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

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

@@ -0,0 +1,93 @@
+export declare const parse: (u: any) => 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;
+/**
+ * Returns the current working directory (in Node) or the current page URL (in browsers).
+ *
+ * @returns
+ */
+export declare function cwd(): string;
+/**
+ * Returns the protocol of the given URL, or `undefined` if it has no protocol.
+ *
+ * @param path
+ * @returns
+ */
+export declare function getProtocol(path: any): string | undefined;
+/**
+ * Returns the lowercased file extension of the given URL,
+ * or an empty string if it has no extension.
+ *
+ * @param path
+ * @returns
+ */
+export declare function getExtension(path: any): any;
+/**
+ * Removes the query, if any, from the given path.
+ *
+ * @param path
+ * @returns
+ */
+export declare function stripQuery(path: any): any;
+/**
+ * Returns the hash (URL fragment), of the given path.
+ * If there is no hash, then the root hash ("#") is returned.
+ *
+ * @param path
+ * @returns
+ */
+export declare function getHash(path: any): any;
+/**
+ * Removes the hash (URL fragment), if any, from the given path.
+ *
+ * @param path
+ * @returns
+ */
+export declare function stripHash(path: any): any;
+/**
+ * Determines whether the given path is an HTTP(S) URL.
+ *
+ * @param path
+ * @returns
+ */
+export declare function isHttp(path: any): boolean;
+/**
+ * Determines whether the given path is a filesystem path.
+ * This includes "file://" URLs.
+ *
+ * @param path
+ * @returns
+ */
+export declare function isFileSystemPath(path: any): boolean;
+/**
+ * Converts a filesystem path to a properly-encoded URL.
+ *
+ * This is intended to handle situations where JSON Schema $Ref Parser is called
+ * with a filesystem path that contains characters which are not allowed in URLs.
+ *
+ * @example
+ * The following filesystem paths would be converted to the following URLs:
+ *
+ *    <"!@#$%^&*+=?'>.json              ==>   %3C%22!@%23$%25%5E&*+=%3F\'%3E.json
+ *    C:\\My Documents\\File (1).json   ==>   C:/My%20Documents/File%20(1).json
+ *    file://Project #42/file.json      ==>   file://Project%20%2342/file.json
+ *
+ * @param path
+ * @returns
+ */
+export declare function fromFileSystemPath(path: any): any;
+/**
+ * Converts a URL to a local filesystem path.
+ */
+export declare function toFileSystemPath(path: string | undefined, keepFileProtocol?: boolean): string;
+/**
+ * Converts a $ref pointer to a valid JSON Path.
+ *
+ * @param pointer
+ * @returns
+ */
+export declare function safePointerToPath(pointer: any): any;

package/{cjs → dist/lib}/util/url.js

@@ -1,170 +1,186 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    parse: function() {
-        return parse;
-    },
-    resolve: function() {
-        return resolve;
-    },
-    cwd: function() {
-        return cwd;
-    },
-    getProtocol: function() {
-        return getProtocol;
-    },
-    getExtension: function() {
-        return getExtension;
-    },
-    stripQuery: function() {
-        return stripQuery;
-    },
-    getHash: function() {
-        return getHash;
-    },
-    stripHash: function() {
-        return stripHash;
-    },
-    isHttp: function() {
-        return isHttp;
-    },
-    isFileSystemPath: function() {
-        return isFileSystemPath;
-    },
-    fromFileSystemPath: function() {
-        return fromFileSystemPath;
-    },
-    toFileSystemPath: function() {
-        return toFileSystemPath;
-    },
-    safePointerToPath: function() {
-        return safePointerToPath;
-    }
-});
-var _projectDirCjs = /*#__PURE__*/ _interopRequireDefault(require("./projectDir.cjs"));
-function _interopRequireDefault(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
-    };
-}
-var isWindows = /^win/.test(globalThis.process ? globalThis.process.platform : undefined), forwardSlashPattern = /\//g, protocolPattern = /^(\w{2,}):\/\//i, jsonPointerSlash = /~1/g, jsonPointerTilde = /~0/g;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safePointerToPath = exports.toFileSystemPath = exports.fromFileSystemPath = exports.isFileSystemPath = exports.isHttp = exports.stripHash = exports.getHash = exports.stripQuery = exports.getExtension = exports.getProtocol = exports.cwd = exports.resolve = exports.parse = void 0;
+const isWindows = /^win/.test(globalThis.process ? globalThis.process.platform : ""), forwardSlashPattern = /\//g, protocolPattern = /^(\w{2,}):\/\//i, jsonPointerSlash = /~1/g, jsonPointerTilde = /~0/g;
+const path_1 = require("path");
+const projectDir = (0, path_1.join)(__dirname, "..", "..");
 // RegExp patterns to URL-encode special characters in local filesystem paths
-var urlEncodePatterns = [
-    /\?/g,
-    "%3F",
-    /\#/g,
-    "%23"
-];
+const urlEncodePatterns = [/\?/g, "%3F", /#/g, "%23"];
 // RegExp patterns to URL-decode special characters for local filesystem paths
-var urlDecodePatterns = [
-    /\%23/g,
-    "#",
-    /\%24/g,
-    "$",
-    /\%26/g,
-    "&",
-    /\%2C/g,
-    ",",
-    /\%40/g,
-    "@"
-];
-var parse = function(u) {
-    return new URL(u);
-};
+const urlDecodePatterns = [/%23/g, "#", /%24/g, "$", /%26/g, "&", /%2C/g, ",", /%40/g, "@"];
+const parse = (u) => new URL(u);
+exports.parse = parse;
+/**
+ * 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
+ */
 function resolve(from, to) {
-    var resolvedUrl = new URL(to, new URL(from, "resolve://"));
+    const resolvedUrl = new URL(to, new URL(from, "resolve://"));
     if (resolvedUrl.protocol === "resolve:") {
         // `from` is a relative URL.
-        var pathname = resolvedUrl.pathname, search = resolvedUrl.search, hash = resolvedUrl.hash;
+        const { pathname, search, hash } = resolvedUrl;
         return pathname + search + hash;
     }
     return resolvedUrl.toString();
 }
+exports.resolve = resolve;
+/**
+ * Returns the current working directory (in Node) or the current page URL (in browsers).
+ *
+ * @returns
+ */
 function cwd() {
     if (typeof window !== "undefined") {
         return location.href;
     }
-    var path = process.cwd();
-    var lastChar = path.slice(-1);
+    const path = process.cwd();
+    const lastChar = path.slice(-1);
     if (lastChar === "/" || lastChar === "\\") {
         return path;
-    } else {
+    }
+    else {
         return path + "/";
     }
 }
+exports.cwd = cwd;
+/**
+ * Returns the protocol of the given URL, or `undefined` if it has no protocol.
+ *
+ * @param path
+ * @returns
+ */
 function getProtocol(path) {
-    var match = protocolPattern.exec(path);
+    const match = protocolPattern.exec(path);
     if (match) {
         return match[1].toLowerCase();
     }
 }
+exports.getProtocol = getProtocol;
+/**
+ * Returns the lowercased file extension of the given URL,
+ * or an empty string if it has no extension.
+ *
+ * @param path
+ * @returns
+ */
 function getExtension(path) {
-    var lastDot = path.lastIndexOf(".");
+    const lastDot = path.lastIndexOf(".");
     if (lastDot >= 0) {
         return stripQuery(path.substr(lastDot).toLowerCase());
     }
     return "";
 }
+exports.getExtension = getExtension;
+/**
+ * Removes the query, if any, from the given path.
+ *
+ * @param path
+ * @returns
+ */
 function stripQuery(path) {
-    var queryIndex = path.indexOf("?");
+    const queryIndex = path.indexOf("?");
     if (queryIndex >= 0) {
         path = path.substr(0, queryIndex);
     }
     return path;
 }
+exports.stripQuery = stripQuery;
+/**
+ * Returns the hash (URL fragment), of the given path.
+ * If there is no hash, then the root hash ("#") is returned.
+ *
+ * @param path
+ * @returns
+ */
 function getHash(path) {
-    var hashIndex = path.indexOf("#");
+    const hashIndex = path.indexOf("#");
     if (hashIndex >= 0) {
         return path.substr(hashIndex);
     }
     return "#";
 }
+exports.getHash = getHash;
+/**
+ * Removes the hash (URL fragment), if any, from the given path.
+ *
+ * @param path
+ * @returns
+ */
 function stripHash(path) {
-    var hashIndex = path.indexOf("#");
+    const hashIndex = path.indexOf("#");
     if (hashIndex >= 0) {
         path = path.substr(0, hashIndex);
     }
     return path;
 }
+exports.stripHash = stripHash;
+/**
+ * Determines whether the given path is an HTTP(S) URL.
+ *
+ * @param path
+ * @returns
+ */
 function isHttp(path) {
-    var protocol = getProtocol(path);
+    const protocol = getProtocol(path);
     if (protocol === "http" || protocol === "https") {
         return true;
-    } else if (protocol === undefined) {
+    }
+    else if (protocol === undefined) {
         // There is no protocol.  If we're running in a browser, then assume it's HTTP.
         return typeof window !== "undefined";
-    } else {
+    }
+    else {
         // It's some other protocol, such as "ftp://", "mongodb://", etc.
         return false;
     }
 }
+exports.isHttp = isHttp;
+/**
+ * Determines whether the given path is a filesystem path.
+ * This includes "file://" URLs.
+ *
+ * @param path
+ * @returns
+ */
 function isFileSystemPath(path) {
-    if (process.browser) {
+    // @ts-ignore
+    if (typeof window !== "undefined" || process.browser) {
         // We're running in a browser, so assume that all paths are URLs.
         // This way, even relative paths will be treated as URLs rather than as filesystem paths
         return false;
     }
-    var protocol = getProtocol(path);
+    const protocol = getProtocol(path);
     return protocol === undefined || protocol === "file";
 }
+exports.isFileSystemPath = isFileSystemPath;
+/**
+ * Converts a filesystem path to a properly-encoded URL.
+ *
+ * This is intended to handle situations where JSON Schema $Ref Parser is called
+ * with a filesystem path that contains characters which are not allowed in URLs.
+ *
+ * @example
+ * The following filesystem paths would be converted to the following URLs:
+ *
+ *    <"!@#$%^&*+=?'>.json              ==>   %3C%22!@%23$%25%5E&*+=%3F\'%3E.json
+ *    C:\\My Documents\\File (1).json   ==>   C:/My%20Documents/File%20(1).json
+ *    file://Project #42/file.json      ==>   file://Project%20%2342/file.json
+ *
+ * @param path
+ * @returns
+ */
 function fromFileSystemPath(path) {
     // Step 1: On Windows, replace backslashes with forward slashes,
     // rather than encoding them as "%5C"
     if (isWindows) {
-        var hasProjectDir = path.toUpperCase().includes(_projectDirCjs.default.replace(/\\/g, "\\").toUpperCase());
-        var hasProjectUri = path.toUpperCase().includes(_projectDirCjs.default.replace(/\\/g, "/").toUpperCase());
+        const hasProjectDir = path.toUpperCase().includes(projectDir.replace(/\\/g, "\\").toUpperCase());
+        const hasProjectUri = path.toUpperCase().includes(projectDir.replace(/\\/g, "/").toUpperCase());
         if (hasProjectDir || hasProjectUri) {
             path = path.replace(/\\/g, "/");
-        } else {
-            path = "".concat(_projectDirCjs.default, "/").concat(path).replace(/\\/g, "/");
+        }
+        else {
+            path = `${projectDir}/${path}`.replace(/\\/g, "/");
         }
     }
     // Step 2: `encodeURI` will take care of MOST characters
@@ -172,23 +188,27 @@ function fromFileSystemPath(path) {
     // Step 3: Manually encode characters that are not encoded by `encodeURI`.
     // This includes characters such as "#" and "?", which have special meaning in URLs,
     // but are just normal characters in a filesystem path.
-    for(var i = 0; i < urlEncodePatterns.length; i += 2){
+    for (let i = 0; i < urlEncodePatterns.length; i += 2) {
         path = path.replace(urlEncodePatterns[i], urlEncodePatterns[i + 1]);
     }
     return path;
 }
+exports.fromFileSystemPath = fromFileSystemPath;
+/**
+ * Converts a URL to a local filesystem path.
+ */
 function toFileSystemPath(path, keepFileProtocol) {
     // Step 1: `decodeURI` will decode characters such as Cyrillic characters, spaces, etc.
     path = decodeURI(path);
     // Step 2: Manually decode characters that are not decoded by `decodeURI`.
     // This includes characters such as "#" and "?", which have special meaning in URLs,
     // but are just normal characters in a filesystem path.
-    for(var i = 0; i < urlDecodePatterns.length; i += 2){
+    for (let i = 0; i < urlDecodePatterns.length; i += 2) {
         path = path.replace(urlDecodePatterns[i], urlDecodePatterns[i + 1]);
     }
     // Step 3: If it's a "file://" URL, then format it consistently
     // or convert it to a local filesystem path
-    var isFileUrl = path.substr(0, 7).toLowerCase() === "file://";
+    let isFileUrl = path.substr(0, 7).toLowerCase() === "file://";
     if (isFileUrl) {
         // Strip-off the protocol, and the initial "/", if there is one
         path = path[7] === "/" ? path.substr(8) : path.substr(7);
@@ -199,7 +219,8 @@ function toFileSystemPath(path, keepFileProtocol) {
         if (keepFileProtocol) {
             // Return the consistently-formatted "file://" URL
             path = "file:///" + path;
-        } else {
+        }
+        else {
             // Convert the "file://" URL to a local filesystem path.
             // On Windows, it will start with something like "C:/".
             // On Posix, it will start with "/"
@@ -218,11 +239,22 @@ function toFileSystemPath(path, keepFileProtocol) {
     }
     return path;
 }
+exports.toFileSystemPath = toFileSystemPath;
+/**
+ * Converts a $ref pointer to a valid JSON Path.
+ *
+ * @param pointer
+ * @returns
+ */
 function safePointerToPath(pointer) {
     if (pointer.length <= 1 || pointer[0] !== "#" || pointer[1] !== "/") {
         return [];
     }
-    return pointer.slice(2).split("/").map(function(value) {
+    return pointer
+        .slice(2)
+        .split("/")
+        .map((value) => {
         return decodeURIComponent(value).replace(jsonPointerSlash, "/").replace(jsonPointerTilde, "~");
     });
 }
+exports.safePointerToPath = safePointerToPath;

package/dist/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vitest/dist/config").UserConfigExport;
+export default _default;

package/dist/vite.config.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("vitest/config");
+const isBrowser = process.env.BROWSER === "true";
+exports.default = (0, config_1.defineConfig)({
+    test: {
+        environment: isBrowser ? "jsdom" : "node",
+        dir: "test",
+        exclude: ["**/__IGNORED__/**"],
+        watch: false,
+        globalSetup: isBrowser ? ["./test/fixtures/server.ts"] : undefined,
+        setupFiles: isBrowser ? ["./test/fixtures/polyfill.ts"] : undefined,
+        testTimeout: 5000,
+        globals: true,
+        passWithNoTests: true,
+        reporters: ["verbose"],
+        coverage: { reporter: ["lcov", "html", "text"] },
+        deps: {
+            fallbackCJS: true,
+            registerNodeLoader: true,
+        },
+    },
+});