@knowcode/doc-builder 1.3.8 → 1.3.10

package/CHANGELOG.md

@@ -5,6 +5,48 @@ 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
+- Fixed tooltip JavaScript positioning implementation
+- Removed invalid getComputedStyle call on pseudo-elements
+- Added mouseleave handler to clean up CSS variables
+- Fixed tooltip arrow positioning with proper transform
+- Added event listener cleanup to prevent duplicates
+- Added console logging for tooltip debugging
+
+### Improved
+- Tooltips now properly use fixed positioning as per lessons learned
+- Added MutationObserver to handle dynamically updated navigation
+- Better event handling with proper cleanup on element replacement
+- More robust tooltip initialization that works with dynamic content
+
+### Technical Details
+- JavaScript now correctly sets `--tooltip-left` and `--tooltip-top` CSS variables
+- Fixed positioning allows tooltips to escape overflow containers
+- Event listeners are properly cleaned up to prevent memory leaks
+- Console logging helps debug tooltip initialization issues
+
 ## [1.3.8] - 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);
 }
@@ -1848,9 +1848,9 @@ section + section {
 [data-tooltip]::before {
   content: '';
   position: fixed;
-  left: calc(var(--tooltip-left, 0) - 8px);
+  left: var(--tooltip-left, 0);
   top: var(--tooltip-top, 0);
-  transform: translateY(-50%);
+  transform: translateX(-8px) translateY(-50%);
   width: 0;
   height: 0;
   border-style: solid;

package/assets/js/main.js

@@ -1332,18 +1332,33 @@ function generateBreadcrumbs() {
 
 // Initialize tooltip positioning for navigation items
 function initTooltips() {
-  const tooltipElements = document.querySelectorAll('[data-tooltip]');
+  // Use event delegation for better performance and dynamic content support
+  const navigation = document.querySelector('.navigation');
+  if (!navigation) return;
   
-  tooltipElements.forEach(element => {
-    element.addEventListener('mouseenter', function(e) {
-      const rect = element.getBoundingClientRect();
-      const tooltip = window.getComputedStyle(element, '::after');
-      
-      // Position the tooltip using CSS variables
-      element.style.setProperty('--tooltip-left', `${rect.right + 10}px`);
-      element.style.setProperty('--tooltip-top', `${rect.top + rect.height / 2}px`);
-    });
-  });
+  navigation.addEventListener('mouseenter', function(e) {
+    const tooltipElement = e.target.closest('[data-tooltip]');
+    if (!tooltipElement) return;
+    
+    const rect = tooltipElement.getBoundingClientRect();
+    const tooltipText = tooltipElement.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;
+    
+    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

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.8",
+  "version": "1.3.10",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {