@apidevtools/json-schema-ref-parser 10.1.0 → 11.1.0

package/dist/lib/parsers/yaml.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -40,26 +31,24 @@ exports.default = {
      * @param file.data      - The file contents. This will be whatever data type was returned by the resolver
      * @returns
      */
-    parse(file) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // eslint-disable-line require-await
-            let data = file.data;
-            if (Buffer.isBuffer(data)) {
-                data = data.toString();
-            }
-            if (typeof data === "string") {
-                try {
-                    return js_yaml_1.default.load(data, { schema: js_yaml_2.JSON_SCHEMA });
-                }
-                catch (e) {
-                    // @ts-expect-error TS(2571): Object is of type 'unknown'.
-                    throw new errors_js_1.ParserError(e.message, file.url);
-                }
+    async parse(file) {
+        // eslint-disable-line require-await
+        let data = file.data;
+        if (Buffer.isBuffer(data)) {
+            data = data.toString();
+        }
+        if (typeof data === "string") {
+            try {
+                return js_yaml_1.default.load(data, { schema: js_yaml_2.JSON_SCHEMA });
             }
-            else {
-                // data is already a JavaScript value (object, array, number, null, NaN, etc.)
-                return data;
+            catch (e) {
+                // @ts-expect-error TS(2571): Object is of type 'unknown'.
+                throw new errors_js_1.ParserError(e.message, file.url);
             }
-        });
+        }
+        else {
+            // data is already a JavaScript value (object, array, number, null, NaN, etc.)
+            return data;
+        }
     },
 };

package/dist/lib/ref.d.ts

@@ -2,7 +2,6 @@ import Pointer from "./pointer.js";
 import type { JSONParserError, MissingPointerError, ParserError, ResolverError } from "./util/errors.js";
 import type $Refs from "./refs.js";
 import type $RefParserOptions from "./options.js";
-import type { JSONSchema } from "./types";
 type $RefError = JSONParserError | ResolverError | ParserError | MissingPointerError;
 /**
  * This class represents a single JSON reference and its resolved value.
@@ -100,7 +99,7 @@ declare class $Ref {
      * @param value - The value to inspect
      * @returns
      */
-    static isExternal$Ref(value: any): value is JSONSchema;
+    static isExternal$Ref(value: any): boolean;
     /**
      * Determines whether the given value is a JSON reference, and whether it is allowed by the options.
      * For example, if it references an external file, then options.resolve.external must be true.

package/dist/lib/ref.js

@@ -64,8 +64,7 @@ class $Ref {
      * @returns - Returns the resolved value
      */
     get(path, options) {
-        var _a;
-        return (_a = this.resolve(path, options)) === null || _a === void 0 ? void 0 : _a.value;
+        return this.resolve(path, options)?.value;
     }
     /**
      * Resolves the given JSON reference within this {@link $Ref#value}.

package/dist/lib/refs.js

@@ -29,8 +29,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const ono_1 = require("@jsdevtools/ono");
 const ref_js_1 = __importDefault(require("./ref.js"));
 const url = __importStar(require("./util/url.js"));
-const isWindows = /^win/.test(globalThis.process ? globalThis.process.platform : "");
-const getPathFromOs = (filePath) => (isWindows ? filePath.replace(/\\/g, "/") : filePath);
+const convert_path_to_posix_1 = __importDefault(require("./util/convert-path-to-posix"));
 /**
  * When you call the resolve method, the value that gets passed to the callback function (or Promise) is a $Refs object. This same object is accessible via the parser.$refs property of $RefParser objects.
  *
@@ -49,7 +48,7 @@ class $Refs {
     paths(...types) {
         const paths = getPaths(this._$refs, types);
         return paths.map((path) => {
-            return getPathFromOs(path.decoded);
+            return (0, convert_path_to_posix_1.default)(path.decoded);
         });
     }
     /**
@@ -63,7 +62,7 @@ class $Refs {
         const $refs = this._$refs;
         const paths = getPaths($refs, types);
         return paths.reduce((obj, path) => {
-            obj[getPathFromOs(path.decoded)] = $refs[path.encoded].value;
+            obj[(0, convert_path_to_posix_1.default)(path.decoded)] = $refs[path.encoded].value;
             return obj;
         }, {});
     }

package/dist/lib/resolve-external.js

@@ -22,15 +22,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -70,6 +61,7 @@ function resolveExternal(parser, options) {
  *
  * @param obj - The value to crawl. If it's not an object or array, it will be ignored.
  * @param path - The full path of `obj`, possibly with a JSON Pointer in the hash
+ * @param {boolean} external - Whether `obj` was found in an external document.
  * @param $refs
  * @param options
  * @param seen - Internal.
@@ -80,7 +72,7 @@ function resolveExternal(parser, options) {
  * If any of the JSON references point to files that contain additional JSON references,
  * then the corresponding promise will internally reference an array of promises.
  */
-function crawl(obj, path, $refs, options, seen) {
+function crawl(obj, path, $refs, options, seen, external) {
     seen || (seen = new Set());
     let promises = [];
     if (obj && typeof obj === "object" && !ArrayBuffer.isView(obj) && !seen.has(obj)) {
@@ -88,17 +80,11 @@ function crawl(obj, path, $refs, options, seen) {
         if (ref_js_1.default.isExternal$Ref(obj)) {
             promises.push(resolve$Ref(obj, path, $refs, options));
         }
-        else {
-            for (const key of Object.keys(obj)) {
-                const keyPath = pointer_js_1.default.join(path, key);
-                const value = obj[key];
-                if (ref_js_1.default.isExternal$Ref(value)) {
-                    promises.push(resolve$Ref(value, keyPath, $refs, options));
-                }
-                else {
-                    promises = promises.concat(crawl(value, keyPath, $refs, options, seen));
-                }
-            }
+        const keys = Object.keys(obj);
+        for (const key of keys) {
+            const keyPath = pointer_js_1.default.join(path, key);
+            const value = obj[key];
+            promises = promises.concat(crawl(value, keyPath, $refs, options, seen, external));
         }
     }
     return promises;
@@ -115,34 +101,33 @@ function crawl(obj, path, $refs, options, seen) {
  * The promise resolves once all JSON references in the object have been resolved,
  * including nested references that are contained in externally-referenced files.
  */
-function resolve$Ref($ref, path, $refs, options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // console.log('Resolving $ref pointer "%s" at %s', $ref.$ref, path);
-        const resolvedPath = url.resolve(path, $ref.$ref);
-        const withoutHash = url.stripHash(resolvedPath);
-        // Do we already have this $ref?
-        $ref = $refs._$refs[withoutHash];
-        if ($ref) {
-            // We've already parsed this $ref, so use the existing value
-            return Promise.resolve($ref.value);
-        }
-        // Parse the $referenced file/url
-        try {
-            const result = yield (0, parse_js_1.default)(resolvedPath, $refs, options);
-            // Crawl the parsed value
-            // console.log('Resolving $ref pointers in %s', withoutHash);
-            const promises = crawl(result, withoutHash + "#", $refs, options);
-            return Promise.all(promises);
+async function resolve$Ref($ref, path, $refs, options) {
+    const shouldResolveOnCwd = options.dereference.externalReferenceResolution === "root";
+    const resolvedPath = url.resolve(shouldResolveOnCwd ? url.cwd() : path, $ref.$ref);
+    const withoutHash = url.stripHash(resolvedPath);
+    // $ref.$ref = url.relative($refs._root$Ref.path, resolvedPath);
+    // Do we already have this $ref?
+    $ref = $refs._$refs[withoutHash];
+    if ($ref) {
+        // We've already parsed this $ref, so use the existing value
+        return Promise.resolve($ref.value);
+    }
+    // Parse the $referenced file/url
+    try {
+        const result = await (0, parse_js_1.default)(resolvedPath, $refs, options);
+        // Crawl the parsed value
+        // console.log('Resolving $ref pointers in %s', withoutHash);
+        const promises = crawl(result, withoutHash + "#", $refs, options, new Set(), true);
+        return Promise.all(promises);
+    }
+    catch (err) {
+        if (!options?.continueOnError || !(0, errors_js_1.isHandledError)(err)) {
+            throw err;
         }
-        catch (err) {
-            if (!(options === null || options === void 0 ? void 0 : options.continueOnError) || !(0, errors_js_1.isHandledError)(err)) {
-                throw err;
-            }
-            if ($refs._$refs[withoutHash]) {
-                err.source = decodeURI(url.stripHash(path));
-                err.path = url.safePointerToPath(url.getHash(path));
-            }
-            return [];
+        if ($refs._$refs[withoutHash]) {
+            err.source = decodeURI(url.stripHash(path));
+            err.path = url.safePointerToPath(url.getHash(path));
         }
-    });
+        return [];
+    }
 }

package/dist/lib/resolvers/file.js

@@ -22,20 +22,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const promises_1 = __importDefault(require("fs/promises"));
+const fs_1 = require("fs");
 const ono_1 = require("@jsdevtools/ono");
 const url = __importStar(require("../util/url.js"));
 const errors_js_1 = require("../util/errors.js");
@@ -55,22 +43,20 @@ exports.default = {
     /**
      * Reads the given file and returns its raw contents as a Buffer.
      */
-    read(file) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let path;
-            try {
-                path = url.toFileSystemPath(file.url);
-            }
-            catch (err) {
-                throw new errors_js_1.ResolverError(ono_1.ono.uri(err, `Malformed URI: ${file.url}`), file.url);
-            }
-            try {
-                const data = yield promises_1.default.readFile(path);
-                return data;
-            }
-            catch (err) {
-                throw new errors_js_1.ResolverError((0, ono_1.ono)(err, `Error opening file "${path}"`), path);
-            }
-        });
+    async read(file) {
+        let path;
+        try {
+            path = url.toFileSystemPath(file.url);
+        }
+        catch (err) {
+            throw new errors_js_1.ResolverError(ono_1.ono.uri(err, `Malformed URI: ${file.url}`), file.url);
+        }
+        try {
+            const data = await fs_1.promises.readFile(path);
+            return data;
+        }
+        catch (err) {
+            throw new errors_js_1.ResolverError((0, ono_1.ono)(err, `Error opening file "${path}"`), path);
+        }
     },
 };

package/dist/lib/resolvers/http.js

@@ -22,15 +22,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 const ono_1 = require("@jsdevtools/ono");
 const url = __importStar(require("../util/url.js"));
@@ -89,71 +80,67 @@ exports.default = {
  * @returns
  * The promise resolves with the raw downloaded data, or rejects if there is an HTTP error.
  */
-function download(u, httpOptions, _redirects) {
-    return __awaiter(this, void 0, void 0, function* () {
-        u = url.parse(u);
-        const redirects = _redirects || [];
-        redirects.push(u.href);
-        try {
-            const res = yield get(u, httpOptions);
-            if (res.status >= 400) {
-                throw (0, ono_1.ono)({ status: res.status }, `HTTP ERROR ${res.status}`);
+async function download(u, httpOptions, _redirects) {
+    u = url.parse(u);
+    const redirects = _redirects || [];
+    redirects.push(u.href);
+    try {
+        const res = await get(u, httpOptions);
+        if (res.status >= 400) {
+            throw (0, ono_1.ono)({ status: res.status }, `HTTP ERROR ${res.status}`);
+        }
+        else if (res.status >= 300) {
+            if (!Number.isNaN(httpOptions.redirects) && redirects.length > httpOptions.redirects) {
+                throw new errors_js_1.ResolverError((0, ono_1.ono)({ status: res.status }, `Error downloading ${redirects[0]}. \nToo many redirects: \n  ${redirects.join(" \n  ")}`));
             }
-            else if (res.status >= 300) {
-                if (!Number.isNaN(httpOptions.redirects) && redirects.length > httpOptions.redirects) {
-                    throw new errors_js_1.ResolverError((0, ono_1.ono)({ status: res.status }, `Error downloading ${redirects[0]}. \nToo many redirects: \n  ${redirects.join(" \n  ")}`));
-                }
-                else if (!("location" in res.headers) || !res.headers.location) {
-                    throw (0, ono_1.ono)({ status: res.status }, `HTTP ${res.status} redirect with no location header`);
-                }
-                else {
-                    const redirectTo = url.resolve(u, res.headers.location);
-                    return download(redirectTo, httpOptions, redirects);
-                }
+            else if (!("location" in res.headers) || !res.headers.location) {
+                throw (0, ono_1.ono)({ status: res.status }, `HTTP ${res.status} redirect with no location header`);
             }
             else {
-                if (res.body) {
-                    const buf = yield res.arrayBuffer();
-                    return Buffer.from(buf);
-                }
-                return Buffer.alloc(0);
+                const redirectTo = url.resolve(u.href, res.headers.location);
+                return download(redirectTo, httpOptions, redirects);
             }
         }
-        catch (err) {
-            throw new errors_js_1.ResolverError((0, ono_1.ono)(err, `Error downloading ${u.href}`), u.href);
+        else {
+            if (res.body) {
+                const buf = await res.arrayBuffer();
+                return Buffer.from(buf);
+            }
+            return Buffer.alloc(0);
         }
-    });
+    }
+    catch (err) {
+        throw new errors_js_1.ResolverError((0, ono_1.ono)(err, `Error downloading ${u.href}`), u.href);
+    }
 }
 /**
  * Sends an HTTP GET request.
  * The promise resolves with the HTTP Response object.
  */
-function get(u, httpOptions) {
-    return __awaiter(this, void 0, void 0, function* () {
-        let controller;
-        let timeoutId;
-        if (httpOptions.timeout) {
-            controller = new AbortController();
-            timeoutId = setTimeout(() => controller.abort(), httpOptions.timeout);
-        }
-        if (!global.fetch) {
-            const { default: fetch, Request, Headers } = yield Promise.resolve().then(() => __importStar(require("node-fetch")));
-            // @ts-ignore
-            global.fetch = fetch;
-            // @ts-ignore
-            global.Request = Request;
-            // @ts-ignore
-            global.Headers = Headers;
-        }
-        const response = yield fetch(u, {
-            method: "GET",
-            headers: httpOptions.headers || {},
-            credentials: httpOptions.withCredentials ? "include" : "same-origin",
-            signal: controller ? controller.signal : null,
-        });
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-        }
-        return response;
+async function get(u, httpOptions) {
+    let controller;
+    let timeoutId;
+    if (httpOptions.timeout) {
+        controller = new AbortController();
+        timeoutId = setTimeout(() => controller.abort(), httpOptions.timeout);
+    }
+    if (!global.fetch) {
+        const { default: fetch, Request, Headers } = await Promise.resolve().then(() => __importStar(require("node-fetch")));
+        // @ts-ignore
+        global.fetch = fetch;
+        // @ts-ignore
+        global.Request = Request;
+        // @ts-ignore
+        global.Headers = Headers;
+    }
+    const response = await fetch(u, {
+        method: "GET",
+        headers: httpOptions.headers || {},
+        credentials: httpOptions.withCredentials ? "include" : "same-origin",
+        signal: controller ? controller.signal : null,
     });
+    if (timeoutId) {
+        clearTimeout(timeoutId);
+    }
+    return response;
 }

package/dist/lib/util/convert-path-to-posix.d.ts

@@ -0,0 +1 @@
+export default function convertPathToPosix(filePath: string): string;

package/dist/lib/util/convert-path-to-posix.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+function convertPathToPosix(filePath) {
+    const isExtendedLengthPath = filePath.startsWith("\\\\?\\");
+    if (isExtendedLengthPath) {
+        return filePath;
+    }
+    return filePath.split(path_1.default.win32.sep).join(path_1.default.posix.sep);
+}
+exports.default = convertPathToPosix;

package/dist/lib/util/is-windows.d.ts

@@ -0,0 +1 @@
+export declare const isWindows: () => boolean;

package/dist/lib/util/is-windows.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWindows = void 0;
+const isWindowsConst = /^win/.test(globalThis.process ? globalThis.process.platform : "");
+const isWindows = () => isWindowsConst;
+exports.isWindows = isWindows;

package/dist/lib/util/plugins.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.run = exports.sort = exports.filter = exports.all = void 0;
 /**
@@ -56,62 +47,60 @@ exports.sort = sort;
  * If the promise rejects, or the callback is called with an error, then the next plugin is called.
  * If ALL plugins fail, then the last error is thrown.
  */
-function run(plugins, method, file, $refs) {
-    return __awaiter(this, void 0, void 0, function* () {
-        let plugin;
-        let lastError;
-        let index = 0;
-        return new Promise((resolve, reject) => {
-            runNextPlugin();
-            function runNextPlugin() {
-                plugin = plugins[index++];
-                if (!plugin) {
-                    // There are no more functions, so re-throw the last error
-                    return reject(lastError);
-                }
-                try {
-                    // console.log('  %s', plugin.name);
-                    const result = getResult(plugin, method, file, callback, $refs);
-                    if (result && typeof result.then === "function") {
-                        // A promise was returned
-                        result.then(onSuccess, onError);
-                    }
-                    else if (result !== undefined) {
-                        // A synchronous result was returned
-                        onSuccess(result);
-                    }
-                    else if (index === plugins.length) {
-                        throw new Error("No promise has been returned or callback has been called.");
-                    }
-                }
-                catch (e) {
-                    onError(e);
-                }
+async function run(plugins, method, file, $refs) {
+    let plugin;
+    let lastError;
+    let index = 0;
+    return new Promise((resolve, reject) => {
+        runNextPlugin();
+        function runNextPlugin() {
+            plugin = plugins[index++];
+            if (!plugin) {
+                // There are no more functions, so re-throw the last error
+                return reject(lastError);
             }
-            function callback(err, result) {
-                if (err) {
-                    onError(err);
+            try {
+                // console.log('  %s', plugin.name);
+                const result = getResult(plugin, method, file, callback, $refs);
+                if (result && typeof result.then === "function") {
+                    // A promise was returned
+                    result.then(onSuccess, onError);
                 }
-                else {
+                else if (result !== undefined) {
+                    // A synchronous result was returned
                     onSuccess(result);
                 }
+                else if (index === plugins.length) {
+                    throw new Error("No promise has been returned or callback has been called.");
+                }
             }
-            function onSuccess(result) {
-                // console.log('    success');
-                resolve({
-                    plugin,
-                    result,
-                });
+            catch (e) {
+                onError(e);
             }
-            function onError(error) {
-                // console.log('    %s', err.message || err);
-                lastError = {
-                    plugin,
-                    error,
-                };
-                runNextPlugin();
+        }
+        function callback(err, result) {
+            if (err) {
+                onError(err);
+            }
+            else {
+                onSuccess(result);
             }
-        });
+        }
+        function onSuccess(result) {
+            // console.log('    success');
+            resolve({
+                plugin,
+                result,
+            });
+        }
+        function onError(error) {
+            // console.log('    %s', err.message || err);
+            lastError = {
+                plugin,
+                error,
+            };
+            runNextPlugin();
+        }
     });
 }
 exports.run = run;

package/dist/lib/util/url.d.ts

@@ -1,10 +1,10 @@
-export declare const parse: (u: any) => URL;
+export declare const parse: (u: string | URL) => URL;
 /**
  * Returns resolved target URL relative to a base URL in a manner similar to that of a Web browser resolving an anchor tag HREF.
  *
  * @returns
  */
-export declare function resolve(from: any, to: any): string;
+export declare function resolve(from: string, to: string): string;
 /**
  * Returns the current working directory (in Node) or the current page URL (in browsers).
  *
@@ -17,7 +17,7 @@ export declare function cwd(): string;
  * @param path
  * @returns
  */
-export declare function getProtocol(path: any): string | undefined;
+export declare function getProtocol(path: string | undefined): string | undefined;
 /**
  * Returns the lowercased file extension of the given URL,
  * or an empty string if it has no extension.
@@ -62,7 +62,7 @@ export declare function isHttp(path: any): boolean;
  * @param path
  * @returns
  */
-export declare function isFileSystemPath(path: any): boolean;
+export declare function isFileSystemPath(path: string | undefined): boolean;
 /**
  * Converts a filesystem path to a properly-encoded URL.
  *
@@ -91,3 +91,4 @@ export declare function toFileSystemPath(path: string | undefined, keepFileProto
  * @returns
  */
 export declare function safePointerToPath(pointer: any): any;
+export declare function relative(from: string, to: string): string;