@pnpm/pkg-manifest.utils 1100.2.13 → 1100.3.1

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @pnpm/manifest-utils
 
+## 1100.3.1
+
+### Patch Changes
+
+- Updated dependencies:
+  - @pnpm/core-loggers@1100.3.2
+  - @pnpm/error@1100.1.1
+  - @pnpm/types@1101.9.0
+
+## 1100.3.0
+
+### Minor Changes
+
+- Renamed the `PinnedVersion` type to `RangeSpecStyle` and the `pinnedVersion` option fields to `rangeSpecStyle`: the value selects the operator a specifier is saved with, not a pin. `whichVersionIsPinned` is now `inferRangeSpecStyle`, and the new `rangeSpecGranularity` helper collapses the `exact` spelling to its `patch` range width. `@pnpm/types` keeps `PinnedVersion` as a deprecated alias of `RangeSpecStyle`. The rename itself changes no CLI behavior; the `=`-pin handling is described in its own changesets.
+
+- The `save-prefix` setting now accepts `=`: newly added dependencies are saved with an explicit `=` operator (`=1.2.3`) instead of the setting being silently treated as the default `^`.
+
+### Patch Changes
+
+- `pnpm update` keeps the explicit `=` operator of an exact version pin: a dependency saved as `=3.5.1` now updates to `=3.5.2` instead of the bare `3.5.2`. See pnpm/pnpm#13168.
+
+- Updated dependencies:
+  - @pnpm/core-loggers@1100.3.1
+  - @pnpm/types@1101.8.0
+
 ## 1100.2.13
 
 ### Patch Changes

package/lib/index.d.ts

@@ -4,6 +4,7 @@ import { getSpecFromPackageManifest } from './getSpecFromPackageManifest.js';
 export * from './convertEnginesRuntimeToDependencies.js';
 export * from './getAllDependenciesFromManifest.js';
 export * from './getDependencyTypeFromManifest.js';
+export * from './rangeSpecStyle.js';
 export * from './updateProjectManifestObject.js';
 export { getAllUniqueSpecs, getSpecFromPackageManifest };
 export declare function filterDependenciesByType(manifest: ProjectManifest, include: IncludedDependencies): Dependencies;

package/lib/index.js

@@ -3,6 +3,7 @@ import { getSpecFromPackageManifest } from './getSpecFromPackageManifest.js';
 export * from './convertEnginesRuntimeToDependencies.js';
 export * from './getAllDependenciesFromManifest.js';
 export * from './getDependencyTypeFromManifest.js';
+export * from './rangeSpecStyle.js';
 export * from './updateProjectManifestObject.js';
 export { getAllUniqueSpecs, getSpecFromPackageManifest };
 export function filterDependenciesByType(manifest, include) {

package/lib/rangeSpecStyle.d.ts

@@ -0,0 +1,13 @@
+import type { RangeSpecGranularity, RangeSpecStyle } from '@pnpm/types';
+export declare function rangeSpecGranularity(style: RangeSpecStyle): RangeSpecGranularity;
+/**
+ * Interpret the `save-exact` and `save-prefix` settings into a
+ * {@link RangeSpecStyle}. `save-exact` (like the empty `save-prefix`) wins
+ * and saves the bare version; a `save-prefix` of `=` saves the version with
+ * an explicit `=` operator.
+ */
+export declare function getRangeSpecStyle(opts: {
+    saveExact?: boolean;
+    savePrefix?: string;
+}): RangeSpecStyle;
+export declare function versionWithRangeSpecStyle(version: string, rangeSpecStyle: RangeSpecStyle): string;

package/lib/rangeSpecStyle.js

@@ -0,0 +1,30 @@
+export function rangeSpecGranularity(style) {
+    return style === 'exact' ? 'patch' : style;
+}
+/**
+ * Interpret the `save-exact` and `save-prefix` settings into a
+ * {@link RangeSpecStyle}. `save-exact` (like the empty `save-prefix`) wins
+ * and saves the bare version; a `save-prefix` of `=` saves the version with
+ * an explicit `=` operator.
+ */
+export function getRangeSpecStyle(opts) {
+    if (opts.saveExact === true || opts.savePrefix === '')
+        return 'patch';
+    switch (opts.savePrefix) {
+        case '=': return 'exact';
+        case '~': return 'minor';
+        default: return 'major';
+    }
+}
+export function versionWithRangeSpecStyle(version, rangeSpecStyle) {
+    switch (rangeSpecStyle) {
+        case 'none':
+        case 'major': return `^${version}`;
+        case 'minor': return `~${version}`;
+        case 'patch': return version;
+        case 'exact': return `=${version}`;
+    }
+    // Unreachable for type-checked callers; fail loudly for untyped JS input.
+    throw new Error(`Unknown range spec style: '${String(rangeSpecStyle)}'`);
+}
+//# sourceMappingURL=rangeSpecStyle.js.map

package/lib/updateProjectManifestObject.d.ts

@@ -1,12 +1,12 @@
-import { type DependenciesField, type DependenciesOrPeersField, type PinnedVersion, type ProjectManifest } from '@pnpm/types';
+import { type DependenciesField, type DependenciesOrPeersField, type ProjectManifest, type RangeSpecStyle } from '@pnpm/types';
 export interface PackageSpecObject {
     alias: string;
     peer?: boolean;
     bareSpecifier?: string;
     resolvedVersion?: string;
-    pinnedVersion?: PinnedVersion;
+    rangeSpecStyle?: RangeSpecStyle;
     saveType?: DependenciesField;
 }
-export declare function createVersionSpecFromResolvedVersion(resolvedVersion: string, pinnedVersion?: PinnedVersion): string | null;
+export declare function createVersionSpecFromResolvedVersion(resolvedVersion: string, rangeSpecStyle?: RangeSpecStyle): string | null;
 export declare function updateProjectManifestObject(prefix: string, packageManifest: ProjectManifest, packageSpecs: PackageSpecObject[]): Promise<ProjectManifest>;
 export declare function guessDependencyType(alias: string, manifest: ProjectManifest): DependenciesOrPeersField | undefined;

package/lib/updateProjectManifestObject.js

@@ -2,29 +2,20 @@ import { packageManifestLogger } from '@pnpm/core-loggers';
 import { isValidPeerRange } from '@pnpm/deps.peer-range';
 import { DEPENDENCIES_FIELDS, DEPENDENCIES_OR_PEER_FIELDS, } from '@pnpm/types';
 import semver from 'semver';
-function getPeerSpecifier(spec, resolvedVersion, pinnedVersion) {
+import { versionWithRangeSpecStyle } from './rangeSpecStyle.js';
+function getPeerSpecifier(spec, resolvedVersion, rangeSpecStyle) {
     if (isValidPeerRange(spec))
         return spec;
-    const rangeFromResolved = resolvedVersion ? createVersionSpecFromResolvedVersion(resolvedVersion, pinnedVersion) : null;
+    const rangeFromResolved = resolvedVersion ? createVersionSpecFromResolvedVersion(resolvedVersion, rangeSpecStyle) : null;
     return rangeFromResolved ?? '*';
 }
-export function createVersionSpecFromResolvedVersion(resolvedVersion, pinnedVersion) {
+export function createVersionSpecFromResolvedVersion(resolvedVersion, rangeSpecStyle) {
     const parsed = semver.parse(resolvedVersion);
     if (!parsed)
         return null;
     if (parsed.prerelease.length)
         return resolvedVersion;
-    switch (pinnedVersion ?? 'major') {
-        case 'none':
-        case 'major':
-            return `^${resolvedVersion}`;
-        case 'minor':
-            return `~${resolvedVersion}`;
-        case 'patch':
-            return resolvedVersion;
-        default:
-            return `^${resolvedVersion}`;
-    }
+    return versionWithRangeSpecStyle(resolvedVersion, rangeSpecStyle ?? 'major');
 }
 export async function updateProjectManifestObject(prefix, packageManifest, packageSpecs) {
     for (const packageSpec of packageSpecs) {
@@ -40,7 +31,7 @@ export async function updateProjectManifestObject(prefix, packageManifest, packa
                 }
                 if (packageSpec.peer === true) {
                     packageManifest.peerDependencies = packageManifest.peerDependencies ?? {};
-                    defineDepEntry(packageManifest.peerDependencies, packageSpec.alias, getPeerSpecifier(spec, packageSpec.resolvedVersion, packageSpec.pinnedVersion));
+                    defineDepEntry(packageManifest.peerDependencies, packageSpec.alias, getPeerSpecifier(spec, packageSpec.resolvedVersion, packageSpec.rangeSpecStyle));
                 }
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/pkg-manifest.utils",
-  "version": "1100.2.13",
+  "version": "1100.3.1",
   "description": "Utils for dealing with package manifest",
   "keywords": [
     "pnpm",
@@ -27,10 +27,10 @@
     "!*.map"
   ],
   "dependencies": {
-    "@pnpm/core-loggers": "1100.3.0",
+    "@pnpm/core-loggers": "1100.3.2",
     "@pnpm/deps.peer-range": "1100.1.1",
-    "@pnpm/error": "1100.1.0",
-    "@pnpm/types": "1101.7.0",
+    "@pnpm/error": "1100.1.1",
+    "@pnpm/types": "1101.9.0",
     "semver": "^7.8.5"
   },
   "peerDependencies": {
@@ -39,7 +39,7 @@
   "devDependencies": {
     "@jest/globals": "30.4.1",
     "@pnpm/logger": "1100.0.0",
-    "@pnpm/pkg-manifest.utils": "1100.2.13",
+    "@pnpm/pkg-manifest.utils": "1100.3.1",
     "@types/semver": "7.7.1"
   },
   "engines": {