docyard 1.1.0 → 1.3.0

data/lib/docyard/templates/assets/css/variables.css

@@ -35,12 +35,6 @@
   --sidebar-border: oklch(0.92 0.004 286.32);
   --sidebar-ring: oklch(0.705 0.015 286.067);
 
-  --chart-1: oklch(0.87 0.12 207);
-  --chart-2: oklch(0.80 0.13 212);
-  --chart-3: oklch(0.71 0.13 215);
-  --chart-4: oklch(0.61 0.11 222);
-  --chart-5: oklch(0.52 0.09 223);
-
   --code-background: oklch(0.967 0.001 286.375);
   --code-foreground: oklch(0.141 0.005 285.823);
 

data/lib/docyard/templates/assets/js/components/abbreviation.js

@@ -1,21 +1,27 @@
-function initializeAbbreviations() {
-  const abbreviations = document.querySelectorAll('.docyard-abbr');
-  if (abbreviations.length === 0) return;
+var abbrPopover = null;
+var abbrHideTimeout = null;
 
-  const popover = createPopover();
-  document.body.appendChild(popover);
+function initializeAbbreviations(root = document) {
+  const abbreviations = root.querySelectorAll('.docyard-abbr');
+  if (abbreviations.length === 0) return;
 
-  let hideTimeout;
+  if (!abbrPopover) {
+    abbrPopover = createPopover();
+    document.body.appendChild(abbrPopover);
+  }
 
   abbreviations.forEach(abbr => {
+    if (abbr.hasAttribute('data-abbr-initialized')) return;
+    abbr.setAttribute('data-abbr-initialized', 'true');
+
     abbr.addEventListener('mouseenter', () => {
-      clearTimeout(hideTimeout);
-      showPopover(popover, abbr);
+      clearTimeout(abbrHideTimeout);
+      showPopover(abbrPopover, abbr);
     });
 
     abbr.addEventListener('mouseleave', () => {
-      hideTimeout = setTimeout(() => {
-        hidePopover(popover);
+      abbrHideTimeout = setTimeout(() => {
+        hidePopover(abbrPopover);
       }, 100);
     });
   });
@@ -79,7 +85,10 @@ function hidePopover(popover) {
 }
 
 if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initializeAbbreviations);
+  document.addEventListener('DOMContentLoaded', function() { initializeAbbreviations(); });
 } else {
   initializeAbbreviations();
 }
+
+window.docyard = window.docyard || {};
+window.docyard.initAbbreviations = initializeAbbreviations;

data/lib/docyard/templates/assets/js/components/code-block.js

@@ -125,20 +125,25 @@ class CodeBlockManager {
   }
 }
 
-function initializeCodeBlocks() {
-  const codeBlocks = document.querySelectorAll('.docyard-code-block');
+function initializeCodeBlocks(root = document) {
+  const codeBlocks = root.querySelectorAll('.docyard-code-block');
 
   codeBlocks.forEach(container => {
+    if (container.hasAttribute('data-code-block-initialized')) return;
+    container.setAttribute('data-code-block-initialized', 'true');
     new CodeBlockManager(container);
   });
 }
 
 if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initializeCodeBlocks);
+  document.addEventListener('DOMContentLoaded', function() { initializeCodeBlocks(); });
 } else {
   initializeCodeBlocks();
 }
 
+window.docyard = window.docyard || {};
+window.docyard.initCodeBlocks = initializeCodeBlocks;
+
 if (typeof module !== 'undefined' && module.exports) {
   module.exports = { CodeBlockManager };
 }

data/lib/docyard/templates/assets/js/components/code-group.js

@@ -9,6 +9,8 @@ class CodeGroupManager {
     if (containers.length === 0) return;
 
     containers.forEach(container => {
+      if (container.hasAttribute('data-code-group-initialized')) return;
+      container.setAttribute('data-code-group-initialized', 'true');
       this.groups.push(new CodeGroup(container, this));
     });
 
@@ -275,12 +277,27 @@ class CodeGroup {
   }
 }
 
-function initializeCodeGroups() {
-  new CodeGroupManager();
+function initializeCodeGroups(root = document) {
+  const containers = root.querySelectorAll('.docyard-code-group');
+  if (containers.length === 0) return;
+
+  if (!window.docyardCodeGroupManager) {
+    window.docyardCodeGroupManager = new CodeGroupManager();
+  } else {
+    containers.forEach(container => {
+      if (container.hasAttribute('data-code-group-initialized')) return;
+      container.setAttribute('data-code-group-initialized', 'true');
+      window.docyardCodeGroupManager.groups.push(new CodeGroup(container, window.docyardCodeGroupManager));
+    });
+    window.docyardCodeGroupManager.loadPreference();
+  }
 }
 
 if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initializeCodeGroups);
+  document.addEventListener('DOMContentLoaded', function() { initializeCodeGroups(); });
 } else {
   initializeCodeGroups();
 }
+
+window.docyard = window.docyard || {};
+window.docyard.initCodeGroups = initializeCodeGroups;

data/lib/docyard/templates/assets/js/components/file-tree.js

@@ -1,7 +1,10 @@
-function initializeFileTrees() {
-  const fileTrees = document.querySelectorAll('.docyard-filetree');
+function initializeFileTrees(root = document) {
+  const fileTrees = root.querySelectorAll('.docyard-filetree');
 
   fileTrees.forEach(tree => {
+    if (tree.hasAttribute('data-filetree-initialized')) return;
+    tree.setAttribute('data-filetree-initialized', 'true');
+
     const folders = tree.querySelectorAll('.docyard-filetree__item--folder');
 
     folders.forEach(folder => {
@@ -33,7 +36,10 @@ function initializeFileTrees() {
 }
 
 if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initializeFileTrees);
+  document.addEventListener('DOMContentLoaded', function() { initializeFileTrees(); });
 } else {
   initializeFileTrees();
 }
+
+window.docyard = window.docyard || {};
+window.docyard.initFileTrees = initializeFileTrees;

data/lib/docyard/templates/assets/js/components/heading-anchor.js

@@ -1,92 +1,91 @@
-class HeadingAnchorManager {
-  constructor() {
-    this.anchors = document.querySelectorAll('.heading-anchor');
-    this.init();
-  }
-
-  init() {
-    this.anchors.forEach(anchor => {
-      anchor.addEventListener('click', (e) => this.handleClick(e, anchor));
-    });
-  }
+function initializeHeadingAnchors(root = document) {
+  const anchors = root.querySelectorAll('.heading-anchor');
+  if (anchors.length === 0) return;
+
+  anchors.forEach(anchor => {
+    if (anchor.hasAttribute('data-anchor-initialized')) return;
+    anchor.setAttribute('data-anchor-initialized', 'true');
+    anchor.addEventListener('click', (e) => handleHeadingAnchorClick(e, anchor));
+  });
+}
 
-  
-  handleClick(e, anchor) {
-    e.preventDefault();
+function handleHeadingAnchorClick(e, anchor) {
+  e.preventDefault();
 
-    const headingId = anchor.dataset.headingId;
-    const url = `${window.location.origin}${window.location.pathname}#${headingId}`;
+  const headingId = anchor.dataset.headingId;
+  const url = `${window.location.origin}${window.location.pathname}#${headingId}`;
 
-    this.copyToClipboard(url, anchor);
+  copyAnchorToClipboard(url, anchor);
 
-    history.pushState(null, null, `#${headingId}`);
+  history.pushState(null, null, `#${headingId}`);
 
-    const heading = document.getElementById(headingId);
-    if (heading) {
-      const offsetTop = heading.getBoundingClientRect().top + window.pageYOffset - this.getScrollOffset();
-      window.scrollTo({
-        top: offsetTop,
-        behavior: 'smooth'
-      });
-    }
+  const heading = document.getElementById(headingId);
+  if (heading) {
+    const offsetTop = heading.getBoundingClientRect().top + window.pageYOffset - getAnchorScrollOffset();
+    window.scrollTo({
+      top: offsetTop,
+      behavior: 'smooth'
+    });
   }
+}
 
-  getScrollOffset() {
-    const hasTabs = document.body.classList.contains('has-tabs');
-    const headerHeight = 64;
-    const tabBarHeight = hasTabs ? 48 : 0;
-    const buffer = 24;
-
-    if (window.innerWidth > 1024 && window.innerWidth <= 1280) {
-      return headerHeight + 48 + buffer;
-    }
-
-    if (window.innerWidth <= 1024) {
-      return headerHeight + 48 + buffer;
-    }
+function getAnchorScrollOffset() {
+  const hasTabs = document.body.classList.contains('has-tabs');
+  const headerHeight = 64;
+  const tabBarHeight = hasTabs ? 48 : 0;
+  const buffer = 24;
 
-    return headerHeight + tabBarHeight + buffer;
+  if (window.innerWidth > 1024 && window.innerWidth <= 1280) {
+    return headerHeight + 48 + buffer;
   }
 
-  
-  async copyToClipboard(text, anchor) {
-    try {
-      await navigator.clipboard.writeText(text);
-      this.showFeedback(anchor, true);
-    } catch (err) {
-      this.fallbackCopyToClipboard(text);
-      this.showFeedback(anchor, true);
-    }
+  if (window.innerWidth <= 1024) {
+    return headerHeight + 48 + buffer;
   }
 
-  
-  fallbackCopyToClipboard(text) {
-    const textarea = document.createElement('textarea');
-    textarea.value = text;
-    textarea.style.position = 'fixed';
-    textarea.style.opacity = '0';
-    document.body.appendChild(textarea);
-    textarea.select();
-    document.execCommand('copy');
-    document.body.removeChild(textarea);
+  return headerHeight + tabBarHeight + buffer;
+}
+
+async function copyAnchorToClipboard(text, anchor) {
+  try {
+    await navigator.clipboard.writeText(text);
+    showAnchorFeedback(anchor, true);
+  } catch (err) {
+    fallbackAnchorCopy(text);
+    showAnchorFeedback(anchor, true);
   }
+}
 
-  
-  showFeedback(anchor, success) {
-    const originalTitle = anchor.getAttribute('aria-label');
-    anchor.setAttribute('aria-label', success ? 'Link copied!' : 'Failed to copy');
+function fallbackAnchorCopy(text) {
+  const textarea = document.createElement('textarea');
+  textarea.value = text;
+  textarea.style.position = 'fixed';
+  textarea.style.opacity = '0';
+  document.body.appendChild(textarea);
+  textarea.select();
+  document.execCommand('copy');
+  document.body.removeChild(textarea);
+}
 
-    anchor.style.color = success ? 'var(--color-success, #10b981)' : 'var(--color-danger, #ef4444)';
+function showAnchorFeedback(anchor, success) {
+  const originalTitle = anchor.getAttribute('aria-label');
+  anchor.setAttribute('aria-label', success ? 'Link copied!' : 'Failed to copy');
 
-    setTimeout(() => {
-      anchor.setAttribute('aria-label', originalTitle);
-      anchor.style.color = '';
-    }, 2000);
-  }
+  anchor.style.color = success ? 'var(--color-success, #10b981)' : 'var(--color-danger, #ef4444)';
+
+  setTimeout(() => {
+    anchor.setAttribute('aria-label', originalTitle);
+    anchor.style.color = '';
+  }, 2000);
 }
 
 if (typeof window !== 'undefined') {
-  document.addEventListener('DOMContentLoaded', () => {
-    new HeadingAnchorManager();
-  });
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', function() { initializeHeadingAnchors(); });
+  } else {
+    initializeHeadingAnchors();
+  }
+
+  window.docyard = window.docyard || {};
+  window.docyard.initHeadingAnchors = initializeHeadingAnchors;
 }

data/lib/docyard/templates/assets/js/components/lightbox.js

@@ -49,8 +49,9 @@
     }
   }
 
-  function initLightbox() {
-    var contentImages = document.querySelectorAll('.content img');
+  function initLightbox(root) {
+    var container = root || document;
+    var contentImages = container.querySelectorAll('.content img');
 
     contentImages.forEach(function(img) {
       if (img.hasAttribute('data-no-zoom')) {
@@ -58,6 +59,9 @@
         return;
       }
 
+      if (img.hasAttribute('data-lightbox-initialized')) return;
+      img.setAttribute('data-lightbox-initialized', 'true');
+
       img.addEventListener('click', function() {
         openLightbox(this.src, this.alt);
       });
@@ -65,8 +69,11 @@
   }
 
   if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', initLightbox);
+    document.addEventListener('DOMContentLoaded', function() { initLightbox(); });
   } else {
     initLightbox();
   }
+
+  window.docyard = window.docyard || {};
+  window.docyard.initLightbox = initLightbox;
 })();

data/lib/docyard/templates/assets/js/components/tabs.js

@@ -304,20 +304,25 @@ class TabsManager {
   }
 }
 
-function initializeTabs() {
-  const tabsContainers = document.querySelectorAll('.docyard-tabs');
+function initializeTabs(root = document) {
+  const tabsContainers = root.querySelectorAll('.docyard-tabs');
 
   tabsContainers.forEach(container => {
+    if (container.hasAttribute('data-tabs-initialized')) return;
+    container.setAttribute('data-tabs-initialized', 'true');
     new TabsManager(container);
   });
 }
 
 if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initializeTabs);
+  document.addEventListener('DOMContentLoaded', function() { initializeTabs(); });
 } else {
   initializeTabs();
 }
 
+window.docyard = window.docyard || {};
+window.docyard.initTabs = initializeTabs;
+
 if (typeof module !== 'undefined' && module.exports) {
   module.exports = { TabsManager };
 }

data/lib/docyard/templates/assets/js/components/tooltip.js

@@ -1,35 +1,41 @@
-function initializeTooltips() {
-  const tooltips = document.querySelectorAll('.docyard-tooltip');
-  if (tooltips.length === 0) return;
+var tooltipPopover = null;
+var tooltipHideTimeout = null;
+var tooltipIsHoveringPopover = false;
 
-  const popover = createTooltipPopover();
-  document.body.appendChild(popover);
+function initializeTooltips(root = document) {
+  const tooltips = root.querySelectorAll('.docyard-tooltip');
+  if (tooltips.length === 0) return;
 
-  let hideTimeout;
-  let isHoveringPopover = false;
+  if (!tooltipPopover) {
+    tooltipPopover = createTooltipPopover();
+    document.body.appendChild(tooltipPopover);
 
-  popover.addEventListener('mouseenter', () => {
-    isHoveringPopover = true;
-    clearTimeout(hideTimeout);
-  }, { passive: true });
+    tooltipPopover.addEventListener('mouseenter', () => {
+      tooltipIsHoveringPopover = true;
+      clearTimeout(tooltipHideTimeout);
+    }, { passive: true });
 
-  popover.addEventListener('mouseleave', () => {
-    isHoveringPopover = false;
-    hideTimeout = setTimeout(() => {
-      hideTooltipPopover(popover);
-    }, 100);
-  }, { passive: true });
+    tooltipPopover.addEventListener('mouseleave', () => {
+      tooltipIsHoveringPopover = false;
+      tooltipHideTimeout = setTimeout(() => {
+        hideTooltipPopover(tooltipPopover);
+      }, 100);
+    }, { passive: true });
+  }
 
   tooltips.forEach(tooltip => {
+    if (tooltip.hasAttribute('data-tooltip-initialized')) return;
+    tooltip.setAttribute('data-tooltip-initialized', 'true');
+
     tooltip.addEventListener('mouseenter', () => {
-      clearTimeout(hideTimeout);
-      showTooltipPopover(popover, tooltip);
+      clearTimeout(tooltipHideTimeout);
+      showTooltipPopover(tooltipPopover, tooltip);
     }, { passive: true });
 
     tooltip.addEventListener('mouseleave', () => {
-      hideTimeout = setTimeout(() => {
-        if (!isHoveringPopover) {
-          hideTooltipPopover(popover);
+      tooltipHideTimeout = setTimeout(() => {
+        if (!tooltipIsHoveringPopover) {
+          hideTooltipPopover(tooltipPopover);
         }
       }, 100);
     }, { passive: true });
@@ -112,7 +118,10 @@ function hideTooltipPopover(popover) {
 }
 
 if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initializeTooltips);
+  document.addEventListener('DOMContentLoaded', function() { initializeTooltips(); });
 } else {
   initializeTooltips();
 }
+
+window.docyard = window.docyard || {};
+window.docyard.initTooltips = initializeTooltips;

data/lib/docyard/templates/assets/js/hot-reload.js

@@ -10,6 +10,9 @@
     if (data.type === 'content') {
       console.log('[Docyard] Content updated');
       reloadContent();
+    } else if (data.type === 'css') {
+      console.log('[Docyard] CSS updated');
+      reloadStyles();
     } else {
       console.log('[Docyard] Full reload');
       location.reload();
@@ -20,6 +23,44 @@
     eventSource.close();
   };
 
+  function reloadStyles() {
+    var links = document.querySelectorAll('link[rel="stylesheet"]');
+    var cacheBuster = Date.now();
+
+    links.forEach(function (link) {
+      var href = link.getAttribute('href');
+      if (!href) return;
+
+      var baseHref = href.split('?')[0];
+      var newHref = baseHref + '?_dc=' + cacheBuster;
+
+      var newLink = document.createElement('link');
+      newLink.rel = 'stylesheet';
+      newLink.href = newHref;
+
+      newLink.onload = function () {
+        link.remove();
+      };
+
+      link.parentNode.insertBefore(newLink, link.nextSibling);
+    });
+  }
+
+  function reinitializeComponents(container) {
+    if (window.Prism) window.Prism.highlightAll();
+    if (window.docyardTOC) window.docyardTOC.init();
+
+    var docyard = window.docyard || {};
+    if (docyard.initTabs) docyard.initTabs(container);
+    if (docyard.initFileTrees) docyard.initFileTrees(container);
+    if (docyard.initCodeGroups) docyard.initCodeGroups(container);
+    if (docyard.initCodeBlocks) docyard.initCodeBlocks(container);
+    if (docyard.initHeadingAnchors) docyard.initHeadingAnchors(container);
+    if (docyard.initAbbreviations) docyard.initAbbreviations(container);
+    if (docyard.initLightbox) docyard.initLightbox(container);
+    if (docyard.initTooltips) docyard.initTooltips(container);
+  }
+
   function reloadContent() {
     var cacheBuster = '_dc=' + Date.now();
     var separator = location.href.indexOf('?') === -1 ? '?' : '&';
@@ -33,8 +74,7 @@
 
         if (newContent && currentContent) {
           currentContent.innerHTML = newContent.innerHTML;
-          if (window.Prism) window.Prism.highlightAll();
-          if (window.docyardTOC) window.docyardTOC.init();
+          reinitializeComponents(currentContent);
           updateErrorOverlay(newDoc);
         } else {
           location.reload();

data/lib/docyard/templates/partials/_head.html.erb

@@ -94,4 +94,8 @@
 </style>
 <% end %>
 
+<% if @dev_mode && @custom_css_exists %>
+<link rel="stylesheet" href="/_docyard/css/custom.css">
+<% end %>
+
 <%= render_partial('_analytics') %>

data/lib/docyard/templates/partials/_scripts.html.erb

@@ -4,6 +4,9 @@
 
 <script src="/_docyard/js/theme.js" defer></script>
 <script src="/_docyard/js/components.js" defer></script>
+<% if @dev_mode && @custom_js_exists %>
+<script src="/_docyard/js/custom.js" defer></script>
+<% end %>
 <% if @dev_mode %>
 <script>window.__DOCYARD_SSE_PORT__ = <%= @sse_port %>;</script>
 <script src="/_docyard/js/hot-reload.js" defer></script>

data/lib/docyard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Docyard
-  VERSION = "1.1.0"
+  VERSION = "1.3.0"
 end

data/lib/docyard.rb

@@ -27,8 +27,10 @@ require_relative "docyard/navigation/prev_next_builder"
 require_relative "docyard/config/branding_resolver"
 
 require_relative "docyard/initializer"
+require_relative "docyard/customizer"
 require_relative "docyard/cli"
 
+require_relative "docyard/search/pagefind_binary"
 require_relative "docyard/search/pagefind_support"
 require_relative "docyard/search/dev_indexer"
 require_relative "docyard/search/build_indexer"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docyard
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Sanif Himani
@@ -183,6 +183,10 @@ files:
 - lib/docyard/build/llms_txt_generator.rb
 - lib/docyard/build/root_fallback_generator.rb
 - lib/docyard/build/sitemap_generator.rb
+- lib/docyard/build/social_cards/card_renderer.rb
+- lib/docyard/build/social_cards/doc_card.rb
+- lib/docyard/build/social_cards/homepage_card.rb
+- lib/docyard/build/social_cards_generator.rb
 - lib/docyard/build/static_generator.rb
 - lib/docyard/build/step_runner.rb
 - lib/docyard/build/validator.rb
@@ -240,6 +244,14 @@ files:
 - lib/docyard/config/type_validators.rb
 - lib/docyard/config/validator.rb
 - lib/docyard/constants.rb
+- lib/docyard/customizer.rb
+- lib/docyard/deploy/adapters/base.rb
+- lib/docyard/deploy/adapters/cloudflare.rb
+- lib/docyard/deploy/adapters/github_pages.rb
+- lib/docyard/deploy/adapters/netlify.rb
+- lib/docyard/deploy/adapters/vercel.rb
+- lib/docyard/deploy/deployer.rb
+- lib/docyard/deploy/platform_detector.rb
 - lib/docyard/diagnostic.rb
 - lib/docyard/diagnostic_context.rb
 - lib/docyard/doctor.rb
@@ -296,6 +308,7 @@ files:
 - lib/docyard/routing/fallback_resolver.rb
 - lib/docyard/search/build_indexer.rb
 - lib/docyard/search/dev_indexer.rb
+- lib/docyard/search/pagefind_binary.rb
 - lib/docyard/search/pagefind_support.rb
 - lib/docyard/server/asset_handler.rb
 - lib/docyard/server/dev_server.rb