keep-a-changelog 2.6.0 → 2.6.2

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

@@ -1,62 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertArg } from "../_common/dirname.js";
-import { stripTrailingSeparators } from "../_common/strip_trailing_separators.js";
-import { isPosixPathSeparator } from "./_util.js";
-/**
- * Return the directory path of a `path`.
- *
- * @example Usage
- * ```ts
- * import { dirname } from "dirname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(dirname("/home/user/Documents/"), "/home/user");
- * assertEquals(dirname("/home/user/Documents/image.png"), "/home/user/Documents");
- * assertEquals(dirname("https://deno.land/std/path/mod.ts"), "https://deno.land/std/path");
- * ```
- *
- * @example Working with URLs
- *
- * ```ts
- * import { dirname } from "dirname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(dirname("https://deno.land/std/path/mod.ts"), "https://deno.land/std/path");
- * assertEquals(dirname("https://deno.land/std/path/mod.ts?a=b"), "https://deno.land/std/path");
- * assertEquals(dirname("https://deno.land/std/path/mod.ts#header"), "https://deno.land/std/path");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `dirname` from `@std/path/posix/unstable-dirname`.
- *
- * @param path The path to get the directory from.
- * @returns The directory path.
- */
-export function dirname(path) {
-    assertArg(path);
-    let end = -1;
-    let matchedNonSeparator = false;
-    for (let i = path.length - 1; i >= 1; --i) {
-        if (isPosixPathSeparator(path.charCodeAt(i))) {
-            if (matchedNonSeparator) {
-                end = i;
-                break;
-            }
-        }
-        else {
-            matchedNonSeparator = true;
-        }
-    }
-    // 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);
-}

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

@@ -1,36 +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";
- *
- * assertEquals(extname("/home/user/Documents/file.ts"), ".ts");
- * assertEquals(extname("/home/user/Documents/"), "");
- * assertEquals(extname("/home/user/Documents/image.png"), ".png");
- * ```
- *
- * @example Working with URLs
- *
- * Note: This function doesn't automatically strip hash and query parts from
- * URLs. If your URL contains a hash or query, remove them before passing the
- * URL to the function. This can be done by passing the URL to `new URL(url)`,
- * and setting the `hash` and `search` properties to empty strings.
- *
- * ```ts
- * import { extname } from "extname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(extname("https://deno.land/std/path/mod.ts"), ".ts");
- * assertEquals(extname("https://deno.land/std/path/mod.ts?a=b"), ".ts?a=b");
- * assertEquals(extname("https://deno.land/std/path/mod.ts#header"), ".ts#header");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `extname` from `@std/path/posix/unstable-extname`.
- *
- * @param path The path to get the extension from.
- * @returns The extension (ex. for `file.ts` returns `.ts`).
- */
-export declare function extname(path: string): string;

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

@@ -1,89 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { CHAR_DOT } from "../_common/constants.js";
-import { assertPath } from "../_common/assert_path.js";
-import { isPosixPathSeparator } 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";
- *
- * assertEquals(extname("/home/user/Documents/file.ts"), ".ts");
- * assertEquals(extname("/home/user/Documents/"), "");
- * assertEquals(extname("/home/user/Documents/image.png"), ".png");
- * ```
- *
- * @example Working with URLs
- *
- * Note: This function doesn't automatically strip hash and query parts from
- * URLs. If your URL contains a hash or query, remove them before passing the
- * URL to the function. This can be done by passing the URL to `new URL(url)`,
- * and setting the `hash` and `search` properties to empty strings.
- *
- * ```ts
- * import { extname } from "extname.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * assertEquals(extname("https://deno.land/std/path/mod.ts"), ".ts");
- * assertEquals(extname("https://deno.land/std/path/mod.ts?a=b"), ".ts?a=b");
- * assertEquals(extname("https://deno.land/std/path/mod.ts#header"), ".ts#header");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `extname` from `@std/path/posix/unstable-extname`.
- *
- * @param path The path to get the extension from.
- * @returns The extension (ex. for `file.ts` returns `.ts`).
- */
-export function extname(path) {
-    assertPath(path);
-    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;
-    for (let i = path.length - 1; i >= 0; --i) {
-        const code = path.charCodeAt(i);
-        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) {
-                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/posix/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: "/",
- *   dir: "/path/dir",
- *   base: "file.txt",
- *   ext: ".txt",
- *   name: "file"
- * });
- * assertEquals(path, "/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/posix/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: "/",
- *   dir: "/path/dir",
- *   base: "file.txt",
- *   ext: ".txt",
- *   name: "file"
- * });
- * assertEquals(path, "/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/posix/from_file_url.d.ts

@@ -1,16 +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(new URL("file:///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/posix/from_file_url.js

@@ -1,21 +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(new URL("file:///home/foo")), "/home/foo");
- * ```
- *
- * @param url The file URL to convert.
- * @returns The path string.
- */
-export function fromFileUrl(url) {
-    url = assertArg(url);
-    return decodeURIComponent(url.pathname.replace(/%(?![0-9A-Fa-f]{2})/g, "%25"));
-}

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

@@ -1,71 +0,0 @@
-import { type GlobOptions } from "../_common/glob_to_reg_exp.js";
-export type { GlobOptions };
-/** 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;

package/esm/std/path/posix/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/posix/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("/home/user/Documents/"));
- * assertFalse(isAbsolute("home/user/Documents/"));
- * ```
- *
- * @param path The path to verify.
- * @returns Whether the path is absolute.
- */
-export declare function isAbsolute(path: string): boolean;

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

@@ -1,23 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertPath } from "../_common/assert_path.js";
-import { isPosixPathSeparator } 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("/home/user/Documents/"));
- * assertFalse(isAbsolute("home/user/Documents/"));
- * ```
- *
- * @param path The path to verify.
- * @returns Whether the path is absolute.
- */
-export function isAbsolute(path) {
-    assertPath(path);
-    return path.length > 0 && isPosixPathSeparator(path.charCodeAt(0));
-}

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

@@ -1,32 +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 path = join("/foo", "bar", "baz/asdf", "quux", "..");
- * assertEquals(path, "/foo/bar/baz/asdf");
- * ```
- *
- * @example Working with URLs
- * ```ts
- * import { join } from "join.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const url = new URL("https://deno.land");
- * url.pathname = join("std", "path", "mod.ts");
- * assertEquals(url.href, "https://deno.land/std/path/mod.ts");
- *
- * url.pathname = join("//std", "path/", "/mod.ts");
- * assertEquals(url.href, "https://deno.land/std/path/mod.ts");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `join` from `@std/path/posix/unstable-join`.
- *
- * @param paths The paths to join.
- * @returns The joined path.
- */
-export declare function join(...paths: string[]): string;

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

@@ -1,42 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { assertPath } from "../_common/assert_path.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 path = join("/foo", "bar", "baz/asdf", "quux", "..");
- * assertEquals(path, "/foo/bar/baz/asdf");
- * ```
- *
- * @example Working with URLs
- * ```ts
- * import { join } from "join.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const url = new URL("https://deno.land");
- * url.pathname = join("std", "path", "mod.ts");
- * assertEquals(url.href, "https://deno.land/std/path/mod.ts");
- *
- * url.pathname = join("//std", "path/", "/mod.ts");
- * assertEquals(url.href, "https://deno.land/std/path/mod.ts");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `join` from `@std/path/posix/unstable-join`.
- *
- * @param paths The paths to join.
- * @returns The joined path.
- */
-export function join(...paths) {
-    if (paths.length === 0)
-        return ".";
-    paths.forEach((path) => assertPath(path));
-    const joined = paths.filter((path) => path.length > 0).join("/");
-    return joined === "" ? "." : normalize(joined);
-}

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

@@ -1,19 +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 path = joinGlobs(["foo", "bar", "**"], { globstar: true });
- * assertEquals(path, "foo/bar/**");
- * ```
- *
- * @param globs The globs to join.
- * @param options The options to use.
- * @returns The joined path.
- */
-export declare function joinGlobs(globs: string[], options?: Pick<GlobOptions, "globstar">): string;

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

@@ -1,40 +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 path = joinGlobs(["foo", "bar", "**"], { globstar: true });
- * assertEquals(path, "foo/bar/**");
- * ```
- *
- * @param globs The globs to join.
- * @param options The options to use.
- * @returns The joined path.
- */
-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/posix/normalize.d.ts

@@ -1,39 +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 path = normalize("/foo/bar//baz/asdf/quux/..");
- * assertEquals(path, "/foo/bar/baz/asdf");
- * ```
- *
- * @example Working with URLs
- *
- * Note: This function will remove the double slashes from a URL's scheme.
- * Hence, do not pass a full URL to this function. Instead, pass the pathname of
- * the URL.
- *
- * ```ts
- * import { normalize } from "normalize.ts";
- * import { assertEquals } from "../../assert/mod.ts";
- *
- * const url = new URL("https://deno.land");
- * url.pathname = normalize("//std//assert//.//mod.ts");
- * assertEquals(url.href, "https://deno.land/std/assert/mod.ts");
- *
- * url.pathname = normalize("std/assert/../async/retry.ts");
- * assertEquals(url.href, "https://deno.land/std/async/retry.ts");
- * ```
- *
- * Note: If you are working with file URLs,
- * use the new version of `normalize` from `@std/path/posix/unstable-normalize`.
- *
- * @param path The path to normalize.
- * @returns The normalized path.
- */
-export declare function normalize(path: string): string;