FIX: max heading level set to 3/2 for toc (#323)

* fix; max heading level set to 2 for toc

* fix: fixed toc for pages where heading was greater than 2

docs/api/app.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.app
+toc_max_heading_level: 2
 ---
 
 `Neutralino.app` namespace contains methods related to the current application instance.

docs/api/clipboard.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.clipboard
+toc_max_heading_level: 2
 ---
 
 `Neutralino.clipboard` namespace offers functions to access system clipboard.

docs/api/computer.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.computer
+toc_max_heading_level: 2
 ---
 
 `Neutralino.computer` namespace contains methods related to the user's hardware.

docs/api/custom.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.custom
+toc_max_heading_level: 2
 ---
 
 Neutralinojs offers the extensions API to write custom backend code with any programming language,

docs/api/debug.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.debug
+toc_max_heading_level: 2
 ---
 
 `Neutralino.debug` namespace contains application debugging utilities.

docs/api/error-codes.md

@@ -1,5 +1,6 @@
 ---
 title: Error Codes
+toc_max_heading_level: 2
 ---
 
 If a particular native API call fails, Neutralinojs client library rejects the pending Promise with an error object.

docs/api/events.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.events
+toc_max_heading_level: 2
 ---
 
 `Neutralino.events` namespace contains methods related to the native events handling. These events are often initiated

docs/api/extensions.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.extensions
+toc_max_heading_level: 2
 ---
 
 `Neutralino.extensions` namespace contains methods related to Neutralino extensions. Extensions let

docs/api/filesystem.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.filesystem
+toc_max_heading_level: 2
 ---
 
 `Neutralino.filesystem` namespace contains methods for handling files.

docs/api/global-variables.md

@@ -1,5 +1,6 @@
 ---
 title: Global Variables
+toc_max_heading_level: 2
 ---
 
 These JavaScript variables can be used anywhere because these variables are defined in the window scope.

docs/api/init.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.init
+toc_max_heading_level: 2
 ---
 
 `init` is not a namespace, it's a function that initializes a Neutralinojs application.

docs/api/os.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.os
+toc_max_heading_level: 2
 ---
 
 `Neutralino.os` namespace contains methods related to the user's operating system.

docs/api/overview.md

@@ -1,5 +1,6 @@
 ---
 title: Native API Overview
+toc_max_heading_level: 2
 ---
 
 Neutralinojs offers a JavaScript client library (also known as Neutralino.js) for developers to interact

docs/api/storage.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.storage
+toc_max_heading_level: 2
 ---
 
 Neutralinojs has a built-in shared key-value storage. It's like a

docs/api/updater.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.updater
+toc_max_heading_level: 2
 ---
 
 `Neutralino.updater` namespace contains methods related to built-in automatic updater. Neutralinojs offers

docs/api/window.md

@@ -1,5 +1,6 @@
 ---
 title: Neutralino.window
+toc_max_heading_level: 2
 ---
 
 The `Neutralino.window` namespace contains methods related to the current native window instance.

src/theme/DocItem/TOC/Desktop/index.js

@@ -7,11 +7,13 @@ import { useTOCHighlight } from "@docusaurus/theme-common/internal"
 const LINK_CLASS_NAME = 'table-of-contents__link';
 const ACTIVE_LINK_CLASS_NAME = 'table-of-contents__link--active';
 const TOP_OFFSET = 100;
+const MAX_HEADING_LEVEL = 3;
 
 /* eslint-disable jsx-a11y/control-has-associated-label */
 function Headings({
   toc,
   isChild,
+  frontMatter
 }) {
   if (!toc) {
     return null;
@@ -21,23 +23,27 @@ function Headings({
       className={
         isChild ? '' : 'table-of-contents table-of-contents__left-border'
       }>
-      {toc.map((heading) => (
-        <li key={heading.id}>
-          <a
-            href={`#${heading.id}`}
-            className={LINK_CLASS_NAME}
-            // Developer provided the HTML, so assume it's safe.
-            // eslint-disable-next-line react/no-danger
-            dangerouslySetInnerHTML={{ __html: heading.value }}
-          />
-          <Headings isChild toc={heading.children} />
-        </li>
-      ))}
+      {toc.map((heading) => {
+        const LOCAL_MAX_HEADING_VALUE = frontMatter.toc_max_heading_level ? frontMatter.toc_max_heading_level : MAX_HEADING_LEVEL
+        if(heading.level > LOCAL_MAX_HEADING_VALUE) return null
+        return (
+          <li key={heading.id}>
+            <a
+              href={`#${heading.id}`}
+              className={LINK_CLASS_NAME}
+              // Developer provided the HTML, so assume it's safe.
+              // eslint-disable-next-line react/no-danger
+              dangerouslySetInnerHTML={{ __html: heading.value }}
+            />
+            <Headings isChild toc={heading.children} />
+          </li>
+        )
+      })}
     </ul>
   );
 }
 
-function CustomTOC({ toc }) {
+function CustomTOC({ toc, frontMatter }) {
   useTOCHighlight({linkClassName: LINK_CLASS_NAME, linkActiveClassName: ACTIVE_LINK_CLASS_NAME, maxHeadingLevel: TOP_OFFSET, minHeadingLevel: 0});
   const [isInitialized, setIsInitialized] = useState(false);
   const [isEthABlocked, setIsEthABlocked] = useState(false)
@@ -63,14 +69,14 @@ function CustomTOC({ toc }) {
         >
         </div>
       </div>
-      <Headings toc={toc} />
+      <Headings toc={toc} frontMatter={frontMatter}/>
     </div>
   );
 }
 
 export default function DocItemTOCDesktop() {
   const {toc, frontMatter} = useDoc();
   return (
-    <CustomTOC toc={toc}/>
+    <CustomTOC toc={toc} frontMatter={frontMatter}/>
   );
 }