Merge branch 'dev'

- Add :not([data-fancybox]) to pjaxExclude to prevent fancybox links from being loaded via pjax
- Refactor series grouping to use a shared hexo._seriesGroups object built once
- Improve performance by avoiding repeated post iteration in both tag and helper
- Version bump to 5.6.1

.github/workflows/publish.yml

@@ -3,17 +3,25 @@ name: npm publish
 on:
   release:
     types: [created]
+
 jobs:
   build:
     runs-on: ubuntu-latest
+    
+    permissions:
+      contents: read
+      id-token: write  # OIDC 必須
+
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
     # Setup .npmrc file to publish to npm
-    - uses: actions/setup-node@v1
+    - uses: actions/setup-node@v4
       with:
-        node-version: '12.x'
+        node-version: '20.x'
         registry-url: 'https://registry.npmjs.org'
+
     - run: npm install
-    - run: npm publish
+
+    - run: npm publish --provenance --access public
       env:
         NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

_config.yml

@@ -659,7 +659,7 @@ artalk:
 # --------------------------------------
 
 chat:
-  # Choose: chatra/tidio/crisp
+  # Choose: chatra/tidio/crisp/knocket
   # Leave it empty if you don't need chat
   use:
   # Chat Button [recommend]
@@ -680,6 +680,10 @@ tidio:
 crisp:
   website_id:
 
+# https://trtc.io/solutions/knocket
+knocket:
+  identifier:
+
 # --------------------------------------
 # Analysis
 # --------------------------------------

layout/includes/page/shuoshuo.pug

@@ -54,6 +54,8 @@
       (() => {
         const limitConfig = !{ JSON.stringify(page.limit || {}) }
 
+        const escapeHtml = str => String(str).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;')
+
         const sortDataByDate = data => data.sort((a, b) => new Date(b.date) - new Date(a.date))
 
         const filterDataByLimit = (data, limit) => {
@@ -64,13 +66,10 @@
             return data.filter(item => new Date(item.date) >= limitDate)
           }
           return data
-        };
+        }
 
-        const formatToTimeZone = (date) => {
+        const dateFormatter = new Intl.DateTimeFormat('en-GB', {
-          const fullDate = date.length === 10 ? `${date} 00:00:00` : date
+          timeZone: !{JSON.stringify(config.timezone || '')} || Intl.DateTimeFormat().resolvedOptions().timeZone,
-          const visitorTimeZone = '#{config.timezone}' || Intl.DateTimeFormat().resolvedOptions().timeZone
-          const options = {
-            timeZone: visitorTimeZone,
           year: 'numeric',
           month: '2-digit',
           day: '2-digit',
@@ -78,35 +77,36 @@
           minute: '2-digit',
           second: '2-digit',
           hour12: false
-          }
+        })
-          const [day, month, year, hour, minute, second] = new Intl.DateTimeFormat('en-GB', options)
+
-            .format(new Date(fullDate))
+        const formatToTimeZone = (date) => {
-            .match(/\d+/g)
+          const fullDate = date.length === 10 ? `${date} 00:00:00` : date
+          const [day, month, year, hour, minute, second] = dateFormatter.format(new Date(fullDate)).match(/\d+/g)
           return `${year}-${month}-${day} ${hour}:${minute}:${second}`
         }
 
         const addLazyload = str => {
-          const config = {
+          const lazyConfig = {
             enable: !{Boolean(enable)},
             native: !{Boolean(native)},
-            field: '!{field}',
+            field: !{JSON.stringify(field || '')},
-            placeholder: '!{url_for(placeholder)}',
+            placeholder: !{JSON.stringify(url_for(placeholder))},
           }
 
-          if (!config.enable || config.field !== 'site') return str
+          if (!lazyConfig.enable || lazyConfig.field !== 'site' || str.indexOf('<img') === -1) return str
           const parser = new DOMParser()
           const doc = parser.parseFromString(str, 'text/html')
           const images = doc.querySelectorAll('img')
 
           images.forEach(img => {
-            if (config.native) {
+            if (lazyConfig.native) {
               img.setAttribute('loading', 'lazy')
             } else {
               const src = img.getAttribute('src')
               img.setAttribute('data-lazy-src', src)
 
-              if (config.placeholder) {
+              if (lazyConfig.placeholder) {
-                img.setAttribute('src', config.placeholder)
+                img.setAttribute('src', lazyConfig.placeholder)
               } else {
                 img.removeAttribute('src')
               }
@@ -119,19 +119,18 @@
         const itemsPerPage = 8
         let totalPages = 0
         let data = []
-        let inputEventsAttached = false // Flag to mark if input event listeners have been added
 
         const renderData = (dataSlice) => {
           const content = dataSlice.map(item => {
             const formattedDate = formatToTimeZone(item.date)
-            const tags = item.tags && item.tags.map(tag => `<span class="shuoshuo-tag">${tag}</span>`).join('') || ''
+            const tags = item.tags && item.tags.map(tag => `<span class="shuoshuo-tag">${escapeHtml(tag)}</span>`).join('') || ''
-            const commentButton = item.key && !{commentsJsLoad}
+            const commentButton = item.key && !{commentsJsLoad || false}
               ? `<div class="shuoshuo-comment-btn" onclick="addCommentToShuoshuo(event)">
                   <i class="fa-solid fa-comments"></i>
                 </div>`
               : ''
             const commentContainer = item.key
-              ? `<div class="shuoshuo-comment no-comment" data-key="${item.key}"></div>`
+              ? `<div class="shuoshuo-comment no-comment" data-key="${escapeHtml(item.key)}"></div>`
               : ''
 
             return `
@@ -139,10 +138,10 @@
                 <div class="container">
                   <div class="shuoshuo-item-header">
                     <div class="shuoshuo-avatar">
-                      <img class="no-lightbox" src="${item.avatar || '!{url_for(theme.avatar.img)}'}">
+                      <img class="no-lightbox" src="${item.avatar ? escapeHtml(item.avatar) : !{JSON.stringify(url_for(theme.avatar.img))}}">
                     </div>
                     <div class="shuoshuo-info">
-                      <div class="shuoshuo-author">${item.author || '!{config.author}'}</div>
+                      <div class="shuoshuo-author">${item.author ? escapeHtml(item.author) : !{JSON.stringify(config.author || '')}}</div>
                       <time class="shuoshuo-date" title="${formattedDate}">
                         ${btf.diffDate(formattedDate, true)}
                       </time>
@@ -165,70 +164,94 @@
           btf.loadLightbox(document.querySelectorAll('#article-container img:not(.no-lightbox)'))
         }
 
-        const renderNavigation = () => {
+        const setupNavEvents = (nav) => {
-          const container = document.getElementById('article-container')
+          nav.querySelector('.shuoshuo-prev-btn').addEventListener('click', () => {
-          const existingNav = container.nextElementSibling
+            if (currentPage > 1) { currentPage--; renderPage(currentPage) }
-          if (existingNav && existingNav.classList.contains('shuoshuo-navigation')) {
+          })
-            existingNav.remove()
+          nav.querySelector('.shuoshuo-next-btn').addEventListener('click', () => {
+            if (currentPage < totalPages) { currentPage++; renderPage(currentPage) }
+          })
+
+          const input = nav.querySelector('.shuoshuo-page-input')
+
+          input.addEventListener('focus', e => { e.target.placeholder = '' })
+          input.addEventListener('blur', e => {
+            if (!e.target.value.trim()) e.target.placeholder = currentPage
+          })
+
+          input.addEventListener('input', e => {
+            const value = parseInt(e.target.value) || 0
+            let wasInvalid = false
+
+            if (value > totalPages) { e.target.value = totalPages; wasInvalid = true }
+            else if (value < 1 && e.target.value !== '') { e.target.value = 1; wasInvalid = true }
+
+            if (wasInvalid) {
+              e.target.classList.add('invalid')
+              setTimeout(() => e.target.classList.remove('invalid'), 500)
+            }
+          })
+
+          input.addEventListener('keydown', e => {
+            const value = e.target.value + e.key
+
+            if (e.key === 'Enter' || e.key === 'Backspace' || e.key === 'Delete' ||
+                e.key === 'ArrowLeft' || e.key === 'ArrowRight' ||
+                e.key === 'Tab' || e.ctrlKey || e.metaKey) {
+              if (e.key === 'Enter') {
+                const inputValue = e.target.value.trim()
+                const inputPage = inputValue === '' ? currentPage : parseInt(inputValue)
+                if (inputPage >= 1 && inputPage <= totalPages && inputPage !== currentPage) {
+                  currentPage = inputPage
+                  renderPage(currentPage)
+                } else if (inputValue === '') {
+                  renderPage(currentPage)
+                }
+              }
+              return
             }
 
+            if (!/^\d$/.test(e.key)) {
+              e.preventDefault()
+              return
+            }
+
+            const newValue = parseInt(value) || 0
+            if (newValue > totalPages || (value.length > 1 && newValue === 0)) {
+              e.preventDefault()
+              e.target.classList.add('invalid')
+              setTimeout(() => e.target.classList.remove('invalid'), 500)
+            }
+          })
+        }
+
+        const renderNavigation = () => {
+          const container = document.getElementById('article-container')
+          let nav = container.nextElementSibling
           const pageInfoTemplate = '#{__('pagination.page_info')}'
           const pageInfoText = pageInfoTemplate
             .replace(/\$\{current}/g, currentPage)
             .replace(/\$\{total}/g, totalPages)
 
-          const navHtml = `
+          if (!nav || !nav.classList.contains('shuoshuo-navigation')) {
-            <div class="shuoshuo-navigation">
+            nav = document.createElement('div')
-              <button onclick="window.shuoshuoPrevPage()" ${currentPage === 1 ? 'disabled' : ''}><i class="fa-solid fa-chevron-left"></i></button>
+            nav.className = 'shuoshuo-navigation'
-              <span class="shuoshuo-page-info">${pageInfoText}</span>
+            nav.innerHTML = `
-              <input type="number" class="shuoshuo-page-input" min="1" max="${totalPages}" placeholder="${currentPage}" onkeydown="window.shuoshuoHandleKeyDown(event)">
+              <button class="shuoshuo-prev-btn"><i class="fa-solid fa-chevron-left"></i></button>
-              <button onclick="window.shuoshuoNextPage()" ${currentPage === totalPages ? 'disabled' : ''}><i class="fa-solid fa-chevron-right"></i></button>
+              <span class="shuoshuo-page-info"></span>
-            </div>
+              <input type="number" class="shuoshuo-page-input" min="1">
+              <button class="shuoshuo-next-btn"><i class="fa-solid fa-chevron-right"></i></button>
             `
-          container.insertAdjacentHTML('afterend', navHtml)
+            container.insertAdjacentElement('afterend', nav)
-
+            setupNavEvents(nav)
-          // Add input validation event listeners (only once)
-          if (!inputEventsAttached) {
-            setTimeout(() => {
-              const input = document.querySelector('.shuoshuo-page-input')
-              if (input) {
-                // Clear placeholder when clicking the input box
-                input.addEventListener('focus', (event) => {
-                  event.target.placeholder = ''
-                })
-
-                // Restore placeholder if no content when losing focus
-                input.addEventListener('blur', (event) => {
-                  if (!event.target.value.trim()) {
-                    event.target.placeholder = currentPage
-                  }
-                })
-
-                input.addEventListener('input', (event) => {
-                  const value = parseInt(event.target.value) || 0
-                  let wasInvalid = false
-
-                  if (value > totalPages) {
-                    event.target.value = totalPages
-                    wasInvalid = true
-                  } else if (value < 1 && event.target.value !== '') {
-                    event.target.value = 1
-                    wasInvalid = true
           }
 
-                  // If value is corrected, show red and shake effect
+          nav.querySelector('.shuoshuo-page-info').textContent = pageInfoText
-                  if (wasInvalid) {
+          nav.querySelector('.shuoshuo-prev-btn').disabled = currentPage === 1
-                    event.target.classList.add('invalid')
+          nav.querySelector('.shuoshuo-next-btn').disabled = currentPage === totalPages
-                    setTimeout(() => {
+          const input = nav.querySelector('.shuoshuo-page-input')
-                      event.target.classList.remove('invalid')
+          input.max = totalPages
-                    }, 500)
+          input.placeholder = currentPage
-                  }
-                })
-
-                inputEventsAttached = true // Mark that event listeners have been added
-              }
-            }, 0)
-          }
         }
 
         const renderPage = (page) => {
@@ -239,79 +262,14 @@
           renderNavigation()
         }
 
-        window.shuoshuoPrevPage = () => {
-          if (currentPage > 1) {
-            currentPage--
-            renderPage(currentPage)
-          }
-        }
-
-        window.shuoshuoNextPage = () => {
-          if (currentPage < totalPages) {
-            currentPage++
-            renderPage(currentPage)
-          }
-        }
-
-        window.shuoshuoGoToPage = (page) => {
-          if (typeof page === 'number') {
-            // Directly jump to the specified page
-            if (page >= 1 && page <= totalPages && page !== currentPage) {
-              currentPage = page
-              renderPage(currentPage)
-            }
-          } else {
-            // Get page from input box
-            const input = document.querySelector('.shuoshuo-page-input')
-            const inputValue = input.value.trim()
-            const inputPage = inputValue === '' ? currentPage : parseInt(inputValue)
-            if (inputPage >= 1 && inputPage <= totalPages && inputPage !== currentPage) {
-              currentPage = inputPage
-              renderPage(currentPage)
-            } else if (inputValue === '') {
-              // If input box is empty, re-render current page (update placeholder)
-              renderPage(currentPage)
-            }
-          }
-        }
-
-        window.shuoshuoHandleKeyDown = (event) => {
-          const input = event.target
-          const value = input.value + event.key
-
-          // Allow delete, arrow keys, backspace, etc.
-          if (event.key === 'Enter' || event.key === 'Backspace' || event.key === 'Delete' ||
-              event.key === 'ArrowLeft' || event.key === 'ArrowRight' ||
-              event.key === 'Tab' || event.ctrlKey || event.metaKey) {
-            if (event.key === 'Enter') {
-              window.shuoshuoGoToPage()
-            }
-            return
-          }
-
-          // Only allow numbers
-          if (!/^\d$/.test(event.key)) {
-            event.preventDefault()
-            return
-          }
-
-          // Check if the value after input exceeds the range
-          const newValue = parseInt(value) || 0
-          if (newValue > totalPages || (value.length > 1 && newValue === 0)) {
-            event.preventDefault()
-            // Add red and shake effect
-            input.classList.add('invalid')
-            setTimeout(() => {
-              input.classList.remove('invalid')
-            }, 500)
-          }
-        }
-
         const loadShuoshuo = async () => {
+          const container = document.getElementById('article-container')
           try {
             let originData = []
             if (!{Boolean(page.shuoshuo_url)}) {
+              container.innerHTML = '<div class="shuoshuo-loading"><i class="fa-solid fa-circle-notch fa-spin"></i></div>'
               const response = await fetch('!{url_for(page.shuoshuo_url)}')
+              if (!response.ok) throw new Error(`HTTP ${response.status}`)
               originData = await response.json()
             } else {
               const dataElement = document.getElementById('shuoshuo-data')
@@ -319,14 +277,33 @@
             }
 
             data = filterDataByLimit(sortDataByDate(originData), limitConfig)
-
             totalPages = Math.ceil(data.length / itemsPerPage)
 
+            if (data.length === 0) {
+              container.innerHTML = '<div class="shuoshuo-empty"></div>'
+              return
+            }
+
             renderPage(currentPage)
           } catch (error) {
             console.error(error)
+            container.innerHTML = '<div class="shuoshuo-error"><i class="fa-solid fa-circle-exclamation"></i></div>'
+          }
         }
-        };
 
-        window.pjax ? loadShuoshuo() : window.addEventListener('load', loadShuoshuo)
+        const pjaxCleanup = () => {
+          const container = document.getElementById('article-container')
+          if (container) {
+            const nav = container.nextElementSibling
+            if (nav && nav.classList.contains('shuoshuo-navigation')) nav.remove()
+          }
+          document.removeEventListener('pjax:send', pjaxCleanup)
+        }
+
+        if (window.pjax) {
+          document.addEventListener('pjax:send', pjaxCleanup)
+          loadShuoshuo()
+        } else {
+          window.addEventListener('load', loadShuoshuo)
+        }
       })()

layout/includes/third-party/abcjs/abcjs.pug

@@ -2,8 +2,11 @@ script.
   (() => {
     const abcjsInit = () => {
       const abcjsFn = () => {
+        const $article = document.getElementById("article-container")
+        if (!$article || $article.querySelector(".hbe-container")) return
+
         setTimeout(() => {
-          const sheets = document.querySelectorAll(".abc-music-sheet")
+          const sheets = $article.querySelectorAll(".abc-music-sheet")
           for (let i = 0; i < sheets.length; i++) {
             const ele = sheets[i]
             if (ele.children.length > 0) continue
@@ -29,7 +32,7 @@ script.
         }, 100)
       }
 
-      if (typeof ABCJS === "object") {
+      if (typeof ABCJS === "object" && ABCJS !== null) {
         abcjsFn()
       } else {
         btf.getScript("!{url_for(theme.asset.abcjs_basic_js)}").then(abcjsFn)

layout/includes/third-party/chat/chatra.pug

@@ -6,10 +6,14 @@ script.
       (window.Chatra.q = window.Chatra.q || []).push(arguments)
     }
 
-    btf.getScript('https://call.chatra.io/chatra.js').then(() => {
     const isChatBtn = !{theme.chat.rightside_button}
     const isChatHideShow = !{theme.chat.button_hide_show}
 
+    if (isChatBtn) {
+      window.ChatraSetup = { startHidden: true }
+    }
+
+    btf.getScript('https://call.chatra.io/chatra.js').then(() => {
       if (isChatBtn) {
         const close = () => {
           Chatra('minimizeWidget')
@@ -21,11 +25,13 @@ script.
           Chatra('show')
         }
 
-        window.ChatraSetup = { startHidden: true }
+        window.chatBtnFn = () => {
+          const el = document.getElementById('chatra')
+          return el && el.classList.contains('chatra--expanded') ? close() : open()
+        }
 
-        window.chatBtnFn = () => document.getElementById('chatra').classList.contains('chatra--expanded') ? close() : open()
+        const chatBtn = document.getElementById('chat-btn')
-
+        if (chatBtn) chatBtn.style.display = 'block'
-        document.getElementById('chat-btn').style.display = 'block'
       } else if (isChatHideShow) {
         window.chatBtn = {
           hide: () => Chatra('hide'),

layout/includes/third-party/chat/crisp.pug

@@ -21,7 +21,8 @@ script.
 
         window.chatBtnFn = () => $crisp.is("chat:visible") ? close() : open()
 
-        document.getElementById('chat-btn').style.display = 'block'
+        const chatBtn = document.getElementById('chat-btn')
+        if (chatBtn) chatBtn.style.display = 'block'
       } else if (isChatHideShow) {
         window.chatBtn = {
           hide: () => $crisp.push(["do", "chat:hide"]),

layout/includes/third-party/chat/index.pug

@@ -5,3 +5,5 @@ case theme.chat.use
     include ./tidio.pug
   when 'crisp'
     include ./crisp.pug
+  when 'knocket'
+    include ./knocket.pug

layout/includes/third-party/chat/knocket.pug

@@ -0,0 +1,42 @@
+//- Knocket live chat — https://trtc.io/solutions/knocket
+script.
+  (() => {
+    const identifier = !{JSON.stringify(theme.knocket.identifier || '').replace(/</g, '\\u003c')}
+    if (!identifier) return
+
+    btf.getScript(`https://trtc.io/knocket-sdk/sdk.js?identifier=${encodeURIComponent(identifier)}`).then(() => {
+      const isChatBtn = !{theme.chat.rightside_button}
+      const isChatHideShow = !{theme.chat.button_hide_show}
+
+      let widget = null
+      const getWidget = () => widget || (widget = document.getElementById('contact-widget-auto'))
+
+      if (isChatBtn) {
+        const hide = () => { const w = getWidget(); if (w) w.style.display = 'none' }
+        const show = () => { const w = getWidget(); if (w) w.style.display = '' }
+
+        // Hide the native Knocket floating button
+        const observer = new MutationObserver(() => {
+          if (getWidget()) { hide(); observer.disconnect() }
+        })
+        observer.observe(document.body, { childList: true, subtree: true })
+        hide()
+
+        window.chatBtnFn = () => {
+          const w = getWidget()
+          if (!w) return
+          w.style.display = w.style.display === 'none' ? '' : 'none'
+        }
+
+        const chatBtn = document.getElementById('chat-btn')
+        if (chatBtn) chatBtn.style.display = 'block'
+      } else if (isChatHideShow) {
+        window.chatBtn = {
+          hide: () => { const w = getWidget(); if (w) w.style.display = 'none' },
+          show: () => { const w = getWidget(); if (w) w.style.display = '' }
+        }
+      }
+    }).catch(error => {
+      console.warn('[Knocket] Failed to load the chat SDK.', error)
+    })
+  })()

layout/includes/third-party/chat/tidio.pug

@@ -32,8 +32,8 @@ script.
           isShow ? close() : open()
         }
 
-        document.getElementById('chat-btn').style.display = 'block'
+        const chatBtn = document.getElementById('chat-btn')
-
+        if (chatBtn) chatBtn.style.display = 'block'
       } else if (isChatHideShow) {
         window.chatBtn = {
           hide: () => window.tidioChatApi && window.tidioChatApi.hide(),

layout/includes/third-party/comments/disqusjs.pug

@@ -3,7 +3,7 @@
 
 script.
   (() => {
-    const isShuoshuo = GLOBAL_CONFIG_SITE.pageType === 'shuoshuo'== 'shuoshuo'
+    const isShuoshuo = GLOBAL_CONFIG_SITE.pageType === 'shuoshuo'
     const dqOption = !{JSON.stringify(dqOption)}
 
     const destroyDisqusjs = () => {

layout/includes/third-party/comments/facebook_comments.pug

@@ -3,7 +3,7 @@
 
 script.
   (()=>{
-    const isShuoshuo = GLOBAL_CONFIG_SITE.pageType === 'shuoshuo'== 'shuoshuo'
+    const isShuoshuo = GLOBAL_CONFIG_SITE.pageType === 'shuoshuo'
 
     const loadFBComment = (el = document, path) => {
       if (isShuoshuo) {

layout/includes/third-party/math/mathjax.pug

@@ -2,7 +2,22 @@
 - const { tags, enableMenu } = theme.math.mathjax
 script.
   (() => {
+    const changeScriptToMath = article => {
+      article.querySelectorAll('script[type^="math/tex"]').forEach(el => {
+        const display = /mode=display/.test(el.type)
+        const node = document.createElement(display ? 'div' : 'span')
+        node.textContent = display
+          ? `$$${el.textContent}$$`
+          : `$${el.textContent}$`
+        el.parentNode.replaceChild(node, el)
+      })
+    }
+
     const loadMathjax = () => {
+      const article = document.getElementById('article-container')
+      if (!article || article.querySelector('.hbe-container')) return
+      changeScriptToMath(article)
+
       if (!window.MathJax) {
         window.MathJax = {
           loader: {
@@ -11,7 +26,8 @@ script.
               //- '[tex]/bbm',
               //- '[tex]/bboldx',
               //- '[tex]/dsfont',
-              '[tex]/mhchem'
+              '[tex]/mhchem',
+              'ui/lazy'
             ],
             paths: {
               'mathjax-newcm': '[mathjax]/../@mathjax/mathjax-newcm-font',
@@ -39,25 +55,13 @@ script.
             scale: 1.1
           },
           options: {
+            lazyMargin: '200px',
             enableMenu: !{enableMenu},
             menuOptions: {
               settings: {
                 enrich: false  // Turn off Braille and voice narration text automatic generation
               }
             },
-            renderActions: {
-              findScript: [10, doc => {
-                for (const node of document.querySelectorAll('script[type^="math/tex"]')) {
-                  const display = !!node.type.match(/; *mode=display/)
-                  const math = new doc.options.MathItem(node.textContent, doc.inputJax[0], display)
-                  const text = document.createTextNode('')
-                  node.parentNode.replaceChild(text, node)
-                  math.start = {node: text, delim: '', n: 0}
-                  math.end = {node: text, delim: '', n: 0}
-                  doc.math.push(math)
-                }
-              }, '']
-            }
           }
         }
 
@@ -67,9 +71,8 @@ script.
         script.async = true
         document.head.appendChild(script)
       } else {
-        MathJax.startup.document.state(0)
+        MathJax.typesetClear()
-        MathJax.texReset()
+        MathJax.typesetPromise([ article ])
-        MathJax.typesetPromise()
       }
     }
 

layout/includes/third-party/math/mermaid.pug

@@ -51,7 +51,7 @@ script.
         clone.setAttribute('viewBox', initViewBox.join(' '))
       }
       if (!clone.getAttribute('xmlns')) clone.setAttribute('xmlns', 'http://www.w3.org/2000/svg')
-      if (!clone.getAttribute('xmlns:xlink') && clone.outerHTML.includes('xlink:')) {
+      if (!clone.getAttribute('xmlns:xlink') && clone.innerHTML.includes('xlink:')) {
         clone.setAttribute('xmlns:xlink', 'http://www.w3.org/1999/xlink')
       }
       // inject background to match current theme
@@ -70,7 +70,8 @@ script.
       const blob = new Blob([htmlSource], { type: 'text/html;charset=utf-8' })
       const url = URL.createObjectURL(blob)
       window.open(url, '_blank', 'noopener')
-      setTimeout(() => URL.revokeObjectURL(url), 30000)
+
+      setTimeout(() => URL.revokeObjectURL(url), 5000)
     }
 
     const attachMermaidViewerButton = wrap => {
@@ -91,10 +92,6 @@ script.
           const svg = wrap.__mermaidOriginalSvg || wrap.querySelector('svg')
           if (!svg) return
           const initViewBox = wrap.__mermaidInitViewBox
-          if (typeof svg === 'string') {
-            openSvgInNewTab({ source: svg, initViewBox })
-            return
-          }
           openSvgInNewTab({ source: svg, initViewBox })
         })
         btn.__mermaidViewerBound = true
@@ -111,6 +108,13 @@ script.
     }
 
     const initMermaidGestures = wrap => {
+      // Clean up previous event listeners and pending frames
+      if (wrap.__mermaidAbortController) {
+        wrap.__mermaidAbortController.abort()
+        if (wrap.__mermaidRafId) cancelAnimationFrame(wrap.__mermaidRafId)
+      }
+      const ac = new AbortController()
+      wrap.__mermaidAbortController = ac
       const svg = wrap.querySelector('svg')
       if (!svg) return
 
@@ -119,158 +123,177 @@ script.
       wrap.__mermaidInitViewBox = initVb
       wrap.__mermaidCurViewBox = initVb.slice()
       setSvgViewBox(svg, initVb)
+      // Disable default gestures to prevent scroll chaining and pinch-zoom penetration in Chrome
+      svg.style.touchAction = 'none'
 
-      // Avoid binding multiple times on themeChange/pjax
+      // Cache BoundingClientRect, throttled on scroll to reduce reflow
-      if (wrap.__mermaidGestureBound) return
+      let cachedRect = svg.getBoundingClientRect()
-      wrap.__mermaidGestureBound = true
+      let rectDirty = false
+      const markRectDirty = () => { rectDirty = true }
+      window.addEventListener('resize', markRectDirty, { signal: ac.signal })
+      window.addEventListener('scroll', markRectDirty, { signal: ac.signal, capture: true })
+      const getRect = () => {
+        if (rectDirty) {
+          cachedRect = svg.getBoundingClientRect()
+          rectDirty = false
+        }
+        return cachedRect
+      }
 
-      // Helper: map client (viewport) coordinate -> viewBox coordinate
+      // Precompute clamp bounds from initial viewBox
-      const clientToViewBox = (clientX, clientY) => {
+      const minW = initVb[2] * 0.1
-        const rect = svg.getBoundingClientRect()
+      const maxW = initVb[2] * 10
-        const vb = wrap.__mermaidCurViewBox || getSvgViewBox(svg)
+      const minH = initVb[3] * 0.1
-        const x = vb[0] + (clientX - rect.left) * (vb[2] / rect.width)
+      const maxH = initVb[3] * 10
-        const y = vb[1] + (clientY - rect.top) * (vb[3] / rect.height)
+      const clampVb = vb => {
-        return { x, y, rect, vb }
+        const out = vb.slice()
+        out[2] = clamp(out[2], minW, maxW)
+        out[3] = clamp(out[3], minH, maxH)
+        return out
+      }
+
+      // Throttle DOM updates using requestAnimationFrame
+      let pendingVb = null
+      let rafId = null
+      const applyVb = () => {
+        if (pendingVb) {
+          wrap.__mermaidCurViewBox = pendingVb
+          setSvgViewBox(svg, pendingVb)
+          pendingVb = null
+        }
+        rafId = null
+        wrap.__mermaidRafId = null
+      }
+      const setCurVb = vb => {
+        pendingVb = clampVb(vb)
+        if (!rafId) {
+          rafId = requestAnimationFrame(applyVb)
+          wrap.__mermaidRafId = rafId
+        }
       }
 
       const state = {
         pointers: new Map(),
         startVb: null,
         startDist: 0,
-        startCenter: null
+        lastPointerX: 0,
-      }
+        lastPointerY: 0
-
-      const clampVb = vb => {
-        const init = wrap.__mermaidInitViewBox || vb
-        const minW = init[2] * 0.1
-        const maxW = init[2] * 10
-        const minH = init[3] * 0.1
-        const maxH = init[3] * 10
-        vb[2] = clamp(vb[2], minW, maxW)
-        vb[3] = clamp(vb[3], minH, maxH)
-        return vb
-      }
-
-      const setCurVb = vb => {
-        vb = clampVb(vb)
-        wrap.__mermaidCurViewBox = vb
-        setSvgViewBox(svg, vb)
       }
 
       const onPointerDown = e => {
-        // Allow only primary button for mouse
         if (e.pointerType === 'mouse' && e.button !== 0) return
         svg.setPointerCapture(e.pointerId)
+        const curVb = wrap.__mermaidCurViewBox
         state.pointers.set(e.pointerId, { x: e.clientX, y: e.clientY })
-
         if (state.pointers.size === 1) {
-          state.startVb = (wrap.__mermaidCurViewBox || getSvgViewBox(svg)).slice()
+          state.startVb = curVb.slice()
+          state.lastPointerX = e.clientX
+          state.lastPointerY = e.clientY
         } else if (state.pointers.size === 2) {
           const pts = [...state.pointers.values()]
           const dx = pts[0].x - pts[1].x
           const dy = pts[0].y - pts[1].y
           state.startDist = Math.hypot(dx, dy)
-          state.startVb = (wrap.__mermaidCurViewBox || getSvgViewBox(svg)).slice()
+          state.startVb = curVb.slice()
-          state.startCenter = { x: (pts[0].x + pts[1].x) / 2, y: (pts[0].y + pts[1].y) / 2 }
         }
       }
 
       const onPointerMove = e => {
         if (!state.pointers.has(e.pointerId)) return
         state.pointers.set(e.pointerId, { x: e.clientX, y: e.clientY })
-
+        const curVb = wrap.__mermaidCurViewBox
-        // Pan with 1 pointer
+        const rect = getRect()
         if (state.pointers.size === 1 && state.startVb) {
-          const p = [...state.pointers.values()][0]
+          const p = state.pointers.values().next().value
-          const prev = { x: e.clientX - e.movementX, y: e.clientY - e.movementY }
+          const dxClient = p.x - state.lastPointerX
-          // movementX/Y unreliable on touch, compute from stored last position
+          const dyClient = p.y - state.lastPointerY
-          const last = wrap.__mermaidLastSinglePointer || p
+          state.lastPointerX = p.x
-          const dxClient = p.x - last.x
+          state.lastPointerY = p.y
-          const dyClient = p.y - last.y
+          const dx = dxClient * (curVb[2] / rect.width)
-          wrap.__mermaidLastSinglePointer = p
+          const dy = dyClient * (curVb[3] / rect.height)
-
+          setCurVb([curVb[0] - dx, curVb[1] - dy, curVb[2], curVb[3]])
-          const { rect } = clientToViewBox(p.x, p.y)
-          const vb = (wrap.__mermaidCurViewBox || getSvgViewBox(svg)).slice()
-          const dx = dxClient * (vb[2] / rect.width)
-          const dy = dyClient * (vb[3] / rect.height)
-          setCurVb([vb[0] - dx, vb[1] - dy, vb[2], vb[3]])
           return
         }
-
-        // Pinch zoom with 2 pointers
         if (state.pointers.size === 2 && state.startVb && state.startDist > 0) {
           const pts = [...state.pointers.values()]
           const dx = pts[0].x - pts[1].x
           const dy = pts[0].y - pts[1].y
           const dist = Math.hypot(dx, dy)
           if (!dist) return
-          const factor = state.startDist / dist // dist bigger => zoom in (viewBox smaller)
+          const factor = state.startDist / dist
-
           const cx = (pts[0].x + pts[1].x) / 2
           const cy = (pts[0].y + pts[1].y) / 2
-          const centerClient = { x: cx, y: cy }
+          const px = curVb[0] + (cx - rect.left) * (curVb[2] / rect.width)
-
+          const py = curVb[1] + (cy - rect.top) * (curVb[3] / rect.height)
-          const pxy = clientToViewBox(centerClient.x, centerClient.y)
+          setCurVb(zoomAtPoint(state.startVb, factor, px, py))
-          const cpx = pxy.x
-          const cpy = pxy.y
-
-          const vb = zoomAtPoint(state.startVb, factor, cpx, cpy)
-          setCurVb(vb)
         }
       }
 
       const onPointerUpOrCancel = e => {
+        // Release PointerCapture to avoid event capture anomalies
+        if (svg.hasPointerCapture && svg.hasPointerCapture(e.pointerId)) {
+          svg.releasePointerCapture(e.pointerId)
+        }
         state.pointers.delete(e.pointerId)
         if (state.pointers.size === 0) {
           state.startVb = null
           state.startDist = 0
-          state.startCenter = null
-          wrap.__mermaidLastSinglePointer = null
         } else if (state.pointers.size === 1) {
-          // reset single pointer baseline to avoid jump
+          const p = state.pointers.values().next().value
-          wrap.__mermaidLastSinglePointer = [...state.pointers.values()][0]
+          state.lastPointerX = p.x
+          state.lastPointerY = p.y
         }
       }
 
-      // Wheel zoom (mouse/trackpad)
       const onWheel = e => {
-        // ctrlKey on mac trackpad pinch; we treat both as zoom
+        // Prevent event bubbling from triggering external scroll
         e.preventDefault()
-        const delta = e.deltaY
+        e.stopPropagation()
-        const zoomFactor = delta > 0 ? 1.1 : 0.9
+        // Normalize deltaY across deltaMode (Chrome uses pixels, Safari uses lines)
-        const { x, y } = clientToViewBox(e.clientX, e.clientY)
+        let delta = e.deltaY
-        const vb = (wrap.__mermaidCurViewBox || getSvgViewBox(svg)).slice()
+        if (e.deltaMode === 1) delta *= 16
-        setCurVb(zoomAtPoint(vb, zoomFactor, x, y))
+        else if (e.deltaMode === 2) delta *= 400
+
+        // Continuous zoom factor: smoother than fixed 1.1/0.9 steps
+        const zoomFactor = Math.pow(1.001, delta)
+
+        const curVb = wrap.__mermaidCurViewBox
+        const rect = getRect()
+        const px = curVb[0] + (e.clientX - rect.left) * (curVb[2] / rect.width)
+        const py = curVb[1] + (e.clientY - rect.top) * (curVb[3] / rect.height)
+        setCurVb(zoomAtPoint(curVb, zoomFactor, px, py))
       }
 
       const onDblClick = () => {
         const init = wrap.__mermaidInitViewBox
-        if (!init) return
+        if (init) setCurVb(init)
-        wrap.__mermaidCurViewBox = init.slice()
-        setSvgViewBox(svg, init)
       }
 
-      svg.addEventListener('pointerdown', onPointerDown)
+      svg.addEventListener('pointerdown', onPointerDown, { signal: ac.signal })
-      svg.addEventListener('pointermove', onPointerMove)
+      svg.addEventListener('pointermove', onPointerMove, { signal: ac.signal })
-      svg.addEventListener('pointerup', onPointerUpOrCancel)
+      svg.addEventListener('pointerup', onPointerUpOrCancel, { signal: ac.signal })
-      svg.addEventListener('pointercancel', onPointerUpOrCancel)
+      svg.addEventListener('pointercancel', onPointerUpOrCancel, { signal: ac.signal })
-      svg.addEventListener('wheel', onWheel, { passive: false })
+      svg.addEventListener('wheel', onWheel, { passive: false, signal: ac.signal })
-      svg.addEventListener('dblclick', onDblClick)
+      svg.addEventListener('dblclick', onDblClick, { signal: ac.signal })
     }
 
     const runMermaid = ele => {
       window.loadMermaid = true
       const theme = document.documentElement.getAttribute('data-theme') === 'dark' ? '!{theme.mermaid.theme.dark}' : '!{theme.mermaid.theme.light}'
-
       ele.forEach((item, index) => {
         const mermaidSrc = item.firstElementChild
-
+        // Clean up event listeners before removing old SVG
-        // Clear old render (themeChange/pjax will rerun)
+        if (item.__mermaidAbortController) {
+          item.__mermaidAbortController.abort()
+        }
         const oldSvg = item.querySelector('svg')
         if (oldSvg) oldSvg.remove()
-        item.__mermaidGestureBound = false
+        let config = {}
-
+        try {
-        const config = mermaidSrc.dataset.config ? JSON.parse(mermaidSrc.dataset.config) : {}
+          config = mermaidSrc.dataset.config ? JSON.parse(mermaidSrc.dataset.config) : {}
+        } catch (e) {
+          console.warn('[mermaid] failed to parse dataset.config:', e)
+        }
         if (!config.theme) {
           config.theme = theme
         }
@@ -278,7 +301,6 @@ script.
         const mermaidID = `mermaid-${index}`
         const mermaidDefinition = mermaidThemeConfig + mermaidSrc.textContent
 
-        const renderFn = mermaid.render(mermaidID, mermaidDefinition)
         const renderMermaid = svg => {
           mermaidSrc.insertAdjacentHTML('afterend', svg)
           if (!{theme.mermaid.zoom_pan}) initMermaidGestures(item)
@@ -286,14 +308,30 @@ script.
           if (!{theme.mermaid.open_in_new_tab}) attachMermaidViewerButton(item)
         }
 
+        const handleError = err => {
+          console.error(`[mermaid] render failed for block #${index}:`, err)
+          const errorEl = document.createElement('div')
+          errorEl.className = 'mermaid-error'
+          errorEl.textContent = `Mermaid render error: ${err.message || err}`
+          mermaidSrc.insertAdjacentElement('afterend', errorEl)
+        }
 
+        try {
+          const renderFn = mermaid.render(mermaidID, mermaidDefinition)
           // mermaid v9 and v10 compatibility
-        typeof renderFn === 'string' ? renderMermaid(renderFn) : renderFn.then(({ svg }) => renderMermaid(svg))
+          if (typeof renderFn === 'string') {
+            renderMermaid(renderFn)
+          } else {
+            renderFn.then(({ svg }) => renderMermaid(svg)).catch(handleError)
+          }
+        } catch (err) {
+          handleError(err)
+        }
       })
     }
 
-    const codeToMermaid = () => {
+    const codeToMermaid = $article => {
-      const codeMermaidEle = document.querySelectorAll('pre > code.mermaid')
+      const codeMermaidEle = $article.querySelectorAll('pre > code.mermaid')
       if (codeMermaidEle.length === 0) return
 
       codeMermaidEle.forEach(ele => {
@@ -309,8 +347,11 @@ script.
     }
 
     const loadMermaid = () => {
-      if (!{theme.mermaid.code_write}) codeToMermaid()
+      const $article = document.getElementById('article-container')
-      const $mermaid = document.querySelectorAll('#article-container .mermaid-wrap')
+      if (!$article) return
+
+      if (!{theme.mermaid.code_write}) codeToMermaid($article)
+      const $mermaid = $article.querySelectorAll('.mermaid-wrap')
       if ($mermaid.length === 0) return
 
       const runMermaidFn = () => runMermaid($mermaid)

layout/includes/third-party/pjax.pug

@@ -1,4 +1,4 @@
-- var pjaxExclude = 'a:not([target="_blank"])'
+- var pjaxExclude = 'a:not([target="_blank"]):not([data-fancybox])'
 if theme.pjax.exclude
   each val in theme.pjax.exclude
     - pjaxExclude += `:not([href="${val}"])`
@@ -53,8 +53,9 @@ script.
     document.addEventListener('pjax:complete', () => {
       btf.removeGlobalFnEvent('pjaxCompleteOnce')
       document.querySelectorAll('script[data-pjax]').forEach(item => {
+        if (!item.parentNode) return
         const newScript = document.createElement('script')
-        const content = item.text || item.textContent || item.innerHTML || ""
+        const content = item.text || item.textContent || ''
         Array.from(item.attributes).forEach(attr => newScript.setAttribute(attr.name, attr.value))
         newScript.appendChild(document.createTextNode(content))
         item.parentNode.replaceChild(newScript, item)
@@ -64,10 +65,13 @@ script.
     })
 
     document.addEventListener('pjax:error', e => {
-      if (e.request.status === 404) {
+      const responseURL = e.request && e.request.responseURL
+      if (e.request && e.request.status === 404) {
         !{theme.error_404 && theme.error_404.enable}
           ? pjax.loadUrl('!{url_for("/404.html")}')
-          : window.location.href = e.request.responseURL
+          : responseURL && (window.location.href = responseURL)
+      } else if (responseURL) {
+        window.location.href = responseURL
       }
     })
   })

layout/includes/third-party/prismjs.pug

@@ -5,11 +5,15 @@
 if (syntax_highlighter === 'prismjs' || enable) && !preprocess
   script.
     (() => {
+      const $article = document.getElementById('article-container')
+      if (!$article || $article.querySelector('.hbe-container')) return
+
       window.Prism = window.Prism || {}
       window.Prism.manual = true
 
       const highlightAll = () => {
-        window.Prism.highlightAll()
+        // window.Prism.highlightAll()
+        window.Prism.highlightAllUnder($article, true)
       }
 
       window.addEventListener('load', highlightAll)

layout/includes/third-party/subtitle.pug

@@ -1,5 +1,5 @@
 - const { effect, source, sub, typed_option } = theme.subtitle
-- let subContent = sub || new Array()
+- let subContent = typeof sub === 'string' ? [sub] : (sub || new Array())
 
 script.
   window.typedJSFn = {
@@ -44,7 +44,7 @@ script.
       }
     }
   }
-  btf.addGlobalFn('pjaxSendOnce', () => { typed.destroy() }, 'typedDestroy')
+  btf.addGlobalFn('pjaxSendOnce', () => { typed && typed.destroy() }, 'typedDestroy')
 
 case source
   when 1
@@ -53,8 +53,8 @@ case source
         fetch('https://v1.hitokoto.cn')
           .then(response => response.json())
           .then(data => {
-            const from = '出自 ' + data.from
+            const from = data.from ? '出自 ' + data.from : ''
-            typedJSFn.processSubtitle(data.hitokoto, [from])
+            typedJSFn.processSubtitle(data.hitokoto, from ? [from] : [])
           })
           .catch(err => {
             console.error('Failed to get the Hitokoto API:', err)
@@ -79,7 +79,7 @@ case source
           })
           .catch(err => {
             console.error('Failed to get the Yiyan API:', err)
-            typedJSFn.processSubtitle(!{JSON.stringify(subContent.length)})
+            typedJSFn.processSubtitle(!{JSON.stringify(subContent)})
           })
       }
       typedJSFn.run(subtitleType)
@@ -99,7 +99,7 @@ case source
           })
           .catch(err => {
             console.error('Failed to get the Jinrishici API:', err)
-            typedJSFn.processSubtitle(!{JSON.stringify(subContent.length)})
+            typedJSFn.processSubtitle(!{JSON.stringify(subContent)})
           })
       }
       typedJSFn.run(subtitleType)

layout/includes/third-party/umami_analytics.pug

@@ -28,21 +28,20 @@ script.
       })
     }
 
+    const extractValue = stat => (stat && typeof stat.value !== 'undefined') ? stat.value : stat
+
     const getData = async (isPost) => {
       try {
         const now = Date.now()
-        const keyUrl = isPost ? `&url=${window.location.pathname}&path=${window.location.pathname}` : ''
+        const pathQuery = isPost ? `&url=${window.location.pathname}&path=${window.location.pathname}` : ''
-        const headerList = { 'Accept': 'application/json' }
+        const headers = {
-
+          'Accept': 'application/json',
-        if (!{isServerURL}) {
+          [!{isServerURL} ? 'Authorization' : 'x-umami-api-key']: !{isServerURL} ? `Bearer ${config.token}` : config.token
-          headerList['Authorization'] = `Bearer ${config.token}`
-        } else {
-          headerList['x-umami-api-key'] = config.token
         }
 
-        const res = await fetch(`!{apiUrl}/websites/!{website_id}/stats?startAt=0000000000&endAt=${now}${keyUrl}`, {
+        const res = await fetch(`!{apiUrl}/websites/!{website_id}/stats?startAt=0000000000&endAt=${now}${pathQuery}`, {
-          method: "GET",
+          method: 'GET',
-          headers: headerList
+          headers
         })
 
         if (!res.ok) {
@@ -58,25 +57,30 @@ script.
 
     const insertData = async () => {
       try {
+        const tasks = []
+
         if (GLOBAL_CONFIG_SITE.pageType === 'post' && config.page_pv) {
+          tasks.push((async () => {
             const pagePV = document.getElementById('umamiPV')
             if (pagePV) {
               const data = await getData(true)
               if (data && data.pageviews) {
-              pagePV.textContent = typeof data.pageviews.value !== 'undefined' ? data.pageviews.value : data.pageviews
+                pagePV.textContent = extractValue(data.pageviews)
               } else {
                 console.warn('Umami Analytics: Invalid page view data received')
               }
             }
+          })())
         }
 
         if (config.site_uv || config.site_pv) {
+          tasks.push((async () => {
             const data = await getData(false)
 
             if (config.site_uv) {
               const siteUV = document.getElementById('umami-site-uv')
               if (siteUV && data && data.visitors) {
-              siteUV.textContent = typeof data.visitors.value !== 'undefined' ? data.visitors.value : data.visitors
+                siteUV.textContent = extractValue(data.visitors)
               } else if (siteUV) {
                 console.warn('Umami Analytics: Invalid site UV data received')
               }
@@ -85,12 +89,15 @@ script.
             if (config.site_pv) {
               const sitePV = document.getElementById('umami-site-pv')
               if (sitePV && data && data.pageviews) {
-              sitePV.textContent = typeof data.pageviews.value !== 'undefined' ? data.pageviews.value : data.pageviews
+                sitePV.textContent = extractValue(data.pageviews)
               } else if (sitePV) {
                 console.warn('Umami Analytics: Invalid site PV data received')
               }
             }
+          })())
         }
+
+        await Promise.all(tasks)
       } catch (error) {
         console.error('Umami Analytics: Failed to insert data', error)
       }
@@ -99,7 +106,6 @@ script.
     btf.addGlobalFn('pjaxComplete', runTrack, 'umami_analytics_run_track')
     btf.addGlobalFn('pjaxComplete', insertData, 'umami_analytics_insert')
 
-
     loadUmamiJS()
 
     if (document.readyState === 'loading') {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hexo-theme-butterfly",
-  "version": "5.5.4",
+  "version": "5.6.1",
   "description": "A Simple and Card UI Design theme for Hexo",
   "main": "package.json",
   "scripts": {
@@ -26,7 +26,7 @@
     "hexo-renderer-pug": "^3.0.0",
     "hexo-renderer-stylus": "^3.0.1",
     "hexo-util": "^4.0.0",
-    "moment-timezone": "^0.6.0"
+    "moment-timezone": "^0.6.2"
   },
   "homepage": "https://butterfly.js.org/",
   "author": "Jerry <my@crazywong.com>",

plugins.yml

@@ -1,7 +1,7 @@
 abcjs_basic_js:
   name: abcjs
   file: dist/abcjs-basic-min.js
-  version: 6.6.0
+  version: 6.6.4
 activate_power_mode:
   name: butterfly-extsrc
   file: dist/activate-power-mode.min.js
@@ -9,7 +9,7 @@ activate_power_mode:
 algolia_search:
   name: algoliasearch
   file: dist/lite/builds/browser.umd.js
-  version: 5.47.0
+  version: 5.56.0
 aplayer_css:
   name: aplayer
   file: dist/APlayer.min.css
@@ -66,12 +66,12 @@ docsearch_css:
   name: '@docsearch/css'
   other_name: docsearch-css
   file: dist/style.css
-  version: 4.5.3
+  version: 4.6.3
 docsearch_js:
   name: '@docsearch/js'
   other_name: docsearch-js
   file: dist/umd/index.js
-  version: 4.5.3
+  version: 4.6.3
 egjs_infinitegrid:
   name: '@egjs/infinitegrid'
   other_name: egjs-infinitegrid
@@ -80,12 +80,12 @@ egjs_infinitegrid:
 fancybox:
   name: '@fancyapps/ui'
   file: dist/fancybox/fancybox.umd.js
-  version: 6.1.9
+  version: 6.1.14
   other_name: fancyapps-ui
 fancybox_css:
   name: '@fancyapps/ui'
   file: dist/fancybox/fancybox.css
-  version: 6.1.9
+  version: 6.1.14
   other_name: fancyapps-ui
 fireworks:
   name: butterfly-extsrc
@@ -95,7 +95,7 @@ fontawesome:
   name: '@fortawesome/fontawesome-free'
   file: css/all.min.css
   other_name: font-awesome
-  version: 7.1.0
+  version: 7.3.1
 gitalk:
   name: gitalk
   file: dist/gitalk.min.js
@@ -112,12 +112,12 @@ katex:
   name: katex
   file: dist/katex.min.css
   other_name: KaTeX
-  version: 0.16.28
+  version: 0.17.0
 katex_copytex:
   name: katex
   file: dist/contrib/copy-tex.min.js
   other_name: KaTeX
-  version: 0.16.28
+  version: 0.17.0
 lazyload:
   name: vanilla-lazyload
   file: dist/lazyload.iife.min.js
@@ -125,7 +125,7 @@ lazyload:
 mathjax:
   name: mathjax
   file: tex-mml-chtml.js
-  version: 4.1.0
+  version: 4.1.3
 medium_zoom:
   name: medium-zoom
   file: dist/medium-zoom.min.js
@@ -133,7 +133,7 @@ medium_zoom:
 mermaid:
   name: mermaid
   file: dist/mermaid.min.js
-  version: 11.12.2
+  version: 11.16.0
 meting_js:
   name: butterfly-extsrc
   file: metingjs/dist/Meting.min.js
@@ -186,7 +186,7 @@ snackbar_css:
 twikoo:
   name: twikoo
   file: dist/twikoo.all.min.js
-  version: 1.6.44
+  version: 1.7.14
 typed:
   name: typed.js
   file: dist/typed.umd.js
@@ -199,9 +199,9 @@ waline_css:
   name: '@waline/client'
   file: dist/waline.css
   other_name: waline
-  version: 3.8.0
+  version: 3.15.2
 waline_js:
   name: '@waline/client'
   file: dist/waline.js
   other_name: waline
-  version: 3.8.0
+  version: 3.15.2

scripts/common/default_config.js

@@ -394,6 +394,9 @@ module.exports = {
   crisp: {
     website_id: null
   },
+  knocket: {
+    identifier: null
+  },
   google_tag_manager: {
     tag_id: null,
     domain: 'https://www.googletagmanager.com'

scripts/filters/post_lazyload.js

@@ -21,7 +21,7 @@ const lazyload = htmlContent => {
   // Handle src attributes with double quotes, single quotes, or no quotes (unified approach)
   // Matches: src="..." or src='...' or src=... (e.g., after minification by hexo-minify)
   return htmlContent.replace(/(<img(?![^>]*?\bdata-lazy-src=)(?:\s[^>]*?)?\ssrc=)(?:"([^"]*)"|'([^']*)'|([^\s>]+))(?![^<]*<\/script>)/gi, (match, prefix, srcDoubleQuote, srcSingleQuote, srcNoQuote) => {
-    const src = srcDoubleQuote || srcSingleQuote || srcNoQuote
+    const src = srcDoubleQuote ?? srcSingleQuote ?? srcNoQuote
     return `${prefix}"${bg}" data-lazy-src="${src}"`
   })
 }

scripts/filters/random_cover.js

@@ -6,33 +6,46 @@
 
 hexo.extend.generator.register('post', locals => {
   const imgTestReg = /\.(png|jpe?g|gif|svg|webp|avif)(\?.*)?$/i
+  const remoteImgReg = /^(?:https?:)?\/\//i
+  const dataImgReg = /^data:image\//i
+
   const { post_asset_folder: postAssetFolder } = hexo.config
   const { cover: { default_cover: defaultCover } } = hexo.theme.config
 
+  const isImage = value => {
+    return typeof value === 'string' &&
+      (remoteImgReg.test(value) || dataImgReg.test(value) || imgTestReg.test(value))
+  }
+
   function * createCoverGenerator () {
-    if (!defaultCover) {
+    if (!defaultCover || (Array.isArray(defaultCover) && defaultCover.length === 0)) {
       while (true) yield false
     }
+
     if (!Array.isArray(defaultCover)) {
       while (true) yield defaultCover
     }
 
-    const coverCount = defaultCover.length
+    if (defaultCover.length === 1) {
-    if (coverCount === 1) {
       while (true) yield defaultCover[0]
     }
 
+    const coverCount = defaultCover.length
     const maxHistory = Math.min(3, coverCount - 1)
     const history = []
 
     while (true) {
       let index
+
       do {
         index = Math.floor(Math.random() * coverCount)
       } while (history.includes(index))
 
       history.push(index)
-      if (history.length > maxHistory) history.shift()
+
+      if (history.length > maxHistory) {
+        history.shift()
+      }
 
       yield defaultCover[index]
     }
@@ -40,32 +53,31 @@ hexo.extend.generator.register('post', locals => {
 
   const coverGenerator = createCoverGenerator()
 
+  const resolvePostAsset = (value, postPath) => {
+    if (
+      !postAssetFolder ||
+      typeof value !== 'string' ||
+      value.includes('/') ||
+      !imgTestReg.test(value)
+    ) {
+      return value
+    }
+
+    return `${postPath}${value}`
+  }
+
   const handleImg = data => {
-    let { cover: coverVal, top_img: topImg, pagination_cover: paginationCover } = data
+    data.top_img = resolvePostAsset(data.top_img, data.path)
+    data.cover = resolvePostAsset(data.cover, data.path)
+    data.pagination_cover = resolvePostAsset(data.pagination_cover, data.path)
 
-    // Add path to top_img and cover if post_asset_folder is enabled
+    if (data.cover === false) return data
-    if (postAssetFolder) {
+
-      if (topImg && topImg.indexOf('/') === -1 && imgTestReg.test(topImg)) {
+    if (!data.cover) {
-        data.top_img = `${data.path}${topImg}`
+      data.cover = coverGenerator.next().value
-      }
-      if (coverVal && coverVal.indexOf('/') === -1 && imgTestReg.test(coverVal)) {
-        data.cover = `${data.path}${coverVal}`
-      }
-      if (paginationCover && paginationCover.indexOf('/') === -1 && imgTestReg.test(paginationCover)) {
-        data.pagination_cover = `${data.path}${paginationCover}`
-      }
     }
 
-    if (coverVal === false) return data
+    if (isImage(data.cover)) {
-
-    // If cover is not set, use random cover
-    if (!coverVal) {
-      const randomCover = coverGenerator.next().value
-      data.cover = randomCover
-      coverVal = randomCover
-    }
-
-    if (coverVal && (coverVal.indexOf('//') !== -1 || imgTestReg.test(coverVal))) {
       data.cover_type = 'img'
     }
 
@@ -75,16 +87,23 @@ hexo.extend.generator.register('post', locals => {
   const posts = locals.posts.sort('date').toArray()
   const { length } = posts
 
-  return posts.map((post, i) => {
+  return posts.map((post, index) => {
-    if (i) post.prev = posts[i - 1]
+    const data = post
-    if (i < length - 1) post.next = posts[i + 1]
 
-    post.__post = true
+    if (index > 0) {
+      data.prev = posts[index - 1]
+    }
+
+    if (index < length - 1) {
+      data.next = posts[index + 1]
+    }
+
+    data.__post = true
 
     return {
-      data: handleImg(post),
+      data: handleImg(data),
       layout: 'post',
-      path: post.path
+      path: data.path
     }
   })
 })

scripts/helpers/getArchiveLength.js

@@ -17,12 +17,11 @@ hexo.extend.helper.register('getArchiveLength', function () {
       const m = date.month() + 1
       const d = date.date()
 
-      if (yearly) {
+      // Always track year so year archive pages can be counted
       const keyYear = `${y}`
       map.set(keyYear, (map.get(keyYear) || 0) + 1)
-      }
 
-      if (monthly) {
+      if (monthly || daily) {
         const keyMonth = `${y}-${m}`
         map.set(keyMonth, (map.get(keyMonth) || 0) + 1)
       }
@@ -37,8 +36,8 @@ hexo.extend.helper.register('getArchiveLength', function () {
 
   // Determine the appropriate key to fetch based on current page context
   let key
-  if (yearly && year) key = `${year}`
+  if (yearly || monthly || daily) key = `${year}`
-  if (monthly && month) key = `${year}-${month}`
+  if ((monthly || daily) && month) key = `${year}-${month}`
   if (daily && day) key = `${year}-${month}-${day}`
 
   // Return the count for the current period or default to the total posts

scripts/helpers/inject_head_js.js

@@ -11,46 +11,87 @@ hexo.extend.helper.register('inject_head_js', function () {
   const createCustomJs = () => `
     const saveToLocal = {
       set: (key, value, ttl) => {
-        if (!ttl) return
+        const data = { value }
-        const expiry = Date.now() + ttl * 86400000
+
-        localStorage.setItem(key, JSON.stringify({ value, expiry }))
+        if (ttl != null) {
+          data.expiry = Date.now() + ttl * 86400000
+        }
+
+        localStorage.setItem(key, JSON.stringify(data))
       },
       get: key => {
         const itemStr = localStorage.getItem(key)
-        if (!itemStr) return undefined
+        if (!itemStr) return
-        const { value, expiry } = JSON.parse(itemStr)
+
-        if (Date.now() > expiry) {
+        try {
+          const data = JSON.parse(itemStr)
+
+          if (data.expiry && Date.now() > data.expiry) {
+            localStorage.removeItem(key)
+            return
+          }
+
+          return data.value
+        } catch {
           localStorage.removeItem(key)
-          return undefined
         }
-        return value
       }
     }
 
+    const scriptCache = new Map()
+    const cssCache = new Map()
     window.btf = {
       saveToLocal,
-      getScript: (url, attr = {}) => new Promise((resolve, reject) => {
+      getScript: (url, attr = {}) => {
+        if (scriptCache.has(url)) {
+          return scriptCache.get(url)
+        }
+
+        const promise = new Promise((resolve, reject) => {
           const script = document.createElement('script')
+
           script.src = url
           script.async = true
-        Object.entries(attr).forEach(([key, val]) => script.setAttribute(key, val))
+
-        script.onload = script.onreadystatechange = () => {
+          for (const key in attr) {
-          if (!script.readyState || /loaded|complete/.test(script.readyState)) resolve()
+            script.setAttribute(key, attr[key])
           }
+
+          script.onload = resolve
           script.onerror = reject
+
           document.head.appendChild(script)
-      }),
+        })
-      getCSS: (url, id) => new Promise((resolve, reject) => {
+
+        scriptCache.set(url, promise)
+
+        return promise
+      },
+      getCSS: (url, id) => {
+        if (cssCache.has(url)) {
+          return cssCache.get(url)
+        }
+
+        const promise = new Promise((resolve, reject) => {
           const link = document.createElement('link')
+
           link.rel = 'stylesheet'
           link.href = url
-        if (id) link.id = id
+
-        link.onload = link.onreadystatechange = () => {
+          if (id) {
-          if (!link.readyState || /loaded|complete/.test(link.readyState)) resolve()
+            link.id = id
           }
+
+          link.onload = resolve
           link.onerror = reject
+
           document.head.appendChild(link)
-      }),
+        })
+
+        cssCache.set(url, promise)
+
+        return promise
+      },
       addGlobalFn: (key, fn, name = false, parent = window) => {
         if (!${pjax.enable} && key.startsWith('pjax')) return
         const globalFn = parent.globalFn || {}
@@ -65,16 +106,17 @@ hexo.extend.helper.register('inject_head_js', function () {
     if (!darkmode.enable) return ''
 
     let darkmodeJs = `
+      const metaThemeColor = document.querySelector('meta[name="theme-color"]')
       const activateDarkMode = () => {
-        document.documentElement.setAttribute('data-theme', 'dark')
+        document.documentElement.dataset.theme = 'dark'
-        if (document.querySelector('meta[name="theme-color"]') !== null) {
+        if (metaThemeColor !== null) {
-          document.querySelector('meta[name="theme-color"]').setAttribute('content', '${themeColorDark}')
+          metaThemeColor.setAttribute('content', '${themeColorDark}')
         }
       }
       const activateLightMode = () => {
-        document.documentElement.setAttribute('data-theme', 'light')
+        document.documentElement.dataset.theme = 'light'
-        if (document.querySelector('meta[name="theme-color"]') !== null) {
+        if (metaThemeColor !== null) {
-          document.querySelector('meta[name="theme-color"]').setAttribute('content', '${themeColorLight}')
+          metaThemeColor.setAttribute('content', '${themeColorLight}')
         }
       }
 
@@ -95,10 +137,15 @@ hexo.extend.helper.register('inject_head_js', function () {
             else if (mediaQueryDark.matches) activateDarkMode()
             else {
               const hour = new Date().getHours()
-              const isNight = hour <= ${start} || hour >= ${end}
+              const start = ${start}
+              const end = ${end}
+              const isNight =
+                start < end
+                    ? hour < start || hour >= end
+                    : hour >= start || hour < end
               isNight ? activateDarkMode() : activateLightMode()
             }
-            mediaQueryDark.addEventListener('change', () => {
+            mediaQueryDark.addEventListener('change', e => {
               if (saveToLocal.get('theme') === undefined) {
                 e.matches ? activateDarkMode() : activateLightMode()
               }
@@ -111,7 +158,12 @@ hexo.extend.helper.register('inject_head_js', function () {
       case 2:
         darkmodeJs += `
           const hour = new Date().getHours()
-          const isNight = hour <= ${start} || hour >= ${end}
+          const start = ${start}
+          const end = ${end}
+          const isNight =
+            start < end
+                ? hour < start || hour >= end
+                : hour >= start || hour < end
           if (theme === undefined) isNight ? activateDarkMode() : activateLightMode()
           else theme === 'light' ? activateLightMode() : activateDarkMode()
         `

scripts/helpers/page.js

@@ -11,6 +11,8 @@ const colorPattern = /^(#|rgb|rgba|hsl|hsla)/i
 const simpleFilePattern = /\.(png|jpg|jpeg|gif|bmp|webp|svg|tiff)$/i
 const archiveRegex = /\/archives\//
 
+const { version: themeVersion } = require('../../package.json')
+
 hexo.extend.helper.register('truncate', truncateContent)
 
 hexo.extend.helper.register('postDesc', data => {
@@ -58,8 +60,6 @@ hexo.extend.helper.register('cloudTags', function (options = {}) {
 
   const userColors = normalizeColors(custom_colors)
 
-  const resolveColorClass = (idx) => `tag-color-${idx % userColors.length}`
-
   const generateStyle = (size, unit, page, color) => {
     const colorStyle = page === 'tags' ? `background-color: ${color};` : `color: ${color};`
     return `font-size: ${parseFloat(size.toFixed(2))}${unit}; ${colorStyle}`
@@ -70,10 +70,9 @@ hexo.extend.helper.register('cloudTags', function (options = {}) {
     const size = minfontsize + ((maxfontsize - minfontsize) * ratio)
 
     if (userColors && userColors.length) {
-      const colorClass = resolveColorClass(idx)
       const color = userColors[idx % userColors.length]
       const style = generateStyle(size, unit, page, color)
-      return `<a href="${env.url_for(tag.path)}" class="tag-cloud-item ${colorClass}" style="${style}">${tag.name}</a>`
+      return `<a href="${env.url_for(tag.path)}" class="tag-cloud-item" style="${style}">${tag.name}</a>`
     }
 
     const color = getRandomColor()
@@ -105,13 +104,13 @@ hexo.extend.helper.register('findArchivesTitle', function (page, menu, date) {
   if (!menu) return defaultTitle
 
   const loop = m => {
-    for (const key in m) {
+    for (const [key, value] of Object.entries(m)) {
-      if (typeof m[key] === 'object') {
+      if (value && typeof value === 'object') {
-        const result = loop(m[key])
+        const result = loop(value)
         if (result) return result
       }
 
-      if (archiveRegex.test(m[key])) {
+      if (typeof value === 'string' && archiveRegex.test(value)) {
         return key
       }
     }
@@ -154,9 +153,10 @@ hexo.extend.helper.register('shuoshuoFN', (data, page) => {
 
   // This is a hack method, because hexo treats time as UTC time
   // so you need to manually convert the time zone
+  const timezone = hexo.config.timezone
   processedData.forEach(item => {
-    const utcDate = moment.utc(item.date).format('YYYY-MM-DD HH:mm:ss')
+    const parsed = moment.utc(item.date)
-    item.date = moment.tz(utcDate, hexo.config.timezone).format('YYYY-MM-DD HH:mm:ss')
+    item.date = moment.tz(parsed.format('YYYY-MM-DD HH:mm:ss'), timezone).format('YYYY-MM-DD HH:mm:ss')
     // markdown
     item.content = hexo.render.renderSync({ text: item.content, engine: 'markdown' })
   })
@@ -171,7 +171,7 @@ hexo.extend.helper.register('getPageType', (page, isHome) => {
   if (category) return 'category'
   if (archive) return 'archive'
   if (type) {
-    if (type === 'tags' || type === 'categories') return type
+    if (type === 'tags' || type === 'categories' || type === '404') return type
     else return 'page'
   }
   if (isHome) return 'home'
@@ -179,8 +179,7 @@ hexo.extend.helper.register('getPageType', (page, isHome) => {
 })
 
 hexo.extend.helper.register('getVersion', () => {
-  const { version } = require('../../package.json')
+  return { hexo: hexo.version, theme: themeVersion }
-  return { hexo: hexo.version, theme: version }
 })
 
 hexo.extend.helper.register('safeJSON', data => {

scripts/helpers/related_post.js

@@ -23,7 +23,6 @@ hexo.extend.helper.register('related_posts', function (currentPost) {
       if (relatedPosts.has(post.path)) {
         relatedPosts.get(post.path).weight += 1
       } else {
-        const getPostDesc = post.postDesc || postDesc(post, hexo)
         relatedPosts.set(post.path, {
           title: post.title,
           path: post.path,
@@ -32,7 +31,7 @@ hexo.extend.helper.register('related_posts', function (currentPost) {
           weight: 1,
           updated: post.updated,
           created: post.date,
-          postDesc: getPostDesc,
+          post,
           random: Math.random()
         })
       }
@@ -61,12 +60,15 @@ hexo.extend.helper.register('related_posts', function (currentPost) {
   result += `<div class="headline"><i class="fas fa-thumbs-up fa-fw"></i><span>${headlineLang}</span></div>`
   result += '<div class="relatedPosts-list">'
 
-  for (let i = 0; i < Math.min(relatedPostsList.length, limitNum); i++) {
+  const max = Math.min(relatedPostsList.length, limitNum)
-    let { cover, title, path, cover_type, created, updated, postDesc } = relatedPostsList[i]
+  for (let i = 0; i < max; i++) {
+    const item = relatedPostsList[i]
+    let { cover, title, path, cover_type, created, updated, post } = item
     const { escape_html, url_for, date } = this
     cover = cover || 'var(--default-bg-color)'
     title = escape_html(title)
-    const className = postDesc ? 'pagination-related' : 'pagination-related no-desc'
+    const desc = post.postDesc || postDesc(post, hexo)
+    const className = desc ? 'pagination-related' : 'pagination-related no-desc'
     result += `<a class="${className}" href="${url_for(path)}" title="${title}">`
     if (cover_type === 'img') {
       result += `<img class="cover" src="${url_for(cover)}" alt="cover">`
@@ -80,8 +82,8 @@ hexo.extend.helper.register('related_posts', function (currentPost) {
     }
     result += `<div class="info-item-2">${title}</div></div>`
 
-    if (postDesc) {
+    if (desc) {
-      result += `<div class="info-2"><div class="info-item-1">${postDesc}</div></div>`
+      result += `<div class="info-2"><div class="info-item-1">${desc}</div></div>`
     }
     result += '</div></a>'
   }

scripts/helpers/series.js

@@ -1,22 +1,24 @@
 'use strict'
 
+// Read pre-built groups from tag/series.js (hexo._seriesGroups)
+// and sort each group according to the sidebar card config.
 hexo.extend.helper.register('groupPosts', function () {
-  const getGroupArray = array => {
+  const groups = hexo._seriesGroups || {}
-    return array.reduce((groups, item) => {
-      const key = item.series
-      if (key) {
-        groups[key] = groups[key] || []
-        groups[key].push(item)
-      }
-      return groups
-    }, {})
-  }
-
-  const sortPosts = posts => {
   const { orderBy = 'date', order = 1 } = this.theme.aside.card_post_series
-    if (orderBy === 'title') return posts.sort('title', order)
-    return posts.sort('date', order)
-  }
 
-  return getGroupArray(sortPosts(this.site.posts))
+  const result = {}
+  Object.keys(groups).forEach(key => {
+    const arr = groups[key].slice() // copy to avoid mutating the shared data
+    if (orderBy === 'title') {
+      arr.sort((a, b) => {
+        const cmp = a.title.toUpperCase().localeCompare(b.title.toUpperCase())
+        return order === 1 ? cmp : -cmp
+      })
+    } else {
+      arr.sort((a, b) => order === 1 ? a.date - b.date : b.date - a.date)
+    }
+    result[key] = arr
+  })
+
+  return result
 })

scripts/tag/button.js

@@ -7,15 +7,16 @@
 
 'use strict'
 
-const urlFor = require('hexo-util').url_for.bind(hexo)
+const { url_for, escapeHTML } = require('hexo-util')
+const urlFor = url_for.bind(hexo)
 
 const btn = args => {
   const [url = '', text = '', icon = '', option = ''] = args.join(' ').split(',').map(arg => arg.trim())
 
-  const iconHTML = icon ? `<i class="${icon}"></i>` : ''
+  const iconHTML = icon ? `<i class="${escapeHTML(icon)}"></i>` : ''
-  const textHTML = text ? `<span>${text}</span>` : ''
+  const textHTML = text ? `<span>${escapeHTML(text)}</span>` : ''
 
-  return `<a class="btn-beautify ${option}" href="${urlFor(url)}" title="${text}">${iconHTML}${textHTML}</a>`
+  return `<a class="btn-beautify ${escapeHTML(option)}" href="${urlFor(url)}" title="${escapeHTML(text)}">${iconHTML}${textHTML}</a>`
 }
 
 hexo.extend.tag.register('btn', btn, { ends: false })

scripts/tag/flink.js

@@ -4,24 +4,25 @@
 
 'use strict'
 
-const urlFor = require('hexo-util').url_for.bind(hexo)
+const { url_for, escapeHTML } = require('hexo-util')
+const urlFor = url_for.bind(hexo)
 
 const flinkFn = (args, content) => {
   const data = hexo.render.renderSync({ text: content, engine: 'yaml' })
   let result = ''
 
   data.forEach(item => {
-    const className = item.class_name ? `<div class="flink-name">${item.class_name}</div>` : ''
+    const className = item.class_name ? `<div class="flink-name">${escapeHTML(item.class_name)}</div>` : ''
-    const classDesc = item.class_desc ? `<div class="flink-desc">${item.class_desc}</div>` : ''
+    const classDesc = item.class_desc ? `<div class="flink-desc">${escapeHTML(item.class_desc)}</div>` : ''
 
     const listResult = item.link_list.map(link => `
       <div class="flink-list-item">
-        <a href="${link.link}" title="${link.name}" target="_blank">
+        <a href="${escapeHTML(link.link)}" title="${escapeHTML(link.name)}" target="_blank">
           <div class="flink-item-icon">
-            <img class="no-lightbox" src="${link.avatar}" onerror='this.onerror=null;this.src="${urlFor(hexo.theme.config.error_img.flink)}"' alt="${link.name}" />
+            <img class="no-lightbox" src="${escapeHTML(link.avatar)}" onerror='this.onerror=null;this.src="${urlFor(hexo.theme.config.error_img.flink)}"' alt="${escapeHTML(link.name)}" />
           </div>
-          <div class="flink-item-name">${link.name}</div>
+          <div class="flink-item-name">${escapeHTML(link.name)}</div>
-          <div class="flink-item-desc" title="${link.descr}">${link.descr}</div>
+          <div class="flink-item-desc" title="${escapeHTML(link.descr)}">${escapeHTML(link.descr)}</div>
         </a>
       </div>`).join('')
 

scripts/tag/gallery.js

@@ -27,6 +27,7 @@ const parseGalleryArgs = args => {
 const parseImageContent = content => {
   const images = []
   let match
+  IMAGE_REGEX.lastIndex = 0
 
   while ((match = IMAGE_REGEX.exec(content)) !== null) {
     images.push({

scripts/tag/hide.js

@@ -16,7 +16,7 @@
 
 'use strict'
 
-const parseArgs = args => args.join(' ').split(',')
+const parseArgs = args => args.join(' ').split(',').map(s => s.trim())
 
 const generateStyle = (bg, color) => {
   let style = 'style="'

scripts/tag/score.js

@@ -5,20 +5,10 @@
 
 'use strict'
 
+const { escapeHTML } = require('hexo-util')
+
 const score = (args, content) => {
-  // Escape HTML tags and some special characters, including curly braces
+  const escapeHtmlTags = s => escapeHTML(s).replace(/[{}]/g, c => c === '{' ? '{' : '}')
-  const escapeHtmlTags = s => {
-    const lookup = {
-      '&': '&',
-      '"': '"',
-      "'": ''',
-      '<': '&lt;',
-      '>': '&gt;',
-      '{': '&#123;',
-      '}': '&#125;'
-    }
-    return s.replace(/[&"'<>{}]/g, c => lookup[c])
-  }
 
   const trimmed = content.trim()
   // Split content using six dashes as a delimiter

scripts/tag/series.js

@@ -10,23 +10,42 @@
 'use strict'
 
 const urlFor = require('hexo-util').url_for.bind(hexo)
-const groups = {}
 
-hexo.extend.filter.register('before_post_render', data => {
+// Iterate all posts once and group by series name.
-  if (!hexo.theme.config.series.enable) return data
+// Result is stored on hexo._seriesGroups, shared by both tag and helper.
-
+function buildSeriesGroups () {
-  const { layout, series } = data
+  const groups = {}
-  if (layout === 'post' && series) {
+  const posts = hexo.model('Post').toArray()
-    if (!groups[series]) groups[series] = []
+  for (let i = 0, len = posts.length; i < len; i++) {
-    groups[series].push({
+    const p = posts[i]
-      title: data.title,
+    if (p.series) {
-      path: data.path,
+      if (!groups[p.series]) groups[p.series] = []
-      date: data.date.unix()
+      groups[p.series].push({
+        title: p.title,
+        path: p.path,
+        date: p.date.unix()
       })
     }
+  }
+  return groups
+}
+
+// Build once before the first render (hexo generate / hexo server initial load).
+// before_generate runs after tag rendering, so we need this as a fallback.
+hexo.extend.filter.register('before_post_render', data => {
+  if (!hexo.theme.config.series.enable) return data
+  if (!hexo._seriesGroups) {
+    hexo._seriesGroups = buildSeriesGroups()
+  }
   return data
 })
 
+// Rebuild after each generate cycle in hexo server to reflect latest post data.
+hexo.extend.filter.register('before_generate', () => {
+  if (!hexo.theme.config.series.enable) return
+  hexo._seriesGroups = buildSeriesGroups()
+})
+
 function series (args) {
   const { series } = hexo.theme.config
   if (!series.enable) {
@@ -34,24 +53,30 @@ function series (args) {
     return ''
   }
 
-  const seriesArr = args.length ? groups[args[0]] : groups[this.series]
+  const groupName = args.length ? args[0] : this.series
 
-  if (!seriesArr) {
+  if (!groupName) {
-    hexo.log.warn(`There is no series named "${args[0]}"`)
+    hexo.log.warn('No series specified')
     return ''
   }
 
-  const isAsc = (series.order || 1) === 1 // 1: asc, -1: desc
+  const groups = hexo._seriesGroups || {}
-  const isSortByTitle = series.orderBy === 'title'
+  const source = groups[groupName]
 
-  const compareFn = (a, b) => {
+  if (!source || !source.length) {
-    const itemA = isSortByTitle ? a.title.toUpperCase() : a.date
+    hexo.log.warn(`There is no series named "${groupName}"`)
-    const itemB = isSortByTitle ? b.title.toUpperCase() : b.date
+    return ''
-
-    return itemA < itemB ? (isAsc ? -1 : 1) : itemA > itemB ? (isAsc ? 1 : -1) : 0
   }
 
-  seriesArr.sort(compareFn)
+  const isAsc = (series.order || 1) === 1
+  const isSortByTitle = series.orderBy === 'title'
+
+  // .slice() to copy before sorting, so we don't mutate the shared data
+  const seriesArr = source.slice().sort((a, b) => {
+    const itemA = isSortByTitle ? a.title.toUpperCase() : a.date
+    const itemB = isSortByTitle ? b.title.toUpperCase() : b.date
+    return itemA < itemB ? (isAsc ? -1 : 1) : itemA > itemB ? (isAsc ? 1 : -1) : 0
+  })
 
   const listItems = seriesArr.map(ele =>
     `<li><a href="${urlFor(ele.path)}" title="${ele.title}">${ele.title}</a></li>`

source/css/_layout/pagination.styl

@@ -39,7 +39,7 @@
   .pagination
     & > *
       display: inline-block
-      margin: 0 6px
+      margin: 6px
       width: w = 2.5em
       height: w
       line-height: w

source/css/_layout/third-party.styl

@@ -226,5 +226,6 @@ if hexo-config('math.use')
     opacity: 1
 
 +maxWidth768()
-  .fancybox__toolbar__column.is-middle
+  .fancybox__toolbar__column.is-middle,
-    display: none
+  .f-carousel__toolbar__column.is-middle
+    visibility: hidden

source/js/main.js

@@ -2,18 +2,25 @@ document.addEventListener('DOMContentLoaded', () => {
   let headerContentWidth, $nav
   let mobileSidebarOpen = false
 
+  // rightsideScrollPercent
+  let goUpElement = null
+  let scrollPercentElement = null
+
   const adjustMenu = init => {
-    const getAllWidth = ele => Array.from(ele).reduce((width, i) => width + i.offsetWidth, 0)
+    let hideMenuIndex = false
 
     if (init) {
-      const blogInfoWidth = getAllWidth(document.querySelector('#blog-info > a').children)
+      const blogInfoWidth = Array.from(document.querySelector('#blog-info > a').children).reduce((w, i) => w + i.offsetWidth, 0)
-      const menusWidth = getAllWidth(document.getElementById('menus').children)
+      const menusWidth = Array.from(document.getElementById('menus').children).reduce((w, i) => w + i.offsetWidth, 0)
       headerContentWidth = blogInfoWidth + menusWidth
       $nav = document.getElementById('nav')
     }
 
-    const hideMenuIndex = window.innerWidth <= 768 || headerContentWidth > $nav.offsetWidth - 120
+    hideMenuIndex = window.innerWidth <= 768 || headerContentWidth > $nav.offsetWidth - 120
+
+    requestAnimationFrame(() => {
       $nav.classList.toggle('hide-menu', hideMenuIndex)
+    })
   }
 
   // 初始化header
@@ -54,7 +61,7 @@ document.addEventListener('DOMContentLoaded', () => {
    * 代碼
    * 只適用於Hexo默認的代碼渲染
    */
-  const addHighlightTool = () => {
+  const addHighlightTool = $article => {
     const highLight = GLOBAL_CONFIG.highlight
     if (!highLight) return
 
@@ -64,8 +71,8 @@ document.addEventListener('DOMContentLoaded', () => {
     const isNotHighlightJs = plugin !== 'highlight.js'
     const isPrismjs = plugin === 'prismjs'
     const $figureHighlight = isNotHighlightJs
-      ? Array.from(document.querySelectorAll('code[class*="language-"]')).map(code => code.parentElement)
+      ? Array.from($article.querySelectorAll('code[class*="language-"]')).map(code => code.parentElement)
-      : document.querySelectorAll('figure.highlight')
+      : $article.querySelectorAll('figure.highlight')
 
     if (!((isShowTool || highlightHeightLimit) && $figureHighlight.length)) return
 
@@ -167,33 +174,23 @@ document.addEventListener('DOMContentLoaded', () => {
     // 獲取隱藏狀態下元素的真實高度
     const getActualHeight = item => {
       if (item.offsetHeight > 0) return item.offsetHeight
-      const hiddenElements = new Map()
 
-      const fix = () => {
+      const clone = item.cloneNode(true)
-        let current = item
-        while (current !== document.body && current != null) {
-          if (window.getComputedStyle(current).display === 'none') {
-            hiddenElements.set(current, current.getAttribute('style') || '')
-          }
-          current = current.parentNode
-        }
 
-        const style = 'visibility: hidden !important; display: block !important;'
+      clone.style.cssText = `
-        hiddenElements.forEach((originalStyle, elem) => {
+        position: absolute !important;
-          elem.setAttribute('style', originalStyle ? originalStyle + ';' + style : style)
+        visibility: hidden !important;
-        })
+        display: block !important;
-      }
+        left: 0 !important;
+        top: 0 !important;
+        pointer-events: none !important;
+        z-index: -1 !important;
+        margin: 0 !important;
+      `
 
-      const restore = () => {
+      item.parentNode.insertBefore(clone, item)
-        hiddenElements.forEach((originalStyle, elem) => {
+      const height = clone.offsetHeight
-          if (originalStyle === '') elem.removeAttribute('style')
+      clone.remove()
-          else elem.setAttribute('style', originalStyle)
-        })
-      }
-
-      fix()
-      const height = item.offsetHeight
-      restore()
       return height
     }
 
@@ -244,9 +241,9 @@ document.addEventListener('DOMContentLoaded', () => {
   /**
    * PhotoFigcaption
    */
-  const addPhotoFigcaption = () => {
+  const addPhotoFigcaption = $article => {
     if (!GLOBAL_CONFIG.isPhotoFigcaption) return
-    document.querySelectorAll('#article-container img').forEach(item => {
+    $article.querySelectorAll('img').forEach(item => {
       const altValue = item.title || item.alt
       if (!altValue) return
       const ele = document.createElement('div')
@@ -259,8 +256,8 @@ document.addEventListener('DOMContentLoaded', () => {
   /**
    * Lightbox
    */
-  const runLightbox = () => {
+  const runLightbox = $article => {
-    btf.loadLightbox(document.querySelectorAll('#article-container img:not(.no-lightbox)'))
+    btf.loadLightbox($article.querySelectorAll('img:not(.no-lightbox)'))
   }
 
   /**
@@ -270,18 +267,23 @@ document.addEventListener('DOMContentLoaded', () => {
   const fetchUrl = async url => {
     try {
       const response = await fetch(url)
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
       return await response.json()
     } catch (error) {
       console.error('Failed to fetch URL:', error)
-      return []
+      throw error
     }
   }
 
   const runJustifiedGallery = (container, data, config) => {
-    const { isButton, limit, firstLimit, tabs } = config
+    const { isButton, tabs } = config
+    const limit = Math.max(1, Number(config.limit) || 20)
+    const firstLimit = Math.max(1, Number(config.firstLimit) || limit)
 
     const dataLength = data.length
-    const maxGroupKey = Math.ceil((dataLength - firstLimit) / limit + 1)
+    const maxGroupKey = dataLength
+      ? Math.ceil(Math.max(0, dataLength - firstLimit) / limit) + 1
+      : 0
 
     // Gallery configuration
     const igConfig = {
@@ -298,13 +300,19 @@ document.addEventListener('DOMContentLoaded', () => {
     let isLayoutHidden = false
 
     // Utility functions
-    const sanitizeString = str => (str && str.replace(/"/g, '&quot;')) || ''
+    const sanitizeString = str => String(str ?? '')
+      .replace(/&/g, '&amp;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#39;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
 
     const createImageItem = item => {
       const alt = item.alt ? `alt="${sanitizeString(item.alt)}"` : ''
       const title = item.title ? `title="${sanitizeString(item.title)}"` : ''
+      const url = item.url ? sanitizeString(item.url) : ''
       return `<div class="item">
-        <img src="${item.url}" data-grid-maintained-target="true" ${alt} ${title} />
+        <img src="${url}" data-grid-maintained-target="true" ${alt} ${title} />
       </div>`
     }
 
@@ -373,11 +381,13 @@ document.addEventListener('DOMContentLoaded', () => {
     btf.setLoading.add(container)
     ig.on('renderComplete', handleRenderComplete)
 
-    if (isButton) {
+    if (isButton && dataLength) {
       appendItems(1, firstLimit, true)
-    } else {
+    } else if (dataLength) {
       ig.on('requestAppend', handleRequestAppend)
       ig.renderItems()
+    } else {
+      btf.setLoading.remove(container)
     }
 
     btf.addGlobalFn('pjaxSendOnce', () => ig.destroy())
@@ -400,11 +410,11 @@ document.addEventListener('DOMContentLoaded', () => {
         const container = element.firstElementChild
         const content = container.textContent
         container.textContent = ''
-        element.classList.add('loaded')
-
         try {
           const data = element.getAttribute('data-type') === 'url' ? await fetchUrl(content) : JSON.parse(content)
+          if (!Array.isArray(data)) throw new TypeError('Gallery data must be an array')
           runJustifiedGallery(container, data, config)
+          element.classList.add('loaded')
         } catch (error) {
           console.error('Gallery data parsing failed:', error)
         }
@@ -424,11 +434,11 @@ document.addEventListener('DOMContentLoaded', () => {
    */
   const rightsideScrollPercent = currentTop => {
     const scrollPercent = btf.getScrollPercent(currentTop, document.body)
-    const goUpElement = document.getElementById('go-up')
 
+    if (!goUpElement || !scrollPercentElement) return
     if (scrollPercent < 95) {
       goUpElement.classList.add('show-percent')
-      goUpElement.querySelector('.scroll-percent').textContent = scrollPercent
+      scrollPercentElement.textContent = scrollPercent
     } else {
       goUpElement.classList.remove('show-percent')
     }
@@ -439,24 +449,20 @@ document.addEventListener('DOMContentLoaded', () => {
    */
   const scrollFn = () => {
     const $rightside = document.getElementById('rightside')
-    const innerHeight = window.innerHeight + 56
     let initTop = 0
     const $header = document.getElementById('page-header')
-    const isChatBtn = typeof chatBtn !== 'undefined'
+    const isChatBtn = typeof window.chatBtn !== 'undefined'
     const isShowPercent = GLOBAL_CONFIG.percent.rightside
 
     // 檢查文檔高度是否小於視窗高度
     const checkDocumentHeight = () => {
-      if (document.body.scrollHeight <= innerHeight) {
+      if (document.body.scrollHeight <= window.innerHeight + 56) {
         $rightside.classList.add('rightside-show')
         return true
       }
       return false
     }
 
-    // 如果文檔高度小於視窗高度,直接返回
-    if (checkDocumentHeight()) return
-
     // find the scroll direction
     const scrollDirection = currentTop => {
       const result = currentTop > initTop // true is down & false is up
@@ -465,7 +471,9 @@ document.addEventListener('DOMContentLoaded', () => {
     }
 
     let flag = ''
-    const scrollTask = btf.throttle(() => {
+    const scrollTask = btf.rafThrottle(() => {
+      if (checkDocumentHeight()) return
+
       const currentTop = window.scrollY || document.documentElement.scrollTop
       const isDown = scrollDirection(currentTop)
       if (currentTop > 56) {
@@ -496,19 +504,18 @@ document.addEventListener('DOMContentLoaded', () => {
       }
 
       isShowPercent && rightsideScrollPercent(currentTop)
-      checkDocumentHeight()
+    })
-    }, 300)
 
+    checkDocumentHeight()
     btf.addEventListenerPjax(window, 'scroll', scrollTask, { passive: true })
   }
 
   /**
-  * toc,anchor
+  * toc, anchor
   */
-  const scrollFnToDo = () => {
+  const scrollFnToDo = $article => {
     const isToc = GLOBAL_CONFIG_SITE.isToc
     const isAnchor = GLOBAL_CONFIG.isAnchor
-    const $article = document.getElementById('article-container')
 
     if (!($article && (isToc || isAnchor))) return
 
@@ -521,7 +528,6 @@ document.addEventListener('DOMContentLoaded', () => {
       $tocPercentage = $cardTocLayout.querySelector('.toc-percentage')
       isExpand = $cardToc.classList.contains('is-expand')
 
-      // toc元素點擊
       const tocItemClickFn = e => {
         const target = e.target.closest('.toc-link')
         if (!target) return
@@ -548,94 +554,105 @@ document.addEventListener('DOMContentLoaded', () => {
         }
       }
 
-      // 處理 hexo-blog-encrypt 事件
       $cardToc.style.display = 'block'
     }
 
-    // find head position & add active class
     const $articleList = $article.querySelectorAll('h1,h2,h3,h4,h5,h6')
-    let detectItem = ''
+    if (!$articleList.length) return
 
-    // Optimization: Cache header positions
+    let activeTocItem = null
-    let headerList = []
+    let activeParentItems = []
-    const updateHeaderPositions = () => {
+
-      headerList = Array.from($articleList).map(ele => ({
+    const updateTocUI = currentId => {
-        ele,
+      const encodedAnchor = currentId ? '#' + encodeURI(decodeURI(currentId)) : ''
-        top: btf.getEleTop(ele),
+      if (isAnchor) btf.updateAnchor(encodedAnchor)
-        id: ele.id
+
-      }))
+      if (!isToc) return
+
+      if (activeTocItem) activeTocItem.classList.remove('active')
+      activeParentItems.forEach(i => i.classList.remove('active'))
+      activeParentItems = []
+
+      if (!currentId) {
+        activeTocItem = null
+        return
       }
 
-    updateHeaderPositions()
+      const targetLink = Array.from($tocLink).find(link => {
-    btf.addEventListenerPjax(window, 'resize', btf.throttle(updateHeaderPositions, 200))
+        const href = link.getAttribute('href')
+        if (!href) return false
+        return decodeURI(href).replace('#', '') === decodeURI(currentId)
+      })
 
-    const findHeadPosition = top => {
+      if (!targetLink) return
-      if (top === 0) return false
 
-      let currentId = ''
+      targetLink.classList.add('active')
-      let currentIndex = ''
+      activeTocItem = targetLink
-
+      setTimeout(() => autoScrollToc(targetLink), 0)
-      for (let i = 0; i < headerList.length; i++) {
-        const item = headerList[i]
-        if (top > item.top - 80) {
-          currentId = item.id ? '#' + encodeURI(item.id) : ''
-          currentIndex = i
-        } else {
-          break
-        }
-      }
-
-      if (detectItem === currentIndex) return
-
-      if (isAnchor) btf.updateAnchor(currentId)
-
-      detectItem = currentIndex
-
-      if (isToc) {
-        $cardToc.querySelectorAll('.active').forEach(i => i.classList.remove('active'))
-
-        if (currentId) {
-          const currentActive = $tocLink[currentIndex]
-          currentActive.classList.add('active')
-
-          setTimeout(() => autoScrollToc(currentActive), 0)
 
       if (!isExpand) {
-            let parent = currentActive.parentNode
+        let parent = targetLink.parentNode
         while (!parent.matches('.toc')) {
-              if (parent.matches('li')) parent.classList.add('active')
+          if (parent.matches('li')) {
+            parent.classList.add('active')
+            activeParentItems.push(parent)
+          }
           parent = parent.parentNode
         }
       }
     }
-      }
+
+    const observerOptions = {
+      root: null,
+      rootMargin: '-60px 0px -80% 0px',
+      threshold: 0
     }
 
-    // main of scroll
+    const observer = new IntersectionObserver(entries => {
-    const tocScrollFn = btf.throttle(() => {
+      entries.forEach(entry => {
+        if (entry.isIntersecting) {
+          updateTocUI(entry.target.id)
+        }
+      })
+    }, observerOptions)
+
+    $articleList.forEach(ele => observer.observe(ele))
+
+    const scrollHandler = btf.rafThrottle(() => {
       const currentTop = window.scrollY || document.documentElement.scrollTop
+
       if (isToc && GLOBAL_CONFIG.percent.toc) {
         $tocPercentage.textContent = btf.getScrollPercent(currentTop, $article)
       }
-      findHeadPosition(currentTop)
-    }, 100)
 
-    btf.addEventListenerPjax(window, 'scroll', tocScrollFn, { passive: true })
+      if (currentTop === 0) {
+        updateTocUI('')
+      } else if (currentTop + window.innerHeight >= document.documentElement.scrollHeight - 10) {
+        const lastHeader = $articleList[$articleList.length - 1]
+        updateTocUI(lastHeader.id)
+      }
+    })
+
+    btf.addEventListenerPjax(window, 'scroll', scrollHandler, { passive: true })
+
+    btf.addGlobalFn('pjaxSendOnce', () => {
+      observer.disconnect()
+    })
   }
 
   const handleThemeChange = mode => {
     const globalFn = window.globalFn || {}
-    const themeChange = globalFn.themeChange || {}
+    const themeChange = globalFn.themeChange
-    if (!themeChange) {
+    if (!themeChange) return
-      return
-    }
 
     Object.keys(themeChange).forEach(key => {
-      const themeChangeFn = themeChange[key]
+      const fn = themeChange[key]
+      if (typeof fn !== 'function') return
+
       if (['disqus', 'disqusjs'].includes(key)) {
-        setTimeout(() => themeChangeFn(mode), 300)
+        setTimeout(() => fn(mode), 300)
       } else {
-        themeChangeFn(mode)
+        fn(mode)
       }
     })
   }
@@ -797,8 +814,8 @@ document.addEventListener('DOMContentLoaded', () => {
   /**
    * table overflow
    */
-  const addTableWrap = () => {
+  const addTableWrap = $article => {
-    const $table = document.querySelectorAll('#article-container table')
+    const $table = $article.querySelectorAll('table')
     if (!$table.length) return
 
     $table.forEach(item => {
@@ -808,52 +825,54 @@ document.addEventListener('DOMContentLoaded', () => {
     })
   }
 
-  /**
+  const clickFnOfTagHide = $article => {
-   * tag-hide
+    const hideButtons = $article.querySelectorAll('.hide-button')
-   */
-  const clickFnOfTagHide = () => {
-    const hideButtons = document.querySelectorAll('#article-container .hide-button')
     if (!hideButtons.length) return
-    hideButtons.forEach(item => item.addEventListener('click', e => {
+
-      const currentTarget = e.currentTarget
+    const handleClickOfTagHide = e => {
-      currentTarget.classList.add('open')
+      const button = e.target.closest('.hide-button')
-      addJustifiedGallery(currentTarget.nextElementSibling.querySelectorAll('.gallery-container'))
+      if (!button) return
-    }, { once: true }))
+      button.classList.add('open')
+      addJustifiedGallery(button.nextElementSibling.querySelectorAll('.gallery-container'))
     }
 
-  const tabsFn = () => {
+    btf.addEventListenerPjax($article, 'click', handleClickOfTagHide)
-    const navTabsElements = document.querySelectorAll('#article-container .tabs')
+  }
-    if (!navTabsElements.length) return
+
+  const tabsFn = $article => {
+    if (!$article.querySelector('.tabs')) return
 
     const setActiveClass = (elements, activeIndex) => {
-      elements.forEach((el, index) => {
+      elements.forEach((el, index) => el.classList.toggle('active', index === activeIndex))
-        el.classList.toggle('active', index === activeIndex)
-      })
     }
 
-    const handleNavClick = e => {
+    const handleClick = e => {
+      const tabsRoot = e.target.closest('.tabs')
+      if (!tabsRoot) return
+
+      const navContainer = tabsRoot.firstElementChild
+      const toTopContainer = tabsRoot.lastElementChild
+
+      if (navContainer.contains(e.target)) {
         const target = e.target.closest('button')
         if (!target || target.classList.contains('active')) return
 
-      const navItems = [...e.currentTarget.children]
+        const navItems = [...navContainer.children]
-      const tabContents = [...e.currentTarget.nextElementSibling.children]
+        const tabContents = [...navContainer.nextElementSibling.children]
         const indexOfButton = navItems.indexOf(target)
         setActiveClass(navItems, indexOfButton)
-      e.currentTarget.classList.remove('no-default')
+        navContainer.classList.remove('no-default')
         setActiveClass(tabContents, indexOfButton)
         addJustifiedGallery(tabContents[indexOfButton].querySelectorAll('.gallery-container'), true)
+        return
       }
 
-    const handleToTopClick = tabElement => e => {
+      if (toTopContainer.contains(e.target) && e.target.closest('button')) {
-      if (e.target.closest('button')) {
+        btf.scrollToDest(btf.getEleTop(tabsRoot), 300)
-        btf.scrollToDest(btf.getEleTop(tabElement), 300)
       }
     }
 
-    navTabsElements.forEach(tabElement => {
+    btf.addEventListenerPjax($article, 'click', handleClick)
-      btf.addEventListenerPjax(tabElement.firstElementChild, 'click', handleNavClick)
-      btf.addEventListenerPjax(tabElement.lastElementChild, 'click', handleToTopClick(tabElement))
-    })
   }
 
   const toggleCardCategory = () => {
@@ -919,10 +938,13 @@ document.addEventListener('DOMContentLoaded', () => {
   }
 
   const unRefreshFn = () => {
-    window.addEventListener('resize', () => {
+    const resizeHandler = btf.rafThrottle(() => {
       adjustMenu(false)
-      mobileSidebarOpen && btf.isHidden(document.getElementById('toggle-menu')) && sidebarFn.close()
+      if (mobileSidebarOpen && btf.isHidden(document.getElementById('toggle-menu'))) {
+        sidebarFn.close()
+      }
     })
+    window.addEventListener('resize', resizeHandler, { passive: true })
 
     const menuMask = document.getElementById('menu-mask')
     menuMask && menuMask.addEventListener('click', () => { sidebarFn.close() })
@@ -940,18 +962,24 @@ document.addEventListener('DOMContentLoaded', () => {
   }
 
   const forPostFn = () => {
-    addHighlightTool()
+    const $article = document.getElementById('article-container')
-    addPhotoFigcaption()
+    if (!$article || $article.querySelector('.hbe-container')) return
-    addJustifiedGallery(document.querySelectorAll('#article-container .gallery-container'))
+
-    runLightbox()
+    addHighlightTool($article)
-    scrollFnToDo()
+    addPhotoFigcaption($article)
-    addTableWrap()
+    addJustifiedGallery($article.querySelectorAll('.gallery-container'))
-    clickFnOfTagHide()
+    runLightbox($article)
-    tabsFn()
+    scrollFnToDo($article)
+    addTableWrap($article)
+    clickFnOfTagHide($article)
+    tabsFn($article)
   }
 
   const refreshFn = () => {
     initAdjust()
+    goUpElement = document.getElementById('go-up')
+    scrollPercentElement = goUpElement?.querySelector('.scroll-percent')
+
     justifiedIndexPostUI()
 
     if (GLOBAL_CONFIG_SITE.pageType === 'post') {

source/js/search/algolia.js

@@ -6,8 +6,28 @@ window.addEventListener('load', () => {
     return console.error('Algolia setting is invalid!')
   }
 
+  const CONTENT_FIELDS = ['contentStripTruncate', 'contentStrip', 'content']
+  const HIGHLIGHT_PARAMS = {
+    highlightPreTag: '<mark>',
+    highlightPostTag: '</mark>',
+    attributesToHighlight: ['title', 'content', 'contentStrip', 'contentStripTruncate']
+  }
+
+  // Pre-compiled regex for tag balancing (reused across cutContent calls)
+  const TAG_REGEX = /<\/?([a-zA-Z][a-zA-Z0-9]*)[^>]*\/?>/g
+
   const $searchMask = document.getElementById('search-mask')
   const $searchDialog = document.querySelector('#algolia-search .search-dialog')
+  const $loadingStatus = document.getElementById('loading-status')
+  const $hits = document.getElementById('algolia-hits')
+  const $hitsEmpty = document.getElementById('algolia-hits-empty')
+  const $hitsList = document.querySelector('#algolia-hits .ais-Hits-list')
+  const $hitsWrapper = document.querySelector('#algolia-hits .ais-Hits')
+  const $pagination = document.getElementById('algolia-pagination')
+  const $paginationList = document.querySelector('#algolia-pagination .ais-Pagination-list')
+  const $stats = document.querySelector('#algolia-info .ais-Stats-text')
+  const $searchInput = document.querySelector('#algolia-search-input .ais-SearchBox-input')
+  const $searchForm = document.querySelector('#algolia-search-input .ais-SearchBox-form')
 
   const animateElements = show => {
     const action = show ? 'animateIn' : 'animateOut'
@@ -23,15 +43,12 @@ window.addEventListener('load', () => {
     }
   }
 
-  const openSearch = () => {
+  // Debounced resize to avoid layout thrashing
-    btf.overflowPaddingR.add()
+  let resizeTimer
-    animateElements(true)
+  const onResize = () => {
-    showLoading(false)
+    clearTimeout(resizeTimer)
-
+    resizeTimer = setTimeout(fixSafariHeight, 150)
-    setTimeout(() => {
+  }
-      const searchInput = document.querySelector('#algolia-search-input .ais-SearchBox-input')
-      if (searchInput) searchInput.focus()
-    }, 100)
 
   const handleEscape = event => {
     if (event.code === 'Escape') {
@@ -40,15 +57,29 @@ window.addEventListener('load', () => {
     }
   }
 
+  const showLoading = show => {
+    if ($loadingStatus) $loadingStatus.hidden = !show
+  }
+
+  const openSearch = () => {
+    btf.overflowPaddingR.add()
+    animateElements(true)
+    showLoading(false)
+
+    setTimeout(() => {
+      if ($searchInput) $searchInput.focus()
+    }, 100)
+
     document.addEventListener('keydown', handleEscape)
     fixSafariHeight()
-    window.addEventListener('resize', fixSafariHeight)
+    window.addEventListener('resize', onResize)
   }
 
   const closeSearch = () => {
     btf.overflowPaddingR.remove()
     animateElements(false)
-    window.removeEventListener('resize', fixSafariHeight)
+    document.removeEventListener('keydown', handleEscape)
+    window.removeEventListener('resize', onResize)
   }
 
   const searchClickFn = () => {
@@ -60,37 +91,40 @@ window.addEventListener('load', () => {
     document.querySelector('#algolia-search .search-close-button').addEventListener('click', closeSearch)
   }
 
-  const cutContent = content => {
+  const extractContentStr = content => {
     if (!content) return ''
-
+    if (typeof content === 'string') return content.trim()
-    let contentStr = ''
+    if (typeof content === 'object') {
-    if (typeof content === 'string') {
-      contentStr = content.trim()
-    } else if (typeof content === 'object') {
       if (content.value !== undefined) {
-        contentStr = String(content.value).trim()
+        const str = String(content.value).trim()
-        if (!contentStr) return ''
+        return str || ''
-      } else if (content.matchedWords || content.matchLevel || content.fullyHighlighted !== undefined) {
+      }
-        return ''
+      if (content.matchedWords || content.matchLevel || content.fullyHighlighted !== undefined) return ''
-      } else {
       try {
-          contentStr = JSON.stringify(content).trim()
+        const str = JSON.stringify(content).trim()
-          if (contentStr === '{}' || contentStr === '[]' || contentStr === '""') {
+        return (str === '{}' || str === '[]' || str === '""') ? '' : str
+      } catch (e) { return '' }
+    }
+    if (content.toString && typeof content.toString === 'function') {
+      const str = content.toString().trim()
+      return (str === '[object Object]' || str === '[object Array]') ? '' : str
+    }
     return ''
   }
-        } catch (e) {
+
-          return ''
+  const extractHighlightValue = highlightObj => {
-        }
+    if (!highlightObj) return ''
-      }
+    if (typeof highlightObj === 'string') return highlightObj.trim()
-    } else if (content.toString && typeof content.toString === 'function') {
+    if (typeof highlightObj === 'object' && highlightObj.value !== undefined) {
-      contentStr = content.toString().trim()
+      return String(highlightObj.value).trim()
-      if (contentStr === '[object Object]' || contentStr === '[object Array]') {
+    }
-        return ''
-      }
-    } else {
     return ''
   }
 
+  const cutContent = content => {
+    const contentStr = extractContentStr(content)
+    if (!contentStr) return ''
+
     const firstOccur = contentStr.indexOf('<mark>')
     let start = firstOccur - 30
     let end = firstOccur + 120
@@ -110,112 +144,67 @@ window.addEventListener('load', () => {
       post = '...'
     }
 
-    // Ensure we don't cut off HTML tags in the middle
     let substr = contentStr.substring(start, end)
 
-    // Handle tag completeness
+    // Remove incomplete tags at boundaries
-    // Check for incomplete opening tags at the beginning
     const firstCloseBracket = substr.indexOf('>')
     const firstOpenBracket = substr.indexOf('<')
-
-    // If there's a closing bracket but no opening bracket before it, we've cut a tag
     if (firstCloseBracket !== -1 && (firstOpenBracket === -1 || firstCloseBracket < firstOpenBracket)) {
       substr = substr.substring(firstCloseBracket + 1)
     }
 
-    // Check for incomplete closing tags at the end
     const lastOpenBracket = substr.lastIndexOf('<')
     const lastCloseBracket = substr.lastIndexOf('>')
-
-    // If there's an opening bracket after the last closing bracket, we've cut a tag
     if (lastOpenBracket !== -1 && lastOpenBracket > lastCloseBracket) {
       substr = substr.substring(0, lastOpenBracket)
     }
 
-    // Balance tags in the substring
+    // Balance tags using regex
     const tagStack = []
     let balancedStr = ''
-    let i = 0
+    let lastIndex = 0
+    let match
 
-    while (i < substr.length) {
+    TAG_REGEX.lastIndex = 0
-      if (substr[i] === '<') {
+    while ((match = TAG_REGEX.exec(substr)) !== null) {
-        // Check if it's a closing tag
+      const fullTag = match[0]
-        if (substr[i + 1] === '/') {
+      const tagName = match[1]
-          const closeTagEnd = substr.indexOf('>', i)
+      const tagStart = match.index
-          if (closeTagEnd !== -1) {
+
-            const closeTagName = substr.substring(i + 2, closeTagEnd)
+      // Append text before this tag
-            // Remove matching opening tag from stack
+      balancedStr += substr.substring(lastIndex, tagStart)
-            for (let j = tagStack.length - 1; j >= 0; j--) {
+
-              if (tagStack[j] === closeTagName) {
+      if (fullTag.startsWith('</')) {
-                tagStack.splice(j, 1)
+        // Closing tag - remove matching opening tag from stack
-                break
+        const idx = tagStack.lastIndexOf(tagName)
-              }
+        if (idx !== -1) tagStack.splice(idx, 1)
-            }
+      } else if (!fullTag.endsWith('/>') && !fullTag.startsWith('<!')) {
-            balancedStr += substr.substring(i, closeTagEnd + 1)
+        // Opening tag (not self-closing or comment)
-            i = closeTagEnd + 1
-            continue
-          }
-        } else if (substr.substr(i, 2) === '<!' || (substr.indexOf('/>', i) !== -1 && substr.indexOf('/>', i) < substr.indexOf('>', i))) {
-          const tagEnd = substr.indexOf('>', i)
-          if (tagEnd !== -1) {
-            balancedStr += substr.substring(i, tagEnd + 1)
-            i = tagEnd + 1
-            continue
-          }
-        } else {
-          const tagEnd = substr.indexOf('>', i)
-          if (tagEnd !== -1) {
-            const tagName = substr.substring(i + 1, (substr.indexOf(' ', i) > -1 && substr.indexOf(' ', i) < tagEnd)
-              ? substr.indexOf(' ', i)
-              : tagEnd).split(/\s/)[0]
         tagStack.push(tagName)
-            balancedStr += substr.substring(i, tagEnd + 1)
-            i = tagEnd + 1
-            continue
       }
+      balancedStr += fullTag
+      lastIndex = tagStart + fullTag.length
     }
-      }
+    balancedStr += substr.substring(lastIndex)
-      balancedStr += substr[i]
+
-      i++
+    // Close unclosed tags
+    for (let i = tagStack.length - 1; i >= 0; i--) {
+      balancedStr += `</${tagStack[i]}>`
     }
 
-    // Close any unclosed tags
+    // Check if we cut a mark tag at the beginning
-    while (tagStack.length > 0) {
-      const tagName = tagStack.pop()
-      balancedStr += `</${tagName}>`
-    }
-
-    // If we removed content from the beginning, add prefix
     if (start > 0 || pre) {
-      const actualFirstOpenBracket = contentStr.indexOf('<', start > 0 ? start - 30 : 0)
+      const checkStart = Math.max(0, start - 30)
-      const actualFirstMark = contentStr.indexOf('<mark>', start > 0 ? start - 30 : 0)
+      const actualFirstOpenBracket = contentStr.indexOf('<', checkStart)
-
+      const actualFirstMark = contentStr.indexOf('<mark>', checkStart)
-      if (actualFirstOpenBracket !== -1 &&
+      if (actualFirstOpenBracket !== -1 && (actualFirstMark === -1 || actualFirstOpenBracket < actualFirstMark)) {
-          (actualFirstMark === -1 || actualFirstOpenBracket < actualFirstMark)) {
         pre = '...'
       }
     }
 
-    substr = balancedStr
+    return `${pre}${balancedStr}${post}`
-    return `${pre}${substr}${post}`
   }
 
-  // Helper function to handle Algolia highlight results
-  const extractHighlightValue = highlightObj => {
-    if (!highlightObj) return ''
-
-    if (typeof highlightObj === 'string') {
-      return highlightObj.trim()
-    }
-
-    if (typeof highlightObj === 'object' && highlightObj.value !== undefined) {
-      return String(highlightObj.value).trim()
-    }
-
-    return ''
-  }
-
-  // Initialize Algolia client
   let searchClient
 
   if (window['algoliasearch/lite'] && typeof window['algoliasearch/lite'].liteClient === 'function') {
@@ -230,96 +219,52 @@ window.addEventListener('load', () => {
     return console.error('Failed to initialize Algolia search client')
   }
 
-  // Search state
   let currentQuery = ''
+  let searchRequestId = 0 // Race condition guard
 
-  // Show loading state
-  const showLoading = show => {
-    const loadingIndicator = document.getElementById('loading-status')
-    if (loadingIndicator) {
-      loadingIndicator.hidden = !show
-    }
-  }
-
-  // Cache frequently used elements
-  const elements = {
-    get searchInput () { return document.querySelector('#algolia-search-input .ais-SearchBox-input') },
-    get hits () { return document.getElementById('algolia-hits') },
-    get hitsEmpty () { return document.getElementById('algolia-hits-empty') },
-    get hitsList () { return document.querySelector('#algolia-hits .ais-Hits-list') },
-    get hitsWrapper () { return document.querySelector('#algolia-hits .ais-Hits') },
-    get pagination () { return document.getElementById('algolia-pagination') },
-    get paginationList () { return document.querySelector('#algolia-pagination .ais-Pagination-list') },
-    get stats () { return document.querySelector('#algolia-info .ais-Stats-text') },
-  }
-
-  // Show/hide search results area
   const toggleResultsVisibility = hasResults => {
-    elements.pagination.style.display = hasResults ? '' : 'none'
+    $pagination.style.display = hasResults ? '' : 'none'
-    elements.stats.style.display = hasResults ? '' : 'none'
+    $stats.style.display = hasResults ? '' : 'none'
   }
 
-  // Render search results
   const renderHits = (hits, query, page = 0) => {
     if (hits.length === 0 && query) {
-      elements.hitsEmpty.textContent = languages.hits_empty.replace(/\$\{query}/, query)
+      $hitsEmpty.textContent = languages.hits_empty.replace(/\$\{query}/, query)
-      elements.hitsEmpty.style.display = ''
+      $hitsEmpty.style.display = ''
-      elements.hitsWrapper.style.display = 'none'
+      $hitsWrapper.style.display = 'none'
-      elements.stats.style.display = 'none'
+      $stats.style.display = 'none'
       return
     }
 
-    elements.hitsEmpty.style.display = 'none'
+    $hitsEmpty.style.display = 'none'
 
     const hitsHTML = hits.map((hit, index) => {
       const itemNumber = page * hitsPerPage + index + 1
       const link = hit.permalink || (GLOBAL_CONFIG.root + hit.path)
       const result = hit._highlightResult || hit
 
-      // Content extraction
+      // Content extraction - try highlight result first, then raw hit
       let content = ''
-      try {
+      for (const field of CONTENT_FIELDS) {
-        if (result.contentStripTruncate) {
+        if (result[field]) { content = cutContent(result[field]); break }
-          content = cutContent(result.contentStripTruncate)
+        if (hit[field]) { content = cutContent(hit[field]); break }
-        } else if (result.contentStrip) {
-          content = cutContent(result.contentStrip)
-        } else if (result.content) {
-          content = cutContent(result.content)
-        } else if (hit.contentStripTruncate) {
-          content = cutContent(hit.contentStripTruncate)
-        } else if (hit.contentStrip) {
-          content = cutContent(hit.contentStrip)
-        } else if (hit.content) {
-          content = cutContent(hit.content)
-        }
-      } catch (error) {
-        content = ''
       }
 
-      // Title handling
+      // Title handling - try highlight result first, then raw hit
       let title = 'no-title'
-      try {
+      const titleSource = result.title || hit.title
-        if (result.title) {
+      if (titleSource) {
-          title = extractHighlightValue(result.title) || 'no-title'
+        title = extractHighlightValue(titleSource) || 'no-title'
-        } else if (hit.title) {
-          title = extractHighlightValue(hit.title) || 'no-title'
       }
-
+      if (title === 'no-title') {
-        if (!title || title === 'no-title') {
         if (typeof hit.title === 'string' && hit.title.trim()) {
           title = hit.title.trim()
-          } else if (hit.title && typeof hit.title === 'object' && hit.title.value) {
+        } else if (hit.title?.value) {
           title = String(hit.title.value).trim() || 'no-title'
-          } else {
-            title = 'no-title'
         }
       }
-      } catch (error) {
-        title = 'no-title'
-      }
 
-      return `
+      return `<li class="ais-Hits-item" value="${itemNumber}">
-        <li class="ais-Hits-item" value="${itemNumber}">
           <a href="${link}" class="algolia-hit-item-link">
             <span class="algolia-hits-item-title">${title}</span>
             ${content ? `<div class="algolia-hit-item-content">${content}</div>` : ''}
@@ -327,24 +272,21 @@ window.addEventListener('load', () => {
         </li>`
     }).join('')
 
-    elements.hitsList.innerHTML = hitsHTML
+    $hitsList.innerHTML = hitsHTML
-    elements.hitsWrapper.style.display = query ? '' : 'none'
+    $hitsWrapper.style.display = query ? '' : 'none'
 
     if (hits.length > 0) {
-      elements.stats.style.display = ''
+      $stats.style.display = ''
     }
   }
 
-  // Render pagination
   const renderPagination = (page, nbPages) => {
     if (nbPages <= 1) {
-      elements.pagination.style.display = 'none'
+      $pagination.style.display = 'none'
-      elements.paginationList.innerHTML = ''
+      $paginationList.innerHTML = ''
       return
     }
 
-    elements.pagination.style.display = 'block'
-
     const isFirstPage = page === 0
     const isLastPage = page === nbPages - 1
 
@@ -359,90 +301,63 @@ window.addEventListener('load', () => {
       startPage = Math.max(0, endPage - maxVisiblePages + 1)
     }
 
-    let pagesHTML = ''
+    const parts = []
 
     // Only add ellipsis and first page when there are many pages
     if (nbPages > maxVisiblePages && startPage > 0) {
-      pagesHTML += `
+      parts.push('<li class="ais-Pagination-item ais-Pagination-item--page"><a class="ais-Pagination-link" aria-label="Page 1" href="#" data-page="0">1</a></li>')
-        <li class="ais-Pagination-item ais-Pagination-item--page">
-          <a class="ais-Pagination-link" aria-label="Page 1" href="#" data-page="0">1</a>
-        </li>`
       if (startPage > 1) {
-        pagesHTML += `
+        parts.push('<li class="ais-Pagination-item ais-Pagination-item--ellipsis"><span class="ais-Pagination-link">...</span></li>')
-          <li class="ais-Pagination-item ais-Pagination-item--ellipsis">
-            <span class="ais-Pagination-link">...</span>
-          </li>`
       }
     }
 
     // Add middle page numbers
     for (let i = startPage; i <= endPage; i++) {
-      const isSelected = i === page
+      if (i === page) {
-      if (isSelected) {
+        parts.push(`<li class="ais-Pagination-item ais-Pagination-item--page ais-Pagination-item--selected"><span class="ais-Pagination-link" aria-label="Page ${i + 1}">${i + 1}</span></li>`)
-        pagesHTML += `
-          <li class="ais-Pagination-item ais-Pagination-item--page ais-Pagination-item--selected">
-            <span class="ais-Pagination-link" aria-label="Page ${i + 1}">${i + 1}</span>
-          </li>`
       } else {
-        pagesHTML += `
+        parts.push(`<li class="ais-Pagination-item ais-Pagination-item--page"><a class="ais-Pagination-link" aria-label="Page ${i + 1}" href="#" data-page="${i}">${i + 1}</a></li>`)
-          <li class="ais-Pagination-item ais-Pagination-item--page">
-            <a class="ais-Pagination-link" aria-label="Page ${i + 1}" href="#" data-page="${i}">${i + 1}</a>
-          </li>`
       }
     }
 
     // Only add ellipsis and last page when there are many pages
     if (nbPages > maxVisiblePages && endPage < nbPages - 1) {
       if (endPage < nbPages - 2) {
-        pagesHTML += `
+        parts.push('<li class="ais-Pagination-item ais-Pagination-item--ellipsis"><span class="ais-Pagination-link">...</span></li>')
-          <li class="ais-Pagination-item ais-Pagination-item--ellipsis">
-            <span class="ais-Pagination-link">...</span>
-          </li>`
       }
-      pagesHTML += `
+      parts.push(`<li class="ais-Pagination-item ais-Pagination-item--page"><a class="ais-Pagination-link" aria-label="Page ${nbPages}" href="#" data-page="${nbPages - 1}">${nbPages}</a></li>`)
-        <li class="ais-Pagination-item ais-Pagination-item--page">
-          <a class="ais-Pagination-link" aria-label="Page ${nbPages}" href="#" data-page="${nbPages - 1}">${nbPages}</a>
-        </li>`
     }
 
-    if (nbPages > 1) {
+    // Build prev/next links
-      elements.paginationList.innerHTML = `
+    const prevLink = isFirstPage
-            <li class="ais-Pagination-item ais-Pagination-item--previousPage ${isFirstPage ? 'ais-Pagination-item--disabled' : ''}">
-              ${isFirstPage
       ? '<span class="ais-Pagination-link ais-Pagination-link--disabled" aria-label="Previous Page"><i class="fas fa-angle-left"></i></span>'
       : `<a class="ais-Pagination-link" aria-label="Previous Page" href="#" data-page="${page - 1}"><i class="fas fa-angle-left"></i></a>`
-              }
+    const nextLink = isLastPage
-            </li>
-            ${pagesHTML}
-            <li class="ais-Pagination-item ais-Pagination-item--nextPage ${isLastPage ? 'ais-Pagination-item--disabled' : ''}">
-              ${isLastPage
       ? '<span class="ais-Pagination-link ais-Pagination-link--disabled" aria-label="Next Page"><i class="fas fa-angle-right"></i></span>'
       : `<a class="ais-Pagination-link" aria-label="Next Page" href="#" data-page="${page + 1}"><i class="fas fa-angle-right"></i></a>`
-              }
+
-            </li>`
+    $paginationList.innerHTML = `<li class="ais-Pagination-item ais-Pagination-item--previousPage ${isFirstPage ? 'ais-Pagination-item--disabled' : ''}">${prevLink}</li>${parts.join('')}<li class="ais-Pagination-item ais-Pagination-item--nextPage ${isLastPage ? 'ais-Pagination-item--disabled' : ''}">${nextLink}</li>`
-      elements.pagination.style.display = currentQuery ? '' : 'none'
+    $pagination.style.display = currentQuery ? '' : 'none'
-    } else {
-      elements.pagination.style.display = 'none'
-    }
   }
 
-  // Render statistics
   const renderStats = (nbHits, processingTimeMS, query) => {
     if (query) {
       const stats = languages.hits_stats
         .replace(/\$\{hits}/, nbHits)
         .replace(/\$\{time}/, processingTimeMS)
-      elements.stats.innerHTML = `<hr>${stats}`
+      $stats.innerHTML = `<hr>${stats}`
-      elements.stats.style.display = ''
+      $stats.style.display = ''
     } else {
-      elements.stats.style.display = 'none'
+      $stats.style.display = 'none'
     }
   }
 
-  // Perform search
   const performSearch = async (query, page = 0) => {
-    if (!query.trim()) {
+    const trimmedQuery = query.trim()
+
+    if (!trimmedQuery) {
       currentQuery = ''
+      searchRequestId++
       renderHits([], '', 0)
       renderPagination(0, 0)
       renderStats(0, 0, '')
@@ -451,7 +366,8 @@ window.addEventListener('load', () => {
     }
 
     showLoading(true)
-    currentQuery = query
+    currentQuery = trimmedQuery
+    const requestId = ++searchRequestId
 
     try {
       let result
@@ -460,82 +376,76 @@ window.addEventListener('load', () => {
         // v5 multi-index search
         const searchResult = await searchClient.search([{
           indexName,
-          query,
+          query: trimmedQuery,
-          params: {
+          params: { page, hitsPerPage, ...HIGHLIGHT_PARAMS }
-            page,
-            hitsPerPage,
-            highlightPreTag: '<mark>',
-            highlightPostTag: '</mark>',
-            attributesToHighlight: ['title', 'content', 'contentStrip', 'contentStripTruncate']
-          }
         }])
         result = searchResult.results[0]
       } else if (searchClient && typeof searchClient.initIndex === 'function') {
         // v4 single-index search
         const index = searchClient.initIndex(indexName)
-        result = await index.search(query, {
+        result = await index.search(trimmedQuery, { page, hitsPerPage, ...HIGHLIGHT_PARAMS })
-          page,
-          hitsPerPage,
-          highlightPreTag: '<mark>',
-          highlightPostTag: '</mark>',
-          attributesToHighlight: ['title', 'content', 'contentStrip', 'contentStripTruncate']
-        })
       } else {
         throw new Error('Algolia: No compatible search method available')
       }
 
-      renderHits(result.hits || [], query, page)
+      // Discard stale results from superseded searches
+      if (requestId !== searchRequestId) return
+
+      renderHits(result.hits || [], trimmedQuery, page)
 
       const actualNbPages = result.nbHits <= hitsPerPage ? 1 : (result.nbPages || 0)
       renderPagination(page, actualNbPages)
-      renderStats(result.nbHits || 0, result.processingTimeMS || 0, query)
+      renderStats(result.nbHits || 0, result.processingTimeMS || 0, trimmedQuery)
 
       const hasResults = result.hits && result.hits.length > 0
       toggleResultsVisibility(hasResults)
 
       // Refresh Pjax links
       if (window.pjax) {
-        window.pjax.refresh(document.getElementById('algolia-hits'))
+        window.pjax.refresh($hits)
       }
     } catch (error) {
+      if (requestId !== searchRequestId) return
       console.error('Algolia search error:', error)
-      renderHits([], query, page)
+      renderHits([], trimmedQuery, page)
       renderPagination(0, 0)
-      renderStats(0, 0, query)
+      renderStats(0, 0, trimmedQuery)
     } finally {
+      if (requestId === searchRequestId) {
         showLoading(false)
       }
     }
+  }
 
-  // Debounced search
   let searchTimeout
   const debouncedSearch = (query, delay = 300) => {
     clearTimeout(searchTimeout)
+    // Empty query: clear results immediately without debounce delay
+    if (!query.trim()) {
+      performSearch(query)
+      return
+    }
     searchTimeout = setTimeout(() => performSearch(query), delay)
   }
 
-  // Initialize search box and events
   const initializeSearch = () => {
     showLoading(false)
 
-    if (elements.searchInput) {
+    if ($searchInput) {
-      elements.searchInput.addEventListener('input', e => {
+      $searchInput.addEventListener('input', e => {
-        const query = e.target.value
+        debouncedSearch(e.target.value)
-        debouncedSearch(query)
       })
     }
 
-    const searchForm = document.querySelector('#algolia-search-input .ais-SearchBox-form')
+    if ($searchForm) {
-    if (searchForm) {
+      $searchForm.addEventListener('submit', e => {
-      searchForm.addEventListener('submit', e => {
         e.preventDefault()
-        const query = elements.searchInput.value
+        performSearch($searchInput ? $searchInput.value : '')
-        performSearch(query)
       })
     }
 
     // Pagination event delegation
-    elements.pagination.addEventListener('click', e => {
+    $pagination.addEventListener('click', e => {
       e.preventDefault()
       const link = e.target.closest('a[data-page]')
       if (link) {
@@ -550,7 +460,6 @@ window.addEventListener('load', () => {
     toggleResultsVisibility(false)
   }
 
-  // Initialize
   initializeSearch()
   searchClickFn()
   searchFnOnce()

source/js/search/local-search.js

@@ -15,31 +15,39 @@ class LocalSearch {
     this.top_n_per_article = top_n_per_article
     this.isfetched = false
     this.datas = null
+    this._unescapeDiv = unescape ? document.createElement('div') : null
+    this._processedKeywords = null
+  }
+
+  _processKeywords (keywords) {
+    if (this._processedKeywords) return this._processedKeywords
+    this._processedKeywords = keywords.map(word => {
+      if (this.unescape) {
+        this._unescapeDiv.innerText = word
+        return this._unescapeDiv.innerHTML
+      }
+      return word
+    })
+    return this._processedKeywords
   }
 
   getIndexByWord (words, text, caseSensitive = false) {
     const index = []
     const included = new Set()
+    const processedWords = this._processKeywords(words)
 
     if (!caseSensitive) {
       text = text.toLowerCase()
     }
-    words.forEach(word => {
+    processedWords.forEach((word, i) => {
-      if (this.unescape) {
-        const div = document.createElement('div')
-        div.innerText = word
-        word = div.innerHTML
-      }
       const wordLen = word.length
       if (wordLen === 0) return
       let startPosition = 0
       let position = -1
-      if (!caseSensitive) {
+      const searchWord = caseSensitive ? word : word.toLowerCase()
-        word = word.toLowerCase()
+      while ((position = text.indexOf(searchWord, startPosition)) > -1) {
-      }
-      while ((position = text.indexOf(word, startPosition)) > -1) {
         index.push({ position, word })
-        included.add(word)
+        included.add(words[i])
         startPosition = position + wordLen
       }
     })
@@ -90,19 +98,22 @@ class LocalSearch {
 
   // Highlight title and content
   highlightKeyword (val, slice) {
-    let result = ''
+    const parts = []
     let index = slice.start
     for (const { position, length } of slice.hits) {
-      result += val.substring(index, position)
+      parts.push(val.substring(index, position))
       index = position + length
-      result += `<mark class="search-keyword">${val.substr(position, length)}</mark>`
+      parts.push(`<mark class="search-keyword">${val.substring(position, position + length)}</mark>`)
     }
-    result += val.substring(index, slice.end)
+    parts.push(val.substring(index, slice.end))
-    return result
+    return parts.join('')
   }
 
   getResultItems (keywords) {
     const resultItems = []
+    this._processedKeywords = null
+    // Compute highlight param once instead of per-article
+    const highlightParam = keywords.join(' ')
     this.datas.forEach(({ title, content, url }) => {
       // The number of different keywords included in the article.
       const [indexOfTitle, keysOfTitle] = this.getIndexByWord(keywords, title)
@@ -147,7 +158,7 @@ class LocalSearch {
       let resultItem = ''
 
       url = new URL(url, location.origin)
-      url.searchParams.append('highlight', keywords.join(' '))
+      url.searchParams.append('highlight', highlightParam)
 
       if (slicesOfTitle.length !== 0) {
         resultItem += `<li class="local-search-hit-item"><a href="${url.href}"><span class="search-result-title">${this.highlightKeyword(title, slicesOfTitle[0])}</span>`
@@ -173,7 +184,10 @@ class LocalSearch {
   fetchData () {
     const isXml = !this.path.endsWith('json')
     fetch(this.path)
-      .then(response => response.text())
+      .then(response => {
+        if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`)
+        return response.text()
+      })
       .then(res => {
         // Get the contents from search data
         this.isfetched = true
@@ -194,6 +208,12 @@ class LocalSearch {
         // Remove loading animation
         window.dispatchEvent(new Event('search:loaded'))
       })
+      .catch(error => {
+        console.error('Local search data fetch failed:', error)
+        this.isfetched = true
+        this.datas = []
+        window.dispatchEvent(new Event('search:loaded'))
+      })
   }
 
   // Highlight by wrapping node in mark elements with the given class name
@@ -206,7 +226,7 @@ class LocalSearch {
       index = position + length
       const mark = document.createElement('mark')
       mark.className = className
-      mark.appendChild(document.createTextNode(val.substr(position, length)))
+      mark.appendChild(document.createTextNode(val.substring(position, position + length)))
       children.push(text, mark)
     }
     node.nodeValue = val.substring(index, slice.end)
@@ -235,7 +255,7 @@ class LocalSearch {
 }
 
 window.addEventListener('load', () => {
-// Search
+  // Search
   const { path, top_n_per_article, unescape, languages, pagination } = GLOBAL_CONFIG.localSearch
   const enablePagination = pagination && pagination.enable
   const localSearch = new LocalSearch({
@@ -244,9 +264,14 @@ window.addEventListener('load', () => {
     unescape
   })
 
-  const input = document.querySelector('.local-search-input input')
+  const $input = document.querySelector('.local-search-input input')
-  const statsItem = document.getElementById('local-search-stats')
+  const $statsItem = document.getElementById('local-search-stats')
   const $loadingStatus = document.getElementById('loading-status')
+  const $searchMask = document.getElementById('search-mask')
+  const $searchDialog = document.querySelector('#local-search .search-dialog')
+  const $results = document.getElementById('local-search-results')
+  const $pagination = document.getElementById('local-search-pagination')
+  const $paginationList = document.querySelector('#local-search-pagination .ais-Pagination-list')
   const isXml = !path.endsWith('json')
 
   // Pagination variables (only initialize if pagination is enabled)
@@ -256,30 +281,17 @@ window.addEventListener('load', () => {
   let currentResultItems = []
 
   if (!enablePagination) {
-    // If pagination is disabled, we don't need these variables
     currentPage = undefined
     currentResultItems = undefined
   }
 
-  // Cache frequently used elements
-  const elements = {
-    get pagination () { return document.getElementById('local-search-pagination') },
-    get paginationList () { return document.querySelector('#local-search-pagination .ais-Pagination-list') }
-  }
-
   // Show/hide search results area
   const toggleResultsVisibility = hasResults => {
-    if (enablePagination) {
+    $pagination.style.display = (hasResults && enablePagination) ? '' : 'none'
-      elements.pagination.style.display = hasResults ? '' : 'none'
-    } else {
-      elements.pagination.style.display = 'none'
-    }
   }
 
   // Render search results for current page
   const renderResults = (searchText, resultItems) => {
-    const container = document.getElementById('local-search-results')
-
     // Determine items to display based on pagination mode
     const itemsToDisplay = enablePagination
       ? currentResultItems.slice(currentPage * hitsPerPage, (currentPage + 1) * hitsPerPage)
@@ -303,12 +315,12 @@ window.addEventListener('load', () => {
       )
     })
 
-    container.innerHTML = `<ol class="search-result-list">${numberedItems.join('')}</ol>`
+    $results.innerHTML = `<ol class="search-result-list">${numberedItems.join('')}</ol>`
 
     // Update stats
     const displayCount = enablePagination ? currentResultItems.length : resultItems.length
     const stats = languages.hits_stats.replace(/\$\{hits}/, displayCount)
-    statsItem.innerHTML = `<hr><div class="search-result-stats">${stats}</div>`
+    $statsItem.innerHTML = `<hr><div class="search-result-stats">${stats}</div>`
 
     // Handle pagination
     if (enablePagination) {
@@ -319,19 +331,17 @@ window.addEventListener('load', () => {
     const hasResults = resultItems.length > 0
     toggleResultsVisibility(hasResults)
 
-    window.pjax && window.pjax.refresh(container)
+    window.pjax && window.pjax.refresh($results)
   }
 
   // Render pagination
-  const renderPagination = (page, nbPages, query) => {
+  const renderPagination = (page, nbPages) => {
     if (nbPages <= 1) {
-      elements.pagination.style.display = 'none'
+      $pagination.style.display = 'none'
-      elements.paginationList.innerHTML = ''
+      $paginationList.innerHTML = ''
       return
     }
 
-    elements.pagination.style.display = 'block'
-
     const isFirstPage = page === 0
     const isLastPage = page === nbPages - 1
 
@@ -346,77 +356,49 @@ window.addEventListener('load', () => {
       startPage = Math.max(0, endPage - maxVisiblePages + 1)
     }
 
-    let pagesHTML = ''
+    const parts = []
 
     // Only add ellipsis and first page when there are many pages
     if (nbPages > maxVisiblePages && startPage > 0) {
-      pagesHTML += `
+      parts.push('<li class="ais-Pagination-item ais-Pagination-item--page"><a class="ais-Pagination-link" aria-label="Page 1" href="#" data-page="0">1</a></li>')
-        <li class="ais-Pagination-item ais-Pagination-item--page">
-          <a class="ais-Pagination-link" aria-label="Page 1" href="#" data-page="0">1</a>
-        </li>`
       if (startPage > 1) {
-        pagesHTML += `
+        parts.push('<li class="ais-Pagination-item ais-Pagination-item--ellipsis"><span class="ais-Pagination-link">...</span></li>')
-          <li class="ais-Pagination-item ais-Pagination-item--ellipsis">
-            <span class="ais-Pagination-link">...</span>
-          </li>`
       }
     }
 
     // Add middle page numbers
     for (let i = startPage; i <= endPage; i++) {
-      const isSelected = i === page
+      if (i === page) {
-      if (isSelected) {
+        parts.push(`<li class="ais-Pagination-item ais-Pagination-item--page ais-Pagination-item--selected"><span class="ais-Pagination-link" aria-label="Page ${i + 1}">${i + 1}</span></li>`)
-        pagesHTML += `
-          <li class="ais-Pagination-item ais-Pagination-item--page ais-Pagination-item--selected">
-            <span class="ais-Pagination-link" aria-label="Page ${i + 1}">${i + 1}</span>
-          </li>`
       } else {
-        pagesHTML += `
+        parts.push(`<li class="ais-Pagination-item ais-Pagination-item--page"><a class="ais-Pagination-link" aria-label="Page ${i + 1}" href="#" data-page="${i}">${i + 1}</a></li>`)
-          <li class="ais-Pagination-item ais-Pagination-item--page">
-            <a class="ais-Pagination-link" aria-label="Page ${i + 1}" href="#" data-page="${i}">${i + 1}</a>
-          </li>`
       }
     }
 
     // Only add ellipsis and last page when there are many pages
     if (nbPages > maxVisiblePages && endPage < nbPages - 1) {
       if (endPage < nbPages - 2) {
-        pagesHTML += `
+        parts.push('<li class="ais-Pagination-item ais-Pagination-item--ellipsis"><span class="ais-Pagination-link">...</span></li>')
-          <li class="ais-Pagination-item ais-Pagination-item--ellipsis">
-            <span class="ais-Pagination-link">...</span>
-          </li>`
       }
-      pagesHTML += `
+      parts.push(`<li class="ais-Pagination-item ais-Pagination-item--page"><a class="ais-Pagination-link" aria-label="Page ${nbPages}" href="#" data-page="${nbPages - 1}">${nbPages}</a></li>`)
-        <li class="ais-Pagination-item ais-Pagination-item--page">
-          <a class="ais-Pagination-link" aria-label="Page ${nbPages}" href="#" data-page="${nbPages - 1}">${nbPages}</a>
-        </li>`
     }
 
-    if (nbPages > 1) {
+    // Build prev/next links
-      elements.paginationList.innerHTML = `
+    const prevLink = isFirstPage
-            <li class="ais-Pagination-item ais-Pagination-item--previousPage ${isFirstPage ? 'ais-Pagination-item--disabled' : ''}">
-              ${isFirstPage
       ? '<span class="ais-Pagination-link ais-Pagination-link--disabled" aria-label="Previous Page"><i class="fas fa-angle-left"></i></span>'
       : `<a class="ais-Pagination-link" aria-label="Previous Page" href="#" data-page="${page - 1}"><i class="fas fa-angle-left"></i></a>`
-              }
+    const nextLink = isLastPage
-            </li>
-            ${pagesHTML}
-            <li class="ais-Pagination-item ais-Pagination-item--nextPage ${isLastPage ? 'ais-Pagination-item--disabled' : ''}">
-              ${isLastPage
       ? '<span class="ais-Pagination-link ais-Pagination-link--disabled" aria-label="Next Page"><i class="fas fa-angle-right"></i></span>'
       : `<a class="ais-Pagination-link" aria-label="Next Page" href="#" data-page="${page + 1}"><i class="fas fa-angle-right"></i></a>`
-              }
+
-            </li>`
+    $paginationList.innerHTML = `<li class="ais-Pagination-item ais-Pagination-item--previousPage ${isFirstPage ? 'ais-Pagination-item--disabled' : ''}">${prevLink}</li>${parts.join('')}<li class="ais-Pagination-item ais-Pagination-item--nextPage ${isLastPage ? 'ais-Pagination-item--disabled' : ''}">${nextLink}</li>`
-    } else {
+    $pagination.style.display = ''
-      elements.pagination.style.display = 'none'
-    }
   }
 
   // Clear search results and stats
   const clearSearchResults = () => {
-    const container = document.getElementById('local-search-results')
+    $results.textContent = ''
-    container.textContent = ''
+    $statsItem.textContent = ''
-    statsItem.textContent = ''
     toggleResultsVisibility(false)
     if (enablePagination) {
       currentResultItems = []
@@ -426,12 +408,11 @@ window.addEventListener('load', () => {
 
   // Show no results message
   const showNoResults = searchText => {
-    const container = document.getElementById('local-search-results')
+    $results.textContent = ''
-    container.textContent = ''
     const statsDiv = document.createElement('div')
     statsDiv.className = 'search-result-stats'
     statsDiv.textContent = languages.hits_empty.replace(/\$\{query}/, searchText)
-    statsItem.innerHTML = statsDiv.outerHTML
+    $statsItem.innerHTML = statsDiv.outerHTML
     toggleResultsVisibility(false)
     if (enablePagination) {
       currentResultItems = []
@@ -441,7 +422,7 @@ window.addEventListener('load', () => {
 
   const inputEventFunction = () => {
     if (!localSearch.isfetched) return
-    let searchText = input.value.trim().toLowerCase()
+    let searchText = $input.value.trim().toLowerCase()
     isXml && (searchText = searchText.replace(/</g, '&lt;').replace(/>/g, '&gt;'))
 
     if (searchText !== '') $loadingStatus.hidden = false
@@ -478,44 +459,63 @@ window.addEventListener('load', () => {
     $loadingStatus.hidden = true
   }
 
-  let loadFlag = false
+  // Debounced input handler
-  const $searchMask = document.getElementById('search-mask')
+  let searchTimeout
-  const $searchDialog = document.querySelector('#local-search .search-dialog')
+  const debouncedInputEvent = () => {
+    clearTimeout(searchTimeout)
+    // Empty input: clear results immediately without debounce delay
+    if (!$input.value.trim()) {
+      inputEventFunction()
+      return
+    }
+    searchTimeout = setTimeout(inputEventFunction, 200)
+  }
+
+  let loadFlag = false
 
-  // fix safari
   const fixSafariHeight = () => {
     if (window.innerWidth < 768) {
       $searchDialog.style.setProperty('--search-height', window.innerHeight + 'px')
     }
   }
 
+  // Debounced resize to avoid layout thrashing
+  let resizeTimer
+  const onResize = () => {
+    clearTimeout(resizeTimer)
+    resizeTimer = setTimeout(fixSafariHeight, 150)
+  }
+
+  const handleEscape = event => {
+    if (event.code === 'Escape') {
+      closeSearch()
+      document.removeEventListener('keydown', handleEscape)
+    }
+  }
+
   const openSearch = () => {
     btf.overflowPaddingR.add()
     btf.animateIn($searchMask, 'to_show 0.5s')
     btf.animateIn($searchDialog, 'titleScale 0.5s')
-    setTimeout(() => { input.focus() }, 300)
+    setTimeout(() => { $input.focus() }, 300)
     if (!loadFlag) {
       !localSearch.isfetched && localSearch.fetchData()
-      input.addEventListener('input', inputEventFunction)
+      $input.addEventListener('input', debouncedInputEvent)
       loadFlag = true
     }
     // shortcut: ESC
-    document.addEventListener('keydown', function f (event) {
+    document.addEventListener('keydown', handleEscape)
-      if (event.code === 'Escape') {
-        closeSearch()
-        document.removeEventListener('keydown', f)
-      }
-    })
 
     fixSafariHeight()
-    window.addEventListener('resize', fixSafariHeight)
+    window.addEventListener('resize', onResize)
   }
 
   const closeSearch = () => {
     btf.overflowPaddingR.remove()
     btf.animateOut($searchDialog, 'search_close .5s')
     btf.animateOut($searchMask, 'to_hide 0.5s')
-    window.removeEventListener('resize', fixSafariHeight)
+    document.removeEventListener('keydown', handleEscape)
+    window.removeEventListener('resize', onResize)
   }
 
   const searchClickFn = () => {
@@ -532,14 +532,14 @@ window.addEventListener('load', () => {
 
     // Pagination event delegation - only add if pagination is enabled
     if (enablePagination) {
-      elements.pagination.addEventListener('click', e => {
+      $pagination.addEventListener('click', e => {
         e.preventDefault()
         const link = e.target.closest('a[data-page]')
         if (link) {
           const page = parseInt(link.dataset.page, 10)
           if (!isNaN(page) && currentResultItems.length > 0) {
             currentPage = page
-            renderResults(input.value.trim().toLowerCase(), currentResultItems)
+            renderResults($input.value.trim().toLowerCase(), currentResultItems)
           }
         }
       })

source/js/utils.js

@@ -45,28 +45,54 @@
       }
     },
 
-    overflowPaddingR: {
+    rafThrottle: fn => {
+      let rafId = null
+      return (...args) => {
+        if (rafId) return
+        rafId = requestAnimationFrame(() => {
+          fn(...args)
+          rafId = null
+        })
+      }
+    },
+
+    overflowPaddingR: (() => {
+      let headerElement = null
+      let menuElement = null
+
+      const getElements = () => {
+        if (!headerElement) {
+          headerElement = document.getElementById('page-header')
+        }
+        if (!menuElement) {
+          menuElement = document.getElementById('menus')
+        }
+        return { headerElement, menuElement }
+      }
+
+      return {
         add: () => {
           const paddingRight = window.innerWidth - document.body.clientWidth
 
           if (paddingRight > 0) {
             document.body.style.paddingRight = `${paddingRight}px`
             document.body.style.overflow = 'hidden'
-          const menuElement = document.querySelector('#page-header.nav-fixed #menus')
+            const { headerElement: header, menuElement: menu } = getElements()
-          if (menuElement) {
+            if (header && menu && header.classList.contains('nav-fixed')) {
-            menuElement.style.paddingRight = `${paddingRight}px`
+              menu.style.paddingRight = `${paddingRight}px`
             }
           }
         },
         remove: () => {
           document.body.style.paddingRight = ''
           document.body.style.overflow = ''
-        const menuElement = document.querySelector('#page-header.nav-fixed #menus')
+          const { headerElement: header, menuElement: menu } = getElements()
-        if (menuElement) {
+          if (header && menu && header.classList.contains('nav-fixed')) {
-          menuElement.style.paddingRight = ''
+            menu.style.paddingRight = ''
           }
         }
-    },
+      }
+    })(),
 
     snackbarShow: (text, showAction = false, duration = 2000) => {
       const { position, bgLight, bgDark } = GLOBAL_CONFIG.Snackbar
@@ -133,7 +159,8 @@
       const animate = currentTime => {
         const timeElapsed = currentTime - startTime
         const progress = Math.min(timeElapsed / time, 1)
-        window.scrollTo(0, currentPos + (pos - currentPos) * progress)
+        const easedProgress = 1 - Math.pow(1 - progress, 4) // easeOutQuart
+        window.scrollTo(0, currentPos + (pos - currentPos) * easedProgress)
         if (progress < 1) {
           requestAnimationFrame(animate)
         }