RubyGems - datalog-theme - Versions diffs - 0.6.0 - Mend

datalog-theme 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (180) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +162 -0
data/CITATION.cff +29 -0
data/LICENSE +21 -0
data/README.md +257 -0
data/_data/academic.yml +217 -0
data/_data/cdn-integrity.yml +51 -0
data/_data/config/author.yml +121 -0
data/_data/config/features.yml +262 -0
data/_data/config/site.yml +42 -0
data/_data/config/theme.yml +181 -0
data/_data/datasets.yml +28 -0
data/_data/i18n/en.yml +438 -0
data/_data/i18n/es.yml +438 -0
data/_data/i18n/pt.yml +438 -0
data/_data/js_manifest.json +22 -0
data/_data/js_meta.json +371 -0
data/_data/navigation.yml +145 -0
data/_data/projects.yml +41 -0
data/_data/publications.yml +28 -0
data/_data/social.yml +73 -0
data/_data/visualizations.yml +51 -0
data/_includes/analytics/dashboard.html +149 -0
data/_includes/analytics.html +9 -0
data/_includes/components/academic-dashboard.html +347 -0
data/_includes/components/advanced-search.html +682 -0
data/_includes/components/api-function.html +94 -0
data/_includes/components/author-bio.html +166 -0
data/_includes/components/bookmark-system.html +96 -0
data/_includes/components/breadcrumbs.html +89 -0
data/_includes/components/citation-tools.html +94 -0
data/_includes/components/comments.html +244 -0
data/_includes/components/content-provenance.html +43 -0
data/_includes/components/content-recommendations.html +228 -0
data/_includes/components/difficulty-badge.html +84 -0
data/_includes/components/email-preferences.html +200 -0
data/_includes/components/enhanced-code-block.html +212 -0
data/_includes/components/enhanced-metadata.html +228 -0
data/_includes/components/enhanced-toc.html +209 -0
data/_includes/components/hero.html +15 -0
data/_includes/components/language-switcher.html +396 -0
data/_includes/components/math-fallback.html +19 -0
data/_includes/components/navigation-enhancements.html +454 -0
data/_includes/components/newsletter-signup.html +178 -0
data/_includes/components/open-science-badges.html +16 -0
data/_includes/components/package-install.html +194 -0
data/_includes/components/performance-monitor.html +170 -0
data/_includes/components/popular-posts.html +233 -0
data/_includes/components/post-hero.html +62 -0
data/_includes/components/reading-progress.html +133 -0
data/_includes/components/reading-time.html +121 -0
data/_includes/components/responsive-image.html +63 -0
data/_includes/components/search-facets.html +307 -0
data/_includes/components/series-navigation.html +124 -0
data/_includes/components/social-proof.html +34 -0
data/_includes/components/social-share.html +119 -0
data/_includes/components/user-preferences.html +566 -0
data/_includes/components/visualization-card.html +24 -0
data/_includes/components/viz-table-fallback.html +19 -0
data/_includes/critical-css/default.html +0 -0
data/_includes/critical-css/home.html +0 -0
data/_includes/critical-css/post.html +0 -0
data/_includes/csp-meta.html +17 -0
data/_includes/footer/nav-column.html +31 -0
data/_includes/footer.html +76 -0
data/_includes/head.html +337 -0
data/_includes/header/navigation.html +48 -0
data/_includes/header.html +70 -0
data/_includes/helpers/array-to-sentence.html +21 -0
data/_includes/helpers/date-format.html +16 -0
data/_includes/helpers/link-with-icon.html +26 -0
data/_includes/layouts/default/article.html +67 -0
data/_includes/meta/language-attributes.html +25 -0
data/_includes/meta/math-config.html +21 -0
data/_includes/meta/schema.html +153 -0
data/_includes/meta/scripts-loader.html +52 -0
data/_includes/post/related-posts.html +63 -0
data/_includes/scripts.html +72 -0
data/_includes/skip-link.html +1 -0
data/_includes/toc.html +2 -0
data/_layouts/archive.html +282 -0
data/_layouts/dataset.html +52 -0
data/_layouts/default.html +33 -0
data/_layouts/home.html +48 -0
data/_layouts/notebook.html +173 -0
data/_layouts/package.html +238 -0
data/_layouts/page.html +16 -0
data/_layouts/portfolio.html +41 -0
data/_layouts/post-sidebar.html +183 -0
data/_layouts/post.html +338 -0
data/_layouts/project.html +252 -0
data/_layouts/research.html +504 -0
data/_plugins/analytics_dashboard.rb +315 -0
data/_plugins/config_validator.rb +397 -0
data/_plugins/csp_generator.rb +115 -0
data/_plugins/datalog_bibliography.rb +19 -0
data/_plugins/datalog_comments.rb +18 -0
data/_plugins/datalog_slides.rb +20 -0
data/_plugins/front_matter_compat.rb +109 -0
data/_plugins/i18n.rb +160 -0
data/_plugins/image_optimizer.rb +445 -0
data/_plugins/math_preprocessor.rb +185 -0
data/_plugins/notebook_converter.rb +1107 -0
data/_plugins/plugin_loader.rb +185 -0
data/_plugins/publications_generator.rb +234 -0
data/_plugins/reading_time.rb +15 -0
data/_plugins/search_normalizer.rb +74 -0
data/_plugins/sri_filter.rb +18 -0
data/_plugins/toc_filter.rb +68 -0
data/_plugins/warning_filter.rb +3 -0
data/_sass/_base.scss +142 -0
data/_sass/_components.scss +2380 -0
data/_sass/_header.scss +470 -0
data/_sass/_interactive.scss +344 -0
data/_sass/_layout.scss +1760 -0
data/_sass/_mathematical.scss +368 -0
data/_sass/_mixins.scss +99 -0
data/_sass/_package-docs.scss +715 -0
data/_sass/_phase1-enhancements.scss +721 -0
data/_sass/_phase3-enhancements.scss +874 -0
data/_sass/_phase4-enhancements.scss +1214 -0
data/_sass/_phase5-enhancements.scss +414 -0
data/_sass/_search.scss +654 -0
data/_sass/_syntax-highlighting.scss +128 -0
data/_sass/_theme.scss +79 -0
data/_sass/_typography.scss +148 -0
data/_sass/_utilities.scss +334 -0
data/_sass/_variables.scss +153 -0
data/_sass/_visualizations.scss +242 -0
data/assets/css/main.scss +4 -0
data/assets/img/20220607123041_detail.001.png +0 -0
data/assets/img/favicons/android-chrome-192x192.png +0 -0
data/assets/img/favicons/android-chrome-512x512.png +0 -0
data/assets/img/favicons/apple-touch-icon.png +0 -0
data/assets/img/favicons/favicon-16x16.png +0 -0
data/assets/img/favicons/favicon-32x32.png +0 -0
data/assets/img/favicons/favicon.ico +0 -0
data/assets/img/favicons/site.webmanifest +21 -0
data/assets/img/portfolio-placeholder.svg +20 -0
data/assets/js/academic.js +262 -0
data/assets/js/analytics-dashboard.js +382 -0
data/assets/js/core/dark-mode.js +79 -0
data/assets/js/core/github-cards.js +123 -0
data/assets/js/core/language-filter.js +69 -0
data/assets/js/core/navigation.js +184 -0
data/assets/js/core/scroll-progress.js +45 -0
data/assets/js/core/search-hotkeys.js +62 -0
data/assets/js/core/skip-links.js +62 -0
data/assets/js/loader.js +163 -0
data/assets/js/main.js +23 -0
data/assets/js/math.js +818 -0
data/assets/js/notebook.js +158 -0
data/assets/js/search/analytics.js +91 -0
data/assets/js/search/app.js +271 -0
data/assets/js/search/autocomplete.js +120 -0
data/assets/js/search/engine.js +260 -0
data/assets/js/search/filters.js +38 -0
data/assets/js/search/render.js +217 -0
data/assets/js/search/utils.js +99 -0
data/assets/js/search.js +354 -0
data/assets/js/visualizations.js +816 -0
data/assets/publications/datalog-publications.bib +8 -0
data/assets/publications/datalog-publications.ris +9 -0
data/assets/publications/publications.bib +30 -0
data/assets/templates/diogo-ribeiro-cv.md +31 -0
data/assets/templates/diogo-ribeiro-cv.tex +32 -0
data/bin/datalog +26 -0
data/datalog-theme.gemspec +72 -0
data/lib/datalog/cli.rb +563 -0
data/lib/datalog/plugin_system/dependency_resolver.rb +223 -0
data/lib/datalog/plugin_system.rb +237 -0
data/lib/datalog/plugins/citations.rb +182 -0
data/lib/datalog/plugins/comments.rb +183 -0
data/lib/datalog/plugins/search.rb +45 -0
data/lib/datalog/plugins/slides.rb +121 -0
data/lib/datalog/theme/theme.rb +18 -0
data/lib/datalog/theme/version.rb +7 -0
data/lib/datalog/warning_filter.rb +28 -0
data/lib/datalog-theme.rb +17 -0
metadata +555 -0

data/assets/js/core/dark-mode.js ADDED Viewed

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Dark mode toggle functionality.
+ * Persists user preference and respects system color scheme.
+ * @module core/dark-mode
+ */
+/** @constant {string} LocalStorage key for color mode preference */
+const STORAGE_KEY = "datalog-color-mode";
+/** @constant {string} Class applied to body for dark mode */
+const DARK_CLASS = "dark-mode";
+/**
+ * Resolves the initial dark mode preference from storage or system settings.
+ * @param {MediaQueryList} prefersDarkScheme - Media query for dark scheme preference
+ * @returns {boolean} True if dark mode should be enabled
+ */
+function resolveInitialPreference(prefersDarkScheme) {
+  const storedPreference = localStorage.getItem(STORAGE_KEY);
+  if (storedPreference === "dark") {
+    return true;
+  }
+  if (storedPreference === "light") {
+    return false;
+  }
+  return prefersDarkScheme.matches;
+}
+/**
+ * Initializes the dark mode toggle button and system preference listener.
+ * Reads initial preference from localStorage or system settings.
+ * @returns {void}
+ */
+export function initDarkModeToggle() {
+  const toggleButton = document.querySelector("[data-toggle-dark-mode]");
+  const body = document.body;
+  const prefersDarkScheme = window.matchMedia("(prefers-color-scheme: dark)");
+  if (resolveInitialPreference(prefersDarkScheme)) {
+    body.classList.add(DARK_CLASS);
+  }
+  /** Mirrors the effective theme on <body data-theme> for CSS hooks and tests. */
+  const syncThemeAttribute = () => {
+    const theme = body.classList.contains(DARK_CLASS) ? "dark" : "light";
+    body.dataset.theme = theme;
+    document.documentElement.dataset.theme = theme;
+  };
+  const syncButton = () => {
+    syncThemeAttribute();
+    if (!toggleButton) {
+      return;
+    }
+    toggleButton.setAttribute("aria-pressed", body.classList.contains(DARK_CLASS));
+  };
+  syncButton();
+  if (toggleButton) {
+    toggleButton.addEventListener("click", () => {
+      const isDark = body.classList.toggle(DARK_CLASS);
+      toggleButton.setAttribute("aria-pressed", String(isDark));
+      localStorage.setItem(STORAGE_KEY, isDark ? "dark" : "light");
+      syncThemeAttribute();
+    });
+  }
+  prefersDarkScheme.addEventListener("change", (event) => {
+    if (localStorage.getItem(STORAGE_KEY)) {
+      return;
+    }
+    if (event.matches) {
+      body.classList.add(DARK_CLASS);
+    } else {
+      body.classList.remove(DARK_CLASS);
+    }
+    syncButton();
+  });
+}

data/assets/js/core/github-cards.js ADDED Viewed

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview GitHub repository cards with live stats.
+ * Fetches and displays repository statistics with caching.
+ * @module core/github-cards
+ */
+/** @constant {string} Prefix for localStorage cache keys */
+const CACHE_PREFIX = "datalog-github-";
+/**
+ * Generates a cache key for a repository.
+ * @param {string} owner - Repository owner
+ * @param {string} repo - Repository name
+ * @returns {string} Cache key
+ */
+function cacheKey(owner, repo) {
+  return `${CACHE_PREFIX}${owner}-${repo}`;
+}
+function readCache(owner, repo, cacheTtl) {
+  try {
+    const raw = localStorage.getItem(cacheKey(owner, repo));
+    if (!raw) {
+      return null;
+    }
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") {
+      return null;
+    }
+    if (Date.now() - parsed.timestamp > cacheTtl) {
+      localStorage.removeItem(cacheKey(owner, repo));
+      return null;
+    }
+    return parsed.data;
+  } catch (error) {
+    console.warn("GitHub cache read failed", error);
+    return null;
+  }
+}
+function writeCache(owner, repo, data) {
+  try {
+    localStorage.setItem(
+      cacheKey(owner, repo),
+      JSON.stringify({ timestamp: Date.now(), data })
+    );
+  } catch (error) {
+    console.warn("GitHub cache write failed", error);
+  }
+}
+async function fetchRepository(owner, repo, apiBase, cacheTtl) {
+  const cached = readCache(owner, repo, cacheTtl);
+  if (cached) {
+    return cached;
+  }
+  try {
+    const response = await fetch(`${apiBase}/${owner}/${repo}`);
+    if (!response.ok) {
+      throw new Error(`GitHub API error: ${response.status}`);
+    }
+    const json = await response.json();
+    writeCache(owner, repo, json);
+    return json;
+  } catch (error) {
+    console.warn(`Unable to load GitHub data for ${owner}/${repo}`);
+    return null;
+  }
+}
+function applyRepositoryData(card, data) {
+  const statElements = card.querySelectorAll("[data-github-stat]");
+  statElements.forEach((element) => {
+    const stat = element.getAttribute("data-github-stat");
+    if (!stat) {
+      return;
+    }
+    const value = data[stat];
+    if (typeof value === "number") {
+      element.textContent = value.toLocaleString();
+    } else if (typeof value === "string" && value.length > 0) {
+      element.textContent = value;
+    }
+  });
+}
+/**
+ * Initializes GitHub repository cards by fetching live stats.
+ * Uses localStorage caching to minimize API calls.
+ * @returns {Promise<void[]>} Resolves when all cards are populated
+ */
+export function initGitHubCards() {
+  const cards = document.querySelectorAll("[data-github-owner][data-github-repo]");
+  if (!cards.length) {
+    return Promise.resolve();
+  }
+  const integrations = window.DatalogIntegrations || {};
+  const githubConfig = integrations.github || {};
+  if (githubConfig.enabled === false) {
+    return Promise.resolve();
+  }
+  const apiBase = githubConfig.api_base || "https://api.github.com/repos";
+  const cacheTtl = Number(githubConfig.cache_ttl || 43200) * 1000;
+  const promises = Array.from(cards).map((card) => {
+    const owner = card.getAttribute("data-github-owner");
+    const repo = card.getAttribute("data-github-repo");
+    if (!owner || !repo) {
+      return Promise.resolve();
+    }
+    return fetchRepository(owner, repo, apiBase, cacheTtl).then((data) => {
+      if (!data) {
+        return;
+      }
+      applyRepositoryData(card, data);
+    });
+  });
+  return Promise.all(promises);
+}

data/assets/js/core/language-filter.js ADDED Viewed

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Navigate-on-change select handling.
+ * @module core/language-filter
+ */
+const NAVIGATING_SELECTS = "[data-language-filter], [data-navigate-on-change]";
+/**
+ * Resolves an option value to a target that is safe to navigate to.
+ *
+ * Option values come from site data and front matter, so they are not visitor
+ * controlled, but rejecting non-http(s) schemes keeps a stray `javascript:`
+ * value from turning a dropdown into a script sink. Relative values carry no
+ * scheme and pass through untouched, so existing links keep working.
+ *
+ * @param {unknown} value Raw option value.
+ * @returns {string|null} The value to navigate to, or null when unsafe.
+ */
+function safeNavigationTarget(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  // Browsers ignore control characters when parsing a scheme, so strip them
+  // first; otherwise "java	script:alert(1)" would read as scheme-less here
+  // and still execute once assigned. Done by code point rather than a regex,
+  // which would trip no-control-regex.
+  const candidate = Array.from(value)
+    .filter((character) => {
+      const code = character.codePointAt(0);
+      return code > 0x1f && code !== 0x7f;
+    })
+    .join("")
+    .trim();
+  if (!candidate) {
+    return null;
+  }
+  const scheme = /^[a-z][a-z0-9+.-]*:/i.exec(candidate);
+  if (scheme && !/^https?:$/i.test(scheme[0])) {
+    return null;
+  }
+  return candidate;
+}
+/**
+ * Binds selects that navigate when their value changes.
+ *
+ * Replaces inline `onchange` handlers, which the site's CSP blocks because
+ * script-src carries no 'unsafe-inline'.
+ *
+ * @returns {void}
+ */
+export function initLanguageFilter() {
+  const selects = document.querySelectorAll(NAVIGATING_SELECTS);
+  if (selects.length === 0) {
+    return;
+  }
+  selects.forEach((select) => {
+    select.addEventListener("change", (event) => {
+      const target = safeNavigationTarget(event.target && event.target.value);
+      if (target) {
+        window.location.href = target;
+      }
+    });
+  });
+}

data/assets/js/core/navigation.js ADDED Viewed

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Navigation module for responsive site navigation.
+ * Handles mobile menu toggling, smooth scrolling, and keyboard navigation.
+ * @module core/navigation
+ */
+/** @constant {string} Media query for desktop viewport */
+const DESKTOP_MEDIA = "(min-width: 48rem)";
+/** @constant {string} Selector for the main navigation element */
+const NAV_SELECTOR = "#site-nav";
+/** @constant {string} Selector for the navigation toggle button */
+const TOGGLE_SELECTOR = ".nav-toggle";
+/** @constant {string} Class applied to body when nav is open */
+const NAV_OPEN_CLASS = "nav-open";
+/**
+ * Normalizes a URL path by removing trailing slashes and index.html.
+ * @param {string} path - The path to normalize
+ * @returns {string} Normalized path
+ */
+function normalizePath(path) {
+  return path.replace(/index\.html$/, "").replace(/\/$/, "");
+}
+function getAnchorTarget(link) {
+  const href = link.getAttribute("href");
+  if (!href) {
+    return null;
+  }
+  try {
+    const destination = new URL(href, window.location.origin);
+    if (!destination.hash) {
+      return null;
+    }
+    const current = new URL(window.location.href);
+    if (normalizePath(destination.pathname) !== normalizePath(current.pathname)) {
+      return null;
+    }
+    return destination.hash.replace("#", "");
+  } catch (error) {
+    return null;
+  }
+}
+function smoothScrollToId(id) {
+  if (!id) {
+    return false;
+  }
+  const target = document.getElementById(id);
+  if (!target) {
+    return false;
+  }
+  target.scrollIntoView({ behavior: "smooth", block: "start" });
+  return true;
+}
+/**
+ * Initializes the navigation system including mobile toggle,
+ * smooth scrolling for anchor links, and keyboard accessibility.
+ * @returns {void}
+ */
+export function initNavigation() {
+  const siteNav = document.querySelector(NAV_SELECTOR);
+  if (!siteNav) {
+    return;
+  }
+  const navToggle = document.querySelector(TOGGLE_SELECTOR);
+  const body = document.body;
+  const navMediaQuery = window.matchMedia(DESKTOP_MEDIA);
+  const syncNavForViewport = (isDesktop) => {
+    if (isDesktop) {
+      siteNav.dataset.open = "true";
+      body.classList.remove(NAV_OPEN_CLASS);
+      if (navToggle) {
+        navToggle.setAttribute("aria-expanded", "false");
+        navToggle.classList.remove("is-active");
+      }
+      return;
+    }
+    const isOpen = siteNav.dataset.open === "true";
+    if (!isOpen) {
+      siteNav.dataset.open = "false";
+    }
+    if (navToggle) {
+      navToggle.setAttribute("aria-expanded", String(isOpen));
+      navToggle.classList.toggle("is-active", isOpen);
+    }
+  };
+  const closeNav = ({ focusToggle = false } = {}) => {
+    if (navMediaQuery.matches) {
+      return;
+    }
+    siteNav.dataset.open = "false";
+    body.classList.remove(NAV_OPEN_CLASS);
+    if (navToggle) {
+      navToggle.setAttribute("aria-expanded", "false");
+      navToggle.classList.remove("is-active");
+      if (focusToggle) {
+        navToggle.focus();
+      }
+    }
+  };
+  const openNav = () => {
+    if (navMediaQuery.matches) {
+      return;
+    }
+    siteNav.dataset.open = "true";
+    body.classList.add(NAV_OPEN_CLASS);
+    if (navToggle) {
+      navToggle.setAttribute("aria-expanded", "true");
+      navToggle.classList.add("is-active");
+    }
+  };
+  const toggleNav = () => {
+    if (navMediaQuery.matches) {
+      return;
+    }
+    if (siteNav.dataset.open === "true") {
+      closeNav();
+    } else {
+      openNav();
+    }
+  };
+  if (!navMediaQuery.matches) {
+    siteNav.dataset.open = "false";
+  }
+  syncNavForViewport(navMediaQuery.matches);
+  navMediaQuery.addEventListener("change", (event) => {
+    if (event.matches) {
+      syncNavForViewport(true);
+    } else {
+      closeNav();
+      siteNav.dataset.open = "false";
+      syncNavForViewport(false);
+    }
+  });
+  const navLinks = siteNav.querySelectorAll(".nav-link");
+  navLinks.forEach((link) => {
+    const anchorId = getAnchorTarget(link);
+    link.addEventListener("click", (event) => {
+      if (!navMediaQuery.matches) {
+        closeNav();
+      }
+      if (anchorId && smoothScrollToId(anchorId)) {
+        event.preventDefault();
+      }
+    });
+  });
+  if (navToggle) {
+    navToggle.addEventListener("click", () => {
+      toggleNav();
+    });
+  }
+  document.addEventListener("keydown", (event) => {
+    if (event.key === "Escape") {
+      closeNav({ focusToggle: true });
+    }
+  });
+  document.addEventListener("click", (event) => {
+    if (navMediaQuery.matches || siteNav.dataset.open !== "true") {
+      return;
+    }
+    const target = event.target;
+    if (!target || typeof target.closest !== "function") {
+      return;
+    }
+    if (target.closest(NAV_SELECTOR) || (navToggle && target.closest(TOGGLE_SELECTOR))) {
+      return;
+    }
+    closeNav();
+  });
+}

data/assets/js/core/scroll-progress.js ADDED Viewed

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Scroll progress indicator.
+ * Shows reading progress as user scrolls through content.
+ * @module core/scroll-progress
+ */
+/**
+ * Calculates and updates the scroll progress indicator.
+ * @param {HTMLElement} progressBar - The progress bar element
+ * @param {HTMLElement|null} progressValue - Optional element to display percentage
+ */
+function calculateProgress(progressBar, progressValue) {
+  const scrollTop = window.pageYOffset || document.documentElement.scrollTop;
+  const docHeight = document.documentElement.scrollHeight - window.innerHeight;
+  const progress = docHeight > 0 ? Math.min((scrollTop / docHeight) * 100, 100) : 0;
+  if (progressBar.tagName === "PROGRESS") {
+    progressBar.setAttribute("value", String(progress));
+  } else {
+    progressBar.style.setProperty("--progress", `${progress}%`);
+  }
+  if (progressValue) {
+    progressValue.textContent = Math.round(progress);
+  }
+}
+/**
+ * Initializes the scroll progress indicator.
+ * Listens to scroll and resize events to update progress.
+ * @returns {void}
+ */
+export function initScrollProgress() {
+  const progressBar = document.querySelector("[data-scroll-progress]");
+  if (!progressBar) {
+    return;
+  }
+  const progressValue = document.querySelector("[data-scroll-progress-value]");
+  const updateProgress = () => calculateProgress(progressBar, progressValue);
+  updateProgress();
+  window.addEventListener("scroll", updateProgress, { passive: true });
+  window.addEventListener("resize", updateProgress);
+}

data/assets/js/core/search-hotkeys.js ADDED Viewed

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Search keyboard shortcuts.
+ * Enables "/" and Cmd/Ctrl+K hotkeys to focus search.
+ * @module core/search-hotkeys
+ */
+/**
+ * Focuses the global search input or navigates to search page.
+ * @param {HTMLElement} siteSearchForm - The search form element
+ */
+function focusGlobalSearch(siteSearchForm) {
+  if (!siteSearchForm) {
+    return;
+  }
+  const siteSearchInput = siteSearchForm.querySelector("input[type='search']");
+  const searchDestination = siteSearchForm.getAttribute("action");
+  if (siteSearchInput) {
+    siteSearchInput.focus();
+    siteSearchInput.select();
+  } else if (searchDestination) {
+    window.location.href = searchDestination;
+  }
+}
+function shouldIgnoreHotkey(activeElement) {
+  if (!activeElement) {
+    return false;
+  }
+  if (activeElement.isContentEditable) {
+    return true;
+  }
+  const tag = activeElement.tagName;
+  return tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT";
+}
+/**
+ * Initializes search keyboard shortcuts (/ and Cmd/Ctrl+K).
+ * @returns {void}
+ */
+export function initSearchHotkeys() {
+  const siteSearchForm = document.querySelector(".site-search");
+  if (!siteSearchForm) {
+    return;
+  }
+  document.addEventListener("keydown", (event) => {
+    if (shouldIgnoreHotkey(document.activeElement)) {
+      return;
+    }
+    if (event.key === "/" && !event.ctrlKey && !event.metaKey && !event.altKey) {
+      event.preventDefault();
+      focusGlobalSearch(siteSearchForm);
+    }
+    if ((event.key === "k" || event.key === "K") && (event.ctrlKey || event.metaKey)) {
+      event.preventDefault();
+      focusGlobalSearch(siteSearchForm);
+    }
+  });
+}

data/assets/js/core/skip-links.js ADDED Viewed

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Skip links for keyboard accessibility.
+ * Allows users to skip to main content areas.
+ * @module core/skip-links
+ */
+/**
+ * Focuses a target element, temporarily making it focusable if needed.
+ * @param {HTMLElement|null} target - The element to focus
+ */
+function focusTarget(target) {
+  if (!target) {
+    return;
+  }
+  const previousTabIndex = target.getAttribute("tabindex");
+  if (previousTabIndex === null) {
+    target.setAttribute("tabindex", "-1");
+    target.dataset.skipLinkTempTabindex = "true";
+  }
+  target.addEventListener(
+    "blur",
+    () => {
+      if (target.dataset.skipLinkTempTabindex) {
+        target.removeAttribute("tabindex");
+        delete target.dataset.skipLinkTempTabindex;
+      }
+    },
+    { once: true }
+  );
+  target.focus();
+}
+/**
+ * Initializes skip link functionality for accessibility.
+ * Enhances focus management when skip links are activated.
+ * @returns {void}
+ */
+export function initSkipLinks() {
+  const skipLinks = document.querySelectorAll(".skip-link[href^='#']");
+  if (!skipLinks.length) {
+    return;
+  }
+  skipLinks.forEach((link) => {
+    link.addEventListener("click", (event) => {
+      const href = link.getAttribute("href") || "";
+      const targetId = href.slice(1);
+      if (!targetId) {
+        return;
+      }
+      const target = document.getElementById(targetId);
+      if (!target) {
+        return;
+      }
+      event.preventDefault();
+      focusTarget(target);
+    });
+  });
+}