Added documentation for '1.7.3'.

Author: smyrgeorge

docs/index.html

@@ -43,7 +43,7 @@
         </button>
         <div class="navigation-controls--break ui-kit_mobile-only"></div>
         <div class="library-version" id="library-version">
-1.7.2        </div>
+1.7.3        </div>
         <div class="navigation-controls">
             <button class="navigation-controls--btn navigation-controls--btn_theme" id="theme-toggle-button"
                     type="button">Switch theme

docs/navigation.html

@@ -9,12 +9,8 @@ filteringContext = {
 }
 let highlightedAnchor;
 let topNavbarOffset;
-let instances = [];
 let sourcesetNotification;
 
-const samplesDarkThemeName = 'darcula'
-const samplesLightThemeName = 'idea'
-
 window.addEventListener('load', () => {
     document.querySelectorAll("div[data-platform-hinted]")
         .forEach(elem => elem.addEventListener('click', (event) => togglePlatformDependent(event, elem)))
@@ -37,60 +33,26 @@ const darkModeSwitch = () => {
     const osDarkSchemePreferred = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches
     const darkModeEnabled = storage ? JSON.parse(storage) : osDarkSchemePreferred
     const element = document.getElementById("theme-toggle-button")
-    initPlayground(darkModeEnabled ? samplesDarkThemeName : samplesLightThemeName)
+
+    // Notify external scripts about changing dark mode, runnable samples plugin depends on this
+    if (window.onDarkModeChanged) {
+        window.onDarkModeChanged(darkModeEnabled)
+    }
 
     element.addEventListener('click', () => {
         const enabledClasses = document.getElementsByTagName("html")[0].classList
         enabledClasses.toggle("theme-dark")
 
         //if previously we had saved dark theme then we set it to light as this is what we save in local storage
         const darkModeEnabled = enabledClasses.contains("theme-dark")
-        if (darkModeEnabled) {
-            initPlayground(samplesDarkThemeName)
-        } else {
-            initPlayground(samplesLightThemeName)
+        // Notify external scripts about changing dark mode, runnable samples plugin depends on this
+        if (window.onDarkModeChanged) {
+            window.onDarkModeChanged(darkModeEnabled)
         }
         safeLocalStorage.setItem(localStorageKey, JSON.stringify(darkModeEnabled))
     })
 }
 
-const initPlayground = (theme) => {
-    if (!samplesAreEnabled()) return
-    instances.forEach(instance => instance.destroy())
-    instances = []
-
-    // Manually tag code fragments as not processed by playground since we also manually destroy all of its instances
-    document.querySelectorAll('code.runnablesample').forEach(node => {
-        node.removeAttribute("data-kotlin-playground-initialized");
-
-        if (node.parentNode) {
-            node.parentNode.setAttribute("runnable-code-sample", "");
-        }
-    })
-
-    KotlinPlayground('code.runnablesample', {
-        getInstance: playgroundInstance => {
-            instances.push(playgroundInstance)
-        },
-        theme: theme
-    });
-}
-
-// We check if type is accessible from the current scope to determine if samples script is present
-// As an alternative we could extract this samples-specific script to new js file but then we would handle dark mode in 2 separate files which is not ideal
-const samplesAreEnabled = () => {
-    try {
-        if (typeof KotlinPlayground === 'undefined') {
-            // KotlinPlayground is exported universally as a global variable or as a module
-            // Due to possible interaction with other js scripts KotlinPlayground may not be accessible directly from `window`, so we need an additional check
-            KotlinPlayground = exports.KotlinPlayground;
-        }
-        return typeof KotlinPlayground === 'function';
-    } catch (e) {
-        return false
-    }
-}
-
 // Hash change is needed in order to allow for linking inside the same page with anchors
 // If this is not present user is forced to refresh the site in order to use an anchor
 window.onhashchange = handleAnchor
@@ -278,16 +240,6 @@ function refreshFiltering() {
     refreshFilterButtons()
     refreshPlatformTabs()
     refreshNoContentNotification()
-    refreshPlaygroundSamples()
-}
-
-function refreshPlaygroundSamples() {
-    document.querySelectorAll('code.runnablesample').forEach(node => {
-        const playground = node.KotlinPlayground;
-        /* Some samples may be hidden by filter, they have 0px height  for visible code area
-         * after rendering. Call this method for re-calculate code area height */
-        playground && playground.view.codemirror.refresh();
-    });
 }
 
 function refreshNoContentNotification() {

docs/package-list

@@ -18,7 +18,6 @@
         }
       }
     </script>
-<script type="text/javascript" src="https://unpkg.com/kotlin-playground@1/dist/playground.min.js" async></script>
 <script type="text/javascript" src="../scripts/sourceset_dependencies.js" async></script>
 <link href="../styles/style.css" rel="Stylesheet">
 <link href="../styles/main.css" rel="Stylesheet">
@@ -39,7 +38,7 @@
             </a>        <button class="navigation-controls--btn navigation-controls--btn_toc ui-kit_mobile-only" id="toc-toggle" type="button">Toggle table of contents
         </button>
         <div class="navigation-controls--break ui-kit_mobile-only"></div>
-        <div class="library-version" id="library-version">1.7.2
+        <div class="library-version" id="library-version">1.7.3
         </div>
         <div class="navigation-controls">
         <ul class="filter-section filter-section_loading" id="filter-section" aria-label="Target filter">

docs/scripts/pages.json

@@ -18,7 +18,6 @@
         }
       }
     </script>
-<script type="text/javascript" src="https://unpkg.com/kotlin-playground@1/dist/playground.min.js" async></script>
 <script type="text/javascript" src="../../../scripts/sourceset_dependencies.js" async></script>
 <link href="../../../styles/style.css" rel="Stylesheet">
 <link href="../../../styles/main.css" rel="Stylesheet">
@@ -39,7 +38,7 @@
             </a>        <button class="navigation-controls--btn navigation-controls--btn_toc ui-kit_mobile-only" id="toc-toggle" type="button">Toggle table of contents
         </button>
         <div class="navigation-controls--break ui-kit_mobile-only"></div>
-        <div class="library-version" id="library-version">1.7.2
+        <div class="library-version" id="library-version">1.7.3
         </div>
         <div class="navigation-controls">
         <ul class="filter-section filter-section_loading" id="filter-section" aria-label="Target filter">

docs/scripts/platform-content-handler.js

@@ -18,7 +18,6 @@
         }
       }
     </script>
-<script type="text/javascript" src="https://unpkg.com/kotlin-playground@1/dist/playground.min.js" async></script>
 <script type="text/javascript" src="../../scripts/sourceset_dependencies.js" async></script>
 <link href="../../styles/style.css" rel="Stylesheet">
 <link href="../../styles/main.css" rel="Stylesheet">
@@ -39,7 +38,7 @@
             </a>        <button class="navigation-controls--btn navigation-controls--btn_toc ui-kit_mobile-only" id="toc-toggle" type="button">Toggle table of contents
         </button>
         <div class="navigation-controls--break ui-kit_mobile-only"></div>
-        <div class="library-version" id="library-version">1.7.2
+        <div class="library-version" id="library-version">1.7.3
         </div>
         <div class="navigation-controls">
         <ul class="filter-section filter-section_loading" id="filter-section" aria-label="Target filter">

docs/sqlx4k-arrow/index.html

@@ -18,7 +18,6 @@
         }
       }
     </script>
-<script type="text/javascript" src="https://unpkg.com/kotlin-playground@1/dist/playground.min.js" async></script>
 <script type="text/javascript" src="../../scripts/sourceset_dependencies.js" async></script>
 <link href="../../styles/style.css" rel="Stylesheet">
 <link href="../../styles/main.css" rel="Stylesheet">
@@ -39,7 +38,7 @@
             </a>        <button class="navigation-controls--btn navigation-controls--btn_toc ui-kit_mobile-only" id="toc-toggle" type="button">Toggle table of contents
         </button>
         <div class="navigation-controls--break ui-kit_mobile-only"></div>
-        <div class="library-version" id="library-version">1.7.2
+        <div class="library-version" id="library-version">1.7.3
         </div>
         <div class="navigation-controls">
         <ul class="filter-section filter-section_loading" id="filter-section" aria-label="Target filter">

docs/sqlx4k-arrow/io.github.smyrgeorge.sqlx4k.arrow.impl.extensions/-db-result/index.html

@@ -18,7 +18,6 @@
         }
       }
     </script>
-<script type="text/javascript" src="https://unpkg.com/kotlin-playground@1/dist/playground.min.js" async></script>
 <script type="text/javascript" src="../../../scripts/sourceset_dependencies.js" async></script>
 <link href="../../../styles/style.css" rel="Stylesheet">
 <link href="../../../styles/main.css" rel="Stylesheet">
@@ -39,7 +38,7 @@
             </a>        <button class="navigation-controls--btn navigation-controls--btn_toc ui-kit_mobile-only" id="toc-toggle" type="button">Toggle table of contents
         </button>
         <div class="navigation-controls--break ui-kit_mobile-only"></div>
-        <div class="library-version" id="library-version">1.7.2
+        <div class="library-version" id="library-version">1.7.3
         </div>
         <div class="navigation-controls">
         <ul class="filter-section filter-section_loading" id="filter-section" aria-label="Target filter">
@@ -95,7 +94,7 @@
   <div class="cover ">
     <h1 class="cover"><span>batch</span><wbr><span><span>Insert</span></span></h1>
   </div>
-  <div class="platform-hinted " data-platform-hinted="data-platform-hinted"><div class="content sourceset-dependent-content" data-active="" data-togglable=":sqlx4k-arrow/commonMain"><div class="symbol monospace"><span class="token keyword">context</span><span class="token punctuation">(</span><span class="parameters "><span class="parameter ">context<span class="token operator">: </span><a href="../../../sqlx4k/io.github.smyrgeorge.sqlx4k/-query-executor/index.html">QueryExecutor</a></span></span><span class="token punctuation">)</span><br><span class="token keyword">abstract </span><span class="token keyword">suspend </span><span class="token keyword">fun </span><a href="batch-insert.html"><span class="token function">batchInsert</span></a><span class="token punctuation">(</span><span class="parameters "><span class="parameter ">entities<span class="token operator">: </span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-iterable/index.html">Iterable</a><span class="token operator">&lt;</span><a href="index.html">T</a><span class="token operator">&gt;</span></span></span><span class="token punctuation">)</span><span class="token operator">: </span><a href="../../io.github.smyrgeorge.sqlx4k.arrow.impl.extensions/-db-result/index.html">DbResult</a><span class="token operator">&lt;</span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html">List</a><span class="token operator">&lt;</span><a href="index.html">T</a><span class="token operator">&gt;</span><span class="token operator">&gt;</span><span class="source-link-wrapper"><span class="source-link" data-element-type="source-link">(<a href="https://github.com/smyrgeorge/sqlx4k/tree/main/sqlx4k-arrow/src/commonMain/kotlin/io/github/smyrgeorge/sqlx4k/arrow/ArrowContextCrudRepository.kt#L87">source</a>)</span></span></div><p class="paragraph">Inserts multiple entities into the data source using the specified driver context.</p><p class="paragraph">This method performs an asynchronous batch insert operation and returns the result. If the operation is successful, the result will contain the list of inserted entities. In case of failure, the result contains the error details.</p><p class="paragraph">Note: Batch insert is not supported for MySQL dialect (no multi-row INSERT with RETURNING).</p><span class="kdoc-tag"><h4 class="">Return</h4><p class="paragraph">A <a href="../../io.github.smyrgeorge.sqlx4k.arrow.impl.extensions/-db-result/index.html">DbResult</a> containing the list of inserted entities of type <a href="index.html">T</a> if the operation is successful,     or an error if the operation fails.</p></span><h4 class="tableheader">Parameters</h4><div class="table"><div class="table-row table-row_content" data-filterable-current=":sqlx4k-arrow/commonMain" data-filterable-set=":sqlx4k-arrow/commonMain"><div class="main-subrow keyValue "><div class=""><span class="inline-flex"><div><u><span><span>entities</span></span></u></div></span></div><div><div class="title"><p class="paragraph">The collection of entities of type <a href="index.html">T</a> to be inserted into the data source.</p></div></div></div></div></div></div></div>
+  <div class="platform-hinted " data-platform-hinted="data-platform-hinted"><div class="content sourceset-dependent-content" data-active="" data-togglable=":sqlx4k-arrow/commonMain"><div class="symbol monospace"><span class="token keyword">context</span><span class="token punctuation">(</span><span class="parameters "><span class="parameter ">context<span class="token operator">: </span><a href="../../../sqlx4k/io.github.smyrgeorge.sqlx4k/-query-executor/index.html">QueryExecutor</a></span></span><span class="token punctuation">)</span><br><span class="token keyword">abstract </span><span class="token keyword">suspend </span><span class="token keyword">fun </span><a href="batch-insert.html"><span class="token function">batchInsert</span></a><span class="token punctuation">(</span><span class="parameters "><span class="parameter ">entities<span class="token operator">: </span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-iterable/index.html">Iterable</a><span class="token operator">&lt;</span><a href="index.html">T</a><span class="token operator">&gt;</span></span></span><span class="token punctuation">)</span><span class="token operator">: </span><a href="../../io.github.smyrgeorge.sqlx4k.arrow.impl.extensions/-db-result/index.html">DbResult</a><span class="token operator">&lt;</span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html">List</a><span class="token operator">&lt;</span><a href="index.html">T</a><span class="token operator">&gt;</span><span class="token operator">&gt;</span><span class="source-link-wrapper"><span class="source-link" data-element-type="source-link">(<a href="https://github.com/smyrgeorge/sqlx4k/tree/main/sqlx4k-arrow/src/commonMain/kotlin/io/github/smyrgeorge/sqlx4k/arrow/ArrowContextCrudRepository.kt#L87">source</a>)</span></span></div><p class="paragraph">Inserts multiple entities into the data source using the specified driver context.</p><p class="paragraph">This method performs an asynchronous batch insert operation and returns the result. If the operation is successful, the result will contain the list of inserted entities. In case of failure, the result contains the error details.</p><p class="paragraph">Note: Batch insert is not supported for MySQL dialect (no multi-row INSERT with RETURNING).</p><span class="kdoc-tag"><h4 class="">Return</h4><p class="paragraph">A <a href="../../io.github.smyrgeorge.sqlx4k.arrow.impl.extensions/-db-result/index.html">DbResult</a> containing the list of inserted entities of type <a href="index.html">T</a> if the operation is successful,          or an error if the operation fails.</p></span><h4 class="tableheader">Parameters</h4><div class="table"><div class="table-row table-row_content" data-filterable-current=":sqlx4k-arrow/commonMain" data-filterable-set=":sqlx4k-arrow/commonMain"><div class="main-subrow keyValue "><div class=""><span class="inline-flex"><div><u><span><span>entities</span></span></u></div></span></div><div><div class="title"><p class="paragraph">The collection of entities of type <a href="index.html">T</a> to be inserted into the data source.</p></div></div></div></div></div></div></div>
 </div>
     <div class="footer">
         <div class="footer--container">