From 1c755088aeeb724602b7c7e1860401ebe4552b75 Mon Sep 17 00:00:00 2001
From: EMMOntoPy Developers <Team4.0@SINTEF.no>
Date: Fri, 21 Jun 2024 21:34:00 +0000
Subject: [PATCH] Deployed 1524490b to latest with MkDocs 1.6.0 and mike 2.1.1

---
 latest/404.html                               |   6 +-
 latest/CHANGELOG/index.html                   |  16 ++--
 latest/LICENSE/index.html                     |   6 +-
 .../api_reference/emmopy/emmocheck/index.html |   6 +-
 latest/api_reference/emmopy/emmopy/index.html |   6 +-
 .../api_reference/ontopy/colortest/index.html |   6 +-
 .../ontopy/excelparser/index.html             |   6 +-
 .../factppgraph/index.html                    |   6 +-
 .../owlapi_interface/index.html               |   6 +-
 .../sync_factpp/index.html                    |   6 +-
 latest/api_reference/ontopy/graph/index.html  |   6 +-
 .../ontopy/manchester/index.html              |   6 +-
 latest/api_reference/ontopy/nadict/index.html |   6 +-
 .../api_reference/ontopy/ontodoc/index.html   |   6 +-
 .../ontopy/ontodoc_rst/index.html             |   6 +-
 .../api_reference/ontopy/ontology/index.html  |  18 ++---
 latest/api_reference/ontopy/patch/index.html  |   6 +-
 .../api_reference/ontopy/testutils/index.html |   6 +-
 latest/api_reference/ontopy/utils/index.html  |   6 +-
 ...081f42fc.min.js => bundle.ad660dcc.min.js} |   6 +-
 ....min.js.map => bundle.ad660dcc.min.js.map} |   6 +-
 latest/demo/horizontal/index.html             |   6 +-
 latest/demo/index.html                        |   6 +-
 latest/demo/vertical/index.html               |   6 +-
 .../release-instructions/index.html           |   6 +-
 latest/developers/setup/index.html            |   6 +-
 latest/developers/testing/index.html          |   6 +-
 latest/docker-instructions/index.html         |   6 +-
 latest/examples/emmodoc/classes/index.html    |   6 +-
 latest/examples/emmodoc/emmo/index.html       |   6 +-
 .../emmodoc/important_concepts/index.html     |   6 +-
 latest/examples/emmodoc/index.html            |   6 +-
 .../examples/emmodoc/introduction/index.html  |   6 +-
 latest/examples/emmodoc/relations/index.html  |   6 +-
 .../examples/jupyter-visualization/index.html |   6 +-
 .../examples/ontology-from-excel/index.html   |   6 +-
 latest/index.html                             |   6 +-
 latest/search/search_index.json               |   2 +-
 latest/sitemap.xml                            |  70 +++++++++---------
 latest/sitemap.xml.gz                         | Bin 547 -> 547 bytes
 latest/tools-instructions/index.html          |   6 +-
 41 files changed, 161 insertions(+), 161 deletions(-)
 rename latest/assets/javascripts/{bundle.081f42fc.min.js => bundle.ad660dcc.min.js} (71%)
 rename latest/assets/javascripts/{bundle.081f42fc.min.js.map => bundle.ad660dcc.min.js.map} (78%)

diff --git a/latest/404.html b/latest/404.html
index ba09bc7f..2d02a22b 100644
--- a/latest/404.html
+++ b/latest/404.html
@@ -14,7 +14,7 @@
       
       
       <link rel="icon" href="/EMMOntoPy/latest/images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -143,7 +143,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1271,7 +1271,7 @@ <h1>404 - Not found</h1>
     <script id="__config" type="application/json">{"base": "/EMMOntoPy/latest", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "/EMMOntoPy/latest/assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="/EMMOntoPy/latest/assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="/EMMOntoPy/latest/assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/CHANGELOG/index.html b/latest/CHANGELOG/index.html
index c4b0a553..38b2cbfd 100644
--- a/latest/CHANGELOG/index.html
+++ b/latest/CHANGELOG/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -718,9 +718,9 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#unreleased-changes-2024-05-29" class="md-nav__link">
+  <a href="#unreleased-changes-2024-06-21" class="md-nav__link">
     <span class="md-ellipsis">
-      Unreleased changes (2024-05-29)
+      Unreleased changes (2024-06-21)
     </span>
   </a>
   
@@ -1754,9 +1754,9 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#unreleased-changes-2024-05-29" class="md-nav__link">
+  <a href="#unreleased-changes-2024-06-21" class="md-nav__link">
     <span class="md-ellipsis">
-      Unreleased changes (2024-05-29)
+      Unreleased changes (2024-06-21)
     </span>
   </a>
   
@@ -2264,7 +2264,7 @@
 
 
 <h1 id="changelog">Changelog<a class="headerlink" href="#changelog" title="Permanent link">&para;</a></h1>
-<h2 id="unreleased-changes-2024-05-29"><a href="https://github.com/emmo-repo/EMMOntoPy/tree/Unreleased changes">Unreleased changes</a> (2024-05-29)<a class="headerlink" href="#unreleased-changes-2024-05-29" title="Permanent link">&para;</a></h2>
+<h2 id="unreleased-changes-2024-06-21"><a href="https://github.com/emmo-repo/EMMOntoPy/tree/Unreleased changes">Unreleased changes</a> (2024-06-21)<a class="headerlink" href="#unreleased-changes-2024-06-21" title="Permanent link">&para;</a></h2>
 <p><a href="https://github.com/emmo-repo/EMMOntoPy/compare/v0.7.1...Unreleased changes">Full Changelog</a></p>
 <p><strong>Closed issues:</strong></p>
 <ul>
@@ -3141,7 +3141,7 @@ <h2 id="v099-2019-07-14"><a href="https://github.com/emmo-repo/EMMOntoPy/tree/v0
     <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/LICENSE/index.html b/latest/LICENSE/index.html
index 3557fe84..89a4eda7 100644
--- a/latest/LICENSE/index.html
+++ b/latest/LICENSE/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -149,7 +149,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1332,7 +1332,7 @@ <h1>LICENSE</h1>
     <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/emmopy/emmocheck/index.html b/latest/api_reference/emmopy/emmocheck/index.html
index 3a54f3e8..bd284441 100644
--- a/latest/api_reference/emmopy/emmocheck/index.html
+++ b/latest/api_reference/emmopy/emmocheck/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -3450,7 +3450,7 @@ <h2 id="emmopy.emmocheck.main" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/emmopy/emmopy/index.html b/latest/api_reference/emmopy/emmopy/index.html
index 7b00ad6b..709000dd 100644
--- a/latest/api_reference/emmopy/emmopy/index.html
+++ b/latest/api_reference/emmopy/emmopy/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1507,7 +1507,7 @@ <h2 id="emmopy.emmopy.get_emmo" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/colortest/index.html b/latest/api_reference/ontopy/colortest/index.html
index 28583bf1..25473f18 100644
--- a/latest/api_reference/ontopy/colortest/index.html
+++ b/latest/api_reference/ontopy/colortest/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -2716,7 +2716,7 @@ <h4 id="ontopy.colortest.ColourTextTestRunner.resultclass.startTest" class="doc
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/excelparser/index.html b/latest/api_reference/ontopy/excelparser/index.html
index 166c8d03..d36c5b76 100644
--- a/latest/api_reference/ontopy/excelparser/index.html
+++ b/latest/api_reference/ontopy/excelparser/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -2332,7 +2332,7 @@ <h2 id="ontopy.excelparser.get_metadata_from_dataframe" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/factpluspluswrapper/factppgraph/index.html b/latest/api_reference/ontopy/factpluspluswrapper/factppgraph/index.html
index 0c0404a4..72cb57e8 100644
--- a/latest/api_reference/ontopy/factpluspluswrapper/factppgraph/index.html
+++ b/latest/api_reference/ontopy/factpluspluswrapper/factppgraph/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -2234,7 +2234,7 @@ <h2 id="ontopy.factpluspluswrapper.factppgraph.FactPPError" class="doc doc-headi
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/factpluspluswrapper/owlapi_interface/index.html b/latest/api_reference/ontopy/factpluspluswrapper/owlapi_interface/index.html
index 304d5551..866601bc 100644
--- a/latest/api_reference/ontopy/factpluspluswrapper/owlapi_interface/index.html
+++ b/latest/api_reference/ontopy/factpluspluswrapper/owlapi_interface/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1875,7 +1875,7 @@ <h2 id="ontopy.factpluspluswrapper.owlapi_interface.reason_from_terminal" class=
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/factpluspluswrapper/sync_factpp/index.html b/latest/api_reference/ontopy/factpluspluswrapper/sync_factpp/index.html
index 248d12b4..58efa695 100644
--- a/latest/api_reference/ontopy/factpluspluswrapper/sync_factpp/index.html
+++ b/latest/api_reference/ontopy/factpluspluswrapper/sync_factpp/index.html
@@ -18,7 +18,7 @@
       
       
       <link rel="icon" href="../../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -152,7 +152,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1607,7 +1607,7 @@ <h4 id="ontopy.factpluspluswrapper.sync_factpp.sync_reasoner_factpp--parameters"
     <script id="__config" type="application/json">{"base": "../../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/graph/index.html b/latest/api_reference/ontopy/graph/index.html
index ee22f30d..44655a9b 100644
--- a/latest/api_reference/ontopy/graph/index.html
+++ b/latest/api_reference/ontopy/graph/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -4374,7 +4374,7 @@ <h2 id="ontopy.graph.plot_modules" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/manchester/index.html b/latest/api_reference/ontopy/manchester/index.html
index df79816b..affdf840 100644
--- a/latest/api_reference/ontopy/manchester/index.html
+++ b/latest/api_reference/ontopy/manchester/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1764,7 +1764,7 @@ <h2 id="ontopy.manchester.manchester_expression" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/nadict/index.html b/latest/api_reference/ontopy/nadict/index.html
index 24ab9e22..d48181fc 100644
--- a/latest/api_reference/ontopy/nadict/index.html
+++ b/latest/api_reference/ontopy/nadict/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -2299,7 +2299,7 @@ <h3 id="ontopy.nadict.NADict.values" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/ontodoc/index.html b/latest/api_reference/ontopy/ontodoc/index.html
index ddb98275..81e9365c 100644
--- a/latest/api_reference/ontopy/ontodoc/index.html
+++ b/latest/api_reference/ontopy/ontodoc/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -5483,7 +5483,7 @@ <h2 id="ontopy.ontodoc.run_pandoc_pdf" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/ontodoc_rst/index.html b/latest/api_reference/ontopy/ontodoc_rst/index.html
index fb45b717..1a8c7528 100644
--- a/latest/api_reference/ontopy/ontodoc_rst/index.html
+++ b/latest/api_reference/ontopy/ontodoc_rst/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -3100,7 +3100,7 @@ <h3 id="ontopy.ontodoc_rst.OntologyDocumentation.write_refdoc" class="doc doc-he
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/ontology/index.html b/latest/api_reference/ontopy/ontology/index.html
index 7c27e406..319f4c59 100644
--- a/latest/api_reference/ontopy/ontology/index.html
+++ b/latest/api_reference/ontopy/ontology/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -3607,16 +3607,16 @@ <h2 id="ontopy.ontology.Ontology" class="doc doc-heading">
 <span class="sd">        are also returned.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
 
-        <span class="k">def</span> <span class="nf">rec_imported</span><span class="p">(</span><span class="n">onto</span><span class="p">):</span>
+        <span class="k">def</span> <span class="nf">rec_imported</span><span class="p">(</span><span class="n">onto</span><span class="p">,</span> <span class="n">imported</span><span class="p">):</span>
             <span class="k">for</span> <span class="n">ontology</span> <span class="ow">in</span> <span class="n">onto</span><span class="o">.</span><span class="n">imported_ontologies</span><span class="p">:</span>
                 <span class="c1"># pylint: disable=possibly-used-before-assignment</span>
                 <span class="k">if</span> <span class="n">ontology</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">imported</span><span class="p">:</span>
                     <span class="n">imported</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">ontology</span><span class="p">)</span>
-                    <span class="n">rec_imported</span><span class="p">(</span><span class="n">ontology</span><span class="p">)</span>
+                    <span class="n">rec_imported</span><span class="p">(</span><span class="n">ontology</span><span class="p">,</span> <span class="n">imported</span><span class="p">)</span>
 
         <span class="k">if</span> <span class="n">recursive</span><span class="p">:</span>
             <span class="n">imported</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-            <span class="n">rec_imported</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+            <span class="n">rec_imported</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">imported</span><span class="p">)</span>
             <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">imported</span><span class="p">)</span>
 
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">imported_ontologies</span>
@@ -5990,16 +5990,16 @@ <h3 id="ontopy.ontology.Ontology.get_imported_ontologies" class="doc doc-heading
 <span class="sd">    are also returned.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">rec_imported</span><span class="p">(</span><span class="n">onto</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">rec_imported</span><span class="p">(</span><span class="n">onto</span><span class="p">,</span> <span class="n">imported</span><span class="p">):</span>
         <span class="k">for</span> <span class="n">ontology</span> <span class="ow">in</span> <span class="n">onto</span><span class="o">.</span><span class="n">imported_ontologies</span><span class="p">:</span>
             <span class="c1"># pylint: disable=possibly-used-before-assignment</span>
             <span class="k">if</span> <span class="n">ontology</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">imported</span><span class="p">:</span>
                 <span class="n">imported</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">ontology</span><span class="p">)</span>
-                <span class="n">rec_imported</span><span class="p">(</span><span class="n">ontology</span><span class="p">)</span>
+                <span class="n">rec_imported</span><span class="p">(</span><span class="n">ontology</span><span class="p">,</span> <span class="n">imported</span><span class="p">)</span>
 
     <span class="k">if</span> <span class="n">recursive</span><span class="p">:</span>
         <span class="n">imported</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>
-        <span class="n">rec_imported</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+        <span class="n">rec_imported</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">imported</span><span class="p">)</span>
         <span class="k">return</span> <span class="nb">list</span><span class="p">(</span><span class="n">imported</span><span class="p">)</span>
 
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">imported_ontologies</span>
@@ -8520,7 +8520,7 @@ <h2 id="ontopy.ontology.get_ontology" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/patch/index.html b/latest/api_reference/ontopy/patch/index.html
index 770beff0..4cef2b92 100644
--- a/latest/api_reference/ontopy/patch/index.html
+++ b/latest/api_reference/ontopy/patch/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -2021,7 +2021,7 @@ <h2 id="ontopy.patch.render_func" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/testutils/index.html b/latest/api_reference/ontopy/testutils/index.html
index 761bc63e..22061dc5 100644
--- a/latest/api_reference/ontopy/testutils/index.html
+++ b/latest/api_reference/ontopy/testutils/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1458,7 +1458,7 @@ <h2 id="ontopy.testutils.get_tool_module" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/api_reference/ontopy/utils/index.html b/latest/api_reference/ontopy/utils/index.html
index 1db67a46..aea0638d 100644
--- a/latest/api_reference/ontopy/utils/index.html
+++ b/latest/api_reference/ontopy/utils/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -3656,7 +3656,7 @@ <h2 id="ontopy.utils.write_catalog" class="doc doc-heading">
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/assets/javascripts/bundle.081f42fc.min.js b/latest/assets/javascripts/bundle.ad660dcc.min.js
similarity index 71%
rename from latest/assets/javascripts/bundle.081f42fc.min.js
rename to latest/assets/javascripts/bundle.ad660dcc.min.js
index 32734cd3..0ffc0460 100644
--- a/latest/assets/javascripts/bundle.081f42fc.min.js
+++ b/latest/assets/javascripts/bundle.ad660dcc.min.js
@@ -9,7 +9,7 @@
  * Copyright(c) 2015 Andreas Lubbe
  * Copyright(c) 2015 Tiancheng "Timothy" Gu
  * MIT Licensed
- */var ts=/["'&<>]/;ei.exports=rs;function rs(e){var t=""+e,r=ts.exec(t);if(!r)return t;var o,n="",i=0,a=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}a!==i&&(n+=t.substring(a,i)),a=i+1,n+=o}return a!==i?n+t.substring(a,i):n}});var e0=Vt(co());/*! *****************************************************************************
+ */var ts=/["'&<>]/;ei.exports=rs;function rs(e){var t=""+e,r=ts.exec(t);if(!r)return t;var o,n="",i=0,a=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}a!==i&&(n+=t.substring(a,i)),a=i+1,n+=o}return a!==i?n+t.substring(a,i):n}});var eM=Vt(co());/*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
 
 Permission to use, copy, modify, and/or distribute this software for any
@@ -24,6 +24,6 @@ OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */var wr=function(e,t){return wr=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},wr(e,t)};function re(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");wr(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function po(e,t,r,o){function n(i){return i instanceof r?i:new r(function(a){a(i)})}return new(r||(r=Promise))(function(i,a){function s(l){try{c(o.next(l))}catch(f){a(f)}}function p(l){try{c(o.throw(l))}catch(f){a(f)}}function c(l){l.done?i(l.value):n(l.value).then(s,p)}c((o=o.apply(e,t||[])).next())})}function Nt(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,a;return a={next:s(0),throw:s(1),return:s(2)},typeof Symbol=="function"&&(a[Symbol.iterator]=function(){return this}),a;function s(c){return function(l){return p([c,l])}}function p(c){if(o)throw new TypeError("Generator is already executing.");for(;r;)try{if(o=1,n&&(i=c[0]&2?n.return:c[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,c[1])).done)return i;switch(n=0,i&&(c=[c[0]&2,i.value]),c[0]){case 0:case 1:i=c;break;case 4:return r.label++,{value:c[1],done:!1};case 5:r.label++,n=c[1],c=[0];continue;case 7:c=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(c[0]===6||c[0]===2)){r=0;continue}if(c[0]===3&&(!i||c[1]>i[0]&&c[1]<i[3])){r.label=c[1];break}if(c[0]===6&&r.label<i[1]){r.label=i[1],i=c;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(c);break}i[2]&&r.ops.pop(),r.trys.pop();continue}c=t.call(e,r)}catch(l){c=[6,l],n=0}finally{o=i=0}if(c[0]&5)throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}}function de(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function N(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],a;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(s){a={error:s}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(a)throw a.error}}return i}function q(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function nt(e){return this instanceof nt?(this.v=e,this):new nt(e)}function lo(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n={},a("next"),a("throw"),a("return"),n[Symbol.asyncIterator]=function(){return this},n;function a(u){o[u]&&(n[u]=function(h){return new Promise(function(w,A){i.push([u,h,w,A])>1||s(u,h)})})}function s(u,h){try{p(o[u](h))}catch(w){f(i[0][3],w)}}function p(u){u.value instanceof nt?Promise.resolve(u.value.v).then(c,l):f(i[0][2],u)}function c(u){s("next",u)}function l(u){s("throw",u)}function f(u,h){u(h),i.shift(),i.length&&s(i[0][0],i[0][1])}}function mo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof de=="function"?de(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(a){return new Promise(function(s,p){a=e[i](a),n(s,p,a.done,a.value)})}}function n(i,a,s,p){Promise.resolve(p).then(function(c){i({value:c,done:s})},a)}}function k(e){return typeof e=="function"}function ft(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var zt=ft(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
 `+r.map(function(o,n){return n+1+") "+o.toString()}).join(`
-  `):"",this.name="UnsubscriptionError",this.errors=r}});function qe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Fe=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=de(a),p=s.next();!p.done;p=s.next()){var c=p.value;c.remove(this)}}catch(A){t={error:A}}finally{try{p&&!p.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(k(l))try{l()}catch(A){i=A instanceof zt?A.errors:[A]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=de(f),h=u.next();!h.done;h=u.next()){var w=h.value;try{fo(w)}catch(A){i=i!=null?i:[],A instanceof zt?i=q(q([],N(i)),N(A.errors)):i.push(A)}}}catch(A){o={error:A}}finally{try{h&&!h.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new zt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)fo(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&qe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&qe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Tr=Fe.EMPTY;function qt(e){return e instanceof Fe||e&&"closed"in e&&k(e.remove)&&k(e.add)&&k(e.unsubscribe)}function fo(e){k(e)?e():e.unsubscribe()}var $e={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var ut={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=ut.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,q([e,t],N(r))):setTimeout.apply(void 0,q([e,t],N(r)))},clearTimeout:function(e){var t=ut.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Qt(e){ut.setTimeout(function(){var t=$e.onUnhandledError;if(t)t(e);else throw e})}function he(){}var uo=function(){return Sr("C",void 0,void 0)}();function ho(e){return Sr("E",void 0,e)}function bo(e){return Sr("N",e,void 0)}function Sr(e,t,r){return{kind:e,value:t,error:r}}var it=null;function dt(e){if($e.useDeprecatedSynchronousErrorHandling){var t=!it;if(t&&(it={errorThrown:!1,error:null}),e(),t){var r=it,o=r.errorThrown,n=r.error;if(it=null,o)throw n}}else e()}function vo(e){$e.useDeprecatedSynchronousErrorHandling&&it&&(it.errorThrown=!0,it.error=e)}var Mt=function(e){re(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,qt(r)&&r.add(o)):o.destination=qi,o}return t.create=function(r,o,n){return new at(r,o,n)},t.prototype.next=function(r){this.isStopped?Mr(bo(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Mr(ho(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Mr(uo,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Fe);var Vi=Function.prototype.bind;function Or(e,t){return Vi.call(e,t)}var Ni=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Kt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Kt(o)}else Kt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Kt(r)}},e}(),at=function(e){re(t,e);function t(r,o,n){var i=e.call(this)||this,a;if(k(r)||!r)a={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var s;i&&$e.useDeprecatedNextContext?(s=Object.create(r),s.unsubscribe=function(){return i.unsubscribe()},a={next:r.next&&Or(r.next,s),error:r.error&&Or(r.error,s),complete:r.complete&&Or(r.complete,s)}):a=r}return i.destination=new Ni(a),i}return t}(Mt);function Kt(e){$e.useDeprecatedSynchronousErrorHandling?vo(e):Qt(e)}function zi(e){throw e}function Mr(e,t){var r=$e.onStoppedNotification;r&&ut.setTimeout(function(){return r(e,t)})}var qi={closed:!0,next:he,error:zi,complete:he};var ht=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function le(e){return e}function go(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Lr(e)}function Lr(e){return e.length===0?le:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var F=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=Ki(t)?t:new at(t,r,o);return dt(function(){var a=n,s=a.operator,p=a.source;i.add(s?s.call(i,p):p?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=xo(r),new r(function(n,i){var a=new at({next:function(s){try{t(s)}catch(p){i(p),a.unsubscribe()}},error:i,complete:n});o.subscribe(a)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[ht]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Lr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=xo(t),new t(function(o,n){var i;r.subscribe(function(a){return i=a},function(a){return n(a)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function xo(e){var t;return(t=e!=null?e:$e.Promise)!==null&&t!==void 0?t:Promise}function Qi(e){return e&&k(e.next)&&k(e.error)&&k(e.complete)}function Ki(e){return e&&e instanceof Mt||Qi(e)&&qt(e)}function Yi(e){return k(e==null?void 0:e.lift)}function y(e){return function(t){if(Yi(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function T(e,t,r,o,n){return new Bi(e,t,r,o,n)}var Bi=function(e){re(t,e);function t(r,o,n,i,a,s){var p=e.call(this,r)||this;return p.onFinalize=a,p.shouldUnsubscribe=s,p._next=o?function(c){try{o(c)}catch(l){r.error(l)}}:e.prototype._next,p._error=i?function(c){try{i(c)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,p._complete=n?function(){try{n()}catch(c){r.error(c)}finally{this.unsubscribe()}}:e.prototype._complete,p}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(Mt);var bt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=bt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Fe(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=bt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,q([],N(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=bt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,q([],N(e)))},delegate:void 0};var yo=ft(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var g=function(e){re(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new Eo(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new yo},t.prototype.next=function(r){var o=this;dt(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var a=de(o.currentObservers),s=a.next();!s.done;s=a.next()){var p=s.value;p.next(r)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;dt(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;dt(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Tr:(this.currentObservers=null,s.push(r),new Fe(function(){o.currentObservers=null,qe(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new F;return r.source=this,r},t.create=function(r,o){return new Eo(r,o)},t}(F);var Eo=function(e){re(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Tr},t}(g);var _r=function(e){re(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(g);var Lt={now:function(){return(Lt.delegate||Date).now()},delegate:void 0};var _t=function(e){re(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=Lt);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,p=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+p)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),p=0;p<s.length&&!r.closed;p+=i?1:2)r.next(s[p]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,a=r._infiniteTimeWindow,s=(a?1:2)*o;if(o<1/0&&s<i.length&&i.splice(0,i.length-s),!a){for(var p=n.now(),c=0,l=1;l<i.length&&i[l]<=p;l+=2)c=l;c&&i.splice(0,c+1)}},t}(g);var wo=function(e){re(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Fe);var At={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=At.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,q([e,t],N(r))):setInterval.apply(void 0,q([e,t],N(r)))},clearInterval:function(e){var t=At.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var vt=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,a=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(a,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(a,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),At.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&At.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(a){n=!0,i=a||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,qe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(wo);var Ar=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=Lt.now,e}();var gt=function(e){re(t,e);function t(r,o){o===void 0&&(o=Ar.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ar);var se=new gt(vt),Cr=se;var To=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(vt);var So=function(e){re(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(gt);var Hr=new So(To);var Oo=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=bt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(bt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(vt);var Mo=function(e){re(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(gt);var me=new Mo(Oo);var M=new F(function(e){return e.complete()});function Yt(e){return e&&k(e.schedule)}function kr(e){return e[e.length-1]}function Xe(e){return k(kr(e))?e.pop():void 0}function He(e){return Yt(kr(e))?e.pop():void 0}function Bt(e,t){return typeof kr(e)=="number"?e.pop():t}var xt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Gt(e){return k(e==null?void 0:e.then)}function Jt(e){return k(e[ht])}function Xt(e){return Symbol.asyncIterator&&k(e==null?void 0:e[Symbol.asyncIterator])}function Zt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Gi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var er=Gi();function tr(e){return k(e==null?void 0:e[er])}function rr(e){return lo(this,arguments,function(){var r,o,n,i;return Nt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,nt(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,nt(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,nt(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function or(e){return k(e==null?void 0:e.getReader)}function W(e){if(e instanceof F)return e;if(e!=null){if(Jt(e))return Ji(e);if(xt(e))return Xi(e);if(Gt(e))return Zi(e);if(Xt(e))return Lo(e);if(tr(e))return ea(e);if(or(e))return ta(e)}throw Zt(e)}function Ji(e){return new F(function(t){var r=e[ht]();if(k(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Xi(e){return new F(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function Zi(e){return new F(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Qt)})}function ea(e){return new F(function(t){var r,o;try{for(var n=de(e),i=n.next();!i.done;i=n.next()){var a=i.value;if(t.next(a),t.closed)return}}catch(s){r={error:s}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Lo(e){return new F(function(t){ra(e,t).catch(function(r){return t.error(r)})})}function ta(e){return Lo(rr(e))}function ra(e,t){var r,o,n,i;return po(this,void 0,void 0,function(){var a,s;return Nt(this,function(p){switch(p.label){case 0:p.trys.push([0,5,6,11]),r=mo(e),p.label=1;case 1:return[4,r.next()];case 2:if(o=p.sent(),!!o.done)return[3,4];if(a=o.value,t.next(a),t.closed)return[2];p.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return s=p.sent(),n={error:s},[3,11];case 6:return p.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:p.sent(),p.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function we(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function be(e,t){return t===void 0&&(t=0),y(function(r,o){r.subscribe(T(o,function(n){return we(o,e,function(){return o.next(n)},t)},function(){return we(o,e,function(){return o.complete()},t)},function(n){return we(o,e,function(){return o.error(n)},t)}))})}function Qe(e,t){return t===void 0&&(t=0),y(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function _o(e,t){return W(e).pipe(Qe(t),be(t))}function Ao(e,t){return W(e).pipe(Qe(t),be(t))}function Co(e,t){return new F(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function Ho(e,t){return new F(function(r){var o;return we(r,t,function(){o=e[er](),we(r,t,function(){var n,i,a;try{n=o.next(),i=n.value,a=n.done}catch(s){r.error(s);return}a?r.complete():r.next(i)},0,!0)}),function(){return k(o==null?void 0:o.return)&&o.return()}})}function nr(e,t){if(!e)throw new Error("Iterable cannot be null");return new F(function(r){we(r,t,function(){var o=e[Symbol.asyncIterator]();we(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function ko(e,t){return nr(rr(e),t)}function $o(e,t){if(e!=null){if(Jt(e))return _o(e,t);if(xt(e))return Co(e,t);if(Gt(e))return Ao(e,t);if(Xt(e))return nr(e,t);if(tr(e))return Ho(e,t);if(or(e))return ko(e,t)}throw Zt(e)}function ue(e,t){return t?$o(e,t):W(e)}function I(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e);return ue(e,r)}function $r(e,t){var r=k(e)?e:function(){return e},o=function(n){return n.error(r())};return new F(t?function(n){return t.schedule(o,0,n)}:o)}var ir=ft(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Po(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return y(function(r,o){var n=0;r.subscribe(T(o,function(i){o.next(e.call(t,i,n++))}))})}var oa=Array.isArray;function na(e,t){return oa(t)?e.apply(void 0,q([],N(t))):e(t)}function Ze(e){return m(function(t){return na(e,t)})}var ia=Array.isArray,aa=Object.getPrototypeOf,sa=Object.prototype,ca=Object.keys;function Ro(e){if(e.length===1){var t=e[0];if(ia(t))return{args:t,keys:null};if(pa(t)){var r=ca(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function pa(e){return e&&typeof e=="object"&&aa(e)===sa}function Io(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Xe(e),n=Ro(e),i=n.args,a=n.keys;if(i.length===0)return ue([],r);var s=new F(Pr(i,r,a?function(p){return Io(a,p)}:le));return o?s.pipe(Ze(o)):s}function Pr(e,t,r){return r===void 0&&(r=le),function(o){Fo(t,function(){for(var n=e.length,i=new Array(n),a=n,s=n,p=function(l){Fo(t,function(){var f=ue(e[l],t),u=!1;f.subscribe(T(o,function(h){i[l]=h,u||(u=!0,s--),s||o.next(r(i.slice()))},function(){--a||o.complete()}))},o)},c=0;c<n;c++)p(c)},o)}}function Fo(e,t,r){e?we(r,e,t):t()}function jo(e,t,r,o,n,i,a,s){var p=[],c=0,l=0,f=!1,u=function(){f&&!p.length&&!c&&t.complete()},h=function(A){return c<o?w(A):p.push(A)},w=function(A){i&&t.next(A),c++;var te=!1;W(r(A,l++)).subscribe(T(t,function(ie){n==null||n(ie),i?h(ie):t.next(ie)},function(){te=!0},void 0,function(){if(te)try{c--;for(var ie=function(){var J=p.shift();a?we(t,a,function(){return w(J)}):w(J)};p.length&&c<o;)ie();u()}catch(J){t.error(J)}}))};return e.subscribe(T(t,h,function(){f=!0,u()})),function(){s==null||s()}}function oe(e,t,r){return r===void 0&&(r=1/0),k(t)?oe(function(o,n){return m(function(i,a){return t(o,i,n,a)})(W(e(o,n)))},r):(typeof t=="number"&&(r=t),y(function(o,n){return jo(o,n,e,r)}))}function yt(e){return e===void 0&&(e=1/0),oe(le,e)}function Wo(){return yt(1)}function je(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Wo()(ue(e,He(e)))}function C(e){return new F(function(t){W(e()).subscribe(t)})}var la=["addListener","removeListener"],ma=["addEventListener","removeEventListener"],fa=["on","off"];function d(e,t,r,o){if(k(r)&&(o=r,r=void 0),o)return d(e,t,r).pipe(Ze(o));var n=N(ha(e)?ma.map(function(s){return function(p){return e[s](t,p,r)}}):ua(e)?la.map(Uo(e,t)):da(e)?fa.map(Uo(e,t)):[],2),i=n[0],a=n[1];if(!i&&xt(e))return oe(function(s){return d(s,t,r)})(W(e));if(!i)throw new TypeError("Invalid event target");return new F(function(s){var p=function(){for(var c=[],l=0;l<arguments.length;l++)c[l]=arguments[l];return s.next(1<c.length?c:c[0])};return i(p),function(){return a(p)}})}function Uo(e,t){return function(r){return function(o){return e[r](t,o)}}}function ua(e){return k(e.addListener)&&k(e.removeListener)}function da(e){return k(e.on)&&k(e.off)}function ha(e){return k(e.addEventListener)&&k(e.removeEventListener)}function ar(e,t,r){return r?ar(e,t).pipe(Ze(r)):new F(function(o){var n=function(){for(var a=[],s=0;s<arguments.length;s++)a[s]=arguments[s];return o.next(a.length===1?a[0]:a)},i=e(n);return k(t)?function(){return t(n,i)}:void 0})}function Me(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Cr);var o=-1;return t!=null&&(Yt(t)?r=t:o=t),new F(function(n){var i=Po(e)?+e-r.now():e;i<0&&(i=0);var a=0;return r.schedule(function(){n.closed||(n.next(a++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function S(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Bt(e,1/0),n=e;return n.length?n.length===1?W(n[0]):yt(o)(ue(n,r)):M}var Ke=new F(he);var ba=Array.isArray;function Et(e){return e.length===1&&ba(e[0])?e[0]:e}function v(e,t){return y(function(r,o){var n=0;r.subscribe(T(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function Ct(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e),o=Et(e);return o.length?new F(function(n){var i=o.map(function(){return[]}),a=o.map(function(){return!1});n.add(function(){i=a=null});for(var s=function(c){W(o[c]).subscribe(T(n,function(l){if(i[c].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,q([],N(f))):f),i.some(function(u,h){return!u.length&&a[h]})&&n.complete()}},function(){a[c]=!0,!i[c].length&&n.complete()}))},p=0;!n.closed&&p<o.length;p++)s(p);return function(){i=a=null}}):M}function Do(e){return y(function(t,r){var o=!1,n=null,i=null,a=!1,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var c=n;n=null,r.next(c)}a&&r.complete()},p=function(){i=null,a&&r.complete()};t.subscribe(T(r,function(c){o=!0,n=c,i||W(e(c)).subscribe(i=T(r,s,p))},function(){a=!0,(!o||!i||i.closed)&&r.complete()}))})}function Le(e,t){return t===void 0&&(t=se),Do(function(){return Me(e,t)})}function Ye(e,t){return t===void 0&&(t=null),t=t!=null?t:e,y(function(r,o){var n=[],i=0;r.subscribe(T(o,function(a){var s,p,c,l,f=null;i++%t===0&&n.push([]);try{for(var u=de(n),h=u.next();!h.done;h=u.next()){var w=h.value;w.push(a),e<=w.length&&(f=f!=null?f:[],f.push(w))}}catch(ie){s={error:ie}}finally{try{h&&!h.done&&(p=u.return)&&p.call(u)}finally{if(s)throw s.error}}if(f)try{for(var A=de(f),te=A.next();!te.done;te=A.next()){var w=te.value;qe(n,w),o.next(w)}}catch(ie){c={error:ie}}finally{try{te&&!te.done&&(l=A.return)&&l.call(A)}finally{if(c)throw c.error}}},function(){var a,s;try{for(var p=de(n),c=p.next();!c.done;c=p.next()){var l=c.value;o.next(l)}}catch(f){a={error:f}}finally{try{c&&!c.done&&(s=p.return)&&s.call(p)}finally{if(a)throw a.error}}o.complete()},void 0,function(){n=null}))})}function ve(e){return y(function(t,r){var o=null,n=!1,i;o=t.subscribe(T(r,void 0,void 0,function(a){i=W(e(a,ve(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function Vo(e,t,r,o,n){return function(i,a){var s=r,p=t,c=0;i.subscribe(T(a,function(l){var f=c++;p=s?e(p,l,f):(s=!0,l),o&&a.next(p)},n&&function(){s&&a.next(p),a.complete()}))}}function Rr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return r?go(Rr.apply(void 0,q([],N(e))),Ze(r)):y(function(o,n){Pr(q([o],N(Et(e))))(n)})}function We(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Rr.apply(void 0,q([],N(e)))}function Ht(e){return y(function(t,r){var o=!1,n=null,i=null,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var s=n;n=null,r.next(s)}};t.subscribe(T(r,function(s){i==null||i.unsubscribe(),o=!0,n=s,i=T(r,a,he),W(e(s)).subscribe(i)},function(){a(),r.complete()},void 0,function(){n=i=null}))})}function _e(e,t){return t===void 0&&(t=se),y(function(r,o){var n=null,i=null,a=null,s=function(){if(n){n.unsubscribe(),n=null;var c=i;i=null,o.next(c)}};function p(){var c=a+e,l=t.now();if(l<c){n=this.schedule(void 0,c-l),o.add(n);return}s()}r.subscribe(T(o,function(c){i=c,a=t.now(),n||(n=t.schedule(p,e),o.add(n))},function(){s(),o.complete()},void 0,function(){i=n=null}))})}function Be(e){return y(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Te(e){return e<=0?function(){return M}:y(function(t,r){var o=0;t.subscribe(T(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function X(){return y(function(e,t){e.subscribe(T(t,he))})}function No(e){return m(function(){return e})}function Ir(e,t){return t?function(r){return je(t.pipe(Te(1),X()),r.pipe(Ir(e)))}:oe(function(r,o){return W(e(r,o)).pipe(Te(1),No(r))})}function Ge(e,t){t===void 0&&(t=se);var r=Me(e,t);return Ir(function(){return r})}function K(e,t){return t===void 0&&(t=le),e=e!=null?e:va,y(function(r,o){var n,i=!0;r.subscribe(T(o,function(a){var s=t(a);(i||!e(n,s))&&(i=!1,n=s,o.next(a))}))})}function va(e,t){return e===t}function Z(e,t){return K(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function zo(e){return e===void 0&&(e=ga),y(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function ga(){return new ir}function ne(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return je(r,I.apply(void 0,q([],N(e))))}}function L(e){return y(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Ae(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?v(function(n,i){return e(n,i,o)}):le,Te(1),r?Be(t):zo(function(){return new ir}))}}function Fr(e){return e<=0?function(){return M}:y(function(t,r){var o=[];t.subscribe(T(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var a=de(o),s=a.next();!s.done;s=a.next()){var p=s.value;r.next(p)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function qo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Bt(e,1/0);return e=Et(e),y(function(n,i){yt(o)(ue(q([n],N(e)),r)).subscribe(i)})}function Pe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return qo.apply(void 0,q([],N(e)))}function st(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return M}:y(function(n,i){var a=0,s,p=function(){if(s==null||s.unsubscribe(),s=null,o!=null){var l=typeof o=="number"?Me(o):W(o(a)),f=T(i,function(){f.unsubscribe(),c()});l.subscribe(f)}else c()},c=function(){var l=!1;s=n.subscribe(T(i,void 0,function(){++a<r?s?p():l=!0:i.complete()})),l&&p()};c()})}function jr(e,t){return y(Vo(e,t,arguments.length>=2,!0))}function pe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new g}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,p=s===void 0?!0:s;return function(c){var l,f,u,h=0,w=!1,A=!1,te=function(){f==null||f.unsubscribe(),f=void 0},ie=function(){te(),l=u=void 0,w=A=!1},J=function(){var H=l;ie(),H==null||H.unsubscribe()};return y(function(H,mt){h++,!A&&!w&&te();var ze=u=u!=null?u:r();mt.add(function(){h--,h===0&&!A&&!w&&(f=Wr(J,p))}),ze.subscribe(mt),!l&&h>0&&(l=new at({next:function(Ie){return ze.next(Ie)},error:function(Ie){A=!0,te(),f=Wr(ie,n,Ie),ze.error(Ie)},complete:function(){w=!0,te(),f=Wr(ie,a),ze.complete()}}),W(H).subscribe(l))})(c)}}function Wr(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new at({next:function(){n.unsubscribe(),e()}});return W(t.apply(void 0,q([],N(r)))).subscribe(n)}}function B(e,t,r){var o,n,i,a,s=!1;return e&&typeof e=="object"?(o=e.bufferSize,a=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,s=i===void 0?!1:i,r=e.scheduler):a=e!=null?e:1/0,pe({connector:function(){return new _t(a,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:s})}function Ce(e){return v(function(t,r){return e<=r})}function Ur(e){return y(function(t,r){var o=!1,n=T(r,function(){n==null||n.unsubscribe(),o=!0},he);W(e).subscribe(n),t.subscribe(T(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e);return y(function(o,n){(r?je(e,o,r):je(e,o)).subscribe(n)})}function b(e,t){return y(function(r,o){var n=null,i=0,a=!1,s=function(){return a&&!n&&o.complete()};r.subscribe(T(o,function(p){n==null||n.unsubscribe();var c=0,l=i++;W(e(p,l)).subscribe(n=T(o,function(f){return o.next(t?t(p,f,l,c++):f)},function(){n=null,s()}))},function(){a=!0,s()}))})}function U(e){return y(function(t,r){W(e).subscribe(T(r,function(){return r.complete()},he)),!r.closed&&t.subscribe(r)})}function Dr(e,t){return t===void 0&&(t=!1),y(function(r,o){var n=0;r.subscribe(T(o,function(i){var a=e(i,n++);(a||t)&&o.next(i),!a&&o.complete()}))})}function E(e,t,r){var o=k(e)||t||r?{next:e,error:t,complete:r}:e;return o?y(function(n,i){var a;(a=o.subscribe)===null||a===void 0||a.call(o);var s=!0;n.subscribe(T(i,function(p){var c;(c=o.next)===null||c===void 0||c.call(o,p),i.next(p)},function(){var p;s=!1,(p=o.complete)===null||p===void 0||p.call(o),i.complete()},function(p){var c;s=!1,(c=o.error)===null||c===void 0||c.call(o,p),i.error(p)},function(){var p,c;s&&((p=o.unsubscribe)===null||p===void 0||p.call(o)),(c=o.finalize)===null||c===void 0||c.call(o)}))}):le}function Qo(e,t){return y(function(r,o){var n=t!=null?t:{},i=n.leading,a=i===void 0?!0:i,s=n.trailing,p=s===void 0?!1:s,c=!1,l=null,f=null,u=!1,h=function(){f==null||f.unsubscribe(),f=null,p&&(te(),u&&o.complete())},w=function(){f=null,u&&o.complete()},A=function(ie){return f=W(e(ie)).subscribe(T(o,h,w))},te=function(){if(c){c=!1;var ie=l;l=null,o.next(ie),!u&&A(ie)}};r.subscribe(T(o,function(ie){c=!0,l=ie,!(f&&!f.closed)&&(a?te():A(ie))},function(){u=!0,!(p&&c&&f&&!f.closed)&&o.complete()}))})}function ct(e,t,r){t===void 0&&(t=se);var o=Me(e,t);return Qo(function(){return o},r)}function ee(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return y(function(o,n){for(var i=e.length,a=new Array(i),s=e.map(function(){return!1}),p=!1,c=function(f){W(e[f]).subscribe(T(n,function(u){a[f]=u,!p&&!s[f]&&(s[f]=!0,(p=s.every(le))&&(s=null))},he))},l=0;l<i;l++)c(l);o.subscribe(T(n,function(f){if(p){var u=q([f],N(a));n.next(r?r.apply(void 0,q([],N(u))):u)}}))})}function Ko(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return y(function(r,o){Ct.apply(void 0,q([r],N(e))).subscribe(o)})}function Vr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Ko.apply(void 0,q([],N(e)))}function Yo(){let e=new _t(1);return d(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function $(e,t=document){return Array.from(t.querySelectorAll(e))}function P(e,t=document){let r=fe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function fe(e,t=document){return t.querySelector(e)||void 0}function Re(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var xa=S(d(document.body,"focusin"),d(document.body,"focusout")).pipe(_e(1),Q(void 0),m(()=>Re()||document.body),B(1));function et(e){return xa.pipe(m(t=>e.contains(t)),K())}function kt(e,t){return C(()=>S(d(e,"mouseenter").pipe(m(()=>!0)),d(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ht(r=>Me(+!r*t)):le,Q(e.matches(":hover"))))}function Bo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Bo(e,r)}function x(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Bo(o,n);return o}function sr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function wt(e){let t=x("script",{src:e});return C(()=>(document.head.appendChild(t),S(d(t,"load"),d(t,"error").pipe(b(()=>$r(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),L(()=>document.head.removeChild(t)),Te(1))))}var Go=new g,ya=C(()=>typeof ResizeObserver=="undefined"?wt("https://unpkg.com/resize-observer-polyfill"):I(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>Go.next(t)))),b(e=>S(Ke,I(e)).pipe(L(()=>e.disconnect()))),B(1));function ce(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return ya.pipe(E(r=>r.observe(t)),b(r=>Go.pipe(v(o=>o.target===t),L(()=>r.unobserve(t)))),m(()=>ce(e)),Q(ce(e)))}function Tt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function Jo(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Ue(e){return{x:e.offsetLeft,y:e.offsetTop}}function Xo(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function Zo(e){return S(d(window,"load"),d(window,"resize")).pipe(Le(0,me),m(()=>Ue(e)),Q(Ue(e)))}function pr(e){return{x:e.scrollLeft,y:e.scrollTop}}function De(e){return S(d(e,"scroll"),d(window,"scroll"),d(window,"resize")).pipe(Le(0,me),m(()=>pr(e)),Q(pr(e)))}var en=new g,Ea=C(()=>I(new IntersectionObserver(e=>{for(let t of e)en.next(t)},{threshold:0}))).pipe(b(e=>S(Ke,I(e)).pipe(L(()=>e.disconnect()))),B(1));function tt(e){return Ea.pipe(E(t=>t.observe(e)),b(t=>en.pipe(v(({target:r})=>r===e),L(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function tn(e,t=16){return De(e).pipe(m(({y:r})=>{let o=ce(e),n=Tt(e);return r>=n.height-o.height-t}),K())}var lr={drawer:P("[data-md-toggle=drawer]"),search:P("[data-md-toggle=search]")};function rn(e){return lr[e].checked}function Je(e,t){lr[e].checked!==t&&lr[e].click()}function Ve(e){let t=lr[e];return d(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function wa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Ta(){return S(d(window,"compositionstart").pipe(m(()=>!0)),d(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function on(){let e=d(window,"keydown").pipe(v(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:rn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),v(({mode:t,type:r})=>{if(t==="global"){let o=Re();if(typeof o!="undefined")return!wa(o,r)}return!0}),pe());return Ta().pipe(b(t=>t?M:e))}function xe(){return new URL(location.href)}function pt(e,t=!1){if(G("navigation.instant")&&!t){let r=x("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function nn(){return new g}function an(){return location.hash.slice(1)}function sn(e){let t=x("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Sa(e){return S(d(window,"hashchange"),e).pipe(m(an),Q(an()),v(t=>t.length>0),B(1))}function cn(e){return Sa(e).pipe(m(t=>fe(`[id="${t}"]`)),v(t=>typeof t!="undefined"))}function $t(e){let t=matchMedia(e);return ar(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function pn(){let e=matchMedia("print");return S(d(window,"beforeprint").pipe(m(()=>!0)),d(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function Nr(e,t){return e.pipe(b(r=>r?t():M))}function zr(e,t){return new F(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let a=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+a*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function Ne(e,t){return zr(e,t).pipe(b(r=>r.text()),m(r=>JSON.parse(r)),B(1))}function ln(e,t){let r=new DOMParser;return zr(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),B(1))}function mn(e,t){let r=new DOMParser;return zr(e,t).pipe(b(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),B(1))}function fn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function un(){return S(d(window,"scroll",{passive:!0}),d(window,"resize",{passive:!0})).pipe(m(fn),Q(fn()))}function dn(){return{width:innerWidth,height:innerHeight}}function hn(){return d(window,"resize",{passive:!0}).pipe(m(dn),Q(dn()))}function bn(){return z([un(),hn()]).pipe(m(([e,t])=>({offset:e,size:t})),B(1))}function mr(e,{viewport$:t,header$:r}){let o=t.pipe(Z("size")),n=z([o,r]).pipe(m(()=>Ue(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:p,y:c}])=>({offset:{x:a.x-p,y:a.y-c+i},size:s})))}function Oa(e){return d(e,"message",t=>t.data)}function Ma(e){let t=new g;return t.subscribe(r=>e.postMessage(r)),t}function vn(e,t=new Worker(e)){let r=Oa(t),o=Ma(t),n=new g;n.subscribe(o);let i=o.pipe(X(),ne(!0));return n.pipe(X(),Pe(r.pipe(U(i))),pe())}var La=P("#__config"),St=JSON.parse(La.textContent);St.base=`${new URL(St.base,xe())}`;function ye(){return St}function G(e){return St.features.includes(e)}function Ee(e,t){return typeof t!="undefined"?St.translations[e].replace("#",t.toString()):St.translations[e]}function Se(e,t=document){return P(`[data-md-component=${e}]`,t)}function ae(e,t=document){return $(`[data-md-component=${e}]`,t)}function _a(e){let t=P(".md-typeset > :first-child",e);return d(t,"click",{once:!0}).pipe(m(()=>P(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function gn(e){if(!G("announce.dismiss")||!e.childElementCount)return M;if(!e.hidden){let t=P(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return C(()=>{let t=new g;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),_a(e).pipe(E(r=>t.next(r)),L(()=>t.complete()),m(r=>R({ref:e},r)))})}function Aa(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function xn(e,t){let r=new g;return r.subscribe(({hidden:o})=>{e.hidden=o}),Aa(e,t).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))}function Pt(e,t){return t==="inline"?x("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"})):x("div",{class:"md-tooltip",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"}))}function yn(...e){return x("div",{class:"md-tooltip2",role:"tooltip"},x("div",{class:"md-tooltip2__inner md-typeset"},e))}function En(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return x("aside",{class:"md-annotation",tabIndex:0},Pt(t),x("a",{href:r,class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}else return x("aside",{class:"md-annotation",tabIndex:0},Pt(t),x("span",{class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}function wn(e){return x("button",{class:"md-clipboard md-icon",title:Ee("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}function qr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(p=>!e.terms[p]).reduce((p,c)=>[...p,x("del",null,c)," "],[]).slice(0,-1),i=ye(),a=new URL(e.location,i.base);G("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,p])=>p).reduce((p,[c])=>`${p} ${c}`.trim(),""));let{tags:s}=ye();return x("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},x("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&x("div",{class:"md-search-result__icon md-icon"}),r>0&&x("h1",null,e.title),r<=0&&x("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(p=>{let c=s?p in s?`md-tag-icon md-tag--${s[p]}`:"md-tag-icon":"";return x("span",{class:`md-tag ${c}`},p)}),o>0&&n.length>0&&x("p",{class:"md-search-result__terms"},Ee("search.result.term.missing"),": ",...n)))}function Tn(e){let t=e[0].score,r=[...e],o=ye(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.score<t);a===-1&&(a=r.length);let s=r.slice(0,a),p=r.slice(a),c=[qr(i,2|+(!n&&a===0)),...s.map(l=>qr(l,1)),...p.length?[x("details",{class:"md-search-result__more"},x("summary",{tabIndex:-1},x("div",null,p.length>0&&p.length===1?Ee("search.result.more.one"):Ee("search.result.more.other",p.length))),...p.map(l=>qr(l,1)))]:[]];return x("li",{class:"md-search-result__item"},c)}function Sn(e){return x("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>x("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?sr(r):r)))}function Qr(e){let t=`tabbed-control tabbed-control--${e}`;return x("div",{class:t,hidden:!0},x("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function On(e){return x("div",{class:"md-typeset__scrollwrap"},x("div",{class:"md-typeset__table"},e))}function Ca(e){var o;let t=ye(),r=new URL(`../${e.version}/`,t.base);return x("li",{class:"md-version__item"},x("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&x("span",{class:"md-version__alias"},e.aliases[0])))}function Mn(e,t){var o;let r=ye();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),x("div",{class:"md-version"},x("button",{class:"md-version__current","aria-label":Ee("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&x("span",{class:"md-version__alias"},t.aliases[0])),x("ul",{class:"md-version__list"},e.map(Ca)))}var Ha=0;function ka(e){let t=z([et(e),kt(e)]).pipe(m(([o,n])=>o||n),K()),r=C(()=>Jo(e)).pipe(oe(De),ct(1),m(()=>Xo(e)));return t.pipe(Ae(o=>o),b(()=>z([t,r])),m(([o,n])=>({active:o,offset:n})),pe())}function $a(e,t){let{content$:r,viewport$:o}=t,n=`__tooltip2_${Ha++}`;return C(()=>{let i=new g,a=new _r(!1);i.pipe(X(),ne(!1)).subscribe(a);let s=a.pipe(Ht(c=>Me(+!c*250,Hr)),K(),b(c=>c?r:M),E(c=>c.id=n),pe());z([i.pipe(m(({active:c})=>c)),s.pipe(b(c=>kt(c,250)),Q(!1))]).pipe(m(c=>c.some(l=>l))).subscribe(a);let p=a.pipe(v(c=>c),ee(s,o),m(([c,l,{size:f}])=>{let u=e.getBoundingClientRect(),h=u.width/2;if(l.role==="tooltip")return{x:h,y:8+u.height};if(u.y>=f.height/2){let{height:w}=ce(l);return{x:h,y:-16-w}}else return{x:h,y:16+u.height}}));return z([s,i,p]).subscribe(([c,{offset:l},f])=>{c.style.setProperty("--md-tooltip-host-x",`${l.x}px`),c.style.setProperty("--md-tooltip-host-y",`${l.y}px`),c.style.setProperty("--md-tooltip-x",`${f.x}px`),c.style.setProperty("--md-tooltip-y",`${f.y}px`),c.classList.toggle("md-tooltip2--top",f.y<0),c.classList.toggle("md-tooltip2--bottom",f.y>=0)}),a.pipe(v(c=>c),ee(s,(c,l)=>l),v(c=>c.role==="tooltip")).subscribe(c=>{let l=ce(P(":scope > *",c));c.style.setProperty("--md-tooltip-width",`${l.width}px`),c.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(K(),be(me),ee(s)).subscribe(([c,l])=>{l.classList.toggle("md-tooltip2--active",c)}),z([a.pipe(v(c=>c)),s]).subscribe(([c,l])=>{l.role==="dialog"?(e.setAttribute("aria-controls",n),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",n)}),a.pipe(v(c=>!c)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),ka(e).pipe(E(c=>i.next(c)),L(()=>i.complete()),m(c=>R({ref:e},c)))})}function lt(e,{viewport$:t},r=document.body){return $a(e,{content$:new F(o=>{let n=e.title,i=yn(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t})}function Pa(e,t){let r=C(()=>z([Zo(e),De(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ce(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return et(e).pipe(b(o=>r.pipe(m(n=>({active:o,offset:n})),Te(+!o||1/0))))}function Ln(e,t,{target$:r}){let[o,n]=Array.from(e.children);return C(()=>{let i=new g,a=i.pipe(X(),ne(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),tt(e).pipe(U(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),S(i.pipe(v(({active:s})=>s)),i.pipe(_e(250),v(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Le(16,me)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(ct(125,me),v(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),d(n,"click").pipe(U(a),v(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),d(n,"mousedown").pipe(U(a),ee(i)).subscribe(([s,{active:p}])=>{var c;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(p){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(c=Re())==null||c.blur()}}),r.pipe(U(a),v(s=>s===o),Ge(125)).subscribe(()=>e.focus()),Pa(e,t).pipe(E(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))})}function Ra(e){return e.tagName==="CODE"?$(".c, .c1, .cm",e):[e]}function Ia(e){let t=[];for(let r of Ra(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,p]=a;if(typeof p=="undefined"){let c=i.splitText(a.index);i=c.splitText(s.length),t.push(c)}else{i.textContent=s,t.push(i);break}}}}return t}function _n(e,t){t.append(...Array.from(e.childNodes))}function fr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Ia(t)){let[,p]=s.textContent.match(/\((\d+)\)/);fe(`:scope > li:nth-child(${p})`,e)&&(a.set(p,En(p,i)),s.replaceWith(a.get(p)))}return a.size===0?M:C(()=>{let s=new g,p=s.pipe(X(),ne(!0)),c=[];for(let[l,f]of a)c.push([P(".md-typeset",f),P(`:scope > li:nth-child(${l})`,e)]);return o.pipe(U(p)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of c)l?_n(f,u):_n(u,f)}),S(...[...a].map(([,l])=>Ln(l,t,{target$:r}))).pipe(L(()=>s.complete()),pe())})}function An(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return An(t)}}function Cn(e,t){return C(()=>{let r=An(e);return typeof r!="undefined"?fr(r,e,t):M})}var Hn=Vt(Yr());var Fa=0;function kn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return kn(t)}}function ja(e){return ge(e).pipe(m(({width:t})=>({scrollable:Tt(e).width>t})),Z("scrollable"))}function $n(e,t){let{matches:r}=matchMedia("(hover)"),o=C(()=>{let n=new g,i=n.pipe(Fr(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=[];if(Hn.default.isSupported()&&(e.closest(".copy")||G("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${Fa++}`;let l=wn(c.id);c.insertBefore(l,e),G("content.tooltips")&&a.push(lt(l,{viewport$}))}let s=e.closest(".highlight");if(s instanceof HTMLElement){let c=kn(s);if(typeof c!="undefined"&&(s.classList.contains("annotate")||G("content.code.annotate"))){let l=fr(c,e,t);a.push(ge(s).pipe(U(i),m(({width:f,height:u})=>f&&u),K(),b(f=>f?l:M)))}}return $(":scope > span[id]",e).length&&e.classList.add("md-code__content"),ja(e).pipe(E(c=>n.next(c)),L(()=>n.complete()),m(c=>R({ref:e},c)),Pe(...a))});return G("content.lazy")?tt(e).pipe(v(n=>n),Te(1),b(()=>o)):o}function Wa(e,{target$:t,print$:r}){let o=!0;return S(t.pipe(m(n=>n.closest("details:not([open])")),v(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(v(n=>n||!o),E(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Pn(e,t){return C(()=>{let r=new g;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Wa(e,t).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}var Rn=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var Br,Da=0;function Va(){return typeof mermaid=="undefined"||mermaid instanceof Element?wt("https://unpkg.com/mermaid@10/dist/mermaid.min.js"):I(void 0)}function In(e){return e.classList.remove("mermaid"),Br||(Br=Va().pipe(E(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Rn,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),B(1))),Br.subscribe(()=>ao(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Da++}`,r=x("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})),Br.pipe(m(()=>({ref:e})))}var Fn=x("table");function jn(e){return e.replaceWith(Fn),Fn.replaceWith(On(e)),I({ref:e})}function Na(e){let t=e.find(r=>r.checked)||e[0];return S(...e.map(r=>d(r,"change").pipe(m(()=>P(`label[for="${r.id}"]`))))).pipe(Q(P(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Wn(e,{viewport$:t,target$:r}){let o=P(".tabbed-labels",e),n=$(":scope > input",e),i=Qr("prev");e.append(i);let a=Qr("next");return e.append(a),C(()=>{let s=new g,p=s.pipe(X(),ne(!0));z([s,ge(e)]).pipe(U(p),Le(1,me)).subscribe({next([{active:c},l]){let f=Ue(c),{width:u}=ce(c);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let h=pr(o);(f.x<h.x||f.x+u>h.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([De(o),ge(o)]).pipe(U(p)).subscribe(([c,l])=>{let f=Tt(o);i.hidden=c.x<16,a.hidden=c.x>f.width-l.width-16}),S(d(i,"click").pipe(m(()=>-1)),d(a,"click").pipe(m(()=>1))).pipe(U(p)).subscribe(c=>{let{width:l}=ce(o);o.scrollBy({left:l*c,behavior:"smooth"})}),r.pipe(U(p),v(c=>n.includes(c))).subscribe(c=>c.click()),o.classList.add("tabbed-labels--linked");for(let c of n){let l=P(`label[for="${c.id}"]`);l.replaceChildren(x("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),d(l.firstElementChild,"click").pipe(U(p),v(f=>!(f.metaKey||f.ctrlKey)),E(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return G("content.tabs.link")&&s.pipe(Ce(1),ee(t)).subscribe(([{active:c},{offset:l}])=>{let f=c.innerText.trim();if(c.hasAttribute("data-md-switching"))c.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let w of $("[data-tabs]"))for(let A of $(":scope > input",w)){let te=P(`label[for="${A.id}"]`);if(te!==c&&te.innerText.trim()===f){te.setAttribute("data-md-switching",""),A.click();break}}window.scrollTo({top:e.offsetTop-u});let h=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...h])])}}),s.pipe(U(p)).subscribe(()=>{for(let c of $("audio, video",e))c.pause()}),tt(e).pipe(b(()=>Na(n)),E(c=>s.next(c)),L(()=>s.complete()),m(c=>R({ref:e},c)))}).pipe(Qe(se))}function Un(e,{viewport$:t,target$:r,print$:o}){return S(...$(".annotate:not(.highlight)",e).map(n=>Cn(n,{target$:r,print$:o})),...$("pre:not(.mermaid) > code",e).map(n=>$n(n,{target$:r,print$:o})),...$("pre.mermaid",e).map(n=>In(n)),...$("table:not([class])",e).map(n=>jn(n)),...$("details",e).map(n=>Pn(n,{target$:r,print$:o})),...$("[data-tabs]",e).map(n=>Wn(n,{viewport$:t,target$:r})),...$("[title]",e).filter(()=>G("content.tooltips")).map(n=>lt(n,{viewport$:t})))}function za(e,{alert$:t}){return t.pipe(b(r=>S(I(!0),I(!1).pipe(Ge(2e3))).pipe(m(o=>({message:r,active:o})))))}function Dn(e,t){let r=P(".md-typeset",e);return C(()=>{let o=new g;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),za(e,t).pipe(E(n=>o.next(n)),L(()=>o.complete()),m(n=>R({ref:e},n)))})}var qa=0;function Qa(e,t){document.body.append(e);let{width:r}=ce(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=cr(t),n=typeof o!="undefined"?De(o):I({x:0,y:0}),i=S(et(t),kt(t)).pipe(K());return z([i,n]).pipe(m(([a,s])=>{let{x:p,y:c}=Ue(t),l=ce(t),f=t.closest("table");return f&&t.parentElement&&(p+=f.offsetLeft+t.parentElement.offsetLeft,c+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:p-s.x+l.width/2-r/2,y:c-s.y+l.height+8}}}))}function Vn(e){let t=e.title;if(!t.length)return M;let r=`__tooltip_${qa++}`,o=Pt(r,"inline"),n=P(".md-typeset",o);return n.innerHTML=t,C(()=>{let i=new g;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),S(i.pipe(v(({active:a})=>a)),i.pipe(_e(250),v(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Le(16,me)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(ct(125,me),v(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Qa(o,e).pipe(E(a=>i.next(a)),L(()=>i.complete()),m(a=>R({ref:e},a)))}).pipe(Qe(se))}function Ka({viewport$:e}){if(!G("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Ye(2,1),m(([n,i])=>[n<i,i]),Z(0)),r=z([e,t]).pipe(v(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),K()),o=Ve("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),K(),b(n=>n?r:I(!1)),Q(!1))}function Nn(e,t){return C(()=>z([ge(e),Ka(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),K((r,o)=>r.height===o.height&&r.hidden===o.hidden),B(1))}function zn(e,{header$:t,main$:r}){return C(()=>{let o=new g,n=o.pipe(X(),ne(!0));o.pipe(Z("active"),We(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=ue($("[title]",e)).pipe(v(()=>G("content.tooltips")),oe(a=>Vn(a)));return r.subscribe(o),t.pipe(U(n),m(a=>R({ref:e},a)),Pe(i.pipe(U(n))))})}function Ya(e,{viewport$:t,header$:r}){return mr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ce(e);return{active:o>=n}}),Z("active"))}function qn(e,t){return C(()=>{let r=new g;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=fe(".md-content h1");return typeof o=="undefined"?M:Ya(o,t).pipe(E(n=>r.next(n)),L(()=>r.complete()),m(n=>R({ref:e},n)))})}function Qn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),K()),n=o.pipe(b(()=>ge(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),Z("bottom"))));return z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:p},size:{height:c}}])=>(c=Math.max(0,c-Math.max(0,a-p,i)-Math.max(0,c+p-s)),{offset:a-i,height:c,active:a-i<=p})),K((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function Ba(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return I(...e).pipe(oe(o=>d(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),B(1))}function Kn(e){let t=$("input",e),r=x("meta",{name:"theme-color"});document.head.appendChild(r);let o=x("meta",{name:"color-scheme"});document.head.appendChild(o);let n=$t("(prefers-color-scheme: light)");return C(()=>{let i=new g;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),p=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=p.getAttribute("data-md-color-scheme"),a.color.primary=p.getAttribute("data-md-color-primary"),a.color.accent=p.getAttribute("data-md-color-accent")}for(let[s,p]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,p);for(let s=0;s<t.length;s++){let p=t[s].nextElementSibling;p instanceof HTMLElement&&(p.hidden=a.index!==s)}__md_set("__palette",a)}),d(e,"keydown").pipe(v(a=>a.key==="Enter"),ee(i,(a,s)=>s)).subscribe(({index:a})=>{a=(a+1)%t.length,t[a].click(),t[a].focus()}),i.pipe(m(()=>{let a=Se("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(p=>(+p).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(be(se)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),Ba(t).pipe(U(n.pipe(Ce(1))),st(),E(a=>i.next(a)),L(()=>i.complete()),m(a=>R({ref:e},a)))})}function Yn(e,{progress$:t}){return C(()=>{let r=new g;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(E(o=>r.next({value:o})),L(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Gr=Vt(Yr());function Ga(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Bn({alert$:e}){Gr.default.isSupported()&&new F(t=>{new Gr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||Ga(P(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(E(t=>{t.trigger.focus()}),m(()=>Ee("clipboard.copied"))).subscribe(e)}function Gn(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function Ja(e,t){let r=new Map;for(let o of $("url",e)){let n=P("loc",o),i=[Gn(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let a of $("[rel=alternate]",o)){let s=a.getAttribute("href");s!=null&&i.push(Gn(new URL(s),t))}}return r}function ur(e){return mn(new URL("sitemap.xml",e)).pipe(m(t=>Ja(t,new URL(e))),ve(()=>I(new Map)))}function Xa(e,t){if(!(e.target instanceof Element))return M;let r=e.target.closest("a");if(r===null)return M;if(r.target||e.metaKey||e.ctrlKey)return M;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),I(new URL(r.href))):M}function Jn(e){let t=new Map;for(let r of $(":scope > *",e.head))t.set(r.outerHTML,r);return t}function Xn(e){for(let t of $("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return I(e)}function Za(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...G("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=fe(o),i=fe(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=Jn(document);for(let[o,n]of Jn(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Se("container");return je($("script",r)).pipe(b(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new F(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),M}),X(),ne(document))}function Zn({location$:e,viewport$:t,progress$:r}){let o=ye();if(location.protocol==="file:")return M;let n=ur(o.base);I(document).subscribe(Xn);let i=d(document.body,"click").pipe(We(n),b(([p,c])=>Xa(p,c)),pe()),a=d(window,"popstate").pipe(m(xe),pe());i.pipe(ee(t)).subscribe(([p,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",p)}),S(i,a).subscribe(e);let s=e.pipe(Z("pathname"),b(p=>ln(p,{progress$:r}).pipe(ve(()=>(pt(p,!0),M)))),b(Xn),b(Za),pe());return S(s.pipe(ee(e,(p,c)=>c)),s.pipe(b(()=>e),Z("pathname"),b(()=>e),Z("hash")),e.pipe(K((p,c)=>p.pathname===c.pathname&&p.hash===c.hash),b(()=>i),E(()=>history.back()))).subscribe(p=>{var c,l;history.state!==null||!p.hash?window.scrollTo(0,(l=(c=history.state)==null?void 0:c.y)!=null?l:0):(history.scrollRestoration="auto",sn(p.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),d(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(Z("offset"),_e(100)).subscribe(({offset:p})=>{history.replaceState(p,"")}),s}var ri=Vt(ti());function oi(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}<mark data-md-highlight>${a}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ri.default)(a).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function It(e){return e.type===1}function dr(e){return e.type===3}function ni(e,t){let r=vn(e);return S(I(location.protocol!=="file:"),Ve("search")).pipe(Ae(o=>o),b(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:G("search.suggest")}}})),r}function ii({document$:e}){let t=ye(),r=Ne(new URL("../versions.json",t.base)).pipe(ve(()=>M)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),b(n=>d(document.body,"click").pipe(v(i=>!i.metaKey&&!i.ctrlKey),ee(o),b(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let p=s.href;return!i.target.closest(".md-version")&&n.get(p)===a?M:(i.preventDefault(),I(p))}}return M}),b(i=>ur(new URL(i)).pipe(m(a=>{let p=xe().href.replace(t.base,i);return a.has(p.split("#")[0])?new URL(p):new URL(i)})))))).subscribe(n=>pt(n,!0)),z([r,o]).subscribe(([n,i])=>{P(".md-header__topic").appendChild(Mn(n,i))}),e.pipe(b(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let p of s)for(let c of n.aliases.concat(n.version))if(new RegExp(p,"i").test(c)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of ae("outdated"))s.hidden=!1})}function ns(e,{worker$:t}){let{searchParams:r}=xe();r.has("q")&&(Je("search",!0),e.value=r.get("q"),e.focus(),Ve("search").pipe(Ae(i=>!i)).subscribe(()=>{let i=xe();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=et(e),n=S(t.pipe(Ae(It)),d(e,"keyup"),o).pipe(m(()=>e.value),K());return z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),B(1))}function ai(e,{worker$:t}){let r=new g,o=r.pipe(X(),ne(!0));z([t.pipe(Ae(It)),r],(i,a)=>a).pipe(Z("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(Z("focus")).subscribe(({focus:i})=>{i&&Je("search",i)}),d(e.form,"reset").pipe(U(o)).subscribe(()=>e.focus());let n=P("header [for=__search]");return d(n,"click").subscribe(()=>e.focus()),ns(e,{worker$:t}).pipe(E(i=>r.next(i)),L(()=>r.complete()),m(i=>R({ref:e},i)),B(1))}function si(e,{worker$:t,query$:r}){let o=new g,n=tn(e.parentElement).pipe(v(Boolean)),i=e.parentElement,a=P(":scope > :first-child",e),s=P(":scope > :last-child",e);Ve("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(ee(r),Ur(t.pipe(Ae(It)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?Ee("search.result.none"):Ee("search.result.placeholder");break;case 1:a.textContent=Ee("search.result.one");break;default:let u=sr(l.length);a.textContent=Ee("search.result.other",u)}});let p=o.pipe(E(()=>s.innerHTML=""),b(({items:l})=>S(I(...l.slice(0,10)),I(...l.slice(10)).pipe(Ye(4),Vr(n),b(([f])=>f)))),m(Tn),pe());return p.subscribe(l=>s.appendChild(l)),p.pipe(oe(l=>{let f=fe("details",l);return typeof f=="undefined"?M:d(f,"toggle").pipe(U(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(v(dr),m(({data:l})=>l)).pipe(E(l=>o.next(l)),L(()=>o.complete()),m(l=>R({ref:e},l)))}function is(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=xe();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function ci(e,t){let r=new g,o=r.pipe(X(),ne(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),d(e,"click").pipe(U(o)).subscribe(n=>n.preventDefault()),is(e,t).pipe(E(n=>r.next(n)),L(()=>r.complete()),m(n=>R({ref:e},n)))}function pi(e,{worker$:t,keyboard$:r}){let o=new g,n=Se("search-query"),i=S(d(n,"keydown"),d(n,"focus")).pipe(be(se),m(()=>n.value),K());return o.pipe(We(i),m(([{suggest:s},p])=>{let c=p.split(/([\s-]+)/);if(s!=null&&s.length&&c[c.length-1]){let l=s[s.length-1];l.startsWith(c[c.length-1])&&(c[c.length-1]=l)}else c.length=0;return c})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g,"&nbsp;")),r.pipe(v(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(v(dr),m(({data:s})=>s)).pipe(E(s=>o.next(s)),L(()=>o.complete()),m(()=>({ref:e})))}function li(e,{index$:t,keyboard$:r}){let o=ye();try{let n=ni(o.search,t),i=Se("search-query",e),a=Se("search-result",e);d(e,"click").pipe(v(({target:p})=>p instanceof Element&&!!p.closest("a"))).subscribe(()=>Je("search",!1)),r.pipe(v(({mode:p})=>p==="search")).subscribe(p=>{let c=Re();switch(p.type){case"Enter":if(c===i){let l=new Map;for(let f of $(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,h])=>h-u);f.click()}p.claim()}break;case"Escape":case"Tab":Je("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof c=="undefined")i.focus();else{let l=[i,...$(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(c))+l.length+(p.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}p.claim();break;default:i!==Re()&&i.focus()}}),r.pipe(v(({mode:p})=>p==="global")).subscribe(p=>{switch(p.type){case"f":case"s":case"/":i.focus(),i.select(),p.claim();break}});let s=ai(i,{worker$:n});return S(s,si(a,{worker$:n,query$:s})).pipe(Pe(...ae("search-share",e).map(p=>ci(p,{query$:s})),...ae("search-suggest",e).map(p=>pi(p,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Ke}}function mi(e,{index$:t,location$:r}){return z([t,r.pipe(Q(xe()),v(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>oi(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let p=s.textContent,c=o(p);c.length>p.length&&n.set(s,c)}for(let[s,p]of n){let{childNodes:c}=x("span",null,p);s.replaceWith(...Array.from(c))}return{ref:e,nodes:n}}))}function as(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),K((i,a)=>i.height===a.height&&i.locked===a.locked))}function Jr(e,o){var n=o,{header$:t}=n,r=io(n,["header$"]);let i=P(".md-sidebar__scrollwrap",e),{y:a}=Ue(i);return C(()=>{let s=new g,p=s.pipe(X(),ne(!0)),c=s.pipe(Le(0,me));return c.pipe(ee(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),c.pipe(Ae()).subscribe(()=>{for(let l of $(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ce(f);f.scrollTo({top:u-h/2})}}}),ue($("label[tabindex]",e)).pipe(oe(l=>d(l,"click").pipe(be(se),m(()=>l),U(p)))).subscribe(l=>{let f=P(`[id="${l.htmlFor}"]`);P(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),as(e,r).pipe(E(l=>s.next(l)),L(()=>s.complete()),m(l=>R({ref:e},l)))})}function fi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return Ct(Ne(`${r}/releases/latest`).pipe(ve(()=>M),m(o=>({version:o.tag_name})),Be({})),Ne(r).pipe(ve(()=>M),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),Be({}))).pipe(m(([o,n])=>R(R({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return Ne(r).pipe(m(o=>({repositories:o.public_repos})),Be({}))}}function ui(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Ne(r).pipe(ve(()=>M),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),Be({}))}function di(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return fi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return ui(r,o)}return M}var ss;function cs(e){return ss||(ss=C(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(ae("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return M}return di(e.href).pipe(E(o=>__md_set("__source",o,sessionStorage)))}).pipe(ve(()=>M),v(t=>Object.keys(t).length>0),m(t=>({facts:t})),B(1)))}function hi(e){let t=P(":scope > :last-child",e);return C(()=>{let r=new g;return r.subscribe(({facts:o})=>{t.appendChild(Sn(o)),t.classList.add("md-source__repository--active")}),cs(e).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}function ps(e,{viewport$:t,header$:r}){return ge(document.body).pipe(b(()=>mr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),Z("hidden"))}function bi(e,t){return C(()=>{let r=new g;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(G("navigation.tabs.sticky")?I({hidden:!1}):ps(e,t)).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}function ls(e,{viewport$:t,header$:r}){let o=new Map,n=$(".md-nav__link",e);for(let s of n){let p=decodeURIComponent(s.hash.substring(1)),c=fe(`[id="${p}"]`);typeof c!="undefined"&&o.set(s,c)}let i=r.pipe(Z("height"),m(({height:s})=>{let p=Se("main"),c=P(":scope > :first-child",p);return s+.8*(c.offsetTop-p.offsetTop)}),pe());return ge(document.body).pipe(Z("height"),b(s=>C(()=>{let p=[];return I([...o].reduce((c,[l,f])=>{for(;p.length&&o.get(p[p.length-1]).tagName>=f.tagName;)p.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let h=f.offsetParent;for(;h;h=h.offsetParent)u+=h.offsetTop;return c.set([...p=[...p,l]].reverse(),u)},new Map))}).pipe(m(p=>new Map([...p].sort(([,c],[,l])=>c-l))),We(i),b(([p,c])=>t.pipe(jr(([l,f],{offset:{y:u},size:h})=>{let w=u+h.height>=Math.floor(s.height);for(;f.length;){let[,A]=f[0];if(A-c<u||w)l=[...l,f.shift()];else break}for(;l.length;){let[,A]=l[l.length-1];if(A-c>=u&&!w)f=[l.pop(),...f];else break}return[l,f]},[[],[...p]]),K((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,p])=>({prev:s.map(([c])=>c),next:p.map(([c])=>c)})),Q({prev:[],next:[]}),Ye(2,1),m(([s,p])=>s.prev.length<p.prev.length?{prev:p.prev.slice(Math.max(0,s.prev.length-1),p.prev.length),next:[]}:{prev:p.prev.slice(-1),next:p.next.slice(0,p.next.length-s.next.length)}))}function vi(e,{viewport$:t,header$:r,main$:o,target$:n}){return C(()=>{let i=new g,a=i.pipe(X(),ne(!0));if(i.subscribe(({prev:s,next:p})=>{for(let[c]of p)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",c===s.length-1)}),G("toc.follow")){let s=S(t.pipe(_e(1),m(()=>{})),t.pipe(_e(250),m(()=>"smooth")));i.pipe(v(({prev:p})=>p.length>0),We(o.pipe(be(se))),ee(s)).subscribe(([[{prev:p}],c])=>{let[l]=p[p.length-1];if(l.offsetHeight){let f=cr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ce(f);f.scrollTo({top:u-h/2,behavior:c})}}})}return G("navigation.tracking")&&t.pipe(U(a),Z("offset"),_e(250),Ce(1),U(n.pipe(Ce(1))),st({delay:250}),ee(i)).subscribe(([,{prev:s}])=>{let p=xe(),c=s[s.length-1];if(c&&c.length){let[l]=c,{hash:f}=new URL(l.href);p.hash!==f&&(p.hash=f,history.replaceState({},"",`${p}`))}else p.hash="",history.replaceState({},"",`${p}`)}),ls(e,{viewport$:t,header$:r}).pipe(E(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))})}function ms(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Ye(2,1),m(([a,s])=>a>s&&s>0),K()),i=r.pipe(m(({active:a})=>a));return z([i,n]).pipe(m(([a,s])=>!(a&&s)),K(),U(o.pipe(Ce(1))),ne(!0),st({delay:250}),m(a=>({hidden:a})))}function gi(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new g,a=i.pipe(X(),ne(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(U(a),Z("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),d(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),ms(e,{viewport$:t,main$:o,target$:n}).pipe(E(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))}function xi({document$:e,viewport$:t}){e.pipe(b(()=>$(".md-ellipsis")),oe(r=>tt(r).pipe(U(e.pipe(Ce(1))),v(o=>o),m(()=>r),Te(1))),v(r=>r.offsetWidth<r.scrollWidth),oe(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,lt(n,{viewport$:t}).pipe(U(e.pipe(Ce(1))),L(()=>n.removeAttribute("title")))})).subscribe(),e.pipe(b(()=>$(".md-status")),oe(r=>lt(r,{viewport$:t}))).subscribe()}function yi({document$:e,tablet$:t}){e.pipe(b(()=>$(".md-toggle--indeterminate")),E(r=>{r.indeterminate=!0,r.checked=!1}),oe(r=>d(r,"change").pipe(Dr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),ee(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function fs(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Ei({document$:e}){e.pipe(b(()=>$("[data-md-scrollfix]")),E(t=>t.removeAttribute("data-md-scrollfix")),v(fs),oe(t=>d(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function wi({viewport$:e,tablet$:t}){z([Ve("search"),t]).pipe(m(([r,o])=>r&&!o),b(r=>I(r).pipe(Ge(r?400:100))),ee(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function us(){return location.protocol==="file:"?wt(`${new URL("search/search_index.js",Xr.base)}`).pipe(m(()=>__index),B(1)):Ne(new URL("search/search_index.json",Xr.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ot=Yo(),jt=nn(),Ot=cn(jt),Zr=on(),Oe=bn(),hr=$t("(min-width: 960px)"),Si=$t("(min-width: 1220px)"),Oi=pn(),Xr=ye(),Mi=document.forms.namedItem("search")?us():Ke,eo=new g;Bn({alert$:eo});var to=new g;G("navigation.instant")&&Zn({location$:jt,viewport$:Oe,progress$:to}).subscribe(ot);var Ti;((Ti=Xr.version)==null?void 0:Ti.provider)==="mike"&&ii({document$:ot});S(jt,Ot).pipe(Ge(125)).subscribe(()=>{Je("drawer",!1),Je("search",!1)});Zr.pipe(v(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=fe("link[rel=prev]");typeof t!="undefined"&&pt(t);break;case"n":case".":let r=fe("link[rel=next]");typeof r!="undefined"&&pt(r);break;case"Enter":let o=Re();o instanceof HTMLLabelElement&&o.click()}});xi({viewport$:Oe,document$:ot});yi({document$:ot,tablet$:hr});Ei({document$:ot});wi({viewport$:Oe,tablet$:hr});var rt=Nn(Se("header"),{viewport$:Oe}),Ft=ot.pipe(m(()=>Se("main")),b(e=>Qn(e,{viewport$:Oe,header$:rt})),B(1)),ds=S(...ae("consent").map(e=>xn(e,{target$:Ot})),...ae("dialog").map(e=>Dn(e,{alert$:eo})),...ae("header").map(e=>zn(e,{viewport$:Oe,header$:rt,main$:Ft})),...ae("palette").map(e=>Kn(e)),...ae("progress").map(e=>Yn(e,{progress$:to})),...ae("search").map(e=>li(e,{index$:Mi,keyboard$:Zr})),...ae("source").map(e=>hi(e))),hs=C(()=>S(...ae("announce").map(e=>gn(e)),...ae("content").map(e=>Un(e,{viewport$:Oe,target$:Ot,print$:Oi})),...ae("content").map(e=>G("search.highlight")?mi(e,{index$:Mi,location$:jt}):M),...ae("header-title").map(e=>qn(e,{viewport$:Oe,header$:rt})),...ae("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Nr(Si,()=>Jr(e,{viewport$:Oe,header$:rt,main$:Ft})):Nr(hr,()=>Jr(e,{viewport$:Oe,header$:rt,main$:Ft}))),...ae("tabs").map(e=>bi(e,{viewport$:Oe,header$:rt})),...ae("toc").map(e=>vi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Ot})),...ae("top").map(e=>gi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Ot})))),Li=ot.pipe(b(()=>hs),Pe(ds),B(1));Li.subscribe();window.document$=ot;window.location$=jt;window.target$=Ot;window.keyboard$=Zr;window.viewport$=Oe;window.tablet$=hr;window.screen$=Si;window.print$=Oi;window.alert$=eo;window.progress$=to;window.component$=Li;})();
-//# sourceMappingURL=bundle.081f42fc.min.js.map
+  `):"",this.name="UnsubscriptionError",this.errors=r}});function qe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Fe=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=de(a),p=s.next();!p.done;p=s.next()){var c=p.value;c.remove(this)}}catch(A){t={error:A}}finally{try{p&&!p.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(k(l))try{l()}catch(A){i=A instanceof zt?A.errors:[A]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=de(f),h=u.next();!h.done;h=u.next()){var w=h.value;try{fo(w)}catch(A){i=i!=null?i:[],A instanceof zt?i=q(q([],N(i)),N(A.errors)):i.push(A)}}}catch(A){o={error:A}}finally{try{h&&!h.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new zt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)fo(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&qe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&qe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Tr=Fe.EMPTY;function qt(e){return e instanceof Fe||e&&"closed"in e&&k(e.remove)&&k(e.add)&&k(e.unsubscribe)}function fo(e){k(e)?e():e.unsubscribe()}var $e={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var ut={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=ut.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,q([e,t],N(r))):setTimeout.apply(void 0,q([e,t],N(r)))},clearTimeout:function(e){var t=ut.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Qt(e){ut.setTimeout(function(){var t=$e.onUnhandledError;if(t)t(e);else throw e})}function he(){}var uo=function(){return Sr("C",void 0,void 0)}();function ho(e){return Sr("E",void 0,e)}function bo(e){return Sr("N",e,void 0)}function Sr(e,t,r){return{kind:e,value:t,error:r}}var it=null;function dt(e){if($e.useDeprecatedSynchronousErrorHandling){var t=!it;if(t&&(it={errorThrown:!1,error:null}),e(),t){var r=it,o=r.errorThrown,n=r.error;if(it=null,o)throw n}}else e()}function vo(e){$e.useDeprecatedSynchronousErrorHandling&&it&&(it.errorThrown=!0,it.error=e)}var Mt=function(e){re(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,qt(r)&&r.add(o)):o.destination=qi,o}return t.create=function(r,o,n){return new at(r,o,n)},t.prototype.next=function(r){this.isStopped?Mr(bo(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Mr(ho(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Mr(uo,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Fe);var Vi=Function.prototype.bind;function Or(e,t){return Vi.call(e,t)}var Ni=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Kt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Kt(o)}else Kt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Kt(r)}},e}(),at=function(e){re(t,e);function t(r,o,n){var i=e.call(this)||this,a;if(k(r)||!r)a={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var s;i&&$e.useDeprecatedNextContext?(s=Object.create(r),s.unsubscribe=function(){return i.unsubscribe()},a={next:r.next&&Or(r.next,s),error:r.error&&Or(r.error,s),complete:r.complete&&Or(r.complete,s)}):a=r}return i.destination=new Ni(a),i}return t}(Mt);function Kt(e){$e.useDeprecatedSynchronousErrorHandling?vo(e):Qt(e)}function zi(e){throw e}function Mr(e,t){var r=$e.onStoppedNotification;r&&ut.setTimeout(function(){return r(e,t)})}var qi={closed:!0,next:he,error:zi,complete:he};var ht=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function le(e){return e}function go(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Lr(e)}function Lr(e){return e.length===0?le:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var F=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=Ki(t)?t:new at(t,r,o);return dt(function(){var a=n,s=a.operator,p=a.source;i.add(s?s.call(i,p):p?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=xo(r),new r(function(n,i){var a=new at({next:function(s){try{t(s)}catch(p){i(p),a.unsubscribe()}},error:i,complete:n});o.subscribe(a)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[ht]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Lr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=xo(t),new t(function(o,n){var i;r.subscribe(function(a){return i=a},function(a){return n(a)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function xo(e){var t;return(t=e!=null?e:$e.Promise)!==null&&t!==void 0?t:Promise}function Qi(e){return e&&k(e.next)&&k(e.error)&&k(e.complete)}function Ki(e){return e&&e instanceof Mt||Qi(e)&&qt(e)}function Yi(e){return k(e==null?void 0:e.lift)}function y(e){return function(t){if(Yi(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function T(e,t,r,o,n){return new Bi(e,t,r,o,n)}var Bi=function(e){re(t,e);function t(r,o,n,i,a,s){var p=e.call(this,r)||this;return p.onFinalize=a,p.shouldUnsubscribe=s,p._next=o?function(c){try{o(c)}catch(l){r.error(l)}}:e.prototype._next,p._error=i?function(c){try{i(c)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,p._complete=n?function(){try{n()}catch(c){r.error(c)}finally{this.unsubscribe()}}:e.prototype._complete,p}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(Mt);var bt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=bt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Fe(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=bt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,q([],N(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=bt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,q([],N(e)))},delegate:void 0};var yo=ft(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var g=function(e){re(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new Eo(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new yo},t.prototype.next=function(r){var o=this;dt(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var a=de(o.currentObservers),s=a.next();!s.done;s=a.next()){var p=s.value;p.next(r)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;dt(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;dt(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Tr:(this.currentObservers=null,s.push(r),new Fe(function(){o.currentObservers=null,qe(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new F;return r.source=this,r},t.create=function(r,o){return new Eo(r,o)},t}(F);var Eo=function(e){re(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Tr},t}(g);var _r=function(e){re(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(g);var Lt={now:function(){return(Lt.delegate||Date).now()},delegate:void 0};var _t=function(e){re(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=Lt);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,p=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+p)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),p=0;p<s.length&&!r.closed;p+=i?1:2)r.next(s[p]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,a=r._infiniteTimeWindow,s=(a?1:2)*o;if(o<1/0&&s<i.length&&i.splice(0,i.length-s),!a){for(var p=n.now(),c=0,l=1;l<i.length&&i[l]<=p;l+=2)c=l;c&&i.splice(0,c+1)}},t}(g);var wo=function(e){re(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Fe);var At={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=At.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,q([e,t],N(r))):setInterval.apply(void 0,q([e,t],N(r)))},clearInterval:function(e){var t=At.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var vt=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,a=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(a,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(a,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),At.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&At.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(a){n=!0,i=a||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,qe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(wo);var Ar=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=Lt.now,e}();var gt=function(e){re(t,e);function t(r,o){o===void 0&&(o=Ar.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ar);var se=new gt(vt),Cr=se;var To=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(vt);var So=function(e){re(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(gt);var Hr=new So(To);var Oo=function(e){re(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=bt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(bt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(vt);var Mo=function(e){re(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(gt);var me=new Mo(Oo);var M=new F(function(e){return e.complete()});function Yt(e){return e&&k(e.schedule)}function kr(e){return e[e.length-1]}function Xe(e){return k(kr(e))?e.pop():void 0}function He(e){return Yt(kr(e))?e.pop():void 0}function Bt(e,t){return typeof kr(e)=="number"?e.pop():t}var xt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Gt(e){return k(e==null?void 0:e.then)}function Jt(e){return k(e[ht])}function Xt(e){return Symbol.asyncIterator&&k(e==null?void 0:e[Symbol.asyncIterator])}function Zt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Gi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var er=Gi();function tr(e){return k(e==null?void 0:e[er])}function rr(e){return lo(this,arguments,function(){var r,o,n,i;return Nt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,nt(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,nt(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,nt(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function or(e){return k(e==null?void 0:e.getReader)}function W(e){if(e instanceof F)return e;if(e!=null){if(Jt(e))return Ji(e);if(xt(e))return Xi(e);if(Gt(e))return Zi(e);if(Xt(e))return Lo(e);if(tr(e))return ea(e);if(or(e))return ta(e)}throw Zt(e)}function Ji(e){return new F(function(t){var r=e[ht]();if(k(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function Xi(e){return new F(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function Zi(e){return new F(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Qt)})}function ea(e){return new F(function(t){var r,o;try{for(var n=de(e),i=n.next();!i.done;i=n.next()){var a=i.value;if(t.next(a),t.closed)return}}catch(s){r={error:s}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Lo(e){return new F(function(t){ra(e,t).catch(function(r){return t.error(r)})})}function ta(e){return Lo(rr(e))}function ra(e,t){var r,o,n,i;return po(this,void 0,void 0,function(){var a,s;return Nt(this,function(p){switch(p.label){case 0:p.trys.push([0,5,6,11]),r=mo(e),p.label=1;case 1:return[4,r.next()];case 2:if(o=p.sent(),!!o.done)return[3,4];if(a=o.value,t.next(a),t.closed)return[2];p.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return s=p.sent(),n={error:s},[3,11];case 6:return p.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:p.sent(),p.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function we(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function be(e,t){return t===void 0&&(t=0),y(function(r,o){r.subscribe(T(o,function(n){return we(o,e,function(){return o.next(n)},t)},function(){return we(o,e,function(){return o.complete()},t)},function(n){return we(o,e,function(){return o.error(n)},t)}))})}function Qe(e,t){return t===void 0&&(t=0),y(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function _o(e,t){return W(e).pipe(Qe(t),be(t))}function Ao(e,t){return W(e).pipe(Qe(t),be(t))}function Co(e,t){return new F(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function Ho(e,t){return new F(function(r){var o;return we(r,t,function(){o=e[er](),we(r,t,function(){var n,i,a;try{n=o.next(),i=n.value,a=n.done}catch(s){r.error(s);return}a?r.complete():r.next(i)},0,!0)}),function(){return k(o==null?void 0:o.return)&&o.return()}})}function nr(e,t){if(!e)throw new Error("Iterable cannot be null");return new F(function(r){we(r,t,function(){var o=e[Symbol.asyncIterator]();we(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function ko(e,t){return nr(rr(e),t)}function $o(e,t){if(e!=null){if(Jt(e))return _o(e,t);if(xt(e))return Co(e,t);if(Gt(e))return Ao(e,t);if(Xt(e))return nr(e,t);if(tr(e))return Ho(e,t);if(or(e))return ko(e,t)}throw Zt(e)}function ue(e,t){return t?$o(e,t):W(e)}function I(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e);return ue(e,r)}function $r(e,t){var r=k(e)?e:function(){return e},o=function(n){return n.error(r())};return new F(t?function(n){return t.schedule(o,0,n)}:o)}var ir=ft(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Po(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return y(function(r,o){var n=0;r.subscribe(T(o,function(i){o.next(e.call(t,i,n++))}))})}var oa=Array.isArray;function na(e,t){return oa(t)?e.apply(void 0,q([],N(t))):e(t)}function Ze(e){return m(function(t){return na(e,t)})}var ia=Array.isArray,aa=Object.getPrototypeOf,sa=Object.prototype,ca=Object.keys;function Ro(e){if(e.length===1){var t=e[0];if(ia(t))return{args:t,keys:null};if(pa(t)){var r=ca(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function pa(e){return e&&typeof e=="object"&&aa(e)===sa}function Io(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Xe(e),n=Ro(e),i=n.args,a=n.keys;if(i.length===0)return ue([],r);var s=new F(Pr(i,r,a?function(p){return Io(a,p)}:le));return o?s.pipe(Ze(o)):s}function Pr(e,t,r){return r===void 0&&(r=le),function(o){Fo(t,function(){for(var n=e.length,i=new Array(n),a=n,s=n,p=function(l){Fo(t,function(){var f=ue(e[l],t),u=!1;f.subscribe(T(o,function(h){i[l]=h,u||(u=!0,s--),s||o.next(r(i.slice()))},function(){--a||o.complete()}))},o)},c=0;c<n;c++)p(c)},o)}}function Fo(e,t,r){e?we(r,e,t):t()}function jo(e,t,r,o,n,i,a,s){var p=[],c=0,l=0,f=!1,u=function(){f&&!p.length&&!c&&t.complete()},h=function(A){return c<o?w(A):p.push(A)},w=function(A){i&&t.next(A),c++;var te=!1;W(r(A,l++)).subscribe(T(t,function(ie){n==null||n(ie),i?h(ie):t.next(ie)},function(){te=!0},void 0,function(){if(te)try{c--;for(var ie=function(){var J=p.shift();a?we(t,a,function(){return w(J)}):w(J)};p.length&&c<o;)ie();u()}catch(J){t.error(J)}}))};return e.subscribe(T(t,h,function(){f=!0,u()})),function(){s==null||s()}}function oe(e,t,r){return r===void 0&&(r=1/0),k(t)?oe(function(o,n){return m(function(i,a){return t(o,i,n,a)})(W(e(o,n)))},r):(typeof t=="number"&&(r=t),y(function(o,n){return jo(o,n,e,r)}))}function yt(e){return e===void 0&&(e=1/0),oe(le,e)}function Wo(){return yt(1)}function je(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Wo()(ue(e,He(e)))}function C(e){return new F(function(t){W(e()).subscribe(t)})}var la=["addListener","removeListener"],ma=["addEventListener","removeEventListener"],fa=["on","off"];function d(e,t,r,o){if(k(r)&&(o=r,r=void 0),o)return d(e,t,r).pipe(Ze(o));var n=N(ha(e)?ma.map(function(s){return function(p){return e[s](t,p,r)}}):ua(e)?la.map(Uo(e,t)):da(e)?fa.map(Uo(e,t)):[],2),i=n[0],a=n[1];if(!i&&xt(e))return oe(function(s){return d(s,t,r)})(W(e));if(!i)throw new TypeError("Invalid event target");return new F(function(s){var p=function(){for(var c=[],l=0;l<arguments.length;l++)c[l]=arguments[l];return s.next(1<c.length?c:c[0])};return i(p),function(){return a(p)}})}function Uo(e,t){return function(r){return function(o){return e[r](t,o)}}}function ua(e){return k(e.addListener)&&k(e.removeListener)}function da(e){return k(e.on)&&k(e.off)}function ha(e){return k(e.addEventListener)&&k(e.removeEventListener)}function ar(e,t,r){return r?ar(e,t).pipe(Ze(r)):new F(function(o){var n=function(){for(var a=[],s=0;s<arguments.length;s++)a[s]=arguments[s];return o.next(a.length===1?a[0]:a)},i=e(n);return k(t)?function(){return t(n,i)}:void 0})}function Me(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Cr);var o=-1;return t!=null&&(Yt(t)?r=t:o=t),new F(function(n){var i=Po(e)?+e-r.now():e;i<0&&(i=0);var a=0;return r.schedule(function(){n.closed||(n.next(a++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function S(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Bt(e,1/0),n=e;return n.length?n.length===1?W(n[0]):yt(o)(ue(n,r)):M}var Ke=new F(he);var ba=Array.isArray;function Et(e){return e.length===1&&ba(e[0])?e[0]:e}function b(e,t){return y(function(r,o){var n=0;r.subscribe(T(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function Ct(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e),o=Et(e);return o.length?new F(function(n){var i=o.map(function(){return[]}),a=o.map(function(){return!1});n.add(function(){i=a=null});for(var s=function(c){W(o[c]).subscribe(T(n,function(l){if(i[c].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,q([],N(f))):f),i.some(function(u,h){return!u.length&&a[h]})&&n.complete()}},function(){a[c]=!0,!i[c].length&&n.complete()}))},p=0;!n.closed&&p<o.length;p++)s(p);return function(){i=a=null}}):M}function Do(e){return y(function(t,r){var o=!1,n=null,i=null,a=!1,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var c=n;n=null,r.next(c)}a&&r.complete()},p=function(){i=null,a&&r.complete()};t.subscribe(T(r,function(c){o=!0,n=c,i||W(e(c)).subscribe(i=T(r,s,p))},function(){a=!0,(!o||!i||i.closed)&&r.complete()}))})}function Le(e,t){return t===void 0&&(t=se),Do(function(){return Me(e,t)})}function Ye(e,t){return t===void 0&&(t=null),t=t!=null?t:e,y(function(r,o){var n=[],i=0;r.subscribe(T(o,function(a){var s,p,c,l,f=null;i++%t===0&&n.push([]);try{for(var u=de(n),h=u.next();!h.done;h=u.next()){var w=h.value;w.push(a),e<=w.length&&(f=f!=null?f:[],f.push(w))}}catch(ie){s={error:ie}}finally{try{h&&!h.done&&(p=u.return)&&p.call(u)}finally{if(s)throw s.error}}if(f)try{for(var A=de(f),te=A.next();!te.done;te=A.next()){var w=te.value;qe(n,w),o.next(w)}}catch(ie){c={error:ie}}finally{try{te&&!te.done&&(l=A.return)&&l.call(A)}finally{if(c)throw c.error}}},function(){var a,s;try{for(var p=de(n),c=p.next();!c.done;c=p.next()){var l=c.value;o.next(l)}}catch(f){a={error:f}}finally{try{c&&!c.done&&(s=p.return)&&s.call(p)}finally{if(a)throw a.error}}o.complete()},void 0,function(){n=null}))})}function ve(e){return y(function(t,r){var o=null,n=!1,i;o=t.subscribe(T(r,void 0,void 0,function(a){i=W(e(a,ve(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function Vo(e,t,r,o,n){return function(i,a){var s=r,p=t,c=0;i.subscribe(T(a,function(l){var f=c++;p=s?e(p,l,f):(s=!0,l),o&&a.next(p)},n&&function(){s&&a.next(p),a.complete()}))}}function Rr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return r?go(Rr.apply(void 0,q([],N(e))),Ze(r)):y(function(o,n){Pr(q([o],N(Et(e))))(n)})}function We(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Rr.apply(void 0,q([],N(e)))}function Ht(e){return y(function(t,r){var o=!1,n=null,i=null,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var s=n;n=null,r.next(s)}};t.subscribe(T(r,function(s){i==null||i.unsubscribe(),o=!0,n=s,i=T(r,a,he),W(e(s)).subscribe(i)},function(){a(),r.complete()},void 0,function(){n=i=null}))})}function _e(e,t){return t===void 0&&(t=se),y(function(r,o){var n=null,i=null,a=null,s=function(){if(n){n.unsubscribe(),n=null;var c=i;i=null,o.next(c)}};function p(){var c=a+e,l=t.now();if(l<c){n=this.schedule(void 0,c-l),o.add(n);return}s()}r.subscribe(T(o,function(c){i=c,a=t.now(),n||(n=t.schedule(p,e),o.add(n))},function(){s(),o.complete()},void 0,function(){i=n=null}))})}function Be(e){return y(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Te(e){return e<=0?function(){return M}:y(function(t,r){var o=0;t.subscribe(T(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function X(){return y(function(e,t){e.subscribe(T(t,he))})}function No(e){return m(function(){return e})}function Ir(e,t){return t?function(r){return je(t.pipe(Te(1),X()),r.pipe(Ir(e)))}:oe(function(r,o){return W(e(r,o)).pipe(Te(1),No(r))})}function Ge(e,t){t===void 0&&(t=se);var r=Me(e,t);return Ir(function(){return r})}function K(e,t){return t===void 0&&(t=le),e=e!=null?e:va,y(function(r,o){var n,i=!0;r.subscribe(T(o,function(a){var s=t(a);(i||!e(n,s))&&(i=!1,n=s,o.next(a))}))})}function va(e,t){return e===t}function Z(e,t){return K(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function zo(e){return e===void 0&&(e=ga),y(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function ga(){return new ir}function ne(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return je(r,I.apply(void 0,q([],N(e))))}}function L(e){return y(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Ae(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?b(function(n,i){return e(n,i,o)}):le,Te(1),r?Be(t):zo(function(){return new ir}))}}function Fr(e){return e<=0?function(){return M}:y(function(t,r){var o=[];t.subscribe(T(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var a=de(o),s=a.next();!s.done;s=a.next()){var p=s.value;r.next(p)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function qo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e),o=Bt(e,1/0);return e=Et(e),y(function(n,i){yt(o)(ue(q([n],N(e)),r)).subscribe(i)})}function Pe(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return qo.apply(void 0,q([],N(e)))}function st(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return M}:y(function(n,i){var a=0,s,p=function(){if(s==null||s.unsubscribe(),s=null,o!=null){var l=typeof o=="number"?Me(o):W(o(a)),f=T(i,function(){f.unsubscribe(),c()});l.subscribe(f)}else c()},c=function(){var l=!1;s=n.subscribe(T(i,void 0,function(){++a<r?s?p():l=!0:i.complete()})),l&&p()};c()})}function jr(e,t){return y(Vo(e,t,arguments.length>=2,!0))}function pe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new g}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,p=s===void 0?!0:s;return function(c){var l,f,u,h=0,w=!1,A=!1,te=function(){f==null||f.unsubscribe(),f=void 0},ie=function(){te(),l=u=void 0,w=A=!1},J=function(){var H=l;ie(),H==null||H.unsubscribe()};return y(function(H,mt){h++,!A&&!w&&te();var ze=u=u!=null?u:r();mt.add(function(){h--,h===0&&!A&&!w&&(f=Wr(J,p))}),ze.subscribe(mt),!l&&h>0&&(l=new at({next:function(Ie){return ze.next(Ie)},error:function(Ie){A=!0,te(),f=Wr(ie,n,Ie),ze.error(Ie)},complete:function(){w=!0,te(),f=Wr(ie,a),ze.complete()}}),W(H).subscribe(l))})(c)}}function Wr(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new at({next:function(){n.unsubscribe(),e()}});return W(t.apply(void 0,q([],N(r)))).subscribe(n)}}function B(e,t,r){var o,n,i,a,s=!1;return e&&typeof e=="object"?(o=e.bufferSize,a=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,s=i===void 0?!1:i,r=e.scheduler):a=e!=null?e:1/0,pe({connector:function(){return new _t(a,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:s})}function Ce(e){return b(function(t,r){return e<=r})}function Ur(e){return y(function(t,r){var o=!1,n=T(r,function(){n==null||n.unsubscribe(),o=!0},he);W(e).subscribe(n),t.subscribe(T(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=He(e);return y(function(o,n){(r?je(e,o,r):je(e,o)).subscribe(n)})}function v(e,t){return y(function(r,o){var n=null,i=0,a=!1,s=function(){return a&&!n&&o.complete()};r.subscribe(T(o,function(p){n==null||n.unsubscribe();var c=0,l=i++;W(e(p,l)).subscribe(n=T(o,function(f){return o.next(t?t(p,f,l,c++):f)},function(){n=null,s()}))},function(){a=!0,s()}))})}function U(e){return y(function(t,r){W(e).subscribe(T(r,function(){return r.complete()},he)),!r.closed&&t.subscribe(r)})}function Dr(e,t){return t===void 0&&(t=!1),y(function(r,o){var n=0;r.subscribe(T(o,function(i){var a=e(i,n++);(a||t)&&o.next(i),!a&&o.complete()}))})}function E(e,t,r){var o=k(e)||t||r?{next:e,error:t,complete:r}:e;return o?y(function(n,i){var a;(a=o.subscribe)===null||a===void 0||a.call(o);var s=!0;n.subscribe(T(i,function(p){var c;(c=o.next)===null||c===void 0||c.call(o,p),i.next(p)},function(){var p;s=!1,(p=o.complete)===null||p===void 0||p.call(o),i.complete()},function(p){var c;s=!1,(c=o.error)===null||c===void 0||c.call(o,p),i.error(p)},function(){var p,c;s&&((p=o.unsubscribe)===null||p===void 0||p.call(o)),(c=o.finalize)===null||c===void 0||c.call(o)}))}):le}function Qo(e,t){return y(function(r,o){var n=t!=null?t:{},i=n.leading,a=i===void 0?!0:i,s=n.trailing,p=s===void 0?!1:s,c=!1,l=null,f=null,u=!1,h=function(){f==null||f.unsubscribe(),f=null,p&&(te(),u&&o.complete())},w=function(){f=null,u&&o.complete()},A=function(ie){return f=W(e(ie)).subscribe(T(o,h,w))},te=function(){if(c){c=!1;var ie=l;l=null,o.next(ie),!u&&A(ie)}};r.subscribe(T(o,function(ie){c=!0,l=ie,!(f&&!f.closed)&&(a?te():A(ie))},function(){u=!0,!(p&&c&&f&&!f.closed)&&o.complete()}))})}function ct(e,t,r){t===void 0&&(t=se);var o=Me(e,t);return Qo(function(){return o},r)}function ee(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return y(function(o,n){for(var i=e.length,a=new Array(i),s=e.map(function(){return!1}),p=!1,c=function(f){W(e[f]).subscribe(T(n,function(u){a[f]=u,!p&&!s[f]&&(s[f]=!0,(p=s.every(le))&&(s=null))},he))},l=0;l<i;l++)c(l);o.subscribe(T(n,function(f){if(p){var u=q([f],N(a));n.next(r?r.apply(void 0,q([],N(u))):u)}}))})}function Ko(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return y(function(r,o){Ct.apply(void 0,q([r],N(e))).subscribe(o)})}function Vr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Ko.apply(void 0,q([],N(e)))}function Yo(){let e=new _t(1);return d(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function $(e,t=document){return Array.from(t.querySelectorAll(e))}function P(e,t=document){let r=fe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function fe(e,t=document){return t.querySelector(e)||void 0}function Re(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var xa=S(d(document.body,"focusin"),d(document.body,"focusout")).pipe(_e(1),Q(void 0),m(()=>Re()||document.body),B(1));function et(e){return xa.pipe(m(t=>e.contains(t)),K())}function kt(e,t){return C(()=>S(d(e,"mouseenter").pipe(m(()=>!0)),d(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ht(r=>Me(+!r*t)):le,Q(e.matches(":hover"))))}function Bo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Bo(e,r)}function x(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Bo(o,n);return o}function sr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function wt(e){let t=x("script",{src:e});return C(()=>(document.head.appendChild(t),S(d(t,"load"),d(t,"error").pipe(v(()=>$r(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),L(()=>document.head.removeChild(t)),Te(1))))}var Go=new g,ya=C(()=>typeof ResizeObserver=="undefined"?wt("https://unpkg.com/resize-observer-polyfill"):I(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>Go.next(t)))),v(e=>S(Ke,I(e)).pipe(L(()=>e.disconnect()))),B(1));function ce(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return ya.pipe(E(r=>r.observe(t)),v(r=>Go.pipe(b(o=>o.target===t),L(()=>r.unobserve(t)))),m(()=>ce(e)),Q(ce(e)))}function Tt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function Jo(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Ue(e){return{x:e.offsetLeft,y:e.offsetTop}}function Xo(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function Zo(e){return S(d(window,"load"),d(window,"resize")).pipe(Le(0,me),m(()=>Ue(e)),Q(Ue(e)))}function pr(e){return{x:e.scrollLeft,y:e.scrollTop}}function De(e){return S(d(e,"scroll"),d(window,"scroll"),d(window,"resize")).pipe(Le(0,me),m(()=>pr(e)),Q(pr(e)))}var en=new g,Ea=C(()=>I(new IntersectionObserver(e=>{for(let t of e)en.next(t)},{threshold:0}))).pipe(v(e=>S(Ke,I(e)).pipe(L(()=>e.disconnect()))),B(1));function tt(e){return Ea.pipe(E(t=>t.observe(e)),v(t=>en.pipe(b(({target:r})=>r===e),L(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function tn(e,t=16){return De(e).pipe(m(({y:r})=>{let o=ce(e),n=Tt(e);return r>=n.height-o.height-t}),K())}var lr={drawer:P("[data-md-toggle=drawer]"),search:P("[data-md-toggle=search]")};function rn(e){return lr[e].checked}function Je(e,t){lr[e].checked!==t&&lr[e].click()}function Ve(e){let t=lr[e];return d(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function wa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Ta(){return S(d(window,"compositionstart").pipe(m(()=>!0)),d(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function on(){let e=d(window,"keydown").pipe(b(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:rn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),b(({mode:t,type:r})=>{if(t==="global"){let o=Re();if(typeof o!="undefined")return!wa(o,r)}return!0}),pe());return Ta().pipe(v(t=>t?M:e))}function xe(){return new URL(location.href)}function pt(e,t=!1){if(G("navigation.instant")&&!t){let r=x("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function nn(){return new g}function an(){return location.hash.slice(1)}function sn(e){let t=x("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Sa(e){return S(d(window,"hashchange"),e).pipe(m(an),Q(an()),b(t=>t.length>0),B(1))}function cn(e){return Sa(e).pipe(m(t=>fe(`[id="${t}"]`)),b(t=>typeof t!="undefined"))}function $t(e){let t=matchMedia(e);return ar(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function pn(){let e=matchMedia("print");return S(d(window,"beforeprint").pipe(m(()=>!0)),d(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function Nr(e,t){return e.pipe(v(r=>r?t():M))}function zr(e,t){return new F(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let a=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+a*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function Ne(e,t){return zr(e,t).pipe(v(r=>r.text()),m(r=>JSON.parse(r)),B(1))}function ln(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),B(1))}function mn(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),B(1))}function fn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function un(){return S(d(window,"scroll",{passive:!0}),d(window,"resize",{passive:!0})).pipe(m(fn),Q(fn()))}function dn(){return{width:innerWidth,height:innerHeight}}function hn(){return d(window,"resize",{passive:!0}).pipe(m(dn),Q(dn()))}function bn(){return z([un(),hn()]).pipe(m(([e,t])=>({offset:e,size:t})),B(1))}function mr(e,{viewport$:t,header$:r}){let o=t.pipe(Z("size")),n=z([o,r]).pipe(m(()=>Ue(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:p,y:c}])=>({offset:{x:a.x-p,y:a.y-c+i},size:s})))}function Oa(e){return d(e,"message",t=>t.data)}function Ma(e){let t=new g;return t.subscribe(r=>e.postMessage(r)),t}function vn(e,t=new Worker(e)){let r=Oa(t),o=Ma(t),n=new g;n.subscribe(o);let i=o.pipe(X(),ne(!0));return n.pipe(X(),Pe(r.pipe(U(i))),pe())}var La=P("#__config"),St=JSON.parse(La.textContent);St.base=`${new URL(St.base,xe())}`;function ye(){return St}function G(e){return St.features.includes(e)}function Ee(e,t){return typeof t!="undefined"?St.translations[e].replace("#",t.toString()):St.translations[e]}function Se(e,t=document){return P(`[data-md-component=${e}]`,t)}function ae(e,t=document){return $(`[data-md-component=${e}]`,t)}function _a(e){let t=P(".md-typeset > :first-child",e);return d(t,"click",{once:!0}).pipe(m(()=>P(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function gn(e){if(!G("announce.dismiss")||!e.childElementCount)return M;if(!e.hidden){let t=P(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return C(()=>{let t=new g;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),_a(e).pipe(E(r=>t.next(r)),L(()=>t.complete()),m(r=>R({ref:e},r)))})}function Aa(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function xn(e,t){let r=new g;return r.subscribe(({hidden:o})=>{e.hidden=o}),Aa(e,t).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))}function Pt(e,t){return t==="inline"?x("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"})):x("div",{class:"md-tooltip",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"}))}function yn(...e){return x("div",{class:"md-tooltip2",role:"tooltip"},x("div",{class:"md-tooltip2__inner md-typeset"},e))}function En(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return x("aside",{class:"md-annotation",tabIndex:0},Pt(t),x("a",{href:r,class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}else return x("aside",{class:"md-annotation",tabIndex:0},Pt(t),x("span",{class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}function wn(e){return x("button",{class:"md-clipboard md-icon",title:Ee("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}function qr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(p=>!e.terms[p]).reduce((p,c)=>[...p,x("del",null,c)," "],[]).slice(0,-1),i=ye(),a=new URL(e.location,i.base);G("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,p])=>p).reduce((p,[c])=>`${p} ${c}`.trim(),""));let{tags:s}=ye();return x("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},x("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&x("div",{class:"md-search-result__icon md-icon"}),r>0&&x("h1",null,e.title),r<=0&&x("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&e.tags.map(p=>{let c=s?p in s?`md-tag-icon md-tag--${s[p]}`:"md-tag-icon":"";return x("span",{class:`md-tag ${c}`},p)}),o>0&&n.length>0&&x("p",{class:"md-search-result__terms"},Ee("search.result.term.missing"),": ",...n)))}function Tn(e){let t=e[0].score,r=[...e],o=ye(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.score<t);a===-1&&(a=r.length);let s=r.slice(0,a),p=r.slice(a),c=[qr(i,2|+(!n&&a===0)),...s.map(l=>qr(l,1)),...p.length?[x("details",{class:"md-search-result__more"},x("summary",{tabIndex:-1},x("div",null,p.length>0&&p.length===1?Ee("search.result.more.one"):Ee("search.result.more.other",p.length))),...p.map(l=>qr(l,1)))]:[]];return x("li",{class:"md-search-result__item"},c)}function Sn(e){return x("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>x("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?sr(r):r)))}function Qr(e){let t=`tabbed-control tabbed-control--${e}`;return x("div",{class:t,hidden:!0},x("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function On(e){return x("div",{class:"md-typeset__scrollwrap"},x("div",{class:"md-typeset__table"},e))}function Ca(e){var o;let t=ye(),r=new URL(`../${e.version}/`,t.base);return x("li",{class:"md-version__item"},x("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&x("span",{class:"md-version__alias"},e.aliases[0])))}function Mn(e,t){var o;let r=ye();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),x("div",{class:"md-version"},x("button",{class:"md-version__current","aria-label":Ee("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&x("span",{class:"md-version__alias"},t.aliases[0])),x("ul",{class:"md-version__list"},e.map(Ca)))}var Ha=0;function ka(e){let t=z([et(e),kt(e)]).pipe(m(([o,n])=>o||n),K()),r=C(()=>Jo(e)).pipe(oe(De),ct(1),m(()=>Xo(e)));return t.pipe(Ae(o=>o),v(()=>z([t,r])),m(([o,n])=>({active:o,offset:n})),pe())}function $a(e,t){let{content$:r,viewport$:o}=t,n=`__tooltip2_${Ha++}`;return C(()=>{let i=new g,a=new _r(!1);i.pipe(X(),ne(!1)).subscribe(a);let s=a.pipe(Ht(c=>Me(+!c*250,Hr)),K(),v(c=>c?r:M),E(c=>c.id=n),pe());z([i.pipe(m(({active:c})=>c)),s.pipe(v(c=>kt(c,250)),Q(!1))]).pipe(m(c=>c.some(l=>l))).subscribe(a);let p=a.pipe(b(c=>c),ee(s,o),m(([c,l,{size:f}])=>{let u=e.getBoundingClientRect(),h=u.width/2;if(l.role==="tooltip")return{x:h,y:8+u.height};if(u.y>=f.height/2){let{height:w}=ce(l);return{x:h,y:-16-w}}else return{x:h,y:16+u.height}}));return z([s,i,p]).subscribe(([c,{offset:l},f])=>{c.style.setProperty("--md-tooltip-host-x",`${l.x}px`),c.style.setProperty("--md-tooltip-host-y",`${l.y}px`),c.style.setProperty("--md-tooltip-x",`${f.x}px`),c.style.setProperty("--md-tooltip-y",`${f.y}px`),c.classList.toggle("md-tooltip2--top",f.y<0),c.classList.toggle("md-tooltip2--bottom",f.y>=0)}),a.pipe(b(c=>c),ee(s,(c,l)=>l),b(c=>c.role==="tooltip")).subscribe(c=>{let l=ce(P(":scope > *",c));c.style.setProperty("--md-tooltip-width",`${l.width}px`),c.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(K(),be(me),ee(s)).subscribe(([c,l])=>{l.classList.toggle("md-tooltip2--active",c)}),z([a.pipe(b(c=>c)),s]).subscribe(([c,l])=>{l.role==="dialog"?(e.setAttribute("aria-controls",n),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",n)}),a.pipe(b(c=>!c)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),ka(e).pipe(E(c=>i.next(c)),L(()=>i.complete()),m(c=>R({ref:e},c)))})}function lt(e,{viewport$:t},r=document.body){return $a(e,{content$:new F(o=>{let n=e.title,i=yn(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t})}function Pa(e,t){let r=C(()=>z([Zo(e),De(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ce(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return et(e).pipe(v(o=>r.pipe(m(n=>({active:o,offset:n})),Te(+!o||1/0))))}function Ln(e,t,{target$:r}){let[o,n]=Array.from(e.children);return C(()=>{let i=new g,a=i.pipe(X(),ne(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),tt(e).pipe(U(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),S(i.pipe(b(({active:s})=>s)),i.pipe(_e(250),b(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Le(16,me)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(ct(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),d(n,"click").pipe(U(a),b(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),d(n,"mousedown").pipe(U(a),ee(i)).subscribe(([s,{active:p}])=>{var c;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(p){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(c=Re())==null||c.blur()}}),r.pipe(U(a),b(s=>s===o),Ge(125)).subscribe(()=>e.focus()),Pa(e,t).pipe(E(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))})}function Ra(e){return e.tagName==="CODE"?$(".c, .c1, .cm",e):[e]}function Ia(e){let t=[];for(let r of Ra(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,p]=a;if(typeof p=="undefined"){let c=i.splitText(a.index);i=c.splitText(s.length),t.push(c)}else{i.textContent=s,t.push(i);break}}}}return t}function _n(e,t){t.append(...Array.from(e.childNodes))}function fr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Ia(t)){let[,p]=s.textContent.match(/\((\d+)\)/);fe(`:scope > li:nth-child(${p})`,e)&&(a.set(p,En(p,i)),s.replaceWith(a.get(p)))}return a.size===0?M:C(()=>{let s=new g,p=s.pipe(X(),ne(!0)),c=[];for(let[l,f]of a)c.push([P(".md-typeset",f),P(`:scope > li:nth-child(${l})`,e)]);return o.pipe(U(p)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of c)l?_n(f,u):_n(u,f)}),S(...[...a].map(([,l])=>Ln(l,t,{target$:r}))).pipe(L(()=>s.complete()),pe())})}function An(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return An(t)}}function Cn(e,t){return C(()=>{let r=An(e);return typeof r!="undefined"?fr(r,e,t):M})}var Hn=Vt(Yr());var Fa=0;function kn(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return kn(t)}}function ja(e){return ge(e).pipe(m(({width:t})=>({scrollable:Tt(e).width>t})),Z("scrollable"))}function $n(e,t){let{matches:r}=matchMedia("(hover)"),o=C(()=>{let n=new g,i=n.pipe(Fr(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=[];if(Hn.default.isSupported()&&(e.closest(".copy")||G("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${Fa++}`;let l=wn(c.id);c.insertBefore(l,e),G("content.tooltips")&&a.push(lt(l,{viewport$}))}let s=e.closest(".highlight");if(s instanceof HTMLElement){let c=kn(s);if(typeof c!="undefined"&&(s.classList.contains("annotate")||G("content.code.annotate"))){let l=fr(c,e,t);a.push(ge(s).pipe(U(i),m(({width:f,height:u})=>f&&u),K(),v(f=>f?l:M)))}}return $(":scope > span[id]",e).length&&e.classList.add("md-code__content"),ja(e).pipe(E(c=>n.next(c)),L(()=>n.complete()),m(c=>R({ref:e},c)),Pe(...a))});return G("content.lazy")?tt(e).pipe(b(n=>n),Te(1),v(()=>o)):o}function Wa(e,{target$:t,print$:r}){let o=!0;return S(t.pipe(m(n=>n.closest("details:not([open])")),b(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(b(n=>n||!o),E(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Pn(e,t){return C(()=>{let r=new g;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),Wa(e,t).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}var Rn=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var Br,Da=0;function Va(){return typeof mermaid=="undefined"||mermaid instanceof Element?wt("https://unpkg.com/mermaid@10/dist/mermaid.min.js"):I(void 0)}function In(e){return e.classList.remove("mermaid"),Br||(Br=Va().pipe(E(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Rn,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),B(1))),Br.subscribe(()=>ao(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Da++}`,r=x("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})),Br.pipe(m(()=>({ref:e})))}var Fn=x("table");function jn(e){return e.replaceWith(Fn),Fn.replaceWith(On(e)),I({ref:e})}function Na(e){let t=e.find(r=>r.checked)||e[0];return S(...e.map(r=>d(r,"change").pipe(m(()=>P(`label[for="${r.id}"]`))))).pipe(Q(P(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Wn(e,{viewport$:t,target$:r}){let o=P(".tabbed-labels",e),n=$(":scope > input",e),i=Qr("prev");e.append(i);let a=Qr("next");return e.append(a),C(()=>{let s=new g,p=s.pipe(X(),ne(!0));z([s,ge(e),tt(e)]).pipe(U(p),Le(1,me)).subscribe({next([{active:c},l]){let f=Ue(c),{width:u}=ce(c);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let h=pr(o);(f.x<h.x||f.x+u>h.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([De(o),ge(o)]).pipe(U(p)).subscribe(([c,l])=>{let f=Tt(o);i.hidden=c.x<16,a.hidden=c.x>f.width-l.width-16}),S(d(i,"click").pipe(m(()=>-1)),d(a,"click").pipe(m(()=>1))).pipe(U(p)).subscribe(c=>{let{width:l}=ce(o);o.scrollBy({left:l*c,behavior:"smooth"})}),r.pipe(U(p),b(c=>n.includes(c))).subscribe(c=>c.click()),o.classList.add("tabbed-labels--linked");for(let c of n){let l=P(`label[for="${c.id}"]`);l.replaceChildren(x("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),d(l.firstElementChild,"click").pipe(U(p),b(f=>!(f.metaKey||f.ctrlKey)),E(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return G("content.tabs.link")&&s.pipe(Ce(1),ee(t)).subscribe(([{active:c},{offset:l}])=>{let f=c.innerText.trim();if(c.hasAttribute("data-md-switching"))c.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let w of $("[data-tabs]"))for(let A of $(":scope > input",w)){let te=P(`label[for="${A.id}"]`);if(te!==c&&te.innerText.trim()===f){te.setAttribute("data-md-switching",""),A.click();break}}window.scrollTo({top:e.offsetTop-u});let h=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...h])])}}),s.pipe(U(p)).subscribe(()=>{for(let c of $("audio, video",e))c.pause()}),Na(n).pipe(E(c=>s.next(c)),L(()=>s.complete()),m(c=>R({ref:e},c)))}).pipe(Qe(se))}function Un(e,{viewport$:t,target$:r,print$:o}){return S(...$(".annotate:not(.highlight)",e).map(n=>Cn(n,{target$:r,print$:o})),...$("pre:not(.mermaid) > code",e).map(n=>$n(n,{target$:r,print$:o})),...$("pre.mermaid",e).map(n=>In(n)),...$("table:not([class])",e).map(n=>jn(n)),...$("details",e).map(n=>Pn(n,{target$:r,print$:o})),...$("[data-tabs]",e).map(n=>Wn(n,{viewport$:t,target$:r})),...$("[title]",e).filter(()=>G("content.tooltips")).map(n=>lt(n,{viewport$:t})))}function za(e,{alert$:t}){return t.pipe(v(r=>S(I(!0),I(!1).pipe(Ge(2e3))).pipe(m(o=>({message:r,active:o})))))}function Dn(e,t){let r=P(".md-typeset",e);return C(()=>{let o=new g;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),za(e,t).pipe(E(n=>o.next(n)),L(()=>o.complete()),m(n=>R({ref:e},n)))})}var qa=0;function Qa(e,t){document.body.append(e);let{width:r}=ce(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=cr(t),n=typeof o!="undefined"?De(o):I({x:0,y:0}),i=S(et(t),kt(t)).pipe(K());return z([i,n]).pipe(m(([a,s])=>{let{x:p,y:c}=Ue(t),l=ce(t),f=t.closest("table");return f&&t.parentElement&&(p+=f.offsetLeft+t.parentElement.offsetLeft,c+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:p-s.x+l.width/2-r/2,y:c-s.y+l.height+8}}}))}function Vn(e){let t=e.title;if(!t.length)return M;let r=`__tooltip_${qa++}`,o=Pt(r,"inline"),n=P(".md-typeset",o);return n.innerHTML=t,C(()=>{let i=new g;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),S(i.pipe(b(({active:a})=>a)),i.pipe(_e(250),b(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Le(16,me)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(ct(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Qa(o,e).pipe(E(a=>i.next(a)),L(()=>i.complete()),m(a=>R({ref:e},a)))}).pipe(Qe(se))}function Ka({viewport$:e}){if(!G("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Ye(2,1),m(([n,i])=>[n<i,i]),Z(0)),r=z([e,t]).pipe(b(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),K()),o=Ve("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),K(),v(n=>n?r:I(!1)),Q(!1))}function Nn(e,t){return C(()=>z([ge(e),Ka(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),K((r,o)=>r.height===o.height&&r.hidden===o.hidden),B(1))}function zn(e,{header$:t,main$:r}){return C(()=>{let o=new g,n=o.pipe(X(),ne(!0));o.pipe(Z("active"),We(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=ue($("[title]",e)).pipe(b(()=>G("content.tooltips")),oe(a=>Vn(a)));return r.subscribe(o),t.pipe(U(n),m(a=>R({ref:e},a)),Pe(i.pipe(U(n))))})}function Ya(e,{viewport$:t,header$:r}){return mr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ce(e);return{active:o>=n}}),Z("active"))}function qn(e,t){return C(()=>{let r=new g;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=fe(".md-content h1");return typeof o=="undefined"?M:Ya(o,t).pipe(E(n=>r.next(n)),L(()=>r.complete()),m(n=>R({ref:e},n)))})}function Qn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),K()),n=o.pipe(v(()=>ge(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),Z("bottom"))));return z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:p},size:{height:c}}])=>(c=Math.max(0,c-Math.max(0,a-p,i)-Math.max(0,c+p-s)),{offset:a-i,height:c,active:a-i<=p})),K((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function Ba(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return I(...e).pipe(oe(o=>d(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),B(1))}function Kn(e){let t=$("input",e),r=x("meta",{name:"theme-color"});document.head.appendChild(r);let o=x("meta",{name:"color-scheme"});document.head.appendChild(o);let n=$t("(prefers-color-scheme: light)");return C(()=>{let i=new g;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),p=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=p.getAttribute("data-md-color-scheme"),a.color.primary=p.getAttribute("data-md-color-primary"),a.color.accent=p.getAttribute("data-md-color-accent")}for(let[s,p]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,p);for(let s=0;s<t.length;s++){let p=t[s].nextElementSibling;p instanceof HTMLElement&&(p.hidden=a.index!==s)}__md_set("__palette",a)}),d(e,"keydown").pipe(b(a=>a.key==="Enter"),ee(i,(a,s)=>s)).subscribe(({index:a})=>{a=(a+1)%t.length,t[a].click(),t[a].focus()}),i.pipe(m(()=>{let a=Se("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(p=>(+p).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(be(se)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),Ba(t).pipe(U(n.pipe(Ce(1))),st(),E(a=>i.next(a)),L(()=>i.complete()),m(a=>R({ref:e},a)))})}function Yn(e,{progress$:t}){return C(()=>{let r=new g;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(E(o=>r.next({value:o})),L(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Gr=Vt(Yr());function Ga(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Bn({alert$:e}){Gr.default.isSupported()&&new F(t=>{new Gr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||Ga(P(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(E(t=>{t.trigger.focus()}),m(()=>Ee("clipboard.copied"))).subscribe(e)}function Gn(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function Ja(e,t){let r=new Map;for(let o of $("url",e)){let n=P("loc",o),i=[Gn(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let a of $("[rel=alternate]",o)){let s=a.getAttribute("href");s!=null&&i.push(Gn(new URL(s),t))}}return r}function ur(e){return mn(new URL("sitemap.xml",e)).pipe(m(t=>Ja(t,new URL(e))),ve(()=>I(new Map)))}function Xa(e,t){if(!(e.target instanceof Element))return M;let r=e.target.closest("a");if(r===null)return M;if(r.target||e.metaKey||e.ctrlKey)return M;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),I(new URL(r.href))):M}function Jn(e){let t=new Map;for(let r of $(":scope > *",e.head))t.set(r.outerHTML,r);return t}function Xn(e){for(let t of $("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return I(e)}function Za(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...G("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=fe(o),i=fe(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=Jn(document);for(let[o,n]of Jn(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Se("container");return je($("script",r)).pipe(v(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new F(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),M}),X(),ne(document))}function Zn({location$:e,viewport$:t,progress$:r}){let o=ye();if(location.protocol==="file:")return M;let n=ur(o.base);I(document).subscribe(Xn);let i=d(document.body,"click").pipe(We(n),v(([p,c])=>Xa(p,c)),pe()),a=d(window,"popstate").pipe(m(xe),pe());i.pipe(ee(t)).subscribe(([p,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",p)}),S(i,a).subscribe(e);let s=e.pipe(Z("pathname"),v(p=>ln(p,{progress$:r}).pipe(ve(()=>(pt(p,!0),M)))),v(Xn),v(Za),pe());return S(s.pipe(ee(e,(p,c)=>c)),s.pipe(v(()=>e),Z("pathname"),v(()=>e),Z("hash")),e.pipe(K((p,c)=>p.pathname===c.pathname&&p.hash===c.hash),v(()=>i),E(()=>history.back()))).subscribe(p=>{var c,l;history.state!==null||!p.hash?window.scrollTo(0,(l=(c=history.state)==null?void 0:c.y)!=null?l:0):(history.scrollRestoration="auto",sn(p.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),d(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(Z("offset"),_e(100)).subscribe(({offset:p})=>{history.replaceState(p,"")}),s}var ri=Vt(ti());function oi(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}<mark data-md-highlight>${a}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ri.default)(a).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function It(e){return e.type===1}function dr(e){return e.type===3}function ni(e,t){let r=vn(e);return S(I(location.protocol!=="file:"),Ve("search")).pipe(Ae(o=>o),v(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:G("search.suggest")}}})),r}function ii({document$:e}){let t=ye(),r=Ne(new URL("../versions.json",t.base)).pipe(ve(()=>M)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),v(n=>d(document.body,"click").pipe(b(i=>!i.metaKey&&!i.ctrlKey),ee(o),v(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let p=s.href;return!i.target.closest(".md-version")&&n.get(p)===a?M:(i.preventDefault(),I(p))}}return M}),v(i=>ur(new URL(i)).pipe(m(a=>{let p=xe().href.replace(t.base,i);return a.has(p.split("#")[0])?new URL(p):new URL(i)})))))).subscribe(n=>pt(n,!0)),z([r,o]).subscribe(([n,i])=>{P(".md-header__topic").appendChild(Mn(n,i))}),e.pipe(v(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let p of s)for(let c of n.aliases.concat(n.version))if(new RegExp(p,"i").test(c)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of ae("outdated"))s.hidden=!1})}function ns(e,{worker$:t}){let{searchParams:r}=xe();r.has("q")&&(Je("search",!0),e.value=r.get("q"),e.focus(),Ve("search").pipe(Ae(i=>!i)).subscribe(()=>{let i=xe();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=et(e),n=S(t.pipe(Ae(It)),d(e,"keyup"),o).pipe(m(()=>e.value),K());return z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),B(1))}function ai(e,{worker$:t}){let r=new g,o=r.pipe(X(),ne(!0));z([t.pipe(Ae(It)),r],(i,a)=>a).pipe(Z("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(Z("focus")).subscribe(({focus:i})=>{i&&Je("search",i)}),d(e.form,"reset").pipe(U(o)).subscribe(()=>e.focus());let n=P("header [for=__search]");return d(n,"click").subscribe(()=>e.focus()),ns(e,{worker$:t}).pipe(E(i=>r.next(i)),L(()=>r.complete()),m(i=>R({ref:e},i)),B(1))}function si(e,{worker$:t,query$:r}){let o=new g,n=tn(e.parentElement).pipe(b(Boolean)),i=e.parentElement,a=P(":scope > :first-child",e),s=P(":scope > :last-child",e);Ve("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(ee(r),Ur(t.pipe(Ae(It)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?Ee("search.result.none"):Ee("search.result.placeholder");break;case 1:a.textContent=Ee("search.result.one");break;default:let u=sr(l.length);a.textContent=Ee("search.result.other",u)}});let p=o.pipe(E(()=>s.innerHTML=""),v(({items:l})=>S(I(...l.slice(0,10)),I(...l.slice(10)).pipe(Ye(4),Vr(n),v(([f])=>f)))),m(Tn),pe());return p.subscribe(l=>s.appendChild(l)),p.pipe(oe(l=>{let f=fe("details",l);return typeof f=="undefined"?M:d(f,"toggle").pipe(U(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(b(dr),m(({data:l})=>l)).pipe(E(l=>o.next(l)),L(()=>o.complete()),m(l=>R({ref:e},l)))}function is(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=xe();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function ci(e,t){let r=new g,o=r.pipe(X(),ne(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),d(e,"click").pipe(U(o)).subscribe(n=>n.preventDefault()),is(e,t).pipe(E(n=>r.next(n)),L(()=>r.complete()),m(n=>R({ref:e},n)))}function pi(e,{worker$:t,keyboard$:r}){let o=new g,n=Se("search-query"),i=S(d(n,"keydown"),d(n,"focus")).pipe(be(se),m(()=>n.value),K());return o.pipe(We(i),m(([{suggest:s},p])=>{let c=p.split(/([\s-]+)/);if(s!=null&&s.length&&c[c.length-1]){let l=s[s.length-1];l.startsWith(c[c.length-1])&&(c[c.length-1]=l)}else c.length=0;return c})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g,"&nbsp;")),r.pipe(b(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(b(dr),m(({data:s})=>s)).pipe(E(s=>o.next(s)),L(()=>o.complete()),m(()=>({ref:e})))}function li(e,{index$:t,keyboard$:r}){let o=ye();try{let n=ni(o.search,t),i=Se("search-query",e),a=Se("search-result",e);d(e,"click").pipe(b(({target:p})=>p instanceof Element&&!!p.closest("a"))).subscribe(()=>Je("search",!1)),r.pipe(b(({mode:p})=>p==="search")).subscribe(p=>{let c=Re();switch(p.type){case"Enter":if(c===i){let l=new Map;for(let f of $(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,h])=>h-u);f.click()}p.claim()}break;case"Escape":case"Tab":Je("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof c=="undefined")i.focus();else{let l=[i,...$(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(c))+l.length+(p.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}p.claim();break;default:i!==Re()&&i.focus()}}),r.pipe(b(({mode:p})=>p==="global")).subscribe(p=>{switch(p.type){case"f":case"s":case"/":i.focus(),i.select(),p.claim();break}});let s=ai(i,{worker$:n});return S(s,si(a,{worker$:n,query$:s})).pipe(Pe(...ae("search-share",e).map(p=>ci(p,{query$:s})),...ae("search-suggest",e).map(p=>pi(p,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Ke}}function mi(e,{index$:t,location$:r}){return z([t,r.pipe(Q(xe()),b(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>oi(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let p=s.textContent,c=o(p);c.length>p.length&&n.set(s,c)}for(let[s,p]of n){let{childNodes:c}=x("span",null,p);s.replaceWith(...Array.from(c))}return{ref:e,nodes:n}}))}function as(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),K((i,a)=>i.height===a.height&&i.locked===a.locked))}function Jr(e,o){var n=o,{header$:t}=n,r=io(n,["header$"]);let i=P(".md-sidebar__scrollwrap",e),{y:a}=Ue(i);return C(()=>{let s=new g,p=s.pipe(X(),ne(!0)),c=s.pipe(Le(0,me));return c.pipe(ee(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),c.pipe(Ae()).subscribe(()=>{for(let l of $(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ce(f);f.scrollTo({top:u-h/2})}}}),ue($("label[tabindex]",e)).pipe(oe(l=>d(l,"click").pipe(be(se),m(()=>l),U(p)))).subscribe(l=>{let f=P(`[id="${l.htmlFor}"]`);P(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),as(e,r).pipe(E(l=>s.next(l)),L(()=>s.complete()),m(l=>R({ref:e},l)))})}function fi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return Ct(Ne(`${r}/releases/latest`).pipe(ve(()=>M),m(o=>({version:o.tag_name})),Be({})),Ne(r).pipe(ve(()=>M),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),Be({}))).pipe(m(([o,n])=>R(R({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return Ne(r).pipe(m(o=>({repositories:o.public_repos})),Be({}))}}function ui(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return Ne(r).pipe(ve(()=>M),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),Be({}))}function di(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return fi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return ui(r,o)}return M}var ss;function cs(e){return ss||(ss=C(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(ae("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return M}return di(e.href).pipe(E(o=>__md_set("__source",o,sessionStorage)))}).pipe(ve(()=>M),b(t=>Object.keys(t).length>0),m(t=>({facts:t})),B(1)))}function hi(e){let t=P(":scope > :last-child",e);return C(()=>{let r=new g;return r.subscribe(({facts:o})=>{t.appendChild(Sn(o)),t.classList.add("md-source__repository--active")}),cs(e).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}function ps(e,{viewport$:t,header$:r}){return ge(document.body).pipe(v(()=>mr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),Z("hidden"))}function bi(e,t){return C(()=>{let r=new g;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(G("navigation.tabs.sticky")?I({hidden:!1}):ps(e,t)).pipe(E(o=>r.next(o)),L(()=>r.complete()),m(o=>R({ref:e},o)))})}function ls(e,{viewport$:t,header$:r}){let o=new Map,n=$(".md-nav__link",e);for(let s of n){let p=decodeURIComponent(s.hash.substring(1)),c=fe(`[id="${p}"]`);typeof c!="undefined"&&o.set(s,c)}let i=r.pipe(Z("height"),m(({height:s})=>{let p=Se("main"),c=P(":scope > :first-child",p);return s+.8*(c.offsetTop-p.offsetTop)}),pe());return ge(document.body).pipe(Z("height"),v(s=>C(()=>{let p=[];return I([...o].reduce((c,[l,f])=>{for(;p.length&&o.get(p[p.length-1]).tagName>=f.tagName;)p.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let h=f.offsetParent;for(;h;h=h.offsetParent)u+=h.offsetTop;return c.set([...p=[...p,l]].reverse(),u)},new Map))}).pipe(m(p=>new Map([...p].sort(([,c],[,l])=>c-l))),We(i),v(([p,c])=>t.pipe(jr(([l,f],{offset:{y:u},size:h})=>{let w=u+h.height>=Math.floor(s.height);for(;f.length;){let[,A]=f[0];if(A-c<u||w)l=[...l,f.shift()];else break}for(;l.length;){let[,A]=l[l.length-1];if(A-c>=u&&!w)f=[l.pop(),...f];else break}return[l,f]},[[],[...p]]),K((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,p])=>({prev:s.map(([c])=>c),next:p.map(([c])=>c)})),Q({prev:[],next:[]}),Ye(2,1),m(([s,p])=>s.prev.length<p.prev.length?{prev:p.prev.slice(Math.max(0,s.prev.length-1),p.prev.length),next:[]}:{prev:p.prev.slice(-1),next:p.next.slice(0,p.next.length-s.next.length)}))}function vi(e,{viewport$:t,header$:r,main$:o,target$:n}){return C(()=>{let i=new g,a=i.pipe(X(),ne(!0));if(i.subscribe(({prev:s,next:p})=>{for(let[c]of p)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",c===s.length-1)}),G("toc.follow")){let s=S(t.pipe(_e(1),m(()=>{})),t.pipe(_e(250),m(()=>"smooth")));i.pipe(b(({prev:p})=>p.length>0),We(o.pipe(be(se))),ee(s)).subscribe(([[{prev:p}],c])=>{let[l]=p[p.length-1];if(l.offsetHeight){let f=cr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:h}=ce(f);f.scrollTo({top:u-h/2,behavior:c})}}})}return G("navigation.tracking")&&t.pipe(U(a),Z("offset"),_e(250),Ce(1),U(n.pipe(Ce(1))),st({delay:250}),ee(i)).subscribe(([,{prev:s}])=>{let p=xe(),c=s[s.length-1];if(c&&c.length){let[l]=c,{hash:f}=new URL(l.href);p.hash!==f&&(p.hash=f,history.replaceState({},"",`${p}`))}else p.hash="",history.replaceState({},"",`${p}`)}),ls(e,{viewport$:t,header$:r}).pipe(E(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))})}function ms(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Ye(2,1),m(([a,s])=>a>s&&s>0),K()),i=r.pipe(m(({active:a})=>a));return z([i,n]).pipe(m(([a,s])=>!(a&&s)),K(),U(o.pipe(Ce(1))),ne(!0),st({delay:250}),m(a=>({hidden:a})))}function gi(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new g,a=i.pipe(X(),ne(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(U(a),Z("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),d(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),ms(e,{viewport$:t,main$:o,target$:n}).pipe(E(s=>i.next(s)),L(()=>i.complete()),m(s=>R({ref:e},s)))}function xi({document$:e,viewport$:t}){e.pipe(v(()=>$(".md-ellipsis")),oe(r=>tt(r).pipe(U(e.pipe(Ce(1))),b(o=>o),m(()=>r),Te(1))),b(r=>r.offsetWidth<r.scrollWidth),oe(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,lt(n,{viewport$:t}).pipe(U(e.pipe(Ce(1))),L(()=>n.removeAttribute("title")))})).subscribe(),e.pipe(v(()=>$(".md-status")),oe(r=>lt(r,{viewport$:t}))).subscribe()}function yi({document$:e,tablet$:t}){e.pipe(v(()=>$(".md-toggle--indeterminate")),E(r=>{r.indeterminate=!0,r.checked=!1}),oe(r=>d(r,"change").pipe(Dr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),ee(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function fs(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Ei({document$:e}){e.pipe(v(()=>$("[data-md-scrollfix]")),E(t=>t.removeAttribute("data-md-scrollfix")),b(fs),oe(t=>d(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function wi({viewport$:e,tablet$:t}){z([Ve("search"),t]).pipe(m(([r,o])=>r&&!o),v(r=>I(r).pipe(Ge(r?400:100))),ee(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function us(){return location.protocol==="file:"?wt(`${new URL("search/search_index.js",Xr.base)}`).pipe(m(()=>__index),B(1)):Ne(new URL("search/search_index.json",Xr.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ot=Yo(),jt=nn(),Ot=cn(jt),Zr=on(),Oe=bn(),hr=$t("(min-width: 960px)"),Si=$t("(min-width: 1220px)"),Oi=pn(),Xr=ye(),Mi=document.forms.namedItem("search")?us():Ke,eo=new g;Bn({alert$:eo});var to=new g;G("navigation.instant")&&Zn({location$:jt,viewport$:Oe,progress$:to}).subscribe(ot);var Ti;((Ti=Xr.version)==null?void 0:Ti.provider)==="mike"&&ii({document$:ot});S(jt,Ot).pipe(Ge(125)).subscribe(()=>{Je("drawer",!1),Je("search",!1)});Zr.pipe(b(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=fe("link[rel=prev]");typeof t!="undefined"&&pt(t);break;case"n":case".":let r=fe("link[rel=next]");typeof r!="undefined"&&pt(r);break;case"Enter":let o=Re();o instanceof HTMLLabelElement&&o.click()}});xi({viewport$:Oe,document$:ot});yi({document$:ot,tablet$:hr});Ei({document$:ot});wi({viewport$:Oe,tablet$:hr});var rt=Nn(Se("header"),{viewport$:Oe}),Ft=ot.pipe(m(()=>Se("main")),v(e=>Qn(e,{viewport$:Oe,header$:rt})),B(1)),ds=S(...ae("consent").map(e=>xn(e,{target$:Ot})),...ae("dialog").map(e=>Dn(e,{alert$:eo})),...ae("header").map(e=>zn(e,{viewport$:Oe,header$:rt,main$:Ft})),...ae("palette").map(e=>Kn(e)),...ae("progress").map(e=>Yn(e,{progress$:to})),...ae("search").map(e=>li(e,{index$:Mi,keyboard$:Zr})),...ae("source").map(e=>hi(e))),hs=C(()=>S(...ae("announce").map(e=>gn(e)),...ae("content").map(e=>Un(e,{viewport$:Oe,target$:Ot,print$:Oi})),...ae("content").map(e=>G("search.highlight")?mi(e,{index$:Mi,location$:jt}):M),...ae("header-title").map(e=>qn(e,{viewport$:Oe,header$:rt})),...ae("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Nr(Si,()=>Jr(e,{viewport$:Oe,header$:rt,main$:Ft})):Nr(hr,()=>Jr(e,{viewport$:Oe,header$:rt,main$:Ft}))),...ae("tabs").map(e=>bi(e,{viewport$:Oe,header$:rt})),...ae("toc").map(e=>vi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Ot})),...ae("top").map(e=>gi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Ot})))),Li=ot.pipe(v(()=>hs),Pe(ds),B(1));Li.subscribe();window.document$=ot;window.location$=jt;window.target$=Ot;window.keyboard$=Zr;window.viewport$=Oe;window.tablet$=hr;window.screen$=Si;window.print$=Oi;window.alert$=eo;window.progress$=to;window.component$=Li;})();
+//# sourceMappingURL=bundle.ad660dcc.min.js.map
 
diff --git a/latest/assets/javascripts/bundle.081f42fc.min.js.map b/latest/assets/javascripts/bundle.ad660dcc.min.js.map
similarity index 78%
rename from latest/assets/javascripts/bundle.081f42fc.min.js.map
rename to latest/assets/javascripts/bundle.ad660dcc.min.js.map
index e055db5a..6d61170f 100644
--- a/latest/assets/javascripts/bundle.081f42fc.min.js.map
+++ b/latest/assets/javascripts/bundle.ad660dcc.min.js.map
@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/clipboard/dist/clipboard.js", "node_modules/escape-html/index.js", "src/templates/assets/javascripts/bundle.ts", "node_modules/rxjs/node_modules/tslib/tslib.es6.js", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/BehaviorSubject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/QueueAction.ts", "node_modules/rxjs/src/internal/scheduler/QueueScheduler.ts", "node_modules/rxjs/src/internal/scheduler/queue.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/observable/throwError.ts", "node_modules/rxjs/src/internal/util/EmptyError.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/debounce.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/throwIfEmpty.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/first.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/repeat.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/templates/assets/javascripts/browser/document/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/browser/element/focus/index.ts", "src/templates/assets/javascripts/browser/element/hover/index.ts", "src/templates/assets/javascripts/utilities/h/index.ts", "src/templates/assets/javascripts/utilities/round/index.ts", "src/templates/assets/javascripts/browser/script/index.ts", "src/templates/assets/javascripts/browser/element/size/_/index.ts", "src/templates/assets/javascripts/browser/element/size/content/index.ts", "src/templates/assets/javascripts/browser/element/offset/_/index.ts", "src/templates/assets/javascripts/browser/element/offset/content/index.ts", "src/templates/assets/javascripts/browser/element/visibility/index.ts", "src/templates/assets/javascripts/browser/toggle/index.ts", "src/templates/assets/javascripts/browser/keyboard/index.ts", "src/templates/assets/javascripts/browser/location/_/index.ts", "src/templates/assets/javascripts/browser/location/hash/index.ts", "src/templates/assets/javascripts/browser/media/index.ts", "src/templates/assets/javascripts/browser/request/index.ts", "src/templates/assets/javascripts/browser/viewport/offset/index.ts", "src/templates/assets/javascripts/browser/viewport/size/index.ts", "src/templates/assets/javascripts/browser/viewport/_/index.ts", "src/templates/assets/javascripts/browser/viewport/at/index.ts", "src/templates/assets/javascripts/browser/worker/index.ts", "src/templates/assets/javascripts/_/index.ts", "src/templates/assets/javascripts/components/_/index.ts", "src/templates/assets/javascripts/components/announce/index.ts", "src/templates/assets/javascripts/components/consent/index.ts", "src/templates/assets/javascripts/templates/tooltip/index.tsx", "src/templates/assets/javascripts/templates/annotation/index.tsx", "src/templates/assets/javascripts/templates/clipboard/index.tsx", "src/templates/assets/javascripts/templates/search/index.tsx", "src/templates/assets/javascripts/templates/source/index.tsx", "src/templates/assets/javascripts/templates/tabbed/index.tsx", "src/templates/assets/javascripts/templates/table/index.tsx", "src/templates/assets/javascripts/templates/version/index.tsx", "src/templates/assets/javascripts/components/tooltip2/index.ts", "src/templates/assets/javascripts/components/content/annotation/_/index.ts", "src/templates/assets/javascripts/components/content/annotation/list/index.ts", "src/templates/assets/javascripts/components/content/annotation/block/index.ts", "src/templates/assets/javascripts/components/content/code/_/index.ts", "src/templates/assets/javascripts/components/content/details/index.ts", "src/templates/assets/javascripts/components/content/mermaid/index.css", "src/templates/assets/javascripts/components/content/mermaid/index.ts", "src/templates/assets/javascripts/components/content/table/index.ts", "src/templates/assets/javascripts/components/content/tabs/index.ts", "src/templates/assets/javascripts/components/content/_/index.ts", "src/templates/assets/javascripts/components/dialog/index.ts", "src/templates/assets/javascripts/components/tooltip/index.ts", "src/templates/assets/javascripts/components/header/_/index.ts", "src/templates/assets/javascripts/components/header/title/index.ts", "src/templates/assets/javascripts/components/main/index.ts", "src/templates/assets/javascripts/components/palette/index.ts", "src/templates/assets/javascripts/components/progress/index.ts", "src/templates/assets/javascripts/integrations/clipboard/index.ts", "src/templates/assets/javascripts/integrations/sitemap/index.ts", "src/templates/assets/javascripts/integrations/instant/index.ts", "src/templates/assets/javascripts/integrations/search/highlighter/index.ts", "src/templates/assets/javascripts/integrations/search/worker/message/index.ts", "src/templates/assets/javascripts/integrations/search/worker/_/index.ts", "src/templates/assets/javascripts/integrations/version/index.ts", "src/templates/assets/javascripts/components/search/query/index.ts", "src/templates/assets/javascripts/components/search/result/index.ts", "src/templates/assets/javascripts/components/search/share/index.ts", "src/templates/assets/javascripts/components/search/suggest/index.ts", "src/templates/assets/javascripts/components/search/_/index.ts", "src/templates/assets/javascripts/components/search/highlight/index.ts", "src/templates/assets/javascripts/components/sidebar/index.ts", "src/templates/assets/javascripts/components/source/facts/github/index.ts", "src/templates/assets/javascripts/components/source/facts/gitlab/index.ts", "src/templates/assets/javascripts/components/source/facts/_/index.ts", "src/templates/assets/javascripts/components/source/_/index.ts", "src/templates/assets/javascripts/components/tabs/index.ts", "src/templates/assets/javascripts/components/toc/index.ts", "src/templates/assets/javascripts/components/top/index.ts", "src/templates/assets/javascripts/patches/ellipsis/index.ts", "src/templates/assets/javascripts/patches/indeterminate/index.ts", "src/templates/assets/javascripts/patches/scrollfix/index.ts", "src/templates/assets/javascripts/patches/scrolllock/index.ts", "src/templates/assets/javascripts/polyfills/index.ts"],
-  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ viewport$, document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { Subject } from './Subject';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\n\n/**\n * A variant of Subject that requires an initial value and emits its current\n * value whenever it is subscribed to.\n *\n * @class BehaviorSubject<T>\n */\nexport class BehaviorSubject<T> extends Subject<T> {\n  constructor(private _value: T) {\n    super();\n  }\n\n  get value(): T {\n    return this.getValue();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    const subscription = super._subscribe(subscriber);\n    !subscription.closed && subscriber.next(this._value);\n    return subscription;\n  }\n\n  getValue(): T {\n    const { hasError, thrownError, _value } = this;\n    if (hasError) {\n      throw thrownError;\n    }\n    this._throwIfClosed();\n    return _value;\n  }\n\n  next(value: T): void {\n    super.next((this._value = value));\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { Subscription } from '../Subscription';\nimport { QueueScheduler } from './QueueScheduler';\nimport { SchedulerAction } from '../types';\nimport { TimerHandle } from './timerHandle';\n\nexport class QueueAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: QueueScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (delay > 0) {\n      return super.schedule(state, delay);\n    }\n    this.delay = delay;\n    this.state = state;\n    this.scheduler.flush(this);\n    return this;\n  }\n\n  public execute(state: T, delay: number): any {\n    return delay > 0 || this.closed ? super.execute(state, delay) : this._execute(state, delay);\n  }\n\n  protected requestAsyncId(scheduler: QueueScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n\n    if ((delay != null && delay > 0) || (delay == null && this.delay > 0)) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n\n    // Otherwise flush the scheduler starting with this action.\n    scheduler.flush(this);\n\n    // HACK: In the past, this was returning `void`. However, `void` isn't a valid\n    // `TimerHandle`, and generally the return value here isn't really used. So the\n    // compromise is to return `0` which is both \"falsy\" and a valid `TimerHandle`,\n    // as opposed to refactoring every other instanceo of `requestAsyncId`.\n    return 0;\n  }\n}\n", "import { AsyncScheduler } from './AsyncScheduler';\n\nexport class QueueScheduler extends AsyncScheduler {\n}\n", "import { QueueAction } from './QueueAction';\nimport { QueueScheduler } from './QueueScheduler';\n\n/**\n *\n * Queue Scheduler\n *\n * <span class=\"informal\">Put every next task on a queue, instead of executing it immediately</span>\n *\n * `queue` scheduler, when used with delay, behaves the same as {@link asyncScheduler} scheduler.\n *\n * When used without delay, it schedules given task synchronously - executes it right when\n * it is scheduled. However when called recursively, that is when inside the scheduled task,\n * another task is scheduled with queue scheduler, instead of executing immediately as well,\n * that task will be put on a queue and wait for current one to finish.\n *\n * This means that when you execute task with `queue` scheduler, you are sure it will end\n * before any other task scheduled with that scheduler will start.\n *\n * ## Examples\n * Schedule recursively first, then do something\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(() => {\n *   queueScheduler.schedule(() => console.log('second')); // will not happen now, but will be put on a queue\n *\n *   console.log('first');\n * });\n *\n * // Logs:\n * // \"first\"\n * // \"second\"\n * ```\n *\n * Reschedule itself recursively\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(function(state) {\n *   if (state !== 0) {\n *     console.log('before', state);\n *     this.schedule(state - 1); // `this` references currently executing Action,\n *                               // which we reschedule with new state\n *     console.log('after', state);\n *   }\n * }, 0, 3);\n *\n * // In scheduler that runs recursively, you would expect:\n * // \"before\", 3\n * // \"before\", 2\n * // \"before\", 1\n * // \"after\", 1\n * // \"after\", 2\n * // \"after\", 3\n *\n * // But with queue it logs:\n * // \"before\", 3\n * // \"after\", 3\n * // \"before\", 2\n * // \"after\", 2\n * // \"before\", 1\n * // \"after\", 1\n * ```\n */\n\nexport const queueScheduler = new QueueScheduler(QueueAction);\n\n/**\n * @deprecated Renamed to {@link queueScheduler}. Will be removed in v8.\n */\nexport const queue = queueScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { noop } from '../util/noop';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * determined by another Observable has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link debounceTime}, but the time span of\n * emission silence is determined by a second Observable.</span>\n *\n * ![](debounce.svg)\n *\n * `debounce` delays notifications emitted by the source Observable, but drops previous\n * pending delayed emissions if a new notification arrives on the source Observable.\n * This operator keeps track of the most recent notification from the source\n * Observable, and spawns a duration Observable by calling the\n * `durationSelector` function. The notification is emitted only when the duration\n * Observable emits a next notification, and if no other notification was emitted on\n * the source Observable since the duration Observable was spawned. If a new\n * notification appears before the duration Observable emits, the previous notification will\n * not be emitted and a new duration is scheduled from `durationSelector` is scheduled.\n * If the completing event happens during the scheduled duration the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during the scheduled duration or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * Like {@link debounceTime}, this is a rate-limiting operator, and also a\n * delay-like operator since output emissions do not necessarily occur at the\n * same time as they did on the source Observable.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, scan, debounce, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(\n *   scan(i => ++i, 1),\n *   debounce(i => interval(200 * i))\n * );\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the timeout\n * duration for each source value, returned as an Observable or a Promise.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified duration Observable returned by\n * `durationSelector`, and may drop some values if they occur too frequently.\n */\nexport function debounce<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    // The subscriber/subscription for the current debounce, if there is one.\n    let durationSubscriber: Subscriber<any> | null = null;\n\n    const emit = () => {\n      // Unsubscribe any current debounce subscription we have,\n      // we only cared about the first notification from it, and we\n      // want to clean that subscription up as soon as possible.\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        // We have a value! Free up memory first, then emit the value.\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          // Cancel any pending debounce duration. We don't\n          // need to null it out here yet tho, because we're just going\n          // to create another one in a few lines.\n          durationSubscriber?.unsubscribe();\n          hasValue = true;\n          lastValue = value;\n          // Capture our duration subscriber, so we can unsubscribe it when we're notified\n          // and we're going to emit the value.\n          durationSubscriber = createOperatorSubscriber(subscriber, emit, noop);\n          // Subscribe to the duration.\n          innerFrom(durationSelector(value)).subscribe(durationSubscriber);\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = durationSubscriber = null;\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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 * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  debounce,\n  defer,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith,\n  timer\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * The second parameter allows to specify a timeout in milliseconds after which\n * the hover state will be reset to `false`. This is useful for tooltips which\n * should disappear after a certain amount of time, in order to allow the user\n * to move the cursor from the host to the tooltip.\n *\n * @param el - Element\n * @param timeout - Timeout\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, timeout?: number\n): Observable<boolean> {\n  return defer(() => merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      timeout ? debounce(active => timer(+!active * timeout)) : identity,\n      startWith(el.matches(\":hover\"))\n    )\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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 * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => (\n      entries.forEach(entry => entry$.next(entry))\n    ))),\n    switchMap(observer => merge(NEVER, of(observer)).pipe(\n      finalize(() => observer.disconnect())\n    )),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n\n  // Compute target element - since inline elements cannot be observed by the\n  // current `ResizeObserver` implementation as provided by browsers, we need\n  // to determine the first containing parent element and use that one as a\n  // target, while we always compute the actual size from the element.\n  let target = el\n  while (target.clientWidth === 0)\n    if (target.parentElement)\n      target = target.parentElement\n    else\n      break\n\n  // Observe target element and recompute element size on resize - as described\n  // above, the target element is not necessarily the element of interest\n  return observer$.pipe(\n    tap(observer => observer.observe(target)),\n    switchMap(observer => entry$.pipe(\n      filter(entry => entry.target === target),\n      finalize(() => observer.unobserve(target))\n    )),\n    map(() => getElementSize(el)),\n    startWith(getElementSize(el))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n\n/**\n * Retrieve all overflowing containers of an element, if any\n *\n * Note that this function has a slightly different behavior, so we should at\n * some point consider refactoring how overflowing containers are handled.\n *\n * @param el - Element\n *\n * @returns Overflowing containers\n */\nexport function getElementContainers(\n  el: HTMLElement\n): HTMLElement[] {\n  const containers: HTMLElement[] = []\n\n  // Walk up the DOM tree until we find an overflowing container\n  let parent = el.parentElement\n  while (parent) {\n    if (\n      el.clientWidth  > parent.clientWidth ||\n      el.clientHeight > parent.clientHeight\n    )\n      containers.push(parent)\n\n    // Continue with parent element\n    parent = (el = parent).parentElement\n  }\n\n  // If the page is short, the body might not be overflowing and there might be\n  // no other containers, which is why we need to make sure the body is present\n  if (containers.length === 0)\n    containers.push(document.documentElement)\n\n  // Return overflowing containers\n  return containers\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { watchElementSize } from \"../../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/**\n * Retrieve absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffsetAbsolute(\n  el: HTMLElement\n): ElementOffset {\n  const rect = el.getBoundingClientRect()\n  return {\n    x: rect.x + window.scrollX,\n    y: rect.y + window.scrollY\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n\n/**\n * Watch absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffsetAbsolute(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    watchElementOffset(el),\n    watchElementSize(document.body) // @todo find a better way for this\n  )\n    .pipe(\n      map(() => getElementOffsetAbsolute(el)),\n      startWith(getElementOffsetAbsolute(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n  alias?: boolean                      /* Show alias */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ComponentChild } from \"preact\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n\n// @todo: rename\nexport function renderInlineTooltip2(\n  ...children: ComponentChild[]\n): HTMLElement {\n  return (\n    <div class=\"md-tooltip2\" role=\"tooltip\">\n      <div class=\"md-tooltip2__inner md-typeset\">\n        {children}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{key}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && document.tags.map(tag => {\n          const type = tags\n            ? tag in tags\n              ? `md-tag-icon md-tag--${tags[tag]}`\n              : \"md-tag-icon\"\n            : \"\"\n          return (\n            <span class={`md-tag ${type}`}>{tag}</span>\n          )\n        })}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n        {config.version?.alias && version.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {version.aliases[0]}\n          </span>\n        )}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  const config = configuration()\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n        {config.version?.alias && active.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {active.aliases[0]}\n          </span>\n        )}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  BehaviorSubject,\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  combineLatest,\n  debounce,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  filter,\n  finalize,\n  first,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  queueScheduler,\n  share,\n  startWith,\n  switchMap,\n  tap,\n  throttleTime,\n  timer,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  Viewport,\n  getElement,\n  getElementContainers,\n  getElementOffsetAbsolute,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderInlineTooltip2 } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      // Tooltip is active\n  offset: ElementOffset                // Tooltip offset\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dependencies\n */\ninterface Dependencies {\n  content$: Observable<HTMLElement>    // Tooltip content observable\n  viewport$: Observable<Viewport>      // Viewport observable\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function tracks the tooltip host element, and deduces the active state\n * and offset of the tooltip from it. The active state is determined by whether\n * the host element is focused or hovered, and the offset is determined by the\n * host element's absolute position in the document.\n *\n * @param el - Tooltip host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip2(\n  el: HTMLElement\n): Observable<Tooltip> {\n\n  // Compute whether tooltip should be shown - we need to watch both focus and\n  // hover events on the host element and emit if one of them is active. In case\n  // of a hover event, we keep the element visible for a short amount of time\n  // after the pointer left the host element for a better user experience.\n  const active$ =\n    combineLatest([\n      watchElementFocus(el),\n      watchElementHover(el)\n    ])\n      .pipe(\n        map(([focus, hover]) => focus || hover),\n        distinctUntilChanged()\n      )\n\n  // We need to determine all parent elements of the host element that are\n  // currently scrollable, as they might affect the position of the tooltip\n  // depending on their horizontal of vertical offset. We must track all of\n  // them and recompute the position of the tooltip if they change.\n  const offset$ =\n    defer(() => getElementContainers(el)).pipe(\n      mergeMap(watchElementContentOffset),\n      throttleTime(1),\n      map(() => getElementOffsetAbsolute(el))\n    )\n\n  // Only track parent elements and compute offset of the tooltip host if the\n  // tooltip should be shown - we defer the computation of the offset until the\n  // tooltip becomes active for the first time. This is necessary, because we\n  // must also keep the tooltip active as long as it is focused or hovered.\n  return active$.pipe(\n    first(active => active),\n    switchMap(() => combineLatest([active$, offset$])),\n    map(([active, offset]) => ({ active, offset })),\n    share()\n  )\n}\n\n/**\n * Mount tooltip\n *\n * This function renders a tooltip with the content from the provided `content$`\n * observable as passed via the dependencies. If the returned element has a role\n * of type `dialog`, the tooltip is considered to be interactive, and rendered\n * either above or below the host element, depending on the available space.\n *\n * If the returned element has a role of type `tooltip`, the tooltip is always\n * rendered below the host element and considered to be non-interactive. This\n * allows us to reuse the same positioning logic for both interactive and\n * non-interactive tooltips, as it is largely the same.\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip2(\n  el: HTMLElement, dependencies: Dependencies\n): Observable<Component<Tooltip>> {\n  const { content$, viewport$ } = dependencies\n\n  // Compute unique tooltip id - this is necessary to associate the tooltip host\n  // element with the tooltip element for ARIA purposes\n  const id = `__tooltip2_${sequence++}`\n\n  // Create component on subscription\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n\n    // Create subject to track tooltip presence and visibility - we use another\n    // purely internal subject to track the tooltip's presence and visibility,\n    // as the tooltip should be visible if the host element or tooltip itself\n    // is focused or hovered to allow for smooth pointer migration\n    const show$ = new BehaviorSubject(false)\n    push$.pipe(ignoreElements(), endWith(false))\n      .subscribe(show$)\n\n    // Create observable controlling tooltip element - we create and attach the\n    // tooltip only if it is actually present, in order to keep the number of\n    // elements low. We need to keep the tooltip visible for a short time after\n    // the pointer left the host element or tooltip itself. For this, we use an\n    // inner subscription to the tooltip observable, which we terminate when the\n    // tooltip should not be shown, automatically removing the element. Moreover\n    // we use the queue scheduler, which will schedule synchronously in case the\n    // tooltip should be shown, and asynchronously if it should be hidden.\n    const node$ = show$.pipe(\n      debounce(active => timer(+!active * 250, queueScheduler)),\n      distinctUntilChanged(),\n      switchMap(active => active ? content$ : EMPTY),\n      tap(node => node.id = id),\n      share()\n    )\n\n    // Compute tooltip presence and visibility - the tooltip should be shown if\n    // the host element or the tooltip itself is focused or hovered\n    combineLatest([\n      push$.pipe(map(({ active }) => active)),\n      node$.pipe(\n        switchMap(node => watchElementHover(node, 250)),\n        startWith(false)\n      )\n    ])\n      .pipe(map(states => states.some(active => active)))\n      .subscribe(show$)\n\n    // Compute tooltip origin - we need to compute the tooltip origin depending\n    // on the position of the host element, the viewport size, as well as the\n    // actual size of the tooltip, if positioned above. The tooltip must about\n    // to be rendered for this to be correct, which is why we do it here.\n    const origin$ = show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, viewport$),\n      map(([_, node, { size }]) => {\n        const host = el.getBoundingClientRect()\n        const x = host.width / 2\n\n        // If the tooltip is non-interactive, we always render it below the\n        // actual element because all operating systems do it that way\n        if (node.role === \"tooltip\") {\n          return { x, y: 8 + host.height }\n\n        // Otherwise, we determine where there is more space, and render the\n        // tooltip either above or below the host element\n        } else if (host.y >= size.height / 2) {\n          const { height } = getElementSize(node)\n          return { x, y: -16 - height }\n        } else {\n          return { x, y: +16 + host.height }\n        }\n      })\n    )\n\n    // Update tooltip position - we always need to update the position of the\n    // tooltip, as it might change depending on the viewport offset of the host\n    combineLatest([node$, push$, origin$])\n      .subscribe(([node, { offset }, origin]) => {\n        node.style.setProperty(\"--md-tooltip-host-x\", `${offset.x}px`)\n        node.style.setProperty(\"--md-tooltip-host-y\", `${offset.y}px`)\n\n        // Update tooltip origin - this is mainly set to determine the position\n        // of the tooltip tail, to show the direction it is originating from\n        node.style.setProperty(\"--md-tooltip-x\", `${origin.x}px`)\n        node.style.setProperty(\"--md-tooltip-y\", `${origin.y}px`)\n\n        // Update tooltip render location, i.e., whether the tooltip is shown\n        // above or below the host element, depending on the available space\n        node.classList.toggle(\"md-tooltip2--top\",    origin.y <  0)\n        node.classList.toggle(\"md-tooltip2--bottom\", origin.y >= 0)\n      })\n\n    // Update tooltip width - we only explicitly set the width of the tooltip\n    // if it is non-interactive, in case it should always be rendered centered\n    show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, (_, node) => node),\n      filter(node => node.role === \"tooltip\")\n    )\n      .subscribe(node => {\n        const size = getElementSize(getElement(\":scope > *\", node))\n\n        // Set tooltip width and remove tail by setting it to a width of zero -\n        // if authors want to keep the tail, we can move this to CSS later\n        node.style.setProperty(\"--md-tooltip-width\", `${size.width}px`)\n        node.style.setProperty(\"--md-tooltip-tail\",  `${0}px`)\n      })\n\n    // Update tooltip visibility - we defer to the next animation frame, because\n    // the tooltip must first be added to the document before we make it appear,\n    // or it will appear instantly without delay. Additionally, we need to keep\n    // the tooltip visible for a short time after the pointer left the host.\n    show$.pipe(\n      distinctUntilChanged(),\n      observeOn(animationFrameScheduler),\n      withLatestFrom(node$)\n    )\n      .subscribe(([active, node]) => {\n        node.classList.toggle(\"md-tooltip2--active\", active)\n      })\n\n    // Set up ARIA attributes when tooltip is visible\n    combineLatest([\n      show$.pipe(filter(active => active)),\n      node$\n    ])\n      .subscribe(([_, node]) => {\n        if (node.role === \"dialog\") {\n          el.setAttribute(\"aria-controls\", id)\n          el.setAttribute(\"aria-haspopup\", \"dialog\")\n        } else {\n          el.setAttribute(\"aria-describedby\", id)\n        }\n      })\n\n    // Remove ARIA attributes when tooltip is hidden\n    show$.pipe(filter(active => !active))\n      .subscribe(() => {\n        el.removeAttribute(\"aria-controls\")\n        el.removeAttribute(\"aria-describedby\")\n        el.removeAttribute(\"aria-haspopup\")\n      })\n\n    // Create and return component\n    return watchTooltip2(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n\n// ----------------------------------------------------------------------------\n\n/**\n * Mount inline tooltip\n *\n * @todo refactor this function\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n * @param container - Container\n *\n * @returns Tooltip component observable\n */\nexport function mountInlineTooltip2(\n  el: HTMLElement, { viewport$ }: { viewport$: Observable<Viewport> },\n  container = document.body\n): Observable<Component<Tooltip>> {\n  return mountTooltip2(el, {\n    content$: new Observable<HTMLElement>(observer => {\n      const title = el.title\n      const node = renderInlineTooltip2(title)\n      observer.next(node)\n      el.removeAttribute(\"title\")\n      // Append tooltip and remove on unsubscription\n      container.append(node)\n      return () => {\n        node.remove()\n        el.setAttribute(\"title\", title)\n      }\n    }),\n    viewport$\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  getElements,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"~/components/tooltip2\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountInlineTooltip2(button, { viewport$ }))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    // If the code block has line spans, we can add this additional class to\n    // the code block element, which fixes the problem for highlighted code\n    // lines not stretching to the entirety of the screen when the code block\n    // overflows, e.g., on mobile - see\n    const spans = getElements(\":scope > span[id]\", el)\n    if (spans.length)\n      el.classList.add(\"md-code__content\")\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@10/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchElementVisibility(el)\n      .pipe(\n        switchMap(() => watchContentTabs(inputs)),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"../../tooltip2\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountInlineTooltip2(child, { viewport$ }))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    // Handle color switch on Enter or Space - see https://t.ly/YIhVj\n    fromEvent<KeyboardEvent>(el, \"keydown\").pipe(\n      filter(ev => ev.key === \"Enter\"),\n      withLatestFrom(push$, (_, palette) => palette)\n    )\n      .subscribe(({ index }) => {\n        index = (index + 1) % inputs.length\n        inputs[index].click()\n        inputs[index].focus()\n      })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    document$.pipe(\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\")\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. It is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 RTICULAR PURPOSE AND NON-INFRINGEMENT. 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\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 RTICULAR PURPOSE AND NON-INFRINGEMENT. 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\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(url)\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(url => {\n            return fetchSitemap(new URL(url))\n              .pipe(\n                map(sitemap => {\n                  const location = getLocation()\n                  const path = location.href.replace(config.base, url)\n                  return sitemap.has(path.split(\"#\")[0])\n                    ? new URL(path)\n                    : new URL(url)\n                })\n              )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return requestJSON<ProjectSchema>(url)\n    .pipe(\n      catchError(() => EMPTY), // @todo refactor instant loading\n      map(({ star_count, forks_count }) => ({\n        stars: star_count,\n        forks: forks_count\n      })),\n      defaultIfEmpty({})\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountInlineTooltip2 } from \"~/components/tooltip2\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$, viewport$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        /* Mount tooltip */\n        return mountInlineTooltip2(host, { viewport$ })\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-status\")),\n      mergeMap(el => mountInlineTooltip2(el, { viewport$ }))\n    )\n      .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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 * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
-  "mappings": "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",
-  "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "import_focus_visible", "extendStatics", "d", "b", "p", "__extends", "__", "__awaiter", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "e", "rejected", "result", "__generator", "body", "_", "t", "f", "y", "g", "verb", "n", "v", "op", "__values", "o", "s", "m", "i", "__read", "n", "r", "ar", "e", "error", "__spreadArray", "to", "from", "pack", "i", "l", "ar", "__await", "v", "__asyncGenerator", "thisArg", "_arguments", "generator", "g", "q", "verb", "n", "a", "b", "resume", "step", "e", "settle", "r", "fulfill", "reject", "value", "f", "__asyncValues", "o", "m", "i", "__values", "verb", "n", "v", "resolve", "reject", "settle", "d", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "BehaviorSubject", "_super", "__extends", "_value", "_this", "subscriber", "subscription", "_a", "hasError", "thrownError", "value", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "QueueAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "AsyncAction", "QueueScheduler", "_super", "__extends", "AsyncScheduler", "queueScheduler", "QueueScheduler", "QueueAction", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "EmptyError", "createErrorClass", "_super", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "debounce", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "emit", "value", "createOperatorSubscriber", "noop", "innerFrom", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "innerFrom", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "throwIfEmpty", "errorFactory", "defaultErrorFactory", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "EmptyError", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "first", "predicate", "defaultValue", "hasDefaultValue", "source", "filter", "v", "identity", "take", "defaultIfEmpty", "throwIfEmpty", "EmptyError", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "_a", "_b", "leading", "_c", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "_a", "_b", "_c", "_d", "observer$", "merge", "fromEvent", "debounceTime", "startWith", "map", "getActiveElement", "shareReplay", "watchElementFocus", "el", "active", "distinctUntilChanged", "watchElementHover", "el", "timeout", "defer", "merge", "fromEvent", "map", "debounce", "active", "timer", "identity", "startWith", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "round", "value", "digits", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "entry$", "Subject", "observer$", "defer", "watchScript", "of", "map", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "target", "tap", "filter", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "getElementContainers", "containers", "getElementOffset", "el", "getElementOffsetAbsolute", "rect", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchComposition", "merge", "fromEvent", "map", "startWith", "watchKeyboard", "keyboard$", "filter", "ev", "getToggle", "mode", "active", "getActiveElement", "share", "switchMap", "EMPTY", "getLocation", "setLocation", "url", "navigate", "feature", "el", "h", "watchLocation", "Subject", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "location$", "merge", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "Observable", "observer", "req", "event", "_a", "length", "requestJSON", "switchMap", "res", "map", "body", "shareReplay", "requestHTML", "dom", "requestXML", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "recv", "worker", "fromEvent", "ev", "send", "send$", "Subject", "data", "watchWorker", "url", "recv$", "worker$", "done$", "ignoreElements", "endWith", "mergeWith", "takeUntil", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "hash", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "renderTooltip", "id", "style", "h", "renderInlineTooltip2", "children", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "config", "configuration", "url", "feature", "match", "highlight", "value", "tags", "tag", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "_a", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "translation", "sequence", "watchTooltip2", "el", "active$", "combineLatest", "watchElementFocus", "watchElementHover", "map", "focus", "hover", "distinctUntilChanged", "offset$", "defer", "getElementContainers", "mergeMap", "watchElementContentOffset", "throttleTime", "getElementOffsetAbsolute", "first", "active", "switchMap", "offset", "share", "mountTooltip2", "dependencies", "content$", "viewport$", "id", "push$", "Subject", "show$", "BehaviorSubject", "ignoreElements", "endWith", "node$", "debounce", "timer", "queueScheduler", "EMPTY", "tap", "node", "startWith", "states", "origin$", "filter", "withLatestFrom", "_", "size", "host", "x", "height", "getElementSize", "origin", "getElement", "observeOn", "animationFrameScheduler", "state", "finalize", "__spreadValues", "mountInlineTooltip2", "container", "Observable", "observer", "title", "renderInlineTooltip2", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "ignoreElements", "endWith", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findHosts", "container", "getElements", "findMarkers", "markers", "el", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "pairs", "annotation", "getElement", "takeUntil", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "findList", "el", "sibling", "mountAnnotationBlock", "options", "defer", "list", "mountAnnotationList", "EMPTY", "import_clipboard", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "done$", "takeLast", "scrollable", "content$", "ClipboardJS", "feature", "parent", "button", "renderClipboardButton", "mountInlineTooltip2", "container", "list", "annotations$", "mountAnnotationList", "takeUntil", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "getElements", "tap", "state", "finalize", "__spreadValues", "mergeWith", "watchElementVisibility", "filter", "visible", "take", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "mermaid_default", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "__async", "id", "host", "h", "text", "svg", "fn", "shadow", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "inputs", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "el", "viewport$", "target$", "container", "getElements", "prev", "renderTabbedControl", "next", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatest", "watchElementSize", "takeUntil", "auditTime", "animationFrameScheduler", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "filter", "label", "h", "ev", "tap", "feature", "skip", "withLatestFrom", "tab", "y", "set", "tabs", "media", "watchElementVisibility", "switchMap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountAnnotationBlock", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "feature", "mountInlineTooltip2", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "sequence", "watchTooltip", "el", "host", "width", "getElementSize", "container", "getElementContainer", "scroll$", "watchElementContentOffset", "of", "active$", "merge", "watchElementFocus", "watchElementHover", "distinctUntilChanged", "combineLatest", "map", "active", "scroll", "x", "y", "getElementOffset", "size", "table", "mountTooltip", "title", "EMPTY", "id", "tooltip", "renderTooltip", "typeset", "getElement", "defer", "push$", "Subject", "offset", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatestWith", "tooltips", "from", "getElements", "mergeMap", "child", "mountTooltip", "takeUntil", "state", "__spreadValues", "mergeWith", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "index", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "getElements", "meta", "h", "scheme", "media$", "watchMedia", "defer", "push$", "Subject", "palette", "media", "key", "value", "label", "filter", "ev", "withLatestFrom", "_", "header", "getComponentElement", "style", "color", "observeOn", "asyncScheduler", "takeUntil", "skip", "repeat", "tap", "state", "finalize", "__spreadValues", "mountProgress", "el", "progress$", "defer", "push$", "Subject", "value", "tap", "finalize", "map", "import_clipboard", "extract", "el", "copy", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "resolve", "url", "base", "extract", "document", "sitemap", "el", "getElements", "getElement", "links", "link", "href", "fetchSitemap", "requestXML", "map", "catchError", "of", "handle", "ev", "sitemap", "EMPTY", "el", "url", "of", "head", "document", "tags", "getElements", "resolve", "key", "value", "inject", "next", "selector", "feature", "source", "getOptionalElement", "target", "html", "name", "container", "getComponentElement", "concat", "switchMap", "script", "Observable", "observer", "ignoreElements", "endWith", "setupInstantNavigation", "location$", "viewport$", "progress$", "config", "configuration", "sitemap$", "fetchSitemap", "instant$", "fromEvent", "combineLatestWith", "share", "history$", "map", "getLocation", "withLatestFrom", "offset", "merge", "document$", "distinctUntilKeyChanged", "requestHTML", "catchError", "setLocation", "_", "distinctUntilChanged", "a", "b", "tap", "_a", "_b", "setLocationHash", "debounceTime", "import_escape_html", "setupSearchHighlighter", "config", "regex", "term", "separator", "highlight", "_", "data", "query", "match", "value", "escapeHTML", "isSearchReadyMessage", "message", "isSearchResultMessage", "setupSearchWorker", "url", "index$", "worker$", "watchWorker", "merge", "of", "watchToggle", "first", "active", "switchMap", "config", "docs", "feature", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "fetchSitemap", "sitemap", "path", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "_a", "outdated", "ignored", "main", "ignore", "warning", "getComponentElements", "watchSearchQuery", "el", "worker$", "searchParams", "getLocation", "setToggle", "watchToggle", "first", "active", "url", "focus$", "watchElementFocus", "value$", "merge", "isSearchReadyMessage", "fromEvent", "map", "distinctUntilChanged", "combineLatest", "value", "focus", "shareReplay", "mountSearchQuery", "push$", "Subject", "done$", "ignoreElements", "endWith", "_", "query", "distinctUntilKeyChanged", "takeUntil", "label", "getElement", "tap", "state", "finalize", "__spreadValues", "mountSearchResult", "el", "worker$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "container", "meta", "getElement", "list", "watchToggle", "active", "withLatestFrom", "skipUntil", "first", "isSearchReadyMessage", "items", "value", "translation", "count", "round", "render$", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "map", "renderSearchResultItem", "share", "item", "mergeMap", "details", "getOptionalElement", "EMPTY", "fromEvent", "takeUntil", "isSearchResultMessage", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "done$", "ignoreElements", "endWith", "fromEvent", "takeUntil", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "worker$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggest", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "worker$", "setupSearchWorker", "query", "getComponentElement", "result", "fromEvent", "filter", "target", "setToggle", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "els", "i", "query$", "mountSearchQuery", "merge", "mountSearchResult", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "next$", "auditTime", "animationFrameScheduler", "withLatestFrom", "first", "item", "getElements", "container", "getElementSize", "from", "mergeMap", "label", "fromEvent", "observeOn", "asyncScheduler", "takeUntil", "input", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "requestJSON", "catchError", "EMPTY", "map", "star_count", "forks_count", "defaultIfEmpty", "fetchSourceFacts", "url", "match", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "parent", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "main$", "target$", "push$", "Subject", "done$", "ignoreElements", "endWith", "feature", "smooth$", "merge", "debounceTime", "filter", "observeOn", "asyncScheduler", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "ignoreElements", "distinctUntilKeyChanged", "height", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "patchEllipsis", "document$", "viewport$", "switchMap", "getElements", "mergeMap", "el", "watchElementVisibility", "takeUntil", "skip", "filter", "visible", "map", "take", "text", "host", "mountInlineTooltip2", "finalize", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "fetchSearchIndex", "watchScript", "config", "map", "shareReplay", "requestJSON", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "configuration", "index$", "NEVER", "alert$", "Subject", "setupClipboardJS", "progress$", "feature", "setupInstantNavigation", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "setLocation", "next", "active", "getActiveElement", "patchEllipsis", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "switchMap", "el", "watchMain", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountHeader", "mountPalette", "mountProgress", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"]
+  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ viewport$, document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global Reflect, Promise */\r\n\r\nvar extendStatics = function(d, b) {\r\n    extendStatics = Object.setPrototypeOf ||\r\n        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n    return extendStatics(d, b);\r\n};\r\n\r\nexport function __extends(d, b) {\r\n    if (typeof b !== \"function\" && b !== null)\r\n        throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n    extendStatics(d, b);\r\n    function __() { this.constructor = d; }\r\n    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n}\r\n\r\nexport var __assign = function() {\r\n    __assign = Object.assign || function __assign(t) {\r\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n            s = arguments[i];\r\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n        }\r\n        return t;\r\n    }\r\n    return __assign.apply(this, arguments);\r\n}\r\n\r\nexport function __rest(s, e) {\r\n    var t = {};\r\n    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n        t[p] = s[p];\r\n    if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n                t[p[i]] = s[p[i]];\r\n        }\r\n    return t;\r\n}\r\n\r\nexport function __decorate(decorators, target, key, desc) {\r\n    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n    if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n    return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n}\r\n\r\nexport function __param(paramIndex, decorator) {\r\n    return function (target, key) { decorator(target, key, paramIndex); }\r\n}\r\n\r\nexport function __metadata(metadataKey, metadataValue) {\r\n    if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n}\r\n\r\nexport function __awaiter(thisArg, _arguments, P, generator) {\r\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n    return new (P || (P = Promise))(function (resolve, reject) {\r\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n    });\r\n}\r\n\r\nexport function __generator(thisArg, body) {\r\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n    return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n    function verb(n) { return function (v) { return step([n, v]); }; }\r\n    function step(op) {\r\n        if (f) throw new TypeError(\"Generator is already executing.\");\r\n        while (_) try {\r\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n            if (y = 0, t) op = [op[0] & 2, t.value];\r\n            switch (op[0]) {\r\n                case 0: case 1: t = op; break;\r\n                case 4: _.label++; return { value: op[1], done: false };\r\n                case 5: _.label++; y = op[1]; op = [0]; continue;\r\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n                default:\r\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n                    if (t[2]) _.ops.pop();\r\n                    _.trys.pop(); continue;\r\n            }\r\n            op = body.call(thisArg, _);\r\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n    }\r\n}\r\n\r\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n}) : (function(o, m, k, k2) {\r\n    if (k2 === undefined) k2 = k;\r\n    o[k2] = m[k];\r\n});\r\n\r\nexport function __exportStar(m, o) {\r\n    for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n}\r\n\r\nexport function __values(o) {\r\n    var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n    if (m) return m.call(o);\r\n    if (o && typeof o.length === \"number\") return {\r\n        next: function () {\r\n            if (o && i >= o.length) o = void 0;\r\n            return { value: o && o[i++], done: !o };\r\n        }\r\n    };\r\n    throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n}\r\n\r\nexport function __read(o, n) {\r\n    var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n    if (!m) return o;\r\n    var i = m.call(o), r, ar = [], e;\r\n    try {\r\n        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n    }\r\n    catch (error) { e = { error: error }; }\r\n    finally {\r\n        try {\r\n            if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n        }\r\n        finally { if (e) throw e.error; }\r\n    }\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spread() {\r\n    for (var ar = [], i = 0; i < arguments.length; i++)\r\n        ar = ar.concat(__read(arguments[i]));\r\n    return ar;\r\n}\r\n\r\n/** @deprecated */\r\nexport function __spreadArrays() {\r\n    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n    for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n            r[k] = a[j];\r\n    return r;\r\n}\r\n\r\nexport function __spreadArray(to, from, pack) {\r\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n        if (ar || !(i in from)) {\r\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n            ar[i] = from[i];\r\n        }\r\n    }\r\n    return to.concat(ar || Array.prototype.slice.call(from));\r\n}\r\n\r\nexport function __await(v) {\r\n    return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n}\r\n\r\nexport function __asyncGenerator(thisArg, _arguments, generator) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n    return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n    function fulfill(value) { resume(\"next\", value); }\r\n    function reject(value) { resume(\"throw\", value); }\r\n    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n}\r\n\r\nexport function __asyncDelegator(o) {\r\n    var i, p;\r\n    return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n}\r\n\r\nexport function __asyncValues(o) {\r\n    if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n    var m = o[Symbol.asyncIterator], i;\r\n    return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n}\r\n\r\nexport function __makeTemplateObject(cooked, raw) {\r\n    if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n    return cooked;\r\n};\r\n\r\nvar __setModuleDefault = Object.create ? (function(o, v) {\r\n    Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n}) : function(o, v) {\r\n    o[\"default\"] = v;\r\n};\r\n\r\nexport function __importStar(mod) {\r\n    if (mod && mod.__esModule) return mod;\r\n    var result = {};\r\n    if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n    __setModuleDefault(result, mod);\r\n    return result;\r\n}\r\n\r\nexport function __importDefault(mod) {\r\n    return (mod && mod.__esModule) ? mod : { default: mod };\r\n}\r\n\r\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n    return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n}\r\n\r\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\r\n    if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n    if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n    if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n    return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n}\r\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { Subject } from './Subject';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\n\n/**\n * A variant of Subject that requires an initial value and emits its current\n * value whenever it is subscribed to.\n *\n * @class BehaviorSubject<T>\n */\nexport class BehaviorSubject<T> extends Subject<T> {\n  constructor(private _value: T) {\n    super();\n  }\n\n  get value(): T {\n    return this.getValue();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    const subscription = super._subscribe(subscriber);\n    !subscription.closed && subscriber.next(this._value);\n    return subscription;\n  }\n\n  getValue(): T {\n    const { hasError, thrownError, _value } = this;\n    if (hasError) {\n      throw thrownError;\n    }\n    this._throwIfClosed();\n    return _value;\n  }\n\n  next(value: T): void {\n    super.next((this._value = value));\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { Subscription } from '../Subscription';\nimport { QueueScheduler } from './QueueScheduler';\nimport { SchedulerAction } from '../types';\nimport { TimerHandle } from './timerHandle';\n\nexport class QueueAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: QueueScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (delay > 0) {\n      return super.schedule(state, delay);\n    }\n    this.delay = delay;\n    this.state = state;\n    this.scheduler.flush(this);\n    return this;\n  }\n\n  public execute(state: T, delay: number): any {\n    return delay > 0 || this.closed ? super.execute(state, delay) : this._execute(state, delay);\n  }\n\n  protected requestAsyncId(scheduler: QueueScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n\n    if ((delay != null && delay > 0) || (delay == null && this.delay > 0)) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n\n    // Otherwise flush the scheduler starting with this action.\n    scheduler.flush(this);\n\n    // HACK: In the past, this was returning `void`. However, `void` isn't a valid\n    // `TimerHandle`, and generally the return value here isn't really used. So the\n    // compromise is to return `0` which is both \"falsy\" and a valid `TimerHandle`,\n    // as opposed to refactoring every other instanceo of `requestAsyncId`.\n    return 0;\n  }\n}\n", "import { AsyncScheduler } from './AsyncScheduler';\n\nexport class QueueScheduler extends AsyncScheduler {\n}\n", "import { QueueAction } from './QueueAction';\nimport { QueueScheduler } from './QueueScheduler';\n\n/**\n *\n * Queue Scheduler\n *\n * <span class=\"informal\">Put every next task on a queue, instead of executing it immediately</span>\n *\n * `queue` scheduler, when used with delay, behaves the same as {@link asyncScheduler} scheduler.\n *\n * When used without delay, it schedules given task synchronously - executes it right when\n * it is scheduled. However when called recursively, that is when inside the scheduled task,\n * another task is scheduled with queue scheduler, instead of executing immediately as well,\n * that task will be put on a queue and wait for current one to finish.\n *\n * This means that when you execute task with `queue` scheduler, you are sure it will end\n * before any other task scheduled with that scheduler will start.\n *\n * ## Examples\n * Schedule recursively first, then do something\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(() => {\n *   queueScheduler.schedule(() => console.log('second')); // will not happen now, but will be put on a queue\n *\n *   console.log('first');\n * });\n *\n * // Logs:\n * // \"first\"\n * // \"second\"\n * ```\n *\n * Reschedule itself recursively\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(function(state) {\n *   if (state !== 0) {\n *     console.log('before', state);\n *     this.schedule(state - 1); // `this` references currently executing Action,\n *                               // which we reschedule with new state\n *     console.log('after', state);\n *   }\n * }, 0, 3);\n *\n * // In scheduler that runs recursively, you would expect:\n * // \"before\", 3\n * // \"before\", 2\n * // \"before\", 1\n * // \"after\", 1\n * // \"after\", 2\n * // \"after\", 3\n *\n * // But with queue it logs:\n * // \"before\", 3\n * // \"after\", 3\n * // \"before\", 2\n * // \"after\", 2\n * // \"before\", 1\n * // \"after\", 1\n * ```\n */\n\nexport const queueScheduler = new QueueScheduler(QueueAction);\n\n/**\n * @deprecated Renamed to {@link queueScheduler}. Will be removed in v8.\n */\nexport const queue = queueScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { noop } from '../util/noop';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * determined by another Observable has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link debounceTime}, but the time span of\n * emission silence is determined by a second Observable.</span>\n *\n * ![](debounce.svg)\n *\n * `debounce` delays notifications emitted by the source Observable, but drops previous\n * pending delayed emissions if a new notification arrives on the source Observable.\n * This operator keeps track of the most recent notification from the source\n * Observable, and spawns a duration Observable by calling the\n * `durationSelector` function. The notification is emitted only when the duration\n * Observable emits a next notification, and if no other notification was emitted on\n * the source Observable since the duration Observable was spawned. If a new\n * notification appears before the duration Observable emits, the previous notification will\n * not be emitted and a new duration is scheduled from `durationSelector` is scheduled.\n * If the completing event happens during the scheduled duration the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during the scheduled duration or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * Like {@link debounceTime}, this is a rate-limiting operator, and also a\n * delay-like operator since output emissions do not necessarily occur at the\n * same time as they did on the source Observable.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, scan, debounce, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(\n *   scan(i => ++i, 1),\n *   debounce(i => interval(200 * i))\n * );\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the timeout\n * duration for each source value, returned as an Observable or a Promise.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified duration Observable returned by\n * `durationSelector`, and may drop some values if they occur too frequently.\n */\nexport function debounce<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    // The subscriber/subscription for the current debounce, if there is one.\n    let durationSubscriber: Subscriber<any> | null = null;\n\n    const emit = () => {\n      // Unsubscribe any current debounce subscription we have,\n      // we only cared about the first notification from it, and we\n      // want to clean that subscription up as soon as possible.\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        // We have a value! Free up memory first, then emit the value.\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          // Cancel any pending debounce duration. We don't\n          // need to null it out here yet tho, because we're just going\n          // to create another one in a few lines.\n          durationSubscriber?.unsubscribe();\n          hasValue = true;\n          lastValue = value;\n          // Capture our duration subscriber, so we can unsubscribe it when we're notified\n          // and we're going to emit the value.\n          durationSubscriber = createOperatorSubscriber(subscriber, emit, noop);\n          // Subscribe to the duration.\n          innerFrom(durationSelector(value)).subscribe(durationSubscriber);\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = durationSubscriber = null;\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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 * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  debounce,\n  defer,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith,\n  timer\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * The second parameter allows to specify a timeout in milliseconds after which\n * the hover state will be reset to `false`. This is useful for tooltips which\n * should disappear after a certain amount of time, in order to allow the user\n * to move the cursor from the host to the tooltip.\n *\n * @param el - Element\n * @param timeout - Timeout\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, timeout?: number\n): Observable<boolean> {\n  return defer(() => merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      timeout ? debounce(active => timer(+!active * timeout)) : identity,\n      startWith(el.matches(\":hover\"))\n    )\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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 * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => (\n      entries.forEach(entry => entry$.next(entry))\n    ))),\n    switchMap(observer => merge(NEVER, of(observer)).pipe(\n      finalize(() => observer.disconnect())\n    )),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n\n  // Compute target element - since inline elements cannot be observed by the\n  // current `ResizeObserver` implementation as provided by browsers, we need\n  // to determine the first containing parent element and use that one as a\n  // target, while we always compute the actual size from the element.\n  let target = el\n  while (target.clientWidth === 0)\n    if (target.parentElement)\n      target = target.parentElement\n    else\n      break\n\n  // Observe target element and recompute element size on resize - as described\n  // above, the target element is not necessarily the element of interest\n  return observer$.pipe(\n    tap(observer => observer.observe(target)),\n    switchMap(observer => entry$.pipe(\n      filter(entry => entry.target === target),\n      finalize(() => observer.unobserve(target))\n    )),\n    map(() => getElementSize(el)),\n    startWith(getElementSize(el))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n\n/**\n * Retrieve all overflowing containers of an element, if any\n *\n * Note that this function has a slightly different behavior, so we should at\n * some point consider refactoring how overflowing containers are handled.\n *\n * @param el - Element\n *\n * @returns Overflowing containers\n */\nexport function getElementContainers(\n  el: HTMLElement\n): HTMLElement[] {\n  const containers: HTMLElement[] = []\n\n  // Walk up the DOM tree until we find an overflowing container\n  let parent = el.parentElement\n  while (parent) {\n    if (\n      el.clientWidth  > parent.clientWidth ||\n      el.clientHeight > parent.clientHeight\n    )\n      containers.push(parent)\n\n    // Continue with parent element\n    parent = (el = parent).parentElement\n  }\n\n  // If the page is short, the body might not be overflowing and there might be\n  // no other containers, which is why we need to make sure the body is present\n  if (containers.length === 0)\n    containers.push(document.documentElement)\n\n  // Return overflowing containers\n  return containers\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { watchElementSize } from \"../../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/**\n * Retrieve absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffsetAbsolute(\n  el: HTMLElement\n): ElementOffset {\n  const rect = el.getBoundingClientRect()\n  return {\n    x: rect.x + window.scrollX,\n    y: rect.y + window.scrollY\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n\n/**\n * Watch absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffsetAbsolute(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    watchElementOffset(el),\n    watchElementSize(document.body) // @todo find a better way for this\n  )\n    .pipe(\n      map(() => getElementOffsetAbsolute(el)),\n      startWith(getElementOffsetAbsolute(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n  alias?: boolean                      /* Show alias */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ComponentChild } from \"preact\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n\n// @todo: rename\nexport function renderInlineTooltip2(\n  ...children: ComponentChild[]\n): HTMLElement {\n  return (\n    <div class=\"md-tooltip2\" role=\"tooltip\">\n      <div class=\"md-tooltip2__inner md-typeset\">\n        {children}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{key}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && document.tags.map(tag => {\n          const type = tags\n            ? tag in tags\n              ? `md-tag-icon md-tag--${tags[tag]}`\n              : \"md-tag-icon\"\n            : \"\"\n          return (\n            <span class={`md-tag ${type}`}>{tag}</span>\n          )\n        })}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n        {config.version?.alias && version.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {version.aliases[0]}\n          </span>\n        )}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  const config = configuration()\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n        {config.version?.alias && active.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {active.aliases[0]}\n          </span>\n        )}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  BehaviorSubject,\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  combineLatest,\n  debounce,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  filter,\n  finalize,\n  first,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  queueScheduler,\n  share,\n  startWith,\n  switchMap,\n  tap,\n  throttleTime,\n  timer,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  Viewport,\n  getElement,\n  getElementContainers,\n  getElementOffsetAbsolute,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderInlineTooltip2 } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      // Tooltip is active\n  offset: ElementOffset                // Tooltip offset\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dependencies\n */\ninterface Dependencies {\n  content$: Observable<HTMLElement>    // Tooltip content observable\n  viewport$: Observable<Viewport>      // Viewport observable\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function tracks the tooltip host element, and deduces the active state\n * and offset of the tooltip from it. The active state is determined by whether\n * the host element is focused or hovered, and the offset is determined by the\n * host element's absolute position in the document.\n *\n * @param el - Tooltip host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip2(\n  el: HTMLElement\n): Observable<Tooltip> {\n\n  // Compute whether tooltip should be shown - we need to watch both focus and\n  // hover events on the host element and emit if one of them is active. In case\n  // of a hover event, we keep the element visible for a short amount of time\n  // after the pointer left the host element for a better user experience.\n  const active$ =\n    combineLatest([\n      watchElementFocus(el),\n      watchElementHover(el)\n    ])\n      .pipe(\n        map(([focus, hover]) => focus || hover),\n        distinctUntilChanged()\n      )\n\n  // We need to determine all parent elements of the host element that are\n  // currently scrollable, as they might affect the position of the tooltip\n  // depending on their horizontal of vertical offset. We must track all of\n  // them and recompute the position of the tooltip if they change.\n  const offset$ =\n    defer(() => getElementContainers(el)).pipe(\n      mergeMap(watchElementContentOffset),\n      throttleTime(1),\n      map(() => getElementOffsetAbsolute(el))\n    )\n\n  // Only track parent elements and compute offset of the tooltip host if the\n  // tooltip should be shown - we defer the computation of the offset until the\n  // tooltip becomes active for the first time. This is necessary, because we\n  // must also keep the tooltip active as long as it is focused or hovered.\n  return active$.pipe(\n    first(active => active),\n    switchMap(() => combineLatest([active$, offset$])),\n    map(([active, offset]) => ({ active, offset })),\n    share()\n  )\n}\n\n/**\n * Mount tooltip\n *\n * This function renders a tooltip with the content from the provided `content$`\n * observable as passed via the dependencies. If the returned element has a role\n * of type `dialog`, the tooltip is considered to be interactive, and rendered\n * either above or below the host element, depending on the available space.\n *\n * If the returned element has a role of type `tooltip`, the tooltip is always\n * rendered below the host element and considered to be non-interactive. This\n * allows us to reuse the same positioning logic for both interactive and\n * non-interactive tooltips, as it is largely the same.\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip2(\n  el: HTMLElement, dependencies: Dependencies\n): Observable<Component<Tooltip>> {\n  const { content$, viewport$ } = dependencies\n\n  // Compute unique tooltip id - this is necessary to associate the tooltip host\n  // element with the tooltip element for ARIA purposes\n  const id = `__tooltip2_${sequence++}`\n\n  // Create component on subscription\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n\n    // Create subject to track tooltip presence and visibility - we use another\n    // purely internal subject to track the tooltip's presence and visibility,\n    // as the tooltip should be visible if the host element or tooltip itself\n    // is focused or hovered to allow for smooth pointer migration\n    const show$ = new BehaviorSubject(false)\n    push$.pipe(ignoreElements(), endWith(false))\n      .subscribe(show$)\n\n    // Create observable controlling tooltip element - we create and attach the\n    // tooltip only if it is actually present, in order to keep the number of\n    // elements low. We need to keep the tooltip visible for a short time after\n    // the pointer left the host element or tooltip itself. For this, we use an\n    // inner subscription to the tooltip observable, which we terminate when the\n    // tooltip should not be shown, automatically removing the element. Moreover\n    // we use the queue scheduler, which will schedule synchronously in case the\n    // tooltip should be shown, and asynchronously if it should be hidden.\n    const node$ = show$.pipe(\n      debounce(active => timer(+!active * 250, queueScheduler)),\n      distinctUntilChanged(),\n      switchMap(active => active ? content$ : EMPTY),\n      tap(node => node.id = id),\n      share()\n    )\n\n    // Compute tooltip presence and visibility - the tooltip should be shown if\n    // the host element or the tooltip itself is focused or hovered\n    combineLatest([\n      push$.pipe(map(({ active }) => active)),\n      node$.pipe(\n        switchMap(node => watchElementHover(node, 250)),\n        startWith(false)\n      )\n    ])\n      .pipe(map(states => states.some(active => active)))\n      .subscribe(show$)\n\n    // Compute tooltip origin - we need to compute the tooltip origin depending\n    // on the position of the host element, the viewport size, as well as the\n    // actual size of the tooltip, if positioned above. The tooltip must about\n    // to be rendered for this to be correct, which is why we do it here.\n    const origin$ = show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, viewport$),\n      map(([_, node, { size }]) => {\n        const host = el.getBoundingClientRect()\n        const x = host.width / 2\n\n        // If the tooltip is non-interactive, we always render it below the\n        // actual element because all operating systems do it that way\n        if (node.role === \"tooltip\") {\n          return { x, y: 8 + host.height }\n\n        // Otherwise, we determine where there is more space, and render the\n        // tooltip either above or below the host element\n        } else if (host.y >= size.height / 2) {\n          const { height } = getElementSize(node)\n          return { x, y: -16 - height }\n        } else {\n          return { x, y: +16 + host.height }\n        }\n      })\n    )\n\n    // Update tooltip position - we always need to update the position of the\n    // tooltip, as it might change depending on the viewport offset of the host\n    combineLatest([node$, push$, origin$])\n      .subscribe(([node, { offset }, origin]) => {\n        node.style.setProperty(\"--md-tooltip-host-x\", `${offset.x}px`)\n        node.style.setProperty(\"--md-tooltip-host-y\", `${offset.y}px`)\n\n        // Update tooltip origin - this is mainly set to determine the position\n        // of the tooltip tail, to show the direction it is originating from\n        node.style.setProperty(\"--md-tooltip-x\", `${origin.x}px`)\n        node.style.setProperty(\"--md-tooltip-y\", `${origin.y}px`)\n\n        // Update tooltip render location, i.e., whether the tooltip is shown\n        // above or below the host element, depending on the available space\n        node.classList.toggle(\"md-tooltip2--top\",    origin.y <  0)\n        node.classList.toggle(\"md-tooltip2--bottom\", origin.y >= 0)\n      })\n\n    // Update tooltip width - we only explicitly set the width of the tooltip\n    // if it is non-interactive, in case it should always be rendered centered\n    show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, (_, node) => node),\n      filter(node => node.role === \"tooltip\")\n    )\n      .subscribe(node => {\n        const size = getElementSize(getElement(\":scope > *\", node))\n\n        // Set tooltip width and remove tail by setting it to a width of zero -\n        // if authors want to keep the tail, we can move this to CSS later\n        node.style.setProperty(\"--md-tooltip-width\", `${size.width}px`)\n        node.style.setProperty(\"--md-tooltip-tail\",  `${0}px`)\n      })\n\n    // Update tooltip visibility - we defer to the next animation frame, because\n    // the tooltip must first be added to the document before we make it appear,\n    // or it will appear instantly without delay. Additionally, we need to keep\n    // the tooltip visible for a short time after the pointer left the host.\n    show$.pipe(\n      distinctUntilChanged(),\n      observeOn(animationFrameScheduler),\n      withLatestFrom(node$)\n    )\n      .subscribe(([active, node]) => {\n        node.classList.toggle(\"md-tooltip2--active\", active)\n      })\n\n    // Set up ARIA attributes when tooltip is visible\n    combineLatest([\n      show$.pipe(filter(active => active)),\n      node$\n    ])\n      .subscribe(([_, node]) => {\n        if (node.role === \"dialog\") {\n          el.setAttribute(\"aria-controls\", id)\n          el.setAttribute(\"aria-haspopup\", \"dialog\")\n        } else {\n          el.setAttribute(\"aria-describedby\", id)\n        }\n      })\n\n    // Remove ARIA attributes when tooltip is hidden\n    show$.pipe(filter(active => !active))\n      .subscribe(() => {\n        el.removeAttribute(\"aria-controls\")\n        el.removeAttribute(\"aria-describedby\")\n        el.removeAttribute(\"aria-haspopup\")\n      })\n\n    // Create and return component\n    return watchTooltip2(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n\n// ----------------------------------------------------------------------------\n\n/**\n * Mount inline tooltip\n *\n * @todo refactor this function\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n * @param container - Container\n *\n * @returns Tooltip component observable\n */\nexport function mountInlineTooltip2(\n  el: HTMLElement, { viewport$ }: { viewport$: Observable<Viewport> },\n  container = document.body\n): Observable<Component<Tooltip>> {\n  return mountTooltip2(el, {\n    content$: new Observable<HTMLElement>(observer => {\n      const title = el.title\n      const node = renderInlineTooltip2(title)\n      observer.next(node)\n      el.removeAttribute(\"title\")\n      // Append tooltip and remove on unsubscription\n      container.append(node)\n      return () => {\n        node.remove()\n        el.setAttribute(\"title\", title)\n      }\n    }),\n    viewport$\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  getElements,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"~/components/tooltip2\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountInlineTooltip2(button, { viewport$ }))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    // If the code block has line spans, we can add this additional class to\n    // the code block element, which fixes the problem for highlighted code\n    // lines not stretching to the entirety of the screen when the code block\n    // overflows, e.g., on mobile - see\n    const spans = getElements(\":scope > span[id]\", el)\n    if (spans.length)\n      el.classList.add(\"md-code__content\")\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@10/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el), watchElementVisibility(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchContentTabs(inputs)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"../../tooltip2\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountInlineTooltip2(child, { viewport$ }))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    // Handle color switch on Enter or Space - see https://t.ly/YIhVj\n    fromEvent<KeyboardEvent>(el, \"keydown\").pipe(\n      filter(ev => ev.key === \"Enter\"),\n      withLatestFrom(push$, (_, palette) => palette)\n    )\n      .subscribe(({ index }) => {\n        index = (index + 1) % inputs.length\n        inputs[index].click()\n        inputs[index].focus()\n      })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    document$.pipe(\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\")\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. It is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 RTICULAR PURPOSE AND NON-INFRINGEMENT. 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\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 RTICULAR PURPOSE AND NON-INFRINGEMENT. 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\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(url)\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(url => {\n            return fetchSitemap(new URL(url))\n              .pipe(\n                map(sitemap => {\n                  const location = getLocation()\n                  const path = location.href.replace(config.base, url)\n                  return sitemap.has(path.split(\"#\")[0])\n                    ? new URL(path)\n                    : new URL(url)\n                })\n              )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return requestJSON<ProjectSchema>(url)\n    .pipe(\n      catchError(() => EMPTY), // @todo refactor instant loading\n      map(({ star_count, forks_count }) => ({\n        stars: star_count,\n        forks: forks_count\n      })),\n      defaultIfEmpty({})\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountInlineTooltip2 } from \"~/components/tooltip2\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$, viewport$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        /* Mount tooltip */\n        return mountInlineTooltip2(host, { viewport$ })\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-status\")),\n      mergeMap(el => mountInlineTooltip2(el, { viewport$ }))\n    )\n      .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.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\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 NON-INFRINGEMENT. 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 * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
+  "mappings": "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",
+  "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "import_focus_visible", "extendStatics", "d", "b", "p", "__extends", "__", "__awaiter", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "e", "rejected", "result", "__generator", "body", "_", "t", "f", "y", "g", "verb", "n", "v", "op", "__values", "o", "s", "m", "i", "__read", "n", "r", "ar", "e", "error", "__spreadArray", "to", "from", "pack", "i", "l", "ar", "__await", "v", "__asyncGenerator", "thisArg", "_arguments", "generator", "g", "q", "verb", "n", "a", "b", "resume", "step", "e", "settle", "r", "fulfill", "reject", "value", "f", "__asyncValues", "o", "m", "i", "__values", "verb", "n", "v", "resolve", "reject", "settle", "d", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "BehaviorSubject", "_super", "__extends", "_value", "_this", "subscriber", "subscription", "_a", "hasError", "thrownError", "value", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "QueueAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "AsyncAction", "QueueScheduler", "_super", "__extends", "AsyncScheduler", "queueScheduler", "QueueScheduler", "QueueAction", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "EmptyError", "createErrorClass", "_super", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "debounce", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "emit", "value", "createOperatorSubscriber", "noop", "innerFrom", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "innerFrom", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "throwIfEmpty", "errorFactory", "defaultErrorFactory", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "EmptyError", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "first", "predicate", "defaultValue", "hasDefaultValue", "source", "filter", "v", "identity", "take", "defaultIfEmpty", "throwIfEmpty", "EmptyError", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "_a", "_b", "leading", "_c", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "_a", "_b", "_c", "_d", "observer$", "merge", "fromEvent", "debounceTime", "startWith", "map", "getActiveElement", "shareReplay", "watchElementFocus", "el", "active", "distinctUntilChanged", "watchElementHover", "el", "timeout", "defer", "merge", "fromEvent", "map", "debounce", "active", "timer", "identity", "startWith", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "round", "value", "digits", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "entry$", "Subject", "observer$", "defer", "watchScript", "of", "map", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "target", "tap", "filter", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "getElementContainers", "containers", "getElementOffset", "el", "getElementOffsetAbsolute", "rect", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchComposition", "merge", "fromEvent", "map", "startWith", "watchKeyboard", "keyboard$", "filter", "ev", "getToggle", "mode", "active", "getActiveElement", "share", "switchMap", "EMPTY", "getLocation", "setLocation", "url", "navigate", "feature", "el", "h", "watchLocation", "Subject", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "location$", "merge", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "Observable", "observer", "req", "event", "_a", "length", "requestJSON", "switchMap", "res", "map", "body", "shareReplay", "requestHTML", "dom", "requestXML", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "recv", "worker", "fromEvent", "ev", "send", "send$", "Subject", "data", "watchWorker", "url", "recv$", "worker$", "done$", "ignoreElements", "endWith", "mergeWith", "takeUntil", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "hash", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "renderTooltip", "id", "style", "h", "renderInlineTooltip2", "children", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "config", "configuration", "url", "feature", "match", "highlight", "value", "tags", "tag", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "_a", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "translation", "sequence", "watchTooltip2", "el", "active$", "combineLatest", "watchElementFocus", "watchElementHover", "map", "focus", "hover", "distinctUntilChanged", "offset$", "defer", "getElementContainers", "mergeMap", "watchElementContentOffset", "throttleTime", "getElementOffsetAbsolute", "first", "active", "switchMap", "offset", "share", "mountTooltip2", "dependencies", "content$", "viewport$", "id", "push$", "Subject", "show$", "BehaviorSubject", "ignoreElements", "endWith", "node$", "debounce", "timer", "queueScheduler", "EMPTY", "tap", "node", "startWith", "states", "origin$", "filter", "withLatestFrom", "_", "size", "host", "x", "height", "getElementSize", "origin", "getElement", "observeOn", "animationFrameScheduler", "state", "finalize", "__spreadValues", "mountInlineTooltip2", "container", "Observable", "observer", "title", "renderInlineTooltip2", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "ignoreElements", "endWith", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findHosts", "container", "getElements", "findMarkers", "markers", "el", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "pairs", "annotation", "getElement", "takeUntil", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "findList", "el", "sibling", "mountAnnotationBlock", "options", "defer", "list", "mountAnnotationList", "EMPTY", "import_clipboard", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "done$", "takeLast", "scrollable", "content$", "ClipboardJS", "feature", "parent", "button", "renderClipboardButton", "mountInlineTooltip2", "container", "list", "annotations$", "mountAnnotationList", "takeUntil", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "getElements", "tap", "state", "finalize", "__spreadValues", "mergeWith", "watchElementVisibility", "filter", "visible", "take", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "mermaid_default", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "__async", "id", "host", "h", "text", "svg", "fn", "shadow", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "inputs", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "el", "viewport$", "target$", "container", "getElements", "prev", "renderTabbedControl", "next", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatest", "watchElementSize", "watchElementVisibility", "takeUntil", "auditTime", "animationFrameScheduler", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "filter", "label", "h", "ev", "tap", "feature", "skip", "withLatestFrom", "tab", "y", "set", "tabs", "media", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountAnnotationBlock", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "feature", "mountInlineTooltip2", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "sequence", "watchTooltip", "el", "host", "width", "getElementSize", "container", "getElementContainer", "scroll$", "watchElementContentOffset", "of", "active$", "merge", "watchElementFocus", "watchElementHover", "distinctUntilChanged", "combineLatest", "map", "active", "scroll", "x", "y", "getElementOffset", "size", "table", "mountTooltip", "title", "EMPTY", "id", "tooltip", "renderTooltip", "typeset", "getElement", "defer", "push$", "Subject", "offset", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatestWith", "tooltips", "from", "getElements", "mergeMap", "child", "mountTooltip", "takeUntil", "state", "__spreadValues", "mergeWith", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "index", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "getElements", "meta", "h", "scheme", "media$", "watchMedia", "defer", "push$", "Subject", "palette", "media", "key", "value", "label", "filter", "ev", "withLatestFrom", "_", "header", "getComponentElement", "style", "color", "observeOn", "asyncScheduler", "takeUntil", "skip", "repeat", "tap", "state", "finalize", "__spreadValues", "mountProgress", "el", "progress$", "defer", "push$", "Subject", "value", "tap", "finalize", "map", "import_clipboard", "extract", "el", "copy", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "resolve", "url", "base", "extract", "document", "sitemap", "el", "getElements", "getElement", "links", "link", "href", "fetchSitemap", "requestXML", "map", "catchError", "of", "handle", "ev", "sitemap", "EMPTY", "el", "url", "of", "head", "document", "tags", "getElements", "resolve", "key", "value", "inject", "next", "selector", "feature", "source", "getOptionalElement", "target", "html", "name", "container", "getComponentElement", "concat", "switchMap", "script", "Observable", "observer", "ignoreElements", "endWith", "setupInstantNavigation", "location$", "viewport$", "progress$", "config", "configuration", "sitemap$", "fetchSitemap", "instant$", "fromEvent", "combineLatestWith", "share", "history$", "map", "getLocation", "withLatestFrom", "offset", "merge", "document$", "distinctUntilKeyChanged", "requestHTML", "catchError", "setLocation", "_", "distinctUntilChanged", "a", "b", "tap", "_a", "_b", "setLocationHash", "debounceTime", "import_escape_html", "setupSearchHighlighter", "config", "regex", "term", "separator", "highlight", "_", "data", "query", "match", "value", "escapeHTML", "isSearchReadyMessage", "message", "isSearchResultMessage", "setupSearchWorker", "url", "index$", "worker$", "watchWorker", "merge", "of", "watchToggle", "first", "active", "switchMap", "config", "docs", "feature", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "fetchSitemap", "sitemap", "path", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "_a", "outdated", "ignored", "main", "ignore", "warning", "getComponentElements", "watchSearchQuery", "el", "worker$", "searchParams", "getLocation", "setToggle", "watchToggle", "first", "active", "url", "focus$", "watchElementFocus", "value$", "merge", "isSearchReadyMessage", "fromEvent", "map", "distinctUntilChanged", "combineLatest", "value", "focus", "shareReplay", "mountSearchQuery", "push$", "Subject", "done$", "ignoreElements", "endWith", "_", "query", "distinctUntilKeyChanged", "takeUntil", "label", "getElement", "tap", "state", "finalize", "__spreadValues", "mountSearchResult", "el", "worker$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "container", "meta", "getElement", "list", "watchToggle", "active", "withLatestFrom", "skipUntil", "first", "isSearchReadyMessage", "items", "value", "translation", "count", "round", "render$", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "map", "renderSearchResultItem", "share", "item", "mergeMap", "details", "getOptionalElement", "EMPTY", "fromEvent", "takeUntil", "isSearchResultMessage", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "done$", "ignoreElements", "endWith", "fromEvent", "takeUntil", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "worker$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggest", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "worker$", "setupSearchWorker", "query", "getComponentElement", "result", "fromEvent", "filter", "target", "setToggle", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "els", "i", "query$", "mountSearchQuery", "merge", "mountSearchResult", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "next$", "auditTime", "animationFrameScheduler", "withLatestFrom", "first", "item", "getElements", "container", "getElementSize", "from", "mergeMap", "label", "fromEvent", "observeOn", "asyncScheduler", "takeUntil", "input", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "requestJSON", "catchError", "EMPTY", "map", "star_count", "forks_count", "defaultIfEmpty", "fetchSourceFacts", "url", "match", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "parent", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "main$", "target$", "push$", "Subject", "done$", "ignoreElements", "endWith", "feature", "smooth$", "merge", "debounceTime", "filter", "observeOn", "asyncScheduler", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "ignoreElements", "distinctUntilKeyChanged", "height", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "patchEllipsis", "document$", "viewport$", "switchMap", "getElements", "mergeMap", "el", "watchElementVisibility", "takeUntil", "skip", "filter", "visible", "map", "take", "text", "host", "mountInlineTooltip2", "finalize", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "fetchSearchIndex", "watchScript", "config", "map", "shareReplay", "requestJSON", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "configuration", "index$", "NEVER", "alert$", "Subject", "setupClipboardJS", "progress$", "feature", "setupInstantNavigation", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "setLocation", "next", "active", "getActiveElement", "patchEllipsis", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "switchMap", "el", "watchMain", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountHeader", "mountPalette", "mountProgress", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"]
 }
diff --git a/latest/demo/horizontal/index.html b/latest/demo/horizontal/index.html
index 6ee5343d..6f2fcf8f 100644
--- a/latest/demo/horizontal/index.html
+++ b/latest/demo/horizontal/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1400,7 +1400,7 @@ <h2 id="requirements-for-running-the-user-case">Requirements for running the use
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/demo/index.html b/latest/demo/index.html
index c1f8d91d..5cea8776 100644
--- a/latest/demo/index.html
+++ b/latest/demo/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1400,7 +1400,7 @@ <h2 id="the-user-case-welding-an-aluminium-plate-to-steel">The user case - weldi
     <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/demo/vertical/index.html b/latest/demo/vertical/index.html
index d4242aca..802b2c0c 100644
--- a/latest/demo/vertical/index.html
+++ b/latest/demo/vertical/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1492,7 +1492,7 @@ <h3 id="the-new-application-ontology">The new application-ontology<a class="head
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/developers/release-instructions/index.html b/latest/developers/release-instructions/index.html
index 0e98b9fd..1b488e67 100644
--- a/latest/developers/release-instructions/index.html
+++ b/latest/developers/release-instructions/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1328,7 +1328,7 @@ <h1 id="steps-for-creating-a-new-release">Steps for creating a new release<a cla
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/developers/setup/index.html b/latest/developers/setup/index.html
index 2f58efba..f4b728da 100644
--- a/latest/developers/setup/index.html
+++ b/latest/developers/setup/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1561,7 +1561,7 @@ <h2 id="test-the-installation">Test the installation<a class="headerlink" href="
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/developers/testing/index.html b/latest/developers/testing/index.html
index af6ca4e9..1eaeb226 100644
--- a/latest/developers/testing/index.html
+++ b/latest/developers/testing/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1438,7 +1438,7 @@ <h3 id="mypy">Mypy<a class="headerlink" href="#mypy" title="Permanent link">&par
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/docker-instructions/index.html b/latest/docker-instructions/index.html
index 9fd2cf90..cb5b1293 100644
--- a/latest/docker-instructions/index.html
+++ b/latest/docker-instructions/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1552,7 +1552,7 @@ <h3 id="notes-on-mounting-on-windows">Notes on mounting on Windows<a class="head
     <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/emmodoc/classes/index.html b/latest/examples/emmodoc/classes/index.html
index c1fb8c88..bbb26466 100644
--- a/latest/examples/emmodoc/classes/index.html
+++ b/latest/examples/emmodoc/classes/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1367,7 +1367,7 @@ <h1 id="branchdoc-subatomic">%BRANCHDOC Subatomic<a class="headerlink" href="#br
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/emmodoc/emmo/index.html b/latest/examples/emmodoc/emmo/index.html
index a7853557..8f20a5e9 100644
--- a/latest/examples/emmodoc/emmo/index.html
+++ b/latest/examples/emmodoc/emmo/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -149,7 +149,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1310,7 +1310,7 @@ <h1>Emmo</h1>
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/emmodoc/important_concepts/index.html b/latest/examples/emmodoc/important_concepts/index.html
index 677114db..ae9f12d7 100644
--- a/latest/examples/emmodoc/important_concepts/index.html
+++ b/latest/examples/emmodoc/important_concepts/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1510,7 +1510,7 @@ <h3 id="properties">Properties<a class="headerlink" href="#properties" title="Pe
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/emmodoc/index.html b/latest/examples/emmodoc/index.html
index 7ccf880e..dc443ed9 100644
--- a/latest/examples/emmodoc/index.html
+++ b/latest/examples/emmodoc/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1486,7 +1486,7 @@ <h2 id="using-this-example-as-a-starting-point-for-documenting-your-own-ontology
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/emmodoc/introduction/index.html b/latest/examples/emmodoc/introduction/index.html
index bc42b80c..9f70f09f 100644
--- a/latest/examples/emmodoc/introduction/index.html
+++ b/latest/examples/emmodoc/introduction/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1965,7 +1965,7 @@ <h3 id="annotations">Annotations<a class="headerlink" href="#annotations" title=
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/emmodoc/relations/index.html b/latest/examples/emmodoc/relations/index.html
index d78b1c42..3a553d22 100644
--- a/latest/examples/emmodoc/relations/index.html
+++ b/latest/examples/emmodoc/relations/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1365,7 +1365,7 @@ <h1 id="branchdoc-connected">%BRANCHDOC connected<a class="headerlink" href="#br
     <script id="__config" type="application/json">{"base": "../../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/jupyter-visualization/index.html b/latest/examples/jupyter-visualization/index.html
index bda7ede1..e897c84d 100644
--- a/latest/examples/jupyter-visualization/index.html
+++ b/latest/examples/jupyter-visualization/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1408,7 +1408,7 @@ <h2 id="test-the-notebook">Test the notebook<a class="headerlink" href="#test-th
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/examples/ontology-from-excel/index.html b/latest/examples/ontology-from-excel/index.html
index 7475f070..c4b4f6d3 100644
--- a/latest/examples/ontology-from-excel/index.html
+++ b/latest/examples/ontology-from-excel/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1330,7 +1330,7 @@ <h1 id="generate-an-ontology-from-excel">Generate an ontology from excel<a class
     <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/index.html b/latest/index.html
index 373a46f3..9c30266c 100644
--- a/latest/index.html
+++ b/latest/index.html
@@ -18,7 +18,7 @@
       
       
       <link rel="icon" href="images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -152,7 +152,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -1779,7 +1779,7 @@ <h3 id="contributing-projects">Contributing projects<a class="headerlink" href="
     <script id="__config" type="application/json">{"base": ".", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>
diff --git a/latest/search/search_index.json b/latest/search/search_index.json
index a029dd37..2cfe6d9a 100644
--- a/latest/search/search_index.json
+++ b/latest/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#emmontopy","title":"EMMOntoPy","text":"<p>Library for representing and working with ontologies in Python.</p> <p> </p> <p>EMMOntoPy is a Python package based on the excellent Owlready2, which provides a natural and intuitive representation of ontologies in Python. EMMOntoPy extends Owlready2 and adds additional functionality, like accessing entities by label, reasoning with FaCT++ and parsing logical expressions in Manchester syntax. It also includes a set of tools, like creating an ontology from an Excel sheet, generation of reference documentation of ontologies and visualisation of ontologies graphically. EMMOntoPy is freely available for on GitHub and on PyPI under the permissive open source BSD 3-Clause license.</p> <p>EMMOntoPy was originally developed to work effectively with the Elemental Multiperspective Material Ontology (EMMO) and EMMO-based domain ontologies. It has now two sub-packages, <code>ontopy</code> and <code>emmopy</code>, where <code>ontopy</code> is a general package to work with any OWL ontology, while <code>emmopy</code> provides extra features that are specific to EMMO.</p> <p>Owlready2, and thereby also EMMOntoPy, represents OWL classes and individuals in Python as classes and instances. OWL properties are represented as Python attributes. Hence, it provides a new dot notation for representing ontologies as valid Python code. The notation is simple and easy to understand and write for people with some knowledge of OWL and Python. Since Python is a versatile programming language, Owlready2 does not only allow for representation of OWL ontologies, but also to work with them programmatically, including interpretation, modification and generation. Some of the additional features provided by EMMOntoPy are are listed below:</p>"},{"location":"#access-by-label","title":"Access by label","text":"<p>In Owlready2 ontological entities, like classes, properties and individuals are accessed by the name-part of their IRI (i.e. everything that follows after the final slash or hash in the IRI). This is very inconvenient for ontologies like EMMO or Wikidata, that identify ontological entities by long numerical names. For instance, the name-part of the IRI of the Atom class in EMMO is \u2018EMMO_eb77076b_a104_42ac_a065_798b2d2809ad\u2019, which is neither human readable nor easy to write. EMMOntoPy allows to access the entity via its label (or rather skos:prefLabel) \u2018Atom\u2019, which is much more user friendly.</p>"},{"location":"#turtle-serialisationdeserialisation","title":"Turtle serialisation/deserialisation","text":"<p>The Terse RDF Triple Language (Turtle) is a common syntax and file format for representing ontologies. EMMOntoPy adds support for reading and writing ontologies in turtle format.</p>"},{"location":"#fact-reasoning","title":"FaCT++ reasoning","text":"<p>Owlready2 has only support for reasoning with HermiT and Pellet. EMMOntoPy adds additional support for the fast tableaux-based [FaCT++ reasoner] for description logics.</p>"},{"location":"#manchester-syntax","title":"Manchester syntax","text":"<p>Even though the Owlready2 dot notation is clear and easy to read and understand for people who know Python, it is a new syntax that may look foreign for people that are used to working with Prot\u00e9g\u00e9. EMMOntoPy provides support to parse and serialise logical expressions in Manchester syntax, making it possible to create tools that will be much more familiar to work with for people used to working with Prot\u00e9g\u00e9.</p>"},{"location":"#visualisation","title":"Visualisation","text":"<p>EMMOntoPy provides a Python module for graphical visualisation of ontologies. This module allows to graphically represent not only the taxonomy, but also restrictions and logical constructs. The classes to include in the graph, can either be specified manually or inferred from the taxonomy (like all subclasses of a give class that are not a subclass of any class in a set of other classes).</p>"},{"location":"#tools","title":"Tools","text":"<p>EMMOntoPy includes a small set of command-line tools implemented as Python scripts:   - <code>ontoconvert</code>:     Converts ontologies between different file formats.     It also supports some additional transformation during conversion, like running a reasoner, merging several ontological modules together (squashing), rename IRIs, generate catalogue file and automatic annotation of entities with their source IRI.   - <code>ontograph</code>:     Vertasile tool for visualising (parts of) an ontology, utilising the visualisation features mention above.   - <code>ontodoc</code>:     Documents an ontology.   - <code>excel2onto</code>:     Generate an EMMO-based ontology from an excel file.     It is useful for domain experts with limited knowledge of ontologies and that are not used to tools like Prot\u00e9g\u00e9.   - <code>ontoversion</code>:     Prints ontology version number.   - <code>emmocheck</code>:     A small test framework for checking the consistency of EMMO and EMMO-based domain ontologies and whether they confirm to the EMMO conventions.</p>"},{"location":"#some-examples-of-what-you-can-do-with-emmontopy-includes","title":"Some examples of what you can do with EMMOntoPy includes:","text":"<ul> <li>Access and query RDF-based ontologies from your application.   This includes several different flavors of RDF (OWL, Turtle (<code>ttl</code>), and more).</li> <li>Access and query EMMO-based ontologies from your application.</li> <li>Extend EMMO with new domain or application ontologies.   This can be done both statically with easy readable Python code or dynamically within your application.</li> <li>Generate graphs and documentation of your ontologies.   EMMOntoPy includes <code>ontodoc</code>: A dedicated command line tool for this.   You find it in the tools/ sub directory.</li> <li>Check that an EMMO-based domain or application ontology adhere to the conventions of EMMO.</li> <li>Interactively explore an ontology in any Python interpreter, e.g., IPython.   Tab-completion makes exploration easy and fast.   Below is an example of an IPython session where we check the relations of <code>Matter</code> in EMMO utilizing the <code>emmopy.get_emmo</code> function:</li> </ul> <pre><code>In [1]: from emmopy import get_emmo\n\nIn [2]: emmo = get_emmo()\n\nIn [3]: emmo.Matter\nOut[3]: physicalistic.Matter\n\nIn [4]: emmo.Matter.is_a\nOut[4]:\n[physicalistic.Physicalistic,\n  physical.Physical,\n  mereotopology.hasPart.some(physicalistic.Massive),\n  physical.hasTemporalPart.only(physicalistic.Matter)]\n</code></pre>"},{"location":"#documentation-and-examples","title":"Documentation and examples","text":"<p>The Owlready2 documentation is a good starting point. The EMMOntoPy package also has its own dedicated documentation.</p> <p>This includes a few examples and demos:</p> <ul> <li> <p>demo/vertical shows an example of how EMMO may be used to achieve vertical interoperability.   The file define-ontology.py provides a good example for how an EMMO-based application ontology can be defined in Python.</p> </li> <li> <p>demo/horizontal shows an example of how EMMO may be used to achieve horizontal interoperability.   This demo also shows how you can use EMMOntoPy to represent your ontology with the low-level metadata framework DLite.   In addition to achieve interoperability, as shown in the demo, DLite also allow you to automatically generate C or Fortran code base on your ontology.</p> </li> <li> <p>examples/emmodoc shows how the documentation of EMMO is generated using the <code>ontodoc</code> tool.</p> </li> </ul>"},{"location":"#installation","title":"Installation","text":"<p>Install with:</p> <pre><code>pip install EMMOntoPy\n</code></pre>"},{"location":"#required-dependencies","title":"Required Dependencies","text":"<ul> <li>Python 3.7 or later.</li> <li>Owlready2 v0.23 or later.</li> </ul>"},{"location":"#optional-dependencies","title":"Optional Dependencies","text":"<ul> <li>Graphviz: Needed for graph generation.   With support for generation pdf, png and svg figures for tests and generation of documentation automatically (<code>ontodoc</code>).</li> <li>pandoc: Only used for generated documentation from markdown to nicely formatted html or pdf.   Tested with v2.1.2.</li> <li> <p>pdfLaTeX or XeLaTeX and the <code>upgreek</code> LaTeX package (included in <code>texlive-was</code> on RetHat-based distributions and <code>texlive-latex-extra</code> on Ubuntu) for generation of pdf documentation.   If your ontology contains exotic unicode characters, we recommend XeLaTeX.</p> </li> <li> <p>Java.   Needed for reasoning.</p> </li> <li> <p>Optional Python packages:</p> </li> <li>graphviz: Generation of documentation and graphs.</li> <li>PyYAML: Required for generating documentation with pandoc.</li> <li>blessings: Clean output for <code>emmocheck</code>.</li> <li>Pygments: Coloured output for <code>emmocheck</code>.</li> <li>rdflib: Required for <code>ontoversion</code>-tool.</li> <li>semver: Required for <code>ontoversion</code>-tool.</li> <li>pydot: Used for generating graphs.     Will be deprecated.</li> <li>pyparsing: Used for parsing Manchester syntax</li> </ul> <p>See docker-instructions.md for how to build a docker image.</p>"},{"location":"#known-issues","title":"Known issues","text":"<ul> <li>Invalid serialising to turtle: Due to rdflib issue #1043 <code>ontoconvert</code> may produce invalid turtle output (if your ontology contains real literals using scientific notation without a dot in the mantissa).   This issue was fixed after the release of rdflib 5.0.0.   Hence, install the latest rdflib from PyPI (<code>pip install --upgrade rdflib</code>) or directly from the source code repository: GitHub if you need to serialise to turtle.</li> </ul>"},{"location":"#attributions-and-credits","title":"Attributions and credits","text":"<p>EMMOntoPy is maintained by EMMC-ASBL. It has mainly been developed by SINTEF, specifically:</p> <ul> <li>Jesper Friis (jesper-friis)</li> <li>Francesca L. Bleken (francescalb)</li> <li>Casper W. Andersen (CasperWA)</li> <li>Bj\u00f8rn Tore L\u00f8vfall (lovfall)</li> </ul>"},{"location":"#contributing-projects","title":"Contributing projects","text":"<ul> <li>EMMC-CSA;   Grant Agreement No: 723867   </li> </ul> <p>The EMMC-ASBL organization takes on the efforts of continuing and expanding on the efforts of the CSA. - MarketPlace;   Grant Agreement No: 760173    - OntoTrans;   Grant Agreement No: 862136    - BIG-MAP;   Grant Agreement No: 957189    - OpenModel;   Grant Agreement No: 953167   </p>"},{"location":"CHANGELOG/","title":"Changelog","text":""},{"location":"CHANGELOG/#unreleased-changes-2024-05-29","title":"Unreleased changes (2024-05-29)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>excelparser, allow for = in strings for other annotations. #751</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed failing test_save in master #756 (jesper-friis)</li> <li>Added possibility for = in extra annotations defined in excelparser #752 (francescalb)</li> <li>Load doamin-battery instead of battinfo which is just an extra wrapping #745 (francescalb)</li> <li>Rewriting ontodoc based on domain-battery #742 (jesper-friis)</li> <li>Make it possible to run HermiT on EMMO #740 (jesper-friis)</li> <li>Added minor fixes for ontoconvert #739 (jesper-friis)</li> <li>Added additional recognised prefixes #734 (jesper-friis)</li> <li>Copy EMMO annotations #733 (jesper-friis)</li> <li>Add --copy-annotation option to ontoconvert #732 (jesper-friis)</li> <li>Updated list of IRIs to ignore when checking prefLabel #731 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v071-2024-02-29","title":"v0.7.1 (2024-02-29)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v0701-2024-02-29","title":"v0.7.0.1 (2024-02-29)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Implement ontoconvert --base-iri argument #716</li> </ul> <p>Merged pull requests:</p> <ul> <li>Added <code>yield from</code> #720 (jesper-friis)</li> <li>Correct saving squashed ontology #719 (jesper-friis)</li> <li>Updated ontoconvert help #715 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v070-2024-01-26","title":"v0.7.0 (2024-01-26)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Ontology copy #711 (francescalb)</li> <li>Update save recursive and layout #710 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v063-2024-01-25","title":"v0.6.3 (2024-01-25)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Fix infinite recursion in directory layout #708 (jesper-friis)</li> <li>Ensure that saving with squash removes all but current ontology #707 (jesper-friis)</li> <li>Turned on directory layout tests for emmo and made them pytest #706 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v062-2024-01-23","title":"v0.6.2 (2024-01-23)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Allow controling ontology IRI when saving #700 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v061-2024-01-18","title":"v0.6.1 (2024-01-18)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>No tests for ontology.save #684</li> <li>Allow using HermiT from ontoconvert #664</li> <li>PrefLabel used by new_entity, and get_by_label even if it is not in the ontology #642</li> <li>ontology(imported=True) returns all classes in world #640</li> <li>excel2onto example doesn't come into the github pages documentation #626</li> <li>owlready2 &gt; 0.41 fails #624</li> <li>get_by_label and get_by_label all force add label_annotations #621</li> <li>hasPhysicalDimension convention has changed in EMMO-1.0.0-beta3 #347</li> </ul> <p>Merged pull requests:</p> <ul> <li>Avoid infinite recursion in set_common_prefix() #701 (jesper-friis)</li> <li>Updated the getattr patch #699 (jesper-friis)</li> <li>WIP: Fix issues with changed IRIs effecting test_excelparser #697 (jesper-friis)</li> <li>Added directory_layout() function #696 (jesper-friis)</li> <li>Added redirection checking tool #695 (jesper-friis)</li> <li>Add test save #686 (francescalb)</li> <li>Update test_unit_dimension in emmocheck to EMMO 1.0.0-beta5 #678 (jesper-friis)</li> <li>Skip checking dimensional units for domain ontologies that doesn't load this class. #677 (jesper-friis)</li> <li>HermiT is default reasoner. #671 (francescalb)</li> <li>Ci/dependabot updates #662 (francescalb)</li> <li>Updated emmocheck to new EMMO quantities and units #658 (jesper-friis)</li> <li>Update README.md #657 (jesper-friis)</li> <li>Corrected bug so that asking for entities in imported does not return all in world #655 (francescalb)</li> <li>Corrected get_by_label to use only labels in the ontology #643 (francescalb)</li> <li>Update to comply with owlready2&gt;0.41 #639 (francescalb)</li> <li>Ontodoc example in documentation #630 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v060-2023-06-19","title":"v0.6.0 (2023-06-19)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>pyparsing has been updated #629</li> </ul> <p>Merged pull requests:</p> <ul> <li>Check prefLabels in imported ontologies only if asked for. #628 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v054-2023-06-15","title":"v0.5.4 (2023-06-15)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v0532-2023-06-15","title":"v0.5.3.2 (2023-06-15)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>remove warnings_as_errors in cd workflow introduced in 0.5.3 #625 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v053-2023-06-12","title":"v0.5.3 (2023-06-12)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v0531-2023-06-12","title":"v0.5.3.1 (2023-06-12)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Extend new_entity to include properties #609</li> <li>Add support for Python 3.11 #599</li> <li>excelparser - enable object properties creation #587</li> <li>If there are altLabels that match, get_by_label_all returns only the prefLabels. #511</li> <li>excel2onto: implement other annotations #462</li> </ul> <p>Merged pull requests:</p> <ul> <li>default_annotations no longer forced in get_by_label #623 (francescalb)</li> <li>Updated documentation and excel sheet in example. #622 (francescalb)</li> <li>Flb/excel2onto properties #620 (francescalb)</li> <li>Fixed failing tests in test_patch.py #618 (jesper-friis)</li> <li>Add test for Python 3.11 and support it officially #615 (jesper-friis)</li> <li>Added doctest #614 (jesper-friis)</li> <li>Item access to classes #613 (jesper-friis)</li> <li>Change ontology.new_entity to also allow adding properties #610 (francescalb)</li> <li>Added DOI badge #606 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v052-2023-05-24","title":"v0.5.2 (2023-05-24)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Auto-merge dependabot PRs workflow invalid #566</li> </ul> <p>Closed issues:</p> <ul> <li>Point to excelparser api from the tools-page #593</li> <li>BUG: pytest - missing remote file /0.5.0/electrochemicalquantities / ontology #589</li> <li>Owlready 0.41 support ? #588</li> <li>Allow space in labels #583</li> <li>is_defined needs a better description  #563</li> <li>utils line 112 in get_iri_name link = \"{lowerlabel}\" vs \"{label}\" #562</li> <li>ontograph - update colour deafults #559</li> <li>ontograph - argument leafs should be leaves #558</li> <li>ontograph - write out more examples on how to use it #557</li> <li>ontograph --parents not working #556</li> <li>test_graph2 is failing  #555</li> <li>Add client side redirection in generated html documentation #552</li> <li>Typos in PR template #523</li> <li>ontograph, read format from name #497</li> <li>Harmonize get_descendants and get_ancestors #406</li> <li>Review default colours and style in ontopy/graph.py #345</li> </ul> <p>Merged pull requests:</p> <ul> <li>Add links to the original FaCT++ repo, GitHub profiles, etc. #600 (blokhin)</li> <li>Added test update to PR template. #598 (jesper-friis)</li> <li>Changed <code>is_defined</code> into a ThingClass property and improved its documentation. #597 (jesper-friis)</li> <li>Added link to excelparser from tools for documentation of excel sheet. #594 (francescalb)</li> <li>Bump SINTEF/ci-cd from 2.3.0 to 2.3.1 #584 (dependabot[bot])</li> <li>Updated get_by_label() so that it now accepts label, name and full iri #582 (jesper-friis)</li> <li>Added two additional exceptions to emmocheck #577 (jesper-friis)</li> <li>Bump SINTEF/ci-cd from 2.2.1 to 2.3.0 #575 (dependabot[bot])</li> <li>get_ancestors and get_descendants have the same arguments. #572 (francescalb)</li> <li>Bump SINTEF/ci-cd from 2.2.0 to 2.2.1 #571 (dependabot[bot])</li> <li>ontograph: colour updates, examples, bugfix #569 (francescalb)</li> <li>Bump SINTEF/ci-cd from 2.1.0 to 2.2.0 #567 (dependabot[bot])</li> <li>Changed argument leafs to leaves, with deprecation warning in ontograph #564 (francescalb)</li> <li>Corrected bug on getting default relation style. #561 (francescalb)</li> <li>Fix internal links in generated documentation generated with ontodoc #548 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v051-2023-02-07","title":"v0.5.1 (2023-02-07)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Use custom token for GitHub changelog generator #545</li> <li>Avoid using Azure mirror for APT packages #541</li> </ul> <p>Merged pull requests:</p> <ul> <li>Use SINTEF/ci-cd v2.1.0 in CI/CD workflows #546 (CasperWA)</li> <li>Revert version to v0.5.0 #544 (CasperWA)</li> <li>Fix ontodoc for bigmap #543 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v050-2023-02-06","title":"v0.5.0 (2023-02-06)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li><code>LegacyVersion</code> does not exist in <code>packaging.version</code> #540</li> <li>ontodoc: Expect <code>is_instance_of</code> property to be iterable #506</li> <li>Reinstate <code>images/material.png</code> #495</li> </ul> <p>Closed issues:</p> <ul> <li>Newest pylint (2.15.4) has intriduced some new rules. #534</li> <li>sync_attributes according to emmo convention regenerates a new iri even if it already has a valid one #525</li> <li>Remove dependency on LegacyVersion of packaging #514</li> <li>pytests are importing packaging 22.0 even though it is not allowed in requirements #513</li> <li>ontodoc: adding annotations that are not strings fail #510</li> <li>get_by_label_all only works after sync_attributes #502</li> <li>excel2onto: support updating ontology  #501</li> <li>excel2onto: allow to use prefLabel already in imported ontologies #500</li> <li>Drop Python 3.6 support - extend Python &gt;3.7 support #486</li> <li>Update pypi-release github action #482</li> <li>Make workflows dispatchable #481</li> <li>excel2onto: Read catalog file for imported ontology #474</li> <li>Give option to write_catalog for writing relative paths #473</li> <li>excel2onto: add choice of prefix for imported ontologies #467</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fix fixtures for Python3.7 #536 (CasperWA)</li> <li>Flb/fix to pylint2.15.4 #535 (francescalb)</li> <li>Bypass punning in ontodoc. #532 (francescalb)</li> <li>Added possibility to update ontology.  #527 (francescalb)</li> <li>Only generate new uuid if not already a valid one #526 (francescalb)</li> <li>Removed LegacyVersion from ontopy.utils #515 (francescalb)</li> <li>Added fix for adding annotations that are not strings in ontodoc #512 (francescalb)</li> <li>Do not trigger an emmocheck failure for ontologies with a foaf:logo annotation #509 (jesper-friis)</li> <li>New concepts allowed even if name alrady exists in imported ontologies #504 (francescalb)</li> <li>Corrected so that get_by_label_all also returns all concepts #503 (francescalb)</li> <li>Added correct material.png figure in tool-instructions #498 (francescalb)</li> <li>Updated logo #494 (jesper-friis)</li> <li>Makeover for CI/CD workflows, pre-commit &amp; MkDocs #485 (CasperWA)</li> <li>write catalog now writes relative paths per default #483 (francescalb)</li> <li>Setting prefix explicitly in excelparser #470 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v040-2022-10-04","title":"v0.4.0 (2022-10-04)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Update repo files with new repo name #479</li> <li>Pre-commit hook <code>bandit</code> failing #478</li> <li>Fix publish/release workflow #476</li> <li>excel2onto: not all relations are included in the generated ontology #457</li> <li>Unexpected behaviour of get_unabbreviated_triples()  #454</li> <li>Edge without label crash the graph creation #397</li> </ul> <p>Closed issues:</p> <ul> <li>excel2onto: restrictions does not allow for using \"emmo:hasProcessOutput some xx\" #464</li> <li>EMMO is updated to beta4, and now documentation fails #440</li> <li>some ObjectProperties from EMMO-beta-4.0 cause errors in OntoGraph #429</li> <li>Excelparser does not write catalog file correctly #421</li> <li>Add support for prefix #416</li> <li>Pre.commit failed with ontology.py #415</li> <li>visualization of EMMO based ontology #412</li> <li>Avoid infinite recursion when loading catalog file #369</li> <li>Excelparser: Automatize emmo-based? #335</li> <li>What are the applications of EMMO for materials informatics? #325</li> <li>Provide 'support' for same entities with different namespaces #128</li> <li>Remove deprecated emmo/ontograph.py that uses pydot #103</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update from 'EMMO-python' -&gt; 'EMMOntoPy' #477 (CasperWA)</li> <li>Allow for adding prefix in manchester notation. #469 (francescalb)</li> <li>Fixed issue with exel2onto: not all relations are included in the generated ontology #458 (jesper-friis)</li> <li>Added documentation of excel2onto #456 (jesper-friis)</li> <li>factpluspluswrapper README file #453 (jesper-friis)</li> <li>Improved get_unabbreviated_triples() #449 (jesper-friis)</li> <li>Fix loading in windows, url paths #446 (francescalb)</li> <li>Fixed reading web destinations defined in catalog #445 (francescalb)</li> <li>SUPPORT EMMO-beta4.0 #441 (francescalb)</li> <li>Support for userdefined prefixes #439 (francescalb)</li> <li>Flb/issue421 #438 (francescalb)</li> <li>Update demo #437 (jesper-friis)</li> <li>Silence false negative from pylint on github #436 (jesper-friis)</li> <li>Better error messages #435 (jesper-friis)</li> <li>Updated logo. #418 (jesper-friis)</li> <li>cytoscapegraph fails with missing edge labels #414 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v031-2022-05-08","title":"v0.3.1 (2022-05-08)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Fixed typo in ontoconvert #409 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v030-2022-05-05","title":"v0.3.0 (2022-05-05)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Documentation is currently not building #407</li> <li>Pytest is currently failing #384</li> <li>permission denied when working with temporary file #313</li> </ul> <p>Closed issues:</p> <ul> <li>Make get_descendants(levels=1) #403</li> <li>Add functionality for setting name part of IRI to prefLabel #398</li> <li>Generate excelsheet from ontology. #394</li> <li>Return a list of the concepts that are disregarded during when converting from excel with -force argument #393</li> <li>Demo - Broken ontology URLs #390</li> <li>Excelparser: how to handle entities that already exist in one of the imported ontologies? #334</li> </ul> <p>Merged pull requests:</p> <ul> <li>Updated docs python handler #408 (CasperWA)</li> <li>Flb/get descendants #405 (francescalb)</li> <li>Corrected expected number of returned arguments #404 (jesper-friis)</li> <li>Add functionality for setting name part of IRI to prefLabel #399 (jesper-friis)</li> <li>create_from_excel/pandas return as list of concepts that are worngly defined in the excelfile #396 (francescalb)</li> <li>Download EMMO from raw.github deirectly as redirection is broken #392 (francescalb)</li> <li>Workaround for failing test #385 (CasperWA)</li> <li>fix #313 remove handle #315 (sygout)</li> </ul>"},{"location":"CHANGELOG/#v020-2022-03-02","title":"v0.2.0 (2022-03-02)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>spaces before or after word in prefLabel makes excelparser fail #332</li> <li>Make EMMOntopy PyPi #268</li> <li>Use <code>pre-commit</code> #243</li> <li>Standard dunder/magic methods for <code>Ontology</code> #228</li> <li>Update code styling and linting #223</li> <li>Fix checking PR body &amp; improve error message in CD #318 (CasperWA)</li> </ul> <p>Fixed bugs:</p> <ul> <li>GH GraphQL type issue for auto-merge workflow #374</li> <li>Missing warning for excel parser relations and problem with \"nan\" #365</li> <li>Seting metadata in excelparser fails if there are no imported ontologies. #331</li> <li>Edge-case fails CD workflow for dependabot #319</li> <li>Ontodoc failing due to wrong <code>rdflib</code> import #306</li> <li>Overwriting <code>get_triples()</code> method #280</li> <li>OpenModel logo not loading in README #278</li> <li>Disable FOAF test as xmlns.com is down #276</li> </ul> <p>Closed issues:</p> <ul> <li>Use TEAM 4.0[bot] for GH Actions jobs #352</li> <li>_get_triples_spo take argumens s, and p, not subject and predicate #350</li> <li>Add --force to excelparser #333</li> <li>Cannot load ontology in Windows. #328</li> <li>make get_ontology accept 'PosixPath' #326</li> <li>Make EMMOntoPy baseexception and basewarning #321</li> <li>get_by_label crash  if not str #311</li> <li>make excel parser that creates and ontology from a filled excel file #302</li> <li>Check out how to get version of ontology #299</li> <li>Let ontology.new_entity acccept one or more parents directly #294</li> <li>Make ManchesterSyntaxParser that returns Owlready2 #293</li> <li>onto.new_entity should throw Error if label name consists of more than one word #290</li> <li>ReadTheDocs #288</li> <li>Add logo to README #287</li> <li>Write EMMO-python is deprecated and link to EMMOtopy on PyPi #269</li> <li>Consider MarkDown header styling #231</li> </ul> <p>Merged pull requests:</p> <ul> <li>Use <code>ID!</code> type instead of <code>String!</code> #375 (CasperWA)</li> <li>Avoided infinite recursion when loading catalog files that recursively #370 (jesper-friis)</li> <li>Warning relation excelparser #366 (sygout)</li> <li>Close temporary file before reading it #364 (jesper-friis)</li> <li>Ignore safety ID 44715 + add numpy dependency #361 (CasperWA)</li> <li>Use TEAM 4.0[bot] #353 (CasperWA)</li> <li>Changed arguments in _has_obj_triples_spo #351 (francescalb)</li> <li>Fix serialised ontology iri #341 (jesper-friis)</li> <li>Corrected parsing cardinality restrictions #340 (jesper-friis)</li> <li>When visualising restrictions, annotate the edges with the restriction type by default #339 (jesper-friis)</li> <li>Flb/update excel parser accroding to thermodynamics example #336 (francescalb)</li> <li>Added sconverting Posix to str in get_ontology #327 (francescalb)</li> <li>Added package specific base exception and base warning for EMMOntoPy #322 (francescalb)</li> <li>Added checking that label is string in get_by_label #312 (francescalb)</li> <li>Make excelparser that converts a filled excel sheet to an ontology #309 (francescalb)</li> <li>Fix ontoconvert rdflib import #307 (CasperWA)</li> <li>Check first versionIRI then versionInfo in ontology.get_version() #301 (francescalb)</li> <li>Removed .readthedocs.yml #298 (jesper-friis)</li> <li>Added support for evaluating Manchester expression to owlready2 #296 (jesper-friis)</li> <li>Added functionality for more than one parent in new_entity #295 (francescalb)</li> <li>Added test for label name length in ontology.new_entity #291 (francescalb)</li> <li>add logo to Readme and doc #289 (m-abdollahi)</li> <li>Improved representation of blank nodes #283 (jesper-friis)</li> <li>Update method name to avoid overwriting inherited #281 (CasperWA)</li> <li>Fixed link to OpenModel logo #279 (francescalb)</li> <li>Skip FOAF test #277 (CasperWA)</li> <li>Added Standard methods to Ontology #246 (francescalb)</li> <li>Implement <code>pre-commit</code> &amp; various tools #245 (CasperWA)</li> </ul>"},{"location":"CHANGELOG/#v013-2021-10-27","title":"v0.1.3 (2021-10-27)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v012-2021-10-27","title":"v0.1.2 (2021-10-27)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v011-2021-10-27","title":"v0.1.1 (2021-10-27)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v010-2021-10-27","title":"v0.1.0 (2021-10-27)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>\"Warning\" Importing from <code>collections</code> #236</li> </ul> <p>Fixed bugs:</p> <ul> <li>Loading ontologies that do not import skos fails #261</li> <li>Fix documentation build warnings #250</li> <li>Fix images in documentation #233</li> <li>Circular reference from Owlready2 #210</li> </ul> <p>Closed issues:</p> <ul> <li>Write up transfer from EMMOpython to EMMOntoPy i README.md #267</li> <li>Add test to emmocheck for upcoming EMMO #257</li> <li>Add packaging as dependency in requirements #255</li> <li>Add CI check for building documentation #244</li> <li>Add OpenModel as contributing project #237</li> <li>Update public documentation to new framework #234</li> <li>Automate documentation releases #232</li> <li>Update name of EMMO to Elemental Multiperspective Material Ontology #230</li> <li>Tidy up unittests #220</li> <li>Remove importability of sub-<code>factpluspluswrapper</code> folders #213</li> <li>Make function that automatically loads emmo #209</li> <li>Require rdflib&gt;5.0.0? #206</li> <li>change package name #205</li> <li>test_catalog fails because seraching for .owl in emmo/master #203</li> <li>Consider using <code>mike</code> for versioned documentation #197</li> <li>Add a test that checks that loading of non-EMMO based ontologies work - e.g. do not require skos:prefLabel #196</li> <li>Setup Materials for MkDocs framework #195</li> <li>Clean up demo, examples and docs #193</li> <li>Formalize review process with checklists #190</li> <li>funksjon ontology.add_class(label, parent)  #183</li> </ul> <p>Merged pull requests:</p> <ul> <li>Reset version to 0.1.0 #271 (CasperWA)</li> <li>Update README with PyPI and deprecation msgs #270 (CasperWA)</li> <li>Added option: EMMObased = False in ontology.load() #262 (francescalb)</li> <li>Added new test \"test_physical_quantity_dimension\" #258 (jesper-friis)</li> <li>Add <code>packaging</code> to list of requirements #256 (CasperWA)</li> <li>Fix MkDocs build warnings and CI job #254 (CasperWA)</li> <li>Update dependencies #252 (CasperWA)</li> <li>Add OpenModel contributing project #247 (francescalb)</li> <li>Automate documentation releases #242 (CasperWA)</li> <li>Import from <code>collections.abc</code> when possible #240 (CasperWA)</li> <li>Ensure all produced files from tests are in a temp dir #239 (CasperWA)</li> <li>Changed EMMO to be acronym for Elemental Multiperspective Material Ontology #238 (francescalb)</li> <li>Use width in img HTML #235 (CasperWA)</li> <li>Added function to load the emmo (the ontology) directly #226 (francescalb)</li> <li>Created pull request template #225 (francescalb)</li> <li>Setup new documentation framework #222 (CasperWA)</li> <li>Remove <code>__init__.py</code> files for FaCT++ wrapper (again) #221 (CasperWA)</li> <li>Unskip test as #210 has been resolved #218 (CasperWA)</li> <li>Remove sub-fact++ modules importability #217 (CasperWA)</li> <li>Update requirements #216 (CasperWA)</li> <li>Avoid using Owlready2 v0.34 #211 (CasperWA)</li> <li>Update package names #208 (CasperWA)</li> <li>Added function new_entitiy to ontology #207 (francescalb)</li> <li>ttl standard for emmo #204 (francescalb)</li> <li>Added choice for specifying namespace in get_by_label #202 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v101b-2021-07-01","title":"v1.0.1b (2021-07-01)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Correct updating of catalog in ontology.load #188</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update version to 1.0.1 #189 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v101-2021-07-01","title":"v1.0.1 (2021-07-01)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Windows paths are not handled properly #147</li> </ul> <p>Closed issues:</p> <ul> <li>Failing tests when lodaing battinfo #185</li> <li>Fix dependatbot to 'wider' #182</li> <li>Change to get_label instead of asstring in ontograph, emmodoc, ontodoc, be careful #158</li> <li>licence does not work with metadata #157</li> <li>ontograph with several roots fails #153</li> <li>fix redudant getlabel, get_preferred_label, get_label #152</li> <li>add --no-catalog and default as in emmocheck for ontograph #150</li> <li>make tests for checking upgrade of Owlready2 #137</li> <li>Add periodic_table to examples #130</li> <li>Add support for simple property-based ontology annotations like dcterms:license #129</li> <li>Update documentation of tools re reasoner #123</li> <li>Ontograph: Include multiple parents/inheritance #86</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed updating of catalog in load #187 (francescalb)</li> <li>Temporarily commented out loading ontologies with error in redirecting link on emmo.info #186 (francescalb)</li> <li>Changed dependabot to widen #181 (francescalb)</li> <li>Changed requirements to greater than #179 (francescalb)</li> <li>Owread2-0.32 not accepted die to error in owlready2 triplelite #178 (francescalb)</li> <li>Fixed import of defaultstyle in ontograph-tool #177 (francescalb)</li> <li>Updated pygments req to at least 2.7.4 because of high seq alert #168 (francescalb)</li> <li>Owlready requirement &gt;0.28 #167 (francescalb)</li> <li>WIP: Ipycytoscape #163 (francescalb)</li> <li>Made it possible to load other ontologies like foaf #162 (jesper-friis)</li> <li>Added get_label instead of asstring #160 (francescalb)</li> <li>Added write_catalog() #159 (jesper-friis)</li> <li>Periodic table example #156 (francescalb)</li> <li>Make one get label #154 (francescalb)</li> <li>Issue150 ontograph cannotload emmo inferred directly #151 (francescalb)</li> <li>Added Fact++ in tools documentation #149 (francescalb)</li> <li>Improved issue reporting in emmocheck #146 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-2021-03-25","title":"v1.0.0 (2021-03-25)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Use rdflib in Ontology.save() to support more file formats #143</li> <li>Tool for publishing domain ontologies #140</li> </ul> <p>Merged pull requests:</p> <ul> <li>Save to turtle and ontology annotations (via the metadata attribute) #144 (jesper-friis)</li> <li>Corrected configuration of exceptions for test_class_label test. #142 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-30-2021-03-18","title":"v1.0.0-alpha-30 (2021-03-18)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Load ontology #141 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-29-2021-03-16","title":"v1.0.0-alpha-29 (2021-03-16)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>Add Wu&amp;Palmer measure #134</li> </ul> <p>Closed issues:</p> <ul> <li>Convert-imported update in utils #138</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed reading xml as 'rdfxml' #139 (francescalb)</li> <li>Added wu_palmer_measure for semantic similarity #135 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-28-2021-03-09","title":"v1.0.0-alpha-28 (2021-03-09)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Also use the catalog file to map web URLs, not only local files. #109</li> <li>Check Error with Owlready2-0.26 #81</li> </ul> <p>Merged pull requests:</p> <ul> <li>Version updated for rel of v0.28 #133 (francescalb)</li> <li>Load ontology #131 (jesper-friis)</li> <li>Optimised label lookup in ontology and dir listing. It is now much faster #127 (jesper-friis)</li> <li>Use catalog by default #126 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-27-2021-02-27","title":"v1.0.0-alpha-27 (2021-02-27)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Ontodoc #125 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-26-2021-02-26","title":"v1.0.0-alpha-26 (2021-02-26)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Make fact++ reasoner available and default in tools #122</li> <li>Use PyPI token in publish workflow #118</li> <li>Update publish workflow #115</li> <li>do something #108</li> </ul> <p>Merged pull requests:</p> <ul> <li>Added functionality to document domain ontologies #124 (jesper-friis)</li> <li>Made ontoconvert and ontograph tools executable in linux #120 (jesper-friis)</li> <li>Update CI  #119 (CasperWA)</li> <li>Update publish workflow + add dependabot #116 (CasperWA)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-25-2021-01-17","title":"v1.0.0-alpha-25 (2021-01-17)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Update Dockerfile to install correct pandoc #99</li> <li>Correct turtle serialisation #97</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update emmocheck exceptions #113 (jesper-friis)</li> <li>Fix recursion in graph #112 (jesper-friis)</li> <li>Avoid unnessesary/infinite recursion in get_imported_ontologies() #111 (jesper-friis)</li> <li>Break recursion error in get_by_label() #110 (jesper-friis)</li> <li>Updated the Ontology.sync_attributes() method. #107 (jesper-friis)</li> <li>Updated pandoc req in Dockerfile #106 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-24-2021-01-04","title":"v1.0.0-alpha-24 (2021-01-04)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Bumped version number up to 1.0.0-alpha-24  #105 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-23-2021-01-04","title":"v1.0.0-alpha-23 (2021-01-04)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Fix loading imported ttl from web such that emmocheck works for crystallography.ttl #98</li> <li>Add reasoning with FaCT++ #95</li> <li>Correctly load ontologies like crystallography that imports both local and online sub-ontologies #91</li> <li>Fix flake8 errors #88</li> <li>Remove the .ttl namespace when loading domain-crystallography in EMMO-python #83</li> <li>Add option of documenting imported ontologies in ontodoc and ontograph #82</li> <li>Emmocheck fails if Physicaluantities and MeaurementsUnits are not imported from emmo. Make sure that it does not fail if whole of EMMO is not imported. #80</li> <li>Ontograph: Make default root #79</li> <li>Ontodoc: PDF is not generated, produces error. #76</li> <li>AttributeError from ontodoc #70</li> <li>Import emmo .ttl from emmo-repo.github.io #69</li> <li>Unable to use the vertical interoperability demo .py files #66</li> </ul> <p>Merged pull requests:</p> <ul> <li>Release 1.0.0-alpha-23 #104 (jesper-friis)</li> <li>Allow to load turtle ontologies without catalog file. #102 (jesper-friis)</li> <li>Updated README file #100 (jesper-friis)</li> <li>Changed the sync_reasoner() method to use FaCT++ as the default reasoner #94 (jesper-friis)</li> <li>Add reasoning #93 (jesper-friis)</li> <li>Improve load ontologies #92 (jesper-friis)</li> <li>Remove the '.ttl' in namespace names by monkey patching owlready2.Namespace #90 (jesper-friis)</li> <li>Fix flake8 warnings #89 (jesper-friis)</li> <li>Ontodoc pdf #87 (jesper-friis)</li> <li>Automatically find roots in ontograph  #85 (francescalb)</li> <li>Automatic import of ttl from GitHub emmo-repo.io #84 (francescalb)</li> <li>Fixes needed for access ontologies #77 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-22-2020-12-21","title":"v1.0.0-alpha-22 (2020-12-21)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Loading ttl both locally and importing from iri #75 (francescalb)</li> <li>Added sync_python_names() and corrected handling of individuals in sync_attributes() #73 (jesper-friis)</li> <li>Add preflabel to individuals declared in python #72 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-21b-2020-12-13","title":"v1.0.0-alpha-21b (2020-12-13)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Fix bug introduced in ontoconvert #71 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-21-2020-12-11","title":"v1.0.0-alpha-21 (2020-12-11)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Use rdflib to load non-supported formats. #68 (jesper-friis)</li> <li>Added a quick fix for vertical demo. #67 (jesper-friis)</li> <li>Updated emmocheck to new 1.0.0-beta. Old version should still work. #65 (jesper-friis)</li> <li>Added ontoconvert tool #64 (jesper-friis)</li> <li>Improved error messages for classes that doesn't define prefLabel #63 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-20b-2020-11-04","title":"v1.0.0-alpha-20b (2020-11-04)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Version1.0.0 alpha20 #62 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-20-2020-11-04","title":"v1.0.0-alpha-20 (2020-11-04)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Improve support for imported ontologies #61 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-19-2020-11-02","title":"v1.0.0-alpha-19 (2020-11-02)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added --ignore-namespace to emmocheck  #60 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-18-2020-10-29","title":"v1.0.0-alpha-18 (2020-10-29)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Bumped up version number to 1.0.0-alpha-18 #59 (jesper-friis)</li> <li>Added option url_from_catalog to ontology.load() #58 (jesper-friis)</li> <li>Added get_preferred_label() method to classes, properties and individuals #57 (jesper-friis)</li> <li>Correct default IRI to inferred ontology #56 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-17-2020-10-21","title":"v1.0.0-alpha-17 (2020-10-21)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added materials.EngineeredMaterial to namespace exception in emmocheck #55 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-16-2020-10-20","title":"v1.0.0-alpha-16 (2020-10-20)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Include all annotations in .get_annotations() #50</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update to v1.0.0-alpha-16 for new release #54 (francescalb)</li> <li>Update dimensionality checks #53 (jesper-friis)</li> <li>Updated to say that pypi realese is automatic in docs #52 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-15-2020-09-25","title":"v1.0.0-alpha-15 (2020-09-25)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added all labels in get_class_annotations in emmo/patch.py including #51 (francescalb)</li> <li>Support use of skos:prefLabel instead of rdfs:label #49 (jesper-friis)</li> <li>v1.0.0-alpha-14  #48 (jesper-friis)</li> <li>Fix emmocheck to not fail upon use of dcterms and skos #47 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-13-2020-09-19","title":"v1.0.0-alpha-13 (2020-09-19)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Not immediately installable with pip #45</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fix setup #46 (jesper-friis)</li> <li>Make emmo package pip installable in fresh env #44 (CasperWA)</li> <li>Update emmodoc to latest version of emmo-alpha2 #43 (jesper-friis)</li> <li>Ensure that emmocheck exit with non-zero return value if a test is faing #42 (jesper-friis)</li> <li>Installed missing dependencies in pythonpublish deployment workflow #41 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-11-2020-08-12","title":"v1.0.0-alpha-11 (2020-08-12)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Add skip option to emmocheck #40 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-10-2020-04-27","title":"v1.0.0-alpha-10 (2020-04-27)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added exceptions to emmocheck \"test_number_of_labels\" #39 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-9-2020-04-13","title":"v1.0.0-alpha-9 (2020-04-13)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Enhance ontology.sync_attributes() to also update class names #10</li> <li>Add support for the FaCT++ reasoner #9</li> </ul> <p>Merged pull requests:</p> <ul> <li>Set new release version 1.0.0-alpha-9 #38 (francescalb)</li> <li>Added get_version() and set_version() methods to emmo.Ontology. #37 (jesper-friis)</li> <li>Updated example in README file to current version of EMMO. #36 (jesper-friis)</li> <li>Update tools #35 (jesper-friis)</li> <li>Updated simplifed demo_vertical in compliance with EMMO-1.0.0alpha2 as of 202\u2026 #34 (francescalb)</li> <li>Fixed PyPI badge in README #33 (jesper-friis)</li> <li>Update emmocheck #32 (jesper-friis)</li> <li>Sync attributes #31 (jesper-friis)</li> <li>Cleanup ci workflow #28 (jesper-friis)</li> <li>Added ontoversion tool #27 (jesper-friis)</li> <li>Update emmodoc #25 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-8-2020-03-22","title":"v1.0.0-alpha-8 (2020-03-22)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>1.0.0 alpha 8 #30 (jesper-friis)</li> <li>Updated requirements such that \"pip install EMMO\" works #24 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-5-2020-03-18","title":"v1.0.0-alpha-5 (2020-03-18)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>Make EMMO-python available on pypi (installable with pip) #7</li> </ul> <p>Merged pull requests:</p> <ul> <li>Bumbed up version to 1.0.0-alpha-5 #23 (jesper-friis)</li> <li>Emmocheck #22 (jesper-friis)</li> <li>Reworked the generation of graphs - using the graphviz Python package #21 (jesper-friis)</li> <li>1.0.0 #19 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-3-2020-02-16","title":"v1.0.0-alpha-3 (2020-02-16)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v100-alpha-2-2020-01-11","title":"v1.0.0-alpha-2 (2020-01-11)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v100-alpha-1-2020-01-11","title":"v1.0.0-alpha-1 (2020-01-11)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Missing https://emmc.info/emmo-inferred #16</li> <li>setup.py #15</li> <li>Fix emmodoc #6</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-2020-01-08","title":"v1.0.0-alpha (2020-01-08)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Update the user case ontology #3</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed a typo in the title #14 (blokhin)</li> <li>Fixed #5 - homogenised call to reasoner #13 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v099-2019-07-14","title":"v0.9.9 (2019-07-14)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Homogenise call to reasoner in emmo.Ontology.sync_reasoner() #5</li> </ul> <p>Merged pull requests:</p> <ul> <li>#3 update usercase ontology #12 (jesper-friis)</li> <li>Fixed 3 #8 (jesper-friis)</li> <li>Dockerdevel #2 (francescalb)</li> <li>Fix by lukas #1 (jesper-friis)</li> </ul> <p>* This Changelog was automatically generated by github_changelog_generator</p>"},{"location":"LICENSE/","title":"LICENSE","text":"<p>Copyright 2019-2022 SINTEF</p> <p>Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:</p> <ol> <li> <p>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</p> </li> <li> <p>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.</p> </li> <li> <p>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.</p> </li> </ol> <p>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.</p>"},{"location":"docker-instructions/","title":"EMMOntoPy Docker","text":""},{"location":"docker-instructions/#clone-project","title":"Clone project","text":"<pre><code>git clone git@github.com:emmo-repo/EMMOntoPy.git\n</code></pre>"},{"location":"docker-instructions/#build-docker-image","title":"Build Docker image","text":"<pre><code>cd EMMOntoPy\ndocker build -t emmo .\n</code></pre>"},{"location":"docker-instructions/#run-docker-container","title":"Run Docker container","text":"<pre><code>docker run -it emmo\n</code></pre>"},{"location":"docker-instructions/#notes","title":"Notes","text":"<ul> <li>Your Docker container may run out of memory while executing the HermiT reasoner (<code>sync_reasoner</code>).   Append <code>--memory=2GB</code> to <code>docker run</code> in order to align the memory limit with the Java runtime environment.</li> </ul> <p>It is recommended to instead use the FaCT++ reaonser (now default).</p> <ul> <li>Uncomment the last line in the Dockerfile, if you wish to start directly in the Python interpreter.</li> </ul>"},{"location":"docker-instructions/#dockerfile-for-mounting-emmontopy-as-volume-mountdockerfile","title":"Dockerfile for mounting EMMOntoPy as volume (mount.Dockerfile)","text":""},{"location":"docker-instructions/#build-docker-image-mountdockerfile","title":"Build Docker image (mount.DockerFile)","text":"<pre><code>docker build -t emmomount -f mount.Dockerfile .\n</code></pre>"},{"location":"docker-instructions/#run-docker-container-mountdockerfile","title":"Run Docker container (mount.Dockerfile)","text":"<p>In a unix terminal (Linux)</p> <pre><code>docker run --rm -it -v $(pwd):/home/user/EMMOntoPy emmomount\n</code></pre> <p>In PowerShell (Windows 10):</p> <pre><code>docker run --rm -it -v ${PWD}:/home/user/EMMOntoPy emmomount\n</code></pre> <p>To install EMMOntoPy package inside container:</p> <pre><code>cd EMMOntoPy\npip install .\n</code></pre>"},{"location":"docker-instructions/#notes-on-mounting-on-windows","title":"Notes on mounting on Windows","text":"<ul> <li> <p>Allow for mounting of C: in Docker (as administrator).   Docker (rightclick in system tray) -&gt; Settings -&gt; Shared Drives -&gt; tick of C -&gt; Apply.</p> </li> <li> <p>Run the following command in PowerShell:</p> </li> </ul> <pre><code>Set-NetConnectionProfile -interfacealias \"vEthernet (DockerNAT)\" -NetworkCategory Private\n</code></pre> <ul> <li>If mounting does not succeed Reset Credentials (Docker -&gt; Settings -&gt; Shared Drives)  and repeat the steps above.</li> </ul>"},{"location":"tools-instructions/","title":"Instructions for tools available in EMMOntoPy","text":"<p>Content:</p> <ul> <li>emmocheck</li> <li>ontoversion</li> <li>ontograph</li> <li>ontodoc</li> <li>ontoconvert</li> <li>excel2onto</li> </ul>"},{"location":"tools-instructions/#emmocheck","title":"<code>emmocheck</code>","text":"<p>Tool for checking that ontologies conform to EMMO conventions.</p>"},{"location":"tools-instructions/#usage","title":"Usage","text":"<pre><code>emmocheck [options] iri\n</code></pre>"},{"location":"tools-instructions/#options","title":"Options","text":"<pre><code>positional arguments:\n  iri                   File name or URI to the ontology to test.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --database FILENAME, -d FILENAME\n                        Load ontology from Owlready2 sqlite3 database. The\n                        `iri` argument should in this case be the IRI of the\n                        ontology you want to check.\n  --local, -l           Load imported ontologies locally. Their paths are\n                        specified in Prot\u00e9g\u00e9 catalog files or via the --path\n                        option. The IRI should be a file name.\n  --catalog-file CATALOG_FILE\n                        Name of Prot\u00e9g\u00e9 catalog file in the same folder as the\n                        ontology. This option is used together with --local\n                        and defaults to \"catalog-v001.xml\".\n  --path PATH           Paths where imported ontologies can be found. May be\n                        provided as a comma-separated string and/or with\n                        multiple --path options.\n  --check-imported, -i  Whether to check imported ontologies.\n  --verbose, -v         Verbosity level.\n  --configfile CONFIGFILE, -c CONFIGFILE\n                        A yaml file with additional test configurations.\n  --skip, -s ShellPattern\n            Shell pattern matching tests to skip.  This option may be\n                        provided multiple times.\n  --url-from-catalog, -u\n      Get url from catalog file.\n  --ignore-namespace, -n\n                        Namespace to be ignored. Can be given multiple times\n</code></pre>"},{"location":"tools-instructions/#examples","title":"Examples","text":"<pre><code>    emmocheck http://emmo.info/emmo/1.0.0-alpha2\n    emmocheck --database demo.sqlite3 http://www.emmc.info/emmc-csa/demo#\n    emmocheck -l emmo.owl (in folder to which emmo was downloaded locally)\n    emmocheck --check-imported --ignore-namespace=physicalistic --verbose --url-from-catalog emmo.owl (in folder with downloaded EMMO)\n    emmocheck --check-imported --local --url-from-catalog --skip test_namespace emmo.owl\n</code></pre>"},{"location":"tools-instructions/#example-configuration-file","title":"Example configuration file","text":"<p>Example of YAML configuration file provided with the <code>--configfile</code> option that will omit <code>myunits.MyUnitCategory1</code> and <code>myunits.MyUnitCategory1</code> from the unit dimensions test.</p> <pre><code>test_unit_dimensions:\n  exceptions:\n    - myunits.MyUnitCategory1\n    - myunits.MyUnitCategory2\n</code></pre>"},{"location":"tools-instructions/#ontoversion","title":"<code>ontoversion</code>","text":"<p>Prints version of an ontology to standard output.</p> <p>This script uses RDFLib and the versionIRI tag of the ontology to infer the version.</p>"},{"location":"tools-instructions/#usage_1","title":"Usage","text":"<pre><code>ontoversion [options] iri\n</code></pre>"},{"location":"tools-instructions/#special-dependencies","title":"Special dependencies","text":"<ul> <li><code>rdflib</code> (Python package)</li> </ul>"},{"location":"tools-instructions/#options_1","title":"Options","text":"<pre><code>positional arguments:\n  IRI                   IRI/file to OWL source to extract the version from.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --format FORMAT, -f FORMAT\n                        OWL format. Default is \"xml\".\n</code></pre>"},{"location":"tools-instructions/#examples_1","title":"Examples","text":"<pre><code>ontoversion http://emmo.info/emmo/1.0.0-alpha\n</code></pre> <p>Warning</p> <p>Fails if ontology has no versionIRI tag.</p>"},{"location":"tools-instructions/#ontograph","title":"<code>ontograph</code>","text":"<p>Tool for visualizing ontologies.</p>"},{"location":"tools-instructions/#usage_2","title":"Usage","text":"<pre><code>ontograph [options] iri [output]\n</code></pre>"},{"location":"tools-instructions/#dependencies","title":"Dependencies","text":"<ul> <li>Graphviz</li> </ul>"},{"location":"tools-instructions/#options_2","title":"Options","text":"<pre><code>positional arguments:\n  IRI                   File name or URI of the ontology to visualise.\n  output                name of output file.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --format FORMAT, -f FORMAT\n                        Format of output file. By default it is inferred from\n                        the output file extension.\n  --database FILENAME, -d FILENAME\n                        Load ontology from Owlready2 sqlite3 database. The\n                        `iri` argument should in this case be the IRI of the\n                        ontology you want to visualise.\n  --local, -l           Load imported ontologies locally. Their paths are\n                        specified in Prot\u00e9g\u00e9 catalog files or via the --path\n                        option. The IRI should be a file name.\n  --catalog-file CATALOG_FILE\n                        Name of Prot\u00e9g\u00e9 catalog file in the same folder as the\n                        ontology. This option is used together with --local\n                        and defaults to \"catalog-v001.xml\".\n  --path PATH           Paths where imported ontologies can be found. May be\n                        provided as a comma-separated string and/or with\n                        multiple --path options.\n  --reasoner [{FaCT++,HermiT,Pellet}]\n                        Run given reasoner on the ontology. Valid reasoners\n                        are \"FaCT++\" (default), \"HermiT\" and \"Pellet\".\n                        Note: FaCT++ is preferred with EMMO.\n  --root ROOT, -r ROOT  Name of root node in the graph. Defaults to all\n                        classes.\n  --leaves LEAVES       Leaf nodes for plotting sub-graphs. May be provided\n                        as a comma-separated string and/or with multiple\n                        --leaves options.\n  --exclude EXCLUDE, -E EXCLUDE\n                        Nodes, including their subclasses, to exclude from\n                        sub-graphs. May be provided as a comma-separated\n                        string and/or with multiple --exclude options.\n  --parents N, -p N     Adds N levels of parents to graph.\n  --relations RELATIONS, -R RELATIONS\n                        Comma-separated string of relations to visualise.\n                        Default is \"isA\". \"all\" means include all relations.\n  --edgelabels, -e      Whether to add labels to edges.\n  --addnodes, -n        Whether to add missing target nodes in relations.\n  --addconstructs, -c   Whether to add nodes representing class constructs.\n  --rankdir {BT,TB,RL,LR}\n                        Graph direction (from leaves to root). Possible values\n                        are: \"BT\" (bottom-top, default), \"TB\" (top-bottom),\n                        \"RL\" (right-left) and \"LR\" (left-right).\n  --style-file JSON_FILE, -s JSON_FILE\n                        A json file with style definitions.\n  --legend, -L          Whether to add a legend to the graph.\n  --generate-style-file JSON_FILE, -S JSON_FILE\n                        Write default style file to a json file.\n  --plot-modules, -m    Whether to plot module inter-dependencies instead of\n                        their content.\n  --display, -D         Whether to display graph.\n</code></pre>"},{"location":"tools-instructions/#examples_2","title":"Examples","text":"<p><pre><code>ontograph --relations=all --legend --format=pdf emmo-inferred emmo.pdf # complete ontology\nontograph --root=Holistic --relations=hasInput,hasOutput,hasTemporaryParticipant,hasAgent --parents=2 --legend --leaves=Measurement,Manufacturing,CompleteManufacturing,ManufacturedProduct,CommercialProduct,Manufacturer --format=png --exclude=Task,Workflow,Computation,MaterialTreatment emmo-inferred measurement.png\nontograph --root=Material --relations=all --legend --format=png emmo-inferred material.png\n</code></pre> The figure below is generated with the last command in the list above. </p>"},{"location":"tools-instructions/#ontodoc","title":"<code>ontodoc</code>","text":"<p>Tool for documenting ontologies.</p>"},{"location":"tools-instructions/#usage_3","title":"Usage","text":"<pre><code>ontodoc [options] iri outfile\n</code></pre>"},{"location":"tools-instructions/#dependencies_1","title":"Dependencies","text":"<ul> <li>pandoc</li> <li>pdflatex or xelatex</li> </ul>"},{"location":"tools-instructions/#options_3","title":"Options","text":"<pre><code>positional arguments:\n  IRI                   File name or URI of the ontology to document.\n  OUTFILE               Output file.\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --database FILENAME, -d FILENAME\n                            Load ontology from Owlready2 sqlite3 database. The\n                            `iri` argument should in this case be the IRI of the\n                            ontology you want to document.\n      --local, -l           Load imported ontologies locally. Their paths are\n                            specified in Prot\u00e9g\u00e9 catalog files or via the --path\n                            option. The IRI should be a file name.\n      --imported, -i        Include imported ontologies\n      --no-catalog, -n      Do not read url from catalog even if it exists.\n      --catalog-file CATALOG_FILE\n                            Name of Prot\u00e9g\u00e9 catalog file in the same folder as the\n                            ontology. This option is used together with --local\n                            and defaults to \"catalog-v001.xml\".\n      --path PATH           Paths where imported ontologies can be found. May be\n                            provided as a comma-separated string and/or with\n                            multiple --path options.\n      --reasoner [{FaCT++,HermiT,Pellet}]\n                            Run given reasoner on the ontology. Valid reasoners\n                            are \"FaCT++\" (default), \"HermiT\" and \"Pellet\".\n                            Note: FaCT++ is preferred with EMMO.\n      --template FILE, -t FILE\n                            ontodoc input template. If not provided, a simple\n                            default template will be used. Don't confuse it with\n                            the pandoc templates.\n      --format FORMAT, -f FORMAT\n                            Output format. May be \"md\", \"simple-html\" or any other\n                            format supported by pandoc. By default the format is\n                            inferred from --output.\n      --figdir DIR, -D DIR  Default directory to store generated figures. If a\n                            relative path is given, it is relative to the template\n                            (see --template), or the current directory, if\n                            --template is not given. Default: \"genfigs\"\n      --figformat FIGFORMAT, -F FIGFORMAT\n                            Format for generated figures. The default is inferred\n                            from --format.\"\n      --max-figwidth MAX_FIGWIDTH, -w MAX_FIGWIDTH\n                            Maximum figure width. The default is inferred from\n                            --format.\n      --pandoc-option STRING, -p STRING\n                            Additional pandoc long options overriding those read\n                            from --pandoc-option-file. It is possible to remove\n                            pandoc option --XXX with \"--pandoc-option=no-XXX\".\n                            This option may be provided multiple times.\n      --pandoc-option-file FILE, -P FILE\n                            YAML file with additional pandoc options. Note, that\n                            default pandoc options are read from the files\n                            \"pandoc-options.yaml\" and \"pandoc-FORMAT-options.yaml\"\n                            (where FORMAT is format specified with --format). This\n                            option allows to override the defaults and add\n                            additional pandoc options. This option may be provided\n                            multiple times.\n      --keep-generated FILE, -k FILE\n                            Keep a copy of generated markdown input file for\n                            pandoc (for debugging).\n</code></pre>"},{"location":"tools-instructions/#examples_3","title":"Examples","text":"<p>Basic documentation of an ontology <code>demo.owl</code> can be generated with:</p> <pre><code>ontodoc --format=simple-html --local demo.owl demo.html\n</code></pre> <p>See examples/emmodoc/README.md for how this tool is used to generate the html and pdf documentation of EMMO itself.</p>"},{"location":"tools-instructions/#ontoconvert","title":"<code>ontoconvert</code>","text":"<p>Tool for converting between different ontology formats.</p>"},{"location":"tools-instructions/#usage_4","title":"Usage","text":"<pre><code>ontoconvert [options] inputfile outputfile\n</code></pre>"},{"location":"tools-instructions/#dependencies_2","title":"Dependencies","text":"<ul> <li><code>rdflib</code> (Python package)</li> </ul>"},{"location":"tools-instructions/#options_4","title":"Options","text":"<pre><code>positional arguments:\n  INPUTFILE              Name of inputfile.\n  OUTPUTFILE             Name og output file.\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --input-format, -f INPUT_FORMAT\n                            Inputformat. Default is to infer from input.\n      --output-format, -F OUTPUT_FORMAT\n                            Default is to infer from output.\n      --no-catalog, -n      Do not read catalog even if it exists.\n      --inferred, -i        Add additional relations inferred by the FaCT++ reasoner to the converted ontology. Implies --squash.\n      --base-iri BASE_IRI, -b BASE_IRI\n                            Base iri of inferred ontology. The default is the base\n                            iri of the input ontology with \"-inferred\" appended to\n                            it. Used together with --inferred.\n\n      --recursive, -r       The output is written to the directories matching the input. This requires Protege catalog files to be present.\n      --squash, -s          Squash imported ontologies into a single output file.\n</code></pre>"},{"location":"tools-instructions/#examples_4","title":"Examples","text":"<pre><code>ontoconvert --recursive emmo.ttl owl/emmo.owl\nontoconvert --inferred emmo.ttl emmo-inferred.owl\n</code></pre> <p>Note, it is then required to add the argument <code>only_local=True</code> when loading the locally converted ontology in EMMOntoPy, e.g.:</p> <pre><code>from ontopy import get_ontology\n\nemmo_ontology = get_ontology(\"emmo.owl\").load(only_local=True)\n</code></pre> <p>Since the catalog file will be overwritten in the above example writing output to a separate directory is useful.</p> <pre><code>ontoconvert --recursive emmo.ttl owl/emmo.owl\n</code></pre>"},{"location":"tools-instructions/#bugs","title":"Bugs","text":"<p>Since parsing the results from the reasoner is currently broken in Owlready2 (v0.37), a workaround has been added to ontoconvert. This workaround only only supports FaCT++.  Hence, HermiT and Pellet are currently not available.</p>"},{"location":"tools-instructions/#excel2onto","title":"<code>excel2onto</code>","text":"<p>Tool for converting EMMO-based ontologies from Excel to OWL, making it easy for non-ontologists to make EMMO-based domain ontologies.</p> <p>The Excel file must be in the format provided by ontology_template.xlsx.</p>"},{"location":"tools-instructions/#usage_5","title":"Usage","text":"<pre><code>excel2onto [options] excelpath\n</code></pre>"},{"location":"tools-instructions/#dependencies_3","title":"Dependencies","text":"<ul> <li><code>pandas</code> (Python package)</li> </ul>"},{"location":"tools-instructions/#options_5","title":"Options","text":"<pre><code>positional arguments:\n  excelpath             path to excel book\n\noptions:\n  -h, --help            show this help message and exit\n  --output OUTPUT, -o OUTPUT\n                        Name of output ontology, \u00b4ontology.ttl\u00b4 is default\n  --force, -f           Whether to force generation of ontology on non-fatal\n                        error.\n</code></pre> <p>See the documentation of the python api for a thorough description of the requirements on the Excel workbook.</p>"},{"location":"tools-instructions/#examples_5","title":"Examples","text":"<p>Create a <code>new_ontology.ttl</code> turtle file from the Excel file <code>new_ontology.xlsx</code>: <pre><code>excel2onto -o new_ontology.ttl new_ontology.xlsx\n</code></pre></p>"},{"location":"tools-instructions/#bugs_1","title":"Bugs","text":"<p><code>equivalentTo</code> is currently not supported.</p>"},{"location":"api_reference/emmopy/emmocheck/","title":"emmocheck","text":"<p>A module for testing an ontology against conventions defined for EMMO.</p> <p>A YAML file can be provided with additional test configurations.</p> <p>Example configuration file:</p> <pre><code>test_unit_dimensions:\n  exceptions:\n    - myunits.MyUnitCategory1\n    - myunits.MyUnitCategory2\n\nskip:\n  - name_of_test_to_skip\n\nenable:\n  - name_of_test_to_enable\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestEMMOConventions","title":"<code> TestEMMOConventions        </code>","text":"<p>Base class for testing an ontology against EMMO conventions.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>class TestEMMOConventions(unittest.TestCase):\n    \"\"\"Base class for testing an ontology against EMMO conventions.\"\"\"\n\n    config = {}  # configurations\n\n    def get_config(self, string, default=None):\n        \"\"\"Returns the configuration specified by `string`.\n\n        If configuration is not found in the configuration file, `default` is\n        returned.\n\n        Sub-configurations can be accessed by separating the components with\n        dots, like \"test_namespace.exceptions\".\n        \"\"\"\n        result = self.config\n        try:\n            for token in string.split(\".\"):\n                result = result[token]\n        except KeyError:\n            return default\n        return result\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestEMMOConventions.get_config","title":"<code>get_config(self, string, default=None)</code>","text":"<p>Returns the configuration specified by <code>string</code>.</p> <p>If configuration is not found in the configuration file, <code>default</code> is returned.</p> <p>Sub-configurations can be accessed by separating the components with dots, like \"test_namespace.exceptions\".</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def get_config(self, string, default=None):\n    \"\"\"Returns the configuration specified by `string`.\n\n    If configuration is not found in the configuration file, `default` is\n    returned.\n\n    Sub-configurations can be accessed by separating the components with\n    dots, like \"test_namespace.exceptions\".\n    \"\"\"\n    result = self.config\n    try:\n        for token in string.split(\".\"):\n            result = result[token]\n    except KeyError:\n        return default\n    return result\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions","title":"<code> TestFunctionalEMMOConventions        </code>","text":"<p>Test functional EMMO conventions.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>class TestFunctionalEMMOConventions(TestEMMOConventions):\n    \"\"\"Test functional EMMO conventions.\"\"\"\n\n    def test_unit_dimension(self):\n        \"\"\"Check that all measurement units have a physical dimension.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n        \"\"\"\n        exceptions = set(\n            (\n                \"metrology.MultipleUnit\",\n                \"metrology.SubMultipleUnit\",\n                \"metrology.OffSystemUnit\",\n                \"metrology.PrefixedUnit\",\n                \"metrology.NonPrefixedUnit\",\n                \"metrology.SpecialUnit\",\n                \"metrology.DerivedUnit\",\n                \"metrology.BaseUnit\",\n                \"metrology.UnitSymbol\",\n                \"siunits.SICoherentDerivedUnit\",\n                \"siunits.SINonCoherentDerivedUnit\",\n                \"siunits.SISpecialUnit\",\n                \"siunits.SICoherentUnit\",\n                \"siunits.SIPrefixedUnit\",\n                \"siunits.SIBaseUnit\",\n                \"siunits.SIUnitSymbol\",\n                \"siunits.SIUnit\",\n                \"emmo.MultipleUnit\",\n                \"emmo.SubMultipleUnit\",\n                \"emmo.OffSystemUnit\",\n                \"emmo.PrefixedUnit\",\n                \"emmo.NonPrefixedUnit\",\n                \"emmo.SpecialUnit\",\n                \"emmo.DerivedUnit\",\n                \"emmo.BaseUnit\",\n                \"emmo.UnitSymbol\",\n                \"emmo.SIAccepted\",\n                \"emmo.SICoherentDerivedUnit\",\n                \"emmo.SINonCoherentDerivedUnit\",\n                \"emmo.SISpecialUnit\",\n                \"emmo.SICoherentUnit\",\n                \"emmo.SIPrefixedUnit\",\n                \"emmo.SIBaseUnit\",\n                \"emmo.SIUnitSymbol\",\n                \"emmo.SIUnit\",\n            )\n        )\n        if not hasattr(self.onto, \"MeasurementUnit\"):\n            return\n        exceptions.update(self.get_config(\"test_unit_dimension.exceptions\", ()))\n        regex = re.compile(r\"^(emmo|metrology).hasDimensionString.value\\(.*\\)$\")\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.MeasurementUnit.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            # Assume that actual units are not subclassed\n            if not list(cls.subclasses()) and repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    self.assertTrue(\n                        any(\n                            regex.match(repr(r))\n                            for r in cls.get_indirect_is_a()\n                        ),\n                        msg=cls,\n                    )\n\n    def test_quantity_dimension_beta3(self):\n        \"\"\"Check that all quantities have a physicalDimension annotation.\n\n        Note: this test will be deprecated when isq is moved to emmo/domain.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n        \"\"\"\n        exceptions = set(\n            (\n                \"properties.ModelledQuantitativeProperty\",\n                \"properties.MeasuredQuantitativeProperty\",\n                \"properties.ConventionalQuantitativeProperty\",\n                \"metrology.QuantitativeProperty\",\n                \"metrology.Quantity\",\n                \"metrology.OrdinalQuantity\",\n                \"metrology.BaseQuantity\",\n                \"metrology.PhysicalConstant\",\n                \"metrology.PhysicalQuantity\",\n                \"metrology.ExactConstant\",\n                \"metrology.MeasuredConstant\",\n                \"metrology.DerivedQuantity\",\n                \"isq.ISQBaseQuantity\",\n                \"isq.InternationalSystemOfQuantity\",\n                \"isq.ISQDerivedQuantity\",\n                \"isq.SIExactConstant\",\n                \"emmo.ModelledQuantitativeProperty\",\n                \"emmo.MeasuredQuantitativeProperty\",\n                \"emmo.ConventionalQuantitativeProperty\",\n                \"emmo.QuantitativeProperty\",\n                \"emmo.Quantity\",\n                \"emmo.OrdinalQuantity\",\n                \"emmo.BaseQuantity\",\n                \"emmo.PhysicalConstant\",\n                \"emmo.PhysicalQuantity\",\n                \"emmo.ExactConstant\",\n                \"emmo.MeasuredConstant\",\n                \"emmo.DerivedQuantity\",\n                \"emmo.ISQBaseQuantity\",\n                \"emmo.InternationalSystemOfQuantity\",\n                \"emmo.ISQDerivedQuantity\",\n                \"emmo.SIExactConstant\",\n                \"emmo.NonSIUnits\",\n                \"emmo.StandardizedPhysicalQuantity\",\n                \"emmo.CategorizedPhysicalQuantity\",\n                \"emmo.AtomicAndNuclear\",\n                \"emmo.Defined\",\n                \"emmo.Electromagnetic\",\n                \"emmo.FrequentlyUsed\",\n                \"emmo.PhysicoChemical\",\n                \"emmo.ChemicalCompositionQuantity\",\n                \"emmo.Universal\",\n            )\n        )\n        if not hasattr(self.onto, \"PhysicalQuantity\"):\n            return\n        exceptions.update(\n            self.get_config(\"test_quantity_dimension.exceptions\", ())\n        )\n        regex = re.compile(\n            \"^T([+-][1-9]|0) L([+-][1-9]|0) M([+-][1-9]|0) I([+-][1-9]|0) \"\n            \"(H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) J([+-][1-9]|0)$\"\n        )\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.PhysicalQuantity.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            if repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    anno = cls.get_annotations()\n                    self.assertIn(\"physicalDimension\", anno, msg=cls)\n                    physdim = anno[\"physicalDimension\"].first()\n                    self.assertRegex(physdim, regex, msg=cls)\n\n    def test_quantity_dimension(self):\n        \"\"\"Check that all quantities have a physicalDimension.\n\n        Note: this test will be deprecated when isq is moved to emmo/domain.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n        \"\"\"\n        # pylint: disable=invalid-name\n        exceptions = set(\n            (\n                \"properties.ModelledQuantitativeProperty\",\n                \"properties.MeasuredQuantitativeProperty\",\n                \"properties.ConventionalQuantitativeProperty\",\n                \"metrology.QuantitativeProperty\",\n                \"metrology.Quantity\",\n                \"metrology.OrdinalQuantity\",\n                \"metrology.BaseQuantity\",\n                \"metrology.PhysicalConstant\",\n                \"metrology.PhysicalQuantity\",\n                \"metrology.ExactConstant\",\n                \"metrology.MeasuredConstant\",\n                \"metrology.DerivedQuantity\",\n                \"isq.ISQBaseQuantity\",\n                \"isq.InternationalSystemOfQuantity\",\n                \"isq.ISQDerivedQuantity\",\n                \"isq.SIExactConstant\",\n                \"emmo.ModelledQuantitativeProperty\",\n                \"emmo.MeasuredQuantitativeProperty\",\n                \"emmo.ConventionalQuantitativeProperty\",\n                \"emmo.QuantitativeProperty\",\n                \"emmo.Quantity\",\n                \"emmo.OrdinalQuantity\",\n                \"emmo.BaseQuantity\",\n                \"emmo.PhysicalConstant\",\n                \"emmo.PhysicalQuantity\",\n                \"emmo.ExactConstant\",\n                \"emmo.MeasuredConstant\",\n                \"emmo.DerivedQuantity\",\n                \"emmo.ISQBaseQuantity\",\n                \"emmo.InternationalSystemOfQuantity\",\n                \"emmo.ISQDerivedQuantity\",\n                \"emmo.SIExactConstant\",\n                \"emmo.NonSIUnits\",\n                \"emmo.StandardizedPhysicalQuantity\",\n                \"emmo.CategorizedPhysicalQuantity\",\n                \"emmo.ISO80000Categorised\",\n                \"emmo.AtomicAndNuclear\",\n                \"emmo.Defined\",\n                \"emmo.Electromagnetic\",\n                \"emmo.FrequentlyUsed\",\n                \"emmo.ChemicalCompositionQuantity\",\n                \"emmo.EquilibriumConstant\",  # physical dimension may change\n                \"emmo.Solubility\",\n                \"emmo.Universal\",\n                \"emmo.Intensive\",\n                \"emmo.Extensive\",\n                \"emmo.Concentration\",\n            )\n        )\n        if not hasattr(self.onto, \"PhysicalQuantity\"):\n            return\n        exceptions.update(\n            self.get_config(\"test_quantity_dimension.exceptions\", ())\n        )\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.PhysicalQuantity.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            if issubclass(cls, self.onto.ISO80000Categorised):\n                continue\n            if repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    for r in cls.get_indirect_is_a():\n                        if isinstance(r, owlready2.Restriction) and repr(\n                            r\n                        ).startswith(\"emmo.hasMeasurementUnit.some\"):\n                            self.assertTrue(\n                                issubclass(\n                                    r.value,\n                                    (\n                                        self.onto.DimensionalUnit,\n                                        self.onto.DimensionlessUnit,\n                                    ),\n                                )\n                            )\n                            break\n                    else:\n                        self.assertTrue(\n                            issubclass(cls, self.onto.ISQDimensionlessQuantity)\n                        )\n\n    def test_dimensional_unit(self):\n        \"\"\"Check correct syntax of dimension string of dimensional units.\"\"\"\n\n        # This test requires that the ontology has imported SIDimensionalUnit\n        if \"SIDimensionalUnit\" not in self.onto:\n            self.skipTest(\"SIDimensionalUnit is not imported\")\n\n        # pylint: disable=invalid-name\n        regex = re.compile(\n            \"^T([+-][1-9][0-9]*|0) L([+-][1-9]|0) M([+-][1-9]|0) \"\n            \"I([+-][1-9]|0) (H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) \"\n            \"J([+-][1-9]|0)$\"\n        )\n        for cls in self.onto.SIDimensionalUnit.__subclasses__():\n            with self.subTest(cls=cls, label=get_label(cls)):\n                self.assertEqual(len(cls.equivalent_to), 1)\n                r = cls.equivalent_to[0]\n                self.assertIsInstance(r, owlready2.Restriction)\n                self.assertRegex(r.value, regex)\n\n    def test_physical_quantity_dimension(self):\n        \"\"\"Check that all physical quantities have `hasPhysicalDimension`.\n\n        Note: this test will fail before isq is moved to emmo/domain.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n\n        \"\"\"\n        exceptions = set(\n            (\n                \"emmo.ModelledQuantitativeProperty\",\n                \"emmo.MeasuredQuantitativeProperty\",\n                \"emmo.ConventionalQuantitativeProperty\",\n                \"emmo.QuantitativeProperty\",\n                \"emmo.BaseQuantity\",\n                \"emmo.PhysicalConstant\",\n                \"emmo.PhysicalQuantity\",\n                \"emmo.ExactConstant\",\n                \"emmo.MeasuredConstant\",\n                \"emmo.DerivedQuantity\",\n                \"emmo.ISQBaseQuantity\",\n                \"emmo.InternationalSystemOfQuantity\",\n                \"emmo.ISQDerivedQuantity\",\n                \"emmo.SIExactConstant\",\n                \"emmo.NonSIUnits\",\n                \"emmo.StandardizedPhysicalQuantity\",\n                \"emmo.CategorizedPhysicalQuantity\",\n                \"emmo.AtomicAndNuclearPhysicsQuantity\",\n                \"emmo.ThermodynamicalQuantity\",\n                \"emmo.LightAndRadiationQuantity\",\n                \"emmo.SpaceAndTimeQuantity\",\n                \"emmo.AcousticQuantity\",\n                \"emmo.PhysioChememicalQuantity\",\n                \"emmo.ElectromagneticQuantity\",\n                \"emmo.MechanicalQuantity\",\n                \"emmo.CondensedMatterPhysicsQuantity\",\n                \"emmo.ChemicalCompositionQuantity\",\n                \"emmo.Extensive\",\n                \"emmo.Intensive\",\n            )\n        )\n        if not hasattr(self.onto, \"PhysicalQuantity\"):\n            return\n        exceptions.update(\n            self.get_config(\"test_physical_quantity_dimension.exceptions\", ())\n        )\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.PhysicalQuantity.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            if repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    try:\n                        class_props = cls.INDIRECT_get_class_properties()\n                    except AttributeError:\n                        # The INDIRECT_get_class_properties() method\n                        # does not support inverse properties.  Build\n                        # class_props manually...\n                        class_props = set()\n                        for _ in cls.mro():\n                            if hasattr(_, \"is_a\"):\n                                class_props.update(\n                                    [\n                                        restriction.property\n                                        for restriction in _.is_a\n                                        if isinstance(\n                                            restriction, owlready2.Restriction\n                                        )\n                                    ]\n                                )\n\n                    self.assertIn(\n                        self.onto.hasPhysicalDimension, class_props, msg=cls\n                    )\n\n    def test_namespace(self):\n        \"\"\"Check that all IRIs are namespaced after their (sub)ontology.\n\n        Configurations:\n            exceptions - full name of entities to ignore.\n        \"\"\"\n        exceptions = set(\n            (\n                \"owl.qualifiedCardinality\",\n                \"owl.minQualifiedCardinality\",\n                \"terms.creator\",\n                \"terms.contributor\",\n                \"terms.publisher\",\n                \"terms.title\",\n                \"terms.license\",\n                \"terms.abstract\",\n                \"core.prefLabel\",\n                \"core.altLabel\",\n                \"core.hiddenLabel\",\n                \"mereotopology.Item\",\n                \"manufacturing.EngineeredMaterial\",\n            )\n        )\n        exceptions.update(self.get_config(\"test_namespace.exceptions\", ()))\n\n        def checker(onto, ignore_namespace):\n            if list(\n                filter(onto.base_iri.strip(\"#\").endswith, self.ignore_namespace)\n            ):\n                print(f\"Skipping namespace: {onto.base_iri}\")\n                return\n            entities = itertools.chain(\n                onto.classes(),\n                onto.object_properties(),\n                onto.data_properties(),\n                onto.individuals(),\n                onto.annotation_properties(),\n            )\n            for entity in entities:\n                if entity not in visited and repr(entity) not in exceptions:\n                    visited.add(entity)\n                    with self.subTest(\n                        iri=entity.iri,\n                        base_iri=onto.base_iri,\n                        entity=repr(entity),\n                    ):\n                        self.assertTrue(\n                            entity.iri.endswith(entity.name),\n                            msg=(\n                                \"the final part of entity IRIs must be their \"\n                                \"name\"\n                            ),\n                        )\n                        self.assertEqual(\n                            entity.iri,\n                            onto.base_iri + entity.name,\n                            msg=(\n                                f\"IRI {entity.iri!r} does not correspond to \"\n                                f\"module namespace: {onto.base_iri!r}\"\n                            ),\n                        )\n\n            if self.check_imported:\n                for imp_onto in onto.imported_ontologies:\n                    if imp_onto not in visited_onto:\n                        visited_onto.add(imp_onto)\n                        checker(imp_onto, ignore_namespace)\n\n        visited = set()\n        visited_onto = set()\n        checker(self.onto, self.ignore_namespace)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_dimensional_unit","title":"<code>test_dimensional_unit(self)</code>","text":"<p>Check correct syntax of dimension string of dimensional units.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_dimensional_unit(self):\n    \"\"\"Check correct syntax of dimension string of dimensional units.\"\"\"\n\n    # This test requires that the ontology has imported SIDimensionalUnit\n    if \"SIDimensionalUnit\" not in self.onto:\n        self.skipTest(\"SIDimensionalUnit is not imported\")\n\n    # pylint: disable=invalid-name\n    regex = re.compile(\n        \"^T([+-][1-9][0-9]*|0) L([+-][1-9]|0) M([+-][1-9]|0) \"\n        \"I([+-][1-9]|0) (H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) \"\n        \"J([+-][1-9]|0)$\"\n    )\n    for cls in self.onto.SIDimensionalUnit.__subclasses__():\n        with self.subTest(cls=cls, label=get_label(cls)):\n            self.assertEqual(len(cls.equivalent_to), 1)\n            r = cls.equivalent_to[0]\n            self.assertIsInstance(r, owlready2.Restriction)\n            self.assertRegex(r.value, regex)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_namespace","title":"<code>test_namespace(self)</code>","text":"<p>Check that all IRIs are namespaced after their (sub)ontology.</p> <p>Configurations</p> <p>exceptions - full name of entities to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_namespace(self):\n    \"\"\"Check that all IRIs are namespaced after their (sub)ontology.\n\n    Configurations:\n        exceptions - full name of entities to ignore.\n    \"\"\"\n    exceptions = set(\n        (\n            \"owl.qualifiedCardinality\",\n            \"owl.minQualifiedCardinality\",\n            \"terms.creator\",\n            \"terms.contributor\",\n            \"terms.publisher\",\n            \"terms.title\",\n            \"terms.license\",\n            \"terms.abstract\",\n            \"core.prefLabel\",\n            \"core.altLabel\",\n            \"core.hiddenLabel\",\n            \"mereotopology.Item\",\n            \"manufacturing.EngineeredMaterial\",\n        )\n    )\n    exceptions.update(self.get_config(\"test_namespace.exceptions\", ()))\n\n    def checker(onto, ignore_namespace):\n        if list(\n            filter(onto.base_iri.strip(\"#\").endswith, self.ignore_namespace)\n        ):\n            print(f\"Skipping namespace: {onto.base_iri}\")\n            return\n        entities = itertools.chain(\n            onto.classes(),\n            onto.object_properties(),\n            onto.data_properties(),\n            onto.individuals(),\n            onto.annotation_properties(),\n        )\n        for entity in entities:\n            if entity not in visited and repr(entity) not in exceptions:\n                visited.add(entity)\n                with self.subTest(\n                    iri=entity.iri,\n                    base_iri=onto.base_iri,\n                    entity=repr(entity),\n                ):\n                    self.assertTrue(\n                        entity.iri.endswith(entity.name),\n                        msg=(\n                            \"the final part of entity IRIs must be their \"\n                            \"name\"\n                        ),\n                    )\n                    self.assertEqual(\n                        entity.iri,\n                        onto.base_iri + entity.name,\n                        msg=(\n                            f\"IRI {entity.iri!r} does not correspond to \"\n                            f\"module namespace: {onto.base_iri!r}\"\n                        ),\n                    )\n\n        if self.check_imported:\n            for imp_onto in onto.imported_ontologies:\n                if imp_onto not in visited_onto:\n                    visited_onto.add(imp_onto)\n                    checker(imp_onto, ignore_namespace)\n\n    visited = set()\n    visited_onto = set()\n    checker(self.onto, self.ignore_namespace)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_physical_quantity_dimension","title":"<code>test_physical_quantity_dimension(self)</code>","text":"<p>Check that all physical quantities have <code>hasPhysicalDimension</code>.</p> <p>Note: this test will fail before isq is moved to emmo/domain.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_physical_quantity_dimension(self):\n    \"\"\"Check that all physical quantities have `hasPhysicalDimension`.\n\n    Note: this test will fail before isq is moved to emmo/domain.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n\n    \"\"\"\n    exceptions = set(\n        (\n            \"emmo.ModelledQuantitativeProperty\",\n            \"emmo.MeasuredQuantitativeProperty\",\n            \"emmo.ConventionalQuantitativeProperty\",\n            \"emmo.QuantitativeProperty\",\n            \"emmo.BaseQuantity\",\n            \"emmo.PhysicalConstant\",\n            \"emmo.PhysicalQuantity\",\n            \"emmo.ExactConstant\",\n            \"emmo.MeasuredConstant\",\n            \"emmo.DerivedQuantity\",\n            \"emmo.ISQBaseQuantity\",\n            \"emmo.InternationalSystemOfQuantity\",\n            \"emmo.ISQDerivedQuantity\",\n            \"emmo.SIExactConstant\",\n            \"emmo.NonSIUnits\",\n            \"emmo.StandardizedPhysicalQuantity\",\n            \"emmo.CategorizedPhysicalQuantity\",\n            \"emmo.AtomicAndNuclearPhysicsQuantity\",\n            \"emmo.ThermodynamicalQuantity\",\n            \"emmo.LightAndRadiationQuantity\",\n            \"emmo.SpaceAndTimeQuantity\",\n            \"emmo.AcousticQuantity\",\n            \"emmo.PhysioChememicalQuantity\",\n            \"emmo.ElectromagneticQuantity\",\n            \"emmo.MechanicalQuantity\",\n            \"emmo.CondensedMatterPhysicsQuantity\",\n            \"emmo.ChemicalCompositionQuantity\",\n            \"emmo.Extensive\",\n            \"emmo.Intensive\",\n        )\n    )\n    if not hasattr(self.onto, \"PhysicalQuantity\"):\n        return\n    exceptions.update(\n        self.get_config(\"test_physical_quantity_dimension.exceptions\", ())\n    )\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.PhysicalQuantity.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        if repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                try:\n                    class_props = cls.INDIRECT_get_class_properties()\n                except AttributeError:\n                    # The INDIRECT_get_class_properties() method\n                    # does not support inverse properties.  Build\n                    # class_props manually...\n                    class_props = set()\n                    for _ in cls.mro():\n                        if hasattr(_, \"is_a\"):\n                            class_props.update(\n                                [\n                                    restriction.property\n                                    for restriction in _.is_a\n                                    if isinstance(\n                                        restriction, owlready2.Restriction\n                                    )\n                                ]\n                            )\n\n                self.assertIn(\n                    self.onto.hasPhysicalDimension, class_props, msg=cls\n                )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_quantity_dimension","title":"<code>test_quantity_dimension(self)</code>","text":"<p>Check that all quantities have a physicalDimension.</p> <p>Note: this test will be deprecated when isq is moved to emmo/domain.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_quantity_dimension(self):\n    \"\"\"Check that all quantities have a physicalDimension.\n\n    Note: this test will be deprecated when isq is moved to emmo/domain.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n    \"\"\"\n    # pylint: disable=invalid-name\n    exceptions = set(\n        (\n            \"properties.ModelledQuantitativeProperty\",\n            \"properties.MeasuredQuantitativeProperty\",\n            \"properties.ConventionalQuantitativeProperty\",\n            \"metrology.QuantitativeProperty\",\n            \"metrology.Quantity\",\n            \"metrology.OrdinalQuantity\",\n            \"metrology.BaseQuantity\",\n            \"metrology.PhysicalConstant\",\n            \"metrology.PhysicalQuantity\",\n            \"metrology.ExactConstant\",\n            \"metrology.MeasuredConstant\",\n            \"metrology.DerivedQuantity\",\n            \"isq.ISQBaseQuantity\",\n            \"isq.InternationalSystemOfQuantity\",\n            \"isq.ISQDerivedQuantity\",\n            \"isq.SIExactConstant\",\n            \"emmo.ModelledQuantitativeProperty\",\n            \"emmo.MeasuredQuantitativeProperty\",\n            \"emmo.ConventionalQuantitativeProperty\",\n            \"emmo.QuantitativeProperty\",\n            \"emmo.Quantity\",\n            \"emmo.OrdinalQuantity\",\n            \"emmo.BaseQuantity\",\n            \"emmo.PhysicalConstant\",\n            \"emmo.PhysicalQuantity\",\n            \"emmo.ExactConstant\",\n            \"emmo.MeasuredConstant\",\n            \"emmo.DerivedQuantity\",\n            \"emmo.ISQBaseQuantity\",\n            \"emmo.InternationalSystemOfQuantity\",\n            \"emmo.ISQDerivedQuantity\",\n            \"emmo.SIExactConstant\",\n            \"emmo.NonSIUnits\",\n            \"emmo.StandardizedPhysicalQuantity\",\n            \"emmo.CategorizedPhysicalQuantity\",\n            \"emmo.ISO80000Categorised\",\n            \"emmo.AtomicAndNuclear\",\n            \"emmo.Defined\",\n            \"emmo.Electromagnetic\",\n            \"emmo.FrequentlyUsed\",\n            \"emmo.ChemicalCompositionQuantity\",\n            \"emmo.EquilibriumConstant\",  # physical dimension may change\n            \"emmo.Solubility\",\n            \"emmo.Universal\",\n            \"emmo.Intensive\",\n            \"emmo.Extensive\",\n            \"emmo.Concentration\",\n        )\n    )\n    if not hasattr(self.onto, \"PhysicalQuantity\"):\n        return\n    exceptions.update(\n        self.get_config(\"test_quantity_dimension.exceptions\", ())\n    )\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.PhysicalQuantity.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        if issubclass(cls, self.onto.ISO80000Categorised):\n            continue\n        if repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                for r in cls.get_indirect_is_a():\n                    if isinstance(r, owlready2.Restriction) and repr(\n                        r\n                    ).startswith(\"emmo.hasMeasurementUnit.some\"):\n                        self.assertTrue(\n                            issubclass(\n                                r.value,\n                                (\n                                    self.onto.DimensionalUnit,\n                                    self.onto.DimensionlessUnit,\n                                ),\n                            )\n                        )\n                        break\n                else:\n                    self.assertTrue(\n                        issubclass(cls, self.onto.ISQDimensionlessQuantity)\n                    )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_quantity_dimension_beta3","title":"<code>test_quantity_dimension_beta3(self)</code>","text":"<p>Check that all quantities have a physicalDimension annotation.</p> <p>Note: this test will be deprecated when isq is moved to emmo/domain.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_quantity_dimension_beta3(self):\n    \"\"\"Check that all quantities have a physicalDimension annotation.\n\n    Note: this test will be deprecated when isq is moved to emmo/domain.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n    \"\"\"\n    exceptions = set(\n        (\n            \"properties.ModelledQuantitativeProperty\",\n            \"properties.MeasuredQuantitativeProperty\",\n            \"properties.ConventionalQuantitativeProperty\",\n            \"metrology.QuantitativeProperty\",\n            \"metrology.Quantity\",\n            \"metrology.OrdinalQuantity\",\n            \"metrology.BaseQuantity\",\n            \"metrology.PhysicalConstant\",\n            \"metrology.PhysicalQuantity\",\n            \"metrology.ExactConstant\",\n            \"metrology.MeasuredConstant\",\n            \"metrology.DerivedQuantity\",\n            \"isq.ISQBaseQuantity\",\n            \"isq.InternationalSystemOfQuantity\",\n            \"isq.ISQDerivedQuantity\",\n            \"isq.SIExactConstant\",\n            \"emmo.ModelledQuantitativeProperty\",\n            \"emmo.MeasuredQuantitativeProperty\",\n            \"emmo.ConventionalQuantitativeProperty\",\n            \"emmo.QuantitativeProperty\",\n            \"emmo.Quantity\",\n            \"emmo.OrdinalQuantity\",\n            \"emmo.BaseQuantity\",\n            \"emmo.PhysicalConstant\",\n            \"emmo.PhysicalQuantity\",\n            \"emmo.ExactConstant\",\n            \"emmo.MeasuredConstant\",\n            \"emmo.DerivedQuantity\",\n            \"emmo.ISQBaseQuantity\",\n            \"emmo.InternationalSystemOfQuantity\",\n            \"emmo.ISQDerivedQuantity\",\n            \"emmo.SIExactConstant\",\n            \"emmo.NonSIUnits\",\n            \"emmo.StandardizedPhysicalQuantity\",\n            \"emmo.CategorizedPhysicalQuantity\",\n            \"emmo.AtomicAndNuclear\",\n            \"emmo.Defined\",\n            \"emmo.Electromagnetic\",\n            \"emmo.FrequentlyUsed\",\n            \"emmo.PhysicoChemical\",\n            \"emmo.ChemicalCompositionQuantity\",\n            \"emmo.Universal\",\n        )\n    )\n    if not hasattr(self.onto, \"PhysicalQuantity\"):\n        return\n    exceptions.update(\n        self.get_config(\"test_quantity_dimension.exceptions\", ())\n    )\n    regex = re.compile(\n        \"^T([+-][1-9]|0) L([+-][1-9]|0) M([+-][1-9]|0) I([+-][1-9]|0) \"\n        \"(H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) J([+-][1-9]|0)$\"\n    )\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.PhysicalQuantity.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        if repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                anno = cls.get_annotations()\n                self.assertIn(\"physicalDimension\", anno, msg=cls)\n                physdim = anno[\"physicalDimension\"].first()\n                self.assertRegex(physdim, regex, msg=cls)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_unit_dimension","title":"<code>test_unit_dimension(self)</code>","text":"<p>Check that all measurement units have a physical dimension.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_unit_dimension(self):\n    \"\"\"Check that all measurement units have a physical dimension.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n    \"\"\"\n    exceptions = set(\n        (\n            \"metrology.MultipleUnit\",\n            \"metrology.SubMultipleUnit\",\n            \"metrology.OffSystemUnit\",\n            \"metrology.PrefixedUnit\",\n            \"metrology.NonPrefixedUnit\",\n            \"metrology.SpecialUnit\",\n            \"metrology.DerivedUnit\",\n            \"metrology.BaseUnit\",\n            \"metrology.UnitSymbol\",\n            \"siunits.SICoherentDerivedUnit\",\n            \"siunits.SINonCoherentDerivedUnit\",\n            \"siunits.SISpecialUnit\",\n            \"siunits.SICoherentUnit\",\n            \"siunits.SIPrefixedUnit\",\n            \"siunits.SIBaseUnit\",\n            \"siunits.SIUnitSymbol\",\n            \"siunits.SIUnit\",\n            \"emmo.MultipleUnit\",\n            \"emmo.SubMultipleUnit\",\n            \"emmo.OffSystemUnit\",\n            \"emmo.PrefixedUnit\",\n            \"emmo.NonPrefixedUnit\",\n            \"emmo.SpecialUnit\",\n            \"emmo.DerivedUnit\",\n            \"emmo.BaseUnit\",\n            \"emmo.UnitSymbol\",\n            \"emmo.SIAccepted\",\n            \"emmo.SICoherentDerivedUnit\",\n            \"emmo.SINonCoherentDerivedUnit\",\n            \"emmo.SISpecialUnit\",\n            \"emmo.SICoherentUnit\",\n            \"emmo.SIPrefixedUnit\",\n            \"emmo.SIBaseUnit\",\n            \"emmo.SIUnitSymbol\",\n            \"emmo.SIUnit\",\n        )\n    )\n    if not hasattr(self.onto, \"MeasurementUnit\"):\n        return\n    exceptions.update(self.get_config(\"test_unit_dimension.exceptions\", ()))\n    regex = re.compile(r\"^(emmo|metrology).hasDimensionString.value\\(.*\\)$\")\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.MeasurementUnit.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        # Assume that actual units are not subclassed\n        if not list(cls.subclasses()) and repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                self.assertTrue(\n                    any(\n                        regex.match(repr(r))\n                        for r in cls.get_indirect_is_a()\n                    ),\n                    msg=cls,\n                )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions","title":"<code> TestSyntacticEMMOConventions        </code>","text":"<p>Test syntactic EMMO conventions.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>class TestSyntacticEMMOConventions(TestEMMOConventions):\n    \"\"\"Test syntactic EMMO conventions.\"\"\"\n\n    def test_number_of_labels(self):\n        \"\"\"Check that all entities have one and only one prefLabel.\n\n        Use \"altLabel\" for synonyms.\n\n        The only allowed exception is entities who's representation\n        starts with \"owl.\".\n        \"\"\"\n        exceptions = set(\n            (\n                \"0.1.homepage\",  # foaf:homepage\n                \"0.1.logo\",\n                \"0.1.page\",\n                \"0.1.name\",\n                \"bibo:doi\",\n                \"core.altLabel\",\n                \"core.hiddenLabel\",\n                \"core.prefLabel\",\n                \"terms.abstract\",\n                \"terms.alternative\",\n                \"terms:bibliographicCitation\",\n                \"terms.contributor\",\n                \"terms.created\",\n                \"terms.creator\",\n                \"terms.hasFormat\",\n                \"terms.identifier\",\n                \"terms.issued\",\n                \"terms.license\",\n                \"terms.modified\",\n                \"terms.publisher\",\n                \"terms.source\",\n                \"terms.title\",\n                \"vann:preferredNamespacePrefix\",\n                \"vann:preferredNamespaceUri\",\n            )\n        )\n        exceptions.update(\n            self.get_config(\"test_number_of_labels.exceptions\", ())\n        )\n        if (\n            \"prefLabel\"\n            in self.onto.world._props  # pylint: disable=protected-access\n        ):\n            for entity in self.onto.classes(self.check_imported):\n                if repr(entity) not in exceptions:\n                    with self.subTest(\n                        entity=entity,\n                        label=get_label(entity),\n                        prefLabels=entity.prefLabel,\n                    ):\n                        if not repr(entity).startswith(\"owl.\"):\n                            self.assertTrue(hasattr(entity, \"prefLabel\"))\n                            self.assertEqual(1, len(entity.prefLabel))\n        else:\n            self.fail(\"ontology has no prefLabel\")\n\n    def test_class_label(self):\n        \"\"\"Check that class labels are CamelCase and valid identifiers.\n\n        For CamelCase, we are currently only checking that the labels\n        start with upper case.\n        \"\"\"\n        exceptions = set(\n            (\n                \"0-manifold\",  # not needed in 1.0.0-beta\n                \"1-manifold\",\n                \"2-manifold\",\n                \"3-manifold\",\n                \"C++\",\n                \"3DPrinting\",\n            )\n        )\n        exceptions.update(self.get_config(\"test_class_label.exceptions\", ()))\n\n        for cls in self.onto.classes(self.check_imported):\n            for label in cls.label + getattr(cls, \"prefLabel\", []):\n                if str(label) not in exceptions:\n                    with self.subTest(entity=cls, label=label):\n                        self.assertTrue(label.isidentifier())\n                        self.assertTrue(label[0].isupper())\n\n    def test_object_property_label(self):\n        \"\"\"Check that object property labels are lowerCamelCase.\n\n        Allowed exceptions: \"EMMORelation\"\n\n        If they start with \"has\" or \"is\" they should be followed by a\n        upper case letter.\n\n        If they start with \"is\" they should also end with \"Of\".\n        \"\"\"\n        exceptions = set((\"EMMORelation\",))\n        exceptions.update(\n            self.get_config(\"test_object_property_label.exceptions\", ())\n        )\n\n        for obj_prop in self.onto.object_properties():\n            if repr(obj_prop) not in exceptions:\n                for label in obj_prop.label:\n                    with self.subTest(entity=obj_prop, label=label):\n                        self.assertTrue(\n                            label[0].islower(), \"label start with lowercase\"\n                        )\n                        if label.startswith(\"has\"):\n                            self.assertTrue(\n                                label[3].isupper(),\n                                'what follows \"has\" must be \"uppercase\"',\n                            )\n                        if label.startswith(\"is\"):\n                            self.assertTrue(\n                                label[2].isupper(),\n                                'what follows \"is\" must be \"uppercase\"',\n                            )\n                            self.assertTrue(\n                                label.endswith((\"Of\", \"With\")),\n                                'should end with \"Of\" or \"With\"',\n                            )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions.test_class_label","title":"<code>test_class_label(self)</code>","text":"<p>Check that class labels are CamelCase and valid identifiers.</p> <p>For CamelCase, we are currently only checking that the labels start with upper case.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_class_label(self):\n    \"\"\"Check that class labels are CamelCase and valid identifiers.\n\n    For CamelCase, we are currently only checking that the labels\n    start with upper case.\n    \"\"\"\n    exceptions = set(\n        (\n            \"0-manifold\",  # not needed in 1.0.0-beta\n            \"1-manifold\",\n            \"2-manifold\",\n            \"3-manifold\",\n            \"C++\",\n            \"3DPrinting\",\n        )\n    )\n    exceptions.update(self.get_config(\"test_class_label.exceptions\", ()))\n\n    for cls in self.onto.classes(self.check_imported):\n        for label in cls.label + getattr(cls, \"prefLabel\", []):\n            if str(label) not in exceptions:\n                with self.subTest(entity=cls, label=label):\n                    self.assertTrue(label.isidentifier())\n                    self.assertTrue(label[0].isupper())\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions.test_number_of_labels","title":"<code>test_number_of_labels(self)</code>","text":"<p>Check that all entities have one and only one prefLabel.</p> <p>Use \"altLabel\" for synonyms.</p> <p>The only allowed exception is entities who's representation starts with \"owl.\".</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_number_of_labels(self):\n    \"\"\"Check that all entities have one and only one prefLabel.\n\n    Use \"altLabel\" for synonyms.\n\n    The only allowed exception is entities who's representation\n    starts with \"owl.\".\n    \"\"\"\n    exceptions = set(\n        (\n            \"0.1.homepage\",  # foaf:homepage\n            \"0.1.logo\",\n            \"0.1.page\",\n            \"0.1.name\",\n            \"bibo:doi\",\n            \"core.altLabel\",\n            \"core.hiddenLabel\",\n            \"core.prefLabel\",\n            \"terms.abstract\",\n            \"terms.alternative\",\n            \"terms:bibliographicCitation\",\n            \"terms.contributor\",\n            \"terms.created\",\n            \"terms.creator\",\n            \"terms.hasFormat\",\n            \"terms.identifier\",\n            \"terms.issued\",\n            \"terms.license\",\n            \"terms.modified\",\n            \"terms.publisher\",\n            \"terms.source\",\n            \"terms.title\",\n            \"vann:preferredNamespacePrefix\",\n            \"vann:preferredNamespaceUri\",\n        )\n    )\n    exceptions.update(\n        self.get_config(\"test_number_of_labels.exceptions\", ())\n    )\n    if (\n        \"prefLabel\"\n        in self.onto.world._props  # pylint: disable=protected-access\n    ):\n        for entity in self.onto.classes(self.check_imported):\n            if repr(entity) not in exceptions:\n                with self.subTest(\n                    entity=entity,\n                    label=get_label(entity),\n                    prefLabels=entity.prefLabel,\n                ):\n                    if not repr(entity).startswith(\"owl.\"):\n                        self.assertTrue(hasattr(entity, \"prefLabel\"))\n                        self.assertEqual(1, len(entity.prefLabel))\n    else:\n        self.fail(\"ontology has no prefLabel\")\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions.test_object_property_label","title":"<code>test_object_property_label(self)</code>","text":"<p>Check that object property labels are lowerCamelCase.</p> <p>Allowed exceptions: \"EMMORelation\"</p> <p>If they start with \"has\" or \"is\" they should be followed by a upper case letter.</p> <p>If they start with \"is\" they should also end with \"Of\".</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_object_property_label(self):\n    \"\"\"Check that object property labels are lowerCamelCase.\n\n    Allowed exceptions: \"EMMORelation\"\n\n    If they start with \"has\" or \"is\" they should be followed by a\n    upper case letter.\n\n    If they start with \"is\" they should also end with \"Of\".\n    \"\"\"\n    exceptions = set((\"EMMORelation\",))\n    exceptions.update(\n        self.get_config(\"test_object_property_label.exceptions\", ())\n    )\n\n    for obj_prop in self.onto.object_properties():\n        if repr(obj_prop) not in exceptions:\n            for label in obj_prop.label:\n                with self.subTest(entity=obj_prop, label=label):\n                    self.assertTrue(\n                        label[0].islower(), \"label start with lowercase\"\n                    )\n                    if label.startswith(\"has\"):\n                        self.assertTrue(\n                            label[3].isupper(),\n                            'what follows \"has\" must be \"uppercase\"',\n                        )\n                    if label.startswith(\"is\"):\n                        self.assertTrue(\n                            label[2].isupper(),\n                            'what follows \"is\" must be \"uppercase\"',\n                        )\n                        self.assertTrue(\n                            label.endswith((\"Of\", \"With\")),\n                            'should end with \"Of\" or \"With\"',\n                        )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.main","title":"<code>main(argv=None)</code>","text":"<p>Run all checks on ontology <code>iri</code>.</p> <p>Default is 'http://emmo.info/emmo'.</p> <p>Parameters:</p> Name Type Description Default <code>argv</code> <code>list</code> <p>List of arguments, similar to <code>sys.argv[1:]</code>. Mainly for testing purposes, since it allows one to invoke the tool manually / through Python.</p> <code>None</code> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def main(\n    argv: list = None,\n):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    \"\"\"Run all checks on ontology `iri`.\n\n    Default is 'http://emmo.info/emmo'.\n\n    Parameters:\n        argv: List of arguments, similar to `sys.argv[1:]`.\n            Mainly for testing purposes, since it allows one to invoke the tool\n            manually / through Python.\n\n    \"\"\"\n    parser = argparse.ArgumentParser(description=__doc__)\n    parser.add_argument(\"iri\", help=\"File name or URI to the ontology to test.\")\n    parser.add_argument(\n        \"--database\",\n        \"-d\",\n        metavar=\"FILENAME\",\n        default=\":memory:\",\n        help=(\n            \"Load ontology from Owlready2 sqlite3 database. The `iri` argument\"\n            \" should in this case be the IRI of the ontology you want to \"\n            \"check.\"\n        ),\n    )\n    parser.add_argument(\n        \"--local\",\n        \"-l\",\n        action=\"store_true\",\n        help=(\n            \"Load imported ontologies locally.  Their paths are specified in \"\n            \"Prot\u00e8g\u00e8 catalog files or via the --path option.  The IRI should \"\n            \"be a file name.\"\n        ),\n    )\n    parser.add_argument(\n        \"--catalog-file\",\n        default=\"catalog-v001.xml\",\n        help=(\n            \"Name of Prot\u00e8g\u00e8 catalog file in the same folder as the ontology. \"\n            \"This option is used together with --local and defaults to \"\n            '\"catalog-v001.xml\".'\n        ),\n    )\n    parser.add_argument(\n        \"--path\",\n        action=\"append\",\n        default=[],\n        help=(\n            \"Paths where imported ontologies can be found. May be provided as \"\n            \"a comma-separated string and/or with multiple --path options.\"\n        ),\n    )\n    parser.add_argument(\n        \"--check-imported\",\n        \"-i\",\n        action=\"store_true\",\n        help=\"Whether to check imported ontologies.\",\n    )\n    parser.add_argument(\n        \"--verbose\", \"-v\", action=\"store_true\", help=\"Verbosity level.\"\n    )\n    parser.add_argument(\n        \"--configfile\",\n        \"-c\",\n        help=\"A yaml file with additional test configurations.\",\n    )\n    parser.add_argument(\n        \"--skip\",\n        \"-s\",\n        action=\"append\",\n        default=[],\n        help=(\n            \"Shell pattern matching tests to skip.  This option may be \"\n            \"provided multiple times.\"\n        ),\n    )\n    parser.add_argument(\n        \"--enable\",\n        \"-e\",\n        action=\"append\",\n        default=[],\n        help=(\n            \"Shell pattern matching tests to enable that have been skipped by \"\n            \"default or in the config file.  This option may be provided \"\n            \"multiple times.\"\n        ),\n    )\n    parser.add_argument(  # deprecated, replaced by --no-catalog\n        \"--url-from-catalog\",\n        \"-u\",\n        default=None,\n        action=\"store_true\",\n        help=\"Get url from catalog file\",\n    )\n    parser.add_argument(\n        \"--no-catalog\",\n        action=\"store_false\",\n        dest=\"url_from_catalog\",\n        default=None,\n        help=\"Whether to not read catalog file even if it exists.\",\n    )\n    parser.add_argument(\n        \"--ignore-namespace\",\n        \"-n\",\n        action=\"append\",\n        default=[],\n        help=\"Namespace to be ignored. Can be given multiple times\",\n    )\n\n    # Options to pass forward to unittest\n    parser.add_argument(\n        \"--buffer\",\n        \"-b\",\n        dest=\"unittest\",\n        action=\"append_const\",\n        const=\"-b\",\n        help=(\n            \"The standard output and standard error streams are buffered \"\n            \"during the test run. Output during a passing test is discarded. \"\n            \"Output is echoed normally on test fail or error and is added to \"\n            \"the failure messages.\"\n        ),\n    )\n    parser.add_argument(\n        \"--catch\",\n        dest=\"unittest\",\n        action=\"append_const\",\n        const=\"-c\",\n        help=(\n            \"Control-C during the test run waits for the current test to end \"\n            \"and then reports all the results so far. A second control-C \"\n            \"raises the normal KeyboardInterrupt exception\"\n        ),\n    )\n    parser.add_argument(\n        \"--failfast\",\n        \"-f\",\n        dest=\"unittest\",\n        action=\"append_const\",\n        const=\"-f\",\n        help=\"Stop the test run on the first error or failure.\",\n    )\n    try:\n        args = parser.parse_args(args=argv)\n        sys.argv[1:] = args.unittest if args.unittest else []\n        if args.verbose:\n            sys.argv.append(\"-v\")\n    except SystemExit as exc:\n        sys.exit(exc.code)  # Exit without traceback on invalid arguments\n\n    # Append to onto_path\n    for paths in args.path:\n        for path in paths.split(\",\"):\n            if path not in onto_path:\n                onto_path.append(path)\n\n    # Load ontology\n    world = World(filename=args.database)\n    if args.database != \":memory:\" and args.iri not in world.ontologies:\n        parser.error(\n            \"The IRI argument should be one of the ontologies in \"\n            \"the database:\\n  \" + \"\\n  \".join(world.ontologies.keys())\n        )\n\n    onto = world.get_ontology(args.iri)\n    onto.load(\n        only_local=args.local,\n        url_from_catalog=args.url_from_catalog,\n        catalog_file=args.catalog_file,\n    )\n\n    # Store settings TestEMMOConventions\n    TestEMMOConventions.onto = onto\n    TestEMMOConventions.check_imported = args.check_imported\n    TestEMMOConventions.ignore_namespace = args.ignore_namespace\n\n    # Configure tests\n    verbosity = 2 if args.verbose else 1\n    if args.configfile:\n        import yaml  # pylint: disable=import-outside-toplevel\n\n        with open(args.configfile, \"rt\") as handle:\n            TestEMMOConventions.config.update(\n                yaml.load(handle, Loader=yaml.SafeLoader)\n            )\n\n    # Run all subclasses of TestEMMOConventions as test suites\n    status = 0\n    for cls in TestEMMOConventions.__subclasses__():\n        # pylint: disable=cell-var-from-loop,undefined-loop-variable\n\n        suite = unittest.TestLoader().loadTestsFromTestCase(cls)\n\n        # Mark tests to be skipped\n        for test in suite:\n            name = test.id().split(\".\")[-1]\n            skipped = set(  # skipped by default\n                [\n                    \"test_namespace\",\n                    \"test_physical_quantity_dimension_annotation\",\n                    \"test_quantity_dimension_beta3\",\n                    \"test_physical_quantity_dimension\",\n                ]\n            )\n            msg = {name: \"skipped by default\" for name in skipped}\n\n            # enable/skip tests from config file\n            for pattern in test.get_config(\"enable\", ()):\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.remove(name)\n            for pattern in test.get_config(\"skip\", ()):\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.add(name)\n                    msg[name] = \"skipped from config file\"\n\n            # enable/skip from command line\n            for pattern in args.enable:\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.remove(name)\n            for pattern in args.skip:\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.add(name)\n                    msg[name] = \"skipped from command line\"\n\n            if name in skipped:\n                setattr(test, \"setUp\", lambda: test.skipTest(msg.get(name, \"\")))\n\n        runner = TextTestRunner(verbosity=verbosity)\n        runner.resultclass.checkmode = True\n        result = runner.run(suite)\n        if result.failures:\n            status = 1\n\n    return status\n</code></pre>"},{"location":"api_reference/emmopy/emmopy/","title":"emmopy","text":""},{"location":"api_reference/emmopy/emmopy/#emmopy.emmopy--emmopyemmopy","title":"<code>emmopy.emmopy</code>","text":"<p>Automagically retrieve the EMMO utilizing <code>ontopy.get_ontology</code>.</p>"},{"location":"api_reference/emmopy/emmopy/#emmopy.emmopy.get_emmo","title":"<code>get_emmo(inferred=True)</code>","text":"<p>Returns the current version of emmo.</p> <p>Parameters:</p> Name Type Description Default <code>inferred</code> <code>Optional[bool]</code> <p>Whether to import the inferred version of emmo or not. Default is True.</p> <code>True</code> <p>Returns:</p> Type Description <code>Ontology</code> <p>The loaded emmo ontology.</p> Source code in <code>emmopy/emmopy.py</code> <pre><code>def get_emmo(inferred: Optional[bool] = True) -&gt; \"Ontology\":\n    \"\"\"Returns the current version of emmo.\n\n    Args:\n        inferred: Whether to import the inferred version of emmo or not.\n            Default is True.\n\n    Returns:\n        The loaded emmo ontology.\n\n    \"\"\"\n    name = \"emmo-inferred\" if inferred in [True, None] else \"emmo\"\n    return get_ontology(name).load(prefix_emmo=True)\n</code></pre>"},{"location":"api_reference/ontopy/colortest/","title":"colortest","text":""},{"location":"api_reference/ontopy/colortest/#ontopy.colortest--ontopycolortest","title":"<code>ontopy.colortest</code>","text":"<p>Print tests in colors.</p> <p>Adapted from https://github.com/meshy/colour-runner by Charlie Denton License: MIT</p>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult","title":"<code> ColourTextTestResult            (TestResult)         </code>","text":"<p>A test result class that prints colour formatted text results to a stream.</p> <p>Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py</p> Source code in <code>ontopy/colortest.py</code> <pre><code>class ColourTextTestResult(TestResult):\n    \"\"\"\n    A test result class that prints colour formatted text results to a stream.\n\n    Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py\n    \"\"\"\n\n    formatter = formatters.Terminal256Formatter()  # pylint: disable=no-member\n    lexer = Lexer()\n    separator1 = \"=\" * 70\n    separator2 = \"-\" * 70\n    indent = \" \" * 4\n    # if `checkmode` is true, simplified output will be generated with\n    # no traceback\n    checkmode = False\n    _terminal = Terminal()\n    colours = {\n        None: str,\n        \"error\": _terminal.bold_red,\n        \"expected\": _terminal.blue,\n        # \"fail\": _terminal.bold_yellow,\n        \"fail\": _terminal.bold_magenta,\n        \"skip\": str,\n        \"success\": _terminal.green,\n        \"title\": _terminal.blue,\n        \"unexpected\": _terminal.bold_red,\n    }\n\n    _test_class = None\n\n    def __init__(self, stream, descriptions, verbosity):\n        super().__init__(stream, descriptions, verbosity)\n        self.stream = stream\n        self.show_all = verbosity &gt; 1\n        self.dots = verbosity == 1\n        self.descriptions = descriptions\n\n    def getShortDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return self.indent + doc_first_line\n        return self.indent + test._testMethodName\n\n    def getLongDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return \"\\n\".join((str(test), doc_first_line))\n        return str(test)\n\n    def getClassDescription(self, test):\n        test_class = test.__class__\n        doc = test_class.__doc__\n        if self.descriptions and doc:\n            return doc.split(\"\\n\")[0].strip()\n        return strclass(test_class)\n\n    def startTest(self, test):\n        super().startTest(test)\n        pos = 0\n        if self.show_all:\n            if self._test_class != test.__class__:\n                self._test_class = test.__class__\n                title = self.getClassDescription(test)\n                self.stream.writeln(self.colours[\"title\"](title))\n            descr = self.getShortDescription(test)\n            self.stream.write(descr)\n            pos += len(descr)\n            self.stream.write(\" \" * (70 - pos))\n            # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n            # self.stream.write(' ... ')\n            self.stream.flush()\n\n    def printResult(self, short, extended, colour_key=None):\n        colour = self.colours[colour_key]\n        if self.show_all:\n            self.stream.writeln(colour(extended))\n        elif self.dots:\n            self.stream.write(colour(short))\n            self.stream.flush()\n\n    def addSuccess(self, test):\n        super().addSuccess(test)\n        self.printResult(\".\", \"ok\", \"success\")\n\n    def addError(self, test, err):\n        super().addError(test, err)\n        self.printResult(\"E\", \"ERROR\", \"error\")\n\n    def addFailure(self, test, err):\n        super().addFailure(test, err)\n        self.printResult(\"F\", \"FAIL\", \"fail\")\n\n    def addSkip(self, test, reason):\n        super().addSkip(test, reason)\n        if self.checkmode:\n            self.printResult(\"s\", \"skipped\", \"skip\")\n        else:\n            self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n\n    def addExpectedFailure(self, test, err):\n        super().addExpectedFailure(test, err)\n        self.printResult(\"x\", \"expected failure\", \"expected\")\n\n    def addUnexpectedSuccess(self, test):\n        super().addUnexpectedSuccess(test)\n        self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n\n    def printErrors(self):\n        if self.dots or self.show_all:\n            self.stream.writeln()\n        self.printErrorList(\"ERROR\", self.errors)\n        self.printErrorList(\"FAIL\", self.failures)\n\n    def printErrorList(self, flavour, errors):\n        colour = self.colours[flavour.lower()]\n\n        for test, err in errors:\n            if self.checkmode and flavour == \"FAIL\":\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {test.shortDescription()}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(str(test))\n                if self.show_all:\n                    self.stream.writeln(self.separator2)\n                    lines = str(err).split(\"\\n\")\n                    i = 1\n                    for line in lines[1:]:\n                        if line.startswith(\" \"):\n                            i += 1\n                        else:\n                            break\n                    self.stream.writeln(\n                        highlight(\n                            \"\\n\".join(lines[i:]), self.lexer, self.formatter\n                        )\n                    )\n            else:\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {self.getLongDescription(test)}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(self.separator2)\n                self.stream.writeln(highlight(err, self.lexer, self.formatter))\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addError","title":"<code>addError(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addError(self, test, err):\n    super().addError(test, err)\n    self.printResult(\"E\", \"ERROR\", \"error\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addExpectedFailure","title":"<code>addExpectedFailure(self, test, err)</code>","text":"<p>Called when an expected failure/error occurred.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addExpectedFailure(self, test, err):\n    super().addExpectedFailure(test, err)\n    self.printResult(\"x\", \"expected failure\", \"expected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addFailure","title":"<code>addFailure(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addFailure(self, test, err):\n    super().addFailure(test, err)\n    self.printResult(\"F\", \"FAIL\", \"fail\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addSkip","title":"<code>addSkip(self, test, reason)</code>","text":"<p>Called when a test is skipped.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSkip(self, test, reason):\n    super().addSkip(test, reason)\n    if self.checkmode:\n        self.printResult(\"s\", \"skipped\", \"skip\")\n    else:\n        self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addSuccess","title":"<code>addSuccess(self, test)</code>","text":"<p>Called when a test has completed successfully</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSuccess(self, test):\n    super().addSuccess(test)\n    self.printResult(\".\", \"ok\", \"success\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addUnexpectedSuccess","title":"<code>addUnexpectedSuccess(self, test)</code>","text":"<p>Called when a test was expected to fail, but succeed.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addUnexpectedSuccess(self, test):\n    super().addUnexpectedSuccess(test)\n    self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.printErrors","title":"<code>printErrors(self)</code>","text":"<p>Called by TestRunner after test run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def printErrors(self):\n    if self.dots or self.show_all:\n        self.stream.writeln()\n    self.printErrorList(\"ERROR\", self.errors)\n    self.printErrorList(\"FAIL\", self.failures)\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.startTest","title":"<code>startTest(self, test)</code>","text":"<p>Called when the given test is about to be run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def startTest(self, test):\n    super().startTest(test)\n    pos = 0\n    if self.show_all:\n        if self._test_class != test.__class__:\n            self._test_class = test.__class__\n            title = self.getClassDescription(test)\n            self.stream.writeln(self.colours[\"title\"](title))\n        descr = self.getShortDescription(test)\n        self.stream.write(descr)\n        pos += len(descr)\n        self.stream.write(\" \" * (70 - pos))\n        # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n        # self.stream.write(' ... ')\n        self.stream.flush()\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner","title":"<code> ColourTextTestRunner            (TextTestRunner)         </code>","text":"<p>A test runner that uses colour in its output.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>class ColourTextTestRunner(\n    TextTestRunner\n):  # pylint: disable=too-few-public-methods\n    \"\"\"A test runner that uses colour in its output.\"\"\"\n\n    resultclass = ColourTextTestResult\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass","title":"<code> resultclass            (TestResult)         </code>","text":"<p>A test result class that prints colour formatted text results to a stream.</p> <p>Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py</p> Source code in <code>ontopy/colortest.py</code> <pre><code>class ColourTextTestResult(TestResult):\n    \"\"\"\n    A test result class that prints colour formatted text results to a stream.\n\n    Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py\n    \"\"\"\n\n    formatter = formatters.Terminal256Formatter()  # pylint: disable=no-member\n    lexer = Lexer()\n    separator1 = \"=\" * 70\n    separator2 = \"-\" * 70\n    indent = \" \" * 4\n    # if `checkmode` is true, simplified output will be generated with\n    # no traceback\n    checkmode = False\n    _terminal = Terminal()\n    colours = {\n        None: str,\n        \"error\": _terminal.bold_red,\n        \"expected\": _terminal.blue,\n        # \"fail\": _terminal.bold_yellow,\n        \"fail\": _terminal.bold_magenta,\n        \"skip\": str,\n        \"success\": _terminal.green,\n        \"title\": _terminal.blue,\n        \"unexpected\": _terminal.bold_red,\n    }\n\n    _test_class = None\n\n    def __init__(self, stream, descriptions, verbosity):\n        super().__init__(stream, descriptions, verbosity)\n        self.stream = stream\n        self.show_all = verbosity &gt; 1\n        self.dots = verbosity == 1\n        self.descriptions = descriptions\n\n    def getShortDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return self.indent + doc_first_line\n        return self.indent + test._testMethodName\n\n    def getLongDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return \"\\n\".join((str(test), doc_first_line))\n        return str(test)\n\n    def getClassDescription(self, test):\n        test_class = test.__class__\n        doc = test_class.__doc__\n        if self.descriptions and doc:\n            return doc.split(\"\\n\")[0].strip()\n        return strclass(test_class)\n\n    def startTest(self, test):\n        super().startTest(test)\n        pos = 0\n        if self.show_all:\n            if self._test_class != test.__class__:\n                self._test_class = test.__class__\n                title = self.getClassDescription(test)\n                self.stream.writeln(self.colours[\"title\"](title))\n            descr = self.getShortDescription(test)\n            self.stream.write(descr)\n            pos += len(descr)\n            self.stream.write(\" \" * (70 - pos))\n            # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n            # self.stream.write(' ... ')\n            self.stream.flush()\n\n    def printResult(self, short, extended, colour_key=None):\n        colour = self.colours[colour_key]\n        if self.show_all:\n            self.stream.writeln(colour(extended))\n        elif self.dots:\n            self.stream.write(colour(short))\n            self.stream.flush()\n\n    def addSuccess(self, test):\n        super().addSuccess(test)\n        self.printResult(\".\", \"ok\", \"success\")\n\n    def addError(self, test, err):\n        super().addError(test, err)\n        self.printResult(\"E\", \"ERROR\", \"error\")\n\n    def addFailure(self, test, err):\n        super().addFailure(test, err)\n        self.printResult(\"F\", \"FAIL\", \"fail\")\n\n    def addSkip(self, test, reason):\n        super().addSkip(test, reason)\n        if self.checkmode:\n            self.printResult(\"s\", \"skipped\", \"skip\")\n        else:\n            self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n\n    def addExpectedFailure(self, test, err):\n        super().addExpectedFailure(test, err)\n        self.printResult(\"x\", \"expected failure\", \"expected\")\n\n    def addUnexpectedSuccess(self, test):\n        super().addUnexpectedSuccess(test)\n        self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n\n    def printErrors(self):\n        if self.dots or self.show_all:\n            self.stream.writeln()\n        self.printErrorList(\"ERROR\", self.errors)\n        self.printErrorList(\"FAIL\", self.failures)\n\n    def printErrorList(self, flavour, errors):\n        colour = self.colours[flavour.lower()]\n\n        for test, err in errors:\n            if self.checkmode and flavour == \"FAIL\":\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {test.shortDescription()}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(str(test))\n                if self.show_all:\n                    self.stream.writeln(self.separator2)\n                    lines = str(err).split(\"\\n\")\n                    i = 1\n                    for line in lines[1:]:\n                        if line.startswith(\" \"):\n                            i += 1\n                        else:\n                            break\n                    self.stream.writeln(\n                        highlight(\n                            \"\\n\".join(lines[i:]), self.lexer, self.formatter\n                        )\n                    )\n            else:\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {self.getLongDescription(test)}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(self.separator2)\n                self.stream.writeln(highlight(err, self.lexer, self.formatter))\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addError","title":"<code>addError(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addError(self, test, err):\n    super().addError(test, err)\n    self.printResult(\"E\", \"ERROR\", \"error\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addExpectedFailure","title":"<code>addExpectedFailure(self, test, err)</code>","text":"<p>Called when an expected failure/error occurred.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addExpectedFailure(self, test, err):\n    super().addExpectedFailure(test, err)\n    self.printResult(\"x\", \"expected failure\", \"expected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addFailure","title":"<code>addFailure(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addFailure(self, test, err):\n    super().addFailure(test, err)\n    self.printResult(\"F\", \"FAIL\", \"fail\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addSkip","title":"<code>addSkip(self, test, reason)</code>","text":"<p>Called when a test is skipped.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSkip(self, test, reason):\n    super().addSkip(test, reason)\n    if self.checkmode:\n        self.printResult(\"s\", \"skipped\", \"skip\")\n    else:\n        self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addSuccess","title":"<code>addSuccess(self, test)</code>","text":"<p>Called when a test has completed successfully</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSuccess(self, test):\n    super().addSuccess(test)\n    self.printResult(\".\", \"ok\", \"success\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addUnexpectedSuccess","title":"<code>addUnexpectedSuccess(self, test)</code>","text":"<p>Called when a test was expected to fail, but succeed.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addUnexpectedSuccess(self, test):\n    super().addUnexpectedSuccess(test)\n    self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.printErrors","title":"<code>printErrors(self)</code>","text":"<p>Called by TestRunner after test run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def printErrors(self):\n    if self.dots or self.show_all:\n        self.stream.writeln()\n    self.printErrorList(\"ERROR\", self.errors)\n    self.printErrorList(\"FAIL\", self.failures)\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.startTest","title":"<code>startTest(self, test)</code>","text":"<p>Called when the given test is about to be run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def startTest(self, test):\n    super().startTest(test)\n    pos = 0\n    if self.show_all:\n        if self._test_class != test.__class__:\n            self._test_class = test.__class__\n            title = self.getClassDescription(test)\n            self.stream.writeln(self.colours[\"title\"](title))\n        descr = self.getShortDescription(test)\n        self.stream.write(descr)\n        pos += len(descr)\n        self.stream.write(\" \" * (70 - pos))\n        # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n        # self.stream.write(' ... ')\n        self.stream.flush()\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/","title":"excelparser","text":"<p>Module from parsing an excelfile and creating an ontology from it.</p> <p>The excelfile is read by pandas and the pandas dataframe should have column names: prefLabel, altLabel, Elucidation, Comments, Examples, subClassOf, Relations.</p> <p>Note that correct case is mandatory.</p>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.ExcelError","title":"<code> ExcelError            (EMMOntoPyException)         </code>","text":"<p>Raised on errors in Excel file.</p> Source code in <code>ontopy/excelparser.py</code> <pre><code>class ExcelError(EMMOntoPyException):\n    \"\"\"Raised on errors in Excel file.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.create_ontology_from_excel","title":"<code>create_ontology_from_excel(excelpath, concept_sheet_name='Concepts', metadata_sheet_name='Metadata', imports_sheet_name='ImportedOntologies', dataproperties_sheet_name='DataProperties', objectproperties_sheet_name='ObjectProperties', annotationproperties_sheet_name='AnnotationProperties', base_iri='http://emmo.info/emmo/domain/onto#', base_iri_from_metadata=True, imports=None, catalog=None, force=False, input_ontology=None)</code>","text":"<p>Creates an ontology from an Excel-file.</p> <p>Parameters:</p> Name Type Description Default <code>excelpath</code> <code>str</code> <p>Path to Excel workbook.</p> required <code>concept_sheet_name</code> <code>str</code> <p>Name of sheet where concepts are defined. The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel','altLabel', 'Elucidation', 'Comments', 'Examples', 'subClassOf', 'Relations'. Multiple entries are separated with ';'.</p> <code>'Concepts'</code> <code>metadata_sheet_name</code> <code>str</code> <p>Name of sheet where metadata are defined. The first row contains column names 'Metadata name' and 'Value' Supported 'Metadata names' are: 'Ontology IRI', 'Ontology vesion IRI', 'Ontology version Info', 'Title', 'Abstract', 'License', 'Comment', 'Author', 'Contributor'. Multiple entries are separated with a semi-colon (<code>;</code>).</p> <code>'Metadata'</code> <code>imports_sheet_name</code> <code>str</code> <p>Name of sheet where imported ontologies are defined. Column name is 'Imported ontologies'. Fully resolvable URL or path to imported ontologies provided one per row.</p> <code>'ImportedOntologies'</code> <code>dataproperties_sheet_name</code> <code>str</code> <p>Name of sheet where data properties are defined. The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel','altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf', 'Domain', 'Range', 'dijointWith', 'equivalentTo'.</p> <code>'DataProperties'</code> <code>annotationproperties_sheet_name</code> <code>str</code> <p>Name of sheet where annotation properties are defined. The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel', 'altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf', 'Domain', 'Range'.</p> <code>'AnnotationProperties'</code> <code>objectproperties_sheet_name</code> <code>str</code> <p>Name of sheet where object properties are defined.The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel','altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf', 'Domain', 'Range', 'inverseOf', 'dijointWith', 'equivalentTo'.</p> <code>'ObjectProperties'</code> <code>base_iri</code> <code>str</code> <p>Base IRI of the new ontology.</p> <code>'http://emmo.info/emmo/domain/onto#'</code> <code>base_iri_from_metadata</code> <code>bool</code> <p>Whether to use base IRI defined from metadata.</p> <code>True</code> <code>imports</code> <code>list</code> <p>List of imported ontologies.</p> <code>None</code> <code>catalog</code> <code>dict</code> <p>Imported ontologies with (name, full path) key/value-pairs.</p> <code>None</code> <code>force</code> <code>bool</code> <p>Forcibly make an ontology by skipping concepts that are erroneously defined or other errors in the excel sheet.</p> <code>False</code> <code>input_ontology</code> <code>Optional[ontopy.ontology.Ontology]</code> <p>Ontology that should be updated. Default is None, which means that a completely new ontology is generated. If an input_ontology to be updated is provided, the metadata sheet in the excel sheet will not be considered.</p> <code>None</code> <p>Returns:</p> Type Description <code>A tuple with the</code> <ul> <li>created ontology<ul> <li>associated catalog of ontology names and resolvable path as dict</li> <li> <p>a dictionary with lists of concepts that raise errors, with the   following keys:</p> <ul> <li>\"already_defined\": These are concepts (classes)     that are already in the     ontology, because they were already added in a     previous line of the excelfile/pandas dataframe, or because     it is already defined in an imported ontology with the same     base_iri as the newly created ontology.</li> <li>\"in_imported_ontologies\": Concepts (classes)     that are defined in the     excel, but already exist in the imported ontologies.</li> <li>\"wrongly_defined\": Concepts (classes) that are given an     invalid prefLabel (e.g. with a space in the name).</li> <li>\"missing_subClassOf\": Concepts (classes) that are missing     parents. These concepts are added directly under owl:Thing.</li> <li>\"invalid_subClassOf\": Concepts (classes) with invalidly     defined parents.     These concepts are added directly under owl:Thing.</li> <li>\"nonadded_concepts\": List of all concepts (classes) that are     not added,     either because the prefLabel is invalid, or because the     concept has already been added once or already exists in an     imported ontology.</li> <li>\"obj_prop_already_defined\": Object properties that are already     defined in the ontology.</li> <li>\"obj_prop_in_imported_ontologies\": Object properties that are     defined in the excel, but already exist in the imported     ontologies.</li> <li>\"obj_prop_wrongly_defined\": Object properties that are given     an invalid prefLabel (e.g. with a space in the name).</li> <li>\"obj_prop_missing_subPropertyOf\": Object properties that are     missing parents.</li> <li>\"obj_prop_invalid_subPropertyOf\": Object properties with     invalidly defined parents.</li> <li>\"obj_prop_nonadded_entities\": List of all object properties     that are not added, either because the prefLabel is invalid,     or because the concept has already been added once or     already exists in an imported ontology.</li> <li>\"obj_prop_errors_in_properties\": Object properties with     invalidly defined properties.</li> <li>\"obj_prop_errors_in_range\": Object properties with invalidly     defined range.</li> <li>\"obj_prop_errors_in_domain\": Object properties with invalidly     defined domain.</li> <li>\"annot_prop_already_defined\": Annotation properties that are     already defined in the ontology.</li> <li>\"annot_prop_in_imported_ontologies\":  Annotation properties     that     are defined in the excel, but already exist in the imported     ontologies.</li> <li>\"annot_prop_wrongly_defined\": Annotation properties that are     given an invalid prefLabel (e.g. with a space in the name).</li> <li>\"annot_prop_missing_subPropertyOf\": Annotation properties that     are missing parents.</li> <li>\"annot_prop_invalid_subPropertyOf\": Annotation properties with     invalidly defined parents.</li> <li>\"annot_prop_nonadded_entities\": List of all annotation     properties that are not added, either because the prefLabel     is invalid, or because the concept has already been added     once or already exists in an imported ontology.</li> <li>\"annot_prop_errors_in_properties\": Annotation properties with     invalidly defined properties.</li> <li>\"data_prop_already_defined\": Data properties that are already     defined in the ontology.</li> <li>\"data_prop_in_imported_ontologies\": Data properties that are     defined in the excel, but already exist in the imported     ontologies.</li> <li>\"data_prop_wrongly_defined\":  Data properties that are given     an invalid prefLabel (e.g. with a space in the name).</li> <li>\"data_prop_missing_subPropertyOf\": Data properties that are     missing parents.</li> <li>\"data_prop_invalid_subPropertyOf\": Data properties with     invalidly defined parents.</li> <li>\"data_prop_nonadded_entities\": List of all data properties     that are not added, either because the prefLabel is invalid,     or because the concept has already been added once or     already exists in an imported ontology.</li> <li>\"data_prop_errors_in_properties\": Data properties with     invalidly defined properties.</li> <li>\"data_prop_errors_in_range\": Data properties with invalidly     defined range.</li> <li>\"data_prop_errors_in_domain\": Data properties with invalidly     defined domain.</li> </ul> </li> </ul> </li> </ul> Source code in <code>ontopy/excelparser.py</code> <pre><code>def create_ontology_from_excel(  # pylint: disable=too-many-arguments, too-many-locals\n    excelpath: str,\n    concept_sheet_name: str = \"Concepts\",\n    metadata_sheet_name: str = \"Metadata\",\n    imports_sheet_name: str = \"ImportedOntologies\",\n    dataproperties_sheet_name: str = \"DataProperties\",\n    objectproperties_sheet_name: str = \"ObjectProperties\",\n    annotationproperties_sheet_name: str = \"AnnotationProperties\",\n    base_iri: str = \"http://emmo.info/emmo/domain/onto#\",\n    base_iri_from_metadata: bool = True,\n    imports: list = None,\n    catalog: dict = None,\n    force: bool = False,\n    input_ontology: Union[ontopy.ontology.Ontology, None] = None,\n) -&gt; Tuple[ontopy.ontology.Ontology, dict, dict]:\n    \"\"\"\n    Creates an ontology from an Excel-file.\n\n    Arguments:\n        excelpath: Path to Excel workbook.\n        concept_sheet_name: Name of sheet where concepts are defined.\n            The second row of this sheet should contain column names that are\n            supported. Currently these are 'prefLabel','altLabel',\n            'Elucidation', 'Comments', 'Examples', 'subClassOf', 'Relations'.\n            Multiple entries are separated with ';'.\n        metadata_sheet_name: Name of sheet where metadata are defined.\n            The first row contains column names 'Metadata name' and 'Value'\n            Supported 'Metadata names' are: 'Ontology IRI',\n            'Ontology vesion IRI', 'Ontology version Info', 'Title',\n            'Abstract', 'License', 'Comment', 'Author', 'Contributor'.\n            Multiple entries are separated with a semi-colon (`;`).\n        imports_sheet_name: Name of sheet where imported ontologies are\n            defined.\n            Column name is 'Imported ontologies'.\n            Fully resolvable URL or path to imported ontologies provided one\n            per row.\n        dataproperties_sheet_name: Name of sheet where data properties are\n            defined. The second row of this sheet should contain column names\n            that are supported. Currently these are 'prefLabel','altLabel',\n            'Elucidation', 'Comments', 'Examples', 'subPropertyOf',\n            'Domain', 'Range', 'dijointWith', 'equivalentTo'.\n        annotationproperties_sheet_name: Name of sheet where annotation\n            properties are defined. The second row of this sheet should contain\n            column names that are supported. Currently these are 'prefLabel',\n            'altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf',\n            'Domain', 'Range'.\n        objectproperties_sheet_name: Name of sheet where object properties are\n            defined.The second row of this sheet should contain column names\n            that are supported. Currently these are 'prefLabel','altLabel',\n            'Elucidation', 'Comments', 'Examples', 'subPropertyOf',\n            'Domain', 'Range', 'inverseOf', 'dijointWith', 'equivalentTo'.\n        base_iri: Base IRI of the new ontology.\n        base_iri_from_metadata: Whether to use base IRI defined from metadata.\n        imports: List of imported ontologies.\n        catalog: Imported ontologies with (name, full path) key/value-pairs.\n        force: Forcibly make an ontology by skipping concepts\n            that are erroneously defined or other errors in the excel sheet.\n        input_ontology: Ontology that should be updated.\n            Default is None,\n            which means that a completely new ontology is generated.\n            If an input_ontology to be updated is provided,\n            the metadata sheet in the excel sheet will not be considered.\n\n\n    Returns:\n        A tuple with the:\n\n            * created ontology\n            * associated catalog of ontology names and resolvable path as dict\n            * a dictionary with lists of concepts that raise errors, with the\n              following keys:\n\n                - \"already_defined\": These are concepts (classes)\n                    that are already in the\n                    ontology, because they were already added in a\n                    previous line of the excelfile/pandas dataframe, or because\n                    it is already defined in an imported ontology with the same\n                    base_iri as the newly created ontology.\n                - \"in_imported_ontologies\": Concepts (classes)\n                    that are defined in the\n                    excel, but already exist in the imported ontologies.\n                - \"wrongly_defined\": Concepts (classes) that are given an\n                    invalid prefLabel (e.g. with a space in the name).\n                - \"missing_subClassOf\": Concepts (classes) that are missing\n                    parents. These concepts are added directly under owl:Thing.\n                - \"invalid_subClassOf\": Concepts (classes) with invalidly\n                    defined parents.\n                    These concepts are added directly under owl:Thing.\n                - \"nonadded_concepts\": List of all concepts (classes) that are\n                    not added,\n                    either because the prefLabel is invalid, or because the\n                    concept has already been added once or already exists in an\n                    imported ontology.\n                - \"obj_prop_already_defined\": Object properties that are already\n                    defined in the ontology.\n                - \"obj_prop_in_imported_ontologies\": Object properties that are\n                    defined in the excel, but already exist in the imported\n                    ontologies.\n                - \"obj_prop_wrongly_defined\": Object properties that are given\n                    an invalid prefLabel (e.g. with a space in the name).\n                - \"obj_prop_missing_subPropertyOf\": Object properties that are\n                    missing parents.\n                - \"obj_prop_invalid_subPropertyOf\": Object properties with\n                    invalidly defined parents.\n                - \"obj_prop_nonadded_entities\": List of all object properties\n                    that are not added, either because the prefLabel is invalid,\n                    or because the concept has already been added once or\n                    already exists in an imported ontology.\n                - \"obj_prop_errors_in_properties\": Object properties with\n                    invalidly defined properties.\n                - \"obj_prop_errors_in_range\": Object properties with invalidly\n                    defined range.\n                - \"obj_prop_errors_in_domain\": Object properties with invalidly\n                    defined domain.\n                - \"annot_prop_already_defined\": Annotation properties that are\n                    already defined in the ontology.\n                - \"annot_prop_in_imported_ontologies\":  Annotation properties\n                    that\n                    are defined in the excel, but already exist in the imported\n                    ontologies.\n                - \"annot_prop_wrongly_defined\": Annotation properties that are\n                    given an invalid prefLabel (e.g. with a space in the name).\n                - \"annot_prop_missing_subPropertyOf\": Annotation properties that\n                    are missing parents.\n                - \"annot_prop_invalid_subPropertyOf\": Annotation properties with\n                    invalidly defined parents.\n                - \"annot_prop_nonadded_entities\": List of all annotation\n                    properties that are not added, either because the prefLabel\n                    is invalid, or because the concept has already been added\n                    once or already exists in an imported ontology.\n                - \"annot_prop_errors_in_properties\": Annotation properties with\n                    invalidly defined properties.\n                - \"data_prop_already_defined\": Data properties that are already\n                    defined in the ontology.\n                - \"data_prop_in_imported_ontologies\": Data properties that are\n                    defined in the excel, but already exist in the imported\n                    ontologies.\n                - \"data_prop_wrongly_defined\":  Data properties that are given\n                    an invalid prefLabel (e.g. with a space in the name).\n                - \"data_prop_missing_subPropertyOf\": Data properties that are\n                    missing parents.\n                - \"data_prop_invalid_subPropertyOf\": Data properties with\n                    invalidly defined parents.\n                - \"data_prop_nonadded_entities\": List of all data properties\n                    that are not added, either because the prefLabel is invalid,\n                    or because the concept has already been added once or\n                    already exists in an imported ontology.\n                - \"data_prop_errors_in_properties\": Data properties with\n                    invalidly defined properties.\n                - \"data_prop_errors_in_range\": Data properties with invalidly\n                    defined range.\n                - \"data_prop_errors_in_domain\": Data properties with invalidly\n                    defined domain.\n\n    \"\"\"\n    web_protocol = \"http://\", \"https://\", \"ftp://\"\n\n    def _relative_to_absolute_paths(path):\n        if isinstance(path, str):\n            if not path.startswith(web_protocol):\n                path = os.path.dirname(excelpath) + \"/\" + str(path)\n        return path\n\n    try:\n        imports = pd.read_excel(\n            excelpath, sheet_name=imports_sheet_name, skiprows=[1]\n        )\n    except ValueError:\n        imports = pd.DataFrame()\n    else:\n        # Strip leading and trailing white spaces in paths\n        imports.replace(r\"^\\s+\", \"\", regex=True).replace(\n            r\"\\s+$\", \"\", regex=True\n        )\n        # Set empty strings to nan\n        imports = imports.replace(r\"^\\s*$\", np.nan, regex=True)\n        if \"Imported ontologies\" in imports.columns:\n            imports[\"Imported ontologies\"] = imports[\n                \"Imported ontologies\"\n            ].apply(_relative_to_absolute_paths)\n\n    # Read datafile TODO: Some magic to identify the header row\n    conceptdata = pd.read_excel(\n        excelpath, sheet_name=concept_sheet_name, skiprows=[0, 2]\n    )\n    try:\n        objectproperties = pd.read_excel(\n            excelpath, sheet_name=objectproperties_sheet_name, skiprows=[0, 2]\n        )\n        if \"prefLabel\" not in objectproperties.columns:\n            warnings.warn(\n                \"The 'prefLabel' column is missing in \"\n                f\"{objectproperties_sheet_name}. \"\n                \"New object properties will not be added to the ontology.\"\n            )\n            objectproperties = None\n    except ValueError:\n        warnings.warn(\n            f\"No sheet named {objectproperties_sheet_name} found \"\n            f\"in {excelpath}. \"\n            \"New object properties will not be added to the ontology.\"\n        )\n        objectproperties = None\n    try:\n        annotationproperties = pd.read_excel(\n            excelpath,\n            sheet_name=annotationproperties_sheet_name,\n            skiprows=[0, 2],\n        )\n        if \"prefLabel\" not in annotationproperties.columns:\n            warnings.warn(\n                \"The 'prefLabel' column is missing in \"\n                f\"{annotationproperties_sheet_name}. \"\n                \"New annotation properties will not be added to the ontology.\"\n            )\n            annotationproperties = None\n    except ValueError:\n        warnings.warn(\n            f\"No sheet named {annotationproperties_sheet_name} \"\n            f\"found in {excelpath}. \"\n            \"New annotation properties will not be added to the ontology.\"\n        )\n        annotationproperties = None\n\n    try:\n        dataproperties = pd.read_excel(\n            excelpath, sheet_name=dataproperties_sheet_name, skiprows=[0, 2]\n        )\n        if \"prefLabel\" not in dataproperties.columns:\n            warnings.warn(\n                \"The 'prefLabel' column is missing in \"\n                f\"{dataproperties_sheet_name}. \"\n                \"New data properties will not be added to the ontology.\"\n            )\n            dataproperties = None\n    except ValueError:\n        warnings.warn(\n            f\"No sheet named {dataproperties_sheet_name} found in {excelpath}. \"\n            \"New data properties will not be added to the ontology.\"\n        )\n        dataproperties = None\n\n    metadata = pd.read_excel(excelpath, sheet_name=metadata_sheet_name)\n    return create_ontology_from_pandas(\n        data=conceptdata,\n        objectproperties=objectproperties,\n        dataproperties=dataproperties,\n        annotationproperties=annotationproperties,\n        metadata=metadata,\n        imports=imports,\n        base_iri=base_iri,\n        base_iri_from_metadata=base_iri_from_metadata,\n        catalog=catalog,\n        force=force,\n        input_ontology=input_ontology,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.create_ontology_from_pandas","title":"<code>create_ontology_from_pandas(data, objectproperties, annotationproperties, dataproperties, metadata, imports, base_iri='http://emmo.info/emmo/domain/onto#', base_iri_from_metadata=True, catalog=None, force=False, input_ontology=None)</code>","text":"<p>Create an ontology from a pandas DataFrame.</p> <p>Check 'create_ontology_from_excel' for complete documentation.</p> Source code in <code>ontopy/excelparser.py</code> <pre><code>def create_ontology_from_pandas(  # pylint:disable=too-many-locals,too-many-branches,too-many-statements,too-many-arguments\n    data: pd.DataFrame,\n    objectproperties: pd.DataFrame,\n    annotationproperties: pd.DataFrame,\n    dataproperties: pd.DataFrame,\n    metadata: pd.DataFrame,\n    imports: pd.DataFrame,\n    base_iri: str = \"http://emmo.info/emmo/domain/onto#\",\n    base_iri_from_metadata: bool = True,\n    catalog: dict = None,\n    force: bool = False,\n    input_ontology: Union[ontopy.ontology.Ontology, None] = None,\n) -&gt; Tuple[ontopy.ontology.Ontology, dict]:\n    \"\"\"\n    Create an ontology from a pandas DataFrame.\n\n    Check 'create_ontology_from_excel' for complete documentation.\n    \"\"\"\n    # Get ontology to which new concepts should be added\n    if input_ontology:\n        onto = input_ontology\n        catalog = {}\n    else:  # Create new ontology\n        onto, catalog = get_metadata_from_dataframe(\n            metadata, base_iri, imports=imports\n        )\n\n        # Set given or default base_iri if base_iri_from_metadata is False.\n        if not base_iri_from_metadata:\n            onto.base_iri = base_iri\n    # onto.sync_python_names()\n    # prefLabel, label, and altLabel\n    # are default label annotations\n    onto.set_default_label_annotations()\n    # Add object properties\n    if objectproperties is not None:\n        objectproperties = _clean_dataframe(objectproperties)\n        (\n            onto,\n            objectproperties_with_errors,\n            added_objprop_indices,\n        ) = _add_entities(\n            onto=onto,\n            data=objectproperties,\n            entitytype=owlready2.ObjectPropertyClass,\n            force=force,\n        )\n\n    if annotationproperties is not None:\n        annotationproperties = _clean_dataframe(annotationproperties)\n        (\n            onto,\n            annotationproperties_with_errors,\n            added_annotprop_indices,\n        ) = _add_entities(\n            onto=onto,\n            data=annotationproperties,\n            entitytype=owlready2.AnnotationPropertyClass,\n            force=force,\n        )\n\n    if dataproperties is not None:\n        dataproperties = _clean_dataframe(dataproperties)\n        (\n            onto,\n            dataproperties_with_errors,\n            added_dataprop_indices,\n        ) = _add_entities(\n            onto=onto,\n            data=dataproperties,\n            entitytype=owlready2.DataPropertyClass,\n            force=force,\n        )\n    onto.sync_attributes(\n        name_policy=\"uuid\", name_prefix=\"EMMO_\", class_docstring=\"elucidation\"\n    )\n    # Clean up data frame with new concepts\n    data = _clean_dataframe(data)\n    # Add entities\n    onto, entities_with_errors, added_concept_indices = _add_entities(\n        onto=onto, data=data, entitytype=owlready2.ThingClass, force=force\n    )\n\n    # Add entity properties in a second loop\n    for index in added_concept_indices:\n        row = data.loc[index]\n        properties = row[\"Relations\"]\n        if properties == \"nan\":\n            properties = None\n        if isinstance(properties, str):\n            try:\n                entity = onto.get_by_label(row[\"prefLabel\"].strip())\n            except NoSuchLabelError:\n                pass\n            props = properties.split(\";\")\n            for prop in props:\n                try:\n                    entity.is_a.append(evaluate(onto, prop.strip()))\n                except pyparsing.ParseException as exc:\n                    warnings.warn(\n                        # This is currently not tested\n                        f\"Error in Property assignment for: '{entity}'. \"\n                        f\"Property to be Evaluated: '{prop}'. \"\n                        f\"{exc}\"\n                    )\n                    entities_with_errors[\"errors_in_properties\"].append(\n                        entity.name\n                    )\n                except NoSuchLabelError as exc:\n                    msg = (\n                        f\"Error in Property assignment for: {entity}. \"\n                        f\"Property to be Evaluated: {prop}. \"\n                        f\"{exc}\"\n                    )\n                    if force is True:\n                        warnings.warn(msg)\n                        entities_with_errors[\"errors_in_properties\"].append(\n                            entity.name\n                        )\n                    else:\n                        raise ExcelError(msg) from exc\n\n    # Add range and domain for object properties\n    if objectproperties is not None:\n        onto, objectproperties_with_errors = _add_range_domain(\n            onto=onto,\n            properties=objectproperties,\n            added_prop_indices=added_objprop_indices,\n            properties_with_errors=objectproperties_with_errors,\n            force=force,\n        )\n        for key, value in objectproperties_with_errors.items():\n            entities_with_errors[\"obj_prop_\" + key] = value\n    # Add range and domain for annotation properties\n    if annotationproperties is not None:\n        onto, annotationproperties_with_errors = _add_range_domain(\n            onto=onto,\n            properties=annotationproperties,\n            added_prop_indices=added_annotprop_indices,\n            properties_with_errors=annotationproperties_with_errors,\n            force=force,\n        )\n        for key, value in annotationproperties_with_errors.items():\n            entities_with_errors[\"annot_prop_\" + key] = value\n\n    # Add range and domain for data properties\n    if dataproperties is not None:\n        onto, dataproperties_with_errors = _add_range_domain(\n            onto=onto,\n            properties=dataproperties,\n            added_prop_indices=added_dataprop_indices,\n            properties_with_errors=dataproperties_with_errors,\n            force=force,\n        )\n        for key, value in dataproperties_with_errors.items():\n            entities_with_errors[\"data_prop_\" + key] = value\n\n    # Synchronise Python attributes to ontology\n    onto.sync_attributes(\n        name_policy=\"uuid\", name_prefix=\"EMMO_\", class_docstring=\"elucidation\"\n    )\n    onto.dir_label = False\n    entities_with_errors = {\n        key: set(value) for key, value in entities_with_errors.items()\n    }\n    return onto, catalog, entities_with_errors\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.get_metadata_from_dataframe","title":"<code>get_metadata_from_dataframe(metadata, base_iri, base_iri_from_metadata=True, imports=None, catalog=None)</code>","text":"<p>Create ontology with metadata from pd.DataFrame</p> Source code in <code>ontopy/excelparser.py</code> <pre><code>def get_metadata_from_dataframe(  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    metadata: pd.DataFrame,\n    base_iri: str,\n    base_iri_from_metadata: bool = True,\n    imports: pd.DataFrame = None,\n    catalog: dict = None,\n) -&gt; Tuple[ontopy.ontology.Ontology, dict]:\n    \"\"\"Create ontology with metadata from pd.DataFrame\"\"\"\n\n    # base_iri from metadata if it exists and base_iri_from_metadata\n    if base_iri_from_metadata:\n        try:\n            base_iris = _parse_literal(metadata, \"Ontology IRI\", metadata=True)\n            if len(base_iris) &gt; 1:\n                warnings.warn(\n                    \"More than one Ontology IRI given. The first was chosen.\"\n                )\n            base_iri = base_iris[0] + \"#\"\n        except (TypeError, ValueError, AttributeError, IndexError):\n            pass\n\n    # Create new ontology\n    onto = get_ontology(base_iri)\n\n    # Add imported ontologies\n    catalog = {} if catalog is None else catalog\n    locations = set()\n    for _, row in imports.iterrows():\n        # for location in imports:\n        location = row[\"Imported ontologies\"]\n        if not pd.isna(location) and location not in locations:\n            imported = onto.world.get_ontology(location).load()\n            onto.imported_ontologies.append(imported)\n            catalog[imported.base_iri.rstrip(\"#/\")] = location\n            try:\n                cat = read_catalog(location.rsplit(\"/\", 1)[0])\n                catalog.update(cat)\n            except ReadCatalogError:\n                warnings.warn(f\"Catalog for {imported} not found.\")\n            locations.add(location)\n        # set defined prefix\n        if not pd.isna(row[\"prefix\"]):\n            # set prefix for all ontologies with same 'base_iri_root'\n            if not pd.isna(row[\"base_iri_root\"]):\n                onto.set_common_prefix(\n                    iri_base=row[\"base_iri_root\"], prefix=row[\"prefix\"]\n                )\n            # If base_root not given, set prefix only to top ontology\n            else:\n                imported.prefix = row[\"prefix\"]\n\n    with onto:\n        # Add title\n        try:\n            _add_literal(\n                metadata,\n                onto.metadata.title,\n                \"Title\",\n                metadata=True,\n                only_one=True,\n            )\n        except AttributeError:\n            pass\n\n        # Add license\n        try:\n            _add_literal(\n                metadata, onto.metadata.license, \"License\", metadata=True\n            )\n        except AttributeError:\n            pass\n\n        # Add authors/creators\n        try:\n            _add_literal(\n                metadata, onto.metadata.creator, \"Author\", metadata=True\n            )\n        except AttributeError:\n            pass\n\n        # Add contributors\n        try:\n            _add_literal(\n                metadata,\n                onto.metadata.contributor,\n                \"Contributor\",\n                metadata=True,\n            )\n        except AttributeError:\n            pass\n\n        # Add versionInfo\n        try:\n            _add_literal(\n                metadata,\n                onto.metadata.versionInfo,\n                \"Ontology version Info\",\n                metadata=True,\n                only_one=True,\n            )\n        except AttributeError:\n            pass\n    return onto, catalog\n</code></pre>"},{"location":"api_reference/ontopy/graph/","title":"graph","text":"<p>A module for visualising ontologies using graphviz.</p>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph","title":"<code> OntoGraph        </code>","text":"<p>Class for visualising an ontology.</p>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph--parameters","title":"Parameters","text":"<p>ontology : ontopy.Ontology instance     Ontology to visualize. root : None | graph.ALL | string | owlready2.ThingClass instance     Name or owlready2 entity of root node to plot subgraph     below.  If <code>root</code> is <code>graph.ALL</code>, all classes will be included     in the subgraph. leaves : None | sequence     A sequence of leaf node names for generating sub-graphs. entities : None | sequence     A sequence of entities to add to the graph. relations : \"all\" | str | None | sequence     Sequence of relations to visualise.  If \"all\", means to include     all relations. style : None | dict | \"default\"     A dict mapping the name of the different graphical elements     to dicts of dot graph attributes. Supported graphical elements     include:       - graphtype : \"Digraph\" | \"Graph\"       - graph : graph attributes (G)       - class : nodes for classes (N)       - root : additional attributes for root nodes (N)       - leaf : additional attributes for leaf nodes (N)       - defined_class : nodes for defined classes (N)       - class_construct : nodes for class constructs (N)       - individual : nodes for invididuals (N)       - object_property : nodes for object properties (N)       - data_property : nodes for data properties (N)       - annotation_property : nodes for annotation properties (N)       - added_node : nodes added because <code>addnodes</code> is true (N)       - isA : edges for isA relations (E)       - not : edges for not class constructs (E)       - equivalent_to : edges for equivalent_to relations (E)       - disjoint_with : edges for disjoint_with relations (E)       - inverse_of : edges for inverse_of relations (E)       - default_relation : default edges relations and restrictions (E)       - relations : dict of styles for different relations (E)       - inverse : default edges for inverse relations (E)       - default_dataprop : default edges for data properties (E)       - nodes : attribute for individual nodes (N)       - edges : attribute for individual edges (E)     If style is None or \"default\", the default style is used.     See https://www.graphviz.org/doc/info/attrs.html edgelabels : None | bool | dict     Whether to add labels to the edges of the generated graph.     It is also possible to provide a dict mapping the     full labels (with cardinality stripped off for restrictions)     to some abbreviations. addnodes : bool     Whether to add missing target nodes in relations. addconstructs : bool     Whether to add nodes representing class constructs. included_namespaces : sequence     In combination with <code>root</code>, only include classes with one of     the listed namespaces.  If empty (the default), nothing is     excluded. included_ontologies : sequence     In combination with <code>root</code>, only include classes defined in     one of the listed ontologies.  If empty (default), nothing is     excluded. parents : int     Include <code>parents</code> levels of parents. excluded_nodes : None | sequence     Sequence of labels of nodes to exclude. graph : None | pydot.Dot instance     Graphviz Digraph object to plot into.  If None, a new graph object     is created using the keyword arguments. imported : bool     Whether to include imported classes if <code>entities</code> is None. kwargs :     Passed to graphviz.Digraph.</p> Source code in <code>ontopy/graph.py</code> <pre><code>class OntoGraph:  # pylint: disable=too-many-instance-attributes\n    \"\"\"Class for visualising an ontology.\n\n    Parameters\n    ----------\n    ontology : ontopy.Ontology instance\n        Ontology to visualize.\n    root : None | graph.ALL | string | owlready2.ThingClass instance\n        Name or owlready2 entity of root node to plot subgraph\n        below.  If `root` is `graph.ALL`, all classes will be included\n        in the subgraph.\n    leaves : None | sequence\n        A sequence of leaf node names for generating sub-graphs.\n    entities : None | sequence\n        A sequence of entities to add to the graph.\n    relations : \"all\" | str | None | sequence\n        Sequence of relations to visualise.  If \"all\", means to include\n        all relations.\n    style : None | dict | \"default\"\n        A dict mapping the name of the different graphical elements\n        to dicts of dot graph attributes. Supported graphical elements\n        include:\n          - graphtype : \"Digraph\" | \"Graph\"\n          - graph : graph attributes (G)\n          - class : nodes for classes (N)\n          - root : additional attributes for root nodes (N)\n          - leaf : additional attributes for leaf nodes (N)\n          - defined_class : nodes for defined classes (N)\n          - class_construct : nodes for class constructs (N)\n          - individual : nodes for invididuals (N)\n          - object_property : nodes for object properties (N)\n          - data_property : nodes for data properties (N)\n          - annotation_property : nodes for annotation properties (N)\n          - added_node : nodes added because `addnodes` is true (N)\n          - isA : edges for isA relations (E)\n          - not : edges for not class constructs (E)\n          - equivalent_to : edges for equivalent_to relations (E)\n          - disjoint_with : edges for disjoint_with relations (E)\n          - inverse_of : edges for inverse_of relations (E)\n          - default_relation : default edges relations and restrictions (E)\n          - relations : dict of styles for different relations (E)\n          - inverse : default edges for inverse relations (E)\n          - default_dataprop : default edges for data properties (E)\n          - nodes : attribute for individual nodes (N)\n          - edges : attribute for individual edges (E)\n        If style is None or \"default\", the default style is used.\n        See https://www.graphviz.org/doc/info/attrs.html\n    edgelabels : None | bool | dict\n        Whether to add labels to the edges of the generated graph.\n        It is also possible to provide a dict mapping the\n        full labels (with cardinality stripped off for restrictions)\n        to some abbreviations.\n    addnodes : bool\n        Whether to add missing target nodes in relations.\n    addconstructs : bool\n        Whether to add nodes representing class constructs.\n    included_namespaces : sequence\n        In combination with `root`, only include classes with one of\n        the listed namespaces.  If empty (the default), nothing is\n        excluded.\n    included_ontologies : sequence\n        In combination with `root`, only include classes defined in\n        one of the listed ontologies.  If empty (default), nothing is\n        excluded.\n    parents : int\n        Include `parents` levels of parents.\n    excluded_nodes : None | sequence\n        Sequence of labels of nodes to exclude.\n    graph : None | pydot.Dot instance\n        Graphviz Digraph object to plot into.  If None, a new graph object\n        is created using the keyword arguments.\n    imported : bool\n        Whether to include imported classes if `entities` is None.\n    kwargs :\n        Passed to graphviz.Digraph.\n    \"\"\"\n\n    def __init__(  # pylint: disable=too-many-arguments,too-many-locals\n        self,\n        ontology,\n        root=None,\n        leaves=None,\n        entities=None,\n        relations=\"isA\",\n        style=None,\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        included_namespaces=(),\n        included_ontologies=(),\n        parents=0,\n        excluded_nodes=None,\n        graph=None,\n        imported=False,\n        **kwargs,\n    ):\n        if style is None or style == \"default\":\n            style = _default_style\n\n        if graph is None:\n            graphtype = style.get(\"graphtype\", \"Digraph\")\n            dotcls = getattr(graphviz, graphtype)\n            graph_attr = kwargs.pop(\"graph_attr\", {})\n            for key, value in style.get(\"graph\", {}).items():\n                graph_attr.setdefault(key, value)\n            self.dot = dotcls(graph_attr=graph_attr, **kwargs)\n            self.nodes = set()\n            self.edges = set()\n        else:\n            if ontology != graph.ontology:\n                raise ValueError(\n                    \"the same ontology must be used when extending a graph\"\n                )\n            self.dot = graph.dot.copy()\n            self.nodes = graph.nodes.copy()\n            self.edges = graph.edges.copy()\n\n        self.ontology = ontology\n        self.relations = set(\n            [relations] if isinstance(relations, str) else relations\n        )\n        self.style = style\n        self.edgelabels = edgelabels\n        self.addnodes = addnodes\n        self.addconstructs = addconstructs\n        self.excluded_nodes = set(excluded_nodes) if excluded_nodes else set()\n        self.imported = imported\n\n        if root == ALL:\n            self.add_entities(\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n            )\n        elif root:\n            self.add_branch(\n                root,\n                leaves,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n                included_namespaces=included_namespaces,\n                included_ontologies=included_ontologies,\n            )\n            if parents:\n                self.add_parents(\n                    root,\n                    levels=parents,\n                    relations=relations,\n                    edgelabels=edgelabels,\n                    addnodes=addnodes,\n                    addconstructs=addconstructs,\n                )\n\n        if entities:\n            self.add_entities(\n                entities=entities,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n            )\n\n    def add_entities(  # pylint: disable=too-many-arguments\n        self,\n        entities=None,\n        relations=\"isA\",\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        nodeattrs=None,\n        **attrs,\n    ):\n        \"\"\"Adds a sequence of entities to the graph.  If `entities` is None,\n        all classes are added to the graph.\n\n        `nodeattrs` is a dict mapping node names to are attributes for\n        dedicated nodes.\n        \"\"\"\n        if entities is None:\n            entities = self.ontology.classes(imported=self.imported)\n        self.add_nodes(entities, nodeattrs=nodeattrs, **attrs)\n        self.add_edges(\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            **attrs,\n        )\n\n    def add_branch(  # pylint: disable=too-many-arguments,too-many-locals\n        self,\n        root,\n        leaves=None,\n        include_leaves=True,\n        strict_leaves=False,\n        exclude=None,\n        relations=\"isA\",\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        included_namespaces=(),\n        included_ontologies=(),\n        include_parents=\"closest\",\n        **attrs,\n    ):\n        \"\"\"Adds branch under `root` ending at any entity included in the\n        sequence `leaves`.  If `include_leaves` is true, leaf classes are\n        also included.\"\"\"\n        if leaves is None:\n            leaves = ()\n        classes = self.ontology.get_branch(\n            root=root,\n            leaves=leaves,\n            include_leaves=include_leaves,\n            strict_leaves=strict_leaves,\n            exclude=exclude,\n        )\n\n        classes = filter_classes(\n            classes,\n            included_namespaces=included_namespaces,\n            included_ontologies=included_ontologies,\n        )\n\n        nodeattrs = {}\n        nodeattrs[get_label(root)] = self.style.get(\"root\", {})\n        for leaf in leaves:\n            nodeattrs[get_label(leaf)] = self.style.get(\"leaf\", {})\n\n        self.add_entities(\n            entities=classes,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            nodeattrs=nodeattrs,\n            **attrs,\n        )\n        closest_ancestors = False\n        ancestor_generations = None\n        if include_parents == \"closest\":\n            closest_ancestors = True\n        elif isinstance(include_parents, int):\n            ancestor_generations = include_parents\n        parents = self.ontology.get_ancestors(\n            classes,\n            closest=closest_ancestors,\n            generations=ancestor_generations,\n            strict=True,\n        )\n        if parents:\n            for parent in parents:\n                nodeattrs[get_label(parent)] = self.style.get(\"parent_node\", {})\n            self.add_entities(\n                entities=parents,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n                nodeattrs=nodeattrs,\n                **attrs,\n            )\n\n    def add_parents(  # pylint: disable=too-many-arguments\n        self,\n        name,\n        levels=1,\n        relations=\"isA\",\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        **attrs,\n    ):\n        \"\"\"Add `levels` levels of strict parents of entity `name`.\"\"\"\n\n        def addparents(entity, nodes, parents):\n            if nodes &gt; 0:\n                for parent in entity.get_parents(strict=True):\n                    parents.add(parent)\n                    addparents(parent, nodes - 1, parents)\n\n        entity = self.ontology[name] if isinstance(name, str) else name\n        parents = set()\n        addparents(entity, levels, parents)\n        self.add_entities(\n            entities=parents,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            **attrs,\n        )\n\n    def add_node(self, name, nodeattrs=None, **attrs):\n        \"\"\"Add node with given name. `attrs` are graphviz node attributes.\"\"\"\n        entity = self.ontology[name] if isinstance(name, str) else name\n        label = get_label(entity)\n        if label not in self.nodes.union(self.excluded_nodes):\n            kwargs = self.get_node_attrs(\n                entity, nodeattrs=nodeattrs, attrs=attrs\n            )\n            if hasattr(entity, \"iri\"):\n                kwargs.setdefault(\"URL\", entity.iri)\n            self.dot.node(label, label=label, **kwargs)\n            self.nodes.add(label)\n\n    def add_nodes(self, names, nodeattrs, **attrs):\n        \"\"\"Add nodes with given names. `attrs` are graphviz node attributes.\"\"\"\n        for name in names:\n            self.add_node(name, nodeattrs=nodeattrs, **attrs)\n\n    def add_edge(self, subject, predicate, obj, edgelabel=None, **attrs):\n        \"\"\"Add edge corresponding for ``(subject, predicate, object)``\n        triplet.\"\"\"\n        subject = subject if isinstance(subject, str) else get_label(subject)\n        predicate = (\n            predicate if isinstance(predicate, str) else get_label(predicate)\n        )\n        obj = obj if isinstance(obj, str) else get_label(obj)\n        if subject in self.excluded_nodes or obj in self.excluded_nodes:\n            return\n        if not isinstance(subject, str) or not isinstance(obj, str):\n            raise TypeError(\"`subject` and `object` must be strings\")\n        if subject not in self.nodes:\n            raise RuntimeError(f'`subject` \"{subject}\" must have been added')\n        if obj not in self.nodes:\n            raise RuntimeError(f'`object` \"{obj}\" must have been added')\n        key = (subject, predicate, obj)\n        if key not in self.edges:\n            relations = self.style.get(\"relations\", {})\n            rels = set(\n                self.ontology[_] for _ in relations if _ in self.ontology\n            )\n            if (edgelabel is None) and (\n                (predicate in rels) or (predicate == \"isA\")\n            ):\n                edgelabel = self.edgelabels\n            label = None\n            if edgelabel is None:\n                tokens = predicate.split()\n                if len(tokens) == 2 and tokens[1] in (\"some\", \"only\"):\n                    label = f\"{tokens[0]} {tokens[1]}\"\n                elif len(tokens) == 3 and tokens[1] in (\n                    \"exactly\",\n                    \"min\",\n                    \"max\",\n                ):\n                    label = f\"{tokens[0]} {tokens[1]} {tokens[2]}\"\n            elif isinstance(edgelabel, str):\n                label = edgelabel\n            elif isinstance(edgelabel, dict):\n                label = edgelabel.get(predicate, predicate)\n            elif edgelabel:\n                label = predicate\n            kwargs = self.get_edge_attrs(predicate, attrs=attrs)\n            self.dot.edge(subject, obj, label=label, **kwargs)\n            self.edges.add(key)\n\n    def add_source_edges(  # pylint: disable=too-many-arguments,too-many-branches\n        self,\n        source,\n        relations=None,\n        edgelabels=None,\n        addnodes=None,\n        addconstructs=None,\n        **attrs,\n    ):\n        \"\"\"Adds all relations originating from entity `source` who's type\n        are listed in `relations`.\"\"\"\n        if relations is None:\n            relations = self.relations\n        elif isinstance(relations, str):\n            relations = set([relations])\n        else:\n            relations = set(relations)\n\n        edgelabels = self.edgelabels if edgelabels is None else edgelabels\n        addconstructs = (\n            self.addconstructs if addconstructs is None else addconstructs\n        )\n\n        entity = self.ontology[source] if isinstance(source, str) else source\n        label = get_label(entity)\n        for relation in entity.is_a:\n            # isA\n            if isinstance(\n                relation, (owlready2.ThingClass, owlready2.ObjectPropertyClass)\n            ):\n                if \"all\" in relations or \"isA\" in relations:\n                    rlabel = get_label(relation)\n                    # FIXME - we actually want to include individuals...\n                    if isinstance(entity, owlready2.Thing):\n                        continue\n                    if relation not in entity.get_parents(strict=True):\n                        continue\n                    if not self.add_missing_node(relation, addnodes=addnodes):\n                        continue\n                    self.add_edge(\n                        subject=label,\n                        predicate=\"isA\",\n                        obj=rlabel,\n                        edgelabel=edgelabels,\n                        **attrs,\n                    )\n\n            # restriction\n            elif isinstance(relation, owlready2.Restriction):\n                rname = get_label(relation.property)\n                if \"all\" in relations or rname in relations:\n                    rlabel = f\"{rname} {typenames[relation.type]}\"\n                    if isinstance(relation.value, owlready2.ThingClass):\n                        obj = get_label(relation.value)\n                        if not self.add_missing_node(relation.value, addnodes):\n                            continue\n                    elif (\n                        isinstance(relation.value, owlready2.ClassConstruct)\n                        and self.addconstructs\n                    ):\n                        obj = self.add_class_construct(relation.value)\n                    else:\n                        continue\n                    pred = asstring(\n                        relation, exclude_object=True, ontology=self.ontology\n                    )\n                    self.add_edge(\n                        label, pred, obj, edgelabel=edgelabels, **attrs\n                    )\n\n            # inverse\n            if isinstance(relation, owlready2.Inverse):\n                if \"all\" in relations or \"inverse\" in relations:\n                    rlabel = get_label(relation)\n                    if not self.add_missing_node(relation, addnodes=addnodes):\n                        continue\n                    if relation not in entity.get_parents(strict=True):\n                        continue\n                    self.add_edge(\n                        subject=label,\n                        predicate=\"inverse\",\n                        obj=rlabel,\n                        edgelabel=edgelabels,\n                        **attrs,\n                    )\n\n    def add_edges(  # pylint: disable=too-many-arguments\n        self,\n        sources=None,\n        relations=None,\n        edgelabels=None,\n        addnodes=None,\n        addconstructs=None,\n        **attrs,\n    ):\n        \"\"\"Adds all relations originating from entities `sources` who's type\n        are listed in `relations`.  If `sources` is None, edges are added\n        between all current nodes.\"\"\"\n        if sources is None:\n            sources = self.nodes\n        for source in sources.copy():\n            self.add_source_edges(\n                source,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n                **attrs,\n            )\n\n    def add_missing_node(self, name, addnodes=None):\n        \"\"\"Checks if `name` corresponds to a missing node and add it if\n        `addnodes` is true.\n\n        Returns true if the node exists or is added, false otherwise.\"\"\"\n        addnodes = self.addnodes if addnodes is None else addnodes\n        entity = self.ontology[name] if isinstance(name, str) else name\n        label = get_label(entity)\n        if label not in self.nodes:\n            if addnodes:\n                self.add_node(entity, **self.style.get(\"added_node\", {}))\n            else:\n                return False\n        return True\n\n    def add_class_construct(self, construct):\n        \"\"\"Adds class construct and return its label.\"\"\"\n        self.add_node(construct, **self.style.get(\"class_construct\", {}))\n        label = get_label(construct)\n        if isinstance(construct, owlready2.Or):\n            for cls in construct.Classes:\n                clslabel = get_label(cls)\n                if clslabel not in self.nodes and self.addnodes:\n                    self.add_node(cls)\n                if clslabel in self.nodes:\n                    self.add_edge(get_label(cls), \"isA\", label)\n        elif isinstance(construct, owlready2.And):\n            for cls in construct.Classes:\n                clslabel = get_label(cls)\n                if clslabel not in self.nodes and self.addnodes:\n                    self.add_node(cls)\n                if clslabel in self.nodes:\n                    self.add_edge(label, \"isA\", get_label(cls))\n        elif isinstance(construct, owlready2.Not):\n            clslabel = get_label(construct.Class)\n            if clslabel not in self.nodes and self.addnodes:\n                self.add_node(construct.Class)\n            if clslabel in self.nodes:\n                self.add_edge(clslabel, \"not\", label)\n        # Neither and nor inverse constructs are\n        return label\n\n    def get_node_attrs(self, name, nodeattrs, attrs):\n        \"\"\"Returns attributes for node or edge `name`.  `attrs` overrides\n        the default style.\"\"\"\n        entity = self.ontology[name] if isinstance(name, str) else name\n        label = get_label(entity)\n        # class\n        if isinstance(entity, owlready2.ThingClass):\n            if entity.is_defined:\n                kwargs = self.style.get(\"defined_class\", {})\n            else:\n                kwargs = self.style.get(\"class\", {})\n        # class construct\n        elif isinstance(entity, owlready2.ClassConstruct):\n            kwargs = self.style.get(\"class_construct\", {})\n        # individual\n        elif isinstance(entity, owlready2.Thing):\n            kwargs = self.style.get(\"individual\", {})\n        # object property\n        elif isinstance(entity, owlready2.ObjectPropertyClass):\n            kwargs = self.style.get(\"object_property\", {})\n        # data property\n        elif isinstance(entity, owlready2.DataPropertyClass):\n            kwargs = self.style.get(\"data_property\", {})\n        # annotation property\n        elif isinstance(entity, owlready2.AnnotationPropertyClass):\n            kwargs = self.style.get(\"annotation_property\", {})\n        else:\n            raise TypeError(f\"Unknown entity type: {entity!r}\")\n        kwargs = kwargs.copy()\n        kwargs.update(self.style.get(\"nodes\", {}).get(label, {}))\n        if nodeattrs:\n            kwargs.update(nodeattrs.get(label, {}))\n        kwargs.update(attrs)\n        return kwargs\n\n    def _relation_styles(\n        self, entity: ThingClass, relations: dict, rels: set\n    ) -&gt; dict:\n        \"\"\"Helper function that returns the styles of the relations\n        to be used.\n\n        Parameters:\n            entity: the entity of the parent relation\n            relations: relations with default styles\n            rels: relations to be considered that have default styles,\n                either for the prefLabel or one of the altLabels\n        \"\"\"\n        for relation in entity.mro():\n            if relation in rels:\n                if str(get_label(relation)) in relations:\n                    rattrs = relations[str(get_label(relation))]\n                else:\n                    for alt_label in relation.get_annotations()[\"altLabel\"]:\n                        rattrs = relations[str(alt_label)]\n\n                break\n        else:\n            warnings.warn(\n                f\"Style not defined for relation {get_label(entity)}. \"\n                \"Resorting to default style.\"\n            )\n            rattrs = self.style.get(\"default_relation\", {})\n        return rattrs\n\n    def get_edge_attrs(self, predicate: str, attrs: dict) -&gt; dict:\n        \"\"\"Returns attributes for node or edge `predicate`.  `attrs` overrides\n        the default style.\n\n        Parameters:\n            predicate: predicate to get attributes for\n            attrs: desired attributes to override default\n        \"\"\"\n        # given type\n        types = (\"isA\", \"equivalent_to\", \"disjoint_with\", \"inverse_of\")\n        if predicate in types:\n            kwargs = self.style.get(predicate, {}).copy()\n        else:\n            kwargs = {}\n            name = predicate.split(None, 1)[0]\n            match = re.match(r\"Inverse\\((.*)\\)\", name)\n            if match:\n                (name,) = match.groups()\n                attrs = attrs.copy()\n                for key, value in self.style.get(\"inverse\", {}).items():\n                    attrs.setdefault(key, value)\n            if not isinstance(name, str) or name in self.ontology:\n                entity = self.ontology[name] if isinstance(name, str) else name\n                relations = self.style.get(\"relations\", {})\n                rels = set(\n                    self.ontology[_] for _ in relations if _ in self.ontology\n                )\n                rattrs = self._relation_styles(entity, relations, rels)\n\n                # object property\n                if isinstance(\n                    entity,\n                    (owlready2.ObjectPropertyClass, owlready2.ObjectProperty),\n                ):\n                    kwargs = self.style.get(\"default_relation\", {}).copy()\n                    kwargs.update(rattrs)\n                # data property\n                elif isinstance(\n                    entity,\n                    (owlready2.DataPropertyClass, owlready2.DataProperty),\n                ):\n                    kwargs = self.style.get(\"default_dataprop\", {}).copy()\n                    kwargs.update(rattrs)\n                else:\n                    raise TypeError(f\"Unknown entity type: {entity!r}\")\n        kwargs.update(self.style.get(\"edges\", {}).get(predicate, {}))\n        kwargs.update(attrs)\n        return kwargs\n\n    def add_legend(self, relations=None):\n        \"\"\"Adds legend for specified relations to the graph.\n\n        If `relations` is \"all\", the legend will contain all relations\n        that are defined in the style.  By default the legend will\n        only contain relations that are currently included in the\n        graph.\n\n        Hence, you usually want to call add_legend() as the last method\n        before saving or displaying.\n\n        Relations with defined style will be bold in legend.\n        Relations that have inherited style from parent relation\n        will not be bold.\n        \"\"\"\n        rels = self.style.get(\"relations\", {})\n        if relations is None:\n            relations = self.get_relations(sort=True)\n        elif relations == \"all\":\n            relations = [\"isA\"] + list(rels.keys()) + [\"inverse\"]\n        elif isinstance(relations, str):\n            relations = relations.split(\",\")\n\n        nrelations = len(relations)\n        if nrelations == 0:\n            return\n\n        table = (\n            '&lt;&lt;table border=\"0\" cellpadding=\"2\" cellspacing=\"0\" cellborder=\"0\"&gt;'\n        )\n        label1 = [table]\n        label2 = [table]\n        for index, relation in enumerate(relations):\n            if (relation in rels) or (relation == \"isA\"):\n                label1.append(\n                    f'&lt;tr&gt;&lt;td align=\"right\" '\n                    f'port=\"i{index}\"&gt;&lt;b&gt;{relation}&lt;/b&gt;&lt;/td&gt;&lt;/tr&gt;'\n                )\n            else:\n                label1.append(\n                    f'&lt;tr&gt;&lt;td align=\"right\" '\n                    f'port=\"i{index}\"&gt;{relation}&lt;/td&gt;&lt;/tr&gt;'\n                )\n            label2.append(f'&lt;tr&gt;&lt;td port=\"i{index}\"&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt;')\n        label1.append(\"&lt;/table&gt;&gt;\")\n        label2.append(\"&lt;/table&gt;&gt;\")\n        self.dot.node(\"key1\", label=\"\\n\".join(label1), shape=\"plaintext\")\n        self.dot.node(\"key2\", label=\"\\n\".join(label2), shape=\"plaintext\")\n\n        rankdir = self.dot.graph_attr.get(\"rankdir\", \"TB\")\n        constraint = \"false\" if rankdir in (\"TB\", \"BT\") else \"true\"\n        inv = rankdir in (\"BT\",)\n\n        for index in range(nrelations):\n            relation = (\n                relations[nrelations - 1 - index] if inv else relations[index]\n            )\n            if relation == \"inverse\":\n                kwargs = self.style.get(\"inverse\", {}).copy()\n            else:\n                kwargs = self.get_edge_attrs(relation, {}).copy()\n            kwargs[\"constraint\"] = constraint\n            with self.dot.subgraph(name=f\"sub{index}\") as subgraph:\n                subgraph.attr(rank=\"same\")\n                if rankdir in (\"BT\", \"LR\"):\n                    self.dot.edge(\n                        f\"key1:i{index}:e\", f\"key2:i{index}:w\", **kwargs\n                    )\n                else:\n                    self.dot.edge(\n                        f\"key2:i{index}:w\", f\"key1:i{index}:e\", **kwargs\n                    )\n\n    def get_relations(self, sort=True):\n        \"\"\"Returns a set of relations in current graph.  If `sort` is true,\n        a sorted list is returned.\"\"\"\n        relations = set()\n        for _, predicate, _ in self.edges:\n            if predicate.startswith(\"Inverse\"):\n                relations.add(\"inverse\")\n                match = re.match(r\"Inverse\\((.+)\\)\", predicate)\n                if match is None:\n                    raise ValueError(\n                        \"Could unexpectedly not find the inverse relation \"\n                        f\"just added in: {predicate}\"\n                    )\n                relations.add(match.groups()[0])\n            else:\n                relations.add(predicate.split(None, 1)[0])\n\n        # Sort, but place 'isA' first and 'inverse' last\n        if sort:\n            start, end = [], []\n            if \"isA\" in relations:\n                relations.remove(\"isA\")\n                start.append(\"isA\")\n            if \"inverse\" in relations:\n                relations.remove(\"inverse\")\n                end.append(\"inverse\")\n            relations = start + sorted(relations) + end\n\n        return relations\n\n    def save(self, filename, fmt=None, **kwargs):\n        \"\"\"Saves graph to `filename`.  If format is not given, it is\n        inferred from `filename`.\"\"\"\n        base = os.path.splitext(filename)[0]\n        fmt = get_format(filename, default=\"svg\", fmt=fmt)\n        kwargs.setdefault(\"cleanup\", True)\n        if fmt in (\"graphviz\", \"gv\"):\n            if \"dictionary\" in kwargs:\n                self.dot.save(filename, dictionary=kwargs[\"dictionary\"])\n            else:\n                self.dot.save(filename)\n        else:\n            fmt = kwargs.pop(\"format\", fmt)\n            self.dot.render(base, format=fmt, **kwargs)\n\n    def view(self):\n        \"\"\"Shows the graph in a viewer.\"\"\"\n        self.dot.view(cleanup=True)\n\n    def get_figsize(self):\n        \"\"\"Returns the default figure size (width, height) in points.\"\"\"\n        with tempfile.TemporaryDirectory() as tmpdir:\n            tmpfile = os.path.join(tmpdir, \"graph.svg\")\n            self.save(tmpfile)\n            xml = ET.parse(tmpfile)\n            svg = xml.getroot()\n            width = svg.attrib[\"width\"]\n            height = svg.attrib[\"height\"]\n            if not width.endswith(\"pt\"):\n                # ensure that units are in points\n                raise ValueError(\n                    \"The width attribute should always be given in 'pt', \"\n                    f\"but it is: {width}\"\n                )\n\n            def asfloat(string):\n                return float(re.match(r\"^[\\d.]+\", string).group())\n\n        return asfloat(width), asfloat(height)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_branch","title":"<code>add_branch(self, root, leaves=None, include_leaves=True, strict_leaves=False, exclude=None, relations='isA', edgelabels=None, addnodes=False, addconstructs=False, included_namespaces=(), included_ontologies=(), include_parents='closest', **attrs)</code>","text":"<p>Adds branch under <code>root</code> ending at any entity included in the sequence <code>leaves</code>.  If <code>include_leaves</code> is true, leaf classes are also included.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_branch(  # pylint: disable=too-many-arguments,too-many-locals\n    self,\n    root,\n    leaves=None,\n    include_leaves=True,\n    strict_leaves=False,\n    exclude=None,\n    relations=\"isA\",\n    edgelabels=None,\n    addnodes=False,\n    addconstructs=False,\n    included_namespaces=(),\n    included_ontologies=(),\n    include_parents=\"closest\",\n    **attrs,\n):\n    \"\"\"Adds branch under `root` ending at any entity included in the\n    sequence `leaves`.  If `include_leaves` is true, leaf classes are\n    also included.\"\"\"\n    if leaves is None:\n        leaves = ()\n    classes = self.ontology.get_branch(\n        root=root,\n        leaves=leaves,\n        include_leaves=include_leaves,\n        strict_leaves=strict_leaves,\n        exclude=exclude,\n    )\n\n    classes = filter_classes(\n        classes,\n        included_namespaces=included_namespaces,\n        included_ontologies=included_ontologies,\n    )\n\n    nodeattrs = {}\n    nodeattrs[get_label(root)] = self.style.get(\"root\", {})\n    for leaf in leaves:\n        nodeattrs[get_label(leaf)] = self.style.get(\"leaf\", {})\n\n    self.add_entities(\n        entities=classes,\n        relations=relations,\n        edgelabels=edgelabels,\n        addnodes=addnodes,\n        addconstructs=addconstructs,\n        nodeattrs=nodeattrs,\n        **attrs,\n    )\n    closest_ancestors = False\n    ancestor_generations = None\n    if include_parents == \"closest\":\n        closest_ancestors = True\n    elif isinstance(include_parents, int):\n        ancestor_generations = include_parents\n    parents = self.ontology.get_ancestors(\n        classes,\n        closest=closest_ancestors,\n        generations=ancestor_generations,\n        strict=True,\n    )\n    if parents:\n        for parent in parents:\n            nodeattrs[get_label(parent)] = self.style.get(\"parent_node\", {})\n        self.add_entities(\n            entities=parents,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            nodeattrs=nodeattrs,\n            **attrs,\n        )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_class_construct","title":"<code>add_class_construct(self, construct)</code>","text":"<p>Adds class construct and return its label.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_class_construct(self, construct):\n    \"\"\"Adds class construct and return its label.\"\"\"\n    self.add_node(construct, **self.style.get(\"class_construct\", {}))\n    label = get_label(construct)\n    if isinstance(construct, owlready2.Or):\n        for cls in construct.Classes:\n            clslabel = get_label(cls)\n            if clslabel not in self.nodes and self.addnodes:\n                self.add_node(cls)\n            if clslabel in self.nodes:\n                self.add_edge(get_label(cls), \"isA\", label)\n    elif isinstance(construct, owlready2.And):\n        for cls in construct.Classes:\n            clslabel = get_label(cls)\n            if clslabel not in self.nodes and self.addnodes:\n                self.add_node(cls)\n            if clslabel in self.nodes:\n                self.add_edge(label, \"isA\", get_label(cls))\n    elif isinstance(construct, owlready2.Not):\n        clslabel = get_label(construct.Class)\n        if clslabel not in self.nodes and self.addnodes:\n            self.add_node(construct.Class)\n        if clslabel in self.nodes:\n            self.add_edge(clslabel, \"not\", label)\n    # Neither and nor inverse constructs are\n    return label\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_edge","title":"<code>add_edge(self, subject, predicate, obj, edgelabel=None, **attrs)</code>","text":"<p>Add edge corresponding for <code>(subject, predicate, object)</code> triplet.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_edge(self, subject, predicate, obj, edgelabel=None, **attrs):\n    \"\"\"Add edge corresponding for ``(subject, predicate, object)``\n    triplet.\"\"\"\n    subject = subject if isinstance(subject, str) else get_label(subject)\n    predicate = (\n        predicate if isinstance(predicate, str) else get_label(predicate)\n    )\n    obj = obj if isinstance(obj, str) else get_label(obj)\n    if subject in self.excluded_nodes or obj in self.excluded_nodes:\n        return\n    if not isinstance(subject, str) or not isinstance(obj, str):\n        raise TypeError(\"`subject` and `object` must be strings\")\n    if subject not in self.nodes:\n        raise RuntimeError(f'`subject` \"{subject}\" must have been added')\n    if obj not in self.nodes:\n        raise RuntimeError(f'`object` \"{obj}\" must have been added')\n    key = (subject, predicate, obj)\n    if key not in self.edges:\n        relations = self.style.get(\"relations\", {})\n        rels = set(\n            self.ontology[_] for _ in relations if _ in self.ontology\n        )\n        if (edgelabel is None) and (\n            (predicate in rels) or (predicate == \"isA\")\n        ):\n            edgelabel = self.edgelabels\n        label = None\n        if edgelabel is None:\n            tokens = predicate.split()\n            if len(tokens) == 2 and tokens[1] in (\"some\", \"only\"):\n                label = f\"{tokens[0]} {tokens[1]}\"\n            elif len(tokens) == 3 and tokens[1] in (\n                \"exactly\",\n                \"min\",\n                \"max\",\n            ):\n                label = f\"{tokens[0]} {tokens[1]} {tokens[2]}\"\n        elif isinstance(edgelabel, str):\n            label = edgelabel\n        elif isinstance(edgelabel, dict):\n            label = edgelabel.get(predicate, predicate)\n        elif edgelabel:\n            label = predicate\n        kwargs = self.get_edge_attrs(predicate, attrs=attrs)\n        self.dot.edge(subject, obj, label=label, **kwargs)\n        self.edges.add(key)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_edges","title":"<code>add_edges(self, sources=None, relations=None, edgelabels=None, addnodes=None, addconstructs=None, **attrs)</code>","text":"<p>Adds all relations originating from entities <code>sources</code> who's type are listed in <code>relations</code>.  If <code>sources</code> is None, edges are added between all current nodes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_edges(  # pylint: disable=too-many-arguments\n    self,\n    sources=None,\n    relations=None,\n    edgelabels=None,\n    addnodes=None,\n    addconstructs=None,\n    **attrs,\n):\n    \"\"\"Adds all relations originating from entities `sources` who's type\n    are listed in `relations`.  If `sources` is None, edges are added\n    between all current nodes.\"\"\"\n    if sources is None:\n        sources = self.nodes\n    for source in sources.copy():\n        self.add_source_edges(\n            source,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            **attrs,\n        )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_entities","title":"<code>add_entities(self, entities=None, relations='isA', edgelabels=None, addnodes=False, addconstructs=False, nodeattrs=None, **attrs)</code>","text":"<p>Adds a sequence of entities to the graph.  If <code>entities</code> is None, all classes are added to the graph.</p> <p><code>nodeattrs</code> is a dict mapping node names to are attributes for dedicated nodes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_entities(  # pylint: disable=too-many-arguments\n    self,\n    entities=None,\n    relations=\"isA\",\n    edgelabels=None,\n    addnodes=False,\n    addconstructs=False,\n    nodeattrs=None,\n    **attrs,\n):\n    \"\"\"Adds a sequence of entities to the graph.  If `entities` is None,\n    all classes are added to the graph.\n\n    `nodeattrs` is a dict mapping node names to are attributes for\n    dedicated nodes.\n    \"\"\"\n    if entities is None:\n        entities = self.ontology.classes(imported=self.imported)\n    self.add_nodes(entities, nodeattrs=nodeattrs, **attrs)\n    self.add_edges(\n        relations=relations,\n        edgelabels=edgelabels,\n        addnodes=addnodes,\n        addconstructs=addconstructs,\n        **attrs,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_legend","title":"<code>add_legend(self, relations=None)</code>","text":"<p>Adds legend for specified relations to the graph.</p> <p>If <code>relations</code> is \"all\", the legend will contain all relations that are defined in the style.  By default the legend will only contain relations that are currently included in the graph.</p> <p>Hence, you usually want to call add_legend() as the last method before saving or displaying.</p> <p>Relations with defined style will be bold in legend. Relations that have inherited style from parent relation will not be bold.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_legend(self, relations=None):\n    \"\"\"Adds legend for specified relations to the graph.\n\n    If `relations` is \"all\", the legend will contain all relations\n    that are defined in the style.  By default the legend will\n    only contain relations that are currently included in the\n    graph.\n\n    Hence, you usually want to call add_legend() as the last method\n    before saving or displaying.\n\n    Relations with defined style will be bold in legend.\n    Relations that have inherited style from parent relation\n    will not be bold.\n    \"\"\"\n    rels = self.style.get(\"relations\", {})\n    if relations is None:\n        relations = self.get_relations(sort=True)\n    elif relations == \"all\":\n        relations = [\"isA\"] + list(rels.keys()) + [\"inverse\"]\n    elif isinstance(relations, str):\n        relations = relations.split(\",\")\n\n    nrelations = len(relations)\n    if nrelations == 0:\n        return\n\n    table = (\n        '&lt;&lt;table border=\"0\" cellpadding=\"2\" cellspacing=\"0\" cellborder=\"0\"&gt;'\n    )\n    label1 = [table]\n    label2 = [table]\n    for index, relation in enumerate(relations):\n        if (relation in rels) or (relation == \"isA\"):\n            label1.append(\n                f'&lt;tr&gt;&lt;td align=\"right\" '\n                f'port=\"i{index}\"&gt;&lt;b&gt;{relation}&lt;/b&gt;&lt;/td&gt;&lt;/tr&gt;'\n            )\n        else:\n            label1.append(\n                f'&lt;tr&gt;&lt;td align=\"right\" '\n                f'port=\"i{index}\"&gt;{relation}&lt;/td&gt;&lt;/tr&gt;'\n            )\n        label2.append(f'&lt;tr&gt;&lt;td port=\"i{index}\"&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt;')\n    label1.append(\"&lt;/table&gt;&gt;\")\n    label2.append(\"&lt;/table&gt;&gt;\")\n    self.dot.node(\"key1\", label=\"\\n\".join(label1), shape=\"plaintext\")\n    self.dot.node(\"key2\", label=\"\\n\".join(label2), shape=\"plaintext\")\n\n    rankdir = self.dot.graph_attr.get(\"rankdir\", \"TB\")\n    constraint = \"false\" if rankdir in (\"TB\", \"BT\") else \"true\"\n    inv = rankdir in (\"BT\",)\n\n    for index in range(nrelations):\n        relation = (\n            relations[nrelations - 1 - index] if inv else relations[index]\n        )\n        if relation == \"inverse\":\n            kwargs = self.style.get(\"inverse\", {}).copy()\n        else:\n            kwargs = self.get_edge_attrs(relation, {}).copy()\n        kwargs[\"constraint\"] = constraint\n        with self.dot.subgraph(name=f\"sub{index}\") as subgraph:\n            subgraph.attr(rank=\"same\")\n            if rankdir in (\"BT\", \"LR\"):\n                self.dot.edge(\n                    f\"key1:i{index}:e\", f\"key2:i{index}:w\", **kwargs\n                )\n            else:\n                self.dot.edge(\n                    f\"key2:i{index}:w\", f\"key1:i{index}:e\", **kwargs\n                )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_missing_node","title":"<code>add_missing_node(self, name, addnodes=None)</code>","text":"<p>Checks if <code>name</code> corresponds to a missing node and add it if <code>addnodes</code> is true.</p> <p>Returns true if the node exists or is added, false otherwise.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_missing_node(self, name, addnodes=None):\n    \"\"\"Checks if `name` corresponds to a missing node and add it if\n    `addnodes` is true.\n\n    Returns true if the node exists or is added, false otherwise.\"\"\"\n    addnodes = self.addnodes if addnodes is None else addnodes\n    entity = self.ontology[name] if isinstance(name, str) else name\n    label = get_label(entity)\n    if label not in self.nodes:\n        if addnodes:\n            self.add_node(entity, **self.style.get(\"added_node\", {}))\n        else:\n            return False\n    return True\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_node","title":"<code>add_node(self, name, nodeattrs=None, **attrs)</code>","text":"<p>Add node with given name. <code>attrs</code> are graphviz node attributes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_node(self, name, nodeattrs=None, **attrs):\n    \"\"\"Add node with given name. `attrs` are graphviz node attributes.\"\"\"\n    entity = self.ontology[name] if isinstance(name, str) else name\n    label = get_label(entity)\n    if label not in self.nodes.union(self.excluded_nodes):\n        kwargs = self.get_node_attrs(\n            entity, nodeattrs=nodeattrs, attrs=attrs\n        )\n        if hasattr(entity, \"iri\"):\n            kwargs.setdefault(\"URL\", entity.iri)\n        self.dot.node(label, label=label, **kwargs)\n        self.nodes.add(label)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_nodes","title":"<code>add_nodes(self, names, nodeattrs, **attrs)</code>","text":"<p>Add nodes with given names. <code>attrs</code> are graphviz node attributes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_nodes(self, names, nodeattrs, **attrs):\n    \"\"\"Add nodes with given names. `attrs` are graphviz node attributes.\"\"\"\n    for name in names:\n        self.add_node(name, nodeattrs=nodeattrs, **attrs)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_parents","title":"<code>add_parents(self, name, levels=1, relations='isA', edgelabels=None, addnodes=False, addconstructs=False, **attrs)</code>","text":"<p>Add <code>levels</code> levels of strict parents of entity <code>name</code>.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_parents(  # pylint: disable=too-many-arguments\n    self,\n    name,\n    levels=1,\n    relations=\"isA\",\n    edgelabels=None,\n    addnodes=False,\n    addconstructs=False,\n    **attrs,\n):\n    \"\"\"Add `levels` levels of strict parents of entity `name`.\"\"\"\n\n    def addparents(entity, nodes, parents):\n        if nodes &gt; 0:\n            for parent in entity.get_parents(strict=True):\n                parents.add(parent)\n                addparents(parent, nodes - 1, parents)\n\n    entity = self.ontology[name] if isinstance(name, str) else name\n    parents = set()\n    addparents(entity, levels, parents)\n    self.add_entities(\n        entities=parents,\n        relations=relations,\n        edgelabels=edgelabels,\n        addnodes=addnodes,\n        addconstructs=addconstructs,\n        **attrs,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_source_edges","title":"<code>add_source_edges(self, source, relations=None, edgelabels=None, addnodes=None, addconstructs=None, **attrs)</code>","text":"<p>Adds all relations originating from entity <code>source</code> who's type are listed in <code>relations</code>.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_source_edges(  # pylint: disable=too-many-arguments,too-many-branches\n    self,\n    source,\n    relations=None,\n    edgelabels=None,\n    addnodes=None,\n    addconstructs=None,\n    **attrs,\n):\n    \"\"\"Adds all relations originating from entity `source` who's type\n    are listed in `relations`.\"\"\"\n    if relations is None:\n        relations = self.relations\n    elif isinstance(relations, str):\n        relations = set([relations])\n    else:\n        relations = set(relations)\n\n    edgelabels = self.edgelabels if edgelabels is None else edgelabels\n    addconstructs = (\n        self.addconstructs if addconstructs is None else addconstructs\n    )\n\n    entity = self.ontology[source] if isinstance(source, str) else source\n    label = get_label(entity)\n    for relation in entity.is_a:\n        # isA\n        if isinstance(\n            relation, (owlready2.ThingClass, owlready2.ObjectPropertyClass)\n        ):\n            if \"all\" in relations or \"isA\" in relations:\n                rlabel = get_label(relation)\n                # FIXME - we actually want to include individuals...\n                if isinstance(entity, owlready2.Thing):\n                    continue\n                if relation not in entity.get_parents(strict=True):\n                    continue\n                if not self.add_missing_node(relation, addnodes=addnodes):\n                    continue\n                self.add_edge(\n                    subject=label,\n                    predicate=\"isA\",\n                    obj=rlabel,\n                    edgelabel=edgelabels,\n                    **attrs,\n                )\n\n        # restriction\n        elif isinstance(relation, owlready2.Restriction):\n            rname = get_label(relation.property)\n            if \"all\" in relations or rname in relations:\n                rlabel = f\"{rname} {typenames[relation.type]}\"\n                if isinstance(relation.value, owlready2.ThingClass):\n                    obj = get_label(relation.value)\n                    if not self.add_missing_node(relation.value, addnodes):\n                        continue\n                elif (\n                    isinstance(relation.value, owlready2.ClassConstruct)\n                    and self.addconstructs\n                ):\n                    obj = self.add_class_construct(relation.value)\n                else:\n                    continue\n                pred = asstring(\n                    relation, exclude_object=True, ontology=self.ontology\n                )\n                self.add_edge(\n                    label, pred, obj, edgelabel=edgelabels, **attrs\n                )\n\n        # inverse\n        if isinstance(relation, owlready2.Inverse):\n            if \"all\" in relations or \"inverse\" in relations:\n                rlabel = get_label(relation)\n                if not self.add_missing_node(relation, addnodes=addnodes):\n                    continue\n                if relation not in entity.get_parents(strict=True):\n                    continue\n                self.add_edge(\n                    subject=label,\n                    predicate=\"inverse\",\n                    obj=rlabel,\n                    edgelabel=edgelabels,\n                    **attrs,\n                )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_edge_attrs","title":"<code>get_edge_attrs(self, predicate, attrs)</code>","text":"<p>Returns attributes for node or edge <code>predicate</code>.  <code>attrs</code> overrides the default style.</p> <p>Parameters:</p> Name Type Description Default <code>predicate</code> <code>str</code> <p>predicate to get attributes for</p> required <code>attrs</code> <code>dict</code> <p>desired attributes to override default</p> required Source code in <code>ontopy/graph.py</code> <pre><code>def get_edge_attrs(self, predicate: str, attrs: dict) -&gt; dict:\n    \"\"\"Returns attributes for node or edge `predicate`.  `attrs` overrides\n    the default style.\n\n    Parameters:\n        predicate: predicate to get attributes for\n        attrs: desired attributes to override default\n    \"\"\"\n    # given type\n    types = (\"isA\", \"equivalent_to\", \"disjoint_with\", \"inverse_of\")\n    if predicate in types:\n        kwargs = self.style.get(predicate, {}).copy()\n    else:\n        kwargs = {}\n        name = predicate.split(None, 1)[0]\n        match = re.match(r\"Inverse\\((.*)\\)\", name)\n        if match:\n            (name,) = match.groups()\n            attrs = attrs.copy()\n            for key, value in self.style.get(\"inverse\", {}).items():\n                attrs.setdefault(key, value)\n        if not isinstance(name, str) or name in self.ontology:\n            entity = self.ontology[name] if isinstance(name, str) else name\n            relations = self.style.get(\"relations\", {})\n            rels = set(\n                self.ontology[_] for _ in relations if _ in self.ontology\n            )\n            rattrs = self._relation_styles(entity, relations, rels)\n\n            # object property\n            if isinstance(\n                entity,\n                (owlready2.ObjectPropertyClass, owlready2.ObjectProperty),\n            ):\n                kwargs = self.style.get(\"default_relation\", {}).copy()\n                kwargs.update(rattrs)\n            # data property\n            elif isinstance(\n                entity,\n                (owlready2.DataPropertyClass, owlready2.DataProperty),\n            ):\n                kwargs = self.style.get(\"default_dataprop\", {}).copy()\n                kwargs.update(rattrs)\n            else:\n                raise TypeError(f\"Unknown entity type: {entity!r}\")\n    kwargs.update(self.style.get(\"edges\", {}).get(predicate, {}))\n    kwargs.update(attrs)\n    return kwargs\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_figsize","title":"<code>get_figsize(self)</code>","text":"<p>Returns the default figure size (width, height) in points.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_figsize(self):\n    \"\"\"Returns the default figure size (width, height) in points.\"\"\"\n    with tempfile.TemporaryDirectory() as tmpdir:\n        tmpfile = os.path.join(tmpdir, \"graph.svg\")\n        self.save(tmpfile)\n        xml = ET.parse(tmpfile)\n        svg = xml.getroot()\n        width = svg.attrib[\"width\"]\n        height = svg.attrib[\"height\"]\n        if not width.endswith(\"pt\"):\n            # ensure that units are in points\n            raise ValueError(\n                \"The width attribute should always be given in 'pt', \"\n                f\"but it is: {width}\"\n            )\n\n        def asfloat(string):\n            return float(re.match(r\"^[\\d.]+\", string).group())\n\n    return asfloat(width), asfloat(height)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_node_attrs","title":"<code>get_node_attrs(self, name, nodeattrs, attrs)</code>","text":"<p>Returns attributes for node or edge <code>name</code>.  <code>attrs</code> overrides the default style.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_node_attrs(self, name, nodeattrs, attrs):\n    \"\"\"Returns attributes for node or edge `name`.  `attrs` overrides\n    the default style.\"\"\"\n    entity = self.ontology[name] if isinstance(name, str) else name\n    label = get_label(entity)\n    # class\n    if isinstance(entity, owlready2.ThingClass):\n        if entity.is_defined:\n            kwargs = self.style.get(\"defined_class\", {})\n        else:\n            kwargs = self.style.get(\"class\", {})\n    # class construct\n    elif isinstance(entity, owlready2.ClassConstruct):\n        kwargs = self.style.get(\"class_construct\", {})\n    # individual\n    elif isinstance(entity, owlready2.Thing):\n        kwargs = self.style.get(\"individual\", {})\n    # object property\n    elif isinstance(entity, owlready2.ObjectPropertyClass):\n        kwargs = self.style.get(\"object_property\", {})\n    # data property\n    elif isinstance(entity, owlready2.DataPropertyClass):\n        kwargs = self.style.get(\"data_property\", {})\n    # annotation property\n    elif isinstance(entity, owlready2.AnnotationPropertyClass):\n        kwargs = self.style.get(\"annotation_property\", {})\n    else:\n        raise TypeError(f\"Unknown entity type: {entity!r}\")\n    kwargs = kwargs.copy()\n    kwargs.update(self.style.get(\"nodes\", {}).get(label, {}))\n    if nodeattrs:\n        kwargs.update(nodeattrs.get(label, {}))\n    kwargs.update(attrs)\n    return kwargs\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_relations","title":"<code>get_relations(self, sort=True)</code>","text":"<p>Returns a set of relations in current graph.  If <code>sort</code> is true, a sorted list is returned.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_relations(self, sort=True):\n    \"\"\"Returns a set of relations in current graph.  If `sort` is true,\n    a sorted list is returned.\"\"\"\n    relations = set()\n    for _, predicate, _ in self.edges:\n        if predicate.startswith(\"Inverse\"):\n            relations.add(\"inverse\")\n            match = re.match(r\"Inverse\\((.+)\\)\", predicate)\n            if match is None:\n                raise ValueError(\n                    \"Could unexpectedly not find the inverse relation \"\n                    f\"just added in: {predicate}\"\n                )\n            relations.add(match.groups()[0])\n        else:\n            relations.add(predicate.split(None, 1)[0])\n\n    # Sort, but place 'isA' first and 'inverse' last\n    if sort:\n        start, end = [], []\n        if \"isA\" in relations:\n            relations.remove(\"isA\")\n            start.append(\"isA\")\n        if \"inverse\" in relations:\n            relations.remove(\"inverse\")\n            end.append(\"inverse\")\n        relations = start + sorted(relations) + end\n\n    return relations\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.save","title":"<code>save(self, filename, fmt=None, **kwargs)</code>","text":"<p>Saves graph to <code>filename</code>.  If format is not given, it is inferred from <code>filename</code>.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def save(self, filename, fmt=None, **kwargs):\n    \"\"\"Saves graph to `filename`.  If format is not given, it is\n    inferred from `filename`.\"\"\"\n    base = os.path.splitext(filename)[0]\n    fmt = get_format(filename, default=\"svg\", fmt=fmt)\n    kwargs.setdefault(\"cleanup\", True)\n    if fmt in (\"graphviz\", \"gv\"):\n        if \"dictionary\" in kwargs:\n            self.dot.save(filename, dictionary=kwargs[\"dictionary\"])\n        else:\n            self.dot.save(filename)\n    else:\n        fmt = kwargs.pop(\"format\", fmt)\n        self.dot.render(base, format=fmt, **kwargs)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.view","title":"<code>view(self)</code>","text":"<p>Shows the graph in a viewer.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def view(self):\n    \"\"\"Shows the graph in a viewer.\"\"\"\n    self.dot.view(cleanup=True)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.check_module_dependencies","title":"<code>check_module_dependencies(modules, verbose=True)</code>","text":"<p>Check module dependencies and return a copy of modules with redundant dependencies removed.</p> <p>If <code>verbose</code> is true, warnings are printed for each module that</p> <p>If <code>modules</code> is given, it should be a dict returned by get_module_dependencies().</p> Source code in <code>ontopy/graph.py</code> <pre><code>def check_module_dependencies(modules, verbose=True):\n    \"\"\"Check module dependencies and return a copy of modules with\n    redundant dependencies removed.\n\n    If `verbose` is true, warnings are printed for each module that\n\n    If `modules` is given, it should be a dict returned by\n    get_module_dependencies().\n    \"\"\"\n    visited = set()\n\n    def get_deps(iri, excl=None):\n        \"\"\"Returns a set with all dependencies of `iri`, excluding `excl` and\n        its dependencies.\"\"\"\n        if iri in visited:\n            return set()\n        visited.add(iri)\n        deps = set()\n        for dependency in modules[iri]:\n            if dependency != excl:\n                deps.add(dependency)\n                deps.update(get_deps(dependency))\n        return deps\n\n    mods = {}\n    redundant = []\n    for iri, deps in modules.items():\n        if not deps:\n            mods[iri] = set()\n        for dep in deps:\n            if dep in get_deps(iri, dep):\n                redundant.append((iri, dep))\n            elif iri in mods:\n                mods[iri].add(dep)\n            else:\n                mods[iri] = set([dep])\n\n    if redundant and verbose:\n        print(\"** Warning: Redundant module dependency:\")\n        for iri, dep in redundant:\n            print(f\"{iri} -&gt; {dep}\")\n\n    return mods\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.cytoscape_style","title":"<code>cytoscape_style(style=None)</code>","text":"<p>Get list of color, style and fills.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def cytoscape_style(style=None):  # pylint: disable=too-many-branches\n    \"\"\"Get list of color, style and fills.\"\"\"\n    if not style:\n        style = _default_style\n    colours = {}\n    styles = {}\n    fill = {}\n    for key, value in style.items():\n        if isinstance(value, dict):\n            if \"color\" in value:\n                colours[key] = value[\"color\"]\n            else:\n                colours[key] = \"black\"\n            if \"style\" in value:\n                styles[key] = value[\"style\"]\n            else:\n                styles[key] = \"solid\"\n            if \"arrowhead\" in value:\n                if value[\"arrowhead\"] == \"empty\":\n                    fill[key] = \"hollow\"\n            else:\n                fill[key] = \"filled\"\n\n    for key, value in style.get(\"relations\", {}).items():\n        if isinstance(value, dict):\n            if \"color\" in value:\n                colours[key] = value[\"color\"]\n            else:\n                colours[key] = \"black\"\n            if \"style\" in value:\n                styles[key] = value[\"style\"]\n            else:\n                styles[key] = \"solid\"\n            if \"arrowhead\" in value:\n                if value[\"arrowhead\"] == \"empty\":\n                    fill[key] = \"hollow\"\n            else:\n                fill[key] = \"filled\"\n    return [colours, styles, fill]\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.cytoscapegraph","title":"<code>cytoscapegraph(graph, onto=None, infobox=None, force=False)</code>","text":"<p>Returns and instance of icytoscape-figure for an instance Graph of OntoGraph, the accompanying ontology is required for mouse actions.</p> <p>Parameters:</p> Name Type Description Default <code>graph</code> <code>OntoGraph</code> <p>graph generated with OntoGraph with edgelabels=True.</p> required <code>onto</code> <code>Optional[ontopy.ontology.Ontology]</code> <p>ontology to be used for mouse actions.</p> <code>None</code> <code>infobox</code> <code>str</code> <p>\"left\" or \"right\". Placement of infbox with  respect to graph.</p> <code>None</code> <code>force</code> <code>bool</code> <p>force generate graph without correct edgelabels.</p> <code>False</code> <p>Returns:</p> Type Description <code>GridspecLayout</code> <p>cytoscapewidget with graph and infobox to be visualized in jupyter lab.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def cytoscapegraph(\n    graph: OntoGraph,\n    onto: Optional[Ontology] = None,\n    infobox: str = None,\n    force: bool = False,\n) -&gt; \"GridspecLayout\":\n    # pylint: disable=too-many-locals,too-many-statements\n    \"\"\"Returns and instance of icytoscape-figure for an\n    instance Graph of OntoGraph, the accompanying ontology\n    is required for mouse actions.\n    Args:\n            graph: graph generated with OntoGraph with edgelabels=True.\n            onto: ontology to be used for mouse actions.\n            infobox: \"left\" or \"right\". Placement of infbox with\n                     respect to graph.\n            force: force generate graph without correct edgelabels.\n    Returns:\n            cytoscapewidget with graph and infobox to be visualized\n            in jupyter lab.\n\n    \"\"\"\n    # pylint: disable=import-error,import-outside-toplevel\n    from ipywidgets import Output, VBox, GridspecLayout\n    from IPython.display import display, Image\n    from pathlib import Path\n    import networkx as nx\n    import pydotplus\n    import ipycytoscape\n    from networkx.readwrite.json_graph import cytoscape_data\n\n    # Define the styles, this has to be aligned with the graphviz values\n    dotplus = pydotplus.graph_from_dot_data(graph.dot.source)\n    # if graph doesn't have multiedges, use dotplus.set_strict(true)\n    pydot_graph = nx.nx_pydot.from_pydot(dotplus)\n\n    colours, styles, fill = cytoscape_style()\n\n    data = cytoscape_data(pydot_graph)[\"elements\"]\n    for datum in data[\"edges\"]:\n        try:\n            datum[\"data\"][\"label\"] = (\n                datum[\"data\"][\"label\"].rsplit(\" \", 1)[0].lstrip('\"')\n            )\n        except KeyError as err:\n            if not force:\n                raise EMMOntoPyException(\n                    \"Edge label is not defined. Are you sure that the OntoGraph\"\n                    \"instance you provided was generated with \"\n                    \"\u00b4edgelabels=True\u00b4?\"\n                ) from err\n            warnings.warn(\n                \"ARROWS WILL NOT BE DISPLAYED CORRECTLY. \"\n                \"Edge label is not defined. Are you sure that the OntoGraph \"\n                \"instance you provided was generated with \u00b4edgelabels=True\u00b4?\"\n            )\n            datum[\"data\"][\"label\"] = \"\"\n\n        lab = datum[\"data\"][\"label\"].replace(\"Inverse(\", \"\").rstrip(\")\")\n        try:\n            datum[\"data\"][\"colour\"] = colours[lab]\n        except KeyError:\n            datum[\"data\"][\"colour\"] = \"black\"\n        try:\n            datum[\"data\"][\"style\"] = styles[lab]\n        except KeyError:\n            datum[\"data\"][\"style\"] = \"solid\"\n        if datum[\"data\"][\"label\"].startswith(\"Inverse(\"):\n            datum[\"data\"][\"targetarrow\"] = \"diamond\"\n            datum[\"data\"][\"sourcearrow\"] = \"none\"\n        else:\n            datum[\"data\"][\"targetarrow\"] = \"triangle\"\n            datum[\"data\"][\"sourcearrow\"] = \"none\"\n        try:\n            datum[\"data\"][\"fill\"] = fill[lab]\n        except KeyError:\n            datum[\"data\"][\"fill\"] = \"filled\"\n\n    cytofig = ipycytoscape.CytoscapeWidget()\n    cytofig.graph.add_graph_from_json(data, directed=True)\n\n    cytofig.set_style(\n        [\n            {\n                \"selector\": \"node\",\n                \"css\": {\n                    \"content\": \"data(label)\",\n                    # \"text-valign\": \"center\",\n                    # \"color\": \"white\",\n                    # \"text-outline-width\": 2,\n                    # \"text-outline-color\": \"red\",\n                    \"background-color\": \"blue\",\n                },\n            },\n            {\"selector\": \"node:parent\", \"css\": {\"background-opacity\": 0.333}},\n            {\n                \"selector\": \"edge\",\n                \"style\": {\n                    \"width\": 2,\n                    \"line-color\": \"data(colour)\",\n                    # \"content\": \"data(label)\"\",\n                    \"line-style\": \"data(style)\",\n                },\n            },\n            {\n                \"selector\": \"edge.directed\",\n                \"style\": {\n                    \"curve-style\": \"bezier\",\n                    \"target-arrow-shape\": \"data(targetarrow)\",\n                    \"target-arrow-color\": \"data(colour)\",\n                    \"target-arrow-fill\": \"data(fill)\",\n                    \"mid-source-arrow-shape\": \"data(sourcearrow)\",\n                    \"mid-source-arrow-color\": \"data(colour)\",\n                },\n            },\n            {\n                \"selector\": \"edge.multiple_edges\",\n                \"style\": {\"curve-style\": \"bezier\"},\n            },\n            {\n                \"selector\": \":selected\",\n                \"css\": {\n                    \"background-color\": \"black\",\n                    \"line-color\": \"black\",\n                    \"target-arrow-color\": \"black\",\n                    \"source-arrow-color\": \"black\",\n                    \"text-outline-color\": \"black\",\n                },\n            },\n        ]\n    )\n\n    if onto is not None:\n        out = Output(layout={\"border\": \"1px solid black\"})\n\n        def log_clicks(node):\n            with out:\n                print((onto.get_by_label(node[\"data\"][\"label\"])))\n                parent = onto.get_by_label(node[\"data\"][\"label\"]).get_parents()\n                print(f\"parents: {parent}\")\n                try:\n                    elucidation = onto.get_by_label(\n                        node[\"data\"][\"label\"]\n                    ).elucidation\n                    print(f\"elucidation: {elucidation[0]}\")\n                except (AttributeError, IndexError):\n                    pass\n\n                try:\n                    annotations = onto.get_by_label(\n                        node[\"data\"][\"label\"]\n                    ).annotations\n                    for _ in annotations:\n                        print(f\"annotation: {_}\")\n                except AttributeError:\n                    pass\n\n                # Try does not work...\n                try:\n                    iri = onto.get_by_label(node[\"data\"][\"label\"]).iri\n                    print(f\"iri: {iri}\")\n                except (AttributeError, IndexError):\n                    pass\n                try:\n                    fig = node[\"data\"][\"label\"]\n                    if os.path.exists(Path(fig + \".png\")):\n                        display(Image(fig + \".png\", width=100))\n                    elif os.path.exists(Path(fig + \".jpg\")):\n                        display(Image(fig + \".jpg\", width=100))\n                except (AttributeError, IndexError):\n                    pass\n                out.clear_output(wait=True)\n\n        def log_mouseovers(node):\n            with out:\n                print(onto.get_by_label(node[\"data\"][\"label\"]))\n                # print(f'mouseover: {pformat(node)}')\n            out.clear_output(wait=True)\n\n        cytofig.on(\"node\", \"click\", log_clicks)\n        cytofig.on(\"node\", \"mouseover\", log_mouseovers)  # , remove=True)\n        cytofig.on(\"node\", \"mouseout\", out.clear_output(wait=True))\n        grid = GridspecLayout(1, 3, height=\"400px\")\n        if infobox == \"left\":\n            grid[0, 0] = out\n            grid[0, 1:] = cytofig\n        elif infobox == \"right\":\n            grid[0, 0:-1] = cytofig\n            grid[0, 2] = out\n        else:\n            return VBox([cytofig, out])\n        return grid\n\n    return cytofig\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.filter_classes","title":"<code>filter_classes(classes, included_namespaces=(), included_ontologies=())</code>","text":"<p>Filter out classes whos namespace is not in <code>included_namespaces</code> or whos ontology name is not in one of the ontologies in <code>included_ontologies</code>.</p> <p><code>classes</code> should be a sequence of classes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def filter_classes(classes, included_namespaces=(), included_ontologies=()):\n    \"\"\"Filter out classes whos namespace is not in `included_namespaces`\n    or whos ontology name is not in one of the ontologies in\n    `included_ontologies`.\n\n    `classes` should be a sequence of classes.\n    \"\"\"\n    filtered = set(classes)\n    if included_namespaces:\n        filtered = set(\n            c for c in filtered if c.namespace.name in included_namespaces\n        )\n    if included_ontologies:\n        filtered = set(\n            c\n            for c in filtered\n            if c.namespace.ontology.name in included_ontologies\n        )\n    return filtered\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.get_module_dependencies","title":"<code>get_module_dependencies(iri_or_onto, strip_base=None)</code>","text":"<p>Reads <code>iri_or_onto</code> and returns a dict mapping ontology names to a list of ontologies that they depends on.</p> <p>If <code>strip_base</code> is true, the base IRI is stripped from ontology names.  If it is a string, it lstrip'ped from the base iri.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_module_dependencies(iri_or_onto, strip_base=None):\n    \"\"\"Reads `iri_or_onto` and returns a dict mapping ontology names to a\n    list of ontologies that they depends on.\n\n    If `strip_base` is true, the base IRI is stripped from ontology\n    names.  If it is a string, it lstrip'ped from the base iri.\n    \"\"\"\n    from ontopy.ontology import (  # pylint: disable=import-outside-toplevel\n        get_ontology,\n    )\n\n    if isinstance(iri_or_onto, str):\n        onto = get_ontology(iri_or_onto)\n        onto.load()\n    else:\n        onto = iri_or_onto\n\n    modules = {onto.base_iri: set()}\n\n    def strip(base_iri):\n        if isinstance(strip_base, str):\n            return base_iri.lstrip(strip_base)\n        if strip_base:\n            return base_iri.strip(onto.base_iri)\n        return base_iri\n\n    visited = set()\n\n    def setmodules(onto):\n        for imported_onto in onto.imported_ontologies:\n            if onto.base_iri in modules:\n                modules[strip(onto.base_iri)].add(strip(imported_onto.base_iri))\n            else:\n                modules[strip(onto.base_iri)] = set(\n                    [strip(imported_onto.base_iri)]\n                )\n            if imported_onto.base_iri not in modules:\n                modules[strip(imported_onto.base_iri)] = set()\n            if imported_onto not in visited:\n                visited.add(imported_onto)\n                setmodules(imported_onto)\n\n    setmodules(onto)\n    return modules\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.plot_modules","title":"<code>plot_modules(src, filename=None, fmt=None, show=False, strip_base=None, ignore_redundant=True)</code>","text":"<p>Plot module dependency graph for <code>src</code> and return a graph object.</p> <p>Here <code>src</code> may be an IRI, a path the the ontology or a dict returned by get_module_dependencies().</p> <p>If <code>filename</code> is given, write the graph to this file.</p> <p>If <code>fmt</code> is None, the output format is inferred from <code>filename</code>.</p> <p>If <code>show</code> is true, the graph is displayed.</p> <p><code>strip_base</code> is passed on to get_module_dependencies() if <code>src</code> is not a dict.</p> <p>If <code>ignore_redundant</code> is true, redundant dependencies are not plotted.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def plot_modules(  # pylint: disable=too-many-arguments\n    src,\n    filename=None,\n    fmt=None,\n    show=False,\n    strip_base=None,\n    ignore_redundant=True,\n):\n    \"\"\"Plot module dependency graph for `src` and return a graph object.\n\n    Here `src` may be an IRI, a path the the ontology or a dict returned by\n    get_module_dependencies().\n\n    If `filename` is given, write the graph to this file.\n\n    If `fmt` is None, the output format is inferred from `filename`.\n\n    If `show` is true, the graph is displayed.\n\n    `strip_base` is passed on to get_module_dependencies() if `src` is not\n    a dict.\n\n    If `ignore_redundant` is true, redundant dependencies are not plotted.\n    \"\"\"\n    if isinstance(src, dict):\n        modules = src\n    else:\n        modules = get_module_dependencies(src, strip_base=strip_base)\n\n    if ignore_redundant:\n        modules = check_module_dependencies(modules, verbose=False)\n\n    dot = graphviz.Digraph(comment=\"Module dependencies\")\n    dot.attr(rankdir=\"TB\")\n    dot.node_attr.update(\n        style=\"filled\", fillcolor=\"lightblue\", shape=\"box\", edgecolor=\"blue\"\n    )\n    dot.edge_attr.update(arrowtail=\"open\", dir=\"back\")\n\n    for iri in modules.keys():\n        iriname = iri.split(\":\", 1)[1]\n        dot.node(iriname, label=iri, URL=iri)\n\n    for iri, deps in modules.items():\n        for dep in deps:\n            iriname = iri.split(\":\", 1)[1]\n            depname = dep.split(\":\", 1)[1]\n            dot.edge(depname, iriname)\n\n    if filename:\n        base, ext = os.path.splitext(filename)\n        if fmt is None:\n            fmt = ext.lstrip(\".\")\n        dot.render(base, format=fmt, view=False, cleanup=True)\n\n    if show:\n        dot.view(cleanup=True)\n\n    return dot\n</code></pre>"},{"location":"api_reference/ontopy/manchester/","title":"manchester","text":"<p>Evaluate Manchester syntax</p> <p>This module compiles restrictions and logical constructs in Manchester syntax into Owlready2 classes. The main function in this module is <code>manchester.evaluate()</code>, see its docstring for usage example.</p> <p>Pyparsing is used under the hood for parsing.</p>"},{"location":"api_reference/ontopy/manchester/#ontopy.manchester.ManchesterError","title":"<code> ManchesterError            (EMMOntoPyException)         </code>","text":"<p>Raised on invalid Manchester notation.</p> Source code in <code>ontopy/manchester.py</code> <pre><code>class ManchesterError(EMMOntoPyException):\n    \"\"\"Raised on invalid Manchester notation.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/manchester/#ontopy.manchester.evaluate","title":"<code>evaluate(ontology, expr)</code>","text":"<p>Evaluate expression in Manchester syntax.</p> <p>Parameters:</p> Name Type Description Default <code>ontology</code> <code>Ontology</code> <p>The ontology within which the expression will be evaluated.</p> required <code>expr</code> <code>str</code> <p>Manchester expression to be evaluated.</p> required <p>Returns:</p> Type Description <code>Construct</code> <p>An Owlready2 construct that corresponds to the expression.</p> <p>Examples:</p> <p>from ontopy.manchester import evaluate from ontopy import get_ontology emmo = get_ontology().load()</p> <p>restriction = evaluate(emmo, 'hasPart some Atom') cls = evaluate(emmo, 'Atom') expr = evaluate(emmo, 'Atom or Molecule')</p> <p>Note</p> <p>Logical expressions (with <code>not</code>, <code>and</code> and <code>or</code>) are supported as well as object property restrictions.  For data properterties are only value restrictions supported so far.</p> Source code in <code>ontopy/manchester.py</code> <pre><code>def evaluate(ontology: owlready2.Ontology, expr: str) -&gt; owlready2.Construct:\n    \"\"\"Evaluate expression in Manchester syntax.\n\n    Args:\n        ontology: The ontology within which the expression will be evaluated.\n        expr: Manchester expression to be evaluated.\n\n    Returns:\n        An Owlready2 construct that corresponds to the expression.\n\n    Example:\n    &gt;&gt;&gt; from ontopy.manchester import evaluate\n    &gt;&gt;&gt; from ontopy import get_ontology\n    &gt;&gt;&gt; emmo = get_ontology().load()\n\n    &gt;&gt;&gt; restriction = evaluate(emmo, 'hasPart some Atom')\n    &gt;&gt;&gt; cls = evaluate(emmo, 'Atom')\n    &gt;&gt;&gt; expr = evaluate(emmo, 'Atom or Molecule')\n\n    Note:\n        Logical expressions (with `not`, `and` and `or`) are supported as\n        well as object property restrictions.  For data properterties are\n        only value restrictions supported so far.\n    \"\"\"\n\n    # pylint: disable=invalid-name\n    def _parse_literal(r):\n        \"\"\"Compiles literal to Owlready2 type.\"\"\"\n        if r.language:\n            v = owlready2.locstr(r.string, r.language)\n        elif r.number:\n            v = r.number\n        else:\n            v = r.string\n        return v\n\n    # pylint: disable=invalid-name,no-else-return,too-many-return-statements\n    # pylint: disable=too-many-branches\n    def _eval(r):\n        \"\"\"Recursively evaluate expression produced by pyparsing into an\n        Owlready2 construct.\"\"\"\n\n        def fneg(x):\n            \"\"\"Negates the argument if `neg` is true.\"\"\"\n            return owlready2.Not(x) if neg else x\n\n        if isinstance(r, str):  # r is atomic, returns its owlready2 repr\n            return ontology[r]\n        neg = False  # whether the expression starts with \"not\"\n        while r[0] == \"not\":\n            r.pop(0)  # strip off the \"not\" and proceed\n            neg = not neg\n\n        if len(r) == 1:  # r is either a atomic or a parenthesised\n            # subexpression that should be further evaluated\n            if isinstance(r[0], str):\n                return fneg(ontology[r[0]])\n            else:\n                return fneg(_eval(r[0]))\n        elif r.op:  # r contains a logical operator: and/or\n            ops = {\"and\": owlready2.And, \"or\": owlready2.Or}\n            op = ops[r.op]\n            if len(r) == 3:\n                return op([fneg(_eval(r[0])), _eval(r[2])])\n            else:\n                arg1 = fneg(_eval(r[0]))\n                r.pop(0)\n                r.pop(0)\n                return op([arg1, _eval(r)])\n        elif r.objProp:  # r is a restriction\n            if r[0] == \"inverse\":\n                r.pop(0)\n                prop = owlready2.Inverse(ontology[r[0]])\n            else:\n                prop = ontology[r[0]]\n            rtype = r[1]\n            if rtype == \"Self\":\n                return fneg(prop.has_self())\n            r.pop(0)\n            r.pop(0)\n            f = getattr(prop, rtype)\n            if rtype == \"value\":\n                return fneg(f(_eval(r)))\n            elif rtype in (\"some\", \"only\"):\n                return fneg(f(_eval(r)))\n            elif rtype in (\"min\", \"max\", \"exactly\"):\n                cardinality = r.pop(0)\n                return fneg(f(cardinality, _eval(r)))\n            else:\n                raise ManchesterError(f\"invalid restriction type: {rtype}\")\n        elif r.dataProp:  # r is a data property restriction\n            prop = ontology[r[0]]\n            rtype = r[1]\n            r.pop(0)\n            r.pop(0)\n            f = getattr(prop, rtype)\n            if rtype == \"value\":\n                return f(_parse_literal(r))\n            else:\n                raise ManchesterError(\n                    f\"unimplemented data property restriction: \"\n                    f\"{prop} {rtype} {r}\"\n                )\n        else:\n            raise ManchesterError(f\"invalid expression: {r}\")\n\n    grammar = manchester_expression()\n    return _eval(grammar.parseString(expr, parseAll=True))\n</code></pre>"},{"location":"api_reference/ontopy/manchester/#ontopy.manchester.manchester_expression","title":"<code>manchester_expression()</code>","text":"<p>Returns pyparsing grammar for a Manchester expression.</p> <p>This function is mostly for internal use.</p> <p>See also: https://www.w3.org/TR/owl2-manchester-syntax/</p> Source code in <code>ontopy/manchester.py</code> <pre><code>def manchester_expression():\n    \"\"\"Returns pyparsing grammar for a Manchester expression.\n\n    This function is mostly for internal use.\n\n    See also: https://www.w3.org/TR/owl2-manchester-syntax/\n    \"\"\"\n    # pylint: disable=global-statement,invalid-name,too-many-locals\n    global GRAMMAR\n    if GRAMMAR:\n        return GRAMMAR\n\n    # Subset of the Manchester grammar for expressions\n    # It is based on https://www.w3.org/TR/owl2-manchester-syntax/\n    # but allows logical constructs within restrictions (like Protege)\n    ident = pp.Word(pp.alphas + \"_:-\", pp.alphanums + \"_:-\", asKeyword=True)\n    uint = pp.Word(pp.nums)\n    alphas = pp.Word(pp.alphas)\n    string = pp.Word(pp.alphanums + \":\")\n    quotedString = (\n        pp.QuotedString('\"\"\"', multiline=True) | pp.QuotedString('\"')\n    )(\"string\")\n    typedLiteral = pp.Combine(quotedString + \"^^\" + string(\"datatype\"))\n    stringLanguageLiteral = pp.Combine(quotedString + \"@\" + alphas(\"language\"))\n    stringLiteral = quotedString\n    numberLiteral = pp.pyparsing_common.number(\"number\")\n    literal = (\n        typedLiteral | stringLanguageLiteral | stringLiteral | numberLiteral\n    )\n    logOp = pp.one_of([\"and\", \"or\"], asKeyword=True)\n    expr = pp.Forward()\n    restriction = pp.Forward()\n    primary = pp.Keyword(\"not\")[...] + (\n        restriction | ident(\"cls\") | pp.nested_expr(\"(\", \")\", expr)\n    )\n    objPropExpr = (\n        pp.Literal(\"inverse\")\n        + pp.Suppress(\"(\")\n        + ident(\"objProp\")\n        + pp.Suppress(\")\")\n        | pp.Literal(\"inverse\") + ident(\"objProp\")\n        | ident(\"objProp\")\n    )\n    dataPropExpr = ident(\"dataProp\")\n    restriction &lt;&lt;= (\n        objPropExpr + pp.Keyword(\"some\") + expr\n        | objPropExpr + pp.Keyword(\"only\") + expr\n        | objPropExpr + pp.Keyword(\"Self\")\n        | objPropExpr + pp.Keyword(\"value\") + ident(\"individual\")\n        | objPropExpr + pp.Keyword(\"min\") + uint + expr\n        | objPropExpr + pp.Keyword(\"max\") + uint + expr\n        | objPropExpr + pp.Keyword(\"exactly\") + uint + expr\n        | dataPropExpr + pp.Keyword(\"value\") + literal\n    )\n    expr &lt;&lt;= primary + (logOp(\"op\") + expr)[...]\n\n    GRAMMAR = expr\n    return expr\n</code></pre>"},{"location":"api_reference/ontopy/nadict/","title":"nadict","text":"<p>A nested dict with both attribute and item access.</p> <p>NA stands for Nested and Attribute.</p>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict","title":"<code> NADict        </code>","text":"<p>A nested dict with both attribute and item access.</p> <p>It is intended to be used with keys that are valid Python identifiers.  However, except for string keys containing a dot, there are actually no hard limitations.  If a key equals an existing attribute name, attribute access is of cause not possible.</p> <p>Nested items can be accessed via a dot notation, as shown in the example below.</p>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict--examples","title":"Examples","text":"<p>n = NADict(a=1, b=NADict(c=3, d=4)) n['a'] 1 n.a 1 n['b.c'] 3 n.b.c 3 n['b.e'] = 5 n.b.e 5</p>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict--attributes","title":"Attributes","text":"<p>_dict : dict     Dictionary holding the actial items.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>class NADict:\n    \"\"\"A nested dict with both attribute and item access.\n\n    It is intended to be used with keys that are valid Python\n    identifiers.  However, except for string keys containing a dot,\n    there are actually no hard limitations.  If a key equals an existing\n    attribute name, attribute access is of cause not possible.\n\n    Nested items can be accessed via a dot notation, as shown in the\n    example below.\n\n    Examples\n    --------\n    &gt;&gt;&gt; n = NADict(a=1, b=NADict(c=3, d=4))\n    &gt;&gt;&gt; n['a']\n    1\n    &gt;&gt;&gt; n.a\n    1\n    &gt;&gt;&gt; n['b.c']\n    3\n    &gt;&gt;&gt; n.b.c\n    3\n    &gt;&gt;&gt; n['b.e'] = 5\n    &gt;&gt;&gt; n.b.e\n    5\n\n    Attributes\n    ----------\n    _dict : dict\n        Dictionary holding the actial items.\n    \"\"\"\n\n    def __init__(self, *args, **kw):\n        object.__setattr__(self, \"_dict\", {})\n        self.update(*args, **kw)\n\n    def __getitem__(self, key):\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1][key2]\n        return self._dict[key]\n\n    def __setitem__(self, key, value):\n        if key in (\n            \"clear\",\n            \"copy\",\n            \"fromkeys\",\n            \"get\",\n            \"items\",\n            \"keys\",\n            \"pop\",\n            \"popitem\",\n            \"setdefault\",\n            \"update\",\n            \"values\",\n        ):\n            raise ValueError(\n                f\"invalid key {key!r}: must not override supported dict method\"\n                \" names\"\n            )\n\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            if key1 not in self._dict:\n                self._dict[key1] = NADict()\n            self._dict[key1][key2] = value\n        elif key in self._dict:\n            if isinstance(self._dict[key], NADict):\n                self._dict[key].update(value)\n            else:\n                self._dict[key] = value\n        else:\n            if isinstance(value, Mapping):\n                self._dict[key] = NADict(value)\n            else:\n                self._dict[key] = value\n\n    def __delitem__(self, key):\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            del self._dict[key1][key2]\n        else:\n            del self._dict[key]\n\n    def __getattr__(self, key):\n        if key not in self._dict:\n            raise AttributeError(f\"No such key: {key}\")\n        return self._dict[key]\n\n    def __setattr__(self, key, value):\n        if key in self._dict:\n            self._dict[key] = value\n        else:\n            object.__setattr__(self, key, value)\n\n    def __delattr__(self, key):\n        if key in self._dict:\n            del self._dict[key]\n        else:\n            object.__delattr__(self, key)\n\n    def __len__(self):\n        return len(self._dict)\n\n    def __contains__(self, key):\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return key2 in self._dict[key1]\n        return key in self._dict\n\n    def __iter__(self, prefix=\"\"):\n        for key, value in self._dict.items():\n            key = f\"{prefix}.{key}\" if prefix else key\n            if isinstance(value, NADict):\n                yield from value.__iter__(key)\n            else:\n                yield key\n\n    def __repr__(self):\n        return (\n            f\"{self.__class__.__name__}(\"\n            f\"{', '.join(f'{key}={value!r}' for key, value in self._dict.items())})\"  # pylint: disable=line-too-long\n        )\n\n    def clear(self):\n        \"\"\"Clear all keys.\"\"\"\n        self._dict.clear()\n\n    def copy(self):\n        \"\"\"Returns a deep copy of self.\"\"\"\n        return copy.deepcopy(self)\n\n    @staticmethod\n    def fromkeys(iterable, value=None):\n        \"\"\"Returns a new NADict with keys from `iterable` and values\n        set to `value`.\"\"\"\n        res = NADict()\n        for key in iterable:\n            res[key] = value\n        return res\n\n    def get(self, key, default=None):\n        \"\"\"Returns the value for `key` if `key` is in self, else return\n        `default`.\"\"\"\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1].get(key2, default)\n        return self._dict.get(key, default)\n\n    def items(self, prefix=\"\"):\n        \"\"\"Returns an iterator over all items as (key, value) pairs.\"\"\"\n        for key, value in self._dict.items():\n            key = f\"{prefix}.{key}\" if prefix else key\n            if isinstance(value, NADict):\n                yield from value.items(key)\n            else:\n                yield (key, value)\n\n    def keys(self, prefix=\"\"):\n        \"\"\"Returns an iterator over all keys.\"\"\"\n        for key, value in self._dict.items():\n            key = f\"{prefix}.{key}\" if prefix else key\n            if isinstance(value, NADict):\n                yield from value.keys(key)\n            else:\n                yield key\n\n    def pop(self, key, default=None):\n        \"\"\"Removed `key` and returns corresponding value.  If `key` is not\n        found, `default` is returned if given, otherwise KeyError is\n        raised.\"\"\"\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1].pop(key2, default)\n        return self._dict.pop(key, default)\n\n    def popitem(self, prefix=\"\"):\n        \"\"\"Removes and returns some (key, value). Raises KeyError if empty.\"\"\"\n        item = self._dict.popitem()\n        if isinstance(item, NADict):\n            key, value = item\n            item2 = item.popitem(key)\n            self._dict[key] = value\n            return item2\n        key, value = self._dict.popitem()\n        key = f\"{prefix}.{key}\" if prefix else key\n        return (key, value)\n\n    def setdefault(self, key, value=None):\n        \"\"\"Inserts `key` and `value` pair if key is not found.\n\n        Returns the new value for `key`.\"\"\"\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1].setdefault(key2, value)\n        return self._dict.setdefault(key, value)\n\n    def update(self, *args, **kwargs):\n        \"\"\"Updates self with dict/iterable from `args` and keyword arguments\n        from `kw`.\"\"\"\n        for arg in args:\n            if hasattr(arg, \"keys\"):\n                for _ in arg:\n                    self[_] = arg[_]\n            else:\n                for key, value in arg:\n                    self[key] = value\n        for key, value in kwargs.items():\n            self[key] = value\n\n    def values(self):\n        \"\"\"Returns a set-like providing a view of all style values.\"\"\"\n        return self._dict.values()\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.clear","title":"<code>clear(self)</code>","text":"<p>Clear all keys.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def clear(self):\n    \"\"\"Clear all keys.\"\"\"\n    self._dict.clear()\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.copy","title":"<code>copy(self)</code>","text":"<p>Returns a deep copy of self.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def copy(self):\n    \"\"\"Returns a deep copy of self.\"\"\"\n    return copy.deepcopy(self)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.fromkeys","title":"<code>fromkeys(iterable, value=None)</code>  <code>staticmethod</code>","text":"<p>Returns a new NADict with keys from <code>iterable</code> and values set to <code>value</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>@staticmethod\ndef fromkeys(iterable, value=None):\n    \"\"\"Returns a new NADict with keys from `iterable` and values\n    set to `value`.\"\"\"\n    res = NADict()\n    for key in iterable:\n        res[key] = value\n    return res\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.get","title":"<code>get(self, key, default=None)</code>","text":"<p>Returns the value for <code>key</code> if <code>key</code> is in self, else return <code>default</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def get(self, key, default=None):\n    \"\"\"Returns the value for `key` if `key` is in self, else return\n    `default`.\"\"\"\n    if \".\" in key:\n        key1, key2 = key.split(\".\", 1)\n        return self._dict[key1].get(key2, default)\n    return self._dict.get(key, default)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.items","title":"<code>items(self, prefix='')</code>","text":"<p>Returns an iterator over all items as (key, value) pairs.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def items(self, prefix=\"\"):\n    \"\"\"Returns an iterator over all items as (key, value) pairs.\"\"\"\n    for key, value in self._dict.items():\n        key = f\"{prefix}.{key}\" if prefix else key\n        if isinstance(value, NADict):\n            yield from value.items(key)\n        else:\n            yield (key, value)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.keys","title":"<code>keys(self, prefix='')</code>","text":"<p>Returns an iterator over all keys.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def keys(self, prefix=\"\"):\n    \"\"\"Returns an iterator over all keys.\"\"\"\n    for key, value in self._dict.items():\n        key = f\"{prefix}.{key}\" if prefix else key\n        if isinstance(value, NADict):\n            yield from value.keys(key)\n        else:\n            yield key\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.pop","title":"<code>pop(self, key, default=None)</code>","text":"<p>Removed <code>key</code> and returns corresponding value.  If <code>key</code> is not found, <code>default</code> is returned if given, otherwise KeyError is raised.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def pop(self, key, default=None):\n    \"\"\"Removed `key` and returns corresponding value.  If `key` is not\n    found, `default` is returned if given, otherwise KeyError is\n    raised.\"\"\"\n    if \".\" in key:\n        key1, key2 = key.split(\".\", 1)\n        return self._dict[key1].pop(key2, default)\n    return self._dict.pop(key, default)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.popitem","title":"<code>popitem(self, prefix='')</code>","text":"<p>Removes and returns some (key, value). Raises KeyError if empty.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def popitem(self, prefix=\"\"):\n    \"\"\"Removes and returns some (key, value). Raises KeyError if empty.\"\"\"\n    item = self._dict.popitem()\n    if isinstance(item, NADict):\n        key, value = item\n        item2 = item.popitem(key)\n        self._dict[key] = value\n        return item2\n    key, value = self._dict.popitem()\n    key = f\"{prefix}.{key}\" if prefix else key\n    return (key, value)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.setdefault","title":"<code>setdefault(self, key, value=None)</code>","text":"<p>Inserts <code>key</code> and <code>value</code> pair if key is not found.</p> <p>Returns the new value for <code>key</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def setdefault(self, key, value=None):\n    \"\"\"Inserts `key` and `value` pair if key is not found.\n\n    Returns the new value for `key`.\"\"\"\n    if \".\" in key:\n        key1, key2 = key.split(\".\", 1)\n        return self._dict[key1].setdefault(key2, value)\n    return self._dict.setdefault(key, value)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.update","title":"<code>update(self, *args, **kwargs)</code>","text":"<p>Updates self with dict/iterable from <code>args</code> and keyword arguments from <code>kw</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def update(self, *args, **kwargs):\n    \"\"\"Updates self with dict/iterable from `args` and keyword arguments\n    from `kw`.\"\"\"\n    for arg in args:\n        if hasattr(arg, \"keys\"):\n            for _ in arg:\n                self[_] = arg[_]\n        else:\n            for key, value in arg:\n                self[key] = value\n    for key, value in kwargs.items():\n        self[key] = value\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.values","title":"<code>values(self)</code>","text":"<p>Returns a set-like providing a view of all style values.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def values(self):\n    \"\"\"Returns a set-like providing a view of all style values.\"\"\"\n    return self._dict.values()\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/","title":"ontodoc","text":"<p>A module for documenting ontologies.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.AttributeDict","title":"<code> AttributeDict            (dict)         </code>","text":"<p>A dict with attribute access.</p> <p>Note that methods like key() and update() may be overridden.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class AttributeDict(dict):\n    \"\"\"A dict with attribute access.\n\n    Note that methods like key() and update() may be overridden.\"\"\"\n\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.__dict__ = self\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP","title":"<code> DocPP        </code>","text":"<p>Documentation pre-processor.</p> <p>It supports the following features:</p> <ul> <li> <p>Comment lines</p> <pre><code>%% Comment line...\n</code></pre> </li> <li> <p>Insert header with given level</p> <pre><code>%HEADER label [level=1]\n</code></pre> </li> <li> <p>Insert figure with optional caption and width. <code>filepath</code>     should be relative to <code>basedir</code>.  If width is 0, no width will     be specified.</p> <pre><code>%FIGURE filepath [caption='' width=0px]\n</code></pre> </li> <li> <p>Include other markdown files.  Header levels may be up or down with     <code>shift</code></p> <pre><code>%INCLUDE filepath [shift=0]\n</code></pre> </li> <li> <p>Insert generated documentation for ontology entity.  The header     level may be set with <code>header_level</code>.</p> <pre><code>%ENTITY name [header_level=3]\n</code></pre> </li> <li> <p>Insert generated documentation for ontology branch <code>name</code>.  Options:</p> <ul> <li>header_level: Header level.</li> <li>terminated: Whether to branch should be terminated at all branch     names in the final document.</li> <li> <p>include_leaves: Whether to include leaves as end points     to the branch.</p> <p>%BRANCH name [header_level=3 terminated=1 include_leaves=0               namespaces='' ontologies='']</p> </li> </ul> </li> <li> <p>Insert generated figure of ontology branch <code>name</code>.  The figure     is written to <code>path</code>.  The default path is <code>figdir</code>/<code>name</code>,     where <code>figdir</code> is given at class initiation. It is recommended     to exclude the file extension from <code>path</code>.  In this case, the     default figformat will be used (and easily adjusted to the     correct format required by the backend). <code>leaves</code> may be a comma-     separated list of leaf node names.</p> <pre><code>%BRANCHFIG name [path='' caption='' terminated=1 include_leaves=1\n                 strict_leaves=1, width=0px leaves='' relations=all\n                 edgelabels=0 namespaces='' ontologies='']\n</code></pre> </li> <li> <p>This is a combination of the %HEADER and %BRANCHFIG directives.</p> <pre><code>%BRANCHHEAD name [level=2  path='' caption='' terminated=1\n                  include_leaves=1 width=0px leaves='']\n</code></pre> </li> <li> <p>This is a combination of the %HEADER, %BRANCHFIG and %BRANCH     directives. It inserts documentation of branch <code>name</code>, with a     header followed by a figure and then documentation of each     element.</p> <pre><code>%BRANCHDOC name [level=2  path='' title='' caption='' terminated=1\n                 strict_leaves=1 width=0px leaves='' relations='all'\n                 rankdir='BT' legend=1 namespaces='' ontologies='']\n</code></pre> </li> <li> <p>Insert generated documentation for all entities of the given type.     Valid values of <code>type</code> are: \"classes\", \"individuals\",     \"object_properties\", \"data_properties\", \"annotations_properties\"</p> <pre><code>%ALL type [header_level=3, namespaces='', ontologies='']\n</code></pre> </li> <li> <p>Insert generated figure of all entities of the given type.     Valid values of <code>type</code> are: \"classes\", \"object_properties\" and     \"data_properties\".</p> <pre><code>%ALLFIG type\n</code></pre> </li> </ul>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP--parameters","title":"Parameters","text":"<p>template : str     Input template. ontodoc : OntoDoc instance     Instance of OntoDoc basedir : str     Base directory for including relative file paths. figdir : str     Default directory to store generated figures. figformat : str     Default format for generated figures. figscale : float     Default scaling of generated figures. maxwidth : float     Maximum figure width.  Figures larger than this will be rescaled. imported : bool     Whether to include imported entities.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class DocPP:  # pylint: disable=too-many-instance-attributes\n    \"\"\"Documentation pre-processor.\n\n    It supports the following features:\n\n      * Comment lines\n\n            %% Comment line...\n\n      * Insert header with given level\n\n            %HEADER label [level=1]\n\n      * Insert figure with optional caption and width. `filepath`\n        should be relative to `basedir`.  If width is 0, no width will\n        be specified.\n\n            %FIGURE filepath [caption='' width=0px]\n\n      * Include other markdown files.  Header levels may be up or down with\n        `shift`\n\n            %INCLUDE filepath [shift=0]\n\n      * Insert generated documentation for ontology entity.  The header\n        level may be set with `header_level`.\n\n            %ENTITY name [header_level=3]\n\n      * Insert generated documentation for ontology branch `name`.  Options:\n          - header_level: Header level.\n          - terminated: Whether to branch should be terminated at all branch\n            names in the final document.\n          - include_leaves: Whether to include leaves as end points\n            to the branch.\n\n            %BRANCH name [header_level=3 terminated=1 include_leaves=0\n                          namespaces='' ontologies='']\n\n      * Insert generated figure of ontology branch `name`.  The figure\n        is written to `path`.  The default path is `figdir`/`name`,\n        where `figdir` is given at class initiation. It is recommended\n        to exclude the file extension from `path`.  In this case, the\n        default figformat will be used (and easily adjusted to the\n        correct format required by the backend). `leaves` may be a comma-\n        separated list of leaf node names.\n\n            %BRANCHFIG name [path='' caption='' terminated=1 include_leaves=1\n                             strict_leaves=1, width=0px leaves='' relations=all\n                             edgelabels=0 namespaces='' ontologies='']\n\n      * This is a combination of the %HEADER and %BRANCHFIG directives.\n\n            %BRANCHHEAD name [level=2  path='' caption='' terminated=1\n                              include_leaves=1 width=0px leaves='']\n\n      * This is a combination of the %HEADER, %BRANCHFIG and %BRANCH\n        directives. It inserts documentation of branch `name`, with a\n        header followed by a figure and then documentation of each\n        element.\n\n            %BRANCHDOC name [level=2  path='' title='' caption='' terminated=1\n                             strict_leaves=1 width=0px leaves='' relations='all'\n                             rankdir='BT' legend=1 namespaces='' ontologies='']\n\n      * Insert generated documentation for all entities of the given type.\n        Valid values of `type` are: \"classes\", \"individuals\",\n        \"object_properties\", \"data_properties\", \"annotations_properties\"\n\n            %ALL type [header_level=3, namespaces='', ontologies='']\n\n      * Insert generated figure of all entities of the given type.\n        Valid values of `type` are: \"classes\", \"object_properties\" and\n        \"data_properties\".\n\n            %ALLFIG type\n\n    Parameters\n    ----------\n    template : str\n        Input template.\n    ontodoc : OntoDoc instance\n        Instance of OntoDoc\n    basedir : str\n        Base directory for including relative file paths.\n    figdir : str\n        Default directory to store generated figures.\n    figformat : str\n        Default format for generated figures.\n    figscale : float\n        Default scaling of generated figures.\n    maxwidth : float\n        Maximum figure width.  Figures larger than this will be rescaled.\n    imported : bool\n        Whether to include imported entities.\n    \"\"\"\n\n    # FIXME - this class should be refractured:\n    #   * Instead of rescan the entire document for each pre-processer\n    #     directive, we should scan the source like by line and handle\n    #     each directive as they occour.\n    #   * The current implementation has a lot of dublicated code.\n    #   * Instead of modifying the source in-place, we should copy to a\n    #     result list. This will make good error reporting much easier.\n    #   * Branch leaves are only looked up in the file witht the %BRANCH\n    #     directive, not in all included files as expedted.\n\n    def __init__(  # pylint: disable=too-many-arguments\n        self,\n        template,\n        ontodoc,\n        basedir=\".\",\n        figdir=\"genfigs\",\n        figformat=\"png\",\n        figscale=1.0,\n        maxwidth=None,\n        imported=False,\n    ):\n        self.lines = template.split(\"\\n\")\n        self.ontodoc = ontodoc\n        self.basedir = basedir\n        self.figdir = os.path.join(basedir, figdir)\n        self.figformat = figformat\n        self.figscale = figscale\n        self.maxwidth = maxwidth\n        self.imported = imported\n        self._branch_cache = None\n        self._processed = False  # Whether process() has been called\n\n    def __str__(self):\n        return self.get_buffer()\n\n    def get_buffer(self):\n        \"\"\"Returns the current buffer.\"\"\"\n        return \"\\n\".join(self.lines)\n\n    def copy(self):\n        \"\"\"Returns a copy of self.\"\"\"\n        docpp = DocPP(\n            \"\",\n            self.ontodoc,\n            self.basedir,\n            figformat=self.figformat,\n            figscale=self.figscale,\n            maxwidth=self.maxwidth,\n        )\n        docpp.lines[:] = self.lines\n        docpp.figdir = self.figdir\n        return docpp\n\n    def get_branches(self):\n        \"\"\"Returns a list with all branch names as specified with %BRANCH\n        (in current and all included documents).  The returned value is\n        cached for efficiency purposes and so that it is not lost after\n        processing branches.\"\"\"\n        if self._branch_cache is None:\n            names = []\n            docpp = self.copy()\n            docpp.process_includes()\n            for line in docpp.lines:\n                if line.startswith(\"%BRANCH\"):\n                    names.append(shlex.split(line)[1])\n            self._branch_cache = names\n        return self._branch_cache\n\n    def shift_header_levels(self, shift):\n        \"\"\"Shift header level of all hashtag-headers in buffer.  Underline\n        headers are ignored.\"\"\"\n        if not shift:\n            return\n        pat = re.compile(\"^#+ \")\n        for i, line in enumerate(self.lines):\n            match = pat.match(line)\n            if match:\n                if shift &gt; 0:\n                    self.lines[i] = \"#\" * shift + line\n                elif shift &lt; 0:\n                    counter = match.end()\n                    if shift &gt; counter:\n                        self.lines[i] = line.lstrip(\"# \")\n                    else:\n                        self.lines[i] = line[counter:]\n\n    def process_comments(self):\n        \"\"\"Strips out comment lines starting with \"%%\".\"\"\"\n        self.lines = [line for line in self.lines if not line.startswith(\"%%\")]\n\n    def process_headers(self):\n        \"\"\"Expand all %HEADER specifications.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%HEADER \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(tokens[2:], level=1)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.get_header(\n                    name, int(opts.level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_figures(self):\n        \"\"\"Expand all %FIGURE specifications.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%FIGURE \"):\n                tokens = shlex.split(line)\n                path = tokens[1]\n                opts = get_options(tokens[2:], caption=\"\", width=0)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.get_figure(\n                    os.path.join(self.basedir, path),\n                    caption=opts.caption,  # pylint: disable=no-member\n                    width=opts.width,  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_entities(self):\n        \"\"\"Expand all %ENTITY specifications.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%ENTITY \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(tokens[2:], header_level=3)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.itemdoc(\n                    name, int(opts.header_level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_branches(self):\n        \"\"\"Expand all %BRANCH specifications.\"\"\"\n        onto = self.ontodoc.onto\n\n        # Get all branch names in final document\n        names = self.get_branches()\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%BRANCH \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(\n                    tokens[2:],\n                    header_level=3,\n                    terminated=1,\n                    include_leaves=0,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n                leaves = (\n                    names if opts.terminated else ()\n                )  # pylint: disable=no-member\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                branch = filter_classes(\n                    onto.get_branch(\n                        name, leaves, opts.include_leaves\n                    ),  # pylint: disable=no-member\n                    included_namespaces=included_namespaces,\n                    included_ontologies=included_ontologies,\n                )\n\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.itemsdoc(\n                    branch, int(opts.header_level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def _make_branchfig(  # pylint: disable=too-many-arguments,too-many-locals\n        self,\n        name: str,\n        path: \"Union[Path, str]\",\n        terminated: bool,\n        include_leaves: bool,\n        strict_leaves: bool,\n        width: float,\n        leaves: \"Union[str, list[str]]\",\n        relations: str,\n        edgelabels: str,\n        rankdir: str,\n        legend: bool,\n        included_namespaces: \"Iterable[str]\",\n        included_ontologies: \"Iterable[str]\",\n    ) -&gt; \"tuple[str, list[str], float]\":\n        \"\"\"Help method for process_branchfig().\n\n        Args:\n            name: name of branch root\n            path: optional figure path name\n            include_leaves: whether to include leaves as end points\n                to the branch.\n            strict_leaves: whether to strictly exclude leave descendants\n            terminated: whether the graph should be terminated at leaf nodes\n            width: optional figure width\n            leaves: optional leaf node names for graph termination\n            relations: comma-separated list of relations to include\n            edgelabels: whether to include edgelabels\n            rankdir: graph direction (BT, TB, RL, LR)\n            legend: whether to add legend\n            included_namespaces: sequence of names of namespaces to be included\n            included_ontologies: sequence of names of ontologies to be included\n\n        Returns:\n            filepath: path to generated figure\n            leaves: used list of leaf node names\n            width: actual figure width\n\n        \"\"\"\n        onto = self.ontodoc.onto\n        if leaves:\n            if isinstance(leaves, str):\n                leaves = leaves.split(\",\")\n        elif terminated:\n            leaves = set(self.get_branches())\n            leaves.discard(name)\n        else:\n            leaves = None\n        if path:\n            figdir = os.path.dirname(path)\n            formatext = os.path.splitext(path)[1]\n            if formatext:\n                fmt = formatext.lstrip(\".\")\n            else:\n                fmt = self.figformat\n                path += f\".{fmt}\"\n        else:\n            figdir = self.figdir\n            fmt = self.figformat\n            term = \"T\" if terminated else \"\"\n            path = os.path.join(figdir, name + term) + f\".{fmt}\"\n\n        # Create graph\n        graph = OntoGraph(onto, graph_attr={\"rankdir\": rankdir})\n        graph.add_branch(\n            root=name,\n            leaves=leaves,\n            include_leaves=include_leaves,\n            strict_leaves=strict_leaves,\n            relations=relations,\n            edgelabels=edgelabels,\n            included_namespaces=included_namespaces,\n            included_ontologies=included_ontologies,\n        )\n        if legend:\n            graph.add_legend()\n\n        if not width:\n            figwidth, _ = graph.get_figsize()\n            width = self.figscale * figwidth\n            if self.maxwidth and width &gt; self.maxwidth:\n                width = self.maxwidth\n\n        filepath = os.path.join(self.basedir, path)\n        destdir = os.path.dirname(filepath)\n        if not os.path.exists(destdir):\n            os.makedirs(destdir)\n        graph.save(filepath, fmt=fmt)\n        return filepath, leaves, width\n\n    def process_branchfigs(self):\n        \"\"\"Process all %BRANCHFIG directives.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%BRANCHFIG \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(\n                    tokens[2:],\n                    path=\"\",\n                    caption=\"\",\n                    terminated=1,\n                    include_leaves=1,\n                    strict_leaves=1,\n                    width=0,\n                    leaves=\"\",\n                    relations=\"all\",\n                    edgelabels=0,\n                    rankdir=\"BT\",\n                    legend=1,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                filepath, _, width = self._make_branchfig(\n                    name,\n                    opts.path,  # pylint: disable=no-member\n                    opts.terminated,  # pylint: disable=no-member\n                    opts.include_leaves,  # pylint: disable=no-member\n                    opts.strict_leaves,  # pylint: disable=no-member\n                    opts.width,  # pylint: disable=no-member\n                    opts.leaves,  # pylint: disable=no-member\n                    opts.relations,  # pylint: disable=no-member\n                    opts.edgelabels,  # pylint: disable=no-member\n                    opts.rankdir,  # pylint: disable=no-member\n                    opts.legend,  # pylint: disable=no-member\n                    included_namespaces,\n                    included_ontologies,\n                )\n\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.get_figure(\n                    filepath,\n                    caption=opts.caption,\n                    width=width,  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_branchdocs(self):  # pylint: disable=too-many-locals\n        \"\"\"Process all %BRANCHDOC and  %BRANCHEAD directives.\"\"\"\n        onto = self.ontodoc.onto\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%BRANCHDOC \") or line.startswith(\n                \"%BRANCHHEAD \"\n            ):\n                with_branch = bool(line.startswith(\"%BRANCHDOC \"))\n                tokens = shlex.split(line)\n                name = tokens[1]\n                title = camelsplit(name)\n                title = title[0].upper() + title[1:] + \" branch\"\n                opts = get_options(\n                    tokens[2:],\n                    level=2,\n                    path=\"\",\n                    title=title,\n                    caption=title + \".\",\n                    terminated=1,\n                    strict_leaves=1,\n                    width=0,\n                    leaves=\"\",\n                    relations=\"all\",\n                    edgelabels=0,\n                    rankdir=\"BT\",\n                    legend=1,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                include_leaves = 1\n                filepath, leaves, width = self._make_branchfig(\n                    name,\n                    opts.path,  # pylint: disable=no-member\n                    opts.terminated,  # pylint: disable=no-member\n                    include_leaves,\n                    opts.strict_leaves,  # pylint: disable=no-member\n                    opts.width,  # pylint: disable=no-member\n                    opts.leaves,  # pylint: disable=no-member\n                    opts.relations,  # pylint: disable=no-member\n                    opts.edgelabels,  # pylint: disable=no-member\n                    opts.rankdir,  # pylint: disable=no-member\n                    opts.legend,  # pylint: disable=no-member\n                    included_namespaces,\n                    included_ontologies,\n                )\n\n                sec = []\n                sec.append(\n                    self.ontodoc.get_header(opts.title, int(opts.level))\n                )  # pylint: disable=no-member\n                sec.append(\n                    self.ontodoc.get_figure(\n                        filepath,\n                        caption=opts.caption,\n                        width=width,  # pylint: disable=no-member\n                    )\n                )\n                if with_branch:\n                    include_leaves = 0\n                    branch = filter_classes(\n                        onto.get_branch(name, leaves, include_leaves),\n                        included_namespaces=included_namespaces,\n                        included_ontologies=included_ontologies,\n                    )\n                    sec.append(\n                        self.ontodoc.itemsdoc(\n                            branch, int(opts.level + 1)\n                        )  # pylint: disable=no-member\n                    )\n\n                del self.lines[i]\n                self.lines[i:i] = sec\n\n    def process_alls(self):\n        \"\"\"Expand all %ALL specifications.\"\"\"\n        onto = self.ontodoc.onto\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%ALL \"):\n                tokens = shlex.split(line)\n                token = tokens[1]\n                opts = get_options(tokens[2:], header_level=3)\n                if token == \"classes\":  # nosec\n                    items = onto.classes(imported=self.imported)\n                elif token in (\"object_properties\", \"relations\"):\n                    items = onto.object_properties(imported=self.imported)\n                elif token == \"data_properties\":  # nosec\n                    items = onto.data_properties(imported=self.imported)\n                elif token == \"annotation_properties\":  # nosec\n                    items = onto.annotation_properties(imported=self.imported)\n                elif token == \"individuals\":  # nosec\n                    items = onto.individuals(imported=self.imported)\n                else:\n                    raise InvalidTemplateError(\n                        f\"Invalid argument to %%ALL: {token}\"\n                    )\n                items = sorted(items, key=get_label)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.itemsdoc(\n                    items, int(opts.header_level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_allfig(self):  # pylint: disable=too-many-locals\n        \"\"\"Process all %ALLFIG directives.\"\"\"\n        onto = self.ontodoc.onto\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%ALLFIG \"):\n                tokens = shlex.split(line)\n                token = tokens[1]\n                opts = get_options(\n                    tokens[2:],\n                    path=\"\",\n                    level=3,\n                    terminated=0,\n                    include_leaves=1,\n                    strict_leaves=1,\n                    width=0,\n                    leaves=\"\",\n                    relations=\"isA\",\n                    edgelabels=0,\n                    rankdir=\"BT\",\n                    legend=1,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n                if token == \"classes\":  # nosec\n                    roots = onto.get_root_classes(imported=self.imported)\n                elif token in (\"object_properties\", \"relations\"):\n                    roots = onto.get_root_object_properties(\n                        imported=self.imported\n                    )\n                elif token == \"data_properties\":  # nosec\n                    roots = onto.get_root_data_properties(\n                        imported=self.imported\n                    )\n                else:\n                    raise InvalidTemplateError(\n                        f\"Invalid argument to %%ALLFIG: {token}\"\n                    )\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                sec = []\n                for root in roots:\n                    name = asstring(root, link=\"{label}\", ontology=onto)\n                    filepath, _, width = self._make_branchfig(\n                        name,\n                        opts.path,  # pylint: disable=no-member\n                        opts.terminated,  # pylint: disable=no-member\n                        opts.include_leaves,  # pylint: disable=no-member\n                        opts.strict_leaves,  # pylint: disable=no-member\n                        opts.width,  # pylint: disable=no-member\n                        opts.leaves,  # pylint: disable=no-member\n                        opts.relations,  # pylint: disable=no-member\n                        opts.edgelabels,  # pylint: disable=no-member\n                        opts.rankdir,  # pylint: disable=no-member\n                        opts.legend,  # pylint: disable=no-member\n                        included_namespaces,\n                        included_ontologies,\n                    )\n                    title = f\"Taxonomy of {name}.\"\n                    sec.append(\n                        self.ontodoc.get_header(title, int(opts.level))\n                    )  # pylint: disable=no-member\n                    sec.extend(\n                        self.ontodoc.get_figure(\n                            filepath, caption=title, width=width\n                        ).split(\"\\n\")\n                    )\n\n                del self.lines[i]\n                self.lines[i:i] = sec\n\n    def process_includes(self):\n        \"\"\"Process all %INCLUDE directives.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%INCLUDE \"):\n                tokens = shlex.split(line)\n                filepath = tokens[1]\n                opts = get_options(tokens[2:], shift=0)\n                with open(\n                    os.path.join(self.basedir, filepath), \"rt\", encoding=\"utf8\"\n                ) as handle:\n                    docpp = DocPP(\n                        handle.read(),\n                        self.ontodoc,\n                        basedir=os.path.dirname(filepath),\n                        figformat=self.figformat,\n                        figscale=self.figscale,\n                        maxwidth=self.maxwidth,\n                    )\n                    docpp.figdir = self.figdir\n                if opts.shift:  # pylint: disable=no-member\n                    docpp.shift_header_levels(\n                        int(opts.shift)\n                    )  # pylint: disable=no-member\n                docpp.process()\n                del self.lines[i]\n                self.lines[i:i] = docpp.lines\n\n    def process(self):\n        \"\"\"Perform all pre-processing steps.\"\"\"\n        if not self._processed:\n            self.process_comments()\n            self.process_headers()\n            self.process_figures()\n            self.process_entities()\n            self.process_branches()\n            self.process_branchfigs()\n            self.process_branchdocs()\n            self.process_alls()\n            self.process_allfig()\n            self.process_includes()\n            self._processed = True\n\n    def write(  # pylint: disable=too-many-arguments\n        self,\n        outfile,\n        fmt=None,\n        pandoc_option_files=(),\n        pandoc_options=(),\n        genfile=None,\n        verbose=True,\n    ):\n        \"\"\"Writes documentation to `outfile`.\n\n        Parameters\n        ----------\n        outfile : str\n            File that the documentation is written to.\n        fmt : str\n            Output format.  If it is \"md\" or \"simple-html\",\n            the built-in template generator is used.  Otherwise\n            pandoc is used.  If not given, the format is inferred\n            from the `outfile` name extension.\n        pandoc_option_files : sequence\n            Sequence with command line arguments provided to pandoc.\n        pandoc_options : sequence\n            Additional pandoc options overriding options read from\n        `pandoc_option_files`.\n        genfile : str\n            Store temporary generated markdown input file to pandoc\n            to this file (for debugging).\n        verbose : bool\n            Whether to show some messages when running pandoc.\n        \"\"\"\n        self.process()\n        content = self.get_buffer()\n\n        substitutions = self.ontodoc.style.get(\"substitutions\", [])\n        for reg, sub in substitutions:\n            content = re.sub(reg, sub, content)\n\n        fmt = get_format(outfile, default=\"html\", fmt=fmt)\n        if fmt not in (\"simple-html\", \"markdown\", \"md\"):  # Run pandoc\n            if not genfile:\n                with NamedTemporaryFile(mode=\"w+t\", suffix=\".md\") as temp_file:\n                    temp_file.write(content)\n                    temp_file.flush()\n                    genfile = temp_file.name\n\n                    run_pandoc(\n                        genfile,\n                        outfile,\n                        fmt,\n                        pandoc_option_files=pandoc_option_files,\n                        pandoc_options=pandoc_options,\n                        verbose=verbose,\n                    )\n            else:\n                with open(genfile, \"wt\") as handle:\n                    handle.write(content)\n\n                run_pandoc(\n                    genfile,\n                    outfile,\n                    fmt,\n                    pandoc_option_files=pandoc_option_files,\n                    pandoc_options=pandoc_options,\n                    verbose=verbose,\n                )\n        else:\n            if verbose:\n                print(\"Writing:\", outfile)\n            with open(outfile, \"wt\") as handle:\n                handle.write(content)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.copy","title":"<code>copy(self)</code>","text":"<p>Returns a copy of self.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def copy(self):\n    \"\"\"Returns a copy of self.\"\"\"\n    docpp = DocPP(\n        \"\",\n        self.ontodoc,\n        self.basedir,\n        figformat=self.figformat,\n        figscale=self.figscale,\n        maxwidth=self.maxwidth,\n    )\n    docpp.lines[:] = self.lines\n    docpp.figdir = self.figdir\n    return docpp\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.get_branches","title":"<code>get_branches(self)</code>","text":"<p>Returns a list with all branch names as specified with %BRANCH (in current and all included documents).  The returned value is cached for efficiency purposes and so that it is not lost after processing branches.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_branches(self):\n    \"\"\"Returns a list with all branch names as specified with %BRANCH\n    (in current and all included documents).  The returned value is\n    cached for efficiency purposes and so that it is not lost after\n    processing branches.\"\"\"\n    if self._branch_cache is None:\n        names = []\n        docpp = self.copy()\n        docpp.process_includes()\n        for line in docpp.lines:\n            if line.startswith(\"%BRANCH\"):\n                names.append(shlex.split(line)[1])\n        self._branch_cache = names\n    return self._branch_cache\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.get_buffer","title":"<code>get_buffer(self)</code>","text":"<p>Returns the current buffer.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_buffer(self):\n    \"\"\"Returns the current buffer.\"\"\"\n    return \"\\n\".join(self.lines)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process","title":"<code>process(self)</code>","text":"<p>Perform all pre-processing steps.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process(self):\n    \"\"\"Perform all pre-processing steps.\"\"\"\n    if not self._processed:\n        self.process_comments()\n        self.process_headers()\n        self.process_figures()\n        self.process_entities()\n        self.process_branches()\n        self.process_branchfigs()\n        self.process_branchdocs()\n        self.process_alls()\n        self.process_allfig()\n        self.process_includes()\n        self._processed = True\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_allfig","title":"<code>process_allfig(self)</code>","text":"<p>Process all %ALLFIG directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_allfig(self):  # pylint: disable=too-many-locals\n    \"\"\"Process all %ALLFIG directives.\"\"\"\n    onto = self.ontodoc.onto\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%ALLFIG \"):\n            tokens = shlex.split(line)\n            token = tokens[1]\n            opts = get_options(\n                tokens[2:],\n                path=\"\",\n                level=3,\n                terminated=0,\n                include_leaves=1,\n                strict_leaves=1,\n                width=0,\n                leaves=\"\",\n                relations=\"isA\",\n                edgelabels=0,\n                rankdir=\"BT\",\n                legend=1,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n            if token == \"classes\":  # nosec\n                roots = onto.get_root_classes(imported=self.imported)\n            elif token in (\"object_properties\", \"relations\"):\n                roots = onto.get_root_object_properties(\n                    imported=self.imported\n                )\n            elif token == \"data_properties\":  # nosec\n                roots = onto.get_root_data_properties(\n                    imported=self.imported\n                )\n            else:\n                raise InvalidTemplateError(\n                    f\"Invalid argument to %%ALLFIG: {token}\"\n                )\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            sec = []\n            for root in roots:\n                name = asstring(root, link=\"{label}\", ontology=onto)\n                filepath, _, width = self._make_branchfig(\n                    name,\n                    opts.path,  # pylint: disable=no-member\n                    opts.terminated,  # pylint: disable=no-member\n                    opts.include_leaves,  # pylint: disable=no-member\n                    opts.strict_leaves,  # pylint: disable=no-member\n                    opts.width,  # pylint: disable=no-member\n                    opts.leaves,  # pylint: disable=no-member\n                    opts.relations,  # pylint: disable=no-member\n                    opts.edgelabels,  # pylint: disable=no-member\n                    opts.rankdir,  # pylint: disable=no-member\n                    opts.legend,  # pylint: disable=no-member\n                    included_namespaces,\n                    included_ontologies,\n                )\n                title = f\"Taxonomy of {name}.\"\n                sec.append(\n                    self.ontodoc.get_header(title, int(opts.level))\n                )  # pylint: disable=no-member\n                sec.extend(\n                    self.ontodoc.get_figure(\n                        filepath, caption=title, width=width\n                    ).split(\"\\n\")\n                )\n\n            del self.lines[i]\n            self.lines[i:i] = sec\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_alls","title":"<code>process_alls(self)</code>","text":"<p>Expand all %ALL specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_alls(self):\n    \"\"\"Expand all %ALL specifications.\"\"\"\n    onto = self.ontodoc.onto\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%ALL \"):\n            tokens = shlex.split(line)\n            token = tokens[1]\n            opts = get_options(tokens[2:], header_level=3)\n            if token == \"classes\":  # nosec\n                items = onto.classes(imported=self.imported)\n            elif token in (\"object_properties\", \"relations\"):\n                items = onto.object_properties(imported=self.imported)\n            elif token == \"data_properties\":  # nosec\n                items = onto.data_properties(imported=self.imported)\n            elif token == \"annotation_properties\":  # nosec\n                items = onto.annotation_properties(imported=self.imported)\n            elif token == \"individuals\":  # nosec\n                items = onto.individuals(imported=self.imported)\n            else:\n                raise InvalidTemplateError(\n                    f\"Invalid argument to %%ALL: {token}\"\n                )\n            items = sorted(items, key=get_label)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.itemsdoc(\n                items, int(opts.header_level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_branchdocs","title":"<code>process_branchdocs(self)</code>","text":"<p>Process all %BRANCHDOC and  %BRANCHEAD directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_branchdocs(self):  # pylint: disable=too-many-locals\n    \"\"\"Process all %BRANCHDOC and  %BRANCHEAD directives.\"\"\"\n    onto = self.ontodoc.onto\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%BRANCHDOC \") or line.startswith(\n            \"%BRANCHHEAD \"\n        ):\n            with_branch = bool(line.startswith(\"%BRANCHDOC \"))\n            tokens = shlex.split(line)\n            name = tokens[1]\n            title = camelsplit(name)\n            title = title[0].upper() + title[1:] + \" branch\"\n            opts = get_options(\n                tokens[2:],\n                level=2,\n                path=\"\",\n                title=title,\n                caption=title + \".\",\n                terminated=1,\n                strict_leaves=1,\n                width=0,\n                leaves=\"\",\n                relations=\"all\",\n                edgelabels=0,\n                rankdir=\"BT\",\n                legend=1,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            include_leaves = 1\n            filepath, leaves, width = self._make_branchfig(\n                name,\n                opts.path,  # pylint: disable=no-member\n                opts.terminated,  # pylint: disable=no-member\n                include_leaves,\n                opts.strict_leaves,  # pylint: disable=no-member\n                opts.width,  # pylint: disable=no-member\n                opts.leaves,  # pylint: disable=no-member\n                opts.relations,  # pylint: disable=no-member\n                opts.edgelabels,  # pylint: disable=no-member\n                opts.rankdir,  # pylint: disable=no-member\n                opts.legend,  # pylint: disable=no-member\n                included_namespaces,\n                included_ontologies,\n            )\n\n            sec = []\n            sec.append(\n                self.ontodoc.get_header(opts.title, int(opts.level))\n            )  # pylint: disable=no-member\n            sec.append(\n                self.ontodoc.get_figure(\n                    filepath,\n                    caption=opts.caption,\n                    width=width,  # pylint: disable=no-member\n                )\n            )\n            if with_branch:\n                include_leaves = 0\n                branch = filter_classes(\n                    onto.get_branch(name, leaves, include_leaves),\n                    included_namespaces=included_namespaces,\n                    included_ontologies=included_ontologies,\n                )\n                sec.append(\n                    self.ontodoc.itemsdoc(\n                        branch, int(opts.level + 1)\n                    )  # pylint: disable=no-member\n                )\n\n            del self.lines[i]\n            self.lines[i:i] = sec\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_branches","title":"<code>process_branches(self)</code>","text":"<p>Expand all %BRANCH specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_branches(self):\n    \"\"\"Expand all %BRANCH specifications.\"\"\"\n    onto = self.ontodoc.onto\n\n    # Get all branch names in final document\n    names = self.get_branches()\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%BRANCH \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(\n                tokens[2:],\n                header_level=3,\n                terminated=1,\n                include_leaves=0,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n            leaves = (\n                names if opts.terminated else ()\n            )  # pylint: disable=no-member\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            branch = filter_classes(\n                onto.get_branch(\n                    name, leaves, opts.include_leaves\n                ),  # pylint: disable=no-member\n                included_namespaces=included_namespaces,\n                included_ontologies=included_ontologies,\n            )\n\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.itemsdoc(\n                branch, int(opts.header_level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_branchfigs","title":"<code>process_branchfigs(self)</code>","text":"<p>Process all %BRANCHFIG directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_branchfigs(self):\n    \"\"\"Process all %BRANCHFIG directives.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%BRANCHFIG \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(\n                tokens[2:],\n                path=\"\",\n                caption=\"\",\n                terminated=1,\n                include_leaves=1,\n                strict_leaves=1,\n                width=0,\n                leaves=\"\",\n                relations=\"all\",\n                edgelabels=0,\n                rankdir=\"BT\",\n                legend=1,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            filepath, _, width = self._make_branchfig(\n                name,\n                opts.path,  # pylint: disable=no-member\n                opts.terminated,  # pylint: disable=no-member\n                opts.include_leaves,  # pylint: disable=no-member\n                opts.strict_leaves,  # pylint: disable=no-member\n                opts.width,  # pylint: disable=no-member\n                opts.leaves,  # pylint: disable=no-member\n                opts.relations,  # pylint: disable=no-member\n                opts.edgelabels,  # pylint: disable=no-member\n                opts.rankdir,  # pylint: disable=no-member\n                opts.legend,  # pylint: disable=no-member\n                included_namespaces,\n                included_ontologies,\n            )\n\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.get_figure(\n                filepath,\n                caption=opts.caption,\n                width=width,  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_comments","title":"<code>process_comments(self)</code>","text":"<p>Strips out comment lines starting with \"%%\".</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_comments(self):\n    \"\"\"Strips out comment lines starting with \"%%\".\"\"\"\n    self.lines = [line for line in self.lines if not line.startswith(\"%%\")]\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_entities","title":"<code>process_entities(self)</code>","text":"<p>Expand all %ENTITY specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_entities(self):\n    \"\"\"Expand all %ENTITY specifications.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%ENTITY \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(tokens[2:], header_level=3)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.itemdoc(\n                name, int(opts.header_level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_figures","title":"<code>process_figures(self)</code>","text":"<p>Expand all %FIGURE specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_figures(self):\n    \"\"\"Expand all %FIGURE specifications.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%FIGURE \"):\n            tokens = shlex.split(line)\n            path = tokens[1]\n            opts = get_options(tokens[2:], caption=\"\", width=0)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.get_figure(\n                os.path.join(self.basedir, path),\n                caption=opts.caption,  # pylint: disable=no-member\n                width=opts.width,  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_headers","title":"<code>process_headers(self)</code>","text":"<p>Expand all %HEADER specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_headers(self):\n    \"\"\"Expand all %HEADER specifications.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%HEADER \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(tokens[2:], level=1)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.get_header(\n                name, int(opts.level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_includes","title":"<code>process_includes(self)</code>","text":"<p>Process all %INCLUDE directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_includes(self):\n    \"\"\"Process all %INCLUDE directives.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%INCLUDE \"):\n            tokens = shlex.split(line)\n            filepath = tokens[1]\n            opts = get_options(tokens[2:], shift=0)\n            with open(\n                os.path.join(self.basedir, filepath), \"rt\", encoding=\"utf8\"\n            ) as handle:\n                docpp = DocPP(\n                    handle.read(),\n                    self.ontodoc,\n                    basedir=os.path.dirname(filepath),\n                    figformat=self.figformat,\n                    figscale=self.figscale,\n                    maxwidth=self.maxwidth,\n                )\n                docpp.figdir = self.figdir\n            if opts.shift:  # pylint: disable=no-member\n                docpp.shift_header_levels(\n                    int(opts.shift)\n                )  # pylint: disable=no-member\n            docpp.process()\n            del self.lines[i]\n            self.lines[i:i] = docpp.lines\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.shift_header_levels","title":"<code>shift_header_levels(self, shift)</code>","text":"<p>Shift header level of all hashtag-headers in buffer.  Underline headers are ignored.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def shift_header_levels(self, shift):\n    \"\"\"Shift header level of all hashtag-headers in buffer.  Underline\n    headers are ignored.\"\"\"\n    if not shift:\n        return\n    pat = re.compile(\"^#+ \")\n    for i, line in enumerate(self.lines):\n        match = pat.match(line)\n        if match:\n            if shift &gt; 0:\n                self.lines[i] = \"#\" * shift + line\n            elif shift &lt; 0:\n                counter = match.end()\n                if shift &gt; counter:\n                    self.lines[i] = line.lstrip(\"# \")\n                else:\n                    self.lines[i] = line[counter:]\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.write","title":"<code>write(self, outfile, fmt=None, pandoc_option_files=(), pandoc_options=(), genfile=None, verbose=True)</code>","text":"<p>Writes documentation to <code>outfile</code>.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.write--parameters","title":"Parameters","text":"<p>outfile : str     File that the documentation is written to. fmt : str     Output format.  If it is \"md\" or \"simple-html\",     the built-in template generator is used.  Otherwise     pandoc is used.  If not given, the format is inferred     from the <code>outfile</code> name extension. pandoc_option_files : sequence     Sequence with command line arguments provided to pandoc. pandoc_options : sequence     Additional pandoc options overriding options read from <code>pandoc_option_files</code>. genfile : str     Store temporary generated markdown input file to pandoc     to this file (for debugging). verbose : bool     Whether to show some messages when running pandoc.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def write(  # pylint: disable=too-many-arguments\n    self,\n    outfile,\n    fmt=None,\n    pandoc_option_files=(),\n    pandoc_options=(),\n    genfile=None,\n    verbose=True,\n):\n    \"\"\"Writes documentation to `outfile`.\n\n    Parameters\n    ----------\n    outfile : str\n        File that the documentation is written to.\n    fmt : str\n        Output format.  If it is \"md\" or \"simple-html\",\n        the built-in template generator is used.  Otherwise\n        pandoc is used.  If not given, the format is inferred\n        from the `outfile` name extension.\n    pandoc_option_files : sequence\n        Sequence with command line arguments provided to pandoc.\n    pandoc_options : sequence\n        Additional pandoc options overriding options read from\n    `pandoc_option_files`.\n    genfile : str\n        Store temporary generated markdown input file to pandoc\n        to this file (for debugging).\n    verbose : bool\n        Whether to show some messages when running pandoc.\n    \"\"\"\n    self.process()\n    content = self.get_buffer()\n\n    substitutions = self.ontodoc.style.get(\"substitutions\", [])\n    for reg, sub in substitutions:\n        content = re.sub(reg, sub, content)\n\n    fmt = get_format(outfile, default=\"html\", fmt=fmt)\n    if fmt not in (\"simple-html\", \"markdown\", \"md\"):  # Run pandoc\n        if not genfile:\n            with NamedTemporaryFile(mode=\"w+t\", suffix=\".md\") as temp_file:\n                temp_file.write(content)\n                temp_file.flush()\n                genfile = temp_file.name\n\n                run_pandoc(\n                    genfile,\n                    outfile,\n                    fmt,\n                    pandoc_option_files=pandoc_option_files,\n                    pandoc_options=pandoc_options,\n                    verbose=verbose,\n                )\n        else:\n            with open(genfile, \"wt\") as handle:\n                handle.write(content)\n\n            run_pandoc(\n                genfile,\n                outfile,\n                fmt,\n                pandoc_option_files=pandoc_option_files,\n                pandoc_options=pandoc_options,\n                verbose=verbose,\n            )\n    else:\n        if verbose:\n            print(\"Writing:\", outfile)\n        with open(outfile, \"wt\") as handle:\n            handle.write(content)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.InvalidTemplateError","title":"<code> InvalidTemplateError            (NameError)         </code>","text":"<p>Raised on errors in template files.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class InvalidTemplateError(NameError):\n    \"\"\"Raised on errors in template files.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc","title":"<code> OntoDoc        </code>","text":"<p>A class for helping documentating ontologies.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc--parameters","title":"Parameters","text":"<p>onto : Ontology instance     The ontology that should be documented. style : dict | \"html\" | \"markdown\" | \"markdown_tex\"     A dict defining the following template strings (and substitutions):</p> <pre><code>:header: Formats an header.\n    Substitutions: {level}, {label}\n:link: Formats a link.\n   Substitutions: {name}\n:point: Formats a point (list item).\n   Substitutions: {point}, {ontology}\n:points: Formats a list of points.  Used within annotations.\n   Substitutions: {points}, {ontology}\n:annotation: Formats an annotation.\n    Substitutions: {key}, {value}, {ontology}\n:substitutions: list of ``(regex, sub)`` pairs for substituting\n    annotation values.\n</code></pre> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class OntoDoc:\n    \"\"\"A class for helping documentating ontologies.\n\n    Parameters\n    ----------\n    onto : Ontology instance\n        The ontology that should be documented.\n    style : dict | \"html\" | \"markdown\" | \"markdown_tex\"\n        A dict defining the following template strings (and substitutions):\n\n        :header: Formats an header.\n            Substitutions: {level}, {label}\n        :link: Formats a link.\n           Substitutions: {name}\n        :point: Formats a point (list item).\n           Substitutions: {point}, {ontology}\n        :points: Formats a list of points.  Used within annotations.\n           Substitutions: {points}, {ontology}\n        :annotation: Formats an annotation.\n            Substitutions: {key}, {value}, {ontology}\n        :substitutions: list of ``(regex, sub)`` pairs for substituting\n            annotation values.\n    \"\"\"\n\n    _markdown_style = {\n        \"sep\": \"\\n\",\n        \"figwidth\": \"{{ width={width:.0f}px }}\",\n        \"figure\": \"![{caption}]({path}){figwidth}\\n\",\n        \"header\": \"\\n{:#&lt;{level}} {label}    {{#{anchor}}}\",\n        # Use ref instead of iri for local references in links\n        \"link\": \"[{label}]({ref})\",\n        \"point\": \"  - {point}\\n\",\n        \"points\": \"\\n\\n{points}\\n\",\n        \"annotation\": \"**{key}:** {value}\\n\",\n        \"substitutions\": [],\n    }\n    # Extra style settings for markdown+tex (e.g. pdf generation with pandoc)\n    _markdown_tex_extra_style = {\n        \"substitutions\": [\n            # logic/math symbols\n            (\"\\u2200\", r\"$\\\\forall$\"),\n            (\"\\u2203\", r\"$\\\\exists$\"),\n            (\"\\u2206\", r\"$\\\\nabla$\"),\n            (\"\\u2227\", r\"$\\\\land$\"),\n            (\"\\u2228\", r\"$\\\\lor$\"),\n            (\"\\u2207\", r\"$\\\\nabla$\"),\n            (\"\\u2212\", r\"-\"),\n            (\"-&gt;\", r\"$\\\\rightarrow$\"),\n            # uppercase greek letters\n            (\"\\u0391\", r\"$\\\\Upalpha$\"),\n            (\"\\u0392\", r\"$\\\\Upbeta$\"),\n            (\"\\u0393\", r\"$\\\\Upgamma$\"),\n            (\"\\u0394\", r\"$\\\\Updelta$\"),\n            (\"\\u0395\", r\"$\\\\Upepsilon$\"),\n            (\"\\u0396\", r\"$\\\\Upzeta$\"),\n            (\"\\u0397\", r\"$\\\\Upeta$\"),\n            (\"\\u0398\", r\"$\\\\Uptheta$\"),\n            (\"\\u0399\", r\"$\\\\Upiota$\"),\n            (\"\\u039a\", r\"$\\\\Upkappa$\"),\n            (\"\\u039b\", r\"$\\\\Uplambda$\"),\n            (\"\\u039c\", r\"$\\\\Upmu$\"),\n            (\"\\u039d\", r\"$\\\\Upnu$\"),\n            (\"\\u039e\", r\"$\\\\Upxi$\"),\n            (\"\\u039f\", r\"$\\\\Upomekron$\"),\n            (\"\\u03a0\", r\"$\\\\Uppi$\"),\n            (\"\\u03a1\", r\"$\\\\Uprho$\"),\n            (\"\\u03a3\", r\"$\\\\Upsigma$\"),  # no \\u0302\n            (\"\\u03a4\", r\"$\\\\Uptau$\"),\n            (\"\\u03a5\", r\"$\\\\Upupsilon$\"),\n            (\"\\u03a6\", r\"$\\\\Upvarphi$\"),\n            (\"\\u03a7\", r\"$\\\\Upchi$\"),\n            (\"\\u03a8\", r\"$\\\\Uppsi$\"),\n            (\"\\u03a9\", r\"$\\\\Upomega$\"),\n            # lowercase greek letters\n            (\"\\u03b1\", r\"$\\\\upalpha$\"),\n            (\"\\u03b2\", r\"$\\\\upbeta$\"),\n            (\"\\u03b3\", r\"$\\\\upgamma$\"),\n            (\"\\u03b4\", r\"$\\\\updelta$\"),\n            (\"\\u03b5\", r\"$\\\\upepsilon$\"),\n            (\"\\u03b6\", r\"$\\\\upzeta$\"),\n            (\"\\u03b7\", r\"$\\\\upeta$\"),\n            (\"\\u03b8\", r\"$\\\\uptheta$\"),\n            (\"\\u03b9\", r\"$\\\\upiota$\"),\n            (\"\\u03ba\", r\"$\\\\upkappa$\"),\n            (\"\\u03bb\", r\"$\\\\uplambda$\"),\n            (\"\\u03bc\", r\"$\\\\upmu$\"),\n            (\"\\u03bd\", r\"$\\\\upnu$\"),\n            (\"\\u03be\", r\"$\\\\upxi$\"),\n            (\"\\u03bf\", r\"o\"),  # no \\upomicron\n            (\"\\u03c0\", r\"$\\\\uppi$\"),\n            (\"\\u03c1\", r\"$\\\\uprho$\"),\n            (\"\\u03c2\", r\"$\\\\upvarsigma$\"),\n            (\"\\u03c3\", r\"$\\\\upsigma$\"),\n            (\"\\u03c4\", r\"$\\\\uptau$\"),\n            (\"\\u03c5\", r\"$\\\\upupsilon$\"),\n            (\"\\u03c6\", r\"$\\\\upvarphi$\"),\n            (\"\\u03c7\", r\"$\\\\upchi$\"),\n            (\"\\u03c8\", r\"$\\\\uppsi$\"),\n            (\"\\u03c9\", r\"$\\\\upomega$\"),\n            # acutes, accents, etc...\n            (\"\\u03ae\", r\"$\\\\acute{\\\\upeta}$\"),\n            (\"\\u1e17\", r\"$\\\\acute{\\\\bar{\\\\mathrm{e}}}$\"),\n            (\"\\u03ac\", r\"$\\\\acute{\\\\upalpha}$\"),\n            (\"\\u00e1\", r\"$\\\\acute{\\\\mathrm{a}}$\"),\n            (\"\\u03cc\", r\"$\\\\acute{o}$\"),  # no \\upomicron\n            (\"\\u014d\", r\"$\\\\bar{\\\\mathrm{o}}$\"),\n            (\"\\u1f45\", r\"$\\\\acute{o}$\"),  # no \\omicron\n        ],\n    }\n    _html_style = {\n        \"sep\": \"&lt;p&gt;\\n\",\n        \"figwidth\": 'width=\"{width:.0f}\"',\n        \"figure\": '&lt;img src=\"{path}\" alt=\"{caption}\"{figwidth}&gt;',\n        \"header\": '&lt;h{level} id=\"{anchor}\"&gt;{label}&lt;/h{level}&gt;',\n        \"link\": '&lt;a href=\"{ref}\"&gt;{label}&lt;/a&gt;',\n        \"point\": \"      &lt;li&gt;{point}&lt;/li&gt;\\n\",\n        \"points\": \"    &lt;ul&gt;\\n      {points}\\n    &lt;/ul&gt;\\n\",\n        \"annotation\": \"  &lt;dd&gt;&lt;strong&gt;{key}:&lt;/strong&gt;\\n{value}  &lt;/dd&gt;\\n\",\n        \"substitutions\": [\n            (r\"&amp;\", r\"&amp;#8210;\"),\n            (r\"&lt;p&gt;\", r\"&lt;p&gt;\\n\\n\"),\n            (r\"\\u2018([^\\u2019]*)\\u2019\", r\"&lt;q&gt;\\1&lt;/q&gt;\"),\n            (r\"\\u2019\", r\"'\"),\n            (r\"\\u2260\", r\"&amp;ne;\"),\n            (r\"\\u2264\", r\"&amp;le;\"),\n            (r\"\\u2265\", r\"&amp;ge;\"),\n            (r\"\\u226A\", r\"&amp;x226A;\"),\n            (r\"\\u226B\", r\"&amp;x226B;\"),\n            (r'\"Y$', r\"\"),  # strange noice added by owlready2\n        ],\n    }\n\n    def __init__(self, onto, style=\"markdown\"):\n        if isinstance(style, str):\n            if style == \"markdown_tex\":\n                style = self._markdown_style.copy()\n                style.update(self._markdown_tex_extra_style)\n            else:\n                style = getattr(self, f\"_{style}_style\")\n        self.onto = onto\n        self.style = style\n        self.url_regex = re.compile(r\"https?:\\/\\/[^\\s ]+\")\n\n    def get_default_template(self):\n        \"\"\"Returns default template.\"\"\"\n        title = os.path.splitext(\n            os.path.basename(self.onto.base_iri.rstrip(\"/#\"))\n        )[0]\n        irilink = self.style.get(\"link\", \"{name}\").format(\n            iri=self.onto.base_iri,\n            name=self.onto.base_iri,\n            ref=self.onto.base_iri,\n            label=self.onto.base_iri,\n            lowerlabel=self.onto.base_iri,\n        )\n        template = dedent(\n            \"\"\"\\\n        %HEADER {title}\n        Documentation of {irilink}\n\n        %HEADER Relations level=2\n        %ALL object_properties\n\n        %HEADER Classes level=2\n        %ALL classes\n\n        %HEADER Individuals level=2\n        %ALL individuals\n\n        %HEADER Appendix               level=1\n        %HEADER \"Relation taxonomies\"  level=2\n        %ALLFIG object_properties\n\n        %HEADER \"Class taxonomies\"     level=2\n        %ALLFIG classes\n        \"\"\"\n        ).format(ontology=self.onto, title=title, irilink=irilink)\n        return template\n\n    def get_header(self, label, header_level=1, anchor=None):\n        \"\"\"Returns `label` formatted as a header of given level.\"\"\"\n        header_style = self.style.get(\"header\", \"{label}\\n\")\n        return header_style.format(\n            \"\",\n            level=header_level,\n            label=label,\n            anchor=anchor if anchor else label.lower().replace(\" \", \"-\"),\n        )\n\n    def get_figure(self, path, caption=\"\", width=None):\n        \"\"\"Returns a formatted insert-figure-directive.\"\"\"\n        figwidth_style = self.style.get(\"figwidth\", \"\")\n        figure_style = self.style.get(\"figure\", \"\")\n        figwidth = figwidth_style.format(width=width) if width else \"\"\n        return figure_style.format(\n            path=path, caption=caption, figwidth=figwidth\n        )\n\n    def itemdoc(\n        self, item, header_level=3, show_disjoints=False\n    ):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n        \"\"\"Returns documentation of `item`.\n\n        Parameters\n        ----------\n        item : obj | label\n            The class, individual or relation to document.\n        header_level : int\n            Header level. Defaults to 3.\n        show_disjoints : Bool\n            Whether to show `disjoint_with` relations.\n        \"\"\"\n        onto = self.onto\n        if isinstance(item, str):\n            item = self.onto.get_by_label(item)\n\n        header_style = self.style.get(\"header\", \"{label}\\n\")\n        link_style = self.style.get(\"link\", \"{name}\")\n        point_style = self.style.get(\"point\", \"{point}\")\n        points_style = self.style.get(\"points\", \"{points}\")\n        annotation_style = self.style.get(\"annotation\", \"{key}: {value}\\n\")\n        substitutions = self.style.get(\"substitutions\", [])\n\n        # Logical \"sorting\" of annotations\n        order = {\n            \"definition\": \"00\",\n            \"axiom\": \"01\",\n            \"theorem\": \"02\",\n            \"elucidation\": \"03\",\n            \"domain\": \"04\",\n            \"range\": \"05\",\n            \"example\": \"06\",\n        }\n\n        doc = []\n\n        # Header\n        label = get_label(item)\n        iriname = item.iri.partition(\"#\")[2]\n        anchor = iriname if iriname else label.lower()\n        doc.append(\n            header_style.format(\n                \"\",\n                level=header_level,\n                label=label,\n                anchor=anchor,\n            )\n        )\n\n        # Add warning about missing prefLabel\n        if not hasattr(item, \"prefLabel\") or not item.prefLabel.first():\n            doc.append(\n                annotation_style.format(\n                    key=\"Warning\", value=\"Missing prefLabel\"\n                )\n            )\n\n        # Add iri\n        doc.append(\n            annotation_style.format(\n                key=\"IRI\",\n                value=asstring(item.iri, link_style, ontology=onto),\n                ontology=onto,\n            )\n        )\n\n        # Add annotations\n        if isinstance(item, owlready2.Thing):\n            annotations = item.get_individual_annotations()\n        else:\n            annotations = item.get_annotations()\n\n        for key in sorted(\n            annotations.keys(), key=lambda key: order.get(key, key)\n        ):\n            for value in annotations[key]:\n                value = str(value)\n                if self.url_regex.match(value):\n                    doc.append(\n                        annotation_style.format(\n                            key=key,\n                            value=asstring(value, link_style, ontology=onto),\n                        )\n                    )\n                else:\n                    for reg, sub in substitutions:\n                        value = re.sub(reg, sub, value)\n                    doc.append(annotation_style.format(key=key, value=value))\n\n        # ...add relations from is_a\n        points = []\n        non_prop = (\n            owlready2.ThingClass,  # owlready2.Restriction,\n            owlready2.And,\n            owlready2.Or,\n            owlready2.Not,\n        )\n        for prop in item.is_a:\n            if isinstance(prop, non_prop) or (\n                isinstance(item, owlready2.PropertyClass)\n                and isinstance(prop, owlready2.PropertyClass)\n            ):\n                points.append(\n                    point_style.format(\n                        point=\"is_a \"\n                        + asstring(prop, link_style, ontology=onto),\n                        ontology=onto,\n                    )\n                )\n            else:\n                points.append(\n                    point_style.format(\n                        point=asstring(prop, link_style, ontology=onto),\n                        ontology=onto,\n                    )\n                )\n\n        # ...add equivalent_to relations\n        for entity in item.equivalent_to:\n            points.append(\n                point_style.format(\n                    point=\"equivalent_to \"\n                    + asstring(entity, link_style, ontology=onto)\n                )\n            )\n\n        # ...add disjoint_with relations\n        if show_disjoints and hasattr(item, \"disjoint_with\"):\n            subjects = set(item.disjoint_with(reduce=True))\n            points.append(\n                point_style.format(\n                    point=\"disjoint_with \"\n                    + \", \".join(\n                        asstring(s, link_style, ontology=onto) for s in subjects\n                    ),\n                    ontology=onto,\n                )\n            )\n\n        # ...add disjoint_unions\n        if hasattr(item, \"disjoint_unions\"):\n            for unions in item.disjoint_unions:\n                string = \", \".join(\n                    asstring(u, link_style, ontology=onto) for u in unions\n                )\n                points.append(\n                    point_style.format(\n                        point=f\"disjoint_union_of {string}\", ontology=onto\n                    )\n                )\n\n        # ...add inverse_of relations\n        if hasattr(item, \"inverse_property\") and item.inverse_property:\n            points.append(\n                point_style.format(\n                    point=\"inverse_of \"\n                    + asstring(item.inverse_property, link_style, ontology=onto)\n                )\n            )\n\n        # ...add domain restrictions\n        for domain in getattr(item, \"domain\", ()):\n            points.append(\n                point_style.format(\n                    point=\"domain \"\n                    + asstring(domain, link_style, ontology=onto)\n                )\n            )\n\n        # ...add range restrictions\n        for restriction in getattr(item, \"range\", ()):\n            points.append(\n                point_style.format(\n                    point=\"range \"\n                    + asstring(restriction, link_style, ontology=onto)\n                )\n            )\n\n        # Add points (from is_a)\n        if points:\n            value = points_style.format(points=\"\".join(points), ontology=onto)\n            doc.append(\n                annotation_style.format(\n                    key=\"Subclass of\", value=value, ontology=onto\n                )\n            )\n\n        # Instances (individuals)\n        if hasattr(item, \"instances\"):\n            points = []\n\n            for instance in item.instances():\n                if isinstance(instance.is_instance_of, property):\n                    warnings.warn(\n                        f'Ignoring instance \"{instance}\" which is both and '\n                        \"indivudual and class. Ontodoc does not support \"\n                        \"punning at the present moment.\"\n                    )\n                    continue\n                if item in instance.is_instance_of:\n                    points.append(\n                        point_style.format(\n                            point=asstring(instance, link_style, ontology=onto),\n                            ontology=onto,\n                        )\n                    )\n                if points:\n                    value = points_style.format(\n                        points=\"\".join(points), ontology=onto\n                    )\n                    doc.append(\n                        annotation_style.format(\n                            key=\"Individuals\", value=value, ontology=onto\n                        )\n                    )\n\n        return \"\\n\".join(doc)\n\n    def itemsdoc(self, items, header_level=3):\n        \"\"\"Returns documentation of `items`.\"\"\"\n        sep_style = self.style.get(\"sep\", \"\\n\")\n        doc = []\n        for item in items:\n            doc.append(self.itemdoc(item, header_level))\n            doc.append(sep_style.format(ontology=self.onto))\n        return \"\\n\".join(doc)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.get_default_template","title":"<code>get_default_template(self)</code>","text":"<p>Returns default template.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_default_template(self):\n    \"\"\"Returns default template.\"\"\"\n    title = os.path.splitext(\n        os.path.basename(self.onto.base_iri.rstrip(\"/#\"))\n    )[0]\n    irilink = self.style.get(\"link\", \"{name}\").format(\n        iri=self.onto.base_iri,\n        name=self.onto.base_iri,\n        ref=self.onto.base_iri,\n        label=self.onto.base_iri,\n        lowerlabel=self.onto.base_iri,\n    )\n    template = dedent(\n        \"\"\"\\\n    %HEADER {title}\n    Documentation of {irilink}\n\n    %HEADER Relations level=2\n    %ALL object_properties\n\n    %HEADER Classes level=2\n    %ALL classes\n\n    %HEADER Individuals level=2\n    %ALL individuals\n\n    %HEADER Appendix               level=1\n    %HEADER \"Relation taxonomies\"  level=2\n    %ALLFIG object_properties\n\n    %HEADER \"Class taxonomies\"     level=2\n    %ALLFIG classes\n    \"\"\"\n    ).format(ontology=self.onto, title=title, irilink=irilink)\n    return template\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.get_figure","title":"<code>get_figure(self, path, caption='', width=None)</code>","text":"<p>Returns a formatted insert-figure-directive.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_figure(self, path, caption=\"\", width=None):\n    \"\"\"Returns a formatted insert-figure-directive.\"\"\"\n    figwidth_style = self.style.get(\"figwidth\", \"\")\n    figure_style = self.style.get(\"figure\", \"\")\n    figwidth = figwidth_style.format(width=width) if width else \"\"\n    return figure_style.format(\n        path=path, caption=caption, figwidth=figwidth\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.get_header","title":"<code>get_header(self, label, header_level=1, anchor=None)</code>","text":"<p>Returns <code>label</code> formatted as a header of given level.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_header(self, label, header_level=1, anchor=None):\n    \"\"\"Returns `label` formatted as a header of given level.\"\"\"\n    header_style = self.style.get(\"header\", \"{label}\\n\")\n    return header_style.format(\n        \"\",\n        level=header_level,\n        label=label,\n        anchor=anchor if anchor else label.lower().replace(\" \", \"-\"),\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.itemdoc","title":"<code>itemdoc(self, item, header_level=3, show_disjoints=False)</code>","text":"<p>Returns documentation of <code>item</code>.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.itemdoc--parameters","title":"Parameters","text":"<p>item : obj | label     The class, individual or relation to document. header_level : int     Header level. Defaults to 3. show_disjoints : Bool     Whether to show <code>disjoint_with</code> relations.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def itemdoc(\n    self, item, header_level=3, show_disjoints=False\n):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    \"\"\"Returns documentation of `item`.\n\n    Parameters\n    ----------\n    item : obj | label\n        The class, individual or relation to document.\n    header_level : int\n        Header level. Defaults to 3.\n    show_disjoints : Bool\n        Whether to show `disjoint_with` relations.\n    \"\"\"\n    onto = self.onto\n    if isinstance(item, str):\n        item = self.onto.get_by_label(item)\n\n    header_style = self.style.get(\"header\", \"{label}\\n\")\n    link_style = self.style.get(\"link\", \"{name}\")\n    point_style = self.style.get(\"point\", \"{point}\")\n    points_style = self.style.get(\"points\", \"{points}\")\n    annotation_style = self.style.get(\"annotation\", \"{key}: {value}\\n\")\n    substitutions = self.style.get(\"substitutions\", [])\n\n    # Logical \"sorting\" of annotations\n    order = {\n        \"definition\": \"00\",\n        \"axiom\": \"01\",\n        \"theorem\": \"02\",\n        \"elucidation\": \"03\",\n        \"domain\": \"04\",\n        \"range\": \"05\",\n        \"example\": \"06\",\n    }\n\n    doc = []\n\n    # Header\n    label = get_label(item)\n    iriname = item.iri.partition(\"#\")[2]\n    anchor = iriname if iriname else label.lower()\n    doc.append(\n        header_style.format(\n            \"\",\n            level=header_level,\n            label=label,\n            anchor=anchor,\n        )\n    )\n\n    # Add warning about missing prefLabel\n    if not hasattr(item, \"prefLabel\") or not item.prefLabel.first():\n        doc.append(\n            annotation_style.format(\n                key=\"Warning\", value=\"Missing prefLabel\"\n            )\n        )\n\n    # Add iri\n    doc.append(\n        annotation_style.format(\n            key=\"IRI\",\n            value=asstring(item.iri, link_style, ontology=onto),\n            ontology=onto,\n        )\n    )\n\n    # Add annotations\n    if isinstance(item, owlready2.Thing):\n        annotations = item.get_individual_annotations()\n    else:\n        annotations = item.get_annotations()\n\n    for key in sorted(\n        annotations.keys(), key=lambda key: order.get(key, key)\n    ):\n        for value in annotations[key]:\n            value = str(value)\n            if self.url_regex.match(value):\n                doc.append(\n                    annotation_style.format(\n                        key=key,\n                        value=asstring(value, link_style, ontology=onto),\n                    )\n                )\n            else:\n                for reg, sub in substitutions:\n                    value = re.sub(reg, sub, value)\n                doc.append(annotation_style.format(key=key, value=value))\n\n    # ...add relations from is_a\n    points = []\n    non_prop = (\n        owlready2.ThingClass,  # owlready2.Restriction,\n        owlready2.And,\n        owlready2.Or,\n        owlready2.Not,\n    )\n    for prop in item.is_a:\n        if isinstance(prop, non_prop) or (\n            isinstance(item, owlready2.PropertyClass)\n            and isinstance(prop, owlready2.PropertyClass)\n        ):\n            points.append(\n                point_style.format(\n                    point=\"is_a \"\n                    + asstring(prop, link_style, ontology=onto),\n                    ontology=onto,\n                )\n            )\n        else:\n            points.append(\n                point_style.format(\n                    point=asstring(prop, link_style, ontology=onto),\n                    ontology=onto,\n                )\n            )\n\n    # ...add equivalent_to relations\n    for entity in item.equivalent_to:\n        points.append(\n            point_style.format(\n                point=\"equivalent_to \"\n                + asstring(entity, link_style, ontology=onto)\n            )\n        )\n\n    # ...add disjoint_with relations\n    if show_disjoints and hasattr(item, \"disjoint_with\"):\n        subjects = set(item.disjoint_with(reduce=True))\n        points.append(\n            point_style.format(\n                point=\"disjoint_with \"\n                + \", \".join(\n                    asstring(s, link_style, ontology=onto) for s in subjects\n                ),\n                ontology=onto,\n            )\n        )\n\n    # ...add disjoint_unions\n    if hasattr(item, \"disjoint_unions\"):\n        for unions in item.disjoint_unions:\n            string = \", \".join(\n                asstring(u, link_style, ontology=onto) for u in unions\n            )\n            points.append(\n                point_style.format(\n                    point=f\"disjoint_union_of {string}\", ontology=onto\n                )\n            )\n\n    # ...add inverse_of relations\n    if hasattr(item, \"inverse_property\") and item.inverse_property:\n        points.append(\n            point_style.format(\n                point=\"inverse_of \"\n                + asstring(item.inverse_property, link_style, ontology=onto)\n            )\n        )\n\n    # ...add domain restrictions\n    for domain in getattr(item, \"domain\", ()):\n        points.append(\n            point_style.format(\n                point=\"domain \"\n                + asstring(domain, link_style, ontology=onto)\n            )\n        )\n\n    # ...add range restrictions\n    for restriction in getattr(item, \"range\", ()):\n        points.append(\n            point_style.format(\n                point=\"range \"\n                + asstring(restriction, link_style, ontology=onto)\n            )\n        )\n\n    # Add points (from is_a)\n    if points:\n        value = points_style.format(points=\"\".join(points), ontology=onto)\n        doc.append(\n            annotation_style.format(\n                key=\"Subclass of\", value=value, ontology=onto\n            )\n        )\n\n    # Instances (individuals)\n    if hasattr(item, \"instances\"):\n        points = []\n\n        for instance in item.instances():\n            if isinstance(instance.is_instance_of, property):\n                warnings.warn(\n                    f'Ignoring instance \"{instance}\" which is both and '\n                    \"indivudual and class. Ontodoc does not support \"\n                    \"punning at the present moment.\"\n                )\n                continue\n            if item in instance.is_instance_of:\n                points.append(\n                    point_style.format(\n                        point=asstring(instance, link_style, ontology=onto),\n                        ontology=onto,\n                    )\n                )\n            if points:\n                value = points_style.format(\n                    points=\"\".join(points), ontology=onto\n                )\n                doc.append(\n                    annotation_style.format(\n                        key=\"Individuals\", value=value, ontology=onto\n                    )\n                )\n\n    return \"\\n\".join(doc)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.itemsdoc","title":"<code>itemsdoc(self, items, header_level=3)</code>","text":"<p>Returns documentation of <code>items</code>.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def itemsdoc(self, items, header_level=3):\n    \"\"\"Returns documentation of `items`.\"\"\"\n    sep_style = self.style.get(\"sep\", \"\\n\")\n    doc = []\n    for item in items:\n        doc.append(self.itemdoc(item, header_level))\n        doc.append(sep_style.format(ontology=self.onto))\n    return \"\\n\".join(doc)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.append_pandoc_options","title":"<code>append_pandoc_options(options, updates)</code>","text":"<p>Append <code>updates</code> to pandoc options <code>options</code>.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.append_pandoc_options--parameters","title":"Parameters","text":"<p>options : sequence     Sequence with initial Pandoc options. updates : sequence of str     Sequence of strings of the form \"--longoption=value\", where     <code>longoption</code> is a valid pandoc long option and <code>value</code> is the     new value.  The \"=value\" part is optional.</p> <pre><code>Strings of the form \"no-longoption\" will filter out \"--longoption\"\nfrom `options`.\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.append_pandoc_options--returns","title":"Returns","text":"<p>new_options : list     Updated pandoc options.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def append_pandoc_options(options, updates):\n    \"\"\"Append `updates` to pandoc options `options`.\n\n    Parameters\n    ----------\n    options : sequence\n        Sequence with initial Pandoc options.\n    updates : sequence of str\n        Sequence of strings of the form \"--longoption=value\", where\n        ``longoption`` is a valid pandoc long option and ``value`` is the\n        new value.  The \"=value\" part is optional.\n\n        Strings of the form \"no-longoption\" will filter out \"--longoption\"\n        from `options`.\n\n    Returns\n    -------\n    new_options : list\n        Updated pandoc options.\n    \"\"\"\n    # Valid pandoc options starting with \"--no-XXX\"\n    no_options = set(\"no-highlight\")\n\n    if not updates:\n        return list(options)\n\n    curated_updates = {}\n    for update in updates:\n        key, sep, value = update.partition(\"=\")\n        curated_updates[key.lstrip(\"-\")] = value if sep else None\n        filter_out = set(\n            _\n            for _ in curated_updates\n            if _.startswith(\"no-\") and _ not in no_options\n        )\n        _filter_out = set(f\"--{_[3:]}\" for _ in filter_out)\n        new_options = [\n            opt for opt in options if opt.partition(\"=\")[0] not in _filter_out\n        ]\n        new_options.extend(\n            [\n                f\"--{key}\" if value is None else f\"--{key}={value}\"\n                for key, value in curated_updates.items()\n                if key not in filter_out\n            ]\n        )\n    return new_options\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_docpp","title":"<code>get_docpp(ontodoc, infile, figdir='genfigs', figformat='png', maxwidth=None, imported=False)</code>","text":"<p>Read <code>infile</code> and return a new docpp instance.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_docpp(  # pylint: disable=too-many-arguments\n    ontodoc,\n    infile,\n    figdir=\"genfigs\",\n    figformat=\"png\",\n    maxwidth=None,\n    imported=False,\n):\n    \"\"\"Read `infile` and return a new docpp instance.\"\"\"\n    if infile:\n        with open(infile, \"rt\") as handle:\n            template = handle.read()\n        basedir = os.path.dirname(infile)\n    else:\n        template = ontodoc.get_default_template()\n        basedir = \".\"\n\n    docpp = DocPP(\n        template,\n        ontodoc,\n        basedir=basedir,\n        figdir=figdir,\n        figformat=figformat,\n        maxwidth=maxwidth,\n        imported=imported,\n    )\n\n    return docpp\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_figformat","title":"<code>get_figformat(fmt)</code>","text":"<p>Infer preferred figure format from output format.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_figformat(fmt):\n    \"\"\"Infer preferred figure format from output format.\"\"\"\n    if fmt == \"pdf\":\n        figformat = \"pdf\"  # XXX\n    elif \"html\" in fmt:\n        figformat = \"svg\"\n    else:\n        figformat = \"png\"\n    return figformat\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_maxwidth","title":"<code>get_maxwidth(fmt)</code>","text":"<p>Infer preferred max figure width from output format.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_maxwidth(fmt):\n    \"\"\"Infer preferred max figure width from output format.\"\"\"\n    if fmt == \"pdf\":\n        maxwidth = 668\n    else:\n        maxwidth = 1024\n    return maxwidth\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_options","title":"<code>get_options(opts, **kwargs)</code>","text":"<p>Returns a dict with options from the sequence <code>opts</code> with \"name=value\" pairs. Valid option names and default values are provided with the keyword arguments.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_options(opts, **kwargs):\n    \"\"\"Returns a dict with options from the sequence `opts` with\n    \"name=value\" pairs. Valid option names and default values are\n    provided with the keyword arguments.\"\"\"\n    res = AttributeDict(kwargs)\n    for opt in opts:\n        if \"=\" not in opt:\n            raise InvalidTemplateError(\n                f'Missing \"=\" in template option: {opt!r}'\n            )\n        name, value = opt.split(\"=\", 1)\n        if name not in res:\n            raise InvalidTemplateError(f\"Invalid template option: {name!r}\")\n        res_type = type(res[name])\n        res[name] = res_type(value)\n    return res\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_style","title":"<code>get_style(fmt)</code>","text":"<p>Infer style from output format.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_style(fmt):\n    \"\"\"Infer style from output format.\"\"\"\n    if fmt == \"simple-html\":\n        style = \"html\"\n    elif fmt in (\"tex\", \"latex\", \"pdf\"):\n        style = \"markdown_tex\"\n    else:\n        style = \"markdown\"\n    return style\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.load_pandoc_option_file","title":"<code>load_pandoc_option_file(yamlfile)</code>","text":"<p>Loads pandoc options from <code>yamlfile</code> and return a list with corresponding pandoc command line arguments.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def load_pandoc_option_file(yamlfile):\n    \"\"\"Loads pandoc options from `yamlfile` and return a list with\n    corresponding pandoc command line arguments.\"\"\"\n    with open(yamlfile) as handle:\n        pandoc_options = yaml.safe_load(handle)\n    options = pandoc_options.pop(\"input-files\", [])\n    variables = pandoc_options.pop(\"variables\", {})\n\n    for key, value in pandoc_options.items():\n        if isinstance(value, bool):\n            if value:\n                options.append(f\"--{key}\")\n        else:\n            options.append(f\"--{key}={value}\")\n\n    for key, value in variables.items():\n        if key == \"date\" and value == \"now\":\n            value = time.strftime(\"%B %d, %Y\")\n        options.append(f\"--variable={key}:{value}\")\n\n    return options\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc","title":"<code>run_pandoc(genfile, outfile, fmt, pandoc_option_files=(), pandoc_options=(), verbose=True)</code>","text":"<p>Runs pandoc.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc--parameters","title":"Parameters","text":"<p>genfile : str     Name of markdown input file. outfile : str     Output file name. fmt : str     Output format. pandoc_option_files : sequence     List of files with additional pandoc options.  Default is to read     \"pandoc-options.yaml\" and \"pandoc-FORMAT-options.yml\", where     <code>FORMAT</code> is the output format. pandoc_options : sequence     Additional pandoc options overriding options read from     <code>pandoc_option_files</code>. verbose : bool     Whether to print the pandoc command before execution.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc--raises","title":"Raises","text":"<p>subprocess.CalledProcessError     If the pandoc process returns with non-zero status.  The <code>returncode</code>     attribute will hold the exit code.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def run_pandoc(  # pylint: disable=too-many-arguments\n    genfile,\n    outfile,\n    fmt,\n    pandoc_option_files=(),\n    pandoc_options=(),\n    verbose=True,\n):\n    \"\"\"Runs pandoc.\n\n    Parameters\n    ----------\n    genfile : str\n        Name of markdown input file.\n    outfile : str\n        Output file name.\n    fmt : str\n        Output format.\n    pandoc_option_files : sequence\n        List of files with additional pandoc options.  Default is to read\n        \"pandoc-options.yaml\" and \"pandoc-FORMAT-options.yml\", where\n        `FORMAT` is the output format.\n    pandoc_options : sequence\n        Additional pandoc options overriding options read from\n        `pandoc_option_files`.\n    verbose : bool\n        Whether to print the pandoc command before execution.\n\n    Raises\n    ------\n    subprocess.CalledProcessError\n        If the pandoc process returns with non-zero status.  The `returncode`\n        attribute will hold the exit code.\n    \"\"\"\n    # Create pandoc argument list\n    args = [genfile]\n    files = [\"pandoc-options.yaml\", f\"pandoc-{fmt}-options.yaml\"]\n    if pandoc_option_files:\n        files = pandoc_option_files\n    for fname in files:\n        if os.path.exists(fname):\n            args.extend(load_pandoc_option_file(fname))\n        else:\n            warnings.warn(f\"missing pandoc option file: {fname}\")\n\n    # Update pandoc argument list\n    args = append_pandoc_options(args, pandoc_options)\n\n    # pdf output requires a special attention...\n    if fmt == \"pdf\":\n        pdf_engine = \"pdflatex\"\n        for arg in args:\n            if arg.startswith(\"--pdf-engine\"):\n                pdf_engine = arg.split(\"=\", 1)[1]\n                break\n        with TemporaryDirectory() as tmpdir:\n            run_pandoc_pdf(tmpdir, pdf_engine, outfile, args, verbose=verbose)\n    else:\n        args.append(f\"--output={outfile}\")\n        cmd = [\"pandoc\"] + args\n        if verbose:\n            print()\n            print(\"* Executing command:\")\n            print(\" \".join(shlex.quote(_) for _ in cmd))\n        subprocess.check_call(cmd)  # nosec\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc_pdf","title":"<code>run_pandoc_pdf(latex_dir, pdf_engine, outfile, args, verbose=True)</code>","text":"<p>Run pandoc for pdf generation.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def run_pandoc_pdf(latex_dir, pdf_engine, outfile, args, verbose=True):\n    \"\"\"Run pandoc for pdf generation.\"\"\"\n    basename = os.path.join(\n        latex_dir, os.path.splitext(os.path.basename(outfile))[0]\n    )\n\n    # Run pandoc\n    texfile = basename + \".tex\"\n    args.append(f\"--output={texfile}\")\n    cmd = [\"pandoc\"] + args\n    if verbose:\n        print()\n        print(\"* Executing commands:\")\n        print(\" \".join(shlex.quote(s) for s in cmd))\n    subprocess.check_call(cmd)  # nosec\n\n    # Fixing tex output\n    texfile2 = basename + \"2.tex\"\n    with open(texfile, \"rt\") as handle:\n        content = handle.read().replace(r\"\\$\\Uptheta\\$\", r\"$\\Uptheta$\")\n    with open(texfile2, \"wt\") as handle:\n        handle.write(content)\n\n    # Run latex\n    pdffile = basename + \"2.pdf\"\n    cmd = [\n        pdf_engine,\n        texfile2,\n        \"-halt-on-error\",\n        f\"-output-directory={latex_dir}\",\n    ]\n    if verbose:\n        print()\n        print(\" \".join(shlex.quote(s) for s in cmd))\n    output = subprocess.check_output(cmd, timeout=60)  # nosec\n    output = subprocess.check_output(cmd, timeout=60)  # nosec\n\n    # Workaround for non-working \"-output-directory\" latex option\n    if not os.path.exists(pdffile):\n        if os.path.exists(os.path.basename(pdffile)):\n            pdffile = os.path.basename(pdffile)\n            for ext in \"aux\", \"out\", \"toc\", \"log\":\n                filename = os.path.splitext(pdffile)[0] + \".\" + ext\n                if os.path.exists(filename):\n                    os.remove(filename)\n        else:\n            print()\n            print(output)\n            print()\n            raise RuntimeError(\"latex did not produce pdf file: \" + pdffile)\n\n    # Copy pdffile\n    if not os.path.exists(outfile) or not os.path.samefile(pdffile, outfile):\n        if verbose:\n            print()\n            print(f\"move {pdffile} to {outfile}\")\n        shutil.move(pdffile, outfile)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/","title":"ontodoc_rst","text":"<p>A module for documenting ontologies.</p>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation","title":"<code> ModuleDocumentation        </code>","text":"<p>Class for documentating a module in an ontology.</p> <p>Parameters:</p> Name Type Description Default <code>ontology</code> <code>Optional[Ontology]</code> <p>Ontology to include in the generated documentation. All entities in this ontology will be included.</p> <code>None</code> <code>entities</code> <code>Optional[Iterable[Entity]]</code> <p>Explicit listing of entities (classes, properties, individuals, datatypes) to document.  Normally not needed.</p> <code>None</code> <code>title</code> <code>Optional[str]</code> <p>Header title.  Be default it is inferred from title of</p> <code>None</code> <code>iri_regex</code> <code>Optional[str]</code> <p>A regular expression that the IRI of documented entities should match.</p> <code>None</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>class ModuleDocumentation:\n    \"\"\"Class for documentating a module in an ontology.\n\n    Arguments:\n        ontology: Ontology to include in the generated documentation.\n            All entities in this ontology will be included.\n        entities: Explicit listing of entities (classes, properties,\n            individuals, datatypes) to document.  Normally not needed.\n        title: Header title.  Be default it is inferred from title of\n        iri_regex: A regular expression that the IRI of documented entities\n            should match.\n    \"\"\"\n\n    def __init__(\n        self,\n        ontology: \"Optional[Ontology]\" = None,\n        entities: \"Optional[Iterable[Entity]]\" = None,\n        title: \"Optional[str]\" = None,\n        iri_regex: \"Optional[str]\" = None,\n    ) -&gt; None:\n        self.ontology = ontology\n        self.title = title\n        self.iri_regex = iri_regex\n        self.graph = (\n            ontology.world.as_rdflib_graph() if ontology else rdflib.Graph()\n        )\n        self.classes = set()\n        self.object_properties = set()\n        self.data_properties = set()\n        self.annotation_properties = set()\n        self.individuals = set()\n        self.datatypes = set()\n\n        if ontology:\n            self.add_ontology(ontology)\n\n        if entities:\n            for entity in entities:\n                self.add_entity(entity)\n\n    def nonempty(self) -&gt; bool:\n        \"\"\"Returns whether the module has any classes, properties, individuals\n        or datatypes.\"\"\"\n        return (\n            self.classes\n            or self.object_properties\n            or self.data_properties\n            or self.annotation_properties\n            or self.individuals\n            or self.datatypes\n        )\n\n    def add_entity(self, entity: \"Entity\") -&gt; None:\n        \"\"\"Add `entity` (class, property, individual, datatype) to list of\n        entities to document.\n        \"\"\"\n        if self.iri_regex and not re.match(self.iri_regex, entity.iri):\n            return\n\n        if isinstance(entity, owlready2.ThingClass):\n            self.classes.add(entity)\n        elif isinstance(entity, owlready2.ObjectPropertyClass):\n            self.object_properties.add(entity)\n        elif isinstance(entity, owlready2.DataPropertyClass):\n            self.object_properties.add(entity)\n        elif isinstance(entity, owlready2.AnnotationPropertyClass):\n            self.object_properties.add(entity)\n        elif isinstance(entity, owlready2.Thing):\n            if (\n                hasattr(entity.__class__, \"iri\")\n                and entity.__class__.iri\n                == \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n            ):\n                self.datatypes.add(entity)\n            else:\n                self.individuals.add(entity)\n\n    def add_ontology(\n        self, ontology: \"Ontology\", imported: bool = False\n    ) -&gt; None:\n        \"\"\"Add ontology to documentation.\"\"\"\n        for entity in ontology.get_entities(imported=imported):\n            self.add_entity(entity)\n\n    def get_title(self) -&gt; str:\n        \"\"\"Return a module title.\"\"\"\n        iri = self.ontology.base_iri.rstrip(\"#/\")\n        if self.title:\n            title = self.title\n        elif self.ontology:\n            title = self.graph.value(URIRef(iri), DCTERMS.title)\n        if not title:\n            title = iri.rsplit(\"/\", 1)[-1]\n        return title\n\n    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        heading = f\"Module: {self.get_title()}\"\n        return f\"\"\"\n\n{heading.title()}\n{'='*len(heading)}\n\n\"\"\"\n\n    def get_refdoc(\n        self,\n        subsections: str = \"all\",\n        header: bool = True,\n    ) -&gt; str:\n        # pylint: disable=too-many-branches,too-many-locals\n        \"\"\"Return reference documentation of all module entities.\n\n        Arguments:\n            subsections: Comma-separated list of subsections to include in\n                the returned documentation.  Valid subsection names are:\n                  - classes\n                  - object_properties\n                  - data_properties\n                  - annotation_properties\n                  - individuals\n                  - datatypes\n                If \"all\", all subsections will be documented.\n            header: Whether to also include the header in the returned\n                documentation.\n\n        Returns:\n            String with reference documentation.\n        \"\"\"\n        # pylint: disable=too-many-nested-blocks\n        if subsections == \"all\":\n            subsections = (\n                \"classes,object_properties,data_properties,\"\n                \"annotation_properties,individuals,datatypes\"\n            )\n\n        maps = {\n            \"classes\": self.classes,\n            \"object_properties\": self.object_properties,\n            \"data_properties\": self.data_properties,\n            \"annotation_properties\": self.annotation_properties,\n            \"individuals\": self.individuals,\n            \"datatypes\": self.datatypes,\n        }\n        lines = []\n\n        if header:\n            lines.append(self.get_header())\n\n        def add_header(name):\n            clsname = f\"element-table-{name.lower().replace(' ', '-')}\"\n            lines.extend(\n                [\n                    \"  &lt;tr&gt;\",\n                    f'    &lt;th class=\"{clsname}\" colspan=\"2\"&gt;{name}&lt;/th&gt;',\n                    \"  &lt;/tr&gt;\",\n                ]\n            )\n\n        def add_keyvalue(key, value, escape=True, htmllink=True):\n            \"\"\"Help function for adding a key-value row to table.\"\"\"\n            if escape:\n                value = html.escape(str(value))\n            if htmllink:\n                value = re.sub(\n                    r\"(https?://[^\\s]+)\", r'&lt;a href=\"\\1\"&gt;\\1&lt;/a&gt;', value\n                )\n            value = value.replace(\"\\n\", \"&lt;br&gt;\")\n            lines.extend(\n                [\n                    \"  &lt;tr&gt;\",\n                    '    &lt;td class=\"element-table-key\"&gt;'\n                    f'&lt;span class=\"element-table-key\"&gt;'\n                    f\"{key.title()}&lt;/span&gt;&lt;/td&gt;\",\n                    f'    &lt;td class=\"element-table-value\"&gt;{value}&lt;/td&gt;',\n                    \"  &lt;/tr&gt;\",\n                ]\n            )\n\n        for subsection in subsections.split(\",\"):\n            if maps[subsection]:\n                moduletitle = self.get_title().lower().replace(\" \", \"-\")\n                anchor = f\"{moduletitle}-{subsection.replace('_', '-')}\"\n                lines.extend(\n                    [\n                        \"\",\n                        f\".. _{anchor}:\",\n                        \"\",\n                        subsection.replace(\"_\", \" \").title(),\n                        \"-\" * len(subsection),\n                        \"\",\n                    ]\n                )\n            for entity in sorted(maps[subsection], key=get_label):\n                label = get_label(entity)\n                lines.extend(\n                    [\n                        \".. raw:: html\",\n                        \"\",\n                        f'   &lt;div id=\"{entity.name}\"&gt;&lt;/div&gt;',\n                        \"\",\n                        f\"{label}\",\n                        \"^\" * len(label),\n                        \"\",\n                        \".. raw:: html\",\n                        \"\",\n                        '  &lt;table class=\"element-table\"&gt;',\n                    ]\n                )\n                add_keyvalue(\"IRI\", entity.iri)\n                if hasattr(entity, \"get_annotations\"):\n                    add_header(\"Annotations\")\n                    for key, value in entity.get_annotations().items():\n                        if isinstance(value, list):\n                            for val in value:\n                                add_keyvalue(key, val)\n                        else:\n                            add_keyvalue(key, value)\n                if entity.is_a or entity.equivalent_to:\n                    add_header(\"Formal description\")\n                    for r in entity.equivalent_to:\n\n                        # FIXME: Skip restrictions with value None to work\n                        # around bug in Owlready2 that doesn't handle custom\n                        # datatypes in restrictions correctly...\n                        if hasattr(r, \"value\") and r.value is None:\n                            continue\n\n                        add_keyvalue(\n                            \"Equivalent To\",\n                            asstring(\n                                r,\n                                link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                                ontology=self.ontology,\n                            ),\n                            escape=False,\n                            htmllink=False,\n                        )\n                    for r in entity.is_a:\n                        add_keyvalue(\n                            \"Subclass Of\",\n                            asstring(\n                                r,\n                                link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                                ontology=self.ontology,\n                            ),\n                            escape=False,\n                            htmllink=False,\n                        )\n\n                lines.extend([\"  &lt;/table&gt;\", \"\"])\n\n        return \"\\n\".join(lines)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.add_entity","title":"<code>add_entity(self, entity)</code>","text":"<p>Add <code>entity</code> (class, property, individual, datatype) to list of entities to document.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def add_entity(self, entity: \"Entity\") -&gt; None:\n    \"\"\"Add `entity` (class, property, individual, datatype) to list of\n    entities to document.\n    \"\"\"\n    if self.iri_regex and not re.match(self.iri_regex, entity.iri):\n        return\n\n    if isinstance(entity, owlready2.ThingClass):\n        self.classes.add(entity)\n    elif isinstance(entity, owlready2.ObjectPropertyClass):\n        self.object_properties.add(entity)\n    elif isinstance(entity, owlready2.DataPropertyClass):\n        self.object_properties.add(entity)\n    elif isinstance(entity, owlready2.AnnotationPropertyClass):\n        self.object_properties.add(entity)\n    elif isinstance(entity, owlready2.Thing):\n        if (\n            hasattr(entity.__class__, \"iri\")\n            and entity.__class__.iri\n            == \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n        ):\n            self.datatypes.add(entity)\n        else:\n            self.individuals.add(entity)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.add_ontology","title":"<code>add_ontology(self, ontology, imported=False)</code>","text":"<p>Add ontology to documentation.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def add_ontology(\n    self, ontology: \"Ontology\", imported: bool = False\n) -&gt; None:\n    \"\"\"Add ontology to documentation.\"\"\"\n    for entity in ontology.get_entities(imported=imported):\n        self.add_entity(entity)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.get_header","title":"<code>get_header(self)</code>","text":"<p>Return a the reStructuredText header as a string.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        heading = f\"Module: {self.get_title()}\"\n        return f\"\"\"\n\n{heading.title()}\n{'='*len(heading)}\n\n\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.get_refdoc","title":"<code>get_refdoc(self, subsections='all', header=True)</code>","text":"<p>Return reference documentation of all module entities.</p> <p>Parameters:</p> Name Type Description Default <code>subsections</code> <code>str</code> <p>Comma-separated list of subsections to include in the returned documentation.  Valid subsection names are:   - classes   - object_properties   - data_properties   - annotation_properties   - individuals   - datatypes If \"all\", all subsections will be documented.</p> <code>'all'</code> <code>header</code> <code>bool</code> <p>Whether to also include the header in the returned documentation.</p> <code>True</code> <p>Returns:</p> Type Description <code>str</code> <p>String with reference documentation.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def get_refdoc(\n    self,\n    subsections: str = \"all\",\n    header: bool = True,\n) -&gt; str:\n    # pylint: disable=too-many-branches,too-many-locals\n    \"\"\"Return reference documentation of all module entities.\n\n    Arguments:\n        subsections: Comma-separated list of subsections to include in\n            the returned documentation.  Valid subsection names are:\n              - classes\n              - object_properties\n              - data_properties\n              - annotation_properties\n              - individuals\n              - datatypes\n            If \"all\", all subsections will be documented.\n        header: Whether to also include the header in the returned\n            documentation.\n\n    Returns:\n        String with reference documentation.\n    \"\"\"\n    # pylint: disable=too-many-nested-blocks\n    if subsections == \"all\":\n        subsections = (\n            \"classes,object_properties,data_properties,\"\n            \"annotation_properties,individuals,datatypes\"\n        )\n\n    maps = {\n        \"classes\": self.classes,\n        \"object_properties\": self.object_properties,\n        \"data_properties\": self.data_properties,\n        \"annotation_properties\": self.annotation_properties,\n        \"individuals\": self.individuals,\n        \"datatypes\": self.datatypes,\n    }\n    lines = []\n\n    if header:\n        lines.append(self.get_header())\n\n    def add_header(name):\n        clsname = f\"element-table-{name.lower().replace(' ', '-')}\"\n        lines.extend(\n            [\n                \"  &lt;tr&gt;\",\n                f'    &lt;th class=\"{clsname}\" colspan=\"2\"&gt;{name}&lt;/th&gt;',\n                \"  &lt;/tr&gt;\",\n            ]\n        )\n\n    def add_keyvalue(key, value, escape=True, htmllink=True):\n        \"\"\"Help function for adding a key-value row to table.\"\"\"\n        if escape:\n            value = html.escape(str(value))\n        if htmllink:\n            value = re.sub(\n                r\"(https?://[^\\s]+)\", r'&lt;a href=\"\\1\"&gt;\\1&lt;/a&gt;', value\n            )\n        value = value.replace(\"\\n\", \"&lt;br&gt;\")\n        lines.extend(\n            [\n                \"  &lt;tr&gt;\",\n                '    &lt;td class=\"element-table-key\"&gt;'\n                f'&lt;span class=\"element-table-key\"&gt;'\n                f\"{key.title()}&lt;/span&gt;&lt;/td&gt;\",\n                f'    &lt;td class=\"element-table-value\"&gt;{value}&lt;/td&gt;',\n                \"  &lt;/tr&gt;\",\n            ]\n        )\n\n    for subsection in subsections.split(\",\"):\n        if maps[subsection]:\n            moduletitle = self.get_title().lower().replace(\" \", \"-\")\n            anchor = f\"{moduletitle}-{subsection.replace('_', '-')}\"\n            lines.extend(\n                [\n                    \"\",\n                    f\".. _{anchor}:\",\n                    \"\",\n                    subsection.replace(\"_\", \" \").title(),\n                    \"-\" * len(subsection),\n                    \"\",\n                ]\n            )\n        for entity in sorted(maps[subsection], key=get_label):\n            label = get_label(entity)\n            lines.extend(\n                [\n                    \".. raw:: html\",\n                    \"\",\n                    f'   &lt;div id=\"{entity.name}\"&gt;&lt;/div&gt;',\n                    \"\",\n                    f\"{label}\",\n                    \"^\" * len(label),\n                    \"\",\n                    \".. raw:: html\",\n                    \"\",\n                    '  &lt;table class=\"element-table\"&gt;',\n                ]\n            )\n            add_keyvalue(\"IRI\", entity.iri)\n            if hasattr(entity, \"get_annotations\"):\n                add_header(\"Annotations\")\n                for key, value in entity.get_annotations().items():\n                    if isinstance(value, list):\n                        for val in value:\n                            add_keyvalue(key, val)\n                    else:\n                        add_keyvalue(key, value)\n            if entity.is_a or entity.equivalent_to:\n                add_header(\"Formal description\")\n                for r in entity.equivalent_to:\n\n                    # FIXME: Skip restrictions with value None to work\n                    # around bug in Owlready2 that doesn't handle custom\n                    # datatypes in restrictions correctly...\n                    if hasattr(r, \"value\") and r.value is None:\n                        continue\n\n                    add_keyvalue(\n                        \"Equivalent To\",\n                        asstring(\n                            r,\n                            link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                            ontology=self.ontology,\n                        ),\n                        escape=False,\n                        htmllink=False,\n                    )\n                for r in entity.is_a:\n                    add_keyvalue(\n                        \"Subclass Of\",\n                        asstring(\n                            r,\n                            link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                            ontology=self.ontology,\n                        ),\n                        escape=False,\n                        htmllink=False,\n                    )\n\n            lines.extend([\"  &lt;/table&gt;\", \"\"])\n\n    return \"\\n\".join(lines)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.get_title","title":"<code>get_title(self)</code>","text":"<p>Return a module title.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def get_title(self) -&gt; str:\n    \"\"\"Return a module title.\"\"\"\n    iri = self.ontology.base_iri.rstrip(\"#/\")\n    if self.title:\n        title = self.title\n    elif self.ontology:\n        title = self.graph.value(URIRef(iri), DCTERMS.title)\n    if not title:\n        title = iri.rsplit(\"/\", 1)[-1]\n    return title\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.nonempty","title":"<code>nonempty(self)</code>","text":"<p>Returns whether the module has any classes, properties, individuals or datatypes.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def nonempty(self) -&gt; bool:\n    \"\"\"Returns whether the module has any classes, properties, individuals\n    or datatypes.\"\"\"\n    return (\n        self.classes\n        or self.object_properties\n        or self.data_properties\n        or self.annotation_properties\n        or self.individuals\n        or self.datatypes\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation","title":"<code> OntologyDocumentation        </code>","text":"<p>Documentation for an ontology with a common namespace.</p> <p>Parameters:</p> Name Type Description Default <code>ontologies</code> <code>Iterable[Ontology]</code> <p>Ontologies to include in the generated documentation. All entities in these ontologies will be included.</p> required <code>imported</code> <code>bool</code> <p>Whether to include imported ontologies.</p> <code>True</code> <code>recursive</code> <code>bool</code> <p>Whether to recursively import all imported ontologies. Implies <code>recursive=True</code>.</p> <code>False</code> <code>iri_regex</code> <code>Optional[str]</code> <p>A regular expression that the IRI of documented entities should match.</p> <code>None</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>class OntologyDocumentation:\n    \"\"\"Documentation for an ontology with a common namespace.\n\n    Arguments:\n        ontologies: Ontologies to include in the generated documentation.\n            All entities in these ontologies will be included.\n        imported: Whether to include imported ontologies.\n        recursive: Whether to recursively import all imported ontologies.\n            Implies `recursive=True`.\n        iri_regex: A regular expression that the IRI of documented entities\n            should match.\n    \"\"\"\n\n    def __init__(\n        self,\n        ontologies: \"Iterable[Ontology]\",\n        imported: bool = True,\n        recursive: bool = False,\n        iri_regex: \"Optional[str]\" = None,\n    ) -&gt; None:\n        if isinstance(ontologies, (Ontology, str, Path)):\n            ontologies = [ontologies]\n\n        if recursive:\n            imported = True\n\n        self.iri_regex = iri_regex\n        self.module_documentations = []\n\n        # Explicitly included ontologies\n        included_ontologies = {}\n        for onto in ontologies:\n            if isinstance(onto, (str, Path)):\n                onto = get_ontology(onto).load()\n            elif not isinstance(onto, Ontology):\n                raise TypeError(\n                    \"expected ontology as an IRI, Path or Ontology object, \"\n                    f\"got: {onto}\"\n                )\n            if onto.base_iri not in included_ontologies:\n                included_ontologies[onto.base_iri] = onto\n\n        # Indirectly included ontologies (imported)\n        if imported:\n            for onto in list(included_ontologies.values()):\n                for o in onto.get_imported_ontologies(recursive=recursive):\n                    if o.base_iri not in included_ontologies:\n                        included_ontologies[o.base_iri] = o\n\n        # Module documentations\n        for onto in included_ontologies.values():\n            self.module_documentations.append(\n                ModuleDocumentation(onto, iri_regex=iri_regex)\n            )\n\n    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        return \"\"\"\n==========\nReferences\n==========\n\"\"\"\n\n    def get_refdoc(self, header: bool = True, subsections: str = \"all\") -&gt; str:\n        \"\"\"Return reference documentation of all module entities.\n\n        Arguments:\n            header: Whether to also include the header in the returned\n                documentation.\n            subsections: Comma-separated list of subsections to include in\n                the returned documentation. See ModuleDocumentation.get_refdoc()\n                for more info.\n\n        Returns:\n            String with reference documentation.\n        \"\"\"\n        moduledocs = []\n        if header:\n            moduledocs.append(self.get_header())\n        moduledocs.extend(\n            md.get_refdoc(subsections=subsections)\n            for md in self.module_documentations\n            if md.nonempty()\n        )\n        return \"\\n\".join(moduledocs)\n\n    def top_ontology(self) -&gt; Ontology:\n        \"\"\"Return the top-level ontology.\"\"\"\n        return self.module_documentations[0].ontology\n\n    def write_refdoc(self, docfile=None, subsections=\"all\"):\n        \"\"\"Write reference documentation to disk.\n\n        Arguments:\n            docfile: Name of file to write to. Defaults to the name of\n                the top ontology with extension `.rst`.\n            subsections: Comma-separated list of subsections to include in\n                the returned documentation. See ModuleDocumentation.get_refdoc()\n                for more info.\n        \"\"\"\n        if not docfile:\n            docfile = self.top_ontology().name + \".rst\"\n        Path(docfile).write_text(\n            self.get_refdoc(subsections=subsections), encoding=\"utf8\"\n        )\n\n    def write_index_template(\n        self, indexfile=\"index.rst\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write a basic template index.rst file to disk.\n\n        Arguments:\n            indexfile: Name of index file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        docname = Path(docfile).stem if docfile else self.top_ontology().name\n        content = f\"\"\"\n.. toctree::\n   :includehidden:\n   :hidden:\n\n   Reference Index &lt;{docname}&gt;\n\n\"\"\"\n        outpath = Path(indexfile)\n        if not overwrite and outpath.exists():\n            warnings.warn(f\"index.rst file already exists: {outpath}\")\n            return\n\n        outpath.write_text(content, encoding=\"utf8\")\n\n    def write_conf_template(\n        self, conffile=\"conf.py\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write basic template sphinx conf.py file to disk.\n\n        Arguments:\n            conffile: Name of configuration file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        # pylint: disable=redefined-builtin\n        md = self.module_documentations[0]\n\n        iri = md.ontology.base_iri.rstrip(\"#/\")\n        authors = sorted(md.graph.objects(URIRef(iri), DCTERMS.creator))\n        license = md.graph.value(URIRef(iri), DCTERMS.license, default=None)\n        release = md.graph.value(URIRef(iri), OWL.versionInfo, default=\"1.0\")\n\n        author = \", \".join(a.value for a in authors) if authors else \"&lt;AUTHOR&gt;\"\n        copyright = license if license else f\"{time.strftime('%Y')}, {author}\"\n\n        content = f\"\"\"\n# Configuration file for the Sphinx documentation builder.\n#\n# For the full list of built-in configuration values, see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Project information -----------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information\n\nproject = '{md.ontology.name}'\ncopyright = '{copyright}'\nauthor = '{author}'\nrelease = '{release}'\n\n# -- General configuration ---------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration\n\nextensions = []\n\ntemplates_path = ['_templates']\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']\n\n\n\n# -- Options for HTML output -------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output\n\nhtml_theme = 'alabaster'\nhtml_static_path = ['_static']\n\"\"\"\n        if not conffile:\n            conffile = Path(docfile).with_name(\"conf.py\")\n        if overwrite and conffile.exists():\n            warnings.warn(f\"conf.py file already exists: {conffile}\")\n            return\n\n        conffile.write_text(content, encoding=\"utf8\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.get_header","title":"<code>get_header(self)</code>","text":"<p>Return a the reStructuredText header as a string.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        return \"\"\"\n==========\nReferences\n==========\n\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.get_refdoc","title":"<code>get_refdoc(self, header=True, subsections='all')</code>","text":"<p>Return reference documentation of all module entities.</p> <p>Parameters:</p> Name Type Description Default <code>header</code> <code>bool</code> <p>Whether to also include the header in the returned documentation.</p> <code>True</code> <code>subsections</code> <code>str</code> <p>Comma-separated list of subsections to include in the returned documentation. See ModuleDocumentation.get_refdoc() for more info.</p> <code>'all'</code> <p>Returns:</p> Type Description <code>str</code> <p>String with reference documentation.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def get_refdoc(self, header: bool = True, subsections: str = \"all\") -&gt; str:\n    \"\"\"Return reference documentation of all module entities.\n\n    Arguments:\n        header: Whether to also include the header in the returned\n            documentation.\n        subsections: Comma-separated list of subsections to include in\n            the returned documentation. See ModuleDocumentation.get_refdoc()\n            for more info.\n\n    Returns:\n        String with reference documentation.\n    \"\"\"\n    moduledocs = []\n    if header:\n        moduledocs.append(self.get_header())\n    moduledocs.extend(\n        md.get_refdoc(subsections=subsections)\n        for md in self.module_documentations\n        if md.nonempty()\n    )\n    return \"\\n\".join(moduledocs)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.top_ontology","title":"<code>top_ontology(self)</code>","text":"<p>Return the top-level ontology.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def top_ontology(self) -&gt; Ontology:\n    \"\"\"Return the top-level ontology.\"\"\"\n    return self.module_documentations[0].ontology\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.write_conf_template","title":"<code>write_conf_template(self, conffile='conf.py', docfile=None, overwrite=False)</code>","text":"<p>Write basic template sphinx conf.py file to disk.</p> <p>Parameters:</p> Name Type Description Default <code>conffile</code> <p>Name of configuration file to write.</p> <code>'conf.py'</code> <code>docfile</code> <p>Name of generated documentation file.  If not given, the name of the top ontology will be used.</p> <code>None</code> <code>overwrite</code> <p>Whether to overwrite an existing file.</p> <code>False</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def write_conf_template(\n        self, conffile=\"conf.py\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write basic template sphinx conf.py file to disk.\n\n        Arguments:\n            conffile: Name of configuration file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        # pylint: disable=redefined-builtin\n        md = self.module_documentations[0]\n\n        iri = md.ontology.base_iri.rstrip(\"#/\")\n        authors = sorted(md.graph.objects(URIRef(iri), DCTERMS.creator))\n        license = md.graph.value(URIRef(iri), DCTERMS.license, default=None)\n        release = md.graph.value(URIRef(iri), OWL.versionInfo, default=\"1.0\")\n\n        author = \", \".join(a.value for a in authors) if authors else \"&lt;AUTHOR&gt;\"\n        copyright = license if license else f\"{time.strftime('%Y')}, {author}\"\n\n        content = f\"\"\"\n# Configuration file for the Sphinx documentation builder.\n#\n# For the full list of built-in configuration values, see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Project information -----------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information\n\nproject = '{md.ontology.name}'\ncopyright = '{copyright}'\nauthor = '{author}'\nrelease = '{release}'\n\n# -- General configuration ---------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration\n\nextensions = []\n\ntemplates_path = ['_templates']\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']\n\n\n\n# -- Options for HTML output -------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output\n\nhtml_theme = 'alabaster'\nhtml_static_path = ['_static']\n\"\"\"\n        if not conffile:\n            conffile = Path(docfile).with_name(\"conf.py\")\n        if overwrite and conffile.exists():\n            warnings.warn(f\"conf.py file already exists: {conffile}\")\n            return\n\n        conffile.write_text(content, encoding=\"utf8\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.write_index_template","title":"<code>write_index_template(self, indexfile='index.rst', docfile=None, overwrite=False)</code>","text":"<p>Write a basic template index.rst file to disk.</p> <p>Parameters:</p> Name Type Description Default <code>indexfile</code> <p>Name of index file to write.</p> <code>'index.rst'</code> <code>docfile</code> <p>Name of generated documentation file.  If not given, the name of the top ontology will be used.</p> <code>None</code> <code>overwrite</code> <p>Whether to overwrite an existing file.</p> <code>False</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def write_index_template(\n        self, indexfile=\"index.rst\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write a basic template index.rst file to disk.\n\n        Arguments:\n            indexfile: Name of index file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        docname = Path(docfile).stem if docfile else self.top_ontology().name\n        content = f\"\"\"\n.. toctree::\n   :includehidden:\n   :hidden:\n\n   Reference Index &lt;{docname}&gt;\n\n\"\"\"\n        outpath = Path(indexfile)\n        if not overwrite and outpath.exists():\n            warnings.warn(f\"index.rst file already exists: {outpath}\")\n            return\n\n        outpath.write_text(content, encoding=\"utf8\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.write_refdoc","title":"<code>write_refdoc(self, docfile=None, subsections='all')</code>","text":"<p>Write reference documentation to disk.</p> <p>Parameters:</p> Name Type Description Default <code>docfile</code> <p>Name of file to write to. Defaults to the name of the top ontology with extension <code>.rst</code>.</p> <code>None</code> <code>subsections</code> <p>Comma-separated list of subsections to include in the returned documentation. See ModuleDocumentation.get_refdoc() for more info.</p> <code>'all'</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def write_refdoc(self, docfile=None, subsections=\"all\"):\n    \"\"\"Write reference documentation to disk.\n\n    Arguments:\n        docfile: Name of file to write to. Defaults to the name of\n            the top ontology with extension `.rst`.\n        subsections: Comma-separated list of subsections to include in\n            the returned documentation. See ModuleDocumentation.get_refdoc()\n            for more info.\n    \"\"\"\n    if not docfile:\n        docfile = self.top_ontology().name + \".rst\"\n    Path(docfile).write_text(\n        self.get_refdoc(subsections=subsections), encoding=\"utf8\"\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/","title":"ontology","text":"<p>A module adding additional functionality to owlready2.</p> <p>If desirable some of these additions may be moved back into owlready2.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.BlankNode","title":"<code> BlankNode        </code>","text":"<p>Represents a blank node.</p> <p>A blank node is a node that is not a literal and has no IRI. Resources represented by blank nodes are also called anonumous resources. Only the subject or object in an RDF triple can be a blank node.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>class BlankNode:\n    \"\"\"Represents a blank node.\n\n    A blank node is a node that is not a literal and has no IRI.\n    Resources represented by blank nodes are also called anonumous resources.\n    Only the subject or object in an RDF triple can be a blank node.\n    \"\"\"\n\n    def __init__(self, onto: Union[World, Ontology], storid: int):\n        \"\"\"Initiate a blank node.\n\n        Args:\n            onto: Ontology or World instance.\n            storid: The storage id of the blank node.\n        \"\"\"\n        if storid &gt;= 0:\n            raise ValueError(\n                f\"A BlankNode is supposed to have a negative storid: {storid}\"\n            )\n        self.onto = onto\n        self.storid = storid\n\n    def __repr__(self):\n        return repr(f\"_:b{-self.storid}\")\n\n    def __hash__(self):\n        return hash((self.onto, self.storid))\n\n    def __eq__(self, other):\n        \"\"\"For now blank nodes always compare true against each other.\"\"\"\n        return isinstance(other, BlankNode)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.BlankNode.__init__","title":"<code>__init__(self, onto, storid)</code>  <code>special</code>","text":"<p>Initiate a blank node.</p> <p>Parameters:</p> Name Type Description Default <code>onto</code> <code>Union[ontopy.ontology.World, ontopy.ontology.Ontology]</code> <p>Ontology or World instance.</p> required <code>storid</code> <code>int</code> <p>The storage id of the blank node.</p> required Source code in <code>ontopy/ontology.py</code> <pre><code>def __init__(self, onto: Union[World, Ontology], storid: int):\n    \"\"\"Initiate a blank node.\n\n    Args:\n        onto: Ontology or World instance.\n        storid: The storage id of the blank node.\n    \"\"\"\n    if storid &gt;= 0:\n        raise ValueError(\n            f\"A BlankNode is supposed to have a negative storid: {storid}\"\n        )\n    self.onto = onto\n    self.storid = storid\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology","title":"<code> Ontology            (Ontology)         </code>","text":"<p>A generic class extending owlready2.Ontology.</p> <p>Additional attributes:     !!! iri \"IRI of this ontology.  Currently only used for serialisation\"         with rdflib. Defaults to None, meaning <code>base_iri</code> will be used         instead.     !!! label_annotations \"List of label annotations, i.e. annotations\"         that are recognised by the get_by_label() method. Defaults         to <code>[skos:prefLabel, rdf:label, skos:altLabel]</code>.     prefix: Prefix for this ontology. Defaults to None.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>class Ontology(owlready2.Ontology):  # pylint: disable=too-many-public-methods\n    \"\"\"A generic class extending owlready2.Ontology.\n\n    Additional attributes:\n        iri: IRI of this ontology.  Currently only used for serialisation\n            with rdflib. Defaults to None, meaning `base_iri` will be used\n            instead.\n        label_annotations: List of label annotations, i.e. annotations\n            that are recognised by the get_by_label() method. Defaults\n            to `[skos:prefLabel, rdf:label, skos:altLabel]`.\n        prefix: Prefix for this ontology. Defaults to None.\n    \"\"\"\n\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.iri = None\n        self.label_annotations = DEFAULT_LABEL_ANNOTATIONS[:]\n        self.prefix = None\n\n    # Name of special unlabeled entities, like Thing, Nothing, etc...\n    _special_labels = None\n\n    # Some properties for customising dir() listing - useful in\n    # interactive sessions...\n    _dir_preflabel = isinteractive()\n    _dir_label = isinteractive()\n    _dir_name = False\n    _dir_imported = isinteractive()\n    dir_preflabel = property(\n        fget=lambda self: self._dir_preflabel,\n        fset=lambda self, v: setattr(self, \"_dir_preflabel\", bool(v)),\n        doc=\"Whether to include entity prefLabel in dir() listing.\",\n    )\n    dir_label = property(\n        fget=lambda self: self._dir_label,\n        fset=lambda self, v: setattr(self, \"_dir_label\", bool(v)),\n        doc=\"Whether to include entity label in dir() listing.\",\n    )\n    dir_name = property(\n        fget=lambda self: self._dir_name,\n        fset=lambda self, v: setattr(self, \"_dir_name\", bool(v)),\n        doc=\"Whether to include entity name in dir() listing.\",\n    )\n    dir_imported = property(\n        fget=lambda self: self._dir_imported,\n        fset=lambda self, v: setattr(self, \"_dir_imported\", bool(v)),\n        doc=\"Whether to include imported ontologies in dir() listing.\",\n    )\n\n    # Other settings\n    _colon_in_label = False\n    colon_in_label = property(\n        fget=lambda self: self._colon_in_label,\n        fset=lambda self, v: setattr(self, \"_colon_in_label\", bool(v)),\n        doc=\"Whether to accept colon in name-part of IRI.  \"\n        \"If true, the name cannot be prefixed.\",\n    )\n\n    def __dir__(self):\n        dirset = set(super().__dir__())\n        lst = list(self.get_entities(imported=self._dir_imported))\n        if self._dir_preflabel:\n            dirset.update(\n                str(dir.prefLabel.first())\n                for dir in lst\n                if hasattr(dir, \"prefLabel\")\n            )\n        if self._dir_label:\n            dirset.update(\n                str(dir.label.first()) for dir in lst if hasattr(dir, \"label\")\n            )\n        if self._dir_name:\n            dirset.update(dir.name for dir in lst if hasattr(dir, \"name\"))\n        dirset.difference_update({None})  # get rid of possible None\n        return sorted(dirset)\n\n    def __getitem__(self, name):\n        item = super().__getitem__(name)\n        if not item:\n            item = self.get_by_label(name)\n        return item\n\n    def __getattr__(self, name):\n        attr = super().__getattr__(name)\n        if not attr:\n            attr = self.get_by_label(name)\n        return attr\n\n    def __contains__(self, other):\n        if self.world[other]:\n            return True\n        try:\n            self.get_by_label(other)\n        except NoSuchLabelError:\n            return False\n        return True\n\n    def __objclass__(self):\n        # Play nice with inspect...\n        pass\n\n    def __hash__(self):\n        \"\"\"Returns a hash based on base_iri.\n        This is done to keep Ontology hashable when defining __eq__.\n        \"\"\"\n        return hash(self.base_iri)\n\n    def __eq__(self, other):\n        \"\"\"Checks if this ontology is equal to `other`.\n\n        This function compares the result of\n        ``set(self.get_unabbreviated_triples(label='_:b'))``,\n        i.e. blank nodes are not distinguished, but relations to blank\n        nodes are included.\n        \"\"\"\n        return set(self.get_unabbreviated_triples(blank=\"_:b\")) == set(\n            other.get_unabbreviated_triples(blank=\"_:b\")\n        )\n\n    def get_unabbreviated_triples(\n        self, subject=None, predicate=None, obj=None, blank=None\n    ):\n        \"\"\"Returns all matching triples unabbreviated.\n\n        If `blank` is given, it will be used to represent blank nodes.\n        \"\"\"\n        # pylint: disable=invalid-name\n        return _get_unabbreviated_triples(\n            self, subject=subject, predicate=predicate, obj=obj, blank=blank\n        )\n\n    def set_default_label_annotations(self):\n        \"\"\"Sets the default label annotations.\"\"\"\n        warnings.warn(\n            \"Ontology.set_default_label_annotations() is deprecated. \"\n            \"Default label annotations are set by Ontology.__init__(). \",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        self.label_annotations = DEFAULT_LABEL_ANNOTATIONS[:]\n\n    def get_by_label(\n        self,\n        label: str,\n        label_annotations: str = None,\n        prefix: str = None,\n        imported: bool = True,\n        colon_in_label: bool = None,\n    ):\n        \"\"\"Returns entity with label annotation `label`.\n\n        Arguments:\n           label: label so search for.\n               May be written as 'label' or 'prefix:label'.\n               get_by_label('prefix:label') ==\n               get_by_label('label', prefix='prefix').\n           label_annotations: a sequence of label annotation names to look up.\n               Defaults to the `label_annotations` property.\n           prefix: if provided, it should be the last component of\n               the base iri of an ontology (with trailing slash (/) or hash\n               (#) stripped off).  The search for a matching label will be\n               limited to this namespace.\n           imported: Whether to also look for `label` in imported ontologies.\n           colon_in_label: Whether to accept colon (:) in a label or name-part\n               of IRI.  Defaults to the `colon_in_label` property of `self`.\n               Setting this true cannot be combined with `prefix`.\n\n        If several entities have the same label, only the one which is\n        found first is returned.Use get_by_label_all() to get all matches.\n\n        Note, if different prefixes are provided in the label and via\n        the `prefix` argument a warning will be issued and the\n        `prefix` argument will take precedence.\n\n        A NoSuchLabelError is raised if `label` cannot be found.\n        \"\"\"\n        # pylint: disable=too-many-arguments,too-many-branches,invalid-name\n        if not isinstance(label, str):\n            raise TypeError(\n                f\"Invalid label definition, must be a string: '{label}'\"\n            )\n\n        if label_annotations is None:\n            label_annotations = self.label_annotations\n\n        if colon_in_label is None:\n            colon_in_label = self._colon_in_label\n        if colon_in_label:\n            if prefix:\n                raise ValueError(\n                    \"`prefix` cannot be combined with `colon_in_label`\"\n                )\n        else:\n            splitlabel = label.split(\":\", 1)\n            if len(splitlabel) == 2 and not splitlabel[1].startswith(\"//\"):\n                label = splitlabel[1]\n                if prefix and prefix != splitlabel[0]:\n                    warnings.warn(\n                        f\"Prefix given both as argument ({prefix}) \"\n                        f\"and in label ({splitlabel[0]}). \"\n                        \"Prefix given in argument takes precedence. \"\n                    )\n                if not prefix:\n                    prefix = splitlabel[0]\n\n        if prefix:\n            entityset = self.get_by_label_all(\n                label,\n                label_annotations=label_annotations,\n                prefix=prefix,\n            )\n            if len(entityset) == 1:\n                return entityset.pop()\n            if len(entityset) &gt; 1:\n                raise AmbiguousLabelError(\n                    f\"Several entities have the same label '{label}' \"\n                    f\"with prefix '{prefix}'.\"\n                )\n            raise NoSuchLabelError(\n                f\"No label annotations matches for '{label}' \"\n                f\"with prefix '{prefix}'.\"\n            )\n\n        # Label is a full IRI\n        entity = self.world[label]\n        if entity:\n            return entity\n\n        get_triples = (\n            self.world._get_data_triples_spod_spod\n            if imported\n            else self._get_data_triples_spod_spod\n        )\n\n        for storid in self._to_storids(label_annotations):\n            for s, _, _, _ in get_triples(None, storid, label, None):\n                return self.world[self._unabbreviate(s)]\n\n        # Special labels\n        if self._special_labels and label in self._special_labels:\n            return self._special_labels[label]\n\n        # Check if label is a name under base_iri\n        entity = self.world[self.base_iri + label]\n        if entity:\n            return entity\n\n        # Check label is the name of an entity\n        for entity in self.get_entities(imported=imported):\n            if label == entity.name:\n                return entity\n\n        raise NoSuchLabelError(f\"No label annotations matches '{label}'\")\n\n    def get_by_label_all(\n        self,\n        label,\n        label_annotations=None,\n        prefix=None,\n        exact_match=False,\n    ) -&gt; \"Set[Optional[owlready2.entity.EntityClass]]\":\n        \"\"\"Returns set of entities with label annotation `label`.\n\n        Arguments:\n           label: label so search for.\n               May be written as 'label' or 'prefix:label'.  Wildcard matching\n               using glob pattern is also supported if `exact_match` is set to\n               false.\n           label_annotations: a sequence of label annotation names to look up.\n               Defaults to the `label_annotations` property.\n           prefix: if provided, it should be the last component of\n               the base iri of an ontology (with trailing slash (/) or hash\n               (#) stripped off).  The search for a matching label will be\n               limited to this namespace.\n           exact_match: Do not treat \"*\" and brackets as special characters\n               when matching.  May be useful if your ontology has labels\n               containing such labels.\n\n        Returns:\n            Set of all matching entities or an empty set if no matches\n            could be found.\n        \"\"\"\n        if not isinstance(label, str):\n            raise TypeError(\n                f\"Invalid label definition, \" f\"must be a string: {label!r}\"\n            )\n        if \" \" in label:\n            raise ValueError(\n                f\"Invalid label definition, {label!r} contains spaces.\"\n            )\n\n        if label_annotations is None:\n            label_annotations = self.label_annotations\n\n        entities = set()\n\n        # Check label annotations\n        if exact_match:\n            for storid in self._to_storids(label_annotations):\n                entities.update(\n                    self.world._get_by_storid(s)\n                    for s, _, _ in self.world._get_data_triples_spod_spod(\n                        None, storid, str(label), None\n                    )\n                )\n        else:\n            for storid in self._to_storids(label_annotations):\n                label_entity = self._unabbreviate(storid)\n                key = (\n                    label_entity.name\n                    if hasattr(label_entity, \"name\")\n                    else label_entity\n                )\n                entities.update(self.world.search(**{key: label}))\n\n        if self._special_labels and label in self._special_labels:\n            entities.update(self._special_labels[label])\n\n        # Check name-part of IRI\n        if exact_match:\n            entities.update(\n                ent for ent in self.get_entities() if ent.name == str(label)\n            )\n        else:\n            matches = fnmatch.filter(\n                (ent.name for ent in self.get_entities()), label\n            )\n            entities.update(\n                ent for ent in self.get_entities() if ent.name in matches\n            )\n\n        if prefix:\n            return set(\n                ent\n                for ent in entities\n                if ent.namespace.ontology.prefix == prefix\n            )\n        return entities\n\n    def _to_storids(self, sequence, create_if_missing=False):\n        \"\"\"Return a list of storid's corresponding to the elements in the\n        sequence `sequence`.\n\n        The elements may be either be full IRIs (strings) or Owlready2\n        entities with an associated storid.\n\n        If `create_if_missing` is true, new Owlready2 entities will be\n        created for IRIs that not already are associated with an\n        entity.  Otherwise such IRIs will be skipped in the returned\n        list.\n        \"\"\"\n        if not sequence:\n            return []\n        storids = []\n        for element in sequence:\n            if hasattr(element, \"storid\"):\n                storids.append(element.storid)\n            else:\n                storid = self.world._abbreviate(element, create_if_missing)\n                if storid:\n                    storids.append(storid)\n        return storids\n\n    def add_label_annotation(self, iri):\n        \"\"\"Adds label annotation used by get_by_label().\"\"\"\n        warnings.warn(\n            \"Ontology.add_label_annotations() is deprecated. \"\n            \"Direct modify the `label_annotations` attribute instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        if hasattr(iri, \"iri\"):\n            iri = iri.iri\n        if iri not in self.label_annotations:\n            self.label_annotations.append(iri)\n\n    def remove_label_annotation(self, iri):\n        \"\"\"Removes label annotation used by get_by_label().\"\"\"\n        warnings.warn(\n            \"Ontology.remove_label_annotations() is deprecated. \"\n            \"Direct modify the `label_annotations` attribute instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        if hasattr(iri, \"iri\"):\n            iri = iri.iri\n        try:\n            self.label_annotations.remove(iri)\n        except ValueError:\n            pass\n\n    def set_common_prefix(\n        self,\n        iri_base: str = \"http://emmo.info/emmo\",\n        prefix: str = \"emmo\",\n        visited: \"Optional[Set]\" = None,\n    ) -&gt; None:\n        \"\"\"Set a common prefix for all imported ontologies\n        with the same first part of the base_iri.\n\n        Args:\n            iri_base: The start of the base_iri to look for. Defaults to\n                the emmo base_iri http://emmo.info/emmo\n            prefix: the desired prefix. Defaults to emmo.\n            visited: Ontologies to skip. Only intended for internal use.\n        \"\"\"\n        if visited is None:\n            visited = set()\n        if self.base_iri.startswith(iri_base):\n            self.prefix = prefix\n        for onto in self.imported_ontologies:\n            if not onto in visited:\n                visited.add(onto)\n                onto.set_common_prefix(\n                    iri_base=iri_base, prefix=prefix, visited=visited\n                )\n\n    def load(  # pylint: disable=too-many-arguments,arguments-renamed\n        self,\n        only_local=False,\n        filename=None,\n        format=None,  # pylint: disable=redefined-builtin\n        reload=None,\n        reload_if_newer=False,\n        url_from_catalog=None,\n        catalog_file=\"catalog-v001.xml\",\n        emmo_based=True,\n        prefix=None,\n        prefix_emmo=None,\n        **kwargs,\n    ):\n        \"\"\"Load the ontology.\n\n        Arguments\n        ---------\n        only_local: bool\n            Whether to only read local files.  This requires that you\n            have appended the path to the ontology to owlready2.onto_path.\n        filename: str\n            Path to file to load the ontology from.  Defaults to `base_iri`\n            provided to get_ontology().\n        format: str\n            Format of `filename`.  Default is inferred from `filename`\n            extension.\n        reload: bool\n            Whether to reload the ontology if it is already loaded.\n        reload_if_newer: bool\n            Whether to reload the ontology if the source has changed since\n            last time it was loaded.\n        url_from_catalog: bool | None\n            Whether to use catalog file to resolve the location of `base_iri`.\n            If None, the catalog file is used if it exists in the same\n            directory as `filename`.\n        catalog_file: str\n            Name of Prot\u00e8g\u00e8 catalog file in the same folder as the\n            ontology.  This option is used together with `only_local` and\n            defaults to \"catalog-v001.xml\".\n        emmo_based: bool\n            Whether this is an EMMO-based ontology or not, default `True`.\n        prefix: defaults to self.get_namespace.name if\n        prefix_emmo: bool, default None. If emmo_based is True it\n            defaults to True and sets the prefix of all imported ontologies\n            with base_iri starting with 'http://emmo.info/emmo' to emmo\n        kwargs:\n            Additional keyword arguments are passed on to\n            owlready2.Ontology.load().\n        \"\"\"\n        # TODO: make sure that `only_local` argument is respected...\n\n        if self.loaded:\n            return self\n        self._load(\n            only_local=only_local,\n            filename=filename,\n            format=format,\n            reload=reload,\n            reload_if_newer=reload_if_newer,\n            url_from_catalog=url_from_catalog,\n            catalog_file=catalog_file,\n            **kwargs,\n        )\n\n        # Enable optimised search by get_by_label()\n        if self._special_labels is None and emmo_based:\n            top = self.world[\"http://www.w3.org/2002/07/owl#topObjectProperty\"]\n            self._special_labels = {\n                \"Thing\": owlready2.Thing,\n                \"Nothing\": owlready2.Nothing,\n                \"topObjectProperty\": top,\n                \"owl:Thing\": owlready2.Thing,\n                \"owl:Nothing\": owlready2.Nothing,\n                \"owl:topObjectProperty\": top,\n            }\n        # set prefix if another prefix is desired\n        # if we do this, shouldn't we make the name of all\n        # entities of the given ontology to the same?\n        if prefix:\n            self.prefix = prefix\n        else:\n            self.prefix = self.name\n\n        if emmo_based and prefix_emmo is None:\n            prefix_emmo = True\n        if prefix_emmo:\n            self.set_common_prefix()\n\n        return self\n\n    def _load(  # pylint: disable=too-many-arguments,too-many-locals,too-many-branches,too-many-statements\n        self,\n        only_local=False,\n        filename=None,\n        format=None,  # pylint: disable=redefined-builtin\n        reload=None,\n        reload_if_newer=False,\n        url_from_catalog=None,\n        catalog_file=\"catalog-v001.xml\",\n        **kwargs,\n    ):\n        \"\"\"Help function for load().\"\"\"\n        web_protocol = \"http://\", \"https://\", \"ftp://\"\n        url = str(filename) if filename else self.base_iri.rstrip(\"/#\")\n        if url.startswith(web_protocol):\n            baseurl = os.path.dirname(url)\n            catalogurl = baseurl + \"/\" + catalog_file\n        else:\n            if url.startswith(\"file://\"):\n                url = url[7:]\n            url = os.path.normpath(os.path.abspath(url))\n            baseurl = os.path.dirname(url)\n            catalogurl = os.path.join(baseurl, catalog_file)\n\n        def getmtime(path):\n            if os.path.exists(path):\n                return os.path.getmtime(path)\n            return 0.0\n\n        # Resolve url from catalog file\n        iris = {}\n        dirs = set()\n        if url_from_catalog or url_from_catalog is None:\n            not_reload = not reload and (\n                not reload_if_newer\n                or getmtime(catalogurl)\n                &gt; self.world._cached_catalogs[catalogurl][0]\n            )\n            # get iris from catalog already in cached catalogs\n            if catalogurl in self.world._cached_catalogs and not_reload:\n                _, iris, dirs = self.world._cached_catalogs[catalogurl]\n            # do not update cached_catalogs if url already in _iri_mappings\n            # and reload not forced\n            elif url in self.world._iri_mappings and not_reload:\n                pass\n            # update iris from current catalogurl\n            else:\n                try:\n                    iris, dirs = read_catalog(\n                        uri=catalogurl,\n                        recursive=False,\n                        return_paths=True,\n                        catalog_file=catalog_file,\n                    )\n                except ReadCatalogError:\n                    if url_from_catalog is not None:\n                        raise\n                    self.world._cached_catalogs[catalogurl] = (0.0, {}, set())\n                else:\n                    self.world._cached_catalogs[catalogurl] = (\n                        getmtime(catalogurl),\n                        iris,\n                        dirs,\n                    )\n            self.world._iri_mappings.update(iris)\n        resolved_url = self.world._iri_mappings.get(url, url)\n        # Append paths from catalog file to onto_path\n        for path in sorted(dirs, reverse=True):\n            if path not in owlready2.onto_path:\n                owlready2.onto_path.append(path)\n\n        # Use catalog file to update IRIs of imported ontologies\n        # in internal store and try to load again...\n        if self.world._iri_mappings:\n            for abbrev_iri in self.world._get_obj_triples_sp_o(\n                self.storid, owlready2.owl_imports\n            ):\n                iri = self._unabbreviate(abbrev_iri)\n                if iri in self.world._iri_mappings:\n                    self._del_obj_triple_spo(\n                        self.storid, owlready2.owl_imports, abbrev_iri\n                    )\n                    self._add_obj_triple_spo(\n                        self.storid,\n                        owlready2.owl_imports,\n                        self._abbreviate(self.world._iri_mappings[iri]),\n                    )\n\n        # Load ontology\n        try:\n            self.loaded = False\n            fmt = format if format else guess_format(resolved_url, fmap=FMAP)\n            if fmt and fmt not in OWLREADY2_FORMATS:\n                # Convert filename to rdfxml before passing it to owlready2\n                graph = rdflib.Graph()\n                try:\n                    graph.parse(resolved_url, format=fmt)\n                except URLError as err:\n                    raise EMMOntoPyException(\n                        \"URL error\", err, resolved_url\n                    ) from err\n\n                with tempfile.NamedTemporaryFile() as handle:\n                    graph.serialize(destination=handle, format=\"xml\")\n                    handle.seek(0)\n                    return super().load(\n                        only_local=True,\n                        fileobj=handle,\n                        reload=reload,\n                        reload_if_newer=reload_if_newer,\n                        format=\"rdfxml\",\n                        **kwargs,\n                    )\n            elif resolved_url.startswith(web_protocol):\n                return super().load(\n                    only_local=only_local,\n                    reload=reload,\n                    reload_if_newer=reload_if_newer,\n                    **kwargs,\n                )\n\n            else:\n                with open(resolved_url, \"rb\") as handle:\n                    return super().load(\n                        only_local=only_local,\n                        fileobj=handle,\n                        reload=reload,\n                        reload_if_newer=reload_if_newer,\n                        **kwargs,\n                    )\n        except owlready2.OwlReadyOntologyParsingError:\n            # Owlready2 is not able to parse the ontology - most\n            # likely because imported ontologies must be resolved\n            # using the catalog file.\n\n            # Reraise if we don't want to read from the catalog file\n            if not url_from_catalog and url_from_catalog is not None:\n                raise\n\n            warnings.warn(\n                \"Recovering from Owlready2 parsing error... might be deprecated\"\n            )\n\n            # Copy the ontology into a local folder and try again\n            with tempfile.TemporaryDirectory() as handle:\n                output = os.path.join(handle, os.path.basename(resolved_url))\n                convert_imported(\n                    input_ontology=resolved_url,\n                    output_ontology=output,\n                    input_format=fmt,\n                    output_format=\"xml\",\n                    url_from_catalog=url_from_catalog,\n                    catalog_file=catalog_file,\n                )\n\n                self.loaded = False\n                with open(output, \"rb\") as handle:\n                    try:\n                        return super().load(\n                            only_local=True,\n                            fileobj=handle,\n                            reload=reload,\n                            reload_if_newer=reload_if_newer,\n                            format=\"rdfxml\",\n                            **kwargs,\n                        )\n                    except HTTPError as exc:  # Add url to HTTPError message\n                        raise HTTPError(\n                            url=exc.url,\n                            code=exc.code,\n                            msg=f\"{exc.url}: {exc.msg}\",\n                            hdrs=exc.hdrs,\n                            fp=exc.fp,\n                        ).with_traceback(exc.__traceback__)\n\n        except HTTPError as exc:  # Add url to HTTPError message\n            raise HTTPError(\n                url=exc.url,\n                code=exc.code,\n                msg=f\"{exc.url}: {exc.msg}\",\n                hdrs=exc.hdrs,\n                fp=exc.fp,\n            ).with_traceback(exc.__traceback__)\n\n    def save(\n        self,\n        filename=None,\n        format=None,\n        dir=\".\",\n        mkdir=False,\n        overwrite=False,\n        recursive=False,\n        squash=False,\n        write_catalog_file=False,\n        append_catalog=False,\n        catalog_file=\"catalog-v001.xml\",\n        **kwargs,\n    ) -&gt; Path:\n        \"\"\"Writes the ontology to file.\n\n        Parameters\n        ----------\n        filename: None | str | Path\n            Name of file to write to.  If None, it defaults to the name\n            of the ontology with `format` as file extension.\n        format: str\n            Output format. The default is to infer it from `filename`.\n        dir: str | Path\n            If `filename` is a relative path, it is a relative path to `dir`.\n        mkdir: bool\n            Whether to create output directory if it does not exists.\n        owerwrite: bool\n            If true and `filename` exists, remove the existing file before\n            saving.  The default is to append to an existing ontology.\n        recursive: bool\n            Whether to save imported ontologies recursively.  This is\n            commonly combined with `filename=None`, `dir` and `mkdir`.\n            Note that depending on the structure of the ontology and\n            all imports the ontology might end up in a subdirectory.\n            If filename is given, the ontology is saved to the given\n            directory.\n            The path to the final location is returned.\n        squash: bool\n            If true, rdflib will be used to save the current ontology\n            together with all its sub-ontologies into `filename`.\n            It makes no sense to combine this with `recursive`.\n        write_catalog_file: bool\n            Whether to also write a catalog file to disk.\n        append_catalog: bool\n            Whether to append to an existing catalog file.\n        catalog_file: str | Path\n            Name of catalog file.  If not an absolute path, it is prepended\n            to `dir`.\n\n        Returns\n        --------\n            The path to the saved ontology.\n        \"\"\"\n        # pylint: disable=redefined-builtin,too-many-arguments\n        # pylint: disable=too-many-statements,too-many-branches\n        # pylint: disable=too-many-locals,arguments-renamed,invalid-name\n\n        if not _validate_installed_version(\n            package=\"rdflib\", min_version=\"6.0.0\"\n        ) and format == FMAP.get(\"ttl\", \"\"):\n            from rdflib import (  # pylint: disable=import-outside-toplevel\n                __version__ as __rdflib_version__,\n            )\n\n            warnings.warn(\n                IncompatibleVersion(\n                    \"To correctly convert to Turtle format, rdflib must be \"\n                    \"version 6.0.0 or greater, however, the detected rdflib \"\n                    \"version used by your Python interpreter is \"\n                    f\"{__rdflib_version__!r}. For more information see the \"\n                    \"'Known issues' section of the README.\"\n                )\n            )\n        revmap = {value: key for key, value in FMAP.items()}\n        if filename is None:\n            if format:\n                fmt = revmap.get(format, format)\n                file = f\"{self.name}.{fmt}\"\n            else:\n                raise TypeError(\"`filename` and `format` cannot both be None.\")\n        else:\n            file = filename\n        filepath = os.path.join(\n            dir, file if isinstance(file, (str, Path)) else file.name\n        )\n        returnpath = filepath\n\n        dir = Path(filepath).resolve().parent\n\n        if mkdir:\n            outdir = Path(filepath).parent.resolve()\n            if not outdir.exists():\n                outdir.mkdir(parents=True)\n\n        if not format:\n            format = guess_format(file, fmap=FMAP)\n        fmt = revmap.get(format, format)\n\n        if overwrite and os.path.exists(filepath):\n            os.remove(filepath)\n\n        if recursive:\n            if squash:\n                raise ValueError(\n                    \"`recursive` and `squash` should not both be true\"\n                )\n            layout = directory_layout(self)\n            if filename:\n                layout[self] = file.rstrip(f\".{fmt}\")\n            # Update path to where the ontology is saved\n            # Note that filename should include format\n            # when given\n            returnpath = Path(dir) / f\"{layout[self]}.{fmt}\"\n            for onto, path in layout.items():\n                fname = Path(dir) / f\"{path}.{fmt}\"\n                onto.save(\n                    filename=fname,\n                    format=format,\n                    dir=dir,\n                    mkdir=mkdir,\n                    overwrite=overwrite,\n                    recursive=False,\n                    squash=False,\n                    write_catalog_file=False,\n                    **kwargs,\n                )\n\n            if write_catalog_file:\n                catalog_files = set()\n                irimap = {}\n                for onto, path in layout.items():\n                    irimap[onto.get_version(as_iri=True)] = (\n                        f\"{dir}/{path}.{fmt}\"\n                    )\n                    catalog_files.add(Path(path).parent / catalog_file)\n\n                for catfile in catalog_files:\n                    write_catalog(\n                        irimap.copy(),\n                        output=catfile,\n                        directory=dir,\n                        append=append_catalog,\n                    )\n        elif squash:\n            URIRef, RDF, OWL = rdflib.URIRef, rdflib.RDF, rdflib.OWL\n\n            # Make a copy of the owlready2 graph object to not mess with\n            # owlready2 internals\n            graph = rdflib.Graph()\n            for triple in self.world.as_rdflib_graph():\n                graph.add(triple)\n\n            # Add common namespaces unknown to rdflib\n            extra_namespaces = [\n                (\"\", self.base_iri),\n                (\"swrl\", \"http://www.w3.org/2003/11/swrl#\"),\n                (\"bibo\", \"http://purl.org/ontology/bibo/\"),\n            ]\n            for prefix, iri in extra_namespaces:\n                graph.namespace_manager.bind(\n                    prefix, rdflib.Namespace(iri), override=False\n                )\n\n            # Remove all ontology-declarations in the graph that are\n            # not the current ontology.\n            for s, _, _ in graph.triples(  # pylint: disable=not-an-iterable\n                (None, RDF.type, OWL.Ontology)\n            ):\n                if str(s).rstrip(\"/#\") != self.base_iri.rstrip(\"/#\"):\n                    for (\n                        _,\n                        p,\n                        o,\n                    ) in graph.triples(  # pylint: disable=not-an-iterable\n                        (s, None, None)\n                    ):\n                        graph.remove((s, p, o))\n                graph.remove((s, OWL.imports, None))\n\n            # Insert correct IRI of the ontology\n            if self.iri:\n                base_iri = URIRef(self.base_iri)\n                for s, p, o in graph.triples(  # pylint: disable=not-an-iterable\n                    (base_iri, None, None)\n                ):\n                    graph.remove((s, p, o))\n                    graph.add((URIRef(self.iri), p, o))\n\n            graph.serialize(destination=filepath, format=format)\n        elif format in OWLREADY2_FORMATS:\n            super().save(file=filepath, format=fmt, **kwargs)\n        else:\n            # The try-finally clause is needed for cleanup and because\n            # we have to provide delete=False to NamedTemporaryFile\n            # since Windows does not allow to reopen an already open\n            # file.\n            try:\n                with tempfile.NamedTemporaryFile(\n                    suffix=\".owl\", delete=False\n                ) as handle:\n                    tmpfile = handle.name\n                super().save(tmpfile, format=\"ntriples\", **kwargs)\n                graph = rdflib.Graph()\n                graph.parse(tmpfile, format=\"ntriples\")\n                graph.namespace_manager.bind(\n                    \"\", rdflib.Namespace(self.base_iri)\n                )\n                if self.iri:\n                    base_iri = rdflib.URIRef(self.base_iri)\n                    for (\n                        s,\n                        p,\n                        o,\n                    ) in graph.triples(  # pylint: disable=not-an-iterable\n                        (base_iri, None, None)\n                    ):\n                        graph.remove((s, p, o))\n                        graph.add((rdflib.URIRef(self.iri), p, o))\n                graph.serialize(destination=filepath, format=format)\n            finally:\n                os.remove(tmpfile)\n\n        if write_catalog_file and not recursive:\n            write_catalog(\n                {self.get_version(as_iri=True): filepath},\n                output=catalog_file,\n                directory=dir,\n                append=append_catalog,\n            )\n        return Path(returnpath)\n\n    def copy(self):\n        \"\"\"Return a copy of the ontology.\"\"\"\n        with tempfile.TemporaryDirectory() as dirname:\n            filename = self.save(\n                dir=dirname,\n                format=\"turtle\",\n                recursive=True,\n                write_catalog_file=True,\n                mkdir=True,\n            )\n            ontology = get_ontology(filename).load()\n            ontology.name = self.name\n        return ontology\n\n    def get_imported_ontologies(self, recursive=False):\n        \"\"\"Return a list with imported ontologies.\n\n        If `recursive` is `True`, ontologies imported by imported ontologies\n        are also returned.\n        \"\"\"\n\n        def rec_imported(onto):\n            for ontology in onto.imported_ontologies:\n                # pylint: disable=possibly-used-before-assignment\n                if ontology not in imported:\n                    imported.add(ontology)\n                    rec_imported(ontology)\n\n        if recursive:\n            imported = set()\n            rec_imported(self)\n            return list(imported)\n\n        return self.imported_ontologies\n\n    def get_entities(  # pylint: disable=too-many-arguments\n        self,\n        imported=True,\n        classes=True,\n        individuals=True,\n        object_properties=True,\n        data_properties=True,\n        annotation_properties=True,\n    ):\n        \"\"\"Return a generator over (optionally) all classes, individuals,\n        object_properties, data_properties and annotation_properties.\n\n        If `imported` is `True`, entities in imported ontologies will also\n        be included.\n        \"\"\"\n        generator = []\n        if classes:\n            generator.append(self.classes(imported))\n        if individuals:\n            generator.append(self.individuals(imported))\n        if object_properties:\n            generator.append(self.object_properties(imported))\n        if data_properties:\n            generator.append(self.data_properties(imported))\n        if annotation_properties:\n            generator.append(self.annotation_properties(imported))\n        yield from itertools.chain(*generator)\n\n    def classes(self, imported=False):\n        \"\"\"Returns an generator over all classes.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"classes\", imported=imported)\n\n    def _entities(\n        self, entity_type, imported=False\n    ):  # pylint: disable=too-many-branches\n        \"\"\"Returns an generator over all entities of the desired type.\n        This is a helper function for `classes()`, `individuals()`,\n        `object_properties()`, `data_properties()` and\n        `annotation_properties()`.\n\n        Arguments:\n            entity_type: The type of entity desired given as a string.\n                Can be any of `classes`, `individuals`,\n                `object_properties`, `data_properties` and\n                `annotation_properties`.\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n\n        generator = []\n        if imported:\n            ontologies = self.get_imported_ontologies(recursive=True)\n            ontologies.append(self)\n            for onto in ontologies:\n                if entity_type == \"classes\":\n                    for cls in list(onto.classes()):\n                        generator.append(cls)\n                elif entity_type == \"individuals\":\n                    for ind in list(onto.individuals()):\n                        generator.append(ind)\n                elif entity_type == \"object_properties\":\n                    for prop in list(onto.object_properties()):\n                        generator.append(prop)\n                elif entity_type == \"data_properties\":\n                    for prop in list(onto.data_properties()):\n                        generator.append(prop)\n                elif entity_type == \"annotation_properties\":\n                    for prop in list(onto.annotation_properties()):\n                        generator.append(prop)\n        else:\n            if entity_type == \"classes\":\n                generator = super().classes()\n            elif entity_type == \"individuals\":\n                generator = super().individuals()\n            elif entity_type == \"object_properties\":\n                generator = super().object_properties()\n            elif entity_type == \"data_properties\":\n                generator = super().data_properties()\n            elif entity_type == \"annotation_properties\":\n                generator = super().annotation_properties()\n\n        yield from generator\n\n    def individuals(self, imported=False):\n        \"\"\"Returns an generator over all individuals.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"individuals\", imported=imported)\n\n    def object_properties(self, imported=False):\n        \"\"\"Returns an generator over all object_properties.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"object_properties\", imported=imported)\n\n    def data_properties(self, imported=False):\n        \"\"\"Returns an generator over all data_properties.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"data_properties\", imported=imported)\n\n    def annotation_properties(self, imported=False):\n        \"\"\"Returns an generator over all annotation_properties.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n\n        \"\"\"\n        return self._entities(\"annotation_properties\", imported=imported)\n\n    def get_root_classes(self, imported=False):\n        \"\"\"Returns a list or root classes.\"\"\"\n        return [\n            cls\n            for cls in self.classes(imported=imported)\n            if not cls.ancestors().difference(set([cls, owlready2.Thing]))\n        ]\n\n    def get_root_object_properties(self, imported=False):\n        \"\"\"Returns a list of root object properties.\"\"\"\n        props = set(self.object_properties(imported=imported))\n        return [p for p in props if not props.intersection(p.is_a)]\n\n    def get_root_data_properties(self, imported=False):\n        \"\"\"Returns a list of root object properties.\"\"\"\n        props = set(self.data_properties(imported=imported))\n        return [p for p in props if not props.intersection(p.is_a)]\n\n    def get_roots(self, imported=False):\n        \"\"\"Returns all class, object_property and data_property roots.\"\"\"\n        roots = self.get_root_classes(imported=imported)\n        roots.extend(self.get_root_object_properties(imported=imported))\n        roots.extend(self.get_root_data_properties(imported=imported))\n        return roots\n\n    def sync_python_names(self, annotations=(\"prefLabel\", \"label\", \"altLabel\")):\n        \"\"\"Update the `python_name` attribute of all properties.\n\n        The python_name attribute will be set to the first non-empty\n        annotation in the sequence of annotations in `annotations` for\n        the property.\n        \"\"\"\n\n        def update(gen):\n            for prop in gen:\n                for annotation in annotations:\n                    if hasattr(prop, annotation) and getattr(prop, annotation):\n                        prop.python_name = getattr(prop, annotation).first()\n                        break\n\n        update(\n            self.get_entities(\n                classes=False,\n                individuals=False,\n                object_properties=False,\n                data_properties=False,\n            )\n        )\n        update(\n            self.get_entities(\n                classes=False, individuals=False, annotation_properties=False\n            )\n        )\n\n    def rename_entities(\n        self,\n        annotations=(\"prefLabel\", \"label\", \"altLabel\"),\n    ):\n        \"\"\"Set `name` of all entities to the first non-empty annotation in\n        `annotations`.\n\n        Warning, this method changes all IRIs in the ontology.  However,\n        it may be useful to make the ontology more readable and to work\n        with it together with a triple store.\n        \"\"\"\n        for entity in self.get_entities():\n            for annotation in annotations:\n                if hasattr(entity, annotation):\n                    name = getattr(entity, annotation).first()\n                    if name:\n                        entity.name = name\n                        break\n\n    def sync_reasoner(\n        self, reasoner=\"HermiT\", include_imported=False, **kwargs\n    ):\n        \"\"\"Update current ontology by running the given reasoner.\n\n        Supported values for `reasoner` are 'HermiT' (default), Pellet\n        and 'FaCT++'.\n\n        If `include_imported` is true, the reasoner will also reason\n        over imported ontologies.  Note that this may be **very** slow.\n\n        Keyword arguments are passed to the underlying owlready2 function.\n        \"\"\"\n        # pylint: disable=too-many-branches\n\n        removed_equivalent = defaultdict(list)\n        removed_subclasses = defaultdict(list)\n\n        if reasoner == \"FaCT++\":\n            sync = sync_reasoner_factpp\n        elif reasoner == \"Pellet\":\n            sync = owlready2.sync_reasoner_pellet\n        elif reasoner == \"HermiT\":\n            sync = owlready2.sync_reasoner_hermit\n\n            # Remove custom data propertyes, otherwise HermiT will crash\n            datatype_iri = \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n\n            for cls in self.classes(imported=include_imported):\n                remove_eq = []\n                for i, r in enumerate(cls.equivalent_to):\n                    if isinstance(r, owlready2.Restriction):\n                        if (\n                            hasattr(r.value.__class__, \"iri\")\n                            and r.value.__class__.iri == datatype_iri\n                        ):\n                            remove_eq.append(i)\n                            removed_equivalent[cls].append(r)\n                for i in reversed(remove_eq):\n                    del cls.equivalent_to[i]\n\n                remove_subcls = []\n                for i, r in enumerate(cls.is_a):\n                    if isinstance(r, owlready2.Restriction):\n                        if (\n                            hasattr(r.value.__class__, \"iri\")\n                            and r.value.__class__.iri == datatype_iri\n                        ):\n                            remove_subcls.append(i)\n                            removed_subclasses[cls].append(r)\n                for i in reversed(remove_subcls):\n                    del cls.is_a[i]\n\n        else:\n            raise ValueError(\n                f\"Unknown reasoner '{reasoner}'. Supported reasoners \"\n                \"are 'Pellet', 'HermiT' and 'FaCT++'.\"\n            )\n\n        # For some reason we must visit all entities once before running\n        # the reasoner...\n        list(self.get_entities())\n\n        with self:\n            if include_imported:\n                sync(self.world, **kwargs)\n            else:\n                sync(self, **kwargs)\n\n        # Restore removed custom data properties\n        for cls, eqs in removed_equivalent.items():\n            cls.extend(eqs)\n        for cls, subcls in removed_subclasses.items():\n            cls.extend(subcls)\n\n    def sync_attributes(  # pylint: disable=too-many-branches\n        self,\n        name_policy=None,\n        name_prefix=\"\",\n        class_docstring=\"comment\",\n        sync_imported=False,\n    ):\n        \"\"\"This method is intended to be called after you have added new\n        classes (typically via Python) to make sure that attributes like\n        `label` and `comments` are defined.\n\n        If a class, object property, data property or annotation\n        property in the current ontology has no label, the name of\n        the corresponding Python class will be assigned as label.\n\n        If a class, object property, data property or annotation\n        property has no comment, it will be assigned the docstring of\n        the corresponding Python class.\n\n        `name_policy` specify wether and how the names in the ontology\n        should be updated.  Valid values are:\n          None          not changed\n          \"uuid\"        `name_prefix` followed by a global unique id (UUID).\n                        If the name is already valid accoridng to this standard\n                        it will not be regenerated.\n          \"sequential\"  `name_prefix` followed a sequantial number.\n        EMMO conventions imply ``name_policy=='uuid'``.\n\n        If `sync_imported` is true, all imported ontologies are also\n        updated.\n\n        The `class_docstring` argument specifies the annotation that\n        class docstrings are mapped to.  Defaults to \"comment\".\n        \"\"\"\n        for cls in itertools.chain(\n            self.classes(),\n            self.object_properties(),\n            self.data_properties(),\n            self.annotation_properties(),\n        ):\n            if not hasattr(cls, \"prefLabel\"):\n                # no prefLabel - create new annotation property..\n                with self:\n                    # pylint: disable=invalid-name,missing-class-docstring\n                    # pylint: disable=unused-variable\n                    class prefLabel(owlready2.label):\n                        pass\n\n                cls.prefLabel = [locstr(cls.__name__, lang=\"en\")]\n            elif not cls.prefLabel:\n                cls.prefLabel.append(locstr(cls.__name__, lang=\"en\"))\n            if class_docstring and hasattr(cls, \"__doc__\") and cls.__doc__:\n                getattr(cls, class_docstring).append(\n                    locstr(inspect.cleandoc(cls.__doc__), lang=\"en\")\n                )\n\n        for ind in self.individuals():\n            if not hasattr(ind, \"prefLabel\"):\n                # no prefLabel - create new annotation property..\n                with self:\n                    # pylint: disable=invalid-name,missing-class-docstring\n                    # pylint: disable=function-redefined\n                    class prefLabel(owlready2.label):\n                        iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n\n                ind.prefLabel = [locstr(ind.name, lang=\"en\")]\n            elif not ind.prefLabel:\n                ind.prefLabel.append(locstr(ind.name, lang=\"en\"))\n\n        chain = itertools.chain(\n            self.classes(),\n            self.individuals(),\n            self.object_properties(),\n            self.data_properties(),\n            self.annotation_properties(),\n        )\n        if name_policy == \"uuid\":\n            for obj in chain:\n                try:\n                    # Passing the following means that the name is valid\n                    # and need not be regenerated.\n                    if not obj.name.startswith(name_prefix):\n                        raise ValueError\n                    uuid.UUID(obj.name.lstrip(name_prefix), version=5)\n                except ValueError:\n                    obj.name = name_prefix + str(\n                        uuid.uuid5(uuid.NAMESPACE_DNS, obj.name)\n                    )\n        elif name_policy == \"sequential\":\n            for obj in chain:\n                counter = 0\n                while f\"{self.base_iri}{name_prefix}{counter}\" in self:\n                    counter += 1\n                obj.name = f\"{name_prefix}{counter}\"\n        elif name_policy is not None:\n            raise TypeError(f\"invalid name_policy: {name_policy!r}\")\n\n        if sync_imported:\n            for onto in self.imported_ontologies:\n                onto.sync_attributes()\n\n    def get_relations(self):\n        \"\"\"Returns a generator for all relations.\"\"\"\n        warnings.warn(\n            \"Ontology.get_relations() is deprecated. Use \"\n            \"onto.object_properties() instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        return self.object_properties()\n\n    def get_annotations(self, entity):\n        \"\"\"Returns a dict with annotations for `entity`.  Entity may be given\n        either as a ThingClass object or as a label.\"\"\"\n        warnings.warn(\n            \"Ontology.get_annotations(entity) is deprecated. Use \"\n            \"entity.get_annotations() instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n\n        if isinstance(entity, str):\n            entity = self.get_by_label(entity)\n        res = {\"comment\": getattr(entity, \"comment\", \"\")}\n        for annotation in self.annotation_properties():\n            res[annotation.label.first()] = [\n                obj.strip('\"')\n                for _, _, obj in self.get_triples(\n                    entity.storid, annotation.storid, None\n                )\n            ]\n        return res\n\n    def get_branch(  # pylint: disable=too-many-arguments\n        self,\n        root,\n        leaves=(),\n        include_leaves=True,\n        strict_leaves=False,\n        exclude=None,\n        sort=False,\n    ):\n        \"\"\"Returns a set with all direct and indirect subclasses of `root`.\n        Any subclass found in the sequence `leaves` will be included in\n        the returned list, but its subclasses will not.  The elements\n        of `leaves` may be ThingClass objects or labels.\n\n        Subclasses of any subclass found in the sequence `leaves` will\n        be excluded from the returned list, where the elements of `leaves`\n        may be ThingClass objects or labels.\n\n        If `include_leaves` is true, the leaves are included in the returned\n        list, otherwise they are not.\n\n        If `strict_leaves` is true, any descendant of a leaf will be excluded\n        in the returned set.\n\n        If given, `exclude` may be a sequence of classes, including\n        their subclasses, to exclude from the output.\n\n        If `sort` is True, a list sorted according to depth and label\n        will be returned instead of a set.\n        \"\"\"\n\n        def _branch(root, leaves):\n            if root not in leaves:\n                branch = {\n                    root,\n                }\n                for cls in root.subclasses():\n                    # Defining a branch is actually quite tricky.  Consider\n                    # the case:\n                    #\n                    #      L isA R\n                    #      A isA L\n                    #      A isA R\n                    #\n                    # where R is the root, L is a leaf and A is a direct\n                    # child of both.  Logically, since A is a child of the\n                    # leaf we want to skip A.  But a strait forward imple-\n                    # mentation will see that A is a child of the root and\n                    # include it.  Requireing that the R should be a strict\n                    # parent of A solves this.\n                    if root in cls.get_parents(strict=True):\n                        branch.update(_branch(cls, leaves))\n            else:\n                branch = (\n                    {\n                        root,\n                    }\n                    if include_leaves\n                    else set()\n                )\n            return branch\n\n        if isinstance(root, str):\n            root = self.get_by_label(root)\n\n        leaves = set(\n            self.get_by_label(leaf) if isinstance(leaf, str) else leaf\n            for leaf in leaves\n        )\n        leaves.discard(root)\n\n        if exclude:\n            exclude = set(\n                self.get_by_label(e) if isinstance(e, str) else e\n                for e in exclude\n            )\n            leaves.update(exclude)\n\n        branch = _branch(root, leaves)\n\n        # Exclude all descendants of any leaf\n        if strict_leaves:\n            descendants = root.descendants()\n            for leaf in leaves:\n                if leaf in descendants:\n                    branch.difference_update(\n                        leaf.descendants(include_self=False)\n                    )\n\n        if exclude:\n            branch.difference_update(exclude)\n\n        # Sort according to depth, then by label\n        if sort:\n            branch = sorted(\n                sorted(branch, key=asstring),\n                key=lambda x: len(x.mro()),\n            )\n\n        return branch\n\n    def is_individual(self, entity):\n        \"\"\"Returns true if entity is an individual.\"\"\"\n        if isinstance(entity, str):\n            entity = self.get_by_label(entity)\n        return isinstance(entity, owlready2.Thing)\n\n    # FIXME - deprecate this method as soon the ThingClass property\n    #         `defined_class` works correct in Owlready2\n    def is_defined(self, entity):\n        \"\"\"Returns true if the entity is a defined class.\n\n        Deprecated, use the `is_defined` property of the classes\n        (ThingClass subclasses) instead.\n        \"\"\"\n        warnings.warn(\n            \"This method is deprecated.  Use the `is_defined` property of \"\n            \"the classes instad.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        if isinstance(entity, str):\n            entity = self.get_by_label(entity)\n        return hasattr(entity, \"equivalent_to\") and bool(entity.equivalent_to)\n\n    def get_version(self, as_iri=False) -&gt; str:\n        \"\"\"Returns the version number of the ontology as inferred from the\n        owl:versionIRI tag or, if owl:versionIRI is not found, from\n        owl:versionINFO.\n\n        If `as_iri` is True, the full versionIRI is returned.\n        \"\"\"\n        version_iri_storid = self.world._abbreviate(\n            \"http://www.w3.org/2002/07/owl#versionIRI\"\n        )\n        tokens = self.get_triples(s=self.storid, p=version_iri_storid)\n        if (not tokens) and (as_iri is True):\n            raise TypeError(\n                \"No owl:versionIRI \"\n                f\"in Ontology {self.base_iri!r}. \"\n                \"Search for owl:versionInfo with as_iri=False\"\n            )\n        if tokens:\n            _, _, obj = tokens[0]\n            version_iri = self.world._unabbreviate(obj)\n            if as_iri:\n                return version_iri\n            return infer_version(self.base_iri, version_iri)\n\n        version_info_storid = self.world._abbreviate(\n            \"http://www.w3.org/2002/07/owl#versionInfo\"\n        )\n        tokens = self.get_triples(s=self.storid, p=version_info_storid)\n        if not tokens:\n            raise TypeError(\n                \"No versionIRI or versionInfo \" f\"in Ontology {self.base_iri!r}\"\n            )\n        _, _, version_info = tokens[0]\n        return version_info.split(\"^^\")[0].strip('\"')\n\n    def set_version(self, version=None, version_iri=None):\n        \"\"\"Assign version to ontology by asigning owl:versionIRI.\n\n        If `version` but not `version_iri` is provided, the version\n        IRI will be the combination of `base_iri` and `version`.\n        \"\"\"\n        _version_iri = \"http://www.w3.org/2002/07/owl#versionIRI\"\n        version_iri_storid = self.world._abbreviate(_version_iri)\n        if self._has_obj_triple_spo(  # pylint: disable=unexpected-keyword-arg\n            # For some reason _has_obj_triples_spo exists in both\n            # owlready2.namespace.Namespace (with arguments subject/predicate)\n            # and in owlready2.triplelite._GraphManager (with arguments s/p)\n            # owlready2.Ontology inherits from Namespace directly\n            # and pylint checks that.\n            # It actually accesses the one in triplelite.\n            # subject=self.storid, predicate=version_iri_storid\n            s=self.storid,\n            p=version_iri_storid,\n        ):\n            self._del_obj_triple_spo(s=self.storid, p=version_iri_storid)\n\n        if not version_iri:\n            if not version:\n                raise TypeError(\n                    \"Either `version` or `version_iri` must be provided\"\n                )\n            head, tail = self.base_iri.rstrip(\"#/\").rsplit(\"/\", 1)\n            version_iri = \"/\".join([head, version, tail])\n\n        self._add_obj_triple_spo(\n            s=self.storid,\n            p=self.world._abbreviate(_version_iri),\n            o=self.world._abbreviate(version_iri),\n        )\n\n    def get_graph(self, **kwargs):\n        \"\"\"Returns a new graph object.  See  emmo.graph.OntoGraph.\n\n        Note that this method requires the Python graphviz package.\n        \"\"\"\n        # pylint: disable=import-outside-toplevel,cyclic-import\n        from ontopy.graph import OntoGraph\n\n        return OntoGraph(self, **kwargs)\n\n    @staticmethod\n    def common_ancestors(cls1, cls2):\n        \"\"\"Return a list of common ancestors for `cls1` and `cls2`.\"\"\"\n        return set(cls1.ancestors()).intersection(cls2.ancestors())\n\n    def number_of_generations(self, descendant, ancestor):\n        \"\"\"Return shortest distance from ancestor to descendant\"\"\"\n        if ancestor not in descendant.ancestors():\n            raise ValueError(\"Descendant is not a descendant of ancestor\")\n        return self._number_of_generations(descendant, ancestor, 0)\n\n    def _number_of_generations(self, descendant, ancestor, counter):\n        \"\"\"Recursive help function to number_of_generations(), return\n        distance between a ancestor-descendant pair (counter+1).\"\"\"\n        if descendant.name == ancestor.name:\n            return counter\n        try:\n            return min(\n                self._number_of_generations(parent, ancestor, counter + 1)\n                for parent in descendant.get_parents()\n                if ancestor in parent.ancestors()\n            )\n        except ValueError:\n            return counter\n\n    def closest_common_ancestors(self, cls1, cls2):\n        \"\"\"Returns a list with closest_common_ancestor for cls1 and cls2\"\"\"\n        distances = {}\n        for ancestor in self.common_ancestors(cls1, cls2):\n            distances[ancestor] = self.number_of_generations(\n                cls1, ancestor\n            ) + self.number_of_generations(cls2, ancestor)\n        return [\n            ancestor\n            for ancestor, distance in distances.items()\n            if distance == min(distances.values())\n        ]\n\n    @staticmethod\n    def closest_common_ancestor(*classes):\n        \"\"\"Returns closest_common_ancestor for the given classes.\"\"\"\n        mros = [cls.mro() for cls in classes]\n        track = defaultdict(int)\n        while mros:\n            for mro in mros:\n                cur = mro.pop(0)\n                track[cur] += 1\n                if track[cur] == len(classes):\n                    return cur\n                if len(mro) == 0:\n                    mros.remove(mro)\n        raise EMMOntoPyException(\n            \"A closest common ancestor should always exist !\"\n        )\n\n    def get_ancestors(\n        self,\n        classes: \"Union[List, ThingClass]\",\n        closest: bool = False,\n        generations: int = None,\n        strict: bool = True,\n    ) -&gt; set:\n        \"\"\"Return ancestors of all classes in `classes`.\n        Args:\n            classes: class(es) for which ancestors should be returned.\n            generations: Include this number of generations, default is all.\n            closest: If True, return all ancestors up to and including the\n                closest common ancestor. Return all if False.\n            strict: If True returns only real ancestors, i.e. `classes` are\n                are not included in the returned set.\n        Returns:\n            Set of ancestors to `classes`.\n        \"\"\"\n        if not isinstance(classes, Iterable):\n            classes = [classes]\n\n        ancestors = set()\n        if not classes:\n            return ancestors\n\n        def addancestors(entity, counter, subject):\n            if counter &gt; 0:\n                for parent in entity.get_parents(strict=True):\n                    subject.add(parent)\n                    addancestors(parent, counter - 1, subject)\n\n        if closest:\n            if generations is not None:\n                raise ValueError(\n                    \"Only one of `generations` or `closest` may be specified.\"\n                )\n\n            closest_ancestor = self.closest_common_ancestor(*classes)\n            for cls in classes:\n                ancestors.update(\n                    anc\n                    for anc in cls.ancestors()\n                    if closest_ancestor in anc.ancestors()\n                )\n        elif isinstance(generations, int):\n            for entity in classes:\n                addancestors(entity, generations, ancestors)\n        else:\n            ancestors.update(*(cls.ancestors() for cls in classes))\n\n        if strict:\n            return ancestors.difference(classes)\n        return ancestors\n\n    def get_descendants(\n        self,\n        classes: \"Union[List, ThingClass]\",\n        generations: int = None,\n        common: bool = False,\n    ) -&gt; set:\n        \"\"\"Return descendants/subclasses of all classes in `classes`.\n        Args:\n            classes: class(es) for which descendants are desired.\n            common: whether to only return descendants common to all classes.\n            generations: Include this number of generations, default is all.\n        Returns:\n            A set of descendants for given number of generations.\n            If 'common'=True, the common descendants are returned\n            within the specified number of generations.\n            'generations' defaults to all.\n        \"\"\"\n\n        if not isinstance(classes, Iterable):\n            classes = [classes]\n\n        descendants = {name: [] for name in classes}\n\n        def _children_recursively(num, newentity, parent, descendants):\n            \"\"\"Helper function to get all children up to generation.\"\"\"\n            for child in self.get_children_of(newentity):\n                descendants[parent].append(child)\n                if num &lt; generations:\n                    _children_recursively(num + 1, child, parent, descendants)\n\n        if generations == 0:\n            return set()\n\n        if not generations:\n            for entity in classes:\n                descendants[entity] = entity.descendants()\n                # only include proper descendants\n                descendants[entity].remove(entity)\n        else:\n            for entity in classes:\n                _children_recursively(1, entity, entity, descendants)\n\n        results = descendants.values()\n        if common is True:\n            return set.intersection(*map(set, results))\n        return set(flatten(results))\n\n    def get_wu_palmer_measure(self, cls1, cls2):\n        \"\"\"Return Wu-Palmer measure for semantic similarity.\n\n        Returns Wu-Palmer measure for semantic similarity between\n        two concepts.\n        Wu, Palmer; ACL 94: Proceedings of the 32nd annual meeting on\n        Association for Computational Linguistics, June 1994.\n        \"\"\"\n        cca = self.closest_common_ancestor(cls1, cls2)\n        ccadepth = self.number_of_generations(cca, self.Thing)\n        generations1 = self.number_of_generations(cls1, cca)\n        generations2 = self.number_of_generations(cls2, cca)\n        return 2 * ccadepth / (generations1 + generations2 + 2 * ccadepth)\n\n    def new_entity(\n        self,\n        name: str,\n        parent: Union[\n            ThingClass,\n            ObjectPropertyClass,\n            DataPropertyClass,\n            AnnotationPropertyClass,\n            Iterable,\n        ],\n        entitytype: Optional[\n            Union[\n                str,\n                ThingClass,\n                ObjectPropertyClass,\n                DataPropertyClass,\n                AnnotationPropertyClass,\n            ]\n        ] = \"class\",\n        preflabel: Optional[str] = None,\n    ) -&gt; Union[\n        ThingClass,\n        ObjectPropertyClass,\n        DataPropertyClass,\n        AnnotationPropertyClass,\n    ]:\n        \"\"\"Create and return new entity\n\n        Args:\n            name: name of the entity\n            parent: parent(s) of the entity\n            entitytype: type of the entity,\n                default is 'class' (str) 'ThingClass' (owlready2 Python class).\n                Other options\n                are 'data_property', 'object_property',\n                'annotation_property' (strings) or the\n                Python classes ObjectPropertyClass,\n                DataPropertyClass and AnnotationProperty classes.\n            preflabel: if given, add this as a skos:prefLabel annotation\n                to the new entity.  If None (default), `name` will\n                be added as prefLabel if skos:prefLabel is in the ontology\n                and listed in `self.label_annotations`.  Set `preflabel` to\n                False, to avoid assigning a prefLabel.\n\n        Returns:\n            the new entity.\n\n        Throws exception if name consists of more than one word, if type is not\n        one of the allowed types, or if parent is not of the correct type.\n        By default, the parent is Thing.\n\n        \"\"\"\n        # pylint: disable=invalid-name\n        if \" \" in name:\n            raise LabelDefinitionError(\n                f\"Error in label name definition '{name}': \"\n                f\"Label consists of more than one word.\"\n            )\n        parents = tuple(parent) if isinstance(parent, Iterable) else (parent,)\n        if entitytype == \"class\":\n            parenttype = owlready2.ThingClass\n        elif entitytype == \"data_property\":\n            parenttype = owlready2.DataPropertyClass\n        elif entitytype == \"object_property\":\n            parenttype = owlready2.ObjectPropertyClass\n        elif entitytype == \"annotation_property\":\n            parenttype = owlready2.AnnotationPropertyClass\n        elif entitytype in [\n            ThingClass,\n            ObjectPropertyClass,\n            DataPropertyClass,\n            AnnotationPropertyClass,\n        ]:\n            parenttype = entitytype\n        else:\n            raise EntityClassDefinitionError(\n                f\"Error in entity type definition: \"\n                f\"'{entitytype}' is not a valid entity type.\"\n            )\n        for thing in parents:\n            if not isinstance(thing, parenttype):\n                raise EntityClassDefinitionError(\n                    f\"Error in parent definition: \"\n                    f\"'{thing}' is not an {parenttype}.\"\n                )\n\n        with self:\n            entity = types.new_class(name, parents)\n\n            preflabel_iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n            if preflabel:\n                if not self.world[preflabel_iri]:\n                    pref_label = self.new_annotation_property(\n                        \"prefLabel\",\n                        parent=[owlready2.AnnotationProperty],\n                    )\n                    pref_label.iri = preflabel_iri\n                entity.prefLabel = english(preflabel)\n            elif (\n                preflabel is None\n                and preflabel_iri in self.label_annotations\n                and self.world[preflabel_iri]\n            ):\n                entity.prefLabel = english(name)\n\n        return entity\n\n    # Method that creates new ThingClass using new_entity\n    def new_class(\n        self, name: str, parent: Union[ThingClass, Iterable]\n    ) -&gt; ThingClass:\n        \"\"\"Create and return new class.\n\n        Args:\n            name: name of the class\n            parent: parent(s) of the class\n\n        Returns:\n            the new class.\n        \"\"\"\n        return self.new_entity(name, parent, \"class\")\n\n    # Method that creates new ObjectPropertyClass using new_entity\n    def new_object_property(\n        self, name: str, parent: Union[ObjectPropertyClass, Iterable]\n    ) -&gt; ObjectPropertyClass:\n        \"\"\"Create and return new object property.\n\n        Args:\n            name: name of the object property\n            parent: parent(s) of the object property\n\n        Returns:\n            the new object property.\n        \"\"\"\n        return self.new_entity(name, parent, \"object_property\")\n\n    # Method that creates new DataPropertyClass using new_entity\n    def new_data_property(\n        self, name: str, parent: Union[DataPropertyClass, Iterable]\n    ) -&gt; DataPropertyClass:\n        \"\"\"Create and return new data property.\n\n        Args:\n            name: name of the data property\n            parent: parent(s) of the data property\n\n        Returns:\n            the new data property.\n        \"\"\"\n        return self.new_entity(name, parent, \"data_property\")\n\n    # Method that creates new AnnotationPropertyClass using new_entity\n    def new_annotation_property(\n        self, name: str, parent: Union[AnnotationPropertyClass, Iterable]\n    ) -&gt; AnnotationPropertyClass:\n        \"\"\"Create and return new annotation property.\n\n        Args:\n            name: name of the annotation property\n            parent: parent(s) of the annotation property\n\n        Returns:\n            the new annotation property.\n        \"\"\"\n        return self.new_entity(name, parent, \"annotation_property\")\n\n    def difference(self, other: owlready2.Ontology) -&gt; set:\n        \"\"\"Return a set of triples that are in this, but not in the\n        `other` ontology.\"\"\"\n        # pylint: disable=invalid-name\n        s1 = set(self.get_unabbreviated_triples(blank=\"_:b\"))\n        s2 = set(other.get_unabbreviated_triples(blank=\"_:b\"))\n        return s1.difference(s2)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.colon_in_label","title":"<code>colon_in_label</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to accept colon in name-part of IRI.  If true, the name cannot be prefixed.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_imported","title":"<code>dir_imported</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include imported ontologies in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_label","title":"<code>dir_label</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include entity label in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_name","title":"<code>dir_name</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include entity name in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_preflabel","title":"<code>dir_preflabel</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include entity prefLabel in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.add_label_annotation","title":"<code>add_label_annotation(self, iri)</code>","text":"<p>Adds label annotation used by get_by_label().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def add_label_annotation(self, iri):\n    \"\"\"Adds label annotation used by get_by_label().\"\"\"\n    warnings.warn(\n        \"Ontology.add_label_annotations() is deprecated. \"\n        \"Direct modify the `label_annotations` attribute instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    if hasattr(iri, \"iri\"):\n        iri = iri.iri\n    if iri not in self.label_annotations:\n        self.label_annotations.append(iri)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.annotation_properties","title":"<code>annotation_properties(self, imported=False)</code>","text":"<p>Returns an generator over all annotation_properties.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def annotation_properties(self, imported=False):\n    \"\"\"Returns an generator over all annotation_properties.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n\n    \"\"\"\n    return self._entities(\"annotation_properties\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.classes","title":"<code>classes(self, imported=False)</code>","text":"<p>Returns an generator over all classes.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def classes(self, imported=False):\n    \"\"\"Returns an generator over all classes.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"classes\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.closest_common_ancestor","title":"<code>closest_common_ancestor(*classes)</code>  <code>staticmethod</code>","text":"<p>Returns closest_common_ancestor for the given classes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>@staticmethod\ndef closest_common_ancestor(*classes):\n    \"\"\"Returns closest_common_ancestor for the given classes.\"\"\"\n    mros = [cls.mro() for cls in classes]\n    track = defaultdict(int)\n    while mros:\n        for mro in mros:\n            cur = mro.pop(0)\n            track[cur] += 1\n            if track[cur] == len(classes):\n                return cur\n            if len(mro) == 0:\n                mros.remove(mro)\n    raise EMMOntoPyException(\n        \"A closest common ancestor should always exist !\"\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.closest_common_ancestors","title":"<code>closest_common_ancestors(self, cls1, cls2)</code>","text":"<p>Returns a list with closest_common_ancestor for cls1 and cls2</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def closest_common_ancestors(self, cls1, cls2):\n    \"\"\"Returns a list with closest_common_ancestor for cls1 and cls2\"\"\"\n    distances = {}\n    for ancestor in self.common_ancestors(cls1, cls2):\n        distances[ancestor] = self.number_of_generations(\n            cls1, ancestor\n        ) + self.number_of_generations(cls2, ancestor)\n    return [\n        ancestor\n        for ancestor, distance in distances.items()\n        if distance == min(distances.values())\n    ]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.common_ancestors","title":"<code>common_ancestors(cls1, cls2)</code>  <code>staticmethod</code>","text":"<p>Return a list of common ancestors for <code>cls1</code> and <code>cls2</code>.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>@staticmethod\ndef common_ancestors(cls1, cls2):\n    \"\"\"Return a list of common ancestors for `cls1` and `cls2`.\"\"\"\n    return set(cls1.ancestors()).intersection(cls2.ancestors())\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.copy","title":"<code>copy(self)</code>","text":"<p>Return a copy of the ontology.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def copy(self):\n    \"\"\"Return a copy of the ontology.\"\"\"\n    with tempfile.TemporaryDirectory() as dirname:\n        filename = self.save(\n            dir=dirname,\n            format=\"turtle\",\n            recursive=True,\n            write_catalog_file=True,\n            mkdir=True,\n        )\n        ontology = get_ontology(filename).load()\n        ontology.name = self.name\n    return ontology\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.data_properties","title":"<code>data_properties(self, imported=False)</code>","text":"<p>Returns an generator over all data_properties.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def data_properties(self, imported=False):\n    \"\"\"Returns an generator over all data_properties.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"data_properties\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.difference","title":"<code>difference(self, other)</code>","text":"<p>Return a set of triples that are in this, but not in the <code>other</code> ontology.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def difference(self, other: owlready2.Ontology) -&gt; set:\n    \"\"\"Return a set of triples that are in this, but not in the\n    `other` ontology.\"\"\"\n    # pylint: disable=invalid-name\n    s1 = set(self.get_unabbreviated_triples(blank=\"_:b\"))\n    s2 = set(other.get_unabbreviated_triples(blank=\"_:b\"))\n    return s1.difference(s2)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_ancestors","title":"<code>get_ancestors(self, classes, closest=False, generations=None, strict=True)</code>","text":"<p>Return ancestors of all classes in <code>classes</code>.</p> <p>Parameters:</p> Name Type Description Default <code>classes</code> <code>Union[List, ThingClass]</code> <p>class(es) for which ancestors should be returned.</p> required <code>generations</code> <code>int</code> <p>Include this number of generations, default is all.</p> <code>None</code> <code>closest</code> <code>bool</code> <p>If True, return all ancestors up to and including the closest common ancestor. Return all if False.</p> <code>False</code> <code>strict</code> <code>bool</code> <p>If True returns only real ancestors, i.e. <code>classes</code> are are not included in the returned set.</p> <code>True</code> <p>Returns:</p> Type Description <code>set</code> <p>Set of ancestors to <code>classes</code>.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_ancestors(\n    self,\n    classes: \"Union[List, ThingClass]\",\n    closest: bool = False,\n    generations: int = None,\n    strict: bool = True,\n) -&gt; set:\n    \"\"\"Return ancestors of all classes in `classes`.\n    Args:\n        classes: class(es) for which ancestors should be returned.\n        generations: Include this number of generations, default is all.\n        closest: If True, return all ancestors up to and including the\n            closest common ancestor. Return all if False.\n        strict: If True returns only real ancestors, i.e. `classes` are\n            are not included in the returned set.\n    Returns:\n        Set of ancestors to `classes`.\n    \"\"\"\n    if not isinstance(classes, Iterable):\n        classes = [classes]\n\n    ancestors = set()\n    if not classes:\n        return ancestors\n\n    def addancestors(entity, counter, subject):\n        if counter &gt; 0:\n            for parent in entity.get_parents(strict=True):\n                subject.add(parent)\n                addancestors(parent, counter - 1, subject)\n\n    if closest:\n        if generations is not None:\n            raise ValueError(\n                \"Only one of `generations` or `closest` may be specified.\"\n            )\n\n        closest_ancestor = self.closest_common_ancestor(*classes)\n        for cls in classes:\n            ancestors.update(\n                anc\n                for anc in cls.ancestors()\n                if closest_ancestor in anc.ancestors()\n            )\n    elif isinstance(generations, int):\n        for entity in classes:\n            addancestors(entity, generations, ancestors)\n    else:\n        ancestors.update(*(cls.ancestors() for cls in classes))\n\n    if strict:\n        return ancestors.difference(classes)\n    return ancestors\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_annotations","title":"<code>get_annotations(self, entity)</code>","text":"<p>Returns a dict with annotations for <code>entity</code>.  Entity may be given either as a ThingClass object or as a label.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_annotations(self, entity):\n    \"\"\"Returns a dict with annotations for `entity`.  Entity may be given\n    either as a ThingClass object or as a label.\"\"\"\n    warnings.warn(\n        \"Ontology.get_annotations(entity) is deprecated. Use \"\n        \"entity.get_annotations() instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n\n    if isinstance(entity, str):\n        entity = self.get_by_label(entity)\n    res = {\"comment\": getattr(entity, \"comment\", \"\")}\n    for annotation in self.annotation_properties():\n        res[annotation.label.first()] = [\n            obj.strip('\"')\n            for _, _, obj in self.get_triples(\n                entity.storid, annotation.storid, None\n            )\n        ]\n    return res\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_branch","title":"<code>get_branch(self, root, leaves=(), include_leaves=True, strict_leaves=False, exclude=None, sort=False)</code>","text":"<p>Returns a set with all direct and indirect subclasses of <code>root</code>. Any subclass found in the sequence <code>leaves</code> will be included in the returned list, but its subclasses will not.  The elements of <code>leaves</code> may be ThingClass objects or labels.</p> <p>Subclasses of any subclass found in the sequence <code>leaves</code> will be excluded from the returned list, where the elements of <code>leaves</code> may be ThingClass objects or labels.</p> <p>If <code>include_leaves</code> is true, the leaves are included in the returned list, otherwise they are not.</p> <p>If <code>strict_leaves</code> is true, any descendant of a leaf will be excluded in the returned set.</p> <p>If given, <code>exclude</code> may be a sequence of classes, including their subclasses, to exclude from the output.</p> <p>If <code>sort</code> is True, a list sorted according to depth and label will be returned instead of a set.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_branch(  # pylint: disable=too-many-arguments\n    self,\n    root,\n    leaves=(),\n    include_leaves=True,\n    strict_leaves=False,\n    exclude=None,\n    sort=False,\n):\n    \"\"\"Returns a set with all direct and indirect subclasses of `root`.\n    Any subclass found in the sequence `leaves` will be included in\n    the returned list, but its subclasses will not.  The elements\n    of `leaves` may be ThingClass objects or labels.\n\n    Subclasses of any subclass found in the sequence `leaves` will\n    be excluded from the returned list, where the elements of `leaves`\n    may be ThingClass objects or labels.\n\n    If `include_leaves` is true, the leaves are included in the returned\n    list, otherwise they are not.\n\n    If `strict_leaves` is true, any descendant of a leaf will be excluded\n    in the returned set.\n\n    If given, `exclude` may be a sequence of classes, including\n    their subclasses, to exclude from the output.\n\n    If `sort` is True, a list sorted according to depth and label\n    will be returned instead of a set.\n    \"\"\"\n\n    def _branch(root, leaves):\n        if root not in leaves:\n            branch = {\n                root,\n            }\n            for cls in root.subclasses():\n                # Defining a branch is actually quite tricky.  Consider\n                # the case:\n                #\n                #      L isA R\n                #      A isA L\n                #      A isA R\n                #\n                # where R is the root, L is a leaf and A is a direct\n                # child of both.  Logically, since A is a child of the\n                # leaf we want to skip A.  But a strait forward imple-\n                # mentation will see that A is a child of the root and\n                # include it.  Requireing that the R should be a strict\n                # parent of A solves this.\n                if root in cls.get_parents(strict=True):\n                    branch.update(_branch(cls, leaves))\n        else:\n            branch = (\n                {\n                    root,\n                }\n                if include_leaves\n                else set()\n            )\n        return branch\n\n    if isinstance(root, str):\n        root = self.get_by_label(root)\n\n    leaves = set(\n        self.get_by_label(leaf) if isinstance(leaf, str) else leaf\n        for leaf in leaves\n    )\n    leaves.discard(root)\n\n    if exclude:\n        exclude = set(\n            self.get_by_label(e) if isinstance(e, str) else e\n            for e in exclude\n        )\n        leaves.update(exclude)\n\n    branch = _branch(root, leaves)\n\n    # Exclude all descendants of any leaf\n    if strict_leaves:\n        descendants = root.descendants()\n        for leaf in leaves:\n            if leaf in descendants:\n                branch.difference_update(\n                    leaf.descendants(include_self=False)\n                )\n\n    if exclude:\n        branch.difference_update(exclude)\n\n    # Sort according to depth, then by label\n    if sort:\n        branch = sorted(\n            sorted(branch, key=asstring),\n            key=lambda x: len(x.mro()),\n        )\n\n    return branch\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_by_label","title":"<code>get_by_label(self, label, label_annotations=None, prefix=None, imported=True, colon_in_label=None)</code>","text":"<p>Returns entity with label annotation <code>label</code>.</p> <p>Parameters:</p> Name Type Description Default <code>label</code> <code>str</code> <p>label so search for.  May be written as 'label' or 'prefix:label'.  get_by_label('prefix:label') ==  get_by_label('label', prefix='prefix').</p> required <code>label_annotations</code> <code>str</code> <p>a sequence of label annotation names to look up.  Defaults to the <code>label_annotations</code> property.</p> <code>None</code> <code>prefix</code> <code>str</code> <p>if provided, it should be the last component of  the base iri of an ontology (with trailing slash (/) or hash  (#) stripped off).  The search for a matching label will be  limited to this namespace.</p> <code>None</code> <code>imported</code> <code>bool</code> <p>Whether to also look for <code>label</code> in imported ontologies.</p> <code>True</code> <code>colon_in_label</code> <code>bool</code> <p>Whether to accept colon (:) in a label or name-part  of IRI.  Defaults to the <code>colon_in_label</code> property of <code>self</code>.  Setting this true cannot be combined with <code>prefix</code>.</p> <code>None</code> <p>If several entities have the same label, only the one which is found first is returned.Use get_by_label_all() to get all matches.</p> <p>Note, if different prefixes are provided in the label and via the <code>prefix</code> argument a warning will be issued and the <code>prefix</code> argument will take precedence.</p> <p>A NoSuchLabelError is raised if <code>label</code> cannot be found.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_by_label(\n    self,\n    label: str,\n    label_annotations: str = None,\n    prefix: str = None,\n    imported: bool = True,\n    colon_in_label: bool = None,\n):\n    \"\"\"Returns entity with label annotation `label`.\n\n    Arguments:\n       label: label so search for.\n           May be written as 'label' or 'prefix:label'.\n           get_by_label('prefix:label') ==\n           get_by_label('label', prefix='prefix').\n       label_annotations: a sequence of label annotation names to look up.\n           Defaults to the `label_annotations` property.\n       prefix: if provided, it should be the last component of\n           the base iri of an ontology (with trailing slash (/) or hash\n           (#) stripped off).  The search for a matching label will be\n           limited to this namespace.\n       imported: Whether to also look for `label` in imported ontologies.\n       colon_in_label: Whether to accept colon (:) in a label or name-part\n           of IRI.  Defaults to the `colon_in_label` property of `self`.\n           Setting this true cannot be combined with `prefix`.\n\n    If several entities have the same label, only the one which is\n    found first is returned.Use get_by_label_all() to get all matches.\n\n    Note, if different prefixes are provided in the label and via\n    the `prefix` argument a warning will be issued and the\n    `prefix` argument will take precedence.\n\n    A NoSuchLabelError is raised if `label` cannot be found.\n    \"\"\"\n    # pylint: disable=too-many-arguments,too-many-branches,invalid-name\n    if not isinstance(label, str):\n        raise TypeError(\n            f\"Invalid label definition, must be a string: '{label}'\"\n        )\n\n    if label_annotations is None:\n        label_annotations = self.label_annotations\n\n    if colon_in_label is None:\n        colon_in_label = self._colon_in_label\n    if colon_in_label:\n        if prefix:\n            raise ValueError(\n                \"`prefix` cannot be combined with `colon_in_label`\"\n            )\n    else:\n        splitlabel = label.split(\":\", 1)\n        if len(splitlabel) == 2 and not splitlabel[1].startswith(\"//\"):\n            label = splitlabel[1]\n            if prefix and prefix != splitlabel[0]:\n                warnings.warn(\n                    f\"Prefix given both as argument ({prefix}) \"\n                    f\"and in label ({splitlabel[0]}). \"\n                    \"Prefix given in argument takes precedence. \"\n                )\n            if not prefix:\n                prefix = splitlabel[0]\n\n    if prefix:\n        entityset = self.get_by_label_all(\n            label,\n            label_annotations=label_annotations,\n            prefix=prefix,\n        )\n        if len(entityset) == 1:\n            return entityset.pop()\n        if len(entityset) &gt; 1:\n            raise AmbiguousLabelError(\n                f\"Several entities have the same label '{label}' \"\n                f\"with prefix '{prefix}'.\"\n            )\n        raise NoSuchLabelError(\n            f\"No label annotations matches for '{label}' \"\n            f\"with prefix '{prefix}'.\"\n        )\n\n    # Label is a full IRI\n    entity = self.world[label]\n    if entity:\n        return entity\n\n    get_triples = (\n        self.world._get_data_triples_spod_spod\n        if imported\n        else self._get_data_triples_spod_spod\n    )\n\n    for storid in self._to_storids(label_annotations):\n        for s, _, _, _ in get_triples(None, storid, label, None):\n            return self.world[self._unabbreviate(s)]\n\n    # Special labels\n    if self._special_labels and label in self._special_labels:\n        return self._special_labels[label]\n\n    # Check if label is a name under base_iri\n    entity = self.world[self.base_iri + label]\n    if entity:\n        return entity\n\n    # Check label is the name of an entity\n    for entity in self.get_entities(imported=imported):\n        if label == entity.name:\n            return entity\n\n    raise NoSuchLabelError(f\"No label annotations matches '{label}'\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_by_label_all","title":"<code>get_by_label_all(self, label, label_annotations=None, prefix=None, exact_match=False)</code>","text":"<p>Returns set of entities with label annotation <code>label</code>.</p> <p>Parameters:</p> Name Type Description Default <code>label</code> <p>label so search for.  May be written as 'label' or 'prefix:label'.  Wildcard matching  using glob pattern is also supported if <code>exact_match</code> is set to  false.</p> required <code>label_annotations</code> <p>a sequence of label annotation names to look up.  Defaults to the <code>label_annotations</code> property.</p> <code>None</code> <code>prefix</code> <p>if provided, it should be the last component of  the base iri of an ontology (with trailing slash (/) or hash  (#) stripped off).  The search for a matching label will be  limited to this namespace.</p> <code>None</code> <code>exact_match</code> <p>Do not treat \"*\" and brackets as special characters  when matching.  May be useful if your ontology has labels  containing such labels.</p> <code>False</code> <p>Returns:</p> Type Description <code>Set[Optional[owlready2.entity.EntityClass]]</code> <p>Set of all matching entities or an empty set if no matches could be found.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_by_label_all(\n    self,\n    label,\n    label_annotations=None,\n    prefix=None,\n    exact_match=False,\n) -&gt; \"Set[Optional[owlready2.entity.EntityClass]]\":\n    \"\"\"Returns set of entities with label annotation `label`.\n\n    Arguments:\n       label: label so search for.\n           May be written as 'label' or 'prefix:label'.  Wildcard matching\n           using glob pattern is also supported if `exact_match` is set to\n           false.\n       label_annotations: a sequence of label annotation names to look up.\n           Defaults to the `label_annotations` property.\n       prefix: if provided, it should be the last component of\n           the base iri of an ontology (with trailing slash (/) or hash\n           (#) stripped off).  The search for a matching label will be\n           limited to this namespace.\n       exact_match: Do not treat \"*\" and brackets as special characters\n           when matching.  May be useful if your ontology has labels\n           containing such labels.\n\n    Returns:\n        Set of all matching entities or an empty set if no matches\n        could be found.\n    \"\"\"\n    if not isinstance(label, str):\n        raise TypeError(\n            f\"Invalid label definition, \" f\"must be a string: {label!r}\"\n        )\n    if \" \" in label:\n        raise ValueError(\n            f\"Invalid label definition, {label!r} contains spaces.\"\n        )\n\n    if label_annotations is None:\n        label_annotations = self.label_annotations\n\n    entities = set()\n\n    # Check label annotations\n    if exact_match:\n        for storid in self._to_storids(label_annotations):\n            entities.update(\n                self.world._get_by_storid(s)\n                for s, _, _ in self.world._get_data_triples_spod_spod(\n                    None, storid, str(label), None\n                )\n            )\n    else:\n        for storid in self._to_storids(label_annotations):\n            label_entity = self._unabbreviate(storid)\n            key = (\n                label_entity.name\n                if hasattr(label_entity, \"name\")\n                else label_entity\n            )\n            entities.update(self.world.search(**{key: label}))\n\n    if self._special_labels and label in self._special_labels:\n        entities.update(self._special_labels[label])\n\n    # Check name-part of IRI\n    if exact_match:\n        entities.update(\n            ent for ent in self.get_entities() if ent.name == str(label)\n        )\n    else:\n        matches = fnmatch.filter(\n            (ent.name for ent in self.get_entities()), label\n        )\n        entities.update(\n            ent for ent in self.get_entities() if ent.name in matches\n        )\n\n    if prefix:\n        return set(\n            ent\n            for ent in entities\n            if ent.namespace.ontology.prefix == prefix\n        )\n    return entities\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_descendants","title":"<code>get_descendants(self, classes, generations=None, common=False)</code>","text":"<p>Return descendants/subclasses of all classes in <code>classes</code>.</p> <p>Parameters:</p> Name Type Description Default <code>classes</code> <code>Union[List, ThingClass]</code> <p>class(es) for which descendants are desired.</p> required <code>common</code> <code>bool</code> <p>whether to only return descendants common to all classes.</p> <code>False</code> <code>generations</code> <code>int</code> <p>Include this number of generations, default is all.</p> <code>None</code> <p>Returns:</p> Type Description <code>set</code> <p>A set of descendants for given number of generations. If 'common'=True, the common descendants are returned within the specified number of generations. 'generations' defaults to all.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_descendants(\n    self,\n    classes: \"Union[List, ThingClass]\",\n    generations: int = None,\n    common: bool = False,\n) -&gt; set:\n    \"\"\"Return descendants/subclasses of all classes in `classes`.\n    Args:\n        classes: class(es) for which descendants are desired.\n        common: whether to only return descendants common to all classes.\n        generations: Include this number of generations, default is all.\n    Returns:\n        A set of descendants for given number of generations.\n        If 'common'=True, the common descendants are returned\n        within the specified number of generations.\n        'generations' defaults to all.\n    \"\"\"\n\n    if not isinstance(classes, Iterable):\n        classes = [classes]\n\n    descendants = {name: [] for name in classes}\n\n    def _children_recursively(num, newentity, parent, descendants):\n        \"\"\"Helper function to get all children up to generation.\"\"\"\n        for child in self.get_children_of(newentity):\n            descendants[parent].append(child)\n            if num &lt; generations:\n                _children_recursively(num + 1, child, parent, descendants)\n\n    if generations == 0:\n        return set()\n\n    if not generations:\n        for entity in classes:\n            descendants[entity] = entity.descendants()\n            # only include proper descendants\n            descendants[entity].remove(entity)\n    else:\n        for entity in classes:\n            _children_recursively(1, entity, entity, descendants)\n\n    results = descendants.values()\n    if common is True:\n        return set.intersection(*map(set, results))\n    return set(flatten(results))\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_entities","title":"<code>get_entities(self, imported=True, classes=True, individuals=True, object_properties=True, data_properties=True, annotation_properties=True)</code>","text":"<p>Return a generator over (optionally) all classes, individuals, object_properties, data_properties and annotation_properties.</p> <p>If <code>imported</code> is <code>True</code>, entities in imported ontologies will also be included.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_entities(  # pylint: disable=too-many-arguments\n    self,\n    imported=True,\n    classes=True,\n    individuals=True,\n    object_properties=True,\n    data_properties=True,\n    annotation_properties=True,\n):\n    \"\"\"Return a generator over (optionally) all classes, individuals,\n    object_properties, data_properties and annotation_properties.\n\n    If `imported` is `True`, entities in imported ontologies will also\n    be included.\n    \"\"\"\n    generator = []\n    if classes:\n        generator.append(self.classes(imported))\n    if individuals:\n        generator.append(self.individuals(imported))\n    if object_properties:\n        generator.append(self.object_properties(imported))\n    if data_properties:\n        generator.append(self.data_properties(imported))\n    if annotation_properties:\n        generator.append(self.annotation_properties(imported))\n    yield from itertools.chain(*generator)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_graph","title":"<code>get_graph(self, **kwargs)</code>","text":"<p>Returns a new graph object.  See  emmo.graph.OntoGraph.</p> <p>Note that this method requires the Python graphviz package.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_graph(self, **kwargs):\n    \"\"\"Returns a new graph object.  See  emmo.graph.OntoGraph.\n\n    Note that this method requires the Python graphviz package.\n    \"\"\"\n    # pylint: disable=import-outside-toplevel,cyclic-import\n    from ontopy.graph import OntoGraph\n\n    return OntoGraph(self, **kwargs)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_imported_ontologies","title":"<code>get_imported_ontologies(self, recursive=False)</code>","text":"<p>Return a list with imported ontologies.</p> <p>If <code>recursive</code> is <code>True</code>, ontologies imported by imported ontologies are also returned.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_imported_ontologies(self, recursive=False):\n    \"\"\"Return a list with imported ontologies.\n\n    If `recursive` is `True`, ontologies imported by imported ontologies\n    are also returned.\n    \"\"\"\n\n    def rec_imported(onto):\n        for ontology in onto.imported_ontologies:\n            # pylint: disable=possibly-used-before-assignment\n            if ontology not in imported:\n                imported.add(ontology)\n                rec_imported(ontology)\n\n    if recursive:\n        imported = set()\n        rec_imported(self)\n        return list(imported)\n\n    return self.imported_ontologies\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_relations","title":"<code>get_relations(self)</code>","text":"<p>Returns a generator for all relations.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_relations(self):\n    \"\"\"Returns a generator for all relations.\"\"\"\n    warnings.warn(\n        \"Ontology.get_relations() is deprecated. Use \"\n        \"onto.object_properties() instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    return self.object_properties()\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_root_classes","title":"<code>get_root_classes(self, imported=False)</code>","text":"<p>Returns a list or root classes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_root_classes(self, imported=False):\n    \"\"\"Returns a list or root classes.\"\"\"\n    return [\n        cls\n        for cls in self.classes(imported=imported)\n        if not cls.ancestors().difference(set([cls, owlready2.Thing]))\n    ]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_root_data_properties","title":"<code>get_root_data_properties(self, imported=False)</code>","text":"<p>Returns a list of root object properties.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_root_data_properties(self, imported=False):\n    \"\"\"Returns a list of root object properties.\"\"\"\n    props = set(self.data_properties(imported=imported))\n    return [p for p in props if not props.intersection(p.is_a)]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_root_object_properties","title":"<code>get_root_object_properties(self, imported=False)</code>","text":"<p>Returns a list of root object properties.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_root_object_properties(self, imported=False):\n    \"\"\"Returns a list of root object properties.\"\"\"\n    props = set(self.object_properties(imported=imported))\n    return [p for p in props if not props.intersection(p.is_a)]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_roots","title":"<code>get_roots(self, imported=False)</code>","text":"<p>Returns all class, object_property and data_property roots.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_roots(self, imported=False):\n    \"\"\"Returns all class, object_property and data_property roots.\"\"\"\n    roots = self.get_root_classes(imported=imported)\n    roots.extend(self.get_root_object_properties(imported=imported))\n    roots.extend(self.get_root_data_properties(imported=imported))\n    return roots\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_unabbreviated_triples","title":"<code>get_unabbreviated_triples(self, subject=None, predicate=None, obj=None, blank=None)</code>","text":"<p>Returns all matching triples unabbreviated.</p> <p>If <code>blank</code> is given, it will be used to represent blank nodes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_unabbreviated_triples(\n    self, subject=None, predicate=None, obj=None, blank=None\n):\n    \"\"\"Returns all matching triples unabbreviated.\n\n    If `blank` is given, it will be used to represent blank nodes.\n    \"\"\"\n    # pylint: disable=invalid-name\n    return _get_unabbreviated_triples(\n        self, subject=subject, predicate=predicate, obj=obj, blank=blank\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_version","title":"<code>get_version(self, as_iri=False)</code>","text":"<p>Returns the version number of the ontology as inferred from the owl:versionIRI tag or, if owl:versionIRI is not found, from owl:versionINFO.</p> <p>If <code>as_iri</code> is True, the full versionIRI is returned.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_version(self, as_iri=False) -&gt; str:\n    \"\"\"Returns the version number of the ontology as inferred from the\n    owl:versionIRI tag or, if owl:versionIRI is not found, from\n    owl:versionINFO.\n\n    If `as_iri` is True, the full versionIRI is returned.\n    \"\"\"\n    version_iri_storid = self.world._abbreviate(\n        \"http://www.w3.org/2002/07/owl#versionIRI\"\n    )\n    tokens = self.get_triples(s=self.storid, p=version_iri_storid)\n    if (not tokens) and (as_iri is True):\n        raise TypeError(\n            \"No owl:versionIRI \"\n            f\"in Ontology {self.base_iri!r}. \"\n            \"Search for owl:versionInfo with as_iri=False\"\n        )\n    if tokens:\n        _, _, obj = tokens[0]\n        version_iri = self.world._unabbreviate(obj)\n        if as_iri:\n            return version_iri\n        return infer_version(self.base_iri, version_iri)\n\n    version_info_storid = self.world._abbreviate(\n        \"http://www.w3.org/2002/07/owl#versionInfo\"\n    )\n    tokens = self.get_triples(s=self.storid, p=version_info_storid)\n    if not tokens:\n        raise TypeError(\n            \"No versionIRI or versionInfo \" f\"in Ontology {self.base_iri!r}\"\n        )\n    _, _, version_info = tokens[0]\n    return version_info.split(\"^^\")[0].strip('\"')\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_wu_palmer_measure","title":"<code>get_wu_palmer_measure(self, cls1, cls2)</code>","text":"<p>Return Wu-Palmer measure for semantic similarity.</p> <p>Returns Wu-Palmer measure for semantic similarity between two concepts. Wu, Palmer; ACL 94: Proceedings of the 32nd annual meeting on Association for Computational Linguistics, June 1994.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_wu_palmer_measure(self, cls1, cls2):\n    \"\"\"Return Wu-Palmer measure for semantic similarity.\n\n    Returns Wu-Palmer measure for semantic similarity between\n    two concepts.\n    Wu, Palmer; ACL 94: Proceedings of the 32nd annual meeting on\n    Association for Computational Linguistics, June 1994.\n    \"\"\"\n    cca = self.closest_common_ancestor(cls1, cls2)\n    ccadepth = self.number_of_generations(cca, self.Thing)\n    generations1 = self.number_of_generations(cls1, cca)\n    generations2 = self.number_of_generations(cls2, cca)\n    return 2 * ccadepth / (generations1 + generations2 + 2 * ccadepth)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.individuals","title":"<code>individuals(self, imported=False)</code>","text":"<p>Returns an generator over all individuals.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def individuals(self, imported=False):\n    \"\"\"Returns an generator over all individuals.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"individuals\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.is_defined","title":"<code>is_defined(self, entity)</code>","text":"<p>Returns true if the entity is a defined class.</p> <p>Deprecated, use the <code>is_defined</code> property of the classes (ThingClass subclasses) instead.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def is_defined(self, entity):\n    \"\"\"Returns true if the entity is a defined class.\n\n    Deprecated, use the `is_defined` property of the classes\n    (ThingClass subclasses) instead.\n    \"\"\"\n    warnings.warn(\n        \"This method is deprecated.  Use the `is_defined` property of \"\n        \"the classes instad.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    if isinstance(entity, str):\n        entity = self.get_by_label(entity)\n    return hasattr(entity, \"equivalent_to\") and bool(entity.equivalent_to)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.is_individual","title":"<code>is_individual(self, entity)</code>","text":"<p>Returns true if entity is an individual.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def is_individual(self, entity):\n    \"\"\"Returns true if entity is an individual.\"\"\"\n    if isinstance(entity, str):\n        entity = self.get_by_label(entity)\n    return isinstance(entity, owlready2.Thing)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.load","title":"<code>load(self, only_local=False, filename=None, format=None, reload=None, reload_if_newer=False, url_from_catalog=None, catalog_file='catalog-v001.xml', emmo_based=True, prefix=None, prefix_emmo=None, **kwargs)</code>","text":"<p>Load the ontology.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.load--arguments","title":"Arguments","text":"<p>bool</p> <p>Whether to only read local files.  This requires that you have appended the path to the ontology to owlready2.onto_path.</p> <p>str</p> <p>Path to file to load the ontology from.  Defaults to <code>base_iri</code> provided to get_ontology().</p> <p>str</p> <p>Format of <code>filename</code>.  Default is inferred from <code>filename</code> extension.</p> <p>bool</p> <p>Whether to reload the ontology if it is already loaded.</p> <p>bool</p> <p>Whether to reload the ontology if the source has changed since last time it was loaded.</p> <p>bool | None</p> <p>Whether to use catalog file to resolve the location of <code>base_iri</code>. If None, the catalog file is used if it exists in the same directory as <code>filename</code>.</p> <p>str</p> <p>Name of Prot\u00e8g\u00e8 catalog file in the same folder as the ontology.  This option is used together with <code>only_local</code> and defaults to \"catalog-v001.xml\".</p> <p>bool</p> <p>Whether this is an EMMO-based ontology or not, default <code>True</code>.</p> <p>prefix: defaults to self.get_namespace.name if</p> <p>bool, default None. If emmo_based is True it</p> <p>defaults to True and sets the prefix of all imported ontologies with base_iri starting with 'http://emmo.info/emmo' to emmo</p> <p>Kwargs</p> <p>Additional keyword arguments are passed on to owlready2.Ontology.load().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def load(  # pylint: disable=too-many-arguments,arguments-renamed\n    self,\n    only_local=False,\n    filename=None,\n    format=None,  # pylint: disable=redefined-builtin\n    reload=None,\n    reload_if_newer=False,\n    url_from_catalog=None,\n    catalog_file=\"catalog-v001.xml\",\n    emmo_based=True,\n    prefix=None,\n    prefix_emmo=None,\n    **kwargs,\n):\n    \"\"\"Load the ontology.\n\n    Arguments\n    ---------\n    only_local: bool\n        Whether to only read local files.  This requires that you\n        have appended the path to the ontology to owlready2.onto_path.\n    filename: str\n        Path to file to load the ontology from.  Defaults to `base_iri`\n        provided to get_ontology().\n    format: str\n        Format of `filename`.  Default is inferred from `filename`\n        extension.\n    reload: bool\n        Whether to reload the ontology if it is already loaded.\n    reload_if_newer: bool\n        Whether to reload the ontology if the source has changed since\n        last time it was loaded.\n    url_from_catalog: bool | None\n        Whether to use catalog file to resolve the location of `base_iri`.\n        If None, the catalog file is used if it exists in the same\n        directory as `filename`.\n    catalog_file: str\n        Name of Prot\u00e8g\u00e8 catalog file in the same folder as the\n        ontology.  This option is used together with `only_local` and\n        defaults to \"catalog-v001.xml\".\n    emmo_based: bool\n        Whether this is an EMMO-based ontology or not, default `True`.\n    prefix: defaults to self.get_namespace.name if\n    prefix_emmo: bool, default None. If emmo_based is True it\n        defaults to True and sets the prefix of all imported ontologies\n        with base_iri starting with 'http://emmo.info/emmo' to emmo\n    kwargs:\n        Additional keyword arguments are passed on to\n        owlready2.Ontology.load().\n    \"\"\"\n    # TODO: make sure that `only_local` argument is respected...\n\n    if self.loaded:\n        return self\n    self._load(\n        only_local=only_local,\n        filename=filename,\n        format=format,\n        reload=reload,\n        reload_if_newer=reload_if_newer,\n        url_from_catalog=url_from_catalog,\n        catalog_file=catalog_file,\n        **kwargs,\n    )\n\n    # Enable optimised search by get_by_label()\n    if self._special_labels is None and emmo_based:\n        top = self.world[\"http://www.w3.org/2002/07/owl#topObjectProperty\"]\n        self._special_labels = {\n            \"Thing\": owlready2.Thing,\n            \"Nothing\": owlready2.Nothing,\n            \"topObjectProperty\": top,\n            \"owl:Thing\": owlready2.Thing,\n            \"owl:Nothing\": owlready2.Nothing,\n            \"owl:topObjectProperty\": top,\n        }\n    # set prefix if another prefix is desired\n    # if we do this, shouldn't we make the name of all\n    # entities of the given ontology to the same?\n    if prefix:\n        self.prefix = prefix\n    else:\n        self.prefix = self.name\n\n    if emmo_based and prefix_emmo is None:\n        prefix_emmo = True\n    if prefix_emmo:\n        self.set_common_prefix()\n\n    return self\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_annotation_property","title":"<code>new_annotation_property(self, name, parent)</code>","text":"<p>Create and return new annotation property.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the annotation property</p> required <code>parent</code> <code>Union[owlready2.annotation.AnnotationPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the annotation property</p> required <p>Returns:</p> Type Description <code>AnnotationPropertyClass</code> <p>the new annotation property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_annotation_property(\n    self, name: str, parent: Union[AnnotationPropertyClass, Iterable]\n) -&gt; AnnotationPropertyClass:\n    \"\"\"Create and return new annotation property.\n\n    Args:\n        name: name of the annotation property\n        parent: parent(s) of the annotation property\n\n    Returns:\n        the new annotation property.\n    \"\"\"\n    return self.new_entity(name, parent, \"annotation_property\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_class","title":"<code>new_class(self, name, parent)</code>","text":"<p>Create and return new class.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the class</p> required <code>parent</code> <code>Union[owlready2.entity.ThingClass, collections.abc.Iterable]</code> <p>parent(s) of the class</p> required <p>Returns:</p> Type Description <code>ThingClass</code> <p>the new class.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_class(\n    self, name: str, parent: Union[ThingClass, Iterable]\n) -&gt; ThingClass:\n    \"\"\"Create and return new class.\n\n    Args:\n        name: name of the class\n        parent: parent(s) of the class\n\n    Returns:\n        the new class.\n    \"\"\"\n    return self.new_entity(name, parent, \"class\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_data_property","title":"<code>new_data_property(self, name, parent)</code>","text":"<p>Create and return new data property.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the data property</p> required <code>parent</code> <code>Union[owlready2.prop.DataPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the data property</p> required <p>Returns:</p> Type Description <code>DataPropertyClass</code> <p>the new data property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_data_property(\n    self, name: str, parent: Union[DataPropertyClass, Iterable]\n) -&gt; DataPropertyClass:\n    \"\"\"Create and return new data property.\n\n    Args:\n        name: name of the data property\n        parent: parent(s) of the data property\n\n    Returns:\n        the new data property.\n    \"\"\"\n    return self.new_entity(name, parent, \"data_property\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_entity","title":"<code>new_entity(self, name, parent, entitytype='class', preflabel=None)</code>","text":"<p>Create and return new entity</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the entity</p> required <code>parent</code> <code>Union[owlready2.entity.ThingClass, owlready2.prop.ObjectPropertyClass, owlready2.prop.DataPropertyClass, owlready2.annotation.AnnotationPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the entity</p> required <code>entitytype</code> <code>Union[str, owlready2.entity.ThingClass, owlready2.prop.ObjectPropertyClass, owlready2.prop.DataPropertyClass, owlready2.annotation.AnnotationPropertyClass]</code> <p>type of the entity, default is 'class' (str) 'ThingClass' (owlready2 Python class). Other options are 'data_property', 'object_property', 'annotation_property' (strings) or the Python classes ObjectPropertyClass, DataPropertyClass and AnnotationProperty classes.</p> <code>'class'</code> <code>preflabel</code> <code>Optional[str]</code> <p>if given, add this as a skos:prefLabel annotation to the new entity.  If None (default), <code>name</code> will be added as prefLabel if skos:prefLabel is in the ontology and listed in <code>self.label_annotations</code>.  Set <code>preflabel</code> to False, to avoid assigning a prefLabel.</p> <code>None</code> <p>Returns:</p> Type Description <code>Union[owlready2.entity.ThingClass, owlready2.prop.ObjectPropertyClass, owlready2.prop.DataPropertyClass, owlready2.annotation.AnnotationPropertyClass]</code> <p>the new entity.</p> <p>Throws exception if name consists of more than one word, if type is not one of the allowed types, or if parent is not of the correct type. By default, the parent is Thing.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_entity(\n    self,\n    name: str,\n    parent: Union[\n        ThingClass,\n        ObjectPropertyClass,\n        DataPropertyClass,\n        AnnotationPropertyClass,\n        Iterable,\n    ],\n    entitytype: Optional[\n        Union[\n            str,\n            ThingClass,\n            ObjectPropertyClass,\n            DataPropertyClass,\n            AnnotationPropertyClass,\n        ]\n    ] = \"class\",\n    preflabel: Optional[str] = None,\n) -&gt; Union[\n    ThingClass,\n    ObjectPropertyClass,\n    DataPropertyClass,\n    AnnotationPropertyClass,\n]:\n    \"\"\"Create and return new entity\n\n    Args:\n        name: name of the entity\n        parent: parent(s) of the entity\n        entitytype: type of the entity,\n            default is 'class' (str) 'ThingClass' (owlready2 Python class).\n            Other options\n            are 'data_property', 'object_property',\n            'annotation_property' (strings) or the\n            Python classes ObjectPropertyClass,\n            DataPropertyClass and AnnotationProperty classes.\n        preflabel: if given, add this as a skos:prefLabel annotation\n            to the new entity.  If None (default), `name` will\n            be added as prefLabel if skos:prefLabel is in the ontology\n            and listed in `self.label_annotations`.  Set `preflabel` to\n            False, to avoid assigning a prefLabel.\n\n    Returns:\n        the new entity.\n\n    Throws exception if name consists of more than one word, if type is not\n    one of the allowed types, or if parent is not of the correct type.\n    By default, the parent is Thing.\n\n    \"\"\"\n    # pylint: disable=invalid-name\n    if \" \" in name:\n        raise LabelDefinitionError(\n            f\"Error in label name definition '{name}': \"\n            f\"Label consists of more than one word.\"\n        )\n    parents = tuple(parent) if isinstance(parent, Iterable) else (parent,)\n    if entitytype == \"class\":\n        parenttype = owlready2.ThingClass\n    elif entitytype == \"data_property\":\n        parenttype = owlready2.DataPropertyClass\n    elif entitytype == \"object_property\":\n        parenttype = owlready2.ObjectPropertyClass\n    elif entitytype == \"annotation_property\":\n        parenttype = owlready2.AnnotationPropertyClass\n    elif entitytype in [\n        ThingClass,\n        ObjectPropertyClass,\n        DataPropertyClass,\n        AnnotationPropertyClass,\n    ]:\n        parenttype = entitytype\n    else:\n        raise EntityClassDefinitionError(\n            f\"Error in entity type definition: \"\n            f\"'{entitytype}' is not a valid entity type.\"\n        )\n    for thing in parents:\n        if not isinstance(thing, parenttype):\n            raise EntityClassDefinitionError(\n                f\"Error in parent definition: \"\n                f\"'{thing}' is not an {parenttype}.\"\n            )\n\n    with self:\n        entity = types.new_class(name, parents)\n\n        preflabel_iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n        if preflabel:\n            if not self.world[preflabel_iri]:\n                pref_label = self.new_annotation_property(\n                    \"prefLabel\",\n                    parent=[owlready2.AnnotationProperty],\n                )\n                pref_label.iri = preflabel_iri\n            entity.prefLabel = english(preflabel)\n        elif (\n            preflabel is None\n            and preflabel_iri in self.label_annotations\n            and self.world[preflabel_iri]\n        ):\n            entity.prefLabel = english(name)\n\n    return entity\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_object_property","title":"<code>new_object_property(self, name, parent)</code>","text":"<p>Create and return new object property.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the object property</p> required <code>parent</code> <code>Union[owlready2.prop.ObjectPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the object property</p> required <p>Returns:</p> Type Description <code>ObjectPropertyClass</code> <p>the new object property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_object_property(\n    self, name: str, parent: Union[ObjectPropertyClass, Iterable]\n) -&gt; ObjectPropertyClass:\n    \"\"\"Create and return new object property.\n\n    Args:\n        name: name of the object property\n        parent: parent(s) of the object property\n\n    Returns:\n        the new object property.\n    \"\"\"\n    return self.new_entity(name, parent, \"object_property\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.number_of_generations","title":"<code>number_of_generations(self, descendant, ancestor)</code>","text":"<p>Return shortest distance from ancestor to descendant</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def number_of_generations(self, descendant, ancestor):\n    \"\"\"Return shortest distance from ancestor to descendant\"\"\"\n    if ancestor not in descendant.ancestors():\n        raise ValueError(\"Descendant is not a descendant of ancestor\")\n    return self._number_of_generations(descendant, ancestor, 0)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.object_properties","title":"<code>object_properties(self, imported=False)</code>","text":"<p>Returns an generator over all object_properties.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def object_properties(self, imported=False):\n    \"\"\"Returns an generator over all object_properties.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"object_properties\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.remove_label_annotation","title":"<code>remove_label_annotation(self, iri)</code>","text":"<p>Removes label annotation used by get_by_label().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def remove_label_annotation(self, iri):\n    \"\"\"Removes label annotation used by get_by_label().\"\"\"\n    warnings.warn(\n        \"Ontology.remove_label_annotations() is deprecated. \"\n        \"Direct modify the `label_annotations` attribute instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    if hasattr(iri, \"iri\"):\n        iri = iri.iri\n    try:\n        self.label_annotations.remove(iri)\n    except ValueError:\n        pass\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.rename_entities","title":"<code>rename_entities(self, annotations=('prefLabel', 'label', 'altLabel'))</code>","text":"<p>Set <code>name</code> of all entities to the first non-empty annotation in <code>annotations</code>.</p> <p>Warning, this method changes all IRIs in the ontology.  However, it may be useful to make the ontology more readable and to work with it together with a triple store.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def rename_entities(\n    self,\n    annotations=(\"prefLabel\", \"label\", \"altLabel\"),\n):\n    \"\"\"Set `name` of all entities to the first non-empty annotation in\n    `annotations`.\n\n    Warning, this method changes all IRIs in the ontology.  However,\n    it may be useful to make the ontology more readable and to work\n    with it together with a triple store.\n    \"\"\"\n    for entity in self.get_entities():\n        for annotation in annotations:\n            if hasattr(entity, annotation):\n                name = getattr(entity, annotation).first()\n                if name:\n                    entity.name = name\n                    break\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.save","title":"<code>save(self, filename=None, format=None, dir='.', mkdir=False, overwrite=False, recursive=False, squash=False, write_catalog_file=False, append_catalog=False, catalog_file='catalog-v001.xml', **kwargs)</code>","text":"<p>Writes the ontology to file.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.save--parameters","title":"Parameters","text":"<p>None | str | Path</p> <p>Name of file to write to.  If None, it defaults to the name of the ontology with <code>format</code> as file extension.</p> <p>str</p> <p>Output format. The default is to infer it from <code>filename</code>.</p> <p>str | Path</p> <p>If <code>filename</code> is a relative path, it is a relative path to <code>dir</code>.</p> <p>bool</p> <p>Whether to create output directory if it does not exists.</p> <p>bool</p> <p>If true and <code>filename</code> exists, remove the existing file before saving.  The default is to append to an existing ontology.</p> <p>bool</p> <p>Whether to save imported ontologies recursively.  This is commonly combined with <code>filename=None</code>, <code>dir</code> and <code>mkdir</code>. Note that depending on the structure of the ontology and all imports the ontology might end up in a subdirectory. If filename is given, the ontology is saved to the given directory. The path to the final location is returned.</p> <p>bool</p> <p>If true, rdflib will be used to save the current ontology together with all its sub-ontologies into <code>filename</code>. It makes no sense to combine this with <code>recursive</code>.</p> <p>bool</p> <p>Whether to also write a catalog file to disk.</p> <p>bool</p> <p>Whether to append to an existing catalog file.</p> <p>str | Path</p> <p>Name of catalog file.  If not an absolute path, it is prepended to <code>dir</code>.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.save--returns","title":"Returns","text":"<pre><code>The path to the saved ontology.\n</code></pre> Source code in <code>ontopy/ontology.py</code> <pre><code>def save(\n    self,\n    filename=None,\n    format=None,\n    dir=\".\",\n    mkdir=False,\n    overwrite=False,\n    recursive=False,\n    squash=False,\n    write_catalog_file=False,\n    append_catalog=False,\n    catalog_file=\"catalog-v001.xml\",\n    **kwargs,\n) -&gt; Path:\n    \"\"\"Writes the ontology to file.\n\n    Parameters\n    ----------\n    filename: None | str | Path\n        Name of file to write to.  If None, it defaults to the name\n        of the ontology with `format` as file extension.\n    format: str\n        Output format. The default is to infer it from `filename`.\n    dir: str | Path\n        If `filename` is a relative path, it is a relative path to `dir`.\n    mkdir: bool\n        Whether to create output directory if it does not exists.\n    owerwrite: bool\n        If true and `filename` exists, remove the existing file before\n        saving.  The default is to append to an existing ontology.\n    recursive: bool\n        Whether to save imported ontologies recursively.  This is\n        commonly combined with `filename=None`, `dir` and `mkdir`.\n        Note that depending on the structure of the ontology and\n        all imports the ontology might end up in a subdirectory.\n        If filename is given, the ontology is saved to the given\n        directory.\n        The path to the final location is returned.\n    squash: bool\n        If true, rdflib will be used to save the current ontology\n        together with all its sub-ontologies into `filename`.\n        It makes no sense to combine this with `recursive`.\n    write_catalog_file: bool\n        Whether to also write a catalog file to disk.\n    append_catalog: bool\n        Whether to append to an existing catalog file.\n    catalog_file: str | Path\n        Name of catalog file.  If not an absolute path, it is prepended\n        to `dir`.\n\n    Returns\n    --------\n        The path to the saved ontology.\n    \"\"\"\n    # pylint: disable=redefined-builtin,too-many-arguments\n    # pylint: disable=too-many-statements,too-many-branches\n    # pylint: disable=too-many-locals,arguments-renamed,invalid-name\n\n    if not _validate_installed_version(\n        package=\"rdflib\", min_version=\"6.0.0\"\n    ) and format == FMAP.get(\"ttl\", \"\"):\n        from rdflib import (  # pylint: disable=import-outside-toplevel\n            __version__ as __rdflib_version__,\n        )\n\n        warnings.warn(\n            IncompatibleVersion(\n                \"To correctly convert to Turtle format, rdflib must be \"\n                \"version 6.0.0 or greater, however, the detected rdflib \"\n                \"version used by your Python interpreter is \"\n                f\"{__rdflib_version__!r}. For more information see the \"\n                \"'Known issues' section of the README.\"\n            )\n        )\n    revmap = {value: key for key, value in FMAP.items()}\n    if filename is None:\n        if format:\n            fmt = revmap.get(format, format)\n            file = f\"{self.name}.{fmt}\"\n        else:\n            raise TypeError(\"`filename` and `format` cannot both be None.\")\n    else:\n        file = filename\n    filepath = os.path.join(\n        dir, file if isinstance(file, (str, Path)) else file.name\n    )\n    returnpath = filepath\n\n    dir = Path(filepath).resolve().parent\n\n    if mkdir:\n        outdir = Path(filepath).parent.resolve()\n        if not outdir.exists():\n            outdir.mkdir(parents=True)\n\n    if not format:\n        format = guess_format(file, fmap=FMAP)\n    fmt = revmap.get(format, format)\n\n    if overwrite and os.path.exists(filepath):\n        os.remove(filepath)\n\n    if recursive:\n        if squash:\n            raise ValueError(\n                \"`recursive` and `squash` should not both be true\"\n            )\n        layout = directory_layout(self)\n        if filename:\n            layout[self] = file.rstrip(f\".{fmt}\")\n        # Update path to where the ontology is saved\n        # Note that filename should include format\n        # when given\n        returnpath = Path(dir) / f\"{layout[self]}.{fmt}\"\n        for onto, path in layout.items():\n            fname = Path(dir) / f\"{path}.{fmt}\"\n            onto.save(\n                filename=fname,\n                format=format,\n                dir=dir,\n                mkdir=mkdir,\n                overwrite=overwrite,\n                recursive=False,\n                squash=False,\n                write_catalog_file=False,\n                **kwargs,\n            )\n\n        if write_catalog_file:\n            catalog_files = set()\n            irimap = {}\n            for onto, path in layout.items():\n                irimap[onto.get_version(as_iri=True)] = (\n                    f\"{dir}/{path}.{fmt}\"\n                )\n                catalog_files.add(Path(path).parent / catalog_file)\n\n            for catfile in catalog_files:\n                write_catalog(\n                    irimap.copy(),\n                    output=catfile,\n                    directory=dir,\n                    append=append_catalog,\n                )\n    elif squash:\n        URIRef, RDF, OWL = rdflib.URIRef, rdflib.RDF, rdflib.OWL\n\n        # Make a copy of the owlready2 graph object to not mess with\n        # owlready2 internals\n        graph = rdflib.Graph()\n        for triple in self.world.as_rdflib_graph():\n            graph.add(triple)\n\n        # Add common namespaces unknown to rdflib\n        extra_namespaces = [\n            (\"\", self.base_iri),\n            (\"swrl\", \"http://www.w3.org/2003/11/swrl#\"),\n            (\"bibo\", \"http://purl.org/ontology/bibo/\"),\n        ]\n        for prefix, iri in extra_namespaces:\n            graph.namespace_manager.bind(\n                prefix, rdflib.Namespace(iri), override=False\n            )\n\n        # Remove all ontology-declarations in the graph that are\n        # not the current ontology.\n        for s, _, _ in graph.triples(  # pylint: disable=not-an-iterable\n            (None, RDF.type, OWL.Ontology)\n        ):\n            if str(s).rstrip(\"/#\") != self.base_iri.rstrip(\"/#\"):\n                for (\n                    _,\n                    p,\n                    o,\n                ) in graph.triples(  # pylint: disable=not-an-iterable\n                    (s, None, None)\n                ):\n                    graph.remove((s, p, o))\n            graph.remove((s, OWL.imports, None))\n\n        # Insert correct IRI of the ontology\n        if self.iri:\n            base_iri = URIRef(self.base_iri)\n            for s, p, o in graph.triples(  # pylint: disable=not-an-iterable\n                (base_iri, None, None)\n            ):\n                graph.remove((s, p, o))\n                graph.add((URIRef(self.iri), p, o))\n\n        graph.serialize(destination=filepath, format=format)\n    elif format in OWLREADY2_FORMATS:\n        super().save(file=filepath, format=fmt, **kwargs)\n    else:\n        # The try-finally clause is needed for cleanup and because\n        # we have to provide delete=False to NamedTemporaryFile\n        # since Windows does not allow to reopen an already open\n        # file.\n        try:\n            with tempfile.NamedTemporaryFile(\n                suffix=\".owl\", delete=False\n            ) as handle:\n                tmpfile = handle.name\n            super().save(tmpfile, format=\"ntriples\", **kwargs)\n            graph = rdflib.Graph()\n            graph.parse(tmpfile, format=\"ntriples\")\n            graph.namespace_manager.bind(\n                \"\", rdflib.Namespace(self.base_iri)\n            )\n            if self.iri:\n                base_iri = rdflib.URIRef(self.base_iri)\n                for (\n                    s,\n                    p,\n                    o,\n                ) in graph.triples(  # pylint: disable=not-an-iterable\n                    (base_iri, None, None)\n                ):\n                    graph.remove((s, p, o))\n                    graph.add((rdflib.URIRef(self.iri), p, o))\n            graph.serialize(destination=filepath, format=format)\n        finally:\n            os.remove(tmpfile)\n\n    if write_catalog_file and not recursive:\n        write_catalog(\n            {self.get_version(as_iri=True): filepath},\n            output=catalog_file,\n            directory=dir,\n            append=append_catalog,\n        )\n    return Path(returnpath)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.set_common_prefix","title":"<code>set_common_prefix(self, iri_base='http://emmo.info/emmo', prefix='emmo', visited=None)</code>","text":"<p>Set a common prefix for all imported ontologies with the same first part of the base_iri.</p> <p>Parameters:</p> Name Type Description Default <code>iri_base</code> <code>str</code> <p>The start of the base_iri to look for. Defaults to the emmo base_iri http://emmo.info/emmo</p> <code>'http://emmo.info/emmo'</code> <code>prefix</code> <code>str</code> <p>the desired prefix. Defaults to emmo.</p> <code>'emmo'</code> <code>visited</code> <code>Optional[Set]</code> <p>Ontologies to skip. Only intended for internal use.</p> <code>None</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def set_common_prefix(\n    self,\n    iri_base: str = \"http://emmo.info/emmo\",\n    prefix: str = \"emmo\",\n    visited: \"Optional[Set]\" = None,\n) -&gt; None:\n    \"\"\"Set a common prefix for all imported ontologies\n    with the same first part of the base_iri.\n\n    Args:\n        iri_base: The start of the base_iri to look for. Defaults to\n            the emmo base_iri http://emmo.info/emmo\n        prefix: the desired prefix. Defaults to emmo.\n        visited: Ontologies to skip. Only intended for internal use.\n    \"\"\"\n    if visited is None:\n        visited = set()\n    if self.base_iri.startswith(iri_base):\n        self.prefix = prefix\n    for onto in self.imported_ontologies:\n        if not onto in visited:\n            visited.add(onto)\n            onto.set_common_prefix(\n                iri_base=iri_base, prefix=prefix, visited=visited\n            )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.set_default_label_annotations","title":"<code>set_default_label_annotations(self)</code>","text":"<p>Sets the default label annotations.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def set_default_label_annotations(self):\n    \"\"\"Sets the default label annotations.\"\"\"\n    warnings.warn(\n        \"Ontology.set_default_label_annotations() is deprecated. \"\n        \"Default label annotations are set by Ontology.__init__(). \",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    self.label_annotations = DEFAULT_LABEL_ANNOTATIONS[:]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.set_version","title":"<code>set_version(self, version=None, version_iri=None)</code>","text":"<p>Assign version to ontology by asigning owl:versionIRI.</p> <p>If <code>version</code> but not <code>version_iri</code> is provided, the version IRI will be the combination of <code>base_iri</code> and <code>version</code>.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def set_version(self, version=None, version_iri=None):\n    \"\"\"Assign version to ontology by asigning owl:versionIRI.\n\n    If `version` but not `version_iri` is provided, the version\n    IRI will be the combination of `base_iri` and `version`.\n    \"\"\"\n    _version_iri = \"http://www.w3.org/2002/07/owl#versionIRI\"\n    version_iri_storid = self.world._abbreviate(_version_iri)\n    if self._has_obj_triple_spo(  # pylint: disable=unexpected-keyword-arg\n        # For some reason _has_obj_triples_spo exists in both\n        # owlready2.namespace.Namespace (with arguments subject/predicate)\n        # and in owlready2.triplelite._GraphManager (with arguments s/p)\n        # owlready2.Ontology inherits from Namespace directly\n        # and pylint checks that.\n        # It actually accesses the one in triplelite.\n        # subject=self.storid, predicate=version_iri_storid\n        s=self.storid,\n        p=version_iri_storid,\n    ):\n        self._del_obj_triple_spo(s=self.storid, p=version_iri_storid)\n\n    if not version_iri:\n        if not version:\n            raise TypeError(\n                \"Either `version` or `version_iri` must be provided\"\n            )\n        head, tail = self.base_iri.rstrip(\"#/\").rsplit(\"/\", 1)\n        version_iri = \"/\".join([head, version, tail])\n\n    self._add_obj_triple_spo(\n        s=self.storid,\n        p=self.world._abbreviate(_version_iri),\n        o=self.world._abbreviate(version_iri),\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.sync_attributes","title":"<code>sync_attributes(self, name_policy=None, name_prefix='', class_docstring='comment', sync_imported=False)</code>","text":"<p>This method is intended to be called after you have added new classes (typically via Python) to make sure that attributes like <code>label</code> and <code>comments</code> are defined.</p> <p>If a class, object property, data property or annotation property in the current ontology has no label, the name of the corresponding Python class will be assigned as label.</p> <p>If a class, object property, data property or annotation property has no comment, it will be assigned the docstring of the corresponding Python class.</p> <p><code>name_policy</code> specify wether and how the names in the ontology should be updated.  Valid values are:   None          not changed   \"uuid\"        <code>name_prefix</code> followed by a global unique id (UUID).                 If the name is already valid accoridng to this standard                 it will not be regenerated.   \"sequential\"  <code>name_prefix</code> followed a sequantial number. EMMO conventions imply <code>name_policy=='uuid'</code>.</p> <p>If <code>sync_imported</code> is true, all imported ontologies are also updated.</p> <p>The <code>class_docstring</code> argument specifies the annotation that class docstrings are mapped to.  Defaults to \"comment\".</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def sync_attributes(  # pylint: disable=too-many-branches\n    self,\n    name_policy=None,\n    name_prefix=\"\",\n    class_docstring=\"comment\",\n    sync_imported=False,\n):\n    \"\"\"This method is intended to be called after you have added new\n    classes (typically via Python) to make sure that attributes like\n    `label` and `comments` are defined.\n\n    If a class, object property, data property or annotation\n    property in the current ontology has no label, the name of\n    the corresponding Python class will be assigned as label.\n\n    If a class, object property, data property or annotation\n    property has no comment, it will be assigned the docstring of\n    the corresponding Python class.\n\n    `name_policy` specify wether and how the names in the ontology\n    should be updated.  Valid values are:\n      None          not changed\n      \"uuid\"        `name_prefix` followed by a global unique id (UUID).\n                    If the name is already valid accoridng to this standard\n                    it will not be regenerated.\n      \"sequential\"  `name_prefix` followed a sequantial number.\n    EMMO conventions imply ``name_policy=='uuid'``.\n\n    If `sync_imported` is true, all imported ontologies are also\n    updated.\n\n    The `class_docstring` argument specifies the annotation that\n    class docstrings are mapped to.  Defaults to \"comment\".\n    \"\"\"\n    for cls in itertools.chain(\n        self.classes(),\n        self.object_properties(),\n        self.data_properties(),\n        self.annotation_properties(),\n    ):\n        if not hasattr(cls, \"prefLabel\"):\n            # no prefLabel - create new annotation property..\n            with self:\n                # pylint: disable=invalid-name,missing-class-docstring\n                # pylint: disable=unused-variable\n                class prefLabel(owlready2.label):\n                    pass\n\n            cls.prefLabel = [locstr(cls.__name__, lang=\"en\")]\n        elif not cls.prefLabel:\n            cls.prefLabel.append(locstr(cls.__name__, lang=\"en\"))\n        if class_docstring and hasattr(cls, \"__doc__\") and cls.__doc__:\n            getattr(cls, class_docstring).append(\n                locstr(inspect.cleandoc(cls.__doc__), lang=\"en\")\n            )\n\n    for ind in self.individuals():\n        if not hasattr(ind, \"prefLabel\"):\n            # no prefLabel - create new annotation property..\n            with self:\n                # pylint: disable=invalid-name,missing-class-docstring\n                # pylint: disable=function-redefined\n                class prefLabel(owlready2.label):\n                    iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n\n            ind.prefLabel = [locstr(ind.name, lang=\"en\")]\n        elif not ind.prefLabel:\n            ind.prefLabel.append(locstr(ind.name, lang=\"en\"))\n\n    chain = itertools.chain(\n        self.classes(),\n        self.individuals(),\n        self.object_properties(),\n        self.data_properties(),\n        self.annotation_properties(),\n    )\n    if name_policy == \"uuid\":\n        for obj in chain:\n            try:\n                # Passing the following means that the name is valid\n                # and need not be regenerated.\n                if not obj.name.startswith(name_prefix):\n                    raise ValueError\n                uuid.UUID(obj.name.lstrip(name_prefix), version=5)\n            except ValueError:\n                obj.name = name_prefix + str(\n                    uuid.uuid5(uuid.NAMESPACE_DNS, obj.name)\n                )\n    elif name_policy == \"sequential\":\n        for obj in chain:\n            counter = 0\n            while f\"{self.base_iri}{name_prefix}{counter}\" in self:\n                counter += 1\n            obj.name = f\"{name_prefix}{counter}\"\n    elif name_policy is not None:\n        raise TypeError(f\"invalid name_policy: {name_policy!r}\")\n\n    if sync_imported:\n        for onto in self.imported_ontologies:\n            onto.sync_attributes()\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.sync_python_names","title":"<code>sync_python_names(self, annotations=('prefLabel', 'label', 'altLabel'))</code>","text":"<p>Update the <code>python_name</code> attribute of all properties.</p> <p>The python_name attribute will be set to the first non-empty annotation in the sequence of annotations in <code>annotations</code> for the property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def sync_python_names(self, annotations=(\"prefLabel\", \"label\", \"altLabel\")):\n    \"\"\"Update the `python_name` attribute of all properties.\n\n    The python_name attribute will be set to the first non-empty\n    annotation in the sequence of annotations in `annotations` for\n    the property.\n    \"\"\"\n\n    def update(gen):\n        for prop in gen:\n            for annotation in annotations:\n                if hasattr(prop, annotation) and getattr(prop, annotation):\n                    prop.python_name = getattr(prop, annotation).first()\n                    break\n\n    update(\n        self.get_entities(\n            classes=False,\n            individuals=False,\n            object_properties=False,\n            data_properties=False,\n        )\n    )\n    update(\n        self.get_entities(\n            classes=False, individuals=False, annotation_properties=False\n        )\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.sync_reasoner","title":"<code>sync_reasoner(self, reasoner='HermiT', include_imported=False, **kwargs)</code>","text":"<p>Update current ontology by running the given reasoner.</p> <p>Supported values for <code>reasoner</code> are 'HermiT' (default), Pellet and 'FaCT++'.</p> <p>If <code>include_imported</code> is true, the reasoner will also reason over imported ontologies.  Note that this may be very slow.</p> <p>Keyword arguments are passed to the underlying owlready2 function.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def sync_reasoner(\n    self, reasoner=\"HermiT\", include_imported=False, **kwargs\n):\n    \"\"\"Update current ontology by running the given reasoner.\n\n    Supported values for `reasoner` are 'HermiT' (default), Pellet\n    and 'FaCT++'.\n\n    If `include_imported` is true, the reasoner will also reason\n    over imported ontologies.  Note that this may be **very** slow.\n\n    Keyword arguments are passed to the underlying owlready2 function.\n    \"\"\"\n    # pylint: disable=too-many-branches\n\n    removed_equivalent = defaultdict(list)\n    removed_subclasses = defaultdict(list)\n\n    if reasoner == \"FaCT++\":\n        sync = sync_reasoner_factpp\n    elif reasoner == \"Pellet\":\n        sync = owlready2.sync_reasoner_pellet\n    elif reasoner == \"HermiT\":\n        sync = owlready2.sync_reasoner_hermit\n\n        # Remove custom data propertyes, otherwise HermiT will crash\n        datatype_iri = \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n\n        for cls in self.classes(imported=include_imported):\n            remove_eq = []\n            for i, r in enumerate(cls.equivalent_to):\n                if isinstance(r, owlready2.Restriction):\n                    if (\n                        hasattr(r.value.__class__, \"iri\")\n                        and r.value.__class__.iri == datatype_iri\n                    ):\n                        remove_eq.append(i)\n                        removed_equivalent[cls].append(r)\n            for i in reversed(remove_eq):\n                del cls.equivalent_to[i]\n\n            remove_subcls = []\n            for i, r in enumerate(cls.is_a):\n                if isinstance(r, owlready2.Restriction):\n                    if (\n                        hasattr(r.value.__class__, \"iri\")\n                        and r.value.__class__.iri == datatype_iri\n                    ):\n                        remove_subcls.append(i)\n                        removed_subclasses[cls].append(r)\n            for i in reversed(remove_subcls):\n                del cls.is_a[i]\n\n    else:\n        raise ValueError(\n            f\"Unknown reasoner '{reasoner}'. Supported reasoners \"\n            \"are 'Pellet', 'HermiT' and 'FaCT++'.\"\n        )\n\n    # For some reason we must visit all entities once before running\n    # the reasoner...\n    list(self.get_entities())\n\n    with self:\n        if include_imported:\n            sync(self.world, **kwargs)\n        else:\n            sync(self, **kwargs)\n\n    # Restore removed custom data properties\n    for cls, eqs in removed_equivalent.items():\n        cls.extend(eqs)\n    for cls, subcls in removed_subclasses.items():\n        cls.extend(subcls)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.World","title":"<code> World            (World)         </code>","text":"<p>A subclass of owlready2.World.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>class World(owlready2.World):\n    \"\"\"A subclass of owlready2.World.\"\"\"\n\n    def __init__(self, *args, **kwargs):\n        # Caches stored in the world\n        self._cached_catalogs = {}  # maps url to (mtime, iris, dirs)\n        self._iri_mappings = {}  # all iri mappings loaded so far\n        super().__init__(*args, **kwargs)\n\n    def get_ontology(\n        self,\n        base_iri: str = \"emmo-inferred\",\n        OntologyClass: \"owlready2.Ontology\" = None,\n        label_annotations: \"Sequence\" = None,\n    ) -&gt; \"Ontology\":\n        # pylint: disable=too-many-branches\n        \"\"\"Returns a new Ontology from `base_iri`.\n\n        Arguments:\n            base_iri: The base IRI of the ontology. May be one of:\n                - valid URL (possible excluding final .owl or .ttl)\n                - file name (possible excluding final .owl or .ttl)\n                - \"emmo\": load latest version of asserted EMMO\n                - \"emmo-inferred\": load latest version of inferred EMMO\n                  (default)\n                - \"emmo-development\": load latest inferred development\n                  version of EMMO. Until first stable release\n                  emmo-inferred and emmo-development will be the same.\n            OntologyClass: If given and `base_iri` doesn't correspond\n                to an existing ontology, a new ontology is created of\n                this Ontology subclass.  Defaults to `ontopy.Ontology`.\n            label_annotations: Sequence of label IRIs used for accessing\n                entities in the ontology given that they are in the ontology.\n                Label IRIs not in the ontology will need to be added to\n                ontologies in order to be accessible.\n                Defaults to DEFAULT_LABEL_ANNOTATIONS if set to None.\n        \"\"\"\n        base_iri = base_iri.as_uri() if isinstance(base_iri, Path) else base_iri\n\n        if base_iri == \"emmo\":\n            base_iri = (\n                \"http://emmo-repo.github.io/versions/1.0.0-beta4/emmo.ttl\"\n            )\n        elif base_iri == \"emmo-inferred\":\n            base_iri = (\n                \"https://emmo-repo.github.io/versions/1.0.0-beta4/\"\n                \"emmo-inferred.ttl\"\n            )\n        elif base_iri == \"emmo-development\":\n            base_iri = (\n                \"https://emmo-repo.github.io/versions/1.0.0-beta5/\"\n                \"emmo-inferred.ttl\"\n            )\n\n        if base_iri in self.ontologies:\n            onto = self.ontologies[base_iri]\n        elif base_iri + \"#\" in self.ontologies:\n            onto = self.ontologies[base_iri + \"#\"]\n        elif base_iri + \"/\" in self.ontologies:\n            onto = self.ontologies[base_iri + \"/\"]\n        else:\n            if os.path.exists(base_iri):\n                iri = os.path.abspath(base_iri)\n            elif os.path.exists(base_iri + \".ttl\"):\n                iri = os.path.abspath(base_iri + \".ttl\")\n            elif os.path.exists(base_iri + \".owl\"):\n                iri = os.path.abspath(base_iri + \".owl\")\n            else:\n                iri = base_iri\n\n            if iri[-1] not in \"/#\":\n                iri += \"#\"\n\n            if OntologyClass is None:\n                OntologyClass = Ontology\n\n            onto = OntologyClass(self, iri)\n\n        if label_annotations:\n            onto.label_annotations = list(label_annotations)\n\n        return onto\n\n    def get_unabbreviated_triples(\n        self, subject=None, predicate=None, obj=None, blank=None\n    ):\n        # pylint: disable=invalid-name\n        \"\"\"Returns all triples unabbreviated.\n\n        If any of the `subject`, `predicate` or `obj` arguments are given,\n        only matching triples will be returned.\n\n        If `blank` is given, it will be used to represent blank nodes.\n        \"\"\"\n        return _get_unabbreviated_triples(\n            self, subject=subject, predicate=predicate, obj=obj, blank=blank\n        )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.World.get_ontology","title":"<code>get_ontology(self, base_iri='emmo-inferred', OntologyClass=None, label_annotations=None)</code>","text":"<p>Returns a new Ontology from <code>base_iri</code>.</p> <p>Parameters:</p> Name Type Description Default <code>base_iri</code> <code>str</code> <p>The base IRI of the ontology. May be one of: - valid URL (possible excluding final .owl or .ttl) - file name (possible excluding final .owl or .ttl) - \"emmo\": load latest version of asserted EMMO - \"emmo-inferred\": load latest version of inferred EMMO   (default) - \"emmo-development\": load latest inferred development   version of EMMO. Until first stable release   emmo-inferred and emmo-development will be the same.</p> <code>'emmo-inferred'</code> <code>OntologyClass</code> <code>owlready2.Ontology</code> <p>If given and <code>base_iri</code> doesn't correspond to an existing ontology, a new ontology is created of this Ontology subclass.  Defaults to <code>ontopy.Ontology</code>.</p> <code>None</code> <code>label_annotations</code> <code>Sequence</code> <p>Sequence of label IRIs used for accessing entities in the ontology given that they are in the ontology. Label IRIs not in the ontology will need to be added to ontologies in order to be accessible. Defaults to DEFAULT_LABEL_ANNOTATIONS if set to None.</p> <code>None</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_ontology(\n    self,\n    base_iri: str = \"emmo-inferred\",\n    OntologyClass: \"owlready2.Ontology\" = None,\n    label_annotations: \"Sequence\" = None,\n) -&gt; \"Ontology\":\n    # pylint: disable=too-many-branches\n    \"\"\"Returns a new Ontology from `base_iri`.\n\n    Arguments:\n        base_iri: The base IRI of the ontology. May be one of:\n            - valid URL (possible excluding final .owl or .ttl)\n            - file name (possible excluding final .owl or .ttl)\n            - \"emmo\": load latest version of asserted EMMO\n            - \"emmo-inferred\": load latest version of inferred EMMO\n              (default)\n            - \"emmo-development\": load latest inferred development\n              version of EMMO. Until first stable release\n              emmo-inferred and emmo-development will be the same.\n        OntologyClass: If given and `base_iri` doesn't correspond\n            to an existing ontology, a new ontology is created of\n            this Ontology subclass.  Defaults to `ontopy.Ontology`.\n        label_annotations: Sequence of label IRIs used for accessing\n            entities in the ontology given that they are in the ontology.\n            Label IRIs not in the ontology will need to be added to\n            ontologies in order to be accessible.\n            Defaults to DEFAULT_LABEL_ANNOTATIONS if set to None.\n    \"\"\"\n    base_iri = base_iri.as_uri() if isinstance(base_iri, Path) else base_iri\n\n    if base_iri == \"emmo\":\n        base_iri = (\n            \"http://emmo-repo.github.io/versions/1.0.0-beta4/emmo.ttl\"\n        )\n    elif base_iri == \"emmo-inferred\":\n        base_iri = (\n            \"https://emmo-repo.github.io/versions/1.0.0-beta4/\"\n            \"emmo-inferred.ttl\"\n        )\n    elif base_iri == \"emmo-development\":\n        base_iri = (\n            \"https://emmo-repo.github.io/versions/1.0.0-beta5/\"\n            \"emmo-inferred.ttl\"\n        )\n\n    if base_iri in self.ontologies:\n        onto = self.ontologies[base_iri]\n    elif base_iri + \"#\" in self.ontologies:\n        onto = self.ontologies[base_iri + \"#\"]\n    elif base_iri + \"/\" in self.ontologies:\n        onto = self.ontologies[base_iri + \"/\"]\n    else:\n        if os.path.exists(base_iri):\n            iri = os.path.abspath(base_iri)\n        elif os.path.exists(base_iri + \".ttl\"):\n            iri = os.path.abspath(base_iri + \".ttl\")\n        elif os.path.exists(base_iri + \".owl\"):\n            iri = os.path.abspath(base_iri + \".owl\")\n        else:\n            iri = base_iri\n\n        if iri[-1] not in \"/#\":\n            iri += \"#\"\n\n        if OntologyClass is None:\n            OntologyClass = Ontology\n\n        onto = OntologyClass(self, iri)\n\n    if label_annotations:\n        onto.label_annotations = list(label_annotations)\n\n    return onto\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.World.get_unabbreviated_triples","title":"<code>get_unabbreviated_triples(self, subject=None, predicate=None, obj=None, blank=None)</code>","text":"<p>Returns all triples unabbreviated.</p> <p>If any of the <code>subject</code>, <code>predicate</code> or <code>obj</code> arguments are given, only matching triples will be returned.</p> <p>If <code>blank</code> is given, it will be used to represent blank nodes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_unabbreviated_triples(\n    self, subject=None, predicate=None, obj=None, blank=None\n):\n    # pylint: disable=invalid-name\n    \"\"\"Returns all triples unabbreviated.\n\n    If any of the `subject`, `predicate` or `obj` arguments are given,\n    only matching triples will be returned.\n\n    If `blank` is given, it will be used to represent blank nodes.\n    \"\"\"\n    return _get_unabbreviated_triples(\n        self, subject=subject, predicate=predicate, obj=obj, blank=blank\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.flatten","title":"<code>flatten(items)</code>","text":"<p>Yield items from any nested iterable.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def flatten(items):\n    \"\"\"Yield items from any nested iterable.\"\"\"\n    for item in items:\n        if isinstance(item, Iterable) and not isinstance(item, (str, bytes)):\n            yield from flatten(item)\n        else:\n            yield item\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.get_ontology","title":"<code>get_ontology(*args, **kwargs)</code>","text":"<p>Returns a new Ontology from <code>base_iri</code>.</p> <p>This is a convenient function for calling World.get_ontology().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_ontology(*args, **kwargs):\n    \"\"\"Returns a new Ontology from `base_iri`.\n\n    This is a convenient function for calling World.get_ontology().\"\"\"\n    return World().get_ontology(*args, **kwargs)\n</code></pre>"},{"location":"api_reference/ontopy/patch/","title":"patch","text":"<p>This module injects some additional methods into owlready2 classes.</p>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.disjoint_with","title":"<code>disjoint_with(self, reduce=False)</code>","text":"<p>Returns a generator with all classes that are disjoint with <code>self</code>.</p> <p>If <code>reduce</code> is <code>True</code>, all classes that are a descendant of another class will be excluded.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def disjoint_with(self, reduce=False):\n    \"\"\"Returns a generator with all classes that are disjoint with `self`.\n\n    If `reduce` is `True`, all classes that are a descendant of another class\n    will be excluded.\n    \"\"\"\n    if reduce:\n        disjoint_set = set(self.disjoint_with())\n        for entity in disjoint_set.copy():\n            disjoint_set.difference_update(\n                entity.descendants(include_self=False)\n            )\n        yield from disjoint_set\n    else:\n        for disjoint in self.disjoints():\n            for entity in disjoint.entities:\n                if entity is not self:\n                    yield entity\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_annotations","title":"<code>get_annotations(self, all=False, imported=True)</code>","text":"<p>Returns a dict with non-empty annotations.</p> <p>If <code>all</code> is <code>True</code>, also annotations with no value are included.</p> <p>If <code>imported</code> is <code>True</code>, also include annotations defined in imported ontologies.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_annotations(\n    self, all=False, imported=True\n):  # pylint: disable=redefined-builtin\n    \"\"\"Returns a dict with non-empty annotations.\n\n    If `all` is `True`, also annotations with no value are included.\n\n    If `imported` is `True`, also include annotations defined in imported\n    ontologies.\n    \"\"\"\n    onto = self.namespace.ontology\n\n    def extend(key, values):\n        \"\"\"Extend annotations with a sequence of values.\"\"\"\n        if key in annotations:\n            annotations[key].extend(values)\n        else:\n            annotations[key] = values\n\n    annotations = {\n        str(get_preferred_label(a)): a._get_values_for_class(self)\n        for a in onto.annotation_properties(imported=imported)\n    }\n    extend(\"comment\", self.comment)\n    extend(\"label\", self.label)\n    if all:\n        return annotations\n    return {key: value for key, value in annotations.items() if value}\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_indirect_is_a","title":"<code>get_indirect_is_a(self, skip_classes=True)</code>","text":"<p>Returns the set of all isSubclassOf relations of self and its ancestors.</p> <p>If <code>skip_classes</code> is <code>True</code>, indirect classes are not included in the returned set.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_indirect_is_a(self, skip_classes=True):\n    \"\"\"Returns the set of all isSubclassOf relations of self and its ancestors.\n\n    If `skip_classes` is `True`, indirect classes are not included in the\n    returned set.\n    \"\"\"\n    subclass_relations = set()\n    for entity in reversed(self.mro()):\n        for attr in \"is_a\", \"equivalent_to\":\n            if hasattr(entity, attr):\n                lst = getattr(entity, attr)\n                if skip_classes:\n                    subclass_relations.update(\n                        r\n                        for r in lst\n                        if not isinstance(r, owlready2.ThingClass)\n                    )\n                else:\n                    subclass_relations.update(lst)\n\n    subclass_relations.update(self.is_a)\n    return subclass_relations\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_parents","title":"<code>get_parents(self, strict=False)</code>","text":"<p>Returns a list of all parents.</p> <p>If <code>strict</code> is <code>True</code>, parents that are parents of other parents are excluded.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_parents(self, strict=False):\n    \"\"\"Returns a list of all parents.\n\n    If `strict` is `True`, parents that are parents of other parents are\n    excluded.\n    \"\"\"\n    if strict:\n        parents = self.get_parents()\n        for entity in parents.copy():\n            parents.difference_update(entity.ancestors(include_self=False))\n        return parents\n    if isinstance(self, ThingClass):\n        return {cls for cls in self.is_a if isinstance(cls, ThingClass)}\n    if isinstance(self, owlready2.ObjectPropertyClass):\n        return {\n            cls\n            for cls in self.is_a\n            if isinstance(cls, owlready2.ObjectPropertyClass)\n        }\n    raise EMMOntoPyException(\n        \"self has no parents - this should not be possible!\"\n    )\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_preferred_label","title":"<code>get_preferred_label(self)</code>","text":"<p>Returns the preferred label as a string (not list).</p> <p>The following heuristics is used:   - if prefLabel annotation property exists, returns the first prefLabel   - if label annotation property exists, returns the first label   - otherwise return the name</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_preferred_label(self):\n    \"\"\"Returns the preferred label as a string (not list).\n\n    The following heuristics is used:\n      - if prefLabel annotation property exists, returns the first prefLabel\n      - if label annotation property exists, returns the first label\n      - otherwise return the name\n    \"\"\"\n    if hasattr(self, \"prefLabel\") and self.prefLabel:\n        return self.prefLabel[0]\n    if hasattr(self, \"label\") and self.label:\n        return self.label.first()\n    return self.name\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_typename","title":"<code>get_typename(self)</code>","text":"<p>Get restriction type label/name.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_typename(self):\n    \"\"\"Get restriction type label/name.\"\"\"\n    return owlready2.class_construct._restriction_type_2_label[self.type]\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.has","title":"<code>has(self, name)</code>","text":"<p>Returns true if <code>name</code></p> Source code in <code>ontopy/patch.py</code> <pre><code>def has(self, name):\n    \"\"\"Returns true if `name`\"\"\"\n    return name in set(self.keys())\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.items","title":"<code>items(self)</code>","text":"<p>Return a generator over annotation property (name, value_list) pairs associates with this ontology.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def items(self):\n    \"\"\"Return a generator over annotation property (name, value_list)\n    pairs associates with this ontology.\"\"\"\n    namespace = self.namespace\n    for annotation in namespace.annotation_properties():\n        if namespace._has_data_triple_spod(\n            s=namespace.storid, p=annotation.storid\n        ):\n            yield annotation, getattr(self, annotation.name)\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.keys","title":"<code>keys(self)</code>","text":"<p>Return a generator over annotation property names associated with this ontology.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def keys(self):\n    \"\"\"Return a generator over annotation property names associated\n    with this ontology.\"\"\"\n    namespace = self.namespace\n    for annotation in namespace.annotation_properties():\n        if namespace._has_data_triple_spod(\n            s=namespace.storid, p=annotation.storid\n        ):\n            yield annotation\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.namespace_init","title":"<code>namespace_init(self, world_or_ontology, base_iri, name=None)</code>","text":"<p>init function for the <code>Namespace</code> class.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def namespace_init(self, world_or_ontology, base_iri, name=None):\n    \"\"\"__init__ function for the `Namespace` class.\"\"\"\n    orig_namespace_init(self, world_or_ontology, base_iri, name)\n    if self.name.endswith(\".ttl\"):\n        self.name = self.name[:-4]\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.render_func","title":"<code>render_func(entity)</code>","text":"<p>Improve default rendering of entities.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def render_func(entity):\n    \"\"\"Improve default rendering of entities.\"\"\"\n    if hasattr(entity, \"prefLabel\") and entity.prefLabel:\n        name = entity.prefLabel[0]\n    elif hasattr(entity, \"label\") and entity.label:\n        name = entity.label[0]\n    elif hasattr(entity, \"altLabel\") and entity.altLabel:\n        name = entity.altLabel[0]\n    else:\n        name = entity.name\n    return f\"{entity.namespace.name}.{name}\"\n</code></pre>"},{"location":"api_reference/ontopy/testutils/","title":"testutils","text":"<p>Module primarly intended to be imported by tests.</p> <p>It defines some directories and some utility functions that can be used with and without conftest.</p>"},{"location":"api_reference/ontopy/testutils/#ontopy.testutils.get_tool_module","title":"<code>get_tool_module(name)</code>","text":"<p>Imports and returns the module for the EMMOntoPy tool corresponding to <code>name</code>.</p> Source code in <code>ontopy/testutils.py</code> <pre><code>def get_tool_module(name):\n    \"\"\"Imports and returns the module for the EMMOntoPy tool\n    corresponding to `name`.\"\"\"\n    if str(toolsdir) not in sys.path:\n        sys.path.append(str(toolsdir))\n\n    # For Python 3.4+\n    spec = spec_from_loader(name, SourceFileLoader(name, str(toolsdir / name)))\n    module = module_from_spec(spec)\n    spec.loader.exec_module(module)\n    return module\n</code></pre>"},{"location":"api_reference/ontopy/utils/","title":"utils","text":"<p>Some generic utility functions.</p>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.AmbiguousLabelError","title":"<code> AmbiguousLabelError            (LookupError, AttributeError, EMMOntoPyException)         </code>","text":"<p>Error raised when a label is ambiguous.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class AmbiguousLabelError(LookupError, AttributeError, EMMOntoPyException):\n    \"\"\"Error raised when a label is ambiguous.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.EMMOntoPyException","title":"<code> EMMOntoPyException            (Exception)         </code>","text":"<p>A BaseException class for EMMOntoPy</p> Source code in <code>ontopy/utils.py</code> <pre><code>class EMMOntoPyException(Exception):\n    \"\"\"A BaseException class for EMMOntoPy\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.EMMOntoPyWarning","title":"<code> EMMOntoPyWarning            (Warning)         </code>","text":"<p>A BaseWarning class for EMMOntoPy</p> Source code in <code>ontopy/utils.py</code> <pre><code>class EMMOntoPyWarning(Warning):\n    \"\"\"A BaseWarning class for EMMOntoPy\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.EntityClassDefinitionError","title":"<code> EntityClassDefinitionError            (EMMOntoPyException)         </code>","text":"<p>Error in ThingClass definition.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class EntityClassDefinitionError(EMMOntoPyException):\n    \"\"\"Error in ThingClass definition.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.IncompatibleVersion","title":"<code> IncompatibleVersion            (EMMOntoPyWarning)         </code>","text":"<p>An installed dependency version may be incompatible with a functionality of this package - or rather an outcome of a functionality. This is not critical, hence this is only a warning.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class IncompatibleVersion(EMMOntoPyWarning):\n    \"\"\"An installed dependency version may be incompatible with a functionality\n    of this package - or rather an outcome of a functionality.\n    This is not critical, hence this is only a warning.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.IndividualWarning","title":"<code> IndividualWarning            (EMMOntoPyWarning)         </code>","text":"<p>A warning related to an individual, e.g. punning.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class IndividualWarning(EMMOntoPyWarning):\n    \"\"\"A warning related to an individual, e.g. punning.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.LabelDefinitionError","title":"<code> LabelDefinitionError            (EMMOntoPyException)         </code>","text":"<p>Error in label definition.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class LabelDefinitionError(EMMOntoPyException):\n    \"\"\"Error in label definition.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.NoSuchLabelError","title":"<code> NoSuchLabelError            (LookupError, AttributeError, EMMOntoPyException)         </code>","text":"<p>Error raised when a label cannot be found.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class NoSuchLabelError(LookupError, AttributeError, EMMOntoPyException):\n    \"\"\"Error raised when a label cannot be found.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.ReadCatalogError","title":"<code> ReadCatalogError            (OSError)         </code>","text":"<p>Error reading catalog file.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class ReadCatalogError(IOError):\n    \"\"\"Error reading catalog file.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.UnknownVersion","title":"<code> UnknownVersion            (EMMOntoPyException)         </code>","text":"<p>Cannot retrieve version from a package.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class UnknownVersion(EMMOntoPyException):\n    \"\"\"Cannot retrieve version from a package.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.annotate_source","title":"<code>annotate_source(onto, imported=True)</code>","text":"<p>Annotate all entities with the base IRI of the ontology using <code>rdfs:isDefinedBy</code> annotations.</p> <p>If <code>imported</code> is true, all entities in imported sub-ontologies will also be annotated.</p> <p>This is contextual information that is otherwise lost when the ontology is squashed and/or inferred.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def annotate_source(onto, imported=True):\n    \"\"\"Annotate all entities with the base IRI of the ontology using\n    `rdfs:isDefinedBy` annotations.\n\n    If `imported` is true, all entities in imported sub-ontologies will\n    also be annotated.\n\n    This is contextual information that is otherwise lost when the ontology\n    is squashed and/or inferred.\n    \"\"\"\n    source = onto._abbreviate(\n        \"http://www.w3.org/2000/01/rdf-schema#isDefinedBy\"\n    )\n    for entity in onto.get_entities(imported=imported):\n        triple = (\n            entity.storid,\n            source,\n            onto._abbreviate(entity.namespace.ontology.base_iri),\n        )\n        if not onto._has_obj_triple_spo(*triple):\n            onto._add_obj_triple_spo(*triple)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.asstring","title":"<code>asstring(expr, link='{label}', recursion_depth=0, exclude_object=False, ontology=None)</code>","text":"<p>Returns a string representation of <code>expr</code>.</p> <p>Parameters:</p> Name Type Description Default <code>expr</code> <p>The entity, restriction or a logical expression or these to represent.</p> required <code>link</code> <p>A template for links.  May contain the following variables: - {iri}: The full IRI of the concept. - {name}: Name-part of IRI. - {ref}: \"#{name}\" if the base iri of hte ontology has the same   root as {iri}, otherwise \"{iri}\". - {label}: The label of the concept. - {lowerlabel}: The label of the concept in lower case and with   spaces replaced with hyphens.</p> <code>'{label}'</code> <code>recursion_depth</code> <p>Recursion depth. Only intended for internal use.</p> <code>0</code> <code>exclude_object</code> <p>If true, the object will be excluded in restrictions.</p> <code>False</code> <code>ontology</code> <p>Ontology object.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>String representation of <code>expr</code>.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def asstring(\n    expr,\n    link=\"{label}\",\n    recursion_depth=0,\n    exclude_object=False,\n    ontology=None,\n) -&gt; str:\n    \"\"\"Returns a string representation of `expr`.\n\n    Arguments:\n        expr: The entity, restriction or a logical expression or these\n            to represent.\n        link: A template for links.  May contain the following variables:\n            - {iri}: The full IRI of the concept.\n            - {name}: Name-part of IRI.\n            - {ref}: \"#{name}\" if the base iri of hte ontology has the same\n              root as {iri}, otherwise \"{iri}\".\n            - {label}: The label of the concept.\n            - {lowerlabel}: The label of the concept in lower case and with\n              spaces replaced with hyphens.\n        recursion_depth: Recursion depth. Only intended for internal use.\n        exclude_object: If true, the object will be excluded in restrictions.\n        ontology: Ontology object.\n\n    Returns:\n        String representation of `expr`.\n    \"\"\"\n    # pylint: disable=too-many-return-statements,too-many-branches,too-many-statements\n    if ontology is None:\n        ontology = expr.ontology\n\n    def fmt(entity):\n        \"\"\"Returns the formatted label of an entity.\"\"\"\n        if isinstance(entity, str):\n            if ontology and ontology.world[entity]:\n                iri = ontology.world[entity].iri\n            elif (\n                ontology\n                and re.match(\"^[a-zA-Z0-9_+-]+$\", entity)\n                and entity in ontology\n            ):\n                iri = ontology[entity].iri\n            else:\n                # This may not be a valid IRI, but the best we can do\n                iri = entity\n            label = entity\n        else:\n            iri = entity.iri\n            label = get_label(entity)\n        name = getiriname(iri)\n        start = iri.split(\"#\", 1)[0] if \"#\" in iri else iri.rsplit(\"/\", 1)[0]\n        ref = f\"#{name}\" if ontology.base_iri.startswith(start) else iri\n        return link.format(\n            entity=entity,\n            name=name,\n            ref=ref,\n            iri=iri,\n            label=label,\n            lowerlabel=label.lower().replace(\" \", \"-\"),\n        )\n\n    if isinstance(expr, str):\n        # return link.format(name=expr)\n        return fmt(expr)\n    if isinstance(expr, owlready2.Restriction):\n        rlabel = owlready2.class_construct._restriction_type_2_label[expr.type]\n\n        if isinstance(\n            expr.property,\n            (owlready2.ObjectPropertyClass, owlready2.DataPropertyClass),\n        ):\n            res = fmt(expr.property)\n        elif isinstance(expr.property, owlready2.Inverse):\n            string = asstring(\n                expr.property.property,\n                link,\n                recursion_depth + 1,\n                ontology=ontology,\n            )\n            res = f\"Inverse({string})\"\n        else:\n            print(\n                f\"*** WARNING: unknown restriction property: {expr.property!r}\"\n            )\n            res = fmt(expr.property)\n\n        if not rlabel:\n            pass\n        elif expr.type in (owlready2.MIN, owlready2.MAX, owlready2.EXACTLY):\n            res += f\" {rlabel} {expr.cardinality}\"\n        elif expr.type in (\n            owlready2.SOME,\n            owlready2.ONLY,\n            owlready2.VALUE,\n            owlready2.HAS_SELF,\n        ):\n            res += f\" {rlabel}\"\n        else:\n            print(\"*** WARNING: unknown relation\", expr, rlabel)\n            res += f\" {rlabel}\"\n\n        if not exclude_object:\n            string = asstring(\n                expr.value, link, recursion_depth + 1, ontology=ontology\n            )\n            res += (\n                f\" {string!r}\" if isinstance(expr.value, str) else f\" {string}\"\n            )\n        return res\n    if isinstance(expr, owlready2.Or):\n        res = \" or \".join(\n            [\n                asstring(c, link, recursion_depth + 1, ontology=ontology)\n                for c in expr.Classes\n            ]\n        )\n        return res if recursion_depth == 0 else f\"({res})\"\n    if isinstance(expr, owlready2.And):\n        res = \" and \".join(\n            [\n                asstring(c, link, recursion_depth + 1, ontology=ontology)\n                for c in expr.Classes\n            ]\n        )\n        return res if recursion_depth == 0 else f\"({res})\"\n    if isinstance(expr, owlready2.Not):\n        string = asstring(\n            expr.Class, link, recursion_depth + 1, ontology=ontology\n        )\n        return f\"not {string}\"\n    if isinstance(expr, owlready2.ThingClass):\n        return fmt(expr)\n    if isinstance(expr, owlready2.PropertyClass):\n        return fmt(expr)\n    if isinstance(expr, owlready2.Thing):  # instance (individual)\n        return fmt(expr)\n    if isinstance(expr, owlready2.class_construct.Inverse):\n        return f\"inverse({fmt(expr.property)})\"\n    if isinstance(expr, owlready2.disjoint.AllDisjoint):\n        return fmt(expr)\n\n    if isinstance(expr, (bool, int, float)):\n        return repr(expr)\n    # Check for subclasses\n    if inspect.isclass(expr):\n        if issubclass(expr, (bool, int, float, str)):\n            return fmt(expr.__class__.__name__)\n        if issubclass(expr, datetime.date):\n            return \"date\"\n        if issubclass(expr, datetime.time):\n            return \"datetime\"\n        if issubclass(expr, datetime.datetime):\n            return \"datetime\"\n\n    raise RuntimeError(f\"Unknown expression: {expr!r} (type: {type(expr)!r})\")\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.camelsplit","title":"<code>camelsplit(string)</code>","text":"<p>Splits CamelCase string before upper case letters (except if there is a sequence of upper case letters).</p> Source code in <code>ontopy/utils.py</code> <pre><code>def camelsplit(string):\n    \"\"\"Splits CamelCase string before upper case letters (except\n    if there is a sequence of upper case letters).\"\"\"\n    if len(string) &lt; 2:\n        return string\n    result = []\n    prev_lower = False\n    prev_isspace = True\n    char = string[0]\n    for next_char in string[1:]:\n        if (not prev_isspace and char.isupper() and next_char.islower()) or (\n            prev_lower and char.isupper()\n        ):\n            result.append(\" \")\n        result.append(char)\n        prev_lower = char.islower()\n        prev_isspace = char.isspace()\n        char = next_char\n    result.append(char)\n    return \"\".join(result)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.convert_imported","title":"<code>convert_imported(input_ontology, output_ontology, input_format=None, output_format='xml', url_from_catalog=None, catalog_file='catalog-v001.xml')</code>","text":"<p>Convert imported ontologies.</p> <p>Store the output in a directory structure matching the source files.  This require catalog file(s) to be present.</p> <p>Warning</p> <p>To convert to Turtle (<code>.ttl</code>) format, you must have installed <code>rdflib&gt;=6.0.0</code>. See Known issues for more information.</p> <p>Parameters:</p> Name Type Description Default <code>input_ontology</code> <code>Union[Path, str]</code> <p>input ontology file name</p> required <code>output_ontology</code> <code>Union[Path, str]</code> <p>output ontology file path. The directory part of <code>output</code> will be the root of the generated directory structure</p> required <code>input_format</code> <code>Optional[str]</code> <p>input format. The default is to infer from <code>input_ontology</code></p> <code>None</code> <code>output_format</code> <code>str</code> <p>output format. The default is to infer from <code>output_ontology</code></p> <code>'xml'</code> <code>url_from_catalog</code> <code>Optional[bool]</code> <p>Whether to read urls form catalog file. If False, the catalog file will be used if it exists.</p> <code>None</code> <code>catalog_file</code> <code>str</code> <p>name of catalog file, that maps ontology IRIs to local file names</p> <code>'catalog-v001.xml'</code> Source code in <code>ontopy/utils.py</code> <pre><code>def convert_imported(  # pylint: disable=too-many-arguments,too-many-locals\n    input_ontology: \"Union[Path, str]\",\n    output_ontology: \"Union[Path, str]\",\n    input_format: \"Optional[str]\" = None,\n    output_format: str = \"xml\",\n    url_from_catalog: \"Optional[bool]\" = None,\n    catalog_file: str = \"catalog-v001.xml\",\n):\n    \"\"\"Convert imported ontologies.\n\n    Store the output in a directory structure matching the source\n    files.  This require catalog file(s) to be present.\n\n    Warning:\n        To convert to Turtle (`.ttl`) format, you must have installed\n        `rdflib&gt;=6.0.0`. See [Known issues](../../../#known-issues) for\n        more information.\n\n    Args:\n        input_ontology: input ontology file name\n        output_ontology: output ontology file path. The directory part of\n            `output` will be the root of the generated directory structure\n        input_format: input format. The default is to infer from\n            `input_ontology`\n        output_format: output format. The default is to infer from\n            `output_ontology`\n        url_from_catalog: Whether to read urls form catalog file.\n            If False, the catalog file will be used if it exists.\n        catalog_file: name of catalog file, that maps ontology IRIs to\n            local file names\n    \"\"\"\n    inroot = os.path.dirname(os.path.abspath(input_ontology))\n    outroot = os.path.dirname(os.path.abspath(output_ontology))\n    outext = os.path.splitext(output_ontology)[1]\n\n    if url_from_catalog is None:\n        url_from_catalog = os.path.exists(os.path.join(inroot, catalog_file))\n\n    if url_from_catalog:\n        iris, dirs = read_catalog(\n            inroot, catalog_file=catalog_file, recursive=True, return_paths=True\n        )\n\n        # Create output dirs and copy catalog files\n        for indir in dirs:\n            outdir = os.path.normpath(\n                os.path.join(outroot, os.path.relpath(indir, inroot))\n            )\n            if not os.path.exists(outdir):\n                os.makedirs(outdir)\n            with open(\n                os.path.join(indir, catalog_file), mode=\"rt\", encoding=\"utf8\"\n            ) as handle:\n                content = handle.read()\n            for path in iris.values():\n                newpath = os.path.splitext(path)[0] + outext\n                content = content.replace(\n                    os.path.basename(path), os.path.basename(newpath)\n                )\n            with open(\n                os.path.join(outdir, catalog_file), mode=\"wt\", encoding=\"utf8\"\n            ) as handle:\n                handle.write(content)\n    else:\n        iris = {}\n\n    outpaths = set()\n\n    def recur(graph, outext):\n        for imported in graph.objects(\n            predicate=URIRef(\"http://www.w3.org/2002/07/owl#imports\")\n        ):\n            inpath = iris.get(str(imported), str(imported))\n            if inpath.startswith((\"http://\", \"https://\", \"ftp://\")):\n                outpath = os.path.join(outroot, inpath.split(\"/\")[-1])\n            else:\n                outpath = os.path.join(outroot, os.path.relpath(inpath, inroot))\n            outpath = os.path.splitext(os.path.normpath(outpath))[0] + outext\n            if outpath not in outpaths:\n                outpaths.add(outpath)\n                fmt = (\n                    input_format\n                    if input_format\n                    else guess_format(inpath, fmap=FMAP)\n                )\n                new_graph = Graph()\n                new_graph.parse(iris.get(inpath, inpath), format=fmt)\n                new_graph.serialize(destination=outpath, format=output_format)\n                recur(new_graph, outext)\n\n    # Write output files\n    fmt = (\n        input_format\n        if input_format\n        else guess_format(input_ontology, fmap=FMAP)\n    )\n\n    if not _validate_installed_version(\n        package=\"rdflib\", min_version=\"6.0.0\"\n    ) and (output_format == FMAP.get(\"ttl\", \"\") or outext == \"ttl\"):\n        from rdflib import (  # pylint: disable=import-outside-toplevel\n            __version__ as __rdflib_version__,\n        )\n\n        warnings.warn(\n            IncompatibleVersion(\n                \"To correctly convert to Turtle format, rdflib must be \"\n                \"version 6.0.0 or greater, however, the detected rdflib \"\n                \"version used by your Python interpreter is \"\n                f\"{__rdflib_version__!r}. For more information see the \"\n                \"'Known issues' section of the README.\"\n            )\n        )\n\n    graph = Graph()\n    try:\n        graph.parse(input_ontology, format=fmt)\n    except PluginException as exc:  # Add input_ontology to exception msg\n        raise PluginException(\n            f'Cannot load \"{input_ontology}\": {exc.msg}'\n        ).with_traceback(exc.__traceback__)\n    graph.serialize(destination=output_ontology, format=output_format)\n    recur(graph, outext)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.copy_annotation","title":"<code>copy_annotation(onto, src, dst)</code>","text":"<p>In all classes and properties in <code>onto</code>, copy annotation <code>src</code> to <code>dst</code>.</p> <p>Parameters:</p> Name Type Description Default <code>onto</code> <p>Ontology to work on.</p> required <code>src</code> <p>Name of source annotation.</p> required <code>dst</code> <p>Name or IRI of destination annotation.  Use IRI if the destination annotation is not already in the ontology.</p> required Source code in <code>ontopy/utils.py</code> <pre><code>def copy_annotation(onto, src, dst):\n    \"\"\"In all classes and properties in `onto`, copy annotation `src` to `dst`.\n\n    Arguments:\n        onto: Ontology to work on.\n        src: Name of source annotation.\n        dst: Name or IRI of destination annotation.  Use IRI if the\n            destination annotation is not already in the ontology.\n    \"\"\"\n    if onto.world[src]:\n        src = onto.world[src]\n    else:\n        src = onto[src]\n\n    if onto.world[dst]:\n        dst = onto.world[dst]\n    elif dst in onto:\n        dst = onto[dst]\n    else:\n        if \"://\" not in dst:\n            raise ValueError(\n                \"new destination annotation property must be provided as \"\n                \"a full IRI\"\n            )\n        name = min(dst.rsplit(\"#\")[-1], dst.rsplit(\"/\")[-1], key=len)\n        iri = dst\n        dst = onto.new_annotation_property(name, owlready2.AnnotationProperty)\n        dst.iri = iri\n\n    for e in onto.get_entities():\n        new = getattr(e, src.name).first()\n        if new and new not in getattr(e, dst.name):\n            getattr(e, dst.name).append(new)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.directory_layout","title":"<code>directory_layout(onto)</code>","text":"<p>Analyse IRIs of imported ontologies and suggested a directory layout for saving recursively.</p> <p>Parameters:</p> Name Type Description Default <code>onto</code> <p>Ontology to analyse.</p> required <p>Returns:</p> Type Description <code>layout</code> <p>A dict mapping ontology objects to relative path names     derived from the ontology IRIs. No file name extension are     added.</p> <p>Examples:</p> <p>Assume that our ontology <code>onto</code> has IRI <code>ex:onto</code>. If it directly or indirectly imports ontologies with IRIs <code>ex:A/ontoA</code>, <code>ex:B/ontoB</code> and <code>ex:A/C/ontoC</code>, this function will return the following dict:</p> <pre><code>{\n    onto: \"onto\",\n    ontoA: \"A/ontoA\",\n    ontoB: \"B/ontoB\",\n    ontoC: \"A/C/ontoC\",\n}\n</code></pre> <p>where <code>ontoA</code>, <code>ontoB</code> and <code>ontoC</code> are imported Ontology objects.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def directory_layout(onto):\n    \"\"\"Analyse IRIs of imported ontologies and suggested a directory\n    layout for saving recursively.\n\n    Arguments:\n        onto: Ontology to analyse.\n\n    Returns:\n        layout: A dict mapping ontology objects to relative path names\n            derived from the ontology IRIs. No file name extension are\n            added.\n\n    Example:\n        Assume that our ontology `onto` has IRI `ex:onto`. If it directly\n        or indirectly imports ontologies with IRIs `ex:A/ontoA`, `ex:B/ontoB`\n        and `ex:A/C/ontoC`, this function will return the following dict:\n\n            {\n                onto: \"onto\",\n                ontoA: \"A/ontoA\",\n                ontoB: \"B/ontoB\",\n                ontoC: \"A/C/ontoC\",\n            }\n\n        where `ontoA`, `ontoB` and `ontoC` are imported Ontology objects.\n    \"\"\"\n    all_imported = [\n        imported.base_iri for imported in onto.indirectly_imported_ontologies()\n    ]\n    # get protocol and domain of all imported ontologies\n    namespace_roots = set()\n    for iri in all_imported:\n        protocol, domain, *_ = urllib.parse.urlsplit(iri)\n        namespace_roots.add(\"://\".join([protocol, domain]))\n\n    def recur(o):\n        baseiri = o.base_iri.rstrip(\"/#\")\n\n        # Some heuristics here to reproduce the EMMO layout.\n        # It might not apply to all ontologies, so maybe it should be\n        # made optional?  Alternatively, change EMMO ontology IRIs to\n        # match the directory layout.\n        emmolayout = (\n            any(\n                oo.base_iri.startswith(baseiri + \"/\")\n                for oo in o.imported_ontologies\n            )\n            or o.base_iri == \"http://emmo.info/emmo/mereocausality#\"\n        )\n\n        layout[o] = (\n            baseiri + \"/\" + os.path.basename(baseiri) if emmolayout else baseiri\n        )\n        for imported in o.imported_ontologies:\n            if imported not in layout:\n                recur(imported)\n\n    layout = {}\n    recur(onto)\n    # Strip off initial common prefix from all paths\n    if len(namespace_roots) == 1:\n        prefix = os.path.commonprefix(list(layout.values()))\n        for o, path in layout.items():\n            layout[o] = path[len(prefix) :].lstrip(\"/\")\n    else:\n        for o, path in layout.items():\n            for namespace_root in namespace_roots:\n                if path.startswith(namespace_root):\n                    layout[o] = (\n                        urllib.parse.urlsplit(namespace_root)[1]\n                        + path[len(namespace_root) :]\n                    )\n\n    return layout\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.english","title":"<code>english(string)</code>","text":"<p>Returns <code>string</code> as an English location string.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def english(string):\n    \"\"\"Returns `string` as an English location string.\"\"\"\n    return owlready2.locstr(string, lang=\"en\")\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.get_format","title":"<code>get_format(outfile, default, fmt=None)</code>","text":"<p>Infer format from outfile and format.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def get_format(outfile: str, default: str, fmt: str = None):\n    \"\"\"Infer format from outfile and format.\"\"\"\n    if fmt is None:\n        fmt = os.path.splitext(outfile)[1]\n    if not fmt:\n        fmt = default\n    return fmt.lstrip(\".\")\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.get_label","title":"<code>get_label(entity)</code>","text":"<p>Returns the label of an entity.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def get_label(entity):\n    \"\"\"Returns the label of an entity.\"\"\"\n    # pylint: disable=too-many-return-statements\n    if hasattr(entity, \"namespace\"):\n        onto = entity.namespace.ontology\n        if onto.label_annotations:\n            for la in onto.label_annotations:\n                try:\n                    label = entity[la]\n                    if label:\n                        return get_preferred_language(label)\n                except (NoSuchLabelError, AttributeError, TypeError):\n                    continue\n    if hasattr(entity, \"prefLabel\") and entity.prefLabel:\n        return get_preferred_language(entity.prefLabel)\n    if hasattr(entity, \"label\") and entity.label:\n        return get_preferred_language(entity.label)\n    if hasattr(entity, \"__name__\"):\n        return entity.__name__\n    if hasattr(entity, \"name\"):\n        return str(entity.name)\n    if isinstance(entity, str):\n        return entity\n    return repr(entity)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.get_preferred_language","title":"<code>get_preferred_language(langstrings, lang=None)</code>","text":"<p>Given a list of localised strings, return the one in language <code>lang</code>. If <code>lang</code> is not given, use <code>ontopy.utils.PREFERRED_LANGUAGE</code>.  If no one match is found, return the first one with no language tag or fallback to the first string.</p> <p>The preferred language is stored as a module variable. You can change it with:</p> <p>import ontopy.utils ontopy.utils.PREFERRED_LANGUAGE = \"en\"</p> Source code in <code>ontopy/utils.py</code> <pre><code>def get_preferred_language(langstrings: list, lang=None) -&gt; str:\n    \"\"\"Given a list of localised strings, return the one in language\n    `lang`. If `lang` is not given, use\n    `ontopy.utils.PREFERRED_LANGUAGE`.  If no one match is found,\n    return the first one with no language tag or fallback to the first\n    string.\n\n    The preferred language is stored as a module variable. You can\n    change it with:\n\n    &gt;&gt;&gt; import ontopy.utils\n    &gt;&gt;&gt; ontopy.utils.PREFERRED_LANGUAGE = \"en\"\n\n    \"\"\"\n    if lang is None:\n        lang = PREFERRED_LANGUAGE\n    for langstr in langstrings:\n        if hasattr(langstr, \"lang\") and langstr.lang == lang:\n            return str(langstr)\n    for langstr in langstrings:\n        if not hasattr(langstr, \"lang\"):\n            return langstr\n    return str(langstrings[0])\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.getiriname","title":"<code>getiriname(iri)</code>","text":"<p>Return name part of an IRI.</p> <p>The name part is what follows after the last slash or hash.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def getiriname(iri):\n    \"\"\"Return name part of an IRI.\n\n    The name part is what follows after the last slash or hash.\n    \"\"\"\n    res = urllib.parse.urlparse(iri)\n    return res.fragment if res.fragment else res.path.rsplit(\"/\", 1)[-1]\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.infer_version","title":"<code>infer_version(iri, version_iri)</code>","text":"<p>Infer version from IRI and versionIRI.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def infer_version(iri, version_iri):\n    \"\"\"Infer version from IRI and versionIRI.\"\"\"\n    if str(version_iri[: len(iri)]) == str(iri):\n        version = version_iri[len(iri) :].lstrip(\"/\")\n    else:\n        j = 0\n        version_parts = []\n        for i, char in enumerate(iri):\n            while i + j &lt; len(version_iri) and char != version_iri[i + j]:\n                version_parts.append(version_iri[i + j])\n                j += 1\n        version = \"\".join(version_parts).lstrip(\"/\").rstrip(\"/#\")\n\n    if \"/\" in version:\n        raise ValueError(\n            f\"version IRI {version_iri!r} is not consistent with base IRI \"\n            f\"{iri!r}\"\n        )\n    return version\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.isinteractive","title":"<code>isinteractive()</code>","text":"<p>Returns true if we are running from an interactive interpreater, false otherwise.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def isinteractive():\n    \"\"\"Returns true if we are running from an interactive interpreater,\n    false otherwise.\"\"\"\n    return bool(\n        hasattr(__builtins__, \"__IPYTHON__\")\n        or sys.flags.interactive\n        or hasattr(sys, \"ps1\")\n    )\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.normalise_url","title":"<code>normalise_url(url)</code>","text":"<p>Returns <code>url</code> in a normalised form.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def normalise_url(url):\n    \"\"\"Returns `url` in a normalised form.\"\"\"\n    splitted = urllib.parse.urlsplit(url)\n    components = list(splitted)\n    components[2] = os.path.normpath(splitted.path)\n    return urllib.parse.urlunsplit(components)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.read_catalog","title":"<code>read_catalog(uri, catalog_file='catalog-v001.xml', baseuri=None, recursive=False, relative_to=None, return_paths=False, visited_iris=None, visited_paths=None)</code>","text":"<p>Reads a Prot\u00e8g\u00e8 catalog file and returns as a dict.</p> <p>The returned dict maps the ontology IRI (name) to its actual location (URI).  The location can be either an absolute file path or a HTTP, HTTPS or FTP web location.</p> <p><code>uri</code> is a string locating the catalog file. It may be a http or https web location or a file path.</p> <p>The <code>catalog_file</code> argument spesifies the catalog file name and is used if <code>path</code> is used when <code>recursive</code> is true or when <code>path</code> is a directory.</p> <p>If <code>baseuri</code> is not None, it will be used as the base URI for the mapped locations.  Otherwise it defaults to <code>uri</code> with its final component omitted.</p> <p>If <code>recursive</code> is true, catalog files in sub-folders are also read.</p> <p>if <code>relative_to</code> is given, the paths in the returned dict will be relative to this path.</p> <p>If <code>return_paths</code> is true, a set of directory paths to source files is returned in addition to the default dict.</p> <p>The <code>visited_uris</code> and <code>visited_paths</code> arguments are only intended for internal use to avoid infinite recursions.</p> <p>A ReadCatalogError is raised if the catalog file cannot be found.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def read_catalog(  # pylint: disable=too-many-locals,too-many-statements,too-many-arguments\n    uri,\n    catalog_file=\"catalog-v001.xml\",\n    baseuri=None,\n    recursive=False,\n    relative_to=None,\n    return_paths=False,\n    visited_iris=None,\n    visited_paths=None,\n):\n    \"\"\"Reads a Prot\u00e8g\u00e8 catalog file and returns as a dict.\n\n    The returned dict maps the ontology IRI (name) to its actual\n    location (URI).  The location can be either an absolute file path\n    or a HTTP, HTTPS or FTP web location.\n\n    `uri` is a string locating the catalog file. It may be a http or\n    https web location or a file path.\n\n    The `catalog_file` argument spesifies the catalog file name and is\n    used if `path` is used when `recursive` is true or when `path` is a\n    directory.\n\n    If `baseuri` is not None, it will be used as the base URI for the\n    mapped locations.  Otherwise it defaults to `uri` with its final\n    component omitted.\n\n    If `recursive` is true, catalog files in sub-folders are also read.\n\n    if `relative_to` is given, the paths in the returned dict will be\n    relative to this path.\n\n    If `return_paths` is true, a set of directory paths to source\n    files is returned in addition to the default dict.\n\n    The `visited_uris` and `visited_paths` arguments are only intended for\n    internal use to avoid infinite recursions.\n\n    A ReadCatalogError is raised if the catalog file cannot be found.\n    \"\"\"\n    # pylint: disable=too-many-branches\n\n    # Protocols supported by urllib.request\n    web_protocols = \"http://\", \"https://\", \"ftp://\"\n    uri = str(uri)  # in case uri is a pathlib.Path object\n    iris = visited_iris if visited_iris else {}\n    dirs = visited_paths if visited_paths else set()\n    if uri in iris:\n        return (iris, dirs) if return_paths else iris\n\n    if uri.startswith(web_protocols):\n        # Call read_catalog() recursively to ensure that the temporary\n        # file is properly cleaned up\n        with tempfile.TemporaryDirectory() as tmpdir:\n            destfile = os.path.join(tmpdir, catalog_file)\n            uris = {  # maps uri to base\n                uri: (baseuri if baseuri else os.path.dirname(uri)),\n                f'{uri.rstrip(\"/\")}/{catalog_file}': (\n                    baseuri if baseuri else uri.rstrip(\"/\")\n                ),\n                f\"{os.path.dirname(uri)}/{catalog_file}\": (\n                    os.path.dirname(uri)\n                ),\n            }\n            for url, base in uris.items():\n                try:\n                    # The URL can only contain the schemes from `web_protocols`.\n                    _, msg = urllib.request.urlretrieve(url, destfile)  # nosec\n                except urllib.request.URLError:\n                    continue\n                else:\n                    if \"Content-Length\" not in msg:\n                        continue\n\n                    return read_catalog(\n                        destfile,\n                        catalog_file=catalog_file,\n                        baseuri=baseuri if baseuri else base,\n                        recursive=recursive,\n                        return_paths=return_paths,\n                        visited_iris=iris,\n                        visited_paths=dirs,\n                    )\n            raise ReadCatalogError(\n                \"Cannot download catalog from URLs: \" + \", \".join(uris)\n            )\n    elif uri.startswith(\"file://\"):\n        path = uri[7:]\n    else:\n        path = uri\n\n    if os.path.isdir(path):\n        dirname = os.path.abspath(path)\n        filepath = os.path.join(dirname, catalog_file)\n    else:\n        catalog_file = os.path.basename(path)\n        filepath = os.path.abspath(path)\n        dirname = os.path.dirname(filepath)\n\n    def gettag(entity):\n        return entity.tag.rsplit(\"}\", 1)[-1]\n\n    def load_catalog(filepath):\n        if not os.path.exists(filepath):\n            raise ReadCatalogError(\"No such catalog file: \" + filepath)\n        dirname = os.path.normpath(os.path.dirname(filepath))\n        dirs.add(baseuri if baseuri else dirname)\n        xml = ET.parse(filepath)\n        root = xml.getroot()\n        if gettag(root) != \"catalog\":\n            raise ReadCatalogError(\n                f\"expected root tag of catalog file {filepath!r} to be \"\n                '\"catalog\"'\n            )\n        for child in root:\n            if gettag(child) == \"uri\":\n                load_uri(child, dirname)\n            elif gettag(child) == \"group\":\n                for uri in child:\n                    load_uri(uri, dirname)\n\n    def load_uri(uri, dirname):\n        if gettag(uri) != \"uri\":\n            raise ValueError(f\"{gettag(uri)!r} should be 'uri'.\")\n        uri_as_str = uri.attrib[\"uri\"]\n        if uri_as_str.startswith(web_protocols):\n            url = uri_as_str\n        else:\n            uri_as_str = os.path.normpath(uri_as_str)\n            if baseuri and baseuri.startswith(web_protocols):\n                url = f\"{baseuri}/{uri_as_str}\"\n            else:\n                url = os.path.join(baseuri if baseuri else dirname, uri_as_str)\n\n        iris.setdefault(uri.attrib[\"name\"], url)\n        if recursive:\n            directory = os.path.dirname(url)\n            if directory not in dirs:\n                catalog = os.path.join(directory, catalog_file)\n                if catalog.startswith(web_protocols):\n                    iris_, dirs_ = read_catalog(\n                        catalog,\n                        catalog_file=catalog_file,\n                        baseuri=None,\n                        recursive=recursive,\n                        return_paths=True,\n                        visited_iris=iris,\n                        visited_paths=dirs,\n                    )\n                    iris.update(iris_)\n                    dirs.update(dirs_)\n                else:\n                    load_catalog(catalog)\n\n    load_catalog(filepath)\n\n    if relative_to:\n        for iri, path in iris.items():\n            iris[iri] = os.path.relpath(path, relative_to)\n\n    if return_paths:\n        return iris, dirs\n    return iris\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.rename_iris","title":"<code>rename_iris(onto, annotation='prefLabel')</code>","text":"<p>For IRIs with the given annotation, change the name of the entity to the value of the annotation.  Also add an <code>skos:exactMatch</code> annotation referring to the old IRI.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def rename_iris(onto, annotation=\"prefLabel\"):\n    \"\"\"For IRIs with the given annotation, change the name of the entity\n    to the value of the annotation.  Also add an `skos:exactMatch`\n    annotation referring to the old IRI.\n    \"\"\"\n    exactMatch = onto._abbreviate(  # pylint:disable=invalid-name\n        \"http://www.w3.org/2004/02/skos/core#exactMatch\"\n    )\n    for entity in onto.get_entities():\n        if hasattr(entity, annotation) and getattr(entity, annotation):\n            onto._add_data_triple_spod(\n                entity.storid, exactMatch, entity.iri, \"\"\n            )\n            entity.name = getattr(entity, annotation).first()\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.write_catalog","title":"<code>write_catalog(irimap, output='catalog-v001.xml', directory='.', relative_paths=True, append=False)</code>","text":"<p>Write catalog file do disk.</p> <p>Parameters:</p> Name Type Description Default <code>irimap</code> <code>dict</code> <p>dict mapping ontology IRIs (name) to actual locations (URIs).  It has the same format as the dict returned by read_catalog().</p> required <code>output</code> <code>Union[str, Path]</code> <p>name of catalog file.</p> <code>'catalog-v001.xml'</code> <code>directory</code> <code>Union[str, Path]</code> <p>directory path to the catalog file.  Only used if <code>output</code> is a relative path.</p> <code>'.'</code> <code>relative_paths</code> <code>bool</code> <p>whether to write file paths inside the catalog as relative paths (instead of  absolute paths).</p> <code>True</code> <code>append</code> <code>bool</code> <p>whether to append to a possible existing catalog file. If false, an existing file will be overwritten.</p> <code>False</code> Source code in <code>ontopy/utils.py</code> <pre><code>def write_catalog(\n    irimap: dict,\n    output: \"Union[str, Path]\" = \"catalog-v001.xml\",\n    directory: \"Union[str, Path]\" = \".\",\n    relative_paths: bool = True,\n    append: bool = False,\n):  # pylint: disable=redefined-builtin\n    \"\"\"Write catalog file do disk.\n\n    Args:\n        irimap: dict mapping ontology IRIs (name) to actual locations\n            (URIs).  It has the same format as the dict returned by\n            read_catalog().\n        output: name of catalog file.\n        directory: directory path to the catalog file.  Only used if `output`\n            is a relative path.\n        relative_paths: whether to write file paths inside the catalog as\n            relative paths (instead of  absolute paths).\n        append: whether to append to a possible existing catalog file.\n            If false, an existing file will be overwritten.\n    \"\"\"\n    filename = Path(directory) / output\n\n    if relative_paths:\n        irimap = irimap.copy()  # don't modify provided irimap\n        for iri, path in irimap.items():\n            if os.path.isabs(path):\n                irimap[iri] = os.path.relpath(path, filename.parent)\n\n    if filename.exists() and append:\n        iris = read_catalog(filename)\n        iris.update(irimap)\n        irimap = iris\n\n    res = [\n        '&lt;?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?&gt;',\n        '&lt;catalog prefer=\"public\" '\n        'xmlns=\"urn:oasis:names:tc:entity:xmlns:xml:catalog\"&gt;',\n        '    &lt;group id=\"Folder Repository, directory=, recursive=true, '\n        'Auto-Update=false, version=2\" prefer=\"public\" xml:base=\"\"&gt;',\n    ]\n    for iri, path in irimap.items():\n        res.append(f'        &lt;uri name=\"{iri}\" uri=\"{path}\"/&gt;')\n    res.append(\"    &lt;/group&gt;\")\n    res.append(\"&lt;/catalog&gt;\")\n    with open(filename, \"wt\") as handle:\n        handle.write(\"\\n\".join(res) + \"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/","title":"factppgraph","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph--ontopyfactpluspluswrapperfactppgraph","title":"<code>ontopy.factpluspluswrapper.factppgraph</code>","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph","title":"<code> FaCTPPGraph        </code>","text":"<p>Class for running the FaCT++ reasoner (using OwlApiInterface) and postprocessing the resulting inferred ontology.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph--parameters","title":"Parameters","text":"<p>graph : owlapi.Graph instance     The graph to be inferred.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>class FaCTPPGraph:\n    \"\"\"Class for running the FaCT++ reasoner (using OwlApiInterface) and\n    postprocessing the resulting inferred ontology.\n\n    Parameters\n    ----------\n    graph : owlapi.Graph instance\n        The graph to be inferred.\n    \"\"\"\n\n    def __init__(self, graph):\n        self.graph = graph\n        self._inferred = None\n        self._namespaces = None\n        self._base_iri = None\n\n    @property\n    def inferred(self):\n        \"\"\"The current inferred graph.\"\"\"\n        if self._inferred is None:\n            self._inferred = self.raw_inferred_graph()\n        return self._inferred\n\n    @property\n    def base_iri(self):\n        \"\"\"Base iri of inferred ontology.\"\"\"\n        if self._base_iri is None:\n            self._base_iri = URIRef(self.asserted_base_iri() + \"-inferred\")\n        return self._base_iri\n\n    @base_iri.setter\n    def base_iri(self, value):\n        \"\"\"Assign inferred base iri.\"\"\"\n        self._base_iri = URIRef(value)\n\n    @property\n    def namespaces(self):\n        \"\"\"Namespaces defined in the original graph.\"\"\"\n        if self._namespaces is None:\n            self._namespaces = dict(self.graph.namespaces()).copy()\n            self._namespaces[\"\"] = self.base_iri\n        return self._namespaces\n\n    def asserted_base_iri(self):\n        \"\"\"Returns the base iri or the original graph.\"\"\"\n        return URIRef(dict(self.graph.namespaces()).get(\"\", \"\").rstrip(\"#/\"))\n\n    def raw_inferred_graph(self):\n        \"\"\"Returns the raw non-postprocessed inferred ontology as a rdflib\n        graph.\"\"\"\n        return OwlApiInterface().reason(self.graph)\n\n    def inferred_graph(self):\n        \"\"\"Returns the postprocessed inferred graph.\"\"\"\n        self.add_base_annotations()\n        self.set_namespace()\n        self.clean_base()\n        self.remove_nothing_is_nothing()\n        self.clean_ancestors()\n        return self.inferred\n\n    def add_base_annotations(self):\n        \"\"\"Copy base annotations from original graph to the inferred graph.\"\"\"\n        base = self.base_iri\n        inferred = self.inferred\n        for _, predicate, obj in self.graph.triples(\n            (self.asserted_base_iri(), None, None)\n        ):\n            if predicate == OWL.versionIRI:\n                version = obj.rsplit(\"/\", 1)[-1]\n                obj = URIRef(f\"{base}/{version}\")\n            inferred.add((base, predicate, obj))\n\n    def set_namespace(self):\n        \"\"\"Override namespace of inferred graph with the namespace of the\n        original graph.\n        \"\"\"\n        inferred = self.inferred\n        for key, value in self.namespaces.items():\n            inferred.namespace_manager.bind(\n                key, value, override=True, replace=True\n            )\n\n    def clean_base(self):\n        \"\"\"Remove all relations `s? a owl:Ontology` where `s?` is not\n        `base_iri`.\n        \"\"\"\n        inferred = self.inferred\n        for (\n            subject,\n            predicate,\n            obj,\n        ) in inferred.triples(  # pylint: disable=not-an-iterable\n            (None, RDF.type, OWL.Ontology)\n        ):\n            inferred.remove((subject, predicate, obj))\n        inferred.add((self.base_iri, RDF.type, OWL.Ontology))\n\n    def remove_nothing_is_nothing(self):\n        \"\"\"Remove superfluid relation in inferred graph:\n\n        owl:Nothing rdfs:subClassOf owl:Nothing\n        \"\"\"\n        triple = OWL.Nothing, RDFS.subClassOf, OWL.Nothing\n        inferred = self.inferred\n        if triple in inferred:\n            inferred.remove(triple)\n\n    def clean_ancestors(self):\n        \"\"\"Remove redundant rdfs:subClassOf relations in inferred graph.\"\"\"\n        inferred = self.inferred\n        for (  # pylint: disable=too-many-nested-blocks\n            subject\n        ) in inferred.subjects(RDF.type, OWL.Class):\n            if isinstance(subject, URIRef):\n                parents = set(\n                    parent\n                    for parent in inferred.objects(subject, RDFS.subClassOf)\n                    if isinstance(parent, URIRef)\n                )\n                if len(parents) &gt; 1:\n                    for parent in parents:\n                        ancestors = set(\n                            inferred.transitive_objects(parent, RDFS.subClassOf)\n                        )\n                        for entity in parents:\n                            if entity != parent and entity in ancestors:\n                                triple = subject, RDFS.subClassOf, entity\n                                if triple in inferred:\n                                    inferred.remove(triple)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.base_iri","title":"<code>base_iri</code>  <code>property</code> <code>writable</code>","text":"<p>Base iri of inferred ontology.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.inferred","title":"<code>inferred</code>  <code>property</code> <code>readonly</code>","text":"<p>The current inferred graph.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.namespaces","title":"<code>namespaces</code>  <code>property</code> <code>readonly</code>","text":"<p>Namespaces defined in the original graph.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.add_base_annotations","title":"<code>add_base_annotations(self)</code>","text":"<p>Copy base annotations from original graph to the inferred graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def add_base_annotations(self):\n    \"\"\"Copy base annotations from original graph to the inferred graph.\"\"\"\n    base = self.base_iri\n    inferred = self.inferred\n    for _, predicate, obj in self.graph.triples(\n        (self.asserted_base_iri(), None, None)\n    ):\n        if predicate == OWL.versionIRI:\n            version = obj.rsplit(\"/\", 1)[-1]\n            obj = URIRef(f\"{base}/{version}\")\n        inferred.add((base, predicate, obj))\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.asserted_base_iri","title":"<code>asserted_base_iri(self)</code>","text":"<p>Returns the base iri or the original graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def asserted_base_iri(self):\n    \"\"\"Returns the base iri or the original graph.\"\"\"\n    return URIRef(dict(self.graph.namespaces()).get(\"\", \"\").rstrip(\"#/\"))\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.clean_ancestors","title":"<code>clean_ancestors(self)</code>","text":"<p>Remove redundant rdfs:subClassOf relations in inferred graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def clean_ancestors(self):\n    \"\"\"Remove redundant rdfs:subClassOf relations in inferred graph.\"\"\"\n    inferred = self.inferred\n    for (  # pylint: disable=too-many-nested-blocks\n        subject\n    ) in inferred.subjects(RDF.type, OWL.Class):\n        if isinstance(subject, URIRef):\n            parents = set(\n                parent\n                for parent in inferred.objects(subject, RDFS.subClassOf)\n                if isinstance(parent, URIRef)\n            )\n            if len(parents) &gt; 1:\n                for parent in parents:\n                    ancestors = set(\n                        inferred.transitive_objects(parent, RDFS.subClassOf)\n                    )\n                    for entity in parents:\n                        if entity != parent and entity in ancestors:\n                            triple = subject, RDFS.subClassOf, entity\n                            if triple in inferred:\n                                inferred.remove(triple)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.clean_base","title":"<code>clean_base(self)</code>","text":"<p>Remove all relations <code>s? a owl:Ontology</code> where <code>s?</code> is not <code>base_iri</code>.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def clean_base(self):\n    \"\"\"Remove all relations `s? a owl:Ontology` where `s?` is not\n    `base_iri`.\n    \"\"\"\n    inferred = self.inferred\n    for (\n        subject,\n        predicate,\n        obj,\n    ) in inferred.triples(  # pylint: disable=not-an-iterable\n        (None, RDF.type, OWL.Ontology)\n    ):\n        inferred.remove((subject, predicate, obj))\n    inferred.add((self.base_iri, RDF.type, OWL.Ontology))\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.inferred_graph","title":"<code>inferred_graph(self)</code>","text":"<p>Returns the postprocessed inferred graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def inferred_graph(self):\n    \"\"\"Returns the postprocessed inferred graph.\"\"\"\n    self.add_base_annotations()\n    self.set_namespace()\n    self.clean_base()\n    self.remove_nothing_is_nothing()\n    self.clean_ancestors()\n    return self.inferred\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.raw_inferred_graph","title":"<code>raw_inferred_graph(self)</code>","text":"<p>Returns the raw non-postprocessed inferred ontology as a rdflib graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def raw_inferred_graph(self):\n    \"\"\"Returns the raw non-postprocessed inferred ontology as a rdflib\n    graph.\"\"\"\n    return OwlApiInterface().reason(self.graph)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.remove_nothing_is_nothing","title":"<code>remove_nothing_is_nothing(self)</code>","text":"<p>Remove superfluid relation in inferred graph:</p> <p>owl:Nothing rdfs:subClassOf owl:Nothing</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def remove_nothing_is_nothing(self):\n    \"\"\"Remove superfluid relation in inferred graph:\n\n    owl:Nothing rdfs:subClassOf owl:Nothing\n    \"\"\"\n    triple = OWL.Nothing, RDFS.subClassOf, OWL.Nothing\n    inferred = self.inferred\n    if triple in inferred:\n        inferred.remove(triple)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.set_namespace","title":"<code>set_namespace(self)</code>","text":"<p>Override namespace of inferred graph with the namespace of the original graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def set_namespace(self):\n    \"\"\"Override namespace of inferred graph with the namespace of the\n    original graph.\n    \"\"\"\n    inferred = self.inferred\n    for key, value in self.namespaces.items():\n        inferred.namespace_manager.bind(\n            key, value, override=True, replace=True\n        )\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FactPPError","title":"<code> FactPPError        </code>","text":"<p>Postprocessing error after reasoning with FaCT++.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>class FactPPError:\n    \"\"\"Postprocessing error after reasoning with FaCT++.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/","title":"owlapi_interface","text":"<p>Python interface to the FaCT++ Reasoner.</p> <p>This module is copied from the SimPhoNy project.</p> <p>Original author: Matthias Urban</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface","title":"<code> OwlApiInterface        </code>","text":"<p>Interface to the FaCT++ reasoner via OWLAPI.</p> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>class OwlApiInterface:\n    \"\"\"Interface to the FaCT++ reasoner via OWLAPI.\"\"\"\n\n    def __init__(self):\n        \"\"\"Initialize the interface.\"\"\"\n\n    def reason(self, graph):\n        \"\"\"Generate the inferred axioms for a given Graph.\n\n        Args:\n            graph (Graph): An rdflib graph to execute the reasoner on.\n\n        \"\"\"\n        with tempfile.NamedTemporaryFile(\"wt\") as tmpdir:\n            graph.serialize(tmpdir.name, format=\"xml\")\n            return self._run(tmpdir.name, command=\"--run-reasoner\")\n\n    def reason_files(self, *owl_files):\n        \"\"\"Merge the given owl and generate the inferred axioms.\n\n        Args:\n            *owl_files (os.path): The owl files two merge.\n\n        \"\"\"\n        return self._run(*owl_files, command=\"--run-reasoner\")\n\n    def merge_files(self, *owl_files):\n        \"\"\"Merge the given owl files and its import closure.\n\n        Args:\n            *owl_files (os.path): The owl files two merge.\n\n        \"\"\"\n        return self._run(*owl_files, command=\"--merge-only\")\n\n    @staticmethod\n    def _run(\n        *owl_files, command, output_file=None, return_graph=True\n    ) -&gt; rdflib.Graph:\n        \"\"\"Run the FaCT++ reasoner using a java command.\n\n        Args:\n            *owl_files (str): Path to the owl files to load.\n            command (str): Either --run-reasoner or --merge-only\n            output_file (str, optional): Where the output should be stored.\n                Defaults to None.\n            return_graph (bool, optional): Whether the result should be parsed\n                and returned. Defaults to True.\n\n        Returns:\n            The reasoned result.\n\n        \"\"\"\n        java_base = os.path.abspath(\n            os.path.join(os.path.dirname(__file__), \"java\")\n        )\n        cmd = (\n            [\n                \"java\",\n                \"-cp\",\n                java_base + \"/lib/jars/*\",\n                \"-Djava.library.path=\" + java_base + \"/lib/so\",\n                \"org.simphony.OntologyLoader\",\n            ]\n            + [command]\n            + list(owl_files)\n        )\n        logger.info(\"Running Reasoner\")\n        logger.debug(\"Command %s\", cmd)\n        subprocess.run(cmd, check=True)  # nosec\n\n        graph = None\n        if return_graph:\n            graph = rdflib.Graph()\n            graph.parse(RESULT_FILE)\n        if output_file:\n            os.rename(RESULT_FILE, output_file)\n        else:\n            os.remove(RESULT_FILE)\n        return graph\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.__init__","title":"<code>__init__(self)</code>  <code>special</code>","text":"<p>Initialize the interface.</p> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def __init__(self):\n    \"\"\"Initialize the interface.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.merge_files","title":"<code>merge_files(self, *owl_files)</code>","text":"<p>Merge the given owl files and its import closure.</p> <p>Parameters:</p> Name Type Description Default <code>*owl_files</code> <code>os.path</code> <p>The owl files two merge.</p> <code>()</code> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def merge_files(self, *owl_files):\n    \"\"\"Merge the given owl files and its import closure.\n\n    Args:\n        *owl_files (os.path): The owl files two merge.\n\n    \"\"\"\n    return self._run(*owl_files, command=\"--merge-only\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.reason","title":"<code>reason(self, graph)</code>","text":"<p>Generate the inferred axioms for a given Graph.</p> <p>Parameters:</p> Name Type Description Default <code>graph</code> <code>Graph</code> <p>An rdflib graph to execute the reasoner on.</p> required Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def reason(self, graph):\n    \"\"\"Generate the inferred axioms for a given Graph.\n\n    Args:\n        graph (Graph): An rdflib graph to execute the reasoner on.\n\n    \"\"\"\n    with tempfile.NamedTemporaryFile(\"wt\") as tmpdir:\n        graph.serialize(tmpdir.name, format=\"xml\")\n        return self._run(tmpdir.name, command=\"--run-reasoner\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.reason_files","title":"<code>reason_files(self, *owl_files)</code>","text":"<p>Merge the given owl and generate the inferred axioms.</p> <p>Parameters:</p> Name Type Description Default <code>*owl_files</code> <code>os.path</code> <p>The owl files two merge.</p> <code>()</code> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def reason_files(self, *owl_files):\n    \"\"\"Merge the given owl and generate the inferred axioms.\n\n    Args:\n        *owl_files (os.path): The owl files two merge.\n\n    \"\"\"\n    return self._run(*owl_files, command=\"--run-reasoner\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.reason_from_terminal","title":"<code>reason_from_terminal()</code>","text":"<p>Run the reasoner from terminal.</p> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def reason_from_terminal():\n    \"\"\"Run the reasoner from terminal.\"\"\"\n    parser = argparse.ArgumentParser(\n        description=\"Run the FaCT++ reasoner on the given OWL file. \"\n        \"Catalog files are used to load the import closure. \"\n        \"Then the reasoner is executed and the inferred triples are merged \"\n        \"with the asserted ones. If multiple OWL files are given, they are \"\n        \"merged beforehand\"\n    )\n    parser.add_argument(\n        \"owl_file\", nargs=\"+\", help=\"OWL file(s) to run the reasoner on.\"\n    )\n    parser.add_argument(\"output_file\", help=\"Path to store inferred axioms to.\")\n\n    args = parser.parse_args()\n    OwlApiInterface()._run(  # pylint: disable=protected-access\n        *args.owl_file,\n        command=\"--run-reasoner\",\n        return_graph=False,\n        output_file=args.output_file,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/","title":"sync_factpp","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/#ontopy.factpluspluswrapper.sync_factpp--ontopyfactpluspluswrappersyncfatpp","title":"<code>ontopy.factpluspluswrapper.syncfatpp</code>","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/#ontopy.factpluspluswrapper.sync_factpp.sync_reasoner_factpp","title":"<code>sync_reasoner_factpp(ontology_or_world=None, infer_property_values=False, debug=1)</code>","text":"<p>Run FaCT++ reasoner and load the inferred relations back into the owlready2 triplestore.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/#ontopy.factpluspluswrapper.sync_factpp.sync_reasoner_factpp--parameters","title":"Parameters","text":"<p>ontology_or_world : None | Ontology instance | World instance | list     Identifies the world to run the reasoner over. infer_property_values : bool     Whether to also infer property values. debug : bool     Whether to print debug info to standard output.</p> Source code in <code>ontopy/factpluspluswrapper/sync_factpp.py</code> <pre><code>def sync_reasoner_factpp(\n    ontology_or_world=None, infer_property_values=False, debug=1\n):\n    \"\"\"Run FaCT++ reasoner and load the inferred relations back into\n    the owlready2 triplestore.\n\n    Parameters\n    ----------\n    ontology_or_world : None | Ontology instance | World instance | list\n        Identifies the world to run the reasoner over.\n    infer_property_values : bool\n        Whether to also infer property values.\n    debug : bool\n        Whether to print debug info to standard output.\n    \"\"\"\n    # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    if isinstance(ontology_or_world, World):\n        world = ontology_or_world\n    elif isinstance(ontology_or_world, Ontology):\n        world = ontology_or_world.world\n    elif isinstance(ontology_or_world, Sequence):\n        world = ontology_or_world[0].world\n    else:\n        world = owlready2.default_world\n\n    if isinstance(ontology_or_world, Ontology):\n        ontology = ontology_or_world\n    elif CURRENT_NAMESPACES.get():\n        ontology = CURRENT_NAMESPACES.get()[-1].ontology\n    else:\n        ontology = world.get_ontology(_INFERRENCES_ONTOLOGY)\n\n    locked = world.graph.has_write_lock()\n    if locked:\n        world.graph.release_write_lock()  # Not needed during reasoning\n\n    try:\n        if debug:\n            print(\"*** Prepare graph\")\n        # Exclude owl:imports because they are not needed and can\n        # cause trouble when loading the inferred ontology\n        graph1 = rdflib.Graph()\n        for subject, predicate, obj in world.as_rdflib_graph().triples(\n            (None, None, None)\n        ):\n            if predicate != OWL.imports:\n                graph1.add((subject, predicate, obj))\n\n        if debug:\n            print(\"*** Run FaCT++ reasoner (and postprocess)\")\n        graph2 = FaCTPPGraph(graph1).inferred_graph()\n\n        if debug:\n            print(\"*** Load inferred ontology\")\n        # Check all rdfs:subClassOf relations in the inferred graph and add\n        # them to the world if they are missing\n        new_parents = defaultdict(list)\n        new_equivs = defaultdict(list)\n        entity_2_type = {}\n\n        for (\n            subject,\n            predicate,\n            obj,\n        ) in graph2.triples(  # pylint: disable=not-an-iterable\n            (None, None, None)\n        ):\n            if (\n                isinstance(subject, URIRef)\n                and predicate in OWL_2_TYPE\n                and isinstance(obj, URIRef)\n            ):\n                s_storid = ontology._abbreviate(str(subject), False)\n                p_storid = ontology._abbreviate(str(predicate), False)\n                o_storid = ontology._abbreviate(str(obj), False)\n                if (\n                    s_storid is not None\n                    and p_storid is not None\n                    and o_storid is not None\n                ):\n                    if predicate in (\n                        RDFS.subClassOf,\n                        RDFS.subPropertyOf,\n                        RDF.type,\n                    ):\n                        new_parents[s_storid].append(o_storid)\n                        entity_2_type[s_storid] = OWL_2_TYPE[predicate]\n                    else:\n                        new_equivs[s_storid].append(o_storid)\n                        entity_2_type[s_storid] = OWL_2_TYPE[predicate]\n\n        if infer_property_values:\n            inferred_obj_relations = []\n            # Hmm, does FaCT++ infer any property values?\n            # If not, remove the `infer_property_values` keyword argument.\n            raise NotImplementedError\n\n    finally:\n        if locked:\n            world.graph.acquire_write_lock()  # re-lock when applying results\n\n    if debug:\n        print(\"*** Applying reasoning results\")\n\n    _apply_reasoning_results(\n        world, ontology, debug, new_parents, new_equivs, entity_2_type\n    )\n    if infer_property_values:\n        _apply_inferred_obj_relations(\n            world, ontology, debug, inferred_obj_relations\n        )\n</code></pre>"},{"location":"demo/","title":"EMMO use cases","text":"<p>This demo contains two use cases on how EMMO can be used to achieve vertical and horizontal interpoerability, respectivily.</p> <p>Warning</p> <p>This demonstration is still work in progress. Especially documentation is lacking.</p>"},{"location":"demo/#content","title":"Content","text":"<ul> <li>Vertical interoperability.</li> <li>Horizontal interoperability.</li> </ul>"},{"location":"demo/#the-user-case-welding-an-aluminium-plate-to-steel","title":"The user case - welding an aluminium plate to steel","text":""},{"location":"demo/horizontal/","title":"EMMO use case for horizontal interoperability","text":"<p>Horizontal interoperability is about interoperability between different types of models and codes for a single material (i.e., one use case, multiple models).</p> <p>The key here is to show how to map between EMMO (or an EMMO-based ontology) and another ontology (possible EMMO-based).</p> <p>In this example we use a data-driven approach based on a C-implementation of SOFT<sup>1,2</sup>.</p> <p>This is done in four steps:</p> <ol> <li> <p>Generate metadata from the EMMO-based user case ontology.</p> <p>Implemented in the script step1_generate_metadata.py.</p> </li> <li> <p>Define metadata for an application developed independently of EMMO.</p> <p>In this case a metadata description of the ASE Atoms class 3 is created in <code>atoms.json</code>.</p> <p>Implemented in the script step2_define_metadata.py.</p> </li> <li> <p>Instantiate the metadata defined defined in step 2 with an atomistic structure interface structure.</p> <p>Implemented in the script step3_instantiate.py.</p> </li> <li> <p>Map the atomistic interface structure from the application representation to the common EMMO-based representation.</p> <p>Implemented in the script step4_map_instance.py.</p> </li> </ol> <p>Essentially, this demonstration shows how EMMO can be extended and how external data can be mapped into our extended ontology (serving as a common representational system).</p>"},{"location":"demo/horizontal/#requirements-for-running-the-user-case","title":"Requirements for running the user case","text":"<p>In addition to emmo, this demo also requires:</p> <ul> <li>DLite, a C-implementation of SOFT used for handling metadata</li> <li>ASE, for reading atom structure from cif and visualisation</li> </ul>"},{"location":"demo/vertical/","title":"EMMO use case for vertical interoperability","text":"<p>Vertical interoperability is about interoperability across two or more granulaty levels.</p> <p>In this use case we study the welded interface between an aluminium and a steel plate at three granularity levels. In this case, the granularity levels corresponds to three different length scales, that we here denote component, microstructure and atomistic scale.</p>"},{"location":"demo/vertical/#creating-an-emmo-based-user-case-ontology","title":"Creating an EMMO-based user case ontology","text":"<p>The script define_ontology.py uses the Python API for EMMO to generate an application ontology extending EMMO with additional concepts needed to describe the data that is exchanged between scales. The user case ontology can then be visualised with the script plot_ontology.py.</p>"},{"location":"demo/vertical/#defining-the-needed-material-entities","title":"Defining the needed material entities","text":""},{"location":"demo/vertical/#assigning-properties-to-material-entities","title":"Assigning properties to material entities","text":"<p>Note that we here also assign properties to <code>e-bonded_atom</code>, even though <code>e-bonded_atom</code> is defined in EMMO.</p> <p></p>"},{"location":"demo/vertical/#assigning-units-to-properties","title":"Assigning units to properties","text":"<p>We choose here to consistently use SI units for all scales (even though at the atomistic scale units like \u00c5ngstr\u00f6m and electron volt are more commonly used).</p> <p></p>"},{"location":"demo/vertical/#assigning-types-to-properties","title":"Assigning types to properties","text":"<p>In order to be able to generate metadata and to describe the actual data transferred between scales, we also need to define types.</p> <p></p>"},{"location":"demo/vertical/#the-new-application-ontology","title":"The new application-ontology","text":"<p>The final plot shows the user case ontology in context of EMMO.</p> <p></p>"},{"location":"developers/release-instructions/","title":"Steps for creating a new release","text":"<ol> <li> <p>Create a release on GitHub with a short release description.</p> <p>Ensure you add a <code># &lt;version number&gt;</code> title to the description.</p> <p>Set the tag to the version number prefixed with <code>\"v\"</code> and title to the version number as explained above.</p> </li> <li> <p>Ensure the GitHub Action CD workflows run as expected.</p> </li> </ol> <p>The workflow failed</p> <p>If something is wrong and the workflow fails before publishing the package to PyPI, make sure to remove all traces of the release and tag, fix the bug, and try again.</p> <p>If something is wrong and the workflow fails after publishing the package to PyPI: DO NOT REMOVE THE RELEASE OR TAG !</p> <p>Deployment of the documentation should (in theory) be the only thing that has failed. This can be deployed manually using similar steps as in the workflow.</p>"},{"location":"developers/setup/","title":"Development environment","text":"<p>This section outlines some suggestions as well as conventions used by the EMMOntoPy developers, which should be considered or followed if one wants to contribute to the package.</p>"},{"location":"developers/setup/#setup","title":"Setup","text":"<p>Requirements</p> <p>This section expects you to be running on a Unix-like system (e.g., Linux) with minimum Python 3.7.</p>"},{"location":"developers/setup/#virtual-environment","title":"Virtual environment","text":"<p>Since development can be messy, it is good to separate the development environment from the rest of your system's environment.</p> <p>To do this, you can use a virtual environment. There are a several different ways to create a virtual environment, but we recommend using either <code>virtualenv</code> or <code>venv</code>.</p> <p>Virtual environment considerations</p> <p>There are several different virtual environment setups, here we only address a very few.</p> <p>A great resource for an overview can be found in this StackOverflow answer. However, note that in the end, it is very subjective on the solution one uses and one is not necessarily \"better\" than another.</p> <code>virtualenv</code> (recommended)<code>venv</code> <p>To install <code>virtualenv</code>+<code>virtualenvwrapper</code> run:</p> <pre><code>$ pip install virtualenvwrapper\n</code></pre> <p>There is other setup, most of which only needs to be run once. For more information about this, see the <code>virtualenvwrapper</code> documentation.</p> <p>After successfully setting up <code>virtualenv</code> through <code>virtualenvwrapper</code>, you can create a new virtual environment:</p> <pre><code>$ mkproject -p python3.7 emmo-python\n</code></pre> <p>Note</p> <p>If you do not have Python 3.7 installed (or instead want to use your system's default Python version), you can leave out the extra <code>-p python3.7</code> argument. Or you can choose to use another version of Python by changing this argument to another (valid) python interpreter.</p> <p>Then, if the virtual environment has not been activated automatically (you should see the name <code>emmo-python</code> in a parenthesis in your console), you can run:</p> <pre><code>$ workon emmo-python\n</code></pre> <p>Tip</p> <p>You can quickly see a list of all your virtual environments by writing <code>workon</code> and pressing Tab twice.</p> <p>To deactivate the virtual environment, returning to the system/global environment again, run:</p> <pre><code>(emmo-python) $ deactivate\n</code></pre> <p><code>venv</code> is a built-in package in Python, which works similar to <code>virtualenv</code>, but with fewer capabilities.</p> <p>To create a new virtual environment with <code>venv</code>, first go to the directory, where you desire to keep your virtual environment. Then run the <code>venv</code> module using the Python interpreter you wish to use in the virtual environment. For Python 3.7 this would look like the following:</p> <pre><code>$ python3.7 -m venv emmo-python\n</code></pre> <p>A folder with the name <code>emmo-python</code> containing the environment is created.</p> <p>To activate the environment run:</p> <pre><code>$ ./emmo-python/activate\n</code></pre> <p>or</p> <pre><code>$ /path/to/emmo-python/activate\n</code></pre> <p>You should now see the name <code>emmo-python</code> in a parenthesis in your console, letting you know you have activated and are currently using the <code>emmo-python</code> virtual environment.</p> <p>To deactivate the virtual environment, returning to the system/global environment again, run:</p> <pre><code>(emmo-python) $ deactivate\n</code></pre> <p>Expectation</p> <p>From here on, all commands expect you to have activated your virtual environment, if you are using one, unless stated otherwise.</p>"},{"location":"developers/setup/#installation","title":"Installation","text":"<p>To install the package, please do not install from PyPI. Instead you should clone the repository from GitHub:</p> <pre><code>$ git clone https://github.com/emmo-repo/EMMOntoPy.git\n</code></pre> <p>or, if you are using an SSH connection to GitHub, you can instead clone via:</p> <pre><code>$ git clone git@github.com:emmo-repo/EMMOntoPy.git\n</code></pre> <p>Then enter into the newly cloned <code>EMMOntoPy</code> directory (<code>cd EMMOntoPy</code>) and run:</p> <pre><code>$ pip install -U -e .[dev]\n$ pre-commit install\n</code></pre> <p>This will install the EMMOntoPy Python package, including all dependencies and requirements for building and serving (locally) the documentation and running unit tests.</p> <p>The second line installs the <code>pre-commit</code> hooks defined in the <code>.pre-commit-config.yaml</code> file. <code>pre-commit</code> is a tool that runs immediately prior to you creating new commits (<code>git commit</code>), and checks all the changes, automatically updates the API reference in the documentation and much more. Mainly, it helps to ensure that the package stays nicely formattet, safe, and user-friendly for developers.</p>"},{"location":"developers/setup/#non-python-dependencies","title":"Non-Python dependencies","text":"<p>There are a few non-Python dependencies that EMMOntoPy relies on as well. These can be installed by running (on a Debian system):</p> <pre><code>$ sudo apt-get update &amp;&amp; sudo apt-get install -y graphviz openjdk-11-jre-headless\n</code></pre> <p>If you are on a non-Debian system (Debian, Ubuntu, ...), please check which package manager you are using and find packages for <code>graphviz</code> and <code>openjdk</code> minimum version 11.</p>"},{"location":"developers/setup/#test-the-installation","title":"Test the installation","text":"<p>It is good practice to test the integrity of the installation and that all necessary dependencies are correctly installed.</p> <p>You can run unit tests, to check the integrity of the Python functionality, by running:</p> <pre><code>$ pytest\n</code></pre> <p>If all has installed and is running correctly, you should not have any failures, but perhaps some warnings (deprecation warnings) in the test summary.</p>"},{"location":"developers/testing/","title":"Testing and tooling","text":""},{"location":"developers/testing/#unit-testing","title":"Unit testing","text":"<p>The PyTest framework is used for testing the EMMOntoPy package. It is a unit testing framework with a plugin system, sporting an extensive plugin library as well as a sound fixture injection system.</p> <p>To run the tests locally install the package with the <code>dev</code> extra (see the developer's setup guide) and run:</p> <pre><code>$ pytest\n=== test session starts ===\n...\n</code></pre> <p>To understand what options you have, run <code>pytest --help</code>.</p>"},{"location":"developers/testing/#tools","title":"Tools","text":"<p>Several tools are used to maintain the package, keeping it secure, readable, and easing maintenance.</p>"},{"location":"developers/testing/#mypy","title":"Mypy","text":"<p>Mypy is a static type checker for Python.</p> <p>Documentation: mypy.readthedocs.io</p> <p>The signs of this tool will be found in the code especially through the <code>typing.TYPE_CHECKING</code> boolean variable, which will be used in the current way:</p> <pre><code>from typing import TYPE_CHECKING\n\nif TYPE_CHECKING:\n    from typing import List\n</code></pre> <p>Since <code>TYPE_CHECKING</code> is <code>False</code> at runtime, the <code>if</code>-block will not be run as part of running the script or module or if importing the module. However, when Mypy runs to check the static typing, it forcefully runs these blocks, considering <code>TYPE_CHECKING</code> to be <code>True</code> (see the <code>typing.TYPE_CHECKING</code> section in the Mypy documentation).</p> <p>This means the imports in the <code>if</code>-block are meant to only be used for static typing, helping developers to understand the intention of the code as well as to check the invoked methods make sense (through Mypy).</p>"},{"location":"examples/emmodoc/","title":"Generate documentation for EMMO","text":"<p>This directory contains the needed templates, introductory text and figures for generating the full EMMO documentation using <code>ontodoc</code>. Since the introduction is written in markdown, pandoc is required for both pdf and html generation.</p> <p>For a standalone html documentation including all inferred relations, enter this directory and run:</p> <pre><code>ontodoc --template=emmo.md --format=html emmo-inferred emmo.html\n</code></pre> <p>Pandoc options may be adjusted with the files pandoc-options.yaml and pandoc-html-options.yaml.</p> <p>Similarly, for generating pdf documentation, enter this directory and run:</p> <pre><code>ontodoc --template=emmo.md emmo-inferred emmo.pdf\n</code></pre> <p>By default, we have configured pandoc to use xelatex for better unicode support. It is possible to change these settings in pandoc-options.yaml and pandoc-pdf-options.yaml.</p>"},{"location":"examples/emmodoc/#content-of-this-directory","title":"Content of this directory","text":""},{"location":"examples/emmodoc/#ontodoc-templates-with-introductory-text-and-document-layout","title":"<code>ontodoc</code> templates with introductory text and document layout","text":"<ul> <li>emmo.md: Main template for EMMO.   It includes the other templates.</li> <li>introduction.md: Introductory text.</li> <li>relations.md: Introduction and sections for Relations chapter.</li> <li>classes.md: Introduction and sections for Classes.</li> <li>figs: Figures used in the introduction.</li> </ul>"},{"location":"examples/emmodoc/#pandoc-configuration-files","title":"<code>pandoc</code> configuration files","text":"<ul> <li>emmodoc-meta.yaml: Metadata for EMMO, like title, authers, abstract, etc.</li> <li>pandoc-options.yaml: General pandoc options.</li> <li>pandoc-html-options.yaml: Additional pandoc options for html generation.</li> <li>pandoc-pdf-options.yaml: Additional pandoc options for pdf generation.</li> <li>pandoc-html.css: css file used for html generation.</li> <li>pandoc-template.html: Modified copy of the standard pandoc html template with a small adjustment for the author list.</li> <li>pandoc-template.tex: Modified copy of the standard pandoc latex template with a small adjustment for the author list.</li> </ul>"},{"location":"examples/emmodoc/#using-this-example-as-a-starting-point-for-documenting-your-own-ontology","title":"Using this example as a starting point for documenting your own ontology","text":"<p>For simple html documentation, you can skip all input files and simply run <code>ontodoc</code> as</p> <pre><code>ontodoc --format=simple-html YOUR_ONTO.owl YOUR_ONTO.html\n</code></pre> <p>It is also possible to include ontodoc templates using the <code>--template</code> option for adding additional information and structure the document. In this case the template may only contain <code>ontodoc</code> pre-processer directives and inline html, but not markdown.</p> <p>In order to produce output in pdf (or any other output format supported by pandoc), you can write your <code>ontodoc</code> template in markdown (with <code>ontodoc</code> pre-processer directives) and follow these steps to get started:</p> <ul> <li>Copy all the files starting with <code>pandoc-</code> to a new directory.</li> <li>Create a metadata YAML file for your ontology.   You can use emmodoc-meta.yaml as a template.</li> <li>Update pandoc-options.yaml.   Especially change:</li> <li><code>input-files</code> to the name of your new yaml metadata file.</li> <li><code>logo</code> to the path of your logo (or remove it).</li> <li><code>titlegraphic</code> to the path of your title figure (or remove it).</li> <li>Optionally add <code>ontodoc</code> template files with additional information about your ontology and document layout.</li> </ul> <p>That should be it. Good luck!</p>"},{"location":"examples/emmodoc/classes/","title":"Classes","text":"<p>%% %% This file %% This is Markdown file, except of lines starting with %% will %% be stripped off. %%</p> <p>%HEADER \"EMMO Classes\"    level=1</p> <p>emmo is a class representing the collection of all the individuals (signs) that are used in the ontology. Individuals are declared by the EMMO users when they want to apply the EMMO to represent the world.</p> <p>%BRANCHHEAD EMMO The root of all classes used to represent the world.  It has two children; collection and item.</p> <p>collection is the class representing the collection of all the individuals (signs) that represents a collection of non-connected real world objects.</p> <p>item Is the class that collects all the individuals that are members of a set (it's the most comprehensive set individual).  It is the branch of mereotopology.</p> <p>%% - based on has_part mereological relation that can be axiomatically defined %% - a fusion is the sum of its parts (e.g. a car is made of several %%   mechanical parts, an molecule is made of nuclei and electrons) %% - a fusion is of the same entity type as its parts (e.g. a physical %%   entity is made of physical entities parts) %% - a fusion can be partitioned in more than one way %BRANCH EMMO</p> <p>%BRANCHDOC Elementary %BRANCHDOC Perspective</p> <p>%BRANCHDOC Holistic %BRANCHDOC Semiotics %BRANCHDOC Sign %BRANCHDOC Interpreter %BRANCHDOC Object %BRANCHDOC Conventional %BRANCHDOC Property %BRANCHDOC Icon %BRANCHDOC Process</p> <p>%BRANCHDOC Perceptual %BRANCHDOC Graphical %BRANCHDOC Geometrical %BRANCHDOC Symbol %BRANCHDOC Mathematical %BRANCHDOC MathematicalSymbol %BRANCHDOC MathematicalModel %BRANCHDOC MathematicalOperator %BRANCHDOC Metrological %BRANCHDOC PhysicalDimension     rankdir=RL %BRANCHDOC PhysicalQuantity %BRANCHDOC Number %BRANCHDOC MeasurementUnit %BRANCHDOC UTF8 %BRANCHDOC SIBaseUnit %BRANCHDOC SISpecialUnit        rankdir=RL %BRANCHDOC PrefixedUnit %BRANCHDOC MetricPrefix         rankdir=RL %BRANCHDOC Quantity %BRANCHDOC BaseQuantity %BRANCHDOC DerivedQuantity      rankdir=RL %BRANCHDOC PhysicalConstant</p> <p>%BRANCHDOC Reductionistic %BRANCHDOC Expression</p> <p>%BRANCHDOC Physicalistic %BRANCHDOC ElementaryParticle</p>"},{"location":"examples/emmodoc/classes/#branchdoc-subatomic","title":"%BRANCHDOC Subatomic","text":"<p>%BRANCHDOC Matter %BRANCHDOC Fluid %BRANCHDOC Mixture %BRANCHDOC StateOfMatter</p>"},{"location":"examples/emmodoc/emmo/","title":"Emmo","text":"<p>%% %% This is the main Markdown input file for the EMMO documentation. %% %% Lines starting with a % are pre-processor directives. %%</p> <p>%INCLUDE introduction.md</p> <p>%INCLUDE relations.md</p> <p>%INCLUDE classes.md</p> <p>%HEADER Individuals       level=1 %ALL individuals</p> <p>%HEADER Appendix          level=1</p> <p>%HEADER \"The complete taxonomy of EMMO relations\"   level=2 %BRANCHFIG EMMORelation   caption='The complete taxonomy of EMMO relations.' terminated=0 relations=all edgelabels=0</p> <p>%HEADER \"The taxonomy of EMMO classes\"     level=2 %BRANCHFIG EMMO           caption='The almost complete taxonomy of EMMO classes. Only physical quantities and constants are left out.' terminated=0 relations=isA edgelabels=0 leaves=PhysicalDimension,BaseQuantity,DerivedQuantity,ExactConstant,MeasuredConstant,SIBaseUnit,SISpecialUnit,MetricPrefix,UTF8</p>"},{"location":"examples/emmodoc/important_concepts/","title":"Important concepts","text":""},{"location":"examples/emmodoc/important_concepts/#important-concepts","title":"Important concepts","text":""},{"location":"examples/emmodoc/important_concepts/#mereotopological-composition","title":"Mereotopological composition","text":""},{"location":"examples/emmodoc/important_concepts/#substrate","title":"Substrate","text":"<p>A <code>substrate</code> represents the place (in general sense) in which every real world item exists. It provides the dimensions of existence for real world entities. This follows from the fact that everything that exists is placed somewhere in space and time. Hence, its space and time coordinates can be used to identify it.</p> <p>Substrates are always topologically connected spaces. A topological space, X, is said to be disconnected if it is the union of two disjoint non-empty open sets. Otherwise, X is said to be connected.</p> <p><code>substrate</code> is the superclass of <code>space</code>, <code>time</code> and their combinations, like <code>spacetime</code>.</p> <p>Following Kant, space and time are a priori forms of intuition, i.e. they are the substrate upon which we place our intuitions, assigning space and time coordinates to them.</p>"},{"location":"examples/emmodoc/important_concepts/#hybrid","title":"Hybrid","text":"<p>A <code>hybrid</code> is the combination of <code>space</code> and <code>time</code>. It has the subclasses <code>world_line</code> (0D space + 1D time), <code>world_sheet</code> (1D space + 1D time), <code>world_volume</code> (2D space + 1D time) and <code>spacetime</code> (3D space + 1D time).</p>"},{"location":"examples/emmodoc/important_concepts/#spacetime","title":"Spacetime","text":"<p>EMMO represents real world entities as subclasses of <code>spacetime</code>. A <code>spacetime</code> is valid for all reference systems (as required by the theory of relativity).</p>"},{"location":"examples/emmodoc/important_concepts/#matter","title":"Matter","text":"<p><code>matter</code> is used to represent a group of <code>elementary</code> in an enclosing <code>spacetime</code>. As illustrated in the figure, a <code>matter</code> is an <code>elementary</code> or a composition of other <code>matter</code> and <code>vacuum</code>.</p> <p></p> <p>In EMMO <code>matter</code> is always a 4D spacetime. This is a fundamental difference between EMMO and most other ontologies.</p> <p>In order to describe the real world, we must also take into account the vacuum between the elementaries that composes higher granularity level entity (e.g. an atom).</p> <p>In EMMO <code>vacuum</code> is defined as a <code>spacetime</code> that has no <code>elementary</code> parts.</p>"},{"location":"examples/emmodoc/important_concepts/#existent","title":"Existent","text":"<p>An <code>existent</code> is defined as a <code>matter</code> that unfolds in time as a succession of states. It is used to represent the whole life of a complex but structured state-changing <code>matter</code> entity, like e.g. an atom that becomes ionised and then recombines with an electron.</p> <p>On the contrary, a <code>matter and not existent</code> entity is something \"amorphous\", randomly collected and not classifiable by common terms or definitions. That is a heterogeneous heap of <code>elementary</code>, appearing and disappearing in time.</p>"},{"location":"examples/emmodoc/important_concepts/#state","title":"State","text":"<p>A <code>state</code> is matter in a particular configurational state. It is defined as having spatial direct parts that persist (do not change) throughout the lifetime of the <code>state</code>. Hence, a <code>state</code> is like a snapshot of a physical in a finite time interval.</p> <p></p> <p>The use of spatial direct parthood in the definition of <code>state</code> means that a <code>state</code> cannot overlap in space with another <code>state</code>.</p> <p>An important feature of states, that follows from the fact that they are <code>spacetime</code>, is that they constitute a finite time interval.</p>"},{"location":"examples/emmodoc/important_concepts/#elementary","title":"Elementary","text":"<p>The basic assumption of decomposition in EMMO, is that the most basic manifestation of <code>matter</code> is represented by a subclass of <code>spacetime</code> called <code>elementary</code>.</p> <p>The <code>elementary</code> class defines the \"atomic\" (undividable) level in EMMO. A generic <code>matter</code> can always be decomposed in proper parts down to the <code>elementary</code> level using proper parthood. An <code>elementary</code> can still be decomposed in temporal parts, that are themselves <code>elementary</code>.</p> <p>Example of elementaries are electrons, photons and quarks.</p> <p></p>"},{"location":"examples/emmodoc/important_concepts/#granularity-direct-parthood","title":"Granularity - direct parthood","text":"<p>Granularity is a central concept of EMMO, which allows the user to percieve the world at different levels of detail (granularity) that follow physics and materials science perspectives.</p> <p></p> <p>Every material in EMMO is placed on a granularity level and the ontology gives information about the direct upper and direct lower level classes. This is done with the non-transitive <code>is_direct_part_of</code> relation.</p> <p></p> <p>Granularity is a defined class and is useful sine a reasoner automatically can put the individuals defined by the user under a generic class that clearly expresses the types of its compositional parts.</p>"},{"location":"examples/emmodoc/important_concepts/#mathematical-entities","title":"Mathematical entities","text":"<p>The class <code>mathematical_entity</code> represents fundamental elements of mathematical expressions, like numbers, variables, unknowns and equations. Mathematical entities are pure mathematical and have no physical unit.</p>"},{"location":"examples/emmodoc/important_concepts/#natural-law","title":"Natural law","text":"<p>A <code>natural_law</code> is an abstraction for a series of experiments that tries to define a common cause and effect of the time evolution of a set of interacting participants. It is (by definition) a pre-mathematical entity.</p> <p>The <code>natural_law</code> class is defined as</p> <pre><code>is_abstraction_for some experiment\n</code></pre> <p>It can be represented e.g. as a thought in the mind of the experimentalist, a sketch and textual description in a book of science.</p> <p><code>physical_law</code> and <code>material_law</code> are, according to the RoMM and CWA, the laws behind physical equations and material relations, respectively.</p>"},{"location":"examples/emmodoc/important_concepts/#properties","title":"Properties","text":"<p>Properties are abstracts that are related to a specific material entity with the relation has_property, but that depend on a specific observation process, participated by a specific observer, who catch the physical entity behaviour that is abstracted as a property.</p> <p>Properties enable us to connect a measured property to the measurement process and the measurement instrument.</p>"},{"location":"examples/emmodoc/introduction/","title":"Introduction","text":"<p>EMMO is a multidisciplinary effort to develop a standard representational framework (the ontology) based on current materials modelling knowledge, including physical sciences, analytical philosophy and information and communication technologies. This multidisciplinarity is illustrated by the figure on the title page. It provides the connection between the physical world, materials characterisation world and materials modelling world.</p> <p></p> <p>EMMO is based on and is consistent with the Review of Materials Modelling, CEN Workshop Agreement and MODA template. However, while these efforts are written for humans, EMMO is defined using the Web Ontology Language (OWL), which is machine readable and allows for machine reasoning. In terms of semantic representation, EMMO brings everything to a much higher level than these foundations.</p> <p>As illustrated in the figure below, EMMO covers all aspects of materials modelling and characterisation, including:</p> <ul> <li>the material itself, which must be described in a rigorous way;</li> <li>the observation process involving an observer that percieves the real world (characterisation);</li> <li>the properties that are measured or modelled;</li> <li>the physics laws that describe the material behaviour;</li> <li>the physical models that approximate the physics laws;</li> <li>the solver including the numerical discretisation method that leads to a solvable mathematical representation under certain simplifying assumptions;</li> <li>the numerical solver that performs the calculations; and</li> <li>the post processing of experimental or simulated data.</li> </ul> <p></p> <p>EMMO is released under the Creative Commons license and is available at emmo.info/. The OWL2-DL sources are available in RDF/XML format.</p>"},{"location":"examples/emmodoc/introduction/#what-is-an-ontology","title":"What is an ontology","text":"<p>In short, an ontology is a specification of a conceptualization. The word ontology has a long history in philosophy, in which it refers to the subject of existence. The so-called ontological argument for the existence of God was proposed by Anselm of Canterbury in 1078. He defined God as \"that than which nothing greater can be thought\", and argued that \"if the greatest possible being exists in the mind, it must also exist in reality. If it only exists in the mind, then an even greater being must be possible -- one which exists both in the mind and in reality\". Even though this example has little to do with todays use of ontologies in e.g. computer science, it illustrates the basic idea; the ontology defines some basic premises (concepts and relations between them) from which it is possible reason to gain new knowledge.</p> <p>For a more elaborated and modern definition of the ontology we refer the reader to the one provided by Tom Gruber (2009). Another useful introduction to ontologies is the paper Ontology Development 101: A Guide to Creating Your First Ontology by Noy and McGuinness (2001), which is based on the Protege sortware, with which EMMO has been developed.</p> <p>A taxonomy is a hierarchical representation of classes and subclasses connected via <code>is_a</code> relations. Hence, it is a subset of the ontology excluding all but the <code>is_a</code> relations. The main use of taxonomies is for the organisation of classifications. The figure shows a simple example of a taxonomy illustrating a categorisation of four classes into a hierarchy of more higher of levels of generality.</p> <p></p> <p>In EMMO, the taxonomy is a rooted directed acyclic graph (DAG). This is important since many classification methods relies on this property, see e.g. Valentini (2014) and Robison et al (2015). Note, that EMMO is a DAG does not prevent some classes from having more than one parent. A <code>Variable</code> is for instance both a <code>Mathematical</code> and a <code>Symbol</code>. See appendix for the full EMMO taxonomy.</p>"},{"location":"examples/emmodoc/introduction/#primitive-elements-in-emmo","title":"Primitive elements in EMMO","text":""},{"location":"examples/emmodoc/introduction/#individuals","title":"Individuals","text":"<p>Individuals are the basic, \"ground level\" components of EMMO. They may include concrete objects such as cars, flowers, stars, persons and molecules, as well as abstract individuals such as a measured height, a specific equation and software programs.</p> <p>Individuals possess attributes in form of axioms that are defined by the user (interpreter) upon declaration.</p>"},{"location":"examples/emmodoc/introduction/#classes","title":"Classes","text":"<p>Classes represent concepts. They are the building blocks that we use to create an ontology as a representation of knowledge. We distinguish between defined and non-defined classes.</p> <p>Defined classes are defined by the requirements for being a member of the class. In the graphical representations of EMMO, defined classes are orange. For instance, in the graph of the top-level entity branch below, The root <code>EMMO</code> and a defined class (defined to be the disjoint union of <code>Item</code> and <code>Collection</code>).</p> <p>Non-defined classes are defined as an abstract group of objects, whose members are defined as belonging to the class. They are yellow in the graphical representations.</p> <p>%BRANCHFIG EMMO leaves=Perspective,Elementary caption='Example of the top-level branch of EMMO showing some classes and relationships between them.' width=460</p>"},{"location":"examples/emmodoc/introduction/#axioms","title":"Axioms","text":"<p>Axioms are propositions in a logical framework that define the relations between the individuals and classes. They are used to categorise individuals in classes and to define the defined classes.</p> <p>The simplest form of a class axiom is a class description that just states the existence of the class and gives it an unique identifier. In order to provide more knowledge about the class, class axioms typically contain additional components that state necessary and/or sufficient characteristics of the class. OWL contains three language constructs for combining class descriptions into class axioms:</p> <ul> <li> <p>Subclass (<code>rdfs:subClassOf</code>) allows one to say that the class extension of a class description is a subset of the class extension of another class description.</p> </li> <li> <p>Equivalence (<code>owl:equivalentClass</code>) allows one to say that a class description has exactly the same class extension (i.e. the individuals associated with the class) as another class description.</p> </li> <li> <p>Distjointness (<code>owl:disjointWith</code>) allows one to say that the class extension of a class description has no members in common with the class extension of another class description.</p> </li> </ul> <p>See the section about Description logic for more information about these language constructs. Axioms are also used to define relations between relations. These are further detailed in the chapter on Relations.</p>"},{"location":"examples/emmodoc/introduction/#theoretical-foundations","title":"Theoretical foundations","text":"<p>EMMO build upon several theoretical frameworks.</p>"},{"location":"examples/emmodoc/introduction/#semiotics","title":"Semiotics","text":"<p>Semiotics is the study of meaning-making. It is the dicipline of formulating something that possibly can exist in a defined space and time in the real world.</p> <p>%%It is introdused in EMMO via the %%<code>semion</code> class and used as a way to reduce the complexity of a %%physical to a simple sign (symbol).  A <code>Sign</code> is a physical %%entity that can represent another object. %% %%### Set theory %%Set theory is the theory of membership. This is introduced via %%the <code>set</code> class, representing the collection of all individuals %%(signs) that represent a collection of items.  Sets are defined %%via the <code>hasMember</code> relations.</p>"},{"location":"examples/emmodoc/introduction/#mereotopology","title":"Mereotopology","text":"<p>Mereotopology is the combination of mereology (science of parthood) and topology (mathematical study of the geometrical properties and conservation through deformations). It is introdused via the <code>Item</code> class and based on the <code>mereotopological</code> relations. Items in EMMO are always topologically connected in space and time. EMMO makes a strong distinction between membership and parthood relations. In contrast to collections, items can only have parts that are themselves items. For further information, see Casati and Varzi \"Parts and Places\" (1999).</p>"},{"location":"examples/emmodoc/introduction/#physics","title":"Physics","text":"<p>EMMO is strongly based on physics, with the aim of being able to describe all aspects and all domains of physics, from quantum mechanics to continuum, engeneering, chemistry, etc. EMMO is compatible with both the De Broglie - Bohm and the Copenhagen interpretation of quantum mecanics (see <code>Physical</code> for more comments).</p> <p>EMMO defines a physics-based parthood hierachy under <code>Physical</code> by introducing the following concepts (illustrated in the figure below):</p> <ul> <li> <p><code>Elementary</code> is the fundamental, non-divisible constituent of entities.   In EMMO, elementaries are based on the standard model of physics.</p> </li> <li> <p><code>State</code> is a <code>Physical</code> whose parts does not change during its life time (at the chosen level of granularity).   This is consistent with a state within e.g. thermodynamics.</p> </li> <li> <p><code>Existent</code> is a succession of states.</p> </li> </ul> <p></p>"},{"location":"examples/emmodoc/introduction/#metrology","title":"Metrology","text":"<p>Metrology is the science of measurements. It introduces units and links them to properties. The description of metrology in EMMO is based on the standards of International System of Quantities (ISQ) and International System of Units (SI).</p>"},{"location":"examples/emmodoc/introduction/#description-logic","title":"Description logic","text":"<p>Description logic (DL) is a formal knowledge representation language in which the axioms are expressed. It is less expressive than first-order logic (FOL), but commonly used for providing the logical formalism for ontologies and semantic web. EMMO is expressed in the Web Ontology Language (OWL), which in turn is based on DL. This brings along features like reasoning.</p> <p>Since it is essential to have a basic notion of OWL and DL, we include here a very brief overview. For a proper introduction to OWL and DL, we refer the reader to sources like Grau et.al. (2008), OWL2 Primer and OWL Reference.</p> <p>OWL distinguishes between six types of class descriptions:</p> <ol> <li>a class identifier (a IRI reference);</li> <li>an exhaustive enumeration of individuals that together form the instances of a class (<code>owl:oneOf</code>);</li> <li>a property restriction (<code>owl:someValuesFrom</code>, <code>owl:allValuesFrom</code>, <code>owl:hasValue</code>, <code>owl:cardinality</code>, <code>owl:minCardinality</code>, <code>owl:maxCardinality</code>);</li> <li>the intersection of two or more class descriptions (<code>owl:intersectionOf</code>);</li> <li>the union of two or more class descriptions (<code>owl:unionOf</code>); and</li> <li>the complement of a class description (<code>owl:complementOf</code>).</li> </ol> <p>Except for the first, all of these refer to defined classes. The table below shows the notation in OWL, DL and the Manchester OWL syntax, all commonly used for the definitions. The Manchester syntax is used by Protege and is designed to not use DL symbols and to be easy and quick to read and write. Several other syntaxes exist for DL. An interesting example is the pure Python syntax proposed by Lamy (2017), which is used in the open source Owlready2 Python package. The Python API for EMMO is also based on Owlready2.</p> <p>DL                 Manchester         Python + Owlready2        Read                  Meaning                                        ---------------    -----------------  -------------------        -------------------   -------------------- Constants</p> <p>$\\top$                                Thing                      top                   A special class with every individual as an instance</p> <p>$\\bot$                                Nothing                    bottom                The empty class</p> <p>Axioms</p> <p>$A\\doteq B$                                                      A is defined to be    Class definition                                                                  equal to B</p> <p>$A\\sqsubseteq B$   A subclass_of B    class A(B): ...            all A are B           Class inclusion</p> <pre><code>                                  issubclass(A, B)                                 Test for *inclusion*\n</code></pre> <p>$A\\equiv B$        A equivalent_to B  A.equivalent_to.append(B)  A is equivalent to B  Class equivalence</p> <pre><code>                                  B in A.equivalent_to                             Test for equivalence\n</code></pre> <p>$a:A$              a is_a A           a = A()                    a is a A              Class assertion (instantiation)</p> <pre><code>                                  isinstance(a, A)                                 Test for instance of\n</code></pre> <p>$(a,b):R$          a object property  a.R.append(b)              a is R-related to b   Property assertion                    assertion b</p> <p>$(a,n):R$          a data property    a.R.append(n)              a is R-related to n   Data assertion                    assertion n</p> <p>Constructions</p> <p>$A\\sqcap B$        A and B            A &amp; B                      A and B               Class intersection (conjunction)</p> <p>$A\\sqcup B$        A or B             A | B                      A or B                Class union (disjunction)</p> <p>$\\lnot A$          not A              Not(A)                     not A                 Class complement (negation)</p> <p>${a, b, ...}$    {a, b, ...}        OneOf([a, b, ...])         one of a, b, ...      Class enumeration</p> <p>$S\\equiv R^-$      S inverse_of R     Inverse(R)                 S is inverse of R     Property inverse</p> <pre><code>                                  S.inverse == R                                   Test for *inverse*\n</code></pre> <p>$\\forall R.A$      R only A           R.only(A)                  all A with R          Universal restriction</p> <p>$\\exists R.A$      R some A           R.some(A)                  some A with R         Existential restriction</p> <p>$=n R.A$           R exactly n A      R.exactly(n, A)                                  Cardinality restriction</p> <p>$\\leq n R.A$       R min n A          R.min(n, A)                                      Minimum cardinality restriction</p> <p>$\\geq n R.A$       R max n A          R.max(n, A)                                      Minimum cardinality restriction</p> <p>$\\exists R{a}$   R value a          R.value(a)                                       Value restriction</p> <p>Decompositions</p> <p>$A\\sqcup B         A disjoint with B  AllDisjoint([A, B])        A disjoint with B     Disjoint \\sqsubseteq\\bot$</p> <pre><code>                                  B in A.disjoints()                               Test for disjointness\n</code></pre> <p>$\\exists R.\\top    R domain A         R.domain = [A]                                   Classes that the restriction applies to \\sqsubseteq A$</p> <p>$\\top\\sqsubseteq   R range B          R.range = [B]                                    All classes that can be the value of the restriction \\forall R.B$</p> <p>Table: Notation for DL and Protege. A and B are classes, R is an active relation, S is an passive relation, a and b are individuals and n is a literal. Inspired by the Great table of Description Logics.</p>"},{"location":"examples/emmodoc/introduction/#examples","title":"Examples","text":"<p>Here are some examples of different class descriptions using both the DL and Manchester notation.</p>"},{"location":"examples/emmodoc/introduction/#equivalence-owlequivalentto","title":"Equivalence (<code>owl:equivalentTo</code>)","text":"<p>Equivalence ($\\equiv$) defines necessary and sufficient conditions.</p> <p>Parent is equivalent to mother or father</p> <p>DL: <code>parent</code> $\\equiv$ <code>mother</code> $\\lor$ <code>father</code></p> <p>Manchester: <code>parent equivalent_to mother or father</code></p>"},{"location":"examples/emmodoc/introduction/#inclusion-rdfsubclassof","title":"Inclusion (<code>rdf:subclassOf</code>)","text":"<p>Inclusion ($\\sqsubseteq$) defines necessary conditions.</p> <p>An employee is a person.</p> <p>DL: <code>employee</code> $\\sqsubseteq$ <code>person</code></p> <p>Manchester: <code>employee is_a person</code></p>"},{"location":"examples/emmodoc/introduction/#enumeration-owloneof","title":"Enumeration (<code>owl:oneOf</code>)","text":"<p>The color of a wine is either white, rose or red:</p> <p>DL: <code>wine_color</code> $\\equiv$ {<code>white</code>, <code>rose</code>, <code>red</code>}</p> <p>Manchester: <code>wine_color equivalent_to {white, rose, red}</code></p>"},{"location":"examples/emmodoc/introduction/#existential-restriction-owlsomevaluesfrom","title":"Existential restriction (<code>owl:someValuesFrom</code>)","text":"<p>A mother is a woman that has a child (some person):</p> <p>DL: <code>mother</code> $\\equiv$ <code>woman</code> $\\sqcap$ $\\exists$<code>has_child</code>.<code>person</code></p> <p>Manchester: <code>mother equivalent_to woman and has_child some person</code></p>"},{"location":"examples/emmodoc/introduction/#universal-restriction-owlallvaluesfrom","title":"Universal restriction (<code>owl:allValuesFrom</code>)","text":"<p>All parents that only have daughters:</p> <p>DL: <code>parents_with_only_daughters</code> $\\equiv$ <code>person</code> $\\sqcap$ $\\forall$<code>has_child</code>.<code>woman</code></p> <p>Manchester: <code>parents_with_only_daughters equivalent_to person and has_child only woman</code></p>"},{"location":"examples/emmodoc/introduction/#value-restriction-owlhasvalue","title":"Value restriction (<code>owl:hasValue</code>)","text":"<p>The owl:hasValue restriction allows to define classes based on the existence of particular property values. There must be at least one matching property value.</p> <p>All children of Mary:</p> <p>DL: <code>Marys_children</code> $\\equiv$ <code>person</code> $\\sqcap$ $\\exists$<code>has_parent</code>.{<code>Mary</code>}</p> <p>Manchester: <code>Marys_children equivalent_to person and has_parent value Mary</code></p>"},{"location":"examples/emmodoc/introduction/#property-cardinality-owlcardinality","title":"Property cardinality (<code>owl:cardinality</code>)","text":"<p>The owl:cardinality restrictions ($\\geq$, $\\leq$ or $\\equiv$) allow to define classes based on the maximum (owl:maxCardinality), minimum (owl:minCardinality) or exact (owl:cardinality) number of occurences.</p> <p>A person with one parent:</p> <p>DL: <code>half_orphant</code> $\\equiv$ <code>person</code> and =1<code>has_parent</code>.<code>person</code></p> <p>Manchester: <code>half_orphant equivalent_to person and has_parent exactly 1 person</code></p>"},{"location":"examples/emmodoc/introduction/#intersection-owlintersectionof","title":"Intersection (<code>owl:intersectionOf</code>)","text":"<p>Individuals of the intersection ($\\sqcap$) of two classes, are simultaneously instances of both classes.</p> <p>A man is a person that is male:</p> <p>DL: <code>man</code> $\\equiv$ <code>person</code> $\\sqcap$ <code>male</code></p> <p>Manchester: <code>man equivalent_to person and male</code></p>"},{"location":"examples/emmodoc/introduction/#union-owlunionof","title":"Union (<code>owl:unionOf</code>)","text":"<p>Individuals of the union ($\\sqcup$) of two classes, are either instances of one or both classes.</p> <p>A person is a man or woman:</p> <p>DL: <code>person</code> $\\equiv$ <code>man</code> $\\sqcup$ <code>woman</code></p> <p>Manchester: <code>person equivalent_to man or woman</code></p>"},{"location":"examples/emmodoc/introduction/#complement-owlcomplementof","title":"Complement (<code>owl:complementOf</code>)","text":"<p>Individuals of the complement ($\\lnot$) of a class, are all individuals that are not member of the class.</p> <p>Not a man:</p> <p>DL: <code>female</code> $\\equiv$ $\\lnot$ <code>male</code></p> <p>Manchester: <code>female equivalent_to not male</code></p>"},{"location":"examples/emmodoc/introduction/#the-structure-of-emmo","title":"The structure of EMMO","text":"<p>The EMMO ontology is structured in shells, expressed by specific ontology fragments, that extends from fundamental concepts to the application domains, following the dependency flow.</p>"},{"location":"examples/emmodoc/introduction/#top-level","title":"Top Level","text":"<p>The EMMO top level is the group of fundamental axioms that constitute the philosophical foundation of the EMMO. Adopting a physicalistic/nominalistic perspective, the EMMO defines real world objects as 4D objects that are always extended in space and time (i.e. real world objects cannot be spaceless nor timeless). For this reason abstract objects, i.e. objects that does not extend in space and time, are forbidden in the EMMO.</p> <p>EMMO is strongly based on the analytical philosophy dicipline semiotic. The role of abstract objects are in EMMO fulfilled by semiotic objects, i.e. real world objects (e.g. symbol or sign) that stand for other real world objects that are to be interpreted by an agent. These symbols appear in actions (semiotic processes) meant to communicate meaning by establishing relationships between symbols (signs).</p> <p>Another important building block of from analytical philosophy is atomistic mereology applied to 4D objects. The EMMO calls it 'quantum mereology', since the there is a epistemological limit to how fine we can resolve space and time due to the uncertanity principles.</p> <p>The mereotopology module introduces the fundamental mereotopological concepts and their relations with the real world objects that they represent. The EMMO uses mereotopology as the ground for all the subsequent ontology modules. The concept of topological connection is used to define the first distinction between ontology entities namely the Item and Collection classes. Items are causally self-connected objects, while collections are causally disconnected. Quantum mereology is represented by the Quantum class. This module introduces also the fundamental mereotopological relations used to distinguish between space and time dimensions.</p> <p>The physical module, defines the Physical objects and the concept of Void that plays a fundamental role in the description of multiscale objects and quantum systems. It also define the Elementary class, that restricts mereological atomism in space.</p> <p></p> <p>In EMMO, the only univocally defined real world object is the Item individual called Universe that stands for the universe. Every other real world object is a composition of elementaries up to the most comprehensive object; the Universe. Intermediate objects are not univocally defined, but their definition is provided according to some specific philosophical perspectives. This is an expression of reductionism (i.e. objects are made of sub-objects) and epistemological pluralism (i.e. objects are always defined according to the perspective of an interpreter, or a class of interpreters).</p> <p>The Perspective class collects the different ways to represent the objects that populate the conceptual region between the elementary and universe levels.</p>"},{"location":"examples/emmodoc/introduction/#middle-level","title":"Middle Level","text":"<p>The middle level ontologies act as roots for extending the EMMO towards specific application domains.</p> <p></p> <p>The Reductionistic perspective class uses the fundamental non-transitive parthood relation, called direct parthood, to provide a powerful granularity description of multiscale real world objects. The EMMO can in principle represents the Universe with direct parthood relations as a direct rooted tree up to its elementary constituents.</p> <p>The Phenomenic perspective class introduces the concept of real world objects that express of a recognisable pattern in space or time that impress the user. Under this class the EMMO categorises e.g. formal languages, pictures, geometry, mathematics and sounds. Phenomenic objects can be used in a semiotic process as signs.</p> <p>The Physicalistic perspective class introduces the concept of real world objects that have a meaning for the under applied physics perspective.</p> <p>The Holistic perspective class introduces the concept of real world objects that unfold in time in a way that has a meaning for the EMMO user, through the definition of the classes Process and Participant. The semiotics module introduces the concepts of semiotics and the Semiosis process that has a Sign, an Object and an Interpreter as participants. This forms the basis in EMMO to represent e.g. models, formal languages, theories, information and properties.</p> <p></p>"},{"location":"examples/emmodoc/introduction/#emmo-relations","title":"EMMO relations","text":"<p>All EMMO relations are subrelations of the relations found in the two roots: mereotopological and semiotical. The relation hierarchy extends more vertically (i.e. more subrelations) than horizontally (i.e. less sibling relations), facilitating the categorisation and inferencing of individuals. See also the chapter EMMO Relations.</p> <p>Imposing all relations to fall under mereotopology or semiotics is how the EMMO force the developers to respect its perspectives. Two entities are related only by contact or parthood (mereotopology) or by standing one for another (semiosis): no other types of relation are possible within the EMMO.</p> <p>A unique feature in EMMO, is the introduction of direct parthood. As illustrated in the figure below, it is a mereological relation that lacks transitivity. This makes it possible to entities made of parts at different levels of granularity and to go between granularity levels in a well-defined manner. This is paramount for cross scale interoperability. Every material in EMMO is placed on a granularity level and the ontology gives information about the direct upper and direct lower level classes using the non-transitive direct parthood relations.</p> <p></p>"},{"location":"examples/emmodoc/introduction/#annotations","title":"Annotations","text":"<p>All entities and relations in EMMO have some attributes, called annotations. In some cases, only the required International Resource Identifier (IRI) and relations are provided. However, descriptive annotations, like elucidation and comment, are planned to be added for all classes and relations. Possible annotations are:</p> <ul> <li>Elucidation is a human readable explanation and clearification of the documented class or relation.</li> <li>Example clearifies the elucidation through an example.   A class may have several examples, each addressing different aspects.</li> <li>Comment is a clearifying note complementing the definition and elucidation.   A class may have several comments, each clearifying different aspects.</li> <li>IRI stands for international resource identifier.   It is an identifier that uniquely identifies the class or relation.   IRIs are similar to URIs, but are not restricted to the ASCII character set.   In EMMO, the IRIs are now valid URLs pointing to the stable version of EMMO.</li> <li>Relations is a list of relations applying to the current class or relation.   The relations for relations are special and will be elaborated on in the introduction to chapter [Relations].   Some of the listed relations are defined in the OWL sources, while other are inferred by the reasoner.   The relations are expressed using the Manchester OWL syntax introduced in section Description logic.</li> </ul> <p>%%### Graphs %%The generated graphs borrow some syntax from the Unified Modelling %%Language (UML), which is a general purpose language for software %%design and modelling.  The table below shows the style used for the %%different types of relations and the concept they correspond to in %%UML. %% %%Relation           UML arrow     UML concept %%-------------      -----------   ----------- %%is-a               ![img][isa]   inheritance %%disjoint_with      ![img][djw]   association %%equivalent_to      ![img][eqt]   association %%encloses           ![img][rel]   aggregation %%has_abstract_part  ![img][rel]   aggregation %%has_abstraction    ![img][rel]   aggregation %%has_representation ![img][rel]   aggregation %%has_member         ![img][rel]   aggregation %%has_property       ![img][rel]   aggregation %% %%Table: Notation for arrow styles used in the graphs.  Only active %%relations are listed. Corresponding passive relations use the same %%style. %% %%[isa]: figs/arrow-is_a.png \"inheritance\" %%[djw]: figs/arrow-disjoint_with.png \"association\" %%[eqt]: figs/arrow-equivalent_to.png \"association\" %%[rel]: figs/arrow-relation.png \"aggregation\"</p> <p>%%All relationships have a direction.  In the graphical visualisations, %%the relationships are represented with an arrow pointing from the %%subject to the object.  In order to reduce clutter and limit the size %%of the graphs, the relations are abbreviated according to the %%following table: %% %%Relation                        Abbreviation %%--------                        ------------ %%has_part only                   hp-o %%is_part_of only                 ipo-o %%has_member some                 hm-s %%is_member_of some               imo-s %%has_abstraction some            ha-s %%is_abstraction_of some          iao-s %%has_abstract_part only          pap-o %%is_abstract_part_of only        iapo-o %%has_space_slice some            hss-s %%is_space_slice_of some          isso-s %%has_time_slice some             hts-s %%is_time_slice_of some           itso-s %%has_projection some             hp-s %%is_projection_of some           ipo-s %%has_proper_part some            hpp-s %%is_proper_part_of some          ippo-s %%has_proper_part_of some         hppo-s %%has_spatial_direct_part min     hsdp-m %%has_spatial_direct_part some    hsdp-s %%has_spatial_direct_part exactly hsdp-e %% %%Table: Abbriviations of relations used in the graphical representation %%of the different subbranches. %% %% %%UML represents classes as a box with three compartments; names, attributes %%and operators.  However, since the classes in EMMO have no operators and %%since it gives little meaning to include the OWL annotations as attributes, %%we simply represent the classes as boxes by a name. %% %%As already mentioned, defined classes are colored orange, while %%undefined classes are yellow. %% %% %%</p>"},{"location":"examples/emmodoc/relations/","title":"Relations","text":"<p>%% %% This file %% This is Markdown file, except of lines starting with %% will %% be stripped off. %%</p> <p>%HEADER \"EMMO Relations\"    level=1</p> <p>In the language of OWL, relations are called properties. However, since relations describe relations between classes and individuals and since properties has an other meaning in EMMO, we only call them relations.</p> <p>Resource Description Framework (RDF) is a W3C standard that is widely used for describing informations on the web and is one of the standards that OWL builds on. RDF expresses information in form of subject-predicate-object triplets. The subject and object are resources (aka items to describe) and the predicate expresses a relationship between the subject and the object.</p> <p>In OWL are the subject and object classes or individuals (or data) while the predicate is a relation. An example of an relationship is the statement dog is_a animal. Here <code>dog</code> is the subject, <code>is_a</code> the predicate and <code>animal</code> the object.</p> <p>%%We distinguish between %%<code>active relations</code> where the subject is acting on the object and %%<code>passive relations</code> where the subject is acted on by the object.</p> <p>OWL distingues between object properties, that link classes or individuals to classes or individuals, and data properties that link individuals to data values. Since EMMO only deals with classes, we will only be discussing object properties. However, in actual simulation or characterisation applications build on EMMO, datatype propertyes will be important.</p> <p>The characteristics of the different properties are described by the following property axioms:</p> <ul> <li> <p><code>rdf:subPropertyOf</code> is used to define that a property is a subproperty of some other property.   For instance, in the figure below showing the relation branch, we see that <code>active_relation</code> is a subproperty or <code>relation</code>.   The <code>rdf:subPropertyOf</code> axioms forms a taxonomy-like tree for relations.</p> </li> <li> <p><code>owl:equivalentProperty</code> states that two properties have the same property extension.</p> </li> <li> <p><code>owl:inverseOf</code> axioms relate active relations to their corresponding passive relations, and vice versa.   The root relation <code>relation</code> is its own inverse.</p> </li> <li> <p><code>owl:FunctionalProperty</code> is a property that can have only one (unique) value y for each instance x, i.e. there cannot be two distinct values y1 and y2 such that the pairs (x,y1) and (x,y2) are both instances of this property.   Both object properties and datatype properties can be declared as \"functional\".</p> </li> <li> <p><code>owl:InverseFunctionalProperty</code>.</p> </li> <li> <p><code>owl:TransitiveProperty</code> states that if a pair (x,y) is an instance of P, and the pair (y,z) is instance of P, then we can infer that the pair (x,z) is also an instance of P.</p> </li> <li> <p><code>owl:SymmetricProperty</code> states that if the pair (x,y) is an instance of P, then the pair (y,x) is also an instance of P.   A popular example of a symmetric property is the <code>siblingOf</code> relation.</p> </li> <li> <p><code>rdfs:domain</code> specifies which classes the property applies to.   Or said differently, the valid values of the subject in a subject-predicate-object triplet.</p> </li> <li> <p><code>rdfs:range</code> specifies the property extension, i.e. the valid values of the object in a subject-predicate-object triplet.</p> </li> </ul> <p>%HEADER \"Root of EMMO relations\"      level=2 %BRANCHFIG EMMORelation   caption=\"Top-level of the EMMO relation hierarchy.\" %ENTITY EMMORelation</p>"},{"location":"examples/emmodoc/relations/#branchdoc-mereotopological","title":"%%BRANCHDOC mereotopological","text":""},{"location":"examples/emmodoc/relations/#branchhead-mereotopological","title":"%BRANCHHEAD mereotopological","text":""},{"location":"examples/emmodoc/relations/#branch-mereotopological","title":"%BRANCH mereotopological","text":""},{"location":"examples/emmodoc/relations/#branchdoc-connected","title":"%BRANCHDOC connected","text":"<p>%BRANCHDOC hasPart</p> <p>%BRANCHDOC semiotical</p>"},{"location":"examples/jupyter-visualization/","title":"Visualise an ontology using pyctoscape in Jupyter Notebook","text":""},{"location":"examples/jupyter-visualization/#installation-instructions","title":"Installation instructions","text":"<p>In a terminal, run:</p> <pre><code>cd /path/to/env/dirs\npython -m venv cytopy  # cytopy is my name, you can choose what ouy want\nsource cytopy/bin/activate\ncd /dir/to/EMMOntoPy/\npip install -e .\npip install jupyterlab\npython -m ipykernel install --user --name=cytopy\npip install ipywidgets\npip install nodejs # Note requires that node.js and npm has already been isntalled!\npip install ipycytoscape pydotplus networkx\npip install --upgrade setuptools\njupyter labextension install @jupyter-widgets/jupyterlab-manager\n</code></pre>"},{"location":"examples/jupyter-visualization/#test-the-notebook","title":"Test the notebook","text":"<p>In a terminal, run:</p> <pre><code>jupyter-lab\n</code></pre> <p>That should start jupyter kernel and open a new tab in your browser. In the side pane, select <code>team40.ipynb</code> and run the notebook.</p>"},{"location":"examples/ontology-from-excel/","title":"Generate an ontology from excel","text":"<p>This directory contains an example xlsx-file for how to document ontology entities (classes, object properties, annotation properties and data properties) in an Excel workbook. This workbook can then be used to generate a new ontology or update an already existing ontology with new entities (existing entities are not updated).</p> <p>Please refer to the (documentation)[https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/excelparser/] for full explanation of capabilities.</p> <p>The file <code>tool/onto.xlsx</code> contains examples on how to do things correctly as well as incorrectly. The tool will by default exit without generating the ontology if it detects concepts defined incorrectly. However, if the argument force is set to True, it will skip concepts that are erroneously defined and generate the ontology with what is availble.</p> <p>To run the tool directly <pre><code>cd tool # Since the excel file provides a relative path to an imported ontology\nexcel2onto onto.xlsx # This will fail\nexcel2onto --force onto.xlsx\n</code></pre> We suggest developing your excelsheet without fails as once it starts getting big it is difficult to see what is wrong or correct.</p> <p>It is also possible to generate the ontology in python. Look at the script make_onto.py for an example.</p> <p>That should be it. Good luck!</p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#emmontopy","title":"EMMOntoPy","text":"<p>Library for representing and working with ontologies in Python.</p> <p> </p> <p>EMMOntoPy is a Python package based on the excellent Owlready2, which provides a natural and intuitive representation of ontologies in Python. EMMOntoPy extends Owlready2 and adds additional functionality, like accessing entities by label, reasoning with FaCT++ and parsing logical expressions in Manchester syntax. It also includes a set of tools, like creating an ontology from an Excel sheet, generation of reference documentation of ontologies and visualisation of ontologies graphically. EMMOntoPy is freely available for on GitHub and on PyPI under the permissive open source BSD 3-Clause license.</p> <p>EMMOntoPy was originally developed to work effectively with the Elemental Multiperspective Material Ontology (EMMO) and EMMO-based domain ontologies. It has now two sub-packages, <code>ontopy</code> and <code>emmopy</code>, where <code>ontopy</code> is a general package to work with any OWL ontology, while <code>emmopy</code> provides extra features that are specific to EMMO.</p> <p>Owlready2, and thereby also EMMOntoPy, represents OWL classes and individuals in Python as classes and instances. OWL properties are represented as Python attributes. Hence, it provides a new dot notation for representing ontologies as valid Python code. The notation is simple and easy to understand and write for people with some knowledge of OWL and Python. Since Python is a versatile programming language, Owlready2 does not only allow for representation of OWL ontologies, but also to work with them programmatically, including interpretation, modification and generation. Some of the additional features provided by EMMOntoPy are are listed below:</p>"},{"location":"#access-by-label","title":"Access by label","text":"<p>In Owlready2 ontological entities, like classes, properties and individuals are accessed by the name-part of their IRI (i.e. everything that follows after the final slash or hash in the IRI). This is very inconvenient for ontologies like EMMO or Wikidata, that identify ontological entities by long numerical names. For instance, the name-part of the IRI of the Atom class in EMMO is \u2018EMMO_eb77076b_a104_42ac_a065_798b2d2809ad\u2019, which is neither human readable nor easy to write. EMMOntoPy allows to access the entity via its label (or rather skos:prefLabel) \u2018Atom\u2019, which is much more user friendly.</p>"},{"location":"#turtle-serialisationdeserialisation","title":"Turtle serialisation/deserialisation","text":"<p>The Terse RDF Triple Language (Turtle) is a common syntax and file format for representing ontologies. EMMOntoPy adds support for reading and writing ontologies in turtle format.</p>"},{"location":"#fact-reasoning","title":"FaCT++ reasoning","text":"<p>Owlready2 has only support for reasoning with HermiT and Pellet. EMMOntoPy adds additional support for the fast tableaux-based [FaCT++ reasoner] for description logics.</p>"},{"location":"#manchester-syntax","title":"Manchester syntax","text":"<p>Even though the Owlready2 dot notation is clear and easy to read and understand for people who know Python, it is a new syntax that may look foreign for people that are used to working with Prot\u00e9g\u00e9. EMMOntoPy provides support to parse and serialise logical expressions in Manchester syntax, making it possible to create tools that will be much more familiar to work with for people used to working with Prot\u00e9g\u00e9.</p>"},{"location":"#visualisation","title":"Visualisation","text":"<p>EMMOntoPy provides a Python module for graphical visualisation of ontologies. This module allows to graphically represent not only the taxonomy, but also restrictions and logical constructs. The classes to include in the graph, can either be specified manually or inferred from the taxonomy (like all subclasses of a give class that are not a subclass of any class in a set of other classes).</p>"},{"location":"#tools","title":"Tools","text":"<p>EMMOntoPy includes a small set of command-line tools implemented as Python scripts:   - <code>ontoconvert</code>:     Converts ontologies between different file formats.     It also supports some additional transformation during conversion, like running a reasoner, merging several ontological modules together (squashing), rename IRIs, generate catalogue file and automatic annotation of entities with their source IRI.   - <code>ontograph</code>:     Vertasile tool for visualising (parts of) an ontology, utilising the visualisation features mention above.   - <code>ontodoc</code>:     Documents an ontology.   - <code>excel2onto</code>:     Generate an EMMO-based ontology from an excel file.     It is useful for domain experts with limited knowledge of ontologies and that are not used to tools like Prot\u00e9g\u00e9.   - <code>ontoversion</code>:     Prints ontology version number.   - <code>emmocheck</code>:     A small test framework for checking the consistency of EMMO and EMMO-based domain ontologies and whether they confirm to the EMMO conventions.</p>"},{"location":"#some-examples-of-what-you-can-do-with-emmontopy-includes","title":"Some examples of what you can do with EMMOntoPy includes:","text":"<ul> <li>Access and query RDF-based ontologies from your application.   This includes several different flavors of RDF (OWL, Turtle (<code>ttl</code>), and more).</li> <li>Access and query EMMO-based ontologies from your application.</li> <li>Extend EMMO with new domain or application ontologies.   This can be done both statically with easy readable Python code or dynamically within your application.</li> <li>Generate graphs and documentation of your ontologies.   EMMOntoPy includes <code>ontodoc</code>: A dedicated command line tool for this.   You find it in the tools/ sub directory.</li> <li>Check that an EMMO-based domain or application ontology adhere to the conventions of EMMO.</li> <li>Interactively explore an ontology in any Python interpreter, e.g., IPython.   Tab-completion makes exploration easy and fast.   Below is an example of an IPython session where we check the relations of <code>Matter</code> in EMMO utilizing the <code>emmopy.get_emmo</code> function:</li> </ul> <pre><code>In [1]: from emmopy import get_emmo\n\nIn [2]: emmo = get_emmo()\n\nIn [3]: emmo.Matter\nOut[3]: physicalistic.Matter\n\nIn [4]: emmo.Matter.is_a\nOut[4]:\n[physicalistic.Physicalistic,\n  physical.Physical,\n  mereotopology.hasPart.some(physicalistic.Massive),\n  physical.hasTemporalPart.only(physicalistic.Matter)]\n</code></pre>"},{"location":"#documentation-and-examples","title":"Documentation and examples","text":"<p>The Owlready2 documentation is a good starting point. The EMMOntoPy package also has its own dedicated documentation.</p> <p>This includes a few examples and demos:</p> <ul> <li> <p>demo/vertical shows an example of how EMMO may be used to achieve vertical interoperability.   The file define-ontology.py provides a good example for how an EMMO-based application ontology can be defined in Python.</p> </li> <li> <p>demo/horizontal shows an example of how EMMO may be used to achieve horizontal interoperability.   This demo also shows how you can use EMMOntoPy to represent your ontology with the low-level metadata framework DLite.   In addition to achieve interoperability, as shown in the demo, DLite also allow you to automatically generate C or Fortran code base on your ontology.</p> </li> <li> <p>examples/emmodoc shows how the documentation of EMMO is generated using the <code>ontodoc</code> tool.</p> </li> </ul>"},{"location":"#installation","title":"Installation","text":"<p>Install with:</p> <pre><code>pip install EMMOntoPy\n</code></pre>"},{"location":"#required-dependencies","title":"Required Dependencies","text":"<ul> <li>Python 3.7 or later.</li> <li>Owlready2 v0.23 or later.</li> </ul>"},{"location":"#optional-dependencies","title":"Optional Dependencies","text":"<ul> <li>Graphviz: Needed for graph generation.   With support for generation pdf, png and svg figures for tests and generation of documentation automatically (<code>ontodoc</code>).</li> <li>pandoc: Only used for generated documentation from markdown to nicely formatted html or pdf.   Tested with v2.1.2.</li> <li> <p>pdfLaTeX or XeLaTeX and the <code>upgreek</code> LaTeX package (included in <code>texlive-was</code> on RetHat-based distributions and <code>texlive-latex-extra</code> on Ubuntu) for generation of pdf documentation.   If your ontology contains exotic unicode characters, we recommend XeLaTeX.</p> </li> <li> <p>Java.   Needed for reasoning.</p> </li> <li> <p>Optional Python packages:</p> </li> <li>graphviz: Generation of documentation and graphs.</li> <li>PyYAML: Required for generating documentation with pandoc.</li> <li>blessings: Clean output for <code>emmocheck</code>.</li> <li>Pygments: Coloured output for <code>emmocheck</code>.</li> <li>rdflib: Required for <code>ontoversion</code>-tool.</li> <li>semver: Required for <code>ontoversion</code>-tool.</li> <li>pydot: Used for generating graphs.     Will be deprecated.</li> <li>pyparsing: Used for parsing Manchester syntax</li> </ul> <p>See docker-instructions.md for how to build a docker image.</p>"},{"location":"#known-issues","title":"Known issues","text":"<ul> <li>Invalid serialising to turtle: Due to rdflib issue #1043 <code>ontoconvert</code> may produce invalid turtle output (if your ontology contains real literals using scientific notation without a dot in the mantissa).   This issue was fixed after the release of rdflib 5.0.0.   Hence, install the latest rdflib from PyPI (<code>pip install --upgrade rdflib</code>) or directly from the source code repository: GitHub if you need to serialise to turtle.</li> </ul>"},{"location":"#attributions-and-credits","title":"Attributions and credits","text":"<p>EMMOntoPy is maintained by EMMC-ASBL. It has mainly been developed by SINTEF, specifically:</p> <ul> <li>Jesper Friis (jesper-friis)</li> <li>Francesca L. Bleken (francescalb)</li> <li>Casper W. Andersen (CasperWA)</li> <li>Bj\u00f8rn Tore L\u00f8vfall (lovfall)</li> </ul>"},{"location":"#contributing-projects","title":"Contributing projects","text":"<ul> <li>EMMC-CSA;   Grant Agreement No: 723867   </li> </ul> <p>The EMMC-ASBL organization takes on the efforts of continuing and expanding on the efforts of the CSA. - MarketPlace;   Grant Agreement No: 760173    - OntoTrans;   Grant Agreement No: 862136    - BIG-MAP;   Grant Agreement No: 957189    - OpenModel;   Grant Agreement No: 953167   </p>"},{"location":"CHANGELOG/","title":"Changelog","text":""},{"location":"CHANGELOG/#unreleased-changes-2024-06-21","title":"Unreleased changes (2024-06-21)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>excelparser, allow for = in strings for other annotations. #751</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed failing test_save in master #756 (jesper-friis)</li> <li>Added possibility for = in extra annotations defined in excelparser #752 (francescalb)</li> <li>Load doamin-battery instead of battinfo which is just an extra wrapping #745 (francescalb)</li> <li>Rewriting ontodoc based on domain-battery #742 (jesper-friis)</li> <li>Make it possible to run HermiT on EMMO #740 (jesper-friis)</li> <li>Added minor fixes for ontoconvert #739 (jesper-friis)</li> <li>Added additional recognised prefixes #734 (jesper-friis)</li> <li>Copy EMMO annotations #733 (jesper-friis)</li> <li>Add --copy-annotation option to ontoconvert #732 (jesper-friis)</li> <li>Updated list of IRIs to ignore when checking prefLabel #731 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v071-2024-02-29","title":"v0.7.1 (2024-02-29)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v0701-2024-02-29","title":"v0.7.0.1 (2024-02-29)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Implement ontoconvert --base-iri argument #716</li> </ul> <p>Merged pull requests:</p> <ul> <li>Added <code>yield from</code> #720 (jesper-friis)</li> <li>Correct saving squashed ontology #719 (jesper-friis)</li> <li>Updated ontoconvert help #715 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v070-2024-01-26","title":"v0.7.0 (2024-01-26)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Ontology copy #711 (francescalb)</li> <li>Update save recursive and layout #710 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v063-2024-01-25","title":"v0.6.3 (2024-01-25)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Fix infinite recursion in directory layout #708 (jesper-friis)</li> <li>Ensure that saving with squash removes all but current ontology #707 (jesper-friis)</li> <li>Turned on directory layout tests for emmo and made them pytest #706 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v062-2024-01-23","title":"v0.6.2 (2024-01-23)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Allow controling ontology IRI when saving #700 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v061-2024-01-18","title":"v0.6.1 (2024-01-18)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>No tests for ontology.save #684</li> <li>Allow using HermiT from ontoconvert #664</li> <li>PrefLabel used by new_entity, and get_by_label even if it is not in the ontology #642</li> <li>ontology(imported=True) returns all classes in world #640</li> <li>excel2onto example doesn't come into the github pages documentation #626</li> <li>owlready2 &gt; 0.41 fails #624</li> <li>get_by_label and get_by_label all force add label_annotations #621</li> <li>hasPhysicalDimension convention has changed in EMMO-1.0.0-beta3 #347</li> </ul> <p>Merged pull requests:</p> <ul> <li>Avoid infinite recursion in set_common_prefix() #701 (jesper-friis)</li> <li>Updated the getattr patch #699 (jesper-friis)</li> <li>WIP: Fix issues with changed IRIs effecting test_excelparser #697 (jesper-friis)</li> <li>Added directory_layout() function #696 (jesper-friis)</li> <li>Added redirection checking tool #695 (jesper-friis)</li> <li>Add test save #686 (francescalb)</li> <li>Update test_unit_dimension in emmocheck to EMMO 1.0.0-beta5 #678 (jesper-friis)</li> <li>Skip checking dimensional units for domain ontologies that doesn't load this class. #677 (jesper-friis)</li> <li>HermiT is default reasoner. #671 (francescalb)</li> <li>Ci/dependabot updates #662 (francescalb)</li> <li>Updated emmocheck to new EMMO quantities and units #658 (jesper-friis)</li> <li>Update README.md #657 (jesper-friis)</li> <li>Corrected bug so that asking for entities in imported does not return all in world #655 (francescalb)</li> <li>Corrected get_by_label to use only labels in the ontology #643 (francescalb)</li> <li>Update to comply with owlready2&gt;0.41 #639 (francescalb)</li> <li>Ontodoc example in documentation #630 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v060-2023-06-19","title":"v0.6.0 (2023-06-19)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>pyparsing has been updated #629</li> </ul> <p>Merged pull requests:</p> <ul> <li>Check prefLabels in imported ontologies only if asked for. #628 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v054-2023-06-15","title":"v0.5.4 (2023-06-15)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v0532-2023-06-15","title":"v0.5.3.2 (2023-06-15)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>remove warnings_as_errors in cd workflow introduced in 0.5.3 #625 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v053-2023-06-12","title":"v0.5.3 (2023-06-12)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v0531-2023-06-12","title":"v0.5.3.1 (2023-06-12)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Extend new_entity to include properties #609</li> <li>Add support for Python 3.11 #599</li> <li>excelparser - enable object properties creation #587</li> <li>If there are altLabels that match, get_by_label_all returns only the prefLabels. #511</li> <li>excel2onto: implement other annotations #462</li> </ul> <p>Merged pull requests:</p> <ul> <li>default_annotations no longer forced in get_by_label #623 (francescalb)</li> <li>Updated documentation and excel sheet in example. #622 (francescalb)</li> <li>Flb/excel2onto properties #620 (francescalb)</li> <li>Fixed failing tests in test_patch.py #618 (jesper-friis)</li> <li>Add test for Python 3.11 and support it officially #615 (jesper-friis)</li> <li>Added doctest #614 (jesper-friis)</li> <li>Item access to classes #613 (jesper-friis)</li> <li>Change ontology.new_entity to also allow adding properties #610 (francescalb)</li> <li>Added DOI badge #606 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v052-2023-05-24","title":"v0.5.2 (2023-05-24)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Auto-merge dependabot PRs workflow invalid #566</li> </ul> <p>Closed issues:</p> <ul> <li>Point to excelparser api from the tools-page #593</li> <li>BUG: pytest - missing remote file /0.5.0/electrochemicalquantities / ontology #589</li> <li>Owlready 0.41 support ? #588</li> <li>Allow space in labels #583</li> <li>is_defined needs a better description  #563</li> <li>utils line 112 in get_iri_name link = \"{lowerlabel}\" vs \"{label}\" #562</li> <li>ontograph - update colour deafults #559</li> <li>ontograph - argument leafs should be leaves #558</li> <li>ontograph - write out more examples on how to use it #557</li> <li>ontograph --parents not working #556</li> <li>test_graph2 is failing  #555</li> <li>Add client side redirection in generated html documentation #552</li> <li>Typos in PR template #523</li> <li>ontograph, read format from name #497</li> <li>Harmonize get_descendants and get_ancestors #406</li> <li>Review default colours and style in ontopy/graph.py #345</li> </ul> <p>Merged pull requests:</p> <ul> <li>Add links to the original FaCT++ repo, GitHub profiles, etc. #600 (blokhin)</li> <li>Added test update to PR template. #598 (jesper-friis)</li> <li>Changed <code>is_defined</code> into a ThingClass property and improved its documentation. #597 (jesper-friis)</li> <li>Added link to excelparser from tools for documentation of excel sheet. #594 (francescalb)</li> <li>Bump SINTEF/ci-cd from 2.3.0 to 2.3.1 #584 (dependabot[bot])</li> <li>Updated get_by_label() so that it now accepts label, name and full iri #582 (jesper-friis)</li> <li>Added two additional exceptions to emmocheck #577 (jesper-friis)</li> <li>Bump SINTEF/ci-cd from 2.2.1 to 2.3.0 #575 (dependabot[bot])</li> <li>get_ancestors and get_descendants have the same arguments. #572 (francescalb)</li> <li>Bump SINTEF/ci-cd from 2.2.0 to 2.2.1 #571 (dependabot[bot])</li> <li>ontograph: colour updates, examples, bugfix #569 (francescalb)</li> <li>Bump SINTEF/ci-cd from 2.1.0 to 2.2.0 #567 (dependabot[bot])</li> <li>Changed argument leafs to leaves, with deprecation warning in ontograph #564 (francescalb)</li> <li>Corrected bug on getting default relation style. #561 (francescalb)</li> <li>Fix internal links in generated documentation generated with ontodoc #548 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v051-2023-02-07","title":"v0.5.1 (2023-02-07)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Use custom token for GitHub changelog generator #545</li> <li>Avoid using Azure mirror for APT packages #541</li> </ul> <p>Merged pull requests:</p> <ul> <li>Use SINTEF/ci-cd v2.1.0 in CI/CD workflows #546 (CasperWA)</li> <li>Revert version to v0.5.0 #544 (CasperWA)</li> <li>Fix ontodoc for bigmap #543 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v050-2023-02-06","title":"v0.5.0 (2023-02-06)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li><code>LegacyVersion</code> does not exist in <code>packaging.version</code> #540</li> <li>ontodoc: Expect <code>is_instance_of</code> property to be iterable #506</li> <li>Reinstate <code>images/material.png</code> #495</li> </ul> <p>Closed issues:</p> <ul> <li>Newest pylint (2.15.4) has intriduced some new rules. #534</li> <li>sync_attributes according to emmo convention regenerates a new iri even if it already has a valid one #525</li> <li>Remove dependency on LegacyVersion of packaging #514</li> <li>pytests are importing packaging 22.0 even though it is not allowed in requirements #513</li> <li>ontodoc: adding annotations that are not strings fail #510</li> <li>get_by_label_all only works after sync_attributes #502</li> <li>excel2onto: support updating ontology  #501</li> <li>excel2onto: allow to use prefLabel already in imported ontologies #500</li> <li>Drop Python 3.6 support - extend Python &gt;3.7 support #486</li> <li>Update pypi-release github action #482</li> <li>Make workflows dispatchable #481</li> <li>excel2onto: Read catalog file for imported ontology #474</li> <li>Give option to write_catalog for writing relative paths #473</li> <li>excel2onto: add choice of prefix for imported ontologies #467</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fix fixtures for Python3.7 #536 (CasperWA)</li> <li>Flb/fix to pylint2.15.4 #535 (francescalb)</li> <li>Bypass punning in ontodoc. #532 (francescalb)</li> <li>Added possibility to update ontology.  #527 (francescalb)</li> <li>Only generate new uuid if not already a valid one #526 (francescalb)</li> <li>Removed LegacyVersion from ontopy.utils #515 (francescalb)</li> <li>Added fix for adding annotations that are not strings in ontodoc #512 (francescalb)</li> <li>Do not trigger an emmocheck failure for ontologies with a foaf:logo annotation #509 (jesper-friis)</li> <li>New concepts allowed even if name alrady exists in imported ontologies #504 (francescalb)</li> <li>Corrected so that get_by_label_all also returns all concepts #503 (francescalb)</li> <li>Added correct material.png figure in tool-instructions #498 (francescalb)</li> <li>Updated logo #494 (jesper-friis)</li> <li>Makeover for CI/CD workflows, pre-commit &amp; MkDocs #485 (CasperWA)</li> <li>write catalog now writes relative paths per default #483 (francescalb)</li> <li>Setting prefix explicitly in excelparser #470 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v040-2022-10-04","title":"v0.4.0 (2022-10-04)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Update repo files with new repo name #479</li> <li>Pre-commit hook <code>bandit</code> failing #478</li> <li>Fix publish/release workflow #476</li> <li>excel2onto: not all relations are included in the generated ontology #457</li> <li>Unexpected behaviour of get_unabbreviated_triples()  #454</li> <li>Edge without label crash the graph creation #397</li> </ul> <p>Closed issues:</p> <ul> <li>excel2onto: restrictions does not allow for using \"emmo:hasProcessOutput some xx\" #464</li> <li>EMMO is updated to beta4, and now documentation fails #440</li> <li>some ObjectProperties from EMMO-beta-4.0 cause errors in OntoGraph #429</li> <li>Excelparser does not write catalog file correctly #421</li> <li>Add support for prefix #416</li> <li>Pre.commit failed with ontology.py #415</li> <li>visualization of EMMO based ontology #412</li> <li>Avoid infinite recursion when loading catalog file #369</li> <li>Excelparser: Automatize emmo-based? #335</li> <li>What are the applications of EMMO for materials informatics? #325</li> <li>Provide 'support' for same entities with different namespaces #128</li> <li>Remove deprecated emmo/ontograph.py that uses pydot #103</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update from 'EMMO-python' -&gt; 'EMMOntoPy' #477 (CasperWA)</li> <li>Allow for adding prefix in manchester notation. #469 (francescalb)</li> <li>Fixed issue with exel2onto: not all relations are included in the generated ontology #458 (jesper-friis)</li> <li>Added documentation of excel2onto #456 (jesper-friis)</li> <li>factpluspluswrapper README file #453 (jesper-friis)</li> <li>Improved get_unabbreviated_triples() #449 (jesper-friis)</li> <li>Fix loading in windows, url paths #446 (francescalb)</li> <li>Fixed reading web destinations defined in catalog #445 (francescalb)</li> <li>SUPPORT EMMO-beta4.0 #441 (francescalb)</li> <li>Support for userdefined prefixes #439 (francescalb)</li> <li>Flb/issue421 #438 (francescalb)</li> <li>Update demo #437 (jesper-friis)</li> <li>Silence false negative from pylint on github #436 (jesper-friis)</li> <li>Better error messages #435 (jesper-friis)</li> <li>Updated logo. #418 (jesper-friis)</li> <li>cytoscapegraph fails with missing edge labels #414 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v031-2022-05-08","title":"v0.3.1 (2022-05-08)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Fixed typo in ontoconvert #409 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v030-2022-05-05","title":"v0.3.0 (2022-05-05)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Documentation is currently not building #407</li> <li>Pytest is currently failing #384</li> <li>permission denied when working with temporary file #313</li> </ul> <p>Closed issues:</p> <ul> <li>Make get_descendants(levels=1) #403</li> <li>Add functionality for setting name part of IRI to prefLabel #398</li> <li>Generate excelsheet from ontology. #394</li> <li>Return a list of the concepts that are disregarded during when converting from excel with -force argument #393</li> <li>Demo - Broken ontology URLs #390</li> <li>Excelparser: how to handle entities that already exist in one of the imported ontologies? #334</li> </ul> <p>Merged pull requests:</p> <ul> <li>Updated docs python handler #408 (CasperWA)</li> <li>Flb/get descendants #405 (francescalb)</li> <li>Corrected expected number of returned arguments #404 (jesper-friis)</li> <li>Add functionality for setting name part of IRI to prefLabel #399 (jesper-friis)</li> <li>create_from_excel/pandas return as list of concepts that are worngly defined in the excelfile #396 (francescalb)</li> <li>Download EMMO from raw.github deirectly as redirection is broken #392 (francescalb)</li> <li>Workaround for failing test #385 (CasperWA)</li> <li>fix #313 remove handle #315 (sygout)</li> </ul>"},{"location":"CHANGELOG/#v020-2022-03-02","title":"v0.2.0 (2022-03-02)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>spaces before or after word in prefLabel makes excelparser fail #332</li> <li>Make EMMOntopy PyPi #268</li> <li>Use <code>pre-commit</code> #243</li> <li>Standard dunder/magic methods for <code>Ontology</code> #228</li> <li>Update code styling and linting #223</li> <li>Fix checking PR body &amp; improve error message in CD #318 (CasperWA)</li> </ul> <p>Fixed bugs:</p> <ul> <li>GH GraphQL type issue for auto-merge workflow #374</li> <li>Missing warning for excel parser relations and problem with \"nan\" #365</li> <li>Seting metadata in excelparser fails if there are no imported ontologies. #331</li> <li>Edge-case fails CD workflow for dependabot #319</li> <li>Ontodoc failing due to wrong <code>rdflib</code> import #306</li> <li>Overwriting <code>get_triples()</code> method #280</li> <li>OpenModel logo not loading in README #278</li> <li>Disable FOAF test as xmlns.com is down #276</li> </ul> <p>Closed issues:</p> <ul> <li>Use TEAM 4.0[bot] for GH Actions jobs #352</li> <li>_get_triples_spo take argumens s, and p, not subject and predicate #350</li> <li>Add --force to excelparser #333</li> <li>Cannot load ontology in Windows. #328</li> <li>make get_ontology accept 'PosixPath' #326</li> <li>Make EMMOntoPy baseexception and basewarning #321</li> <li>get_by_label crash  if not str #311</li> <li>make excel parser that creates and ontology from a filled excel file #302</li> <li>Check out how to get version of ontology #299</li> <li>Let ontology.new_entity acccept one or more parents directly #294</li> <li>Make ManchesterSyntaxParser that returns Owlready2 #293</li> <li>onto.new_entity should throw Error if label name consists of more than one word #290</li> <li>ReadTheDocs #288</li> <li>Add logo to README #287</li> <li>Write EMMO-python is deprecated and link to EMMOtopy on PyPi #269</li> <li>Consider MarkDown header styling #231</li> </ul> <p>Merged pull requests:</p> <ul> <li>Use <code>ID!</code> type instead of <code>String!</code> #375 (CasperWA)</li> <li>Avoided infinite recursion when loading catalog files that recursively #370 (jesper-friis)</li> <li>Warning relation excelparser #366 (sygout)</li> <li>Close temporary file before reading it #364 (jesper-friis)</li> <li>Ignore safety ID 44715 + add numpy dependency #361 (CasperWA)</li> <li>Use TEAM 4.0[bot] #353 (CasperWA)</li> <li>Changed arguments in _has_obj_triples_spo #351 (francescalb)</li> <li>Fix serialised ontology iri #341 (jesper-friis)</li> <li>Corrected parsing cardinality restrictions #340 (jesper-friis)</li> <li>When visualising restrictions, annotate the edges with the restriction type by default #339 (jesper-friis)</li> <li>Flb/update excel parser accroding to thermodynamics example #336 (francescalb)</li> <li>Added sconverting Posix to str in get_ontology #327 (francescalb)</li> <li>Added package specific base exception and base warning for EMMOntoPy #322 (francescalb)</li> <li>Added checking that label is string in get_by_label #312 (francescalb)</li> <li>Make excelparser that converts a filled excel sheet to an ontology #309 (francescalb)</li> <li>Fix ontoconvert rdflib import #307 (CasperWA)</li> <li>Check first versionIRI then versionInfo in ontology.get_version() #301 (francescalb)</li> <li>Removed .readthedocs.yml #298 (jesper-friis)</li> <li>Added support for evaluating Manchester expression to owlready2 #296 (jesper-friis)</li> <li>Added functionality for more than one parent in new_entity #295 (francescalb)</li> <li>Added test for label name length in ontology.new_entity #291 (francescalb)</li> <li>add logo to Readme and doc #289 (m-abdollahi)</li> <li>Improved representation of blank nodes #283 (jesper-friis)</li> <li>Update method name to avoid overwriting inherited #281 (CasperWA)</li> <li>Fixed link to OpenModel logo #279 (francescalb)</li> <li>Skip FOAF test #277 (CasperWA)</li> <li>Added Standard methods to Ontology #246 (francescalb)</li> <li>Implement <code>pre-commit</code> &amp; various tools #245 (CasperWA)</li> </ul>"},{"location":"CHANGELOG/#v013-2021-10-27","title":"v0.1.3 (2021-10-27)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v012-2021-10-27","title":"v0.1.2 (2021-10-27)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v011-2021-10-27","title":"v0.1.1 (2021-10-27)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v010-2021-10-27","title":"v0.1.0 (2021-10-27)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>\"Warning\" Importing from <code>collections</code> #236</li> </ul> <p>Fixed bugs:</p> <ul> <li>Loading ontologies that do not import skos fails #261</li> <li>Fix documentation build warnings #250</li> <li>Fix images in documentation #233</li> <li>Circular reference from Owlready2 #210</li> </ul> <p>Closed issues:</p> <ul> <li>Write up transfer from EMMOpython to EMMOntoPy i README.md #267</li> <li>Add test to emmocheck for upcoming EMMO #257</li> <li>Add packaging as dependency in requirements #255</li> <li>Add CI check for building documentation #244</li> <li>Add OpenModel as contributing project #237</li> <li>Update public documentation to new framework #234</li> <li>Automate documentation releases #232</li> <li>Update name of EMMO to Elemental Multiperspective Material Ontology #230</li> <li>Tidy up unittests #220</li> <li>Remove importability of sub-<code>factpluspluswrapper</code> folders #213</li> <li>Make function that automatically loads emmo #209</li> <li>Require rdflib&gt;5.0.0? #206</li> <li>change package name #205</li> <li>test_catalog fails because seraching for .owl in emmo/master #203</li> <li>Consider using <code>mike</code> for versioned documentation #197</li> <li>Add a test that checks that loading of non-EMMO based ontologies work - e.g. do not require skos:prefLabel #196</li> <li>Setup Materials for MkDocs framework #195</li> <li>Clean up demo, examples and docs #193</li> <li>Formalize review process with checklists #190</li> <li>funksjon ontology.add_class(label, parent)  #183</li> </ul> <p>Merged pull requests:</p> <ul> <li>Reset version to 0.1.0 #271 (CasperWA)</li> <li>Update README with PyPI and deprecation msgs #270 (CasperWA)</li> <li>Added option: EMMObased = False in ontology.load() #262 (francescalb)</li> <li>Added new test \"test_physical_quantity_dimension\" #258 (jesper-friis)</li> <li>Add <code>packaging</code> to list of requirements #256 (CasperWA)</li> <li>Fix MkDocs build warnings and CI job #254 (CasperWA)</li> <li>Update dependencies #252 (CasperWA)</li> <li>Add OpenModel contributing project #247 (francescalb)</li> <li>Automate documentation releases #242 (CasperWA)</li> <li>Import from <code>collections.abc</code> when possible #240 (CasperWA)</li> <li>Ensure all produced files from tests are in a temp dir #239 (CasperWA)</li> <li>Changed EMMO to be acronym for Elemental Multiperspective Material Ontology #238 (francescalb)</li> <li>Use width in img HTML #235 (CasperWA)</li> <li>Added function to load the emmo (the ontology) directly #226 (francescalb)</li> <li>Created pull request template #225 (francescalb)</li> <li>Setup new documentation framework #222 (CasperWA)</li> <li>Remove <code>__init__.py</code> files for FaCT++ wrapper (again) #221 (CasperWA)</li> <li>Unskip test as #210 has been resolved #218 (CasperWA)</li> <li>Remove sub-fact++ modules importability #217 (CasperWA)</li> <li>Update requirements #216 (CasperWA)</li> <li>Avoid using Owlready2 v0.34 #211 (CasperWA)</li> <li>Update package names #208 (CasperWA)</li> <li>Added function new_entitiy to ontology #207 (francescalb)</li> <li>ttl standard for emmo #204 (francescalb)</li> <li>Added choice for specifying namespace in get_by_label #202 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v101b-2021-07-01","title":"v1.0.1b (2021-07-01)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Correct updating of catalog in ontology.load #188</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update version to 1.0.1 #189 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v101-2021-07-01","title":"v1.0.1 (2021-07-01)","text":"<p>Full Changelog</p> <p>Fixed bugs:</p> <ul> <li>Windows paths are not handled properly #147</li> </ul> <p>Closed issues:</p> <ul> <li>Failing tests when lodaing battinfo #185</li> <li>Fix dependatbot to 'wider' #182</li> <li>Change to get_label instead of asstring in ontograph, emmodoc, ontodoc, be careful #158</li> <li>licence does not work with metadata #157</li> <li>ontograph with several roots fails #153</li> <li>fix redudant getlabel, get_preferred_label, get_label #152</li> <li>add --no-catalog and default as in emmocheck for ontograph #150</li> <li>make tests for checking upgrade of Owlready2 #137</li> <li>Add periodic_table to examples #130</li> <li>Add support for simple property-based ontology annotations like dcterms:license #129</li> <li>Update documentation of tools re reasoner #123</li> <li>Ontograph: Include multiple parents/inheritance #86</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed updating of catalog in load #187 (francescalb)</li> <li>Temporarily commented out loading ontologies with error in redirecting link on emmo.info #186 (francescalb)</li> <li>Changed dependabot to widen #181 (francescalb)</li> <li>Changed requirements to greater than #179 (francescalb)</li> <li>Owread2-0.32 not accepted die to error in owlready2 triplelite #178 (francescalb)</li> <li>Fixed import of defaultstyle in ontograph-tool #177 (francescalb)</li> <li>Updated pygments req to at least 2.7.4 because of high seq alert #168 (francescalb)</li> <li>Owlready requirement &gt;0.28 #167 (francescalb)</li> <li>WIP: Ipycytoscape #163 (francescalb)</li> <li>Made it possible to load other ontologies like foaf #162 (jesper-friis)</li> <li>Added get_label instead of asstring #160 (francescalb)</li> <li>Added write_catalog() #159 (jesper-friis)</li> <li>Periodic table example #156 (francescalb)</li> <li>Make one get label #154 (francescalb)</li> <li>Issue150 ontograph cannotload emmo inferred directly #151 (francescalb)</li> <li>Added Fact++ in tools documentation #149 (francescalb)</li> <li>Improved issue reporting in emmocheck #146 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-2021-03-25","title":"v1.0.0 (2021-03-25)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Use rdflib in Ontology.save() to support more file formats #143</li> <li>Tool for publishing domain ontologies #140</li> </ul> <p>Merged pull requests:</p> <ul> <li>Save to turtle and ontology annotations (via the metadata attribute) #144 (jesper-friis)</li> <li>Corrected configuration of exceptions for test_class_label test. #142 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-30-2021-03-18","title":"v1.0.0-alpha-30 (2021-03-18)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Load ontology #141 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-29-2021-03-16","title":"v1.0.0-alpha-29 (2021-03-16)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>Add Wu&amp;Palmer measure #134</li> </ul> <p>Closed issues:</p> <ul> <li>Convert-imported update in utils #138</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed reading xml as 'rdfxml' #139 (francescalb)</li> <li>Added wu_palmer_measure for semantic similarity #135 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-28-2021-03-09","title":"v1.0.0-alpha-28 (2021-03-09)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Also use the catalog file to map web URLs, not only local files. #109</li> <li>Check Error with Owlready2-0.26 #81</li> </ul> <p>Merged pull requests:</p> <ul> <li>Version updated for rel of v0.28 #133 (francescalb)</li> <li>Load ontology #131 (jesper-friis)</li> <li>Optimised label lookup in ontology and dir listing. It is now much faster #127 (jesper-friis)</li> <li>Use catalog by default #126 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-27-2021-02-27","title":"v1.0.0-alpha-27 (2021-02-27)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Ontodoc #125 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-26-2021-02-26","title":"v1.0.0-alpha-26 (2021-02-26)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Make fact++ reasoner available and default in tools #122</li> <li>Use PyPI token in publish workflow #118</li> <li>Update publish workflow #115</li> <li>do something #108</li> </ul> <p>Merged pull requests:</p> <ul> <li>Added functionality to document domain ontologies #124 (jesper-friis)</li> <li>Made ontoconvert and ontograph tools executable in linux #120 (jesper-friis)</li> <li>Update CI  #119 (CasperWA)</li> <li>Update publish workflow + add dependabot #116 (CasperWA)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-25-2021-01-17","title":"v1.0.0-alpha-25 (2021-01-17)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Update Dockerfile to install correct pandoc #99</li> <li>Correct turtle serialisation #97</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update emmocheck exceptions #113 (jesper-friis)</li> <li>Fix recursion in graph #112 (jesper-friis)</li> <li>Avoid unnessesary/infinite recursion in get_imported_ontologies() #111 (jesper-friis)</li> <li>Break recursion error in get_by_label() #110 (jesper-friis)</li> <li>Updated the Ontology.sync_attributes() method. #107 (jesper-friis)</li> <li>Updated pandoc req in Dockerfile #106 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-24-2021-01-04","title":"v1.0.0-alpha-24 (2021-01-04)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Bumped version number up to 1.0.0-alpha-24  #105 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-23-2021-01-04","title":"v1.0.0-alpha-23 (2021-01-04)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Fix loading imported ttl from web such that emmocheck works for crystallography.ttl #98</li> <li>Add reasoning with FaCT++ #95</li> <li>Correctly load ontologies like crystallography that imports both local and online sub-ontologies #91</li> <li>Fix flake8 errors #88</li> <li>Remove the .ttl namespace when loading domain-crystallography in EMMO-python #83</li> <li>Add option of documenting imported ontologies in ontodoc and ontograph #82</li> <li>Emmocheck fails if Physicaluantities and MeaurementsUnits are not imported from emmo. Make sure that it does not fail if whole of EMMO is not imported. #80</li> <li>Ontograph: Make default root #79</li> <li>Ontodoc: PDF is not generated, produces error. #76</li> <li>AttributeError from ontodoc #70</li> <li>Import emmo .ttl from emmo-repo.github.io #69</li> <li>Unable to use the vertical interoperability demo .py files #66</li> </ul> <p>Merged pull requests:</p> <ul> <li>Release 1.0.0-alpha-23 #104 (jesper-friis)</li> <li>Allow to load turtle ontologies without catalog file. #102 (jesper-friis)</li> <li>Updated README file #100 (jesper-friis)</li> <li>Changed the sync_reasoner() method to use FaCT++ as the default reasoner #94 (jesper-friis)</li> <li>Add reasoning #93 (jesper-friis)</li> <li>Improve load ontologies #92 (jesper-friis)</li> <li>Remove the '.ttl' in namespace names by monkey patching owlready2.Namespace #90 (jesper-friis)</li> <li>Fix flake8 warnings #89 (jesper-friis)</li> <li>Ontodoc pdf #87 (jesper-friis)</li> <li>Automatically find roots in ontograph  #85 (francescalb)</li> <li>Automatic import of ttl from GitHub emmo-repo.io #84 (francescalb)</li> <li>Fixes needed for access ontologies #77 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-22-2020-12-21","title":"v1.0.0-alpha-22 (2020-12-21)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Loading ttl both locally and importing from iri #75 (francescalb)</li> <li>Added sync_python_names() and corrected handling of individuals in sync_attributes() #73 (jesper-friis)</li> <li>Add preflabel to individuals declared in python #72 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-21b-2020-12-13","title":"v1.0.0-alpha-21b (2020-12-13)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Fix bug introduced in ontoconvert #71 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-21-2020-12-11","title":"v1.0.0-alpha-21 (2020-12-11)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Use rdflib to load non-supported formats. #68 (jesper-friis)</li> <li>Added a quick fix for vertical demo. #67 (jesper-friis)</li> <li>Updated emmocheck to new 1.0.0-beta. Old version should still work. #65 (jesper-friis)</li> <li>Added ontoconvert tool #64 (jesper-friis)</li> <li>Improved error messages for classes that doesn't define prefLabel #63 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-20b-2020-11-04","title":"v1.0.0-alpha-20b (2020-11-04)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Version1.0.0 alpha20 #62 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-20-2020-11-04","title":"v1.0.0-alpha-20 (2020-11-04)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Improve support for imported ontologies #61 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-19-2020-11-02","title":"v1.0.0-alpha-19 (2020-11-02)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added --ignore-namespace to emmocheck  #60 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-18-2020-10-29","title":"v1.0.0-alpha-18 (2020-10-29)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Bumped up version number to 1.0.0-alpha-18 #59 (jesper-friis)</li> <li>Added option url_from_catalog to ontology.load() #58 (jesper-friis)</li> <li>Added get_preferred_label() method to classes, properties and individuals #57 (jesper-friis)</li> <li>Correct default IRI to inferred ontology #56 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-17-2020-10-21","title":"v1.0.0-alpha-17 (2020-10-21)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added materials.EngineeredMaterial to namespace exception in emmocheck #55 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-16-2020-10-20","title":"v1.0.0-alpha-16 (2020-10-20)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Include all annotations in .get_annotations() #50</li> </ul> <p>Merged pull requests:</p> <ul> <li>Update to v1.0.0-alpha-16 for new release #54 (francescalb)</li> <li>Update dimensionality checks #53 (jesper-friis)</li> <li>Updated to say that pypi realese is automatic in docs #52 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-15-2020-09-25","title":"v1.0.0-alpha-15 (2020-09-25)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added all labels in get_class_annotations in emmo/patch.py including #51 (francescalb)</li> <li>Support use of skos:prefLabel instead of rdfs:label #49 (jesper-friis)</li> <li>v1.0.0-alpha-14  #48 (jesper-friis)</li> <li>Fix emmocheck to not fail upon use of dcterms and skos #47 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-13-2020-09-19","title":"v1.0.0-alpha-13 (2020-09-19)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Not immediately installable with pip #45</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fix setup #46 (jesper-friis)</li> <li>Make emmo package pip installable in fresh env #44 (CasperWA)</li> <li>Update emmodoc to latest version of emmo-alpha2 #43 (jesper-friis)</li> <li>Ensure that emmocheck exit with non-zero return value if a test is faing #42 (jesper-friis)</li> <li>Installed missing dependencies in pythonpublish deployment workflow #41 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-11-2020-08-12","title":"v1.0.0-alpha-11 (2020-08-12)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Add skip option to emmocheck #40 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-10-2020-04-27","title":"v1.0.0-alpha-10 (2020-04-27)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>Added exceptions to emmocheck \"test_number_of_labels\" #39 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-9-2020-04-13","title":"v1.0.0-alpha-9 (2020-04-13)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Enhance ontology.sync_attributes() to also update class names #10</li> <li>Add support for the FaCT++ reasoner #9</li> </ul> <p>Merged pull requests:</p> <ul> <li>Set new release version 1.0.0-alpha-9 #38 (francescalb)</li> <li>Added get_version() and set_version() methods to emmo.Ontology. #37 (jesper-friis)</li> <li>Updated example in README file to current version of EMMO. #36 (jesper-friis)</li> <li>Update tools #35 (jesper-friis)</li> <li>Updated simplifed demo_vertical in compliance with EMMO-1.0.0alpha2 as of 202\u2026 #34 (francescalb)</li> <li>Fixed PyPI badge in README #33 (jesper-friis)</li> <li>Update emmocheck #32 (jesper-friis)</li> <li>Sync attributes #31 (jesper-friis)</li> <li>Cleanup ci workflow #28 (jesper-friis)</li> <li>Added ontoversion tool #27 (jesper-friis)</li> <li>Update emmodoc #25 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-8-2020-03-22","title":"v1.0.0-alpha-8 (2020-03-22)","text":"<p>Full Changelog</p> <p>Merged pull requests:</p> <ul> <li>1.0.0 alpha 8 #30 (jesper-friis)</li> <li>Updated requirements such that \"pip install EMMO\" works #24 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-5-2020-03-18","title":"v1.0.0-alpha-5 (2020-03-18)","text":"<p>Full Changelog</p> <p>Implemented enhancements:</p> <ul> <li>Make EMMO-python available on pypi (installable with pip) #7</li> </ul> <p>Merged pull requests:</p> <ul> <li>Bumbed up version to 1.0.0-alpha-5 #23 (jesper-friis)</li> <li>Emmocheck #22 (jesper-friis)</li> <li>Reworked the generation of graphs - using the graphviz Python package #21 (jesper-friis)</li> <li>1.0.0 #19 (jesper-friis)</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-3-2020-02-16","title":"v1.0.0-alpha-3 (2020-02-16)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v100-alpha-2-2020-01-11","title":"v1.0.0-alpha-2 (2020-01-11)","text":"<p>Full Changelog</p>"},{"location":"CHANGELOG/#v100-alpha-1-2020-01-11","title":"v1.0.0-alpha-1 (2020-01-11)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Missing https://emmc.info/emmo-inferred #16</li> <li>setup.py #15</li> <li>Fix emmodoc #6</li> </ul>"},{"location":"CHANGELOG/#v100-alpha-2020-01-08","title":"v1.0.0-alpha (2020-01-08)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Update the user case ontology #3</li> </ul> <p>Merged pull requests:</p> <ul> <li>Fixed a typo in the title #14 (blokhin)</li> <li>Fixed #5 - homogenised call to reasoner #13 (francescalb)</li> </ul>"},{"location":"CHANGELOG/#v099-2019-07-14","title":"v0.9.9 (2019-07-14)","text":"<p>Full Changelog</p> <p>Closed issues:</p> <ul> <li>Homogenise call to reasoner in emmo.Ontology.sync_reasoner() #5</li> </ul> <p>Merged pull requests:</p> <ul> <li>#3 update usercase ontology #12 (jesper-friis)</li> <li>Fixed 3 #8 (jesper-friis)</li> <li>Dockerdevel #2 (francescalb)</li> <li>Fix by lukas #1 (jesper-friis)</li> </ul> <p>* This Changelog was automatically generated by github_changelog_generator</p>"},{"location":"LICENSE/","title":"LICENSE","text":"<p>Copyright 2019-2022 SINTEF</p> <p>Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:</p> <ol> <li> <p>Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.</p> </li> <li> <p>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.</p> </li> <li> <p>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.</p> </li> </ol> <p>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.</p>"},{"location":"docker-instructions/","title":"EMMOntoPy Docker","text":""},{"location":"docker-instructions/#clone-project","title":"Clone project","text":"<pre><code>git clone git@github.com:emmo-repo/EMMOntoPy.git\n</code></pre>"},{"location":"docker-instructions/#build-docker-image","title":"Build Docker image","text":"<pre><code>cd EMMOntoPy\ndocker build -t emmo .\n</code></pre>"},{"location":"docker-instructions/#run-docker-container","title":"Run Docker container","text":"<pre><code>docker run -it emmo\n</code></pre>"},{"location":"docker-instructions/#notes","title":"Notes","text":"<ul> <li>Your Docker container may run out of memory while executing the HermiT reasoner (<code>sync_reasoner</code>).   Append <code>--memory=2GB</code> to <code>docker run</code> in order to align the memory limit with the Java runtime environment.</li> </ul> <p>It is recommended to instead use the FaCT++ reaonser (now default).</p> <ul> <li>Uncomment the last line in the Dockerfile, if you wish to start directly in the Python interpreter.</li> </ul>"},{"location":"docker-instructions/#dockerfile-for-mounting-emmontopy-as-volume-mountdockerfile","title":"Dockerfile for mounting EMMOntoPy as volume (mount.Dockerfile)","text":""},{"location":"docker-instructions/#build-docker-image-mountdockerfile","title":"Build Docker image (mount.DockerFile)","text":"<pre><code>docker build -t emmomount -f mount.Dockerfile .\n</code></pre>"},{"location":"docker-instructions/#run-docker-container-mountdockerfile","title":"Run Docker container (mount.Dockerfile)","text":"<p>In a unix terminal (Linux)</p> <pre><code>docker run --rm -it -v $(pwd):/home/user/EMMOntoPy emmomount\n</code></pre> <p>In PowerShell (Windows 10):</p> <pre><code>docker run --rm -it -v ${PWD}:/home/user/EMMOntoPy emmomount\n</code></pre> <p>To install EMMOntoPy package inside container:</p> <pre><code>cd EMMOntoPy\npip install .\n</code></pre>"},{"location":"docker-instructions/#notes-on-mounting-on-windows","title":"Notes on mounting on Windows","text":"<ul> <li> <p>Allow for mounting of C: in Docker (as administrator).   Docker (rightclick in system tray) -&gt; Settings -&gt; Shared Drives -&gt; tick of C -&gt; Apply.</p> </li> <li> <p>Run the following command in PowerShell:</p> </li> </ul> <pre><code>Set-NetConnectionProfile -interfacealias \"vEthernet (DockerNAT)\" -NetworkCategory Private\n</code></pre> <ul> <li>If mounting does not succeed Reset Credentials (Docker -&gt; Settings -&gt; Shared Drives)  and repeat the steps above.</li> </ul>"},{"location":"tools-instructions/","title":"Instructions for tools available in EMMOntoPy","text":"<p>Content:</p> <ul> <li>emmocheck</li> <li>ontoversion</li> <li>ontograph</li> <li>ontodoc</li> <li>ontoconvert</li> <li>excel2onto</li> </ul>"},{"location":"tools-instructions/#emmocheck","title":"<code>emmocheck</code>","text":"<p>Tool for checking that ontologies conform to EMMO conventions.</p>"},{"location":"tools-instructions/#usage","title":"Usage","text":"<pre><code>emmocheck [options] iri\n</code></pre>"},{"location":"tools-instructions/#options","title":"Options","text":"<pre><code>positional arguments:\n  iri                   File name or URI to the ontology to test.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --database FILENAME, -d FILENAME\n                        Load ontology from Owlready2 sqlite3 database. The\n                        `iri` argument should in this case be the IRI of the\n                        ontology you want to check.\n  --local, -l           Load imported ontologies locally. Their paths are\n                        specified in Prot\u00e9g\u00e9 catalog files or via the --path\n                        option. The IRI should be a file name.\n  --catalog-file CATALOG_FILE\n                        Name of Prot\u00e9g\u00e9 catalog file in the same folder as the\n                        ontology. This option is used together with --local\n                        and defaults to \"catalog-v001.xml\".\n  --path PATH           Paths where imported ontologies can be found. May be\n                        provided as a comma-separated string and/or with\n                        multiple --path options.\n  --check-imported, -i  Whether to check imported ontologies.\n  --verbose, -v         Verbosity level.\n  --configfile CONFIGFILE, -c CONFIGFILE\n                        A yaml file with additional test configurations.\n  --skip, -s ShellPattern\n            Shell pattern matching tests to skip.  This option may be\n                        provided multiple times.\n  --url-from-catalog, -u\n      Get url from catalog file.\n  --ignore-namespace, -n\n                        Namespace to be ignored. Can be given multiple times\n</code></pre>"},{"location":"tools-instructions/#examples","title":"Examples","text":"<pre><code>    emmocheck http://emmo.info/emmo/1.0.0-alpha2\n    emmocheck --database demo.sqlite3 http://www.emmc.info/emmc-csa/demo#\n    emmocheck -l emmo.owl (in folder to which emmo was downloaded locally)\n    emmocheck --check-imported --ignore-namespace=physicalistic --verbose --url-from-catalog emmo.owl (in folder with downloaded EMMO)\n    emmocheck --check-imported --local --url-from-catalog --skip test_namespace emmo.owl\n</code></pre>"},{"location":"tools-instructions/#example-configuration-file","title":"Example configuration file","text":"<p>Example of YAML configuration file provided with the <code>--configfile</code> option that will omit <code>myunits.MyUnitCategory1</code> and <code>myunits.MyUnitCategory1</code> from the unit dimensions test.</p> <pre><code>test_unit_dimensions:\n  exceptions:\n    - myunits.MyUnitCategory1\n    - myunits.MyUnitCategory2\n</code></pre>"},{"location":"tools-instructions/#ontoversion","title":"<code>ontoversion</code>","text":"<p>Prints version of an ontology to standard output.</p> <p>This script uses RDFLib and the versionIRI tag of the ontology to infer the version.</p>"},{"location":"tools-instructions/#usage_1","title":"Usage","text":"<pre><code>ontoversion [options] iri\n</code></pre>"},{"location":"tools-instructions/#special-dependencies","title":"Special dependencies","text":"<ul> <li><code>rdflib</code> (Python package)</li> </ul>"},{"location":"tools-instructions/#options_1","title":"Options","text":"<pre><code>positional arguments:\n  IRI                   IRI/file to OWL source to extract the version from.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --format FORMAT, -f FORMAT\n                        OWL format. Default is \"xml\".\n</code></pre>"},{"location":"tools-instructions/#examples_1","title":"Examples","text":"<pre><code>ontoversion http://emmo.info/emmo/1.0.0-alpha\n</code></pre> <p>Warning</p> <p>Fails if ontology has no versionIRI tag.</p>"},{"location":"tools-instructions/#ontograph","title":"<code>ontograph</code>","text":"<p>Tool for visualizing ontologies.</p>"},{"location":"tools-instructions/#usage_2","title":"Usage","text":"<pre><code>ontograph [options] iri [output]\n</code></pre>"},{"location":"tools-instructions/#dependencies","title":"Dependencies","text":"<ul> <li>Graphviz</li> </ul>"},{"location":"tools-instructions/#options_2","title":"Options","text":"<pre><code>positional arguments:\n  IRI                   File name or URI of the ontology to visualise.\n  output                name of output file.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --format FORMAT, -f FORMAT\n                        Format of output file. By default it is inferred from\n                        the output file extension.\n  --database FILENAME, -d FILENAME\n                        Load ontology from Owlready2 sqlite3 database. The\n                        `iri` argument should in this case be the IRI of the\n                        ontology you want to visualise.\n  --local, -l           Load imported ontologies locally. Their paths are\n                        specified in Prot\u00e9g\u00e9 catalog files or via the --path\n                        option. The IRI should be a file name.\n  --catalog-file CATALOG_FILE\n                        Name of Prot\u00e9g\u00e9 catalog file in the same folder as the\n                        ontology. This option is used together with --local\n                        and defaults to \"catalog-v001.xml\".\n  --path PATH           Paths where imported ontologies can be found. May be\n                        provided as a comma-separated string and/or with\n                        multiple --path options.\n  --reasoner [{FaCT++,HermiT,Pellet}]\n                        Run given reasoner on the ontology. Valid reasoners\n                        are \"FaCT++\" (default), \"HermiT\" and \"Pellet\".\n                        Note: FaCT++ is preferred with EMMO.\n  --root ROOT, -r ROOT  Name of root node in the graph. Defaults to all\n                        classes.\n  --leaves LEAVES       Leaf nodes for plotting sub-graphs. May be provided\n                        as a comma-separated string and/or with multiple\n                        --leaves options.\n  --exclude EXCLUDE, -E EXCLUDE\n                        Nodes, including their subclasses, to exclude from\n                        sub-graphs. May be provided as a comma-separated\n                        string and/or with multiple --exclude options.\n  --parents N, -p N     Adds N levels of parents to graph.\n  --relations RELATIONS, -R RELATIONS\n                        Comma-separated string of relations to visualise.\n                        Default is \"isA\". \"all\" means include all relations.\n  --edgelabels, -e      Whether to add labels to edges.\n  --addnodes, -n        Whether to add missing target nodes in relations.\n  --addconstructs, -c   Whether to add nodes representing class constructs.\n  --rankdir {BT,TB,RL,LR}\n                        Graph direction (from leaves to root). Possible values\n                        are: \"BT\" (bottom-top, default), \"TB\" (top-bottom),\n                        \"RL\" (right-left) and \"LR\" (left-right).\n  --style-file JSON_FILE, -s JSON_FILE\n                        A json file with style definitions.\n  --legend, -L          Whether to add a legend to the graph.\n  --generate-style-file JSON_FILE, -S JSON_FILE\n                        Write default style file to a json file.\n  --plot-modules, -m    Whether to plot module inter-dependencies instead of\n                        their content.\n  --display, -D         Whether to display graph.\n</code></pre>"},{"location":"tools-instructions/#examples_2","title":"Examples","text":"<p><pre><code>ontograph --relations=all --legend --format=pdf emmo-inferred emmo.pdf # complete ontology\nontograph --root=Holistic --relations=hasInput,hasOutput,hasTemporaryParticipant,hasAgent --parents=2 --legend --leaves=Measurement,Manufacturing,CompleteManufacturing,ManufacturedProduct,CommercialProduct,Manufacturer --format=png --exclude=Task,Workflow,Computation,MaterialTreatment emmo-inferred measurement.png\nontograph --root=Material --relations=all --legend --format=png emmo-inferred material.png\n</code></pre> The figure below is generated with the last command in the list above. </p>"},{"location":"tools-instructions/#ontodoc","title":"<code>ontodoc</code>","text":"<p>Tool for documenting ontologies.</p>"},{"location":"tools-instructions/#usage_3","title":"Usage","text":"<pre><code>ontodoc [options] iri outfile\n</code></pre>"},{"location":"tools-instructions/#dependencies_1","title":"Dependencies","text":"<ul> <li>pandoc</li> <li>pdflatex or xelatex</li> </ul>"},{"location":"tools-instructions/#options_3","title":"Options","text":"<pre><code>positional arguments:\n  IRI                   File name or URI of the ontology to document.\n  OUTFILE               Output file.\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --database FILENAME, -d FILENAME\n                            Load ontology from Owlready2 sqlite3 database. The\n                            `iri` argument should in this case be the IRI of the\n                            ontology you want to document.\n      --local, -l           Load imported ontologies locally. Their paths are\n                            specified in Prot\u00e9g\u00e9 catalog files or via the --path\n                            option. The IRI should be a file name.\n      --imported, -i        Include imported ontologies\n      --no-catalog, -n      Do not read url from catalog even if it exists.\n      --catalog-file CATALOG_FILE\n                            Name of Prot\u00e9g\u00e9 catalog file in the same folder as the\n                            ontology. This option is used together with --local\n                            and defaults to \"catalog-v001.xml\".\n      --path PATH           Paths where imported ontologies can be found. May be\n                            provided as a comma-separated string and/or with\n                            multiple --path options.\n      --reasoner [{FaCT++,HermiT,Pellet}]\n                            Run given reasoner on the ontology. Valid reasoners\n                            are \"FaCT++\" (default), \"HermiT\" and \"Pellet\".\n                            Note: FaCT++ is preferred with EMMO.\n      --template FILE, -t FILE\n                            ontodoc input template. If not provided, a simple\n                            default template will be used. Don't confuse it with\n                            the pandoc templates.\n      --format FORMAT, -f FORMAT\n                            Output format. May be \"md\", \"simple-html\" or any other\n                            format supported by pandoc. By default the format is\n                            inferred from --output.\n      --figdir DIR, -D DIR  Default directory to store generated figures. If a\n                            relative path is given, it is relative to the template\n                            (see --template), or the current directory, if\n                            --template is not given. Default: \"genfigs\"\n      --figformat FIGFORMAT, -F FIGFORMAT\n                            Format for generated figures. The default is inferred\n                            from --format.\"\n      --max-figwidth MAX_FIGWIDTH, -w MAX_FIGWIDTH\n                            Maximum figure width. The default is inferred from\n                            --format.\n      --pandoc-option STRING, -p STRING\n                            Additional pandoc long options overriding those read\n                            from --pandoc-option-file. It is possible to remove\n                            pandoc option --XXX with \"--pandoc-option=no-XXX\".\n                            This option may be provided multiple times.\n      --pandoc-option-file FILE, -P FILE\n                            YAML file with additional pandoc options. Note, that\n                            default pandoc options are read from the files\n                            \"pandoc-options.yaml\" and \"pandoc-FORMAT-options.yaml\"\n                            (where FORMAT is format specified with --format). This\n                            option allows to override the defaults and add\n                            additional pandoc options. This option may be provided\n                            multiple times.\n      --keep-generated FILE, -k FILE\n                            Keep a copy of generated markdown input file for\n                            pandoc (for debugging).\n</code></pre>"},{"location":"tools-instructions/#examples_3","title":"Examples","text":"<p>Basic documentation of an ontology <code>demo.owl</code> can be generated with:</p> <pre><code>ontodoc --format=simple-html --local demo.owl demo.html\n</code></pre> <p>See examples/emmodoc/README.md for how this tool is used to generate the html and pdf documentation of EMMO itself.</p>"},{"location":"tools-instructions/#ontoconvert","title":"<code>ontoconvert</code>","text":"<p>Tool for converting between different ontology formats.</p>"},{"location":"tools-instructions/#usage_4","title":"Usage","text":"<pre><code>ontoconvert [options] inputfile outputfile\n</code></pre>"},{"location":"tools-instructions/#dependencies_2","title":"Dependencies","text":"<ul> <li><code>rdflib</code> (Python package)</li> </ul>"},{"location":"tools-instructions/#options_4","title":"Options","text":"<pre><code>positional arguments:\n  INPUTFILE              Name of inputfile.\n  OUTPUTFILE             Name og output file.\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --input-format, -f INPUT_FORMAT\n                            Inputformat. Default is to infer from input.\n      --output-format, -F OUTPUT_FORMAT\n                            Default is to infer from output.\n      --no-catalog, -n      Do not read catalog even if it exists.\n      --inferred, -i        Add additional relations inferred by the FaCT++ reasoner to the converted ontology. Implies --squash.\n      --base-iri BASE_IRI, -b BASE_IRI\n                            Base iri of inferred ontology. The default is the base\n                            iri of the input ontology with \"-inferred\" appended to\n                            it. Used together with --inferred.\n\n      --recursive, -r       The output is written to the directories matching the input. This requires Protege catalog files to be present.\n      --squash, -s          Squash imported ontologies into a single output file.\n</code></pre>"},{"location":"tools-instructions/#examples_4","title":"Examples","text":"<pre><code>ontoconvert --recursive emmo.ttl owl/emmo.owl\nontoconvert --inferred emmo.ttl emmo-inferred.owl\n</code></pre> <p>Note, it is then required to add the argument <code>only_local=True</code> when loading the locally converted ontology in EMMOntoPy, e.g.:</p> <pre><code>from ontopy import get_ontology\n\nemmo_ontology = get_ontology(\"emmo.owl\").load(only_local=True)\n</code></pre> <p>Since the catalog file will be overwritten in the above example writing output to a separate directory is useful.</p> <pre><code>ontoconvert --recursive emmo.ttl owl/emmo.owl\n</code></pre>"},{"location":"tools-instructions/#bugs","title":"Bugs","text":"<p>Since parsing the results from the reasoner is currently broken in Owlready2 (v0.37), a workaround has been added to ontoconvert. This workaround only only supports FaCT++.  Hence, HermiT and Pellet are currently not available.</p>"},{"location":"tools-instructions/#excel2onto","title":"<code>excel2onto</code>","text":"<p>Tool for converting EMMO-based ontologies from Excel to OWL, making it easy for non-ontologists to make EMMO-based domain ontologies.</p> <p>The Excel file must be in the format provided by ontology_template.xlsx.</p>"},{"location":"tools-instructions/#usage_5","title":"Usage","text":"<pre><code>excel2onto [options] excelpath\n</code></pre>"},{"location":"tools-instructions/#dependencies_3","title":"Dependencies","text":"<ul> <li><code>pandas</code> (Python package)</li> </ul>"},{"location":"tools-instructions/#options_5","title":"Options","text":"<pre><code>positional arguments:\n  excelpath             path to excel book\n\noptions:\n  -h, --help            show this help message and exit\n  --output OUTPUT, -o OUTPUT\n                        Name of output ontology, \u00b4ontology.ttl\u00b4 is default\n  --force, -f           Whether to force generation of ontology on non-fatal\n                        error.\n</code></pre> <p>See the documentation of the python api for a thorough description of the requirements on the Excel workbook.</p>"},{"location":"tools-instructions/#examples_5","title":"Examples","text":"<p>Create a <code>new_ontology.ttl</code> turtle file from the Excel file <code>new_ontology.xlsx</code>: <pre><code>excel2onto -o new_ontology.ttl new_ontology.xlsx\n</code></pre></p>"},{"location":"tools-instructions/#bugs_1","title":"Bugs","text":"<p><code>equivalentTo</code> is currently not supported.</p>"},{"location":"api_reference/emmopy/emmocheck/","title":"emmocheck","text":"<p>A module for testing an ontology against conventions defined for EMMO.</p> <p>A YAML file can be provided with additional test configurations.</p> <p>Example configuration file:</p> <pre><code>test_unit_dimensions:\n  exceptions:\n    - myunits.MyUnitCategory1\n    - myunits.MyUnitCategory2\n\nskip:\n  - name_of_test_to_skip\n\nenable:\n  - name_of_test_to_enable\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestEMMOConventions","title":"<code> TestEMMOConventions        </code>","text":"<p>Base class for testing an ontology against EMMO conventions.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>class TestEMMOConventions(unittest.TestCase):\n    \"\"\"Base class for testing an ontology against EMMO conventions.\"\"\"\n\n    config = {}  # configurations\n\n    def get_config(self, string, default=None):\n        \"\"\"Returns the configuration specified by `string`.\n\n        If configuration is not found in the configuration file, `default` is\n        returned.\n\n        Sub-configurations can be accessed by separating the components with\n        dots, like \"test_namespace.exceptions\".\n        \"\"\"\n        result = self.config\n        try:\n            for token in string.split(\".\"):\n                result = result[token]\n        except KeyError:\n            return default\n        return result\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestEMMOConventions.get_config","title":"<code>get_config(self, string, default=None)</code>","text":"<p>Returns the configuration specified by <code>string</code>.</p> <p>If configuration is not found in the configuration file, <code>default</code> is returned.</p> <p>Sub-configurations can be accessed by separating the components with dots, like \"test_namespace.exceptions\".</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def get_config(self, string, default=None):\n    \"\"\"Returns the configuration specified by `string`.\n\n    If configuration is not found in the configuration file, `default` is\n    returned.\n\n    Sub-configurations can be accessed by separating the components with\n    dots, like \"test_namespace.exceptions\".\n    \"\"\"\n    result = self.config\n    try:\n        for token in string.split(\".\"):\n            result = result[token]\n    except KeyError:\n        return default\n    return result\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions","title":"<code> TestFunctionalEMMOConventions        </code>","text":"<p>Test functional EMMO conventions.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>class TestFunctionalEMMOConventions(TestEMMOConventions):\n    \"\"\"Test functional EMMO conventions.\"\"\"\n\n    def test_unit_dimension(self):\n        \"\"\"Check that all measurement units have a physical dimension.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n        \"\"\"\n        exceptions = set(\n            (\n                \"metrology.MultipleUnit\",\n                \"metrology.SubMultipleUnit\",\n                \"metrology.OffSystemUnit\",\n                \"metrology.PrefixedUnit\",\n                \"metrology.NonPrefixedUnit\",\n                \"metrology.SpecialUnit\",\n                \"metrology.DerivedUnit\",\n                \"metrology.BaseUnit\",\n                \"metrology.UnitSymbol\",\n                \"siunits.SICoherentDerivedUnit\",\n                \"siunits.SINonCoherentDerivedUnit\",\n                \"siunits.SISpecialUnit\",\n                \"siunits.SICoherentUnit\",\n                \"siunits.SIPrefixedUnit\",\n                \"siunits.SIBaseUnit\",\n                \"siunits.SIUnitSymbol\",\n                \"siunits.SIUnit\",\n                \"emmo.MultipleUnit\",\n                \"emmo.SubMultipleUnit\",\n                \"emmo.OffSystemUnit\",\n                \"emmo.PrefixedUnit\",\n                \"emmo.NonPrefixedUnit\",\n                \"emmo.SpecialUnit\",\n                \"emmo.DerivedUnit\",\n                \"emmo.BaseUnit\",\n                \"emmo.UnitSymbol\",\n                \"emmo.SIAccepted\",\n                \"emmo.SICoherentDerivedUnit\",\n                \"emmo.SINonCoherentDerivedUnit\",\n                \"emmo.SISpecialUnit\",\n                \"emmo.SICoherentUnit\",\n                \"emmo.SIPrefixedUnit\",\n                \"emmo.SIBaseUnit\",\n                \"emmo.SIUnitSymbol\",\n                \"emmo.SIUnit\",\n            )\n        )\n        if not hasattr(self.onto, \"MeasurementUnit\"):\n            return\n        exceptions.update(self.get_config(\"test_unit_dimension.exceptions\", ()))\n        regex = re.compile(r\"^(emmo|metrology).hasDimensionString.value\\(.*\\)$\")\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.MeasurementUnit.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            # Assume that actual units are not subclassed\n            if not list(cls.subclasses()) and repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    self.assertTrue(\n                        any(\n                            regex.match(repr(r))\n                            for r in cls.get_indirect_is_a()\n                        ),\n                        msg=cls,\n                    )\n\n    def test_quantity_dimension_beta3(self):\n        \"\"\"Check that all quantities have a physicalDimension annotation.\n\n        Note: this test will be deprecated when isq is moved to emmo/domain.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n        \"\"\"\n        exceptions = set(\n            (\n                \"properties.ModelledQuantitativeProperty\",\n                \"properties.MeasuredQuantitativeProperty\",\n                \"properties.ConventionalQuantitativeProperty\",\n                \"metrology.QuantitativeProperty\",\n                \"metrology.Quantity\",\n                \"metrology.OrdinalQuantity\",\n                \"metrology.BaseQuantity\",\n                \"metrology.PhysicalConstant\",\n                \"metrology.PhysicalQuantity\",\n                \"metrology.ExactConstant\",\n                \"metrology.MeasuredConstant\",\n                \"metrology.DerivedQuantity\",\n                \"isq.ISQBaseQuantity\",\n                \"isq.InternationalSystemOfQuantity\",\n                \"isq.ISQDerivedQuantity\",\n                \"isq.SIExactConstant\",\n                \"emmo.ModelledQuantitativeProperty\",\n                \"emmo.MeasuredQuantitativeProperty\",\n                \"emmo.ConventionalQuantitativeProperty\",\n                \"emmo.QuantitativeProperty\",\n                \"emmo.Quantity\",\n                \"emmo.OrdinalQuantity\",\n                \"emmo.BaseQuantity\",\n                \"emmo.PhysicalConstant\",\n                \"emmo.PhysicalQuantity\",\n                \"emmo.ExactConstant\",\n                \"emmo.MeasuredConstant\",\n                \"emmo.DerivedQuantity\",\n                \"emmo.ISQBaseQuantity\",\n                \"emmo.InternationalSystemOfQuantity\",\n                \"emmo.ISQDerivedQuantity\",\n                \"emmo.SIExactConstant\",\n                \"emmo.NonSIUnits\",\n                \"emmo.StandardizedPhysicalQuantity\",\n                \"emmo.CategorizedPhysicalQuantity\",\n                \"emmo.AtomicAndNuclear\",\n                \"emmo.Defined\",\n                \"emmo.Electromagnetic\",\n                \"emmo.FrequentlyUsed\",\n                \"emmo.PhysicoChemical\",\n                \"emmo.ChemicalCompositionQuantity\",\n                \"emmo.Universal\",\n            )\n        )\n        if not hasattr(self.onto, \"PhysicalQuantity\"):\n            return\n        exceptions.update(\n            self.get_config(\"test_quantity_dimension.exceptions\", ())\n        )\n        regex = re.compile(\n            \"^T([+-][1-9]|0) L([+-][1-9]|0) M([+-][1-9]|0) I([+-][1-9]|0) \"\n            \"(H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) J([+-][1-9]|0)$\"\n        )\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.PhysicalQuantity.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            if repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    anno = cls.get_annotations()\n                    self.assertIn(\"physicalDimension\", anno, msg=cls)\n                    physdim = anno[\"physicalDimension\"].first()\n                    self.assertRegex(physdim, regex, msg=cls)\n\n    def test_quantity_dimension(self):\n        \"\"\"Check that all quantities have a physicalDimension.\n\n        Note: this test will be deprecated when isq is moved to emmo/domain.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n        \"\"\"\n        # pylint: disable=invalid-name\n        exceptions = set(\n            (\n                \"properties.ModelledQuantitativeProperty\",\n                \"properties.MeasuredQuantitativeProperty\",\n                \"properties.ConventionalQuantitativeProperty\",\n                \"metrology.QuantitativeProperty\",\n                \"metrology.Quantity\",\n                \"metrology.OrdinalQuantity\",\n                \"metrology.BaseQuantity\",\n                \"metrology.PhysicalConstant\",\n                \"metrology.PhysicalQuantity\",\n                \"metrology.ExactConstant\",\n                \"metrology.MeasuredConstant\",\n                \"metrology.DerivedQuantity\",\n                \"isq.ISQBaseQuantity\",\n                \"isq.InternationalSystemOfQuantity\",\n                \"isq.ISQDerivedQuantity\",\n                \"isq.SIExactConstant\",\n                \"emmo.ModelledQuantitativeProperty\",\n                \"emmo.MeasuredQuantitativeProperty\",\n                \"emmo.ConventionalQuantitativeProperty\",\n                \"emmo.QuantitativeProperty\",\n                \"emmo.Quantity\",\n                \"emmo.OrdinalQuantity\",\n                \"emmo.BaseQuantity\",\n                \"emmo.PhysicalConstant\",\n                \"emmo.PhysicalQuantity\",\n                \"emmo.ExactConstant\",\n                \"emmo.MeasuredConstant\",\n                \"emmo.DerivedQuantity\",\n                \"emmo.ISQBaseQuantity\",\n                \"emmo.InternationalSystemOfQuantity\",\n                \"emmo.ISQDerivedQuantity\",\n                \"emmo.SIExactConstant\",\n                \"emmo.NonSIUnits\",\n                \"emmo.StandardizedPhysicalQuantity\",\n                \"emmo.CategorizedPhysicalQuantity\",\n                \"emmo.ISO80000Categorised\",\n                \"emmo.AtomicAndNuclear\",\n                \"emmo.Defined\",\n                \"emmo.Electromagnetic\",\n                \"emmo.FrequentlyUsed\",\n                \"emmo.ChemicalCompositionQuantity\",\n                \"emmo.EquilibriumConstant\",  # physical dimension may change\n                \"emmo.Solubility\",\n                \"emmo.Universal\",\n                \"emmo.Intensive\",\n                \"emmo.Extensive\",\n                \"emmo.Concentration\",\n            )\n        )\n        if not hasattr(self.onto, \"PhysicalQuantity\"):\n            return\n        exceptions.update(\n            self.get_config(\"test_quantity_dimension.exceptions\", ())\n        )\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.PhysicalQuantity.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            if issubclass(cls, self.onto.ISO80000Categorised):\n                continue\n            if repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    for r in cls.get_indirect_is_a():\n                        if isinstance(r, owlready2.Restriction) and repr(\n                            r\n                        ).startswith(\"emmo.hasMeasurementUnit.some\"):\n                            self.assertTrue(\n                                issubclass(\n                                    r.value,\n                                    (\n                                        self.onto.DimensionalUnit,\n                                        self.onto.DimensionlessUnit,\n                                    ),\n                                )\n                            )\n                            break\n                    else:\n                        self.assertTrue(\n                            issubclass(cls, self.onto.ISQDimensionlessQuantity)\n                        )\n\n    def test_dimensional_unit(self):\n        \"\"\"Check correct syntax of dimension string of dimensional units.\"\"\"\n\n        # This test requires that the ontology has imported SIDimensionalUnit\n        if \"SIDimensionalUnit\" not in self.onto:\n            self.skipTest(\"SIDimensionalUnit is not imported\")\n\n        # pylint: disable=invalid-name\n        regex = re.compile(\n            \"^T([+-][1-9][0-9]*|0) L([+-][1-9]|0) M([+-][1-9]|0) \"\n            \"I([+-][1-9]|0) (H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) \"\n            \"J([+-][1-9]|0)$\"\n        )\n        for cls in self.onto.SIDimensionalUnit.__subclasses__():\n            with self.subTest(cls=cls, label=get_label(cls)):\n                self.assertEqual(len(cls.equivalent_to), 1)\n                r = cls.equivalent_to[0]\n                self.assertIsInstance(r, owlready2.Restriction)\n                self.assertRegex(r.value, regex)\n\n    def test_physical_quantity_dimension(self):\n        \"\"\"Check that all physical quantities have `hasPhysicalDimension`.\n\n        Note: this test will fail before isq is moved to emmo/domain.\n\n        Configurations:\n            exceptions - full class names of classes to ignore.\n\n        \"\"\"\n        exceptions = set(\n            (\n                \"emmo.ModelledQuantitativeProperty\",\n                \"emmo.MeasuredQuantitativeProperty\",\n                \"emmo.ConventionalQuantitativeProperty\",\n                \"emmo.QuantitativeProperty\",\n                \"emmo.BaseQuantity\",\n                \"emmo.PhysicalConstant\",\n                \"emmo.PhysicalQuantity\",\n                \"emmo.ExactConstant\",\n                \"emmo.MeasuredConstant\",\n                \"emmo.DerivedQuantity\",\n                \"emmo.ISQBaseQuantity\",\n                \"emmo.InternationalSystemOfQuantity\",\n                \"emmo.ISQDerivedQuantity\",\n                \"emmo.SIExactConstant\",\n                \"emmo.NonSIUnits\",\n                \"emmo.StandardizedPhysicalQuantity\",\n                \"emmo.CategorizedPhysicalQuantity\",\n                \"emmo.AtomicAndNuclearPhysicsQuantity\",\n                \"emmo.ThermodynamicalQuantity\",\n                \"emmo.LightAndRadiationQuantity\",\n                \"emmo.SpaceAndTimeQuantity\",\n                \"emmo.AcousticQuantity\",\n                \"emmo.PhysioChememicalQuantity\",\n                \"emmo.ElectromagneticQuantity\",\n                \"emmo.MechanicalQuantity\",\n                \"emmo.CondensedMatterPhysicsQuantity\",\n                \"emmo.ChemicalCompositionQuantity\",\n                \"emmo.Extensive\",\n                \"emmo.Intensive\",\n            )\n        )\n        if not hasattr(self.onto, \"PhysicalQuantity\"):\n            return\n        exceptions.update(\n            self.get_config(\"test_physical_quantity_dimension.exceptions\", ())\n        )\n        classes = set(self.onto.classes(self.check_imported))\n        for cls in self.onto.PhysicalQuantity.descendants():\n            if not self.check_imported and cls not in classes:\n                continue\n            if repr(cls) not in exceptions:\n                with self.subTest(cls=cls, label=get_label(cls)):\n                    try:\n                        class_props = cls.INDIRECT_get_class_properties()\n                    except AttributeError:\n                        # The INDIRECT_get_class_properties() method\n                        # does not support inverse properties.  Build\n                        # class_props manually...\n                        class_props = set()\n                        for _ in cls.mro():\n                            if hasattr(_, \"is_a\"):\n                                class_props.update(\n                                    [\n                                        restriction.property\n                                        for restriction in _.is_a\n                                        if isinstance(\n                                            restriction, owlready2.Restriction\n                                        )\n                                    ]\n                                )\n\n                    self.assertIn(\n                        self.onto.hasPhysicalDimension, class_props, msg=cls\n                    )\n\n    def test_namespace(self):\n        \"\"\"Check that all IRIs are namespaced after their (sub)ontology.\n\n        Configurations:\n            exceptions - full name of entities to ignore.\n        \"\"\"\n        exceptions = set(\n            (\n                \"owl.qualifiedCardinality\",\n                \"owl.minQualifiedCardinality\",\n                \"terms.creator\",\n                \"terms.contributor\",\n                \"terms.publisher\",\n                \"terms.title\",\n                \"terms.license\",\n                \"terms.abstract\",\n                \"core.prefLabel\",\n                \"core.altLabel\",\n                \"core.hiddenLabel\",\n                \"mereotopology.Item\",\n                \"manufacturing.EngineeredMaterial\",\n            )\n        )\n        exceptions.update(self.get_config(\"test_namespace.exceptions\", ()))\n\n        def checker(onto, ignore_namespace):\n            if list(\n                filter(onto.base_iri.strip(\"#\").endswith, self.ignore_namespace)\n            ):\n                print(f\"Skipping namespace: {onto.base_iri}\")\n                return\n            entities = itertools.chain(\n                onto.classes(),\n                onto.object_properties(),\n                onto.data_properties(),\n                onto.individuals(),\n                onto.annotation_properties(),\n            )\n            for entity in entities:\n                if entity not in visited and repr(entity) not in exceptions:\n                    visited.add(entity)\n                    with self.subTest(\n                        iri=entity.iri,\n                        base_iri=onto.base_iri,\n                        entity=repr(entity),\n                    ):\n                        self.assertTrue(\n                            entity.iri.endswith(entity.name),\n                            msg=(\n                                \"the final part of entity IRIs must be their \"\n                                \"name\"\n                            ),\n                        )\n                        self.assertEqual(\n                            entity.iri,\n                            onto.base_iri + entity.name,\n                            msg=(\n                                f\"IRI {entity.iri!r} does not correspond to \"\n                                f\"module namespace: {onto.base_iri!r}\"\n                            ),\n                        )\n\n            if self.check_imported:\n                for imp_onto in onto.imported_ontologies:\n                    if imp_onto not in visited_onto:\n                        visited_onto.add(imp_onto)\n                        checker(imp_onto, ignore_namespace)\n\n        visited = set()\n        visited_onto = set()\n        checker(self.onto, self.ignore_namespace)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_dimensional_unit","title":"<code>test_dimensional_unit(self)</code>","text":"<p>Check correct syntax of dimension string of dimensional units.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_dimensional_unit(self):\n    \"\"\"Check correct syntax of dimension string of dimensional units.\"\"\"\n\n    # This test requires that the ontology has imported SIDimensionalUnit\n    if \"SIDimensionalUnit\" not in self.onto:\n        self.skipTest(\"SIDimensionalUnit is not imported\")\n\n    # pylint: disable=invalid-name\n    regex = re.compile(\n        \"^T([+-][1-9][0-9]*|0) L([+-][1-9]|0) M([+-][1-9]|0) \"\n        \"I([+-][1-9]|0) (H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) \"\n        \"J([+-][1-9]|0)$\"\n    )\n    for cls in self.onto.SIDimensionalUnit.__subclasses__():\n        with self.subTest(cls=cls, label=get_label(cls)):\n            self.assertEqual(len(cls.equivalent_to), 1)\n            r = cls.equivalent_to[0]\n            self.assertIsInstance(r, owlready2.Restriction)\n            self.assertRegex(r.value, regex)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_namespace","title":"<code>test_namespace(self)</code>","text":"<p>Check that all IRIs are namespaced after their (sub)ontology.</p> <p>Configurations</p> <p>exceptions - full name of entities to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_namespace(self):\n    \"\"\"Check that all IRIs are namespaced after their (sub)ontology.\n\n    Configurations:\n        exceptions - full name of entities to ignore.\n    \"\"\"\n    exceptions = set(\n        (\n            \"owl.qualifiedCardinality\",\n            \"owl.minQualifiedCardinality\",\n            \"terms.creator\",\n            \"terms.contributor\",\n            \"terms.publisher\",\n            \"terms.title\",\n            \"terms.license\",\n            \"terms.abstract\",\n            \"core.prefLabel\",\n            \"core.altLabel\",\n            \"core.hiddenLabel\",\n            \"mereotopology.Item\",\n            \"manufacturing.EngineeredMaterial\",\n        )\n    )\n    exceptions.update(self.get_config(\"test_namespace.exceptions\", ()))\n\n    def checker(onto, ignore_namespace):\n        if list(\n            filter(onto.base_iri.strip(\"#\").endswith, self.ignore_namespace)\n        ):\n            print(f\"Skipping namespace: {onto.base_iri}\")\n            return\n        entities = itertools.chain(\n            onto.classes(),\n            onto.object_properties(),\n            onto.data_properties(),\n            onto.individuals(),\n            onto.annotation_properties(),\n        )\n        for entity in entities:\n            if entity not in visited and repr(entity) not in exceptions:\n                visited.add(entity)\n                with self.subTest(\n                    iri=entity.iri,\n                    base_iri=onto.base_iri,\n                    entity=repr(entity),\n                ):\n                    self.assertTrue(\n                        entity.iri.endswith(entity.name),\n                        msg=(\n                            \"the final part of entity IRIs must be their \"\n                            \"name\"\n                        ),\n                    )\n                    self.assertEqual(\n                        entity.iri,\n                        onto.base_iri + entity.name,\n                        msg=(\n                            f\"IRI {entity.iri!r} does not correspond to \"\n                            f\"module namespace: {onto.base_iri!r}\"\n                        ),\n                    )\n\n        if self.check_imported:\n            for imp_onto in onto.imported_ontologies:\n                if imp_onto not in visited_onto:\n                    visited_onto.add(imp_onto)\n                    checker(imp_onto, ignore_namespace)\n\n    visited = set()\n    visited_onto = set()\n    checker(self.onto, self.ignore_namespace)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_physical_quantity_dimension","title":"<code>test_physical_quantity_dimension(self)</code>","text":"<p>Check that all physical quantities have <code>hasPhysicalDimension</code>.</p> <p>Note: this test will fail before isq is moved to emmo/domain.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_physical_quantity_dimension(self):\n    \"\"\"Check that all physical quantities have `hasPhysicalDimension`.\n\n    Note: this test will fail before isq is moved to emmo/domain.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n\n    \"\"\"\n    exceptions = set(\n        (\n            \"emmo.ModelledQuantitativeProperty\",\n            \"emmo.MeasuredQuantitativeProperty\",\n            \"emmo.ConventionalQuantitativeProperty\",\n            \"emmo.QuantitativeProperty\",\n            \"emmo.BaseQuantity\",\n            \"emmo.PhysicalConstant\",\n            \"emmo.PhysicalQuantity\",\n            \"emmo.ExactConstant\",\n            \"emmo.MeasuredConstant\",\n            \"emmo.DerivedQuantity\",\n            \"emmo.ISQBaseQuantity\",\n            \"emmo.InternationalSystemOfQuantity\",\n            \"emmo.ISQDerivedQuantity\",\n            \"emmo.SIExactConstant\",\n            \"emmo.NonSIUnits\",\n            \"emmo.StandardizedPhysicalQuantity\",\n            \"emmo.CategorizedPhysicalQuantity\",\n            \"emmo.AtomicAndNuclearPhysicsQuantity\",\n            \"emmo.ThermodynamicalQuantity\",\n            \"emmo.LightAndRadiationQuantity\",\n            \"emmo.SpaceAndTimeQuantity\",\n            \"emmo.AcousticQuantity\",\n            \"emmo.PhysioChememicalQuantity\",\n            \"emmo.ElectromagneticQuantity\",\n            \"emmo.MechanicalQuantity\",\n            \"emmo.CondensedMatterPhysicsQuantity\",\n            \"emmo.ChemicalCompositionQuantity\",\n            \"emmo.Extensive\",\n            \"emmo.Intensive\",\n        )\n    )\n    if not hasattr(self.onto, \"PhysicalQuantity\"):\n        return\n    exceptions.update(\n        self.get_config(\"test_physical_quantity_dimension.exceptions\", ())\n    )\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.PhysicalQuantity.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        if repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                try:\n                    class_props = cls.INDIRECT_get_class_properties()\n                except AttributeError:\n                    # The INDIRECT_get_class_properties() method\n                    # does not support inverse properties.  Build\n                    # class_props manually...\n                    class_props = set()\n                    for _ in cls.mro():\n                        if hasattr(_, \"is_a\"):\n                            class_props.update(\n                                [\n                                    restriction.property\n                                    for restriction in _.is_a\n                                    if isinstance(\n                                        restriction, owlready2.Restriction\n                                    )\n                                ]\n                            )\n\n                self.assertIn(\n                    self.onto.hasPhysicalDimension, class_props, msg=cls\n                )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_quantity_dimension","title":"<code>test_quantity_dimension(self)</code>","text":"<p>Check that all quantities have a physicalDimension.</p> <p>Note: this test will be deprecated when isq is moved to emmo/domain.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_quantity_dimension(self):\n    \"\"\"Check that all quantities have a physicalDimension.\n\n    Note: this test will be deprecated when isq is moved to emmo/domain.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n    \"\"\"\n    # pylint: disable=invalid-name\n    exceptions = set(\n        (\n            \"properties.ModelledQuantitativeProperty\",\n            \"properties.MeasuredQuantitativeProperty\",\n            \"properties.ConventionalQuantitativeProperty\",\n            \"metrology.QuantitativeProperty\",\n            \"metrology.Quantity\",\n            \"metrology.OrdinalQuantity\",\n            \"metrology.BaseQuantity\",\n            \"metrology.PhysicalConstant\",\n            \"metrology.PhysicalQuantity\",\n            \"metrology.ExactConstant\",\n            \"metrology.MeasuredConstant\",\n            \"metrology.DerivedQuantity\",\n            \"isq.ISQBaseQuantity\",\n            \"isq.InternationalSystemOfQuantity\",\n            \"isq.ISQDerivedQuantity\",\n            \"isq.SIExactConstant\",\n            \"emmo.ModelledQuantitativeProperty\",\n            \"emmo.MeasuredQuantitativeProperty\",\n            \"emmo.ConventionalQuantitativeProperty\",\n            \"emmo.QuantitativeProperty\",\n            \"emmo.Quantity\",\n            \"emmo.OrdinalQuantity\",\n            \"emmo.BaseQuantity\",\n            \"emmo.PhysicalConstant\",\n            \"emmo.PhysicalQuantity\",\n            \"emmo.ExactConstant\",\n            \"emmo.MeasuredConstant\",\n            \"emmo.DerivedQuantity\",\n            \"emmo.ISQBaseQuantity\",\n            \"emmo.InternationalSystemOfQuantity\",\n            \"emmo.ISQDerivedQuantity\",\n            \"emmo.SIExactConstant\",\n            \"emmo.NonSIUnits\",\n            \"emmo.StandardizedPhysicalQuantity\",\n            \"emmo.CategorizedPhysicalQuantity\",\n            \"emmo.ISO80000Categorised\",\n            \"emmo.AtomicAndNuclear\",\n            \"emmo.Defined\",\n            \"emmo.Electromagnetic\",\n            \"emmo.FrequentlyUsed\",\n            \"emmo.ChemicalCompositionQuantity\",\n            \"emmo.EquilibriumConstant\",  # physical dimension may change\n            \"emmo.Solubility\",\n            \"emmo.Universal\",\n            \"emmo.Intensive\",\n            \"emmo.Extensive\",\n            \"emmo.Concentration\",\n        )\n    )\n    if not hasattr(self.onto, \"PhysicalQuantity\"):\n        return\n    exceptions.update(\n        self.get_config(\"test_quantity_dimension.exceptions\", ())\n    )\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.PhysicalQuantity.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        if issubclass(cls, self.onto.ISO80000Categorised):\n            continue\n        if repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                for r in cls.get_indirect_is_a():\n                    if isinstance(r, owlready2.Restriction) and repr(\n                        r\n                    ).startswith(\"emmo.hasMeasurementUnit.some\"):\n                        self.assertTrue(\n                            issubclass(\n                                r.value,\n                                (\n                                    self.onto.DimensionalUnit,\n                                    self.onto.DimensionlessUnit,\n                                ),\n                            )\n                        )\n                        break\n                else:\n                    self.assertTrue(\n                        issubclass(cls, self.onto.ISQDimensionlessQuantity)\n                    )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_quantity_dimension_beta3","title":"<code>test_quantity_dimension_beta3(self)</code>","text":"<p>Check that all quantities have a physicalDimension annotation.</p> <p>Note: this test will be deprecated when isq is moved to emmo/domain.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_quantity_dimension_beta3(self):\n    \"\"\"Check that all quantities have a physicalDimension annotation.\n\n    Note: this test will be deprecated when isq is moved to emmo/domain.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n    \"\"\"\n    exceptions = set(\n        (\n            \"properties.ModelledQuantitativeProperty\",\n            \"properties.MeasuredQuantitativeProperty\",\n            \"properties.ConventionalQuantitativeProperty\",\n            \"metrology.QuantitativeProperty\",\n            \"metrology.Quantity\",\n            \"metrology.OrdinalQuantity\",\n            \"metrology.BaseQuantity\",\n            \"metrology.PhysicalConstant\",\n            \"metrology.PhysicalQuantity\",\n            \"metrology.ExactConstant\",\n            \"metrology.MeasuredConstant\",\n            \"metrology.DerivedQuantity\",\n            \"isq.ISQBaseQuantity\",\n            \"isq.InternationalSystemOfQuantity\",\n            \"isq.ISQDerivedQuantity\",\n            \"isq.SIExactConstant\",\n            \"emmo.ModelledQuantitativeProperty\",\n            \"emmo.MeasuredQuantitativeProperty\",\n            \"emmo.ConventionalQuantitativeProperty\",\n            \"emmo.QuantitativeProperty\",\n            \"emmo.Quantity\",\n            \"emmo.OrdinalQuantity\",\n            \"emmo.BaseQuantity\",\n            \"emmo.PhysicalConstant\",\n            \"emmo.PhysicalQuantity\",\n            \"emmo.ExactConstant\",\n            \"emmo.MeasuredConstant\",\n            \"emmo.DerivedQuantity\",\n            \"emmo.ISQBaseQuantity\",\n            \"emmo.InternationalSystemOfQuantity\",\n            \"emmo.ISQDerivedQuantity\",\n            \"emmo.SIExactConstant\",\n            \"emmo.NonSIUnits\",\n            \"emmo.StandardizedPhysicalQuantity\",\n            \"emmo.CategorizedPhysicalQuantity\",\n            \"emmo.AtomicAndNuclear\",\n            \"emmo.Defined\",\n            \"emmo.Electromagnetic\",\n            \"emmo.FrequentlyUsed\",\n            \"emmo.PhysicoChemical\",\n            \"emmo.ChemicalCompositionQuantity\",\n            \"emmo.Universal\",\n        )\n    )\n    if not hasattr(self.onto, \"PhysicalQuantity\"):\n        return\n    exceptions.update(\n        self.get_config(\"test_quantity_dimension.exceptions\", ())\n    )\n    regex = re.compile(\n        \"^T([+-][1-9]|0) L([+-][1-9]|0) M([+-][1-9]|0) I([+-][1-9]|0) \"\n        \"(H|\u0398)([+-][1-9]|0) N([+-][1-9]|0) J([+-][1-9]|0)$\"\n    )\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.PhysicalQuantity.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        if repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                anno = cls.get_annotations()\n                self.assertIn(\"physicalDimension\", anno, msg=cls)\n                physdim = anno[\"physicalDimension\"].first()\n                self.assertRegex(physdim, regex, msg=cls)\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestFunctionalEMMOConventions.test_unit_dimension","title":"<code>test_unit_dimension(self)</code>","text":"<p>Check that all measurement units have a physical dimension.</p> <p>Configurations</p> <p>exceptions - full class names of classes to ignore.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_unit_dimension(self):\n    \"\"\"Check that all measurement units have a physical dimension.\n\n    Configurations:\n        exceptions - full class names of classes to ignore.\n    \"\"\"\n    exceptions = set(\n        (\n            \"metrology.MultipleUnit\",\n            \"metrology.SubMultipleUnit\",\n            \"metrology.OffSystemUnit\",\n            \"metrology.PrefixedUnit\",\n            \"metrology.NonPrefixedUnit\",\n            \"metrology.SpecialUnit\",\n            \"metrology.DerivedUnit\",\n            \"metrology.BaseUnit\",\n            \"metrology.UnitSymbol\",\n            \"siunits.SICoherentDerivedUnit\",\n            \"siunits.SINonCoherentDerivedUnit\",\n            \"siunits.SISpecialUnit\",\n            \"siunits.SICoherentUnit\",\n            \"siunits.SIPrefixedUnit\",\n            \"siunits.SIBaseUnit\",\n            \"siunits.SIUnitSymbol\",\n            \"siunits.SIUnit\",\n            \"emmo.MultipleUnit\",\n            \"emmo.SubMultipleUnit\",\n            \"emmo.OffSystemUnit\",\n            \"emmo.PrefixedUnit\",\n            \"emmo.NonPrefixedUnit\",\n            \"emmo.SpecialUnit\",\n            \"emmo.DerivedUnit\",\n            \"emmo.BaseUnit\",\n            \"emmo.UnitSymbol\",\n            \"emmo.SIAccepted\",\n            \"emmo.SICoherentDerivedUnit\",\n            \"emmo.SINonCoherentDerivedUnit\",\n            \"emmo.SISpecialUnit\",\n            \"emmo.SICoherentUnit\",\n            \"emmo.SIPrefixedUnit\",\n            \"emmo.SIBaseUnit\",\n            \"emmo.SIUnitSymbol\",\n            \"emmo.SIUnit\",\n        )\n    )\n    if not hasattr(self.onto, \"MeasurementUnit\"):\n        return\n    exceptions.update(self.get_config(\"test_unit_dimension.exceptions\", ()))\n    regex = re.compile(r\"^(emmo|metrology).hasDimensionString.value\\(.*\\)$\")\n    classes = set(self.onto.classes(self.check_imported))\n    for cls in self.onto.MeasurementUnit.descendants():\n        if not self.check_imported and cls not in classes:\n            continue\n        # Assume that actual units are not subclassed\n        if not list(cls.subclasses()) and repr(cls) not in exceptions:\n            with self.subTest(cls=cls, label=get_label(cls)):\n                self.assertTrue(\n                    any(\n                        regex.match(repr(r))\n                        for r in cls.get_indirect_is_a()\n                    ),\n                    msg=cls,\n                )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions","title":"<code> TestSyntacticEMMOConventions        </code>","text":"<p>Test syntactic EMMO conventions.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>class TestSyntacticEMMOConventions(TestEMMOConventions):\n    \"\"\"Test syntactic EMMO conventions.\"\"\"\n\n    def test_number_of_labels(self):\n        \"\"\"Check that all entities have one and only one prefLabel.\n\n        Use \"altLabel\" for synonyms.\n\n        The only allowed exception is entities who's representation\n        starts with \"owl.\".\n        \"\"\"\n        exceptions = set(\n            (\n                \"0.1.homepage\",  # foaf:homepage\n                \"0.1.logo\",\n                \"0.1.page\",\n                \"0.1.name\",\n                \"bibo:doi\",\n                \"core.altLabel\",\n                \"core.hiddenLabel\",\n                \"core.prefLabel\",\n                \"terms.abstract\",\n                \"terms.alternative\",\n                \"terms:bibliographicCitation\",\n                \"terms.contributor\",\n                \"terms.created\",\n                \"terms.creator\",\n                \"terms.hasFormat\",\n                \"terms.identifier\",\n                \"terms.issued\",\n                \"terms.license\",\n                \"terms.modified\",\n                \"terms.publisher\",\n                \"terms.source\",\n                \"terms.title\",\n                \"vann:preferredNamespacePrefix\",\n                \"vann:preferredNamespaceUri\",\n            )\n        )\n        exceptions.update(\n            self.get_config(\"test_number_of_labels.exceptions\", ())\n        )\n        if (\n            \"prefLabel\"\n            in self.onto.world._props  # pylint: disable=protected-access\n        ):\n            for entity in self.onto.classes(self.check_imported):\n                if repr(entity) not in exceptions:\n                    with self.subTest(\n                        entity=entity,\n                        label=get_label(entity),\n                        prefLabels=entity.prefLabel,\n                    ):\n                        if not repr(entity).startswith(\"owl.\"):\n                            self.assertTrue(hasattr(entity, \"prefLabel\"))\n                            self.assertEqual(1, len(entity.prefLabel))\n        else:\n            self.fail(\"ontology has no prefLabel\")\n\n    def test_class_label(self):\n        \"\"\"Check that class labels are CamelCase and valid identifiers.\n\n        For CamelCase, we are currently only checking that the labels\n        start with upper case.\n        \"\"\"\n        exceptions = set(\n            (\n                \"0-manifold\",  # not needed in 1.0.0-beta\n                \"1-manifold\",\n                \"2-manifold\",\n                \"3-manifold\",\n                \"C++\",\n                \"3DPrinting\",\n            )\n        )\n        exceptions.update(self.get_config(\"test_class_label.exceptions\", ()))\n\n        for cls in self.onto.classes(self.check_imported):\n            for label in cls.label + getattr(cls, \"prefLabel\", []):\n                if str(label) not in exceptions:\n                    with self.subTest(entity=cls, label=label):\n                        self.assertTrue(label.isidentifier())\n                        self.assertTrue(label[0].isupper())\n\n    def test_object_property_label(self):\n        \"\"\"Check that object property labels are lowerCamelCase.\n\n        Allowed exceptions: \"EMMORelation\"\n\n        If they start with \"has\" or \"is\" they should be followed by a\n        upper case letter.\n\n        If they start with \"is\" they should also end with \"Of\".\n        \"\"\"\n        exceptions = set((\"EMMORelation\",))\n        exceptions.update(\n            self.get_config(\"test_object_property_label.exceptions\", ())\n        )\n\n        for obj_prop in self.onto.object_properties():\n            if repr(obj_prop) not in exceptions:\n                for label in obj_prop.label:\n                    with self.subTest(entity=obj_prop, label=label):\n                        self.assertTrue(\n                            label[0].islower(), \"label start with lowercase\"\n                        )\n                        if label.startswith(\"has\"):\n                            self.assertTrue(\n                                label[3].isupper(),\n                                'what follows \"has\" must be \"uppercase\"',\n                            )\n                        if label.startswith(\"is\"):\n                            self.assertTrue(\n                                label[2].isupper(),\n                                'what follows \"is\" must be \"uppercase\"',\n                            )\n                            self.assertTrue(\n                                label.endswith((\"Of\", \"With\")),\n                                'should end with \"Of\" or \"With\"',\n                            )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions.test_class_label","title":"<code>test_class_label(self)</code>","text":"<p>Check that class labels are CamelCase and valid identifiers.</p> <p>For CamelCase, we are currently only checking that the labels start with upper case.</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_class_label(self):\n    \"\"\"Check that class labels are CamelCase and valid identifiers.\n\n    For CamelCase, we are currently only checking that the labels\n    start with upper case.\n    \"\"\"\n    exceptions = set(\n        (\n            \"0-manifold\",  # not needed in 1.0.0-beta\n            \"1-manifold\",\n            \"2-manifold\",\n            \"3-manifold\",\n            \"C++\",\n            \"3DPrinting\",\n        )\n    )\n    exceptions.update(self.get_config(\"test_class_label.exceptions\", ()))\n\n    for cls in self.onto.classes(self.check_imported):\n        for label in cls.label + getattr(cls, \"prefLabel\", []):\n            if str(label) not in exceptions:\n                with self.subTest(entity=cls, label=label):\n                    self.assertTrue(label.isidentifier())\n                    self.assertTrue(label[0].isupper())\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions.test_number_of_labels","title":"<code>test_number_of_labels(self)</code>","text":"<p>Check that all entities have one and only one prefLabel.</p> <p>Use \"altLabel\" for synonyms.</p> <p>The only allowed exception is entities who's representation starts with \"owl.\".</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_number_of_labels(self):\n    \"\"\"Check that all entities have one and only one prefLabel.\n\n    Use \"altLabel\" for synonyms.\n\n    The only allowed exception is entities who's representation\n    starts with \"owl.\".\n    \"\"\"\n    exceptions = set(\n        (\n            \"0.1.homepage\",  # foaf:homepage\n            \"0.1.logo\",\n            \"0.1.page\",\n            \"0.1.name\",\n            \"bibo:doi\",\n            \"core.altLabel\",\n            \"core.hiddenLabel\",\n            \"core.prefLabel\",\n            \"terms.abstract\",\n            \"terms.alternative\",\n            \"terms:bibliographicCitation\",\n            \"terms.contributor\",\n            \"terms.created\",\n            \"terms.creator\",\n            \"terms.hasFormat\",\n            \"terms.identifier\",\n            \"terms.issued\",\n            \"terms.license\",\n            \"terms.modified\",\n            \"terms.publisher\",\n            \"terms.source\",\n            \"terms.title\",\n            \"vann:preferredNamespacePrefix\",\n            \"vann:preferredNamespaceUri\",\n        )\n    )\n    exceptions.update(\n        self.get_config(\"test_number_of_labels.exceptions\", ())\n    )\n    if (\n        \"prefLabel\"\n        in self.onto.world._props  # pylint: disable=protected-access\n    ):\n        for entity in self.onto.classes(self.check_imported):\n            if repr(entity) not in exceptions:\n                with self.subTest(\n                    entity=entity,\n                    label=get_label(entity),\n                    prefLabels=entity.prefLabel,\n                ):\n                    if not repr(entity).startswith(\"owl.\"):\n                        self.assertTrue(hasattr(entity, \"prefLabel\"))\n                        self.assertEqual(1, len(entity.prefLabel))\n    else:\n        self.fail(\"ontology has no prefLabel\")\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.TestSyntacticEMMOConventions.test_object_property_label","title":"<code>test_object_property_label(self)</code>","text":"<p>Check that object property labels are lowerCamelCase.</p> <p>Allowed exceptions: \"EMMORelation\"</p> <p>If they start with \"has\" or \"is\" they should be followed by a upper case letter.</p> <p>If they start with \"is\" they should also end with \"Of\".</p> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def test_object_property_label(self):\n    \"\"\"Check that object property labels are lowerCamelCase.\n\n    Allowed exceptions: \"EMMORelation\"\n\n    If they start with \"has\" or \"is\" they should be followed by a\n    upper case letter.\n\n    If they start with \"is\" they should also end with \"Of\".\n    \"\"\"\n    exceptions = set((\"EMMORelation\",))\n    exceptions.update(\n        self.get_config(\"test_object_property_label.exceptions\", ())\n    )\n\n    for obj_prop in self.onto.object_properties():\n        if repr(obj_prop) not in exceptions:\n            for label in obj_prop.label:\n                with self.subTest(entity=obj_prop, label=label):\n                    self.assertTrue(\n                        label[0].islower(), \"label start with lowercase\"\n                    )\n                    if label.startswith(\"has\"):\n                        self.assertTrue(\n                            label[3].isupper(),\n                            'what follows \"has\" must be \"uppercase\"',\n                        )\n                    if label.startswith(\"is\"):\n                        self.assertTrue(\n                            label[2].isupper(),\n                            'what follows \"is\" must be \"uppercase\"',\n                        )\n                        self.assertTrue(\n                            label.endswith((\"Of\", \"With\")),\n                            'should end with \"Of\" or \"With\"',\n                        )\n</code></pre>"},{"location":"api_reference/emmopy/emmocheck/#emmopy.emmocheck.main","title":"<code>main(argv=None)</code>","text":"<p>Run all checks on ontology <code>iri</code>.</p> <p>Default is 'http://emmo.info/emmo'.</p> <p>Parameters:</p> Name Type Description Default <code>argv</code> <code>list</code> <p>List of arguments, similar to <code>sys.argv[1:]</code>. Mainly for testing purposes, since it allows one to invoke the tool manually / through Python.</p> <code>None</code> Source code in <code>emmopy/emmocheck.py</code> <pre><code>def main(\n    argv: list = None,\n):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    \"\"\"Run all checks on ontology `iri`.\n\n    Default is 'http://emmo.info/emmo'.\n\n    Parameters:\n        argv: List of arguments, similar to `sys.argv[1:]`.\n            Mainly for testing purposes, since it allows one to invoke the tool\n            manually / through Python.\n\n    \"\"\"\n    parser = argparse.ArgumentParser(description=__doc__)\n    parser.add_argument(\"iri\", help=\"File name or URI to the ontology to test.\")\n    parser.add_argument(\n        \"--database\",\n        \"-d\",\n        metavar=\"FILENAME\",\n        default=\":memory:\",\n        help=(\n            \"Load ontology from Owlready2 sqlite3 database. The `iri` argument\"\n            \" should in this case be the IRI of the ontology you want to \"\n            \"check.\"\n        ),\n    )\n    parser.add_argument(\n        \"--local\",\n        \"-l\",\n        action=\"store_true\",\n        help=(\n            \"Load imported ontologies locally.  Their paths are specified in \"\n            \"Prot\u00e8g\u00e8 catalog files or via the --path option.  The IRI should \"\n            \"be a file name.\"\n        ),\n    )\n    parser.add_argument(\n        \"--catalog-file\",\n        default=\"catalog-v001.xml\",\n        help=(\n            \"Name of Prot\u00e8g\u00e8 catalog file in the same folder as the ontology. \"\n            \"This option is used together with --local and defaults to \"\n            '\"catalog-v001.xml\".'\n        ),\n    )\n    parser.add_argument(\n        \"--path\",\n        action=\"append\",\n        default=[],\n        help=(\n            \"Paths where imported ontologies can be found. May be provided as \"\n            \"a comma-separated string and/or with multiple --path options.\"\n        ),\n    )\n    parser.add_argument(\n        \"--check-imported\",\n        \"-i\",\n        action=\"store_true\",\n        help=\"Whether to check imported ontologies.\",\n    )\n    parser.add_argument(\n        \"--verbose\", \"-v\", action=\"store_true\", help=\"Verbosity level.\"\n    )\n    parser.add_argument(\n        \"--configfile\",\n        \"-c\",\n        help=\"A yaml file with additional test configurations.\",\n    )\n    parser.add_argument(\n        \"--skip\",\n        \"-s\",\n        action=\"append\",\n        default=[],\n        help=(\n            \"Shell pattern matching tests to skip.  This option may be \"\n            \"provided multiple times.\"\n        ),\n    )\n    parser.add_argument(\n        \"--enable\",\n        \"-e\",\n        action=\"append\",\n        default=[],\n        help=(\n            \"Shell pattern matching tests to enable that have been skipped by \"\n            \"default or in the config file.  This option may be provided \"\n            \"multiple times.\"\n        ),\n    )\n    parser.add_argument(  # deprecated, replaced by --no-catalog\n        \"--url-from-catalog\",\n        \"-u\",\n        default=None,\n        action=\"store_true\",\n        help=\"Get url from catalog file\",\n    )\n    parser.add_argument(\n        \"--no-catalog\",\n        action=\"store_false\",\n        dest=\"url_from_catalog\",\n        default=None,\n        help=\"Whether to not read catalog file even if it exists.\",\n    )\n    parser.add_argument(\n        \"--ignore-namespace\",\n        \"-n\",\n        action=\"append\",\n        default=[],\n        help=\"Namespace to be ignored. Can be given multiple times\",\n    )\n\n    # Options to pass forward to unittest\n    parser.add_argument(\n        \"--buffer\",\n        \"-b\",\n        dest=\"unittest\",\n        action=\"append_const\",\n        const=\"-b\",\n        help=(\n            \"The standard output and standard error streams are buffered \"\n            \"during the test run. Output during a passing test is discarded. \"\n            \"Output is echoed normally on test fail or error and is added to \"\n            \"the failure messages.\"\n        ),\n    )\n    parser.add_argument(\n        \"--catch\",\n        dest=\"unittest\",\n        action=\"append_const\",\n        const=\"-c\",\n        help=(\n            \"Control-C during the test run waits for the current test to end \"\n            \"and then reports all the results so far. A second control-C \"\n            \"raises the normal KeyboardInterrupt exception\"\n        ),\n    )\n    parser.add_argument(\n        \"--failfast\",\n        \"-f\",\n        dest=\"unittest\",\n        action=\"append_const\",\n        const=\"-f\",\n        help=\"Stop the test run on the first error or failure.\",\n    )\n    try:\n        args = parser.parse_args(args=argv)\n        sys.argv[1:] = args.unittest if args.unittest else []\n        if args.verbose:\n            sys.argv.append(\"-v\")\n    except SystemExit as exc:\n        sys.exit(exc.code)  # Exit without traceback on invalid arguments\n\n    # Append to onto_path\n    for paths in args.path:\n        for path in paths.split(\",\"):\n            if path not in onto_path:\n                onto_path.append(path)\n\n    # Load ontology\n    world = World(filename=args.database)\n    if args.database != \":memory:\" and args.iri not in world.ontologies:\n        parser.error(\n            \"The IRI argument should be one of the ontologies in \"\n            \"the database:\\n  \" + \"\\n  \".join(world.ontologies.keys())\n        )\n\n    onto = world.get_ontology(args.iri)\n    onto.load(\n        only_local=args.local,\n        url_from_catalog=args.url_from_catalog,\n        catalog_file=args.catalog_file,\n    )\n\n    # Store settings TestEMMOConventions\n    TestEMMOConventions.onto = onto\n    TestEMMOConventions.check_imported = args.check_imported\n    TestEMMOConventions.ignore_namespace = args.ignore_namespace\n\n    # Configure tests\n    verbosity = 2 if args.verbose else 1\n    if args.configfile:\n        import yaml  # pylint: disable=import-outside-toplevel\n\n        with open(args.configfile, \"rt\") as handle:\n            TestEMMOConventions.config.update(\n                yaml.load(handle, Loader=yaml.SafeLoader)\n            )\n\n    # Run all subclasses of TestEMMOConventions as test suites\n    status = 0\n    for cls in TestEMMOConventions.__subclasses__():\n        # pylint: disable=cell-var-from-loop,undefined-loop-variable\n\n        suite = unittest.TestLoader().loadTestsFromTestCase(cls)\n\n        # Mark tests to be skipped\n        for test in suite:\n            name = test.id().split(\".\")[-1]\n            skipped = set(  # skipped by default\n                [\n                    \"test_namespace\",\n                    \"test_physical_quantity_dimension_annotation\",\n                    \"test_quantity_dimension_beta3\",\n                    \"test_physical_quantity_dimension\",\n                ]\n            )\n            msg = {name: \"skipped by default\" for name in skipped}\n\n            # enable/skip tests from config file\n            for pattern in test.get_config(\"enable\", ()):\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.remove(name)\n            for pattern in test.get_config(\"skip\", ()):\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.add(name)\n                    msg[name] = \"skipped from config file\"\n\n            # enable/skip from command line\n            for pattern in args.enable:\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.remove(name)\n            for pattern in args.skip:\n                if fnmatch.fnmatchcase(name, pattern):\n                    skipped.add(name)\n                    msg[name] = \"skipped from command line\"\n\n            if name in skipped:\n                setattr(test, \"setUp\", lambda: test.skipTest(msg.get(name, \"\")))\n\n        runner = TextTestRunner(verbosity=verbosity)\n        runner.resultclass.checkmode = True\n        result = runner.run(suite)\n        if result.failures:\n            status = 1\n\n    return status\n</code></pre>"},{"location":"api_reference/emmopy/emmopy/","title":"emmopy","text":""},{"location":"api_reference/emmopy/emmopy/#emmopy.emmopy--emmopyemmopy","title":"<code>emmopy.emmopy</code>","text":"<p>Automagically retrieve the EMMO utilizing <code>ontopy.get_ontology</code>.</p>"},{"location":"api_reference/emmopy/emmopy/#emmopy.emmopy.get_emmo","title":"<code>get_emmo(inferred=True)</code>","text":"<p>Returns the current version of emmo.</p> <p>Parameters:</p> Name Type Description Default <code>inferred</code> <code>Optional[bool]</code> <p>Whether to import the inferred version of emmo or not. Default is True.</p> <code>True</code> <p>Returns:</p> Type Description <code>Ontology</code> <p>The loaded emmo ontology.</p> Source code in <code>emmopy/emmopy.py</code> <pre><code>def get_emmo(inferred: Optional[bool] = True) -&gt; \"Ontology\":\n    \"\"\"Returns the current version of emmo.\n\n    Args:\n        inferred: Whether to import the inferred version of emmo or not.\n            Default is True.\n\n    Returns:\n        The loaded emmo ontology.\n\n    \"\"\"\n    name = \"emmo-inferred\" if inferred in [True, None] else \"emmo\"\n    return get_ontology(name).load(prefix_emmo=True)\n</code></pre>"},{"location":"api_reference/ontopy/colortest/","title":"colortest","text":""},{"location":"api_reference/ontopy/colortest/#ontopy.colortest--ontopycolortest","title":"<code>ontopy.colortest</code>","text":"<p>Print tests in colors.</p> <p>Adapted from https://github.com/meshy/colour-runner by Charlie Denton License: MIT</p>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult","title":"<code> ColourTextTestResult            (TestResult)         </code>","text":"<p>A test result class that prints colour formatted text results to a stream.</p> <p>Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py</p> Source code in <code>ontopy/colortest.py</code> <pre><code>class ColourTextTestResult(TestResult):\n    \"\"\"\n    A test result class that prints colour formatted text results to a stream.\n\n    Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py\n    \"\"\"\n\n    formatter = formatters.Terminal256Formatter()  # pylint: disable=no-member\n    lexer = Lexer()\n    separator1 = \"=\" * 70\n    separator2 = \"-\" * 70\n    indent = \" \" * 4\n    # if `checkmode` is true, simplified output will be generated with\n    # no traceback\n    checkmode = False\n    _terminal = Terminal()\n    colours = {\n        None: str,\n        \"error\": _terminal.bold_red,\n        \"expected\": _terminal.blue,\n        # \"fail\": _terminal.bold_yellow,\n        \"fail\": _terminal.bold_magenta,\n        \"skip\": str,\n        \"success\": _terminal.green,\n        \"title\": _terminal.blue,\n        \"unexpected\": _terminal.bold_red,\n    }\n\n    _test_class = None\n\n    def __init__(self, stream, descriptions, verbosity):\n        super().__init__(stream, descriptions, verbosity)\n        self.stream = stream\n        self.show_all = verbosity &gt; 1\n        self.dots = verbosity == 1\n        self.descriptions = descriptions\n\n    def getShortDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return self.indent + doc_first_line\n        return self.indent + test._testMethodName\n\n    def getLongDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return \"\\n\".join((str(test), doc_first_line))\n        return str(test)\n\n    def getClassDescription(self, test):\n        test_class = test.__class__\n        doc = test_class.__doc__\n        if self.descriptions and doc:\n            return doc.split(\"\\n\")[0].strip()\n        return strclass(test_class)\n\n    def startTest(self, test):\n        super().startTest(test)\n        pos = 0\n        if self.show_all:\n            if self._test_class != test.__class__:\n                self._test_class = test.__class__\n                title = self.getClassDescription(test)\n                self.stream.writeln(self.colours[\"title\"](title))\n            descr = self.getShortDescription(test)\n            self.stream.write(descr)\n            pos += len(descr)\n            self.stream.write(\" \" * (70 - pos))\n            # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n            # self.stream.write(' ... ')\n            self.stream.flush()\n\n    def printResult(self, short, extended, colour_key=None):\n        colour = self.colours[colour_key]\n        if self.show_all:\n            self.stream.writeln(colour(extended))\n        elif self.dots:\n            self.stream.write(colour(short))\n            self.stream.flush()\n\n    def addSuccess(self, test):\n        super().addSuccess(test)\n        self.printResult(\".\", \"ok\", \"success\")\n\n    def addError(self, test, err):\n        super().addError(test, err)\n        self.printResult(\"E\", \"ERROR\", \"error\")\n\n    def addFailure(self, test, err):\n        super().addFailure(test, err)\n        self.printResult(\"F\", \"FAIL\", \"fail\")\n\n    def addSkip(self, test, reason):\n        super().addSkip(test, reason)\n        if self.checkmode:\n            self.printResult(\"s\", \"skipped\", \"skip\")\n        else:\n            self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n\n    def addExpectedFailure(self, test, err):\n        super().addExpectedFailure(test, err)\n        self.printResult(\"x\", \"expected failure\", \"expected\")\n\n    def addUnexpectedSuccess(self, test):\n        super().addUnexpectedSuccess(test)\n        self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n\n    def printErrors(self):\n        if self.dots or self.show_all:\n            self.stream.writeln()\n        self.printErrorList(\"ERROR\", self.errors)\n        self.printErrorList(\"FAIL\", self.failures)\n\n    def printErrorList(self, flavour, errors):\n        colour = self.colours[flavour.lower()]\n\n        for test, err in errors:\n            if self.checkmode and flavour == \"FAIL\":\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {test.shortDescription()}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(str(test))\n                if self.show_all:\n                    self.stream.writeln(self.separator2)\n                    lines = str(err).split(\"\\n\")\n                    i = 1\n                    for line in lines[1:]:\n                        if line.startswith(\" \"):\n                            i += 1\n                        else:\n                            break\n                    self.stream.writeln(\n                        highlight(\n                            \"\\n\".join(lines[i:]), self.lexer, self.formatter\n                        )\n                    )\n            else:\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {self.getLongDescription(test)}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(self.separator2)\n                self.stream.writeln(highlight(err, self.lexer, self.formatter))\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addError","title":"<code>addError(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addError(self, test, err):\n    super().addError(test, err)\n    self.printResult(\"E\", \"ERROR\", \"error\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addExpectedFailure","title":"<code>addExpectedFailure(self, test, err)</code>","text":"<p>Called when an expected failure/error occurred.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addExpectedFailure(self, test, err):\n    super().addExpectedFailure(test, err)\n    self.printResult(\"x\", \"expected failure\", \"expected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addFailure","title":"<code>addFailure(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addFailure(self, test, err):\n    super().addFailure(test, err)\n    self.printResult(\"F\", \"FAIL\", \"fail\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addSkip","title":"<code>addSkip(self, test, reason)</code>","text":"<p>Called when a test is skipped.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSkip(self, test, reason):\n    super().addSkip(test, reason)\n    if self.checkmode:\n        self.printResult(\"s\", \"skipped\", \"skip\")\n    else:\n        self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addSuccess","title":"<code>addSuccess(self, test)</code>","text":"<p>Called when a test has completed successfully</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSuccess(self, test):\n    super().addSuccess(test)\n    self.printResult(\".\", \"ok\", \"success\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.addUnexpectedSuccess","title":"<code>addUnexpectedSuccess(self, test)</code>","text":"<p>Called when a test was expected to fail, but succeed.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addUnexpectedSuccess(self, test):\n    super().addUnexpectedSuccess(test)\n    self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.printErrors","title":"<code>printErrors(self)</code>","text":"<p>Called by TestRunner after test run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def printErrors(self):\n    if self.dots or self.show_all:\n        self.stream.writeln()\n    self.printErrorList(\"ERROR\", self.errors)\n    self.printErrorList(\"FAIL\", self.failures)\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestResult.startTest","title":"<code>startTest(self, test)</code>","text":"<p>Called when the given test is about to be run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def startTest(self, test):\n    super().startTest(test)\n    pos = 0\n    if self.show_all:\n        if self._test_class != test.__class__:\n            self._test_class = test.__class__\n            title = self.getClassDescription(test)\n            self.stream.writeln(self.colours[\"title\"](title))\n        descr = self.getShortDescription(test)\n        self.stream.write(descr)\n        pos += len(descr)\n        self.stream.write(\" \" * (70 - pos))\n        # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n        # self.stream.write(' ... ')\n        self.stream.flush()\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner","title":"<code> ColourTextTestRunner            (TextTestRunner)         </code>","text":"<p>A test runner that uses colour in its output.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>class ColourTextTestRunner(\n    TextTestRunner\n):  # pylint: disable=too-few-public-methods\n    \"\"\"A test runner that uses colour in its output.\"\"\"\n\n    resultclass = ColourTextTestResult\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass","title":"<code> resultclass            (TestResult)         </code>","text":"<p>A test result class that prints colour formatted text results to a stream.</p> <p>Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py</p> Source code in <code>ontopy/colortest.py</code> <pre><code>class ColourTextTestResult(TestResult):\n    \"\"\"\n    A test result class that prints colour formatted text results to a stream.\n\n    Based on https://github.com/python/cpython/blob/3.3/Lib/unittest/runner.py\n    \"\"\"\n\n    formatter = formatters.Terminal256Formatter()  # pylint: disable=no-member\n    lexer = Lexer()\n    separator1 = \"=\" * 70\n    separator2 = \"-\" * 70\n    indent = \" \" * 4\n    # if `checkmode` is true, simplified output will be generated with\n    # no traceback\n    checkmode = False\n    _terminal = Terminal()\n    colours = {\n        None: str,\n        \"error\": _terminal.bold_red,\n        \"expected\": _terminal.blue,\n        # \"fail\": _terminal.bold_yellow,\n        \"fail\": _terminal.bold_magenta,\n        \"skip\": str,\n        \"success\": _terminal.green,\n        \"title\": _terminal.blue,\n        \"unexpected\": _terminal.bold_red,\n    }\n\n    _test_class = None\n\n    def __init__(self, stream, descriptions, verbosity):\n        super().__init__(stream, descriptions, verbosity)\n        self.stream = stream\n        self.show_all = verbosity &gt; 1\n        self.dots = verbosity == 1\n        self.descriptions = descriptions\n\n    def getShortDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return self.indent + doc_first_line\n        return self.indent + test._testMethodName\n\n    def getLongDescription(self, test):\n        doc_first_line = test.shortDescription()\n        if self.descriptions and doc_first_line:\n            return \"\\n\".join((str(test), doc_first_line))\n        return str(test)\n\n    def getClassDescription(self, test):\n        test_class = test.__class__\n        doc = test_class.__doc__\n        if self.descriptions and doc:\n            return doc.split(\"\\n\")[0].strip()\n        return strclass(test_class)\n\n    def startTest(self, test):\n        super().startTest(test)\n        pos = 0\n        if self.show_all:\n            if self._test_class != test.__class__:\n                self._test_class = test.__class__\n                title = self.getClassDescription(test)\n                self.stream.writeln(self.colours[\"title\"](title))\n            descr = self.getShortDescription(test)\n            self.stream.write(descr)\n            pos += len(descr)\n            self.stream.write(\" \" * (70 - pos))\n            # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n            # self.stream.write(' ... ')\n            self.stream.flush()\n\n    def printResult(self, short, extended, colour_key=None):\n        colour = self.colours[colour_key]\n        if self.show_all:\n            self.stream.writeln(colour(extended))\n        elif self.dots:\n            self.stream.write(colour(short))\n            self.stream.flush()\n\n    def addSuccess(self, test):\n        super().addSuccess(test)\n        self.printResult(\".\", \"ok\", \"success\")\n\n    def addError(self, test, err):\n        super().addError(test, err)\n        self.printResult(\"E\", \"ERROR\", \"error\")\n\n    def addFailure(self, test, err):\n        super().addFailure(test, err)\n        self.printResult(\"F\", \"FAIL\", \"fail\")\n\n    def addSkip(self, test, reason):\n        super().addSkip(test, reason)\n        if self.checkmode:\n            self.printResult(\"s\", \"skipped\", \"skip\")\n        else:\n            self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n\n    def addExpectedFailure(self, test, err):\n        super().addExpectedFailure(test, err)\n        self.printResult(\"x\", \"expected failure\", \"expected\")\n\n    def addUnexpectedSuccess(self, test):\n        super().addUnexpectedSuccess(test)\n        self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n\n    def printErrors(self):\n        if self.dots or self.show_all:\n            self.stream.writeln()\n        self.printErrorList(\"ERROR\", self.errors)\n        self.printErrorList(\"FAIL\", self.failures)\n\n    def printErrorList(self, flavour, errors):\n        colour = self.colours[flavour.lower()]\n\n        for test, err in errors:\n            if self.checkmode and flavour == \"FAIL\":\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {test.shortDescription()}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(str(test))\n                if self.show_all:\n                    self.stream.writeln(self.separator2)\n                    lines = str(err).split(\"\\n\")\n                    i = 1\n                    for line in lines[1:]:\n                        if line.startswith(\" \"):\n                            i += 1\n                        else:\n                            break\n                    self.stream.writeln(\n                        highlight(\n                            \"\\n\".join(lines[i:]), self.lexer, self.formatter\n                        )\n                    )\n            else:\n                self.stream.writeln(self.separator1)\n                title = f\"{flavour}: {self.getLongDescription(test)}\"\n                self.stream.writeln(colour(title))\n                self.stream.writeln(self.separator2)\n                self.stream.writeln(highlight(err, self.lexer, self.formatter))\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addError","title":"<code>addError(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addError(self, test, err):\n    super().addError(test, err)\n    self.printResult(\"E\", \"ERROR\", \"error\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addExpectedFailure","title":"<code>addExpectedFailure(self, test, err)</code>","text":"<p>Called when an expected failure/error occurred.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addExpectedFailure(self, test, err):\n    super().addExpectedFailure(test, err)\n    self.printResult(\"x\", \"expected failure\", \"expected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addFailure","title":"<code>addFailure(self, test, err)</code>","text":"<p>Called when an error has occurred. 'err' is a tuple of values as returned by sys.exc_info().</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addFailure(self, test, err):\n    super().addFailure(test, err)\n    self.printResult(\"F\", \"FAIL\", \"fail\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addSkip","title":"<code>addSkip(self, test, reason)</code>","text":"<p>Called when a test is skipped.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSkip(self, test, reason):\n    super().addSkip(test, reason)\n    if self.checkmode:\n        self.printResult(\"s\", \"skipped\", \"skip\")\n    else:\n        self.printResult(\"s\", f\"skipped {reason!r}\", \"skip\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addSuccess","title":"<code>addSuccess(self, test)</code>","text":"<p>Called when a test has completed successfully</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addSuccess(self, test):\n    super().addSuccess(test)\n    self.printResult(\".\", \"ok\", \"success\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.addUnexpectedSuccess","title":"<code>addUnexpectedSuccess(self, test)</code>","text":"<p>Called when a test was expected to fail, but succeed.</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def addUnexpectedSuccess(self, test):\n    super().addUnexpectedSuccess(test)\n    self.printResult(\"u\", \"unexpected success\", \"unexpected\")\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.printErrors","title":"<code>printErrors(self)</code>","text":"<p>Called by TestRunner after test run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def printErrors(self):\n    if self.dots or self.show_all:\n        self.stream.writeln()\n    self.printErrorList(\"ERROR\", self.errors)\n    self.printErrorList(\"FAIL\", self.failures)\n</code></pre>"},{"location":"api_reference/ontopy/colortest/#ontopy.colortest.ColourTextTestRunner.resultclass.startTest","title":"<code>startTest(self, test)</code>","text":"<p>Called when the given test is about to be run</p> Source code in <code>ontopy/colortest.py</code> <pre><code>def startTest(self, test):\n    super().startTest(test)\n    pos = 0\n    if self.show_all:\n        if self._test_class != test.__class__:\n            self._test_class = test.__class__\n            title = self.getClassDescription(test)\n            self.stream.writeln(self.colours[\"title\"](title))\n        descr = self.getShortDescription(test)\n        self.stream.write(descr)\n        pos += len(descr)\n        self.stream.write(\" \" * (70 - pos))\n        # self.stream.write(' ' * (self._terminal.width - 10 - pos))\n        # self.stream.write(' ... ')\n        self.stream.flush()\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/","title":"excelparser","text":"<p>Module from parsing an excelfile and creating an ontology from it.</p> <p>The excelfile is read by pandas and the pandas dataframe should have column names: prefLabel, altLabel, Elucidation, Comments, Examples, subClassOf, Relations.</p> <p>Note that correct case is mandatory.</p>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.ExcelError","title":"<code> ExcelError            (EMMOntoPyException)         </code>","text":"<p>Raised on errors in Excel file.</p> Source code in <code>ontopy/excelparser.py</code> <pre><code>class ExcelError(EMMOntoPyException):\n    \"\"\"Raised on errors in Excel file.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.create_ontology_from_excel","title":"<code>create_ontology_from_excel(excelpath, concept_sheet_name='Concepts', metadata_sheet_name='Metadata', imports_sheet_name='ImportedOntologies', dataproperties_sheet_name='DataProperties', objectproperties_sheet_name='ObjectProperties', annotationproperties_sheet_name='AnnotationProperties', base_iri='http://emmo.info/emmo/domain/onto#', base_iri_from_metadata=True, imports=None, catalog=None, force=False, input_ontology=None)</code>","text":"<p>Creates an ontology from an Excel-file.</p> <p>Parameters:</p> Name Type Description Default <code>excelpath</code> <code>str</code> <p>Path to Excel workbook.</p> required <code>concept_sheet_name</code> <code>str</code> <p>Name of sheet where concepts are defined. The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel','altLabel', 'Elucidation', 'Comments', 'Examples', 'subClassOf', 'Relations'. Multiple entries are separated with ';'.</p> <code>'Concepts'</code> <code>metadata_sheet_name</code> <code>str</code> <p>Name of sheet where metadata are defined. The first row contains column names 'Metadata name' and 'Value' Supported 'Metadata names' are: 'Ontology IRI', 'Ontology vesion IRI', 'Ontology version Info', 'Title', 'Abstract', 'License', 'Comment', 'Author', 'Contributor'. Multiple entries are separated with a semi-colon (<code>;</code>).</p> <code>'Metadata'</code> <code>imports_sheet_name</code> <code>str</code> <p>Name of sheet where imported ontologies are defined. Column name is 'Imported ontologies'. Fully resolvable URL or path to imported ontologies provided one per row.</p> <code>'ImportedOntologies'</code> <code>dataproperties_sheet_name</code> <code>str</code> <p>Name of sheet where data properties are defined. The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel','altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf', 'Domain', 'Range', 'dijointWith', 'equivalentTo'.</p> <code>'DataProperties'</code> <code>annotationproperties_sheet_name</code> <code>str</code> <p>Name of sheet where annotation properties are defined. The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel', 'altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf', 'Domain', 'Range'.</p> <code>'AnnotationProperties'</code> <code>objectproperties_sheet_name</code> <code>str</code> <p>Name of sheet where object properties are defined.The second row of this sheet should contain column names that are supported. Currently these are 'prefLabel','altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf', 'Domain', 'Range', 'inverseOf', 'dijointWith', 'equivalentTo'.</p> <code>'ObjectProperties'</code> <code>base_iri</code> <code>str</code> <p>Base IRI of the new ontology.</p> <code>'http://emmo.info/emmo/domain/onto#'</code> <code>base_iri_from_metadata</code> <code>bool</code> <p>Whether to use base IRI defined from metadata.</p> <code>True</code> <code>imports</code> <code>list</code> <p>List of imported ontologies.</p> <code>None</code> <code>catalog</code> <code>dict</code> <p>Imported ontologies with (name, full path) key/value-pairs.</p> <code>None</code> <code>force</code> <code>bool</code> <p>Forcibly make an ontology by skipping concepts that are erroneously defined or other errors in the excel sheet.</p> <code>False</code> <code>input_ontology</code> <code>Optional[ontopy.ontology.Ontology]</code> <p>Ontology that should be updated. Default is None, which means that a completely new ontology is generated. If an input_ontology to be updated is provided, the metadata sheet in the excel sheet will not be considered.</p> <code>None</code> <p>Returns:</p> Type Description <code>A tuple with the</code> <ul> <li>created ontology<ul> <li>associated catalog of ontology names and resolvable path as dict</li> <li> <p>a dictionary with lists of concepts that raise errors, with the   following keys:</p> <ul> <li>\"already_defined\": These are concepts (classes)     that are already in the     ontology, because they were already added in a     previous line of the excelfile/pandas dataframe, or because     it is already defined in an imported ontology with the same     base_iri as the newly created ontology.</li> <li>\"in_imported_ontologies\": Concepts (classes)     that are defined in the     excel, but already exist in the imported ontologies.</li> <li>\"wrongly_defined\": Concepts (classes) that are given an     invalid prefLabel (e.g. with a space in the name).</li> <li>\"missing_subClassOf\": Concepts (classes) that are missing     parents. These concepts are added directly under owl:Thing.</li> <li>\"invalid_subClassOf\": Concepts (classes) with invalidly     defined parents.     These concepts are added directly under owl:Thing.</li> <li>\"nonadded_concepts\": List of all concepts (classes) that are     not added,     either because the prefLabel is invalid, or because the     concept has already been added once or already exists in an     imported ontology.</li> <li>\"obj_prop_already_defined\": Object properties that are already     defined in the ontology.</li> <li>\"obj_prop_in_imported_ontologies\": Object properties that are     defined in the excel, but already exist in the imported     ontologies.</li> <li>\"obj_prop_wrongly_defined\": Object properties that are given     an invalid prefLabel (e.g. with a space in the name).</li> <li>\"obj_prop_missing_subPropertyOf\": Object properties that are     missing parents.</li> <li>\"obj_prop_invalid_subPropertyOf\": Object properties with     invalidly defined parents.</li> <li>\"obj_prop_nonadded_entities\": List of all object properties     that are not added, either because the prefLabel is invalid,     or because the concept has already been added once or     already exists in an imported ontology.</li> <li>\"obj_prop_errors_in_properties\": Object properties with     invalidly defined properties.</li> <li>\"obj_prop_errors_in_range\": Object properties with invalidly     defined range.</li> <li>\"obj_prop_errors_in_domain\": Object properties with invalidly     defined domain.</li> <li>\"annot_prop_already_defined\": Annotation properties that are     already defined in the ontology.</li> <li>\"annot_prop_in_imported_ontologies\":  Annotation properties     that     are defined in the excel, but already exist in the imported     ontologies.</li> <li>\"annot_prop_wrongly_defined\": Annotation properties that are     given an invalid prefLabel (e.g. with a space in the name).</li> <li>\"annot_prop_missing_subPropertyOf\": Annotation properties that     are missing parents.</li> <li>\"annot_prop_invalid_subPropertyOf\": Annotation properties with     invalidly defined parents.</li> <li>\"annot_prop_nonadded_entities\": List of all annotation     properties that are not added, either because the prefLabel     is invalid, or because the concept has already been added     once or already exists in an imported ontology.</li> <li>\"annot_prop_errors_in_properties\": Annotation properties with     invalidly defined properties.</li> <li>\"data_prop_already_defined\": Data properties that are already     defined in the ontology.</li> <li>\"data_prop_in_imported_ontologies\": Data properties that are     defined in the excel, but already exist in the imported     ontologies.</li> <li>\"data_prop_wrongly_defined\":  Data properties that are given     an invalid prefLabel (e.g. with a space in the name).</li> <li>\"data_prop_missing_subPropertyOf\": Data properties that are     missing parents.</li> <li>\"data_prop_invalid_subPropertyOf\": Data properties with     invalidly defined parents.</li> <li>\"data_prop_nonadded_entities\": List of all data properties     that are not added, either because the prefLabel is invalid,     or because the concept has already been added once or     already exists in an imported ontology.</li> <li>\"data_prop_errors_in_properties\": Data properties with     invalidly defined properties.</li> <li>\"data_prop_errors_in_range\": Data properties with invalidly     defined range.</li> <li>\"data_prop_errors_in_domain\": Data properties with invalidly     defined domain.</li> </ul> </li> </ul> </li> </ul> Source code in <code>ontopy/excelparser.py</code> <pre><code>def create_ontology_from_excel(  # pylint: disable=too-many-arguments, too-many-locals\n    excelpath: str,\n    concept_sheet_name: str = \"Concepts\",\n    metadata_sheet_name: str = \"Metadata\",\n    imports_sheet_name: str = \"ImportedOntologies\",\n    dataproperties_sheet_name: str = \"DataProperties\",\n    objectproperties_sheet_name: str = \"ObjectProperties\",\n    annotationproperties_sheet_name: str = \"AnnotationProperties\",\n    base_iri: str = \"http://emmo.info/emmo/domain/onto#\",\n    base_iri_from_metadata: bool = True,\n    imports: list = None,\n    catalog: dict = None,\n    force: bool = False,\n    input_ontology: Union[ontopy.ontology.Ontology, None] = None,\n) -&gt; Tuple[ontopy.ontology.Ontology, dict, dict]:\n    \"\"\"\n    Creates an ontology from an Excel-file.\n\n    Arguments:\n        excelpath: Path to Excel workbook.\n        concept_sheet_name: Name of sheet where concepts are defined.\n            The second row of this sheet should contain column names that are\n            supported. Currently these are 'prefLabel','altLabel',\n            'Elucidation', 'Comments', 'Examples', 'subClassOf', 'Relations'.\n            Multiple entries are separated with ';'.\n        metadata_sheet_name: Name of sheet where metadata are defined.\n            The first row contains column names 'Metadata name' and 'Value'\n            Supported 'Metadata names' are: 'Ontology IRI',\n            'Ontology vesion IRI', 'Ontology version Info', 'Title',\n            'Abstract', 'License', 'Comment', 'Author', 'Contributor'.\n            Multiple entries are separated with a semi-colon (`;`).\n        imports_sheet_name: Name of sheet where imported ontologies are\n            defined.\n            Column name is 'Imported ontologies'.\n            Fully resolvable URL or path to imported ontologies provided one\n            per row.\n        dataproperties_sheet_name: Name of sheet where data properties are\n            defined. The second row of this sheet should contain column names\n            that are supported. Currently these are 'prefLabel','altLabel',\n            'Elucidation', 'Comments', 'Examples', 'subPropertyOf',\n            'Domain', 'Range', 'dijointWith', 'equivalentTo'.\n        annotationproperties_sheet_name: Name of sheet where annotation\n            properties are defined. The second row of this sheet should contain\n            column names that are supported. Currently these are 'prefLabel',\n            'altLabel', 'Elucidation', 'Comments', 'Examples', 'subPropertyOf',\n            'Domain', 'Range'.\n        objectproperties_sheet_name: Name of sheet where object properties are\n            defined.The second row of this sheet should contain column names\n            that are supported. Currently these are 'prefLabel','altLabel',\n            'Elucidation', 'Comments', 'Examples', 'subPropertyOf',\n            'Domain', 'Range', 'inverseOf', 'dijointWith', 'equivalentTo'.\n        base_iri: Base IRI of the new ontology.\n        base_iri_from_metadata: Whether to use base IRI defined from metadata.\n        imports: List of imported ontologies.\n        catalog: Imported ontologies with (name, full path) key/value-pairs.\n        force: Forcibly make an ontology by skipping concepts\n            that are erroneously defined or other errors in the excel sheet.\n        input_ontology: Ontology that should be updated.\n            Default is None,\n            which means that a completely new ontology is generated.\n            If an input_ontology to be updated is provided,\n            the metadata sheet in the excel sheet will not be considered.\n\n\n    Returns:\n        A tuple with the:\n\n            * created ontology\n            * associated catalog of ontology names and resolvable path as dict\n            * a dictionary with lists of concepts that raise errors, with the\n              following keys:\n\n                - \"already_defined\": These are concepts (classes)\n                    that are already in the\n                    ontology, because they were already added in a\n                    previous line of the excelfile/pandas dataframe, or because\n                    it is already defined in an imported ontology with the same\n                    base_iri as the newly created ontology.\n                - \"in_imported_ontologies\": Concepts (classes)\n                    that are defined in the\n                    excel, but already exist in the imported ontologies.\n                - \"wrongly_defined\": Concepts (classes) that are given an\n                    invalid prefLabel (e.g. with a space in the name).\n                - \"missing_subClassOf\": Concepts (classes) that are missing\n                    parents. These concepts are added directly under owl:Thing.\n                - \"invalid_subClassOf\": Concepts (classes) with invalidly\n                    defined parents.\n                    These concepts are added directly under owl:Thing.\n                - \"nonadded_concepts\": List of all concepts (classes) that are\n                    not added,\n                    either because the prefLabel is invalid, or because the\n                    concept has already been added once or already exists in an\n                    imported ontology.\n                - \"obj_prop_already_defined\": Object properties that are already\n                    defined in the ontology.\n                - \"obj_prop_in_imported_ontologies\": Object properties that are\n                    defined in the excel, but already exist in the imported\n                    ontologies.\n                - \"obj_prop_wrongly_defined\": Object properties that are given\n                    an invalid prefLabel (e.g. with a space in the name).\n                - \"obj_prop_missing_subPropertyOf\": Object properties that are\n                    missing parents.\n                - \"obj_prop_invalid_subPropertyOf\": Object properties with\n                    invalidly defined parents.\n                - \"obj_prop_nonadded_entities\": List of all object properties\n                    that are not added, either because the prefLabel is invalid,\n                    or because the concept has already been added once or\n                    already exists in an imported ontology.\n                - \"obj_prop_errors_in_properties\": Object properties with\n                    invalidly defined properties.\n                - \"obj_prop_errors_in_range\": Object properties with invalidly\n                    defined range.\n                - \"obj_prop_errors_in_domain\": Object properties with invalidly\n                    defined domain.\n                - \"annot_prop_already_defined\": Annotation properties that are\n                    already defined in the ontology.\n                - \"annot_prop_in_imported_ontologies\":  Annotation properties\n                    that\n                    are defined in the excel, but already exist in the imported\n                    ontologies.\n                - \"annot_prop_wrongly_defined\": Annotation properties that are\n                    given an invalid prefLabel (e.g. with a space in the name).\n                - \"annot_prop_missing_subPropertyOf\": Annotation properties that\n                    are missing parents.\n                - \"annot_prop_invalid_subPropertyOf\": Annotation properties with\n                    invalidly defined parents.\n                - \"annot_prop_nonadded_entities\": List of all annotation\n                    properties that are not added, either because the prefLabel\n                    is invalid, or because the concept has already been added\n                    once or already exists in an imported ontology.\n                - \"annot_prop_errors_in_properties\": Annotation properties with\n                    invalidly defined properties.\n                - \"data_prop_already_defined\": Data properties that are already\n                    defined in the ontology.\n                - \"data_prop_in_imported_ontologies\": Data properties that are\n                    defined in the excel, but already exist in the imported\n                    ontologies.\n                - \"data_prop_wrongly_defined\":  Data properties that are given\n                    an invalid prefLabel (e.g. with a space in the name).\n                - \"data_prop_missing_subPropertyOf\": Data properties that are\n                    missing parents.\n                - \"data_prop_invalid_subPropertyOf\": Data properties with\n                    invalidly defined parents.\n                - \"data_prop_nonadded_entities\": List of all data properties\n                    that are not added, either because the prefLabel is invalid,\n                    or because the concept has already been added once or\n                    already exists in an imported ontology.\n                - \"data_prop_errors_in_properties\": Data properties with\n                    invalidly defined properties.\n                - \"data_prop_errors_in_range\": Data properties with invalidly\n                    defined range.\n                - \"data_prop_errors_in_domain\": Data properties with invalidly\n                    defined domain.\n\n    \"\"\"\n    web_protocol = \"http://\", \"https://\", \"ftp://\"\n\n    def _relative_to_absolute_paths(path):\n        if isinstance(path, str):\n            if not path.startswith(web_protocol):\n                path = os.path.dirname(excelpath) + \"/\" + str(path)\n        return path\n\n    try:\n        imports = pd.read_excel(\n            excelpath, sheet_name=imports_sheet_name, skiprows=[1]\n        )\n    except ValueError:\n        imports = pd.DataFrame()\n    else:\n        # Strip leading and trailing white spaces in paths\n        imports.replace(r\"^\\s+\", \"\", regex=True).replace(\n            r\"\\s+$\", \"\", regex=True\n        )\n        # Set empty strings to nan\n        imports = imports.replace(r\"^\\s*$\", np.nan, regex=True)\n        if \"Imported ontologies\" in imports.columns:\n            imports[\"Imported ontologies\"] = imports[\n                \"Imported ontologies\"\n            ].apply(_relative_to_absolute_paths)\n\n    # Read datafile TODO: Some magic to identify the header row\n    conceptdata = pd.read_excel(\n        excelpath, sheet_name=concept_sheet_name, skiprows=[0, 2]\n    )\n    try:\n        objectproperties = pd.read_excel(\n            excelpath, sheet_name=objectproperties_sheet_name, skiprows=[0, 2]\n        )\n        if \"prefLabel\" not in objectproperties.columns:\n            warnings.warn(\n                \"The 'prefLabel' column is missing in \"\n                f\"{objectproperties_sheet_name}. \"\n                \"New object properties will not be added to the ontology.\"\n            )\n            objectproperties = None\n    except ValueError:\n        warnings.warn(\n            f\"No sheet named {objectproperties_sheet_name} found \"\n            f\"in {excelpath}. \"\n            \"New object properties will not be added to the ontology.\"\n        )\n        objectproperties = None\n    try:\n        annotationproperties = pd.read_excel(\n            excelpath,\n            sheet_name=annotationproperties_sheet_name,\n            skiprows=[0, 2],\n        )\n        if \"prefLabel\" not in annotationproperties.columns:\n            warnings.warn(\n                \"The 'prefLabel' column is missing in \"\n                f\"{annotationproperties_sheet_name}. \"\n                \"New annotation properties will not be added to the ontology.\"\n            )\n            annotationproperties = None\n    except ValueError:\n        warnings.warn(\n            f\"No sheet named {annotationproperties_sheet_name} \"\n            f\"found in {excelpath}. \"\n            \"New annotation properties will not be added to the ontology.\"\n        )\n        annotationproperties = None\n\n    try:\n        dataproperties = pd.read_excel(\n            excelpath, sheet_name=dataproperties_sheet_name, skiprows=[0, 2]\n        )\n        if \"prefLabel\" not in dataproperties.columns:\n            warnings.warn(\n                \"The 'prefLabel' column is missing in \"\n                f\"{dataproperties_sheet_name}. \"\n                \"New data properties will not be added to the ontology.\"\n            )\n            dataproperties = None\n    except ValueError:\n        warnings.warn(\n            f\"No sheet named {dataproperties_sheet_name} found in {excelpath}. \"\n            \"New data properties will not be added to the ontology.\"\n        )\n        dataproperties = None\n\n    metadata = pd.read_excel(excelpath, sheet_name=metadata_sheet_name)\n    return create_ontology_from_pandas(\n        data=conceptdata,\n        objectproperties=objectproperties,\n        dataproperties=dataproperties,\n        annotationproperties=annotationproperties,\n        metadata=metadata,\n        imports=imports,\n        base_iri=base_iri,\n        base_iri_from_metadata=base_iri_from_metadata,\n        catalog=catalog,\n        force=force,\n        input_ontology=input_ontology,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.create_ontology_from_pandas","title":"<code>create_ontology_from_pandas(data, objectproperties, annotationproperties, dataproperties, metadata, imports, base_iri='http://emmo.info/emmo/domain/onto#', base_iri_from_metadata=True, catalog=None, force=False, input_ontology=None)</code>","text":"<p>Create an ontology from a pandas DataFrame.</p> <p>Check 'create_ontology_from_excel' for complete documentation.</p> Source code in <code>ontopy/excelparser.py</code> <pre><code>def create_ontology_from_pandas(  # pylint:disable=too-many-locals,too-many-branches,too-many-statements,too-many-arguments\n    data: pd.DataFrame,\n    objectproperties: pd.DataFrame,\n    annotationproperties: pd.DataFrame,\n    dataproperties: pd.DataFrame,\n    metadata: pd.DataFrame,\n    imports: pd.DataFrame,\n    base_iri: str = \"http://emmo.info/emmo/domain/onto#\",\n    base_iri_from_metadata: bool = True,\n    catalog: dict = None,\n    force: bool = False,\n    input_ontology: Union[ontopy.ontology.Ontology, None] = None,\n) -&gt; Tuple[ontopy.ontology.Ontology, dict]:\n    \"\"\"\n    Create an ontology from a pandas DataFrame.\n\n    Check 'create_ontology_from_excel' for complete documentation.\n    \"\"\"\n    # Get ontology to which new concepts should be added\n    if input_ontology:\n        onto = input_ontology\n        catalog = {}\n    else:  # Create new ontology\n        onto, catalog = get_metadata_from_dataframe(\n            metadata, base_iri, imports=imports\n        )\n\n        # Set given or default base_iri if base_iri_from_metadata is False.\n        if not base_iri_from_metadata:\n            onto.base_iri = base_iri\n    # onto.sync_python_names()\n    # prefLabel, label, and altLabel\n    # are default label annotations\n    onto.set_default_label_annotations()\n    # Add object properties\n    if objectproperties is not None:\n        objectproperties = _clean_dataframe(objectproperties)\n        (\n            onto,\n            objectproperties_with_errors,\n            added_objprop_indices,\n        ) = _add_entities(\n            onto=onto,\n            data=objectproperties,\n            entitytype=owlready2.ObjectPropertyClass,\n            force=force,\n        )\n\n    if annotationproperties is not None:\n        annotationproperties = _clean_dataframe(annotationproperties)\n        (\n            onto,\n            annotationproperties_with_errors,\n            added_annotprop_indices,\n        ) = _add_entities(\n            onto=onto,\n            data=annotationproperties,\n            entitytype=owlready2.AnnotationPropertyClass,\n            force=force,\n        )\n\n    if dataproperties is not None:\n        dataproperties = _clean_dataframe(dataproperties)\n        (\n            onto,\n            dataproperties_with_errors,\n            added_dataprop_indices,\n        ) = _add_entities(\n            onto=onto,\n            data=dataproperties,\n            entitytype=owlready2.DataPropertyClass,\n            force=force,\n        )\n    onto.sync_attributes(\n        name_policy=\"uuid\", name_prefix=\"EMMO_\", class_docstring=\"elucidation\"\n    )\n    # Clean up data frame with new concepts\n    data = _clean_dataframe(data)\n    # Add entities\n    onto, entities_with_errors, added_concept_indices = _add_entities(\n        onto=onto, data=data, entitytype=owlready2.ThingClass, force=force\n    )\n\n    # Add entity properties in a second loop\n    for index in added_concept_indices:\n        row = data.loc[index]\n        properties = row[\"Relations\"]\n        if properties == \"nan\":\n            properties = None\n        if isinstance(properties, str):\n            try:\n                entity = onto.get_by_label(row[\"prefLabel\"].strip())\n            except NoSuchLabelError:\n                pass\n            props = properties.split(\";\")\n            for prop in props:\n                try:\n                    entity.is_a.append(evaluate(onto, prop.strip()))\n                except pyparsing.ParseException as exc:\n                    warnings.warn(\n                        # This is currently not tested\n                        f\"Error in Property assignment for: '{entity}'. \"\n                        f\"Property to be Evaluated: '{prop}'. \"\n                        f\"{exc}\"\n                    )\n                    entities_with_errors[\"errors_in_properties\"].append(\n                        entity.name\n                    )\n                except NoSuchLabelError as exc:\n                    msg = (\n                        f\"Error in Property assignment for: {entity}. \"\n                        f\"Property to be Evaluated: {prop}. \"\n                        f\"{exc}\"\n                    )\n                    if force is True:\n                        warnings.warn(msg)\n                        entities_with_errors[\"errors_in_properties\"].append(\n                            entity.name\n                        )\n                    else:\n                        raise ExcelError(msg) from exc\n\n    # Add range and domain for object properties\n    if objectproperties is not None:\n        onto, objectproperties_with_errors = _add_range_domain(\n            onto=onto,\n            properties=objectproperties,\n            added_prop_indices=added_objprop_indices,\n            properties_with_errors=objectproperties_with_errors,\n            force=force,\n        )\n        for key, value in objectproperties_with_errors.items():\n            entities_with_errors[\"obj_prop_\" + key] = value\n    # Add range and domain for annotation properties\n    if annotationproperties is not None:\n        onto, annotationproperties_with_errors = _add_range_domain(\n            onto=onto,\n            properties=annotationproperties,\n            added_prop_indices=added_annotprop_indices,\n            properties_with_errors=annotationproperties_with_errors,\n            force=force,\n        )\n        for key, value in annotationproperties_with_errors.items():\n            entities_with_errors[\"annot_prop_\" + key] = value\n\n    # Add range and domain for data properties\n    if dataproperties is not None:\n        onto, dataproperties_with_errors = _add_range_domain(\n            onto=onto,\n            properties=dataproperties,\n            added_prop_indices=added_dataprop_indices,\n            properties_with_errors=dataproperties_with_errors,\n            force=force,\n        )\n        for key, value in dataproperties_with_errors.items():\n            entities_with_errors[\"data_prop_\" + key] = value\n\n    # Synchronise Python attributes to ontology\n    onto.sync_attributes(\n        name_policy=\"uuid\", name_prefix=\"EMMO_\", class_docstring=\"elucidation\"\n    )\n    onto.dir_label = False\n    entities_with_errors = {\n        key: set(value) for key, value in entities_with_errors.items()\n    }\n    return onto, catalog, entities_with_errors\n</code></pre>"},{"location":"api_reference/ontopy/excelparser/#ontopy.excelparser.get_metadata_from_dataframe","title":"<code>get_metadata_from_dataframe(metadata, base_iri, base_iri_from_metadata=True, imports=None, catalog=None)</code>","text":"<p>Create ontology with metadata from pd.DataFrame</p> Source code in <code>ontopy/excelparser.py</code> <pre><code>def get_metadata_from_dataframe(  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    metadata: pd.DataFrame,\n    base_iri: str,\n    base_iri_from_metadata: bool = True,\n    imports: pd.DataFrame = None,\n    catalog: dict = None,\n) -&gt; Tuple[ontopy.ontology.Ontology, dict]:\n    \"\"\"Create ontology with metadata from pd.DataFrame\"\"\"\n\n    # base_iri from metadata if it exists and base_iri_from_metadata\n    if base_iri_from_metadata:\n        try:\n            base_iris = _parse_literal(metadata, \"Ontology IRI\", metadata=True)\n            if len(base_iris) &gt; 1:\n                warnings.warn(\n                    \"More than one Ontology IRI given. The first was chosen.\"\n                )\n            base_iri = base_iris[0] + \"#\"\n        except (TypeError, ValueError, AttributeError, IndexError):\n            pass\n\n    # Create new ontology\n    onto = get_ontology(base_iri)\n\n    # Add imported ontologies\n    catalog = {} if catalog is None else catalog\n    locations = set()\n    for _, row in imports.iterrows():\n        # for location in imports:\n        location = row[\"Imported ontologies\"]\n        if not pd.isna(location) and location not in locations:\n            imported = onto.world.get_ontology(location).load()\n            onto.imported_ontologies.append(imported)\n            catalog[imported.base_iri.rstrip(\"#/\")] = location\n            try:\n                cat = read_catalog(location.rsplit(\"/\", 1)[0])\n                catalog.update(cat)\n            except ReadCatalogError:\n                warnings.warn(f\"Catalog for {imported} not found.\")\n            locations.add(location)\n        # set defined prefix\n        if not pd.isna(row[\"prefix\"]):\n            # set prefix for all ontologies with same 'base_iri_root'\n            if not pd.isna(row[\"base_iri_root\"]):\n                onto.set_common_prefix(\n                    iri_base=row[\"base_iri_root\"], prefix=row[\"prefix\"]\n                )\n            # If base_root not given, set prefix only to top ontology\n            else:\n                imported.prefix = row[\"prefix\"]\n\n    with onto:\n        # Add title\n        try:\n            _add_literal(\n                metadata,\n                onto.metadata.title,\n                \"Title\",\n                metadata=True,\n                only_one=True,\n            )\n        except AttributeError:\n            pass\n\n        # Add license\n        try:\n            _add_literal(\n                metadata, onto.metadata.license, \"License\", metadata=True\n            )\n        except AttributeError:\n            pass\n\n        # Add authors/creators\n        try:\n            _add_literal(\n                metadata, onto.metadata.creator, \"Author\", metadata=True\n            )\n        except AttributeError:\n            pass\n\n        # Add contributors\n        try:\n            _add_literal(\n                metadata,\n                onto.metadata.contributor,\n                \"Contributor\",\n                metadata=True,\n            )\n        except AttributeError:\n            pass\n\n        # Add versionInfo\n        try:\n            _add_literal(\n                metadata,\n                onto.metadata.versionInfo,\n                \"Ontology version Info\",\n                metadata=True,\n                only_one=True,\n            )\n        except AttributeError:\n            pass\n    return onto, catalog\n</code></pre>"},{"location":"api_reference/ontopy/graph/","title":"graph","text":"<p>A module for visualising ontologies using graphviz.</p>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph","title":"<code> OntoGraph        </code>","text":"<p>Class for visualising an ontology.</p>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph--parameters","title":"Parameters","text":"<p>ontology : ontopy.Ontology instance     Ontology to visualize. root : None | graph.ALL | string | owlready2.ThingClass instance     Name or owlready2 entity of root node to plot subgraph     below.  If <code>root</code> is <code>graph.ALL</code>, all classes will be included     in the subgraph. leaves : None | sequence     A sequence of leaf node names for generating sub-graphs. entities : None | sequence     A sequence of entities to add to the graph. relations : \"all\" | str | None | sequence     Sequence of relations to visualise.  If \"all\", means to include     all relations. style : None | dict | \"default\"     A dict mapping the name of the different graphical elements     to dicts of dot graph attributes. Supported graphical elements     include:       - graphtype : \"Digraph\" | \"Graph\"       - graph : graph attributes (G)       - class : nodes for classes (N)       - root : additional attributes for root nodes (N)       - leaf : additional attributes for leaf nodes (N)       - defined_class : nodes for defined classes (N)       - class_construct : nodes for class constructs (N)       - individual : nodes for invididuals (N)       - object_property : nodes for object properties (N)       - data_property : nodes for data properties (N)       - annotation_property : nodes for annotation properties (N)       - added_node : nodes added because <code>addnodes</code> is true (N)       - isA : edges for isA relations (E)       - not : edges for not class constructs (E)       - equivalent_to : edges for equivalent_to relations (E)       - disjoint_with : edges for disjoint_with relations (E)       - inverse_of : edges for inverse_of relations (E)       - default_relation : default edges relations and restrictions (E)       - relations : dict of styles for different relations (E)       - inverse : default edges for inverse relations (E)       - default_dataprop : default edges for data properties (E)       - nodes : attribute for individual nodes (N)       - edges : attribute for individual edges (E)     If style is None or \"default\", the default style is used.     See https://www.graphviz.org/doc/info/attrs.html edgelabels : None | bool | dict     Whether to add labels to the edges of the generated graph.     It is also possible to provide a dict mapping the     full labels (with cardinality stripped off for restrictions)     to some abbreviations. addnodes : bool     Whether to add missing target nodes in relations. addconstructs : bool     Whether to add nodes representing class constructs. included_namespaces : sequence     In combination with <code>root</code>, only include classes with one of     the listed namespaces.  If empty (the default), nothing is     excluded. included_ontologies : sequence     In combination with <code>root</code>, only include classes defined in     one of the listed ontologies.  If empty (default), nothing is     excluded. parents : int     Include <code>parents</code> levels of parents. excluded_nodes : None | sequence     Sequence of labels of nodes to exclude. graph : None | pydot.Dot instance     Graphviz Digraph object to plot into.  If None, a new graph object     is created using the keyword arguments. imported : bool     Whether to include imported classes if <code>entities</code> is None. kwargs :     Passed to graphviz.Digraph.</p> Source code in <code>ontopy/graph.py</code> <pre><code>class OntoGraph:  # pylint: disable=too-many-instance-attributes\n    \"\"\"Class for visualising an ontology.\n\n    Parameters\n    ----------\n    ontology : ontopy.Ontology instance\n        Ontology to visualize.\n    root : None | graph.ALL | string | owlready2.ThingClass instance\n        Name or owlready2 entity of root node to plot subgraph\n        below.  If `root` is `graph.ALL`, all classes will be included\n        in the subgraph.\n    leaves : None | sequence\n        A sequence of leaf node names for generating sub-graphs.\n    entities : None | sequence\n        A sequence of entities to add to the graph.\n    relations : \"all\" | str | None | sequence\n        Sequence of relations to visualise.  If \"all\", means to include\n        all relations.\n    style : None | dict | \"default\"\n        A dict mapping the name of the different graphical elements\n        to dicts of dot graph attributes. Supported graphical elements\n        include:\n          - graphtype : \"Digraph\" | \"Graph\"\n          - graph : graph attributes (G)\n          - class : nodes for classes (N)\n          - root : additional attributes for root nodes (N)\n          - leaf : additional attributes for leaf nodes (N)\n          - defined_class : nodes for defined classes (N)\n          - class_construct : nodes for class constructs (N)\n          - individual : nodes for invididuals (N)\n          - object_property : nodes for object properties (N)\n          - data_property : nodes for data properties (N)\n          - annotation_property : nodes for annotation properties (N)\n          - added_node : nodes added because `addnodes` is true (N)\n          - isA : edges for isA relations (E)\n          - not : edges for not class constructs (E)\n          - equivalent_to : edges for equivalent_to relations (E)\n          - disjoint_with : edges for disjoint_with relations (E)\n          - inverse_of : edges for inverse_of relations (E)\n          - default_relation : default edges relations and restrictions (E)\n          - relations : dict of styles for different relations (E)\n          - inverse : default edges for inverse relations (E)\n          - default_dataprop : default edges for data properties (E)\n          - nodes : attribute for individual nodes (N)\n          - edges : attribute for individual edges (E)\n        If style is None or \"default\", the default style is used.\n        See https://www.graphviz.org/doc/info/attrs.html\n    edgelabels : None | bool | dict\n        Whether to add labels to the edges of the generated graph.\n        It is also possible to provide a dict mapping the\n        full labels (with cardinality stripped off for restrictions)\n        to some abbreviations.\n    addnodes : bool\n        Whether to add missing target nodes in relations.\n    addconstructs : bool\n        Whether to add nodes representing class constructs.\n    included_namespaces : sequence\n        In combination with `root`, only include classes with one of\n        the listed namespaces.  If empty (the default), nothing is\n        excluded.\n    included_ontologies : sequence\n        In combination with `root`, only include classes defined in\n        one of the listed ontologies.  If empty (default), nothing is\n        excluded.\n    parents : int\n        Include `parents` levels of parents.\n    excluded_nodes : None | sequence\n        Sequence of labels of nodes to exclude.\n    graph : None | pydot.Dot instance\n        Graphviz Digraph object to plot into.  If None, a new graph object\n        is created using the keyword arguments.\n    imported : bool\n        Whether to include imported classes if `entities` is None.\n    kwargs :\n        Passed to graphviz.Digraph.\n    \"\"\"\n\n    def __init__(  # pylint: disable=too-many-arguments,too-many-locals\n        self,\n        ontology,\n        root=None,\n        leaves=None,\n        entities=None,\n        relations=\"isA\",\n        style=None,\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        included_namespaces=(),\n        included_ontologies=(),\n        parents=0,\n        excluded_nodes=None,\n        graph=None,\n        imported=False,\n        **kwargs,\n    ):\n        if style is None or style == \"default\":\n            style = _default_style\n\n        if graph is None:\n            graphtype = style.get(\"graphtype\", \"Digraph\")\n            dotcls = getattr(graphviz, graphtype)\n            graph_attr = kwargs.pop(\"graph_attr\", {})\n            for key, value in style.get(\"graph\", {}).items():\n                graph_attr.setdefault(key, value)\n            self.dot = dotcls(graph_attr=graph_attr, **kwargs)\n            self.nodes = set()\n            self.edges = set()\n        else:\n            if ontology != graph.ontology:\n                raise ValueError(\n                    \"the same ontology must be used when extending a graph\"\n                )\n            self.dot = graph.dot.copy()\n            self.nodes = graph.nodes.copy()\n            self.edges = graph.edges.copy()\n\n        self.ontology = ontology\n        self.relations = set(\n            [relations] if isinstance(relations, str) else relations\n        )\n        self.style = style\n        self.edgelabels = edgelabels\n        self.addnodes = addnodes\n        self.addconstructs = addconstructs\n        self.excluded_nodes = set(excluded_nodes) if excluded_nodes else set()\n        self.imported = imported\n\n        if root == ALL:\n            self.add_entities(\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n            )\n        elif root:\n            self.add_branch(\n                root,\n                leaves,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n                included_namespaces=included_namespaces,\n                included_ontologies=included_ontologies,\n            )\n            if parents:\n                self.add_parents(\n                    root,\n                    levels=parents,\n                    relations=relations,\n                    edgelabels=edgelabels,\n                    addnodes=addnodes,\n                    addconstructs=addconstructs,\n                )\n\n        if entities:\n            self.add_entities(\n                entities=entities,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n            )\n\n    def add_entities(  # pylint: disable=too-many-arguments\n        self,\n        entities=None,\n        relations=\"isA\",\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        nodeattrs=None,\n        **attrs,\n    ):\n        \"\"\"Adds a sequence of entities to the graph.  If `entities` is None,\n        all classes are added to the graph.\n\n        `nodeattrs` is a dict mapping node names to are attributes for\n        dedicated nodes.\n        \"\"\"\n        if entities is None:\n            entities = self.ontology.classes(imported=self.imported)\n        self.add_nodes(entities, nodeattrs=nodeattrs, **attrs)\n        self.add_edges(\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            **attrs,\n        )\n\n    def add_branch(  # pylint: disable=too-many-arguments,too-many-locals\n        self,\n        root,\n        leaves=None,\n        include_leaves=True,\n        strict_leaves=False,\n        exclude=None,\n        relations=\"isA\",\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        included_namespaces=(),\n        included_ontologies=(),\n        include_parents=\"closest\",\n        **attrs,\n    ):\n        \"\"\"Adds branch under `root` ending at any entity included in the\n        sequence `leaves`.  If `include_leaves` is true, leaf classes are\n        also included.\"\"\"\n        if leaves is None:\n            leaves = ()\n        classes = self.ontology.get_branch(\n            root=root,\n            leaves=leaves,\n            include_leaves=include_leaves,\n            strict_leaves=strict_leaves,\n            exclude=exclude,\n        )\n\n        classes = filter_classes(\n            classes,\n            included_namespaces=included_namespaces,\n            included_ontologies=included_ontologies,\n        )\n\n        nodeattrs = {}\n        nodeattrs[get_label(root)] = self.style.get(\"root\", {})\n        for leaf in leaves:\n            nodeattrs[get_label(leaf)] = self.style.get(\"leaf\", {})\n\n        self.add_entities(\n            entities=classes,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            nodeattrs=nodeattrs,\n            **attrs,\n        )\n        closest_ancestors = False\n        ancestor_generations = None\n        if include_parents == \"closest\":\n            closest_ancestors = True\n        elif isinstance(include_parents, int):\n            ancestor_generations = include_parents\n        parents = self.ontology.get_ancestors(\n            classes,\n            closest=closest_ancestors,\n            generations=ancestor_generations,\n            strict=True,\n        )\n        if parents:\n            for parent in parents:\n                nodeattrs[get_label(parent)] = self.style.get(\"parent_node\", {})\n            self.add_entities(\n                entities=parents,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n                nodeattrs=nodeattrs,\n                **attrs,\n            )\n\n    def add_parents(  # pylint: disable=too-many-arguments\n        self,\n        name,\n        levels=1,\n        relations=\"isA\",\n        edgelabels=None,\n        addnodes=False,\n        addconstructs=False,\n        **attrs,\n    ):\n        \"\"\"Add `levels` levels of strict parents of entity `name`.\"\"\"\n\n        def addparents(entity, nodes, parents):\n            if nodes &gt; 0:\n                for parent in entity.get_parents(strict=True):\n                    parents.add(parent)\n                    addparents(parent, nodes - 1, parents)\n\n        entity = self.ontology[name] if isinstance(name, str) else name\n        parents = set()\n        addparents(entity, levels, parents)\n        self.add_entities(\n            entities=parents,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            **attrs,\n        )\n\n    def add_node(self, name, nodeattrs=None, **attrs):\n        \"\"\"Add node with given name. `attrs` are graphviz node attributes.\"\"\"\n        entity = self.ontology[name] if isinstance(name, str) else name\n        label = get_label(entity)\n        if label not in self.nodes.union(self.excluded_nodes):\n            kwargs = self.get_node_attrs(\n                entity, nodeattrs=nodeattrs, attrs=attrs\n            )\n            if hasattr(entity, \"iri\"):\n                kwargs.setdefault(\"URL\", entity.iri)\n            self.dot.node(label, label=label, **kwargs)\n            self.nodes.add(label)\n\n    def add_nodes(self, names, nodeattrs, **attrs):\n        \"\"\"Add nodes with given names. `attrs` are graphviz node attributes.\"\"\"\n        for name in names:\n            self.add_node(name, nodeattrs=nodeattrs, **attrs)\n\n    def add_edge(self, subject, predicate, obj, edgelabel=None, **attrs):\n        \"\"\"Add edge corresponding for ``(subject, predicate, object)``\n        triplet.\"\"\"\n        subject = subject if isinstance(subject, str) else get_label(subject)\n        predicate = (\n            predicate if isinstance(predicate, str) else get_label(predicate)\n        )\n        obj = obj if isinstance(obj, str) else get_label(obj)\n        if subject in self.excluded_nodes or obj in self.excluded_nodes:\n            return\n        if not isinstance(subject, str) or not isinstance(obj, str):\n            raise TypeError(\"`subject` and `object` must be strings\")\n        if subject not in self.nodes:\n            raise RuntimeError(f'`subject` \"{subject}\" must have been added')\n        if obj not in self.nodes:\n            raise RuntimeError(f'`object` \"{obj}\" must have been added')\n        key = (subject, predicate, obj)\n        if key not in self.edges:\n            relations = self.style.get(\"relations\", {})\n            rels = set(\n                self.ontology[_] for _ in relations if _ in self.ontology\n            )\n            if (edgelabel is None) and (\n                (predicate in rels) or (predicate == \"isA\")\n            ):\n                edgelabel = self.edgelabels\n            label = None\n            if edgelabel is None:\n                tokens = predicate.split()\n                if len(tokens) == 2 and tokens[1] in (\"some\", \"only\"):\n                    label = f\"{tokens[0]} {tokens[1]}\"\n                elif len(tokens) == 3 and tokens[1] in (\n                    \"exactly\",\n                    \"min\",\n                    \"max\",\n                ):\n                    label = f\"{tokens[0]} {tokens[1]} {tokens[2]}\"\n            elif isinstance(edgelabel, str):\n                label = edgelabel\n            elif isinstance(edgelabel, dict):\n                label = edgelabel.get(predicate, predicate)\n            elif edgelabel:\n                label = predicate\n            kwargs = self.get_edge_attrs(predicate, attrs=attrs)\n            self.dot.edge(subject, obj, label=label, **kwargs)\n            self.edges.add(key)\n\n    def add_source_edges(  # pylint: disable=too-many-arguments,too-many-branches\n        self,\n        source,\n        relations=None,\n        edgelabels=None,\n        addnodes=None,\n        addconstructs=None,\n        **attrs,\n    ):\n        \"\"\"Adds all relations originating from entity `source` who's type\n        are listed in `relations`.\"\"\"\n        if relations is None:\n            relations = self.relations\n        elif isinstance(relations, str):\n            relations = set([relations])\n        else:\n            relations = set(relations)\n\n        edgelabels = self.edgelabels if edgelabels is None else edgelabels\n        addconstructs = (\n            self.addconstructs if addconstructs is None else addconstructs\n        )\n\n        entity = self.ontology[source] if isinstance(source, str) else source\n        label = get_label(entity)\n        for relation in entity.is_a:\n            # isA\n            if isinstance(\n                relation, (owlready2.ThingClass, owlready2.ObjectPropertyClass)\n            ):\n                if \"all\" in relations or \"isA\" in relations:\n                    rlabel = get_label(relation)\n                    # FIXME - we actually want to include individuals...\n                    if isinstance(entity, owlready2.Thing):\n                        continue\n                    if relation not in entity.get_parents(strict=True):\n                        continue\n                    if not self.add_missing_node(relation, addnodes=addnodes):\n                        continue\n                    self.add_edge(\n                        subject=label,\n                        predicate=\"isA\",\n                        obj=rlabel,\n                        edgelabel=edgelabels,\n                        **attrs,\n                    )\n\n            # restriction\n            elif isinstance(relation, owlready2.Restriction):\n                rname = get_label(relation.property)\n                if \"all\" in relations or rname in relations:\n                    rlabel = f\"{rname} {typenames[relation.type]}\"\n                    if isinstance(relation.value, owlready2.ThingClass):\n                        obj = get_label(relation.value)\n                        if not self.add_missing_node(relation.value, addnodes):\n                            continue\n                    elif (\n                        isinstance(relation.value, owlready2.ClassConstruct)\n                        and self.addconstructs\n                    ):\n                        obj = self.add_class_construct(relation.value)\n                    else:\n                        continue\n                    pred = asstring(\n                        relation, exclude_object=True, ontology=self.ontology\n                    )\n                    self.add_edge(\n                        label, pred, obj, edgelabel=edgelabels, **attrs\n                    )\n\n            # inverse\n            if isinstance(relation, owlready2.Inverse):\n                if \"all\" in relations or \"inverse\" in relations:\n                    rlabel = get_label(relation)\n                    if not self.add_missing_node(relation, addnodes=addnodes):\n                        continue\n                    if relation not in entity.get_parents(strict=True):\n                        continue\n                    self.add_edge(\n                        subject=label,\n                        predicate=\"inverse\",\n                        obj=rlabel,\n                        edgelabel=edgelabels,\n                        **attrs,\n                    )\n\n    def add_edges(  # pylint: disable=too-many-arguments\n        self,\n        sources=None,\n        relations=None,\n        edgelabels=None,\n        addnodes=None,\n        addconstructs=None,\n        **attrs,\n    ):\n        \"\"\"Adds all relations originating from entities `sources` who's type\n        are listed in `relations`.  If `sources` is None, edges are added\n        between all current nodes.\"\"\"\n        if sources is None:\n            sources = self.nodes\n        for source in sources.copy():\n            self.add_source_edges(\n                source,\n                relations=relations,\n                edgelabels=edgelabels,\n                addnodes=addnodes,\n                addconstructs=addconstructs,\n                **attrs,\n            )\n\n    def add_missing_node(self, name, addnodes=None):\n        \"\"\"Checks if `name` corresponds to a missing node and add it if\n        `addnodes` is true.\n\n        Returns true if the node exists or is added, false otherwise.\"\"\"\n        addnodes = self.addnodes if addnodes is None else addnodes\n        entity = self.ontology[name] if isinstance(name, str) else name\n        label = get_label(entity)\n        if label not in self.nodes:\n            if addnodes:\n                self.add_node(entity, **self.style.get(\"added_node\", {}))\n            else:\n                return False\n        return True\n\n    def add_class_construct(self, construct):\n        \"\"\"Adds class construct and return its label.\"\"\"\n        self.add_node(construct, **self.style.get(\"class_construct\", {}))\n        label = get_label(construct)\n        if isinstance(construct, owlready2.Or):\n            for cls in construct.Classes:\n                clslabel = get_label(cls)\n                if clslabel not in self.nodes and self.addnodes:\n                    self.add_node(cls)\n                if clslabel in self.nodes:\n                    self.add_edge(get_label(cls), \"isA\", label)\n        elif isinstance(construct, owlready2.And):\n            for cls in construct.Classes:\n                clslabel = get_label(cls)\n                if clslabel not in self.nodes and self.addnodes:\n                    self.add_node(cls)\n                if clslabel in self.nodes:\n                    self.add_edge(label, \"isA\", get_label(cls))\n        elif isinstance(construct, owlready2.Not):\n            clslabel = get_label(construct.Class)\n            if clslabel not in self.nodes and self.addnodes:\n                self.add_node(construct.Class)\n            if clslabel in self.nodes:\n                self.add_edge(clslabel, \"not\", label)\n        # Neither and nor inverse constructs are\n        return label\n\n    def get_node_attrs(self, name, nodeattrs, attrs):\n        \"\"\"Returns attributes for node or edge `name`.  `attrs` overrides\n        the default style.\"\"\"\n        entity = self.ontology[name] if isinstance(name, str) else name\n        label = get_label(entity)\n        # class\n        if isinstance(entity, owlready2.ThingClass):\n            if entity.is_defined:\n                kwargs = self.style.get(\"defined_class\", {})\n            else:\n                kwargs = self.style.get(\"class\", {})\n        # class construct\n        elif isinstance(entity, owlready2.ClassConstruct):\n            kwargs = self.style.get(\"class_construct\", {})\n        # individual\n        elif isinstance(entity, owlready2.Thing):\n            kwargs = self.style.get(\"individual\", {})\n        # object property\n        elif isinstance(entity, owlready2.ObjectPropertyClass):\n            kwargs = self.style.get(\"object_property\", {})\n        # data property\n        elif isinstance(entity, owlready2.DataPropertyClass):\n            kwargs = self.style.get(\"data_property\", {})\n        # annotation property\n        elif isinstance(entity, owlready2.AnnotationPropertyClass):\n            kwargs = self.style.get(\"annotation_property\", {})\n        else:\n            raise TypeError(f\"Unknown entity type: {entity!r}\")\n        kwargs = kwargs.copy()\n        kwargs.update(self.style.get(\"nodes\", {}).get(label, {}))\n        if nodeattrs:\n            kwargs.update(nodeattrs.get(label, {}))\n        kwargs.update(attrs)\n        return kwargs\n\n    def _relation_styles(\n        self, entity: ThingClass, relations: dict, rels: set\n    ) -&gt; dict:\n        \"\"\"Helper function that returns the styles of the relations\n        to be used.\n\n        Parameters:\n            entity: the entity of the parent relation\n            relations: relations with default styles\n            rels: relations to be considered that have default styles,\n                either for the prefLabel or one of the altLabels\n        \"\"\"\n        for relation in entity.mro():\n            if relation in rels:\n                if str(get_label(relation)) in relations:\n                    rattrs = relations[str(get_label(relation))]\n                else:\n                    for alt_label in relation.get_annotations()[\"altLabel\"]:\n                        rattrs = relations[str(alt_label)]\n\n                break\n        else:\n            warnings.warn(\n                f\"Style not defined for relation {get_label(entity)}. \"\n                \"Resorting to default style.\"\n            )\n            rattrs = self.style.get(\"default_relation\", {})\n        return rattrs\n\n    def get_edge_attrs(self, predicate: str, attrs: dict) -&gt; dict:\n        \"\"\"Returns attributes for node or edge `predicate`.  `attrs` overrides\n        the default style.\n\n        Parameters:\n            predicate: predicate to get attributes for\n            attrs: desired attributes to override default\n        \"\"\"\n        # given type\n        types = (\"isA\", \"equivalent_to\", \"disjoint_with\", \"inverse_of\")\n        if predicate in types:\n            kwargs = self.style.get(predicate, {}).copy()\n        else:\n            kwargs = {}\n            name = predicate.split(None, 1)[0]\n            match = re.match(r\"Inverse\\((.*)\\)\", name)\n            if match:\n                (name,) = match.groups()\n                attrs = attrs.copy()\n                for key, value in self.style.get(\"inverse\", {}).items():\n                    attrs.setdefault(key, value)\n            if not isinstance(name, str) or name in self.ontology:\n                entity = self.ontology[name] if isinstance(name, str) else name\n                relations = self.style.get(\"relations\", {})\n                rels = set(\n                    self.ontology[_] for _ in relations if _ in self.ontology\n                )\n                rattrs = self._relation_styles(entity, relations, rels)\n\n                # object property\n                if isinstance(\n                    entity,\n                    (owlready2.ObjectPropertyClass, owlready2.ObjectProperty),\n                ):\n                    kwargs = self.style.get(\"default_relation\", {}).copy()\n                    kwargs.update(rattrs)\n                # data property\n                elif isinstance(\n                    entity,\n                    (owlready2.DataPropertyClass, owlready2.DataProperty),\n                ):\n                    kwargs = self.style.get(\"default_dataprop\", {}).copy()\n                    kwargs.update(rattrs)\n                else:\n                    raise TypeError(f\"Unknown entity type: {entity!r}\")\n        kwargs.update(self.style.get(\"edges\", {}).get(predicate, {}))\n        kwargs.update(attrs)\n        return kwargs\n\n    def add_legend(self, relations=None):\n        \"\"\"Adds legend for specified relations to the graph.\n\n        If `relations` is \"all\", the legend will contain all relations\n        that are defined in the style.  By default the legend will\n        only contain relations that are currently included in the\n        graph.\n\n        Hence, you usually want to call add_legend() as the last method\n        before saving or displaying.\n\n        Relations with defined style will be bold in legend.\n        Relations that have inherited style from parent relation\n        will not be bold.\n        \"\"\"\n        rels = self.style.get(\"relations\", {})\n        if relations is None:\n            relations = self.get_relations(sort=True)\n        elif relations == \"all\":\n            relations = [\"isA\"] + list(rels.keys()) + [\"inverse\"]\n        elif isinstance(relations, str):\n            relations = relations.split(\",\")\n\n        nrelations = len(relations)\n        if nrelations == 0:\n            return\n\n        table = (\n            '&lt;&lt;table border=\"0\" cellpadding=\"2\" cellspacing=\"0\" cellborder=\"0\"&gt;'\n        )\n        label1 = [table]\n        label2 = [table]\n        for index, relation in enumerate(relations):\n            if (relation in rels) or (relation == \"isA\"):\n                label1.append(\n                    f'&lt;tr&gt;&lt;td align=\"right\" '\n                    f'port=\"i{index}\"&gt;&lt;b&gt;{relation}&lt;/b&gt;&lt;/td&gt;&lt;/tr&gt;'\n                )\n            else:\n                label1.append(\n                    f'&lt;tr&gt;&lt;td align=\"right\" '\n                    f'port=\"i{index}\"&gt;{relation}&lt;/td&gt;&lt;/tr&gt;'\n                )\n            label2.append(f'&lt;tr&gt;&lt;td port=\"i{index}\"&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt;')\n        label1.append(\"&lt;/table&gt;&gt;\")\n        label2.append(\"&lt;/table&gt;&gt;\")\n        self.dot.node(\"key1\", label=\"\\n\".join(label1), shape=\"plaintext\")\n        self.dot.node(\"key2\", label=\"\\n\".join(label2), shape=\"plaintext\")\n\n        rankdir = self.dot.graph_attr.get(\"rankdir\", \"TB\")\n        constraint = \"false\" if rankdir in (\"TB\", \"BT\") else \"true\"\n        inv = rankdir in (\"BT\",)\n\n        for index in range(nrelations):\n            relation = (\n                relations[nrelations - 1 - index] if inv else relations[index]\n            )\n            if relation == \"inverse\":\n                kwargs = self.style.get(\"inverse\", {}).copy()\n            else:\n                kwargs = self.get_edge_attrs(relation, {}).copy()\n            kwargs[\"constraint\"] = constraint\n            with self.dot.subgraph(name=f\"sub{index}\") as subgraph:\n                subgraph.attr(rank=\"same\")\n                if rankdir in (\"BT\", \"LR\"):\n                    self.dot.edge(\n                        f\"key1:i{index}:e\", f\"key2:i{index}:w\", **kwargs\n                    )\n                else:\n                    self.dot.edge(\n                        f\"key2:i{index}:w\", f\"key1:i{index}:e\", **kwargs\n                    )\n\n    def get_relations(self, sort=True):\n        \"\"\"Returns a set of relations in current graph.  If `sort` is true,\n        a sorted list is returned.\"\"\"\n        relations = set()\n        for _, predicate, _ in self.edges:\n            if predicate.startswith(\"Inverse\"):\n                relations.add(\"inverse\")\n                match = re.match(r\"Inverse\\((.+)\\)\", predicate)\n                if match is None:\n                    raise ValueError(\n                        \"Could unexpectedly not find the inverse relation \"\n                        f\"just added in: {predicate}\"\n                    )\n                relations.add(match.groups()[0])\n            else:\n                relations.add(predicate.split(None, 1)[0])\n\n        # Sort, but place 'isA' first and 'inverse' last\n        if sort:\n            start, end = [], []\n            if \"isA\" in relations:\n                relations.remove(\"isA\")\n                start.append(\"isA\")\n            if \"inverse\" in relations:\n                relations.remove(\"inverse\")\n                end.append(\"inverse\")\n            relations = start + sorted(relations) + end\n\n        return relations\n\n    def save(self, filename, fmt=None, **kwargs):\n        \"\"\"Saves graph to `filename`.  If format is not given, it is\n        inferred from `filename`.\"\"\"\n        base = os.path.splitext(filename)[0]\n        fmt = get_format(filename, default=\"svg\", fmt=fmt)\n        kwargs.setdefault(\"cleanup\", True)\n        if fmt in (\"graphviz\", \"gv\"):\n            if \"dictionary\" in kwargs:\n                self.dot.save(filename, dictionary=kwargs[\"dictionary\"])\n            else:\n                self.dot.save(filename)\n        else:\n            fmt = kwargs.pop(\"format\", fmt)\n            self.dot.render(base, format=fmt, **kwargs)\n\n    def view(self):\n        \"\"\"Shows the graph in a viewer.\"\"\"\n        self.dot.view(cleanup=True)\n\n    def get_figsize(self):\n        \"\"\"Returns the default figure size (width, height) in points.\"\"\"\n        with tempfile.TemporaryDirectory() as tmpdir:\n            tmpfile = os.path.join(tmpdir, \"graph.svg\")\n            self.save(tmpfile)\n            xml = ET.parse(tmpfile)\n            svg = xml.getroot()\n            width = svg.attrib[\"width\"]\n            height = svg.attrib[\"height\"]\n            if not width.endswith(\"pt\"):\n                # ensure that units are in points\n                raise ValueError(\n                    \"The width attribute should always be given in 'pt', \"\n                    f\"but it is: {width}\"\n                )\n\n            def asfloat(string):\n                return float(re.match(r\"^[\\d.]+\", string).group())\n\n        return asfloat(width), asfloat(height)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_branch","title":"<code>add_branch(self, root, leaves=None, include_leaves=True, strict_leaves=False, exclude=None, relations='isA', edgelabels=None, addnodes=False, addconstructs=False, included_namespaces=(), included_ontologies=(), include_parents='closest', **attrs)</code>","text":"<p>Adds branch under <code>root</code> ending at any entity included in the sequence <code>leaves</code>.  If <code>include_leaves</code> is true, leaf classes are also included.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_branch(  # pylint: disable=too-many-arguments,too-many-locals\n    self,\n    root,\n    leaves=None,\n    include_leaves=True,\n    strict_leaves=False,\n    exclude=None,\n    relations=\"isA\",\n    edgelabels=None,\n    addnodes=False,\n    addconstructs=False,\n    included_namespaces=(),\n    included_ontologies=(),\n    include_parents=\"closest\",\n    **attrs,\n):\n    \"\"\"Adds branch under `root` ending at any entity included in the\n    sequence `leaves`.  If `include_leaves` is true, leaf classes are\n    also included.\"\"\"\n    if leaves is None:\n        leaves = ()\n    classes = self.ontology.get_branch(\n        root=root,\n        leaves=leaves,\n        include_leaves=include_leaves,\n        strict_leaves=strict_leaves,\n        exclude=exclude,\n    )\n\n    classes = filter_classes(\n        classes,\n        included_namespaces=included_namespaces,\n        included_ontologies=included_ontologies,\n    )\n\n    nodeattrs = {}\n    nodeattrs[get_label(root)] = self.style.get(\"root\", {})\n    for leaf in leaves:\n        nodeattrs[get_label(leaf)] = self.style.get(\"leaf\", {})\n\n    self.add_entities(\n        entities=classes,\n        relations=relations,\n        edgelabels=edgelabels,\n        addnodes=addnodes,\n        addconstructs=addconstructs,\n        nodeattrs=nodeattrs,\n        **attrs,\n    )\n    closest_ancestors = False\n    ancestor_generations = None\n    if include_parents == \"closest\":\n        closest_ancestors = True\n    elif isinstance(include_parents, int):\n        ancestor_generations = include_parents\n    parents = self.ontology.get_ancestors(\n        classes,\n        closest=closest_ancestors,\n        generations=ancestor_generations,\n        strict=True,\n    )\n    if parents:\n        for parent in parents:\n            nodeattrs[get_label(parent)] = self.style.get(\"parent_node\", {})\n        self.add_entities(\n            entities=parents,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            nodeattrs=nodeattrs,\n            **attrs,\n        )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_class_construct","title":"<code>add_class_construct(self, construct)</code>","text":"<p>Adds class construct and return its label.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_class_construct(self, construct):\n    \"\"\"Adds class construct and return its label.\"\"\"\n    self.add_node(construct, **self.style.get(\"class_construct\", {}))\n    label = get_label(construct)\n    if isinstance(construct, owlready2.Or):\n        for cls in construct.Classes:\n            clslabel = get_label(cls)\n            if clslabel not in self.nodes and self.addnodes:\n                self.add_node(cls)\n            if clslabel in self.nodes:\n                self.add_edge(get_label(cls), \"isA\", label)\n    elif isinstance(construct, owlready2.And):\n        for cls in construct.Classes:\n            clslabel = get_label(cls)\n            if clslabel not in self.nodes and self.addnodes:\n                self.add_node(cls)\n            if clslabel in self.nodes:\n                self.add_edge(label, \"isA\", get_label(cls))\n    elif isinstance(construct, owlready2.Not):\n        clslabel = get_label(construct.Class)\n        if clslabel not in self.nodes and self.addnodes:\n            self.add_node(construct.Class)\n        if clslabel in self.nodes:\n            self.add_edge(clslabel, \"not\", label)\n    # Neither and nor inverse constructs are\n    return label\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_edge","title":"<code>add_edge(self, subject, predicate, obj, edgelabel=None, **attrs)</code>","text":"<p>Add edge corresponding for <code>(subject, predicate, object)</code> triplet.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_edge(self, subject, predicate, obj, edgelabel=None, **attrs):\n    \"\"\"Add edge corresponding for ``(subject, predicate, object)``\n    triplet.\"\"\"\n    subject = subject if isinstance(subject, str) else get_label(subject)\n    predicate = (\n        predicate if isinstance(predicate, str) else get_label(predicate)\n    )\n    obj = obj if isinstance(obj, str) else get_label(obj)\n    if subject in self.excluded_nodes or obj in self.excluded_nodes:\n        return\n    if not isinstance(subject, str) or not isinstance(obj, str):\n        raise TypeError(\"`subject` and `object` must be strings\")\n    if subject not in self.nodes:\n        raise RuntimeError(f'`subject` \"{subject}\" must have been added')\n    if obj not in self.nodes:\n        raise RuntimeError(f'`object` \"{obj}\" must have been added')\n    key = (subject, predicate, obj)\n    if key not in self.edges:\n        relations = self.style.get(\"relations\", {})\n        rels = set(\n            self.ontology[_] for _ in relations if _ in self.ontology\n        )\n        if (edgelabel is None) and (\n            (predicate in rels) or (predicate == \"isA\")\n        ):\n            edgelabel = self.edgelabels\n        label = None\n        if edgelabel is None:\n            tokens = predicate.split()\n            if len(tokens) == 2 and tokens[1] in (\"some\", \"only\"):\n                label = f\"{tokens[0]} {tokens[1]}\"\n            elif len(tokens) == 3 and tokens[1] in (\n                \"exactly\",\n                \"min\",\n                \"max\",\n            ):\n                label = f\"{tokens[0]} {tokens[1]} {tokens[2]}\"\n        elif isinstance(edgelabel, str):\n            label = edgelabel\n        elif isinstance(edgelabel, dict):\n            label = edgelabel.get(predicate, predicate)\n        elif edgelabel:\n            label = predicate\n        kwargs = self.get_edge_attrs(predicate, attrs=attrs)\n        self.dot.edge(subject, obj, label=label, **kwargs)\n        self.edges.add(key)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_edges","title":"<code>add_edges(self, sources=None, relations=None, edgelabels=None, addnodes=None, addconstructs=None, **attrs)</code>","text":"<p>Adds all relations originating from entities <code>sources</code> who's type are listed in <code>relations</code>.  If <code>sources</code> is None, edges are added between all current nodes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_edges(  # pylint: disable=too-many-arguments\n    self,\n    sources=None,\n    relations=None,\n    edgelabels=None,\n    addnodes=None,\n    addconstructs=None,\n    **attrs,\n):\n    \"\"\"Adds all relations originating from entities `sources` who's type\n    are listed in `relations`.  If `sources` is None, edges are added\n    between all current nodes.\"\"\"\n    if sources is None:\n        sources = self.nodes\n    for source in sources.copy():\n        self.add_source_edges(\n            source,\n            relations=relations,\n            edgelabels=edgelabels,\n            addnodes=addnodes,\n            addconstructs=addconstructs,\n            **attrs,\n        )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_entities","title":"<code>add_entities(self, entities=None, relations='isA', edgelabels=None, addnodes=False, addconstructs=False, nodeattrs=None, **attrs)</code>","text":"<p>Adds a sequence of entities to the graph.  If <code>entities</code> is None, all classes are added to the graph.</p> <p><code>nodeattrs</code> is a dict mapping node names to are attributes for dedicated nodes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_entities(  # pylint: disable=too-many-arguments\n    self,\n    entities=None,\n    relations=\"isA\",\n    edgelabels=None,\n    addnodes=False,\n    addconstructs=False,\n    nodeattrs=None,\n    **attrs,\n):\n    \"\"\"Adds a sequence of entities to the graph.  If `entities` is None,\n    all classes are added to the graph.\n\n    `nodeattrs` is a dict mapping node names to are attributes for\n    dedicated nodes.\n    \"\"\"\n    if entities is None:\n        entities = self.ontology.classes(imported=self.imported)\n    self.add_nodes(entities, nodeattrs=nodeattrs, **attrs)\n    self.add_edges(\n        relations=relations,\n        edgelabels=edgelabels,\n        addnodes=addnodes,\n        addconstructs=addconstructs,\n        **attrs,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_legend","title":"<code>add_legend(self, relations=None)</code>","text":"<p>Adds legend for specified relations to the graph.</p> <p>If <code>relations</code> is \"all\", the legend will contain all relations that are defined in the style.  By default the legend will only contain relations that are currently included in the graph.</p> <p>Hence, you usually want to call add_legend() as the last method before saving or displaying.</p> <p>Relations with defined style will be bold in legend. Relations that have inherited style from parent relation will not be bold.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_legend(self, relations=None):\n    \"\"\"Adds legend for specified relations to the graph.\n\n    If `relations` is \"all\", the legend will contain all relations\n    that are defined in the style.  By default the legend will\n    only contain relations that are currently included in the\n    graph.\n\n    Hence, you usually want to call add_legend() as the last method\n    before saving or displaying.\n\n    Relations with defined style will be bold in legend.\n    Relations that have inherited style from parent relation\n    will not be bold.\n    \"\"\"\n    rels = self.style.get(\"relations\", {})\n    if relations is None:\n        relations = self.get_relations(sort=True)\n    elif relations == \"all\":\n        relations = [\"isA\"] + list(rels.keys()) + [\"inverse\"]\n    elif isinstance(relations, str):\n        relations = relations.split(\",\")\n\n    nrelations = len(relations)\n    if nrelations == 0:\n        return\n\n    table = (\n        '&lt;&lt;table border=\"0\" cellpadding=\"2\" cellspacing=\"0\" cellborder=\"0\"&gt;'\n    )\n    label1 = [table]\n    label2 = [table]\n    for index, relation in enumerate(relations):\n        if (relation in rels) or (relation == \"isA\"):\n            label1.append(\n                f'&lt;tr&gt;&lt;td align=\"right\" '\n                f'port=\"i{index}\"&gt;&lt;b&gt;{relation}&lt;/b&gt;&lt;/td&gt;&lt;/tr&gt;'\n            )\n        else:\n            label1.append(\n                f'&lt;tr&gt;&lt;td align=\"right\" '\n                f'port=\"i{index}\"&gt;{relation}&lt;/td&gt;&lt;/tr&gt;'\n            )\n        label2.append(f'&lt;tr&gt;&lt;td port=\"i{index}\"&gt;&amp;nbsp;&lt;/td&gt;&lt;/tr&gt;')\n    label1.append(\"&lt;/table&gt;&gt;\")\n    label2.append(\"&lt;/table&gt;&gt;\")\n    self.dot.node(\"key1\", label=\"\\n\".join(label1), shape=\"plaintext\")\n    self.dot.node(\"key2\", label=\"\\n\".join(label2), shape=\"plaintext\")\n\n    rankdir = self.dot.graph_attr.get(\"rankdir\", \"TB\")\n    constraint = \"false\" if rankdir in (\"TB\", \"BT\") else \"true\"\n    inv = rankdir in (\"BT\",)\n\n    for index in range(nrelations):\n        relation = (\n            relations[nrelations - 1 - index] if inv else relations[index]\n        )\n        if relation == \"inverse\":\n            kwargs = self.style.get(\"inverse\", {}).copy()\n        else:\n            kwargs = self.get_edge_attrs(relation, {}).copy()\n        kwargs[\"constraint\"] = constraint\n        with self.dot.subgraph(name=f\"sub{index}\") as subgraph:\n            subgraph.attr(rank=\"same\")\n            if rankdir in (\"BT\", \"LR\"):\n                self.dot.edge(\n                    f\"key1:i{index}:e\", f\"key2:i{index}:w\", **kwargs\n                )\n            else:\n                self.dot.edge(\n                    f\"key2:i{index}:w\", f\"key1:i{index}:e\", **kwargs\n                )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_missing_node","title":"<code>add_missing_node(self, name, addnodes=None)</code>","text":"<p>Checks if <code>name</code> corresponds to a missing node and add it if <code>addnodes</code> is true.</p> <p>Returns true if the node exists or is added, false otherwise.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_missing_node(self, name, addnodes=None):\n    \"\"\"Checks if `name` corresponds to a missing node and add it if\n    `addnodes` is true.\n\n    Returns true if the node exists or is added, false otherwise.\"\"\"\n    addnodes = self.addnodes if addnodes is None else addnodes\n    entity = self.ontology[name] if isinstance(name, str) else name\n    label = get_label(entity)\n    if label not in self.nodes:\n        if addnodes:\n            self.add_node(entity, **self.style.get(\"added_node\", {}))\n        else:\n            return False\n    return True\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_node","title":"<code>add_node(self, name, nodeattrs=None, **attrs)</code>","text":"<p>Add node with given name. <code>attrs</code> are graphviz node attributes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_node(self, name, nodeattrs=None, **attrs):\n    \"\"\"Add node with given name. `attrs` are graphviz node attributes.\"\"\"\n    entity = self.ontology[name] if isinstance(name, str) else name\n    label = get_label(entity)\n    if label not in self.nodes.union(self.excluded_nodes):\n        kwargs = self.get_node_attrs(\n            entity, nodeattrs=nodeattrs, attrs=attrs\n        )\n        if hasattr(entity, \"iri\"):\n            kwargs.setdefault(\"URL\", entity.iri)\n        self.dot.node(label, label=label, **kwargs)\n        self.nodes.add(label)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_nodes","title":"<code>add_nodes(self, names, nodeattrs, **attrs)</code>","text":"<p>Add nodes with given names. <code>attrs</code> are graphviz node attributes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_nodes(self, names, nodeattrs, **attrs):\n    \"\"\"Add nodes with given names. `attrs` are graphviz node attributes.\"\"\"\n    for name in names:\n        self.add_node(name, nodeattrs=nodeattrs, **attrs)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_parents","title":"<code>add_parents(self, name, levels=1, relations='isA', edgelabels=None, addnodes=False, addconstructs=False, **attrs)</code>","text":"<p>Add <code>levels</code> levels of strict parents of entity <code>name</code>.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_parents(  # pylint: disable=too-many-arguments\n    self,\n    name,\n    levels=1,\n    relations=\"isA\",\n    edgelabels=None,\n    addnodes=False,\n    addconstructs=False,\n    **attrs,\n):\n    \"\"\"Add `levels` levels of strict parents of entity `name`.\"\"\"\n\n    def addparents(entity, nodes, parents):\n        if nodes &gt; 0:\n            for parent in entity.get_parents(strict=True):\n                parents.add(parent)\n                addparents(parent, nodes - 1, parents)\n\n    entity = self.ontology[name] if isinstance(name, str) else name\n    parents = set()\n    addparents(entity, levels, parents)\n    self.add_entities(\n        entities=parents,\n        relations=relations,\n        edgelabels=edgelabels,\n        addnodes=addnodes,\n        addconstructs=addconstructs,\n        **attrs,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.add_source_edges","title":"<code>add_source_edges(self, source, relations=None, edgelabels=None, addnodes=None, addconstructs=None, **attrs)</code>","text":"<p>Adds all relations originating from entity <code>source</code> who's type are listed in <code>relations</code>.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def add_source_edges(  # pylint: disable=too-many-arguments,too-many-branches\n    self,\n    source,\n    relations=None,\n    edgelabels=None,\n    addnodes=None,\n    addconstructs=None,\n    **attrs,\n):\n    \"\"\"Adds all relations originating from entity `source` who's type\n    are listed in `relations`.\"\"\"\n    if relations is None:\n        relations = self.relations\n    elif isinstance(relations, str):\n        relations = set([relations])\n    else:\n        relations = set(relations)\n\n    edgelabels = self.edgelabels if edgelabels is None else edgelabels\n    addconstructs = (\n        self.addconstructs if addconstructs is None else addconstructs\n    )\n\n    entity = self.ontology[source] if isinstance(source, str) else source\n    label = get_label(entity)\n    for relation in entity.is_a:\n        # isA\n        if isinstance(\n            relation, (owlready2.ThingClass, owlready2.ObjectPropertyClass)\n        ):\n            if \"all\" in relations or \"isA\" in relations:\n                rlabel = get_label(relation)\n                # FIXME - we actually want to include individuals...\n                if isinstance(entity, owlready2.Thing):\n                    continue\n                if relation not in entity.get_parents(strict=True):\n                    continue\n                if not self.add_missing_node(relation, addnodes=addnodes):\n                    continue\n                self.add_edge(\n                    subject=label,\n                    predicate=\"isA\",\n                    obj=rlabel,\n                    edgelabel=edgelabels,\n                    **attrs,\n                )\n\n        # restriction\n        elif isinstance(relation, owlready2.Restriction):\n            rname = get_label(relation.property)\n            if \"all\" in relations or rname in relations:\n                rlabel = f\"{rname} {typenames[relation.type]}\"\n                if isinstance(relation.value, owlready2.ThingClass):\n                    obj = get_label(relation.value)\n                    if not self.add_missing_node(relation.value, addnodes):\n                        continue\n                elif (\n                    isinstance(relation.value, owlready2.ClassConstruct)\n                    and self.addconstructs\n                ):\n                    obj = self.add_class_construct(relation.value)\n                else:\n                    continue\n                pred = asstring(\n                    relation, exclude_object=True, ontology=self.ontology\n                )\n                self.add_edge(\n                    label, pred, obj, edgelabel=edgelabels, **attrs\n                )\n\n        # inverse\n        if isinstance(relation, owlready2.Inverse):\n            if \"all\" in relations or \"inverse\" in relations:\n                rlabel = get_label(relation)\n                if not self.add_missing_node(relation, addnodes=addnodes):\n                    continue\n                if relation not in entity.get_parents(strict=True):\n                    continue\n                self.add_edge(\n                    subject=label,\n                    predicate=\"inverse\",\n                    obj=rlabel,\n                    edgelabel=edgelabels,\n                    **attrs,\n                )\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_edge_attrs","title":"<code>get_edge_attrs(self, predicate, attrs)</code>","text":"<p>Returns attributes for node or edge <code>predicate</code>.  <code>attrs</code> overrides the default style.</p> <p>Parameters:</p> Name Type Description Default <code>predicate</code> <code>str</code> <p>predicate to get attributes for</p> required <code>attrs</code> <code>dict</code> <p>desired attributes to override default</p> required Source code in <code>ontopy/graph.py</code> <pre><code>def get_edge_attrs(self, predicate: str, attrs: dict) -&gt; dict:\n    \"\"\"Returns attributes for node or edge `predicate`.  `attrs` overrides\n    the default style.\n\n    Parameters:\n        predicate: predicate to get attributes for\n        attrs: desired attributes to override default\n    \"\"\"\n    # given type\n    types = (\"isA\", \"equivalent_to\", \"disjoint_with\", \"inverse_of\")\n    if predicate in types:\n        kwargs = self.style.get(predicate, {}).copy()\n    else:\n        kwargs = {}\n        name = predicate.split(None, 1)[0]\n        match = re.match(r\"Inverse\\((.*)\\)\", name)\n        if match:\n            (name,) = match.groups()\n            attrs = attrs.copy()\n            for key, value in self.style.get(\"inverse\", {}).items():\n                attrs.setdefault(key, value)\n        if not isinstance(name, str) or name in self.ontology:\n            entity = self.ontology[name] if isinstance(name, str) else name\n            relations = self.style.get(\"relations\", {})\n            rels = set(\n                self.ontology[_] for _ in relations if _ in self.ontology\n            )\n            rattrs = self._relation_styles(entity, relations, rels)\n\n            # object property\n            if isinstance(\n                entity,\n                (owlready2.ObjectPropertyClass, owlready2.ObjectProperty),\n            ):\n                kwargs = self.style.get(\"default_relation\", {}).copy()\n                kwargs.update(rattrs)\n            # data property\n            elif isinstance(\n                entity,\n                (owlready2.DataPropertyClass, owlready2.DataProperty),\n            ):\n                kwargs = self.style.get(\"default_dataprop\", {}).copy()\n                kwargs.update(rattrs)\n            else:\n                raise TypeError(f\"Unknown entity type: {entity!r}\")\n    kwargs.update(self.style.get(\"edges\", {}).get(predicate, {}))\n    kwargs.update(attrs)\n    return kwargs\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_figsize","title":"<code>get_figsize(self)</code>","text":"<p>Returns the default figure size (width, height) in points.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_figsize(self):\n    \"\"\"Returns the default figure size (width, height) in points.\"\"\"\n    with tempfile.TemporaryDirectory() as tmpdir:\n        tmpfile = os.path.join(tmpdir, \"graph.svg\")\n        self.save(tmpfile)\n        xml = ET.parse(tmpfile)\n        svg = xml.getroot()\n        width = svg.attrib[\"width\"]\n        height = svg.attrib[\"height\"]\n        if not width.endswith(\"pt\"):\n            # ensure that units are in points\n            raise ValueError(\n                \"The width attribute should always be given in 'pt', \"\n                f\"but it is: {width}\"\n            )\n\n        def asfloat(string):\n            return float(re.match(r\"^[\\d.]+\", string).group())\n\n    return asfloat(width), asfloat(height)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_node_attrs","title":"<code>get_node_attrs(self, name, nodeattrs, attrs)</code>","text":"<p>Returns attributes for node or edge <code>name</code>.  <code>attrs</code> overrides the default style.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_node_attrs(self, name, nodeattrs, attrs):\n    \"\"\"Returns attributes for node or edge `name`.  `attrs` overrides\n    the default style.\"\"\"\n    entity = self.ontology[name] if isinstance(name, str) else name\n    label = get_label(entity)\n    # class\n    if isinstance(entity, owlready2.ThingClass):\n        if entity.is_defined:\n            kwargs = self.style.get(\"defined_class\", {})\n        else:\n            kwargs = self.style.get(\"class\", {})\n    # class construct\n    elif isinstance(entity, owlready2.ClassConstruct):\n        kwargs = self.style.get(\"class_construct\", {})\n    # individual\n    elif isinstance(entity, owlready2.Thing):\n        kwargs = self.style.get(\"individual\", {})\n    # object property\n    elif isinstance(entity, owlready2.ObjectPropertyClass):\n        kwargs = self.style.get(\"object_property\", {})\n    # data property\n    elif isinstance(entity, owlready2.DataPropertyClass):\n        kwargs = self.style.get(\"data_property\", {})\n    # annotation property\n    elif isinstance(entity, owlready2.AnnotationPropertyClass):\n        kwargs = self.style.get(\"annotation_property\", {})\n    else:\n        raise TypeError(f\"Unknown entity type: {entity!r}\")\n    kwargs = kwargs.copy()\n    kwargs.update(self.style.get(\"nodes\", {}).get(label, {}))\n    if nodeattrs:\n        kwargs.update(nodeattrs.get(label, {}))\n    kwargs.update(attrs)\n    return kwargs\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.get_relations","title":"<code>get_relations(self, sort=True)</code>","text":"<p>Returns a set of relations in current graph.  If <code>sort</code> is true, a sorted list is returned.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_relations(self, sort=True):\n    \"\"\"Returns a set of relations in current graph.  If `sort` is true,\n    a sorted list is returned.\"\"\"\n    relations = set()\n    for _, predicate, _ in self.edges:\n        if predicate.startswith(\"Inverse\"):\n            relations.add(\"inverse\")\n            match = re.match(r\"Inverse\\((.+)\\)\", predicate)\n            if match is None:\n                raise ValueError(\n                    \"Could unexpectedly not find the inverse relation \"\n                    f\"just added in: {predicate}\"\n                )\n            relations.add(match.groups()[0])\n        else:\n            relations.add(predicate.split(None, 1)[0])\n\n    # Sort, but place 'isA' first and 'inverse' last\n    if sort:\n        start, end = [], []\n        if \"isA\" in relations:\n            relations.remove(\"isA\")\n            start.append(\"isA\")\n        if \"inverse\" in relations:\n            relations.remove(\"inverse\")\n            end.append(\"inverse\")\n        relations = start + sorted(relations) + end\n\n    return relations\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.save","title":"<code>save(self, filename, fmt=None, **kwargs)</code>","text":"<p>Saves graph to <code>filename</code>.  If format is not given, it is inferred from <code>filename</code>.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def save(self, filename, fmt=None, **kwargs):\n    \"\"\"Saves graph to `filename`.  If format is not given, it is\n    inferred from `filename`.\"\"\"\n    base = os.path.splitext(filename)[0]\n    fmt = get_format(filename, default=\"svg\", fmt=fmt)\n    kwargs.setdefault(\"cleanup\", True)\n    if fmt in (\"graphviz\", \"gv\"):\n        if \"dictionary\" in kwargs:\n            self.dot.save(filename, dictionary=kwargs[\"dictionary\"])\n        else:\n            self.dot.save(filename)\n    else:\n        fmt = kwargs.pop(\"format\", fmt)\n        self.dot.render(base, format=fmt, **kwargs)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.OntoGraph.view","title":"<code>view(self)</code>","text":"<p>Shows the graph in a viewer.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def view(self):\n    \"\"\"Shows the graph in a viewer.\"\"\"\n    self.dot.view(cleanup=True)\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.check_module_dependencies","title":"<code>check_module_dependencies(modules, verbose=True)</code>","text":"<p>Check module dependencies and return a copy of modules with redundant dependencies removed.</p> <p>If <code>verbose</code> is true, warnings are printed for each module that</p> <p>If <code>modules</code> is given, it should be a dict returned by get_module_dependencies().</p> Source code in <code>ontopy/graph.py</code> <pre><code>def check_module_dependencies(modules, verbose=True):\n    \"\"\"Check module dependencies and return a copy of modules with\n    redundant dependencies removed.\n\n    If `verbose` is true, warnings are printed for each module that\n\n    If `modules` is given, it should be a dict returned by\n    get_module_dependencies().\n    \"\"\"\n    visited = set()\n\n    def get_deps(iri, excl=None):\n        \"\"\"Returns a set with all dependencies of `iri`, excluding `excl` and\n        its dependencies.\"\"\"\n        if iri in visited:\n            return set()\n        visited.add(iri)\n        deps = set()\n        for dependency in modules[iri]:\n            if dependency != excl:\n                deps.add(dependency)\n                deps.update(get_deps(dependency))\n        return deps\n\n    mods = {}\n    redundant = []\n    for iri, deps in modules.items():\n        if not deps:\n            mods[iri] = set()\n        for dep in deps:\n            if dep in get_deps(iri, dep):\n                redundant.append((iri, dep))\n            elif iri in mods:\n                mods[iri].add(dep)\n            else:\n                mods[iri] = set([dep])\n\n    if redundant and verbose:\n        print(\"** Warning: Redundant module dependency:\")\n        for iri, dep in redundant:\n            print(f\"{iri} -&gt; {dep}\")\n\n    return mods\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.cytoscape_style","title":"<code>cytoscape_style(style=None)</code>","text":"<p>Get list of color, style and fills.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def cytoscape_style(style=None):  # pylint: disable=too-many-branches\n    \"\"\"Get list of color, style and fills.\"\"\"\n    if not style:\n        style = _default_style\n    colours = {}\n    styles = {}\n    fill = {}\n    for key, value in style.items():\n        if isinstance(value, dict):\n            if \"color\" in value:\n                colours[key] = value[\"color\"]\n            else:\n                colours[key] = \"black\"\n            if \"style\" in value:\n                styles[key] = value[\"style\"]\n            else:\n                styles[key] = \"solid\"\n            if \"arrowhead\" in value:\n                if value[\"arrowhead\"] == \"empty\":\n                    fill[key] = \"hollow\"\n            else:\n                fill[key] = \"filled\"\n\n    for key, value in style.get(\"relations\", {}).items():\n        if isinstance(value, dict):\n            if \"color\" in value:\n                colours[key] = value[\"color\"]\n            else:\n                colours[key] = \"black\"\n            if \"style\" in value:\n                styles[key] = value[\"style\"]\n            else:\n                styles[key] = \"solid\"\n            if \"arrowhead\" in value:\n                if value[\"arrowhead\"] == \"empty\":\n                    fill[key] = \"hollow\"\n            else:\n                fill[key] = \"filled\"\n    return [colours, styles, fill]\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.cytoscapegraph","title":"<code>cytoscapegraph(graph, onto=None, infobox=None, force=False)</code>","text":"<p>Returns and instance of icytoscape-figure for an instance Graph of OntoGraph, the accompanying ontology is required for mouse actions.</p> <p>Parameters:</p> Name Type Description Default <code>graph</code> <code>OntoGraph</code> <p>graph generated with OntoGraph with edgelabels=True.</p> required <code>onto</code> <code>Optional[ontopy.ontology.Ontology]</code> <p>ontology to be used for mouse actions.</p> <code>None</code> <code>infobox</code> <code>str</code> <p>\"left\" or \"right\". Placement of infbox with  respect to graph.</p> <code>None</code> <code>force</code> <code>bool</code> <p>force generate graph without correct edgelabels.</p> <code>False</code> <p>Returns:</p> Type Description <code>GridspecLayout</code> <p>cytoscapewidget with graph and infobox to be visualized in jupyter lab.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def cytoscapegraph(\n    graph: OntoGraph,\n    onto: Optional[Ontology] = None,\n    infobox: str = None,\n    force: bool = False,\n) -&gt; \"GridspecLayout\":\n    # pylint: disable=too-many-locals,too-many-statements\n    \"\"\"Returns and instance of icytoscape-figure for an\n    instance Graph of OntoGraph, the accompanying ontology\n    is required for mouse actions.\n    Args:\n            graph: graph generated with OntoGraph with edgelabels=True.\n            onto: ontology to be used for mouse actions.\n            infobox: \"left\" or \"right\". Placement of infbox with\n                     respect to graph.\n            force: force generate graph without correct edgelabels.\n    Returns:\n            cytoscapewidget with graph and infobox to be visualized\n            in jupyter lab.\n\n    \"\"\"\n    # pylint: disable=import-error,import-outside-toplevel\n    from ipywidgets import Output, VBox, GridspecLayout\n    from IPython.display import display, Image\n    from pathlib import Path\n    import networkx as nx\n    import pydotplus\n    import ipycytoscape\n    from networkx.readwrite.json_graph import cytoscape_data\n\n    # Define the styles, this has to be aligned with the graphviz values\n    dotplus = pydotplus.graph_from_dot_data(graph.dot.source)\n    # if graph doesn't have multiedges, use dotplus.set_strict(true)\n    pydot_graph = nx.nx_pydot.from_pydot(dotplus)\n\n    colours, styles, fill = cytoscape_style()\n\n    data = cytoscape_data(pydot_graph)[\"elements\"]\n    for datum in data[\"edges\"]:\n        try:\n            datum[\"data\"][\"label\"] = (\n                datum[\"data\"][\"label\"].rsplit(\" \", 1)[0].lstrip('\"')\n            )\n        except KeyError as err:\n            if not force:\n                raise EMMOntoPyException(\n                    \"Edge label is not defined. Are you sure that the OntoGraph\"\n                    \"instance you provided was generated with \"\n                    \"\u00b4edgelabels=True\u00b4?\"\n                ) from err\n            warnings.warn(\n                \"ARROWS WILL NOT BE DISPLAYED CORRECTLY. \"\n                \"Edge label is not defined. Are you sure that the OntoGraph \"\n                \"instance you provided was generated with \u00b4edgelabels=True\u00b4?\"\n            )\n            datum[\"data\"][\"label\"] = \"\"\n\n        lab = datum[\"data\"][\"label\"].replace(\"Inverse(\", \"\").rstrip(\")\")\n        try:\n            datum[\"data\"][\"colour\"] = colours[lab]\n        except KeyError:\n            datum[\"data\"][\"colour\"] = \"black\"\n        try:\n            datum[\"data\"][\"style\"] = styles[lab]\n        except KeyError:\n            datum[\"data\"][\"style\"] = \"solid\"\n        if datum[\"data\"][\"label\"].startswith(\"Inverse(\"):\n            datum[\"data\"][\"targetarrow\"] = \"diamond\"\n            datum[\"data\"][\"sourcearrow\"] = \"none\"\n        else:\n            datum[\"data\"][\"targetarrow\"] = \"triangle\"\n            datum[\"data\"][\"sourcearrow\"] = \"none\"\n        try:\n            datum[\"data\"][\"fill\"] = fill[lab]\n        except KeyError:\n            datum[\"data\"][\"fill\"] = \"filled\"\n\n    cytofig = ipycytoscape.CytoscapeWidget()\n    cytofig.graph.add_graph_from_json(data, directed=True)\n\n    cytofig.set_style(\n        [\n            {\n                \"selector\": \"node\",\n                \"css\": {\n                    \"content\": \"data(label)\",\n                    # \"text-valign\": \"center\",\n                    # \"color\": \"white\",\n                    # \"text-outline-width\": 2,\n                    # \"text-outline-color\": \"red\",\n                    \"background-color\": \"blue\",\n                },\n            },\n            {\"selector\": \"node:parent\", \"css\": {\"background-opacity\": 0.333}},\n            {\n                \"selector\": \"edge\",\n                \"style\": {\n                    \"width\": 2,\n                    \"line-color\": \"data(colour)\",\n                    # \"content\": \"data(label)\"\",\n                    \"line-style\": \"data(style)\",\n                },\n            },\n            {\n                \"selector\": \"edge.directed\",\n                \"style\": {\n                    \"curve-style\": \"bezier\",\n                    \"target-arrow-shape\": \"data(targetarrow)\",\n                    \"target-arrow-color\": \"data(colour)\",\n                    \"target-arrow-fill\": \"data(fill)\",\n                    \"mid-source-arrow-shape\": \"data(sourcearrow)\",\n                    \"mid-source-arrow-color\": \"data(colour)\",\n                },\n            },\n            {\n                \"selector\": \"edge.multiple_edges\",\n                \"style\": {\"curve-style\": \"bezier\"},\n            },\n            {\n                \"selector\": \":selected\",\n                \"css\": {\n                    \"background-color\": \"black\",\n                    \"line-color\": \"black\",\n                    \"target-arrow-color\": \"black\",\n                    \"source-arrow-color\": \"black\",\n                    \"text-outline-color\": \"black\",\n                },\n            },\n        ]\n    )\n\n    if onto is not None:\n        out = Output(layout={\"border\": \"1px solid black\"})\n\n        def log_clicks(node):\n            with out:\n                print((onto.get_by_label(node[\"data\"][\"label\"])))\n                parent = onto.get_by_label(node[\"data\"][\"label\"]).get_parents()\n                print(f\"parents: {parent}\")\n                try:\n                    elucidation = onto.get_by_label(\n                        node[\"data\"][\"label\"]\n                    ).elucidation\n                    print(f\"elucidation: {elucidation[0]}\")\n                except (AttributeError, IndexError):\n                    pass\n\n                try:\n                    annotations = onto.get_by_label(\n                        node[\"data\"][\"label\"]\n                    ).annotations\n                    for _ in annotations:\n                        print(f\"annotation: {_}\")\n                except AttributeError:\n                    pass\n\n                # Try does not work...\n                try:\n                    iri = onto.get_by_label(node[\"data\"][\"label\"]).iri\n                    print(f\"iri: {iri}\")\n                except (AttributeError, IndexError):\n                    pass\n                try:\n                    fig = node[\"data\"][\"label\"]\n                    if os.path.exists(Path(fig + \".png\")):\n                        display(Image(fig + \".png\", width=100))\n                    elif os.path.exists(Path(fig + \".jpg\")):\n                        display(Image(fig + \".jpg\", width=100))\n                except (AttributeError, IndexError):\n                    pass\n                out.clear_output(wait=True)\n\n        def log_mouseovers(node):\n            with out:\n                print(onto.get_by_label(node[\"data\"][\"label\"]))\n                # print(f'mouseover: {pformat(node)}')\n            out.clear_output(wait=True)\n\n        cytofig.on(\"node\", \"click\", log_clicks)\n        cytofig.on(\"node\", \"mouseover\", log_mouseovers)  # , remove=True)\n        cytofig.on(\"node\", \"mouseout\", out.clear_output(wait=True))\n        grid = GridspecLayout(1, 3, height=\"400px\")\n        if infobox == \"left\":\n            grid[0, 0] = out\n            grid[0, 1:] = cytofig\n        elif infobox == \"right\":\n            grid[0, 0:-1] = cytofig\n            grid[0, 2] = out\n        else:\n            return VBox([cytofig, out])\n        return grid\n\n    return cytofig\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.filter_classes","title":"<code>filter_classes(classes, included_namespaces=(), included_ontologies=())</code>","text":"<p>Filter out classes whos namespace is not in <code>included_namespaces</code> or whos ontology name is not in one of the ontologies in <code>included_ontologies</code>.</p> <p><code>classes</code> should be a sequence of classes.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def filter_classes(classes, included_namespaces=(), included_ontologies=()):\n    \"\"\"Filter out classes whos namespace is not in `included_namespaces`\n    or whos ontology name is not in one of the ontologies in\n    `included_ontologies`.\n\n    `classes` should be a sequence of classes.\n    \"\"\"\n    filtered = set(classes)\n    if included_namespaces:\n        filtered = set(\n            c for c in filtered if c.namespace.name in included_namespaces\n        )\n    if included_ontologies:\n        filtered = set(\n            c\n            for c in filtered\n            if c.namespace.ontology.name in included_ontologies\n        )\n    return filtered\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.get_module_dependencies","title":"<code>get_module_dependencies(iri_or_onto, strip_base=None)</code>","text":"<p>Reads <code>iri_or_onto</code> and returns a dict mapping ontology names to a list of ontologies that they depends on.</p> <p>If <code>strip_base</code> is true, the base IRI is stripped from ontology names.  If it is a string, it lstrip'ped from the base iri.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def get_module_dependencies(iri_or_onto, strip_base=None):\n    \"\"\"Reads `iri_or_onto` and returns a dict mapping ontology names to a\n    list of ontologies that they depends on.\n\n    If `strip_base` is true, the base IRI is stripped from ontology\n    names.  If it is a string, it lstrip'ped from the base iri.\n    \"\"\"\n    from ontopy.ontology import (  # pylint: disable=import-outside-toplevel\n        get_ontology,\n    )\n\n    if isinstance(iri_or_onto, str):\n        onto = get_ontology(iri_or_onto)\n        onto.load()\n    else:\n        onto = iri_or_onto\n\n    modules = {onto.base_iri: set()}\n\n    def strip(base_iri):\n        if isinstance(strip_base, str):\n            return base_iri.lstrip(strip_base)\n        if strip_base:\n            return base_iri.strip(onto.base_iri)\n        return base_iri\n\n    visited = set()\n\n    def setmodules(onto):\n        for imported_onto in onto.imported_ontologies:\n            if onto.base_iri in modules:\n                modules[strip(onto.base_iri)].add(strip(imported_onto.base_iri))\n            else:\n                modules[strip(onto.base_iri)] = set(\n                    [strip(imported_onto.base_iri)]\n                )\n            if imported_onto.base_iri not in modules:\n                modules[strip(imported_onto.base_iri)] = set()\n            if imported_onto not in visited:\n                visited.add(imported_onto)\n                setmodules(imported_onto)\n\n    setmodules(onto)\n    return modules\n</code></pre>"},{"location":"api_reference/ontopy/graph/#ontopy.graph.plot_modules","title":"<code>plot_modules(src, filename=None, fmt=None, show=False, strip_base=None, ignore_redundant=True)</code>","text":"<p>Plot module dependency graph for <code>src</code> and return a graph object.</p> <p>Here <code>src</code> may be an IRI, a path the the ontology or a dict returned by get_module_dependencies().</p> <p>If <code>filename</code> is given, write the graph to this file.</p> <p>If <code>fmt</code> is None, the output format is inferred from <code>filename</code>.</p> <p>If <code>show</code> is true, the graph is displayed.</p> <p><code>strip_base</code> is passed on to get_module_dependencies() if <code>src</code> is not a dict.</p> <p>If <code>ignore_redundant</code> is true, redundant dependencies are not plotted.</p> Source code in <code>ontopy/graph.py</code> <pre><code>def plot_modules(  # pylint: disable=too-many-arguments\n    src,\n    filename=None,\n    fmt=None,\n    show=False,\n    strip_base=None,\n    ignore_redundant=True,\n):\n    \"\"\"Plot module dependency graph for `src` and return a graph object.\n\n    Here `src` may be an IRI, a path the the ontology or a dict returned by\n    get_module_dependencies().\n\n    If `filename` is given, write the graph to this file.\n\n    If `fmt` is None, the output format is inferred from `filename`.\n\n    If `show` is true, the graph is displayed.\n\n    `strip_base` is passed on to get_module_dependencies() if `src` is not\n    a dict.\n\n    If `ignore_redundant` is true, redundant dependencies are not plotted.\n    \"\"\"\n    if isinstance(src, dict):\n        modules = src\n    else:\n        modules = get_module_dependencies(src, strip_base=strip_base)\n\n    if ignore_redundant:\n        modules = check_module_dependencies(modules, verbose=False)\n\n    dot = graphviz.Digraph(comment=\"Module dependencies\")\n    dot.attr(rankdir=\"TB\")\n    dot.node_attr.update(\n        style=\"filled\", fillcolor=\"lightblue\", shape=\"box\", edgecolor=\"blue\"\n    )\n    dot.edge_attr.update(arrowtail=\"open\", dir=\"back\")\n\n    for iri in modules.keys():\n        iriname = iri.split(\":\", 1)[1]\n        dot.node(iriname, label=iri, URL=iri)\n\n    for iri, deps in modules.items():\n        for dep in deps:\n            iriname = iri.split(\":\", 1)[1]\n            depname = dep.split(\":\", 1)[1]\n            dot.edge(depname, iriname)\n\n    if filename:\n        base, ext = os.path.splitext(filename)\n        if fmt is None:\n            fmt = ext.lstrip(\".\")\n        dot.render(base, format=fmt, view=False, cleanup=True)\n\n    if show:\n        dot.view(cleanup=True)\n\n    return dot\n</code></pre>"},{"location":"api_reference/ontopy/manchester/","title":"manchester","text":"<p>Evaluate Manchester syntax</p> <p>This module compiles restrictions and logical constructs in Manchester syntax into Owlready2 classes. The main function in this module is <code>manchester.evaluate()</code>, see its docstring for usage example.</p> <p>Pyparsing is used under the hood for parsing.</p>"},{"location":"api_reference/ontopy/manchester/#ontopy.manchester.ManchesterError","title":"<code> ManchesterError            (EMMOntoPyException)         </code>","text":"<p>Raised on invalid Manchester notation.</p> Source code in <code>ontopy/manchester.py</code> <pre><code>class ManchesterError(EMMOntoPyException):\n    \"\"\"Raised on invalid Manchester notation.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/manchester/#ontopy.manchester.evaluate","title":"<code>evaluate(ontology, expr)</code>","text":"<p>Evaluate expression in Manchester syntax.</p> <p>Parameters:</p> Name Type Description Default <code>ontology</code> <code>Ontology</code> <p>The ontology within which the expression will be evaluated.</p> required <code>expr</code> <code>str</code> <p>Manchester expression to be evaluated.</p> required <p>Returns:</p> Type Description <code>Construct</code> <p>An Owlready2 construct that corresponds to the expression.</p> <p>Examples:</p> <p>from ontopy.manchester import evaluate from ontopy import get_ontology emmo = get_ontology().load()</p> <p>restriction = evaluate(emmo, 'hasPart some Atom') cls = evaluate(emmo, 'Atom') expr = evaluate(emmo, 'Atom or Molecule')</p> <p>Note</p> <p>Logical expressions (with <code>not</code>, <code>and</code> and <code>or</code>) are supported as well as object property restrictions.  For data properterties are only value restrictions supported so far.</p> Source code in <code>ontopy/manchester.py</code> <pre><code>def evaluate(ontology: owlready2.Ontology, expr: str) -&gt; owlready2.Construct:\n    \"\"\"Evaluate expression in Manchester syntax.\n\n    Args:\n        ontology: The ontology within which the expression will be evaluated.\n        expr: Manchester expression to be evaluated.\n\n    Returns:\n        An Owlready2 construct that corresponds to the expression.\n\n    Example:\n    &gt;&gt;&gt; from ontopy.manchester import evaluate\n    &gt;&gt;&gt; from ontopy import get_ontology\n    &gt;&gt;&gt; emmo = get_ontology().load()\n\n    &gt;&gt;&gt; restriction = evaluate(emmo, 'hasPart some Atom')\n    &gt;&gt;&gt; cls = evaluate(emmo, 'Atom')\n    &gt;&gt;&gt; expr = evaluate(emmo, 'Atom or Molecule')\n\n    Note:\n        Logical expressions (with `not`, `and` and `or`) are supported as\n        well as object property restrictions.  For data properterties are\n        only value restrictions supported so far.\n    \"\"\"\n\n    # pylint: disable=invalid-name\n    def _parse_literal(r):\n        \"\"\"Compiles literal to Owlready2 type.\"\"\"\n        if r.language:\n            v = owlready2.locstr(r.string, r.language)\n        elif r.number:\n            v = r.number\n        else:\n            v = r.string\n        return v\n\n    # pylint: disable=invalid-name,no-else-return,too-many-return-statements\n    # pylint: disable=too-many-branches\n    def _eval(r):\n        \"\"\"Recursively evaluate expression produced by pyparsing into an\n        Owlready2 construct.\"\"\"\n\n        def fneg(x):\n            \"\"\"Negates the argument if `neg` is true.\"\"\"\n            return owlready2.Not(x) if neg else x\n\n        if isinstance(r, str):  # r is atomic, returns its owlready2 repr\n            return ontology[r]\n        neg = False  # whether the expression starts with \"not\"\n        while r[0] == \"not\":\n            r.pop(0)  # strip off the \"not\" and proceed\n            neg = not neg\n\n        if len(r) == 1:  # r is either a atomic or a parenthesised\n            # subexpression that should be further evaluated\n            if isinstance(r[0], str):\n                return fneg(ontology[r[0]])\n            else:\n                return fneg(_eval(r[0]))\n        elif r.op:  # r contains a logical operator: and/or\n            ops = {\"and\": owlready2.And, \"or\": owlready2.Or}\n            op = ops[r.op]\n            if len(r) == 3:\n                return op([fneg(_eval(r[0])), _eval(r[2])])\n            else:\n                arg1 = fneg(_eval(r[0]))\n                r.pop(0)\n                r.pop(0)\n                return op([arg1, _eval(r)])\n        elif r.objProp:  # r is a restriction\n            if r[0] == \"inverse\":\n                r.pop(0)\n                prop = owlready2.Inverse(ontology[r[0]])\n            else:\n                prop = ontology[r[0]]\n            rtype = r[1]\n            if rtype == \"Self\":\n                return fneg(prop.has_self())\n            r.pop(0)\n            r.pop(0)\n            f = getattr(prop, rtype)\n            if rtype == \"value\":\n                return fneg(f(_eval(r)))\n            elif rtype in (\"some\", \"only\"):\n                return fneg(f(_eval(r)))\n            elif rtype in (\"min\", \"max\", \"exactly\"):\n                cardinality = r.pop(0)\n                return fneg(f(cardinality, _eval(r)))\n            else:\n                raise ManchesterError(f\"invalid restriction type: {rtype}\")\n        elif r.dataProp:  # r is a data property restriction\n            prop = ontology[r[0]]\n            rtype = r[1]\n            r.pop(0)\n            r.pop(0)\n            f = getattr(prop, rtype)\n            if rtype == \"value\":\n                return f(_parse_literal(r))\n            else:\n                raise ManchesterError(\n                    f\"unimplemented data property restriction: \"\n                    f\"{prop} {rtype} {r}\"\n                )\n        else:\n            raise ManchesterError(f\"invalid expression: {r}\")\n\n    grammar = manchester_expression()\n    return _eval(grammar.parseString(expr, parseAll=True))\n</code></pre>"},{"location":"api_reference/ontopy/manchester/#ontopy.manchester.manchester_expression","title":"<code>manchester_expression()</code>","text":"<p>Returns pyparsing grammar for a Manchester expression.</p> <p>This function is mostly for internal use.</p> <p>See also: https://www.w3.org/TR/owl2-manchester-syntax/</p> Source code in <code>ontopy/manchester.py</code> <pre><code>def manchester_expression():\n    \"\"\"Returns pyparsing grammar for a Manchester expression.\n\n    This function is mostly for internal use.\n\n    See also: https://www.w3.org/TR/owl2-manchester-syntax/\n    \"\"\"\n    # pylint: disable=global-statement,invalid-name,too-many-locals\n    global GRAMMAR\n    if GRAMMAR:\n        return GRAMMAR\n\n    # Subset of the Manchester grammar for expressions\n    # It is based on https://www.w3.org/TR/owl2-manchester-syntax/\n    # but allows logical constructs within restrictions (like Protege)\n    ident = pp.Word(pp.alphas + \"_:-\", pp.alphanums + \"_:-\", asKeyword=True)\n    uint = pp.Word(pp.nums)\n    alphas = pp.Word(pp.alphas)\n    string = pp.Word(pp.alphanums + \":\")\n    quotedString = (\n        pp.QuotedString('\"\"\"', multiline=True) | pp.QuotedString('\"')\n    )(\"string\")\n    typedLiteral = pp.Combine(quotedString + \"^^\" + string(\"datatype\"))\n    stringLanguageLiteral = pp.Combine(quotedString + \"@\" + alphas(\"language\"))\n    stringLiteral = quotedString\n    numberLiteral = pp.pyparsing_common.number(\"number\")\n    literal = (\n        typedLiteral | stringLanguageLiteral | stringLiteral | numberLiteral\n    )\n    logOp = pp.one_of([\"and\", \"or\"], asKeyword=True)\n    expr = pp.Forward()\n    restriction = pp.Forward()\n    primary = pp.Keyword(\"not\")[...] + (\n        restriction | ident(\"cls\") | pp.nested_expr(\"(\", \")\", expr)\n    )\n    objPropExpr = (\n        pp.Literal(\"inverse\")\n        + pp.Suppress(\"(\")\n        + ident(\"objProp\")\n        + pp.Suppress(\")\")\n        | pp.Literal(\"inverse\") + ident(\"objProp\")\n        | ident(\"objProp\")\n    )\n    dataPropExpr = ident(\"dataProp\")\n    restriction &lt;&lt;= (\n        objPropExpr + pp.Keyword(\"some\") + expr\n        | objPropExpr + pp.Keyword(\"only\") + expr\n        | objPropExpr + pp.Keyword(\"Self\")\n        | objPropExpr + pp.Keyword(\"value\") + ident(\"individual\")\n        | objPropExpr + pp.Keyword(\"min\") + uint + expr\n        | objPropExpr + pp.Keyword(\"max\") + uint + expr\n        | objPropExpr + pp.Keyword(\"exactly\") + uint + expr\n        | dataPropExpr + pp.Keyword(\"value\") + literal\n    )\n    expr &lt;&lt;= primary + (logOp(\"op\") + expr)[...]\n\n    GRAMMAR = expr\n    return expr\n</code></pre>"},{"location":"api_reference/ontopy/nadict/","title":"nadict","text":"<p>A nested dict with both attribute and item access.</p> <p>NA stands for Nested and Attribute.</p>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict","title":"<code> NADict        </code>","text":"<p>A nested dict with both attribute and item access.</p> <p>It is intended to be used with keys that are valid Python identifiers.  However, except for string keys containing a dot, there are actually no hard limitations.  If a key equals an existing attribute name, attribute access is of cause not possible.</p> <p>Nested items can be accessed via a dot notation, as shown in the example below.</p>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict--examples","title":"Examples","text":"<p>n = NADict(a=1, b=NADict(c=3, d=4)) n['a'] 1 n.a 1 n['b.c'] 3 n.b.c 3 n['b.e'] = 5 n.b.e 5</p>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict--attributes","title":"Attributes","text":"<p>_dict : dict     Dictionary holding the actial items.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>class NADict:\n    \"\"\"A nested dict with both attribute and item access.\n\n    It is intended to be used with keys that are valid Python\n    identifiers.  However, except for string keys containing a dot,\n    there are actually no hard limitations.  If a key equals an existing\n    attribute name, attribute access is of cause not possible.\n\n    Nested items can be accessed via a dot notation, as shown in the\n    example below.\n\n    Examples\n    --------\n    &gt;&gt;&gt; n = NADict(a=1, b=NADict(c=3, d=4))\n    &gt;&gt;&gt; n['a']\n    1\n    &gt;&gt;&gt; n.a\n    1\n    &gt;&gt;&gt; n['b.c']\n    3\n    &gt;&gt;&gt; n.b.c\n    3\n    &gt;&gt;&gt; n['b.e'] = 5\n    &gt;&gt;&gt; n.b.e\n    5\n\n    Attributes\n    ----------\n    _dict : dict\n        Dictionary holding the actial items.\n    \"\"\"\n\n    def __init__(self, *args, **kw):\n        object.__setattr__(self, \"_dict\", {})\n        self.update(*args, **kw)\n\n    def __getitem__(self, key):\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1][key2]\n        return self._dict[key]\n\n    def __setitem__(self, key, value):\n        if key in (\n            \"clear\",\n            \"copy\",\n            \"fromkeys\",\n            \"get\",\n            \"items\",\n            \"keys\",\n            \"pop\",\n            \"popitem\",\n            \"setdefault\",\n            \"update\",\n            \"values\",\n        ):\n            raise ValueError(\n                f\"invalid key {key!r}: must not override supported dict method\"\n                \" names\"\n            )\n\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            if key1 not in self._dict:\n                self._dict[key1] = NADict()\n            self._dict[key1][key2] = value\n        elif key in self._dict:\n            if isinstance(self._dict[key], NADict):\n                self._dict[key].update(value)\n            else:\n                self._dict[key] = value\n        else:\n            if isinstance(value, Mapping):\n                self._dict[key] = NADict(value)\n            else:\n                self._dict[key] = value\n\n    def __delitem__(self, key):\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            del self._dict[key1][key2]\n        else:\n            del self._dict[key]\n\n    def __getattr__(self, key):\n        if key not in self._dict:\n            raise AttributeError(f\"No such key: {key}\")\n        return self._dict[key]\n\n    def __setattr__(self, key, value):\n        if key in self._dict:\n            self._dict[key] = value\n        else:\n            object.__setattr__(self, key, value)\n\n    def __delattr__(self, key):\n        if key in self._dict:\n            del self._dict[key]\n        else:\n            object.__delattr__(self, key)\n\n    def __len__(self):\n        return len(self._dict)\n\n    def __contains__(self, key):\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return key2 in self._dict[key1]\n        return key in self._dict\n\n    def __iter__(self, prefix=\"\"):\n        for key, value in self._dict.items():\n            key = f\"{prefix}.{key}\" if prefix else key\n            if isinstance(value, NADict):\n                yield from value.__iter__(key)\n            else:\n                yield key\n\n    def __repr__(self):\n        return (\n            f\"{self.__class__.__name__}(\"\n            f\"{', '.join(f'{key}={value!r}' for key, value in self._dict.items())})\"  # pylint: disable=line-too-long\n        )\n\n    def clear(self):\n        \"\"\"Clear all keys.\"\"\"\n        self._dict.clear()\n\n    def copy(self):\n        \"\"\"Returns a deep copy of self.\"\"\"\n        return copy.deepcopy(self)\n\n    @staticmethod\n    def fromkeys(iterable, value=None):\n        \"\"\"Returns a new NADict with keys from `iterable` and values\n        set to `value`.\"\"\"\n        res = NADict()\n        for key in iterable:\n            res[key] = value\n        return res\n\n    def get(self, key, default=None):\n        \"\"\"Returns the value for `key` if `key` is in self, else return\n        `default`.\"\"\"\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1].get(key2, default)\n        return self._dict.get(key, default)\n\n    def items(self, prefix=\"\"):\n        \"\"\"Returns an iterator over all items as (key, value) pairs.\"\"\"\n        for key, value in self._dict.items():\n            key = f\"{prefix}.{key}\" if prefix else key\n            if isinstance(value, NADict):\n                yield from value.items(key)\n            else:\n                yield (key, value)\n\n    def keys(self, prefix=\"\"):\n        \"\"\"Returns an iterator over all keys.\"\"\"\n        for key, value in self._dict.items():\n            key = f\"{prefix}.{key}\" if prefix else key\n            if isinstance(value, NADict):\n                yield from value.keys(key)\n            else:\n                yield key\n\n    def pop(self, key, default=None):\n        \"\"\"Removed `key` and returns corresponding value.  If `key` is not\n        found, `default` is returned if given, otherwise KeyError is\n        raised.\"\"\"\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1].pop(key2, default)\n        return self._dict.pop(key, default)\n\n    def popitem(self, prefix=\"\"):\n        \"\"\"Removes and returns some (key, value). Raises KeyError if empty.\"\"\"\n        item = self._dict.popitem()\n        if isinstance(item, NADict):\n            key, value = item\n            item2 = item.popitem(key)\n            self._dict[key] = value\n            return item2\n        key, value = self._dict.popitem()\n        key = f\"{prefix}.{key}\" if prefix else key\n        return (key, value)\n\n    def setdefault(self, key, value=None):\n        \"\"\"Inserts `key` and `value` pair if key is not found.\n\n        Returns the new value for `key`.\"\"\"\n        if \".\" in key:\n            key1, key2 = key.split(\".\", 1)\n            return self._dict[key1].setdefault(key2, value)\n        return self._dict.setdefault(key, value)\n\n    def update(self, *args, **kwargs):\n        \"\"\"Updates self with dict/iterable from `args` and keyword arguments\n        from `kw`.\"\"\"\n        for arg in args:\n            if hasattr(arg, \"keys\"):\n                for _ in arg:\n                    self[_] = arg[_]\n            else:\n                for key, value in arg:\n                    self[key] = value\n        for key, value in kwargs.items():\n            self[key] = value\n\n    def values(self):\n        \"\"\"Returns a set-like providing a view of all style values.\"\"\"\n        return self._dict.values()\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.clear","title":"<code>clear(self)</code>","text":"<p>Clear all keys.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def clear(self):\n    \"\"\"Clear all keys.\"\"\"\n    self._dict.clear()\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.copy","title":"<code>copy(self)</code>","text":"<p>Returns a deep copy of self.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def copy(self):\n    \"\"\"Returns a deep copy of self.\"\"\"\n    return copy.deepcopy(self)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.fromkeys","title":"<code>fromkeys(iterable, value=None)</code>  <code>staticmethod</code>","text":"<p>Returns a new NADict with keys from <code>iterable</code> and values set to <code>value</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>@staticmethod\ndef fromkeys(iterable, value=None):\n    \"\"\"Returns a new NADict with keys from `iterable` and values\n    set to `value`.\"\"\"\n    res = NADict()\n    for key in iterable:\n        res[key] = value\n    return res\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.get","title":"<code>get(self, key, default=None)</code>","text":"<p>Returns the value for <code>key</code> if <code>key</code> is in self, else return <code>default</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def get(self, key, default=None):\n    \"\"\"Returns the value for `key` if `key` is in self, else return\n    `default`.\"\"\"\n    if \".\" in key:\n        key1, key2 = key.split(\".\", 1)\n        return self._dict[key1].get(key2, default)\n    return self._dict.get(key, default)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.items","title":"<code>items(self, prefix='')</code>","text":"<p>Returns an iterator over all items as (key, value) pairs.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def items(self, prefix=\"\"):\n    \"\"\"Returns an iterator over all items as (key, value) pairs.\"\"\"\n    for key, value in self._dict.items():\n        key = f\"{prefix}.{key}\" if prefix else key\n        if isinstance(value, NADict):\n            yield from value.items(key)\n        else:\n            yield (key, value)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.keys","title":"<code>keys(self, prefix='')</code>","text":"<p>Returns an iterator over all keys.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def keys(self, prefix=\"\"):\n    \"\"\"Returns an iterator over all keys.\"\"\"\n    for key, value in self._dict.items():\n        key = f\"{prefix}.{key}\" if prefix else key\n        if isinstance(value, NADict):\n            yield from value.keys(key)\n        else:\n            yield key\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.pop","title":"<code>pop(self, key, default=None)</code>","text":"<p>Removed <code>key</code> and returns corresponding value.  If <code>key</code> is not found, <code>default</code> is returned if given, otherwise KeyError is raised.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def pop(self, key, default=None):\n    \"\"\"Removed `key` and returns corresponding value.  If `key` is not\n    found, `default` is returned if given, otherwise KeyError is\n    raised.\"\"\"\n    if \".\" in key:\n        key1, key2 = key.split(\".\", 1)\n        return self._dict[key1].pop(key2, default)\n    return self._dict.pop(key, default)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.popitem","title":"<code>popitem(self, prefix='')</code>","text":"<p>Removes and returns some (key, value). Raises KeyError if empty.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def popitem(self, prefix=\"\"):\n    \"\"\"Removes and returns some (key, value). Raises KeyError if empty.\"\"\"\n    item = self._dict.popitem()\n    if isinstance(item, NADict):\n        key, value = item\n        item2 = item.popitem(key)\n        self._dict[key] = value\n        return item2\n    key, value = self._dict.popitem()\n    key = f\"{prefix}.{key}\" if prefix else key\n    return (key, value)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.setdefault","title":"<code>setdefault(self, key, value=None)</code>","text":"<p>Inserts <code>key</code> and <code>value</code> pair if key is not found.</p> <p>Returns the new value for <code>key</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def setdefault(self, key, value=None):\n    \"\"\"Inserts `key` and `value` pair if key is not found.\n\n    Returns the new value for `key`.\"\"\"\n    if \".\" in key:\n        key1, key2 = key.split(\".\", 1)\n        return self._dict[key1].setdefault(key2, value)\n    return self._dict.setdefault(key, value)\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.update","title":"<code>update(self, *args, **kwargs)</code>","text":"<p>Updates self with dict/iterable from <code>args</code> and keyword arguments from <code>kw</code>.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def update(self, *args, **kwargs):\n    \"\"\"Updates self with dict/iterable from `args` and keyword arguments\n    from `kw`.\"\"\"\n    for arg in args:\n        if hasattr(arg, \"keys\"):\n            for _ in arg:\n                self[_] = arg[_]\n        else:\n            for key, value in arg:\n                self[key] = value\n    for key, value in kwargs.items():\n        self[key] = value\n</code></pre>"},{"location":"api_reference/ontopy/nadict/#ontopy.nadict.NADict.values","title":"<code>values(self)</code>","text":"<p>Returns a set-like providing a view of all style values.</p> Source code in <code>ontopy/nadict.py</code> <pre><code>def values(self):\n    \"\"\"Returns a set-like providing a view of all style values.\"\"\"\n    return self._dict.values()\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/","title":"ontodoc","text":"<p>A module for documenting ontologies.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.AttributeDict","title":"<code> AttributeDict            (dict)         </code>","text":"<p>A dict with attribute access.</p> <p>Note that methods like key() and update() may be overridden.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class AttributeDict(dict):\n    \"\"\"A dict with attribute access.\n\n    Note that methods like key() and update() may be overridden.\"\"\"\n\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.__dict__ = self\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP","title":"<code> DocPP        </code>","text":"<p>Documentation pre-processor.</p> <p>It supports the following features:</p> <ul> <li> <p>Comment lines</p> <pre><code>%% Comment line...\n</code></pre> </li> <li> <p>Insert header with given level</p> <pre><code>%HEADER label [level=1]\n</code></pre> </li> <li> <p>Insert figure with optional caption and width. <code>filepath</code>     should be relative to <code>basedir</code>.  If width is 0, no width will     be specified.</p> <pre><code>%FIGURE filepath [caption='' width=0px]\n</code></pre> </li> <li> <p>Include other markdown files.  Header levels may be up or down with     <code>shift</code></p> <pre><code>%INCLUDE filepath [shift=0]\n</code></pre> </li> <li> <p>Insert generated documentation for ontology entity.  The header     level may be set with <code>header_level</code>.</p> <pre><code>%ENTITY name [header_level=3]\n</code></pre> </li> <li> <p>Insert generated documentation for ontology branch <code>name</code>.  Options:</p> <ul> <li>header_level: Header level.</li> <li>terminated: Whether to branch should be terminated at all branch     names in the final document.</li> <li> <p>include_leaves: Whether to include leaves as end points     to the branch.</p> <p>%BRANCH name [header_level=3 terminated=1 include_leaves=0               namespaces='' ontologies='']</p> </li> </ul> </li> <li> <p>Insert generated figure of ontology branch <code>name</code>.  The figure     is written to <code>path</code>.  The default path is <code>figdir</code>/<code>name</code>,     where <code>figdir</code> is given at class initiation. It is recommended     to exclude the file extension from <code>path</code>.  In this case, the     default figformat will be used (and easily adjusted to the     correct format required by the backend). <code>leaves</code> may be a comma-     separated list of leaf node names.</p> <pre><code>%BRANCHFIG name [path='' caption='' terminated=1 include_leaves=1\n                 strict_leaves=1, width=0px leaves='' relations=all\n                 edgelabels=0 namespaces='' ontologies='']\n</code></pre> </li> <li> <p>This is a combination of the %HEADER and %BRANCHFIG directives.</p> <pre><code>%BRANCHHEAD name [level=2  path='' caption='' terminated=1\n                  include_leaves=1 width=0px leaves='']\n</code></pre> </li> <li> <p>This is a combination of the %HEADER, %BRANCHFIG and %BRANCH     directives. It inserts documentation of branch <code>name</code>, with a     header followed by a figure and then documentation of each     element.</p> <pre><code>%BRANCHDOC name [level=2  path='' title='' caption='' terminated=1\n                 strict_leaves=1 width=0px leaves='' relations='all'\n                 rankdir='BT' legend=1 namespaces='' ontologies='']\n</code></pre> </li> <li> <p>Insert generated documentation for all entities of the given type.     Valid values of <code>type</code> are: \"classes\", \"individuals\",     \"object_properties\", \"data_properties\", \"annotations_properties\"</p> <pre><code>%ALL type [header_level=3, namespaces='', ontologies='']\n</code></pre> </li> <li> <p>Insert generated figure of all entities of the given type.     Valid values of <code>type</code> are: \"classes\", \"object_properties\" and     \"data_properties\".</p> <pre><code>%ALLFIG type\n</code></pre> </li> </ul>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP--parameters","title":"Parameters","text":"<p>template : str     Input template. ontodoc : OntoDoc instance     Instance of OntoDoc basedir : str     Base directory for including relative file paths. figdir : str     Default directory to store generated figures. figformat : str     Default format for generated figures. figscale : float     Default scaling of generated figures. maxwidth : float     Maximum figure width.  Figures larger than this will be rescaled. imported : bool     Whether to include imported entities.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class DocPP:  # pylint: disable=too-many-instance-attributes\n    \"\"\"Documentation pre-processor.\n\n    It supports the following features:\n\n      * Comment lines\n\n            %% Comment line...\n\n      * Insert header with given level\n\n            %HEADER label [level=1]\n\n      * Insert figure with optional caption and width. `filepath`\n        should be relative to `basedir`.  If width is 0, no width will\n        be specified.\n\n            %FIGURE filepath [caption='' width=0px]\n\n      * Include other markdown files.  Header levels may be up or down with\n        `shift`\n\n            %INCLUDE filepath [shift=0]\n\n      * Insert generated documentation for ontology entity.  The header\n        level may be set with `header_level`.\n\n            %ENTITY name [header_level=3]\n\n      * Insert generated documentation for ontology branch `name`.  Options:\n          - header_level: Header level.\n          - terminated: Whether to branch should be terminated at all branch\n            names in the final document.\n          - include_leaves: Whether to include leaves as end points\n            to the branch.\n\n            %BRANCH name [header_level=3 terminated=1 include_leaves=0\n                          namespaces='' ontologies='']\n\n      * Insert generated figure of ontology branch `name`.  The figure\n        is written to `path`.  The default path is `figdir`/`name`,\n        where `figdir` is given at class initiation. It is recommended\n        to exclude the file extension from `path`.  In this case, the\n        default figformat will be used (and easily adjusted to the\n        correct format required by the backend). `leaves` may be a comma-\n        separated list of leaf node names.\n\n            %BRANCHFIG name [path='' caption='' terminated=1 include_leaves=1\n                             strict_leaves=1, width=0px leaves='' relations=all\n                             edgelabels=0 namespaces='' ontologies='']\n\n      * This is a combination of the %HEADER and %BRANCHFIG directives.\n\n            %BRANCHHEAD name [level=2  path='' caption='' terminated=1\n                              include_leaves=1 width=0px leaves='']\n\n      * This is a combination of the %HEADER, %BRANCHFIG and %BRANCH\n        directives. It inserts documentation of branch `name`, with a\n        header followed by a figure and then documentation of each\n        element.\n\n            %BRANCHDOC name [level=2  path='' title='' caption='' terminated=1\n                             strict_leaves=1 width=0px leaves='' relations='all'\n                             rankdir='BT' legend=1 namespaces='' ontologies='']\n\n      * Insert generated documentation for all entities of the given type.\n        Valid values of `type` are: \"classes\", \"individuals\",\n        \"object_properties\", \"data_properties\", \"annotations_properties\"\n\n            %ALL type [header_level=3, namespaces='', ontologies='']\n\n      * Insert generated figure of all entities of the given type.\n        Valid values of `type` are: \"classes\", \"object_properties\" and\n        \"data_properties\".\n\n            %ALLFIG type\n\n    Parameters\n    ----------\n    template : str\n        Input template.\n    ontodoc : OntoDoc instance\n        Instance of OntoDoc\n    basedir : str\n        Base directory for including relative file paths.\n    figdir : str\n        Default directory to store generated figures.\n    figformat : str\n        Default format for generated figures.\n    figscale : float\n        Default scaling of generated figures.\n    maxwidth : float\n        Maximum figure width.  Figures larger than this will be rescaled.\n    imported : bool\n        Whether to include imported entities.\n    \"\"\"\n\n    # FIXME - this class should be refractured:\n    #   * Instead of rescan the entire document for each pre-processer\n    #     directive, we should scan the source like by line and handle\n    #     each directive as they occour.\n    #   * The current implementation has a lot of dublicated code.\n    #   * Instead of modifying the source in-place, we should copy to a\n    #     result list. This will make good error reporting much easier.\n    #   * Branch leaves are only looked up in the file witht the %BRANCH\n    #     directive, not in all included files as expedted.\n\n    def __init__(  # pylint: disable=too-many-arguments\n        self,\n        template,\n        ontodoc,\n        basedir=\".\",\n        figdir=\"genfigs\",\n        figformat=\"png\",\n        figscale=1.0,\n        maxwidth=None,\n        imported=False,\n    ):\n        self.lines = template.split(\"\\n\")\n        self.ontodoc = ontodoc\n        self.basedir = basedir\n        self.figdir = os.path.join(basedir, figdir)\n        self.figformat = figformat\n        self.figscale = figscale\n        self.maxwidth = maxwidth\n        self.imported = imported\n        self._branch_cache = None\n        self._processed = False  # Whether process() has been called\n\n    def __str__(self):\n        return self.get_buffer()\n\n    def get_buffer(self):\n        \"\"\"Returns the current buffer.\"\"\"\n        return \"\\n\".join(self.lines)\n\n    def copy(self):\n        \"\"\"Returns a copy of self.\"\"\"\n        docpp = DocPP(\n            \"\",\n            self.ontodoc,\n            self.basedir,\n            figformat=self.figformat,\n            figscale=self.figscale,\n            maxwidth=self.maxwidth,\n        )\n        docpp.lines[:] = self.lines\n        docpp.figdir = self.figdir\n        return docpp\n\n    def get_branches(self):\n        \"\"\"Returns a list with all branch names as specified with %BRANCH\n        (in current and all included documents).  The returned value is\n        cached for efficiency purposes and so that it is not lost after\n        processing branches.\"\"\"\n        if self._branch_cache is None:\n            names = []\n            docpp = self.copy()\n            docpp.process_includes()\n            for line in docpp.lines:\n                if line.startswith(\"%BRANCH\"):\n                    names.append(shlex.split(line)[1])\n            self._branch_cache = names\n        return self._branch_cache\n\n    def shift_header_levels(self, shift):\n        \"\"\"Shift header level of all hashtag-headers in buffer.  Underline\n        headers are ignored.\"\"\"\n        if not shift:\n            return\n        pat = re.compile(\"^#+ \")\n        for i, line in enumerate(self.lines):\n            match = pat.match(line)\n            if match:\n                if shift &gt; 0:\n                    self.lines[i] = \"#\" * shift + line\n                elif shift &lt; 0:\n                    counter = match.end()\n                    if shift &gt; counter:\n                        self.lines[i] = line.lstrip(\"# \")\n                    else:\n                        self.lines[i] = line[counter:]\n\n    def process_comments(self):\n        \"\"\"Strips out comment lines starting with \"%%\".\"\"\"\n        self.lines = [line for line in self.lines if not line.startswith(\"%%\")]\n\n    def process_headers(self):\n        \"\"\"Expand all %HEADER specifications.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%HEADER \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(tokens[2:], level=1)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.get_header(\n                    name, int(opts.level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_figures(self):\n        \"\"\"Expand all %FIGURE specifications.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%FIGURE \"):\n                tokens = shlex.split(line)\n                path = tokens[1]\n                opts = get_options(tokens[2:], caption=\"\", width=0)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.get_figure(\n                    os.path.join(self.basedir, path),\n                    caption=opts.caption,  # pylint: disable=no-member\n                    width=opts.width,  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_entities(self):\n        \"\"\"Expand all %ENTITY specifications.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%ENTITY \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(tokens[2:], header_level=3)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.itemdoc(\n                    name, int(opts.header_level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_branches(self):\n        \"\"\"Expand all %BRANCH specifications.\"\"\"\n        onto = self.ontodoc.onto\n\n        # Get all branch names in final document\n        names = self.get_branches()\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%BRANCH \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(\n                    tokens[2:],\n                    header_level=3,\n                    terminated=1,\n                    include_leaves=0,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n                leaves = (\n                    names if opts.terminated else ()\n                )  # pylint: disable=no-member\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                branch = filter_classes(\n                    onto.get_branch(\n                        name, leaves, opts.include_leaves\n                    ),  # pylint: disable=no-member\n                    included_namespaces=included_namespaces,\n                    included_ontologies=included_ontologies,\n                )\n\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.itemsdoc(\n                    branch, int(opts.header_level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def _make_branchfig(  # pylint: disable=too-many-arguments,too-many-locals\n        self,\n        name: str,\n        path: \"Union[Path, str]\",\n        terminated: bool,\n        include_leaves: bool,\n        strict_leaves: bool,\n        width: float,\n        leaves: \"Union[str, list[str]]\",\n        relations: str,\n        edgelabels: str,\n        rankdir: str,\n        legend: bool,\n        included_namespaces: \"Iterable[str]\",\n        included_ontologies: \"Iterable[str]\",\n    ) -&gt; \"tuple[str, list[str], float]\":\n        \"\"\"Help method for process_branchfig().\n\n        Args:\n            name: name of branch root\n            path: optional figure path name\n            include_leaves: whether to include leaves as end points\n                to the branch.\n            strict_leaves: whether to strictly exclude leave descendants\n            terminated: whether the graph should be terminated at leaf nodes\n            width: optional figure width\n            leaves: optional leaf node names for graph termination\n            relations: comma-separated list of relations to include\n            edgelabels: whether to include edgelabels\n            rankdir: graph direction (BT, TB, RL, LR)\n            legend: whether to add legend\n            included_namespaces: sequence of names of namespaces to be included\n            included_ontologies: sequence of names of ontologies to be included\n\n        Returns:\n            filepath: path to generated figure\n            leaves: used list of leaf node names\n            width: actual figure width\n\n        \"\"\"\n        onto = self.ontodoc.onto\n        if leaves:\n            if isinstance(leaves, str):\n                leaves = leaves.split(\",\")\n        elif terminated:\n            leaves = set(self.get_branches())\n            leaves.discard(name)\n        else:\n            leaves = None\n        if path:\n            figdir = os.path.dirname(path)\n            formatext = os.path.splitext(path)[1]\n            if formatext:\n                fmt = formatext.lstrip(\".\")\n            else:\n                fmt = self.figformat\n                path += f\".{fmt}\"\n        else:\n            figdir = self.figdir\n            fmt = self.figformat\n            term = \"T\" if terminated else \"\"\n            path = os.path.join(figdir, name + term) + f\".{fmt}\"\n\n        # Create graph\n        graph = OntoGraph(onto, graph_attr={\"rankdir\": rankdir})\n        graph.add_branch(\n            root=name,\n            leaves=leaves,\n            include_leaves=include_leaves,\n            strict_leaves=strict_leaves,\n            relations=relations,\n            edgelabels=edgelabels,\n            included_namespaces=included_namespaces,\n            included_ontologies=included_ontologies,\n        )\n        if legend:\n            graph.add_legend()\n\n        if not width:\n            figwidth, _ = graph.get_figsize()\n            width = self.figscale * figwidth\n            if self.maxwidth and width &gt; self.maxwidth:\n                width = self.maxwidth\n\n        filepath = os.path.join(self.basedir, path)\n        destdir = os.path.dirname(filepath)\n        if not os.path.exists(destdir):\n            os.makedirs(destdir)\n        graph.save(filepath, fmt=fmt)\n        return filepath, leaves, width\n\n    def process_branchfigs(self):\n        \"\"\"Process all %BRANCHFIG directives.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%BRANCHFIG \"):\n                tokens = shlex.split(line)\n                name = tokens[1]\n                opts = get_options(\n                    tokens[2:],\n                    path=\"\",\n                    caption=\"\",\n                    terminated=1,\n                    include_leaves=1,\n                    strict_leaves=1,\n                    width=0,\n                    leaves=\"\",\n                    relations=\"all\",\n                    edgelabels=0,\n                    rankdir=\"BT\",\n                    legend=1,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                filepath, _, width = self._make_branchfig(\n                    name,\n                    opts.path,  # pylint: disable=no-member\n                    opts.terminated,  # pylint: disable=no-member\n                    opts.include_leaves,  # pylint: disable=no-member\n                    opts.strict_leaves,  # pylint: disable=no-member\n                    opts.width,  # pylint: disable=no-member\n                    opts.leaves,  # pylint: disable=no-member\n                    opts.relations,  # pylint: disable=no-member\n                    opts.edgelabels,  # pylint: disable=no-member\n                    opts.rankdir,  # pylint: disable=no-member\n                    opts.legend,  # pylint: disable=no-member\n                    included_namespaces,\n                    included_ontologies,\n                )\n\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.get_figure(\n                    filepath,\n                    caption=opts.caption,\n                    width=width,  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_branchdocs(self):  # pylint: disable=too-many-locals\n        \"\"\"Process all %BRANCHDOC and  %BRANCHEAD directives.\"\"\"\n        onto = self.ontodoc.onto\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%BRANCHDOC \") or line.startswith(\n                \"%BRANCHHEAD \"\n            ):\n                with_branch = bool(line.startswith(\"%BRANCHDOC \"))\n                tokens = shlex.split(line)\n                name = tokens[1]\n                title = camelsplit(name)\n                title = title[0].upper() + title[1:] + \" branch\"\n                opts = get_options(\n                    tokens[2:],\n                    level=2,\n                    path=\"\",\n                    title=title,\n                    caption=title + \".\",\n                    terminated=1,\n                    strict_leaves=1,\n                    width=0,\n                    leaves=\"\",\n                    relations=\"all\",\n                    edgelabels=0,\n                    rankdir=\"BT\",\n                    legend=1,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                include_leaves = 1\n                filepath, leaves, width = self._make_branchfig(\n                    name,\n                    opts.path,  # pylint: disable=no-member\n                    opts.terminated,  # pylint: disable=no-member\n                    include_leaves,\n                    opts.strict_leaves,  # pylint: disable=no-member\n                    opts.width,  # pylint: disable=no-member\n                    opts.leaves,  # pylint: disable=no-member\n                    opts.relations,  # pylint: disable=no-member\n                    opts.edgelabels,  # pylint: disable=no-member\n                    opts.rankdir,  # pylint: disable=no-member\n                    opts.legend,  # pylint: disable=no-member\n                    included_namespaces,\n                    included_ontologies,\n                )\n\n                sec = []\n                sec.append(\n                    self.ontodoc.get_header(opts.title, int(opts.level))\n                )  # pylint: disable=no-member\n                sec.append(\n                    self.ontodoc.get_figure(\n                        filepath,\n                        caption=opts.caption,\n                        width=width,  # pylint: disable=no-member\n                    )\n                )\n                if with_branch:\n                    include_leaves = 0\n                    branch = filter_classes(\n                        onto.get_branch(name, leaves, include_leaves),\n                        included_namespaces=included_namespaces,\n                        included_ontologies=included_ontologies,\n                    )\n                    sec.append(\n                        self.ontodoc.itemsdoc(\n                            branch, int(opts.level + 1)\n                        )  # pylint: disable=no-member\n                    )\n\n                del self.lines[i]\n                self.lines[i:i] = sec\n\n    def process_alls(self):\n        \"\"\"Expand all %ALL specifications.\"\"\"\n        onto = self.ontodoc.onto\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%ALL \"):\n                tokens = shlex.split(line)\n                token = tokens[1]\n                opts = get_options(tokens[2:], header_level=3)\n                if token == \"classes\":  # nosec\n                    items = onto.classes(imported=self.imported)\n                elif token in (\"object_properties\", \"relations\"):\n                    items = onto.object_properties(imported=self.imported)\n                elif token == \"data_properties\":  # nosec\n                    items = onto.data_properties(imported=self.imported)\n                elif token == \"annotation_properties\":  # nosec\n                    items = onto.annotation_properties(imported=self.imported)\n                elif token == \"individuals\":  # nosec\n                    items = onto.individuals(imported=self.imported)\n                else:\n                    raise InvalidTemplateError(\n                        f\"Invalid argument to %%ALL: {token}\"\n                    )\n                items = sorted(items, key=get_label)\n                del self.lines[i]\n                self.lines[i:i] = self.ontodoc.itemsdoc(\n                    items, int(opts.header_level)  # pylint: disable=no-member\n                ).split(\"\\n\")\n\n    def process_allfig(self):  # pylint: disable=too-many-locals\n        \"\"\"Process all %ALLFIG directives.\"\"\"\n        onto = self.ontodoc.onto\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%ALLFIG \"):\n                tokens = shlex.split(line)\n                token = tokens[1]\n                opts = get_options(\n                    tokens[2:],\n                    path=\"\",\n                    level=3,\n                    terminated=0,\n                    include_leaves=1,\n                    strict_leaves=1,\n                    width=0,\n                    leaves=\"\",\n                    relations=\"isA\",\n                    edgelabels=0,\n                    rankdir=\"BT\",\n                    legend=1,\n                    namespaces=\"\",\n                    ontologies=\"\",\n                )\n                if token == \"classes\":  # nosec\n                    roots = onto.get_root_classes(imported=self.imported)\n                elif token in (\"object_properties\", \"relations\"):\n                    roots = onto.get_root_object_properties(\n                        imported=self.imported\n                    )\n                elif token == \"data_properties\":  # nosec\n                    roots = onto.get_root_data_properties(\n                        imported=self.imported\n                    )\n                else:\n                    raise InvalidTemplateError(\n                        f\"Invalid argument to %%ALLFIG: {token}\"\n                    )\n\n                included_namespaces = (\n                    opts.namespaces.split(\",\")\n                    if opts.namespaces\n                    else ()  # pylint: disable=no-member\n                )\n                included_ontologies = (\n                    opts.ontologies.split(\",\")\n                    if opts.ontologies\n                    else ()  # pylint: disable=no-member\n                )\n\n                sec = []\n                for root in roots:\n                    name = asstring(root, link=\"{label}\", ontology=onto)\n                    filepath, _, width = self._make_branchfig(\n                        name,\n                        opts.path,  # pylint: disable=no-member\n                        opts.terminated,  # pylint: disable=no-member\n                        opts.include_leaves,  # pylint: disable=no-member\n                        opts.strict_leaves,  # pylint: disable=no-member\n                        opts.width,  # pylint: disable=no-member\n                        opts.leaves,  # pylint: disable=no-member\n                        opts.relations,  # pylint: disable=no-member\n                        opts.edgelabels,  # pylint: disable=no-member\n                        opts.rankdir,  # pylint: disable=no-member\n                        opts.legend,  # pylint: disable=no-member\n                        included_namespaces,\n                        included_ontologies,\n                    )\n                    title = f\"Taxonomy of {name}.\"\n                    sec.append(\n                        self.ontodoc.get_header(title, int(opts.level))\n                    )  # pylint: disable=no-member\n                    sec.extend(\n                        self.ontodoc.get_figure(\n                            filepath, caption=title, width=width\n                        ).split(\"\\n\")\n                    )\n\n                del self.lines[i]\n                self.lines[i:i] = sec\n\n    def process_includes(self):\n        \"\"\"Process all %INCLUDE directives.\"\"\"\n        for i, line in reversed(list(enumerate(self.lines))):\n            if line.startswith(\"%INCLUDE \"):\n                tokens = shlex.split(line)\n                filepath = tokens[1]\n                opts = get_options(tokens[2:], shift=0)\n                with open(\n                    os.path.join(self.basedir, filepath), \"rt\", encoding=\"utf8\"\n                ) as handle:\n                    docpp = DocPP(\n                        handle.read(),\n                        self.ontodoc,\n                        basedir=os.path.dirname(filepath),\n                        figformat=self.figformat,\n                        figscale=self.figscale,\n                        maxwidth=self.maxwidth,\n                    )\n                    docpp.figdir = self.figdir\n                if opts.shift:  # pylint: disable=no-member\n                    docpp.shift_header_levels(\n                        int(opts.shift)\n                    )  # pylint: disable=no-member\n                docpp.process()\n                del self.lines[i]\n                self.lines[i:i] = docpp.lines\n\n    def process(self):\n        \"\"\"Perform all pre-processing steps.\"\"\"\n        if not self._processed:\n            self.process_comments()\n            self.process_headers()\n            self.process_figures()\n            self.process_entities()\n            self.process_branches()\n            self.process_branchfigs()\n            self.process_branchdocs()\n            self.process_alls()\n            self.process_allfig()\n            self.process_includes()\n            self._processed = True\n\n    def write(  # pylint: disable=too-many-arguments\n        self,\n        outfile,\n        fmt=None,\n        pandoc_option_files=(),\n        pandoc_options=(),\n        genfile=None,\n        verbose=True,\n    ):\n        \"\"\"Writes documentation to `outfile`.\n\n        Parameters\n        ----------\n        outfile : str\n            File that the documentation is written to.\n        fmt : str\n            Output format.  If it is \"md\" or \"simple-html\",\n            the built-in template generator is used.  Otherwise\n            pandoc is used.  If not given, the format is inferred\n            from the `outfile` name extension.\n        pandoc_option_files : sequence\n            Sequence with command line arguments provided to pandoc.\n        pandoc_options : sequence\n            Additional pandoc options overriding options read from\n        `pandoc_option_files`.\n        genfile : str\n            Store temporary generated markdown input file to pandoc\n            to this file (for debugging).\n        verbose : bool\n            Whether to show some messages when running pandoc.\n        \"\"\"\n        self.process()\n        content = self.get_buffer()\n\n        substitutions = self.ontodoc.style.get(\"substitutions\", [])\n        for reg, sub in substitutions:\n            content = re.sub(reg, sub, content)\n\n        fmt = get_format(outfile, default=\"html\", fmt=fmt)\n        if fmt not in (\"simple-html\", \"markdown\", \"md\"):  # Run pandoc\n            if not genfile:\n                with NamedTemporaryFile(mode=\"w+t\", suffix=\".md\") as temp_file:\n                    temp_file.write(content)\n                    temp_file.flush()\n                    genfile = temp_file.name\n\n                    run_pandoc(\n                        genfile,\n                        outfile,\n                        fmt,\n                        pandoc_option_files=pandoc_option_files,\n                        pandoc_options=pandoc_options,\n                        verbose=verbose,\n                    )\n            else:\n                with open(genfile, \"wt\") as handle:\n                    handle.write(content)\n\n                run_pandoc(\n                    genfile,\n                    outfile,\n                    fmt,\n                    pandoc_option_files=pandoc_option_files,\n                    pandoc_options=pandoc_options,\n                    verbose=verbose,\n                )\n        else:\n            if verbose:\n                print(\"Writing:\", outfile)\n            with open(outfile, \"wt\") as handle:\n                handle.write(content)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.copy","title":"<code>copy(self)</code>","text":"<p>Returns a copy of self.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def copy(self):\n    \"\"\"Returns a copy of self.\"\"\"\n    docpp = DocPP(\n        \"\",\n        self.ontodoc,\n        self.basedir,\n        figformat=self.figformat,\n        figscale=self.figscale,\n        maxwidth=self.maxwidth,\n    )\n    docpp.lines[:] = self.lines\n    docpp.figdir = self.figdir\n    return docpp\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.get_branches","title":"<code>get_branches(self)</code>","text":"<p>Returns a list with all branch names as specified with %BRANCH (in current and all included documents).  The returned value is cached for efficiency purposes and so that it is not lost after processing branches.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_branches(self):\n    \"\"\"Returns a list with all branch names as specified with %BRANCH\n    (in current and all included documents).  The returned value is\n    cached for efficiency purposes and so that it is not lost after\n    processing branches.\"\"\"\n    if self._branch_cache is None:\n        names = []\n        docpp = self.copy()\n        docpp.process_includes()\n        for line in docpp.lines:\n            if line.startswith(\"%BRANCH\"):\n                names.append(shlex.split(line)[1])\n        self._branch_cache = names\n    return self._branch_cache\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.get_buffer","title":"<code>get_buffer(self)</code>","text":"<p>Returns the current buffer.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_buffer(self):\n    \"\"\"Returns the current buffer.\"\"\"\n    return \"\\n\".join(self.lines)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process","title":"<code>process(self)</code>","text":"<p>Perform all pre-processing steps.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process(self):\n    \"\"\"Perform all pre-processing steps.\"\"\"\n    if not self._processed:\n        self.process_comments()\n        self.process_headers()\n        self.process_figures()\n        self.process_entities()\n        self.process_branches()\n        self.process_branchfigs()\n        self.process_branchdocs()\n        self.process_alls()\n        self.process_allfig()\n        self.process_includes()\n        self._processed = True\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_allfig","title":"<code>process_allfig(self)</code>","text":"<p>Process all %ALLFIG directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_allfig(self):  # pylint: disable=too-many-locals\n    \"\"\"Process all %ALLFIG directives.\"\"\"\n    onto = self.ontodoc.onto\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%ALLFIG \"):\n            tokens = shlex.split(line)\n            token = tokens[1]\n            opts = get_options(\n                tokens[2:],\n                path=\"\",\n                level=3,\n                terminated=0,\n                include_leaves=1,\n                strict_leaves=1,\n                width=0,\n                leaves=\"\",\n                relations=\"isA\",\n                edgelabels=0,\n                rankdir=\"BT\",\n                legend=1,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n            if token == \"classes\":  # nosec\n                roots = onto.get_root_classes(imported=self.imported)\n            elif token in (\"object_properties\", \"relations\"):\n                roots = onto.get_root_object_properties(\n                    imported=self.imported\n                )\n            elif token == \"data_properties\":  # nosec\n                roots = onto.get_root_data_properties(\n                    imported=self.imported\n                )\n            else:\n                raise InvalidTemplateError(\n                    f\"Invalid argument to %%ALLFIG: {token}\"\n                )\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            sec = []\n            for root in roots:\n                name = asstring(root, link=\"{label}\", ontology=onto)\n                filepath, _, width = self._make_branchfig(\n                    name,\n                    opts.path,  # pylint: disable=no-member\n                    opts.terminated,  # pylint: disable=no-member\n                    opts.include_leaves,  # pylint: disable=no-member\n                    opts.strict_leaves,  # pylint: disable=no-member\n                    opts.width,  # pylint: disable=no-member\n                    opts.leaves,  # pylint: disable=no-member\n                    opts.relations,  # pylint: disable=no-member\n                    opts.edgelabels,  # pylint: disable=no-member\n                    opts.rankdir,  # pylint: disable=no-member\n                    opts.legend,  # pylint: disable=no-member\n                    included_namespaces,\n                    included_ontologies,\n                )\n                title = f\"Taxonomy of {name}.\"\n                sec.append(\n                    self.ontodoc.get_header(title, int(opts.level))\n                )  # pylint: disable=no-member\n                sec.extend(\n                    self.ontodoc.get_figure(\n                        filepath, caption=title, width=width\n                    ).split(\"\\n\")\n                )\n\n            del self.lines[i]\n            self.lines[i:i] = sec\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_alls","title":"<code>process_alls(self)</code>","text":"<p>Expand all %ALL specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_alls(self):\n    \"\"\"Expand all %ALL specifications.\"\"\"\n    onto = self.ontodoc.onto\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%ALL \"):\n            tokens = shlex.split(line)\n            token = tokens[1]\n            opts = get_options(tokens[2:], header_level=3)\n            if token == \"classes\":  # nosec\n                items = onto.classes(imported=self.imported)\n            elif token in (\"object_properties\", \"relations\"):\n                items = onto.object_properties(imported=self.imported)\n            elif token == \"data_properties\":  # nosec\n                items = onto.data_properties(imported=self.imported)\n            elif token == \"annotation_properties\":  # nosec\n                items = onto.annotation_properties(imported=self.imported)\n            elif token == \"individuals\":  # nosec\n                items = onto.individuals(imported=self.imported)\n            else:\n                raise InvalidTemplateError(\n                    f\"Invalid argument to %%ALL: {token}\"\n                )\n            items = sorted(items, key=get_label)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.itemsdoc(\n                items, int(opts.header_level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_branchdocs","title":"<code>process_branchdocs(self)</code>","text":"<p>Process all %BRANCHDOC and  %BRANCHEAD directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_branchdocs(self):  # pylint: disable=too-many-locals\n    \"\"\"Process all %BRANCHDOC and  %BRANCHEAD directives.\"\"\"\n    onto = self.ontodoc.onto\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%BRANCHDOC \") or line.startswith(\n            \"%BRANCHHEAD \"\n        ):\n            with_branch = bool(line.startswith(\"%BRANCHDOC \"))\n            tokens = shlex.split(line)\n            name = tokens[1]\n            title = camelsplit(name)\n            title = title[0].upper() + title[1:] + \" branch\"\n            opts = get_options(\n                tokens[2:],\n                level=2,\n                path=\"\",\n                title=title,\n                caption=title + \".\",\n                terminated=1,\n                strict_leaves=1,\n                width=0,\n                leaves=\"\",\n                relations=\"all\",\n                edgelabels=0,\n                rankdir=\"BT\",\n                legend=1,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            include_leaves = 1\n            filepath, leaves, width = self._make_branchfig(\n                name,\n                opts.path,  # pylint: disable=no-member\n                opts.terminated,  # pylint: disable=no-member\n                include_leaves,\n                opts.strict_leaves,  # pylint: disable=no-member\n                opts.width,  # pylint: disable=no-member\n                opts.leaves,  # pylint: disable=no-member\n                opts.relations,  # pylint: disable=no-member\n                opts.edgelabels,  # pylint: disable=no-member\n                opts.rankdir,  # pylint: disable=no-member\n                opts.legend,  # pylint: disable=no-member\n                included_namespaces,\n                included_ontologies,\n            )\n\n            sec = []\n            sec.append(\n                self.ontodoc.get_header(opts.title, int(opts.level))\n            )  # pylint: disable=no-member\n            sec.append(\n                self.ontodoc.get_figure(\n                    filepath,\n                    caption=opts.caption,\n                    width=width,  # pylint: disable=no-member\n                )\n            )\n            if with_branch:\n                include_leaves = 0\n                branch = filter_classes(\n                    onto.get_branch(name, leaves, include_leaves),\n                    included_namespaces=included_namespaces,\n                    included_ontologies=included_ontologies,\n                )\n                sec.append(\n                    self.ontodoc.itemsdoc(\n                        branch, int(opts.level + 1)\n                    )  # pylint: disable=no-member\n                )\n\n            del self.lines[i]\n            self.lines[i:i] = sec\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_branches","title":"<code>process_branches(self)</code>","text":"<p>Expand all %BRANCH specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_branches(self):\n    \"\"\"Expand all %BRANCH specifications.\"\"\"\n    onto = self.ontodoc.onto\n\n    # Get all branch names in final document\n    names = self.get_branches()\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%BRANCH \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(\n                tokens[2:],\n                header_level=3,\n                terminated=1,\n                include_leaves=0,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n            leaves = (\n                names if opts.terminated else ()\n            )  # pylint: disable=no-member\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            branch = filter_classes(\n                onto.get_branch(\n                    name, leaves, opts.include_leaves\n                ),  # pylint: disable=no-member\n                included_namespaces=included_namespaces,\n                included_ontologies=included_ontologies,\n            )\n\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.itemsdoc(\n                branch, int(opts.header_level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_branchfigs","title":"<code>process_branchfigs(self)</code>","text":"<p>Process all %BRANCHFIG directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_branchfigs(self):\n    \"\"\"Process all %BRANCHFIG directives.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%BRANCHFIG \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(\n                tokens[2:],\n                path=\"\",\n                caption=\"\",\n                terminated=1,\n                include_leaves=1,\n                strict_leaves=1,\n                width=0,\n                leaves=\"\",\n                relations=\"all\",\n                edgelabels=0,\n                rankdir=\"BT\",\n                legend=1,\n                namespaces=\"\",\n                ontologies=\"\",\n            )\n\n            included_namespaces = (\n                opts.namespaces.split(\",\")\n                if opts.namespaces\n                else ()  # pylint: disable=no-member\n            )\n            included_ontologies = (\n                opts.ontologies.split(\",\")\n                if opts.ontologies\n                else ()  # pylint: disable=no-member\n            )\n\n            filepath, _, width = self._make_branchfig(\n                name,\n                opts.path,  # pylint: disable=no-member\n                opts.terminated,  # pylint: disable=no-member\n                opts.include_leaves,  # pylint: disable=no-member\n                opts.strict_leaves,  # pylint: disable=no-member\n                opts.width,  # pylint: disable=no-member\n                opts.leaves,  # pylint: disable=no-member\n                opts.relations,  # pylint: disable=no-member\n                opts.edgelabels,  # pylint: disable=no-member\n                opts.rankdir,  # pylint: disable=no-member\n                opts.legend,  # pylint: disable=no-member\n                included_namespaces,\n                included_ontologies,\n            )\n\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.get_figure(\n                filepath,\n                caption=opts.caption,\n                width=width,  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_comments","title":"<code>process_comments(self)</code>","text":"<p>Strips out comment lines starting with \"%%\".</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_comments(self):\n    \"\"\"Strips out comment lines starting with \"%%\".\"\"\"\n    self.lines = [line for line in self.lines if not line.startswith(\"%%\")]\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_entities","title":"<code>process_entities(self)</code>","text":"<p>Expand all %ENTITY specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_entities(self):\n    \"\"\"Expand all %ENTITY specifications.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%ENTITY \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(tokens[2:], header_level=3)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.itemdoc(\n                name, int(opts.header_level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_figures","title":"<code>process_figures(self)</code>","text":"<p>Expand all %FIGURE specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_figures(self):\n    \"\"\"Expand all %FIGURE specifications.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%FIGURE \"):\n            tokens = shlex.split(line)\n            path = tokens[1]\n            opts = get_options(tokens[2:], caption=\"\", width=0)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.get_figure(\n                os.path.join(self.basedir, path),\n                caption=opts.caption,  # pylint: disable=no-member\n                width=opts.width,  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_headers","title":"<code>process_headers(self)</code>","text":"<p>Expand all %HEADER specifications.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_headers(self):\n    \"\"\"Expand all %HEADER specifications.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%HEADER \"):\n            tokens = shlex.split(line)\n            name = tokens[1]\n            opts = get_options(tokens[2:], level=1)\n            del self.lines[i]\n            self.lines[i:i] = self.ontodoc.get_header(\n                name, int(opts.level)  # pylint: disable=no-member\n            ).split(\"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.process_includes","title":"<code>process_includes(self)</code>","text":"<p>Process all %INCLUDE directives.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def process_includes(self):\n    \"\"\"Process all %INCLUDE directives.\"\"\"\n    for i, line in reversed(list(enumerate(self.lines))):\n        if line.startswith(\"%INCLUDE \"):\n            tokens = shlex.split(line)\n            filepath = tokens[1]\n            opts = get_options(tokens[2:], shift=0)\n            with open(\n                os.path.join(self.basedir, filepath), \"rt\", encoding=\"utf8\"\n            ) as handle:\n                docpp = DocPP(\n                    handle.read(),\n                    self.ontodoc,\n                    basedir=os.path.dirname(filepath),\n                    figformat=self.figformat,\n                    figscale=self.figscale,\n                    maxwidth=self.maxwidth,\n                )\n                docpp.figdir = self.figdir\n            if opts.shift:  # pylint: disable=no-member\n                docpp.shift_header_levels(\n                    int(opts.shift)\n                )  # pylint: disable=no-member\n            docpp.process()\n            del self.lines[i]\n            self.lines[i:i] = docpp.lines\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.shift_header_levels","title":"<code>shift_header_levels(self, shift)</code>","text":"<p>Shift header level of all hashtag-headers in buffer.  Underline headers are ignored.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def shift_header_levels(self, shift):\n    \"\"\"Shift header level of all hashtag-headers in buffer.  Underline\n    headers are ignored.\"\"\"\n    if not shift:\n        return\n    pat = re.compile(\"^#+ \")\n    for i, line in enumerate(self.lines):\n        match = pat.match(line)\n        if match:\n            if shift &gt; 0:\n                self.lines[i] = \"#\" * shift + line\n            elif shift &lt; 0:\n                counter = match.end()\n                if shift &gt; counter:\n                    self.lines[i] = line.lstrip(\"# \")\n                else:\n                    self.lines[i] = line[counter:]\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.write","title":"<code>write(self, outfile, fmt=None, pandoc_option_files=(), pandoc_options=(), genfile=None, verbose=True)</code>","text":"<p>Writes documentation to <code>outfile</code>.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.DocPP.write--parameters","title":"Parameters","text":"<p>outfile : str     File that the documentation is written to. fmt : str     Output format.  If it is \"md\" or \"simple-html\",     the built-in template generator is used.  Otherwise     pandoc is used.  If not given, the format is inferred     from the <code>outfile</code> name extension. pandoc_option_files : sequence     Sequence with command line arguments provided to pandoc. pandoc_options : sequence     Additional pandoc options overriding options read from <code>pandoc_option_files</code>. genfile : str     Store temporary generated markdown input file to pandoc     to this file (for debugging). verbose : bool     Whether to show some messages when running pandoc.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def write(  # pylint: disable=too-many-arguments\n    self,\n    outfile,\n    fmt=None,\n    pandoc_option_files=(),\n    pandoc_options=(),\n    genfile=None,\n    verbose=True,\n):\n    \"\"\"Writes documentation to `outfile`.\n\n    Parameters\n    ----------\n    outfile : str\n        File that the documentation is written to.\n    fmt : str\n        Output format.  If it is \"md\" or \"simple-html\",\n        the built-in template generator is used.  Otherwise\n        pandoc is used.  If not given, the format is inferred\n        from the `outfile` name extension.\n    pandoc_option_files : sequence\n        Sequence with command line arguments provided to pandoc.\n    pandoc_options : sequence\n        Additional pandoc options overriding options read from\n    `pandoc_option_files`.\n    genfile : str\n        Store temporary generated markdown input file to pandoc\n        to this file (for debugging).\n    verbose : bool\n        Whether to show some messages when running pandoc.\n    \"\"\"\n    self.process()\n    content = self.get_buffer()\n\n    substitutions = self.ontodoc.style.get(\"substitutions\", [])\n    for reg, sub in substitutions:\n        content = re.sub(reg, sub, content)\n\n    fmt = get_format(outfile, default=\"html\", fmt=fmt)\n    if fmt not in (\"simple-html\", \"markdown\", \"md\"):  # Run pandoc\n        if not genfile:\n            with NamedTemporaryFile(mode=\"w+t\", suffix=\".md\") as temp_file:\n                temp_file.write(content)\n                temp_file.flush()\n                genfile = temp_file.name\n\n                run_pandoc(\n                    genfile,\n                    outfile,\n                    fmt,\n                    pandoc_option_files=pandoc_option_files,\n                    pandoc_options=pandoc_options,\n                    verbose=verbose,\n                )\n        else:\n            with open(genfile, \"wt\") as handle:\n                handle.write(content)\n\n            run_pandoc(\n                genfile,\n                outfile,\n                fmt,\n                pandoc_option_files=pandoc_option_files,\n                pandoc_options=pandoc_options,\n                verbose=verbose,\n            )\n    else:\n        if verbose:\n            print(\"Writing:\", outfile)\n        with open(outfile, \"wt\") as handle:\n            handle.write(content)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.InvalidTemplateError","title":"<code> InvalidTemplateError            (NameError)         </code>","text":"<p>Raised on errors in template files.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class InvalidTemplateError(NameError):\n    \"\"\"Raised on errors in template files.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc","title":"<code> OntoDoc        </code>","text":"<p>A class for helping documentating ontologies.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc--parameters","title":"Parameters","text":"<p>onto : Ontology instance     The ontology that should be documented. style : dict | \"html\" | \"markdown\" | \"markdown_tex\"     A dict defining the following template strings (and substitutions):</p> <pre><code>:header: Formats an header.\n    Substitutions: {level}, {label}\n:link: Formats a link.\n   Substitutions: {name}\n:point: Formats a point (list item).\n   Substitutions: {point}, {ontology}\n:points: Formats a list of points.  Used within annotations.\n   Substitutions: {points}, {ontology}\n:annotation: Formats an annotation.\n    Substitutions: {key}, {value}, {ontology}\n:substitutions: list of ``(regex, sub)`` pairs for substituting\n    annotation values.\n</code></pre> Source code in <code>ontopy/ontodoc.py</code> <pre><code>class OntoDoc:\n    \"\"\"A class for helping documentating ontologies.\n\n    Parameters\n    ----------\n    onto : Ontology instance\n        The ontology that should be documented.\n    style : dict | \"html\" | \"markdown\" | \"markdown_tex\"\n        A dict defining the following template strings (and substitutions):\n\n        :header: Formats an header.\n            Substitutions: {level}, {label}\n        :link: Formats a link.\n           Substitutions: {name}\n        :point: Formats a point (list item).\n           Substitutions: {point}, {ontology}\n        :points: Formats a list of points.  Used within annotations.\n           Substitutions: {points}, {ontology}\n        :annotation: Formats an annotation.\n            Substitutions: {key}, {value}, {ontology}\n        :substitutions: list of ``(regex, sub)`` pairs for substituting\n            annotation values.\n    \"\"\"\n\n    _markdown_style = {\n        \"sep\": \"\\n\",\n        \"figwidth\": \"{{ width={width:.0f}px }}\",\n        \"figure\": \"![{caption}]({path}){figwidth}\\n\",\n        \"header\": \"\\n{:#&lt;{level}} {label}    {{#{anchor}}}\",\n        # Use ref instead of iri for local references in links\n        \"link\": \"[{label}]({ref})\",\n        \"point\": \"  - {point}\\n\",\n        \"points\": \"\\n\\n{points}\\n\",\n        \"annotation\": \"**{key}:** {value}\\n\",\n        \"substitutions\": [],\n    }\n    # Extra style settings for markdown+tex (e.g. pdf generation with pandoc)\n    _markdown_tex_extra_style = {\n        \"substitutions\": [\n            # logic/math symbols\n            (\"\\u2200\", r\"$\\\\forall$\"),\n            (\"\\u2203\", r\"$\\\\exists$\"),\n            (\"\\u2206\", r\"$\\\\nabla$\"),\n            (\"\\u2227\", r\"$\\\\land$\"),\n            (\"\\u2228\", r\"$\\\\lor$\"),\n            (\"\\u2207\", r\"$\\\\nabla$\"),\n            (\"\\u2212\", r\"-\"),\n            (\"-&gt;\", r\"$\\\\rightarrow$\"),\n            # uppercase greek letters\n            (\"\\u0391\", r\"$\\\\Upalpha$\"),\n            (\"\\u0392\", r\"$\\\\Upbeta$\"),\n            (\"\\u0393\", r\"$\\\\Upgamma$\"),\n            (\"\\u0394\", r\"$\\\\Updelta$\"),\n            (\"\\u0395\", r\"$\\\\Upepsilon$\"),\n            (\"\\u0396\", r\"$\\\\Upzeta$\"),\n            (\"\\u0397\", r\"$\\\\Upeta$\"),\n            (\"\\u0398\", r\"$\\\\Uptheta$\"),\n            (\"\\u0399\", r\"$\\\\Upiota$\"),\n            (\"\\u039a\", r\"$\\\\Upkappa$\"),\n            (\"\\u039b\", r\"$\\\\Uplambda$\"),\n            (\"\\u039c\", r\"$\\\\Upmu$\"),\n            (\"\\u039d\", r\"$\\\\Upnu$\"),\n            (\"\\u039e\", r\"$\\\\Upxi$\"),\n            (\"\\u039f\", r\"$\\\\Upomekron$\"),\n            (\"\\u03a0\", r\"$\\\\Uppi$\"),\n            (\"\\u03a1\", r\"$\\\\Uprho$\"),\n            (\"\\u03a3\", r\"$\\\\Upsigma$\"),  # no \\u0302\n            (\"\\u03a4\", r\"$\\\\Uptau$\"),\n            (\"\\u03a5\", r\"$\\\\Upupsilon$\"),\n            (\"\\u03a6\", r\"$\\\\Upvarphi$\"),\n            (\"\\u03a7\", r\"$\\\\Upchi$\"),\n            (\"\\u03a8\", r\"$\\\\Uppsi$\"),\n            (\"\\u03a9\", r\"$\\\\Upomega$\"),\n            # lowercase greek letters\n            (\"\\u03b1\", r\"$\\\\upalpha$\"),\n            (\"\\u03b2\", r\"$\\\\upbeta$\"),\n            (\"\\u03b3\", r\"$\\\\upgamma$\"),\n            (\"\\u03b4\", r\"$\\\\updelta$\"),\n            (\"\\u03b5\", r\"$\\\\upepsilon$\"),\n            (\"\\u03b6\", r\"$\\\\upzeta$\"),\n            (\"\\u03b7\", r\"$\\\\upeta$\"),\n            (\"\\u03b8\", r\"$\\\\uptheta$\"),\n            (\"\\u03b9\", r\"$\\\\upiota$\"),\n            (\"\\u03ba\", r\"$\\\\upkappa$\"),\n            (\"\\u03bb\", r\"$\\\\uplambda$\"),\n            (\"\\u03bc\", r\"$\\\\upmu$\"),\n            (\"\\u03bd\", r\"$\\\\upnu$\"),\n            (\"\\u03be\", r\"$\\\\upxi$\"),\n            (\"\\u03bf\", r\"o\"),  # no \\upomicron\n            (\"\\u03c0\", r\"$\\\\uppi$\"),\n            (\"\\u03c1\", r\"$\\\\uprho$\"),\n            (\"\\u03c2\", r\"$\\\\upvarsigma$\"),\n            (\"\\u03c3\", r\"$\\\\upsigma$\"),\n            (\"\\u03c4\", r\"$\\\\uptau$\"),\n            (\"\\u03c5\", r\"$\\\\upupsilon$\"),\n            (\"\\u03c6\", r\"$\\\\upvarphi$\"),\n            (\"\\u03c7\", r\"$\\\\upchi$\"),\n            (\"\\u03c8\", r\"$\\\\uppsi$\"),\n            (\"\\u03c9\", r\"$\\\\upomega$\"),\n            # acutes, accents, etc...\n            (\"\\u03ae\", r\"$\\\\acute{\\\\upeta}$\"),\n            (\"\\u1e17\", r\"$\\\\acute{\\\\bar{\\\\mathrm{e}}}$\"),\n            (\"\\u03ac\", r\"$\\\\acute{\\\\upalpha}$\"),\n            (\"\\u00e1\", r\"$\\\\acute{\\\\mathrm{a}}$\"),\n            (\"\\u03cc\", r\"$\\\\acute{o}$\"),  # no \\upomicron\n            (\"\\u014d\", r\"$\\\\bar{\\\\mathrm{o}}$\"),\n            (\"\\u1f45\", r\"$\\\\acute{o}$\"),  # no \\omicron\n        ],\n    }\n    _html_style = {\n        \"sep\": \"&lt;p&gt;\\n\",\n        \"figwidth\": 'width=\"{width:.0f}\"',\n        \"figure\": '&lt;img src=\"{path}\" alt=\"{caption}\"{figwidth}&gt;',\n        \"header\": '&lt;h{level} id=\"{anchor}\"&gt;{label}&lt;/h{level}&gt;',\n        \"link\": '&lt;a href=\"{ref}\"&gt;{label}&lt;/a&gt;',\n        \"point\": \"      &lt;li&gt;{point}&lt;/li&gt;\\n\",\n        \"points\": \"    &lt;ul&gt;\\n      {points}\\n    &lt;/ul&gt;\\n\",\n        \"annotation\": \"  &lt;dd&gt;&lt;strong&gt;{key}:&lt;/strong&gt;\\n{value}  &lt;/dd&gt;\\n\",\n        \"substitutions\": [\n            (r\"&amp;\", r\"&amp;#8210;\"),\n            (r\"&lt;p&gt;\", r\"&lt;p&gt;\\n\\n\"),\n            (r\"\\u2018([^\\u2019]*)\\u2019\", r\"&lt;q&gt;\\1&lt;/q&gt;\"),\n            (r\"\\u2019\", r\"'\"),\n            (r\"\\u2260\", r\"&amp;ne;\"),\n            (r\"\\u2264\", r\"&amp;le;\"),\n            (r\"\\u2265\", r\"&amp;ge;\"),\n            (r\"\\u226A\", r\"&amp;x226A;\"),\n            (r\"\\u226B\", r\"&amp;x226B;\"),\n            (r'\"Y$', r\"\"),  # strange noice added by owlready2\n        ],\n    }\n\n    def __init__(self, onto, style=\"markdown\"):\n        if isinstance(style, str):\n            if style == \"markdown_tex\":\n                style = self._markdown_style.copy()\n                style.update(self._markdown_tex_extra_style)\n            else:\n                style = getattr(self, f\"_{style}_style\")\n        self.onto = onto\n        self.style = style\n        self.url_regex = re.compile(r\"https?:\\/\\/[^\\s ]+\")\n\n    def get_default_template(self):\n        \"\"\"Returns default template.\"\"\"\n        title = os.path.splitext(\n            os.path.basename(self.onto.base_iri.rstrip(\"/#\"))\n        )[0]\n        irilink = self.style.get(\"link\", \"{name}\").format(\n            iri=self.onto.base_iri,\n            name=self.onto.base_iri,\n            ref=self.onto.base_iri,\n            label=self.onto.base_iri,\n            lowerlabel=self.onto.base_iri,\n        )\n        template = dedent(\n            \"\"\"\\\n        %HEADER {title}\n        Documentation of {irilink}\n\n        %HEADER Relations level=2\n        %ALL object_properties\n\n        %HEADER Classes level=2\n        %ALL classes\n\n        %HEADER Individuals level=2\n        %ALL individuals\n\n        %HEADER Appendix               level=1\n        %HEADER \"Relation taxonomies\"  level=2\n        %ALLFIG object_properties\n\n        %HEADER \"Class taxonomies\"     level=2\n        %ALLFIG classes\n        \"\"\"\n        ).format(ontology=self.onto, title=title, irilink=irilink)\n        return template\n\n    def get_header(self, label, header_level=1, anchor=None):\n        \"\"\"Returns `label` formatted as a header of given level.\"\"\"\n        header_style = self.style.get(\"header\", \"{label}\\n\")\n        return header_style.format(\n            \"\",\n            level=header_level,\n            label=label,\n            anchor=anchor if anchor else label.lower().replace(\" \", \"-\"),\n        )\n\n    def get_figure(self, path, caption=\"\", width=None):\n        \"\"\"Returns a formatted insert-figure-directive.\"\"\"\n        figwidth_style = self.style.get(\"figwidth\", \"\")\n        figure_style = self.style.get(\"figure\", \"\")\n        figwidth = figwidth_style.format(width=width) if width else \"\"\n        return figure_style.format(\n            path=path, caption=caption, figwidth=figwidth\n        )\n\n    def itemdoc(\n        self, item, header_level=3, show_disjoints=False\n    ):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n        \"\"\"Returns documentation of `item`.\n\n        Parameters\n        ----------\n        item : obj | label\n            The class, individual or relation to document.\n        header_level : int\n            Header level. Defaults to 3.\n        show_disjoints : Bool\n            Whether to show `disjoint_with` relations.\n        \"\"\"\n        onto = self.onto\n        if isinstance(item, str):\n            item = self.onto.get_by_label(item)\n\n        header_style = self.style.get(\"header\", \"{label}\\n\")\n        link_style = self.style.get(\"link\", \"{name}\")\n        point_style = self.style.get(\"point\", \"{point}\")\n        points_style = self.style.get(\"points\", \"{points}\")\n        annotation_style = self.style.get(\"annotation\", \"{key}: {value}\\n\")\n        substitutions = self.style.get(\"substitutions\", [])\n\n        # Logical \"sorting\" of annotations\n        order = {\n            \"definition\": \"00\",\n            \"axiom\": \"01\",\n            \"theorem\": \"02\",\n            \"elucidation\": \"03\",\n            \"domain\": \"04\",\n            \"range\": \"05\",\n            \"example\": \"06\",\n        }\n\n        doc = []\n\n        # Header\n        label = get_label(item)\n        iriname = item.iri.partition(\"#\")[2]\n        anchor = iriname if iriname else label.lower()\n        doc.append(\n            header_style.format(\n                \"\",\n                level=header_level,\n                label=label,\n                anchor=anchor,\n            )\n        )\n\n        # Add warning about missing prefLabel\n        if not hasattr(item, \"prefLabel\") or not item.prefLabel.first():\n            doc.append(\n                annotation_style.format(\n                    key=\"Warning\", value=\"Missing prefLabel\"\n                )\n            )\n\n        # Add iri\n        doc.append(\n            annotation_style.format(\n                key=\"IRI\",\n                value=asstring(item.iri, link_style, ontology=onto),\n                ontology=onto,\n            )\n        )\n\n        # Add annotations\n        if isinstance(item, owlready2.Thing):\n            annotations = item.get_individual_annotations()\n        else:\n            annotations = item.get_annotations()\n\n        for key in sorted(\n            annotations.keys(), key=lambda key: order.get(key, key)\n        ):\n            for value in annotations[key]:\n                value = str(value)\n                if self.url_regex.match(value):\n                    doc.append(\n                        annotation_style.format(\n                            key=key,\n                            value=asstring(value, link_style, ontology=onto),\n                        )\n                    )\n                else:\n                    for reg, sub in substitutions:\n                        value = re.sub(reg, sub, value)\n                    doc.append(annotation_style.format(key=key, value=value))\n\n        # ...add relations from is_a\n        points = []\n        non_prop = (\n            owlready2.ThingClass,  # owlready2.Restriction,\n            owlready2.And,\n            owlready2.Or,\n            owlready2.Not,\n        )\n        for prop in item.is_a:\n            if isinstance(prop, non_prop) or (\n                isinstance(item, owlready2.PropertyClass)\n                and isinstance(prop, owlready2.PropertyClass)\n            ):\n                points.append(\n                    point_style.format(\n                        point=\"is_a \"\n                        + asstring(prop, link_style, ontology=onto),\n                        ontology=onto,\n                    )\n                )\n            else:\n                points.append(\n                    point_style.format(\n                        point=asstring(prop, link_style, ontology=onto),\n                        ontology=onto,\n                    )\n                )\n\n        # ...add equivalent_to relations\n        for entity in item.equivalent_to:\n            points.append(\n                point_style.format(\n                    point=\"equivalent_to \"\n                    + asstring(entity, link_style, ontology=onto)\n                )\n            )\n\n        # ...add disjoint_with relations\n        if show_disjoints and hasattr(item, \"disjoint_with\"):\n            subjects = set(item.disjoint_with(reduce=True))\n            points.append(\n                point_style.format(\n                    point=\"disjoint_with \"\n                    + \", \".join(\n                        asstring(s, link_style, ontology=onto) for s in subjects\n                    ),\n                    ontology=onto,\n                )\n            )\n\n        # ...add disjoint_unions\n        if hasattr(item, \"disjoint_unions\"):\n            for unions in item.disjoint_unions:\n                string = \", \".join(\n                    asstring(u, link_style, ontology=onto) for u in unions\n                )\n                points.append(\n                    point_style.format(\n                        point=f\"disjoint_union_of {string}\", ontology=onto\n                    )\n                )\n\n        # ...add inverse_of relations\n        if hasattr(item, \"inverse_property\") and item.inverse_property:\n            points.append(\n                point_style.format(\n                    point=\"inverse_of \"\n                    + asstring(item.inverse_property, link_style, ontology=onto)\n                )\n            )\n\n        # ...add domain restrictions\n        for domain in getattr(item, \"domain\", ()):\n            points.append(\n                point_style.format(\n                    point=\"domain \"\n                    + asstring(domain, link_style, ontology=onto)\n                )\n            )\n\n        # ...add range restrictions\n        for restriction in getattr(item, \"range\", ()):\n            points.append(\n                point_style.format(\n                    point=\"range \"\n                    + asstring(restriction, link_style, ontology=onto)\n                )\n            )\n\n        # Add points (from is_a)\n        if points:\n            value = points_style.format(points=\"\".join(points), ontology=onto)\n            doc.append(\n                annotation_style.format(\n                    key=\"Subclass of\", value=value, ontology=onto\n                )\n            )\n\n        # Instances (individuals)\n        if hasattr(item, \"instances\"):\n            points = []\n\n            for instance in item.instances():\n                if isinstance(instance.is_instance_of, property):\n                    warnings.warn(\n                        f'Ignoring instance \"{instance}\" which is both and '\n                        \"indivudual and class. Ontodoc does not support \"\n                        \"punning at the present moment.\"\n                    )\n                    continue\n                if item in instance.is_instance_of:\n                    points.append(\n                        point_style.format(\n                            point=asstring(instance, link_style, ontology=onto),\n                            ontology=onto,\n                        )\n                    )\n                if points:\n                    value = points_style.format(\n                        points=\"\".join(points), ontology=onto\n                    )\n                    doc.append(\n                        annotation_style.format(\n                            key=\"Individuals\", value=value, ontology=onto\n                        )\n                    )\n\n        return \"\\n\".join(doc)\n\n    def itemsdoc(self, items, header_level=3):\n        \"\"\"Returns documentation of `items`.\"\"\"\n        sep_style = self.style.get(\"sep\", \"\\n\")\n        doc = []\n        for item in items:\n            doc.append(self.itemdoc(item, header_level))\n            doc.append(sep_style.format(ontology=self.onto))\n        return \"\\n\".join(doc)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.get_default_template","title":"<code>get_default_template(self)</code>","text":"<p>Returns default template.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_default_template(self):\n    \"\"\"Returns default template.\"\"\"\n    title = os.path.splitext(\n        os.path.basename(self.onto.base_iri.rstrip(\"/#\"))\n    )[0]\n    irilink = self.style.get(\"link\", \"{name}\").format(\n        iri=self.onto.base_iri,\n        name=self.onto.base_iri,\n        ref=self.onto.base_iri,\n        label=self.onto.base_iri,\n        lowerlabel=self.onto.base_iri,\n    )\n    template = dedent(\n        \"\"\"\\\n    %HEADER {title}\n    Documentation of {irilink}\n\n    %HEADER Relations level=2\n    %ALL object_properties\n\n    %HEADER Classes level=2\n    %ALL classes\n\n    %HEADER Individuals level=2\n    %ALL individuals\n\n    %HEADER Appendix               level=1\n    %HEADER \"Relation taxonomies\"  level=2\n    %ALLFIG object_properties\n\n    %HEADER \"Class taxonomies\"     level=2\n    %ALLFIG classes\n    \"\"\"\n    ).format(ontology=self.onto, title=title, irilink=irilink)\n    return template\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.get_figure","title":"<code>get_figure(self, path, caption='', width=None)</code>","text":"<p>Returns a formatted insert-figure-directive.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_figure(self, path, caption=\"\", width=None):\n    \"\"\"Returns a formatted insert-figure-directive.\"\"\"\n    figwidth_style = self.style.get(\"figwidth\", \"\")\n    figure_style = self.style.get(\"figure\", \"\")\n    figwidth = figwidth_style.format(width=width) if width else \"\"\n    return figure_style.format(\n        path=path, caption=caption, figwidth=figwidth\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.get_header","title":"<code>get_header(self, label, header_level=1, anchor=None)</code>","text":"<p>Returns <code>label</code> formatted as a header of given level.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_header(self, label, header_level=1, anchor=None):\n    \"\"\"Returns `label` formatted as a header of given level.\"\"\"\n    header_style = self.style.get(\"header\", \"{label}\\n\")\n    return header_style.format(\n        \"\",\n        level=header_level,\n        label=label,\n        anchor=anchor if anchor else label.lower().replace(\" \", \"-\"),\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.itemdoc","title":"<code>itemdoc(self, item, header_level=3, show_disjoints=False)</code>","text":"<p>Returns documentation of <code>item</code>.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.itemdoc--parameters","title":"Parameters","text":"<p>item : obj | label     The class, individual or relation to document. header_level : int     Header level. Defaults to 3. show_disjoints : Bool     Whether to show <code>disjoint_with</code> relations.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def itemdoc(\n    self, item, header_level=3, show_disjoints=False\n):  # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    \"\"\"Returns documentation of `item`.\n\n    Parameters\n    ----------\n    item : obj | label\n        The class, individual or relation to document.\n    header_level : int\n        Header level. Defaults to 3.\n    show_disjoints : Bool\n        Whether to show `disjoint_with` relations.\n    \"\"\"\n    onto = self.onto\n    if isinstance(item, str):\n        item = self.onto.get_by_label(item)\n\n    header_style = self.style.get(\"header\", \"{label}\\n\")\n    link_style = self.style.get(\"link\", \"{name}\")\n    point_style = self.style.get(\"point\", \"{point}\")\n    points_style = self.style.get(\"points\", \"{points}\")\n    annotation_style = self.style.get(\"annotation\", \"{key}: {value}\\n\")\n    substitutions = self.style.get(\"substitutions\", [])\n\n    # Logical \"sorting\" of annotations\n    order = {\n        \"definition\": \"00\",\n        \"axiom\": \"01\",\n        \"theorem\": \"02\",\n        \"elucidation\": \"03\",\n        \"domain\": \"04\",\n        \"range\": \"05\",\n        \"example\": \"06\",\n    }\n\n    doc = []\n\n    # Header\n    label = get_label(item)\n    iriname = item.iri.partition(\"#\")[2]\n    anchor = iriname if iriname else label.lower()\n    doc.append(\n        header_style.format(\n            \"\",\n            level=header_level,\n            label=label,\n            anchor=anchor,\n        )\n    )\n\n    # Add warning about missing prefLabel\n    if not hasattr(item, \"prefLabel\") or not item.prefLabel.first():\n        doc.append(\n            annotation_style.format(\n                key=\"Warning\", value=\"Missing prefLabel\"\n            )\n        )\n\n    # Add iri\n    doc.append(\n        annotation_style.format(\n            key=\"IRI\",\n            value=asstring(item.iri, link_style, ontology=onto),\n            ontology=onto,\n        )\n    )\n\n    # Add annotations\n    if isinstance(item, owlready2.Thing):\n        annotations = item.get_individual_annotations()\n    else:\n        annotations = item.get_annotations()\n\n    for key in sorted(\n        annotations.keys(), key=lambda key: order.get(key, key)\n    ):\n        for value in annotations[key]:\n            value = str(value)\n            if self.url_regex.match(value):\n                doc.append(\n                    annotation_style.format(\n                        key=key,\n                        value=asstring(value, link_style, ontology=onto),\n                    )\n                )\n            else:\n                for reg, sub in substitutions:\n                    value = re.sub(reg, sub, value)\n                doc.append(annotation_style.format(key=key, value=value))\n\n    # ...add relations from is_a\n    points = []\n    non_prop = (\n        owlready2.ThingClass,  # owlready2.Restriction,\n        owlready2.And,\n        owlready2.Or,\n        owlready2.Not,\n    )\n    for prop in item.is_a:\n        if isinstance(prop, non_prop) or (\n            isinstance(item, owlready2.PropertyClass)\n            and isinstance(prop, owlready2.PropertyClass)\n        ):\n            points.append(\n                point_style.format(\n                    point=\"is_a \"\n                    + asstring(prop, link_style, ontology=onto),\n                    ontology=onto,\n                )\n            )\n        else:\n            points.append(\n                point_style.format(\n                    point=asstring(prop, link_style, ontology=onto),\n                    ontology=onto,\n                )\n            )\n\n    # ...add equivalent_to relations\n    for entity in item.equivalent_to:\n        points.append(\n            point_style.format(\n                point=\"equivalent_to \"\n                + asstring(entity, link_style, ontology=onto)\n            )\n        )\n\n    # ...add disjoint_with relations\n    if show_disjoints and hasattr(item, \"disjoint_with\"):\n        subjects = set(item.disjoint_with(reduce=True))\n        points.append(\n            point_style.format(\n                point=\"disjoint_with \"\n                + \", \".join(\n                    asstring(s, link_style, ontology=onto) for s in subjects\n                ),\n                ontology=onto,\n            )\n        )\n\n    # ...add disjoint_unions\n    if hasattr(item, \"disjoint_unions\"):\n        for unions in item.disjoint_unions:\n            string = \", \".join(\n                asstring(u, link_style, ontology=onto) for u in unions\n            )\n            points.append(\n                point_style.format(\n                    point=f\"disjoint_union_of {string}\", ontology=onto\n                )\n            )\n\n    # ...add inverse_of relations\n    if hasattr(item, \"inverse_property\") and item.inverse_property:\n        points.append(\n            point_style.format(\n                point=\"inverse_of \"\n                + asstring(item.inverse_property, link_style, ontology=onto)\n            )\n        )\n\n    # ...add domain restrictions\n    for domain in getattr(item, \"domain\", ()):\n        points.append(\n            point_style.format(\n                point=\"domain \"\n                + asstring(domain, link_style, ontology=onto)\n            )\n        )\n\n    # ...add range restrictions\n    for restriction in getattr(item, \"range\", ()):\n        points.append(\n            point_style.format(\n                point=\"range \"\n                + asstring(restriction, link_style, ontology=onto)\n            )\n        )\n\n    # Add points (from is_a)\n    if points:\n        value = points_style.format(points=\"\".join(points), ontology=onto)\n        doc.append(\n            annotation_style.format(\n                key=\"Subclass of\", value=value, ontology=onto\n            )\n        )\n\n    # Instances (individuals)\n    if hasattr(item, \"instances\"):\n        points = []\n\n        for instance in item.instances():\n            if isinstance(instance.is_instance_of, property):\n                warnings.warn(\n                    f'Ignoring instance \"{instance}\" which is both and '\n                    \"indivudual and class. Ontodoc does not support \"\n                    \"punning at the present moment.\"\n                )\n                continue\n            if item in instance.is_instance_of:\n                points.append(\n                    point_style.format(\n                        point=asstring(instance, link_style, ontology=onto),\n                        ontology=onto,\n                    )\n                )\n            if points:\n                value = points_style.format(\n                    points=\"\".join(points), ontology=onto\n                )\n                doc.append(\n                    annotation_style.format(\n                        key=\"Individuals\", value=value, ontology=onto\n                    )\n                )\n\n    return \"\\n\".join(doc)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.OntoDoc.itemsdoc","title":"<code>itemsdoc(self, items, header_level=3)</code>","text":"<p>Returns documentation of <code>items</code>.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def itemsdoc(self, items, header_level=3):\n    \"\"\"Returns documentation of `items`.\"\"\"\n    sep_style = self.style.get(\"sep\", \"\\n\")\n    doc = []\n    for item in items:\n        doc.append(self.itemdoc(item, header_level))\n        doc.append(sep_style.format(ontology=self.onto))\n    return \"\\n\".join(doc)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.append_pandoc_options","title":"<code>append_pandoc_options(options, updates)</code>","text":"<p>Append <code>updates</code> to pandoc options <code>options</code>.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.append_pandoc_options--parameters","title":"Parameters","text":"<p>options : sequence     Sequence with initial Pandoc options. updates : sequence of str     Sequence of strings of the form \"--longoption=value\", where     <code>longoption</code> is a valid pandoc long option and <code>value</code> is the     new value.  The \"=value\" part is optional.</p> <pre><code>Strings of the form \"no-longoption\" will filter out \"--longoption\"\nfrom `options`.\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.append_pandoc_options--returns","title":"Returns","text":"<p>new_options : list     Updated pandoc options.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def append_pandoc_options(options, updates):\n    \"\"\"Append `updates` to pandoc options `options`.\n\n    Parameters\n    ----------\n    options : sequence\n        Sequence with initial Pandoc options.\n    updates : sequence of str\n        Sequence of strings of the form \"--longoption=value\", where\n        ``longoption`` is a valid pandoc long option and ``value`` is the\n        new value.  The \"=value\" part is optional.\n\n        Strings of the form \"no-longoption\" will filter out \"--longoption\"\n        from `options`.\n\n    Returns\n    -------\n    new_options : list\n        Updated pandoc options.\n    \"\"\"\n    # Valid pandoc options starting with \"--no-XXX\"\n    no_options = set(\"no-highlight\")\n\n    if not updates:\n        return list(options)\n\n    curated_updates = {}\n    for update in updates:\n        key, sep, value = update.partition(\"=\")\n        curated_updates[key.lstrip(\"-\")] = value if sep else None\n        filter_out = set(\n            _\n            for _ in curated_updates\n            if _.startswith(\"no-\") and _ not in no_options\n        )\n        _filter_out = set(f\"--{_[3:]}\" for _ in filter_out)\n        new_options = [\n            opt for opt in options if opt.partition(\"=\")[0] not in _filter_out\n        ]\n        new_options.extend(\n            [\n                f\"--{key}\" if value is None else f\"--{key}={value}\"\n                for key, value in curated_updates.items()\n                if key not in filter_out\n            ]\n        )\n    return new_options\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_docpp","title":"<code>get_docpp(ontodoc, infile, figdir='genfigs', figformat='png', maxwidth=None, imported=False)</code>","text":"<p>Read <code>infile</code> and return a new docpp instance.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_docpp(  # pylint: disable=too-many-arguments\n    ontodoc,\n    infile,\n    figdir=\"genfigs\",\n    figformat=\"png\",\n    maxwidth=None,\n    imported=False,\n):\n    \"\"\"Read `infile` and return a new docpp instance.\"\"\"\n    if infile:\n        with open(infile, \"rt\") as handle:\n            template = handle.read()\n        basedir = os.path.dirname(infile)\n    else:\n        template = ontodoc.get_default_template()\n        basedir = \".\"\n\n    docpp = DocPP(\n        template,\n        ontodoc,\n        basedir=basedir,\n        figdir=figdir,\n        figformat=figformat,\n        maxwidth=maxwidth,\n        imported=imported,\n    )\n\n    return docpp\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_figformat","title":"<code>get_figformat(fmt)</code>","text":"<p>Infer preferred figure format from output format.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_figformat(fmt):\n    \"\"\"Infer preferred figure format from output format.\"\"\"\n    if fmt == \"pdf\":\n        figformat = \"pdf\"  # XXX\n    elif \"html\" in fmt:\n        figformat = \"svg\"\n    else:\n        figformat = \"png\"\n    return figformat\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_maxwidth","title":"<code>get_maxwidth(fmt)</code>","text":"<p>Infer preferred max figure width from output format.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_maxwidth(fmt):\n    \"\"\"Infer preferred max figure width from output format.\"\"\"\n    if fmt == \"pdf\":\n        maxwidth = 668\n    else:\n        maxwidth = 1024\n    return maxwidth\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_options","title":"<code>get_options(opts, **kwargs)</code>","text":"<p>Returns a dict with options from the sequence <code>opts</code> with \"name=value\" pairs. Valid option names and default values are provided with the keyword arguments.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_options(opts, **kwargs):\n    \"\"\"Returns a dict with options from the sequence `opts` with\n    \"name=value\" pairs. Valid option names and default values are\n    provided with the keyword arguments.\"\"\"\n    res = AttributeDict(kwargs)\n    for opt in opts:\n        if \"=\" not in opt:\n            raise InvalidTemplateError(\n                f'Missing \"=\" in template option: {opt!r}'\n            )\n        name, value = opt.split(\"=\", 1)\n        if name not in res:\n            raise InvalidTemplateError(f\"Invalid template option: {name!r}\")\n        res_type = type(res[name])\n        res[name] = res_type(value)\n    return res\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.get_style","title":"<code>get_style(fmt)</code>","text":"<p>Infer style from output format.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def get_style(fmt):\n    \"\"\"Infer style from output format.\"\"\"\n    if fmt == \"simple-html\":\n        style = \"html\"\n    elif fmt in (\"tex\", \"latex\", \"pdf\"):\n        style = \"markdown_tex\"\n    else:\n        style = \"markdown\"\n    return style\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.load_pandoc_option_file","title":"<code>load_pandoc_option_file(yamlfile)</code>","text":"<p>Loads pandoc options from <code>yamlfile</code> and return a list with corresponding pandoc command line arguments.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def load_pandoc_option_file(yamlfile):\n    \"\"\"Loads pandoc options from `yamlfile` and return a list with\n    corresponding pandoc command line arguments.\"\"\"\n    with open(yamlfile) as handle:\n        pandoc_options = yaml.safe_load(handle)\n    options = pandoc_options.pop(\"input-files\", [])\n    variables = pandoc_options.pop(\"variables\", {})\n\n    for key, value in pandoc_options.items():\n        if isinstance(value, bool):\n            if value:\n                options.append(f\"--{key}\")\n        else:\n            options.append(f\"--{key}={value}\")\n\n    for key, value in variables.items():\n        if key == \"date\" and value == \"now\":\n            value = time.strftime(\"%B %d, %Y\")\n        options.append(f\"--variable={key}:{value}\")\n\n    return options\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc","title":"<code>run_pandoc(genfile, outfile, fmt, pandoc_option_files=(), pandoc_options=(), verbose=True)</code>","text":"<p>Runs pandoc.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc--parameters","title":"Parameters","text":"<p>genfile : str     Name of markdown input file. outfile : str     Output file name. fmt : str     Output format. pandoc_option_files : sequence     List of files with additional pandoc options.  Default is to read     \"pandoc-options.yaml\" and \"pandoc-FORMAT-options.yml\", where     <code>FORMAT</code> is the output format. pandoc_options : sequence     Additional pandoc options overriding options read from     <code>pandoc_option_files</code>. verbose : bool     Whether to print the pandoc command before execution.</p>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc--raises","title":"Raises","text":"<p>subprocess.CalledProcessError     If the pandoc process returns with non-zero status.  The <code>returncode</code>     attribute will hold the exit code.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def run_pandoc(  # pylint: disable=too-many-arguments\n    genfile,\n    outfile,\n    fmt,\n    pandoc_option_files=(),\n    pandoc_options=(),\n    verbose=True,\n):\n    \"\"\"Runs pandoc.\n\n    Parameters\n    ----------\n    genfile : str\n        Name of markdown input file.\n    outfile : str\n        Output file name.\n    fmt : str\n        Output format.\n    pandoc_option_files : sequence\n        List of files with additional pandoc options.  Default is to read\n        \"pandoc-options.yaml\" and \"pandoc-FORMAT-options.yml\", where\n        `FORMAT` is the output format.\n    pandoc_options : sequence\n        Additional pandoc options overriding options read from\n        `pandoc_option_files`.\n    verbose : bool\n        Whether to print the pandoc command before execution.\n\n    Raises\n    ------\n    subprocess.CalledProcessError\n        If the pandoc process returns with non-zero status.  The `returncode`\n        attribute will hold the exit code.\n    \"\"\"\n    # Create pandoc argument list\n    args = [genfile]\n    files = [\"pandoc-options.yaml\", f\"pandoc-{fmt}-options.yaml\"]\n    if pandoc_option_files:\n        files = pandoc_option_files\n    for fname in files:\n        if os.path.exists(fname):\n            args.extend(load_pandoc_option_file(fname))\n        else:\n            warnings.warn(f\"missing pandoc option file: {fname}\")\n\n    # Update pandoc argument list\n    args = append_pandoc_options(args, pandoc_options)\n\n    # pdf output requires a special attention...\n    if fmt == \"pdf\":\n        pdf_engine = \"pdflatex\"\n        for arg in args:\n            if arg.startswith(\"--pdf-engine\"):\n                pdf_engine = arg.split(\"=\", 1)[1]\n                break\n        with TemporaryDirectory() as tmpdir:\n            run_pandoc_pdf(tmpdir, pdf_engine, outfile, args, verbose=verbose)\n    else:\n        args.append(f\"--output={outfile}\")\n        cmd = [\"pandoc\"] + args\n        if verbose:\n            print()\n            print(\"* Executing command:\")\n            print(\" \".join(shlex.quote(_) for _ in cmd))\n        subprocess.check_call(cmd)  # nosec\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc/#ontopy.ontodoc.run_pandoc_pdf","title":"<code>run_pandoc_pdf(latex_dir, pdf_engine, outfile, args, verbose=True)</code>","text":"<p>Run pandoc for pdf generation.</p> Source code in <code>ontopy/ontodoc.py</code> <pre><code>def run_pandoc_pdf(latex_dir, pdf_engine, outfile, args, verbose=True):\n    \"\"\"Run pandoc for pdf generation.\"\"\"\n    basename = os.path.join(\n        latex_dir, os.path.splitext(os.path.basename(outfile))[0]\n    )\n\n    # Run pandoc\n    texfile = basename + \".tex\"\n    args.append(f\"--output={texfile}\")\n    cmd = [\"pandoc\"] + args\n    if verbose:\n        print()\n        print(\"* Executing commands:\")\n        print(\" \".join(shlex.quote(s) for s in cmd))\n    subprocess.check_call(cmd)  # nosec\n\n    # Fixing tex output\n    texfile2 = basename + \"2.tex\"\n    with open(texfile, \"rt\") as handle:\n        content = handle.read().replace(r\"\\$\\Uptheta\\$\", r\"$\\Uptheta$\")\n    with open(texfile2, \"wt\") as handle:\n        handle.write(content)\n\n    # Run latex\n    pdffile = basename + \"2.pdf\"\n    cmd = [\n        pdf_engine,\n        texfile2,\n        \"-halt-on-error\",\n        f\"-output-directory={latex_dir}\",\n    ]\n    if verbose:\n        print()\n        print(\" \".join(shlex.quote(s) for s in cmd))\n    output = subprocess.check_output(cmd, timeout=60)  # nosec\n    output = subprocess.check_output(cmd, timeout=60)  # nosec\n\n    # Workaround for non-working \"-output-directory\" latex option\n    if not os.path.exists(pdffile):\n        if os.path.exists(os.path.basename(pdffile)):\n            pdffile = os.path.basename(pdffile)\n            for ext in \"aux\", \"out\", \"toc\", \"log\":\n                filename = os.path.splitext(pdffile)[0] + \".\" + ext\n                if os.path.exists(filename):\n                    os.remove(filename)\n        else:\n            print()\n            print(output)\n            print()\n            raise RuntimeError(\"latex did not produce pdf file: \" + pdffile)\n\n    # Copy pdffile\n    if not os.path.exists(outfile) or not os.path.samefile(pdffile, outfile):\n        if verbose:\n            print()\n            print(f\"move {pdffile} to {outfile}\")\n        shutil.move(pdffile, outfile)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/","title":"ontodoc_rst","text":"<p>A module for documenting ontologies.</p>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation","title":"<code> ModuleDocumentation        </code>","text":"<p>Class for documentating a module in an ontology.</p> <p>Parameters:</p> Name Type Description Default <code>ontology</code> <code>Optional[Ontology]</code> <p>Ontology to include in the generated documentation. All entities in this ontology will be included.</p> <code>None</code> <code>entities</code> <code>Optional[Iterable[Entity]]</code> <p>Explicit listing of entities (classes, properties, individuals, datatypes) to document.  Normally not needed.</p> <code>None</code> <code>title</code> <code>Optional[str]</code> <p>Header title.  Be default it is inferred from title of</p> <code>None</code> <code>iri_regex</code> <code>Optional[str]</code> <p>A regular expression that the IRI of documented entities should match.</p> <code>None</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>class ModuleDocumentation:\n    \"\"\"Class for documentating a module in an ontology.\n\n    Arguments:\n        ontology: Ontology to include in the generated documentation.\n            All entities in this ontology will be included.\n        entities: Explicit listing of entities (classes, properties,\n            individuals, datatypes) to document.  Normally not needed.\n        title: Header title.  Be default it is inferred from title of\n        iri_regex: A regular expression that the IRI of documented entities\n            should match.\n    \"\"\"\n\n    def __init__(\n        self,\n        ontology: \"Optional[Ontology]\" = None,\n        entities: \"Optional[Iterable[Entity]]\" = None,\n        title: \"Optional[str]\" = None,\n        iri_regex: \"Optional[str]\" = None,\n    ) -&gt; None:\n        self.ontology = ontology\n        self.title = title\n        self.iri_regex = iri_regex\n        self.graph = (\n            ontology.world.as_rdflib_graph() if ontology else rdflib.Graph()\n        )\n        self.classes = set()\n        self.object_properties = set()\n        self.data_properties = set()\n        self.annotation_properties = set()\n        self.individuals = set()\n        self.datatypes = set()\n\n        if ontology:\n            self.add_ontology(ontology)\n\n        if entities:\n            for entity in entities:\n                self.add_entity(entity)\n\n    def nonempty(self) -&gt; bool:\n        \"\"\"Returns whether the module has any classes, properties, individuals\n        or datatypes.\"\"\"\n        return (\n            self.classes\n            or self.object_properties\n            or self.data_properties\n            or self.annotation_properties\n            or self.individuals\n            or self.datatypes\n        )\n\n    def add_entity(self, entity: \"Entity\") -&gt; None:\n        \"\"\"Add `entity` (class, property, individual, datatype) to list of\n        entities to document.\n        \"\"\"\n        if self.iri_regex and not re.match(self.iri_regex, entity.iri):\n            return\n\n        if isinstance(entity, owlready2.ThingClass):\n            self.classes.add(entity)\n        elif isinstance(entity, owlready2.ObjectPropertyClass):\n            self.object_properties.add(entity)\n        elif isinstance(entity, owlready2.DataPropertyClass):\n            self.object_properties.add(entity)\n        elif isinstance(entity, owlready2.AnnotationPropertyClass):\n            self.object_properties.add(entity)\n        elif isinstance(entity, owlready2.Thing):\n            if (\n                hasattr(entity.__class__, \"iri\")\n                and entity.__class__.iri\n                == \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n            ):\n                self.datatypes.add(entity)\n            else:\n                self.individuals.add(entity)\n\n    def add_ontology(\n        self, ontology: \"Ontology\", imported: bool = False\n    ) -&gt; None:\n        \"\"\"Add ontology to documentation.\"\"\"\n        for entity in ontology.get_entities(imported=imported):\n            self.add_entity(entity)\n\n    def get_title(self) -&gt; str:\n        \"\"\"Return a module title.\"\"\"\n        iri = self.ontology.base_iri.rstrip(\"#/\")\n        if self.title:\n            title = self.title\n        elif self.ontology:\n            title = self.graph.value(URIRef(iri), DCTERMS.title)\n        if not title:\n            title = iri.rsplit(\"/\", 1)[-1]\n        return title\n\n    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        heading = f\"Module: {self.get_title()}\"\n        return f\"\"\"\n\n{heading.title()}\n{'='*len(heading)}\n\n\"\"\"\n\n    def get_refdoc(\n        self,\n        subsections: str = \"all\",\n        header: bool = True,\n    ) -&gt; str:\n        # pylint: disable=too-many-branches,too-many-locals\n        \"\"\"Return reference documentation of all module entities.\n\n        Arguments:\n            subsections: Comma-separated list of subsections to include in\n                the returned documentation.  Valid subsection names are:\n                  - classes\n                  - object_properties\n                  - data_properties\n                  - annotation_properties\n                  - individuals\n                  - datatypes\n                If \"all\", all subsections will be documented.\n            header: Whether to also include the header in the returned\n                documentation.\n\n        Returns:\n            String with reference documentation.\n        \"\"\"\n        # pylint: disable=too-many-nested-blocks\n        if subsections == \"all\":\n            subsections = (\n                \"classes,object_properties,data_properties,\"\n                \"annotation_properties,individuals,datatypes\"\n            )\n\n        maps = {\n            \"classes\": self.classes,\n            \"object_properties\": self.object_properties,\n            \"data_properties\": self.data_properties,\n            \"annotation_properties\": self.annotation_properties,\n            \"individuals\": self.individuals,\n            \"datatypes\": self.datatypes,\n        }\n        lines = []\n\n        if header:\n            lines.append(self.get_header())\n\n        def add_header(name):\n            clsname = f\"element-table-{name.lower().replace(' ', '-')}\"\n            lines.extend(\n                [\n                    \"  &lt;tr&gt;\",\n                    f'    &lt;th class=\"{clsname}\" colspan=\"2\"&gt;{name}&lt;/th&gt;',\n                    \"  &lt;/tr&gt;\",\n                ]\n            )\n\n        def add_keyvalue(key, value, escape=True, htmllink=True):\n            \"\"\"Help function for adding a key-value row to table.\"\"\"\n            if escape:\n                value = html.escape(str(value))\n            if htmllink:\n                value = re.sub(\n                    r\"(https?://[^\\s]+)\", r'&lt;a href=\"\\1\"&gt;\\1&lt;/a&gt;', value\n                )\n            value = value.replace(\"\\n\", \"&lt;br&gt;\")\n            lines.extend(\n                [\n                    \"  &lt;tr&gt;\",\n                    '    &lt;td class=\"element-table-key\"&gt;'\n                    f'&lt;span class=\"element-table-key\"&gt;'\n                    f\"{key.title()}&lt;/span&gt;&lt;/td&gt;\",\n                    f'    &lt;td class=\"element-table-value\"&gt;{value}&lt;/td&gt;',\n                    \"  &lt;/tr&gt;\",\n                ]\n            )\n\n        for subsection in subsections.split(\",\"):\n            if maps[subsection]:\n                moduletitle = self.get_title().lower().replace(\" \", \"-\")\n                anchor = f\"{moduletitle}-{subsection.replace('_', '-')}\"\n                lines.extend(\n                    [\n                        \"\",\n                        f\".. _{anchor}:\",\n                        \"\",\n                        subsection.replace(\"_\", \" \").title(),\n                        \"-\" * len(subsection),\n                        \"\",\n                    ]\n                )\n            for entity in sorted(maps[subsection], key=get_label):\n                label = get_label(entity)\n                lines.extend(\n                    [\n                        \".. raw:: html\",\n                        \"\",\n                        f'   &lt;div id=\"{entity.name}\"&gt;&lt;/div&gt;',\n                        \"\",\n                        f\"{label}\",\n                        \"^\" * len(label),\n                        \"\",\n                        \".. raw:: html\",\n                        \"\",\n                        '  &lt;table class=\"element-table\"&gt;',\n                    ]\n                )\n                add_keyvalue(\"IRI\", entity.iri)\n                if hasattr(entity, \"get_annotations\"):\n                    add_header(\"Annotations\")\n                    for key, value in entity.get_annotations().items():\n                        if isinstance(value, list):\n                            for val in value:\n                                add_keyvalue(key, val)\n                        else:\n                            add_keyvalue(key, value)\n                if entity.is_a or entity.equivalent_to:\n                    add_header(\"Formal description\")\n                    for r in entity.equivalent_to:\n\n                        # FIXME: Skip restrictions with value None to work\n                        # around bug in Owlready2 that doesn't handle custom\n                        # datatypes in restrictions correctly...\n                        if hasattr(r, \"value\") and r.value is None:\n                            continue\n\n                        add_keyvalue(\n                            \"Equivalent To\",\n                            asstring(\n                                r,\n                                link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                                ontology=self.ontology,\n                            ),\n                            escape=False,\n                            htmllink=False,\n                        )\n                    for r in entity.is_a:\n                        add_keyvalue(\n                            \"Subclass Of\",\n                            asstring(\n                                r,\n                                link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                                ontology=self.ontology,\n                            ),\n                            escape=False,\n                            htmllink=False,\n                        )\n\n                lines.extend([\"  &lt;/table&gt;\", \"\"])\n\n        return \"\\n\".join(lines)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.add_entity","title":"<code>add_entity(self, entity)</code>","text":"<p>Add <code>entity</code> (class, property, individual, datatype) to list of entities to document.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def add_entity(self, entity: \"Entity\") -&gt; None:\n    \"\"\"Add `entity` (class, property, individual, datatype) to list of\n    entities to document.\n    \"\"\"\n    if self.iri_regex and not re.match(self.iri_regex, entity.iri):\n        return\n\n    if isinstance(entity, owlready2.ThingClass):\n        self.classes.add(entity)\n    elif isinstance(entity, owlready2.ObjectPropertyClass):\n        self.object_properties.add(entity)\n    elif isinstance(entity, owlready2.DataPropertyClass):\n        self.object_properties.add(entity)\n    elif isinstance(entity, owlready2.AnnotationPropertyClass):\n        self.object_properties.add(entity)\n    elif isinstance(entity, owlready2.Thing):\n        if (\n            hasattr(entity.__class__, \"iri\")\n            and entity.__class__.iri\n            == \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n        ):\n            self.datatypes.add(entity)\n        else:\n            self.individuals.add(entity)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.add_ontology","title":"<code>add_ontology(self, ontology, imported=False)</code>","text":"<p>Add ontology to documentation.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def add_ontology(\n    self, ontology: \"Ontology\", imported: bool = False\n) -&gt; None:\n    \"\"\"Add ontology to documentation.\"\"\"\n    for entity in ontology.get_entities(imported=imported):\n        self.add_entity(entity)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.get_header","title":"<code>get_header(self)</code>","text":"<p>Return a the reStructuredText header as a string.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        heading = f\"Module: {self.get_title()}\"\n        return f\"\"\"\n\n{heading.title()}\n{'='*len(heading)}\n\n\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.get_refdoc","title":"<code>get_refdoc(self, subsections='all', header=True)</code>","text":"<p>Return reference documentation of all module entities.</p> <p>Parameters:</p> Name Type Description Default <code>subsections</code> <code>str</code> <p>Comma-separated list of subsections to include in the returned documentation.  Valid subsection names are:   - classes   - object_properties   - data_properties   - annotation_properties   - individuals   - datatypes If \"all\", all subsections will be documented.</p> <code>'all'</code> <code>header</code> <code>bool</code> <p>Whether to also include the header in the returned documentation.</p> <code>True</code> <p>Returns:</p> Type Description <code>str</code> <p>String with reference documentation.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def get_refdoc(\n    self,\n    subsections: str = \"all\",\n    header: bool = True,\n) -&gt; str:\n    # pylint: disable=too-many-branches,too-many-locals\n    \"\"\"Return reference documentation of all module entities.\n\n    Arguments:\n        subsections: Comma-separated list of subsections to include in\n            the returned documentation.  Valid subsection names are:\n              - classes\n              - object_properties\n              - data_properties\n              - annotation_properties\n              - individuals\n              - datatypes\n            If \"all\", all subsections will be documented.\n        header: Whether to also include the header in the returned\n            documentation.\n\n    Returns:\n        String with reference documentation.\n    \"\"\"\n    # pylint: disable=too-many-nested-blocks\n    if subsections == \"all\":\n        subsections = (\n            \"classes,object_properties,data_properties,\"\n            \"annotation_properties,individuals,datatypes\"\n        )\n\n    maps = {\n        \"classes\": self.classes,\n        \"object_properties\": self.object_properties,\n        \"data_properties\": self.data_properties,\n        \"annotation_properties\": self.annotation_properties,\n        \"individuals\": self.individuals,\n        \"datatypes\": self.datatypes,\n    }\n    lines = []\n\n    if header:\n        lines.append(self.get_header())\n\n    def add_header(name):\n        clsname = f\"element-table-{name.lower().replace(' ', '-')}\"\n        lines.extend(\n            [\n                \"  &lt;tr&gt;\",\n                f'    &lt;th class=\"{clsname}\" colspan=\"2\"&gt;{name}&lt;/th&gt;',\n                \"  &lt;/tr&gt;\",\n            ]\n        )\n\n    def add_keyvalue(key, value, escape=True, htmllink=True):\n        \"\"\"Help function for adding a key-value row to table.\"\"\"\n        if escape:\n            value = html.escape(str(value))\n        if htmllink:\n            value = re.sub(\n                r\"(https?://[^\\s]+)\", r'&lt;a href=\"\\1\"&gt;\\1&lt;/a&gt;', value\n            )\n        value = value.replace(\"\\n\", \"&lt;br&gt;\")\n        lines.extend(\n            [\n                \"  &lt;tr&gt;\",\n                '    &lt;td class=\"element-table-key\"&gt;'\n                f'&lt;span class=\"element-table-key\"&gt;'\n                f\"{key.title()}&lt;/span&gt;&lt;/td&gt;\",\n                f'    &lt;td class=\"element-table-value\"&gt;{value}&lt;/td&gt;',\n                \"  &lt;/tr&gt;\",\n            ]\n        )\n\n    for subsection in subsections.split(\",\"):\n        if maps[subsection]:\n            moduletitle = self.get_title().lower().replace(\" \", \"-\")\n            anchor = f\"{moduletitle}-{subsection.replace('_', '-')}\"\n            lines.extend(\n                [\n                    \"\",\n                    f\".. _{anchor}:\",\n                    \"\",\n                    subsection.replace(\"_\", \" \").title(),\n                    \"-\" * len(subsection),\n                    \"\",\n                ]\n            )\n        for entity in sorted(maps[subsection], key=get_label):\n            label = get_label(entity)\n            lines.extend(\n                [\n                    \".. raw:: html\",\n                    \"\",\n                    f'   &lt;div id=\"{entity.name}\"&gt;&lt;/div&gt;',\n                    \"\",\n                    f\"{label}\",\n                    \"^\" * len(label),\n                    \"\",\n                    \".. raw:: html\",\n                    \"\",\n                    '  &lt;table class=\"element-table\"&gt;',\n                ]\n            )\n            add_keyvalue(\"IRI\", entity.iri)\n            if hasattr(entity, \"get_annotations\"):\n                add_header(\"Annotations\")\n                for key, value in entity.get_annotations().items():\n                    if isinstance(value, list):\n                        for val in value:\n                            add_keyvalue(key, val)\n                    else:\n                        add_keyvalue(key, value)\n            if entity.is_a or entity.equivalent_to:\n                add_header(\"Formal description\")\n                for r in entity.equivalent_to:\n\n                    # FIXME: Skip restrictions with value None to work\n                    # around bug in Owlready2 that doesn't handle custom\n                    # datatypes in restrictions correctly...\n                    if hasattr(r, \"value\") and r.value is None:\n                        continue\n\n                    add_keyvalue(\n                        \"Equivalent To\",\n                        asstring(\n                            r,\n                            link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                            ontology=self.ontology,\n                        ),\n                        escape=False,\n                        htmllink=False,\n                    )\n                for r in entity.is_a:\n                    add_keyvalue(\n                        \"Subclass Of\",\n                        asstring(\n                            r,\n                            link='&lt;a href=\"{iri}\"&gt;{label}&lt;/a&gt;',\n                            ontology=self.ontology,\n                        ),\n                        escape=False,\n                        htmllink=False,\n                    )\n\n            lines.extend([\"  &lt;/table&gt;\", \"\"])\n\n    return \"\\n\".join(lines)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.get_title","title":"<code>get_title(self)</code>","text":"<p>Return a module title.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def get_title(self) -&gt; str:\n    \"\"\"Return a module title.\"\"\"\n    iri = self.ontology.base_iri.rstrip(\"#/\")\n    if self.title:\n        title = self.title\n    elif self.ontology:\n        title = self.graph.value(URIRef(iri), DCTERMS.title)\n    if not title:\n        title = iri.rsplit(\"/\", 1)[-1]\n    return title\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.ModuleDocumentation.nonempty","title":"<code>nonempty(self)</code>","text":"<p>Returns whether the module has any classes, properties, individuals or datatypes.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def nonempty(self) -&gt; bool:\n    \"\"\"Returns whether the module has any classes, properties, individuals\n    or datatypes.\"\"\"\n    return (\n        self.classes\n        or self.object_properties\n        or self.data_properties\n        or self.annotation_properties\n        or self.individuals\n        or self.datatypes\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation","title":"<code> OntologyDocumentation        </code>","text":"<p>Documentation for an ontology with a common namespace.</p> <p>Parameters:</p> Name Type Description Default <code>ontologies</code> <code>Iterable[Ontology]</code> <p>Ontologies to include in the generated documentation. All entities in these ontologies will be included.</p> required <code>imported</code> <code>bool</code> <p>Whether to include imported ontologies.</p> <code>True</code> <code>recursive</code> <code>bool</code> <p>Whether to recursively import all imported ontologies. Implies <code>recursive=True</code>.</p> <code>False</code> <code>iri_regex</code> <code>Optional[str]</code> <p>A regular expression that the IRI of documented entities should match.</p> <code>None</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>class OntologyDocumentation:\n    \"\"\"Documentation for an ontology with a common namespace.\n\n    Arguments:\n        ontologies: Ontologies to include in the generated documentation.\n            All entities in these ontologies will be included.\n        imported: Whether to include imported ontologies.\n        recursive: Whether to recursively import all imported ontologies.\n            Implies `recursive=True`.\n        iri_regex: A regular expression that the IRI of documented entities\n            should match.\n    \"\"\"\n\n    def __init__(\n        self,\n        ontologies: \"Iterable[Ontology]\",\n        imported: bool = True,\n        recursive: bool = False,\n        iri_regex: \"Optional[str]\" = None,\n    ) -&gt; None:\n        if isinstance(ontologies, (Ontology, str, Path)):\n            ontologies = [ontologies]\n\n        if recursive:\n            imported = True\n\n        self.iri_regex = iri_regex\n        self.module_documentations = []\n\n        # Explicitly included ontologies\n        included_ontologies = {}\n        for onto in ontologies:\n            if isinstance(onto, (str, Path)):\n                onto = get_ontology(onto).load()\n            elif not isinstance(onto, Ontology):\n                raise TypeError(\n                    \"expected ontology as an IRI, Path or Ontology object, \"\n                    f\"got: {onto}\"\n                )\n            if onto.base_iri not in included_ontologies:\n                included_ontologies[onto.base_iri] = onto\n\n        # Indirectly included ontologies (imported)\n        if imported:\n            for onto in list(included_ontologies.values()):\n                for o in onto.get_imported_ontologies(recursive=recursive):\n                    if o.base_iri not in included_ontologies:\n                        included_ontologies[o.base_iri] = o\n\n        # Module documentations\n        for onto in included_ontologies.values():\n            self.module_documentations.append(\n                ModuleDocumentation(onto, iri_regex=iri_regex)\n            )\n\n    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        return \"\"\"\n==========\nReferences\n==========\n\"\"\"\n\n    def get_refdoc(self, header: bool = True, subsections: str = \"all\") -&gt; str:\n        \"\"\"Return reference documentation of all module entities.\n\n        Arguments:\n            header: Whether to also include the header in the returned\n                documentation.\n            subsections: Comma-separated list of subsections to include in\n                the returned documentation. See ModuleDocumentation.get_refdoc()\n                for more info.\n\n        Returns:\n            String with reference documentation.\n        \"\"\"\n        moduledocs = []\n        if header:\n            moduledocs.append(self.get_header())\n        moduledocs.extend(\n            md.get_refdoc(subsections=subsections)\n            for md in self.module_documentations\n            if md.nonempty()\n        )\n        return \"\\n\".join(moduledocs)\n\n    def top_ontology(self) -&gt; Ontology:\n        \"\"\"Return the top-level ontology.\"\"\"\n        return self.module_documentations[0].ontology\n\n    def write_refdoc(self, docfile=None, subsections=\"all\"):\n        \"\"\"Write reference documentation to disk.\n\n        Arguments:\n            docfile: Name of file to write to. Defaults to the name of\n                the top ontology with extension `.rst`.\n            subsections: Comma-separated list of subsections to include in\n                the returned documentation. See ModuleDocumentation.get_refdoc()\n                for more info.\n        \"\"\"\n        if not docfile:\n            docfile = self.top_ontology().name + \".rst\"\n        Path(docfile).write_text(\n            self.get_refdoc(subsections=subsections), encoding=\"utf8\"\n        )\n\n    def write_index_template(\n        self, indexfile=\"index.rst\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write a basic template index.rst file to disk.\n\n        Arguments:\n            indexfile: Name of index file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        docname = Path(docfile).stem if docfile else self.top_ontology().name\n        content = f\"\"\"\n.. toctree::\n   :includehidden:\n   :hidden:\n\n   Reference Index &lt;{docname}&gt;\n\n\"\"\"\n        outpath = Path(indexfile)\n        if not overwrite and outpath.exists():\n            warnings.warn(f\"index.rst file already exists: {outpath}\")\n            return\n\n        outpath.write_text(content, encoding=\"utf8\")\n\n    def write_conf_template(\n        self, conffile=\"conf.py\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write basic template sphinx conf.py file to disk.\n\n        Arguments:\n            conffile: Name of configuration file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        # pylint: disable=redefined-builtin\n        md = self.module_documentations[0]\n\n        iri = md.ontology.base_iri.rstrip(\"#/\")\n        authors = sorted(md.graph.objects(URIRef(iri), DCTERMS.creator))\n        license = md.graph.value(URIRef(iri), DCTERMS.license, default=None)\n        release = md.graph.value(URIRef(iri), OWL.versionInfo, default=\"1.0\")\n\n        author = \", \".join(a.value for a in authors) if authors else \"&lt;AUTHOR&gt;\"\n        copyright = license if license else f\"{time.strftime('%Y')}, {author}\"\n\n        content = f\"\"\"\n# Configuration file for the Sphinx documentation builder.\n#\n# For the full list of built-in configuration values, see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Project information -----------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information\n\nproject = '{md.ontology.name}'\ncopyright = '{copyright}'\nauthor = '{author}'\nrelease = '{release}'\n\n# -- General configuration ---------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration\n\nextensions = []\n\ntemplates_path = ['_templates']\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']\n\n\n\n# -- Options for HTML output -------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output\n\nhtml_theme = 'alabaster'\nhtml_static_path = ['_static']\n\"\"\"\n        if not conffile:\n            conffile = Path(docfile).with_name(\"conf.py\")\n        if overwrite and conffile.exists():\n            warnings.warn(f\"conf.py file already exists: {conffile}\")\n            return\n\n        conffile.write_text(content, encoding=\"utf8\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.get_header","title":"<code>get_header(self)</code>","text":"<p>Return a the reStructuredText header as a string.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def get_header(self) -&gt; str:\n        \"\"\"Return a the reStructuredText header as a string.\"\"\"\n        return \"\"\"\n==========\nReferences\n==========\n\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.get_refdoc","title":"<code>get_refdoc(self, header=True, subsections='all')</code>","text":"<p>Return reference documentation of all module entities.</p> <p>Parameters:</p> Name Type Description Default <code>header</code> <code>bool</code> <p>Whether to also include the header in the returned documentation.</p> <code>True</code> <code>subsections</code> <code>str</code> <p>Comma-separated list of subsections to include in the returned documentation. See ModuleDocumentation.get_refdoc() for more info.</p> <code>'all'</code> <p>Returns:</p> Type Description <code>str</code> <p>String with reference documentation.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def get_refdoc(self, header: bool = True, subsections: str = \"all\") -&gt; str:\n    \"\"\"Return reference documentation of all module entities.\n\n    Arguments:\n        header: Whether to also include the header in the returned\n            documentation.\n        subsections: Comma-separated list of subsections to include in\n            the returned documentation. See ModuleDocumentation.get_refdoc()\n            for more info.\n\n    Returns:\n        String with reference documentation.\n    \"\"\"\n    moduledocs = []\n    if header:\n        moduledocs.append(self.get_header())\n    moduledocs.extend(\n        md.get_refdoc(subsections=subsections)\n        for md in self.module_documentations\n        if md.nonempty()\n    )\n    return \"\\n\".join(moduledocs)\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.top_ontology","title":"<code>top_ontology(self)</code>","text":"<p>Return the top-level ontology.</p> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def top_ontology(self) -&gt; Ontology:\n    \"\"\"Return the top-level ontology.\"\"\"\n    return self.module_documentations[0].ontology\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.write_conf_template","title":"<code>write_conf_template(self, conffile='conf.py', docfile=None, overwrite=False)</code>","text":"<p>Write basic template sphinx conf.py file to disk.</p> <p>Parameters:</p> Name Type Description Default <code>conffile</code> <p>Name of configuration file to write.</p> <code>'conf.py'</code> <code>docfile</code> <p>Name of generated documentation file.  If not given, the name of the top ontology will be used.</p> <code>None</code> <code>overwrite</code> <p>Whether to overwrite an existing file.</p> <code>False</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def write_conf_template(\n        self, conffile=\"conf.py\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write basic template sphinx conf.py file to disk.\n\n        Arguments:\n            conffile: Name of configuration file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        # pylint: disable=redefined-builtin\n        md = self.module_documentations[0]\n\n        iri = md.ontology.base_iri.rstrip(\"#/\")\n        authors = sorted(md.graph.objects(URIRef(iri), DCTERMS.creator))\n        license = md.graph.value(URIRef(iri), DCTERMS.license, default=None)\n        release = md.graph.value(URIRef(iri), OWL.versionInfo, default=\"1.0\")\n\n        author = \", \".join(a.value for a in authors) if authors else \"&lt;AUTHOR&gt;\"\n        copyright = license if license else f\"{time.strftime('%Y')}, {author}\"\n\n        content = f\"\"\"\n# Configuration file for the Sphinx documentation builder.\n#\n# For the full list of built-in configuration values, see the documentation:\n# https://www.sphinx-doc.org/en/master/usage/configuration.html\n\n# -- Project information -----------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information\n\nproject = '{md.ontology.name}'\ncopyright = '{copyright}'\nauthor = '{author}'\nrelease = '{release}'\n\n# -- General configuration ---------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration\n\nextensions = []\n\ntemplates_path = ['_templates']\nexclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']\n\n\n\n# -- Options for HTML output -------------------------------------------------\n# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output\n\nhtml_theme = 'alabaster'\nhtml_static_path = ['_static']\n\"\"\"\n        if not conffile:\n            conffile = Path(docfile).with_name(\"conf.py\")\n        if overwrite and conffile.exists():\n            warnings.warn(f\"conf.py file already exists: {conffile}\")\n            return\n\n        conffile.write_text(content, encoding=\"utf8\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.write_index_template","title":"<code>write_index_template(self, indexfile='index.rst', docfile=None, overwrite=False)</code>","text":"<p>Write a basic template index.rst file to disk.</p> <p>Parameters:</p> Name Type Description Default <code>indexfile</code> <p>Name of index file to write.</p> <code>'index.rst'</code> <code>docfile</code> <p>Name of generated documentation file.  If not given, the name of the top ontology will be used.</p> <code>None</code> <code>overwrite</code> <p>Whether to overwrite an existing file.</p> <code>False</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>    def write_index_template(\n        self, indexfile=\"index.rst\", docfile=None, overwrite=False\n    ):\n        \"\"\"Write a basic template index.rst file to disk.\n\n        Arguments:\n            indexfile: Name of index file to write.\n            docfile: Name of generated documentation file.  If not given,\n                the name of the top ontology will be used.\n            overwrite: Whether to overwrite an existing file.\n        \"\"\"\n        docname = Path(docfile).stem if docfile else self.top_ontology().name\n        content = f\"\"\"\n.. toctree::\n   :includehidden:\n   :hidden:\n\n   Reference Index &lt;{docname}&gt;\n\n\"\"\"\n        outpath = Path(indexfile)\n        if not overwrite and outpath.exists():\n            warnings.warn(f\"index.rst file already exists: {outpath}\")\n            return\n\n        outpath.write_text(content, encoding=\"utf8\")\n</code></pre>"},{"location":"api_reference/ontopy/ontodoc_rst/#ontopy.ontodoc_rst.OntologyDocumentation.write_refdoc","title":"<code>write_refdoc(self, docfile=None, subsections='all')</code>","text":"<p>Write reference documentation to disk.</p> <p>Parameters:</p> Name Type Description Default <code>docfile</code> <p>Name of file to write to. Defaults to the name of the top ontology with extension <code>.rst</code>.</p> <code>None</code> <code>subsections</code> <p>Comma-separated list of subsections to include in the returned documentation. See ModuleDocumentation.get_refdoc() for more info.</p> <code>'all'</code> Source code in <code>ontopy/ontodoc_rst.py</code> <pre><code>def write_refdoc(self, docfile=None, subsections=\"all\"):\n    \"\"\"Write reference documentation to disk.\n\n    Arguments:\n        docfile: Name of file to write to. Defaults to the name of\n            the top ontology with extension `.rst`.\n        subsections: Comma-separated list of subsections to include in\n            the returned documentation. See ModuleDocumentation.get_refdoc()\n            for more info.\n    \"\"\"\n    if not docfile:\n        docfile = self.top_ontology().name + \".rst\"\n    Path(docfile).write_text(\n        self.get_refdoc(subsections=subsections), encoding=\"utf8\"\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/","title":"ontology","text":"<p>A module adding additional functionality to owlready2.</p> <p>If desirable some of these additions may be moved back into owlready2.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.BlankNode","title":"<code> BlankNode        </code>","text":"<p>Represents a blank node.</p> <p>A blank node is a node that is not a literal and has no IRI. Resources represented by blank nodes are also called anonumous resources. Only the subject or object in an RDF triple can be a blank node.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>class BlankNode:\n    \"\"\"Represents a blank node.\n\n    A blank node is a node that is not a literal and has no IRI.\n    Resources represented by blank nodes are also called anonumous resources.\n    Only the subject or object in an RDF triple can be a blank node.\n    \"\"\"\n\n    def __init__(self, onto: Union[World, Ontology], storid: int):\n        \"\"\"Initiate a blank node.\n\n        Args:\n            onto: Ontology or World instance.\n            storid: The storage id of the blank node.\n        \"\"\"\n        if storid &gt;= 0:\n            raise ValueError(\n                f\"A BlankNode is supposed to have a negative storid: {storid}\"\n            )\n        self.onto = onto\n        self.storid = storid\n\n    def __repr__(self):\n        return repr(f\"_:b{-self.storid}\")\n\n    def __hash__(self):\n        return hash((self.onto, self.storid))\n\n    def __eq__(self, other):\n        \"\"\"For now blank nodes always compare true against each other.\"\"\"\n        return isinstance(other, BlankNode)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.BlankNode.__init__","title":"<code>__init__(self, onto, storid)</code>  <code>special</code>","text":"<p>Initiate a blank node.</p> <p>Parameters:</p> Name Type Description Default <code>onto</code> <code>Union[ontopy.ontology.World, ontopy.ontology.Ontology]</code> <p>Ontology or World instance.</p> required <code>storid</code> <code>int</code> <p>The storage id of the blank node.</p> required Source code in <code>ontopy/ontology.py</code> <pre><code>def __init__(self, onto: Union[World, Ontology], storid: int):\n    \"\"\"Initiate a blank node.\n\n    Args:\n        onto: Ontology or World instance.\n        storid: The storage id of the blank node.\n    \"\"\"\n    if storid &gt;= 0:\n        raise ValueError(\n            f\"A BlankNode is supposed to have a negative storid: {storid}\"\n        )\n    self.onto = onto\n    self.storid = storid\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology","title":"<code> Ontology            (Ontology)         </code>","text":"<p>A generic class extending owlready2.Ontology.</p> <p>Additional attributes:     !!! iri \"IRI of this ontology.  Currently only used for serialisation\"         with rdflib. Defaults to None, meaning <code>base_iri</code> will be used         instead.     !!! label_annotations \"List of label annotations, i.e. annotations\"         that are recognised by the get_by_label() method. Defaults         to <code>[skos:prefLabel, rdf:label, skos:altLabel]</code>.     prefix: Prefix for this ontology. Defaults to None.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>class Ontology(owlready2.Ontology):  # pylint: disable=too-many-public-methods\n    \"\"\"A generic class extending owlready2.Ontology.\n\n    Additional attributes:\n        iri: IRI of this ontology.  Currently only used for serialisation\n            with rdflib. Defaults to None, meaning `base_iri` will be used\n            instead.\n        label_annotations: List of label annotations, i.e. annotations\n            that are recognised by the get_by_label() method. Defaults\n            to `[skos:prefLabel, rdf:label, skos:altLabel]`.\n        prefix: Prefix for this ontology. Defaults to None.\n    \"\"\"\n\n    def __init__(self, *args, **kwargs):\n        super().__init__(*args, **kwargs)\n        self.iri = None\n        self.label_annotations = DEFAULT_LABEL_ANNOTATIONS[:]\n        self.prefix = None\n\n    # Name of special unlabeled entities, like Thing, Nothing, etc...\n    _special_labels = None\n\n    # Some properties for customising dir() listing - useful in\n    # interactive sessions...\n    _dir_preflabel = isinteractive()\n    _dir_label = isinteractive()\n    _dir_name = False\n    _dir_imported = isinteractive()\n    dir_preflabel = property(\n        fget=lambda self: self._dir_preflabel,\n        fset=lambda self, v: setattr(self, \"_dir_preflabel\", bool(v)),\n        doc=\"Whether to include entity prefLabel in dir() listing.\",\n    )\n    dir_label = property(\n        fget=lambda self: self._dir_label,\n        fset=lambda self, v: setattr(self, \"_dir_label\", bool(v)),\n        doc=\"Whether to include entity label in dir() listing.\",\n    )\n    dir_name = property(\n        fget=lambda self: self._dir_name,\n        fset=lambda self, v: setattr(self, \"_dir_name\", bool(v)),\n        doc=\"Whether to include entity name in dir() listing.\",\n    )\n    dir_imported = property(\n        fget=lambda self: self._dir_imported,\n        fset=lambda self, v: setattr(self, \"_dir_imported\", bool(v)),\n        doc=\"Whether to include imported ontologies in dir() listing.\",\n    )\n\n    # Other settings\n    _colon_in_label = False\n    colon_in_label = property(\n        fget=lambda self: self._colon_in_label,\n        fset=lambda self, v: setattr(self, \"_colon_in_label\", bool(v)),\n        doc=\"Whether to accept colon in name-part of IRI.  \"\n        \"If true, the name cannot be prefixed.\",\n    )\n\n    def __dir__(self):\n        dirset = set(super().__dir__())\n        lst = list(self.get_entities(imported=self._dir_imported))\n        if self._dir_preflabel:\n            dirset.update(\n                str(dir.prefLabel.first())\n                for dir in lst\n                if hasattr(dir, \"prefLabel\")\n            )\n        if self._dir_label:\n            dirset.update(\n                str(dir.label.first()) for dir in lst if hasattr(dir, \"label\")\n            )\n        if self._dir_name:\n            dirset.update(dir.name for dir in lst if hasattr(dir, \"name\"))\n        dirset.difference_update({None})  # get rid of possible None\n        return sorted(dirset)\n\n    def __getitem__(self, name):\n        item = super().__getitem__(name)\n        if not item:\n            item = self.get_by_label(name)\n        return item\n\n    def __getattr__(self, name):\n        attr = super().__getattr__(name)\n        if not attr:\n            attr = self.get_by_label(name)\n        return attr\n\n    def __contains__(self, other):\n        if self.world[other]:\n            return True\n        try:\n            self.get_by_label(other)\n        except NoSuchLabelError:\n            return False\n        return True\n\n    def __objclass__(self):\n        # Play nice with inspect...\n        pass\n\n    def __hash__(self):\n        \"\"\"Returns a hash based on base_iri.\n        This is done to keep Ontology hashable when defining __eq__.\n        \"\"\"\n        return hash(self.base_iri)\n\n    def __eq__(self, other):\n        \"\"\"Checks if this ontology is equal to `other`.\n\n        This function compares the result of\n        ``set(self.get_unabbreviated_triples(label='_:b'))``,\n        i.e. blank nodes are not distinguished, but relations to blank\n        nodes are included.\n        \"\"\"\n        return set(self.get_unabbreviated_triples(blank=\"_:b\")) == set(\n            other.get_unabbreviated_triples(blank=\"_:b\")\n        )\n\n    def get_unabbreviated_triples(\n        self, subject=None, predicate=None, obj=None, blank=None\n    ):\n        \"\"\"Returns all matching triples unabbreviated.\n\n        If `blank` is given, it will be used to represent blank nodes.\n        \"\"\"\n        # pylint: disable=invalid-name\n        return _get_unabbreviated_triples(\n            self, subject=subject, predicate=predicate, obj=obj, blank=blank\n        )\n\n    def set_default_label_annotations(self):\n        \"\"\"Sets the default label annotations.\"\"\"\n        warnings.warn(\n            \"Ontology.set_default_label_annotations() is deprecated. \"\n            \"Default label annotations are set by Ontology.__init__(). \",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        self.label_annotations = DEFAULT_LABEL_ANNOTATIONS[:]\n\n    def get_by_label(\n        self,\n        label: str,\n        label_annotations: str = None,\n        prefix: str = None,\n        imported: bool = True,\n        colon_in_label: bool = None,\n    ):\n        \"\"\"Returns entity with label annotation `label`.\n\n        Arguments:\n           label: label so search for.\n               May be written as 'label' or 'prefix:label'.\n               get_by_label('prefix:label') ==\n               get_by_label('label', prefix='prefix').\n           label_annotations: a sequence of label annotation names to look up.\n               Defaults to the `label_annotations` property.\n           prefix: if provided, it should be the last component of\n               the base iri of an ontology (with trailing slash (/) or hash\n               (#) stripped off).  The search for a matching label will be\n               limited to this namespace.\n           imported: Whether to also look for `label` in imported ontologies.\n           colon_in_label: Whether to accept colon (:) in a label or name-part\n               of IRI.  Defaults to the `colon_in_label` property of `self`.\n               Setting this true cannot be combined with `prefix`.\n\n        If several entities have the same label, only the one which is\n        found first is returned.Use get_by_label_all() to get all matches.\n\n        Note, if different prefixes are provided in the label and via\n        the `prefix` argument a warning will be issued and the\n        `prefix` argument will take precedence.\n\n        A NoSuchLabelError is raised if `label` cannot be found.\n        \"\"\"\n        # pylint: disable=too-many-arguments,too-many-branches,invalid-name\n        if not isinstance(label, str):\n            raise TypeError(\n                f\"Invalid label definition, must be a string: '{label}'\"\n            )\n\n        if label_annotations is None:\n            label_annotations = self.label_annotations\n\n        if colon_in_label is None:\n            colon_in_label = self._colon_in_label\n        if colon_in_label:\n            if prefix:\n                raise ValueError(\n                    \"`prefix` cannot be combined with `colon_in_label`\"\n                )\n        else:\n            splitlabel = label.split(\":\", 1)\n            if len(splitlabel) == 2 and not splitlabel[1].startswith(\"//\"):\n                label = splitlabel[1]\n                if prefix and prefix != splitlabel[0]:\n                    warnings.warn(\n                        f\"Prefix given both as argument ({prefix}) \"\n                        f\"and in label ({splitlabel[0]}). \"\n                        \"Prefix given in argument takes precedence. \"\n                    )\n                if not prefix:\n                    prefix = splitlabel[0]\n\n        if prefix:\n            entityset = self.get_by_label_all(\n                label,\n                label_annotations=label_annotations,\n                prefix=prefix,\n            )\n            if len(entityset) == 1:\n                return entityset.pop()\n            if len(entityset) &gt; 1:\n                raise AmbiguousLabelError(\n                    f\"Several entities have the same label '{label}' \"\n                    f\"with prefix '{prefix}'.\"\n                )\n            raise NoSuchLabelError(\n                f\"No label annotations matches for '{label}' \"\n                f\"with prefix '{prefix}'.\"\n            )\n\n        # Label is a full IRI\n        entity = self.world[label]\n        if entity:\n            return entity\n\n        get_triples = (\n            self.world._get_data_triples_spod_spod\n            if imported\n            else self._get_data_triples_spod_spod\n        )\n\n        for storid in self._to_storids(label_annotations):\n            for s, _, _, _ in get_triples(None, storid, label, None):\n                return self.world[self._unabbreviate(s)]\n\n        # Special labels\n        if self._special_labels and label in self._special_labels:\n            return self._special_labels[label]\n\n        # Check if label is a name under base_iri\n        entity = self.world[self.base_iri + label]\n        if entity:\n            return entity\n\n        # Check label is the name of an entity\n        for entity in self.get_entities(imported=imported):\n            if label == entity.name:\n                return entity\n\n        raise NoSuchLabelError(f\"No label annotations matches '{label}'\")\n\n    def get_by_label_all(\n        self,\n        label,\n        label_annotations=None,\n        prefix=None,\n        exact_match=False,\n    ) -&gt; \"Set[Optional[owlready2.entity.EntityClass]]\":\n        \"\"\"Returns set of entities with label annotation `label`.\n\n        Arguments:\n           label: label so search for.\n               May be written as 'label' or 'prefix:label'.  Wildcard matching\n               using glob pattern is also supported if `exact_match` is set to\n               false.\n           label_annotations: a sequence of label annotation names to look up.\n               Defaults to the `label_annotations` property.\n           prefix: if provided, it should be the last component of\n               the base iri of an ontology (with trailing slash (/) or hash\n               (#) stripped off).  The search for a matching label will be\n               limited to this namespace.\n           exact_match: Do not treat \"*\" and brackets as special characters\n               when matching.  May be useful if your ontology has labels\n               containing such labels.\n\n        Returns:\n            Set of all matching entities or an empty set if no matches\n            could be found.\n        \"\"\"\n        if not isinstance(label, str):\n            raise TypeError(\n                f\"Invalid label definition, \" f\"must be a string: {label!r}\"\n            )\n        if \" \" in label:\n            raise ValueError(\n                f\"Invalid label definition, {label!r} contains spaces.\"\n            )\n\n        if label_annotations is None:\n            label_annotations = self.label_annotations\n\n        entities = set()\n\n        # Check label annotations\n        if exact_match:\n            for storid in self._to_storids(label_annotations):\n                entities.update(\n                    self.world._get_by_storid(s)\n                    for s, _, _ in self.world._get_data_triples_spod_spod(\n                        None, storid, str(label), None\n                    )\n                )\n        else:\n            for storid in self._to_storids(label_annotations):\n                label_entity = self._unabbreviate(storid)\n                key = (\n                    label_entity.name\n                    if hasattr(label_entity, \"name\")\n                    else label_entity\n                )\n                entities.update(self.world.search(**{key: label}))\n\n        if self._special_labels and label in self._special_labels:\n            entities.update(self._special_labels[label])\n\n        # Check name-part of IRI\n        if exact_match:\n            entities.update(\n                ent for ent in self.get_entities() if ent.name == str(label)\n            )\n        else:\n            matches = fnmatch.filter(\n                (ent.name for ent in self.get_entities()), label\n            )\n            entities.update(\n                ent for ent in self.get_entities() if ent.name in matches\n            )\n\n        if prefix:\n            return set(\n                ent\n                for ent in entities\n                if ent.namespace.ontology.prefix == prefix\n            )\n        return entities\n\n    def _to_storids(self, sequence, create_if_missing=False):\n        \"\"\"Return a list of storid's corresponding to the elements in the\n        sequence `sequence`.\n\n        The elements may be either be full IRIs (strings) or Owlready2\n        entities with an associated storid.\n\n        If `create_if_missing` is true, new Owlready2 entities will be\n        created for IRIs that not already are associated with an\n        entity.  Otherwise such IRIs will be skipped in the returned\n        list.\n        \"\"\"\n        if not sequence:\n            return []\n        storids = []\n        for element in sequence:\n            if hasattr(element, \"storid\"):\n                storids.append(element.storid)\n            else:\n                storid = self.world._abbreviate(element, create_if_missing)\n                if storid:\n                    storids.append(storid)\n        return storids\n\n    def add_label_annotation(self, iri):\n        \"\"\"Adds label annotation used by get_by_label().\"\"\"\n        warnings.warn(\n            \"Ontology.add_label_annotations() is deprecated. \"\n            \"Direct modify the `label_annotations` attribute instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        if hasattr(iri, \"iri\"):\n            iri = iri.iri\n        if iri not in self.label_annotations:\n            self.label_annotations.append(iri)\n\n    def remove_label_annotation(self, iri):\n        \"\"\"Removes label annotation used by get_by_label().\"\"\"\n        warnings.warn(\n            \"Ontology.remove_label_annotations() is deprecated. \"\n            \"Direct modify the `label_annotations` attribute instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        if hasattr(iri, \"iri\"):\n            iri = iri.iri\n        try:\n            self.label_annotations.remove(iri)\n        except ValueError:\n            pass\n\n    def set_common_prefix(\n        self,\n        iri_base: str = \"http://emmo.info/emmo\",\n        prefix: str = \"emmo\",\n        visited: \"Optional[Set]\" = None,\n    ) -&gt; None:\n        \"\"\"Set a common prefix for all imported ontologies\n        with the same first part of the base_iri.\n\n        Args:\n            iri_base: The start of the base_iri to look for. Defaults to\n                the emmo base_iri http://emmo.info/emmo\n            prefix: the desired prefix. Defaults to emmo.\n            visited: Ontologies to skip. Only intended for internal use.\n        \"\"\"\n        if visited is None:\n            visited = set()\n        if self.base_iri.startswith(iri_base):\n            self.prefix = prefix\n        for onto in self.imported_ontologies:\n            if not onto in visited:\n                visited.add(onto)\n                onto.set_common_prefix(\n                    iri_base=iri_base, prefix=prefix, visited=visited\n                )\n\n    def load(  # pylint: disable=too-many-arguments,arguments-renamed\n        self,\n        only_local=False,\n        filename=None,\n        format=None,  # pylint: disable=redefined-builtin\n        reload=None,\n        reload_if_newer=False,\n        url_from_catalog=None,\n        catalog_file=\"catalog-v001.xml\",\n        emmo_based=True,\n        prefix=None,\n        prefix_emmo=None,\n        **kwargs,\n    ):\n        \"\"\"Load the ontology.\n\n        Arguments\n        ---------\n        only_local: bool\n            Whether to only read local files.  This requires that you\n            have appended the path to the ontology to owlready2.onto_path.\n        filename: str\n            Path to file to load the ontology from.  Defaults to `base_iri`\n            provided to get_ontology().\n        format: str\n            Format of `filename`.  Default is inferred from `filename`\n            extension.\n        reload: bool\n            Whether to reload the ontology if it is already loaded.\n        reload_if_newer: bool\n            Whether to reload the ontology if the source has changed since\n            last time it was loaded.\n        url_from_catalog: bool | None\n            Whether to use catalog file to resolve the location of `base_iri`.\n            If None, the catalog file is used if it exists in the same\n            directory as `filename`.\n        catalog_file: str\n            Name of Prot\u00e8g\u00e8 catalog file in the same folder as the\n            ontology.  This option is used together with `only_local` and\n            defaults to \"catalog-v001.xml\".\n        emmo_based: bool\n            Whether this is an EMMO-based ontology or not, default `True`.\n        prefix: defaults to self.get_namespace.name if\n        prefix_emmo: bool, default None. If emmo_based is True it\n            defaults to True and sets the prefix of all imported ontologies\n            with base_iri starting with 'http://emmo.info/emmo' to emmo\n        kwargs:\n            Additional keyword arguments are passed on to\n            owlready2.Ontology.load().\n        \"\"\"\n        # TODO: make sure that `only_local` argument is respected...\n\n        if self.loaded:\n            return self\n        self._load(\n            only_local=only_local,\n            filename=filename,\n            format=format,\n            reload=reload,\n            reload_if_newer=reload_if_newer,\n            url_from_catalog=url_from_catalog,\n            catalog_file=catalog_file,\n            **kwargs,\n        )\n\n        # Enable optimised search by get_by_label()\n        if self._special_labels is None and emmo_based:\n            top = self.world[\"http://www.w3.org/2002/07/owl#topObjectProperty\"]\n            self._special_labels = {\n                \"Thing\": owlready2.Thing,\n                \"Nothing\": owlready2.Nothing,\n                \"topObjectProperty\": top,\n                \"owl:Thing\": owlready2.Thing,\n                \"owl:Nothing\": owlready2.Nothing,\n                \"owl:topObjectProperty\": top,\n            }\n        # set prefix if another prefix is desired\n        # if we do this, shouldn't we make the name of all\n        # entities of the given ontology to the same?\n        if prefix:\n            self.prefix = prefix\n        else:\n            self.prefix = self.name\n\n        if emmo_based and prefix_emmo is None:\n            prefix_emmo = True\n        if prefix_emmo:\n            self.set_common_prefix()\n\n        return self\n\n    def _load(  # pylint: disable=too-many-arguments,too-many-locals,too-many-branches,too-many-statements\n        self,\n        only_local=False,\n        filename=None,\n        format=None,  # pylint: disable=redefined-builtin\n        reload=None,\n        reload_if_newer=False,\n        url_from_catalog=None,\n        catalog_file=\"catalog-v001.xml\",\n        **kwargs,\n    ):\n        \"\"\"Help function for load().\"\"\"\n        web_protocol = \"http://\", \"https://\", \"ftp://\"\n        url = str(filename) if filename else self.base_iri.rstrip(\"/#\")\n        if url.startswith(web_protocol):\n            baseurl = os.path.dirname(url)\n            catalogurl = baseurl + \"/\" + catalog_file\n        else:\n            if url.startswith(\"file://\"):\n                url = url[7:]\n            url = os.path.normpath(os.path.abspath(url))\n            baseurl = os.path.dirname(url)\n            catalogurl = os.path.join(baseurl, catalog_file)\n\n        def getmtime(path):\n            if os.path.exists(path):\n                return os.path.getmtime(path)\n            return 0.0\n\n        # Resolve url from catalog file\n        iris = {}\n        dirs = set()\n        if url_from_catalog or url_from_catalog is None:\n            not_reload = not reload and (\n                not reload_if_newer\n                or getmtime(catalogurl)\n                &gt; self.world._cached_catalogs[catalogurl][0]\n            )\n            # get iris from catalog already in cached catalogs\n            if catalogurl in self.world._cached_catalogs and not_reload:\n                _, iris, dirs = self.world._cached_catalogs[catalogurl]\n            # do not update cached_catalogs if url already in _iri_mappings\n            # and reload not forced\n            elif url in self.world._iri_mappings and not_reload:\n                pass\n            # update iris from current catalogurl\n            else:\n                try:\n                    iris, dirs = read_catalog(\n                        uri=catalogurl,\n                        recursive=False,\n                        return_paths=True,\n                        catalog_file=catalog_file,\n                    )\n                except ReadCatalogError:\n                    if url_from_catalog is not None:\n                        raise\n                    self.world._cached_catalogs[catalogurl] = (0.0, {}, set())\n                else:\n                    self.world._cached_catalogs[catalogurl] = (\n                        getmtime(catalogurl),\n                        iris,\n                        dirs,\n                    )\n            self.world._iri_mappings.update(iris)\n        resolved_url = self.world._iri_mappings.get(url, url)\n        # Append paths from catalog file to onto_path\n        for path in sorted(dirs, reverse=True):\n            if path not in owlready2.onto_path:\n                owlready2.onto_path.append(path)\n\n        # Use catalog file to update IRIs of imported ontologies\n        # in internal store and try to load again...\n        if self.world._iri_mappings:\n            for abbrev_iri in self.world._get_obj_triples_sp_o(\n                self.storid, owlready2.owl_imports\n            ):\n                iri = self._unabbreviate(abbrev_iri)\n                if iri in self.world._iri_mappings:\n                    self._del_obj_triple_spo(\n                        self.storid, owlready2.owl_imports, abbrev_iri\n                    )\n                    self._add_obj_triple_spo(\n                        self.storid,\n                        owlready2.owl_imports,\n                        self._abbreviate(self.world._iri_mappings[iri]),\n                    )\n\n        # Load ontology\n        try:\n            self.loaded = False\n            fmt = format if format else guess_format(resolved_url, fmap=FMAP)\n            if fmt and fmt not in OWLREADY2_FORMATS:\n                # Convert filename to rdfxml before passing it to owlready2\n                graph = rdflib.Graph()\n                try:\n                    graph.parse(resolved_url, format=fmt)\n                except URLError as err:\n                    raise EMMOntoPyException(\n                        \"URL error\", err, resolved_url\n                    ) from err\n\n                with tempfile.NamedTemporaryFile() as handle:\n                    graph.serialize(destination=handle, format=\"xml\")\n                    handle.seek(0)\n                    return super().load(\n                        only_local=True,\n                        fileobj=handle,\n                        reload=reload,\n                        reload_if_newer=reload_if_newer,\n                        format=\"rdfxml\",\n                        **kwargs,\n                    )\n            elif resolved_url.startswith(web_protocol):\n                return super().load(\n                    only_local=only_local,\n                    reload=reload,\n                    reload_if_newer=reload_if_newer,\n                    **kwargs,\n                )\n\n            else:\n                with open(resolved_url, \"rb\") as handle:\n                    return super().load(\n                        only_local=only_local,\n                        fileobj=handle,\n                        reload=reload,\n                        reload_if_newer=reload_if_newer,\n                        **kwargs,\n                    )\n        except owlready2.OwlReadyOntologyParsingError:\n            # Owlready2 is not able to parse the ontology - most\n            # likely because imported ontologies must be resolved\n            # using the catalog file.\n\n            # Reraise if we don't want to read from the catalog file\n            if not url_from_catalog and url_from_catalog is not None:\n                raise\n\n            warnings.warn(\n                \"Recovering from Owlready2 parsing error... might be deprecated\"\n            )\n\n            # Copy the ontology into a local folder and try again\n            with tempfile.TemporaryDirectory() as handle:\n                output = os.path.join(handle, os.path.basename(resolved_url))\n                convert_imported(\n                    input_ontology=resolved_url,\n                    output_ontology=output,\n                    input_format=fmt,\n                    output_format=\"xml\",\n                    url_from_catalog=url_from_catalog,\n                    catalog_file=catalog_file,\n                )\n\n                self.loaded = False\n                with open(output, \"rb\") as handle:\n                    try:\n                        return super().load(\n                            only_local=True,\n                            fileobj=handle,\n                            reload=reload,\n                            reload_if_newer=reload_if_newer,\n                            format=\"rdfxml\",\n                            **kwargs,\n                        )\n                    except HTTPError as exc:  # Add url to HTTPError message\n                        raise HTTPError(\n                            url=exc.url,\n                            code=exc.code,\n                            msg=f\"{exc.url}: {exc.msg}\",\n                            hdrs=exc.hdrs,\n                            fp=exc.fp,\n                        ).with_traceback(exc.__traceback__)\n\n        except HTTPError as exc:  # Add url to HTTPError message\n            raise HTTPError(\n                url=exc.url,\n                code=exc.code,\n                msg=f\"{exc.url}: {exc.msg}\",\n                hdrs=exc.hdrs,\n                fp=exc.fp,\n            ).with_traceback(exc.__traceback__)\n\n    def save(\n        self,\n        filename=None,\n        format=None,\n        dir=\".\",\n        mkdir=False,\n        overwrite=False,\n        recursive=False,\n        squash=False,\n        write_catalog_file=False,\n        append_catalog=False,\n        catalog_file=\"catalog-v001.xml\",\n        **kwargs,\n    ) -&gt; Path:\n        \"\"\"Writes the ontology to file.\n\n        Parameters\n        ----------\n        filename: None | str | Path\n            Name of file to write to.  If None, it defaults to the name\n            of the ontology with `format` as file extension.\n        format: str\n            Output format. The default is to infer it from `filename`.\n        dir: str | Path\n            If `filename` is a relative path, it is a relative path to `dir`.\n        mkdir: bool\n            Whether to create output directory if it does not exists.\n        owerwrite: bool\n            If true and `filename` exists, remove the existing file before\n            saving.  The default is to append to an existing ontology.\n        recursive: bool\n            Whether to save imported ontologies recursively.  This is\n            commonly combined with `filename=None`, `dir` and `mkdir`.\n            Note that depending on the structure of the ontology and\n            all imports the ontology might end up in a subdirectory.\n            If filename is given, the ontology is saved to the given\n            directory.\n            The path to the final location is returned.\n        squash: bool\n            If true, rdflib will be used to save the current ontology\n            together with all its sub-ontologies into `filename`.\n            It makes no sense to combine this with `recursive`.\n        write_catalog_file: bool\n            Whether to also write a catalog file to disk.\n        append_catalog: bool\n            Whether to append to an existing catalog file.\n        catalog_file: str | Path\n            Name of catalog file.  If not an absolute path, it is prepended\n            to `dir`.\n\n        Returns\n        --------\n            The path to the saved ontology.\n        \"\"\"\n        # pylint: disable=redefined-builtin,too-many-arguments\n        # pylint: disable=too-many-statements,too-many-branches\n        # pylint: disable=too-many-locals,arguments-renamed,invalid-name\n\n        if not _validate_installed_version(\n            package=\"rdflib\", min_version=\"6.0.0\"\n        ) and format == FMAP.get(\"ttl\", \"\"):\n            from rdflib import (  # pylint: disable=import-outside-toplevel\n                __version__ as __rdflib_version__,\n            )\n\n            warnings.warn(\n                IncompatibleVersion(\n                    \"To correctly convert to Turtle format, rdflib must be \"\n                    \"version 6.0.0 or greater, however, the detected rdflib \"\n                    \"version used by your Python interpreter is \"\n                    f\"{__rdflib_version__!r}. For more information see the \"\n                    \"'Known issues' section of the README.\"\n                )\n            )\n        revmap = {value: key for key, value in FMAP.items()}\n        if filename is None:\n            if format:\n                fmt = revmap.get(format, format)\n                file = f\"{self.name}.{fmt}\"\n            else:\n                raise TypeError(\"`filename` and `format` cannot both be None.\")\n        else:\n            file = filename\n        filepath = os.path.join(\n            dir, file if isinstance(file, (str, Path)) else file.name\n        )\n        returnpath = filepath\n\n        dir = Path(filepath).resolve().parent\n\n        if mkdir:\n            outdir = Path(filepath).parent.resolve()\n            if not outdir.exists():\n                outdir.mkdir(parents=True)\n\n        if not format:\n            format = guess_format(file, fmap=FMAP)\n        fmt = revmap.get(format, format)\n\n        if overwrite and os.path.exists(filepath):\n            os.remove(filepath)\n\n        if recursive:\n            if squash:\n                raise ValueError(\n                    \"`recursive` and `squash` should not both be true\"\n                )\n            layout = directory_layout(self)\n            if filename:\n                layout[self] = file.rstrip(f\".{fmt}\")\n            # Update path to where the ontology is saved\n            # Note that filename should include format\n            # when given\n            returnpath = Path(dir) / f\"{layout[self]}.{fmt}\"\n            for onto, path in layout.items():\n                fname = Path(dir) / f\"{path}.{fmt}\"\n                onto.save(\n                    filename=fname,\n                    format=format,\n                    dir=dir,\n                    mkdir=mkdir,\n                    overwrite=overwrite,\n                    recursive=False,\n                    squash=False,\n                    write_catalog_file=False,\n                    **kwargs,\n                )\n\n            if write_catalog_file:\n                catalog_files = set()\n                irimap = {}\n                for onto, path in layout.items():\n                    irimap[onto.get_version(as_iri=True)] = (\n                        f\"{dir}/{path}.{fmt}\"\n                    )\n                    catalog_files.add(Path(path).parent / catalog_file)\n\n                for catfile in catalog_files:\n                    write_catalog(\n                        irimap.copy(),\n                        output=catfile,\n                        directory=dir,\n                        append=append_catalog,\n                    )\n        elif squash:\n            URIRef, RDF, OWL = rdflib.URIRef, rdflib.RDF, rdflib.OWL\n\n            # Make a copy of the owlready2 graph object to not mess with\n            # owlready2 internals\n            graph = rdflib.Graph()\n            for triple in self.world.as_rdflib_graph():\n                graph.add(triple)\n\n            # Add common namespaces unknown to rdflib\n            extra_namespaces = [\n                (\"\", self.base_iri),\n                (\"swrl\", \"http://www.w3.org/2003/11/swrl#\"),\n                (\"bibo\", \"http://purl.org/ontology/bibo/\"),\n            ]\n            for prefix, iri in extra_namespaces:\n                graph.namespace_manager.bind(\n                    prefix, rdflib.Namespace(iri), override=False\n                )\n\n            # Remove all ontology-declarations in the graph that are\n            # not the current ontology.\n            for s, _, _ in graph.triples(  # pylint: disable=not-an-iterable\n                (None, RDF.type, OWL.Ontology)\n            ):\n                if str(s).rstrip(\"/#\") != self.base_iri.rstrip(\"/#\"):\n                    for (\n                        _,\n                        p,\n                        o,\n                    ) in graph.triples(  # pylint: disable=not-an-iterable\n                        (s, None, None)\n                    ):\n                        graph.remove((s, p, o))\n                graph.remove((s, OWL.imports, None))\n\n            # Insert correct IRI of the ontology\n            if self.iri:\n                base_iri = URIRef(self.base_iri)\n                for s, p, o in graph.triples(  # pylint: disable=not-an-iterable\n                    (base_iri, None, None)\n                ):\n                    graph.remove((s, p, o))\n                    graph.add((URIRef(self.iri), p, o))\n\n            graph.serialize(destination=filepath, format=format)\n        elif format in OWLREADY2_FORMATS:\n            super().save(file=filepath, format=fmt, **kwargs)\n        else:\n            # The try-finally clause is needed for cleanup and because\n            # we have to provide delete=False to NamedTemporaryFile\n            # since Windows does not allow to reopen an already open\n            # file.\n            try:\n                with tempfile.NamedTemporaryFile(\n                    suffix=\".owl\", delete=False\n                ) as handle:\n                    tmpfile = handle.name\n                super().save(tmpfile, format=\"ntriples\", **kwargs)\n                graph = rdflib.Graph()\n                graph.parse(tmpfile, format=\"ntriples\")\n                graph.namespace_manager.bind(\n                    \"\", rdflib.Namespace(self.base_iri)\n                )\n                if self.iri:\n                    base_iri = rdflib.URIRef(self.base_iri)\n                    for (\n                        s,\n                        p,\n                        o,\n                    ) in graph.triples(  # pylint: disable=not-an-iterable\n                        (base_iri, None, None)\n                    ):\n                        graph.remove((s, p, o))\n                        graph.add((rdflib.URIRef(self.iri), p, o))\n                graph.serialize(destination=filepath, format=format)\n            finally:\n                os.remove(tmpfile)\n\n        if write_catalog_file and not recursive:\n            write_catalog(\n                {self.get_version(as_iri=True): filepath},\n                output=catalog_file,\n                directory=dir,\n                append=append_catalog,\n            )\n        return Path(returnpath)\n\n    def copy(self):\n        \"\"\"Return a copy of the ontology.\"\"\"\n        with tempfile.TemporaryDirectory() as dirname:\n            filename = self.save(\n                dir=dirname,\n                format=\"turtle\",\n                recursive=True,\n                write_catalog_file=True,\n                mkdir=True,\n            )\n            ontology = get_ontology(filename).load()\n            ontology.name = self.name\n        return ontology\n\n    def get_imported_ontologies(self, recursive=False):\n        \"\"\"Return a list with imported ontologies.\n\n        If `recursive` is `True`, ontologies imported by imported ontologies\n        are also returned.\n        \"\"\"\n\n        def rec_imported(onto, imported):\n            for ontology in onto.imported_ontologies:\n                # pylint: disable=possibly-used-before-assignment\n                if ontology not in imported:\n                    imported.add(ontology)\n                    rec_imported(ontology, imported)\n\n        if recursive:\n            imported = set()\n            rec_imported(self, imported)\n            return list(imported)\n\n        return self.imported_ontologies\n\n    def get_entities(  # pylint: disable=too-many-arguments\n        self,\n        imported=True,\n        classes=True,\n        individuals=True,\n        object_properties=True,\n        data_properties=True,\n        annotation_properties=True,\n    ):\n        \"\"\"Return a generator over (optionally) all classes, individuals,\n        object_properties, data_properties and annotation_properties.\n\n        If `imported` is `True`, entities in imported ontologies will also\n        be included.\n        \"\"\"\n        generator = []\n        if classes:\n            generator.append(self.classes(imported))\n        if individuals:\n            generator.append(self.individuals(imported))\n        if object_properties:\n            generator.append(self.object_properties(imported))\n        if data_properties:\n            generator.append(self.data_properties(imported))\n        if annotation_properties:\n            generator.append(self.annotation_properties(imported))\n        yield from itertools.chain(*generator)\n\n    def classes(self, imported=False):\n        \"\"\"Returns an generator over all classes.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"classes\", imported=imported)\n\n    def _entities(\n        self, entity_type, imported=False\n    ):  # pylint: disable=too-many-branches\n        \"\"\"Returns an generator over all entities of the desired type.\n        This is a helper function for `classes()`, `individuals()`,\n        `object_properties()`, `data_properties()` and\n        `annotation_properties()`.\n\n        Arguments:\n            entity_type: The type of entity desired given as a string.\n                Can be any of `classes`, `individuals`,\n                `object_properties`, `data_properties` and\n                `annotation_properties`.\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n\n        generator = []\n        if imported:\n            ontologies = self.get_imported_ontologies(recursive=True)\n            ontologies.append(self)\n            for onto in ontologies:\n                if entity_type == \"classes\":\n                    for cls in list(onto.classes()):\n                        generator.append(cls)\n                elif entity_type == \"individuals\":\n                    for ind in list(onto.individuals()):\n                        generator.append(ind)\n                elif entity_type == \"object_properties\":\n                    for prop in list(onto.object_properties()):\n                        generator.append(prop)\n                elif entity_type == \"data_properties\":\n                    for prop in list(onto.data_properties()):\n                        generator.append(prop)\n                elif entity_type == \"annotation_properties\":\n                    for prop in list(onto.annotation_properties()):\n                        generator.append(prop)\n        else:\n            if entity_type == \"classes\":\n                generator = super().classes()\n            elif entity_type == \"individuals\":\n                generator = super().individuals()\n            elif entity_type == \"object_properties\":\n                generator = super().object_properties()\n            elif entity_type == \"data_properties\":\n                generator = super().data_properties()\n            elif entity_type == \"annotation_properties\":\n                generator = super().annotation_properties()\n\n        yield from generator\n\n    def individuals(self, imported=False):\n        \"\"\"Returns an generator over all individuals.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"individuals\", imported=imported)\n\n    def object_properties(self, imported=False):\n        \"\"\"Returns an generator over all object_properties.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"object_properties\", imported=imported)\n\n    def data_properties(self, imported=False):\n        \"\"\"Returns an generator over all data_properties.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n        \"\"\"\n        return self._entities(\"data_properties\", imported=imported)\n\n    def annotation_properties(self, imported=False):\n        \"\"\"Returns an generator over all annotation_properties.\n\n        Arguments:\n            imported: if `True`, entities in imported ontologies\n                are also returned.\n\n        \"\"\"\n        return self._entities(\"annotation_properties\", imported=imported)\n\n    def get_root_classes(self, imported=False):\n        \"\"\"Returns a list or root classes.\"\"\"\n        return [\n            cls\n            for cls in self.classes(imported=imported)\n            if not cls.ancestors().difference(set([cls, owlready2.Thing]))\n        ]\n\n    def get_root_object_properties(self, imported=False):\n        \"\"\"Returns a list of root object properties.\"\"\"\n        props = set(self.object_properties(imported=imported))\n        return [p for p in props if not props.intersection(p.is_a)]\n\n    def get_root_data_properties(self, imported=False):\n        \"\"\"Returns a list of root object properties.\"\"\"\n        props = set(self.data_properties(imported=imported))\n        return [p for p in props if not props.intersection(p.is_a)]\n\n    def get_roots(self, imported=False):\n        \"\"\"Returns all class, object_property and data_property roots.\"\"\"\n        roots = self.get_root_classes(imported=imported)\n        roots.extend(self.get_root_object_properties(imported=imported))\n        roots.extend(self.get_root_data_properties(imported=imported))\n        return roots\n\n    def sync_python_names(self, annotations=(\"prefLabel\", \"label\", \"altLabel\")):\n        \"\"\"Update the `python_name` attribute of all properties.\n\n        The python_name attribute will be set to the first non-empty\n        annotation in the sequence of annotations in `annotations` for\n        the property.\n        \"\"\"\n\n        def update(gen):\n            for prop in gen:\n                for annotation in annotations:\n                    if hasattr(prop, annotation) and getattr(prop, annotation):\n                        prop.python_name = getattr(prop, annotation).first()\n                        break\n\n        update(\n            self.get_entities(\n                classes=False,\n                individuals=False,\n                object_properties=False,\n                data_properties=False,\n            )\n        )\n        update(\n            self.get_entities(\n                classes=False, individuals=False, annotation_properties=False\n            )\n        )\n\n    def rename_entities(\n        self,\n        annotations=(\"prefLabel\", \"label\", \"altLabel\"),\n    ):\n        \"\"\"Set `name` of all entities to the first non-empty annotation in\n        `annotations`.\n\n        Warning, this method changes all IRIs in the ontology.  However,\n        it may be useful to make the ontology more readable and to work\n        with it together with a triple store.\n        \"\"\"\n        for entity in self.get_entities():\n            for annotation in annotations:\n                if hasattr(entity, annotation):\n                    name = getattr(entity, annotation).first()\n                    if name:\n                        entity.name = name\n                        break\n\n    def sync_reasoner(\n        self, reasoner=\"HermiT\", include_imported=False, **kwargs\n    ):\n        \"\"\"Update current ontology by running the given reasoner.\n\n        Supported values for `reasoner` are 'HermiT' (default), Pellet\n        and 'FaCT++'.\n\n        If `include_imported` is true, the reasoner will also reason\n        over imported ontologies.  Note that this may be **very** slow.\n\n        Keyword arguments are passed to the underlying owlready2 function.\n        \"\"\"\n        # pylint: disable=too-many-branches\n\n        removed_equivalent = defaultdict(list)\n        removed_subclasses = defaultdict(list)\n\n        if reasoner == \"FaCT++\":\n            sync = sync_reasoner_factpp\n        elif reasoner == \"Pellet\":\n            sync = owlready2.sync_reasoner_pellet\n        elif reasoner == \"HermiT\":\n            sync = owlready2.sync_reasoner_hermit\n\n            # Remove custom data propertyes, otherwise HermiT will crash\n            datatype_iri = \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n\n            for cls in self.classes(imported=include_imported):\n                remove_eq = []\n                for i, r in enumerate(cls.equivalent_to):\n                    if isinstance(r, owlready2.Restriction):\n                        if (\n                            hasattr(r.value.__class__, \"iri\")\n                            and r.value.__class__.iri == datatype_iri\n                        ):\n                            remove_eq.append(i)\n                            removed_equivalent[cls].append(r)\n                for i in reversed(remove_eq):\n                    del cls.equivalent_to[i]\n\n                remove_subcls = []\n                for i, r in enumerate(cls.is_a):\n                    if isinstance(r, owlready2.Restriction):\n                        if (\n                            hasattr(r.value.__class__, \"iri\")\n                            and r.value.__class__.iri == datatype_iri\n                        ):\n                            remove_subcls.append(i)\n                            removed_subclasses[cls].append(r)\n                for i in reversed(remove_subcls):\n                    del cls.is_a[i]\n\n        else:\n            raise ValueError(\n                f\"Unknown reasoner '{reasoner}'. Supported reasoners \"\n                \"are 'Pellet', 'HermiT' and 'FaCT++'.\"\n            )\n\n        # For some reason we must visit all entities once before running\n        # the reasoner...\n        list(self.get_entities())\n\n        with self:\n            if include_imported:\n                sync(self.world, **kwargs)\n            else:\n                sync(self, **kwargs)\n\n        # Restore removed custom data properties\n        for cls, eqs in removed_equivalent.items():\n            cls.extend(eqs)\n        for cls, subcls in removed_subclasses.items():\n            cls.extend(subcls)\n\n    def sync_attributes(  # pylint: disable=too-many-branches\n        self,\n        name_policy=None,\n        name_prefix=\"\",\n        class_docstring=\"comment\",\n        sync_imported=False,\n    ):\n        \"\"\"This method is intended to be called after you have added new\n        classes (typically via Python) to make sure that attributes like\n        `label` and `comments` are defined.\n\n        If a class, object property, data property or annotation\n        property in the current ontology has no label, the name of\n        the corresponding Python class will be assigned as label.\n\n        If a class, object property, data property or annotation\n        property has no comment, it will be assigned the docstring of\n        the corresponding Python class.\n\n        `name_policy` specify wether and how the names in the ontology\n        should be updated.  Valid values are:\n          None          not changed\n          \"uuid\"        `name_prefix` followed by a global unique id (UUID).\n                        If the name is already valid accoridng to this standard\n                        it will not be regenerated.\n          \"sequential\"  `name_prefix` followed a sequantial number.\n        EMMO conventions imply ``name_policy=='uuid'``.\n\n        If `sync_imported` is true, all imported ontologies are also\n        updated.\n\n        The `class_docstring` argument specifies the annotation that\n        class docstrings are mapped to.  Defaults to \"comment\".\n        \"\"\"\n        for cls in itertools.chain(\n            self.classes(),\n            self.object_properties(),\n            self.data_properties(),\n            self.annotation_properties(),\n        ):\n            if not hasattr(cls, \"prefLabel\"):\n                # no prefLabel - create new annotation property..\n                with self:\n                    # pylint: disable=invalid-name,missing-class-docstring\n                    # pylint: disable=unused-variable\n                    class prefLabel(owlready2.label):\n                        pass\n\n                cls.prefLabel = [locstr(cls.__name__, lang=\"en\")]\n            elif not cls.prefLabel:\n                cls.prefLabel.append(locstr(cls.__name__, lang=\"en\"))\n            if class_docstring and hasattr(cls, \"__doc__\") and cls.__doc__:\n                getattr(cls, class_docstring).append(\n                    locstr(inspect.cleandoc(cls.__doc__), lang=\"en\")\n                )\n\n        for ind in self.individuals():\n            if not hasattr(ind, \"prefLabel\"):\n                # no prefLabel - create new annotation property..\n                with self:\n                    # pylint: disable=invalid-name,missing-class-docstring\n                    # pylint: disable=function-redefined\n                    class prefLabel(owlready2.label):\n                        iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n\n                ind.prefLabel = [locstr(ind.name, lang=\"en\")]\n            elif not ind.prefLabel:\n                ind.prefLabel.append(locstr(ind.name, lang=\"en\"))\n\n        chain = itertools.chain(\n            self.classes(),\n            self.individuals(),\n            self.object_properties(),\n            self.data_properties(),\n            self.annotation_properties(),\n        )\n        if name_policy == \"uuid\":\n            for obj in chain:\n                try:\n                    # Passing the following means that the name is valid\n                    # and need not be regenerated.\n                    if not obj.name.startswith(name_prefix):\n                        raise ValueError\n                    uuid.UUID(obj.name.lstrip(name_prefix), version=5)\n                except ValueError:\n                    obj.name = name_prefix + str(\n                        uuid.uuid5(uuid.NAMESPACE_DNS, obj.name)\n                    )\n        elif name_policy == \"sequential\":\n            for obj in chain:\n                counter = 0\n                while f\"{self.base_iri}{name_prefix}{counter}\" in self:\n                    counter += 1\n                obj.name = f\"{name_prefix}{counter}\"\n        elif name_policy is not None:\n            raise TypeError(f\"invalid name_policy: {name_policy!r}\")\n\n        if sync_imported:\n            for onto in self.imported_ontologies:\n                onto.sync_attributes()\n\n    def get_relations(self):\n        \"\"\"Returns a generator for all relations.\"\"\"\n        warnings.warn(\n            \"Ontology.get_relations() is deprecated. Use \"\n            \"onto.object_properties() instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        return self.object_properties()\n\n    def get_annotations(self, entity):\n        \"\"\"Returns a dict with annotations for `entity`.  Entity may be given\n        either as a ThingClass object or as a label.\"\"\"\n        warnings.warn(\n            \"Ontology.get_annotations(entity) is deprecated. Use \"\n            \"entity.get_annotations() instead.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n\n        if isinstance(entity, str):\n            entity = self.get_by_label(entity)\n        res = {\"comment\": getattr(entity, \"comment\", \"\")}\n        for annotation in self.annotation_properties():\n            res[annotation.label.first()] = [\n                obj.strip('\"')\n                for _, _, obj in self.get_triples(\n                    entity.storid, annotation.storid, None\n                )\n            ]\n        return res\n\n    def get_branch(  # pylint: disable=too-many-arguments\n        self,\n        root,\n        leaves=(),\n        include_leaves=True,\n        strict_leaves=False,\n        exclude=None,\n        sort=False,\n    ):\n        \"\"\"Returns a set with all direct and indirect subclasses of `root`.\n        Any subclass found in the sequence `leaves` will be included in\n        the returned list, but its subclasses will not.  The elements\n        of `leaves` may be ThingClass objects or labels.\n\n        Subclasses of any subclass found in the sequence `leaves` will\n        be excluded from the returned list, where the elements of `leaves`\n        may be ThingClass objects or labels.\n\n        If `include_leaves` is true, the leaves are included in the returned\n        list, otherwise they are not.\n\n        If `strict_leaves` is true, any descendant of a leaf will be excluded\n        in the returned set.\n\n        If given, `exclude` may be a sequence of classes, including\n        their subclasses, to exclude from the output.\n\n        If `sort` is True, a list sorted according to depth and label\n        will be returned instead of a set.\n        \"\"\"\n\n        def _branch(root, leaves):\n            if root not in leaves:\n                branch = {\n                    root,\n                }\n                for cls in root.subclasses():\n                    # Defining a branch is actually quite tricky.  Consider\n                    # the case:\n                    #\n                    #      L isA R\n                    #      A isA L\n                    #      A isA R\n                    #\n                    # where R is the root, L is a leaf and A is a direct\n                    # child of both.  Logically, since A is a child of the\n                    # leaf we want to skip A.  But a strait forward imple-\n                    # mentation will see that A is a child of the root and\n                    # include it.  Requireing that the R should be a strict\n                    # parent of A solves this.\n                    if root in cls.get_parents(strict=True):\n                        branch.update(_branch(cls, leaves))\n            else:\n                branch = (\n                    {\n                        root,\n                    }\n                    if include_leaves\n                    else set()\n                )\n            return branch\n\n        if isinstance(root, str):\n            root = self.get_by_label(root)\n\n        leaves = set(\n            self.get_by_label(leaf) if isinstance(leaf, str) else leaf\n            for leaf in leaves\n        )\n        leaves.discard(root)\n\n        if exclude:\n            exclude = set(\n                self.get_by_label(e) if isinstance(e, str) else e\n                for e in exclude\n            )\n            leaves.update(exclude)\n\n        branch = _branch(root, leaves)\n\n        # Exclude all descendants of any leaf\n        if strict_leaves:\n            descendants = root.descendants()\n            for leaf in leaves:\n                if leaf in descendants:\n                    branch.difference_update(\n                        leaf.descendants(include_self=False)\n                    )\n\n        if exclude:\n            branch.difference_update(exclude)\n\n        # Sort according to depth, then by label\n        if sort:\n            branch = sorted(\n                sorted(branch, key=asstring),\n                key=lambda x: len(x.mro()),\n            )\n\n        return branch\n\n    def is_individual(self, entity):\n        \"\"\"Returns true if entity is an individual.\"\"\"\n        if isinstance(entity, str):\n            entity = self.get_by_label(entity)\n        return isinstance(entity, owlready2.Thing)\n\n    # FIXME - deprecate this method as soon the ThingClass property\n    #         `defined_class` works correct in Owlready2\n    def is_defined(self, entity):\n        \"\"\"Returns true if the entity is a defined class.\n\n        Deprecated, use the `is_defined` property of the classes\n        (ThingClass subclasses) instead.\n        \"\"\"\n        warnings.warn(\n            \"This method is deprecated.  Use the `is_defined` property of \"\n            \"the classes instad.\",\n            DeprecationWarning,\n            stacklevel=2,\n        )\n        if isinstance(entity, str):\n            entity = self.get_by_label(entity)\n        return hasattr(entity, \"equivalent_to\") and bool(entity.equivalent_to)\n\n    def get_version(self, as_iri=False) -&gt; str:\n        \"\"\"Returns the version number of the ontology as inferred from the\n        owl:versionIRI tag or, if owl:versionIRI is not found, from\n        owl:versionINFO.\n\n        If `as_iri` is True, the full versionIRI is returned.\n        \"\"\"\n        version_iri_storid = self.world._abbreviate(\n            \"http://www.w3.org/2002/07/owl#versionIRI\"\n        )\n        tokens = self.get_triples(s=self.storid, p=version_iri_storid)\n        if (not tokens) and (as_iri is True):\n            raise TypeError(\n                \"No owl:versionIRI \"\n                f\"in Ontology {self.base_iri!r}. \"\n                \"Search for owl:versionInfo with as_iri=False\"\n            )\n        if tokens:\n            _, _, obj = tokens[0]\n            version_iri = self.world._unabbreviate(obj)\n            if as_iri:\n                return version_iri\n            return infer_version(self.base_iri, version_iri)\n\n        version_info_storid = self.world._abbreviate(\n            \"http://www.w3.org/2002/07/owl#versionInfo\"\n        )\n        tokens = self.get_triples(s=self.storid, p=version_info_storid)\n        if not tokens:\n            raise TypeError(\n                \"No versionIRI or versionInfo \" f\"in Ontology {self.base_iri!r}\"\n            )\n        _, _, version_info = tokens[0]\n        return version_info.split(\"^^\")[0].strip('\"')\n\n    def set_version(self, version=None, version_iri=None):\n        \"\"\"Assign version to ontology by asigning owl:versionIRI.\n\n        If `version` but not `version_iri` is provided, the version\n        IRI will be the combination of `base_iri` and `version`.\n        \"\"\"\n        _version_iri = \"http://www.w3.org/2002/07/owl#versionIRI\"\n        version_iri_storid = self.world._abbreviate(_version_iri)\n        if self._has_obj_triple_spo(  # pylint: disable=unexpected-keyword-arg\n            # For some reason _has_obj_triples_spo exists in both\n            # owlready2.namespace.Namespace (with arguments subject/predicate)\n            # and in owlready2.triplelite._GraphManager (with arguments s/p)\n            # owlready2.Ontology inherits from Namespace directly\n            # and pylint checks that.\n            # It actually accesses the one in triplelite.\n            # subject=self.storid, predicate=version_iri_storid\n            s=self.storid,\n            p=version_iri_storid,\n        ):\n            self._del_obj_triple_spo(s=self.storid, p=version_iri_storid)\n\n        if not version_iri:\n            if not version:\n                raise TypeError(\n                    \"Either `version` or `version_iri` must be provided\"\n                )\n            head, tail = self.base_iri.rstrip(\"#/\").rsplit(\"/\", 1)\n            version_iri = \"/\".join([head, version, tail])\n\n        self._add_obj_triple_spo(\n            s=self.storid,\n            p=self.world._abbreviate(_version_iri),\n            o=self.world._abbreviate(version_iri),\n        )\n\n    def get_graph(self, **kwargs):\n        \"\"\"Returns a new graph object.  See  emmo.graph.OntoGraph.\n\n        Note that this method requires the Python graphviz package.\n        \"\"\"\n        # pylint: disable=import-outside-toplevel,cyclic-import\n        from ontopy.graph import OntoGraph\n\n        return OntoGraph(self, **kwargs)\n\n    @staticmethod\n    def common_ancestors(cls1, cls2):\n        \"\"\"Return a list of common ancestors for `cls1` and `cls2`.\"\"\"\n        return set(cls1.ancestors()).intersection(cls2.ancestors())\n\n    def number_of_generations(self, descendant, ancestor):\n        \"\"\"Return shortest distance from ancestor to descendant\"\"\"\n        if ancestor not in descendant.ancestors():\n            raise ValueError(\"Descendant is not a descendant of ancestor\")\n        return self._number_of_generations(descendant, ancestor, 0)\n\n    def _number_of_generations(self, descendant, ancestor, counter):\n        \"\"\"Recursive help function to number_of_generations(), return\n        distance between a ancestor-descendant pair (counter+1).\"\"\"\n        if descendant.name == ancestor.name:\n            return counter\n        try:\n            return min(\n                self._number_of_generations(parent, ancestor, counter + 1)\n                for parent in descendant.get_parents()\n                if ancestor in parent.ancestors()\n            )\n        except ValueError:\n            return counter\n\n    def closest_common_ancestors(self, cls1, cls2):\n        \"\"\"Returns a list with closest_common_ancestor for cls1 and cls2\"\"\"\n        distances = {}\n        for ancestor in self.common_ancestors(cls1, cls2):\n            distances[ancestor] = self.number_of_generations(\n                cls1, ancestor\n            ) + self.number_of_generations(cls2, ancestor)\n        return [\n            ancestor\n            for ancestor, distance in distances.items()\n            if distance == min(distances.values())\n        ]\n\n    @staticmethod\n    def closest_common_ancestor(*classes):\n        \"\"\"Returns closest_common_ancestor for the given classes.\"\"\"\n        mros = [cls.mro() for cls in classes]\n        track = defaultdict(int)\n        while mros:\n            for mro in mros:\n                cur = mro.pop(0)\n                track[cur] += 1\n                if track[cur] == len(classes):\n                    return cur\n                if len(mro) == 0:\n                    mros.remove(mro)\n        raise EMMOntoPyException(\n            \"A closest common ancestor should always exist !\"\n        )\n\n    def get_ancestors(\n        self,\n        classes: \"Union[List, ThingClass]\",\n        closest: bool = False,\n        generations: int = None,\n        strict: bool = True,\n    ) -&gt; set:\n        \"\"\"Return ancestors of all classes in `classes`.\n        Args:\n            classes: class(es) for which ancestors should be returned.\n            generations: Include this number of generations, default is all.\n            closest: If True, return all ancestors up to and including the\n                closest common ancestor. Return all if False.\n            strict: If True returns only real ancestors, i.e. `classes` are\n                are not included in the returned set.\n        Returns:\n            Set of ancestors to `classes`.\n        \"\"\"\n        if not isinstance(classes, Iterable):\n            classes = [classes]\n\n        ancestors = set()\n        if not classes:\n            return ancestors\n\n        def addancestors(entity, counter, subject):\n            if counter &gt; 0:\n                for parent in entity.get_parents(strict=True):\n                    subject.add(parent)\n                    addancestors(parent, counter - 1, subject)\n\n        if closest:\n            if generations is not None:\n                raise ValueError(\n                    \"Only one of `generations` or `closest` may be specified.\"\n                )\n\n            closest_ancestor = self.closest_common_ancestor(*classes)\n            for cls in classes:\n                ancestors.update(\n                    anc\n                    for anc in cls.ancestors()\n                    if closest_ancestor in anc.ancestors()\n                )\n        elif isinstance(generations, int):\n            for entity in classes:\n                addancestors(entity, generations, ancestors)\n        else:\n            ancestors.update(*(cls.ancestors() for cls in classes))\n\n        if strict:\n            return ancestors.difference(classes)\n        return ancestors\n\n    def get_descendants(\n        self,\n        classes: \"Union[List, ThingClass]\",\n        generations: int = None,\n        common: bool = False,\n    ) -&gt; set:\n        \"\"\"Return descendants/subclasses of all classes in `classes`.\n        Args:\n            classes: class(es) for which descendants are desired.\n            common: whether to only return descendants common to all classes.\n            generations: Include this number of generations, default is all.\n        Returns:\n            A set of descendants for given number of generations.\n            If 'common'=True, the common descendants are returned\n            within the specified number of generations.\n            'generations' defaults to all.\n        \"\"\"\n\n        if not isinstance(classes, Iterable):\n            classes = [classes]\n\n        descendants = {name: [] for name in classes}\n\n        def _children_recursively(num, newentity, parent, descendants):\n            \"\"\"Helper function to get all children up to generation.\"\"\"\n            for child in self.get_children_of(newentity):\n                descendants[parent].append(child)\n                if num &lt; generations:\n                    _children_recursively(num + 1, child, parent, descendants)\n\n        if generations == 0:\n            return set()\n\n        if not generations:\n            for entity in classes:\n                descendants[entity] = entity.descendants()\n                # only include proper descendants\n                descendants[entity].remove(entity)\n        else:\n            for entity in classes:\n                _children_recursively(1, entity, entity, descendants)\n\n        results = descendants.values()\n        if common is True:\n            return set.intersection(*map(set, results))\n        return set(flatten(results))\n\n    def get_wu_palmer_measure(self, cls1, cls2):\n        \"\"\"Return Wu-Palmer measure for semantic similarity.\n\n        Returns Wu-Palmer measure for semantic similarity between\n        two concepts.\n        Wu, Palmer; ACL 94: Proceedings of the 32nd annual meeting on\n        Association for Computational Linguistics, June 1994.\n        \"\"\"\n        cca = self.closest_common_ancestor(cls1, cls2)\n        ccadepth = self.number_of_generations(cca, self.Thing)\n        generations1 = self.number_of_generations(cls1, cca)\n        generations2 = self.number_of_generations(cls2, cca)\n        return 2 * ccadepth / (generations1 + generations2 + 2 * ccadepth)\n\n    def new_entity(\n        self,\n        name: str,\n        parent: Union[\n            ThingClass,\n            ObjectPropertyClass,\n            DataPropertyClass,\n            AnnotationPropertyClass,\n            Iterable,\n        ],\n        entitytype: Optional[\n            Union[\n                str,\n                ThingClass,\n                ObjectPropertyClass,\n                DataPropertyClass,\n                AnnotationPropertyClass,\n            ]\n        ] = \"class\",\n        preflabel: Optional[str] = None,\n    ) -&gt; Union[\n        ThingClass,\n        ObjectPropertyClass,\n        DataPropertyClass,\n        AnnotationPropertyClass,\n    ]:\n        \"\"\"Create and return new entity\n\n        Args:\n            name: name of the entity\n            parent: parent(s) of the entity\n            entitytype: type of the entity,\n                default is 'class' (str) 'ThingClass' (owlready2 Python class).\n                Other options\n                are 'data_property', 'object_property',\n                'annotation_property' (strings) or the\n                Python classes ObjectPropertyClass,\n                DataPropertyClass and AnnotationProperty classes.\n            preflabel: if given, add this as a skos:prefLabel annotation\n                to the new entity.  If None (default), `name` will\n                be added as prefLabel if skos:prefLabel is in the ontology\n                and listed in `self.label_annotations`.  Set `preflabel` to\n                False, to avoid assigning a prefLabel.\n\n        Returns:\n            the new entity.\n\n        Throws exception if name consists of more than one word, if type is not\n        one of the allowed types, or if parent is not of the correct type.\n        By default, the parent is Thing.\n\n        \"\"\"\n        # pylint: disable=invalid-name\n        if \" \" in name:\n            raise LabelDefinitionError(\n                f\"Error in label name definition '{name}': \"\n                f\"Label consists of more than one word.\"\n            )\n        parents = tuple(parent) if isinstance(parent, Iterable) else (parent,)\n        if entitytype == \"class\":\n            parenttype = owlready2.ThingClass\n        elif entitytype == \"data_property\":\n            parenttype = owlready2.DataPropertyClass\n        elif entitytype == \"object_property\":\n            parenttype = owlready2.ObjectPropertyClass\n        elif entitytype == \"annotation_property\":\n            parenttype = owlready2.AnnotationPropertyClass\n        elif entitytype in [\n            ThingClass,\n            ObjectPropertyClass,\n            DataPropertyClass,\n            AnnotationPropertyClass,\n        ]:\n            parenttype = entitytype\n        else:\n            raise EntityClassDefinitionError(\n                f\"Error in entity type definition: \"\n                f\"'{entitytype}' is not a valid entity type.\"\n            )\n        for thing in parents:\n            if not isinstance(thing, parenttype):\n                raise EntityClassDefinitionError(\n                    f\"Error in parent definition: \"\n                    f\"'{thing}' is not an {parenttype}.\"\n                )\n\n        with self:\n            entity = types.new_class(name, parents)\n\n            preflabel_iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n            if preflabel:\n                if not self.world[preflabel_iri]:\n                    pref_label = self.new_annotation_property(\n                        \"prefLabel\",\n                        parent=[owlready2.AnnotationProperty],\n                    )\n                    pref_label.iri = preflabel_iri\n                entity.prefLabel = english(preflabel)\n            elif (\n                preflabel is None\n                and preflabel_iri in self.label_annotations\n                and self.world[preflabel_iri]\n            ):\n                entity.prefLabel = english(name)\n\n        return entity\n\n    # Method that creates new ThingClass using new_entity\n    def new_class(\n        self, name: str, parent: Union[ThingClass, Iterable]\n    ) -&gt; ThingClass:\n        \"\"\"Create and return new class.\n\n        Args:\n            name: name of the class\n            parent: parent(s) of the class\n\n        Returns:\n            the new class.\n        \"\"\"\n        return self.new_entity(name, parent, \"class\")\n\n    # Method that creates new ObjectPropertyClass using new_entity\n    def new_object_property(\n        self, name: str, parent: Union[ObjectPropertyClass, Iterable]\n    ) -&gt; ObjectPropertyClass:\n        \"\"\"Create and return new object property.\n\n        Args:\n            name: name of the object property\n            parent: parent(s) of the object property\n\n        Returns:\n            the new object property.\n        \"\"\"\n        return self.new_entity(name, parent, \"object_property\")\n\n    # Method that creates new DataPropertyClass using new_entity\n    def new_data_property(\n        self, name: str, parent: Union[DataPropertyClass, Iterable]\n    ) -&gt; DataPropertyClass:\n        \"\"\"Create and return new data property.\n\n        Args:\n            name: name of the data property\n            parent: parent(s) of the data property\n\n        Returns:\n            the new data property.\n        \"\"\"\n        return self.new_entity(name, parent, \"data_property\")\n\n    # Method that creates new AnnotationPropertyClass using new_entity\n    def new_annotation_property(\n        self, name: str, parent: Union[AnnotationPropertyClass, Iterable]\n    ) -&gt; AnnotationPropertyClass:\n        \"\"\"Create and return new annotation property.\n\n        Args:\n            name: name of the annotation property\n            parent: parent(s) of the annotation property\n\n        Returns:\n            the new annotation property.\n        \"\"\"\n        return self.new_entity(name, parent, \"annotation_property\")\n\n    def difference(self, other: owlready2.Ontology) -&gt; set:\n        \"\"\"Return a set of triples that are in this, but not in the\n        `other` ontology.\"\"\"\n        # pylint: disable=invalid-name\n        s1 = set(self.get_unabbreviated_triples(blank=\"_:b\"))\n        s2 = set(other.get_unabbreviated_triples(blank=\"_:b\"))\n        return s1.difference(s2)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.colon_in_label","title":"<code>colon_in_label</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to accept colon in name-part of IRI.  If true, the name cannot be prefixed.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_imported","title":"<code>dir_imported</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include imported ontologies in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_label","title":"<code>dir_label</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include entity label in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_name","title":"<code>dir_name</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include entity name in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.dir_preflabel","title":"<code>dir_preflabel</code>  <code>property</code> <code>writable</code>","text":"<p>Whether to include entity prefLabel in dir() listing.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.add_label_annotation","title":"<code>add_label_annotation(self, iri)</code>","text":"<p>Adds label annotation used by get_by_label().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def add_label_annotation(self, iri):\n    \"\"\"Adds label annotation used by get_by_label().\"\"\"\n    warnings.warn(\n        \"Ontology.add_label_annotations() is deprecated. \"\n        \"Direct modify the `label_annotations` attribute instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    if hasattr(iri, \"iri\"):\n        iri = iri.iri\n    if iri not in self.label_annotations:\n        self.label_annotations.append(iri)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.annotation_properties","title":"<code>annotation_properties(self, imported=False)</code>","text":"<p>Returns an generator over all annotation_properties.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def annotation_properties(self, imported=False):\n    \"\"\"Returns an generator over all annotation_properties.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n\n    \"\"\"\n    return self._entities(\"annotation_properties\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.classes","title":"<code>classes(self, imported=False)</code>","text":"<p>Returns an generator over all classes.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def classes(self, imported=False):\n    \"\"\"Returns an generator over all classes.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"classes\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.closest_common_ancestor","title":"<code>closest_common_ancestor(*classes)</code>  <code>staticmethod</code>","text":"<p>Returns closest_common_ancestor for the given classes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>@staticmethod\ndef closest_common_ancestor(*classes):\n    \"\"\"Returns closest_common_ancestor for the given classes.\"\"\"\n    mros = [cls.mro() for cls in classes]\n    track = defaultdict(int)\n    while mros:\n        for mro in mros:\n            cur = mro.pop(0)\n            track[cur] += 1\n            if track[cur] == len(classes):\n                return cur\n            if len(mro) == 0:\n                mros.remove(mro)\n    raise EMMOntoPyException(\n        \"A closest common ancestor should always exist !\"\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.closest_common_ancestors","title":"<code>closest_common_ancestors(self, cls1, cls2)</code>","text":"<p>Returns a list with closest_common_ancestor for cls1 and cls2</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def closest_common_ancestors(self, cls1, cls2):\n    \"\"\"Returns a list with closest_common_ancestor for cls1 and cls2\"\"\"\n    distances = {}\n    for ancestor in self.common_ancestors(cls1, cls2):\n        distances[ancestor] = self.number_of_generations(\n            cls1, ancestor\n        ) + self.number_of_generations(cls2, ancestor)\n    return [\n        ancestor\n        for ancestor, distance in distances.items()\n        if distance == min(distances.values())\n    ]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.common_ancestors","title":"<code>common_ancestors(cls1, cls2)</code>  <code>staticmethod</code>","text":"<p>Return a list of common ancestors for <code>cls1</code> and <code>cls2</code>.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>@staticmethod\ndef common_ancestors(cls1, cls2):\n    \"\"\"Return a list of common ancestors for `cls1` and `cls2`.\"\"\"\n    return set(cls1.ancestors()).intersection(cls2.ancestors())\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.copy","title":"<code>copy(self)</code>","text":"<p>Return a copy of the ontology.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def copy(self):\n    \"\"\"Return a copy of the ontology.\"\"\"\n    with tempfile.TemporaryDirectory() as dirname:\n        filename = self.save(\n            dir=dirname,\n            format=\"turtle\",\n            recursive=True,\n            write_catalog_file=True,\n            mkdir=True,\n        )\n        ontology = get_ontology(filename).load()\n        ontology.name = self.name\n    return ontology\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.data_properties","title":"<code>data_properties(self, imported=False)</code>","text":"<p>Returns an generator over all data_properties.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def data_properties(self, imported=False):\n    \"\"\"Returns an generator over all data_properties.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"data_properties\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.difference","title":"<code>difference(self, other)</code>","text":"<p>Return a set of triples that are in this, but not in the <code>other</code> ontology.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def difference(self, other: owlready2.Ontology) -&gt; set:\n    \"\"\"Return a set of triples that are in this, but not in the\n    `other` ontology.\"\"\"\n    # pylint: disable=invalid-name\n    s1 = set(self.get_unabbreviated_triples(blank=\"_:b\"))\n    s2 = set(other.get_unabbreviated_triples(blank=\"_:b\"))\n    return s1.difference(s2)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_ancestors","title":"<code>get_ancestors(self, classes, closest=False, generations=None, strict=True)</code>","text":"<p>Return ancestors of all classes in <code>classes</code>.</p> <p>Parameters:</p> Name Type Description Default <code>classes</code> <code>Union[List, ThingClass]</code> <p>class(es) for which ancestors should be returned.</p> required <code>generations</code> <code>int</code> <p>Include this number of generations, default is all.</p> <code>None</code> <code>closest</code> <code>bool</code> <p>If True, return all ancestors up to and including the closest common ancestor. Return all if False.</p> <code>False</code> <code>strict</code> <code>bool</code> <p>If True returns only real ancestors, i.e. <code>classes</code> are are not included in the returned set.</p> <code>True</code> <p>Returns:</p> Type Description <code>set</code> <p>Set of ancestors to <code>classes</code>.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_ancestors(\n    self,\n    classes: \"Union[List, ThingClass]\",\n    closest: bool = False,\n    generations: int = None,\n    strict: bool = True,\n) -&gt; set:\n    \"\"\"Return ancestors of all classes in `classes`.\n    Args:\n        classes: class(es) for which ancestors should be returned.\n        generations: Include this number of generations, default is all.\n        closest: If True, return all ancestors up to and including the\n            closest common ancestor. Return all if False.\n        strict: If True returns only real ancestors, i.e. `classes` are\n            are not included in the returned set.\n    Returns:\n        Set of ancestors to `classes`.\n    \"\"\"\n    if not isinstance(classes, Iterable):\n        classes = [classes]\n\n    ancestors = set()\n    if not classes:\n        return ancestors\n\n    def addancestors(entity, counter, subject):\n        if counter &gt; 0:\n            for parent in entity.get_parents(strict=True):\n                subject.add(parent)\n                addancestors(parent, counter - 1, subject)\n\n    if closest:\n        if generations is not None:\n            raise ValueError(\n                \"Only one of `generations` or `closest` may be specified.\"\n            )\n\n        closest_ancestor = self.closest_common_ancestor(*classes)\n        for cls in classes:\n            ancestors.update(\n                anc\n                for anc in cls.ancestors()\n                if closest_ancestor in anc.ancestors()\n            )\n    elif isinstance(generations, int):\n        for entity in classes:\n            addancestors(entity, generations, ancestors)\n    else:\n        ancestors.update(*(cls.ancestors() for cls in classes))\n\n    if strict:\n        return ancestors.difference(classes)\n    return ancestors\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_annotations","title":"<code>get_annotations(self, entity)</code>","text":"<p>Returns a dict with annotations for <code>entity</code>.  Entity may be given either as a ThingClass object or as a label.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_annotations(self, entity):\n    \"\"\"Returns a dict with annotations for `entity`.  Entity may be given\n    either as a ThingClass object or as a label.\"\"\"\n    warnings.warn(\n        \"Ontology.get_annotations(entity) is deprecated. Use \"\n        \"entity.get_annotations() instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n\n    if isinstance(entity, str):\n        entity = self.get_by_label(entity)\n    res = {\"comment\": getattr(entity, \"comment\", \"\")}\n    for annotation in self.annotation_properties():\n        res[annotation.label.first()] = [\n            obj.strip('\"')\n            for _, _, obj in self.get_triples(\n                entity.storid, annotation.storid, None\n            )\n        ]\n    return res\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_branch","title":"<code>get_branch(self, root, leaves=(), include_leaves=True, strict_leaves=False, exclude=None, sort=False)</code>","text":"<p>Returns a set with all direct and indirect subclasses of <code>root</code>. Any subclass found in the sequence <code>leaves</code> will be included in the returned list, but its subclasses will not.  The elements of <code>leaves</code> may be ThingClass objects or labels.</p> <p>Subclasses of any subclass found in the sequence <code>leaves</code> will be excluded from the returned list, where the elements of <code>leaves</code> may be ThingClass objects or labels.</p> <p>If <code>include_leaves</code> is true, the leaves are included in the returned list, otherwise they are not.</p> <p>If <code>strict_leaves</code> is true, any descendant of a leaf will be excluded in the returned set.</p> <p>If given, <code>exclude</code> may be a sequence of classes, including their subclasses, to exclude from the output.</p> <p>If <code>sort</code> is True, a list sorted according to depth and label will be returned instead of a set.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_branch(  # pylint: disable=too-many-arguments\n    self,\n    root,\n    leaves=(),\n    include_leaves=True,\n    strict_leaves=False,\n    exclude=None,\n    sort=False,\n):\n    \"\"\"Returns a set with all direct and indirect subclasses of `root`.\n    Any subclass found in the sequence `leaves` will be included in\n    the returned list, but its subclasses will not.  The elements\n    of `leaves` may be ThingClass objects or labels.\n\n    Subclasses of any subclass found in the sequence `leaves` will\n    be excluded from the returned list, where the elements of `leaves`\n    may be ThingClass objects or labels.\n\n    If `include_leaves` is true, the leaves are included in the returned\n    list, otherwise they are not.\n\n    If `strict_leaves` is true, any descendant of a leaf will be excluded\n    in the returned set.\n\n    If given, `exclude` may be a sequence of classes, including\n    their subclasses, to exclude from the output.\n\n    If `sort` is True, a list sorted according to depth and label\n    will be returned instead of a set.\n    \"\"\"\n\n    def _branch(root, leaves):\n        if root not in leaves:\n            branch = {\n                root,\n            }\n            for cls in root.subclasses():\n                # Defining a branch is actually quite tricky.  Consider\n                # the case:\n                #\n                #      L isA R\n                #      A isA L\n                #      A isA R\n                #\n                # where R is the root, L is a leaf and A is a direct\n                # child of both.  Logically, since A is a child of the\n                # leaf we want to skip A.  But a strait forward imple-\n                # mentation will see that A is a child of the root and\n                # include it.  Requireing that the R should be a strict\n                # parent of A solves this.\n                if root in cls.get_parents(strict=True):\n                    branch.update(_branch(cls, leaves))\n        else:\n            branch = (\n                {\n                    root,\n                }\n                if include_leaves\n                else set()\n            )\n        return branch\n\n    if isinstance(root, str):\n        root = self.get_by_label(root)\n\n    leaves = set(\n        self.get_by_label(leaf) if isinstance(leaf, str) else leaf\n        for leaf in leaves\n    )\n    leaves.discard(root)\n\n    if exclude:\n        exclude = set(\n            self.get_by_label(e) if isinstance(e, str) else e\n            for e in exclude\n        )\n        leaves.update(exclude)\n\n    branch = _branch(root, leaves)\n\n    # Exclude all descendants of any leaf\n    if strict_leaves:\n        descendants = root.descendants()\n        for leaf in leaves:\n            if leaf in descendants:\n                branch.difference_update(\n                    leaf.descendants(include_self=False)\n                )\n\n    if exclude:\n        branch.difference_update(exclude)\n\n    # Sort according to depth, then by label\n    if sort:\n        branch = sorted(\n            sorted(branch, key=asstring),\n            key=lambda x: len(x.mro()),\n        )\n\n    return branch\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_by_label","title":"<code>get_by_label(self, label, label_annotations=None, prefix=None, imported=True, colon_in_label=None)</code>","text":"<p>Returns entity with label annotation <code>label</code>.</p> <p>Parameters:</p> Name Type Description Default <code>label</code> <code>str</code> <p>label so search for.  May be written as 'label' or 'prefix:label'.  get_by_label('prefix:label') ==  get_by_label('label', prefix='prefix').</p> required <code>label_annotations</code> <code>str</code> <p>a sequence of label annotation names to look up.  Defaults to the <code>label_annotations</code> property.</p> <code>None</code> <code>prefix</code> <code>str</code> <p>if provided, it should be the last component of  the base iri of an ontology (with trailing slash (/) or hash  (#) stripped off).  The search for a matching label will be  limited to this namespace.</p> <code>None</code> <code>imported</code> <code>bool</code> <p>Whether to also look for <code>label</code> in imported ontologies.</p> <code>True</code> <code>colon_in_label</code> <code>bool</code> <p>Whether to accept colon (:) in a label or name-part  of IRI.  Defaults to the <code>colon_in_label</code> property of <code>self</code>.  Setting this true cannot be combined with <code>prefix</code>.</p> <code>None</code> <p>If several entities have the same label, only the one which is found first is returned.Use get_by_label_all() to get all matches.</p> <p>Note, if different prefixes are provided in the label and via the <code>prefix</code> argument a warning will be issued and the <code>prefix</code> argument will take precedence.</p> <p>A NoSuchLabelError is raised if <code>label</code> cannot be found.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_by_label(\n    self,\n    label: str,\n    label_annotations: str = None,\n    prefix: str = None,\n    imported: bool = True,\n    colon_in_label: bool = None,\n):\n    \"\"\"Returns entity with label annotation `label`.\n\n    Arguments:\n       label: label so search for.\n           May be written as 'label' or 'prefix:label'.\n           get_by_label('prefix:label') ==\n           get_by_label('label', prefix='prefix').\n       label_annotations: a sequence of label annotation names to look up.\n           Defaults to the `label_annotations` property.\n       prefix: if provided, it should be the last component of\n           the base iri of an ontology (with trailing slash (/) or hash\n           (#) stripped off).  The search for a matching label will be\n           limited to this namespace.\n       imported: Whether to also look for `label` in imported ontologies.\n       colon_in_label: Whether to accept colon (:) in a label or name-part\n           of IRI.  Defaults to the `colon_in_label` property of `self`.\n           Setting this true cannot be combined with `prefix`.\n\n    If several entities have the same label, only the one which is\n    found first is returned.Use get_by_label_all() to get all matches.\n\n    Note, if different prefixes are provided in the label and via\n    the `prefix` argument a warning will be issued and the\n    `prefix` argument will take precedence.\n\n    A NoSuchLabelError is raised if `label` cannot be found.\n    \"\"\"\n    # pylint: disable=too-many-arguments,too-many-branches,invalid-name\n    if not isinstance(label, str):\n        raise TypeError(\n            f\"Invalid label definition, must be a string: '{label}'\"\n        )\n\n    if label_annotations is None:\n        label_annotations = self.label_annotations\n\n    if colon_in_label is None:\n        colon_in_label = self._colon_in_label\n    if colon_in_label:\n        if prefix:\n            raise ValueError(\n                \"`prefix` cannot be combined with `colon_in_label`\"\n            )\n    else:\n        splitlabel = label.split(\":\", 1)\n        if len(splitlabel) == 2 and not splitlabel[1].startswith(\"//\"):\n            label = splitlabel[1]\n            if prefix and prefix != splitlabel[0]:\n                warnings.warn(\n                    f\"Prefix given both as argument ({prefix}) \"\n                    f\"and in label ({splitlabel[0]}). \"\n                    \"Prefix given in argument takes precedence. \"\n                )\n            if not prefix:\n                prefix = splitlabel[0]\n\n    if prefix:\n        entityset = self.get_by_label_all(\n            label,\n            label_annotations=label_annotations,\n            prefix=prefix,\n        )\n        if len(entityset) == 1:\n            return entityset.pop()\n        if len(entityset) &gt; 1:\n            raise AmbiguousLabelError(\n                f\"Several entities have the same label '{label}' \"\n                f\"with prefix '{prefix}'.\"\n            )\n        raise NoSuchLabelError(\n            f\"No label annotations matches for '{label}' \"\n            f\"with prefix '{prefix}'.\"\n        )\n\n    # Label is a full IRI\n    entity = self.world[label]\n    if entity:\n        return entity\n\n    get_triples = (\n        self.world._get_data_triples_spod_spod\n        if imported\n        else self._get_data_triples_spod_spod\n    )\n\n    for storid in self._to_storids(label_annotations):\n        for s, _, _, _ in get_triples(None, storid, label, None):\n            return self.world[self._unabbreviate(s)]\n\n    # Special labels\n    if self._special_labels and label in self._special_labels:\n        return self._special_labels[label]\n\n    # Check if label is a name under base_iri\n    entity = self.world[self.base_iri + label]\n    if entity:\n        return entity\n\n    # Check label is the name of an entity\n    for entity in self.get_entities(imported=imported):\n        if label == entity.name:\n            return entity\n\n    raise NoSuchLabelError(f\"No label annotations matches '{label}'\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_by_label_all","title":"<code>get_by_label_all(self, label, label_annotations=None, prefix=None, exact_match=False)</code>","text":"<p>Returns set of entities with label annotation <code>label</code>.</p> <p>Parameters:</p> Name Type Description Default <code>label</code> <p>label so search for.  May be written as 'label' or 'prefix:label'.  Wildcard matching  using glob pattern is also supported if <code>exact_match</code> is set to  false.</p> required <code>label_annotations</code> <p>a sequence of label annotation names to look up.  Defaults to the <code>label_annotations</code> property.</p> <code>None</code> <code>prefix</code> <p>if provided, it should be the last component of  the base iri of an ontology (with trailing slash (/) or hash  (#) stripped off).  The search for a matching label will be  limited to this namespace.</p> <code>None</code> <code>exact_match</code> <p>Do not treat \"*\" and brackets as special characters  when matching.  May be useful if your ontology has labels  containing such labels.</p> <code>False</code> <p>Returns:</p> Type Description <code>Set[Optional[owlready2.entity.EntityClass]]</code> <p>Set of all matching entities or an empty set if no matches could be found.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_by_label_all(\n    self,\n    label,\n    label_annotations=None,\n    prefix=None,\n    exact_match=False,\n) -&gt; \"Set[Optional[owlready2.entity.EntityClass]]\":\n    \"\"\"Returns set of entities with label annotation `label`.\n\n    Arguments:\n       label: label so search for.\n           May be written as 'label' or 'prefix:label'.  Wildcard matching\n           using glob pattern is also supported if `exact_match` is set to\n           false.\n       label_annotations: a sequence of label annotation names to look up.\n           Defaults to the `label_annotations` property.\n       prefix: if provided, it should be the last component of\n           the base iri of an ontology (with trailing slash (/) or hash\n           (#) stripped off).  The search for a matching label will be\n           limited to this namespace.\n       exact_match: Do not treat \"*\" and brackets as special characters\n           when matching.  May be useful if your ontology has labels\n           containing such labels.\n\n    Returns:\n        Set of all matching entities or an empty set if no matches\n        could be found.\n    \"\"\"\n    if not isinstance(label, str):\n        raise TypeError(\n            f\"Invalid label definition, \" f\"must be a string: {label!r}\"\n        )\n    if \" \" in label:\n        raise ValueError(\n            f\"Invalid label definition, {label!r} contains spaces.\"\n        )\n\n    if label_annotations is None:\n        label_annotations = self.label_annotations\n\n    entities = set()\n\n    # Check label annotations\n    if exact_match:\n        for storid in self._to_storids(label_annotations):\n            entities.update(\n                self.world._get_by_storid(s)\n                for s, _, _ in self.world._get_data_triples_spod_spod(\n                    None, storid, str(label), None\n                )\n            )\n    else:\n        for storid in self._to_storids(label_annotations):\n            label_entity = self._unabbreviate(storid)\n            key = (\n                label_entity.name\n                if hasattr(label_entity, \"name\")\n                else label_entity\n            )\n            entities.update(self.world.search(**{key: label}))\n\n    if self._special_labels and label in self._special_labels:\n        entities.update(self._special_labels[label])\n\n    # Check name-part of IRI\n    if exact_match:\n        entities.update(\n            ent for ent in self.get_entities() if ent.name == str(label)\n        )\n    else:\n        matches = fnmatch.filter(\n            (ent.name for ent in self.get_entities()), label\n        )\n        entities.update(\n            ent for ent in self.get_entities() if ent.name in matches\n        )\n\n    if prefix:\n        return set(\n            ent\n            for ent in entities\n            if ent.namespace.ontology.prefix == prefix\n        )\n    return entities\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_descendants","title":"<code>get_descendants(self, classes, generations=None, common=False)</code>","text":"<p>Return descendants/subclasses of all classes in <code>classes</code>.</p> <p>Parameters:</p> Name Type Description Default <code>classes</code> <code>Union[List, ThingClass]</code> <p>class(es) for which descendants are desired.</p> required <code>common</code> <code>bool</code> <p>whether to only return descendants common to all classes.</p> <code>False</code> <code>generations</code> <code>int</code> <p>Include this number of generations, default is all.</p> <code>None</code> <p>Returns:</p> Type Description <code>set</code> <p>A set of descendants for given number of generations. If 'common'=True, the common descendants are returned within the specified number of generations. 'generations' defaults to all.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_descendants(\n    self,\n    classes: \"Union[List, ThingClass]\",\n    generations: int = None,\n    common: bool = False,\n) -&gt; set:\n    \"\"\"Return descendants/subclasses of all classes in `classes`.\n    Args:\n        classes: class(es) for which descendants are desired.\n        common: whether to only return descendants common to all classes.\n        generations: Include this number of generations, default is all.\n    Returns:\n        A set of descendants for given number of generations.\n        If 'common'=True, the common descendants are returned\n        within the specified number of generations.\n        'generations' defaults to all.\n    \"\"\"\n\n    if not isinstance(classes, Iterable):\n        classes = [classes]\n\n    descendants = {name: [] for name in classes}\n\n    def _children_recursively(num, newentity, parent, descendants):\n        \"\"\"Helper function to get all children up to generation.\"\"\"\n        for child in self.get_children_of(newentity):\n            descendants[parent].append(child)\n            if num &lt; generations:\n                _children_recursively(num + 1, child, parent, descendants)\n\n    if generations == 0:\n        return set()\n\n    if not generations:\n        for entity in classes:\n            descendants[entity] = entity.descendants()\n            # only include proper descendants\n            descendants[entity].remove(entity)\n    else:\n        for entity in classes:\n            _children_recursively(1, entity, entity, descendants)\n\n    results = descendants.values()\n    if common is True:\n        return set.intersection(*map(set, results))\n    return set(flatten(results))\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_entities","title":"<code>get_entities(self, imported=True, classes=True, individuals=True, object_properties=True, data_properties=True, annotation_properties=True)</code>","text":"<p>Return a generator over (optionally) all classes, individuals, object_properties, data_properties and annotation_properties.</p> <p>If <code>imported</code> is <code>True</code>, entities in imported ontologies will also be included.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_entities(  # pylint: disable=too-many-arguments\n    self,\n    imported=True,\n    classes=True,\n    individuals=True,\n    object_properties=True,\n    data_properties=True,\n    annotation_properties=True,\n):\n    \"\"\"Return a generator over (optionally) all classes, individuals,\n    object_properties, data_properties and annotation_properties.\n\n    If `imported` is `True`, entities in imported ontologies will also\n    be included.\n    \"\"\"\n    generator = []\n    if classes:\n        generator.append(self.classes(imported))\n    if individuals:\n        generator.append(self.individuals(imported))\n    if object_properties:\n        generator.append(self.object_properties(imported))\n    if data_properties:\n        generator.append(self.data_properties(imported))\n    if annotation_properties:\n        generator.append(self.annotation_properties(imported))\n    yield from itertools.chain(*generator)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_graph","title":"<code>get_graph(self, **kwargs)</code>","text":"<p>Returns a new graph object.  See  emmo.graph.OntoGraph.</p> <p>Note that this method requires the Python graphviz package.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_graph(self, **kwargs):\n    \"\"\"Returns a new graph object.  See  emmo.graph.OntoGraph.\n\n    Note that this method requires the Python graphviz package.\n    \"\"\"\n    # pylint: disable=import-outside-toplevel,cyclic-import\n    from ontopy.graph import OntoGraph\n\n    return OntoGraph(self, **kwargs)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_imported_ontologies","title":"<code>get_imported_ontologies(self, recursive=False)</code>","text":"<p>Return a list with imported ontologies.</p> <p>If <code>recursive</code> is <code>True</code>, ontologies imported by imported ontologies are also returned.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_imported_ontologies(self, recursive=False):\n    \"\"\"Return a list with imported ontologies.\n\n    If `recursive` is `True`, ontologies imported by imported ontologies\n    are also returned.\n    \"\"\"\n\n    def rec_imported(onto, imported):\n        for ontology in onto.imported_ontologies:\n            # pylint: disable=possibly-used-before-assignment\n            if ontology not in imported:\n                imported.add(ontology)\n                rec_imported(ontology, imported)\n\n    if recursive:\n        imported = set()\n        rec_imported(self, imported)\n        return list(imported)\n\n    return self.imported_ontologies\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_relations","title":"<code>get_relations(self)</code>","text":"<p>Returns a generator for all relations.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_relations(self):\n    \"\"\"Returns a generator for all relations.\"\"\"\n    warnings.warn(\n        \"Ontology.get_relations() is deprecated. Use \"\n        \"onto.object_properties() instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    return self.object_properties()\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_root_classes","title":"<code>get_root_classes(self, imported=False)</code>","text":"<p>Returns a list or root classes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_root_classes(self, imported=False):\n    \"\"\"Returns a list or root classes.\"\"\"\n    return [\n        cls\n        for cls in self.classes(imported=imported)\n        if not cls.ancestors().difference(set([cls, owlready2.Thing]))\n    ]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_root_data_properties","title":"<code>get_root_data_properties(self, imported=False)</code>","text":"<p>Returns a list of root object properties.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_root_data_properties(self, imported=False):\n    \"\"\"Returns a list of root object properties.\"\"\"\n    props = set(self.data_properties(imported=imported))\n    return [p for p in props if not props.intersection(p.is_a)]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_root_object_properties","title":"<code>get_root_object_properties(self, imported=False)</code>","text":"<p>Returns a list of root object properties.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_root_object_properties(self, imported=False):\n    \"\"\"Returns a list of root object properties.\"\"\"\n    props = set(self.object_properties(imported=imported))\n    return [p for p in props if not props.intersection(p.is_a)]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_roots","title":"<code>get_roots(self, imported=False)</code>","text":"<p>Returns all class, object_property and data_property roots.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_roots(self, imported=False):\n    \"\"\"Returns all class, object_property and data_property roots.\"\"\"\n    roots = self.get_root_classes(imported=imported)\n    roots.extend(self.get_root_object_properties(imported=imported))\n    roots.extend(self.get_root_data_properties(imported=imported))\n    return roots\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_unabbreviated_triples","title":"<code>get_unabbreviated_triples(self, subject=None, predicate=None, obj=None, blank=None)</code>","text":"<p>Returns all matching triples unabbreviated.</p> <p>If <code>blank</code> is given, it will be used to represent blank nodes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_unabbreviated_triples(\n    self, subject=None, predicate=None, obj=None, blank=None\n):\n    \"\"\"Returns all matching triples unabbreviated.\n\n    If `blank` is given, it will be used to represent blank nodes.\n    \"\"\"\n    # pylint: disable=invalid-name\n    return _get_unabbreviated_triples(\n        self, subject=subject, predicate=predicate, obj=obj, blank=blank\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_version","title":"<code>get_version(self, as_iri=False)</code>","text":"<p>Returns the version number of the ontology as inferred from the owl:versionIRI tag or, if owl:versionIRI is not found, from owl:versionINFO.</p> <p>If <code>as_iri</code> is True, the full versionIRI is returned.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_version(self, as_iri=False) -&gt; str:\n    \"\"\"Returns the version number of the ontology as inferred from the\n    owl:versionIRI tag or, if owl:versionIRI is not found, from\n    owl:versionINFO.\n\n    If `as_iri` is True, the full versionIRI is returned.\n    \"\"\"\n    version_iri_storid = self.world._abbreviate(\n        \"http://www.w3.org/2002/07/owl#versionIRI\"\n    )\n    tokens = self.get_triples(s=self.storid, p=version_iri_storid)\n    if (not tokens) and (as_iri is True):\n        raise TypeError(\n            \"No owl:versionIRI \"\n            f\"in Ontology {self.base_iri!r}. \"\n            \"Search for owl:versionInfo with as_iri=False\"\n        )\n    if tokens:\n        _, _, obj = tokens[0]\n        version_iri = self.world._unabbreviate(obj)\n        if as_iri:\n            return version_iri\n        return infer_version(self.base_iri, version_iri)\n\n    version_info_storid = self.world._abbreviate(\n        \"http://www.w3.org/2002/07/owl#versionInfo\"\n    )\n    tokens = self.get_triples(s=self.storid, p=version_info_storid)\n    if not tokens:\n        raise TypeError(\n            \"No versionIRI or versionInfo \" f\"in Ontology {self.base_iri!r}\"\n        )\n    _, _, version_info = tokens[0]\n    return version_info.split(\"^^\")[0].strip('\"')\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.get_wu_palmer_measure","title":"<code>get_wu_palmer_measure(self, cls1, cls2)</code>","text":"<p>Return Wu-Palmer measure for semantic similarity.</p> <p>Returns Wu-Palmer measure for semantic similarity between two concepts. Wu, Palmer; ACL 94: Proceedings of the 32nd annual meeting on Association for Computational Linguistics, June 1994.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_wu_palmer_measure(self, cls1, cls2):\n    \"\"\"Return Wu-Palmer measure for semantic similarity.\n\n    Returns Wu-Palmer measure for semantic similarity between\n    two concepts.\n    Wu, Palmer; ACL 94: Proceedings of the 32nd annual meeting on\n    Association for Computational Linguistics, June 1994.\n    \"\"\"\n    cca = self.closest_common_ancestor(cls1, cls2)\n    ccadepth = self.number_of_generations(cca, self.Thing)\n    generations1 = self.number_of_generations(cls1, cca)\n    generations2 = self.number_of_generations(cls2, cca)\n    return 2 * ccadepth / (generations1 + generations2 + 2 * ccadepth)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.individuals","title":"<code>individuals(self, imported=False)</code>","text":"<p>Returns an generator over all individuals.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def individuals(self, imported=False):\n    \"\"\"Returns an generator over all individuals.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"individuals\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.is_defined","title":"<code>is_defined(self, entity)</code>","text":"<p>Returns true if the entity is a defined class.</p> <p>Deprecated, use the <code>is_defined</code> property of the classes (ThingClass subclasses) instead.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def is_defined(self, entity):\n    \"\"\"Returns true if the entity is a defined class.\n\n    Deprecated, use the `is_defined` property of the classes\n    (ThingClass subclasses) instead.\n    \"\"\"\n    warnings.warn(\n        \"This method is deprecated.  Use the `is_defined` property of \"\n        \"the classes instad.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    if isinstance(entity, str):\n        entity = self.get_by_label(entity)\n    return hasattr(entity, \"equivalent_to\") and bool(entity.equivalent_to)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.is_individual","title":"<code>is_individual(self, entity)</code>","text":"<p>Returns true if entity is an individual.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def is_individual(self, entity):\n    \"\"\"Returns true if entity is an individual.\"\"\"\n    if isinstance(entity, str):\n        entity = self.get_by_label(entity)\n    return isinstance(entity, owlready2.Thing)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.load","title":"<code>load(self, only_local=False, filename=None, format=None, reload=None, reload_if_newer=False, url_from_catalog=None, catalog_file='catalog-v001.xml', emmo_based=True, prefix=None, prefix_emmo=None, **kwargs)</code>","text":"<p>Load the ontology.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.load--arguments","title":"Arguments","text":"<p>bool</p> <p>Whether to only read local files.  This requires that you have appended the path to the ontology to owlready2.onto_path.</p> <p>str</p> <p>Path to file to load the ontology from.  Defaults to <code>base_iri</code> provided to get_ontology().</p> <p>str</p> <p>Format of <code>filename</code>.  Default is inferred from <code>filename</code> extension.</p> <p>bool</p> <p>Whether to reload the ontology if it is already loaded.</p> <p>bool</p> <p>Whether to reload the ontology if the source has changed since last time it was loaded.</p> <p>bool | None</p> <p>Whether to use catalog file to resolve the location of <code>base_iri</code>. If None, the catalog file is used if it exists in the same directory as <code>filename</code>.</p> <p>str</p> <p>Name of Prot\u00e8g\u00e8 catalog file in the same folder as the ontology.  This option is used together with <code>only_local</code> and defaults to \"catalog-v001.xml\".</p> <p>bool</p> <p>Whether this is an EMMO-based ontology or not, default <code>True</code>.</p> <p>prefix: defaults to self.get_namespace.name if</p> <p>bool, default None. If emmo_based is True it</p> <p>defaults to True and sets the prefix of all imported ontologies with base_iri starting with 'http://emmo.info/emmo' to emmo</p> <p>Kwargs</p> <p>Additional keyword arguments are passed on to owlready2.Ontology.load().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def load(  # pylint: disable=too-many-arguments,arguments-renamed\n    self,\n    only_local=False,\n    filename=None,\n    format=None,  # pylint: disable=redefined-builtin\n    reload=None,\n    reload_if_newer=False,\n    url_from_catalog=None,\n    catalog_file=\"catalog-v001.xml\",\n    emmo_based=True,\n    prefix=None,\n    prefix_emmo=None,\n    **kwargs,\n):\n    \"\"\"Load the ontology.\n\n    Arguments\n    ---------\n    only_local: bool\n        Whether to only read local files.  This requires that you\n        have appended the path to the ontology to owlready2.onto_path.\n    filename: str\n        Path to file to load the ontology from.  Defaults to `base_iri`\n        provided to get_ontology().\n    format: str\n        Format of `filename`.  Default is inferred from `filename`\n        extension.\n    reload: bool\n        Whether to reload the ontology if it is already loaded.\n    reload_if_newer: bool\n        Whether to reload the ontology if the source has changed since\n        last time it was loaded.\n    url_from_catalog: bool | None\n        Whether to use catalog file to resolve the location of `base_iri`.\n        If None, the catalog file is used if it exists in the same\n        directory as `filename`.\n    catalog_file: str\n        Name of Prot\u00e8g\u00e8 catalog file in the same folder as the\n        ontology.  This option is used together with `only_local` and\n        defaults to \"catalog-v001.xml\".\n    emmo_based: bool\n        Whether this is an EMMO-based ontology or not, default `True`.\n    prefix: defaults to self.get_namespace.name if\n    prefix_emmo: bool, default None. If emmo_based is True it\n        defaults to True and sets the prefix of all imported ontologies\n        with base_iri starting with 'http://emmo.info/emmo' to emmo\n    kwargs:\n        Additional keyword arguments are passed on to\n        owlready2.Ontology.load().\n    \"\"\"\n    # TODO: make sure that `only_local` argument is respected...\n\n    if self.loaded:\n        return self\n    self._load(\n        only_local=only_local,\n        filename=filename,\n        format=format,\n        reload=reload,\n        reload_if_newer=reload_if_newer,\n        url_from_catalog=url_from_catalog,\n        catalog_file=catalog_file,\n        **kwargs,\n    )\n\n    # Enable optimised search by get_by_label()\n    if self._special_labels is None and emmo_based:\n        top = self.world[\"http://www.w3.org/2002/07/owl#topObjectProperty\"]\n        self._special_labels = {\n            \"Thing\": owlready2.Thing,\n            \"Nothing\": owlready2.Nothing,\n            \"topObjectProperty\": top,\n            \"owl:Thing\": owlready2.Thing,\n            \"owl:Nothing\": owlready2.Nothing,\n            \"owl:topObjectProperty\": top,\n        }\n    # set prefix if another prefix is desired\n    # if we do this, shouldn't we make the name of all\n    # entities of the given ontology to the same?\n    if prefix:\n        self.prefix = prefix\n    else:\n        self.prefix = self.name\n\n    if emmo_based and prefix_emmo is None:\n        prefix_emmo = True\n    if prefix_emmo:\n        self.set_common_prefix()\n\n    return self\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_annotation_property","title":"<code>new_annotation_property(self, name, parent)</code>","text":"<p>Create and return new annotation property.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the annotation property</p> required <code>parent</code> <code>Union[owlready2.annotation.AnnotationPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the annotation property</p> required <p>Returns:</p> Type Description <code>AnnotationPropertyClass</code> <p>the new annotation property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_annotation_property(\n    self, name: str, parent: Union[AnnotationPropertyClass, Iterable]\n) -&gt; AnnotationPropertyClass:\n    \"\"\"Create and return new annotation property.\n\n    Args:\n        name: name of the annotation property\n        parent: parent(s) of the annotation property\n\n    Returns:\n        the new annotation property.\n    \"\"\"\n    return self.new_entity(name, parent, \"annotation_property\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_class","title":"<code>new_class(self, name, parent)</code>","text":"<p>Create and return new class.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the class</p> required <code>parent</code> <code>Union[owlready2.entity.ThingClass, collections.abc.Iterable]</code> <p>parent(s) of the class</p> required <p>Returns:</p> Type Description <code>ThingClass</code> <p>the new class.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_class(\n    self, name: str, parent: Union[ThingClass, Iterable]\n) -&gt; ThingClass:\n    \"\"\"Create and return new class.\n\n    Args:\n        name: name of the class\n        parent: parent(s) of the class\n\n    Returns:\n        the new class.\n    \"\"\"\n    return self.new_entity(name, parent, \"class\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_data_property","title":"<code>new_data_property(self, name, parent)</code>","text":"<p>Create and return new data property.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the data property</p> required <code>parent</code> <code>Union[owlready2.prop.DataPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the data property</p> required <p>Returns:</p> Type Description <code>DataPropertyClass</code> <p>the new data property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_data_property(\n    self, name: str, parent: Union[DataPropertyClass, Iterable]\n) -&gt; DataPropertyClass:\n    \"\"\"Create and return new data property.\n\n    Args:\n        name: name of the data property\n        parent: parent(s) of the data property\n\n    Returns:\n        the new data property.\n    \"\"\"\n    return self.new_entity(name, parent, \"data_property\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_entity","title":"<code>new_entity(self, name, parent, entitytype='class', preflabel=None)</code>","text":"<p>Create and return new entity</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the entity</p> required <code>parent</code> <code>Union[owlready2.entity.ThingClass, owlready2.prop.ObjectPropertyClass, owlready2.prop.DataPropertyClass, owlready2.annotation.AnnotationPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the entity</p> required <code>entitytype</code> <code>Union[str, owlready2.entity.ThingClass, owlready2.prop.ObjectPropertyClass, owlready2.prop.DataPropertyClass, owlready2.annotation.AnnotationPropertyClass]</code> <p>type of the entity, default is 'class' (str) 'ThingClass' (owlready2 Python class). Other options are 'data_property', 'object_property', 'annotation_property' (strings) or the Python classes ObjectPropertyClass, DataPropertyClass and AnnotationProperty classes.</p> <code>'class'</code> <code>preflabel</code> <code>Optional[str]</code> <p>if given, add this as a skos:prefLabel annotation to the new entity.  If None (default), <code>name</code> will be added as prefLabel if skos:prefLabel is in the ontology and listed in <code>self.label_annotations</code>.  Set <code>preflabel</code> to False, to avoid assigning a prefLabel.</p> <code>None</code> <p>Returns:</p> Type Description <code>Union[owlready2.entity.ThingClass, owlready2.prop.ObjectPropertyClass, owlready2.prop.DataPropertyClass, owlready2.annotation.AnnotationPropertyClass]</code> <p>the new entity.</p> <p>Throws exception if name consists of more than one word, if type is not one of the allowed types, or if parent is not of the correct type. By default, the parent is Thing.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_entity(\n    self,\n    name: str,\n    parent: Union[\n        ThingClass,\n        ObjectPropertyClass,\n        DataPropertyClass,\n        AnnotationPropertyClass,\n        Iterable,\n    ],\n    entitytype: Optional[\n        Union[\n            str,\n            ThingClass,\n            ObjectPropertyClass,\n            DataPropertyClass,\n            AnnotationPropertyClass,\n        ]\n    ] = \"class\",\n    preflabel: Optional[str] = None,\n) -&gt; Union[\n    ThingClass,\n    ObjectPropertyClass,\n    DataPropertyClass,\n    AnnotationPropertyClass,\n]:\n    \"\"\"Create and return new entity\n\n    Args:\n        name: name of the entity\n        parent: parent(s) of the entity\n        entitytype: type of the entity,\n            default is 'class' (str) 'ThingClass' (owlready2 Python class).\n            Other options\n            are 'data_property', 'object_property',\n            'annotation_property' (strings) or the\n            Python classes ObjectPropertyClass,\n            DataPropertyClass and AnnotationProperty classes.\n        preflabel: if given, add this as a skos:prefLabel annotation\n            to the new entity.  If None (default), `name` will\n            be added as prefLabel if skos:prefLabel is in the ontology\n            and listed in `self.label_annotations`.  Set `preflabel` to\n            False, to avoid assigning a prefLabel.\n\n    Returns:\n        the new entity.\n\n    Throws exception if name consists of more than one word, if type is not\n    one of the allowed types, or if parent is not of the correct type.\n    By default, the parent is Thing.\n\n    \"\"\"\n    # pylint: disable=invalid-name\n    if \" \" in name:\n        raise LabelDefinitionError(\n            f\"Error in label name definition '{name}': \"\n            f\"Label consists of more than one word.\"\n        )\n    parents = tuple(parent) if isinstance(parent, Iterable) else (parent,)\n    if entitytype == \"class\":\n        parenttype = owlready2.ThingClass\n    elif entitytype == \"data_property\":\n        parenttype = owlready2.DataPropertyClass\n    elif entitytype == \"object_property\":\n        parenttype = owlready2.ObjectPropertyClass\n    elif entitytype == \"annotation_property\":\n        parenttype = owlready2.AnnotationPropertyClass\n    elif entitytype in [\n        ThingClass,\n        ObjectPropertyClass,\n        DataPropertyClass,\n        AnnotationPropertyClass,\n    ]:\n        parenttype = entitytype\n    else:\n        raise EntityClassDefinitionError(\n            f\"Error in entity type definition: \"\n            f\"'{entitytype}' is not a valid entity type.\"\n        )\n    for thing in parents:\n        if not isinstance(thing, parenttype):\n            raise EntityClassDefinitionError(\n                f\"Error in parent definition: \"\n                f\"'{thing}' is not an {parenttype}.\"\n            )\n\n    with self:\n        entity = types.new_class(name, parents)\n\n        preflabel_iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n        if preflabel:\n            if not self.world[preflabel_iri]:\n                pref_label = self.new_annotation_property(\n                    \"prefLabel\",\n                    parent=[owlready2.AnnotationProperty],\n                )\n                pref_label.iri = preflabel_iri\n            entity.prefLabel = english(preflabel)\n        elif (\n            preflabel is None\n            and preflabel_iri in self.label_annotations\n            and self.world[preflabel_iri]\n        ):\n            entity.prefLabel = english(name)\n\n    return entity\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.new_object_property","title":"<code>new_object_property(self, name, parent)</code>","text":"<p>Create and return new object property.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>name of the object property</p> required <code>parent</code> <code>Union[owlready2.prop.ObjectPropertyClass, collections.abc.Iterable]</code> <p>parent(s) of the object property</p> required <p>Returns:</p> Type Description <code>ObjectPropertyClass</code> <p>the new object property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def new_object_property(\n    self, name: str, parent: Union[ObjectPropertyClass, Iterable]\n) -&gt; ObjectPropertyClass:\n    \"\"\"Create and return new object property.\n\n    Args:\n        name: name of the object property\n        parent: parent(s) of the object property\n\n    Returns:\n        the new object property.\n    \"\"\"\n    return self.new_entity(name, parent, \"object_property\")\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.number_of_generations","title":"<code>number_of_generations(self, descendant, ancestor)</code>","text":"<p>Return shortest distance from ancestor to descendant</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def number_of_generations(self, descendant, ancestor):\n    \"\"\"Return shortest distance from ancestor to descendant\"\"\"\n    if ancestor not in descendant.ancestors():\n        raise ValueError(\"Descendant is not a descendant of ancestor\")\n    return self._number_of_generations(descendant, ancestor, 0)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.object_properties","title":"<code>object_properties(self, imported=False)</code>","text":"<p>Returns an generator over all object_properties.</p> <p>Parameters:</p> Name Type Description Default <code>imported</code> <p>if <code>True</code>, entities in imported ontologies are also returned.</p> <code>False</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def object_properties(self, imported=False):\n    \"\"\"Returns an generator over all object_properties.\n\n    Arguments:\n        imported: if `True`, entities in imported ontologies\n            are also returned.\n    \"\"\"\n    return self._entities(\"object_properties\", imported=imported)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.remove_label_annotation","title":"<code>remove_label_annotation(self, iri)</code>","text":"<p>Removes label annotation used by get_by_label().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def remove_label_annotation(self, iri):\n    \"\"\"Removes label annotation used by get_by_label().\"\"\"\n    warnings.warn(\n        \"Ontology.remove_label_annotations() is deprecated. \"\n        \"Direct modify the `label_annotations` attribute instead.\",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    if hasattr(iri, \"iri\"):\n        iri = iri.iri\n    try:\n        self.label_annotations.remove(iri)\n    except ValueError:\n        pass\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.rename_entities","title":"<code>rename_entities(self, annotations=('prefLabel', 'label', 'altLabel'))</code>","text":"<p>Set <code>name</code> of all entities to the first non-empty annotation in <code>annotations</code>.</p> <p>Warning, this method changes all IRIs in the ontology.  However, it may be useful to make the ontology more readable and to work with it together with a triple store.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def rename_entities(\n    self,\n    annotations=(\"prefLabel\", \"label\", \"altLabel\"),\n):\n    \"\"\"Set `name` of all entities to the first non-empty annotation in\n    `annotations`.\n\n    Warning, this method changes all IRIs in the ontology.  However,\n    it may be useful to make the ontology more readable and to work\n    with it together with a triple store.\n    \"\"\"\n    for entity in self.get_entities():\n        for annotation in annotations:\n            if hasattr(entity, annotation):\n                name = getattr(entity, annotation).first()\n                if name:\n                    entity.name = name\n                    break\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.save","title":"<code>save(self, filename=None, format=None, dir='.', mkdir=False, overwrite=False, recursive=False, squash=False, write_catalog_file=False, append_catalog=False, catalog_file='catalog-v001.xml', **kwargs)</code>","text":"<p>Writes the ontology to file.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.save--parameters","title":"Parameters","text":"<p>None | str | Path</p> <p>Name of file to write to.  If None, it defaults to the name of the ontology with <code>format</code> as file extension.</p> <p>str</p> <p>Output format. The default is to infer it from <code>filename</code>.</p> <p>str | Path</p> <p>If <code>filename</code> is a relative path, it is a relative path to <code>dir</code>.</p> <p>bool</p> <p>Whether to create output directory if it does not exists.</p> <p>bool</p> <p>If true and <code>filename</code> exists, remove the existing file before saving.  The default is to append to an existing ontology.</p> <p>bool</p> <p>Whether to save imported ontologies recursively.  This is commonly combined with <code>filename=None</code>, <code>dir</code> and <code>mkdir</code>. Note that depending on the structure of the ontology and all imports the ontology might end up in a subdirectory. If filename is given, the ontology is saved to the given directory. The path to the final location is returned.</p> <p>bool</p> <p>If true, rdflib will be used to save the current ontology together with all its sub-ontologies into <code>filename</code>. It makes no sense to combine this with <code>recursive</code>.</p> <p>bool</p> <p>Whether to also write a catalog file to disk.</p> <p>bool</p> <p>Whether to append to an existing catalog file.</p> <p>str | Path</p> <p>Name of catalog file.  If not an absolute path, it is prepended to <code>dir</code>.</p>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.save--returns","title":"Returns","text":"<pre><code>The path to the saved ontology.\n</code></pre> Source code in <code>ontopy/ontology.py</code> <pre><code>def save(\n    self,\n    filename=None,\n    format=None,\n    dir=\".\",\n    mkdir=False,\n    overwrite=False,\n    recursive=False,\n    squash=False,\n    write_catalog_file=False,\n    append_catalog=False,\n    catalog_file=\"catalog-v001.xml\",\n    **kwargs,\n) -&gt; Path:\n    \"\"\"Writes the ontology to file.\n\n    Parameters\n    ----------\n    filename: None | str | Path\n        Name of file to write to.  If None, it defaults to the name\n        of the ontology with `format` as file extension.\n    format: str\n        Output format. The default is to infer it from `filename`.\n    dir: str | Path\n        If `filename` is a relative path, it is a relative path to `dir`.\n    mkdir: bool\n        Whether to create output directory if it does not exists.\n    owerwrite: bool\n        If true and `filename` exists, remove the existing file before\n        saving.  The default is to append to an existing ontology.\n    recursive: bool\n        Whether to save imported ontologies recursively.  This is\n        commonly combined with `filename=None`, `dir` and `mkdir`.\n        Note that depending on the structure of the ontology and\n        all imports the ontology might end up in a subdirectory.\n        If filename is given, the ontology is saved to the given\n        directory.\n        The path to the final location is returned.\n    squash: bool\n        If true, rdflib will be used to save the current ontology\n        together with all its sub-ontologies into `filename`.\n        It makes no sense to combine this with `recursive`.\n    write_catalog_file: bool\n        Whether to also write a catalog file to disk.\n    append_catalog: bool\n        Whether to append to an existing catalog file.\n    catalog_file: str | Path\n        Name of catalog file.  If not an absolute path, it is prepended\n        to `dir`.\n\n    Returns\n    --------\n        The path to the saved ontology.\n    \"\"\"\n    # pylint: disable=redefined-builtin,too-many-arguments\n    # pylint: disable=too-many-statements,too-many-branches\n    # pylint: disable=too-many-locals,arguments-renamed,invalid-name\n\n    if not _validate_installed_version(\n        package=\"rdflib\", min_version=\"6.0.0\"\n    ) and format == FMAP.get(\"ttl\", \"\"):\n        from rdflib import (  # pylint: disable=import-outside-toplevel\n            __version__ as __rdflib_version__,\n        )\n\n        warnings.warn(\n            IncompatibleVersion(\n                \"To correctly convert to Turtle format, rdflib must be \"\n                \"version 6.0.0 or greater, however, the detected rdflib \"\n                \"version used by your Python interpreter is \"\n                f\"{__rdflib_version__!r}. For more information see the \"\n                \"'Known issues' section of the README.\"\n            )\n        )\n    revmap = {value: key for key, value in FMAP.items()}\n    if filename is None:\n        if format:\n            fmt = revmap.get(format, format)\n            file = f\"{self.name}.{fmt}\"\n        else:\n            raise TypeError(\"`filename` and `format` cannot both be None.\")\n    else:\n        file = filename\n    filepath = os.path.join(\n        dir, file if isinstance(file, (str, Path)) else file.name\n    )\n    returnpath = filepath\n\n    dir = Path(filepath).resolve().parent\n\n    if mkdir:\n        outdir = Path(filepath).parent.resolve()\n        if not outdir.exists():\n            outdir.mkdir(parents=True)\n\n    if not format:\n        format = guess_format(file, fmap=FMAP)\n    fmt = revmap.get(format, format)\n\n    if overwrite and os.path.exists(filepath):\n        os.remove(filepath)\n\n    if recursive:\n        if squash:\n            raise ValueError(\n                \"`recursive` and `squash` should not both be true\"\n            )\n        layout = directory_layout(self)\n        if filename:\n            layout[self] = file.rstrip(f\".{fmt}\")\n        # Update path to where the ontology is saved\n        # Note that filename should include format\n        # when given\n        returnpath = Path(dir) / f\"{layout[self]}.{fmt}\"\n        for onto, path in layout.items():\n            fname = Path(dir) / f\"{path}.{fmt}\"\n            onto.save(\n                filename=fname,\n                format=format,\n                dir=dir,\n                mkdir=mkdir,\n                overwrite=overwrite,\n                recursive=False,\n                squash=False,\n                write_catalog_file=False,\n                **kwargs,\n            )\n\n        if write_catalog_file:\n            catalog_files = set()\n            irimap = {}\n            for onto, path in layout.items():\n                irimap[onto.get_version(as_iri=True)] = (\n                    f\"{dir}/{path}.{fmt}\"\n                )\n                catalog_files.add(Path(path).parent / catalog_file)\n\n            for catfile in catalog_files:\n                write_catalog(\n                    irimap.copy(),\n                    output=catfile,\n                    directory=dir,\n                    append=append_catalog,\n                )\n    elif squash:\n        URIRef, RDF, OWL = rdflib.URIRef, rdflib.RDF, rdflib.OWL\n\n        # Make a copy of the owlready2 graph object to not mess with\n        # owlready2 internals\n        graph = rdflib.Graph()\n        for triple in self.world.as_rdflib_graph():\n            graph.add(triple)\n\n        # Add common namespaces unknown to rdflib\n        extra_namespaces = [\n            (\"\", self.base_iri),\n            (\"swrl\", \"http://www.w3.org/2003/11/swrl#\"),\n            (\"bibo\", \"http://purl.org/ontology/bibo/\"),\n        ]\n        for prefix, iri in extra_namespaces:\n            graph.namespace_manager.bind(\n                prefix, rdflib.Namespace(iri), override=False\n            )\n\n        # Remove all ontology-declarations in the graph that are\n        # not the current ontology.\n        for s, _, _ in graph.triples(  # pylint: disable=not-an-iterable\n            (None, RDF.type, OWL.Ontology)\n        ):\n            if str(s).rstrip(\"/#\") != self.base_iri.rstrip(\"/#\"):\n                for (\n                    _,\n                    p,\n                    o,\n                ) in graph.triples(  # pylint: disable=not-an-iterable\n                    (s, None, None)\n                ):\n                    graph.remove((s, p, o))\n            graph.remove((s, OWL.imports, None))\n\n        # Insert correct IRI of the ontology\n        if self.iri:\n            base_iri = URIRef(self.base_iri)\n            for s, p, o in graph.triples(  # pylint: disable=not-an-iterable\n                (base_iri, None, None)\n            ):\n                graph.remove((s, p, o))\n                graph.add((URIRef(self.iri), p, o))\n\n        graph.serialize(destination=filepath, format=format)\n    elif format in OWLREADY2_FORMATS:\n        super().save(file=filepath, format=fmt, **kwargs)\n    else:\n        # The try-finally clause is needed for cleanup and because\n        # we have to provide delete=False to NamedTemporaryFile\n        # since Windows does not allow to reopen an already open\n        # file.\n        try:\n            with tempfile.NamedTemporaryFile(\n                suffix=\".owl\", delete=False\n            ) as handle:\n                tmpfile = handle.name\n            super().save(tmpfile, format=\"ntriples\", **kwargs)\n            graph = rdflib.Graph()\n            graph.parse(tmpfile, format=\"ntriples\")\n            graph.namespace_manager.bind(\n                \"\", rdflib.Namespace(self.base_iri)\n            )\n            if self.iri:\n                base_iri = rdflib.URIRef(self.base_iri)\n                for (\n                    s,\n                    p,\n                    o,\n                ) in graph.triples(  # pylint: disable=not-an-iterable\n                    (base_iri, None, None)\n                ):\n                    graph.remove((s, p, o))\n                    graph.add((rdflib.URIRef(self.iri), p, o))\n            graph.serialize(destination=filepath, format=format)\n        finally:\n            os.remove(tmpfile)\n\n    if write_catalog_file and not recursive:\n        write_catalog(\n            {self.get_version(as_iri=True): filepath},\n            output=catalog_file,\n            directory=dir,\n            append=append_catalog,\n        )\n    return Path(returnpath)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.set_common_prefix","title":"<code>set_common_prefix(self, iri_base='http://emmo.info/emmo', prefix='emmo', visited=None)</code>","text":"<p>Set a common prefix for all imported ontologies with the same first part of the base_iri.</p> <p>Parameters:</p> Name Type Description Default <code>iri_base</code> <code>str</code> <p>The start of the base_iri to look for. Defaults to the emmo base_iri http://emmo.info/emmo</p> <code>'http://emmo.info/emmo'</code> <code>prefix</code> <code>str</code> <p>the desired prefix. Defaults to emmo.</p> <code>'emmo'</code> <code>visited</code> <code>Optional[Set]</code> <p>Ontologies to skip. Only intended for internal use.</p> <code>None</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def set_common_prefix(\n    self,\n    iri_base: str = \"http://emmo.info/emmo\",\n    prefix: str = \"emmo\",\n    visited: \"Optional[Set]\" = None,\n) -&gt; None:\n    \"\"\"Set a common prefix for all imported ontologies\n    with the same first part of the base_iri.\n\n    Args:\n        iri_base: The start of the base_iri to look for. Defaults to\n            the emmo base_iri http://emmo.info/emmo\n        prefix: the desired prefix. Defaults to emmo.\n        visited: Ontologies to skip. Only intended for internal use.\n    \"\"\"\n    if visited is None:\n        visited = set()\n    if self.base_iri.startswith(iri_base):\n        self.prefix = prefix\n    for onto in self.imported_ontologies:\n        if not onto in visited:\n            visited.add(onto)\n            onto.set_common_prefix(\n                iri_base=iri_base, prefix=prefix, visited=visited\n            )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.set_default_label_annotations","title":"<code>set_default_label_annotations(self)</code>","text":"<p>Sets the default label annotations.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def set_default_label_annotations(self):\n    \"\"\"Sets the default label annotations.\"\"\"\n    warnings.warn(\n        \"Ontology.set_default_label_annotations() is deprecated. \"\n        \"Default label annotations are set by Ontology.__init__(). \",\n        DeprecationWarning,\n        stacklevel=2,\n    )\n    self.label_annotations = DEFAULT_LABEL_ANNOTATIONS[:]\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.set_version","title":"<code>set_version(self, version=None, version_iri=None)</code>","text":"<p>Assign version to ontology by asigning owl:versionIRI.</p> <p>If <code>version</code> but not <code>version_iri</code> is provided, the version IRI will be the combination of <code>base_iri</code> and <code>version</code>.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def set_version(self, version=None, version_iri=None):\n    \"\"\"Assign version to ontology by asigning owl:versionIRI.\n\n    If `version` but not `version_iri` is provided, the version\n    IRI will be the combination of `base_iri` and `version`.\n    \"\"\"\n    _version_iri = \"http://www.w3.org/2002/07/owl#versionIRI\"\n    version_iri_storid = self.world._abbreviate(_version_iri)\n    if self._has_obj_triple_spo(  # pylint: disable=unexpected-keyword-arg\n        # For some reason _has_obj_triples_spo exists in both\n        # owlready2.namespace.Namespace (with arguments subject/predicate)\n        # and in owlready2.triplelite._GraphManager (with arguments s/p)\n        # owlready2.Ontology inherits from Namespace directly\n        # and pylint checks that.\n        # It actually accesses the one in triplelite.\n        # subject=self.storid, predicate=version_iri_storid\n        s=self.storid,\n        p=version_iri_storid,\n    ):\n        self._del_obj_triple_spo(s=self.storid, p=version_iri_storid)\n\n    if not version_iri:\n        if not version:\n            raise TypeError(\n                \"Either `version` or `version_iri` must be provided\"\n            )\n        head, tail = self.base_iri.rstrip(\"#/\").rsplit(\"/\", 1)\n        version_iri = \"/\".join([head, version, tail])\n\n    self._add_obj_triple_spo(\n        s=self.storid,\n        p=self.world._abbreviate(_version_iri),\n        o=self.world._abbreviate(version_iri),\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.sync_attributes","title":"<code>sync_attributes(self, name_policy=None, name_prefix='', class_docstring='comment', sync_imported=False)</code>","text":"<p>This method is intended to be called after you have added new classes (typically via Python) to make sure that attributes like <code>label</code> and <code>comments</code> are defined.</p> <p>If a class, object property, data property or annotation property in the current ontology has no label, the name of the corresponding Python class will be assigned as label.</p> <p>If a class, object property, data property or annotation property has no comment, it will be assigned the docstring of the corresponding Python class.</p> <p><code>name_policy</code> specify wether and how the names in the ontology should be updated.  Valid values are:   None          not changed   \"uuid\"        <code>name_prefix</code> followed by a global unique id (UUID).                 If the name is already valid accoridng to this standard                 it will not be regenerated.   \"sequential\"  <code>name_prefix</code> followed a sequantial number. EMMO conventions imply <code>name_policy=='uuid'</code>.</p> <p>If <code>sync_imported</code> is true, all imported ontologies are also updated.</p> <p>The <code>class_docstring</code> argument specifies the annotation that class docstrings are mapped to.  Defaults to \"comment\".</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def sync_attributes(  # pylint: disable=too-many-branches\n    self,\n    name_policy=None,\n    name_prefix=\"\",\n    class_docstring=\"comment\",\n    sync_imported=False,\n):\n    \"\"\"This method is intended to be called after you have added new\n    classes (typically via Python) to make sure that attributes like\n    `label` and `comments` are defined.\n\n    If a class, object property, data property or annotation\n    property in the current ontology has no label, the name of\n    the corresponding Python class will be assigned as label.\n\n    If a class, object property, data property or annotation\n    property has no comment, it will be assigned the docstring of\n    the corresponding Python class.\n\n    `name_policy` specify wether and how the names in the ontology\n    should be updated.  Valid values are:\n      None          not changed\n      \"uuid\"        `name_prefix` followed by a global unique id (UUID).\n                    If the name is already valid accoridng to this standard\n                    it will not be regenerated.\n      \"sequential\"  `name_prefix` followed a sequantial number.\n    EMMO conventions imply ``name_policy=='uuid'``.\n\n    If `sync_imported` is true, all imported ontologies are also\n    updated.\n\n    The `class_docstring` argument specifies the annotation that\n    class docstrings are mapped to.  Defaults to \"comment\".\n    \"\"\"\n    for cls in itertools.chain(\n        self.classes(),\n        self.object_properties(),\n        self.data_properties(),\n        self.annotation_properties(),\n    ):\n        if not hasattr(cls, \"prefLabel\"):\n            # no prefLabel - create new annotation property..\n            with self:\n                # pylint: disable=invalid-name,missing-class-docstring\n                # pylint: disable=unused-variable\n                class prefLabel(owlready2.label):\n                    pass\n\n            cls.prefLabel = [locstr(cls.__name__, lang=\"en\")]\n        elif not cls.prefLabel:\n            cls.prefLabel.append(locstr(cls.__name__, lang=\"en\"))\n        if class_docstring and hasattr(cls, \"__doc__\") and cls.__doc__:\n            getattr(cls, class_docstring).append(\n                locstr(inspect.cleandoc(cls.__doc__), lang=\"en\")\n            )\n\n    for ind in self.individuals():\n        if not hasattr(ind, \"prefLabel\"):\n            # no prefLabel - create new annotation property..\n            with self:\n                # pylint: disable=invalid-name,missing-class-docstring\n                # pylint: disable=function-redefined\n                class prefLabel(owlready2.label):\n                    iri = \"http://www.w3.org/2004/02/skos/core#prefLabel\"\n\n            ind.prefLabel = [locstr(ind.name, lang=\"en\")]\n        elif not ind.prefLabel:\n            ind.prefLabel.append(locstr(ind.name, lang=\"en\"))\n\n    chain = itertools.chain(\n        self.classes(),\n        self.individuals(),\n        self.object_properties(),\n        self.data_properties(),\n        self.annotation_properties(),\n    )\n    if name_policy == \"uuid\":\n        for obj in chain:\n            try:\n                # Passing the following means that the name is valid\n                # and need not be regenerated.\n                if not obj.name.startswith(name_prefix):\n                    raise ValueError\n                uuid.UUID(obj.name.lstrip(name_prefix), version=5)\n            except ValueError:\n                obj.name = name_prefix + str(\n                    uuid.uuid5(uuid.NAMESPACE_DNS, obj.name)\n                )\n    elif name_policy == \"sequential\":\n        for obj in chain:\n            counter = 0\n            while f\"{self.base_iri}{name_prefix}{counter}\" in self:\n                counter += 1\n            obj.name = f\"{name_prefix}{counter}\"\n    elif name_policy is not None:\n        raise TypeError(f\"invalid name_policy: {name_policy!r}\")\n\n    if sync_imported:\n        for onto in self.imported_ontologies:\n            onto.sync_attributes()\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.sync_python_names","title":"<code>sync_python_names(self, annotations=('prefLabel', 'label', 'altLabel'))</code>","text":"<p>Update the <code>python_name</code> attribute of all properties.</p> <p>The python_name attribute will be set to the first non-empty annotation in the sequence of annotations in <code>annotations</code> for the property.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def sync_python_names(self, annotations=(\"prefLabel\", \"label\", \"altLabel\")):\n    \"\"\"Update the `python_name` attribute of all properties.\n\n    The python_name attribute will be set to the first non-empty\n    annotation in the sequence of annotations in `annotations` for\n    the property.\n    \"\"\"\n\n    def update(gen):\n        for prop in gen:\n            for annotation in annotations:\n                if hasattr(prop, annotation) and getattr(prop, annotation):\n                    prop.python_name = getattr(prop, annotation).first()\n                    break\n\n    update(\n        self.get_entities(\n            classes=False,\n            individuals=False,\n            object_properties=False,\n            data_properties=False,\n        )\n    )\n    update(\n        self.get_entities(\n            classes=False, individuals=False, annotation_properties=False\n        )\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.Ontology.sync_reasoner","title":"<code>sync_reasoner(self, reasoner='HermiT', include_imported=False, **kwargs)</code>","text":"<p>Update current ontology by running the given reasoner.</p> <p>Supported values for <code>reasoner</code> are 'HermiT' (default), Pellet and 'FaCT++'.</p> <p>If <code>include_imported</code> is true, the reasoner will also reason over imported ontologies.  Note that this may be very slow.</p> <p>Keyword arguments are passed to the underlying owlready2 function.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def sync_reasoner(\n    self, reasoner=\"HermiT\", include_imported=False, **kwargs\n):\n    \"\"\"Update current ontology by running the given reasoner.\n\n    Supported values for `reasoner` are 'HermiT' (default), Pellet\n    and 'FaCT++'.\n\n    If `include_imported` is true, the reasoner will also reason\n    over imported ontologies.  Note that this may be **very** slow.\n\n    Keyword arguments are passed to the underlying owlready2 function.\n    \"\"\"\n    # pylint: disable=too-many-branches\n\n    removed_equivalent = defaultdict(list)\n    removed_subclasses = defaultdict(list)\n\n    if reasoner == \"FaCT++\":\n        sync = sync_reasoner_factpp\n    elif reasoner == \"Pellet\":\n        sync = owlready2.sync_reasoner_pellet\n    elif reasoner == \"HermiT\":\n        sync = owlready2.sync_reasoner_hermit\n\n        # Remove custom data propertyes, otherwise HermiT will crash\n        datatype_iri = \"http://www.w3.org/2000/01/rdf-schema#Datatype\"\n\n        for cls in self.classes(imported=include_imported):\n            remove_eq = []\n            for i, r in enumerate(cls.equivalent_to):\n                if isinstance(r, owlready2.Restriction):\n                    if (\n                        hasattr(r.value.__class__, \"iri\")\n                        and r.value.__class__.iri == datatype_iri\n                    ):\n                        remove_eq.append(i)\n                        removed_equivalent[cls].append(r)\n            for i in reversed(remove_eq):\n                del cls.equivalent_to[i]\n\n            remove_subcls = []\n            for i, r in enumerate(cls.is_a):\n                if isinstance(r, owlready2.Restriction):\n                    if (\n                        hasattr(r.value.__class__, \"iri\")\n                        and r.value.__class__.iri == datatype_iri\n                    ):\n                        remove_subcls.append(i)\n                        removed_subclasses[cls].append(r)\n            for i in reversed(remove_subcls):\n                del cls.is_a[i]\n\n    else:\n        raise ValueError(\n            f\"Unknown reasoner '{reasoner}'. Supported reasoners \"\n            \"are 'Pellet', 'HermiT' and 'FaCT++'.\"\n        )\n\n    # For some reason we must visit all entities once before running\n    # the reasoner...\n    list(self.get_entities())\n\n    with self:\n        if include_imported:\n            sync(self.world, **kwargs)\n        else:\n            sync(self, **kwargs)\n\n    # Restore removed custom data properties\n    for cls, eqs in removed_equivalent.items():\n        cls.extend(eqs)\n    for cls, subcls in removed_subclasses.items():\n        cls.extend(subcls)\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.World","title":"<code> World            (World)         </code>","text":"<p>A subclass of owlready2.World.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>class World(owlready2.World):\n    \"\"\"A subclass of owlready2.World.\"\"\"\n\n    def __init__(self, *args, **kwargs):\n        # Caches stored in the world\n        self._cached_catalogs = {}  # maps url to (mtime, iris, dirs)\n        self._iri_mappings = {}  # all iri mappings loaded so far\n        super().__init__(*args, **kwargs)\n\n    def get_ontology(\n        self,\n        base_iri: str = \"emmo-inferred\",\n        OntologyClass: \"owlready2.Ontology\" = None,\n        label_annotations: \"Sequence\" = None,\n    ) -&gt; \"Ontology\":\n        # pylint: disable=too-many-branches\n        \"\"\"Returns a new Ontology from `base_iri`.\n\n        Arguments:\n            base_iri: The base IRI of the ontology. May be one of:\n                - valid URL (possible excluding final .owl or .ttl)\n                - file name (possible excluding final .owl or .ttl)\n                - \"emmo\": load latest version of asserted EMMO\n                - \"emmo-inferred\": load latest version of inferred EMMO\n                  (default)\n                - \"emmo-development\": load latest inferred development\n                  version of EMMO. Until first stable release\n                  emmo-inferred and emmo-development will be the same.\n            OntologyClass: If given and `base_iri` doesn't correspond\n                to an existing ontology, a new ontology is created of\n                this Ontology subclass.  Defaults to `ontopy.Ontology`.\n            label_annotations: Sequence of label IRIs used for accessing\n                entities in the ontology given that they are in the ontology.\n                Label IRIs not in the ontology will need to be added to\n                ontologies in order to be accessible.\n                Defaults to DEFAULT_LABEL_ANNOTATIONS if set to None.\n        \"\"\"\n        base_iri = base_iri.as_uri() if isinstance(base_iri, Path) else base_iri\n\n        if base_iri == \"emmo\":\n            base_iri = (\n                \"http://emmo-repo.github.io/versions/1.0.0-beta4/emmo.ttl\"\n            )\n        elif base_iri == \"emmo-inferred\":\n            base_iri = (\n                \"https://emmo-repo.github.io/versions/1.0.0-beta4/\"\n                \"emmo-inferred.ttl\"\n            )\n        elif base_iri == \"emmo-development\":\n            base_iri = (\n                \"https://emmo-repo.github.io/versions/1.0.0-beta5/\"\n                \"emmo-inferred.ttl\"\n            )\n\n        if base_iri in self.ontologies:\n            onto = self.ontologies[base_iri]\n        elif base_iri + \"#\" in self.ontologies:\n            onto = self.ontologies[base_iri + \"#\"]\n        elif base_iri + \"/\" in self.ontologies:\n            onto = self.ontologies[base_iri + \"/\"]\n        else:\n            if os.path.exists(base_iri):\n                iri = os.path.abspath(base_iri)\n            elif os.path.exists(base_iri + \".ttl\"):\n                iri = os.path.abspath(base_iri + \".ttl\")\n            elif os.path.exists(base_iri + \".owl\"):\n                iri = os.path.abspath(base_iri + \".owl\")\n            else:\n                iri = base_iri\n\n            if iri[-1] not in \"/#\":\n                iri += \"#\"\n\n            if OntologyClass is None:\n                OntologyClass = Ontology\n\n            onto = OntologyClass(self, iri)\n\n        if label_annotations:\n            onto.label_annotations = list(label_annotations)\n\n        return onto\n\n    def get_unabbreviated_triples(\n        self, subject=None, predicate=None, obj=None, blank=None\n    ):\n        # pylint: disable=invalid-name\n        \"\"\"Returns all triples unabbreviated.\n\n        If any of the `subject`, `predicate` or `obj` arguments are given,\n        only matching triples will be returned.\n\n        If `blank` is given, it will be used to represent blank nodes.\n        \"\"\"\n        return _get_unabbreviated_triples(\n            self, subject=subject, predicate=predicate, obj=obj, blank=blank\n        )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.World.get_ontology","title":"<code>get_ontology(self, base_iri='emmo-inferred', OntologyClass=None, label_annotations=None)</code>","text":"<p>Returns a new Ontology from <code>base_iri</code>.</p> <p>Parameters:</p> Name Type Description Default <code>base_iri</code> <code>str</code> <p>The base IRI of the ontology. May be one of: - valid URL (possible excluding final .owl or .ttl) - file name (possible excluding final .owl or .ttl) - \"emmo\": load latest version of asserted EMMO - \"emmo-inferred\": load latest version of inferred EMMO   (default) - \"emmo-development\": load latest inferred development   version of EMMO. Until first stable release   emmo-inferred and emmo-development will be the same.</p> <code>'emmo-inferred'</code> <code>OntologyClass</code> <code>owlready2.Ontology</code> <p>If given and <code>base_iri</code> doesn't correspond to an existing ontology, a new ontology is created of this Ontology subclass.  Defaults to <code>ontopy.Ontology</code>.</p> <code>None</code> <code>label_annotations</code> <code>Sequence</code> <p>Sequence of label IRIs used for accessing entities in the ontology given that they are in the ontology. Label IRIs not in the ontology will need to be added to ontologies in order to be accessible. Defaults to DEFAULT_LABEL_ANNOTATIONS if set to None.</p> <code>None</code> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_ontology(\n    self,\n    base_iri: str = \"emmo-inferred\",\n    OntologyClass: \"owlready2.Ontology\" = None,\n    label_annotations: \"Sequence\" = None,\n) -&gt; \"Ontology\":\n    # pylint: disable=too-many-branches\n    \"\"\"Returns a new Ontology from `base_iri`.\n\n    Arguments:\n        base_iri: The base IRI of the ontology. May be one of:\n            - valid URL (possible excluding final .owl or .ttl)\n            - file name (possible excluding final .owl or .ttl)\n            - \"emmo\": load latest version of asserted EMMO\n            - \"emmo-inferred\": load latest version of inferred EMMO\n              (default)\n            - \"emmo-development\": load latest inferred development\n              version of EMMO. Until first stable release\n              emmo-inferred and emmo-development will be the same.\n        OntologyClass: If given and `base_iri` doesn't correspond\n            to an existing ontology, a new ontology is created of\n            this Ontology subclass.  Defaults to `ontopy.Ontology`.\n        label_annotations: Sequence of label IRIs used for accessing\n            entities in the ontology given that they are in the ontology.\n            Label IRIs not in the ontology will need to be added to\n            ontologies in order to be accessible.\n            Defaults to DEFAULT_LABEL_ANNOTATIONS if set to None.\n    \"\"\"\n    base_iri = base_iri.as_uri() if isinstance(base_iri, Path) else base_iri\n\n    if base_iri == \"emmo\":\n        base_iri = (\n            \"http://emmo-repo.github.io/versions/1.0.0-beta4/emmo.ttl\"\n        )\n    elif base_iri == \"emmo-inferred\":\n        base_iri = (\n            \"https://emmo-repo.github.io/versions/1.0.0-beta4/\"\n            \"emmo-inferred.ttl\"\n        )\n    elif base_iri == \"emmo-development\":\n        base_iri = (\n            \"https://emmo-repo.github.io/versions/1.0.0-beta5/\"\n            \"emmo-inferred.ttl\"\n        )\n\n    if base_iri in self.ontologies:\n        onto = self.ontologies[base_iri]\n    elif base_iri + \"#\" in self.ontologies:\n        onto = self.ontologies[base_iri + \"#\"]\n    elif base_iri + \"/\" in self.ontologies:\n        onto = self.ontologies[base_iri + \"/\"]\n    else:\n        if os.path.exists(base_iri):\n            iri = os.path.abspath(base_iri)\n        elif os.path.exists(base_iri + \".ttl\"):\n            iri = os.path.abspath(base_iri + \".ttl\")\n        elif os.path.exists(base_iri + \".owl\"):\n            iri = os.path.abspath(base_iri + \".owl\")\n        else:\n            iri = base_iri\n\n        if iri[-1] not in \"/#\":\n            iri += \"#\"\n\n        if OntologyClass is None:\n            OntologyClass = Ontology\n\n        onto = OntologyClass(self, iri)\n\n    if label_annotations:\n        onto.label_annotations = list(label_annotations)\n\n    return onto\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.World.get_unabbreviated_triples","title":"<code>get_unabbreviated_triples(self, subject=None, predicate=None, obj=None, blank=None)</code>","text":"<p>Returns all triples unabbreviated.</p> <p>If any of the <code>subject</code>, <code>predicate</code> or <code>obj</code> arguments are given, only matching triples will be returned.</p> <p>If <code>blank</code> is given, it will be used to represent blank nodes.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_unabbreviated_triples(\n    self, subject=None, predicate=None, obj=None, blank=None\n):\n    # pylint: disable=invalid-name\n    \"\"\"Returns all triples unabbreviated.\n\n    If any of the `subject`, `predicate` or `obj` arguments are given,\n    only matching triples will be returned.\n\n    If `blank` is given, it will be used to represent blank nodes.\n    \"\"\"\n    return _get_unabbreviated_triples(\n        self, subject=subject, predicate=predicate, obj=obj, blank=blank\n    )\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.flatten","title":"<code>flatten(items)</code>","text":"<p>Yield items from any nested iterable.</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def flatten(items):\n    \"\"\"Yield items from any nested iterable.\"\"\"\n    for item in items:\n        if isinstance(item, Iterable) and not isinstance(item, (str, bytes)):\n            yield from flatten(item)\n        else:\n            yield item\n</code></pre>"},{"location":"api_reference/ontopy/ontology/#ontopy.ontology.get_ontology","title":"<code>get_ontology(*args, **kwargs)</code>","text":"<p>Returns a new Ontology from <code>base_iri</code>.</p> <p>This is a convenient function for calling World.get_ontology().</p> Source code in <code>ontopy/ontology.py</code> <pre><code>def get_ontology(*args, **kwargs):\n    \"\"\"Returns a new Ontology from `base_iri`.\n\n    This is a convenient function for calling World.get_ontology().\"\"\"\n    return World().get_ontology(*args, **kwargs)\n</code></pre>"},{"location":"api_reference/ontopy/patch/","title":"patch","text":"<p>This module injects some additional methods into owlready2 classes.</p>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.disjoint_with","title":"<code>disjoint_with(self, reduce=False)</code>","text":"<p>Returns a generator with all classes that are disjoint with <code>self</code>.</p> <p>If <code>reduce</code> is <code>True</code>, all classes that are a descendant of another class will be excluded.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def disjoint_with(self, reduce=False):\n    \"\"\"Returns a generator with all classes that are disjoint with `self`.\n\n    If `reduce` is `True`, all classes that are a descendant of another class\n    will be excluded.\n    \"\"\"\n    if reduce:\n        disjoint_set = set(self.disjoint_with())\n        for entity in disjoint_set.copy():\n            disjoint_set.difference_update(\n                entity.descendants(include_self=False)\n            )\n        yield from disjoint_set\n    else:\n        for disjoint in self.disjoints():\n            for entity in disjoint.entities:\n                if entity is not self:\n                    yield entity\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_annotations","title":"<code>get_annotations(self, all=False, imported=True)</code>","text":"<p>Returns a dict with non-empty annotations.</p> <p>If <code>all</code> is <code>True</code>, also annotations with no value are included.</p> <p>If <code>imported</code> is <code>True</code>, also include annotations defined in imported ontologies.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_annotations(\n    self, all=False, imported=True\n):  # pylint: disable=redefined-builtin\n    \"\"\"Returns a dict with non-empty annotations.\n\n    If `all` is `True`, also annotations with no value are included.\n\n    If `imported` is `True`, also include annotations defined in imported\n    ontologies.\n    \"\"\"\n    onto = self.namespace.ontology\n\n    def extend(key, values):\n        \"\"\"Extend annotations with a sequence of values.\"\"\"\n        if key in annotations:\n            annotations[key].extend(values)\n        else:\n            annotations[key] = values\n\n    annotations = {\n        str(get_preferred_label(a)): a._get_values_for_class(self)\n        for a in onto.annotation_properties(imported=imported)\n    }\n    extend(\"comment\", self.comment)\n    extend(\"label\", self.label)\n    if all:\n        return annotations\n    return {key: value for key, value in annotations.items() if value}\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_indirect_is_a","title":"<code>get_indirect_is_a(self, skip_classes=True)</code>","text":"<p>Returns the set of all isSubclassOf relations of self and its ancestors.</p> <p>If <code>skip_classes</code> is <code>True</code>, indirect classes are not included in the returned set.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_indirect_is_a(self, skip_classes=True):\n    \"\"\"Returns the set of all isSubclassOf relations of self and its ancestors.\n\n    If `skip_classes` is `True`, indirect classes are not included in the\n    returned set.\n    \"\"\"\n    subclass_relations = set()\n    for entity in reversed(self.mro()):\n        for attr in \"is_a\", \"equivalent_to\":\n            if hasattr(entity, attr):\n                lst = getattr(entity, attr)\n                if skip_classes:\n                    subclass_relations.update(\n                        r\n                        for r in lst\n                        if not isinstance(r, owlready2.ThingClass)\n                    )\n                else:\n                    subclass_relations.update(lst)\n\n    subclass_relations.update(self.is_a)\n    return subclass_relations\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_parents","title":"<code>get_parents(self, strict=False)</code>","text":"<p>Returns a list of all parents.</p> <p>If <code>strict</code> is <code>True</code>, parents that are parents of other parents are excluded.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_parents(self, strict=False):\n    \"\"\"Returns a list of all parents.\n\n    If `strict` is `True`, parents that are parents of other parents are\n    excluded.\n    \"\"\"\n    if strict:\n        parents = self.get_parents()\n        for entity in parents.copy():\n            parents.difference_update(entity.ancestors(include_self=False))\n        return parents\n    if isinstance(self, ThingClass):\n        return {cls for cls in self.is_a if isinstance(cls, ThingClass)}\n    if isinstance(self, owlready2.ObjectPropertyClass):\n        return {\n            cls\n            for cls in self.is_a\n            if isinstance(cls, owlready2.ObjectPropertyClass)\n        }\n    raise EMMOntoPyException(\n        \"self has no parents - this should not be possible!\"\n    )\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_preferred_label","title":"<code>get_preferred_label(self)</code>","text":"<p>Returns the preferred label as a string (not list).</p> <p>The following heuristics is used:   - if prefLabel annotation property exists, returns the first prefLabel   - if label annotation property exists, returns the first label   - otherwise return the name</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_preferred_label(self):\n    \"\"\"Returns the preferred label as a string (not list).\n\n    The following heuristics is used:\n      - if prefLabel annotation property exists, returns the first prefLabel\n      - if label annotation property exists, returns the first label\n      - otherwise return the name\n    \"\"\"\n    if hasattr(self, \"prefLabel\") and self.prefLabel:\n        return self.prefLabel[0]\n    if hasattr(self, \"label\") and self.label:\n        return self.label.first()\n    return self.name\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.get_typename","title":"<code>get_typename(self)</code>","text":"<p>Get restriction type label/name.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def get_typename(self):\n    \"\"\"Get restriction type label/name.\"\"\"\n    return owlready2.class_construct._restriction_type_2_label[self.type]\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.has","title":"<code>has(self, name)</code>","text":"<p>Returns true if <code>name</code></p> Source code in <code>ontopy/patch.py</code> <pre><code>def has(self, name):\n    \"\"\"Returns true if `name`\"\"\"\n    return name in set(self.keys())\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.items","title":"<code>items(self)</code>","text":"<p>Return a generator over annotation property (name, value_list) pairs associates with this ontology.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def items(self):\n    \"\"\"Return a generator over annotation property (name, value_list)\n    pairs associates with this ontology.\"\"\"\n    namespace = self.namespace\n    for annotation in namespace.annotation_properties():\n        if namespace._has_data_triple_spod(\n            s=namespace.storid, p=annotation.storid\n        ):\n            yield annotation, getattr(self, annotation.name)\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.keys","title":"<code>keys(self)</code>","text":"<p>Return a generator over annotation property names associated with this ontology.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def keys(self):\n    \"\"\"Return a generator over annotation property names associated\n    with this ontology.\"\"\"\n    namespace = self.namespace\n    for annotation in namespace.annotation_properties():\n        if namespace._has_data_triple_spod(\n            s=namespace.storid, p=annotation.storid\n        ):\n            yield annotation\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.namespace_init","title":"<code>namespace_init(self, world_or_ontology, base_iri, name=None)</code>","text":"<p>init function for the <code>Namespace</code> class.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def namespace_init(self, world_or_ontology, base_iri, name=None):\n    \"\"\"__init__ function for the `Namespace` class.\"\"\"\n    orig_namespace_init(self, world_or_ontology, base_iri, name)\n    if self.name.endswith(\".ttl\"):\n        self.name = self.name[:-4]\n</code></pre>"},{"location":"api_reference/ontopy/patch/#ontopy.patch.render_func","title":"<code>render_func(entity)</code>","text":"<p>Improve default rendering of entities.</p> Source code in <code>ontopy/patch.py</code> <pre><code>def render_func(entity):\n    \"\"\"Improve default rendering of entities.\"\"\"\n    if hasattr(entity, \"prefLabel\") and entity.prefLabel:\n        name = entity.prefLabel[0]\n    elif hasattr(entity, \"label\") and entity.label:\n        name = entity.label[0]\n    elif hasattr(entity, \"altLabel\") and entity.altLabel:\n        name = entity.altLabel[0]\n    else:\n        name = entity.name\n    return f\"{entity.namespace.name}.{name}\"\n</code></pre>"},{"location":"api_reference/ontopy/testutils/","title":"testutils","text":"<p>Module primarly intended to be imported by tests.</p> <p>It defines some directories and some utility functions that can be used with and without conftest.</p>"},{"location":"api_reference/ontopy/testutils/#ontopy.testutils.get_tool_module","title":"<code>get_tool_module(name)</code>","text":"<p>Imports and returns the module for the EMMOntoPy tool corresponding to <code>name</code>.</p> Source code in <code>ontopy/testutils.py</code> <pre><code>def get_tool_module(name):\n    \"\"\"Imports and returns the module for the EMMOntoPy tool\n    corresponding to `name`.\"\"\"\n    if str(toolsdir) not in sys.path:\n        sys.path.append(str(toolsdir))\n\n    # For Python 3.4+\n    spec = spec_from_loader(name, SourceFileLoader(name, str(toolsdir / name)))\n    module = module_from_spec(spec)\n    spec.loader.exec_module(module)\n    return module\n</code></pre>"},{"location":"api_reference/ontopy/utils/","title":"utils","text":"<p>Some generic utility functions.</p>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.AmbiguousLabelError","title":"<code> AmbiguousLabelError            (LookupError, AttributeError, EMMOntoPyException)         </code>","text":"<p>Error raised when a label is ambiguous.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class AmbiguousLabelError(LookupError, AttributeError, EMMOntoPyException):\n    \"\"\"Error raised when a label is ambiguous.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.EMMOntoPyException","title":"<code> EMMOntoPyException            (Exception)         </code>","text":"<p>A BaseException class for EMMOntoPy</p> Source code in <code>ontopy/utils.py</code> <pre><code>class EMMOntoPyException(Exception):\n    \"\"\"A BaseException class for EMMOntoPy\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.EMMOntoPyWarning","title":"<code> EMMOntoPyWarning            (Warning)         </code>","text":"<p>A BaseWarning class for EMMOntoPy</p> Source code in <code>ontopy/utils.py</code> <pre><code>class EMMOntoPyWarning(Warning):\n    \"\"\"A BaseWarning class for EMMOntoPy\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.EntityClassDefinitionError","title":"<code> EntityClassDefinitionError            (EMMOntoPyException)         </code>","text":"<p>Error in ThingClass definition.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class EntityClassDefinitionError(EMMOntoPyException):\n    \"\"\"Error in ThingClass definition.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.IncompatibleVersion","title":"<code> IncompatibleVersion            (EMMOntoPyWarning)         </code>","text":"<p>An installed dependency version may be incompatible with a functionality of this package - or rather an outcome of a functionality. This is not critical, hence this is only a warning.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class IncompatibleVersion(EMMOntoPyWarning):\n    \"\"\"An installed dependency version may be incompatible with a functionality\n    of this package - or rather an outcome of a functionality.\n    This is not critical, hence this is only a warning.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.IndividualWarning","title":"<code> IndividualWarning            (EMMOntoPyWarning)         </code>","text":"<p>A warning related to an individual, e.g. punning.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class IndividualWarning(EMMOntoPyWarning):\n    \"\"\"A warning related to an individual, e.g. punning.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.LabelDefinitionError","title":"<code> LabelDefinitionError            (EMMOntoPyException)         </code>","text":"<p>Error in label definition.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class LabelDefinitionError(EMMOntoPyException):\n    \"\"\"Error in label definition.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.NoSuchLabelError","title":"<code> NoSuchLabelError            (LookupError, AttributeError, EMMOntoPyException)         </code>","text":"<p>Error raised when a label cannot be found.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class NoSuchLabelError(LookupError, AttributeError, EMMOntoPyException):\n    \"\"\"Error raised when a label cannot be found.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.ReadCatalogError","title":"<code> ReadCatalogError            (OSError)         </code>","text":"<p>Error reading catalog file.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class ReadCatalogError(IOError):\n    \"\"\"Error reading catalog file.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.UnknownVersion","title":"<code> UnknownVersion            (EMMOntoPyException)         </code>","text":"<p>Cannot retrieve version from a package.</p> Source code in <code>ontopy/utils.py</code> <pre><code>class UnknownVersion(EMMOntoPyException):\n    \"\"\"Cannot retrieve version from a package.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.annotate_source","title":"<code>annotate_source(onto, imported=True)</code>","text":"<p>Annotate all entities with the base IRI of the ontology using <code>rdfs:isDefinedBy</code> annotations.</p> <p>If <code>imported</code> is true, all entities in imported sub-ontologies will also be annotated.</p> <p>This is contextual information that is otherwise lost when the ontology is squashed and/or inferred.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def annotate_source(onto, imported=True):\n    \"\"\"Annotate all entities with the base IRI of the ontology using\n    `rdfs:isDefinedBy` annotations.\n\n    If `imported` is true, all entities in imported sub-ontologies will\n    also be annotated.\n\n    This is contextual information that is otherwise lost when the ontology\n    is squashed and/or inferred.\n    \"\"\"\n    source = onto._abbreviate(\n        \"http://www.w3.org/2000/01/rdf-schema#isDefinedBy\"\n    )\n    for entity in onto.get_entities(imported=imported):\n        triple = (\n            entity.storid,\n            source,\n            onto._abbreviate(entity.namespace.ontology.base_iri),\n        )\n        if not onto._has_obj_triple_spo(*triple):\n            onto._add_obj_triple_spo(*triple)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.asstring","title":"<code>asstring(expr, link='{label}', recursion_depth=0, exclude_object=False, ontology=None)</code>","text":"<p>Returns a string representation of <code>expr</code>.</p> <p>Parameters:</p> Name Type Description Default <code>expr</code> <p>The entity, restriction or a logical expression or these to represent.</p> required <code>link</code> <p>A template for links.  May contain the following variables: - {iri}: The full IRI of the concept. - {name}: Name-part of IRI. - {ref}: \"#{name}\" if the base iri of hte ontology has the same   root as {iri}, otherwise \"{iri}\". - {label}: The label of the concept. - {lowerlabel}: The label of the concept in lower case and with   spaces replaced with hyphens.</p> <code>'{label}'</code> <code>recursion_depth</code> <p>Recursion depth. Only intended for internal use.</p> <code>0</code> <code>exclude_object</code> <p>If true, the object will be excluded in restrictions.</p> <code>False</code> <code>ontology</code> <p>Ontology object.</p> <code>None</code> <p>Returns:</p> Type Description <code>str</code> <p>String representation of <code>expr</code>.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def asstring(\n    expr,\n    link=\"{label}\",\n    recursion_depth=0,\n    exclude_object=False,\n    ontology=None,\n) -&gt; str:\n    \"\"\"Returns a string representation of `expr`.\n\n    Arguments:\n        expr: The entity, restriction or a logical expression or these\n            to represent.\n        link: A template for links.  May contain the following variables:\n            - {iri}: The full IRI of the concept.\n            - {name}: Name-part of IRI.\n            - {ref}: \"#{name}\" if the base iri of hte ontology has the same\n              root as {iri}, otherwise \"{iri}\".\n            - {label}: The label of the concept.\n            - {lowerlabel}: The label of the concept in lower case and with\n              spaces replaced with hyphens.\n        recursion_depth: Recursion depth. Only intended for internal use.\n        exclude_object: If true, the object will be excluded in restrictions.\n        ontology: Ontology object.\n\n    Returns:\n        String representation of `expr`.\n    \"\"\"\n    # pylint: disable=too-many-return-statements,too-many-branches,too-many-statements\n    if ontology is None:\n        ontology = expr.ontology\n\n    def fmt(entity):\n        \"\"\"Returns the formatted label of an entity.\"\"\"\n        if isinstance(entity, str):\n            if ontology and ontology.world[entity]:\n                iri = ontology.world[entity].iri\n            elif (\n                ontology\n                and re.match(\"^[a-zA-Z0-9_+-]+$\", entity)\n                and entity in ontology\n            ):\n                iri = ontology[entity].iri\n            else:\n                # This may not be a valid IRI, but the best we can do\n                iri = entity\n            label = entity\n        else:\n            iri = entity.iri\n            label = get_label(entity)\n        name = getiriname(iri)\n        start = iri.split(\"#\", 1)[0] if \"#\" in iri else iri.rsplit(\"/\", 1)[0]\n        ref = f\"#{name}\" if ontology.base_iri.startswith(start) else iri\n        return link.format(\n            entity=entity,\n            name=name,\n            ref=ref,\n            iri=iri,\n            label=label,\n            lowerlabel=label.lower().replace(\" \", \"-\"),\n        )\n\n    if isinstance(expr, str):\n        # return link.format(name=expr)\n        return fmt(expr)\n    if isinstance(expr, owlready2.Restriction):\n        rlabel = owlready2.class_construct._restriction_type_2_label[expr.type]\n\n        if isinstance(\n            expr.property,\n            (owlready2.ObjectPropertyClass, owlready2.DataPropertyClass),\n        ):\n            res = fmt(expr.property)\n        elif isinstance(expr.property, owlready2.Inverse):\n            string = asstring(\n                expr.property.property,\n                link,\n                recursion_depth + 1,\n                ontology=ontology,\n            )\n            res = f\"Inverse({string})\"\n        else:\n            print(\n                f\"*** WARNING: unknown restriction property: {expr.property!r}\"\n            )\n            res = fmt(expr.property)\n\n        if not rlabel:\n            pass\n        elif expr.type in (owlready2.MIN, owlready2.MAX, owlready2.EXACTLY):\n            res += f\" {rlabel} {expr.cardinality}\"\n        elif expr.type in (\n            owlready2.SOME,\n            owlready2.ONLY,\n            owlready2.VALUE,\n            owlready2.HAS_SELF,\n        ):\n            res += f\" {rlabel}\"\n        else:\n            print(\"*** WARNING: unknown relation\", expr, rlabel)\n            res += f\" {rlabel}\"\n\n        if not exclude_object:\n            string = asstring(\n                expr.value, link, recursion_depth + 1, ontology=ontology\n            )\n            res += (\n                f\" {string!r}\" if isinstance(expr.value, str) else f\" {string}\"\n            )\n        return res\n    if isinstance(expr, owlready2.Or):\n        res = \" or \".join(\n            [\n                asstring(c, link, recursion_depth + 1, ontology=ontology)\n                for c in expr.Classes\n            ]\n        )\n        return res if recursion_depth == 0 else f\"({res})\"\n    if isinstance(expr, owlready2.And):\n        res = \" and \".join(\n            [\n                asstring(c, link, recursion_depth + 1, ontology=ontology)\n                for c in expr.Classes\n            ]\n        )\n        return res if recursion_depth == 0 else f\"({res})\"\n    if isinstance(expr, owlready2.Not):\n        string = asstring(\n            expr.Class, link, recursion_depth + 1, ontology=ontology\n        )\n        return f\"not {string}\"\n    if isinstance(expr, owlready2.ThingClass):\n        return fmt(expr)\n    if isinstance(expr, owlready2.PropertyClass):\n        return fmt(expr)\n    if isinstance(expr, owlready2.Thing):  # instance (individual)\n        return fmt(expr)\n    if isinstance(expr, owlready2.class_construct.Inverse):\n        return f\"inverse({fmt(expr.property)})\"\n    if isinstance(expr, owlready2.disjoint.AllDisjoint):\n        return fmt(expr)\n\n    if isinstance(expr, (bool, int, float)):\n        return repr(expr)\n    # Check for subclasses\n    if inspect.isclass(expr):\n        if issubclass(expr, (bool, int, float, str)):\n            return fmt(expr.__class__.__name__)\n        if issubclass(expr, datetime.date):\n            return \"date\"\n        if issubclass(expr, datetime.time):\n            return \"datetime\"\n        if issubclass(expr, datetime.datetime):\n            return \"datetime\"\n\n    raise RuntimeError(f\"Unknown expression: {expr!r} (type: {type(expr)!r})\")\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.camelsplit","title":"<code>camelsplit(string)</code>","text":"<p>Splits CamelCase string before upper case letters (except if there is a sequence of upper case letters).</p> Source code in <code>ontopy/utils.py</code> <pre><code>def camelsplit(string):\n    \"\"\"Splits CamelCase string before upper case letters (except\n    if there is a sequence of upper case letters).\"\"\"\n    if len(string) &lt; 2:\n        return string\n    result = []\n    prev_lower = False\n    prev_isspace = True\n    char = string[0]\n    for next_char in string[1:]:\n        if (not prev_isspace and char.isupper() and next_char.islower()) or (\n            prev_lower and char.isupper()\n        ):\n            result.append(\" \")\n        result.append(char)\n        prev_lower = char.islower()\n        prev_isspace = char.isspace()\n        char = next_char\n    result.append(char)\n    return \"\".join(result)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.convert_imported","title":"<code>convert_imported(input_ontology, output_ontology, input_format=None, output_format='xml', url_from_catalog=None, catalog_file='catalog-v001.xml')</code>","text":"<p>Convert imported ontologies.</p> <p>Store the output in a directory structure matching the source files.  This require catalog file(s) to be present.</p> <p>Warning</p> <p>To convert to Turtle (<code>.ttl</code>) format, you must have installed <code>rdflib&gt;=6.0.0</code>. See Known issues for more information.</p> <p>Parameters:</p> Name Type Description Default <code>input_ontology</code> <code>Union[Path, str]</code> <p>input ontology file name</p> required <code>output_ontology</code> <code>Union[Path, str]</code> <p>output ontology file path. The directory part of <code>output</code> will be the root of the generated directory structure</p> required <code>input_format</code> <code>Optional[str]</code> <p>input format. The default is to infer from <code>input_ontology</code></p> <code>None</code> <code>output_format</code> <code>str</code> <p>output format. The default is to infer from <code>output_ontology</code></p> <code>'xml'</code> <code>url_from_catalog</code> <code>Optional[bool]</code> <p>Whether to read urls form catalog file. If False, the catalog file will be used if it exists.</p> <code>None</code> <code>catalog_file</code> <code>str</code> <p>name of catalog file, that maps ontology IRIs to local file names</p> <code>'catalog-v001.xml'</code> Source code in <code>ontopy/utils.py</code> <pre><code>def convert_imported(  # pylint: disable=too-many-arguments,too-many-locals\n    input_ontology: \"Union[Path, str]\",\n    output_ontology: \"Union[Path, str]\",\n    input_format: \"Optional[str]\" = None,\n    output_format: str = \"xml\",\n    url_from_catalog: \"Optional[bool]\" = None,\n    catalog_file: str = \"catalog-v001.xml\",\n):\n    \"\"\"Convert imported ontologies.\n\n    Store the output in a directory structure matching the source\n    files.  This require catalog file(s) to be present.\n\n    Warning:\n        To convert to Turtle (`.ttl`) format, you must have installed\n        `rdflib&gt;=6.0.0`. See [Known issues](../../../#known-issues) for\n        more information.\n\n    Args:\n        input_ontology: input ontology file name\n        output_ontology: output ontology file path. The directory part of\n            `output` will be the root of the generated directory structure\n        input_format: input format. The default is to infer from\n            `input_ontology`\n        output_format: output format. The default is to infer from\n            `output_ontology`\n        url_from_catalog: Whether to read urls form catalog file.\n            If False, the catalog file will be used if it exists.\n        catalog_file: name of catalog file, that maps ontology IRIs to\n            local file names\n    \"\"\"\n    inroot = os.path.dirname(os.path.abspath(input_ontology))\n    outroot = os.path.dirname(os.path.abspath(output_ontology))\n    outext = os.path.splitext(output_ontology)[1]\n\n    if url_from_catalog is None:\n        url_from_catalog = os.path.exists(os.path.join(inroot, catalog_file))\n\n    if url_from_catalog:\n        iris, dirs = read_catalog(\n            inroot, catalog_file=catalog_file, recursive=True, return_paths=True\n        )\n\n        # Create output dirs and copy catalog files\n        for indir in dirs:\n            outdir = os.path.normpath(\n                os.path.join(outroot, os.path.relpath(indir, inroot))\n            )\n            if not os.path.exists(outdir):\n                os.makedirs(outdir)\n            with open(\n                os.path.join(indir, catalog_file), mode=\"rt\", encoding=\"utf8\"\n            ) as handle:\n                content = handle.read()\n            for path in iris.values():\n                newpath = os.path.splitext(path)[0] + outext\n                content = content.replace(\n                    os.path.basename(path), os.path.basename(newpath)\n                )\n            with open(\n                os.path.join(outdir, catalog_file), mode=\"wt\", encoding=\"utf8\"\n            ) as handle:\n                handle.write(content)\n    else:\n        iris = {}\n\n    outpaths = set()\n\n    def recur(graph, outext):\n        for imported in graph.objects(\n            predicate=URIRef(\"http://www.w3.org/2002/07/owl#imports\")\n        ):\n            inpath = iris.get(str(imported), str(imported))\n            if inpath.startswith((\"http://\", \"https://\", \"ftp://\")):\n                outpath = os.path.join(outroot, inpath.split(\"/\")[-1])\n            else:\n                outpath = os.path.join(outroot, os.path.relpath(inpath, inroot))\n            outpath = os.path.splitext(os.path.normpath(outpath))[0] + outext\n            if outpath not in outpaths:\n                outpaths.add(outpath)\n                fmt = (\n                    input_format\n                    if input_format\n                    else guess_format(inpath, fmap=FMAP)\n                )\n                new_graph = Graph()\n                new_graph.parse(iris.get(inpath, inpath), format=fmt)\n                new_graph.serialize(destination=outpath, format=output_format)\n                recur(new_graph, outext)\n\n    # Write output files\n    fmt = (\n        input_format\n        if input_format\n        else guess_format(input_ontology, fmap=FMAP)\n    )\n\n    if not _validate_installed_version(\n        package=\"rdflib\", min_version=\"6.0.0\"\n    ) and (output_format == FMAP.get(\"ttl\", \"\") or outext == \"ttl\"):\n        from rdflib import (  # pylint: disable=import-outside-toplevel\n            __version__ as __rdflib_version__,\n        )\n\n        warnings.warn(\n            IncompatibleVersion(\n                \"To correctly convert to Turtle format, rdflib must be \"\n                \"version 6.0.0 or greater, however, the detected rdflib \"\n                \"version used by your Python interpreter is \"\n                f\"{__rdflib_version__!r}. For more information see the \"\n                \"'Known issues' section of the README.\"\n            )\n        )\n\n    graph = Graph()\n    try:\n        graph.parse(input_ontology, format=fmt)\n    except PluginException as exc:  # Add input_ontology to exception msg\n        raise PluginException(\n            f'Cannot load \"{input_ontology}\": {exc.msg}'\n        ).with_traceback(exc.__traceback__)\n    graph.serialize(destination=output_ontology, format=output_format)\n    recur(graph, outext)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.copy_annotation","title":"<code>copy_annotation(onto, src, dst)</code>","text":"<p>In all classes and properties in <code>onto</code>, copy annotation <code>src</code> to <code>dst</code>.</p> <p>Parameters:</p> Name Type Description Default <code>onto</code> <p>Ontology to work on.</p> required <code>src</code> <p>Name of source annotation.</p> required <code>dst</code> <p>Name or IRI of destination annotation.  Use IRI if the destination annotation is not already in the ontology.</p> required Source code in <code>ontopy/utils.py</code> <pre><code>def copy_annotation(onto, src, dst):\n    \"\"\"In all classes and properties in `onto`, copy annotation `src` to `dst`.\n\n    Arguments:\n        onto: Ontology to work on.\n        src: Name of source annotation.\n        dst: Name or IRI of destination annotation.  Use IRI if the\n            destination annotation is not already in the ontology.\n    \"\"\"\n    if onto.world[src]:\n        src = onto.world[src]\n    else:\n        src = onto[src]\n\n    if onto.world[dst]:\n        dst = onto.world[dst]\n    elif dst in onto:\n        dst = onto[dst]\n    else:\n        if \"://\" not in dst:\n            raise ValueError(\n                \"new destination annotation property must be provided as \"\n                \"a full IRI\"\n            )\n        name = min(dst.rsplit(\"#\")[-1], dst.rsplit(\"/\")[-1], key=len)\n        iri = dst\n        dst = onto.new_annotation_property(name, owlready2.AnnotationProperty)\n        dst.iri = iri\n\n    for e in onto.get_entities():\n        new = getattr(e, src.name).first()\n        if new and new not in getattr(e, dst.name):\n            getattr(e, dst.name).append(new)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.directory_layout","title":"<code>directory_layout(onto)</code>","text":"<p>Analyse IRIs of imported ontologies and suggested a directory layout for saving recursively.</p> <p>Parameters:</p> Name Type Description Default <code>onto</code> <p>Ontology to analyse.</p> required <p>Returns:</p> Type Description <code>layout</code> <p>A dict mapping ontology objects to relative path names     derived from the ontology IRIs. No file name extension are     added.</p> <p>Examples:</p> <p>Assume that our ontology <code>onto</code> has IRI <code>ex:onto</code>. If it directly or indirectly imports ontologies with IRIs <code>ex:A/ontoA</code>, <code>ex:B/ontoB</code> and <code>ex:A/C/ontoC</code>, this function will return the following dict:</p> <pre><code>{\n    onto: \"onto\",\n    ontoA: \"A/ontoA\",\n    ontoB: \"B/ontoB\",\n    ontoC: \"A/C/ontoC\",\n}\n</code></pre> <p>where <code>ontoA</code>, <code>ontoB</code> and <code>ontoC</code> are imported Ontology objects.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def directory_layout(onto):\n    \"\"\"Analyse IRIs of imported ontologies and suggested a directory\n    layout for saving recursively.\n\n    Arguments:\n        onto: Ontology to analyse.\n\n    Returns:\n        layout: A dict mapping ontology objects to relative path names\n            derived from the ontology IRIs. No file name extension are\n            added.\n\n    Example:\n        Assume that our ontology `onto` has IRI `ex:onto`. If it directly\n        or indirectly imports ontologies with IRIs `ex:A/ontoA`, `ex:B/ontoB`\n        and `ex:A/C/ontoC`, this function will return the following dict:\n\n            {\n                onto: \"onto\",\n                ontoA: \"A/ontoA\",\n                ontoB: \"B/ontoB\",\n                ontoC: \"A/C/ontoC\",\n            }\n\n        where `ontoA`, `ontoB` and `ontoC` are imported Ontology objects.\n    \"\"\"\n    all_imported = [\n        imported.base_iri for imported in onto.indirectly_imported_ontologies()\n    ]\n    # get protocol and domain of all imported ontologies\n    namespace_roots = set()\n    for iri in all_imported:\n        protocol, domain, *_ = urllib.parse.urlsplit(iri)\n        namespace_roots.add(\"://\".join([protocol, domain]))\n\n    def recur(o):\n        baseiri = o.base_iri.rstrip(\"/#\")\n\n        # Some heuristics here to reproduce the EMMO layout.\n        # It might not apply to all ontologies, so maybe it should be\n        # made optional?  Alternatively, change EMMO ontology IRIs to\n        # match the directory layout.\n        emmolayout = (\n            any(\n                oo.base_iri.startswith(baseiri + \"/\")\n                for oo in o.imported_ontologies\n            )\n            or o.base_iri == \"http://emmo.info/emmo/mereocausality#\"\n        )\n\n        layout[o] = (\n            baseiri + \"/\" + os.path.basename(baseiri) if emmolayout else baseiri\n        )\n        for imported in o.imported_ontologies:\n            if imported not in layout:\n                recur(imported)\n\n    layout = {}\n    recur(onto)\n    # Strip off initial common prefix from all paths\n    if len(namespace_roots) == 1:\n        prefix = os.path.commonprefix(list(layout.values()))\n        for o, path in layout.items():\n            layout[o] = path[len(prefix) :].lstrip(\"/\")\n    else:\n        for o, path in layout.items():\n            for namespace_root in namespace_roots:\n                if path.startswith(namespace_root):\n                    layout[o] = (\n                        urllib.parse.urlsplit(namespace_root)[1]\n                        + path[len(namespace_root) :]\n                    )\n\n    return layout\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.english","title":"<code>english(string)</code>","text":"<p>Returns <code>string</code> as an English location string.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def english(string):\n    \"\"\"Returns `string` as an English location string.\"\"\"\n    return owlready2.locstr(string, lang=\"en\")\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.get_format","title":"<code>get_format(outfile, default, fmt=None)</code>","text":"<p>Infer format from outfile and format.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def get_format(outfile: str, default: str, fmt: str = None):\n    \"\"\"Infer format from outfile and format.\"\"\"\n    if fmt is None:\n        fmt = os.path.splitext(outfile)[1]\n    if not fmt:\n        fmt = default\n    return fmt.lstrip(\".\")\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.get_label","title":"<code>get_label(entity)</code>","text":"<p>Returns the label of an entity.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def get_label(entity):\n    \"\"\"Returns the label of an entity.\"\"\"\n    # pylint: disable=too-many-return-statements\n    if hasattr(entity, \"namespace\"):\n        onto = entity.namespace.ontology\n        if onto.label_annotations:\n            for la in onto.label_annotations:\n                try:\n                    label = entity[la]\n                    if label:\n                        return get_preferred_language(label)\n                except (NoSuchLabelError, AttributeError, TypeError):\n                    continue\n    if hasattr(entity, \"prefLabel\") and entity.prefLabel:\n        return get_preferred_language(entity.prefLabel)\n    if hasattr(entity, \"label\") and entity.label:\n        return get_preferred_language(entity.label)\n    if hasattr(entity, \"__name__\"):\n        return entity.__name__\n    if hasattr(entity, \"name\"):\n        return str(entity.name)\n    if isinstance(entity, str):\n        return entity\n    return repr(entity)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.get_preferred_language","title":"<code>get_preferred_language(langstrings, lang=None)</code>","text":"<p>Given a list of localised strings, return the one in language <code>lang</code>. If <code>lang</code> is not given, use <code>ontopy.utils.PREFERRED_LANGUAGE</code>.  If no one match is found, return the first one with no language tag or fallback to the first string.</p> <p>The preferred language is stored as a module variable. You can change it with:</p> <p>import ontopy.utils ontopy.utils.PREFERRED_LANGUAGE = \"en\"</p> Source code in <code>ontopy/utils.py</code> <pre><code>def get_preferred_language(langstrings: list, lang=None) -&gt; str:\n    \"\"\"Given a list of localised strings, return the one in language\n    `lang`. If `lang` is not given, use\n    `ontopy.utils.PREFERRED_LANGUAGE`.  If no one match is found,\n    return the first one with no language tag or fallback to the first\n    string.\n\n    The preferred language is stored as a module variable. You can\n    change it with:\n\n    &gt;&gt;&gt; import ontopy.utils\n    &gt;&gt;&gt; ontopy.utils.PREFERRED_LANGUAGE = \"en\"\n\n    \"\"\"\n    if lang is None:\n        lang = PREFERRED_LANGUAGE\n    for langstr in langstrings:\n        if hasattr(langstr, \"lang\") and langstr.lang == lang:\n            return str(langstr)\n    for langstr in langstrings:\n        if not hasattr(langstr, \"lang\"):\n            return langstr\n    return str(langstrings[0])\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.getiriname","title":"<code>getiriname(iri)</code>","text":"<p>Return name part of an IRI.</p> <p>The name part is what follows after the last slash or hash.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def getiriname(iri):\n    \"\"\"Return name part of an IRI.\n\n    The name part is what follows after the last slash or hash.\n    \"\"\"\n    res = urllib.parse.urlparse(iri)\n    return res.fragment if res.fragment else res.path.rsplit(\"/\", 1)[-1]\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.infer_version","title":"<code>infer_version(iri, version_iri)</code>","text":"<p>Infer version from IRI and versionIRI.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def infer_version(iri, version_iri):\n    \"\"\"Infer version from IRI and versionIRI.\"\"\"\n    if str(version_iri[: len(iri)]) == str(iri):\n        version = version_iri[len(iri) :].lstrip(\"/\")\n    else:\n        j = 0\n        version_parts = []\n        for i, char in enumerate(iri):\n            while i + j &lt; len(version_iri) and char != version_iri[i + j]:\n                version_parts.append(version_iri[i + j])\n                j += 1\n        version = \"\".join(version_parts).lstrip(\"/\").rstrip(\"/#\")\n\n    if \"/\" in version:\n        raise ValueError(\n            f\"version IRI {version_iri!r} is not consistent with base IRI \"\n            f\"{iri!r}\"\n        )\n    return version\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.isinteractive","title":"<code>isinteractive()</code>","text":"<p>Returns true if we are running from an interactive interpreater, false otherwise.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def isinteractive():\n    \"\"\"Returns true if we are running from an interactive interpreater,\n    false otherwise.\"\"\"\n    return bool(\n        hasattr(__builtins__, \"__IPYTHON__\")\n        or sys.flags.interactive\n        or hasattr(sys, \"ps1\")\n    )\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.normalise_url","title":"<code>normalise_url(url)</code>","text":"<p>Returns <code>url</code> in a normalised form.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def normalise_url(url):\n    \"\"\"Returns `url` in a normalised form.\"\"\"\n    splitted = urllib.parse.urlsplit(url)\n    components = list(splitted)\n    components[2] = os.path.normpath(splitted.path)\n    return urllib.parse.urlunsplit(components)\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.read_catalog","title":"<code>read_catalog(uri, catalog_file='catalog-v001.xml', baseuri=None, recursive=False, relative_to=None, return_paths=False, visited_iris=None, visited_paths=None)</code>","text":"<p>Reads a Prot\u00e8g\u00e8 catalog file and returns as a dict.</p> <p>The returned dict maps the ontology IRI (name) to its actual location (URI).  The location can be either an absolute file path or a HTTP, HTTPS or FTP web location.</p> <p><code>uri</code> is a string locating the catalog file. It may be a http or https web location or a file path.</p> <p>The <code>catalog_file</code> argument spesifies the catalog file name and is used if <code>path</code> is used when <code>recursive</code> is true or when <code>path</code> is a directory.</p> <p>If <code>baseuri</code> is not None, it will be used as the base URI for the mapped locations.  Otherwise it defaults to <code>uri</code> with its final component omitted.</p> <p>If <code>recursive</code> is true, catalog files in sub-folders are also read.</p> <p>if <code>relative_to</code> is given, the paths in the returned dict will be relative to this path.</p> <p>If <code>return_paths</code> is true, a set of directory paths to source files is returned in addition to the default dict.</p> <p>The <code>visited_uris</code> and <code>visited_paths</code> arguments are only intended for internal use to avoid infinite recursions.</p> <p>A ReadCatalogError is raised if the catalog file cannot be found.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def read_catalog(  # pylint: disable=too-many-locals,too-many-statements,too-many-arguments\n    uri,\n    catalog_file=\"catalog-v001.xml\",\n    baseuri=None,\n    recursive=False,\n    relative_to=None,\n    return_paths=False,\n    visited_iris=None,\n    visited_paths=None,\n):\n    \"\"\"Reads a Prot\u00e8g\u00e8 catalog file and returns as a dict.\n\n    The returned dict maps the ontology IRI (name) to its actual\n    location (URI).  The location can be either an absolute file path\n    or a HTTP, HTTPS or FTP web location.\n\n    `uri` is a string locating the catalog file. It may be a http or\n    https web location or a file path.\n\n    The `catalog_file` argument spesifies the catalog file name and is\n    used if `path` is used when `recursive` is true or when `path` is a\n    directory.\n\n    If `baseuri` is not None, it will be used as the base URI for the\n    mapped locations.  Otherwise it defaults to `uri` with its final\n    component omitted.\n\n    If `recursive` is true, catalog files in sub-folders are also read.\n\n    if `relative_to` is given, the paths in the returned dict will be\n    relative to this path.\n\n    If `return_paths` is true, a set of directory paths to source\n    files is returned in addition to the default dict.\n\n    The `visited_uris` and `visited_paths` arguments are only intended for\n    internal use to avoid infinite recursions.\n\n    A ReadCatalogError is raised if the catalog file cannot be found.\n    \"\"\"\n    # pylint: disable=too-many-branches\n\n    # Protocols supported by urllib.request\n    web_protocols = \"http://\", \"https://\", \"ftp://\"\n    uri = str(uri)  # in case uri is a pathlib.Path object\n    iris = visited_iris if visited_iris else {}\n    dirs = visited_paths if visited_paths else set()\n    if uri in iris:\n        return (iris, dirs) if return_paths else iris\n\n    if uri.startswith(web_protocols):\n        # Call read_catalog() recursively to ensure that the temporary\n        # file is properly cleaned up\n        with tempfile.TemporaryDirectory() as tmpdir:\n            destfile = os.path.join(tmpdir, catalog_file)\n            uris = {  # maps uri to base\n                uri: (baseuri if baseuri else os.path.dirname(uri)),\n                f'{uri.rstrip(\"/\")}/{catalog_file}': (\n                    baseuri if baseuri else uri.rstrip(\"/\")\n                ),\n                f\"{os.path.dirname(uri)}/{catalog_file}\": (\n                    os.path.dirname(uri)\n                ),\n            }\n            for url, base in uris.items():\n                try:\n                    # The URL can only contain the schemes from `web_protocols`.\n                    _, msg = urllib.request.urlretrieve(url, destfile)  # nosec\n                except urllib.request.URLError:\n                    continue\n                else:\n                    if \"Content-Length\" not in msg:\n                        continue\n\n                    return read_catalog(\n                        destfile,\n                        catalog_file=catalog_file,\n                        baseuri=baseuri if baseuri else base,\n                        recursive=recursive,\n                        return_paths=return_paths,\n                        visited_iris=iris,\n                        visited_paths=dirs,\n                    )\n            raise ReadCatalogError(\n                \"Cannot download catalog from URLs: \" + \", \".join(uris)\n            )\n    elif uri.startswith(\"file://\"):\n        path = uri[7:]\n    else:\n        path = uri\n\n    if os.path.isdir(path):\n        dirname = os.path.abspath(path)\n        filepath = os.path.join(dirname, catalog_file)\n    else:\n        catalog_file = os.path.basename(path)\n        filepath = os.path.abspath(path)\n        dirname = os.path.dirname(filepath)\n\n    def gettag(entity):\n        return entity.tag.rsplit(\"}\", 1)[-1]\n\n    def load_catalog(filepath):\n        if not os.path.exists(filepath):\n            raise ReadCatalogError(\"No such catalog file: \" + filepath)\n        dirname = os.path.normpath(os.path.dirname(filepath))\n        dirs.add(baseuri if baseuri else dirname)\n        xml = ET.parse(filepath)\n        root = xml.getroot()\n        if gettag(root) != \"catalog\":\n            raise ReadCatalogError(\n                f\"expected root tag of catalog file {filepath!r} to be \"\n                '\"catalog\"'\n            )\n        for child in root:\n            if gettag(child) == \"uri\":\n                load_uri(child, dirname)\n            elif gettag(child) == \"group\":\n                for uri in child:\n                    load_uri(uri, dirname)\n\n    def load_uri(uri, dirname):\n        if gettag(uri) != \"uri\":\n            raise ValueError(f\"{gettag(uri)!r} should be 'uri'.\")\n        uri_as_str = uri.attrib[\"uri\"]\n        if uri_as_str.startswith(web_protocols):\n            url = uri_as_str\n        else:\n            uri_as_str = os.path.normpath(uri_as_str)\n            if baseuri and baseuri.startswith(web_protocols):\n                url = f\"{baseuri}/{uri_as_str}\"\n            else:\n                url = os.path.join(baseuri if baseuri else dirname, uri_as_str)\n\n        iris.setdefault(uri.attrib[\"name\"], url)\n        if recursive:\n            directory = os.path.dirname(url)\n            if directory not in dirs:\n                catalog = os.path.join(directory, catalog_file)\n                if catalog.startswith(web_protocols):\n                    iris_, dirs_ = read_catalog(\n                        catalog,\n                        catalog_file=catalog_file,\n                        baseuri=None,\n                        recursive=recursive,\n                        return_paths=True,\n                        visited_iris=iris,\n                        visited_paths=dirs,\n                    )\n                    iris.update(iris_)\n                    dirs.update(dirs_)\n                else:\n                    load_catalog(catalog)\n\n    load_catalog(filepath)\n\n    if relative_to:\n        for iri, path in iris.items():\n            iris[iri] = os.path.relpath(path, relative_to)\n\n    if return_paths:\n        return iris, dirs\n    return iris\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.rename_iris","title":"<code>rename_iris(onto, annotation='prefLabel')</code>","text":"<p>For IRIs with the given annotation, change the name of the entity to the value of the annotation.  Also add an <code>skos:exactMatch</code> annotation referring to the old IRI.</p> Source code in <code>ontopy/utils.py</code> <pre><code>def rename_iris(onto, annotation=\"prefLabel\"):\n    \"\"\"For IRIs with the given annotation, change the name of the entity\n    to the value of the annotation.  Also add an `skos:exactMatch`\n    annotation referring to the old IRI.\n    \"\"\"\n    exactMatch = onto._abbreviate(  # pylint:disable=invalid-name\n        \"http://www.w3.org/2004/02/skos/core#exactMatch\"\n    )\n    for entity in onto.get_entities():\n        if hasattr(entity, annotation) and getattr(entity, annotation):\n            onto._add_data_triple_spod(\n                entity.storid, exactMatch, entity.iri, \"\"\n            )\n            entity.name = getattr(entity, annotation).first()\n</code></pre>"},{"location":"api_reference/ontopy/utils/#ontopy.utils.write_catalog","title":"<code>write_catalog(irimap, output='catalog-v001.xml', directory='.', relative_paths=True, append=False)</code>","text":"<p>Write catalog file do disk.</p> <p>Parameters:</p> Name Type Description Default <code>irimap</code> <code>dict</code> <p>dict mapping ontology IRIs (name) to actual locations (URIs).  It has the same format as the dict returned by read_catalog().</p> required <code>output</code> <code>Union[str, Path]</code> <p>name of catalog file.</p> <code>'catalog-v001.xml'</code> <code>directory</code> <code>Union[str, Path]</code> <p>directory path to the catalog file.  Only used if <code>output</code> is a relative path.</p> <code>'.'</code> <code>relative_paths</code> <code>bool</code> <p>whether to write file paths inside the catalog as relative paths (instead of  absolute paths).</p> <code>True</code> <code>append</code> <code>bool</code> <p>whether to append to a possible existing catalog file. If false, an existing file will be overwritten.</p> <code>False</code> Source code in <code>ontopy/utils.py</code> <pre><code>def write_catalog(\n    irimap: dict,\n    output: \"Union[str, Path]\" = \"catalog-v001.xml\",\n    directory: \"Union[str, Path]\" = \".\",\n    relative_paths: bool = True,\n    append: bool = False,\n):  # pylint: disable=redefined-builtin\n    \"\"\"Write catalog file do disk.\n\n    Args:\n        irimap: dict mapping ontology IRIs (name) to actual locations\n            (URIs).  It has the same format as the dict returned by\n            read_catalog().\n        output: name of catalog file.\n        directory: directory path to the catalog file.  Only used if `output`\n            is a relative path.\n        relative_paths: whether to write file paths inside the catalog as\n            relative paths (instead of  absolute paths).\n        append: whether to append to a possible existing catalog file.\n            If false, an existing file will be overwritten.\n    \"\"\"\n    filename = Path(directory) / output\n\n    if relative_paths:\n        irimap = irimap.copy()  # don't modify provided irimap\n        for iri, path in irimap.items():\n            if os.path.isabs(path):\n                irimap[iri] = os.path.relpath(path, filename.parent)\n\n    if filename.exists() and append:\n        iris = read_catalog(filename)\n        iris.update(irimap)\n        irimap = iris\n\n    res = [\n        '&lt;?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?&gt;',\n        '&lt;catalog prefer=\"public\" '\n        'xmlns=\"urn:oasis:names:tc:entity:xmlns:xml:catalog\"&gt;',\n        '    &lt;group id=\"Folder Repository, directory=, recursive=true, '\n        'Auto-Update=false, version=2\" prefer=\"public\" xml:base=\"\"&gt;',\n    ]\n    for iri, path in irimap.items():\n        res.append(f'        &lt;uri name=\"{iri}\" uri=\"{path}\"/&gt;')\n    res.append(\"    &lt;/group&gt;\")\n    res.append(\"&lt;/catalog&gt;\")\n    with open(filename, \"wt\") as handle:\n        handle.write(\"\\n\".join(res) + \"\\n\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/","title":"factppgraph","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph--ontopyfactpluspluswrapperfactppgraph","title":"<code>ontopy.factpluspluswrapper.factppgraph</code>","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph","title":"<code> FaCTPPGraph        </code>","text":"<p>Class for running the FaCT++ reasoner (using OwlApiInterface) and postprocessing the resulting inferred ontology.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph--parameters","title":"Parameters","text":"<p>graph : owlapi.Graph instance     The graph to be inferred.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>class FaCTPPGraph:\n    \"\"\"Class for running the FaCT++ reasoner (using OwlApiInterface) and\n    postprocessing the resulting inferred ontology.\n\n    Parameters\n    ----------\n    graph : owlapi.Graph instance\n        The graph to be inferred.\n    \"\"\"\n\n    def __init__(self, graph):\n        self.graph = graph\n        self._inferred = None\n        self._namespaces = None\n        self._base_iri = None\n\n    @property\n    def inferred(self):\n        \"\"\"The current inferred graph.\"\"\"\n        if self._inferred is None:\n            self._inferred = self.raw_inferred_graph()\n        return self._inferred\n\n    @property\n    def base_iri(self):\n        \"\"\"Base iri of inferred ontology.\"\"\"\n        if self._base_iri is None:\n            self._base_iri = URIRef(self.asserted_base_iri() + \"-inferred\")\n        return self._base_iri\n\n    @base_iri.setter\n    def base_iri(self, value):\n        \"\"\"Assign inferred base iri.\"\"\"\n        self._base_iri = URIRef(value)\n\n    @property\n    def namespaces(self):\n        \"\"\"Namespaces defined in the original graph.\"\"\"\n        if self._namespaces is None:\n            self._namespaces = dict(self.graph.namespaces()).copy()\n            self._namespaces[\"\"] = self.base_iri\n        return self._namespaces\n\n    def asserted_base_iri(self):\n        \"\"\"Returns the base iri or the original graph.\"\"\"\n        return URIRef(dict(self.graph.namespaces()).get(\"\", \"\").rstrip(\"#/\"))\n\n    def raw_inferred_graph(self):\n        \"\"\"Returns the raw non-postprocessed inferred ontology as a rdflib\n        graph.\"\"\"\n        return OwlApiInterface().reason(self.graph)\n\n    def inferred_graph(self):\n        \"\"\"Returns the postprocessed inferred graph.\"\"\"\n        self.add_base_annotations()\n        self.set_namespace()\n        self.clean_base()\n        self.remove_nothing_is_nothing()\n        self.clean_ancestors()\n        return self.inferred\n\n    def add_base_annotations(self):\n        \"\"\"Copy base annotations from original graph to the inferred graph.\"\"\"\n        base = self.base_iri\n        inferred = self.inferred\n        for _, predicate, obj in self.graph.triples(\n            (self.asserted_base_iri(), None, None)\n        ):\n            if predicate == OWL.versionIRI:\n                version = obj.rsplit(\"/\", 1)[-1]\n                obj = URIRef(f\"{base}/{version}\")\n            inferred.add((base, predicate, obj))\n\n    def set_namespace(self):\n        \"\"\"Override namespace of inferred graph with the namespace of the\n        original graph.\n        \"\"\"\n        inferred = self.inferred\n        for key, value in self.namespaces.items():\n            inferred.namespace_manager.bind(\n                key, value, override=True, replace=True\n            )\n\n    def clean_base(self):\n        \"\"\"Remove all relations `s? a owl:Ontology` where `s?` is not\n        `base_iri`.\n        \"\"\"\n        inferred = self.inferred\n        for (\n            subject,\n            predicate,\n            obj,\n        ) in inferred.triples(  # pylint: disable=not-an-iterable\n            (None, RDF.type, OWL.Ontology)\n        ):\n            inferred.remove((subject, predicate, obj))\n        inferred.add((self.base_iri, RDF.type, OWL.Ontology))\n\n    def remove_nothing_is_nothing(self):\n        \"\"\"Remove superfluid relation in inferred graph:\n\n        owl:Nothing rdfs:subClassOf owl:Nothing\n        \"\"\"\n        triple = OWL.Nothing, RDFS.subClassOf, OWL.Nothing\n        inferred = self.inferred\n        if triple in inferred:\n            inferred.remove(triple)\n\n    def clean_ancestors(self):\n        \"\"\"Remove redundant rdfs:subClassOf relations in inferred graph.\"\"\"\n        inferred = self.inferred\n        for (  # pylint: disable=too-many-nested-blocks\n            subject\n        ) in inferred.subjects(RDF.type, OWL.Class):\n            if isinstance(subject, URIRef):\n                parents = set(\n                    parent\n                    for parent in inferred.objects(subject, RDFS.subClassOf)\n                    if isinstance(parent, URIRef)\n                )\n                if len(parents) &gt; 1:\n                    for parent in parents:\n                        ancestors = set(\n                            inferred.transitive_objects(parent, RDFS.subClassOf)\n                        )\n                        for entity in parents:\n                            if entity != parent and entity in ancestors:\n                                triple = subject, RDFS.subClassOf, entity\n                                if triple in inferred:\n                                    inferred.remove(triple)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.base_iri","title":"<code>base_iri</code>  <code>property</code> <code>writable</code>","text":"<p>Base iri of inferred ontology.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.inferred","title":"<code>inferred</code>  <code>property</code> <code>readonly</code>","text":"<p>The current inferred graph.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.namespaces","title":"<code>namespaces</code>  <code>property</code> <code>readonly</code>","text":"<p>Namespaces defined in the original graph.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.add_base_annotations","title":"<code>add_base_annotations(self)</code>","text":"<p>Copy base annotations from original graph to the inferred graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def add_base_annotations(self):\n    \"\"\"Copy base annotations from original graph to the inferred graph.\"\"\"\n    base = self.base_iri\n    inferred = self.inferred\n    for _, predicate, obj in self.graph.triples(\n        (self.asserted_base_iri(), None, None)\n    ):\n        if predicate == OWL.versionIRI:\n            version = obj.rsplit(\"/\", 1)[-1]\n            obj = URIRef(f\"{base}/{version}\")\n        inferred.add((base, predicate, obj))\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.asserted_base_iri","title":"<code>asserted_base_iri(self)</code>","text":"<p>Returns the base iri or the original graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def asserted_base_iri(self):\n    \"\"\"Returns the base iri or the original graph.\"\"\"\n    return URIRef(dict(self.graph.namespaces()).get(\"\", \"\").rstrip(\"#/\"))\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.clean_ancestors","title":"<code>clean_ancestors(self)</code>","text":"<p>Remove redundant rdfs:subClassOf relations in inferred graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def clean_ancestors(self):\n    \"\"\"Remove redundant rdfs:subClassOf relations in inferred graph.\"\"\"\n    inferred = self.inferred\n    for (  # pylint: disable=too-many-nested-blocks\n        subject\n    ) in inferred.subjects(RDF.type, OWL.Class):\n        if isinstance(subject, URIRef):\n            parents = set(\n                parent\n                for parent in inferred.objects(subject, RDFS.subClassOf)\n                if isinstance(parent, URIRef)\n            )\n            if len(parents) &gt; 1:\n                for parent in parents:\n                    ancestors = set(\n                        inferred.transitive_objects(parent, RDFS.subClassOf)\n                    )\n                    for entity in parents:\n                        if entity != parent and entity in ancestors:\n                            triple = subject, RDFS.subClassOf, entity\n                            if triple in inferred:\n                                inferred.remove(triple)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.clean_base","title":"<code>clean_base(self)</code>","text":"<p>Remove all relations <code>s? a owl:Ontology</code> where <code>s?</code> is not <code>base_iri</code>.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def clean_base(self):\n    \"\"\"Remove all relations `s? a owl:Ontology` where `s?` is not\n    `base_iri`.\n    \"\"\"\n    inferred = self.inferred\n    for (\n        subject,\n        predicate,\n        obj,\n    ) in inferred.triples(  # pylint: disable=not-an-iterable\n        (None, RDF.type, OWL.Ontology)\n    ):\n        inferred.remove((subject, predicate, obj))\n    inferred.add((self.base_iri, RDF.type, OWL.Ontology))\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.inferred_graph","title":"<code>inferred_graph(self)</code>","text":"<p>Returns the postprocessed inferred graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def inferred_graph(self):\n    \"\"\"Returns the postprocessed inferred graph.\"\"\"\n    self.add_base_annotations()\n    self.set_namespace()\n    self.clean_base()\n    self.remove_nothing_is_nothing()\n    self.clean_ancestors()\n    return self.inferred\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.raw_inferred_graph","title":"<code>raw_inferred_graph(self)</code>","text":"<p>Returns the raw non-postprocessed inferred ontology as a rdflib graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def raw_inferred_graph(self):\n    \"\"\"Returns the raw non-postprocessed inferred ontology as a rdflib\n    graph.\"\"\"\n    return OwlApiInterface().reason(self.graph)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.remove_nothing_is_nothing","title":"<code>remove_nothing_is_nothing(self)</code>","text":"<p>Remove superfluid relation in inferred graph:</p> <p>owl:Nothing rdfs:subClassOf owl:Nothing</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def remove_nothing_is_nothing(self):\n    \"\"\"Remove superfluid relation in inferred graph:\n\n    owl:Nothing rdfs:subClassOf owl:Nothing\n    \"\"\"\n    triple = OWL.Nothing, RDFS.subClassOf, OWL.Nothing\n    inferred = self.inferred\n    if triple in inferred:\n        inferred.remove(triple)\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FaCTPPGraph.set_namespace","title":"<code>set_namespace(self)</code>","text":"<p>Override namespace of inferred graph with the namespace of the original graph.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>def set_namespace(self):\n    \"\"\"Override namespace of inferred graph with the namespace of the\n    original graph.\n    \"\"\"\n    inferred = self.inferred\n    for key, value in self.namespaces.items():\n        inferred.namespace_manager.bind(\n            key, value, override=True, replace=True\n        )\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/factppgraph/#ontopy.factpluspluswrapper.factppgraph.FactPPError","title":"<code> FactPPError        </code>","text":"<p>Postprocessing error after reasoning with FaCT++.</p> Source code in <code>ontopy/factpluspluswrapper/factppgraph.py</code> <pre><code>class FactPPError:\n    \"\"\"Postprocessing error after reasoning with FaCT++.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/","title":"owlapi_interface","text":"<p>Python interface to the FaCT++ Reasoner.</p> <p>This module is copied from the SimPhoNy project.</p> <p>Original author: Matthias Urban</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface","title":"<code> OwlApiInterface        </code>","text":"<p>Interface to the FaCT++ reasoner via OWLAPI.</p> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>class OwlApiInterface:\n    \"\"\"Interface to the FaCT++ reasoner via OWLAPI.\"\"\"\n\n    def __init__(self):\n        \"\"\"Initialize the interface.\"\"\"\n\n    def reason(self, graph):\n        \"\"\"Generate the inferred axioms for a given Graph.\n\n        Args:\n            graph (Graph): An rdflib graph to execute the reasoner on.\n\n        \"\"\"\n        with tempfile.NamedTemporaryFile(\"wt\") as tmpdir:\n            graph.serialize(tmpdir.name, format=\"xml\")\n            return self._run(tmpdir.name, command=\"--run-reasoner\")\n\n    def reason_files(self, *owl_files):\n        \"\"\"Merge the given owl and generate the inferred axioms.\n\n        Args:\n            *owl_files (os.path): The owl files two merge.\n\n        \"\"\"\n        return self._run(*owl_files, command=\"--run-reasoner\")\n\n    def merge_files(self, *owl_files):\n        \"\"\"Merge the given owl files and its import closure.\n\n        Args:\n            *owl_files (os.path): The owl files two merge.\n\n        \"\"\"\n        return self._run(*owl_files, command=\"--merge-only\")\n\n    @staticmethod\n    def _run(\n        *owl_files, command, output_file=None, return_graph=True\n    ) -&gt; rdflib.Graph:\n        \"\"\"Run the FaCT++ reasoner using a java command.\n\n        Args:\n            *owl_files (str): Path to the owl files to load.\n            command (str): Either --run-reasoner or --merge-only\n            output_file (str, optional): Where the output should be stored.\n                Defaults to None.\n            return_graph (bool, optional): Whether the result should be parsed\n                and returned. Defaults to True.\n\n        Returns:\n            The reasoned result.\n\n        \"\"\"\n        java_base = os.path.abspath(\n            os.path.join(os.path.dirname(__file__), \"java\")\n        )\n        cmd = (\n            [\n                \"java\",\n                \"-cp\",\n                java_base + \"/lib/jars/*\",\n                \"-Djava.library.path=\" + java_base + \"/lib/so\",\n                \"org.simphony.OntologyLoader\",\n            ]\n            + [command]\n            + list(owl_files)\n        )\n        logger.info(\"Running Reasoner\")\n        logger.debug(\"Command %s\", cmd)\n        subprocess.run(cmd, check=True)  # nosec\n\n        graph = None\n        if return_graph:\n            graph = rdflib.Graph()\n            graph.parse(RESULT_FILE)\n        if output_file:\n            os.rename(RESULT_FILE, output_file)\n        else:\n            os.remove(RESULT_FILE)\n        return graph\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.__init__","title":"<code>__init__(self)</code>  <code>special</code>","text":"<p>Initialize the interface.</p> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def __init__(self):\n    \"\"\"Initialize the interface.\"\"\"\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.merge_files","title":"<code>merge_files(self, *owl_files)</code>","text":"<p>Merge the given owl files and its import closure.</p> <p>Parameters:</p> Name Type Description Default <code>*owl_files</code> <code>os.path</code> <p>The owl files two merge.</p> <code>()</code> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def merge_files(self, *owl_files):\n    \"\"\"Merge the given owl files and its import closure.\n\n    Args:\n        *owl_files (os.path): The owl files two merge.\n\n    \"\"\"\n    return self._run(*owl_files, command=\"--merge-only\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.reason","title":"<code>reason(self, graph)</code>","text":"<p>Generate the inferred axioms for a given Graph.</p> <p>Parameters:</p> Name Type Description Default <code>graph</code> <code>Graph</code> <p>An rdflib graph to execute the reasoner on.</p> required Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def reason(self, graph):\n    \"\"\"Generate the inferred axioms for a given Graph.\n\n    Args:\n        graph (Graph): An rdflib graph to execute the reasoner on.\n\n    \"\"\"\n    with tempfile.NamedTemporaryFile(\"wt\") as tmpdir:\n        graph.serialize(tmpdir.name, format=\"xml\")\n        return self._run(tmpdir.name, command=\"--run-reasoner\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.OwlApiInterface.reason_files","title":"<code>reason_files(self, *owl_files)</code>","text":"<p>Merge the given owl and generate the inferred axioms.</p> <p>Parameters:</p> Name Type Description Default <code>*owl_files</code> <code>os.path</code> <p>The owl files two merge.</p> <code>()</code> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def reason_files(self, *owl_files):\n    \"\"\"Merge the given owl and generate the inferred axioms.\n\n    Args:\n        *owl_files (os.path): The owl files two merge.\n\n    \"\"\"\n    return self._run(*owl_files, command=\"--run-reasoner\")\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/owlapi_interface/#ontopy.factpluspluswrapper.owlapi_interface.reason_from_terminal","title":"<code>reason_from_terminal()</code>","text":"<p>Run the reasoner from terminal.</p> Source code in <code>ontopy/factpluspluswrapper/owlapi_interface.py</code> <pre><code>def reason_from_terminal():\n    \"\"\"Run the reasoner from terminal.\"\"\"\n    parser = argparse.ArgumentParser(\n        description=\"Run the FaCT++ reasoner on the given OWL file. \"\n        \"Catalog files are used to load the import closure. \"\n        \"Then the reasoner is executed and the inferred triples are merged \"\n        \"with the asserted ones. If multiple OWL files are given, they are \"\n        \"merged beforehand\"\n    )\n    parser.add_argument(\n        \"owl_file\", nargs=\"+\", help=\"OWL file(s) to run the reasoner on.\"\n    )\n    parser.add_argument(\"output_file\", help=\"Path to store inferred axioms to.\")\n\n    args = parser.parse_args()\n    OwlApiInterface()._run(  # pylint: disable=protected-access\n        *args.owl_file,\n        command=\"--run-reasoner\",\n        return_graph=False,\n        output_file=args.output_file,\n    )\n</code></pre>"},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/","title":"sync_factpp","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/#ontopy.factpluspluswrapper.sync_factpp--ontopyfactpluspluswrappersyncfatpp","title":"<code>ontopy.factpluspluswrapper.syncfatpp</code>","text":""},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/#ontopy.factpluspluswrapper.sync_factpp.sync_reasoner_factpp","title":"<code>sync_reasoner_factpp(ontology_or_world=None, infer_property_values=False, debug=1)</code>","text":"<p>Run FaCT++ reasoner and load the inferred relations back into the owlready2 triplestore.</p>"},{"location":"api_reference/ontopy/factpluspluswrapper/sync_factpp/#ontopy.factpluspluswrapper.sync_factpp.sync_reasoner_factpp--parameters","title":"Parameters","text":"<p>ontology_or_world : None | Ontology instance | World instance | list     Identifies the world to run the reasoner over. infer_property_values : bool     Whether to also infer property values. debug : bool     Whether to print debug info to standard output.</p> Source code in <code>ontopy/factpluspluswrapper/sync_factpp.py</code> <pre><code>def sync_reasoner_factpp(\n    ontology_or_world=None, infer_property_values=False, debug=1\n):\n    \"\"\"Run FaCT++ reasoner and load the inferred relations back into\n    the owlready2 triplestore.\n\n    Parameters\n    ----------\n    ontology_or_world : None | Ontology instance | World instance | list\n        Identifies the world to run the reasoner over.\n    infer_property_values : bool\n        Whether to also infer property values.\n    debug : bool\n        Whether to print debug info to standard output.\n    \"\"\"\n    # pylint: disable=too-many-locals,too-many-branches,too-many-statements\n    if isinstance(ontology_or_world, World):\n        world = ontology_or_world\n    elif isinstance(ontology_or_world, Ontology):\n        world = ontology_or_world.world\n    elif isinstance(ontology_or_world, Sequence):\n        world = ontology_or_world[0].world\n    else:\n        world = owlready2.default_world\n\n    if isinstance(ontology_or_world, Ontology):\n        ontology = ontology_or_world\n    elif CURRENT_NAMESPACES.get():\n        ontology = CURRENT_NAMESPACES.get()[-1].ontology\n    else:\n        ontology = world.get_ontology(_INFERRENCES_ONTOLOGY)\n\n    locked = world.graph.has_write_lock()\n    if locked:\n        world.graph.release_write_lock()  # Not needed during reasoning\n\n    try:\n        if debug:\n            print(\"*** Prepare graph\")\n        # Exclude owl:imports because they are not needed and can\n        # cause trouble when loading the inferred ontology\n        graph1 = rdflib.Graph()\n        for subject, predicate, obj in world.as_rdflib_graph().triples(\n            (None, None, None)\n        ):\n            if predicate != OWL.imports:\n                graph1.add((subject, predicate, obj))\n\n        if debug:\n            print(\"*** Run FaCT++ reasoner (and postprocess)\")\n        graph2 = FaCTPPGraph(graph1).inferred_graph()\n\n        if debug:\n            print(\"*** Load inferred ontology\")\n        # Check all rdfs:subClassOf relations in the inferred graph and add\n        # them to the world if they are missing\n        new_parents = defaultdict(list)\n        new_equivs = defaultdict(list)\n        entity_2_type = {}\n\n        for (\n            subject,\n            predicate,\n            obj,\n        ) in graph2.triples(  # pylint: disable=not-an-iterable\n            (None, None, None)\n        ):\n            if (\n                isinstance(subject, URIRef)\n                and predicate in OWL_2_TYPE\n                and isinstance(obj, URIRef)\n            ):\n                s_storid = ontology._abbreviate(str(subject), False)\n                p_storid = ontology._abbreviate(str(predicate), False)\n                o_storid = ontology._abbreviate(str(obj), False)\n                if (\n                    s_storid is not None\n                    and p_storid is not None\n                    and o_storid is not None\n                ):\n                    if predicate in (\n                        RDFS.subClassOf,\n                        RDFS.subPropertyOf,\n                        RDF.type,\n                    ):\n                        new_parents[s_storid].append(o_storid)\n                        entity_2_type[s_storid] = OWL_2_TYPE[predicate]\n                    else:\n                        new_equivs[s_storid].append(o_storid)\n                        entity_2_type[s_storid] = OWL_2_TYPE[predicate]\n\n        if infer_property_values:\n            inferred_obj_relations = []\n            # Hmm, does FaCT++ infer any property values?\n            # If not, remove the `infer_property_values` keyword argument.\n            raise NotImplementedError\n\n    finally:\n        if locked:\n            world.graph.acquire_write_lock()  # re-lock when applying results\n\n    if debug:\n        print(\"*** Applying reasoning results\")\n\n    _apply_reasoning_results(\n        world, ontology, debug, new_parents, new_equivs, entity_2_type\n    )\n    if infer_property_values:\n        _apply_inferred_obj_relations(\n            world, ontology, debug, inferred_obj_relations\n        )\n</code></pre>"},{"location":"demo/","title":"EMMO use cases","text":"<p>This demo contains two use cases on how EMMO can be used to achieve vertical and horizontal interpoerability, respectivily.</p> <p>Warning</p> <p>This demonstration is still work in progress. Especially documentation is lacking.</p>"},{"location":"demo/#content","title":"Content","text":"<ul> <li>Vertical interoperability.</li> <li>Horizontal interoperability.</li> </ul>"},{"location":"demo/#the-user-case-welding-an-aluminium-plate-to-steel","title":"The user case - welding an aluminium plate to steel","text":""},{"location":"demo/horizontal/","title":"EMMO use case for horizontal interoperability","text":"<p>Horizontal interoperability is about interoperability between different types of models and codes for a single material (i.e., one use case, multiple models).</p> <p>The key here is to show how to map between EMMO (or an EMMO-based ontology) and another ontology (possible EMMO-based).</p> <p>In this example we use a data-driven approach based on a C-implementation of SOFT<sup>1,2</sup>.</p> <p>This is done in four steps:</p> <ol> <li> <p>Generate metadata from the EMMO-based user case ontology.</p> <p>Implemented in the script step1_generate_metadata.py.</p> </li> <li> <p>Define metadata for an application developed independently of EMMO.</p> <p>In this case a metadata description of the ASE Atoms class 3 is created in <code>atoms.json</code>.</p> <p>Implemented in the script step2_define_metadata.py.</p> </li> <li> <p>Instantiate the metadata defined defined in step 2 with an atomistic structure interface structure.</p> <p>Implemented in the script step3_instantiate.py.</p> </li> <li> <p>Map the atomistic interface structure from the application representation to the common EMMO-based representation.</p> <p>Implemented in the script step4_map_instance.py.</p> </li> </ol> <p>Essentially, this demonstration shows how EMMO can be extended and how external data can be mapped into our extended ontology (serving as a common representational system).</p>"},{"location":"demo/horizontal/#requirements-for-running-the-user-case","title":"Requirements for running the user case","text":"<p>In addition to emmo, this demo also requires:</p> <ul> <li>DLite, a C-implementation of SOFT used for handling metadata</li> <li>ASE, for reading atom structure from cif and visualisation</li> </ul>"},{"location":"demo/vertical/","title":"EMMO use case for vertical interoperability","text":"<p>Vertical interoperability is about interoperability across two or more granulaty levels.</p> <p>In this use case we study the welded interface between an aluminium and a steel plate at three granularity levels. In this case, the granularity levels corresponds to three different length scales, that we here denote component, microstructure and atomistic scale.</p>"},{"location":"demo/vertical/#creating-an-emmo-based-user-case-ontology","title":"Creating an EMMO-based user case ontology","text":"<p>The script define_ontology.py uses the Python API for EMMO to generate an application ontology extending EMMO with additional concepts needed to describe the data that is exchanged between scales. The user case ontology can then be visualised with the script plot_ontology.py.</p>"},{"location":"demo/vertical/#defining-the-needed-material-entities","title":"Defining the needed material entities","text":""},{"location":"demo/vertical/#assigning-properties-to-material-entities","title":"Assigning properties to material entities","text":"<p>Note that we here also assign properties to <code>e-bonded_atom</code>, even though <code>e-bonded_atom</code> is defined in EMMO.</p> <p></p>"},{"location":"demo/vertical/#assigning-units-to-properties","title":"Assigning units to properties","text":"<p>We choose here to consistently use SI units for all scales (even though at the atomistic scale units like \u00c5ngstr\u00f6m and electron volt are more commonly used).</p> <p></p>"},{"location":"demo/vertical/#assigning-types-to-properties","title":"Assigning types to properties","text":"<p>In order to be able to generate metadata and to describe the actual data transferred between scales, we also need to define types.</p> <p></p>"},{"location":"demo/vertical/#the-new-application-ontology","title":"The new application-ontology","text":"<p>The final plot shows the user case ontology in context of EMMO.</p> <p></p>"},{"location":"developers/release-instructions/","title":"Steps for creating a new release","text":"<ol> <li> <p>Create a release on GitHub with a short release description.</p> <p>Ensure you add a <code># &lt;version number&gt;</code> title to the description.</p> <p>Set the tag to the version number prefixed with <code>\"v\"</code> and title to the version number as explained above.</p> </li> <li> <p>Ensure the GitHub Action CD workflows run as expected.</p> </li> </ol> <p>The workflow failed</p> <p>If something is wrong and the workflow fails before publishing the package to PyPI, make sure to remove all traces of the release and tag, fix the bug, and try again.</p> <p>If something is wrong and the workflow fails after publishing the package to PyPI: DO NOT REMOVE THE RELEASE OR TAG !</p> <p>Deployment of the documentation should (in theory) be the only thing that has failed. This can be deployed manually using similar steps as in the workflow.</p>"},{"location":"developers/setup/","title":"Development environment","text":"<p>This section outlines some suggestions as well as conventions used by the EMMOntoPy developers, which should be considered or followed if one wants to contribute to the package.</p>"},{"location":"developers/setup/#setup","title":"Setup","text":"<p>Requirements</p> <p>This section expects you to be running on a Unix-like system (e.g., Linux) with minimum Python 3.7.</p>"},{"location":"developers/setup/#virtual-environment","title":"Virtual environment","text":"<p>Since development can be messy, it is good to separate the development environment from the rest of your system's environment.</p> <p>To do this, you can use a virtual environment. There are a several different ways to create a virtual environment, but we recommend using either <code>virtualenv</code> or <code>venv</code>.</p> <p>Virtual environment considerations</p> <p>There are several different virtual environment setups, here we only address a very few.</p> <p>A great resource for an overview can be found in this StackOverflow answer. However, note that in the end, it is very subjective on the solution one uses and one is not necessarily \"better\" than another.</p> <code>virtualenv</code> (recommended)<code>venv</code> <p>To install <code>virtualenv</code>+<code>virtualenvwrapper</code> run:</p> <pre><code>$ pip install virtualenvwrapper\n</code></pre> <p>There is other setup, most of which only needs to be run once. For more information about this, see the <code>virtualenvwrapper</code> documentation.</p> <p>After successfully setting up <code>virtualenv</code> through <code>virtualenvwrapper</code>, you can create a new virtual environment:</p> <pre><code>$ mkproject -p python3.7 emmo-python\n</code></pre> <p>Note</p> <p>If you do not have Python 3.7 installed (or instead want to use your system's default Python version), you can leave out the extra <code>-p python3.7</code> argument. Or you can choose to use another version of Python by changing this argument to another (valid) python interpreter.</p> <p>Then, if the virtual environment has not been activated automatically (you should see the name <code>emmo-python</code> in a parenthesis in your console), you can run:</p> <pre><code>$ workon emmo-python\n</code></pre> <p>Tip</p> <p>You can quickly see a list of all your virtual environments by writing <code>workon</code> and pressing Tab twice.</p> <p>To deactivate the virtual environment, returning to the system/global environment again, run:</p> <pre><code>(emmo-python) $ deactivate\n</code></pre> <p><code>venv</code> is a built-in package in Python, which works similar to <code>virtualenv</code>, but with fewer capabilities.</p> <p>To create a new virtual environment with <code>venv</code>, first go to the directory, where you desire to keep your virtual environment. Then run the <code>venv</code> module using the Python interpreter you wish to use in the virtual environment. For Python 3.7 this would look like the following:</p> <pre><code>$ python3.7 -m venv emmo-python\n</code></pre> <p>A folder with the name <code>emmo-python</code> containing the environment is created.</p> <p>To activate the environment run:</p> <pre><code>$ ./emmo-python/activate\n</code></pre> <p>or</p> <pre><code>$ /path/to/emmo-python/activate\n</code></pre> <p>You should now see the name <code>emmo-python</code> in a parenthesis in your console, letting you know you have activated and are currently using the <code>emmo-python</code> virtual environment.</p> <p>To deactivate the virtual environment, returning to the system/global environment again, run:</p> <pre><code>(emmo-python) $ deactivate\n</code></pre> <p>Expectation</p> <p>From here on, all commands expect you to have activated your virtual environment, if you are using one, unless stated otherwise.</p>"},{"location":"developers/setup/#installation","title":"Installation","text":"<p>To install the package, please do not install from PyPI. Instead you should clone the repository from GitHub:</p> <pre><code>$ git clone https://github.com/emmo-repo/EMMOntoPy.git\n</code></pre> <p>or, if you are using an SSH connection to GitHub, you can instead clone via:</p> <pre><code>$ git clone git@github.com:emmo-repo/EMMOntoPy.git\n</code></pre> <p>Then enter into the newly cloned <code>EMMOntoPy</code> directory (<code>cd EMMOntoPy</code>) and run:</p> <pre><code>$ pip install -U -e .[dev]\n$ pre-commit install\n</code></pre> <p>This will install the EMMOntoPy Python package, including all dependencies and requirements for building and serving (locally) the documentation and running unit tests.</p> <p>The second line installs the <code>pre-commit</code> hooks defined in the <code>.pre-commit-config.yaml</code> file. <code>pre-commit</code> is a tool that runs immediately prior to you creating new commits (<code>git commit</code>), and checks all the changes, automatically updates the API reference in the documentation and much more. Mainly, it helps to ensure that the package stays nicely formattet, safe, and user-friendly for developers.</p>"},{"location":"developers/setup/#non-python-dependencies","title":"Non-Python dependencies","text":"<p>There are a few non-Python dependencies that EMMOntoPy relies on as well. These can be installed by running (on a Debian system):</p> <pre><code>$ sudo apt-get update &amp;&amp; sudo apt-get install -y graphviz openjdk-11-jre-headless\n</code></pre> <p>If you are on a non-Debian system (Debian, Ubuntu, ...), please check which package manager you are using and find packages for <code>graphviz</code> and <code>openjdk</code> minimum version 11.</p>"},{"location":"developers/setup/#test-the-installation","title":"Test the installation","text":"<p>It is good practice to test the integrity of the installation and that all necessary dependencies are correctly installed.</p> <p>You can run unit tests, to check the integrity of the Python functionality, by running:</p> <pre><code>$ pytest\n</code></pre> <p>If all has installed and is running correctly, you should not have any failures, but perhaps some warnings (deprecation warnings) in the test summary.</p>"},{"location":"developers/testing/","title":"Testing and tooling","text":""},{"location":"developers/testing/#unit-testing","title":"Unit testing","text":"<p>The PyTest framework is used for testing the EMMOntoPy package. It is a unit testing framework with a plugin system, sporting an extensive plugin library as well as a sound fixture injection system.</p> <p>To run the tests locally install the package with the <code>dev</code> extra (see the developer's setup guide) and run:</p> <pre><code>$ pytest\n=== test session starts ===\n...\n</code></pre> <p>To understand what options you have, run <code>pytest --help</code>.</p>"},{"location":"developers/testing/#tools","title":"Tools","text":"<p>Several tools are used to maintain the package, keeping it secure, readable, and easing maintenance.</p>"},{"location":"developers/testing/#mypy","title":"Mypy","text":"<p>Mypy is a static type checker for Python.</p> <p>Documentation: mypy.readthedocs.io</p> <p>The signs of this tool will be found in the code especially through the <code>typing.TYPE_CHECKING</code> boolean variable, which will be used in the current way:</p> <pre><code>from typing import TYPE_CHECKING\n\nif TYPE_CHECKING:\n    from typing import List\n</code></pre> <p>Since <code>TYPE_CHECKING</code> is <code>False</code> at runtime, the <code>if</code>-block will not be run as part of running the script or module or if importing the module. However, when Mypy runs to check the static typing, it forcefully runs these blocks, considering <code>TYPE_CHECKING</code> to be <code>True</code> (see the <code>typing.TYPE_CHECKING</code> section in the Mypy documentation).</p> <p>This means the imports in the <code>if</code>-block are meant to only be used for static typing, helping developers to understand the intention of the code as well as to check the invoked methods make sense (through Mypy).</p>"},{"location":"examples/emmodoc/","title":"Generate documentation for EMMO","text":"<p>This directory contains the needed templates, introductory text and figures for generating the full EMMO documentation using <code>ontodoc</code>. Since the introduction is written in markdown, pandoc is required for both pdf and html generation.</p> <p>For a standalone html documentation including all inferred relations, enter this directory and run:</p> <pre><code>ontodoc --template=emmo.md --format=html emmo-inferred emmo.html\n</code></pre> <p>Pandoc options may be adjusted with the files pandoc-options.yaml and pandoc-html-options.yaml.</p> <p>Similarly, for generating pdf documentation, enter this directory and run:</p> <pre><code>ontodoc --template=emmo.md emmo-inferred emmo.pdf\n</code></pre> <p>By default, we have configured pandoc to use xelatex for better unicode support. It is possible to change these settings in pandoc-options.yaml and pandoc-pdf-options.yaml.</p>"},{"location":"examples/emmodoc/#content-of-this-directory","title":"Content of this directory","text":""},{"location":"examples/emmodoc/#ontodoc-templates-with-introductory-text-and-document-layout","title":"<code>ontodoc</code> templates with introductory text and document layout","text":"<ul> <li>emmo.md: Main template for EMMO.   It includes the other templates.</li> <li>introduction.md: Introductory text.</li> <li>relations.md: Introduction and sections for Relations chapter.</li> <li>classes.md: Introduction and sections for Classes.</li> <li>figs: Figures used in the introduction.</li> </ul>"},{"location":"examples/emmodoc/#pandoc-configuration-files","title":"<code>pandoc</code> configuration files","text":"<ul> <li>emmodoc-meta.yaml: Metadata for EMMO, like title, authers, abstract, etc.</li> <li>pandoc-options.yaml: General pandoc options.</li> <li>pandoc-html-options.yaml: Additional pandoc options for html generation.</li> <li>pandoc-pdf-options.yaml: Additional pandoc options for pdf generation.</li> <li>pandoc-html.css: css file used for html generation.</li> <li>pandoc-template.html: Modified copy of the standard pandoc html template with a small adjustment for the author list.</li> <li>pandoc-template.tex: Modified copy of the standard pandoc latex template with a small adjustment for the author list.</li> </ul>"},{"location":"examples/emmodoc/#using-this-example-as-a-starting-point-for-documenting-your-own-ontology","title":"Using this example as a starting point for documenting your own ontology","text":"<p>For simple html documentation, you can skip all input files and simply run <code>ontodoc</code> as</p> <pre><code>ontodoc --format=simple-html YOUR_ONTO.owl YOUR_ONTO.html\n</code></pre> <p>It is also possible to include ontodoc templates using the <code>--template</code> option for adding additional information and structure the document. In this case the template may only contain <code>ontodoc</code> pre-processer directives and inline html, but not markdown.</p> <p>In order to produce output in pdf (or any other output format supported by pandoc), you can write your <code>ontodoc</code> template in markdown (with <code>ontodoc</code> pre-processer directives) and follow these steps to get started:</p> <ul> <li>Copy all the files starting with <code>pandoc-</code> to a new directory.</li> <li>Create a metadata YAML file for your ontology.   You can use emmodoc-meta.yaml as a template.</li> <li>Update pandoc-options.yaml.   Especially change:</li> <li><code>input-files</code> to the name of your new yaml metadata file.</li> <li><code>logo</code> to the path of your logo (or remove it).</li> <li><code>titlegraphic</code> to the path of your title figure (or remove it).</li> <li>Optionally add <code>ontodoc</code> template files with additional information about your ontology and document layout.</li> </ul> <p>That should be it. Good luck!</p>"},{"location":"examples/emmodoc/classes/","title":"Classes","text":"<p>%% %% This file %% This is Markdown file, except of lines starting with %% will %% be stripped off. %%</p> <p>%HEADER \"EMMO Classes\"    level=1</p> <p>emmo is a class representing the collection of all the individuals (signs) that are used in the ontology. Individuals are declared by the EMMO users when they want to apply the EMMO to represent the world.</p> <p>%BRANCHHEAD EMMO The root of all classes used to represent the world.  It has two children; collection and item.</p> <p>collection is the class representing the collection of all the individuals (signs) that represents a collection of non-connected real world objects.</p> <p>item Is the class that collects all the individuals that are members of a set (it's the most comprehensive set individual).  It is the branch of mereotopology.</p> <p>%% - based on has_part mereological relation that can be axiomatically defined %% - a fusion is the sum of its parts (e.g. a car is made of several %%   mechanical parts, an molecule is made of nuclei and electrons) %% - a fusion is of the same entity type as its parts (e.g. a physical %%   entity is made of physical entities parts) %% - a fusion can be partitioned in more than one way %BRANCH EMMO</p> <p>%BRANCHDOC Elementary %BRANCHDOC Perspective</p> <p>%BRANCHDOC Holistic %BRANCHDOC Semiotics %BRANCHDOC Sign %BRANCHDOC Interpreter %BRANCHDOC Object %BRANCHDOC Conventional %BRANCHDOC Property %BRANCHDOC Icon %BRANCHDOC Process</p> <p>%BRANCHDOC Perceptual %BRANCHDOC Graphical %BRANCHDOC Geometrical %BRANCHDOC Symbol %BRANCHDOC Mathematical %BRANCHDOC MathematicalSymbol %BRANCHDOC MathematicalModel %BRANCHDOC MathematicalOperator %BRANCHDOC Metrological %BRANCHDOC PhysicalDimension     rankdir=RL %BRANCHDOC PhysicalQuantity %BRANCHDOC Number %BRANCHDOC MeasurementUnit %BRANCHDOC UTF8 %BRANCHDOC SIBaseUnit %BRANCHDOC SISpecialUnit        rankdir=RL %BRANCHDOC PrefixedUnit %BRANCHDOC MetricPrefix         rankdir=RL %BRANCHDOC Quantity %BRANCHDOC BaseQuantity %BRANCHDOC DerivedQuantity      rankdir=RL %BRANCHDOC PhysicalConstant</p> <p>%BRANCHDOC Reductionistic %BRANCHDOC Expression</p> <p>%BRANCHDOC Physicalistic %BRANCHDOC ElementaryParticle</p>"},{"location":"examples/emmodoc/classes/#branchdoc-subatomic","title":"%BRANCHDOC Subatomic","text":"<p>%BRANCHDOC Matter %BRANCHDOC Fluid %BRANCHDOC Mixture %BRANCHDOC StateOfMatter</p>"},{"location":"examples/emmodoc/emmo/","title":"Emmo","text":"<p>%% %% This is the main Markdown input file for the EMMO documentation. %% %% Lines starting with a % are pre-processor directives. %%</p> <p>%INCLUDE introduction.md</p> <p>%INCLUDE relations.md</p> <p>%INCLUDE classes.md</p> <p>%HEADER Individuals       level=1 %ALL individuals</p> <p>%HEADER Appendix          level=1</p> <p>%HEADER \"The complete taxonomy of EMMO relations\"   level=2 %BRANCHFIG EMMORelation   caption='The complete taxonomy of EMMO relations.' terminated=0 relations=all edgelabels=0</p> <p>%HEADER \"The taxonomy of EMMO classes\"     level=2 %BRANCHFIG EMMO           caption='The almost complete taxonomy of EMMO classes. Only physical quantities and constants are left out.' terminated=0 relations=isA edgelabels=0 leaves=PhysicalDimension,BaseQuantity,DerivedQuantity,ExactConstant,MeasuredConstant,SIBaseUnit,SISpecialUnit,MetricPrefix,UTF8</p>"},{"location":"examples/emmodoc/important_concepts/","title":"Important concepts","text":""},{"location":"examples/emmodoc/important_concepts/#important-concepts","title":"Important concepts","text":""},{"location":"examples/emmodoc/important_concepts/#mereotopological-composition","title":"Mereotopological composition","text":""},{"location":"examples/emmodoc/important_concepts/#substrate","title":"Substrate","text":"<p>A <code>substrate</code> represents the place (in general sense) in which every real world item exists. It provides the dimensions of existence for real world entities. This follows from the fact that everything that exists is placed somewhere in space and time. Hence, its space and time coordinates can be used to identify it.</p> <p>Substrates are always topologically connected spaces. A topological space, X, is said to be disconnected if it is the union of two disjoint non-empty open sets. Otherwise, X is said to be connected.</p> <p><code>substrate</code> is the superclass of <code>space</code>, <code>time</code> and their combinations, like <code>spacetime</code>.</p> <p>Following Kant, space and time are a priori forms of intuition, i.e. they are the substrate upon which we place our intuitions, assigning space and time coordinates to them.</p>"},{"location":"examples/emmodoc/important_concepts/#hybrid","title":"Hybrid","text":"<p>A <code>hybrid</code> is the combination of <code>space</code> and <code>time</code>. It has the subclasses <code>world_line</code> (0D space + 1D time), <code>world_sheet</code> (1D space + 1D time), <code>world_volume</code> (2D space + 1D time) and <code>spacetime</code> (3D space + 1D time).</p>"},{"location":"examples/emmodoc/important_concepts/#spacetime","title":"Spacetime","text":"<p>EMMO represents real world entities as subclasses of <code>spacetime</code>. A <code>spacetime</code> is valid for all reference systems (as required by the theory of relativity).</p>"},{"location":"examples/emmodoc/important_concepts/#matter","title":"Matter","text":"<p><code>matter</code> is used to represent a group of <code>elementary</code> in an enclosing <code>spacetime</code>. As illustrated in the figure, a <code>matter</code> is an <code>elementary</code> or a composition of other <code>matter</code> and <code>vacuum</code>.</p> <p></p> <p>In EMMO <code>matter</code> is always a 4D spacetime. This is a fundamental difference between EMMO and most other ontologies.</p> <p>In order to describe the real world, we must also take into account the vacuum between the elementaries that composes higher granularity level entity (e.g. an atom).</p> <p>In EMMO <code>vacuum</code> is defined as a <code>spacetime</code> that has no <code>elementary</code> parts.</p>"},{"location":"examples/emmodoc/important_concepts/#existent","title":"Existent","text":"<p>An <code>existent</code> is defined as a <code>matter</code> that unfolds in time as a succession of states. It is used to represent the whole life of a complex but structured state-changing <code>matter</code> entity, like e.g. an atom that becomes ionised and then recombines with an electron.</p> <p>On the contrary, a <code>matter and not existent</code> entity is something \"amorphous\", randomly collected and not classifiable by common terms or definitions. That is a heterogeneous heap of <code>elementary</code>, appearing and disappearing in time.</p>"},{"location":"examples/emmodoc/important_concepts/#state","title":"State","text":"<p>A <code>state</code> is matter in a particular configurational state. It is defined as having spatial direct parts that persist (do not change) throughout the lifetime of the <code>state</code>. Hence, a <code>state</code> is like a snapshot of a physical in a finite time interval.</p> <p></p> <p>The use of spatial direct parthood in the definition of <code>state</code> means that a <code>state</code> cannot overlap in space with another <code>state</code>.</p> <p>An important feature of states, that follows from the fact that they are <code>spacetime</code>, is that they constitute a finite time interval.</p>"},{"location":"examples/emmodoc/important_concepts/#elementary","title":"Elementary","text":"<p>The basic assumption of decomposition in EMMO, is that the most basic manifestation of <code>matter</code> is represented by a subclass of <code>spacetime</code> called <code>elementary</code>.</p> <p>The <code>elementary</code> class defines the \"atomic\" (undividable) level in EMMO. A generic <code>matter</code> can always be decomposed in proper parts down to the <code>elementary</code> level using proper parthood. An <code>elementary</code> can still be decomposed in temporal parts, that are themselves <code>elementary</code>.</p> <p>Example of elementaries are electrons, photons and quarks.</p> <p></p>"},{"location":"examples/emmodoc/important_concepts/#granularity-direct-parthood","title":"Granularity - direct parthood","text":"<p>Granularity is a central concept of EMMO, which allows the user to percieve the world at different levels of detail (granularity) that follow physics and materials science perspectives.</p> <p></p> <p>Every material in EMMO is placed on a granularity level and the ontology gives information about the direct upper and direct lower level classes. This is done with the non-transitive <code>is_direct_part_of</code> relation.</p> <p></p> <p>Granularity is a defined class and is useful sine a reasoner automatically can put the individuals defined by the user under a generic class that clearly expresses the types of its compositional parts.</p>"},{"location":"examples/emmodoc/important_concepts/#mathematical-entities","title":"Mathematical entities","text":"<p>The class <code>mathematical_entity</code> represents fundamental elements of mathematical expressions, like numbers, variables, unknowns and equations. Mathematical entities are pure mathematical and have no physical unit.</p>"},{"location":"examples/emmodoc/important_concepts/#natural-law","title":"Natural law","text":"<p>A <code>natural_law</code> is an abstraction for a series of experiments that tries to define a common cause and effect of the time evolution of a set of interacting participants. It is (by definition) a pre-mathematical entity.</p> <p>The <code>natural_law</code> class is defined as</p> <pre><code>is_abstraction_for some experiment\n</code></pre> <p>It can be represented e.g. as a thought in the mind of the experimentalist, a sketch and textual description in a book of science.</p> <p><code>physical_law</code> and <code>material_law</code> are, according to the RoMM and CWA, the laws behind physical equations and material relations, respectively.</p>"},{"location":"examples/emmodoc/important_concepts/#properties","title":"Properties","text":"<p>Properties are abstracts that are related to a specific material entity with the relation has_property, but that depend on a specific observation process, participated by a specific observer, who catch the physical entity behaviour that is abstracted as a property.</p> <p>Properties enable us to connect a measured property to the measurement process and the measurement instrument.</p>"},{"location":"examples/emmodoc/introduction/","title":"Introduction","text":"<p>EMMO is a multidisciplinary effort to develop a standard representational framework (the ontology) based on current materials modelling knowledge, including physical sciences, analytical philosophy and information and communication technologies. This multidisciplinarity is illustrated by the figure on the title page. It provides the connection between the physical world, materials characterisation world and materials modelling world.</p> <p></p> <p>EMMO is based on and is consistent with the Review of Materials Modelling, CEN Workshop Agreement and MODA template. However, while these efforts are written for humans, EMMO is defined using the Web Ontology Language (OWL), which is machine readable and allows for machine reasoning. In terms of semantic representation, EMMO brings everything to a much higher level than these foundations.</p> <p>As illustrated in the figure below, EMMO covers all aspects of materials modelling and characterisation, including:</p> <ul> <li>the material itself, which must be described in a rigorous way;</li> <li>the observation process involving an observer that percieves the real world (characterisation);</li> <li>the properties that are measured or modelled;</li> <li>the physics laws that describe the material behaviour;</li> <li>the physical models that approximate the physics laws;</li> <li>the solver including the numerical discretisation method that leads to a solvable mathematical representation under certain simplifying assumptions;</li> <li>the numerical solver that performs the calculations; and</li> <li>the post processing of experimental or simulated data.</li> </ul> <p></p> <p>EMMO is released under the Creative Commons license and is available at emmo.info/. The OWL2-DL sources are available in RDF/XML format.</p>"},{"location":"examples/emmodoc/introduction/#what-is-an-ontology","title":"What is an ontology","text":"<p>In short, an ontology is a specification of a conceptualization. The word ontology has a long history in philosophy, in which it refers to the subject of existence. The so-called ontological argument for the existence of God was proposed by Anselm of Canterbury in 1078. He defined God as \"that than which nothing greater can be thought\", and argued that \"if the greatest possible being exists in the mind, it must also exist in reality. If it only exists in the mind, then an even greater being must be possible -- one which exists both in the mind and in reality\". Even though this example has little to do with todays use of ontologies in e.g. computer science, it illustrates the basic idea; the ontology defines some basic premises (concepts and relations between them) from which it is possible reason to gain new knowledge.</p> <p>For a more elaborated and modern definition of the ontology we refer the reader to the one provided by Tom Gruber (2009). Another useful introduction to ontologies is the paper Ontology Development 101: A Guide to Creating Your First Ontology by Noy and McGuinness (2001), which is based on the Protege sortware, with which EMMO has been developed.</p> <p>A taxonomy is a hierarchical representation of classes and subclasses connected via <code>is_a</code> relations. Hence, it is a subset of the ontology excluding all but the <code>is_a</code> relations. The main use of taxonomies is for the organisation of classifications. The figure shows a simple example of a taxonomy illustrating a categorisation of four classes into a hierarchy of more higher of levels of generality.</p> <p></p> <p>In EMMO, the taxonomy is a rooted directed acyclic graph (DAG). This is important since many classification methods relies on this property, see e.g. Valentini (2014) and Robison et al (2015). Note, that EMMO is a DAG does not prevent some classes from having more than one parent. A <code>Variable</code> is for instance both a <code>Mathematical</code> and a <code>Symbol</code>. See appendix for the full EMMO taxonomy.</p>"},{"location":"examples/emmodoc/introduction/#primitive-elements-in-emmo","title":"Primitive elements in EMMO","text":""},{"location":"examples/emmodoc/introduction/#individuals","title":"Individuals","text":"<p>Individuals are the basic, \"ground level\" components of EMMO. They may include concrete objects such as cars, flowers, stars, persons and molecules, as well as abstract individuals such as a measured height, a specific equation and software programs.</p> <p>Individuals possess attributes in form of axioms that are defined by the user (interpreter) upon declaration.</p>"},{"location":"examples/emmodoc/introduction/#classes","title":"Classes","text":"<p>Classes represent concepts. They are the building blocks that we use to create an ontology as a representation of knowledge. We distinguish between defined and non-defined classes.</p> <p>Defined classes are defined by the requirements for being a member of the class. In the graphical representations of EMMO, defined classes are orange. For instance, in the graph of the top-level entity branch below, The root <code>EMMO</code> and a defined class (defined to be the disjoint union of <code>Item</code> and <code>Collection</code>).</p> <p>Non-defined classes are defined as an abstract group of objects, whose members are defined as belonging to the class. They are yellow in the graphical representations.</p> <p>%BRANCHFIG EMMO leaves=Perspective,Elementary caption='Example of the top-level branch of EMMO showing some classes and relationships between them.' width=460</p>"},{"location":"examples/emmodoc/introduction/#axioms","title":"Axioms","text":"<p>Axioms are propositions in a logical framework that define the relations between the individuals and classes. They are used to categorise individuals in classes and to define the defined classes.</p> <p>The simplest form of a class axiom is a class description that just states the existence of the class and gives it an unique identifier. In order to provide more knowledge about the class, class axioms typically contain additional components that state necessary and/or sufficient characteristics of the class. OWL contains three language constructs for combining class descriptions into class axioms:</p> <ul> <li> <p>Subclass (<code>rdfs:subClassOf</code>) allows one to say that the class extension of a class description is a subset of the class extension of another class description.</p> </li> <li> <p>Equivalence (<code>owl:equivalentClass</code>) allows one to say that a class description has exactly the same class extension (i.e. the individuals associated with the class) as another class description.</p> </li> <li> <p>Distjointness (<code>owl:disjointWith</code>) allows one to say that the class extension of a class description has no members in common with the class extension of another class description.</p> </li> </ul> <p>See the section about Description logic for more information about these language constructs. Axioms are also used to define relations between relations. These are further detailed in the chapter on Relations.</p>"},{"location":"examples/emmodoc/introduction/#theoretical-foundations","title":"Theoretical foundations","text":"<p>EMMO build upon several theoretical frameworks.</p>"},{"location":"examples/emmodoc/introduction/#semiotics","title":"Semiotics","text":"<p>Semiotics is the study of meaning-making. It is the dicipline of formulating something that possibly can exist in a defined space and time in the real world.</p> <p>%%It is introdused in EMMO via the %%<code>semion</code> class and used as a way to reduce the complexity of a %%physical to a simple sign (symbol).  A <code>Sign</code> is a physical %%entity that can represent another object. %% %%### Set theory %%Set theory is the theory of membership. This is introduced via %%the <code>set</code> class, representing the collection of all individuals %%(signs) that represent a collection of items.  Sets are defined %%via the <code>hasMember</code> relations.</p>"},{"location":"examples/emmodoc/introduction/#mereotopology","title":"Mereotopology","text":"<p>Mereotopology is the combination of mereology (science of parthood) and topology (mathematical study of the geometrical properties and conservation through deformations). It is introdused via the <code>Item</code> class and based on the <code>mereotopological</code> relations. Items in EMMO are always topologically connected in space and time. EMMO makes a strong distinction between membership and parthood relations. In contrast to collections, items can only have parts that are themselves items. For further information, see Casati and Varzi \"Parts and Places\" (1999).</p>"},{"location":"examples/emmodoc/introduction/#physics","title":"Physics","text":"<p>EMMO is strongly based on physics, with the aim of being able to describe all aspects and all domains of physics, from quantum mechanics to continuum, engeneering, chemistry, etc. EMMO is compatible with both the De Broglie - Bohm and the Copenhagen interpretation of quantum mecanics (see <code>Physical</code> for more comments).</p> <p>EMMO defines a physics-based parthood hierachy under <code>Physical</code> by introducing the following concepts (illustrated in the figure below):</p> <ul> <li> <p><code>Elementary</code> is the fundamental, non-divisible constituent of entities.   In EMMO, elementaries are based on the standard model of physics.</p> </li> <li> <p><code>State</code> is a <code>Physical</code> whose parts does not change during its life time (at the chosen level of granularity).   This is consistent with a state within e.g. thermodynamics.</p> </li> <li> <p><code>Existent</code> is a succession of states.</p> </li> </ul> <p></p>"},{"location":"examples/emmodoc/introduction/#metrology","title":"Metrology","text":"<p>Metrology is the science of measurements. It introduces units and links them to properties. The description of metrology in EMMO is based on the standards of International System of Quantities (ISQ) and International System of Units (SI).</p>"},{"location":"examples/emmodoc/introduction/#description-logic","title":"Description logic","text":"<p>Description logic (DL) is a formal knowledge representation language in which the axioms are expressed. It is less expressive than first-order logic (FOL), but commonly used for providing the logical formalism for ontologies and semantic web. EMMO is expressed in the Web Ontology Language (OWL), which in turn is based on DL. This brings along features like reasoning.</p> <p>Since it is essential to have a basic notion of OWL and DL, we include here a very brief overview. For a proper introduction to OWL and DL, we refer the reader to sources like Grau et.al. (2008), OWL2 Primer and OWL Reference.</p> <p>OWL distinguishes between six types of class descriptions:</p> <ol> <li>a class identifier (a IRI reference);</li> <li>an exhaustive enumeration of individuals that together form the instances of a class (<code>owl:oneOf</code>);</li> <li>a property restriction (<code>owl:someValuesFrom</code>, <code>owl:allValuesFrom</code>, <code>owl:hasValue</code>, <code>owl:cardinality</code>, <code>owl:minCardinality</code>, <code>owl:maxCardinality</code>);</li> <li>the intersection of two or more class descriptions (<code>owl:intersectionOf</code>);</li> <li>the union of two or more class descriptions (<code>owl:unionOf</code>); and</li> <li>the complement of a class description (<code>owl:complementOf</code>).</li> </ol> <p>Except for the first, all of these refer to defined classes. The table below shows the notation in OWL, DL and the Manchester OWL syntax, all commonly used for the definitions. The Manchester syntax is used by Protege and is designed to not use DL symbols and to be easy and quick to read and write. Several other syntaxes exist for DL. An interesting example is the pure Python syntax proposed by Lamy (2017), which is used in the open source Owlready2 Python package. The Python API for EMMO is also based on Owlready2.</p> <p>DL                 Manchester         Python + Owlready2        Read                  Meaning                                        ---------------    -----------------  -------------------        -------------------   -------------------- Constants</p> <p>$\\top$                                Thing                      top                   A special class with every individual as an instance</p> <p>$\\bot$                                Nothing                    bottom                The empty class</p> <p>Axioms</p> <p>$A\\doteq B$                                                      A is defined to be    Class definition                                                                  equal to B</p> <p>$A\\sqsubseteq B$   A subclass_of B    class A(B): ...            all A are B           Class inclusion</p> <pre><code>                                  issubclass(A, B)                                 Test for *inclusion*\n</code></pre> <p>$A\\equiv B$        A equivalent_to B  A.equivalent_to.append(B)  A is equivalent to B  Class equivalence</p> <pre><code>                                  B in A.equivalent_to                             Test for equivalence\n</code></pre> <p>$a:A$              a is_a A           a = A()                    a is a A              Class assertion (instantiation)</p> <pre><code>                                  isinstance(a, A)                                 Test for instance of\n</code></pre> <p>$(a,b):R$          a object property  a.R.append(b)              a is R-related to b   Property assertion                    assertion b</p> <p>$(a,n):R$          a data property    a.R.append(n)              a is R-related to n   Data assertion                    assertion n</p> <p>Constructions</p> <p>$A\\sqcap B$        A and B            A &amp; B                      A and B               Class intersection (conjunction)</p> <p>$A\\sqcup B$        A or B             A | B                      A or B                Class union (disjunction)</p> <p>$\\lnot A$          not A              Not(A)                     not A                 Class complement (negation)</p> <p>${a, b, ...}$    {a, b, ...}        OneOf([a, b, ...])         one of a, b, ...      Class enumeration</p> <p>$S\\equiv R^-$      S inverse_of R     Inverse(R)                 S is inverse of R     Property inverse</p> <pre><code>                                  S.inverse == R                                   Test for *inverse*\n</code></pre> <p>$\\forall R.A$      R only A           R.only(A)                  all A with R          Universal restriction</p> <p>$\\exists R.A$      R some A           R.some(A)                  some A with R         Existential restriction</p> <p>$=n R.A$           R exactly n A      R.exactly(n, A)                                  Cardinality restriction</p> <p>$\\leq n R.A$       R min n A          R.min(n, A)                                      Minimum cardinality restriction</p> <p>$\\geq n R.A$       R max n A          R.max(n, A)                                      Minimum cardinality restriction</p> <p>$\\exists R{a}$   R value a          R.value(a)                                       Value restriction</p> <p>Decompositions</p> <p>$A\\sqcup B         A disjoint with B  AllDisjoint([A, B])        A disjoint with B     Disjoint \\sqsubseteq\\bot$</p> <pre><code>                                  B in A.disjoints()                               Test for disjointness\n</code></pre> <p>$\\exists R.\\top    R domain A         R.domain = [A]                                   Classes that the restriction applies to \\sqsubseteq A$</p> <p>$\\top\\sqsubseteq   R range B          R.range = [B]                                    All classes that can be the value of the restriction \\forall R.B$</p> <p>Table: Notation for DL and Protege. A and B are classes, R is an active relation, S is an passive relation, a and b are individuals and n is a literal. Inspired by the Great table of Description Logics.</p>"},{"location":"examples/emmodoc/introduction/#examples","title":"Examples","text":"<p>Here are some examples of different class descriptions using both the DL and Manchester notation.</p>"},{"location":"examples/emmodoc/introduction/#equivalence-owlequivalentto","title":"Equivalence (<code>owl:equivalentTo</code>)","text":"<p>Equivalence ($\\equiv$) defines necessary and sufficient conditions.</p> <p>Parent is equivalent to mother or father</p> <p>DL: <code>parent</code> $\\equiv$ <code>mother</code> $\\lor$ <code>father</code></p> <p>Manchester: <code>parent equivalent_to mother or father</code></p>"},{"location":"examples/emmodoc/introduction/#inclusion-rdfsubclassof","title":"Inclusion (<code>rdf:subclassOf</code>)","text":"<p>Inclusion ($\\sqsubseteq$) defines necessary conditions.</p> <p>An employee is a person.</p> <p>DL: <code>employee</code> $\\sqsubseteq$ <code>person</code></p> <p>Manchester: <code>employee is_a person</code></p>"},{"location":"examples/emmodoc/introduction/#enumeration-owloneof","title":"Enumeration (<code>owl:oneOf</code>)","text":"<p>The color of a wine is either white, rose or red:</p> <p>DL: <code>wine_color</code> $\\equiv$ {<code>white</code>, <code>rose</code>, <code>red</code>}</p> <p>Manchester: <code>wine_color equivalent_to {white, rose, red}</code></p>"},{"location":"examples/emmodoc/introduction/#existential-restriction-owlsomevaluesfrom","title":"Existential restriction (<code>owl:someValuesFrom</code>)","text":"<p>A mother is a woman that has a child (some person):</p> <p>DL: <code>mother</code> $\\equiv$ <code>woman</code> $\\sqcap$ $\\exists$<code>has_child</code>.<code>person</code></p> <p>Manchester: <code>mother equivalent_to woman and has_child some person</code></p>"},{"location":"examples/emmodoc/introduction/#universal-restriction-owlallvaluesfrom","title":"Universal restriction (<code>owl:allValuesFrom</code>)","text":"<p>All parents that only have daughters:</p> <p>DL: <code>parents_with_only_daughters</code> $\\equiv$ <code>person</code> $\\sqcap$ $\\forall$<code>has_child</code>.<code>woman</code></p> <p>Manchester: <code>parents_with_only_daughters equivalent_to person and has_child only woman</code></p>"},{"location":"examples/emmodoc/introduction/#value-restriction-owlhasvalue","title":"Value restriction (<code>owl:hasValue</code>)","text":"<p>The owl:hasValue restriction allows to define classes based on the existence of particular property values. There must be at least one matching property value.</p> <p>All children of Mary:</p> <p>DL: <code>Marys_children</code> $\\equiv$ <code>person</code> $\\sqcap$ $\\exists$<code>has_parent</code>.{<code>Mary</code>}</p> <p>Manchester: <code>Marys_children equivalent_to person and has_parent value Mary</code></p>"},{"location":"examples/emmodoc/introduction/#property-cardinality-owlcardinality","title":"Property cardinality (<code>owl:cardinality</code>)","text":"<p>The owl:cardinality restrictions ($\\geq$, $\\leq$ or $\\equiv$) allow to define classes based on the maximum (owl:maxCardinality), minimum (owl:minCardinality) or exact (owl:cardinality) number of occurences.</p> <p>A person with one parent:</p> <p>DL: <code>half_orphant</code> $\\equiv$ <code>person</code> and =1<code>has_parent</code>.<code>person</code></p> <p>Manchester: <code>half_orphant equivalent_to person and has_parent exactly 1 person</code></p>"},{"location":"examples/emmodoc/introduction/#intersection-owlintersectionof","title":"Intersection (<code>owl:intersectionOf</code>)","text":"<p>Individuals of the intersection ($\\sqcap$) of two classes, are simultaneously instances of both classes.</p> <p>A man is a person that is male:</p> <p>DL: <code>man</code> $\\equiv$ <code>person</code> $\\sqcap$ <code>male</code></p> <p>Manchester: <code>man equivalent_to person and male</code></p>"},{"location":"examples/emmodoc/introduction/#union-owlunionof","title":"Union (<code>owl:unionOf</code>)","text":"<p>Individuals of the union ($\\sqcup$) of two classes, are either instances of one or both classes.</p> <p>A person is a man or woman:</p> <p>DL: <code>person</code> $\\equiv$ <code>man</code> $\\sqcup$ <code>woman</code></p> <p>Manchester: <code>person equivalent_to man or woman</code></p>"},{"location":"examples/emmodoc/introduction/#complement-owlcomplementof","title":"Complement (<code>owl:complementOf</code>)","text":"<p>Individuals of the complement ($\\lnot$) of a class, are all individuals that are not member of the class.</p> <p>Not a man:</p> <p>DL: <code>female</code> $\\equiv$ $\\lnot$ <code>male</code></p> <p>Manchester: <code>female equivalent_to not male</code></p>"},{"location":"examples/emmodoc/introduction/#the-structure-of-emmo","title":"The structure of EMMO","text":"<p>The EMMO ontology is structured in shells, expressed by specific ontology fragments, that extends from fundamental concepts to the application domains, following the dependency flow.</p>"},{"location":"examples/emmodoc/introduction/#top-level","title":"Top Level","text":"<p>The EMMO top level is the group of fundamental axioms that constitute the philosophical foundation of the EMMO. Adopting a physicalistic/nominalistic perspective, the EMMO defines real world objects as 4D objects that are always extended in space and time (i.e. real world objects cannot be spaceless nor timeless). For this reason abstract objects, i.e. objects that does not extend in space and time, are forbidden in the EMMO.</p> <p>EMMO is strongly based on the analytical philosophy dicipline semiotic. The role of abstract objects are in EMMO fulfilled by semiotic objects, i.e. real world objects (e.g. symbol or sign) that stand for other real world objects that are to be interpreted by an agent. These symbols appear in actions (semiotic processes) meant to communicate meaning by establishing relationships between symbols (signs).</p> <p>Another important building block of from analytical philosophy is atomistic mereology applied to 4D objects. The EMMO calls it 'quantum mereology', since the there is a epistemological limit to how fine we can resolve space and time due to the uncertanity principles.</p> <p>The mereotopology module introduces the fundamental mereotopological concepts and their relations with the real world objects that they represent. The EMMO uses mereotopology as the ground for all the subsequent ontology modules. The concept of topological connection is used to define the first distinction between ontology entities namely the Item and Collection classes. Items are causally self-connected objects, while collections are causally disconnected. Quantum mereology is represented by the Quantum class. This module introduces also the fundamental mereotopological relations used to distinguish between space and time dimensions.</p> <p>The physical module, defines the Physical objects and the concept of Void that plays a fundamental role in the description of multiscale objects and quantum systems. It also define the Elementary class, that restricts mereological atomism in space.</p> <p></p> <p>In EMMO, the only univocally defined real world object is the Item individual called Universe that stands for the universe. Every other real world object is a composition of elementaries up to the most comprehensive object; the Universe. Intermediate objects are not univocally defined, but their definition is provided according to some specific philosophical perspectives. This is an expression of reductionism (i.e. objects are made of sub-objects) and epistemological pluralism (i.e. objects are always defined according to the perspective of an interpreter, or a class of interpreters).</p> <p>The Perspective class collects the different ways to represent the objects that populate the conceptual region between the elementary and universe levels.</p>"},{"location":"examples/emmodoc/introduction/#middle-level","title":"Middle Level","text":"<p>The middle level ontologies act as roots for extending the EMMO towards specific application domains.</p> <p></p> <p>The Reductionistic perspective class uses the fundamental non-transitive parthood relation, called direct parthood, to provide a powerful granularity description of multiscale real world objects. The EMMO can in principle represents the Universe with direct parthood relations as a direct rooted tree up to its elementary constituents.</p> <p>The Phenomenic perspective class introduces the concept of real world objects that express of a recognisable pattern in space or time that impress the user. Under this class the EMMO categorises e.g. formal languages, pictures, geometry, mathematics and sounds. Phenomenic objects can be used in a semiotic process as signs.</p> <p>The Physicalistic perspective class introduces the concept of real world objects that have a meaning for the under applied physics perspective.</p> <p>The Holistic perspective class introduces the concept of real world objects that unfold in time in a way that has a meaning for the EMMO user, through the definition of the classes Process and Participant. The semiotics module introduces the concepts of semiotics and the Semiosis process that has a Sign, an Object and an Interpreter as participants. This forms the basis in EMMO to represent e.g. models, formal languages, theories, information and properties.</p> <p></p>"},{"location":"examples/emmodoc/introduction/#emmo-relations","title":"EMMO relations","text":"<p>All EMMO relations are subrelations of the relations found in the two roots: mereotopological and semiotical. The relation hierarchy extends more vertically (i.e. more subrelations) than horizontally (i.e. less sibling relations), facilitating the categorisation and inferencing of individuals. See also the chapter EMMO Relations.</p> <p>Imposing all relations to fall under mereotopology or semiotics is how the EMMO force the developers to respect its perspectives. Two entities are related only by contact or parthood (mereotopology) or by standing one for another (semiosis): no other types of relation are possible within the EMMO.</p> <p>A unique feature in EMMO, is the introduction of direct parthood. As illustrated in the figure below, it is a mereological relation that lacks transitivity. This makes it possible to entities made of parts at different levels of granularity and to go between granularity levels in a well-defined manner. This is paramount for cross scale interoperability. Every material in EMMO is placed on a granularity level and the ontology gives information about the direct upper and direct lower level classes using the non-transitive direct parthood relations.</p> <p></p>"},{"location":"examples/emmodoc/introduction/#annotations","title":"Annotations","text":"<p>All entities and relations in EMMO have some attributes, called annotations. In some cases, only the required International Resource Identifier (IRI) and relations are provided. However, descriptive annotations, like elucidation and comment, are planned to be added for all classes and relations. Possible annotations are:</p> <ul> <li>Elucidation is a human readable explanation and clearification of the documented class or relation.</li> <li>Example clearifies the elucidation through an example.   A class may have several examples, each addressing different aspects.</li> <li>Comment is a clearifying note complementing the definition and elucidation.   A class may have several comments, each clearifying different aspects.</li> <li>IRI stands for international resource identifier.   It is an identifier that uniquely identifies the class or relation.   IRIs are similar to URIs, but are not restricted to the ASCII character set.   In EMMO, the IRIs are now valid URLs pointing to the stable version of EMMO.</li> <li>Relations is a list of relations applying to the current class or relation.   The relations for relations are special and will be elaborated on in the introduction to chapter [Relations].   Some of the listed relations are defined in the OWL sources, while other are inferred by the reasoner.   The relations are expressed using the Manchester OWL syntax introduced in section Description logic.</li> </ul> <p>%%### Graphs %%The generated graphs borrow some syntax from the Unified Modelling %%Language (UML), which is a general purpose language for software %%design and modelling.  The table below shows the style used for the %%different types of relations and the concept they correspond to in %%UML. %% %%Relation           UML arrow     UML concept %%-------------      -----------   ----------- %%is-a               ![img][isa]   inheritance %%disjoint_with      ![img][djw]   association %%equivalent_to      ![img][eqt]   association %%encloses           ![img][rel]   aggregation %%has_abstract_part  ![img][rel]   aggregation %%has_abstraction    ![img][rel]   aggregation %%has_representation ![img][rel]   aggregation %%has_member         ![img][rel]   aggregation %%has_property       ![img][rel]   aggregation %% %%Table: Notation for arrow styles used in the graphs.  Only active %%relations are listed. Corresponding passive relations use the same %%style. %% %%[isa]: figs/arrow-is_a.png \"inheritance\" %%[djw]: figs/arrow-disjoint_with.png \"association\" %%[eqt]: figs/arrow-equivalent_to.png \"association\" %%[rel]: figs/arrow-relation.png \"aggregation\"</p> <p>%%All relationships have a direction.  In the graphical visualisations, %%the relationships are represented with an arrow pointing from the %%subject to the object.  In order to reduce clutter and limit the size %%of the graphs, the relations are abbreviated according to the %%following table: %% %%Relation                        Abbreviation %%--------                        ------------ %%has_part only                   hp-o %%is_part_of only                 ipo-o %%has_member some                 hm-s %%is_member_of some               imo-s %%has_abstraction some            ha-s %%is_abstraction_of some          iao-s %%has_abstract_part only          pap-o %%is_abstract_part_of only        iapo-o %%has_space_slice some            hss-s %%is_space_slice_of some          isso-s %%has_time_slice some             hts-s %%is_time_slice_of some           itso-s %%has_projection some             hp-s %%is_projection_of some           ipo-s %%has_proper_part some            hpp-s %%is_proper_part_of some          ippo-s %%has_proper_part_of some         hppo-s %%has_spatial_direct_part min     hsdp-m %%has_spatial_direct_part some    hsdp-s %%has_spatial_direct_part exactly hsdp-e %% %%Table: Abbriviations of relations used in the graphical representation %%of the different subbranches. %% %% %%UML represents classes as a box with three compartments; names, attributes %%and operators.  However, since the classes in EMMO have no operators and %%since it gives little meaning to include the OWL annotations as attributes, %%we simply represent the classes as boxes by a name. %% %%As already mentioned, defined classes are colored orange, while %%undefined classes are yellow. %% %% %%</p>"},{"location":"examples/emmodoc/relations/","title":"Relations","text":"<p>%% %% This file %% This is Markdown file, except of lines starting with %% will %% be stripped off. %%</p> <p>%HEADER \"EMMO Relations\"    level=1</p> <p>In the language of OWL, relations are called properties. However, since relations describe relations between classes and individuals and since properties has an other meaning in EMMO, we only call them relations.</p> <p>Resource Description Framework (RDF) is a W3C standard that is widely used for describing informations on the web and is one of the standards that OWL builds on. RDF expresses information in form of subject-predicate-object triplets. The subject and object are resources (aka items to describe) and the predicate expresses a relationship between the subject and the object.</p> <p>In OWL are the subject and object classes or individuals (or data) while the predicate is a relation. An example of an relationship is the statement dog is_a animal. Here <code>dog</code> is the subject, <code>is_a</code> the predicate and <code>animal</code> the object.</p> <p>%%We distinguish between %%<code>active relations</code> where the subject is acting on the object and %%<code>passive relations</code> where the subject is acted on by the object.</p> <p>OWL distingues between object properties, that link classes or individuals to classes or individuals, and data properties that link individuals to data values. Since EMMO only deals with classes, we will only be discussing object properties. However, in actual simulation or characterisation applications build on EMMO, datatype propertyes will be important.</p> <p>The characteristics of the different properties are described by the following property axioms:</p> <ul> <li> <p><code>rdf:subPropertyOf</code> is used to define that a property is a subproperty of some other property.   For instance, in the figure below showing the relation branch, we see that <code>active_relation</code> is a subproperty or <code>relation</code>.   The <code>rdf:subPropertyOf</code> axioms forms a taxonomy-like tree for relations.</p> </li> <li> <p><code>owl:equivalentProperty</code> states that two properties have the same property extension.</p> </li> <li> <p><code>owl:inverseOf</code> axioms relate active relations to their corresponding passive relations, and vice versa.   The root relation <code>relation</code> is its own inverse.</p> </li> <li> <p><code>owl:FunctionalProperty</code> is a property that can have only one (unique) value y for each instance x, i.e. there cannot be two distinct values y1 and y2 such that the pairs (x,y1) and (x,y2) are both instances of this property.   Both object properties and datatype properties can be declared as \"functional\".</p> </li> <li> <p><code>owl:InverseFunctionalProperty</code>.</p> </li> <li> <p><code>owl:TransitiveProperty</code> states that if a pair (x,y) is an instance of P, and the pair (y,z) is instance of P, then we can infer that the pair (x,z) is also an instance of P.</p> </li> <li> <p><code>owl:SymmetricProperty</code> states that if the pair (x,y) is an instance of P, then the pair (y,x) is also an instance of P.   A popular example of a symmetric property is the <code>siblingOf</code> relation.</p> </li> <li> <p><code>rdfs:domain</code> specifies which classes the property applies to.   Or said differently, the valid values of the subject in a subject-predicate-object triplet.</p> </li> <li> <p><code>rdfs:range</code> specifies the property extension, i.e. the valid values of the object in a subject-predicate-object triplet.</p> </li> </ul> <p>%HEADER \"Root of EMMO relations\"      level=2 %BRANCHFIG EMMORelation   caption=\"Top-level of the EMMO relation hierarchy.\" %ENTITY EMMORelation</p>"},{"location":"examples/emmodoc/relations/#branchdoc-mereotopological","title":"%%BRANCHDOC mereotopological","text":""},{"location":"examples/emmodoc/relations/#branchhead-mereotopological","title":"%BRANCHHEAD mereotopological","text":""},{"location":"examples/emmodoc/relations/#branch-mereotopological","title":"%BRANCH mereotopological","text":""},{"location":"examples/emmodoc/relations/#branchdoc-connected","title":"%BRANCHDOC connected","text":"<p>%BRANCHDOC hasPart</p> <p>%BRANCHDOC semiotical</p>"},{"location":"examples/jupyter-visualization/","title":"Visualise an ontology using pyctoscape in Jupyter Notebook","text":""},{"location":"examples/jupyter-visualization/#installation-instructions","title":"Installation instructions","text":"<p>In a terminal, run:</p> <pre><code>cd /path/to/env/dirs\npython -m venv cytopy  # cytopy is my name, you can choose what ouy want\nsource cytopy/bin/activate\ncd /dir/to/EMMOntoPy/\npip install -e .\npip install jupyterlab\npython -m ipykernel install --user --name=cytopy\npip install ipywidgets\npip install nodejs # Note requires that node.js and npm has already been isntalled!\npip install ipycytoscape pydotplus networkx\npip install --upgrade setuptools\njupyter labextension install @jupyter-widgets/jupyterlab-manager\n</code></pre>"},{"location":"examples/jupyter-visualization/#test-the-notebook","title":"Test the notebook","text":"<p>In a terminal, run:</p> <pre><code>jupyter-lab\n</code></pre> <p>That should start jupyter kernel and open a new tab in your browser. In the side pane, select <code>team40.ipynb</code> and run the notebook.</p>"},{"location":"examples/ontology-from-excel/","title":"Generate an ontology from excel","text":"<p>This directory contains an example xlsx-file for how to document ontology entities (classes, object properties, annotation properties and data properties) in an Excel workbook. This workbook can then be used to generate a new ontology or update an already existing ontology with new entities (existing entities are not updated).</p> <p>Please refer to the (documentation)[https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/excelparser/] for full explanation of capabilities.</p> <p>The file <code>tool/onto.xlsx</code> contains examples on how to do things correctly as well as incorrectly. The tool will by default exit without generating the ontology if it detects concepts defined incorrectly. However, if the argument force is set to True, it will skip concepts that are erroneously defined and generate the ontology with what is availble.</p> <p>To run the tool directly <pre><code>cd tool # Since the excel file provides a relative path to an imported ontology\nexcel2onto onto.xlsx # This will fail\nexcel2onto --force onto.xlsx\n</code></pre> We suggest developing your excelsheet without fails as once it starts getting big it is difficult to see what is wrong or correct.</p> <p>It is also possible to generate the ontology in python. Look at the script make_onto.py for an example.</p> <p>That should be it. Good luck!</p>"}]}
\ No newline at end of file
diff --git a/latest/sitemap.xml b/latest/sitemap.xml
index 205f7749..872cf229 100644
--- a/latest/sitemap.xml
+++ b/latest/sitemap.xml
@@ -2,177 +2,177 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/CHANGELOG/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/LICENSE/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/docker-instructions/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/tools-instructions/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/emmopy/emmocheck/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/emmopy/emmopy/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/colortest/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/excelparser/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/graph/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/manchester/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/nadict/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/ontodoc/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/ontodoc_rst/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/ontology/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/patch/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/testutils/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/utils/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/factpluspluswrapper/factppgraph/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/factpluspluswrapper/owlapi_interface/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/api_reference/ontopy/factpluspluswrapper/sync_factpp/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/demo/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/demo/horizontal/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/demo/vertical/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/developers/release-instructions/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/developers/setup/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/developers/testing/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/emmodoc/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/emmodoc/classes/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/emmodoc/emmo/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/emmodoc/important_concepts/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/emmodoc/introduction/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/emmodoc/relations/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/jupyter-visualization/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://emmo-repo.github.io/EMMOntoPy/latest/examples/ontology-from-excel/</loc>
-         <lastmod>2024-05-29</lastmod>
+         <lastmod>2024-06-21</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/latest/sitemap.xml.gz b/latest/sitemap.xml.gz
index 60096cbf6c5ff99e665b98199339195d1a479065..b6d5cdde7e3ff401f3aa5261e80d924b2b608873 100644
GIT binary patch
delta 100
zcmV-q0Gt1#1fv88ABzYGfWmZ<2OR`T!x-C<C^a{EvCJ0W4c68->+Jjer~F-ZQJs~2
zbOdR^&Ysp;n^O3o)G!PM*#w;qRA6irnU-HjJvFLj@jj81I0Ta~-{!H<O92QrRbuzQ
G8UO&j&Ma5}

delta 100
zcmV-q0Gt1#1fv88ABzYG0B}~32OR{;!UpS+C^a{mVwo+#8?3Ew*4g*_Px<@oqB<-4
z=m^q+ojt9yHl^@EsbLrjvI#mJsKD4LGA+N5dTLb5;yjU*I0Tz7-{rB;O92S`2;>&O
G8UO&SMlAvW

diff --git a/latest/tools-instructions/index.html b/latest/tools-instructions/index.html
index 7aebca1e..389b96b1 100644
--- a/latest/tools-instructions/index.html
+++ b/latest/tools-instructions/index.html
@@ -20,7 +20,7 @@
       
       
       <link rel="icon" href="../images/favicon.png">
-      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.25">
+      <meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.27">
     
     
       
@@ -154,7 +154,7 @@
       
     </form>
     <div class="md-search__output">
-      <div class="md-search__scrollwrap" data-md-scrollfix>
+      <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
         <div class="md-search-result" data-md-component="search-result">
           <div class="md-search-result__meta">
             Initializing search
@@ -2313,7 +2313,7 @@ <h3 id="bugs_1">Bugs<a class="headerlink" href="#bugs_1" title="Permanent link">
     <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.top", "content.tabs.link"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "latest", "provider": "mike"}}</script>
     
     
-      <script src="../assets/javascripts/bundle.081f42fc.min.js"></script>
+      <script src="../assets/javascripts/bundle.ad660dcc.min.js"></script>
       
     
   </body>