Files
FixIt/assets/js/modules/misc.ts
T
Cell 5cad4d3df9 refactor(assets): PWA improvements and app config snake_case migration (#790)
- Service worker: versioned cache name, navigation preload, stale-while-revalidate for images
- New PWAModule extracted from MiscModule with async registration and update detection
- SW update notification toast in Hugo template with i18n support (16 languages)
- Web app manifest template (site.webmanifest) generated from [params.app] config
- [params.app] keys migrated to snake_case: name, short_name, pwa, no_favicon, svg_favicon, mask_color, tile_color, theme_color
- enablePWA moved from [params] to [params.app].pwa
- theme_color no longer accepts single-value, only {light, dark} map
- EventBus: new fixit:sw-update event
- SCSS: new _sw-toast.scss widget for update notification
2026-06-24 12:43:37 +08:00

134 lines
4.8 KiB
TypeScript

import type { CoreService, MiscService } from '../core/tokens'
import { eventBus } from '../core/event-bus'
import { getScrollTop, isMobile, isValidDate, scrollIntoView } from '../utils'
/**
* Miscellaneous module — site time, PWA, bookmarks, rewards, comments, and PostChat.
*
* Responsibilities:
* - Display site running time with animated counters.
* - Register service worker for PWA support.
* - Auto-bookmark scroll position for page restoration.
* - Initialize reward QR codes and PostChat AI user info.
* - Initialize comment section UI and scroll-into-view.
*/
export class MiscModule implements MiscService {
private siteTime: ReturnType<typeof setInterval> | undefined
constructor(private readonly core: CoreService) {}
/** Calculate and display the elapsed time since site launch. */
getSiteTime() {
const now = new Date()
const run = new Date(this.core.config.siteTime!)
const $runTimes = document.querySelector<HTMLElement>('.run-times')
if (!isValidDate(run) || !$runTimes) {
clearInterval(this.siteTime)
$runTimes && $runTimes.parentNode!.removeChild($runTimes)
return
}
const totalSeconds = Math.floor((now.getTime() - run.getTime()) / 1000)
const days = Math.floor(totalSeconds / 86400)
const hours = Math.floor((totalSeconds % 86400) / 3600)
const minutes = Math.floor((totalSeconds % 3600) / 60)
const seconds = totalSeconds % 60
$runTimes.innerHTML = `${days}, ${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`
document.querySelector('.site-time .d-none')?.classList.remove('d-none')
}
/** Start the site-time counter with visibility-change pausing. */
initSiteTime() {
if (this.core.config.siteTime) {
this.siteTime = setInterval(() => this.getSiteTime(), 500)
document.addEventListener('visibilitychange', () => {
if (document.hidden) {
return clearInterval(this.siteTime)
}
this.siteTime = setInterval(() => this.getSiteTime(), 500)
}, false)
}
}
/** Save and restore scroll position as an automatic bookmark. */
initAutoMark() {
if (!this.core.config.autoBookmark)
return
window.addEventListener('beforeunload', () => {
window.sessionStorage?.setItem(`fixit-bookmark/#${location.pathname}`, String(getScrollTop()))
})
const scrollTop = Number(window.sessionStorage?.getItem(`fixit-bookmark/#${location.pathname}`))
if (scrollTop && location.hash === '') {
window.scrollTo({ top: scrollTop, behavior: 'smooth' })
}
}
/** Initialize reward/donation button exclusive-toggle behaviour. */
initReward() {
const $rewards = document.querySelectorAll<HTMLElement>('.post-reward [data-mode="fixed"]')
if (!$rewards.length)
return
if (isMobile()) {
$rewards.forEach($reward => $reward.removeAttribute('data-mode'))
return
}
const _closeRewardExclude = (id?: string | null) => {
$rewards.forEach(($reward) => {
const $rewardInput = $reward.parentElement!.querySelector<HTMLInputElement>('.reward-input')
if ($rewardInput && $rewardInput.id !== id) {
$rewardInput.checked = false
}
})
}
$rewards.forEach(($reward) => {
$reward.previousElementSibling!.addEventListener('click', function (this: HTMLElement) {
_closeRewardExclude(this.getAttribute('for'))
}, false)
})
eventBus.on('fixit:scroll', () => _closeRewardExclude())
}
/** Initialize the comment section UI. */
initComment() {
if (!this.core.config.comment?.enable)
return
if (document.querySelector('#comments')) {
const $viewCommentsBtn = document.querySelector<HTMLElement>('.view-comments')!
$viewCommentsBtn.classList.remove('d-none')
$viewCommentsBtn.addEventListener('click', () => {
scrollIntoView('#comments')
}, false)
}
if (this.core.config.comment.expired)
document.querySelector('#comments')!.remove()
}
/** Initialize PostChat theme sync if configured. */
initPostChatUser() {
if (!window.postChatUser || !window.postChatConfig || window.postChatConfig.userMode === 'magic')
return
window.postChat_theme = this.core.isDark ? 'dark' : 'light'
eventBus.on('fixit:switch-theme', ({ detail }) => {
if (!detail.isChanged)
return
const targetFrame = document.getElementById('postChat_iframeContainer')
if (targetFrame) {
window.postChatUser.setPostChatTheme(detail.isDark ? 'dark' : 'light')
}
else {
window.postChat_theme = detail.isDark ? 'dark' : 'light'
}
})
}
/** Initialize all miscellaneous features. */
setup() {
this.initSiteTime()
this.initAutoMark()
this.initReward()
this.initPostChatUser()
this.initComment()
}
}