@staticbolt/docs 0.0.1-beta.2 → 0.0.1-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staticbolt/docs",
-  "version": "0.0.1-beta.2",
+  "version": "0.0.1-beta.3",
   "description": "Documentation theme for staticbolt: layout parts, styles, and plugins shared by every docs site.",
   "author": "Ahmed ALABSI",
   "license": "MIT",

package/sources/parts/callouts/callouts.part.html

@@ -2,8 +2,8 @@
 <script type="application/x-typescript" build-time>
   for (const callout of document.querySelectorAll("details.callout")) {
     const accordion = document.createElement("sv-accordion");
-    accordion.setAttribute("data-callout", callout.getAttribute("data-callout"));
-    accordion.setAttribute("class", callout.getAttribute("class"));
+    accordion.setAttribute("data-callout", callout.getAttribute("data-callout") || "");
+    accordion.setAttribute("class", callout.getAttribute("class") || "");
     accordion.setAttribute("heading-level", "none");
 
     if (callout.hasAttribute("open")) {

package/sources/parts/color-scheme-switch/color-scheme-switch.part.html

@@ -77,12 +77,7 @@
 
       document.addEventListener("DOMContentLoaded", onReady, { once: true, passive: true });
 
-      /**
-       * @param {() => void} update
-       * @param {number} x
-       * @param {number} y
-       */
-      async function viewTransition(update, x, y) {
+      async function viewTransition(update: () => void, x: number, y: number) {
         if (!document.startViewTransition || matchMedia("(prefers-reduced-motion: reduce)").matches) {
           update();
           return;

package/sources/parts/pagination-links/pagination-links.part.html

@@ -29,11 +29,11 @@
   // ::: Get current link and populate previous/next links :::
   import { join, dirname, normalize } from "node:path";
 
-  const paginationPrev = document.querySelector(".pagination-link-prev");
-  const paginationPrevTitle = paginationPrev.querySelector(".link-title");
+  const paginationPrev = document.querySelector(".pagination-link-prev")!;
+  const paginationPrevTitle = paginationPrev.querySelector(".link-title")!;
 
-  const paginationNext = document.querySelector(".pagination-link-next");
-  const paginationNextTitle = paginationNext.querySelector(".link-title");
+  const paginationNext = document.querySelector(".pagination-link-next")!;
+  const paginationNextTitle = paginationNext.querySelector(".link-title")!;
 
   // You can find `.sidebar` in the documentation layout
   const navigationLinks = document.querySelectorAll(".sidebar a.sidebar-link");
@@ -50,7 +50,7 @@
     const previousLink = navigationLinks[linkIndex - 1];
     if (previousLink) {
       const prevHref = previousLink.getAttribute("href");
-      paginationPrev.setAttribute("href", prevHref);
+      paginationPrev.setAttribute("href", prevHref || "#");
 
       const prevTitle = previousLink.getAttribute("data-title") || previousLink.textContent;
       paginationPrevTitle.textContent = prevTitle;
@@ -62,7 +62,7 @@
     const nextLink = navigationLinks[linkIndex + 1];
     if (nextLink) {
       const nextHref = nextLink.getAttribute("href");
-      paginationNext.setAttribute("href", nextHref);
+      paginationNext.setAttribute("href", nextHref || "#");
 
       const nextTitle = nextLink.getAttribute("data-title") || nextLink.textContent;
       paginationNextTitle.textContent = nextTitle;

package/sources/parts/sidebar/sidebar.part.html

@@ -22,7 +22,7 @@
   const navigationLinks = document.querySelectorAll(".sidebar a");
   const currentFile = normalize(__filepath);
 
-  for (const [linkIndex, link] of navigationLinks.entries()) {
+  for (const [, link] of navigationLinks.entries()) {
     const linkPath = join(dirname(__filepath), link.attributes.href, "index.html");
     if (linkPath !== currentFile) continue;
 
@@ -43,8 +43,10 @@
 
 <!-- ::: Persist sidebar navigation state across page loads. ::: -->
 <script type="application/x-typescript">
+  import type { Accordion } from "@staticview/ui/accordion";
+
   (() => {
-    const accordions = document.querySelectorAll<HTMLDivElement>(".sidebar-accordion");
+    const accordions = document.querySelectorAll<Accordion>(".sidebar-accordion");
 
     // ::: Restore the accordion's previous open state. :::
     try {
@@ -67,7 +69,7 @@
 
     // ::: Save accordion open state when toggled. :::
     const accordionToggleHandler = () => {
-      const state = {};
+      const state: Record<string, boolean> = {};
 
       for (const [accordionIndex, accordion] of accordions.entries()) {
         state[accordionIndex] = accordion.opened;
@@ -81,7 +83,8 @@
     }
 
     // ::: Restore sidebar scroll position. :::
-    const sidebar = document.querySelector(".sidebar");
+    const sidebar = document.querySelector<HTMLElement>(".sidebar");
+    if (!sidebar) return;
 
     const onReady = () => {
       // First rAF: end of current task, second rAF: after first paint
@@ -97,7 +100,7 @@
 
     // ::: Save sidebar scroll position. :::
     const sidebarScrollHandler = () => {
-      sessionStorage.setItem("sidebar-scroll", sidebar.scrollTop);
+      sessionStorage.setItem("sidebar-scroll", String(sidebar.scrollTop));
     };
 
     sidebar.addEventListener("scroll", sidebarScrollHandler, { passive: true });

package/sources/parts/table-of-content/table-of-content-desktop.part.html

@@ -71,17 +71,18 @@
     const links = document.querySelectorAll(".toc-list a");
 
     // Mobile TOC current title
-    const currentTitle = document.querySelector(".toc-current-title");
+    const currentTitle = document.querySelector<HTMLElement>(".toc-current-title");
 
     const headings = Array.from(links)
-      .map(a => document.getElementById(a.getAttribute("href").slice(1)))
-      .filter(Boolean);
+      .map(a => document.getElementById(a.getAttribute("href")?.slice(1) ?? ""))
+      .filter(Boolean) as HTMLElement[];
 
-    function setActive(id) {
+    function setActive(id: string) {
       for (const link of links) {
         const active = link.getAttribute("href") === "#" + id;
         link.classList.toggle("active", active);
-        if (active) {
+
+        if (active && currentTitle) {
           currentTitle.textContent = link.textContent;
         }
       }
@@ -90,8 +91,8 @@
     function update() {
       if (!headings.length) return;
 
-      let scrollPaddingTop = getComputedStyle(document.documentElement).getPropertyValue("scroll-padding-top");
-      scrollPaddingTop = parseFloat(scrollPaddingTop.replace("px", "").trim());
+      const scrollPaddingTopStyle = getComputedStyle(document.documentElement).getPropertyValue("scroll-padding-top");
+      let scrollPaddingTop = parseFloat(scrollPaddingTopStyle.replace("px", "").trim());
       scrollPaddingTop = !isFinite(scrollPaddingTop) ? 50 : scrollPaddingTop + 2;
 
       let active = headings[0];

package/sources/parts/table-of-content/table-of-content-mobile.part.html

@@ -13,12 +13,16 @@
 
 <!-- ::: Close the accordion when a link is clicked ::: -->
 <script type="application/x-typescript" module>
-  const tocAccordion = document.querySelector(".toc-accordion");
+  import type { Accordion } from "@staticview/ui/accordion";
+
+  const tocAccordion = document.querySelector<Accordion>(".toc-accordion");
   const tocLinks = document.querySelectorAll(".toc-accordion a");
 
   for (const link of tocLinks) {
     link.addEventListener("click", () => {
-      tocAccordion.opened = false;
+      if (tocAccordion) {
+        tocAccordion.opened = false;
+      }
     });
   }
 </script>