jekyll-theme-zer0 1.3.0 → 1.4.0

data/assets/js/obsidian-local-graph.js

@@ -1,13 +1,13 @@
 /*
  * obsidian-local-graph.js
  *
- * Renders a small "local graph" (current page + immediate neighbors) into
+ * Renders a focused "local graph" (current page + immediate neighbors) into
  * the element with id `obsidian-local-graph`. Mirrors Obsidian's local
  * graph view: a focused, page-scoped subgraph instead of the full site map.
  *
- * Loaded by _includes/navigation/local-graph.html on every page that has
- * a left sidebar. Cytoscape.js is loaded lazily (and only once) from the
- * same CDN as the full graph page.
+ * Loaded by _includes/navigation/local-graph.html inside a dedicated
+ * collapsible side panel. Cytoscape.js is loaded lazily (and only once) from
+ * the same CDN as the full graph page.
  *
  * Subgraph:
  *   - center  = current page (matched against entry.url, falling back to
@@ -15,17 +15,52 @@
  *   - depth   = configurable via data-depth attribute (default 1)
  *   - direction = both incoming and outgoing wiki-links
  *
- * If the current page is not in the wiki-index (e.g. dynamically-built
- * routes, the homepage with no edges, or excluded pages), the container
- * is hidden and the script is a no-op.
+ * If the current page is in the wiki-index but has no local links, the panel
+ * stays available and renders a single-node graph for the current page.
+ * Pages outside the wiki-index still hide the panel.
  */
 (function () {
   'use strict';
 
   var CONTAINER_ID = 'obsidian-local-graph';
+  var PANEL_SELECTOR = '[data-obsidian-local-graph-panel]';
+  var TOGGLE_SELECTOR = '[data-obsidian-local-graph-toggle]';
+  var STATUS_SELECTOR = '[data-obsidian-local-graph-status]';
   var CYTOSCAPE_URL = 'https://cdn.jsdelivr.net/npm/cytoscape@3.30.0/dist/cytoscape.min.js';
   var CYTOSCAPE_SRI = 'sha384-kpMsYllYzyaWU69Piok08rPNktpnjqAoDMdB00fjqUkEk3lkuUbSuwJ+oXrjvN6B';
 
+  function companionElements(container) {
+    return {
+      panel: container.closest(PANEL_SELECTOR),
+      toggle: document.querySelector(TOGGLE_SELECTOR),
+      status: document.querySelector(STATUS_SELECTOR)
+    };
+  }
+
+  function setStatus(container, message, isError) {
+    var status = companionElements(container).status;
+    if (!status) return;
+    status.textContent = message || '';
+    status.hidden = !message;
+    status.classList.toggle('text-danger', !!isError);
+    status.classList.toggle('text-secondary', !isError);
+  }
+
+  function setPanelAvailable(container, available) {
+    var companions = companionElements(container);
+    [companions.panel, companions.toggle].forEach(function (element) {
+      if (!element) return;
+      element.hidden = !available;
+    });
+  }
+
+  function resizeGraph(container) {
+    var cy = container.__obsidianLocalGraph;
+    if (!cy) return;
+    cy.resize();
+    cy.fit(cy.elements(), 24);
+  }
+
   function normalize(value) {
     return String(value || '').toLowerCase().trim().replace(/\s+/g, ' ');
   }
@@ -252,7 +287,7 @@
           style: {
             'background-color': 'data(color)',
             'label': 'data(label)',
-            'font-size': '10px',
+            'font-size': '11px',
             'font-weight': 500,
             'color': theme.label,
             'text-outline-color': theme.labelOutline,
@@ -262,8 +297,8 @@
             'text-valign': 'bottom',
             'text-margin-y': 4,
             'text-wrap': 'ellipsis',
-            'text-max-width': '110px',
-            'width': 14, 'height': 14,
+            'text-max-width': '140px',
+            'width': 16, 'height': 16,
             'border-width': 1.5,
             'border-color': theme.nodeBorder,
             'transition-property': 'background-color, border-color, width, height',
@@ -319,6 +354,8 @@
       }
     });
 
+    container.__obsidianLocalGraph = cy;
+
     cy.on('tap', 'node', function (evt) {
       var d = evt.target.data();
       if (!d.url || d.broken) return;
@@ -336,12 +373,30 @@
       evt.target.style('z-index', 99);
     });
 
+    requestAnimationFrame(function () {
+      resizeGraph(container);
+    });
+
     return cy;
   }
 
   function init() {
     var container = document.getElementById(CONTAINER_ID);
     if (!container) return;
+    setPanelAvailable(container, true);
+    setStatus(container, 'Loading graph...', false);
+
+    var panel = container.closest(PANEL_SELECTOR);
+    if (panel) {
+      panel.addEventListener('shown.bs.offcanvas', function () {
+        resizeGraph(container);
+      });
+    }
+
+    window.addEventListener('resize', function () {
+      resizeGraph(container);
+    });
+
     var depth = parseInt(container.getAttribute('data-depth') || '1', 10);
     if (!isFinite(depth) || depth < 1) depth = 1;
     var indexUrl = container.getAttribute('data-index-url') ||
@@ -352,25 +407,22 @@
       .then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); })
       .then(function (data) {
         var entries = Array.isArray(data && data.entries) ? data.entries : [];
-        if (!entries.length) { container.style.display = 'none'; return; }
+        if (!entries.length) { setPanelAvailable(container, false); return; }
         var lookup = buildLookup(entries);
         var current = findCurrentEntry(lookup);
-        if (!current) { container.style.display = 'none'; return; }
+        if (!current) { setPanelAvailable(container, false); return; }
         var elements = buildSubgraph(entries, lookup, current, depth);
-        // If the current page has no neighbors, show a tiny "no links yet"
-        // hint instead of a single dot.
-        if (elements.length <= 1) {
-          container.style.display = 'none';
-          return;
-        }
         loadCytoscape(function () {
           render(container, elements, current.url);
+          var nodeCount = elements.filter(function (element) { return element.group === 'nodes'; }).length;
+          var edgeCount = elements.filter(function (element) { return element.group === 'edges'; }).length;
+          setStatus(container, nodeCount + ' pages · ' + edgeCount + ' links', false);
         });
       })
       .catch(function (err) {
-        // Sidebar widget failing is non-fatal — hide and stay quiet.
+        // Sidebar panel failing is non-fatal — hide and stay quiet.
         console.warn('[obsidian-local-graph] init failed:', err);
-        container.style.display = 'none';
+        setPanelAvailable(container, false);
       });
   }
 

data/assets/js/obsidian-wiki-links.js

@@ -26,11 +26,28 @@
     return;
   }
 
+  var RESOLVER_SCRIPT_PATH = 'assets/js/obsidian-wiki-links.js';
+  var OBSIDIAN_CONFIG = window.OBSIDIAN_CONFIG || {};
+
+  function trimTrailingSlash(value) {
+    return (value === null || value === undefined ? '' : String(value)).replace(/\/$/, '');
+  }
+
+  function assetPath(path) {
+    var script = document.currentScript || document.querySelector('script[src*="obsidian-wiki-links.js"]');
+    var src = script && script.getAttribute('src');
+    var escapedScriptPath = RESOLVER_SCRIPT_PATH.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    var match = src && src.match(new RegExp('^(.*?)' + escapedScriptPath + '(?:[?#].*)?$'));
+    if (match) return trimTrailingSlash(match[1]) + path;
+
+    var baseHref = (document.querySelector('base') || {}).href;
+    return trimTrailingSlash(baseHref) + path;
+  }
+
   var CONFIG = {
-    indexUrl: (window.OBSIDIAN_WIKI_INDEX_URL ||
-      ((document.querySelector('base') || {}).href || '/') + 'assets/data/wiki-index.json'),
-    attachmentsPath: window.OBSIDIAN_ATTACHMENTS_PATH || '/assets/images/notes',
-    tagBase: window.OBSIDIAN_TAG_BASE || '/tags/',
+    indexUrl: OBSIDIAN_CONFIG.wikiIndexUrl || window.OBSIDIAN_WIKI_INDEX_URL || assetPath('/assets/data/wiki-index.json'),
+    attachmentsPath: OBSIDIAN_CONFIG.attachmentsPath || window.OBSIDIAN_ATTACHMENTS_PATH || assetPath('/assets/images/notes'),
+    tagBase: OBSIDIAN_CONFIG.tagBase || window.OBSIDIAN_TAG_BASE || assetPath('/tags/'),
     wikiLinkClass: 'wiki-link',
     brokenLinkClass: 'wiki-link wiki-link-broken'
   };

data/scripts/README.md

@@ -8,6 +8,7 @@ This directory contains automation scripts for managing the `jekyll-theme-zer0`
 scripts/
 ├── bin/                    # Entry point commands (use these!)
 │   ├── build              # Build gem without releasing
+│   ├── validate           # Preflight checks for local/CI validation
 │   ├── release            # Full release workflow
 │   └── test               # Run all test suites
 ├── lib/                   # Shared libraries (sourced, not executed)
@@ -39,6 +40,10 @@ scripts/
 # Build gem
 ./scripts/bin/build
 
+# Preflight validation
+./scripts/bin/validate --quick
+./scripts/bin/validate --start-docker
+
 # Full release workflow
 ./scripts/bin/release patch   # or minor/major
 
@@ -57,6 +62,23 @@ Build the gem without the full release workflow.
 ./scripts/bin/build [--dry-run] [--verbose]
 ```
 
+#### `bin/validate`
+Run preflight validation before refactors, pull requests, and releases. The
+quick path validates repository files, version consistency, YAML parsing, active
+configuration contracts, config-file classification, and navigation data before
+the Docker/local build stages run.
+
+```bash
+./scripts/bin/validate [options]
+
+Options:
+  --quick             Host-only checks for CI fast feedback
+  --full              Include tests, Obsidian tests, and HTMLProofer
+  --start-docker      Start the jekyll Docker Compose service if needed
+  --docker            Require Docker Compose for Jekyll commands
+  --local             Require local bundle exec for Jekyll commands
+```
+
 #### `bin/release`
 Full release workflow with changelog, version bump, and publishing.
 

data/scripts/bin/test

@@ -12,6 +12,8 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 SCRIPTS_ROOT="$SCRIPT_DIR/.."
 LIB_DIR="$SCRIPTS_ROOT/lib"
 TEST_DIR="$SCRIPTS_ROOT/test"
+REPO_ROOT="$(cd "$SCRIPTS_ROOT/.." && pwd)"
+THEME_TEST_RUNNER="$REPO_ROOT/test/test_runner.sh"
 
 # Source common library for logging
 source "$LIB_DIR/common.sh"
@@ -37,6 +39,10 @@ TEST_SUITES:
     integration Run integration tests only
     install     Run installer e2e suites only (test/test_install_*.sh)
 
+THEME SUITES:
+    core, deployment, quality, installation, site_generation, styling,
+    visual, full, or --suites <list> are forwarded to test/test_runner.sh.
+
 OPTIONS:
     --verbose, -v    Show detailed test output
     --dry-run        Preview what tests would run
@@ -54,6 +60,62 @@ TEST LOCATIONS:
 EOF
 }
 
+# Pass the repository-level theme runner's interface through this canonical
+# command so CI, docs, and local users can converge on scripts/bin/test without
+# breaking existing --suites calls.
+maybe_delegate_to_theme_runner() {
+    [[ -f "$THEME_TEST_RUNNER" ]] || return 0
+
+    local should_delegate=false
+    local positional_suites=""
+    local delegated_args=()
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --suites|-s)
+                should_delegate=true
+                delegated_args+=("$1")
+                shift
+                [[ $# -gt 0 ]] || error "--suites requires a value"
+                delegated_args+=("$1")
+                ;;
+            core|deployment|quality|installation|site_generation|styling|visual|full)
+                should_delegate=true
+                if [[ -n "$positional_suites" ]]; then
+                    positional_suites="${positional_suites},$1"
+                else
+                    positional_suites="$1"
+                fi
+                ;;
+            --skip-docker|--skip-remote|--coverage|-c|--parallel|-p|--retry-failed|-r|--fail-fast|--baseline-compare)
+                should_delegate=true
+                delegated_args+=("$1")
+                ;;
+            --format|-f|--timeout|-t|--environment|-e)
+                should_delegate=true
+                local option_name="$1"
+                delegated_args+=("$1")
+                shift
+                [[ $# -gt 0 ]] || error "$option_name requires a value"
+                delegated_args+=("$1")
+                ;;
+            --verbose|-v)
+                delegated_args+=("$1")
+                ;;
+        esac
+        shift
+    done
+
+    if [[ "$should_delegate" == "true" ]]; then
+        if [[ -n "$positional_suites" ]]; then
+            delegated_args+=("--suites" "$positional_suites")
+        fi
+        exec "$THEME_TEST_RUNNER" "${delegated_args[@]}"
+    fi
+}
+
+maybe_delegate_to_theme_runner "$@"
+
 # Parse arguments
 TEST_SUITE="all"
 for arg in "$@"; do