@pnpm/napi 12.0.0-beta.2 → 12.0.0-beta.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @pnpm/napi
 
+## 12.0.0-beta.3
+
+### Minor Changes
+
+- `readConfig` now returns `explicitSettings` — the camelCase names of settings the config cascade set explicitly — so hosts that layer the resolved config over their own defaults can forward only the values the user actually configured.
+
+- Added a `returnListOfDepsRequiringBuild` install option. When it is set, `InstallResult.depsRequiringBuild` lists the dep path of every package whose files carry install scripts, whether or not the scripts were allowed to run, matching the TypeScript CLI's option of the same name. An install that computes no list, such as one served from the lockfile, leaves the field undefined.
+
 ## 12.0.0-beta.2
 
 ### Minor Changes

package/index.d.ts

@@ -197,6 +197,15 @@ export interface InstallOptions extends SharedEngineOptions {
    * `InstallResult.depsRequiringBuild` instead.
    */
   strictDepBuilds?: boolean
+  /**
+   * Report in `InstallResult.depsRequiringBuild` the dep path of every
+   * package whose files carry install scripts, regardless of the
+   * allow-build policy. The list is computed only when a fresh resolve
+   * materializes `node_modules`; an install served from the
+   * frozen-lockfile path (or `lockfileOnly`) leaves the field undefined
+   * so the embedder keeps its previously recorded list.
+   */
+  returnListOfDepsRequiringBuild?: boolean
   /** Customizations for how peer-dependency mismatches are treated. */
   peerDependencyRules?: PeerDependencyRules
 }
@@ -214,7 +223,13 @@ export interface InstallResult {
     removed: number
     linkedToRoot: number
   }
-  /** Dep paths whose build scripts were skipped and require approval to run. */
+  /**
+   * With `returnListOfDepsRequiringBuild`: the dep path of every package
+   * whose files carry install scripts, whether or not the scripts were
+   * allowed to run; undefined when the install did not compute the list
+   * (see the option). Without it: the dep paths whose build scripts were
+   * skipped and require approval to run.
+   */
   depsRequiringBuild?: string[]
   /** The resolved content-addressable store directory used by this install. */
   storeDir: string
@@ -400,6 +415,13 @@ export interface ResolvedConfig {
    * not a per-project setting. Absent when no home directory is resolvable.
    */
   pnpmHomeDir?: string
+  /**
+   * The camelCase names of settings the cascade set explicitly
+   * (`pnpm-workspace.yaml`, the global config, `pnpm_config_*` env vars).
+   * Every other projected value is an engine default; an embedder that
+   * layers this config over its own must forward only the explicit ones.
+   */
+  explicitSettings: string[]
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/napi",
-  "version": "12.0.0-beta.2",
+  "version": "12.0.0-beta.3",
   "description": "Node.js addon bindings for the pnpm v12 Rust engine (pacquet)",
   "keywords": [
     "pnpm",
@@ -27,14 +27,14 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "@pnpm/napi.win32-x64": "12.0.0-beta.2",
-    "@pnpm/napi.win32-arm64": "12.0.0-beta.2",
-    "@pnpm/napi.darwin-x64": "12.0.0-beta.2",
-    "@pnpm/napi.darwin-arm64": "12.0.0-beta.2",
-    "@pnpm/napi.linux-x64": "12.0.0-beta.2",
-    "@pnpm/napi.linux-arm64": "12.0.0-beta.2",
-    "@pnpm/napi.linux-x64-musl": "12.0.0-beta.2",
-    "@pnpm/napi.linux-arm64-musl": "12.0.0-beta.2"
+    "@pnpm/napi.win32-x64": "12.0.0-beta.3",
+    "@pnpm/napi.win32-arm64": "12.0.0-beta.3",
+    "@pnpm/napi.darwin-x64": "12.0.0-beta.3",
+    "@pnpm/napi.darwin-arm64": "12.0.0-beta.3",
+    "@pnpm/napi.linux-x64": "12.0.0-beta.3",
+    "@pnpm/napi.linux-arm64": "12.0.0-beta.3",
+    "@pnpm/napi.linux-x64-musl": "12.0.0-beta.3",
+    "@pnpm/napi.linux-arm64-musl": "12.0.0-beta.3"
   },
   "scripts": {
     "generate-packages": "node scripts/generate-packages.mjs"