@knowcode/doc-builder 1.3.7 → 1.3.8

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.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: calc(var(--tooltip-left, 0) - 8px);
+  top: var(--tooltip-top, 0);
+  transform: 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/package.json

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