+
"""
+
+ def level2Html = """
+
+
+ 
+ LITIENGINE Docs API
+
+
+
+ LITIENGINE Docs API
+
+
+
+
+
+ gurkenlabs/litiengine
+
+
+
+
"""
+
+ def hiddenToggleBtn = ''
+ def newTopNav = """"""
+ // Remove the old nav-list-search from sub-nav first
+ html = html.replaceFirst(/(?s)
+ ${enhancedNavList}
+
+ Sponsor
+
+
+ .*?<\/div>/, '')
+ // Replace the entire top-nav block cleanly up to sub-nav
+ html = html.replaceFirst(/(?s)
.*?<\/div>(?=\s*
)/, newTopNav)
+
+ // Remove empty sub-nav on pages without breadcrumbs (overview, tree, index, search, etc.)
+ html = html.replaceAll(/(?s)
\s*
\s*
- \s*<\/ol>\s*<\/div>\s*<\/div>/, '')
+
+ // Remove redundant single-level "java.lang.Object" inheritance tree on class declaration pages
+ html = html.replaceAll(/(?s)
- java\.lang\.]*?>Object<\/a>\s*
- (.*?)<\/ul>\s*<\/li>/, '$1')
+ }
+
+ // Statically pre-render sticky alphabet bar on index-all.html
+ if (file.name == 'index-all.html') {
+ def jumpMatcher = (html =~ /(?s)
\s*Index<\/h1>\s*<\/div>\s*(.*?)(?=
)/) + if (jumpMatcher) { + def rawJump = jumpMatcher[0][1] + def letterLinks = [] + def letM = (rawJump =~ /([A-Z])<\/a>/) + while (letM.find()) { + letterLinks.add(letM.group(0)) + } + def secondaryLinks = [] + def secM = (rawJump =~ /(.*?)<\/a>/) + while (secM.find()) { + secondaryLinks.add(secM.group(0)) + } + + def stickyBarHtml = """\n""" + + html = html.replace(jumpMatcher[0][0], """
\n${stickyBarHtml}""") + html = html.replaceAll(/(?s)<\/dl>\s*A<\/a>.*?<\/main>/, '\n') + } + } + + // Statically pre-render search box wrapper on search.html + if (file.name == 'search.html') { + def searchInputPattern = /(?s)(]*>)\s*(]*>)?/ + def searchIconSvg = '' + html = html.replaceFirst(searchInputPattern) { full, inp, rst -> + def resetStr = rst ?: '' + """Index
${searchIconSvg}${inp}${resetStr}""" + } + } + + // Statically enhance TOC filter input on pages with a table of contents + def tocFilterPattern = /(?s)\s*(?:Contents )?(]*>)\s*(]*>)?\s*<\/div>/ + def tocSearchSvg = '' + html = html.replaceAll(tocFilterPattern) { full, inp, rst -> + def cleanInp = inp.replace('placeholder="Filter contents (type .)"', 'placeholder="Filter"') + def resetStr = rst ?: '' + """""" + } + } + // 2. Build Contextual Tags at generation time def tags = [] as Set def pathLower = file.absolutePath.toLowerCase().replace('\\', '/') @@ -134,10 +277,12 @@ void enhanceJavadocHtml(File file, File rootDir) { if (cleanHeading.endsWith("Listener")) tags.add("listener") if (cleanHeading.endsWith("Event")) tags.add("event") if (cleanHeading.endsWith("Controller")) tags.add("controller") - if (html.contains("deprecation-block") || html.contains("deprecated-label")) tags.add("deprecated") - - if (tags.size() < 4) tags.add("api") - if (tags.size() < 5) tags.add("java") + if (file.name == 'search.html' || file.name == 'help-doc.html') { + tags.clear() + } else { + if (tags.size() < 4) tags.add("api") + if (tags.size() < 5) tags.add("java") + } // 2. Insert Bottom Tags inside${tocSearchSvg}${cleanInp}${resetStr}if (tags && html.contains(" ")) { @@ -165,7 +310,7 @@ void enhanceJavadocHtml(File file, File rootDir) {- Copyright © 2026 GURKENLABS · Released under the MIT License + Documentation · Copyright © 2026 GURKENLABS · Released under the MIT License""" diff --git a/config/javadoc/generate_js.py b/config/javadoc/generate_js.py index 3590c1edc..4fc96c9e4 100644 --- a/config/javadoc/generate_js.py +++ b/config/javadoc/generate_js.py @@ -63,30 +63,6 @@ return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches; } - function loadGoogleFonts() { - if (document.querySelector('link[href*="fonts.googleapis.com"]')) return; - const head = document.head || document.getElementsByTagName('head')[0]; - if (!head) return; - const preconnect1 = document.createElement('link'); - preconnect1.rel = 'preconnect'; - preconnect1.href = 'https://fonts.googleapis.com'; - head.appendChild(preconnect1); - - const preconnect2 = document.createElement('link'); - preconnect2.rel = 'preconnect'; - preconnect2.href = 'https://fonts.gstatic.com'; - preconnect2.crossOrigin = 'anonymous'; - head.appendChild(preconnect2); - - const fontLink = document.createElement('link'); - fontLink.rel = 'stylesheet'; - fontLink.href = 'https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap'; - fontLink.media = 'all'; - head.appendChild(fontLink); - } - - loadGoogleFonts(); - function setupFavicons() { const r = getRoot(); const head = document.head || document.getElementsByTagName('head')[0]; @@ -112,13 +88,57 @@ function setupTwoLevelNavigation() { try { const header = document.querySelector('header[role="banner"]'); - if (!header || document.querySelector('.liti-header-level1')) return; + if (!header) return; + + const themeBtn = header.querySelector('.liti-theme-toggle'); + if (themeBtn) { + function updateToggleIcon() { + themeBtn.innerHTML = isDarkMode() ? MOON_SVG : SUN_SVG; + } + + themeBtn.addEventListener('click', function () { + const nextTheme = isDarkMode() ? 'light' : 'dark'; + document.documentElement.setAttribute('data-theme', nextTheme); + setStoredTheme(nextTheme); + updateToggleIcon(); + }); + + updateToggleIcon(); + } + + const searchInput = header.querySelector('#search-input'); + if (searchInput && document.body.classList.contains('search-page')) { + searchInput.addEventListener('focus', function () { + const pageInput = document.getElementById('page-search-input'); + if (pageInput) { + pageInput.focus(); + pageInput.select(); + } + }); + } + + const isMac = navigator.platform && navigator.platform.toUpperCase().indexOf('MAC') >= 0; + if (isMac) { + header.querySelectorAll('.search-kbd').forEach(k => { k.textContent = '⌘K'; }); + } + + // Remove Deprecated and Help navigation items + header.querySelectorAll('ul.nav-list li').forEach(li => { + const text = li.textContent.trim().toLowerCase(); + if (text === 'deprecated' || text === 'help') { + li.remove(); + } + }); + + // If header is already baked statically into HTML, our work here is done! + if (header.querySelector('.liti-header-level1')) return; const navList = document.querySelector('ul.nav-list'); + if (!navList) return; + const navListSearch = document.querySelector('.nav-list-search'); - if (!navList || !navListSearch) return; - // Create 2-Level Header Structure + // Create 2-Level Header Structure Fallback const level1 = document.createElement('div'); level1.className = 'liti-header-level1'; @@ -128,7 +148,7 @@ // Brand Link (Exact 28.79px logo from DevTools) const brand = document.createElement('a'); brand.className = 'liti-brand-link'; - brand.href = 'https://gurkenlabs.github.io/litiengine-docs/'; + brand.href = 'https://docs.litiengine.com/'; brand.innerHTML = `LITIENGINE Docs API`; level1Inner.appendChild(brand); @@ -137,50 +157,66 @@ level1Right.className = 'liti-header-level1-right'; // 1. Theme toggle button (Dark -> Moon icon, Light -> Sun icon) - const themeBtn = document.createElement('button'); - themeBtn.type = 'button'; - themeBtn.className = 'liti-theme-toggle'; - themeBtn.title = 'Toggle dark / light mode'; - themeBtn.setAttribute('aria-label', 'Toggle theme'); - - function updateToggleIcon() { - themeBtn.innerHTML = isDarkMode() ? MOON_SVG : SUN_SVG; + const dynamicThemeBtn = document.createElement('button'); + dynamicThemeBtn.type = 'button'; + dynamicThemeBtn.className = 'liti-theme-toggle'; + dynamicThemeBtn.title = 'Toggle dark / light mode'; + dynamicThemeBtn.setAttribute('aria-label', 'Toggle theme'); + + function updateDynamicToggleIcon() { + dynamicThemeBtn.innerHTML = isDarkMode() ? MOON_SVG : SUN_SVG; } - themeBtn.addEventListener('click', function () { + dynamicThemeBtn.addEventListener('click', function () { const nextTheme = isDarkMode() ? 'light' : 'dark'; document.documentElement.setAttribute('data-theme', nextTheme); setStoredTheme(nextTheme); - updateToggleIcon(); + updateDynamicToggleIcon(); }); - updateToggleIcon(); - level1Right.appendChild(themeBtn); + updateDynamicToggleIcon(); + level1Right.appendChild(dynamicThemeBtn); - // 2. Search capsule - if (navListSearch) { - const searchInput = navListSearch.querySelector('#search-input'); - if (searchInput) { - searchInput.setAttribute('placeholder', 'Search'); - } + // 2. Search capsule + if (navListSearch) { + const searchInput = navListSearch.querySelector('#search-input'); + if (searchInput) { + searchInput.setAttribute('placeholder', 'Search'); + } - if (!navListSearch.querySelector('.search-icon-svg')) { - const iconWrapper = document.createElement('span'); - iconWrapper.className = 'search-icon-wrapper'; - iconWrapper.innerHTML = SEARCH_SVG; - navListSearch.insertBefore(iconWrapper, navListSearch.firstChild); - } + if (!navListSearch.querySelector('.search-icon-svg')) { + const iconWrapper = document.createElement('span'); + iconWrapper.className = 'search-icon-wrapper'; + iconWrapper.innerHTML = SEARCH_SVG; + navListSearch.insertBefore(iconWrapper, navListSearch.firstChild); + } - if (!navListSearch.querySelector('.search-kbd')) { - const kbd = document.createElement('kbd'); - kbd.className = 'search-kbd'; - const isMac = navigator.platform.toUpperCase().indexOf('MAC') >= 0; - kbd.textContent = isMac ? '⌘K' : 'Ctrl+K'; - navListSearch.appendChild(kbd); - } + if (!navListSearch.querySelector('.search-kbd')) { + const kbd = document.createElement('kbd'); + kbd.className = 'search-kbd'; + const isMac = navigator.platform && navigator.platform.toUpperCase().indexOf('MAC') >= 0; + kbd.textContent = isMac ? '⌘K' : 'Ctrl+K'; + navListSearch.appendChild(kbd); + } - level1Right.appendChild(navListSearch); - } + level1Right.appendChild(navListSearch); + } else { + const searchCapsule = document.createElement('div'); + searchCapsule.className = 'nav-list-search'; + const isMac = navigator.platform && navigator.platform.toUpperCase().indexOf('MAC') >= 0; + searchCapsule.innerHTML = `${isMac ? '⌘K' : 'Ctrl+K'}`; + const headerInput = searchCapsule.querySelector('#search-input'); + if (headerInput) { + headerInput.addEventListener('focus', function () { + const pageInput = document.getElementById('page-search-input'); + if (pageInput) { + pageInput.focus(); + pageInput.select(); + } + }); + } + level1Right.appendChild(searchCapsule); + } // 3. GitHub Repo Link (clean & simplified) const githubLink = document.createElement('a'); @@ -201,8 +237,14 @@ const level2Inner = document.createElement('div'); level2Inner.className = 'liti-header-container'; - // Move navList into level 2 + // Move navList into level 2 with a prominent backlink to documentation if (navList) { + if (!navList.querySelector('.nav-item-backlink')) { + const backLi = document.createElement('li'); + backLi.className = 'nav-item-backlink'; + backLi.innerHTML = `Docs`; + navList.insertBefore(backLi, navList.firstChild); + } level2Inner.appendChild(navList); } @@ -336,9 +378,10 @@ // 1. Unwrap java.lang.Object root nodes so all direct classes start directly at the top level const rootNodes = Array.from(document.querySelectorAll('section.hierarchy > ul > li.circle')); rootNodes.forEach(li => { - const link = li.querySelector('a[href*="java.lang/Object.html"], a[title*="java.lang.Object"]'); - const directText = li.childNodes.length ? li.childNodes[0].textContent : ''; - if ((link && link.textContent.trim() === 'Object') || directText.includes('java.lang.Object') || directText.trim() === 'java.lang.') { + const link = li.querySelector('a[href*="Object.html"]'); + const isObjLink = link && (link.textContent.trim() === 'Object' || link.href.includes('/Object.html')); + const isObjText = li.textContent.includes('java.lang.Object') || (li.childNodes.length && li.childNodes[0].textContent.includes('java.lang.')); + if (isObjLink || isObjText) { const childUl = li.querySelector('ul'); if (childUl && li.parentNode) { const parentUl = li.parentNode; @@ -463,7 +506,7 @@ document.addEventListener('keydown', (e) => { if ((e.ctrlKey || e.metaKey) && e.key.toLowerCase() === 'k') { e.preventDefault(); - const searchInput = document.getElementById('search-input') || document.getElementById('page-search-input'); + const searchInput = document.getElementById('page-search-input') || document.getElementById('search-input'); if (searchInput) { searchInput.focus(); searchInput.select(); @@ -585,6 +628,18 @@ current = Array.from(current.children).find(el => el.classList.contains('inheritance')); } + // Also clean up redundant "extends Object" from type-signature + const extImplements = document.querySelector('.type-signature .extends-implements'); + if (extImplements) { + const extObjLink = extImplements.querySelector('a[href*="Object.html"]'); + if (extObjLink && extObjLink.textContent.trim() === 'Object') { + const text = extImplements.textContent.trim(); + if (text === 'extends Object') { + extImplements.remove(); + } + } + } + // Filter out Object nodes const validItems = items.filter(item => !item.isObject); diff --git a/config/javadoc/litiengine.css b/config/javadoc/litiengine.css index 4b3f6fe22..37918349d 100644 --- a/config/javadoc/litiengine.css +++ b/config/javadoc/litiengine.css @@ -495,13 +495,20 @@ header[role="banner"] { } .liti-brand-text .api-tag { - color: var(--color-primary); - font-size: 0.8rem; - font-weight: 700; - background-color: var(--color-primary-light); - padding: 0.15rem 0.5rem; - border-radius: 4px; - margin-left: 0.4rem; + display: inline-flex !important; + align-items: center !important; + font-size: 0.68rem !important; + font-weight: 800 !important; + letter-spacing: 0.07em !important; + text-transform: uppercase !important; + line-height: 1 !important; + padding: 0.22rem 0.5rem !important; + border-radius: 4px !important; + margin-left: 0.5rem !important; + vertical-align: middle !important; + color: #ffffff !important; + background: linear-gradient(135deg, #ff6b5b 0%, #e64a3b 100%) !important; + box-shadow: 0 2px 8px rgba(230, 74, 59, 0.3) !important; } .liti-header-level1-right { @@ -709,6 +716,54 @@ ul.nav-list li.nav-bar-cell1-rev a, background-color: transparent !important; } +/* Hide Deprecated and Help navigation items */ +ul.nav-list li:has(a[href*="deprecated-list"]), +ul.nav-list li:has(a[href*="help-doc"]) { + display: none !important; +} + +/* Backlink to main documentation in Level 2 */ +ul.nav-list li.nav-item-backlink { + margin-right: 0.5rem !important; +} + +ul.nav-list li.nav-item-backlink a.nav-link-docs { + display: inline-flex !important; + align-items: center !important; + gap: 0.4rem !important; + height: 32px !important; + line-height: 32px !important; + padding: 0 0.85rem !important; + color: var(--color-primary) !important; + background-color: var(--color-primary-light) !important; + border: 1px solid var(--border-subtle) !important; + border-radius: 6px !important; + font-size: 0.86rem !important; + font-weight: 600 !important; + text-decoration: none !important; + transition: all 0.15s ease !important; + white-space: nowrap !important; +} + +ul.nav-list li.nav-item-backlink a.nav-link-docs:hover { + background-color: var(--color-primary) !important; + color: #ffffff !important; + border-color: var(--color-primary) !important; + transform: translateX(-2px) !important; + text-decoration: none !important; +} + +ul.nav-list li.nav-item-backlink a.nav-link-docs svg.docs-back-icon { + width: 14px !important; + height: 14px !important; + stroke: currentColor !important; + transition: transform 0.15s ease !important; +} + +ul.nav-list li.nav-item-backlink a.nav-link-docs:hover svg.docs-back-icon { + transform: translateX(-2px) !important; +} + /* Sponsor button in Level 2 */ .md-tabs__link--sponsor { display: inline-flex !important; @@ -759,6 +814,7 @@ div.sub-nav { width: 100%; } +.sub-nav:not(:has(li)), .sub-nav:has(.sub-nav-list:empty) { display: none !important; } @@ -999,10 +1055,34 @@ ol.sub-nav-list .current-selection { flex-shrink: 0 !important; } +input.filter-input { + background-color: var(--search-box-bg) !important; + background-image: none !important; + border: 1px solid var(--search-box-border) !important; + border-radius: 6px !important; + color: var(--body-text-color) !important; + font-size: 0.82rem !important; + font-family: var(--body-font-family) !important; + padding: 0.35rem 0.6rem !important; + height: 34px !important; + width: 100% !important; + box-sizing: border-box !important; + outline: none !important; + transition: all 0.2s ease !important; +} + +input.filter-input:focus { + border-color: var(--color-primary) !important; + box-shadow: 0 0 0 2px rgba(0, 189, 165, 0.25) !important; + background-color: var(--code-background-color) !important; +} + .toc-filter-wrapper input.filter-input { background: transparent !important; background-color: transparent !important; + background-image: none !important; border: none !important; + border-radius: 0 !important; color: var(--body-text-color) !important; font-size: 0.82rem !important; font-family: var(--body-font-family) !important; @@ -1451,11 +1531,19 @@ div.table-tabs > .active-table-tab { line-height: 1.55 !important; overflow: visible !important; border-bottom: 1px solid var(--border-subtle) !important; - display: flex !important; + display: flex; align-items: center !important; word-break: break-word !important; } +/* Ensure inline display: none applied by script.js table filtering is always respected */ +.summary-table > div[style*="display: none"], +.summary-table > div[style*="display:none"], +.details-table > div[style*="display: none"], +.details-table > div[style*="display:none"] { + display: none !important; +} + .col-first, .col-second, .col-last, .col-constructor-name { overflow: visible !important; scrollbar-width: none !important; @@ -1770,10 +1858,19 @@ footer { Alphabetical Index Page (index-all.html) ========================================================================== */ -body.index-page main { +body.index-page .main-grid { + display: block !important; + width: 100% !important; max-width: var(--max-content-width) !important; margin: 0 auto !important; - padding: 2rem 1.5rem !important; + padding: 1.25rem 1.5rem 4rem 1.5rem !important; +} + +body.index-page main { + width: 100% !important; + max-width: 100% !important; + padding: 0 !important; + margin: 0 !important; } body.index-page main h1 { @@ -1781,7 +1878,8 @@ body.index-page main h1 { font-weight: 700 !important; letter-spacing: -0.02em !important; color: var(--title-color) !important; - margin-bottom: 1.5rem !important; + margin-top: 0 !important; + margin-bottom: 1rem !important; } /* Raw Alphabet Jump Links (Pure CSS Fallback before JS wrapping) */ @@ -1825,21 +1923,21 @@ body.index-page main > span.vertical-separator { /* Sticky Alphabet Quick-Jump Bar */ .index-sticky-bar { position: sticky !important; - top: 130px !important; - z-index: 90 !important; + top: 128px !important; + z-index: 100 !important; background-color: var(--header-glass-bg) !important; - backdrop-filter: blur(14px) !important; - -webkit-backdrop-filter: blur(14px) !important; - padding: 0.85rem 1.25rem !important; - margin: 1rem 1rem 2.5rem 1rem !important; - width: calc(100% - 2rem) !important; + backdrop-filter: blur(16px) !important; + -webkit-backdrop-filter: blur(16px) !important; + padding: 1rem 1.25rem !important; + margin: 1.25rem 0 2.5rem 0 !important; + width: 100% !important; box-sizing: border-box !important; border: 1px solid var(--border-color) !important; border-radius: 12px !important; - box-shadow: var(--elevated-shadow) !important; + box-shadow: 0 8px 30px rgba(0, 0, 0, 0.4), var(--elevated-shadow) !important; display: flex !important; flex-direction: column !important; - gap: 0.65rem !important; + gap: 0.75rem !important; } .index-letters-container { @@ -2036,6 +2134,26 @@ dl.index dd .block { Search Page (search.html) ========================================================================== */ +body.search-page .main-grid { + max-width: var(--max-content-width) !important; + margin: 0 auto !important; + padding: 2.5rem 1.5rem 4rem 1.5rem !important; + display: block !important; +} + +body.search-page main { + width: 100% !important; + max-width: 100% !important; +} + +body.search-page h1.title { + font-size: 2.2rem !important; + font-weight: 700 !important; + letter-spacing: -0.02em !important; + color: var(--title-color) !important; + margin-bottom: 1.25rem !important; +} + .page-search-wrapper { display: inline-flex !important; align-items: center !important; @@ -2073,20 +2191,32 @@ dl.index dd .block { } input#page-search-input { + background-color: var(--search-box-bg) !important; + border: 1px solid var(--search-box-border) !important; + border-radius: 8px !important; + height: 44px !important; + padding: 0 1rem !important; + width: min(100%, 480px) !important; + color: var(--search-input-text-color) !important; + font-size: 0.95rem !important; + font-family: var(--body-font-family) !important; + box-sizing: border-box !important; + transition: all 0.2s ease !important; +} + +.page-search-wrapper input#page-search-input { background: transparent !important; background-image: none !important; background-color: transparent !important; border: none !important; - color: var(--search-input-text-color) !important; - font-size: 0.95rem !important; - font-family: var(--body-font-family) !important; - outline: none !important; - box-shadow: none !important; + border-radius: 0 !important; padding: 0 !important; margin: 0 !important; width: 100% !important; height: 100% !important; flex: 1 1 auto !important; + box-shadow: none !important; + outline: none !important; } input#page-search-reset { @@ -2168,6 +2298,97 @@ div.table-tabs > button[id^="result-tab-"].active-table-tab { font-weight: 600 !important; } +/* ========================================================================== + Search Autocomplete Results Dropdown (Header Search Bar) + ========================================================================== */ + +ul.ui-autocomplete { + position: fixed !important; + z-index: 999999 !important; + background-color: var(--card-bg) !important; + border: 1px solid var(--border-color) !important; + border-radius: 12px !important; + box-shadow: 0 16px 40px rgba(0, 0, 0, 0.5), 0 4px 12px rgba(0, 0, 0, 0.25) !important; + backdrop-filter: blur(16px) !important; + -webkit-backdrop-filter: blur(16px) !important; + padding: 0.35rem 0 !important; + margin-top: 4px !important; + max-height: calc(90vh - 120px) !important; + overflow-y: auto !important; +} + +.ui-autocomplete-category { + background-color: var(--even-row-color) !important; + color: var(--text-muted) !important; + font-size: 0.72rem !important; + font-weight: 700 !important; + text-transform: uppercase !important; + letter-spacing: 0.08em !important; + padding: 0.55rem 1rem 0.35rem 1rem !important; + border-bottom: 1px solid var(--border-subtle) !important; +} + +.ui-autocomplete > li.result-item { + font-family: var(--body-font-family) !important; + padding: 0.45rem 1rem !important; + border-bottom: 1px solid var(--border-subtle) !important; + cursor: pointer !important; + transition: background-color 0.12s ease !important; +} + +.ui-autocomplete > li.result-item:last-of-type { + border-bottom: none !important; +} + +.ui-autocomplete > li.result-item:hover, +.ui-autocomplete > li.result-item.ui-state-active, +.ui-autocomplete > li.result-item .ui-state-active, +.ui-menu .ui-state-active { + background-color: var(--color-primary-light) !important; + border-color: transparent !important; + margin: 0 !important; +} + +.ui-autocomplete .search-result-label { + color: var(--color-primary) !important; + font-weight: 600 !important; + font-size: 0.92rem !important; +} + +.ui-autocomplete .search-result-desc { + color: var(--text-muted) !important; + font-size: 0.8rem !important; +} + +.ui-autocomplete .result-highlight { + color: var(--navbar-link-hover) !important; + font-weight: 700 !important; + text-decoration: underline !important; +} + +ul.ui-autocomplete li.ui-static-link { + position: sticky !important; + bottom: 0 !important; + left: 0 !important; + background: var(--card-bg) !important; + border-top: 1px solid var(--border-color) !important; + padding: 0.65rem 1rem !important; + z-index: 1000000 !important; + border-bottom-left-radius: 12px !important; + border-bottom-right-radius: 12px !important; +} + +ul.ui-autocomplete li.ui-static-link a { + color: var(--color-primary) !important; + font-weight: 600 !important; + font-size: 0.88rem !important; + text-decoration: none !important; +} + +ul.ui-autocomplete li.ui-static-link a:hover { + text-decoration: underline !important; +} + /* Modern Results Table Grid */ div.result-table, .two-column-search-results { @@ -2255,11 +2476,28 @@ span.search-result-desc a:hover { Hierarchy & Tree Pages (overview-tree.html & package-tree.html) ========================================================================== */ -body.tree-page main, -body.package-tree-page main { +body.tree-page .main-grid, +body.package-tree-page .main-grid { + display: block !important; + width: 100% !important; max-width: var(--max-content-width) !important; margin: 0 auto !important; - padding: 2rem 1.5rem !important; + padding: 1.25rem 1.5rem 4rem 1.5rem !important; +} + +body.tree-page main, +body.package-tree-page main { + width: 100% !important; + max-width: 100% !important; + padding: 0 !important; + margin: 0 !important; +} + +body.tree-page h1.title, +body.package-tree-page h1.title { + margin-top: 0 !important; + margin-bottom: 0.75rem !important; + padding-top: 0 !important; } .package-hierarchy-label { diff --git a/config/javadoc/litiengine.js b/config/javadoc/litiengine.js index 4e86b1326..861a7ed6b 100644 --- a/config/javadoc/litiengine.js +++ b/config/javadoc/litiengine.js @@ -59,30 +59,6 @@ return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches; } - function loadGoogleFonts() { - if (document.querySelector('link[href*="fonts.googleapis.com"]')) return; - const head = document.head || document.getElementsByTagName('head')[0]; - if (!head) return; - const preconnect1 = document.createElement('link'); - preconnect1.rel = 'preconnect'; - preconnect1.href = 'https://fonts.googleapis.com'; - head.appendChild(preconnect1); - - const preconnect2 = document.createElement('link'); - preconnect2.rel = 'preconnect'; - preconnect2.href = 'https://fonts.gstatic.com'; - preconnect2.crossOrigin = 'anonymous'; - head.appendChild(preconnect2); - - const fontLink = document.createElement('link'); - fontLink.rel = 'stylesheet'; - fontLink.href = 'https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&display=swap'; - fontLink.media = 'all'; - head.appendChild(fontLink); - } - - loadGoogleFonts(); - function setupFavicons() { const r = getRoot(); const head = document.head || document.getElementsByTagName('head')[0]; @@ -108,13 +84,57 @@ function setupTwoLevelNavigation() { try { const header = document.querySelector('header[role="banner"]'); - if (!header || document.querySelector('.liti-header-level1')) return; + if (!header) return; + + const themeBtn = header.querySelector('.liti-theme-toggle'); + if (themeBtn) { + function updateToggleIcon() { + themeBtn.innerHTML = isDarkMode() ? MOON_SVG : SUN_SVG; + } + + themeBtn.addEventListener('click', function () { + const nextTheme = isDarkMode() ? 'light' : 'dark'; + document.documentElement.setAttribute('data-theme', nextTheme); + setStoredTheme(nextTheme); + updateToggleIcon(); + }); + + updateToggleIcon(); + } + + const searchInput = header.querySelector('#search-input'); + if (searchInput && document.body.classList.contains('search-page')) { + searchInput.addEventListener('focus', function () { + const pageInput = document.getElementById('page-search-input'); + if (pageInput) { + pageInput.focus(); + pageInput.select(); + } + }); + } + + const isMac = navigator.platform && navigator.platform.toUpperCase().indexOf('MAC') >= 0; + if (isMac) { + header.querySelectorAll('.search-kbd').forEach(k => { k.textContent = '⌘K'; }); + } + + // Remove Deprecated and Help navigation items + header.querySelectorAll('ul.nav-list li').forEach(li => { + const text = li.textContent.trim().toLowerCase(); + if (text === 'deprecated' || text === 'help') { + li.remove(); + } + }); + + // If header is already baked statically into HTML, our work here is done! + if (header.querySelector('.liti-header-level1')) return; const navList = document.querySelector('ul.nav-list'); + if (!navList) return; + const navListSearch = document.querySelector('.nav-list-search'); - if (!navList || !navListSearch) return; - // Create 2-Level Header Structure + // Create 2-Level Header Structure Fallback const level1 = document.createElement('div'); level1.className = 'liti-header-level1'; @@ -124,7 +144,7 @@ // Brand Link (Exact 28.79px logo from DevTools) const brand = document.createElement('a'); brand.className = 'liti-brand-link'; - brand.href = 'https://gurkenlabs.github.io/litiengine-docs/'; + brand.href = 'https://docs.litiengine.com/'; brand.innerHTML = `
\s*]*?>java\.lang\.Object<\/a>\s*
([^<]+)<\/div>\s*<\/div>/, '')
+
+ // Remove redundant "extends Object" from type-signature if class only extends Object
+ html = html.replaceAll(/(?s)\s*extends\s*]*?>Object<\/a>\s*<\/span>/, '')
+
+ // Unwrap java.lang.Object root node in hierarchy trees
+ if (file.name.endsWith('-tree.html')) {
+ html = html.replaceAll(/(?s)