Publish examples

examples/dokka-customFormat-example/html/scripts/clipboard.js

@@ -1,3 +1,7 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 window.addEventListener('load', () => {
     document.querySelectorAll('span.copy-icon').forEach(element => {
         element.addEventListener('click', (el) => copyElementsContentToClipboard(element));

examples/dokka-customFormat-example/html/scripts/navigation-loader.js

@@ -1,3 +1,7 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 navigationPageText = fetch(pathToRoot + "navigation.html").then(response => response.text())
 
 displayNavigationFromPage = () => {

examples/dokka-customFormat-example/html/scripts/platform-content-handler.js

@@ -1,3 +1,7 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 filteringContext = {
     dependencies: {},
     restrictedDependencies: [],

examples/dokka-customFormat-example/html/scripts/symbol-parameters-wrapper_deferred.js

@@ -1,83 +1,64 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 // helps with some corner cases where <wbr> starts working already,
 // but the signature is not yet long enough to be wrapped
-const leftPaddingPx = 60
-
-const symbolResizeObserver = new ResizeObserver(entries => {
-    entries.forEach(entry => {
-        const symbolElement = entry.target
-        symbolResizeObserver.unobserve(symbolElement) // only need it once, otherwise will be executed multiple times
-        wrapSymbolParameters(symbolElement);
-    })
-});
-
-const wrapAllSymbolParameters = () => {
-    document.querySelectorAll("div.symbol").forEach(symbol => wrapSymbolParameters(symbol))
-}
+(function() {
+    const leftPaddingPx = 60;
 
-const wrapSymbolParameters = (symbol) => {
-    let parametersBlock = symbol.querySelector("span.parameters")
-    if (parametersBlock == null) {
-        return // nothing to wrap
+    function createNbspIndent() {
+        let indent = document.createElement("span");
+        indent.append(document.createTextNode("\u00A0\u00A0\u00A0\u00A0"));
+        indent.classList.add("nbsp-indent");
+        return indent;
     }
 
-    let symbolBlockWidth = symbol.clientWidth
+    function wrapSymbolParameters(entry) {
+        const symbol = entry.target;
+        const symbolBlockWidth = entry.borderBoxSize && entry.borderBoxSize[0] && entry.borderBoxSize[0].inlineSize;
 
-    // Even though the script is marked as `defer` and we wait for `DOMContentLoaded` event,
-    // it can happen that `symbolBlockWidth` is 0, indicating that something hasn't been loaded.
-    // In this case, just retry once all styles have been applied and it has been resized correctly.
-    if (symbolBlockWidth === 0) {
-        symbolResizeObserver.observe(symbol)
-        return
-    }
+        // Even though the script is marked as `defer` and we wait for `DOMContentLoaded` event,
+        // or if this block is a part of hidden tab, it can happen that `symbolBlockWidth` is 0,
+        // indicating that something hasn't been loaded.
+        // In this case, observer will be triggered onсe again when it will be ready.
+        if (symbolBlockWidth > 0) {
+            const node = symbol.querySelector(".parameters");
 
-    let innerTextWidth = Array.from(symbol.children)
-        .filter(it => !it.classList.contains("block")) // blocks are usually on their own (like annotations), so ignore it
-        .map(it => it.getBoundingClientRect().width).reduce((a, b) => a + b, 0)
+            if (node) {
+                // if window resize happened and observer was triggered, reset previously wrapped
+                // parameters as they might not need wrapping anymore, and check again
+                node.classList.remove("wrapped");
+                node.querySelectorAll(".parameter .nbsp-indent")
+                    .forEach(indent => indent.remove());
 
-    // if signature text takes up more than a single line, wrap params for readability
-    let shouldWrapParams = innerTextWidth > (symbolBlockWidth - leftPaddingPx)
-    if (shouldWrapParams) {
-        parametersBlock.classList.add("wrapped")
-        parametersBlock.querySelectorAll("span.parameter").forEach(param => {
-            // has to be a physical indent so that it can be copied. styles like
-            // paddings and `::before { content: "    " }` do not work for that
-            param.prepend(createNbspIndent())
-        })
-    }
-}
+                const innerTextWidth = Array.from(symbol.children)
+                    .filter(it => !it.classList.contains("block")) // blocks are usually on their own (like annotations), so ignore it
+                    .map(it => it.getBoundingClientRect().width)
+                    .reduce((a, b) => a + b, 0);
 
-const createNbspIndent = () => {
-    let indent = document.createElement("span")
-    indent.append(document.createTextNode("\u00A0\u00A0\u00A0\u00A0"))
-    indent.classList.add("nbsp-indent")
-    return indent
-}
+                // if signature text takes up more than a single line, wrap params for readability
+                if (innerTextWidth > (symbolBlockWidth - leftPaddingPx)) {
+                    node.classList.add("wrapped");
+                    node.querySelectorAll(".parameter").forEach(param => {
+                        // has to be a physical indent so that it can be copied. styles like
+                        // paddings and `::before { content: "    " }` do not work for that
+                        param.prepend(createNbspIndent());
+                    });
+                }
+            }
+        }
+    }
 
-const resetAllSymbolParametersWrapping = () => {
-    document.querySelectorAll("div.symbol").forEach(symbol => resetSymbolParametersWrapping(symbol))
-}
+    const symbolsObserver = new ResizeObserver(entries => entries.forEach(wrapSymbolParameters));
 
-const resetSymbolParametersWrapping = (symbol) => {
-    let parameters = symbol.querySelector("span.parameters")
-    if (parameters != null) {
-        parameters.classList.remove("wrapped")
-        parameters.querySelectorAll("span.parameter").forEach(param => {
-            let indent = param.querySelector("span.nbsp-indent")
-            if (indent != null) indent.remove()
-        })
+    function initHandlers() {
+        document.querySelectorAll("div.symbol").forEach(symbol => symbolsObserver.observe(symbol));
     }
-}
 
-if (document.readyState === 'loading') {
-    window.addEventListener('DOMContentLoaded', () => {
-        wrapAllSymbolParameters()
-    })
-} else {
-    wrapAllSymbolParameters()
-}
+    if (document.readyState === 'loading') window.addEventListener('DOMContentLoaded', initHandlers);
+    else initHandlers();
 
-window.onresize = event => {
-    // need to re-calculate if params need to be wrapped after resize
-    resetAllSymbolParametersWrapping()
-    wrapAllSymbolParameters()
-}
+    // ToDo: Add `unobserve` if dokka will be SPA-like:
+    //       https://github.com/w3c/csswg-drafts/issues/5155
+})();

examples/dokka-customFormat-example/html/styles/font-jb-sans-auto.css

@@ -1,3 +1,7 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 /* Light weight */
 @font-face {
     font-family: 'JetBrains Sans';

examples/dokka-customFormat-example/html/styles/prism.css

@@ -1,3 +1,7 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 /*
  * Custom Dokka styles
  */

examples/dokka-customFormat-example/html/styles/style.css

@@ -1,3 +1,7 @@
+/*
+ * Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
+ */
+
 @import url('./font-jb-sans-auto.css');
 @import url('https://fonts.googleapis.com/css?family=JetBrains+Mono');
 
@@ -1476,4 +1480,4 @@ has only one header, and the header text is the same as the tab name, so no poin
 */
 .main-content[data-page-type="package"] .tabs-section-body h2 {
     display: none;
-}
+}