vite-plugin-taro 0.3.1 → 0.4.0

package/src/node/targets/wx/plugin.ts

@@ -1,163 +0,0 @@
-import path from 'node:path'
-import type { Plugin, PluginOption, UserConfig } from 'vite'
-import type { BuildContext } from '../../build-context.ts'
-import { normalizeModuleId, stripVirtualPrefix } from '../../utils/modules.ts'
-import { packageRequire } from '../../utils/packages.ts'
-import { emitWxCompanionAssets, type WxBundle } from './companion-assets.ts'
-import { WxDevelopmentSession } from './dev-server/development-session.ts'
-import { transformWxReactRefreshModule } from './react-refresh.ts'
-import { emitWxEntryChunks, isWxVirtualModuleId, loadWxVirtualModule, virtualWxAppId } from './virtual-modules.ts'
-
-const taroWxComponentsPath = packageRequire.resolve('@tarojs/plugin-platform-weapp/dist/components-react')
-const vitePluginTaroSourcePath = normalizeModuleId(path.dirname(packageRequire.resolve('vite-plugin-taro')))
-const taroVersion = String(packageRequire('@tarojs/runtime/package.json').version)
-
-/** Creates the plugins that own the complete WX build and development lifecycle. */
-export function createWxTargetPlugins(context: BuildContext): PluginOption[] {
-    return [createWxTargetPlugin(context)]
-}
-
-function createWxTargetPlugin(context: BuildContext): Plugin {
-    let developmentSession: WxDevelopmentSession | undefined
-
-    return {
-        name: 'vite-plugin-taro:wx',
-
-        resolveId: {
-            order: 'pre',
-            handler(id) {
-                return isWxVirtualModuleId(id) ? `\0${id}` : undefined
-            }
-        },
-
-        load: {
-            order: 'post',
-            handler(id) {
-                const cleanId = stripVirtualPrefix(id)
-
-                emitWxEntryChunks(this, context, cleanId)
-
-                return loadWxVirtualModule(cleanId, context)
-            }
-        },
-
-        transform: {
-            order: 'post',
-            async handler(code, id) {
-                if (!context.development) return
-
-                const transformed = await transformWxReactRefreshModule(code, id, context.project.appComponentFile)
-                return transformed === code ? undefined : transformed
-            }
-        },
-
-        generateBundle: {
-            order: 'post',
-            handler(_, bundle) {
-                emitWxCompanionAssets(this, bundle as WxBundle, context)
-            }
-        },
-
-        configureServer: {
-            order: 'post',
-            handler(server) {
-                developmentSession = new WxDevelopmentSession(context, server)
-                developmentSession.install()
-            }
-        },
-
-        closeBundle() {
-            return developmentSession?.close()
-        }
-    }
-}
-
-/** Supplies the complete WX target configuration from the same target owner as its plugin. */
-export function createWxViteConfig(context: BuildContext): UserConfig {
-    return {
-        define: createWxTaroDefines(),
-        experimental: context.development ? { bundledDev: true } : undefined,
-        css: {
-            lightningcss: {
-                visitor: {
-                    // keep CSS3 style single colon :before, :after
-                    // while WeChat Mini Program does not support the double colons versions
-                    Selector(selector) {
-                        return selector.map((component) => {
-                            if (
-                                component.type === 'pseudo-element' &&
-                                (component.kind === 'before' || component.kind === 'after')
-                            ) {
-                                return {
-                                    type: 'pseudo-element' as const,
-                                    kind: 'custom' as const,
-                                    name: component.kind
-                                }
-                            }
-                            return component
-                        })
-                    }
-                }
-            }
-        },
-        resolve: {
-            alias: [{ find: /^@tarojs\/components$/, replacement: taroWxComponentsPath }]
-        },
-        build: {
-            target: 'es2018',
-            assetsInlineLimit: 1024,
-            cssCodeSplit: false,
-            cssMinify: context.development ? false : 'lightningcss',
-            minify: !context.development,
-            rolldownOptions: {
-                input: { app: virtualWxAppId },
-                experimental: {
-                    // remove vite virtual module \0 in comments, which causes WeChat DevTools failed to compile
-                    attachDebugInfo: 'none'
-                },
-                output: {
-                    format: 'cjs',
-                    entryFileNames: '[name].js',
-                    assetFileNames: 'assets/[name][extname]',
-                    chunkFileNames: ({ name }) => `${name === 'rolldown-runtime' ? 'runtime' : name}.js`,
-                    strictExecutionOrder: true,
-                    codeSplitting: {
-                        includeDependenciesRecursively: false,
-                        minSize: 0,
-                        groups: [
-                            { name: 'taro', test: isWxTaroChunkModule, priority: 100 },
-                            { name: 'vendors', test: isNodeModule, priority: 10 },
-                            { name: 'common', minShareCount: 2, minModuleSize: 1, priority: 1 }
-                        ]
-                    }
-                }
-            }
-        }
-    }
-}
-
-function createWxTaroDefines(): Record<string, string> {
-    return {
-        'process.env.FRAMEWORK': JSON.stringify('react'),
-        'process.env.SUPPORT_TARO_POLYFILL': JSON.stringify('disabled'),
-        'process.env.TARO_ENV': JSON.stringify('weapp'),
-        'process.env.TARO_PLATFORM': JSON.stringify('mini'),
-        'process.env.TARO_VERSION': JSON.stringify(taroVersion),
-        ENABLE_ADJACENT_HTML: 'false',
-        ENABLE_CLONE_NODE: 'false',
-        ENABLE_CONTAINS: 'false',
-        ENABLE_INNER_HTML: 'false',
-        ENABLE_MUTATION_OBSERVER: 'false',
-        ENABLE_SIZE_APIS: 'false',
-        ENABLE_TEMPLATE_CONTENT: 'false'
-    }
-}
-
-function isWxTaroChunkModule(id: string): boolean {
-    const normalizedId = normalizeModuleId(id)
-    return normalizedId.includes('/node_modules/@tarojs/') || normalizedId.startsWith(`${vitePluginTaroSourcePath}/`)
-}
-
-function isNodeModule(id: string): boolean {
-    return normalizeModuleId(id).includes('/node_modules/')
-}

package/src/node/targets/wx/react-refresh.ts

@@ -1,51 +0,0 @@
-import { transformWithOxc } from 'vite'
-import { normalizeModuleId } from '../../utils/modules.ts'
-
-/** Rewrites Vite's browser-oriented Refresh output for the WX App Service global environment. */
-export async function transformWxReactRefreshModule(
-    code: string,
-    id: string,
-    appComponentFile: string
-): Promise<string> {
-    const appFile = normalizeModuleId(appComponentFile)
-    const instrumented = normalizeModuleId(id) === appFile ? await instrumentWxAppComponent(code, appFile) : code
-    return instrumented
-        .replaceAll('window.$Refresh', 'globalThis.$Refresh')
-        .replaceAll('window.__registerBeforePerformReactRefresh', 'globalThis.__registerBeforePerformReactRefresh')
-        .replaceAll('window.__getReactRefreshIgnoredExports', 'globalThis.__getReactRefreshIgnoredExports')
-        .replace(
-            'export function register(type, id) {',
-            'export function register(type, id) {\n  if (globalThis.__VITE_PLUGIN_TARO_WX_PAGE_UPDATE__?.blockRefreshRegistration) return'
-        )
-        .replace(
-            '\n  performReactRefresh()\n',
-            '\n  globalThis.__VITE_PLUGIN_TARO_WX_PAGE_UPDATE__?.afterRefresh?.(performReactRefresh())\n'
-        )
-}
-
-/** Creates the virtual preamble that installs React Refresh before the generated WX App entry executes. */
-export function createWxReactRefreshPreambleSource(): string {
-    return `import RefreshRuntime from '/@react-refresh'
-RefreshRuntime.injectIntoGlobalHook(globalThis)
-globalThis.$RefreshReg$ = () => {}
-globalThis.$RefreshSig$ = () => (type) => type
-`
-}
-
-/** Adds Refresh registration to JSX-free App modules that Vite's normal JSX transform would otherwise skip. */
-async function instrumentWxAppComponent(code: string, appFile: string): Promise<string> {
-    const transformed = await transformWithOxc(code, appFile, {
-        lang: 'js',
-        sourcemap: false,
-        jsx: { refresh: true }
-    })
-    return `import {
-    createSignatureFunctionForTransform as __wxCreateRefreshSignature,
-    register as __wxRegisterRefreshType
-} from '/@react-refresh'
-const $RefreshReg$ = (type, id) => __wxRegisterRefreshType(type, ${JSON.stringify(`${appFile} `)} + id)
-const $RefreshSig$ = __wxCreateRefreshSignature
-${transformed.code}
-if (import.meta.hot) import.meta.hot.accept()
-`
-}

package/src/node/targets/wx/virtual-modules.ts

@@ -1,152 +0,0 @@
-/**
- * Defines the generated WX application graph.
- *
- * App, page, and component IDs become native entry chunks. The Refresh preamble is an App bootstrap module, while the
- * page-preload ID deliberately becomes its own development file with a later, page-only execution phase.
- */
-import type { VitePluginTaroPageOption } from '../../../options.ts'
-import type { BuildContext } from '../../build-context.ts'
-import { createPageComponentImportPath, toViteFileImportPath } from '../../utils/modules.ts'
-import { resolvePackageFile } from '../../utils/packages.ts'
-import { wxPagePreloadFile } from './development-files.ts'
-import { createWxReactRefreshPreambleSource } from './react-refresh.ts'
-
-const wxTaroRuntimeImportPath = runtimeImportPath('taro-runtime.js')
-const wxPageUpdateImportPath = runtimeImportPath('page-update.js')
-const wxUpdateClientImportPath = runtimeImportPath('update-client.js')
-
-/** Generated native App entry. */
-export const virtualWxAppId = 'virtual:vite-plugin-taro/wx/app'
-
-/** Generated recursive Taro component entry. */
-const virtualWxComponentId = 'virtual:vite-plugin-taro/wx/component'
-
-/** Prefix for one generated native entry per configured page route. */
-const virtualWxPageIdPrefix = 'virtual:vite-plugin-taro/wx/page/'
-
-/** App bootstrap module that installs React Refresh globals before application modules execute. */
-const virtualWxRefreshPreambleId = 'virtual:vite-plugin-taro/wx/refresh-preamble'
-
-/** Development-only entry that initializes all configured page components before update replay. */
-const virtualWxPagePreloadId = 'virtual:vite-plugin-taro/wx/page-preload'
-
-type WxChunkEmitter = {
-    emitFile(chunk: { type: 'chunk'; id: string; fileName: string; implicitlyLoadedAfterOneOf: string[] }): string
-}
-
-export function isWxVirtualModuleId(id: string): boolean {
-    return (
-        id === virtualWxAppId ||
-        id === virtualWxComponentId ||
-        id === virtualWxRefreshPreambleId ||
-        id === virtualWxPagePreloadId ||
-        id.startsWith(virtualWxPageIdPrefix)
-    )
-}
-
-export function loadWxVirtualModule(id: string, context: BuildContext): string | undefined {
-    if (id === virtualWxRefreshPreambleId) {
-        return createWxReactRefreshPreambleSource()
-    }
-    if (id === virtualWxAppId) {
-        return createWxAppEntrySource(context)
-    }
-    if (id === virtualWxComponentId) {
-        return createWxComponentEntrySource()
-    }
-    if (id === virtualWxPagePreloadId) {
-        return createWxPagePreloadSource(context)
-    }
-
-    if (id.startsWith(virtualWxPageIdPrefix)) {
-        const pagePath = id.slice(virtualWxPageIdPrefix.length)
-
-        const page = context.project.pages.find((candidate) => candidate.path === pagePath)
-        if (page) {
-            return createWxPageEntrySource(page, context)
-        }
-    }
-}
-
-/** Registers every configured page and the shared recursive component as eager WX entry chunks. */
-export function emitWxEntryChunks(emitter: WxChunkEmitter, context: BuildContext, id: string): void {
-    if (id !== virtualWxAppId) return
-
-    for (const page of context.project.pages) {
-        emitter.emitFile({
-            type: 'chunk',
-            id: `${virtualWxPageIdPrefix}${page.path}`,
-            fileName: `${page.path}.js`,
-            implicitlyLoadedAfterOneOf: [id]
-        })
-    }
-
-    emitter.emitFile({
-        type: 'chunk',
-        id: virtualWxComponentId,
-        fileName: 'comp.js',
-        implicitlyLoadedAfterOneOf: [id]
-    })
-
-    if (context.development) {
-        emitter.emitFile({
-            type: 'chunk',
-            id: virtualWxPagePreloadId,
-            fileName: wxPagePreloadFile,
-            implicitlyLoadedAfterOneOf: [id]
-        })
-    }
-}
-
-function createWxAppEntrySource(context: BuildContext): string {
-    const refreshPreamble = context.development ? `import ${JSON.stringify(virtualWxRefreshPreambleId)}\n` : ''
-    const updateClient = context.development
-        ? `import { startWxUpdateClient } from ${JSON.stringify(wxUpdateClientImportPath)}\n`
-        : ''
-    return `${refreshPreamble}${updateClient}import { createReactApp, ReactDOM } from ${JSON.stringify(wxTaroRuntimeImportPath)}
-import React from 'react'
-import AppComponent from ${JSON.stringify(toViteFileImportPath(context.project.appComponentFile))}
-
-const appConfig = ${JSON.stringify(context.project.appConfig)}
-App(createReactApp(AppComponent, React, ReactDOM, appConfig))
-${context.development ? 'startWxUpdateClient()' : ''}
-`
-}
-
-function createWxPageEntrySource(page: VitePluginTaroPageOption, context: BuildContext): string {
-    const hotUpdateImport = context.development
-        ? `import { decorateWxPageConfig, registerWxPage } from ${JSON.stringify(wxPageUpdateImportPath)}\n`
-        : ''
-    const createConfig = `createPageConfig(PageComponent, '${page.path}', { root: { cn: [] } }, pageConfig)`
-    const pageRegistration = context.development
-        ? `registerWxPage(${JSON.stringify(page.path)}, () => Page(taroPageConfig))`
-        : 'Page(taroPageConfig)'
-    return `${hotUpdateImport}import { createPageConfig } from ${JSON.stringify(wxTaroRuntimeImportPath)}
-import PageComponent from ${JSON.stringify(createPageComponentImportPath(page.path))}
-
-const pageConfig = ${JSON.stringify(page.config)}
-const taroPageConfig = ${context.development ? `decorateWxPageConfig(${createConfig})` : createConfig}
-if (PageComponent && PageComponent.behaviors) {
-  taroPageConfig.behaviors = (taroPageConfig.behaviors || []).concat(PageComponent.behaviors)
-}
-${pageRegistration}
-`
-}
-
-function createWxPagePreloadSource(context: BuildContext): string {
-    const imports = context.project.pages.map((page, index) => {
-        return `import Page${index} from ${JSON.stringify(createPageComponentImportPath(page.path))}`
-    })
-    return `${imports.join('\n')}\nvoid [${context.project.pages.map((_, index) => `Page${index}`).join(', ')}]\n`
-}
-
-function runtimeImportPath(fileName: string): string {
-    return toViteFileImportPath(resolvePackageFile('dist/runtime/wx', fileName))
-}
-
-function createWxComponentEntrySource(): string {
-    return `import { createRecursiveComponentConfig } from ${JSON.stringify(wxTaroRuntimeImportPath)}
-
-Component(createRecursiveComponentConfig())
-`
-}

package/src/node/utils/async.ts

@@ -1,19 +0,0 @@
-/** Generic asynchronous coordination helpers for Node-side plugin services. */
-export class SerializedTaskQueue {
-    private readonly reportError: (error: unknown) => void
-    private tail = Promise.resolve()
-
-    constructor(reportError: (error: unknown) => void) {
-        this.reportError = reportError
-    }
-
-    enqueue(task: () => Promise<void>): Promise<void> {
-        const work = this.tail.then(task)
-        this.tail = work.catch(this.reportError)
-        return work
-    }
-
-    async waitForIdle(): Promise<void> {
-        await this.tail
-    }
-}

package/src/node/utils/filesystem.ts

@@ -1,45 +0,0 @@
-/** Node-only filesystem helpers shared by build targets and development services. */
-import fs from 'node:fs/promises'
-import path from 'node:path'
-
-type FileSource = string | Uint8Array
-type FileWrite = { file: string; source: FileSource }
-
-/** Writes through a sibling temporary file so observers never read partial contents. */
-export async function writeFileAtomically(file: string, source: FileSource): Promise<void> {
-    await fs.mkdir(path.dirname(file), { recursive: true })
-    const temporaryFile = `${file}.tmp`
-    await fs.writeFile(temporaryFile, source)
-    await fs.rename(temporaryFile, file)
-}
-
-export async function writeFilesAtomically(files: FileWrite[]): Promise<void> {
-    await Promise.all(files.map(({ file, source }) => writeFileAtomically(file, source)))
-}
-
-/** Copies a directory when present and treats a missing optional source as empty. */
-export async function copyDirectoryIfExists(source: string, destination: string): Promise<void> {
-    if (!source) return
-    try {
-        await fs.cp(source, destination, { recursive: true, force: true })
-    } catch (error) {
-        if (!isMissingFileError(error)) throw error
-    }
-}
-
-/** Mirrors one optional file: copy existing files, ignore directories, and remove a missing source's destination. */
-export async function copyFileOrRemove(source: string, destination: string): Promise<void> {
-    try {
-        const stat = await fs.stat(source)
-        if (stat.isDirectory()) return
-        await fs.mkdir(path.dirname(destination), { recursive: true })
-        await fs.copyFile(source, destination)
-    } catch (error) {
-        if (!isMissingFileError(error)) throw error
-        await fs.rm(destination, { recursive: true, force: true })
-    }
-}
-
-function isMissingFileError(error: unknown): error is NodeJS.ErrnoException {
-    return error instanceof Error && 'code' in error && error.code === 'ENOENT'
-}

package/src/runtime/taro/api.ts

@@ -1,13 +0,0 @@
-/** Physical runtime module backing the public `virtual:taro/api` facade. */
-// Ensure Taro's React runtime registers its `initNativeApi` hook before @tarojs/taro is initialized.
-import '@tarojs/plugin-framework-react/dist/runtime'
-import { hooks } from '@tarojs/runtime'
-import Taro from '@tarojs/taro'
-
-if (hooks.isExist('initNativeApi')) {
-    hooks.call('initNativeApi', Taro)
-}
-
-// @ts-expect-error @tarojs/taro declares export= types, but vite-plugin-taro target aliases expose runtime named exports.
-export * from '@tarojs/taro'
-export default Taro

package/src/runtime/taro/components.ts

@@ -1,2 +0,0 @@
-/** Physical runtime module backing the public `virtual:taro/components` facade. */
-export * from '@tarojs/components'

package/src/runtime/wx/page-update.ts

@@ -1,230 +0,0 @@
-/**
- * Coordinates page-side update execution after the Rolldown and Taro runtimes exist.
- *
- * This module is intentionally page-only: it suppresses DevTools' synthetic lifecycles, preserves the Taro root,
- * commits React Refresh, and relaunches stale component families. HTTP transport remains in update-client.ts.
- */
-import { document } from '@tarojs/runtime'
-import { validateRefreshBoundaryAndEnqueueUpdate } from '/@react-refresh'
-
-type WxPage = {
-    $taroPath?: string
-    $taroParams?: Record<string, unknown>
-}
-
-type WxPageConfig = Record<string, unknown>
-type PageLifecycle = (this: WxPage, ...args: unknown[]) => unknown
-
-type TaroRoot = {
-    ctx: WxPage | null
-    updateChildNodes(): void
-    performUpdate(initRender?: boolean): void
-}
-
-type ReactRefreshResult = {
-    staleFamilies?: Set<unknown>
-}
-
-type WxRolldownRuntime = {
-    beginPatch?(): void
-    endPatch?(): void
-}
-
-type WxPageUpdateCoordinator = {
-    ready: boolean
-    pendingUpdate?: () => void
-    blockRefreshRegistration?: boolean
-    enqueueRefresh?: () => void
-    beginUpdate?: () => void
-    endUpdate?: () => void
-    afterRefresh?: (update?: ReactRefreshResult) => void
-}
-
-type WxUpdateClient = {
-    refreshCompleted(stale: boolean): void
-    routeReady(): void
-}
-
-type WxRuntimeGlobal = typeof globalThis & {
-    __rolldown_runtime__?: WxRolldownRuntime
-    __VITE_PLUGIN_TARO_WX_PAGE_UPDATE__?: WxPageUpdateCoordinator
-    __VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__?: WxUpdateClient
-    getCurrentPages(): Array<{ route?: string }>
-    wx: {
-        reLaunch(options: { url: string }): void
-    }
-}
-
-const wxRuntimeGlobal = globalThis as WxRuntimeGlobal
-wxRuntimeGlobal.__VITE_PLUGIN_TARO_WX_PAGE_UPDATE__ ??= { ready: false }
-const bridge = wxRuntimeGlobal.__VITE_PLUGIN_TARO_WX_PAGE_UPDATE__
-const refreshBoundary = { default: function WxRefreshBoundary() {} }
-const registeredRoutes = new Set<string>()
-const ignoredPages = new WeakSet<WxPage>()
-
-type PageRuntimeState = Readonly<{
-    activePage?: WxPage
-    pendingUpdate?: { page?: WxPage; root?: TaroRoot }
-    suppressLifecycles: boolean
-}>
-
-type PageRuntimeEvent =
-    | { type: 'page-activated'; page: WxPage }
-    | { type: 'page-unloaded'; page: WxPage }
-    | { type: 'update-started'; root?: TaroRoot }
-    | { type: 'suppression-ended' }
-    | { type: 'refresh-finished' }
-
-let pageRuntimeState: PageRuntimeState = { suppressLifecycles: false }
-
-/** Registers a native route once per App Service runtime generation. */
-export function registerWxPage(route: string, register: () => void): void {
-    if (registeredRoutes.has(route)) return
-    register()
-    registeredRoutes.add(route)
-}
-
-/** Retains Taro's live root while filtering DevTools' synthetic update lifecycles. */
-export function decorateWxPageConfig(config: WxPageConfig): WxPageConfig {
-    const onLoad = getLifecycle(config, 'onLoad')
-    config.onLoad = function (this: WxPage, ...args: unknown[]) {
-        if (pageRuntimeState.suppressLifecycles) {
-            ignoredPages.add(this)
-            this.$taroPath = pageRuntimeState.activePage?.$taroPath
-            this.$taroParams = pageRuntimeState.activePage?.$taroParams
-            dispatchPageRuntime({ type: 'page-activated', page: this })
-            return
-        }
-        const result = onLoad?.apply(this, args)
-        dispatchPageRuntime({ type: 'page-activated', page: this })
-        return result
-    }
-    wrapLifecycle(config, 'onReady', applyPendingPageUpdate)
-    wrapLifecycle(config, 'onShow', function () {
-        dispatchPageRuntime({ type: 'page-activated', page: this })
-    })
-    wrapLifecycle(config, 'onHide')
-    wrapLifecycle(config, 'onUnload', function () {
-        dispatchPageRuntime({ type: 'page-unloaded', page: this })
-    })
-    return config
-}
-
-function wrapLifecycle(config: WxPageConfig, name: string, after?: PageLifecycle): void {
-    const original = getLifecycle(config, name)
-    config[name] = function (this: WxPage, ...args: unknown[]) {
-        if (pageRuntimeState.suppressLifecycles) return
-        if (ignoredPages.has(this)) {
-            if (name === 'onUnload') ignoredPages.delete(this)
-            return
-        }
-        const result = original?.apply(this, args)
-        after?.apply(this, args)
-        return result
-    }
-}
-
-function getLifecycle(config: WxPageConfig, name: string): PageLifecycle | undefined {
-    return typeof config[name] === 'function' ? (config[name] as PageLifecycle) : undefined
-}
-
-function applyPendingPageUpdate(): void {
-    bridge.ready = true
-    const pendingUpdate = bridge.pendingUpdate
-    if (pendingUpdate) {
-        delete bridge.pendingUpdate
-        pendingUpdate()
-    }
-    wxRuntimeGlobal.__VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__?.routeReady()
-}
-
-function getActiveTaroRoot(): TaroRoot | undefined {
-    const page = pageRuntimeState.activePage
-    if (!page?.$taroPath) return
-    return (document.getElementById(page.$taroPath) as TaroRoot | null) ?? undefined
-}
-
-bridge.enqueueRefresh = () => {
-    validateRefreshBoundaryAndEnqueueUpdate('vite-plugin-taro-wx', refreshBoundary, refreshBoundary)
-}
-
-bridge.beginUpdate = () => {
-    bridge.blockRefreshRegistration = false
-    wxRuntimeGlobal.__rolldown_runtime__?.beginPatch?.()
-    dispatchPageRuntime({ type: 'update-started', root: getActiveTaroRoot() })
-    refreshTaroRoot(pageRuntimeState.pendingUpdate?.root, pageRuntimeState.pendingUpdate?.page)
-    runInNextNativeTask(() => dispatchPageRuntime({ type: 'suppression-ended' }))
-}
-
-bridge.endUpdate = () => {
-    wxRuntimeGlobal.__rolldown_runtime__?.endPatch?.()
-    bridge.blockRefreshRegistration = true
-    bridge.enqueueRefresh?.()
-}
-
-bridge.afterRefresh = (update) => {
-    bridge.blockRefreshRegistration = false
-    const pendingUpdate = pageRuntimeState.pendingUpdate
-    dispatchPageRuntime({ type: 'refresh-finished' })
-    const page = pendingUpdate?.page
-    const root = pendingUpdate?.root
-
-    const stale = Boolean(update?.staleFamilies?.size)
-    if (stale) {
-        wxRuntimeGlobal.__VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__?.refreshCompleted(true)
-        relaunchActiveRoute(page)
-        return
-    }
-    runInNextNativeTask(() => {
-        refreshTaroRoot(root, pageRuntimeState.activePage ?? page)
-        wxRuntimeGlobal.__VITE_PLUGIN_TARO_WX_UPDATE_CLIENT__?.refreshCompleted(false)
-    })
-}
-
-function dispatchPageRuntime(event: PageRuntimeEvent): void {
-    pageRuntimeState = transitionPageRuntime(pageRuntimeState, event)
-}
-
-function transitionPageRuntime(state: PageRuntimeState, event: PageRuntimeEvent): PageRuntimeState {
-    switch (event.type) {
-        case 'page-activated':
-            return { ...state, activePage: event.page }
-        case 'page-unloaded':
-            return state.activePage === event.page ? { ...state, activePage: undefined } : state
-        case 'update-started':
-            return {
-                ...state,
-                pendingUpdate: { page: state.activePage, root: event.root },
-                suppressLifecycles: true
-            }
-        case 'suppression-ended':
-            return { ...state, suppressLifecycles: false }
-        case 'refresh-finished':
-            return { ...state, pendingUpdate: undefined }
-    }
-}
-
-function refreshTaroRoot(root: TaroRoot | undefined, page: WxPage | undefined): void {
-    if (!root) return
-    root.ctx = page ?? null
-    root.updateChildNodes()
-    root.performUpdate(true)
-}
-
-function relaunchActiveRoute(page: WxPage | undefined): void {
-    const route = wxRuntimeGlobal.getCurrentPages().at(-1)?.route
-    if (!route) return
-    const query = Object.entries(page?.$taroParams ?? {})
-        .filter(([key, value]) => key !== '$taroTimestamp' && value !== undefined)
-        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`)
-        .join('&')
-    runInNextNativeTask(() => wxRuntimeGlobal.wx.reLaunch({ url: `/${route}${query ? `?${query}` : ''}` }))
-}
-
-/**
- * DevTools dispatches synthetic page lifecycles after the changed module returns. A macrotask—not a microtask—runs
- * after that native turn and also avoids navigation or Taro root mutation from inside React Refresh's callback.
- */
-function runInNextNativeTask(task: () => void): void {
-    setTimeout(task)
-}