@knowcode/doc-builder 1.3.8 → 1.3.9

package/CHANGELOG.md

@@ -5,6 +5,28 @@ 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.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/style.css

@@ -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

@@ -1333,15 +1333,32 @@ function generateBreadcrumbs() {
 // Initialize tooltip positioning for navigation items
 function initTooltips() {
   const tooltipElements = document.querySelectorAll('[data-tooltip]');
+  console.log(`Initializing tooltips for ${tooltipElements.length} elements`);
   
   tooltipElements.forEach(element => {
-    element.addEventListener('mouseenter', function(e) {
-      const rect = element.getBoundingClientRect();
-      const tooltip = window.getComputedStyle(element, '::after');
+    // Remove any existing listeners to prevent duplicates
+    const newElement = element.cloneNode(true);
+    element.parentNode.replaceChild(newElement, element);
+    
+    newElement.addEventListener('mouseenter', function(e) {
+      const rect = newElement.getBoundingClientRect();
+      const tooltipText = newElement.getAttribute('data-tooltip');
       
       // 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`);
+      // 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`);
+    });
+    
+    // Clean up on mouse leave
+    newElement.addEventListener('mouseleave', function(e) {
+      newElement.style.removeProperty('--tooltip-left');
+      newElement.style.removeProperty('--tooltip-top');
     });
   });
 }
@@ -1356,4 +1373,17 @@ 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/package.json

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