@taro-hmr-compile/plugin-webpack 0.0.1-alpha.7 → 0.0.1-alpha.8

package/src/patch/hmr-patch-processor.ts

@@ -0,0 +1,149 @@
+import {type Compilation,} from "webpack";
+import generator from '@babel/generator'
+import {
+    parseHotUpdateAssets,
+    ParseHotUpdateAssetsOptions,
+    parseChunkAsset, mergeUpdatePatches, generatePatchAssetSource,
+} from "./utils";
+import {createHash} from "crypto";
+import {ModuleFactory, UpdatePatchSource} from "./types";
+import {DEFAULT_HMR_PATCH_HISTORY_LIMIT} from "../constants";
+
+interface ModuleHash {
+    moduleId: string;
+    factoryHash: string;
+}
+
+interface ProcessChunkModulesOptions {
+    source: string
+    compilation: Compilation,
+    isBootstrapChunk: boolean
+}
+
+export interface HmrPatchProcessorOptions {
+    patchHistoryLimit?: number
+}
+
+interface ProcessUpdateOptions extends ParseHotUpdateAssetsOptions {
+    fromHash: string
+    toHash: string
+}
+
+type BootstrapFactories = Map<string, ModuleFactory>
+
+type ModuleHashesByFullHash = Map<string, Map<string, ModuleHash>>
+
+export class HmrPatchProcessor {
+    private readonly bootstrapFactories: BootstrapFactories = new Map()
+
+    private readonly bootstrapFactoriesByCompilation = new WeakMap<Compilation, BootstrapFactories>()
+
+    private readonly moduleHashesByFullHash: ModuleHashesByFullHash = new Map()
+
+    private recentUpdatePatches: UpdatePatchSource[] = []
+
+    private readonly opts: Partial<HmrPatchProcessorOptions>
+
+    constructor(opts: Partial<HmrPatchProcessorOptions>) {
+        this.opts = opts
+    }
+
+    private getChangedModuleIdsByFullHash(fromHash: string, toHash: string): Set<string> | undefined {
+        const fromModuleHashes = this.moduleHashesByFullHash.get(fromHash)
+
+        const toModuleHashes = this.moduleHashesByFullHash.get(toHash)
+
+        // 任一编译缺少 Hash 基线时不做过滤，避免误丢有效的 hot-update 模块。
+        if (!fromModuleHashes || !toModuleHashes) return
+
+        // 同时检查前后两次编译的模块，确保新增、修改和删除都能被识别。
+        const moduleIds = new Set(fromModuleHashes.keys())
+        toModuleHashes.forEach((_, moduleId) => moduleIds.add(moduleId))
+
+        const changedModuleIds = new Set<string>()
+        moduleIds.forEach(moduleId => {
+            const fromFactoryHash = fromModuleHashes.get(moduleId)?.factoryHash
+            const toFactoryHash = toModuleHashes.get(moduleId)?.factoryHash
+            if (fromFactoryHash !== toFactoryHash) changedModuleIds.add(moduleId)
+        })
+
+        return changedModuleIds
+    }
+
+    processUpdate(opt: ProcessUpdateOptions) {
+        const {fromHash, toHash} = opt
+
+        const tempPatchInfo = parseHotUpdateAssets(opt)
+
+        const changedModuleIds = this.getChangedModuleIdsByFullHash(fromHash, toHash)
+
+        const moduleFactories = (() => {
+            if (!changedModuleIds) return Array.from(tempPatchInfo.moduleFactories.values())
+            return Array.from(tempPatchInfo.moduleFactories.values()).filter(item => changedModuleIds.has(item.moduleId))
+        })()
+
+        const removedModules = (() => {
+            if (!changedModuleIds) return Array.from(tempPatchInfo.removedModules.values())
+            return Array.from(tempPatchInfo.removedModules.values()).filter(item => changedModuleIds.has(item))
+        })()
+
+        this.recentUpdatePatches.push({type: 'update', moduleFactories, fromHash, toHash, removedModules})
+
+        const patchHistoryLimit = Math.max(1, this.opts.patchHistoryLimit ?? DEFAULT_HMR_PATCH_HISTORY_LIMIT)
+
+        if (this.recentUpdatePatches.length <= patchHistoryLimit) return
+
+        const [oldestUpdatePatch, secondOldestUpdatePatch, ...rest] = this.recentUpdatePatches
+
+        const mergedUpdatePatch = mergeUpdatePatches(oldestUpdatePatch, secondOldestUpdatePatch)
+
+        this.recentUpdatePatches = [mergedUpdatePatch, ...rest]
+
+        this.moduleHashesByFullHash.delete(oldestUpdatePatch.toHash)
+    }
+
+    processChunkModules(opt: ProcessChunkModulesOptions) {
+        const {hash: fullHash} = opt.compilation
+        const modules = parseChunkAsset(opt.source)
+        modules.forEach(moduleFactory => {
+            const {moduleId, factory} = moduleFactory
+
+            if (opt.isBootstrapChunk) {
+                const compilationFactories = this.bootstrapFactoriesByCompilation.get(opt.compilation) ?? new Map()
+                compilationFactories.set(moduleId, {moduleId, factory})
+                this.bootstrapFactoriesByCompilation.set(opt.compilation, compilationFactories)
+            }
+
+            if (!fullHash) return
+
+            const moduleHashes = (() => {
+                const hasCurFullHashModuleHashMap = this.moduleHashesByFullHash.has(fullHash)
+                if (!hasCurFullHashModuleHashMap) this.moduleHashesByFullHash.set(fullHash, new Map())
+                return this.moduleHashesByFullHash.get(fullHash)!
+            })()
+
+            const {code: source} = generator(factory, {compact: true, comments: false, minified: true,})
+            const factoryHash = createHash('sha256').update(source).digest('hex')
+            moduleHashes.set(moduleId, {moduleId, factoryHash})
+        })
+    }
+
+    commitBootstrapFactories(compilation: Compilation) {
+        this.bootstrapFactories.clear()
+        this.bootstrapFactoriesByCompilation.get(compilation)?.forEach(moduleFactory => {
+            this.bootstrapFactories.set(moduleFactory.moduleId, moduleFactory)
+        })
+        this.bootstrapFactoriesByCompilation.delete(compilation)
+    }
+
+    generate() {
+        const {bootstrapFactories, recentUpdatePatches} = this
+        return generatePatchAssetSource({bootstrapFactories, recentUpdatePatches})
+    }
+
+    reset() {
+        this.bootstrapFactories.clear()
+        this.moduleHashesByFullHash.clear()
+        this.recentUpdatePatches = []
+    }
+}

package/src/patch/types.ts

@@ -0,0 +1,19 @@
+import type {Expression} from "@babel/types";
+
+export interface ModuleFactory {
+    factory: Expression,
+    moduleId: string
+}
+
+export interface HotUpdateManifest {
+    m?: Array<string | number>
+}
+
+export interface UpdatePatchSource {
+    type: 'update'
+    fromHash: string
+    toHash: string
+    moduleFactories: ModuleFactory[]
+    removedModules: string[]
+}
+

package/src/patch/utils.ts

@@ -0,0 +1,174 @@
+import * as t from "@babel/types";
+import {parse} from "@babel/parser";
+import traverse from "@babel/traverse";
+import template from "@babel/template";
+import generator from "@babel/generator";
+import {Asset} from "webpack";
+import {HotUpdateManifest, ModuleFactory} from "./types";
+import type {ObjectExpression} from "@babel/types";
+import {UpdatePatchSource} from "./types";
+
+
+/**
+ * 解析模块 Factory
+ * @param expression
+ */
+const parseModuleFactories = (expression: ObjectExpression) => {
+
+    const moduleFactories = new Map<string, ModuleFactory>()
+
+    if (!t.isObjectExpression(expression)) return moduleFactories.values()
+
+    expression.properties.forEach(property => {
+        if (!t.isObjectProperty(property) || !t.isExpression(property.value)) throw new Error('[taro-hmr-compile] HMR 模块对象包含无法识别的属性')
+
+        const {key, value: factory} = property
+
+        const moduleId = (() => {
+            if (t.isStringLiteral(key) || t.isNumericLiteral(key)) return String(key.value)
+            if (t.isIdentifier(key) && !property.computed) return key.name
+            throw new Error('[taro-hmr-compile] Chunk 模块对象包含无法识别的模块 ID')
+        })()
+
+        moduleFactories.set(moduleId, {factory, moduleId})
+    })
+
+    return moduleFactories.values()
+}
+
+
+export interface ParseHotUpdateAssetsOptions {
+    manifests: Readonly<Asset>[]
+    scripts: Readonly<Asset>[]
+}
+
+/**
+ * 解析热更新产物
+ * @param opt
+ */
+export const parseHotUpdateAssets = (opt: ParseHotUpdateAssetsOptions) => {
+    const {manifests, scripts} = opt
+
+    const moduleFactories = new Map<string, ModuleFactory>()
+
+    scripts.forEach(asset => {
+
+        const ast = parse(asset.source.source().toString(), {sourceType: 'script'})
+
+        traverse(ast, {
+            CallExpression(nodePath) {
+                const {callee} = nodePath.node
+
+                if (!t.isMemberExpression(callee) || !t.isIdentifier(callee.object, {name: 'wx'})) return
+
+                if (!t.isStringLiteral(callee.property) || !callee.property.value.startsWith('webpackHotUpdate')) return
+
+                const [_, modules] = nodePath.node.arguments
+
+                if (!t.isObjectExpression(modules)) return
+
+                parseModuleFactories(modules).forEach(module => moduleFactories.set(module.moduleId, module))
+            },
+        })
+    })
+
+    const removedModules = new Set<string>()
+
+    manifests.forEach((module) => {
+
+        const manifest = JSON.parse(module.source.source().toString()) as HotUpdateManifest
+
+        const {m: tempRemoveModules = []} = manifest
+
+        tempRemoveModules.forEach(removedModule => removedModules.add(String(removedModule)))
+    }, [])
+
+    return {moduleFactories, removedModules}
+}
+
+/**
+ * 解析 chunk 产物
+ * @param source
+ */
+export const parseChunkAsset = (source: string): Map<string, ModuleFactory> => {
+    const ast = parse(`(${source})`, {sourceType: 'script'})
+
+    const [statement] = ast.program.body
+
+    if (!t.isExpressionStatement(statement) || !t.isObjectExpression(statement.expression)) throw new Error('[taro-hmr-compile] Chunk 模块段不是对象表达式')
+
+    const moduleFactories = new Map<string, ModuleFactory>()
+
+    parseModuleFactories(statement.expression).forEach(module => moduleFactories.set(module.moduleId, module))
+
+    return moduleFactories
+}
+
+export const mergeUpdatePatches = (basePatch: UpdatePatchSource, nextPatch: UpdatePatchSource,): UpdatePatchSource => {
+    if (basePatch.toHash !== nextPatch.fromHash) throw new Error(`[taro-hmr-compile] 无法合并不连续的 HMR patch：${basePatch.toHash} !== ${nextPatch.fromHash}`)
+
+    const moduleFactories = new Map(basePatch.moduleFactories.map(moduleFactory => [moduleFactory.moduleId, moduleFactory]))
+
+    const removedModules = new Set(basePatch.removedModules)
+
+    nextPatch.moduleFactories.forEach(moduleFactory => {
+        const {moduleId} = moduleFactory
+        moduleFactories.set(moduleId, moduleFactory)
+        removedModules.delete(moduleId)
+    })
+
+    nextPatch.removedModules.forEach(moduleId => {
+        moduleFactories.delete(moduleId)
+        removedModules.add(moduleId)
+    })
+
+    return {
+        type: 'update',
+        fromHash: basePatch.fromHash,
+        toHash: nextPatch.toHash,
+        moduleFactories: [...moduleFactories.values()],
+        removedModules: [...removedModules],
+    }
+}
+
+export interface generatePatchAssetSourceOpts {
+    bootstrapFactories: Map<string, ModuleFactory>
+    recentUpdatePatches: UpdatePatchSource[]
+}
+
+export const generatePatchAssetSource = (opt: generatePatchAssetSourceOpts): string => {
+    const {bootstrapFactories, recentUpdatePatches} = opt
+    const buildBootstrapPatch = template.expression(`({
+        type: 'bootstrap',
+        modules: MODULES
+    })`)
+    const buildUpdatePatch = template.expression(`({
+        type: 'update',
+        fromHash: "FROM_HASH",
+        toHash: "TO_HASH",
+        modules: MODULES,
+        removedModules: REMOVED_MODULES
+    })`)
+    const buildPatchAsset = template.program('module.exports = PATCHES;')
+    const bootstrapModules = Array.from(bootstrapFactories.values()).map((moduleFactory) => {
+        const {moduleId, factory} = moduleFactory
+        return t.objectProperty(t.stringLiteral(moduleId), factory)
+    })
+    const patchNodes = [
+        buildBootstrapPatch({MODULES: t.objectExpression(bootstrapModules)}),
+        ...recentUpdatePatches.map(patch => {
+            const updateModules = patch.moduleFactories.map((moduleFactory) => {
+                const {moduleId, factory} = moduleFactory
+                return t.objectProperty(t.stringLiteral(moduleId), factory)
+            })
+            return buildUpdatePatch({
+                FROM_HASH: patch.fromHash,
+                TO_HASH: patch.toHash,
+                MODULES: t.objectExpression(updateModules),
+                REMOVED_MODULES: t.arrayExpression(patch.removedModules.map(moduleId => t.stringLiteral(moduleId))),
+            })
+        }),
+    ]
+
+    return generator(buildPatchAsset({PATCHES: t.arrayExpression(patchNodes)})).code
+}

package/dist/patch/hmr-patch-manager.d.ts

@@ -1,30 +0,0 @@
-import type { Expression } from '@babel/types';
-export interface BootstrapPatchSource {
-    type: 'bootstrap';
-    moduleFactories: Map<string, Expression>;
-}
-export interface UpdatePatchSource {
-    type: 'update';
-    fromHash: string;
-    toHash: string;
-    moduleFactories: Map<string, Expression>;
-    removedModules: string[];
-}
-export type PatchSource = BootstrapPatchSource | UpdatePatchSource;
-/** 仅维护 bootstrap/update Patch 状态、连续性和压缩，不依赖 Webpack 编译对象。 */
-export declare class HmrPatchManager {
-    private bootstrapPatch?;
-    private compactedUpdatePatch?;
-    private readonly recentUpdatePatches;
-    private readonly limit;
-    constructor(limit: number);
-    clear(): void;
-    setBootstrap(moduleFactories: Map<string, Expression>): void;
-    /** 追加 update；发现 hash 不连续时丢弃旧 update 链，并在追加后执行容量压缩。 */
-    appendUpdate(patch: UpdatePatchSource): void;
-    /** 按客户端消费顺序返回 bootstrap、压缩 update 与近期 update。 */
-    getPatches(): PatchSource[];
-    private clearUpdateHistory;
-    /** 将超出上限的旧 update 逐步合并到首个 update；bootstrap 永不参与 merge。 */
-    private compactUpdateHistory;
-}

package/dist/patch/hmr-patch-manager.js

@@ -1,75 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HmrPatchManager = void 0;
-/** 合并两个连续 update，并按后一份 update 的最终模块状态解决修改和删除冲突。 */
-const mergeUpdatePatches = (basePatch, nextPatch) => {
-    if (basePatch.toHash !== nextPatch.fromHash) {
-        throw new Error(`[taro-hmr-compile] 无法合并不连续的 HMR patch：${basePatch.toHash} !== ${nextPatch.fromHash}`);
-    }
-    const moduleFactories = new Map(basePatch.moduleFactories);
-    const removedModules = new Set(basePatch.removedModules);
-    nextPatch.moduleFactories.forEach((factory, moduleId) => {
-        moduleFactories.set(moduleId, factory);
-        removedModules.delete(moduleId);
-    });
-    nextPatch.removedModules.forEach(moduleId => {
-        moduleFactories.delete(moduleId);
-        removedModules.add(moduleId);
-    });
-    return {
-        type: 'update',
-        fromHash: basePatch.fromHash,
-        toHash: nextPatch.toHash,
-        moduleFactories,
-        removedModules: Array.from(removedModules),
-    };
-};
-/** 仅维护 bootstrap/update Patch 状态、连续性和压缩，不依赖 Webpack 编译对象。 */
-class HmrPatchManager {
-    constructor(limit) {
-        this.recentUpdatePatches = [];
-        this.limit = Math.max(1, limit);
-    }
-    clear() {
-        this.bootstrapPatch = undefined;
-        this.clearUpdateHistory();
-    }
-    setBootstrap(moduleFactories) {
-        this.bootstrapPatch = moduleFactories.size > 0
-            ? { type: 'bootstrap', moduleFactories: new Map(moduleFactories) }
-            : undefined;
-    }
-    /** 追加 update；发现 hash 不连续时丢弃旧 update 链，并在追加后执行容量压缩。 */
-    appendUpdate(patch) {
-        var _a;
-        const latestPatch = (_a = this.recentUpdatePatches[this.recentUpdatePatches.length - 1]) !== null && _a !== void 0 ? _a : this.compactedUpdatePatch;
-        if (latestPatch && latestPatch.toHash !== patch.fromHash)
-            this.clearUpdateHistory();
-        this.recentUpdatePatches.push(patch);
-        this.compactUpdateHistory();
-    }
-    /** 按客户端消费顺序返回 bootstrap、压缩 update 与近期 update。 */
-    getPatches() {
-        const updatePatches = this.compactedUpdatePatch
-            ? [this.compactedUpdatePatch, ...this.recentUpdatePatches]
-            : this.recentUpdatePatches;
-        return this.bootstrapPatch
-            ? [this.bootstrapPatch, ...updatePatches]
-            : updatePatches;
-    }
-    clearUpdateHistory() {
-        this.compactedUpdatePatch = undefined;
-        this.recentUpdatePatches.length = 0;
-    }
-    /** 将超出上限的旧 update 逐步合并到首个 update；bootstrap 永不参与 merge。 */
-    compactUpdateHistory() {
-        while (this.recentUpdatePatches.length > this.limit) {
-            const oldestUpdatePatch = this.recentUpdatePatches.shift();
-            this.compactedUpdatePatch = this.compactedUpdatePatch
-                ? mergeUpdatePatches(this.compactedUpdatePatch, oldestUpdatePatch)
-                : oldestUpdatePatch;
-        }
-    }
-}
-exports.HmrPatchManager = HmrPatchManager;
-//# sourceMappingURL=hmr-patch-manager.js.map

package/dist/patch/hmr-patch-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hmr-patch-manager.js","sourceRoot":"","sources":["../../src/patch/hmr-patch-manager.ts"],"names":[],"mappings":"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"}

package/src/patch/hmr-patch-manager.ts

@@ -1,102 +0,0 @@
-import type {Expression} from '@babel/types'
-
-export interface BootstrapPatchSource {
-    type: 'bootstrap'
-    moduleFactories: Map<string, Expression>
-}
-
-export interface UpdatePatchSource {
-    type: 'update'
-    fromHash: string
-    toHash: string
-    moduleFactories: Map<string, Expression>
-    removedModules: string[]
-}
-
-export type PatchSource = BootstrapPatchSource | UpdatePatchSource
-
-/** 合并两个连续 update，并按后一份 update 的最终模块状态解决修改和删除冲突。 */
-const mergeUpdatePatches = (basePatch: UpdatePatchSource, nextPatch: UpdatePatchSource): UpdatePatchSource => {
-    if (basePatch.toHash !== nextPatch.fromHash) {
-        throw new Error(`[taro-hmr-compile] 无法合并不连续的 HMR patch：${basePatch.toHash} !== ${nextPatch.fromHash}`)
-    }
-
-    const moduleFactories = new Map(basePatch.moduleFactories)
-    const removedModules = new Set(basePatch.removedModules)
-
-    nextPatch.moduleFactories.forEach((factory, moduleId) => {
-        moduleFactories.set(moduleId, factory)
-        removedModules.delete(moduleId)
-    })
-    nextPatch.removedModules.forEach(moduleId => {
-        moduleFactories.delete(moduleId)
-        removedModules.add(moduleId)
-    })
-
-    return {
-        type: 'update',
-        fromHash: basePatch.fromHash,
-        toHash: nextPatch.toHash,
-        moduleFactories,
-        removedModules: Array.from(removedModules),
-    }
-}
-
-/** 仅维护 bootstrap/update Patch 状态、连续性和压缩，不依赖 Webpack 编译对象。 */
-export class HmrPatchManager {
-    private bootstrapPatch?: BootstrapPatchSource
-
-    private compactedUpdatePatch?: UpdatePatchSource
-
-    private readonly recentUpdatePatches: UpdatePatchSource[] = []
-
-    private readonly limit: number
-
-    constructor(limit: number) {
-        this.limit = Math.max(1, limit)
-    }
-
-    clear() {
-        this.bootstrapPatch = undefined
-        this.clearUpdateHistory()
-    }
-
-    setBootstrap(moduleFactories: Map<string, Expression>) {
-        this.bootstrapPatch = moduleFactories.size > 0
-            ? {type: 'bootstrap', moduleFactories: new Map(moduleFactories)}
-            : undefined
-    }
-
-    /** 追加 update；发现 hash 不连续时丢弃旧 update 链，并在追加后执行容量压缩。 */
-    appendUpdate(patch: UpdatePatchSource) {
-        const latestPatch = this.recentUpdatePatches[this.recentUpdatePatches.length - 1] ?? this.compactedUpdatePatch
-        if (latestPatch && latestPatch.toHash !== patch.fromHash) this.clearUpdateHistory()
-        this.recentUpdatePatches.push(patch)
-        this.compactUpdateHistory()
-    }
-
-    /** 按客户端消费顺序返回 bootstrap、压缩 update 与近期 update。 */
-    getPatches(): PatchSource[] {
-        const updatePatches = this.compactedUpdatePatch
-            ? [this.compactedUpdatePatch, ...this.recentUpdatePatches]
-            : this.recentUpdatePatches
-        return this.bootstrapPatch
-            ? [this.bootstrapPatch, ...updatePatches]
-            : updatePatches
-    }
-
-    private clearUpdateHistory() {
-        this.compactedUpdatePatch = undefined
-        this.recentUpdatePatches.length = 0
-    }
-
-    /** 将超出上限的旧 update 逐步合并到首个 update；bootstrap 永不参与 merge。 */
-    private compactUpdateHistory() {
-        while (this.recentUpdatePatches.length > this.limit) {
-            const oldestUpdatePatch = this.recentUpdatePatches.shift()!
-            this.compactedUpdatePatch = this.compactedUpdatePatch
-                ? mergeUpdatePatches(this.compactedUpdatePatch, oldestUpdatePatch)
-                : oldestUpdatePatch
-        }
-    }
-}