@utoo/pack 1.4.3 → 1.4.4-alpha.1

package/cjs/binding.d.ts

@@ -9,6 +9,11 @@ export declare class ExternalObject<T> {
     [K: symbol]: T
   }
 }
+export type Lockfile = { __napiType: "Lockfile" }
+export declare function lockfileTryAcquireSync(path: string, content?: string | undefined | null): Lockfile | null
+export declare function lockfileTryAcquire(path: string, content?: string | undefined | null): Promise<Lockfile | null>
+export declare function lockfileUnlockSync(lockfile: Lockfile): void
+export declare function lockfileUnlock(lockfile: Lockfile): Promise<void>
 export declare function registerWorkerScheduler(creator: (arg: NapiWorkerCreation) => any, terminator: (arg: NapiWorkerTermination) => any): void
 export declare function workerCreated(workerId: number): void
 export interface NapiWorkerCreation {

package/cjs/binding.js

@@ -319,7 +319,11 @@ if (!nativeBinding) {
     }
     throw new Error(`Failed to load native binding`);
 }
-const { registerWorkerScheduler, workerCreated, recvTaskMessageInWorker, sendTaskMessage, endpointWriteToDisk, endpointServerChangedSubscribe, endpointClientChangedSubscribe, projectNew, projectUpdate, projectOnExit, projectShutdown, projectWriteAllEntrypointsToDisk, projectEntrypointsSubscribe, projectHmrEvents, projectHmrIdentifiersSubscribe, projectUpdateInfoSubscribe, projectTraceSource, projectGetSourceForAsset, projectGetSourceMap, projectGetSourceMapSync, rootTaskDispose, initCustomTraceSubscriber, teardownTraceSubscriber } = nativeBinding;
+const { lockfileTryAcquireSync, lockfileTryAcquire, lockfileUnlockSync, lockfileUnlock, registerWorkerScheduler, workerCreated, recvTaskMessageInWorker, sendTaskMessage, endpointWriteToDisk, endpointServerChangedSubscribe, endpointClientChangedSubscribe, projectNew, projectUpdate, projectOnExit, projectShutdown, projectWriteAllEntrypointsToDisk, projectEntrypointsSubscribe, projectHmrEvents, projectHmrIdentifiersSubscribe, projectUpdateInfoSubscribe, projectTraceSource, projectGetSourceForAsset, projectGetSourceMap, projectGetSourceMapSync, rootTaskDispose, initCustomTraceSubscriber, teardownTraceSubscriber } = nativeBinding;
+module.exports.lockfileTryAcquireSync = lockfileTryAcquireSync;
+module.exports.lockfileTryAcquire = lockfileTryAcquire;
+module.exports.lockfileUnlockSync = lockfileUnlockSync;
+module.exports.lockfileUnlock = lockfileUnlock;
 module.exports.registerWorkerScheduler = registerWorkerScheduler;
 module.exports.workerCreated = workerCreated;
 module.exports.recvTaskMessageInWorker = recvTaskMessageInWorker;

package/cjs/commands/build.js

@@ -12,11 +12,13 @@ const path_1 = __importDefault(require("path"));
 const webpackCompat_1 = require("../config/webpackCompat");
 const project_1 = require("../core/project");
 const HtmlPlugin_1 = require("../plugins/HtmlPlugin");
+const cleanOutput_1 = require("../utils/cleanOutput");
 const common_1 = require("../utils/common");
 const findRoot_1 = require("../utils/findRoot");
 const getInitialAssets_1 = require("../utils/getInitialAssets");
 const htmlEntry_1 = require("../utils/htmlEntry");
-const normalize_path_1 = require("../utils/normalize-path");
+const lockfile_1 = require("../utils/lockfile");
+const normalizePath_1 = require("../utils/normalizePath");
 const runtimePluginStratety_1 = require("../utils/runtimePluginStratety");
 const validateEntry_1 = require("../utils/validateEntry");
 const xcodeProfile_1 = require("../utils/xcodeProfile");
@@ -29,7 +31,7 @@ function build(options, projectPath, rootPath) {
     return buildInternal(bundleOptions, projectPath, rootPath);
 }
 async function buildInternal(bundleOptions, projectPath, rootPath) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     (0, common_1.blockStdout)();
     if (process.env.XCODE_PROFILE) {
         await (0, xcodeProfile_1.xcodeProfilingReady)();
@@ -39,62 +41,70 @@ async function buildInternal(bundleOptions, projectPath, rootPath) {
     const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : false;
     (0, htmlEntry_1.processHtmlEntry)(bundleOptions.config, resolvedProjectPath);
     (0, validateEntry_1.validateEntryPaths)(bundleOptions.config, resolvedProjectPath);
+    await (0, cleanOutput_1.cleanOutput)(bundleOptions.config, resolvedProjectPath);
     const createProject = (0, project_1.projectFactory)();
-    const project = await createProject({
-        processEnv: (_b = bundleOptions.processEnv) !== null && _b !== void 0 ? _b : {},
-        watch: {
-            enable: false,
-        },
-        dev: (_c = bundleOptions.dev) !== null && _c !== void 0 ? _c : false,
-        buildId: bundleOptions.buildId || (0, nanoid_1.nanoid)(),
-        tracing: (_d = bundleOptions.tracing) !== null && _d !== void 0 ? _d : true,
-        config: {
-            ...bundleOptions.config,
-            stats: Boolean(process.env.ANALYZE) ||
-                bundleOptions.config.stats ||
-                bundleOptions.config.entry.some((e) => !!e.html),
-            pluginRuntimeStrategy: (_f = (_e = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _e === void 0 ? void 0 : _e.pluginRuntimeStrategy) !== null && _f !== void 0 ? _f : ((0, runtimePluginStratety_1.useWorkerThreads)() ? "workerThreads" : "childProcesses"),
-        },
-        projectPath: (0, normalize_path_1.normalizePath)(resolvedProjectPath),
-        rootPath: resolvedRootPath,
-        packPath: (0, common_1.getPackPath)(),
-    }, {
-        persistentCaching,
-        // Build mode is a short-lived, one-shot compilation, so avoid paying
-        // dependency graph bookkeeping cost unless the persistent cache needs it.
-        dependencyTracking: persistentCaching,
-        isShortSession: true,
-    });
-    const entrypoints = await project.writeAllEntrypointsToDisk();
-    (0, pack_shared_1.handleIssues)(entrypoints.issues);
-    const htmlConfigs = [
-        ...(Array.isArray(bundleOptions.config.html)
-            ? bundleOptions.config.html
-            : bundleOptions.config.html
-                ? [bundleOptions.config.html]
-                : []),
-        ...bundleOptions.config.entry
-            .filter((e) => !!e.html)
-            .map((e) => e.html),
-    ];
-    if (htmlConfigs.length > 0) {
-        const assets = { js: [], css: [] };
-        const outputDir = ((_g = bundleOptions.config.output) === null || _g === void 0 ? void 0 : _g.path) || path_1.default.join(process.cwd(), "dist");
-        if (assets.js.length === 0 && assets.css.length === 0) {
-            const discovered = (0, getInitialAssets_1.getInitialAssetsFromStats)(outputDir);
-            assets.js.push(...discovered.js);
-            assets.css.push(...discovered.css);
+    const persistentCacheLock = await (0, lockfile_1.acquirePersistentCacheLock)(resolvedProjectPath, "utoo pack build", persistentCaching);
+    let project;
+    try {
+        project = await createProject({
+            processEnv: (_b = bundleOptions.processEnv) !== null && _b !== void 0 ? _b : {},
+            watch: {
+                enable: false,
+            },
+            dev: (_c = bundleOptions.dev) !== null && _c !== void 0 ? _c : false,
+            buildId: bundleOptions.buildId || (0, nanoid_1.nanoid)(),
+            tracing: (_d = bundleOptions.tracing) !== null && _d !== void 0 ? _d : true,
+            config: {
+                ...bundleOptions.config,
+                stats: Boolean(process.env.ANALYZE) ||
+                    bundleOptions.config.stats ||
+                    bundleOptions.config.entry.some((e) => !!e.html),
+                pluginRuntimeStrategy: (_f = (_e = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _e === void 0 ? void 0 : _e.pluginRuntimeStrategy) !== null && _f !== void 0 ? _f : ((0, runtimePluginStratety_1.useWorkerThreads)() ? "workerThreads" : "childProcesses"),
+            },
+            projectPath: (0, normalizePath_1.normalizePath)(resolvedProjectPath),
+            rootPath: resolvedRootPath,
+            packPath: (0, common_1.getPackPath)(),
+        }, {
+            persistentCaching,
+            // Build mode is a short-lived, one-shot compilation, so avoid paying
+            // dependency graph bookkeeping cost unless the persistent cache needs it.
+            dependencyTracking: persistentCaching,
+            isShortSession: true,
+        });
+        const entrypoints = await project.writeAllEntrypointsToDisk();
+        (0, pack_shared_1.handleIssues)(entrypoints.issues);
+        const htmlConfigs = [
+            ...(Array.isArray(bundleOptions.config.html)
+                ? bundleOptions.config.html
+                : bundleOptions.config.html
+                    ? [bundleOptions.config.html]
+                    : []),
+            ...bundleOptions.config.entry
+                .filter((e) => !!e.html)
+                .map((e) => e.html),
+        ];
+        if (htmlConfigs.length > 0) {
+            const assets = { js: [], css: [] };
+            const outputDir = (0, cleanOutput_1.getOutputPath)(bundleOptions.config, resolvedProjectPath);
+            if (assets.js.length === 0 && assets.css.length === 0) {
+                const discovered = (0, getInitialAssets_1.getInitialAssetsFromStats)(outputDir);
+                assets.js.push(...discovered.js);
+                assets.css.push(...discovered.css);
+            }
+            const publicPath = (_g = bundleOptions.config.output) === null || _g === void 0 ? void 0 : _g.publicPath;
+            for (const config of htmlConfigs) {
+                const plugin = new HtmlPlugin_1.HtmlPlugin(config);
+                await plugin.generate(outputDir, assets, publicPath);
+            }
         }
-        const publicPath = (_h = bundleOptions.config.output) === null || _h === void 0 ? void 0 : _h.publicPath;
-        for (const config of htmlConfigs) {
-            const plugin = new HtmlPlugin_1.HtmlPlugin(config);
-            await plugin.generate(outputDir, assets, publicPath);
+        if (process.env.ANALYZE) {
+            await analyzeBundle(((_h = bundleOptions.config.output) === null || _h === void 0 ? void 0 : _h.path) || "dist");
         }
     }
-    if (process.env.ANALYZE) {
-        await analyzeBundle(((_j = bundleOptions.config.output) === null || _j === void 0 ? void 0 : _j.path) || "dist");
+    finally {
+        await (project === null || project === void 0 ? void 0 : project.shutdown());
+        persistentCacheLock === null || persistentCacheLock === void 0 ? void 0 : persistentCacheLock.unlockSync();
     }
-    await project.shutdown();
     // TODO: Maybe run tasks in worker is a better way, see
     // https://github.com/vercel/next.js/blob/512d8283054407ab92b2583ecce3b253c3be7b85/packages/next/src/lib/worker.ts
 }

package/cjs/commands/dev.js

@@ -15,10 +15,10 @@ const fs_1 = __importDefault(require("fs"));
 const get_port_1 = __importDefault(require("get-port"));
 const hono_1 = require("hono");
 const https_1 = __importDefault(require("https"));
-const path_1 = __importDefault(require("path"));
 const webpackCompat_1 = require("../config/webpackCompat");
 const hmr_1 = require("../core/hmr");
-const proxy_hono_1 = require("../core/proxy-hono");
+const proxyHono_1 = require("../core/proxyHono");
+const cleanOutput_1 = require("../utils/cleanOutput");
 const common_1 = require("../utils/common");
 const findRoot_1 = require("../utils/findRoot");
 const mkcert_1 = require("../utils/mkcert");
@@ -139,7 +139,7 @@ function serve(options, projectPath, rootPath, serverOptions) {
 }
 const HMR_PATH = "/turbopack-hmr";
 async function runDev(options, projectPath, rootPath, serverOptions) {
-    var _a, _b, _d, _e, _f, _g, _h;
+    var _a, _b, _d, _e, _f;
     (0, common_1.blockStdout)();
     process.title = "utoopack-dev-server";
     if (process.env.XCODE_PROFILE) {
@@ -149,8 +149,8 @@ async function runDev(options, projectPath, rootPath, serverOptions) {
     const { bundleOptions, projectPathResolved, rootPathResolved, serveOptsBase, } = await resolveDevConfig(options, projectPath, rootPath, serverOptions);
     const hotReloader = await (0, hmr_1.createHotReloader)(bundleOptions, projectPathResolved, rootPathResolved);
     await hotReloader.start();
-    const distRoot = path_1.default.resolve(projectPathResolved, ((_b = (_a = options.config) === null || _a === void 0 ? void 0 : _a.output) === null || _b === void 0 ? void 0 : _b.path) || "./dist");
-    const publicPath = (_e = (_d = options.config) === null || _d === void 0 ? void 0 : _d.output) === null || _e === void 0 ? void 0 : _e.publicPath;
+    const distRoot = (0, cleanOutput_1.getOutputPath)(options.config, projectPathResolved);
+    const publicPath = (_b = (_a = options.config) === null || _a === void 0 ? void 0 : _a.output) === null || _b === void 0 ? void 0 : _b.publicPath;
     // Skip prefix stripping for "runtime" and when publicPath is absent (match dev.ts).
     const normalizedPrefix = publicPath && publicPath !== "runtime"
         ? normalizedPublicPath(publicPath)
@@ -191,9 +191,9 @@ async function runDev(options, projectPath, rootPath, serverOptions) {
             console.error("HMR WebSocket error", err);
         },
     })));
-    const proxyRules = (_g = (_f = bundleOptions.config) === null || _f === void 0 ? void 0 : _f.devServer) === null || _g === void 0 ? void 0 : _g.proxy;
+    const proxyRules = (_e = (_d = bundleOptions.config) === null || _d === void 0 ? void 0 : _d.devServer) === null || _e === void 0 ? void 0 : _e.proxy;
     if (proxyRules && proxyRules.length > 0) {
-        app.use("*", (0, proxy_hono_1.createHttpProxyMiddleware)(proxyRules));
+        app.use("*", (0, proxyHono_1.createHttpProxyMiddleware)(proxyRules));
     }
     // GET handles HEAD automatically in Hono; serveStatic serves both
     app.get("/*", (0, serve_static_1.serveStatic)({
@@ -220,7 +220,7 @@ async function runDev(options, projectPath, rootPath, serverOptions) {
             server.once("error", onError);
         });
     }
-    await ((_h = serverOptions === null || serverOptions === void 0 ? void 0 : serverOptions.onReady) === null || _h === void 0 ? void 0 : _h.call(serverOptions, {
+    await ((_f = serverOptions === null || serverOptions === void 0 ? void 0 : serverOptions.onReady) === null || _f === void 0 ? void 0 : _f.call(serverOptions, {
         port: serveOptsBase.port,
         hostname: serveOptsBase.hostname,
     }));

package/cjs/core/hmr.js

@@ -1,19 +1,17 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FAST_REFRESH_RUNTIME_RELOAD = exports.HMR_ACTIONS_SENT_TO_BROWSER = void 0;
 exports.createHotReloader = createHotReloader;
 const pack_shared_1 = require("@utoo/pack-shared");
 const nanoid_1 = require("nanoid");
-const path_1 = __importDefault(require("path"));
 const ws_1 = require("ws");
 const HtmlPlugin_1 = require("../plugins/HtmlPlugin");
+const cleanOutput_1 = require("../utils/cleanOutput");
 const common_1 = require("../utils/common");
 const getInitialAssets_1 = require("../utils/getInitialAssets");
 const htmlEntry_1 = require("../utils/htmlEntry");
-const normalize_path_1 = require("../utils/normalize-path");
+const lockfile_1 = require("../utils/lockfile");
+const normalizePath_1 = require("../utils/normalizePath");
 const runtimePluginStratety_1 = require("../utils/runtimePluginStratety");
 const validateEntry_1 = require("../utils/validateEntry");
 const project_1 = require("./project");
@@ -29,35 +27,45 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
     const resolvedRootPath = rootPath || projectPath || process.cwd();
     (0, htmlEntry_1.processHtmlEntry)(bundleOptions.config, resolvedProjectPath);
     (0, validateEntry_1.validateEntryPaths)(bundleOptions.config, resolvedProjectPath);
+    await (0, cleanOutput_1.cleanOutput)(bundleOptions.config, resolvedProjectPath);
     const createProject = (0, project_1.projectFactory)();
-    const project = await createProject({
-        processEnv: (_a = bundleOptions.processEnv) !== null && _a !== void 0 ? _a : {},
-        watch: {
-            enable: true,
-        },
-        dev: true,
-        buildId: bundleOptions.buildId || (0, nanoid_1.nanoid)(),
-        tracing: (_b = bundleOptions.tracing) !== null && _b !== void 0 ? _b : true,
-        config: {
-            ...bundleOptions.config,
-            mode: "development",
-            stats: Boolean(process.env.ANALYZE) ||
-                bundleOptions.config.stats ||
-                bundleOptions.config.entry.some((e) => !!e.html),
-            optimization: {
-                ...bundleOptions.config.optimization,
-                minify: false,
-                moduleIds: "named",
+    const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : false;
+    const persistentCacheLock = await (0, lockfile_1.acquirePersistentCacheLock)(resolvedProjectPath, "utoo pack dev", persistentCaching);
+    let project;
+    try {
+        project = await createProject({
+            processEnv: (_b = bundleOptions.processEnv) !== null && _b !== void 0 ? _b : {},
+            watch: {
+                enable: true,
             },
-            persistentCaching: (_d = (_c = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _c === void 0 ? void 0 : _c.persistentCaching) !== null && _d !== void 0 ? _d : true,
-            pluginRuntimeStrategy: (_f = (_e = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _e === void 0 ? void 0 : _e.pluginRuntimeStrategy) !== null && _f !== void 0 ? _f : ((0, runtimePluginStratety_1.useWorkerThreads)() ? "workerThreads" : "childProcesses"),
-        },
-        projectPath: (0, normalize_path_1.normalizePath)(resolvedProjectPath),
-        rootPath: resolvedRootPath,
-        packPath: (0, common_1.getPackPath)(),
-    }, {
-        persistentCaching: (_g = bundleOptions.config.persistentCaching) !== null && _g !== void 0 ? _g : false,
-    });
+            dev: true,
+            buildId: bundleOptions.buildId || (0, nanoid_1.nanoid)(),
+            tracing: (_c = bundleOptions.tracing) !== null && _c !== void 0 ? _c : true,
+            config: {
+                ...bundleOptions.config,
+                mode: "development",
+                stats: Boolean(process.env.ANALYZE) ||
+                    bundleOptions.config.stats ||
+                    bundleOptions.config.entry.some((e) => !!e.html),
+                optimization: {
+                    ...bundleOptions.config.optimization,
+                    minify: false,
+                    moduleIds: "named",
+                },
+                persistentCaching: (_e = (_d = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _d === void 0 ? void 0 : _d.persistentCaching) !== null && _e !== void 0 ? _e : true,
+                pluginRuntimeStrategy: (_g = (_f = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _f === void 0 ? void 0 : _f.pluginRuntimeStrategy) !== null && _g !== void 0 ? _g : ((0, runtimePluginStratety_1.useWorkerThreads)() ? "workerThreads" : "childProcesses"),
+            },
+            projectPath: (0, normalizePath_1.normalizePath)(resolvedProjectPath),
+            rootPath: resolvedRootPath,
+            packPath: (0, common_1.getPackPath)(),
+        }, {
+            persistentCaching,
+        });
+    }
+    catch (error) {
+        persistentCacheLock === null || persistentCacheLock === void 0 ? void 0 : persistentCacheLock.unlockSync();
+        throw error;
+    }
     const entrypointsSubscription = project.entrypointsSubscribe();
     let currentEntriesHandlingResolve;
     let currentEntriesHandling = new Promise((resolve) => (currentEntriesHandlingResolve = resolve));
@@ -81,6 +89,7 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
     let backgroundWatchGeneration = 0;
     const backgroundWriteTasks = new Map();
     let closed = false;
+    let closePromise;
     function sendToClient(client, payload) {
         client.send(JSON.stringify(payload));
     }
@@ -115,12 +124,12 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
         sendEnqueuedMessagesDebounce();
     }
     async function regenerateHtml() {
-        var _a, _b;
+        var _a;
         if (htmlConfigs.length === 0) {
             return;
         }
-        const outputDir = ((_a = bundleOptions.config.output) === null || _a === void 0 ? void 0 : _a.path) || path_1.default.join(process.cwd(), "dist");
-        const publicPath = (_b = bundleOptions.config.output) === null || _b === void 0 ? void 0 : _b.publicPath;
+        const outputDir = (0, cleanOutput_1.getOutputPath)(bundleOptions.config, resolvedProjectPath);
+        const publicPath = (_a = bundleOptions.config.output) === null || _a === void 0 ? void 0 : _a.publicPath;
         const assets = (0, getInitialAssets_1.getInitialAssetsFromStats)(outputDir);
         for (const config of htmlConfigs) {
             const plugin = new HtmlPlugin_1.HtmlPlugin(config);
@@ -252,6 +261,7 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
         subscription === null || subscription === void 0 ? void 0 : subscription.return();
     }
     async function handleEntrypointsSubscription() {
+        var _a, _b;
         for await (const entrypoints of entrypointsSubscription) {
             if (!currentEntriesHandlingResolve) {
                 currentEntriesHandling = new Promise(
@@ -259,8 +269,8 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
                 (resolve) => (currentEntriesHandlingResolve = resolve));
             }
             currentWatchedEntrypoints = [
-                ...entrypoints.apps,
-                ...entrypoints.libraries,
+                ...((_a = entrypoints.apps) !== null && _a !== void 0 ? _a : []),
+                ...((_b = entrypoints.libraries) !== null && _b !== void 0 ? _b : []),
             ];
             await writeEntrypointsToDisk(currentWatchedEntrypoints);
             if (backgroundWatchersStarted) {
@@ -445,6 +455,14 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
         close() {
             closed = true;
             void disposeBackgroundWatchSubscriptions();
+            closePromise !== null && closePromise !== void 0 ? closePromise : (closePromise = project
+                .onExit()
+                .catch((err) => {
+                console.error(err);
+            })
+                .finally(() => {
+                persistentCacheLock === null || persistentCacheLock === void 0 ? void 0 : persistentCacheLock.unlockSync();
+            }));
             for (const wsClient of clients) {
                 wsClient.close();
             }

package/cjs/core/project.js

@@ -40,7 +40,7 @@ const path_1 = require("path");
 const util_1 = require("util");
 const binding = __importStar(require("../binding"));
 const common_1 = require("../utils/common");
-const normalize_path_1 = require("../utils/normalize-path");
+const normalizePath_1 = require("../utils/normalizePath");
 const loaderWorkerPool_1 = require("./loaderWorkerPool");
 /**
  * An error caused by a bug in Turbopack, and not the user's code (e.g. a Rust panic). These should
@@ -240,15 +240,15 @@ async function rustifyPartialProjectOptions(options) {
 function normalizePathOption(pathLike) {
     if (pathLike === undefined)
         return undefined;
-    return (0, normalize_path_1.normalizePath)(pathLike);
+    return (0, normalizePath_1.normalizePath)(pathLike);
 }
 async function rustifyProjectOptions(options) {
     var _a;
     return {
         ...options,
-        rootPath: (0, normalize_path_1.normalizePath)(options.rootPath),
-        projectPath: (0, normalize_path_1.normalizePath)(options.projectPath),
-        packPath: (0, normalize_path_1.normalizePath)(options.packPath),
+        rootPath: (0, normalizePath_1.normalizePath)(options.rootPath),
+        projectPath: (0, normalizePath_1.normalizePath)(options.projectPath),
+        packPath: (0, normalizePath_1.normalizePath)(options.packPath),
         config: await serializeConfig(options.config, options.dev),
         processEnv: (0, common_1.rustifyEnv)((_a = options.processEnv) !== null && _a !== void 0 ? _a : {}),
     };

package/cjs/utils/cleanOutput.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigComplete } from "../config/types";
+export declare function getOutputPath(config: ConfigComplete, projectPath: string): string;
+export declare function cleanOutput(config: ConfigComplete, projectPath: string): Promise<void>;

package/cjs/utils/cleanOutput.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOutputPath = getOutputPath;
+exports.cleanOutput = cleanOutput;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function getOutputPath(config, projectPath) {
+    var _a;
+    return path_1.default.resolve(projectPath, ((_a = config.output) === null || _a === void 0 ? void 0 : _a.path) || "dist");
+}
+async function cleanOutput(config, projectPath) {
+    var _a;
+    if (!((_a = config.output) === null || _a === void 0 ? void 0 : _a.clean)) {
+        return;
+    }
+    const outputPath = getOutputPath(config, projectPath);
+    let entries;
+    try {
+        entries = await fs_1.default.promises.readdir(outputPath, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+    await Promise.all(entries.map((entry) => fs_1.default.promises.rm(path_1.default.join(outputPath, entry.name), {
+        force: true,
+        maxRetries: 3,
+        recursive: true,
+        retryDelay: 50,
+    })));
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}

package/cjs/utils/lockfile.d.ts

@@ -0,0 +1,10 @@
+export declare class PersistentCacheLock {
+    private listener;
+    private nativeLockfile;
+    private constructor();
+    static tryAcquire(lockPath: string, content?: string): PersistentCacheLock | undefined;
+    static acquireWithRetries(lockPath: string, processName: string): Promise<PersistentCacheLock>;
+    unlock(): Promise<void>;
+    unlockSync(): void;
+}
+export declare function acquirePersistentCacheLock(projectPath: string, processName: string, persistentCaching: boolean): Promise<PersistentCacheLock | undefined>;

package/cjs/utils/lockfile.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistentCacheLock = void 0;
+exports.acquirePersistentCacheLock = acquirePersistentCacheLock;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const binding = __importStar(require("../binding"));
+const RETRY_DELAY_MS = 10;
+const MAX_RETRY_MS = 1000;
+class PersistentCacheLock {
+    constructor(nativeLockfile) {
+        this.nativeLockfile = nativeLockfile;
+        this.listener = () => this.unlockSync();
+        process.on("exit", this.listener);
+    }
+    static tryAcquire(lockPath, content) {
+        const nativeLockfile = binding.lockfileTryAcquireSync(lockPath, content);
+        return nativeLockfile ? new PersistentCacheLock(nativeLockfile) : undefined;
+    }
+    static async acquireWithRetries(lockPath, processName) {
+        const content = JSON.stringify({
+            pid: process.pid,
+            processName,
+            startedAt: Date.now(),
+        });
+        const startMs = Date.now();
+        let lockfile;
+        while (Date.now() - startMs < MAX_RETRY_MS) {
+            lockfile = PersistentCacheLock.tryAcquire(lockPath, content);
+            if (lockfile) {
+                return lockfile;
+            }
+            await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+        }
+        throw new Error(formatLockError(lockPath, processName));
+    }
+    async unlock() {
+        const lockfile = this.nativeLockfile;
+        this.nativeLockfile = undefined;
+        if (this.listener) {
+            process.off("exit", this.listener);
+            this.listener = undefined;
+        }
+        if (lockfile) {
+            await binding.lockfileUnlock(lockfile);
+        }
+    }
+    unlockSync() {
+        const lockfile = this.nativeLockfile;
+        this.nativeLockfile = undefined;
+        if (this.listener) {
+            process.off("exit", this.listener);
+            this.listener = undefined;
+        }
+        if (lockfile) {
+            binding.lockfileUnlockSync(lockfile);
+        }
+    }
+}
+exports.PersistentCacheLock = PersistentCacheLock;
+async function acquirePersistentCacheLock(projectPath, processName, persistentCaching) {
+    if (!persistentCaching) {
+        return undefined;
+    }
+    const internalDir = path_1.default.join(path_1.default.resolve(projectPath), ".turbopack");
+    fs_1.default.mkdirSync(internalDir, { recursive: true });
+    return PersistentCacheLock.acquireWithRetries(path_1.default.join(internalDir, "lock"), processName);
+}
+function formatLockError(lockPath, processName) {
+    let owner = "";
+    try {
+        const data = JSON.parse(fs_1.default.readFileSync(lockPath, "utf-8"));
+        if (data.pid) {
+            const killCommand = process.platform === "win32"
+                ? `taskkill /PID ${data.pid} /F`
+                : `kill ${data.pid}`;
+            owner = `\nExisting process: ${data.processName || "unknown"} (PID ${data.pid}).\nStop it with ${picocolors_1.default.cyan(killCommand)} if it is stale.`;
+        }
+    }
+    catch (_a) {
+        // The lock holder might be a version that did not write metadata.
+    }
+    return `Unable to acquire ${processName} persistent cache lock at ${picocolors_1.default.cyan(lockPath)}. Another utoo pack process may be using the same .turbopack cache.${owner}`;
+}

package/esm/binding.d.ts

@@ -9,6 +9,11 @@ export declare class ExternalObject<T> {
     [K: symbol]: T
   }
 }
+export type Lockfile = { __napiType: "Lockfile" }
+export declare function lockfileTryAcquireSync(path: string, content?: string | undefined | null): Lockfile | null
+export declare function lockfileTryAcquire(path: string, content?: string | undefined | null): Promise<Lockfile | null>
+export declare function lockfileUnlockSync(lockfile: Lockfile): void
+export declare function lockfileUnlock(lockfile: Lockfile): Promise<void>
 export declare function registerWorkerScheduler(creator: (arg: NapiWorkerCreation) => any, terminator: (arg: NapiWorkerTermination) => any): void
 export declare function workerCreated(workerId: number): void
 export interface NapiWorkerCreation {

package/esm/binding.js

@@ -319,7 +319,11 @@ if (!nativeBinding) {
     }
     throw new Error(`Failed to load native binding`);
 }
-const { registerWorkerScheduler, workerCreated, recvTaskMessageInWorker, sendTaskMessage, endpointWriteToDisk, endpointServerChangedSubscribe, endpointClientChangedSubscribe, projectNew, projectUpdate, projectOnExit, projectShutdown, projectWriteAllEntrypointsToDisk, projectEntrypointsSubscribe, projectHmrEvents, projectHmrIdentifiersSubscribe, projectUpdateInfoSubscribe, projectTraceSource, projectGetSourceForAsset, projectGetSourceMap, projectGetSourceMapSync, rootTaskDispose, initCustomTraceSubscriber, teardownTraceSubscriber } = nativeBinding;
+const { lockfileTryAcquireSync, lockfileTryAcquire, lockfileUnlockSync, lockfileUnlock, registerWorkerScheduler, workerCreated, recvTaskMessageInWorker, sendTaskMessage, endpointWriteToDisk, endpointServerChangedSubscribe, endpointClientChangedSubscribe, projectNew, projectUpdate, projectOnExit, projectShutdown, projectWriteAllEntrypointsToDisk, projectEntrypointsSubscribe, projectHmrEvents, projectHmrIdentifiersSubscribe, projectUpdateInfoSubscribe, projectTraceSource, projectGetSourceForAsset, projectGetSourceMap, projectGetSourceMapSync, rootTaskDispose, initCustomTraceSubscriber, teardownTraceSubscriber } = nativeBinding;
+module.exports.lockfileTryAcquireSync = lockfileTryAcquireSync;
+module.exports.lockfileTryAcquire = lockfileTryAcquire;
+module.exports.lockfileUnlockSync = lockfileUnlockSync;
+module.exports.lockfileUnlock = lockfileUnlock;
 module.exports.registerWorkerScheduler = registerWorkerScheduler;
 module.exports.workerCreated = workerCreated;
 module.exports.recvTaskMessageInWorker = recvTaskMessageInWorker;

package/esm/commands/build.js

@@ -6,11 +6,13 @@ import path from "path";
 import { resolveBundleOptions } from "../config/webpackCompat.js";
 import { projectFactory } from "../core/project.js";
 import { HtmlPlugin } from "../plugins/HtmlPlugin.js";
+import { cleanOutput, getOutputPath } from "../utils/cleanOutput.js";
 import { blockStdout, getPackPath } from "../utils/common.js";
 import { findRootDir } from "../utils/findRoot.js";
 import { getInitialAssetsFromStats } from "../utils/getInitialAssets.js";
 import { processHtmlEntry } from "../utils/htmlEntry.js";
-import { normalizePath } from "../utils/normalize-path.js";
+import { acquirePersistentCacheLock } from "../utils/lockfile.js";
+import { normalizePath } from "../utils/normalizePath.js";
 import { useWorkerThreads } from "../utils/runtimePluginStratety.js";
 import { validateEntryPaths } from "../utils/validateEntry.js";
 import { xcodeProfilingReady } from "../utils/xcodeProfile.js";
@@ -23,7 +25,7 @@ export function build(options, projectPath, rootPath) {
     return buildInternal(bundleOptions, projectPath, rootPath);
 }
 async function buildInternal(bundleOptions, projectPath, rootPath) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     blockStdout();
     if (process.env.XCODE_PROFILE) {
         await xcodeProfilingReady();
@@ -33,62 +35,70 @@ async function buildInternal(bundleOptions, projectPath, rootPath) {
     const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : false;
     processHtmlEntry(bundleOptions.config, resolvedProjectPath);
     validateEntryPaths(bundleOptions.config, resolvedProjectPath);
+    await cleanOutput(bundleOptions.config, resolvedProjectPath);
     const createProject = projectFactory();
-    const project = await createProject({
-        processEnv: (_b = bundleOptions.processEnv) !== null && _b !== void 0 ? _b : {},
-        watch: {
-            enable: false,
-        },
-        dev: (_c = bundleOptions.dev) !== null && _c !== void 0 ? _c : false,
-        buildId: bundleOptions.buildId || nanoid(),
-        tracing: (_d = bundleOptions.tracing) !== null && _d !== void 0 ? _d : true,
-        config: {
-            ...bundleOptions.config,
-            stats: Boolean(process.env.ANALYZE) ||
-                bundleOptions.config.stats ||
-                bundleOptions.config.entry.some((e) => !!e.html),
-            pluginRuntimeStrategy: (_f = (_e = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _e === void 0 ? void 0 : _e.pluginRuntimeStrategy) !== null && _f !== void 0 ? _f : (useWorkerThreads() ? "workerThreads" : "childProcesses"),
-        },
-        projectPath: normalizePath(resolvedProjectPath),
-        rootPath: resolvedRootPath,
-        packPath: getPackPath(),
-    }, {
-        persistentCaching,
-        // Build mode is a short-lived, one-shot compilation, so avoid paying
-        // dependency graph bookkeeping cost unless the persistent cache needs it.
-        dependencyTracking: persistentCaching,
-        isShortSession: true,
-    });
-    const entrypoints = await project.writeAllEntrypointsToDisk();
-    handleIssues(entrypoints.issues);
-    const htmlConfigs = [
-        ...(Array.isArray(bundleOptions.config.html)
-            ? bundleOptions.config.html
-            : bundleOptions.config.html
-                ? [bundleOptions.config.html]
-                : []),
-        ...bundleOptions.config.entry
-            .filter((e) => !!e.html)
-            .map((e) => e.html),
-    ];
-    if (htmlConfigs.length > 0) {
-        const assets = { js: [], css: [] };
-        const outputDir = ((_g = bundleOptions.config.output) === null || _g === void 0 ? void 0 : _g.path) || path.join(process.cwd(), "dist");
-        if (assets.js.length === 0 && assets.css.length === 0) {
-            const discovered = getInitialAssetsFromStats(outputDir);
-            assets.js.push(...discovered.js);
-            assets.css.push(...discovered.css);
+    const persistentCacheLock = await acquirePersistentCacheLock(resolvedProjectPath, "utoo pack build", persistentCaching);
+    let project;
+    try {
+        project = await createProject({
+            processEnv: (_b = bundleOptions.processEnv) !== null && _b !== void 0 ? _b : {},
+            watch: {
+                enable: false,
+            },
+            dev: (_c = bundleOptions.dev) !== null && _c !== void 0 ? _c : false,
+            buildId: bundleOptions.buildId || nanoid(),
+            tracing: (_d = bundleOptions.tracing) !== null && _d !== void 0 ? _d : true,
+            config: {
+                ...bundleOptions.config,
+                stats: Boolean(process.env.ANALYZE) ||
+                    bundleOptions.config.stats ||
+                    bundleOptions.config.entry.some((e) => !!e.html),
+                pluginRuntimeStrategy: (_f = (_e = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _e === void 0 ? void 0 : _e.pluginRuntimeStrategy) !== null && _f !== void 0 ? _f : (useWorkerThreads() ? "workerThreads" : "childProcesses"),
+            },
+            projectPath: normalizePath(resolvedProjectPath),
+            rootPath: resolvedRootPath,
+            packPath: getPackPath(),
+        }, {
+            persistentCaching,
+            // Build mode is a short-lived, one-shot compilation, so avoid paying
+            // dependency graph bookkeeping cost unless the persistent cache needs it.
+            dependencyTracking: persistentCaching,
+            isShortSession: true,
+        });
+        const entrypoints = await project.writeAllEntrypointsToDisk();
+        handleIssues(entrypoints.issues);
+        const htmlConfigs = [
+            ...(Array.isArray(bundleOptions.config.html)
+                ? bundleOptions.config.html
+                : bundleOptions.config.html
+                    ? [bundleOptions.config.html]
+                    : []),
+            ...bundleOptions.config.entry
+                .filter((e) => !!e.html)
+                .map((e) => e.html),
+        ];
+        if (htmlConfigs.length > 0) {
+            const assets = { js: [], css: [] };
+            const outputDir = getOutputPath(bundleOptions.config, resolvedProjectPath);
+            if (assets.js.length === 0 && assets.css.length === 0) {
+                const discovered = getInitialAssetsFromStats(outputDir);
+                assets.js.push(...discovered.js);
+                assets.css.push(...discovered.css);
+            }
+            const publicPath = (_g = bundleOptions.config.output) === null || _g === void 0 ? void 0 : _g.publicPath;
+            for (const config of htmlConfigs) {
+                const plugin = new HtmlPlugin(config);
+                await plugin.generate(outputDir, assets, publicPath);
+            }
         }
-        const publicPath = (_h = bundleOptions.config.output) === null || _h === void 0 ? void 0 : _h.publicPath;
-        for (const config of htmlConfigs) {
-            const plugin = new HtmlPlugin(config);
-            await plugin.generate(outputDir, assets, publicPath);
+        if (process.env.ANALYZE) {
+            await analyzeBundle(((_h = bundleOptions.config.output) === null || _h === void 0 ? void 0 : _h.path) || "dist");
         }
     }
-    if (process.env.ANALYZE) {
-        await analyzeBundle(((_j = bundleOptions.config.output) === null || _j === void 0 ? void 0 : _j.path) || "dist");
+    finally {
+        await (project === null || project === void 0 ? void 0 : project.shutdown());
+        persistentCacheLock === null || persistentCacheLock === void 0 ? void 0 : persistentCacheLock.unlockSync();
     }
-    await project.shutdown();
     // TODO: Maybe run tasks in worker is a better way, see
     // https://github.com/vercel/next.js/blob/512d8283054407ab92b2583ecce3b253c3be7b85/packages/next/src/lib/worker.ts
 }

package/esm/commands/dev.js

@@ -9,10 +9,10 @@ import fs from "fs";
 import getPort from "get-port";
 import { Hono } from "hono";
 import https from "https";
-import path from "path";
 import { resolveBundleOptions, } from "../config/webpackCompat.js";
 import { createHotReloader } from "../core/hmr.js";
-import { createHttpProxyMiddleware } from "../core/proxy-hono.js";
+import { createHttpProxyMiddleware } from "../core/proxyHono.js";
+import { getOutputPath } from "../utils/cleanOutput.js";
 import { blockStdout, getPackPath } from "../utils/common.js";
 import { findRootDir } from "../utils/findRoot.js";
 import { createSelfSignedCertificate } from "../utils/mkcert.js";
@@ -133,7 +133,7 @@ export function serve(options, projectPath, rootPath, serverOptions) {
 }
 const HMR_PATH = "/turbopack-hmr";
 async function runDev(options, projectPath, rootPath, serverOptions) {
-    var _a, _b, _d, _e, _f, _g, _h;
+    var _a, _b, _d, _e, _f;
     blockStdout();
     process.title = "utoopack-dev-server";
     if (process.env.XCODE_PROFILE) {
@@ -143,8 +143,8 @@ async function runDev(options, projectPath, rootPath, serverOptions) {
     const { bundleOptions, projectPathResolved, rootPathResolved, serveOptsBase, } = await resolveDevConfig(options, projectPath, rootPath, serverOptions);
     const hotReloader = await createHotReloader(bundleOptions, projectPathResolved, rootPathResolved);
     await hotReloader.start();
-    const distRoot = path.resolve(projectPathResolved, ((_b = (_a = options.config) === null || _a === void 0 ? void 0 : _a.output) === null || _b === void 0 ? void 0 : _b.path) || "./dist");
-    const publicPath = (_e = (_d = options.config) === null || _d === void 0 ? void 0 : _d.output) === null || _e === void 0 ? void 0 : _e.publicPath;
+    const distRoot = getOutputPath(options.config, projectPathResolved);
+    const publicPath = (_b = (_a = options.config) === null || _a === void 0 ? void 0 : _a.output) === null || _b === void 0 ? void 0 : _b.publicPath;
     // Skip prefix stripping for "runtime" and when publicPath is absent (match dev.ts).
     const normalizedPrefix = publicPath && publicPath !== "runtime"
         ? normalizedPublicPath(publicPath)
@@ -185,7 +185,7 @@ async function runDev(options, projectPath, rootPath, serverOptions) {
             console.error("HMR WebSocket error", err);
         },
     })));
-    const proxyRules = (_g = (_f = bundleOptions.config) === null || _f === void 0 ? void 0 : _f.devServer) === null || _g === void 0 ? void 0 : _g.proxy;
+    const proxyRules = (_e = (_d = bundleOptions.config) === null || _d === void 0 ? void 0 : _d.devServer) === null || _e === void 0 ? void 0 : _e.proxy;
     if (proxyRules && proxyRules.length > 0) {
         app.use("*", createHttpProxyMiddleware(proxyRules));
     }
@@ -214,7 +214,7 @@ async function runDev(options, projectPath, rootPath, serverOptions) {
             server.once("error", onError);
         });
     }
-    await ((_h = serverOptions === null || serverOptions === void 0 ? void 0 : serverOptions.onReady) === null || _h === void 0 ? void 0 : _h.call(serverOptions, {
+    await ((_f = serverOptions === null || serverOptions === void 0 ? void 0 : serverOptions.onReady) === null || _f === void 0 ? void 0 : _f.call(serverOptions, {
         port: serveOptsBase.port,
         hostname: serveOptsBase.hostname,
     }));

package/esm/core/hmr.js

@@ -1,12 +1,13 @@
 import { HMR_ACTIONS_SENT_TO_BROWSER, } from "@utoo/pack-shared";
 import { nanoid } from "nanoid";
-import path from "path";
 import { WebSocketServer } from "ws";
 import { HtmlPlugin } from "../plugins/HtmlPlugin.js";
+import { cleanOutput, getOutputPath } from "../utils/cleanOutput.js";
 import { debounce, getPackPath, processIssues } from "../utils/common.js";
 import { getInitialAssetsFromStats } from "../utils/getInitialAssets.js";
 import { processHtmlEntry } from "../utils/htmlEntry.js";
-import { normalizePath } from "../utils/normalize-path.js";
+import { acquirePersistentCacheLock } from "../utils/lockfile.js";
+import { normalizePath } from "../utils/normalizePath.js";
 import { useWorkerThreads } from "../utils/runtimePluginStratety.js";
 import { validateEntryPaths } from "../utils/validateEntry.js";
 import { projectFactory } from "./project.js";
@@ -21,35 +22,45 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
     const resolvedRootPath = rootPath || projectPath || process.cwd();
     processHtmlEntry(bundleOptions.config, resolvedProjectPath);
     validateEntryPaths(bundleOptions.config, resolvedProjectPath);
+    await cleanOutput(bundleOptions.config, resolvedProjectPath);
     const createProject = projectFactory();
-    const project = await createProject({
-        processEnv: (_a = bundleOptions.processEnv) !== null && _a !== void 0 ? _a : {},
-        watch: {
-            enable: true,
-        },
-        dev: true,
-        buildId: bundleOptions.buildId || nanoid(),
-        tracing: (_b = bundleOptions.tracing) !== null && _b !== void 0 ? _b : true,
-        config: {
-            ...bundleOptions.config,
-            mode: "development",
-            stats: Boolean(process.env.ANALYZE) ||
-                bundleOptions.config.stats ||
-                bundleOptions.config.entry.some((e) => !!e.html),
-            optimization: {
-                ...bundleOptions.config.optimization,
-                minify: false,
-                moduleIds: "named",
+    const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : false;
+    const persistentCacheLock = await acquirePersistentCacheLock(resolvedProjectPath, "utoo pack dev", persistentCaching);
+    let project;
+    try {
+        project = await createProject({
+            processEnv: (_b = bundleOptions.processEnv) !== null && _b !== void 0 ? _b : {},
+            watch: {
+                enable: true,
             },
-            persistentCaching: (_d = (_c = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _c === void 0 ? void 0 : _c.persistentCaching) !== null && _d !== void 0 ? _d : true,
-            pluginRuntimeStrategy: (_f = (_e = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _e === void 0 ? void 0 : _e.pluginRuntimeStrategy) !== null && _f !== void 0 ? _f : (useWorkerThreads() ? "workerThreads" : "childProcesses"),
-        },
-        projectPath: normalizePath(resolvedProjectPath),
-        rootPath: resolvedRootPath,
-        packPath: getPackPath(),
-    }, {
-        persistentCaching: (_g = bundleOptions.config.persistentCaching) !== null && _g !== void 0 ? _g : false,
-    });
+            dev: true,
+            buildId: bundleOptions.buildId || nanoid(),
+            tracing: (_c = bundleOptions.tracing) !== null && _c !== void 0 ? _c : true,
+            config: {
+                ...bundleOptions.config,
+                mode: "development",
+                stats: Boolean(process.env.ANALYZE) ||
+                    bundleOptions.config.stats ||
+                    bundleOptions.config.entry.some((e) => !!e.html),
+                optimization: {
+                    ...bundleOptions.config.optimization,
+                    minify: false,
+                    moduleIds: "named",
+                },
+                persistentCaching: (_e = (_d = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _d === void 0 ? void 0 : _d.persistentCaching) !== null && _e !== void 0 ? _e : true,
+                pluginRuntimeStrategy: (_g = (_f = bundleOptions === null || bundleOptions === void 0 ? void 0 : bundleOptions.config) === null || _f === void 0 ? void 0 : _f.pluginRuntimeStrategy) !== null && _g !== void 0 ? _g : (useWorkerThreads() ? "workerThreads" : "childProcesses"),
+            },
+            projectPath: normalizePath(resolvedProjectPath),
+            rootPath: resolvedRootPath,
+            packPath: getPackPath(),
+        }, {
+            persistentCaching,
+        });
+    }
+    catch (error) {
+        persistentCacheLock === null || persistentCacheLock === void 0 ? void 0 : persistentCacheLock.unlockSync();
+        throw error;
+    }
     const entrypointsSubscription = project.entrypointsSubscribe();
     let currentEntriesHandlingResolve;
     let currentEntriesHandling = new Promise((resolve) => (currentEntriesHandlingResolve = resolve));
@@ -73,6 +84,7 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
     let backgroundWatchGeneration = 0;
     const backgroundWriteTasks = new Map();
     let closed = false;
+    let closePromise;
     function sendToClient(client, payload) {
         client.send(JSON.stringify(payload));
     }
@@ -107,12 +119,12 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
         sendEnqueuedMessagesDebounce();
     }
     async function regenerateHtml() {
-        var _a, _b;
+        var _a;
         if (htmlConfigs.length === 0) {
             return;
         }
-        const outputDir = ((_a = bundleOptions.config.output) === null || _a === void 0 ? void 0 : _a.path) || path.join(process.cwd(), "dist");
-        const publicPath = (_b = bundleOptions.config.output) === null || _b === void 0 ? void 0 : _b.publicPath;
+        const outputDir = getOutputPath(bundleOptions.config, resolvedProjectPath);
+        const publicPath = (_a = bundleOptions.config.output) === null || _a === void 0 ? void 0 : _a.publicPath;
         const assets = getInitialAssetsFromStats(outputDir);
         for (const config of htmlConfigs) {
             const plugin = new HtmlPlugin(config);
@@ -244,6 +256,7 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
         subscription === null || subscription === void 0 ? void 0 : subscription.return();
     }
     async function handleEntrypointsSubscription() {
+        var _a, _b;
         for await (const entrypoints of entrypointsSubscription) {
             if (!currentEntriesHandlingResolve) {
                 currentEntriesHandling = new Promise(
@@ -251,8 +264,8 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
                 (resolve) => (currentEntriesHandlingResolve = resolve));
             }
             currentWatchedEntrypoints = [
-                ...entrypoints.apps,
-                ...entrypoints.libraries,
+                ...((_a = entrypoints.apps) !== null && _a !== void 0 ? _a : []),
+                ...((_b = entrypoints.libraries) !== null && _b !== void 0 ? _b : []),
             ];
             await writeEntrypointsToDisk(currentWatchedEntrypoints);
             if (backgroundWatchersStarted) {
@@ -437,6 +450,14 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
         close() {
             closed = true;
             void disposeBackgroundWatchSubscriptions();
+            closePromise !== null && closePromise !== void 0 ? closePromise : (closePromise = project
+                .onExit()
+                .catch((err) => {
+                console.error(err);
+            })
+                .finally(() => {
+                persistentCacheLock === null || persistentCacheLock === void 0 ? void 0 : persistentCacheLock.unlockSync();
+            }));
             for (const wsClient of clients) {
                 wsClient.close();
             }

package/esm/core/project.js

@@ -2,7 +2,7 @@ import { resolve } from "path";
 import { isDeepStrictEqual } from "util";
 import * as binding from "../binding.js";
 import { getPackPath, rustifyEnv } from "../utils/common.js";
-import { normalizePath } from "../utils/normalize-path.js";
+import { normalizePath } from "../utils/normalizePath.js";
 import { runLoaderWorkerPool } from "./loaderWorkerPool.js";
 /**
  * An error caused by a bug in Turbopack, and not the user's code (e.g. a Rust panic). These should

package/esm/utils/cleanOutput.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigComplete } from "../config/types";
+export declare function getOutputPath(config: ConfigComplete, projectPath: string): string;
+export declare function cleanOutput(config: ConfigComplete, projectPath: string): Promise<void>;

package/esm/utils/cleanOutput.js

@@ -0,0 +1,32 @@
+import fs from "fs";
+import path from "path";
+export function getOutputPath(config, projectPath) {
+    var _a;
+    return path.resolve(projectPath, ((_a = config.output) === null || _a === void 0 ? void 0 : _a.path) || "dist");
+}
+export async function cleanOutput(config, projectPath) {
+    var _a;
+    if (!((_a = config.output) === null || _a === void 0 ? void 0 : _a.clean)) {
+        return;
+    }
+    const outputPath = getOutputPath(config, projectPath);
+    let entries;
+    try {
+        entries = await fs.promises.readdir(outputPath, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return;
+        }
+        throw error;
+    }
+    await Promise.all(entries.map((entry) => fs.promises.rm(path.join(outputPath, entry.name), {
+        force: true,
+        maxRetries: 3,
+        recursive: true,
+        retryDelay: 50,
+    })));
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}

package/esm/utils/lockfile.d.ts

@@ -0,0 +1,10 @@
+export declare class PersistentCacheLock {
+    private listener;
+    private nativeLockfile;
+    private constructor();
+    static tryAcquire(lockPath: string, content?: string): PersistentCacheLock | undefined;
+    static acquireWithRetries(lockPath: string, processName: string): Promise<PersistentCacheLock>;
+    unlock(): Promise<void>;
+    unlockSync(): void;
+}
+export declare function acquirePersistentCacheLock(projectPath: string, processName: string, persistentCaching: boolean): Promise<PersistentCacheLock | undefined>;

package/esm/utils/lockfile.js

@@ -0,0 +1,80 @@
+import fs from "fs";
+import path from "path";
+import pc from "picocolors";
+import * as binding from "../binding.js";
+const RETRY_DELAY_MS = 10;
+const MAX_RETRY_MS = 1000;
+export class PersistentCacheLock {
+    constructor(nativeLockfile) {
+        this.nativeLockfile = nativeLockfile;
+        this.listener = () => this.unlockSync();
+        process.on("exit", this.listener);
+    }
+    static tryAcquire(lockPath, content) {
+        const nativeLockfile = binding.lockfileTryAcquireSync(lockPath, content);
+        return nativeLockfile ? new PersistentCacheLock(nativeLockfile) : undefined;
+    }
+    static async acquireWithRetries(lockPath, processName) {
+        const content = JSON.stringify({
+            pid: process.pid,
+            processName,
+            startedAt: Date.now(),
+        });
+        const startMs = Date.now();
+        let lockfile;
+        while (Date.now() - startMs < MAX_RETRY_MS) {
+            lockfile = PersistentCacheLock.tryAcquire(lockPath, content);
+            if (lockfile) {
+                return lockfile;
+            }
+            await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+        }
+        throw new Error(formatLockError(lockPath, processName));
+    }
+    async unlock() {
+        const lockfile = this.nativeLockfile;
+        this.nativeLockfile = undefined;
+        if (this.listener) {
+            process.off("exit", this.listener);
+            this.listener = undefined;
+        }
+        if (lockfile) {
+            await binding.lockfileUnlock(lockfile);
+        }
+    }
+    unlockSync() {
+        const lockfile = this.nativeLockfile;
+        this.nativeLockfile = undefined;
+        if (this.listener) {
+            process.off("exit", this.listener);
+            this.listener = undefined;
+        }
+        if (lockfile) {
+            binding.lockfileUnlockSync(lockfile);
+        }
+    }
+}
+export async function acquirePersistentCacheLock(projectPath, processName, persistentCaching) {
+    if (!persistentCaching) {
+        return undefined;
+    }
+    const internalDir = path.join(path.resolve(projectPath), ".turbopack");
+    fs.mkdirSync(internalDir, { recursive: true });
+    return PersistentCacheLock.acquireWithRetries(path.join(internalDir, "lock"), processName);
+}
+function formatLockError(lockPath, processName) {
+    let owner = "";
+    try {
+        const data = JSON.parse(fs.readFileSync(lockPath, "utf-8"));
+        if (data.pid) {
+            const killCommand = process.platform === "win32"
+                ? `taskkill /PID ${data.pid} /F`
+                : `kill ${data.pid}`;
+            owner = `\nExisting process: ${data.processName || "unknown"} (PID ${data.pid}).\nStop it with ${pc.cyan(killCommand)} if it is stale.`;
+        }
+    }
+    catch (_a) {
+        // The lock holder might be a version that did not write metadata.
+    }
+    return `Unable to acquire ${processName} persistent cache lock at ${pc.cyan(lockPath)}. Another utoo pack process may be using the same .turbopack cache.${owner}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utoo/pack",
-  "version": "1.4.3",
+  "version": "1.4.4-alpha.1",
   "main": "cjs/index.js",
   "module": "esm/index.js",
   "types": "esm/index.d.ts",
@@ -41,7 +41,7 @@
     "@hono/node-server": "^1.19.11",
     "@hono/node-ws": "^1.3.0",
     "@swc/helpers": "0.5.15",
-    "@utoo/pack-shared": "1.4.3",
+    "@utoo/pack-shared": "1.4.4-alpha.1",
     "domparser-rs": "^0.0.7",
     "find-up": "4.1.0",
     "get-port": "5.1.1",
@@ -92,12 +92,12 @@
   },
   "repository": "git@github.com:utooland/utoo.git",
   "optionalDependencies": {
-    "@utoo/pack-darwin-arm64": "1.4.3",
-    "@utoo/pack-darwin-x64": "1.4.3",
-    "@utoo/pack-linux-arm64-gnu": "1.4.3",
-    "@utoo/pack-linux-arm64-musl": "1.4.3",
-    "@utoo/pack-linux-x64-gnu": "1.4.3",
-    "@utoo/pack-linux-x64-musl": "1.4.3",
-    "@utoo/pack-win32-x64-msvc": "1.4.3"
+    "@utoo/pack-darwin-arm64": "1.4.4-alpha.1",
+    "@utoo/pack-darwin-x64": "1.4.4-alpha.1",
+    "@utoo/pack-linux-arm64-gnu": "1.4.4-alpha.1",
+    "@utoo/pack-linux-arm64-musl": "1.4.4-alpha.1",
+    "@utoo/pack-linux-x64-gnu": "1.4.4-alpha.1",
+    "@utoo/pack-linux-x64-musl": "1.4.4-alpha.1",
+    "@utoo/pack-win32-x64-msvc": "1.4.4-alpha.1"
   }
 }