@knowcode/doc-builder 1.3.7 → 1.3.9

package/CHANGELOG.md

@@ -5,6 +5,47 @@ 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
+- Added missing tooltip styles to default theme (style.css)
+- Tooltips now appear on hover for navigation folders with descriptions
+- Matched tooltip styling between default and notion themes
+
+### Added
+- Complete tooltip CSS implementation for default theme
+- Tooltip arrow for better visual connection
+- Dark mode tooltip styling
+- Mobile tooltip suppression (disabled on screens < 768px)
+
+### Technical Details
+- Tooltips use fixed positioning to escape overflow containers
+- High z-index (10000) ensures tooltips appear above all content
+- JavaScript positioning via CSS custom properties (--tooltip-left, --tooltip-top)
+- Smooth fade transitions for professional appearance
+
 ## [1.3.7] - 2025-07-19
 
 ### Fixed

package/assets/css/style.css

@@ -1816,6 +1816,103 @@ section + section {
   }
 }
 
+/* Tooltip Styles */
+[data-tooltip] {
+  position: relative;
+}
+
+/* Tooltip content */
+[data-tooltip]::after {
+  content: attr(data-tooltip);
+  position: fixed; /* Use fixed positioning to escape overflow containers */
+  left: var(--tooltip-left, 0);
+  top: var(--tooltip-top, 0);
+  transform: translateY(-50%);
+  background: #333;
+  color: white;
+  padding: 8px 12px;
+  border-radius: 4px;
+  font-size: 14px;
+  white-space: normal;
+  line-height: 1.4;
+  max-width: 300px;
+  pointer-events: none;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.3s, visibility 0.3s;
+  z-index: 10000;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.2), 0 2px 4px -1px rgba(0, 0, 0, 0.1);
+}
+
+/* Tooltip arrow */
+[data-tooltip]::before {
+  content: '';
+  position: fixed;
+  left: var(--tooltip-left, 0);
+  top: var(--tooltip-top, 0);
+  transform: translateX(-8px) translateY(-50%);
+  width: 0;
+  height: 0;
+  border-style: solid;
+  border-width: 6px 8px 6px 0;
+  border-color: transparent #333 transparent transparent;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.3s, visibility 0.3s;
+  z-index: 10001;
+}
+
+[data-tooltip]:hover::after,
+[data-tooltip]:hover::before {
+  opacity: 1;
+  visibility: visible;
+}
+
+/* Ensure nav items have proper stacking context */
+.nav-item[data-tooltip],
+.nav-title[data-tooltip] {
+  position: relative !important;
+  z-index: 1;
+}
+
+.nav-item[data-tooltip]:hover,
+.nav-title[data-tooltip]:hover {
+  z-index: 100000; /* Very high z-index to ensure tooltip appears above everything */
+}
+
+/* Tooltip for nav titles (folders) */
+.nav-title[data-tooltip]::after {
+  max-width: 350px;
+  font-weight: 400;
+}
+
+/* Ensure nav sections don't clip tooltips */
+.nav-section {
+  position: relative;
+  overflow: visible !important;
+}
+
+/* Dark mode tooltip styles */
+[data-theme="dark"] [data-tooltip]::after {
+  background: var(--bg-secondary);
+  color: var(--text-primary);
+  border: 1px solid var(--bg-tertiary);
+  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.5);
+}
+
+[data-theme="dark"] [data-tooltip]::before {
+  border-right-color: var(--bg-secondary);
+}
+
+/* Mobile adjustments */
+@media (max-width: 768px) {
+  /* Disable tooltips on mobile to prevent overlap issues */
+  [data-tooltip]::before,
+  [data-tooltip]::after {
+    display: none;
+  }
+}
+
 /* Print Styles */
 @media print {
   .header,

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