@utoo/pack 1.4.18-alpha.1 → 1.4.18

package/cjs/binding.d.ts

@@ -125,6 +125,20 @@ export interface NapiTurboEngineOptions {
   dependencyTracking?: boolean
   /** Hint that this turbo-tasks instance is for a short-lived one-shot session. */
   isShortSession?: boolean
+  /** Turbopack memory eviction mode for the persistent cache. */
+  turbopackMemoryEviction?: MemoryEvictionMode
+  /** Avoid large backend preallocations to reduce startup memory. */
+  smallPreallocation?: boolean
+}
+/** Turbopack's memory eviction strategy for the persistent cache. */
+export const enum MemoryEvictionMode {
+  /** Never evict. */
+  Off = "off",
+  /**
+   * After every snapshot, evict all evictable tasks from memory, reloading
+   * them from disk on demand.
+   */
+  Full = "full"
 }
 export declare function projectNew(options: NapiProjectOptions, turboEngineOptions: NapiTurboEngineOptions, napiCallbacks: NapiTurbopackCallbacksJsObject): Promise<{ __napiType: "Project" }>
 export declare function projectUpdate(project: { __napiType: "Project" }, options: NapiPartialProjectOptions): Promise<void>

package/cjs/commands/build.js

@@ -14,6 +14,7 @@ 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 env_1 = require("../utils/env");
 const findRoot_1 = require("../utils/findRoot");
 const getInitialAssets_1 = require("../utils/getInitialAssets");
 const htmlEntry_1 = require("../utils/htmlEntry");
@@ -39,6 +40,8 @@ async function buildInternal(bundleOptions, projectPath, rootPath) {
     const resolvedProjectPath = projectPath || process.cwd();
     const resolvedRootPath = rootPath || projectPath || process.cwd();
     const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : true;
+    const turbopackMemoryEviction = (0, env_1.normalizeTurbopackMemoryEviction)(bundleOptions.config.turbopackMemoryEviction);
+    const smallPreallocation = (0, env_1.isTruthyEnv)(process.env.UTOO_TURBOPACK_SMALL_PREALLOCATION);
     const shouldCreateWebpackStats = Boolean(process.env.ANALYZE) || Boolean(bundleOptions.config.stats);
     (0, htmlEntry_1.processHtmlEntry)(bundleOptions.config, resolvedProjectPath);
     (0, validateEntry_1.validateEntryPaths)(bundleOptions.config, resolvedProjectPath);
@@ -65,6 +68,8 @@ async function buildInternal(bundleOptions, projectPath, rootPath) {
             packPath: (0, common_1.getPackPath)(),
         }, {
             persistentCaching,
+            turbopackMemoryEviction,
+            smallPreallocation,
             // Build mode is a short-lived, one-shot compilation, so avoid paying
             // dependency graph bookkeeping cost unless the persistent cache needs it.
             dependencyTracking: persistentCaching,

package/cjs/core/hmr.js

@@ -8,6 +8,7 @@ const ws_1 = require("ws");
 const HtmlPlugin_1 = require("../plugins/HtmlPlugin");
 const cleanOutput_1 = require("../utils/cleanOutput");
 const common_1 = require("../utils/common");
+const env_1 = require("../utils/env");
 const getInitialAssets_1 = require("../utils/getInitialAssets");
 const htmlEntry_1 = require("../utils/htmlEntry");
 const lockfile_1 = require("../utils/lockfile");
@@ -63,6 +64,8 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
     await (0, cleanOutput_1.cleanOutput)(bundleOptions.config, resolvedProjectPath);
     const createProject = (0, project_1.projectFactory)();
     const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : true;
+    const turbopackMemoryEviction = (0, env_1.normalizeTurbopackMemoryEviction)(bundleOptions.config.turbopackMemoryEviction);
+    const smallPreallocation = (0, env_1.isTruthyEnv)(process.env.UTOO_TURBOPACK_SMALL_PREALLOCATION);
     const persistentCacheLock = await (0, lockfile_1.acquirePersistentCacheLock)(resolvedProjectPath, "utoo pack dev", persistentCaching);
     const htmlConfigs = [
         ...(Array.isArray(bundleOptions.config.html)
@@ -102,6 +105,8 @@ async function createHotReloader(bundleOptions, projectPath, rootPath) {
             packPath: (0, common_1.getPackPath)(),
         }, {
             persistentCaching,
+            turbopackMemoryEviction,
+            smallPreallocation,
         });
     }
     catch (error) {

package/cjs/utils/env.d.ts

@@ -0,0 +1,2 @@
+export declare function isTruthyEnv(value: string | undefined): boolean;
+export declare function normalizeTurbopackMemoryEviction(value: boolean | "full" | undefined): "off" | "full";

package/cjs/utils/env.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTruthyEnv = isTruthyEnv;
+exports.normalizeTurbopackMemoryEviction = normalizeTurbopackMemoryEviction;
+function isTruthyEnv(value) {
+    return value === "1" || value === "true";
+}
+function normalizeTurbopackMemoryEviction(value) {
+    if (value === false) {
+        return "off";
+    }
+    if (value === true || value === "full") {
+        return "full";
+    }
+    const rawEnv = process.env.TURBO_ENGINE_EVICT_AFTER_SNAPSHOT;
+    return rawEnv == null || rawEnv === "1" || rawEnv === "true" ? "full" : "off";
+}

package/config_schema.json

@@ -222,6 +222,17 @@
         "string",
         "null"
       ]
+    },
+    "turbopackMemoryEviction": {
+      "description": "Turbopack memory eviction mode for the persistent cache",
+      "anyOf": [
+        {
+          "$ref": "#/definitions/SchemaTurbopackMemoryEviction"
+        },
+        {
+          "type": "null"
+        }
+      ]
     }
   },
   "definitions": {
@@ -1751,6 +1762,23 @@
         }
       ]
     },
+    "SchemaTurbopackMemoryEviction": {
+      "description": "Turbopack memory eviction mode.",
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "$ref": "#/definitions/SchemaTurbopackMemoryEvictionMode"
+        }
+      ]
+    },
+    "SchemaTurbopackMemoryEvictionMode": {
+      "type": "string",
+      "enum": [
+        "full"
+      ]
+    },
     "SchemaTurbopackModuleType": {
       "description": "Module type for a module rule (`type` / `moduleType` field).\n\nValues must match pack-core / Turbopack's `ConfiguredModuleType::parse()`.",
       "type": "string",

package/esm/binding.d.ts

@@ -125,6 +125,20 @@ export interface NapiTurboEngineOptions {
   dependencyTracking?: boolean
   /** Hint that this turbo-tasks instance is for a short-lived one-shot session. */
   isShortSession?: boolean
+  /** Turbopack memory eviction mode for the persistent cache. */
+  turbopackMemoryEviction?: MemoryEvictionMode
+  /** Avoid large backend preallocations to reduce startup memory. */
+  smallPreallocation?: boolean
+}
+/** Turbopack's memory eviction strategy for the persistent cache. */
+export const enum MemoryEvictionMode {
+  /** Never evict. */
+  Off = "off",
+  /**
+   * After every snapshot, evict all evictable tasks from memory, reloading
+   * them from disk on demand.
+   */
+  Full = "full"
 }
 export declare function projectNew(options: NapiProjectOptions, turboEngineOptions: NapiTurboEngineOptions, napiCallbacks: NapiTurbopackCallbacksJsObject): Promise<{ __napiType: "Project" }>
 export declare function projectUpdate(project: { __napiType: "Project" }, options: NapiPartialProjectOptions): Promise<void>

package/esm/commands/build.js

@@ -8,6 +8,7 @@ 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 { isTruthyEnv, normalizeTurbopackMemoryEviction } from "../utils/env.js";
 import { findRootDir } from "../utils/findRoot.js";
 import { getInitialAssetsFromEndpointPaths } from "../utils/getInitialAssets.js";
 import { processHtmlEntry } from "../utils/htmlEntry.js";
@@ -33,6 +34,8 @@ async function buildInternal(bundleOptions, projectPath, rootPath) {
     const resolvedProjectPath = projectPath || process.cwd();
     const resolvedRootPath = rootPath || projectPath || process.cwd();
     const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : true;
+    const turbopackMemoryEviction = normalizeTurbopackMemoryEviction(bundleOptions.config.turbopackMemoryEviction);
+    const smallPreallocation = isTruthyEnv(process.env.UTOO_TURBOPACK_SMALL_PREALLOCATION);
     const shouldCreateWebpackStats = Boolean(process.env.ANALYZE) || Boolean(bundleOptions.config.stats);
     processHtmlEntry(bundleOptions.config, resolvedProjectPath);
     validateEntryPaths(bundleOptions.config, resolvedProjectPath);
@@ -59,6 +62,8 @@ async function buildInternal(bundleOptions, projectPath, rootPath) {
             packPath: getPackPath(),
         }, {
             persistentCaching,
+            turbopackMemoryEviction,
+            smallPreallocation,
             // Build mode is a short-lived, one-shot compilation, so avoid paying
             // dependency graph bookkeeping cost unless the persistent cache needs it.
             dependencyTracking: persistentCaching,

package/esm/core/hmr.js

@@ -4,6 +4,7 @@ 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 { isTruthyEnv, normalizeTurbopackMemoryEviction } from "../utils/env.js";
 import { getInitialAssetsFromEndpointPaths } from "../utils/getInitialAssets.js";
 import { processHtmlEntry } from "../utils/htmlEntry.js";
 import { acquirePersistentCacheLock } from "../utils/lockfile.js";
@@ -58,6 +59,8 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
     await cleanOutput(bundleOptions.config, resolvedProjectPath);
     const createProject = projectFactory();
     const persistentCaching = (_a = bundleOptions.config.persistentCaching) !== null && _a !== void 0 ? _a : true;
+    const turbopackMemoryEviction = normalizeTurbopackMemoryEviction(bundleOptions.config.turbopackMemoryEviction);
+    const smallPreallocation = isTruthyEnv(process.env.UTOO_TURBOPACK_SMALL_PREALLOCATION);
     const persistentCacheLock = await acquirePersistentCacheLock(resolvedProjectPath, "utoo pack dev", persistentCaching);
     const htmlConfigs = [
         ...(Array.isArray(bundleOptions.config.html)
@@ -97,6 +100,8 @@ export async function createHotReloader(bundleOptions, projectPath, rootPath) {
             packPath: getPackPath(),
         }, {
             persistentCaching,
+            turbopackMemoryEviction,
+            smallPreallocation,
         });
     }
     catch (error) {

package/esm/utils/env.d.ts

@@ -0,0 +1,2 @@
+export declare function isTruthyEnv(value: string | undefined): boolean;
+export declare function normalizeTurbopackMemoryEviction(value: boolean | "full" | undefined): "off" | "full";

package/esm/utils/env.js

@@ -0,0 +1,13 @@
+export function isTruthyEnv(value) {
+    return value === "1" || value === "true";
+}
+export function normalizeTurbopackMemoryEviction(value) {
+    if (value === false) {
+        return "off";
+    }
+    if (value === true || value === "full") {
+        return "full";
+    }
+    const rawEnv = process.env.TURBO_ENGINE_EVICT_AFTER_SNAPSHOT;
+    return rawEnv == null || rawEnv === "1" || rawEnv === "true" ? "full" : "off";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utoo/pack",
-  "version": "1.4.18-alpha.1",
+  "version": "1.4.18",
   "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.18-alpha.1",
+    "@utoo/pack-shared": "1.4.18",
     "domparser-rs": "^0.0.7",
     "find-up": "4.1.0",
     "get-port": "5.1.1",
@@ -96,12 +96,12 @@
     "directory": "packages/pack"
   },
   "optionalDependencies": {
-    "@utoo/pack-darwin-arm64": "1.4.18-alpha.1",
-    "@utoo/pack-darwin-x64": "1.4.18-alpha.1",
-    "@utoo/pack-linux-arm64-gnu": "1.4.18-alpha.1",
-    "@utoo/pack-linux-arm64-musl": "1.4.18-alpha.1",
-    "@utoo/pack-linux-x64-gnu": "1.4.18-alpha.1",
-    "@utoo/pack-linux-x64-musl": "1.4.18-alpha.1",
-    "@utoo/pack-win32-x64-msvc": "1.4.18-alpha.1"
+    "@utoo/pack-darwin-arm64": "1.4.18",
+    "@utoo/pack-darwin-x64": "1.4.18",
+    "@utoo/pack-linux-arm64-gnu": "1.4.18",
+    "@utoo/pack-linux-arm64-musl": "1.4.18",
+    "@utoo/pack-linux-x64-gnu": "1.4.18",
+    "@utoo/pack-linux-x64-musl": "1.4.18",
+    "@utoo/pack-win32-x64-msvc": "1.4.18"
   }
 }