@pnpm/resolving.local-resolver 1100.0.6 → 1101.0.0

package/lib/index.d.ts

@@ -8,12 +8,10 @@ export interface LocalResolveResult extends ResolveResult {
     resolution: DirectoryResolution | TarballResolution;
     resolvedVia: 'local-filesystem';
 }
-/**
- * Resolves a package hosted on the local filesystem
- */
-export declare function resolveFromLocal(ctx: {
+export interface LocalResolverContext {
     preserveAbsolutePaths?: boolean;
-}, wantedDependency: WantedLocalDependency, opts: {
+}
+export interface LocalResolverOptions {
     lockfileDir?: string;
     projectDir: string;
     currentPkg?: {
@@ -21,4 +19,15 @@ export declare function resolveFromLocal(ctx: {
         resolution: DirectoryResolution | TarballResolution | Resolution;
     };
     update?: false | 'compatible' | 'latest';
-}): Promise<LocalResolveResult | null>;
+}
+/**
+ * Resolves a dependency declared with an explicit local scheme:
+ * `link:`, `workspace:`, `file:`, or (rejected) `path:`.
+ */
+export declare function resolveFromLocalScheme(ctx: LocalResolverContext, wantedDependency: WantedLocalDependency, opts: LocalResolverOptions): Promise<LocalResolveResult | null>;
+/**
+ * Resolves a dependency by path shape — a relative/absolute path or a tarball
+ * filename. Does not look at scheme prefixes; callers that want scheme support
+ * should call {@link resolveFromLocalScheme} first.
+ */
+export declare function resolveFromLocalPath(ctx: LocalResolverContext, wantedDependency: WantedLocalDependency, opts: LocalResolverOptions): Promise<LocalResolveResult | null>;

package/lib/index.js

@@ -4,14 +4,30 @@ import { getTarballIntegrity } from '@pnpm/crypto.hash';
 import { PnpmError } from '@pnpm/error';
 import { logger } from '@pnpm/logger';
 import { readProjectManifestOnly } from '@pnpm/workspace.project-manifest-reader';
-import { parseBareSpecifier } from './parseBareSpecifier.js';
+import { parseLocalPath, parseLocalScheme } from './parseBareSpecifier.js';
 export {};
 /**
- * Resolves a package hosted on the local filesystem
+ * Resolves a dependency declared with an explicit local scheme:
+ * `link:`, `workspace:`, `file:`, or (rejected) `path:`.
  */
-export async function resolveFromLocal(ctx, wantedDependency, opts) {
-    const preserveAbsolutePaths = ctx.preserveAbsolutePaths ?? false;
-    const spec = parseBareSpecifier(wantedDependency, opts.projectDir, opts.lockfileDir ?? opts.projectDir, { preserveAbsolutePaths });
+export async function resolveFromLocalScheme(ctx, wantedDependency, opts) {
+    const spec = parseLocalScheme(wantedDependency, opts.projectDir, opts.lockfileDir ?? opts.projectDir, {
+        preserveAbsolutePaths: ctx.preserveAbsolutePaths ?? false,
+    });
+    return resolveSpec(spec, opts);
+}
+/**
+ * Resolves a dependency by path shape — a relative/absolute path or a tarball
+ * filename. Does not look at scheme prefixes; callers that want scheme support
+ * should call {@link resolveFromLocalScheme} first.
+ */
+export async function resolveFromLocalPath(ctx, wantedDependency, opts) {
+    const spec = parseLocalPath(wantedDependency, opts.projectDir, opts.lockfileDir ?? opts.projectDir, {
+        preserveAbsolutePaths: ctx.preserveAbsolutePaths ?? false,
+    });
+    return resolveSpec(spec, opts);
+}
+async function resolveSpec(spec, opts) {
     if (spec == null)
         return null;
     if (spec.type === 'file') {

package/lib/parseBareSpecifier.d.ts

@@ -10,6 +10,9 @@ export interface WantedLocalDependency {
     bareSpecifier: string;
     injected?: boolean;
 }
-export declare function parseBareSpecifier(wd: WantedLocalDependency, projectDir: string, lockfileDir: string, opts: {
+export declare function parseLocalScheme(wd: WantedLocalDependency, projectDir: string, lockfileDir: string, opts: {
+    preserveAbsolutePaths: boolean;
+}): LocalPackageSpec | null;
+export declare function parseLocalPath(wd: WantedLocalDependency, projectDir: string, lockfileDir: string, opts: {
     preserveAbsolutePaths: boolean;
 }): LocalPackageSpec | null;

package/lib/parseBareSpecifier.js

@@ -17,22 +17,28 @@ class PathIsUnsupportedProtocolError extends PnpmError {
         this.protocol = protocol;
     }
 }
-export function parseBareSpecifier(wd, projectDir, lockfileDir, opts) {
+export function parseLocalScheme(wd, projectDir, lockfileDir, opts) {
     if (wd.bareSpecifier.startsWith('link:') || wd.bareSpecifier.startsWith('workspace:')) {
         return fromLocal(wd, projectDir, lockfileDir, 'directory', opts);
     }
+    if (wd.bareSpecifier.startsWith('file:')) {
+        const type = isFilename.test(wd.bareSpecifier) ? 'file' : 'directory';
+        return fromLocal(wd, projectDir, lockfileDir, type, opts);
+    }
+    if (wd.bareSpecifier.startsWith('path:')) {
+        throw new PathIsUnsupportedProtocolError(wd.bareSpecifier, 'path:');
+    }
+    return null;
+}
+export function parseLocalPath(wd, projectDir, lockfileDir, opts) {
     if (wd.bareSpecifier.endsWith('.tgz') ||
         wd.bareSpecifier.endsWith('.tar.gz') ||
         wd.bareSpecifier.endsWith('.tar') ||
         wd.bareSpecifier.includes(path.sep) ||
-        wd.bareSpecifier.startsWith('file:') ||
         isFilespec.test(wd.bareSpecifier)) {
         const type = isFilename.test(wd.bareSpecifier) ? 'file' : 'directory';
         return fromLocal(wd, projectDir, lockfileDir, type, opts);
     }
-    if (wd.bareSpecifier.startsWith('path:')) {
-        throw new PathIsUnsupportedProtocolError(wd.bareSpecifier, 'path:');
-    }
     return null;
 }
 function fromLocal({ bareSpecifier, injected }, projectDir, lockfileDir, type, opts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/resolving.local-resolver",
-  "version": "1100.0.6",
+  "version": "1101.0.0",
   "description": "Resolver for local packages",
   "keywords": [
     "pnpm",
@@ -29,9 +29,9 @@
     "normalize-path": "^3.0.0",
     "@pnpm/crypto.hash": "1100.0.1",
     "@pnpm/resolving.resolver-base": "1100.1.3",
-    "@pnpm/workspace.project-manifest-reader": "1100.0.4",
+    "@pnpm/types": "1101.1.0",
     "@pnpm/error": "1100.0.0",
-    "@pnpm/types": "1101.1.0"
+    "@pnpm/workspace.project-manifest-reader": "1100.0.4"
   },
   "peerDependencies": {
     "@pnpm/logger": ">=1001.0.0 <1002.0.0"
@@ -39,8 +39,8 @@
   "devDependencies": {
     "@jest/globals": "30.3.0",
     "@types/normalize-path": "^3.0.2",
-    "@pnpm/logger": "1100.0.0",
-    "@pnpm/resolving.local-resolver": "1100.0.6"
+    "@pnpm/resolving.local-resolver": "1101.0.0",
+    "@pnpm/logger": "1100.0.0"
   },
   "engines": {
     "node": ">=22.13"