@knowcode/doc-builder 1.3.9 → 1.3.10

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.10] - 2025-07-19
+
+### Fixed
+- Reduced excessive top spacing in content area (changed from 40px to 16px)
+- Fixed tooltip implementation with event delegation for better performance
+- Added native `title` attribute as fallback for tooltips
+- Applied spacing fixes to both default and notion themes
+
+### Improved
+- Content now starts closer to the header/breadcrumb area
+- Tooltips use simpler event delegation instead of individual listeners
+- Better tooltip support with both custom CSS tooltips and native browser tooltips
+- Removed unnecessary MutationObserver for cleaner code
+
+### Technical Details
+- Content padding reduced from 40px to var(--space-lg) (16px) 
+- Event delegation on navigation container captures all tooltip events
+- Native title attributes ensure tooltips work even if CSS/JS fails
+- More efficient event handling with capture phase listeners
+
 ## [1.3.9] - 2025-07-19
 
 ### Fixed

package/assets/css/notion-style.css

@@ -705,7 +705,7 @@ pre code {
 .content {
   flex: 1;
   margin-left: var(--sidebar-width);
-  padding: 40px var(--space-8);
+  padding: var(--space-4) var(--space-8);
   overflow-y: auto;
   background: var(--color-bg-default);
   transition: margin-left var(--duration-normal);

package/assets/css/style.css

@@ -1087,7 +1087,7 @@ em, i {
 .content {
   flex: 1;
   margin-left: var(--sidebar-width);
-  padding: 40px var(--space-2xl) var(--space-xl);
+  padding: var(--space-lg) var(--space-2xl) var(--space-xl);
   max-width: calc(var(--content-max-width) + var(--space-2xl) * 2);
   transition: margin-left var(--transition-base);
 }

package/assets/js/main.js

@@ -1332,35 +1332,33 @@ function generateBreadcrumbs() {
 
 // Initialize tooltip positioning for navigation items
 function initTooltips() {
-  const tooltipElements = document.querySelectorAll('[data-tooltip]');
-  console.log(`Initializing tooltips for ${tooltipElements.length} elements`);
+  // Use event delegation for better performance and dynamic content support
+  const navigation = document.querySelector('.navigation');
+  if (!navigation) return;
   
-  tooltipElements.forEach(element => {
-    // Remove any existing listeners to prevent duplicates
-    const newElement = element.cloneNode(true);
-    element.parentNode.replaceChild(newElement, element);
+  navigation.addEventListener('mouseenter', function(e) {
+    const tooltipElement = e.target.closest('[data-tooltip]');
+    if (!tooltipElement) return;
     
-    newElement.addEventListener('mouseenter', function(e) {
-      const rect = newElement.getBoundingClientRect();
-      const tooltipText = newElement.getAttribute('data-tooltip');
-      
-      // Position the tooltip using CSS variables
-      // Tooltip appears to the right of the element with 10px gap
-      const leftPos = rect.right + 10;
-      const topPos = rect.top + rect.height / 2;
-      
-      console.log(`Tooltip positioned at: ${leftPos}, ${topPos} for "${tooltipText}"`);
-      
-      newElement.style.setProperty('--tooltip-left', `${leftPos}px`);
-      newElement.style.setProperty('--tooltip-top', `${topPos}px`);
-    });
+    const rect = tooltipElement.getBoundingClientRect();
+    const tooltipText = tooltipElement.getAttribute('data-tooltip');
     
-    // Clean up on mouse leave
-    newElement.addEventListener('mouseleave', function(e) {
-      newElement.style.removeProperty('--tooltip-left');
-      newElement.style.removeProperty('--tooltip-top');
-    });
-  });
+    // Position the tooltip using CSS variables
+    // Tooltip appears to the right of the element with 10px gap
+    const leftPos = rect.right + 10;
+    const topPos = rect.top + rect.height / 2;
+    
+    tooltipElement.style.setProperty('--tooltip-left', `${leftPos}px`);
+    tooltipElement.style.setProperty('--tooltip-top', `${topPos}px`);
+  }, true); // Use capture phase
+  
+  navigation.addEventListener('mouseleave', function(e) {
+    const tooltipElement = e.target.closest('[data-tooltip]');
+    if (!tooltipElement) return;
+    
+    tooltipElement.style.removeProperty('--tooltip-left');
+    tooltipElement.style.removeProperty('--tooltip-top');
+  }, true); // Use capture phase
 }
 
 // Initialize on DOM Load
@@ -1373,17 +1371,4 @@ document.addEventListener('DOMContentLoaded', () => {
   addPDFExportButton();
   generateBreadcrumbs();
   initTooltips();
-  
-  // Re-initialize tooltips if navigation is dynamically updated
-  const navigation = document.querySelector('.navigation');
-  if (navigation) {
-    const observer = new MutationObserver(() => {
-      initTooltips();
-    });
-    
-    observer.observe(navigation, {
-      childList: true,
-      subtree: true
-    });
-  }
 });

package/lib/core-builder.js

@@ -286,7 +286,7 @@ function buildNavigationStructure(files, currentFile) {
     
     // Get folder description for tooltip
     const folderDescription = folderDescriptions[folderName] || '';
-    const tooltipAttr = folderDescription ? `data-tooltip="${escapeHtml(folderDescription)}"` : '';
+    const tooltipAttr = folderDescription ? `data-tooltip="${escapeHtml(folderDescription)}" title="${escapeHtml(folderDescription)}"` : '';
     
     // Start all sections collapsed by default (JavaScript will expand sections containing active items)
     const hasActiveChild = checkActiveChild(folderData, currentFile);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {