keep-a-changelog 2.6.0 → 2.6.2

package/esm/std/path/to_file_url.js

@@ -1,28 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { isWindows } from "./_os.js";
-import { toFileUrl as posixToFileUrl } from "./posix/to_file_url.js";
-import { toFileUrl as windowsToFileUrl } from "./windows/to_file_url.js";
-/**
- * Converts a path string to a file URL.
- *
- * @example Usage
- * ```ts
- * import { toFileUrl } from "to_file_url.ts";
- * import { assertEquals } from "../assert/mod.ts";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(toFileUrl("\\home\\foo"), new URL("file:///home/foo"));
- *   assertEquals(toFileUrl("C:\\Users\\foo"), new URL("file:///C:/Users/foo"));
- *   assertEquals(toFileUrl("\\\\127.0.0.1\\home\\foo"), new URL("file://127.0.0.1/home/foo"));
- * } else {
- *   assertEquals(toFileUrl("/home/foo"), new URL("file:///home/foo"));
- * }
- * ```
- *
- * @param path Path to convert to file URL.
- * @returns The file URL equivalent to the path.
- */
-export function toFileUrl(path) {
-    return isWindows ? windowsToFileUrl(path) : posixToFileUrl(path);
-}

package/esm/std/path/to_namespaced_path.d.ts

@@ -1,20 +0,0 @@
-/**
- * Resolves path to a namespace path.  This is a no-op on
- * non-windows systems.
- *
- * @example Usage
- * ```ts
- * import { toNamespacedPath } from "to_namespaced_path.ts";
- * import { assertEquals } from "../assert/mod.ts";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(toNamespacedPath("C:\\foo\\bar"), "\\\\?\\C:\\foo\\bar");
- * } else {
- *   assertEquals(toNamespacedPath("/foo/bar"), "/foo/bar");
- * }
- * ```
- *
- * @param path Path to resolve to namespace.
- * @returns The resolved namespace path.
- */
-export declare function toNamespacedPath(path: string): string;

package/esm/std/path/to_namespaced_path.js

@@ -1,29 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { isWindows } from "./_os.js";
-import { toNamespacedPath as posixToNamespacedPath } from "./posix/to_namespaced_path.js";
-import { toNamespacedPath as windowsToNamespacedPath } from "./windows/to_namespaced_path.js";
-/**
- * Resolves path to a namespace path.  This is a no-op on
- * non-windows systems.
- *
- * @example Usage
- * ```ts
- * import { toNamespacedPath } from "to_namespaced_path.ts";
- * import { assertEquals } from "../assert/mod.ts";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(toNamespacedPath("C:\\foo\\bar"), "\\\\?\\C:\\foo\\bar");
- * } else {
- *   assertEquals(toNamespacedPath("/foo/bar"), "/foo/bar");
- * }
- * ```
- *
- * @param path Path to resolve to namespace.
- * @returns The resolved namespace path.
- */
-export function toNamespacedPath(path) {
-    return isWindows
-        ? windowsToNamespacedPath(path)
-        : posixToNamespacedPath(path);
-}

package/esm/std/path/types.d.ts

@@ -1,37 +0,0 @@
-/**
- * A parsed path object generated by path.parse() or consumed by path.format().
- *
- * @example
- * ```ts
- * import { parse } from "mod.ts";
- *
- * const parsedPathObj = parse("c:\\path\\dir\\index.html");
- * parsedPathObj.root; // "c:\\"
- * parsedPathObj.dir; // "c:\\path\\dir"
- * parsedPathObj.base; // "index.html"
- * parsedPathObj.ext; // ".html"
- * parsedPathObj.name; // "index"
- * ```
- */
-export interface ParsedPath {
-    /**
-     * The root of the path such as '/' or 'c:\'
-     */
-    root: string;
-    /**
-     * The full directory path of the parent such as '/home/user/dir' or 'c:\path\dir'
-     */
-    dir: string;
-    /**
-     * The file name including extension (if any) such as 'index.html'
-     */
-    base: string;
-    /**
-     * The file extension (if any) such as '.html'
-     */
-    ext: string;
-    /**
-     * The file name without extension (if any) such as 'index'
-     */
-    name: string;
-}

package/esm/std/path/windows/_util.d.ts

@@ -1,3 +0,0 @@
-export declare function isPosixPathSeparator(code: number): boolean;
-export declare function isPathSeparator(code: number): boolean;
-export declare function isWindowsDeviceRoot(code: number): boolean;

package/esm/std/path/windows/_util.js

@@ -1,15 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// Copyright the Browserify authors. MIT License.
-// Ported from https://github.com/browserify/path-browserify/
-// This module is browser compatible.
-import { CHAR_BACKWARD_SLASH, CHAR_FORWARD_SLASH, CHAR_LOWERCASE_A, CHAR_LOWERCASE_Z, CHAR_UPPERCASE_A, CHAR_UPPERCASE_Z, } from "../_common/constants.js";
-export function isPosixPathSeparator(code) {
-    return code === CHAR_FORWARD_SLASH;
-}
-export function isPathSeparator(code) {
-    return code === CHAR_FORWARD_SLASH || code === CHAR_BACKWARD_SLASH;
-}
-export function isWindowsDeviceRoot(code) {
-    return ((code >= CHAR_LOWERCASE_A && code <= CHAR_LOWERCASE_Z) ||
-        (code >= CHAR_UPPERCASE_A && code <= CHAR_UPPERCASE_Z));
-}

package/esm/std/path/windows/basename.d.ts

@@ -1,22 +0,0 @@
-/**
- * Return the last portion of a `path`.
- * Trailing directory separators are ignored, and optional suffix is removed.
- *
- * @example Usage
- * ```ts
- * import { basename } from "basename.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(basename("C:\\user\\Documents\\"), "Documents");
- * assertEquals(basename("C:\\user\\Documents\\image.png"), "image.png");
- * assertEquals(basename("C:\\user\\Documents\\image.png", ".png"), "image");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `basename` from `@std/path/windows/unstable-basename`.
- *
- * @param path The path to extract the name from.
- * @param suffix The suffix to remove from extracted name.
- * @returns The extracted name.
- */
-export declare function basename(path: string, suffix?: string): string;

package/esm/std/path/windows/basename.js

@@ -1,44 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertArgs, lastPathSegment, stripSuffix, } from "../_common/basename.js";
-import { CHAR_COLON } from "../_common/constants.js";
-import { stripTrailingSeparators } from "../_common/strip_trailing_separators.js";
-import { isPathSeparator, isWindowsDeviceRoot } from "./_util.js";
-/**
- * Return the last portion of a `path`.
- * Trailing directory separators are ignored, and optional suffix is removed.
- *
- * @example Usage
- * ```ts
- * import { basename } from "basename.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(basename("C:\\user\\Documents\\"), "Documents");
- * assertEquals(basename("C:\\user\\Documents\\image.png"), "image.png");
- * assertEquals(basename("C:\\user\\Documents\\image.png", ".png"), "image");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `basename` from `@std/path/windows/unstable-basename`.
- *
- * @param path The path to extract the name from.
- * @param suffix The suffix to remove from extracted name.
- * @returns The extracted name.
- */
-export function basename(path, suffix = "") {
-    assertArgs(path, suffix);
-    // Check for a drive letter prefix so as not to mistake the following
-    // path separator as an extra separator at the end of the path that can be
-    // disregarded
-    let start = 0;
-    if (path.length >= 2) {
-        const drive = path.charCodeAt(0);
-        if (isWindowsDeviceRoot(drive)) {
-            if (path.charCodeAt(1) === CHAR_COLON)
-                start = 2;
-        }
-    }
-    const lastSegment = lastPathSegment(path, isPathSeparator, start);
-    const strippedSegment = stripTrailingSeparators(lastSegment, isPathSeparator);
-    return suffix ? stripSuffix(strippedSegment, suffix) : strippedSegment;
-}

package/esm/std/path/windows/constants.d.ts

@@ -1,12 +0,0 @@
-/**
- * The character used to separate entries in the PATH environment variable.
- */
-export declare const DELIMITER: ";";
-/**
- * The character used to separate components of a file path.
- */
-export declare const SEPARATOR: "\\";
-/**
- * A regular expression that matches one or more path separators.
- */
-export declare const SEPARATOR_PATTERN: RegExp;

package/esm/std/path/windows/constants.js

@@ -1,14 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-/**
- * The character used to separate entries in the PATH environment variable.
- */
-export const DELIMITER = ";";
-/**
- * The character used to separate components of a file path.
- */
-export const SEPARATOR = "\\";
-/**
- * A regular expression that matches one or more path separators.
- */
-export const SEPARATOR_PATTERN = /[\\/]+/;

package/esm/std/path/windows/dirname.d.ts

@@ -1,19 +0,0 @@
-/**
- * Return the directory path of a `path`.
- *
- * @example Usage
- * ```ts
- * import { dirname } from "dirname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const dir = dirname("C:\\foo\\bar\\baz.ext");
- * assertEquals(dir, "C:\\foo\\bar");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `dirname` from `@std/path/windows/unstable-dirname`.
- *
- * @param path The path to get the directory from.
- * @returns The directory path.
- */
-export declare function dirname(path: string): string;

package/esm/std/path/windows/dirname.js

@@ -1,112 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertArg } from "../_common/dirname.js";
-import { CHAR_COLON } from "../_common/constants.js";
-import { stripTrailingSeparators } from "../_common/strip_trailing_separators.js";
-import { isPathSeparator, isPosixPathSeparator, isWindowsDeviceRoot, } from "./_util.js";
-/**
- * Return the directory path of a `path`.
- *
- * @example Usage
- * ```ts
- * import { dirname } from "dirname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const dir = dirname("C:\\foo\\bar\\baz.ext");
- * assertEquals(dir, "C:\\foo\\bar");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `dirname` from `@std/path/windows/unstable-dirname`.
- *
- * @param path The path to get the directory from.
- * @returns The directory path.
- */
-export function dirname(path) {
-    assertArg(path);
-    const len = path.length;
-    let rootEnd = -1;
-    let end = -1;
-    let matchedSlash = true;
-    let offset = 0;
-    const code = path.charCodeAt(0);
-    // Try to match a root
-    if (len > 1) {
-        if (isPathSeparator(code)) {
-            // Possible UNC root
-            rootEnd = offset = 1;
-            if (isPathSeparator(path.charCodeAt(1))) {
-                // Matched double path separator at beginning
-                let j = 2;
-                let last = j;
-                // Match 1 or more non-path separators
-                for (; j < len; ++j) {
-                    if (isPathSeparator(path.charCodeAt(j)))
-                        break;
-                }
-                if (j < len && j !== last) {
-                    // Matched!
-                    last = j;
-                    // Match 1 or more path separators
-                    for (; j < len; ++j) {
-                        if (!isPathSeparator(path.charCodeAt(j)))
-                            break;
-                    }
-                    if (j < len && j !== last) {
-                        // Matched!
-                        last = j;
-                        // Match 1 or more non-path separators
-                        for (; j < len; ++j) {
-                            if (isPathSeparator(path.charCodeAt(j)))
-                                break;
-                        }
-                        if (j === len) {
-                            // We matched a UNC root only
-                            return path;
-                        }
-                        if (j !== last) {
-                            // We matched a UNC root with leftovers
-                            // Offset by 1 to include the separator after the UNC root to
-                            // treat it as a "normal root" on top of a (UNC) root
-                            rootEnd = offset = j + 1;
-                        }
-                    }
-                }
-            }
-        }
-        else if (isWindowsDeviceRoot(code)) {
-            // Possible device root
-            if (path.charCodeAt(1) === CHAR_COLON) {
-                rootEnd = offset = 2;
-                if (len > 2) {
-                    if (isPathSeparator(path.charCodeAt(2)))
-                        rootEnd = offset = 3;
-                }
-            }
-        }
-    }
-    else if (isPathSeparator(code)) {
-        // `path` contains just a path separator, exit early to avoid
-        // unnecessary work
-        return path;
-    }
-    for (let i = len - 1; i >= offset; --i) {
-        if (isPathSeparator(path.charCodeAt(i))) {
-            if (!matchedSlash) {
-                end = i;
-                break;
-            }
-        }
-        else {
-            // We saw the first non-path separator
-            matchedSlash = false;
-        }
-    }
-    if (end === -1) {
-        if (rootEnd === -1)
-            return ".";
-        else
-            end = rootEnd;
-    }
-    return stripTrailingSeparators(path.slice(0, end), isPosixPathSeparator);
-}

package/esm/std/path/windows/extname.d.ts

@@ -1,19 +0,0 @@
-/**
- * Return the extension of the `path` with leading period.
- *
- * @example Usage
- * ```ts
- * import { extname } from "extname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const ext = extname("file.ts");
- * assertEquals(ext, ".ts");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `extname` from `@std/path/windows/unstable-extname`.
- *
- * @param path The path to get the extension from.
- * @returns The extension of the `path`.
- */
-export declare function extname(path: string): string;

package/esm/std/path/windows/extname.js

@@ -1,81 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { CHAR_COLON, CHAR_DOT } from "../_common/constants.js";
-import { assertPath } from "../_common/assert_path.js";
-import { isPathSeparator, isWindowsDeviceRoot } from "./_util.js";
-/**
- * Return the extension of the `path` with leading period.
- *
- * @example Usage
- * ```ts
- * import { extname } from "extname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const ext = extname("file.ts");
- * assertEquals(ext, ".ts");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `extname` from `@std/path/windows/unstable-extname`.
- *
- * @param path The path to get the extension from.
- * @returns The extension of the `path`.
- */
-export function extname(path) {
-    assertPath(path);
-    let start = 0;
-    let startDot = -1;
-    let startPart = 0;
-    let end = -1;
-    let matchedSlash = true;
-    // Track the state of characters (if any) we see before our first dot and
-    // after any path separator we find
-    let preDotState = 0;
-    // Check for a drive letter prefix so as not to mistake the following
-    // path separator as an extra separator at the end of the path that can be
-    // disregarded
-    if (path.length >= 2 &&
-        path.charCodeAt(1) === CHAR_COLON &&
-        isWindowsDeviceRoot(path.charCodeAt(0))) {
-        start = startPart = 2;
-    }
-    for (let i = path.length - 1; i >= start; --i) {
-        const code = path.charCodeAt(i);
-        if (isPathSeparator(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) {
-                startPart = i + 1;
-                break;
-            }
-            continue;
-        }
-        if (end === -1) {
-            // We saw the first non-path separator, mark this as the end of our
-            // extension
-            matchedSlash = false;
-            end = i + 1;
-        }
-        if (code === CHAR_DOT) {
-            // If this is our first dot, mark it as the start of our extension
-            if (startDot === -1)
-                startDot = i;
-            else if (preDotState !== 1)
-                preDotState = 1;
-        }
-        else if (startDot !== -1) {
-            // We saw a non-dot and non-path separator before our dot, so we should
-            // have a good chance at having a non-empty extension
-            preDotState = -1;
-        }
-    }
-    if (startDot === -1 ||
-        end === -1 ||
-        // We saw a non-dot character immediately before the dot
-        preDotState === 0 ||
-        // The (right-most) trimmed path component is exactly '..'
-        (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)) {
-        return "";
-    }
-    return path.slice(startDot, end);
-}

package/esm/std/path/windows/format.d.ts

@@ -1,23 +0,0 @@
-import type { ParsedPath } from "../types.js";
-/**
- * Generate a path from `ParsedPath` object.
- *
- * @example Usage
- * ```ts
- * import { format } from "format.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const path = format({
- *   root: "C:\\",
- *   dir: "C:\\path\\dir",
- *   base: "file.txt",
- *   ext: ".txt",
- *   name: "file"
- * });
- * assertEquals(path, "C:\\path\\dir\\file.txt");
- * ```
- *
- * @param pathObject The path object to format.
- * @returns The formatted path.
- */
-export declare function format(pathObject: Partial<ParsedPath>): string;

package/esm/std/path/windows/format.js

@@ -1,28 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { _format, assertArg } from "../_common/format.js";
-/**
- * Generate a path from `ParsedPath` object.
- *
- * @example Usage
- * ```ts
- * import { format } from "format.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const path = format({
- *   root: "C:\\",
- *   dir: "C:\\path\\dir",
- *   base: "file.txt",
- *   ext: ".txt",
- *   name: "file"
- * });
- * assertEquals(path, "C:\\path\\dir\\file.txt");
- * ```
- *
- * @param pathObject The path object to format.
- * @returns The formatted path.
- */
-export function format(pathObject) {
-    assertArg(pathObject);
-    return _format("\\", pathObject);
-}

package/esm/std/path/windows/from_file_url.d.ts

@@ -1,18 +0,0 @@
-/// <reference types="node" />
-/**
- * Converts a file URL to a path string.
- *
- * @example Usage
- * ```ts
- * import { fromFileUrl } from "from_file_url.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(fromFileUrl("file:///home/foo"), "\\home\\foo");
- * assertEquals(fromFileUrl("file:///C:/Users/foo"), "C:\\Users\\foo");
- * assertEquals(fromFileUrl("file://localhost/home/foo"), "\\home\\foo");
- * ```
- *
- * @param url The file URL to convert.
- * @returns The path string.
- */
-export declare function fromFileUrl(url: URL | string): string;

package/esm/std/path/windows/from_file_url.js

@@ -1,30 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertArg } from "../_common/from_file_url.js";
-/**
- * Converts a file URL to a path string.
- *
- * @example Usage
- * ```ts
- * import { fromFileUrl } from "from_file_url.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(fromFileUrl("file:///home/foo"), "\\home\\foo");
- * assertEquals(fromFileUrl("file:///C:/Users/foo"), "C:\\Users\\foo");
- * assertEquals(fromFileUrl("file://localhost/home/foo"), "\\home\\foo");
- * ```
- *
- * @param url The file URL to convert.
- * @returns The path string.
- */
-export function fromFileUrl(url) {
-    url = assertArg(url);
-    let path = decodeURIComponent(url.pathname.replace(/\//g, "\\").replace(/%(?![0-9A-Fa-f]{2})/g, "%25")).replace(/^\\*([A-Za-z]:)(\\|$)/, "$1\\");
-    if (url.hostname !== "") {
-        // Note: The `URL` implementation guarantees that the drive letter and
-        // hostname are mutually exclusive. Otherwise it would not have been valid
-        // to append the hostname and path like this.
-        path = `\\\\${url.hostname}${path}`;
-    }
-    return path;
-}

package/esm/std/path/windows/glob_to_regexp.d.ts

@@ -1,70 +0,0 @@
-import { type GlobOptions } from "../_common/glob_to_reg_exp.js";
-/** Convert a glob string to a regular expression.
- *
- * Tries to match bash glob expansion as closely as possible.
- *
- * Basic glob syntax:
- * - `*` - Matches everything without leaving the path segment.
- * - `?` - Matches any single character.
- * - `{foo,bar}` - Matches `foo` or `bar`.
- * - `[abcd]` - Matches `a`, `b`, `c` or `d`.
- * - `[a-d]` - Matches `a`, `b`, `c` or `d`.
- * - `[!abcd]` - Matches any single character besides `a`, `b`, `c` or `d`.
- * - `[[:<class>:]]` - Matches any character belonging to `<class>`.
- *     - `[[:alnum:]]` - Matches any digit or letter.
- *     - `[[:digit:]abc]` - Matches any digit, `a`, `b` or `c`.
- *     - See https://facelessuser.github.io/wcmatch/glob/#posix-character-classes
- *       for a complete list of supported character classes.
- * - `\` - Escapes the next character for an `os` other than `"windows"`.
- * - \` - Escapes the next character for `os` set to `"windows"`.
- * - `/` - Path separator.
- * - `\` - Additional path separator only for `os` set to `"windows"`.
- *
- * Extended syntax:
- * - Requires `{ extended: true }`.
- * - `?(foo|bar)` - Matches 0 or 1 instance of `{foo,bar}`.
- * - `@(foo|bar)` - Matches 1 instance of `{foo,bar}`. They behave the same.
- * - `*(foo|bar)` - Matches _n_ instances of `{foo,bar}`.
- * - `+(foo|bar)` - Matches _n > 0_ instances of `{foo,bar}`.
- * - `!(foo|bar)` - Matches anything other than `{foo,bar}`.
- * - See https://www.linuxjournal.com/content/bash-extended-globbing.
- *
- * Globstar syntax:
- * - Requires `{ globstar: true }`.
- * - `**` - Matches any number of any path segments.
- *     - Must comprise its entire path segment in the provided glob.
- * - See https://www.linuxjournal.com/content/globstar-new-bash-globbing-option.
- *
- * Note the following properties:
- * - The generated `RegExp` is anchored at both start and end.
- * - Repeating and trailing separators are tolerated. Trailing separators in the
- *   provided glob have no meaning and are discarded.
- * - Absolute globs will only match absolute paths, etc.
- * - Empty globs will match nothing.
- * - Any special glob syntax must be contained to one path segment. For example,
- *   `?(foo|bar/baz)` is invalid. The separator will take precedence and the
- *   first segment ends with an unclosed group.
- * - If a path segment ends with unclosed groups or a dangling escape prefix, a
- *   parse error has occurred. Every character for that segment is taken
- *   literally in this event.
- *
- * Limitations:
- * - A negative group like `!(foo|bar)` will wrongly be converted to a negative
- *   look-ahead followed by a wildcard. This means that `!(foo).js` will wrongly
- *   fail to match `foobar.js`, even though `foobar` is not `foo`. Effectively,
- *   `!(foo|bar)` is treated like `!(@(foo|bar)*)`. This will work correctly if
- *   the group occurs not nested at the end of the segment.
- *
- * @example Usage
- * ```ts
- * import { globToRegExp } from "glob_to_regexp.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(globToRegExp("*.js"), /^[^\\/]*\.js(?:\\|\/)*$/);
- * ```
- *
- * @param glob Glob string to convert.
- * @param options Conversion options.
- * @returns The regular expression equivalent to the glob.
- */
-export declare function globToRegExp(glob: string, options?: GlobOptions): RegExp;