keep-a-changelog 2.1.0 → 2.3.0

package/esm/deps/deno.land/std@0.189.0/path/mod.js

@@ -0,0 +1,35 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+// Copyright the Browserify authors. MIT License.
+// Ported mostly from https://github.com/browserify/path-browserify/
+// This module is browser compatible.
+/**
+ * Utilities for working with OS-specific file paths.
+ *
+ * Codes in the examples uses POSIX path but it automatically use Windows path
+ * on Windows. Use methods under `posix` or `win32` object instead to handle non
+ * platform specific path like:
+ * ```ts
+ * import { posix, win32 } from "https://deno.land/std@$STD_VERSION/path/mod.ts";
+ * const p1 = posix.fromFileUrl("file:///home/foo");
+ * const p2 = win32.fromFileUrl("file:///home/foo");
+ * console.log(p1); // "/home/foo"
+ * console.log(p2); // "\\home\\foo"
+ * ```
+ *
+ * This module is browser compatible.
+ *
+ * @module
+ */
+import { isWindows } from "../_util/os.js";
+import * as _win32 from "./win32.js";
+import * as _posix from "./posix.js";
+const path = isWindows ? _win32 : _posix;
+export const win32 = _win32;
+export const posix = _posix;
+export const { basename, delimiter, dirname, extname, format, fromFileUrl, isAbsolute, join, normalize, parse, relative, resolve, toFileUrl, toNamespacedPath, } = path;
+/** @deprecated (will be removed after 0.188.0) Use SEP intead. */
+export const sep = path.sep;
+export * from "./common.js";
+export { SEP, SEP_PATTERN } from "./separator.js";
+export * from "./_interface.js";
+export * from "./glob.js";

package/{types/deps/deno.land/std@0.120.0 → esm/deps/deno.land/std@0.189.0}/path/posix.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import type { FormatInputPathObject, ParsedPath } from "./_interface.js";
 export declare const sep = "/";
 export declare const delimiter = ":";
@@ -8,6 +9,8 @@ export declare const delimiter = ":";
 export declare function resolve(...pathSegments: string[]): string;
 /**
  * Normalize the `path`, resolving `'..'` and `'.'` segments.
+ * Note that resolving these segments does not necessarily mean that all will be eliminated.
+ * A `'..'` at the top-level will be preserved, and an empty path is canonically `'.'`.
  * @param path to be normalized
  */
 export declare function normalize(path: string): string;
@@ -33,19 +36,22 @@ export declare function relative(from: string, to: string): string;
  */
 export declare function toNamespacedPath(path: string): string;
 /**
- * Return the directory name of a `path`.
- * @param path to determine name for
+ * Return the directory path of a `path`.
+ * @param path - path to extract the directory from.
  */
 export declare function dirname(path: string): string;
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract the name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export declare function basename(path: string, ext?: string): string;
+export declare function basename(path: string, suffix?: string): string;
 /**
- * Return the extension of the `path`.
+ * Return the extension of the `path` with leading period.
  * @param path with extension
+ * @returns extension (ex. for `file.ts` returns `.ts`)
  */
 export declare function extname(path: string): string;
 /**
@@ -62,7 +68,7 @@ export declare function parse(path: string): ParsedPath;
  * Converts a file URL to a path string.
  *
  * ```ts
- *      import { fromFileUrl } from "./posix.ts";
+ *      import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/posix.ts";
  *      fromFileUrl("file:///home/foo"); // "/home/foo"
  * ```
  * @param url of a file URL
@@ -72,7 +78,7 @@ export declare function fromFileUrl(url: string | URL): string;
  * Converts a path string to a file URL.
  *
  * ```ts
- *      import { toFileUrl } from "./posix.ts";
+ *      import { toFileUrl } from "https://deno.land/std@$STD_VERSION/path/posix.ts";
  *      toFileUrl("/home/foo"); // new URL("file:///home/foo")
  * ```
  * @param path to convert to file URL

package/esm/deps/deno.land/{std@0.120.0 → std@0.189.0}/path/posix.js

@@ -1,9 +1,10 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.
 import * as dntShim from "../../../../_dnt.shims.js";
-import { CHAR_DOT, CHAR_FORWARD_SLASH } from "./_constants.js";
-import { _format, assertPath, encodeWhitespace, isPosixPathSeparator, normalizeString, } from "./_util.js";
+import { CHAR_DOT } from "./_constants.js";
+import { _format, assertPath, encodeWhitespace, isPosixPathSeparator, lastPathSegment, normalizeString, stripSuffix, stripTrailingSeparators, } from "./_util.js";
 export const sep = "/";
 export const delimiter = ":";
 // path.resolve([from ...], to)
@@ -32,7 +33,7 @@ export function resolve(...pathSegments) {
             continue;
         }
         resolvedPath = `${path}/${resolvedPath}`;
-        resolvedAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+        resolvedAbsolute = isPosixPathSeparator(path.charCodeAt(0));
     }
     // At this point the path should be resolved to a full absolute path, but
     // handle relative paths to be safe (might happen when process.cwd() fails)
@@ -51,14 +52,16 @@ export function resolve(...pathSegments) {
 }
 /**
  * Normalize the `path`, resolving `'..'` and `'.'` segments.
+ * Note that resolving these segments does not necessarily mean that all will be eliminated.
+ * A `'..'` at the top-level will be preserved, and an empty path is canonically `'.'`.
  * @param path to be normalized
  */
 export function normalize(path) {
     assertPath(path);
     if (path.length === 0)
         return ".";
-    const isAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
-    const trailingSeparator = path.charCodeAt(path.length - 1) === CHAR_FORWARD_SLASH;
+    const isAbsolute = isPosixPathSeparator(path.charCodeAt(0));
+    const trailingSeparator = isPosixPathSeparator(path.charCodeAt(path.length - 1));
     // Normalize the path
     path = normalizeString(path, !isAbsolute, "/", isPosixPathSeparator);
     if (path.length === 0 && !isAbsolute)
@@ -75,7 +78,7 @@ export function normalize(path) {
  */
 export function isAbsolute(path) {
     assertPath(path);
-    return path.length > 0 && path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    return path.length > 0 && isPosixPathSeparator(path.charCodeAt(0));
 }
 /**
  * Join all given a sequence of `paths`,then normalizes the resulting path.
@@ -117,7 +120,7 @@ export function relative(from, to) {
     let fromStart = 1;
     const fromEnd = from.length;
     for (; fromStart < fromEnd; ++fromStart) {
-        if (from.charCodeAt(fromStart) !== CHAR_FORWARD_SLASH)
+        if (!isPosixPathSeparator(from.charCodeAt(fromStart)))
             break;
     }
     const fromLen = fromEnd - fromStart;
@@ -125,7 +128,7 @@ export function relative(from, to) {
     let toStart = 1;
     const toEnd = to.length;
     for (; toStart < toEnd; ++toStart) {
-        if (to.charCodeAt(toStart) !== CHAR_FORWARD_SLASH)
+        if (!isPosixPathSeparator(to.charCodeAt(toStart)))
             break;
     }
     const toLen = toEnd - toStart;
@@ -136,7 +139,7 @@ export function relative(from, to) {
     for (; i <= length; ++i) {
         if (i === length) {
             if (toLen > length) {
-                if (to.charCodeAt(toStart + i) === CHAR_FORWARD_SLASH) {
+                if (isPosixPathSeparator(to.charCodeAt(toStart + i))) {
                     // We get here if `from` is the exact base path for `to`.
                     // For example: from='/foo/bar'; to='/foo/bar/baz'
                     return to.slice(toStart + i + 1);
@@ -148,7 +151,7 @@ export function relative(from, to) {
                 }
             }
             else if (fromLen > length) {
-                if (from.charCodeAt(fromStart + i) === CHAR_FORWARD_SLASH) {
+                if (isPosixPathSeparator(from.charCodeAt(fromStart + i))) {
                     // We get here if `to` is the exact base path for `from`.
                     // For example: from='/foo/bar/baz'; to='/foo/bar'
                     lastCommonSep = i;
@@ -165,14 +168,14 @@ export function relative(from, to) {
         const toCode = to.charCodeAt(toStart + i);
         if (fromCode !== toCode)
             break;
-        else if (fromCode === CHAR_FORWARD_SLASH)
+        else if (isPosixPathSeparator(fromCode))
             lastCommonSep = i;
     }
     let out = "";
     // Generate the relative path based on the path difference between `to`
     // and `from`
     for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
-        if (i === fromEnd || from.charCodeAt(i) === CHAR_FORWARD_SLASH) {
+        if (i === fromEnd || isPosixPathSeparator(from.charCodeAt(i))) {
             if (out.length === 0)
                 out += "..";
             else
@@ -185,7 +188,7 @@ export function relative(from, to) {
         return out + to.slice(toStart + lastCommonSep);
     else {
         toStart += lastCommonSep;
-        if (to.charCodeAt(toStart) === CHAR_FORWARD_SLASH)
+        if (isPosixPathSeparator(to.charCodeAt(toStart)))
             ++toStart;
         return to.slice(toStart);
     }
@@ -199,119 +202,59 @@ export function toNamespacedPath(path) {
     return path;
 }
 /**
- * Return the directory name of a `path`.
- * @param path to determine name for
+ * Return the directory path of a `path`.
+ * @param path - path to extract the directory from.
  */
 export function dirname(path) {
-    assertPath(path);
     if (path.length === 0)
         return ".";
-    const hasRoot = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
     let end = -1;
-    let matchedSlash = true;
+    let matchedNonSeparator = false;
     for (let i = path.length - 1; i >= 1; --i) {
-        if (path.charCodeAt(i) === CHAR_FORWARD_SLASH) {
-            if (!matchedSlash) {
+        if (isPosixPathSeparator(path.charCodeAt(i))) {
+            if (matchedNonSeparator) {
                 end = i;
                 break;
             }
         }
         else {
-            // We saw the first non-path separator
-            matchedSlash = false;
+            matchedNonSeparator = true;
         }
     }
-    if (end === -1)
-        return hasRoot ? "/" : ".";
-    if (hasRoot && end === 1)
-        return "//";
-    return path.slice(0, end);
+    // No matches. Fallback based on provided path:
+    //
+    // - leading slashes paths
+    //     "/foo" => "/"
+    //     "///foo" => "/"
+    // - no slash path
+    //     "foo" => "."
+    if (end === -1) {
+        return isPosixPathSeparator(path.charCodeAt(0)) ? "/" : ".";
+    }
+    return stripTrailingSeparators(path.slice(0, end), isPosixPathSeparator);
 }
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract the name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export function basename(path, ext = "") {
-    if (ext !== undefined && typeof ext !== "string") {
-        throw new TypeError('"ext" argument must be a string');
-    }
+export function basename(path, suffix = "") {
     assertPath(path);
-    let start = 0;
-    let end = -1;
-    let matchedSlash = true;
-    let i;
-    if (ext !== undefined && ext.length > 0 && ext.length <= path.length) {
-        if (ext.length === path.length && ext === path)
-            return "";
-        let extIdx = ext.length - 1;
-        let firstNonSlashEnd = -1;
-        for (i = path.length - 1; i >= 0; --i) {
-            const code = path.charCodeAt(i);
-            if (code === CHAR_FORWARD_SLASH) {
-                // If we reached a path separator that was not part of a set of path
-                // separators at the end of the string, stop now
-                if (!matchedSlash) {
-                    start = i + 1;
-                    break;
-                }
-            }
-            else {
-                if (firstNonSlashEnd === -1) {
-                    // We saw the first non-path separator, remember this index in case
-                    // we need it if the extension ends up not matching
-                    matchedSlash = false;
-                    firstNonSlashEnd = i + 1;
-                }
-                if (extIdx >= 0) {
-                    // Try to match the explicit extension
-                    if (code === ext.charCodeAt(extIdx)) {
-                        if (--extIdx === -1) {
-                            // We matched the extension, so mark this as the end of our path
-                            // component
-                            end = i;
-                        }
-                    }
-                    else {
-                        // Extension does not match, so our result is the entire path
-                        // component
-                        extIdx = -1;
-                        end = firstNonSlashEnd;
-                    }
-                }
-            }
-        }
-        if (start === end)
-            end = firstNonSlashEnd;
-        else if (end === -1)
-            end = path.length;
-        return path.slice(start, end);
-    }
-    else {
-        for (i = path.length - 1; i >= 0; --i) {
-            if (path.charCodeAt(i) === CHAR_FORWARD_SLASH) {
-                // If we reached a path separator that was not part of a set of path
-                // separators at the end of the string, stop now
-                if (!matchedSlash) {
-                    start = i + 1;
-                    break;
-                }
-            }
-            else if (end === -1) {
-                // We saw the first non-path separator, mark this as the end of our
-                // path component
-                matchedSlash = false;
-                end = i + 1;
-            }
-        }
-        if (end === -1)
-            return "";
-        return path.slice(start, end);
+    if (path.length === 0)
+        return path;
+    if (typeof suffix !== "string") {
+        throw new TypeError(`Suffix must be a string. Received ${JSON.stringify(suffix)}`);
     }
+    const lastSegment = lastPathSegment(path, isPosixPathSeparator);
+    const strippedSegment = stripTrailingSeparators(lastSegment, isPosixPathSeparator);
+    return suffix ? stripSuffix(strippedSegment, suffix) : strippedSegment;
 }
 /**
- * Return the extension of the `path`.
+ * Return the extension of the `path` with leading period.
  * @param path with extension
+ * @returns extension (ex. for `file.ts` returns `.ts`)
  */
 export function extname(path) {
     assertPath(path);
@@ -324,7 +267,7 @@ export function extname(path) {
     let preDotState = 0;
     for (let i = path.length - 1; i >= 0; --i) {
         const code = path.charCodeAt(i);
-        if (code === CHAR_FORWARD_SLASH) {
+        if (isPosixPathSeparator(code)) {
             // If we reached a path separator that was not part of a set of path
             // separators at the end of the string, stop now
             if (!matchedSlash) {
@@ -381,7 +324,7 @@ export function parse(path) {
     const ret = { root: "", dir: "", base: "", ext: "", name: "" };
     if (path.length === 0)
         return ret;
-    const isAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    const isAbsolute = isPosixPathSeparator(path.charCodeAt(0));
     let start;
     if (isAbsolute) {
         ret.root = "/";
@@ -401,7 +344,7 @@ export function parse(path) {
     // Get non-dir info
     for (; i >= start; --i) {
         const code = path.charCodeAt(i);
-        if (code === CHAR_FORWARD_SLASH) {
+        if (isPosixPathSeparator(code)) {
             // If we reached a path separator that was not part of a set of path
             // separators at the end of the string, stop now
             if (!matchedSlash) {
@@ -443,6 +386,8 @@ export function parse(path) {
                 ret.base = ret.name = path.slice(startPart, end);
             }
         }
+        // Fallback to '/' in case there is no basename
+        ret.base = ret.base || "/";
     }
     else {
         if (startPart === 0 && isAbsolute) {
@@ -455,8 +400,9 @@ export function parse(path) {
         }
         ret.ext = path.slice(startDot, end);
     }
-    if (startPart > 0)
-        ret.dir = path.slice(0, startPart - 1);
+    if (startPart > 0) {
+        ret.dir = stripTrailingSeparators(path.slice(0, startPart - 1), isPosixPathSeparator);
+    }
     else if (isAbsolute)
         ret.dir = "/";
     return ret;
@@ -465,7 +411,7 @@ export function parse(path) {
  * Converts a file URL to a path string.
  *
  * ```ts
- *      import { fromFileUrl } from "./posix.ts";
+ *      import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/posix.ts";
  *      fromFileUrl("file:///home/foo"); // "/home/foo"
  * ```
  * @param url of a file URL
@@ -481,7 +427,7 @@ export function fromFileUrl(url) {
  * Converts a path string to a file URL.
  *
  * ```ts
- *      import { toFileUrl } from "./posix.ts";
+ *      import { toFileUrl } from "https://deno.land/std@$STD_VERSION/path/posix.ts";
  *      toFileUrl("/home/foo"); // new URL("file:///home/foo")
  * ```
  * @param path to convert to file URL

package/esm/deps/deno.land/{std@0.120.0 → std@0.189.0}/path/separator.js

@@ -1,4 +1,4 @@
-// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 import { isWindows } from "../_util/os.js";
 export const SEP = isWindows ? "\\" : "/";

package/{types/deps/deno.land/std@0.120.0 → esm/deps/deno.land/std@0.189.0}/path/win32.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import type { FormatInputPathObject, ParsedPath } from "./_interface.js";
 export declare const sep = "\\";
 export declare const delimiter = ";";
@@ -36,19 +37,22 @@ export declare function relative(from: string, to: string): string;
  */
 export declare function toNamespacedPath(path: string): string;
 /**
- * Return the directory name of a `path`.
- * @param path to determine name for
+ * Return the directory path of a `path`.
+ * @param path - path to extract the directory from.
  */
 export declare function dirname(path: string): string;
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export declare function basename(path: string, ext?: string): string;
+export declare function basename(path: string, suffix?: string): string;
 /**
- * Return the extension of the `path`.
+ * Return the extension of the `path` with leading period.
  * @param path with extension
+ * @returns extension (ex. for `file.ts` returns `.ts`)
  */
 export declare function extname(path: string): string;
 /**
@@ -65,7 +69,7 @@ export declare function parse(path: string): ParsedPath;
  * Converts a file URL to a path string.
  *
  * ```ts
- *      import { fromFileUrl } from "./win32.ts";
+ *      import { fromFileUrl } from "https://deno.land/std@$STD_VERSION/path/win32.ts";
  *      fromFileUrl("file:///home/foo"); // "\\home\\foo"
  *      fromFileUrl("file:///C:/Users/foo"); // "C:\\Users\\foo"
  *      fromFileUrl("file://localhost/home/foo"); // "\\\\localhost\\home\\foo"
@@ -77,7 +81,7 @@ export declare function fromFileUrl(url: string | URL): string;
  * Converts a path string to a file URL.
  *
  * ```ts
- *      import { toFileUrl } from "./win32.ts";
+ *      import { toFileUrl } from "https://deno.land/std@$STD_VERSION/path/win32.ts";
  *      toFileUrl("\\home\\foo"); // new URL("file:///home/foo")
  *      toFileUrl("C:\\Users\\foo"); // new URL("file:///C:/Users/foo")
  *      toFileUrl("\\\\127.0.0.1\\home\\foo"); // new URL("file://127.0.0.1/home/foo")