keep-a-changelog 2.6.0 → 2.6.2

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

@@ -1,82 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { _globToRegExp, } from "../_common/glob_to_reg_exp.js";
-const constants = {
-    sep: "(?:\\\\|/)+",
-    sepMaybe: "(?:\\\\|/)*",
-    seps: ["\\", "/"],
-    globstar: "(?:[^\\\\/]*(?:\\\\|/|$)+)*",
-    wildcard: "[^\\\\/]*",
-    escapePrefix: "`",
-};
-/** 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 function globToRegExp(glob, options = {}) {
-    return _globToRegExp(constants, glob, options);
-}

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

@@ -1,16 +0,0 @@
-/**
- * Verifies whether provided path is absolute.
- *
- * @example Usage
- * ```ts
- * import { isAbsolute } from "is_absolute.ts";
- * import { assert, assertFalse } from "../../assert/mod.ts";
- *
- * assert(isAbsolute("C:\\foo\\bar"));
- * assertFalse(isAbsolute("..\\baz"));
- * ```
- *
- * @param path The path to verify.
- * @returns `true` if the path is absolute, `false` otherwise.
- */
-export declare function isAbsolute(path: string): boolean;

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

@@ -1,38 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { CHAR_COLON } from "../_common/constants.js";
-import { assertPath } from "../_common/assert_path.js";
-import { isPathSeparator, isWindowsDeviceRoot } from "./_util.js";
-/**
- * Verifies whether provided path is absolute.
- *
- * @example Usage
- * ```ts
- * import { isAbsolute } from "is_absolute.ts";
- * import { assert, assertFalse } from "../../assert/mod.ts";
- *
- * assert(isAbsolute("C:\\foo\\bar"));
- * assertFalse(isAbsolute("..\\baz"));
- * ```
- *
- * @param path The path to verify.
- * @returns `true` if the path is absolute, `false` otherwise.
- */
-export function isAbsolute(path) {
-    assertPath(path);
-    const len = path.length;
-    if (len === 0)
-        return false;
-    const code = path.charCodeAt(0);
-    if (isPathSeparator(code)) {
-        return true;
-    }
-    else if (isWindowsDeviceRoot(code)) {
-        // Possible device root
-        if (len > 2 && path.charCodeAt(1) === CHAR_COLON) {
-            if (isPathSeparator(path.charCodeAt(2)))
-                return true;
-        }
-    }
-    return false;
-}

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

@@ -1,19 +0,0 @@
-/**
- * Join all given a sequence of `paths`,then normalizes the resulting path.
- *
- * @example Usage
- * ```ts
- * import { join } from "join.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const joined = join("C:\\foo", "bar", "baz\\..");
- * assertEquals(joined, "C:\\foo\\bar");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `join` from `@std/path/windows/unstable-join`.
- *
- * @param paths The paths to join.
- * @returns The joined path.
- */
-export declare function join(...paths: string[]): string;

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

@@ -1,74 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertPath } from "../_common/assert_path.js";
-import { isPathSeparator } from "./_util.js";
-import { normalize } from "./normalize.js";
-/**
- * Join all given a sequence of `paths`,then normalizes the resulting path.
- *
- * @example Usage
- * ```ts
- * import { join } from "join.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const joined = join("C:\\foo", "bar", "baz\\..");
- * assertEquals(joined, "C:\\foo\\bar");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `join` from `@std/path/windows/unstable-join`.
- *
- * @param paths The paths to join.
- * @returns The joined path.
- */
-export function join(...paths) {
-    paths.forEach((path) => assertPath(path));
-    paths = paths.filter((path) => path.length > 0);
-    if (paths.length === 0)
-        return ".";
-    // Make sure that the joined path doesn't start with two slashes, because
-    // normalize() will mistake it for an UNC path then.
-    //
-    // This step is skipped when it is very clear that the user actually
-    // intended to point at an UNC path. This is assumed when the first
-    // non-empty string arguments starts with exactly two slashes followed by
-    // at least one more non-slash character.
-    //
-    // Note that for normalize() to treat a path as an UNC path it needs to
-    // have at least 2 components, so we don't filter for that here.
-    // This means that the user can use join to construct UNC paths from
-    // a server name and a share name; for example:
-    //   path.join('//server', 'share') -> '\\\\server\\share\\'
-    let needsReplace = true;
-    let slashCount = 0;
-    const firstPart = paths[0];
-    if (isPathSeparator(firstPart.charCodeAt(0))) {
-        ++slashCount;
-        const firstLen = firstPart.length;
-        if (firstLen > 1) {
-            if (isPathSeparator(firstPart.charCodeAt(1))) {
-                ++slashCount;
-                if (firstLen > 2) {
-                    if (isPathSeparator(firstPart.charCodeAt(2)))
-                        ++slashCount;
-                    else {
-                        // We matched a UNC path in the first part
-                        needsReplace = false;
-                    }
-                }
-            }
-        }
-    }
-    let joined = paths.join("\\");
-    if (needsReplace) {
-        // Find any more consecutive slashes we need to replace
-        for (; slashCount < joined.length; ++slashCount) {
-            if (!isPathSeparator(joined.charCodeAt(slashCount)))
-                break;
-        }
-        // Replace the slashes if needed
-        if (slashCount >= 2)
-            joined = `\\${joined.slice(slashCount)}`;
-    }
-    return normalize(joined);
-}

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

@@ -1,20 +0,0 @@
-import type { GlobOptions } from "../_common/glob_to_reg_exp.js";
-export type { GlobOptions };
-/**
- * Like join(), but doesn't collapse "**\/.." when `globstar` is true.
- *
- * @example Usage
- *
- * ```ts
- * import { joinGlobs } from "join_globs.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const joined = joinGlobs(["foo", "**", "bar"], { globstar: true });
- * assertEquals(joined, "foo\\**\\bar");
- * ```
- *
- * @param globs The globs to join.
- * @param options The options for glob pattern.
- * @returns The joined glob pattern.
- */
-export declare function joinGlobs(globs: string[], options?: Pick<GlobOptions, "globstar">): string;

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

@@ -1,41 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { join } from "./join.js";
-import { SEPARATOR } from "./constants.js";
-import { normalizeGlob } from "./normalize_glob.js";
-/**
- * Like join(), but doesn't collapse "**\/.." when `globstar` is true.
- *
- * @example Usage
- *
- * ```ts
- * import { joinGlobs } from "join_globs.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const joined = joinGlobs(["foo", "**", "bar"], { globstar: true });
- * assertEquals(joined, "foo\\**\\bar");
- * ```
- *
- * @param globs The globs to join.
- * @param options The options for glob pattern.
- * @returns The joined glob pattern.
- */
-export function joinGlobs(globs, options = {}) {
-    const { globstar = false } = options;
-    if (!globstar || globs.length === 0) {
-        return join(...globs);
-    }
-    let joined;
-    for (const glob of globs) {
-        const path = glob;
-        if (path.length > 0) {
-            if (!joined)
-                joined = path;
-            else
-                joined += `${SEPARATOR}${path}`;
-        }
-    }
-    if (!joined)
-        return ".";
-    return normalizeGlob(joined, { globstar });
-}

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

@@ -1,21 +0,0 @@
-/**
- * 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 `'.'`.
- *
- * @example Usage
- * ```ts
- * import { normalize } from "normalize.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const normalized = normalize("C:\\foo\\..\\bar");
- * assertEquals(normalized, "C:\\bar");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `normalize` from `@std/path/windows/unstable-normalize`.
- *
- * @param path The path to normalize
- * @returns The normalized path
- */
-export declare function normalize(path: string): string;

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

@@ -1,134 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertArg } from "../_common/normalize.js";
-import { CHAR_COLON } from "../_common/constants.js";
-import { normalizeString } from "../_common/normalize_string.js";
-import { isPathSeparator, isWindowsDeviceRoot } from "./_util.js";
-/**
- * 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 `'.'`.
- *
- * @example Usage
- * ```ts
- * import { normalize } from "normalize.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const normalized = normalize("C:\\foo\\..\\bar");
- * assertEquals(normalized, "C:\\bar");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `normalize` from `@std/path/windows/unstable-normalize`.
- *
- * @param path The path to normalize
- * @returns The normalized path
- */
-export function normalize(path) {
-    assertArg(path);
-    const len = path.length;
-    let rootEnd = 0;
-    let device;
-    let isAbsolute = false;
-    const code = path.charCodeAt(0);
-    // Try to match a root
-    if (len > 1) {
-        if (isPathSeparator(code)) {
-            // Possible UNC root
-            // If we started with a separator, we know we at least have an absolute
-            // path of some kind (UNC or otherwise)
-            isAbsolute = true;
-            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) {
-                    const firstPart = path.slice(last, j);
-                    // 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 the normalized version of the UNC root since there
-                            // is nothing left to process
-                            return `\\\\${firstPart}\\${path.slice(last)}\\`;
-                        }
-                        else if (j !== last) {
-                            // We matched a UNC root with leftovers
-                            device = `\\\\${firstPart}\\${path.slice(last, j)}`;
-                            rootEnd = j;
-                        }
-                    }
-                }
-            }
-            else {
-                rootEnd = 1;
-            }
-        }
-        else if (isWindowsDeviceRoot(code)) {
-            // Possible device root
-            if (path.charCodeAt(1) === CHAR_COLON) {
-                device = path.slice(0, 2);
-                rootEnd = 2;
-                if (len > 2) {
-                    if (isPathSeparator(path.charCodeAt(2))) {
-                        // Treat separator following drive name as an absolute path
-                        // indicator
-                        isAbsolute = true;
-                        rootEnd = 3;
-                    }
-                }
-            }
-        }
-    }
-    else if (isPathSeparator(code)) {
-        // `path` contains just a path separator, exit early to avoid unnecessary
-        // work
-        return "\\";
-    }
-    let tail;
-    if (rootEnd < len) {
-        tail = normalizeString(path.slice(rootEnd), !isAbsolute, "\\", isPathSeparator);
-    }
-    else {
-        tail = "";
-    }
-    if (tail.length === 0 && !isAbsolute)
-        tail = ".";
-    if (tail.length > 0 && isPathSeparator(path.charCodeAt(len - 1))) {
-        tail += "\\";
-    }
-    if (device === undefined) {
-        if (isAbsolute) {
-            if (tail.length > 0)
-                return `\\${tail}`;
-            else
-                return "\\";
-        }
-        return tail;
-    }
-    else if (isAbsolute) {
-        if (tail.length > 0)
-            return `${device}\\${tail}`;
-        else
-            return `${device}\\`;
-    }
-    return device + tail;
-}

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

@@ -1,19 +0,0 @@
-import type { GlobOptions } from "../_common/glob_to_reg_exp.js";
-export type { GlobOptions };
-/**
- * Like normalize(), but doesn't collapse "**\/.." when `globstar` is true.
- *
- * @example Usage
- * ```ts
- * import { normalizeGlob } from "normalize_glob.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const normalized = normalizeGlob("**\\foo\\..\\bar", { globstar: true });
- * assertEquals(normalized, "**\\bar");
- * ```
- *
- * @param glob The glob pattern to normalize.
- * @param options The options for glob pattern.
- * @returns The normalized glob pattern.
- */
-export declare function normalizeGlob(glob: string, options?: Pick<GlobOptions, "globstar">): string;

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

@@ -1,32 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { normalize } from "./normalize.js";
-import { SEPARATOR_PATTERN } from "./constants.js";
-/**
- * Like normalize(), but doesn't collapse "**\/.." when `globstar` is true.
- *
- * @example Usage
- * ```ts
- * import { normalizeGlob } from "normalize_glob.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const normalized = normalizeGlob("**\\foo\\..\\bar", { globstar: true });
- * assertEquals(normalized, "**\\bar");
- * ```
- *
- * @param glob The glob pattern to normalize.
- * @param options The options for glob pattern.
- * @returns The normalized glob pattern.
- */
-export function normalizeGlob(glob, options = {}) {
-    const { globstar = false } = options;
-    if (glob.match(/\0/g)) {
-        throw new Error(`Glob contains invalid characters: "${glob}"`);
-    }
-    if (!globstar) {
-        return normalize(glob);
-    }
-    const s = SEPARATOR_PATTERN.source;
-    const badParentPattern = new RegExp(`(?<=(${s}|^)\\*\\*${s})\\.\\.(?=${s}|$)`, "g");
-    return normalize(glob.replace(badParentPattern, "\0")).replace(/\0/g, "..");
-}

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

@@ -1,24 +0,0 @@
-import type { ParsedPath } from "../types.js";
-export type { ParsedPath } from "../types.js";
-/**
- * Return a `ParsedPath` object of the `path`.
- *
- * @example Usage
- * ```ts
- * import { parse } from "parse.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const parsed = parse("C:\\foo\\bar\\baz.ext");
- * assertEquals(parsed, {
- *   root: "C:\\",
- *   dir: "C:\\foo\\bar",
- *   base: "baz.ext",
- *   ext: ".ext",
- *   name: "baz",
- * });
- * ```
- *
- * @param path The path to parse.
- * @returns The `ParsedPath` object.
- */
-export declare function parse(path: string): ParsedPath;