keep-a-changelog 2.5.2 → 2.6.0

package/script/std/path/is_absolute.js

@@ -0,0 +1,32 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAbsolute = void 0;
+const _os_js_1 = require("./_os.js");
+const is_absolute_js_1 = require("./posix/is_absolute.js");
+const is_absolute_js_2 = require("./windows/is_absolute.js");
+/**
+ * Verifies whether provided path is absolute.
+ *
+ * @example Usage
+ * ```ts
+ * import { isAbsolute } from "is_absolute.ts";
+ * import { assert, assertFalse } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assert(isAbsolute("C:\\home\\foo"));
+ *   assertFalse(isAbsolute("home\\foo"));
+ * } else {
+ *   assert(isAbsolute("/home/foo"));
+ *   assertFalse(isAbsolute("home/foo"));
+ * }
+ * ```
+ *
+ * @param path Path to be verified as absolute.
+ * @returns `true` if path is absolute, `false` otherwise
+ */
+function isAbsolute(path) {
+    return _os_js_1.isWindows ? (0, is_absolute_js_2.isAbsolute)(path) : (0, is_absolute_js_1.isAbsolute)(path);
+}
+exports.isAbsolute = isAbsolute;

package/script/std/path/is_glob.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test whether the given string is a glob.
+ *
+ * @example Usage
+ * ```ts
+ * import { isGlob } from "is_glob.ts";
+ * import { assert } from "../assert/mod.ts";
+ *
+ * assert(!isGlob("foo/bar/../baz"));
+ * assert(isGlob("foo/*ar/../baz"));
+ * ```
+ *
+ * @param str String to test.
+ * @returns `true` if the given string is a glob, otherwise `false`
+ */
+export declare function isGlob(str: string): boolean;

package/script/std/path/is_glob.js

@@ -0,0 +1,46 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGlob = void 0;
+/**
+ * Test whether the given string is a glob.
+ *
+ * @example Usage
+ * ```ts
+ * import { isGlob } from "is_glob.ts";
+ * import { assert } from "../assert/mod.ts";
+ *
+ * assert(!isGlob("foo/bar/../baz"));
+ * assert(isGlob("foo/*ar/../baz"));
+ * ```
+ *
+ * @param str String to test.
+ * @returns `true` if the given string is a glob, otherwise `false`
+ */
+function isGlob(str) {
+    const chars = { "{": "}", "(": ")", "[": "]" };
+    const regex = /\\(.)|(^!|\*|\?|[\].+)]\?|\[[^\\\]]+\]|\{[^\\}]+\}|\(\?[:!=][^\\)]+\)|\([^|]+\|[^\\)]+\))/;
+    if (str === "") {
+        return false;
+    }
+    let match;
+    while ((match = regex.exec(str))) {
+        if (match[2])
+            return true;
+        let idx = match.index + match[0].length;
+        // if an open bracket/brace/paren is escaped,
+        // set the index to the next closing character
+        const open = match[1];
+        const close = open ? chars[open] : null;
+        if (open && close) {
+            const n = str.indexOf(close, idx);
+            if (n !== -1) {
+                idx = n + 1;
+            }
+        }
+        str = str.slice(idx);
+    }
+    return false;
+}
+exports.isGlob = isGlob;

package/script/std/path/join.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Joins a sequence of paths, then normalizes the resulting path.
+ *
+ * @example Usage
+ * ```ts
+ * import { join } from "join.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(join("C:\\foo", "bar", "baz\\quux", "garply", ".."), "C:\\foo\\bar\\baz\\quux");
+ * } else {
+ *   assertEquals(join("/foo", "bar", "baz/quux", "garply", ".."), "/foo/bar/baz/quux");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `join` from `@std/path/unstable-join`.
+ *
+ * @param paths Paths to be joined and normalized.
+ * @returns The joined and normalized path.
+ */
+export declare function join(...paths: string[]): string;

package/script/std/path/join.js

@@ -0,0 +1,33 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.join = void 0;
+const _os_js_1 = require("./_os.js");
+const join_js_1 = require("./posix/join.js");
+const join_js_2 = require("./windows/join.js");
+/**
+ * Joins a sequence of paths, then normalizes the resulting path.
+ *
+ * @example Usage
+ * ```ts
+ * import { join } from "join.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(join("C:\\foo", "bar", "baz\\quux", "garply", ".."), "C:\\foo\\bar\\baz\\quux");
+ * } else {
+ *   assertEquals(join("/foo", "bar", "baz/quux", "garply", ".."), "/foo/bar/baz/quux");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `join` from `@std/path/unstable-join`.
+ *
+ * @param paths Paths to be joined and normalized.
+ * @returns The joined and normalized path.
+ */
+function join(...paths) {
+    return _os_js_1.isWindows ? (0, join_js_2.join)(...paths) : (0, join_js_1.join)(...paths);
+}
+exports.join = join;

package/script/std/path/join_globs.d.ts

@@ -0,0 +1,27 @@
+import type { GlobOptions } from "./_common/glob_to_reg_exp.js";
+export type { GlobOptions };
+/**
+ * Joins a sequence of globs, then normalizes the resulting glob.
+ *
+ * Behaves like {@linkcode https://jsr.io/@std/path/doc/~/join | join()}, but
+ * doesn't collapse `**\/..` when `globstar` is true.
+ *
+ * @example Usage
+ * ```ts
+ * import { joinGlobs } from "join_globs.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(joinGlobs(["foo", "bar", "..", "baz"]), "foo\\baz");
+ *   assertEquals(joinGlobs(["foo", "**", "bar", "..", "baz"], { globstar: true }), "foo\\**\\baz");
+ * } else {
+ *   assertEquals(joinGlobs(["foo", "bar", "..", "baz"]), "foo/baz");
+ *   assertEquals(joinGlobs(["foo", "**", "bar", "..", "baz"], { globstar: true }), "foo/**\/baz");
+ * }
+ * ```
+ *
+ * @param globs Globs to be joined and normalized.
+ * @param options Glob options.
+ * @returns The joined and normalized glob string.
+ */
+export declare function joinGlobs(globs: string[], options?: GlobOptions): string;

package/script/std/path/join_globs.js

@@ -0,0 +1,38 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinGlobs = void 0;
+const _os_js_1 = require("./_os.js");
+const join_globs_js_1 = require("./posix/join_globs.js");
+const join_globs_js_2 = require("./windows/join_globs.js");
+/**
+ * Joins a sequence of globs, then normalizes the resulting glob.
+ *
+ * Behaves like {@linkcode https://jsr.io/@std/path/doc/~/join | join()}, but
+ * doesn't collapse `**\/..` when `globstar` is true.
+ *
+ * @example Usage
+ * ```ts
+ * import { joinGlobs } from "join_globs.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(joinGlobs(["foo", "bar", "..", "baz"]), "foo\\baz");
+ *   assertEquals(joinGlobs(["foo", "**", "bar", "..", "baz"], { globstar: true }), "foo\\**\\baz");
+ * } else {
+ *   assertEquals(joinGlobs(["foo", "bar", "..", "baz"]), "foo/baz");
+ *   assertEquals(joinGlobs(["foo", "**", "bar", "..", "baz"], { globstar: true }), "foo/**\/baz");
+ * }
+ * ```
+ *
+ * @param globs Globs to be joined and normalized.
+ * @param options Glob options.
+ * @returns The joined and normalized glob string.
+ */
+function joinGlobs(globs, options = {}) {
+    return _os_js_1.isWindows
+        ? (0, join_globs_js_2.joinGlobs)(globs, options)
+        : (0, join_globs_js_1.joinGlobs)(globs, options);
+}
+exports.joinGlobs = joinGlobs;

package/script/std/path/mod.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Utilities for working with OS-specific file paths.
+ *
+ * Functions from this module will automatically switch to support the path style
+ * of the current OS, either `windows` for Microsoft Windows, or `posix` for
+ * every other operating system, eg. Linux, MacOS, BSD etc.
+ *
+ * To use functions for a specific path style regardless of the current OS
+ * import the modules from the platform sub directory instead.
+ *
+ * Example, for POSIX:
+ *
+ * ```ts
+ * import { fromFileUrl } from "posix/from_file_url.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * assertEquals(fromFileUrl("file:///home/foo"), "/home/foo");
+ * ```
+ *
+ * Or, for Windows:
+ *
+ * ```ts
+ * import { fromFileUrl } from "windows/from_file_url.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * assertEquals(fromFileUrl("file:///home/foo"), "\\home\\foo");
+ * ```
+ *
+ * Functions for working with URLs can be found in
+ * {@link ./doc/posix/~ | @std/path/posix}.
+ *
+ * @module
+ */
+export * from "./basename.js";
+export * from "./constants.js";
+export * from "./dirname.js";
+export * from "./extname.js";
+export * from "./format.js";
+export * from "./from_file_url.js";
+export * from "./is_absolute.js";
+export * from "./join.js";
+export * from "./normalize.js";
+export * from "./parse.js";
+export * from "./relative.js";
+export * from "./resolve.js";
+export * from "./to_file_url.js";
+export * from "./to_namespaced_path.js";
+export * from "./common.js";
+export * from "./types.js";
+export * from "./glob_to_regexp.js";
+export * from "./is_glob.js";
+export * from "./join_globs.js";
+export * from "./normalize_glob.js";

package/script/std/path/mod.js

@@ -0,0 +1,73 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+// Ported mostly from https://github.com/browserify/path-browserify/
+// This module is browser compatible.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Utilities for working with OS-specific file paths.
+ *
+ * Functions from this module will automatically switch to support the path style
+ * of the current OS, either `windows` for Microsoft Windows, or `posix` for
+ * every other operating system, eg. Linux, MacOS, BSD etc.
+ *
+ * To use functions for a specific path style regardless of the current OS
+ * import the modules from the platform sub directory instead.
+ *
+ * Example, for POSIX:
+ *
+ * ```ts
+ * import { fromFileUrl } from "posix/from_file_url.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * assertEquals(fromFileUrl("file:///home/foo"), "/home/foo");
+ * ```
+ *
+ * Or, for Windows:
+ *
+ * ```ts
+ * import { fromFileUrl } from "windows/from_file_url.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * assertEquals(fromFileUrl("file:///home/foo"), "\\home\\foo");
+ * ```
+ *
+ * Functions for working with URLs can be found in
+ * {@link ./doc/posix/~ | @std/path/posix}.
+ *
+ * @module
+ */
+__exportStar(require("./basename.js"), exports);
+__exportStar(require("./constants.js"), exports);
+__exportStar(require("./dirname.js"), exports);
+__exportStar(require("./extname.js"), exports);
+__exportStar(require("./format.js"), exports);
+__exportStar(require("./from_file_url.js"), exports);
+__exportStar(require("./is_absolute.js"), exports);
+__exportStar(require("./join.js"), exports);
+__exportStar(require("./normalize.js"), exports);
+__exportStar(require("./parse.js"), exports);
+__exportStar(require("./relative.js"), exports);
+__exportStar(require("./resolve.js"), exports);
+__exportStar(require("./to_file_url.js"), exports);
+__exportStar(require("./to_namespaced_path.js"), exports);
+__exportStar(require("./common.js"), exports);
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./glob_to_regexp.js"), exports);
+__exportStar(require("./is_glob.js"), exports);
+__exportStar(require("./join_globs.js"), exports);
+__exportStar(require("./normalize_glob.js"), exports);

package/script/std/path/normalize.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Normalize the path, resolving `'..'` and `'.'` segments.
+ *
+ * Note: 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";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
+ * } else {
+ *   assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `normalize` from `@std/path/unstable-normalize`.
+ *
+ * @param path Path to be normalized
+ * @returns The normalized path.
+ */
+export declare function normalize(path: string): string;

package/script/std/path/normalize.js

@@ -0,0 +1,37 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalize = void 0;
+const _os_js_1 = require("./_os.js");
+const normalize_js_1 = require("./posix/normalize.js");
+const normalize_js_2 = require("./windows/normalize.js");
+/**
+ * Normalize the path, resolving `'..'` and `'.'` segments.
+ *
+ * Note: 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";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(normalize("C:\\foo\\bar\\..\\baz\\quux"), "C:\\foo\\baz\\quux");
+ * } else {
+ *   assertEquals(normalize("/foo/bar/../baz/quux"), "/foo/baz/quux");
+ * }
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `normalize` from `@std/path/unstable-normalize`.
+ *
+ * @param path Path to be normalized
+ * @returns The normalized path.
+ */
+function normalize(path) {
+    return _os_js_1.isWindows ? (0, normalize_js_2.normalize)(path) : (0, normalize_js_1.normalize)(path);
+}
+exports.normalize = normalize;

package/script/std/path/normalize_glob.d.ts

@@ -0,0 +1,28 @@
+import type { GlobOptions } from "./_common/glob_to_reg_exp.js";
+export type { GlobOptions };
+/**
+ * Normalizes a glob string.
+ *
+ * Behaves like
+ * {@linkcode https://jsr.io/@std/path/doc/~/normalize | normalize()}, but
+ * doesn't collapse "**\/.." when `globstar` is true.
+ *
+ * @example Usage
+ * ```ts
+ * import { normalizeGlob } from "normalize_glob.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(normalizeGlob("foo\\bar\\..\\baz"), "foo\\baz");
+ *   assertEquals(normalizeGlob("foo\\**\\..\\bar\\..\\baz", { globstar: true }), "foo\\**\\..\\baz");
+ * } else {
+ *   assertEquals(normalizeGlob("foo/bar/../baz"), "foo/baz");
+ *   assertEquals(normalizeGlob("foo/**\/../bar/../baz", { globstar: true }), "foo/**\/../baz");
+ * }
+ * ```
+ *
+ * @param glob Glob string to normalize.
+ * @param options Glob options.
+ * @returns The normalized glob string.
+ */
+export declare function normalizeGlob(glob: string, options?: GlobOptions): string;

package/script/std/path/normalize_glob.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeGlob = void 0;
+const _os_js_1 = require("./_os.js");
+const normalize_glob_js_1 = require("./posix/normalize_glob.js");
+const normalize_glob_js_2 = require("./windows/normalize_glob.js");
+/**
+ * Normalizes a glob string.
+ *
+ * Behaves like
+ * {@linkcode https://jsr.io/@std/path/doc/~/normalize | normalize()}, but
+ * doesn't collapse "**\/.." when `globstar` is true.
+ *
+ * @example Usage
+ * ```ts
+ * import { normalizeGlob } from "normalize_glob.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(normalizeGlob("foo\\bar\\..\\baz"), "foo\\baz");
+ *   assertEquals(normalizeGlob("foo\\**\\..\\bar\\..\\baz", { globstar: true }), "foo\\**\\..\\baz");
+ * } else {
+ *   assertEquals(normalizeGlob("foo/bar/../baz"), "foo/baz");
+ *   assertEquals(normalizeGlob("foo/**\/../bar/../baz", { globstar: true }), "foo/**\/../baz");
+ * }
+ * ```
+ *
+ * @param glob Glob string to normalize.
+ * @param options Glob options.
+ * @returns The normalized glob string.
+ */
+function normalizeGlob(glob, options = {}) {
+    return _os_js_1.isWindows
+        ? (0, normalize_glob_js_2.normalizeGlob)(glob, options)
+        : (0, normalize_glob_js_1.normalizeGlob)(glob, options);
+}
+exports.normalizeGlob = normalizeGlob;

package/script/std/path/parse.d.ts

@@ -0,0 +1,34 @@
+import type { ParsedPath } from "./types.js";
+export type { ParsedPath } from "./types.js";
+/**
+ * Return an object containing the parsed components of the path.
+ *
+ * Use {@linkcode https://jsr.io/@std/path/doc/~/format | format()} to reverse
+ * the result.
+ *
+ * @example Usage
+ * ```ts
+ * import { parse } from "parse.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   const parsedPathObj = parse("C:\\path\\to\\script.ts");
+ *   assertEquals(parsedPathObj.root, "C:\\");
+ *   assertEquals(parsedPathObj.dir, "C:\\path\\to");
+ *   assertEquals(parsedPathObj.base, "script.ts");
+ *   assertEquals(parsedPathObj.ext, ".ts");
+ *   assertEquals(parsedPathObj.name, "script");
+ * } else {
+ *   const parsedPathObj = parse("/path/to/dir/script.ts");
+ *   parsedPathObj.root; // "/"
+ *   parsedPathObj.dir; // "/path/to/dir"
+ *   parsedPathObj.base; // "script.ts"
+ *   parsedPathObj.ext; // ".ts"
+ *   parsedPathObj.name; // "script"
+ * }
+ * ```
+ *
+ * @param path Path to process
+ * @returns An object with the parsed path components.
+ */
+export declare function parse(path: string): ParsedPath;

package/script/std/path/parse.js

@@ -0,0 +1,43 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse = void 0;
+const _os_js_1 = require("./_os.js");
+const parse_js_1 = require("./posix/parse.js");
+const parse_js_2 = require("./windows/parse.js");
+/**
+ * Return an object containing the parsed components of the path.
+ *
+ * Use {@linkcode https://jsr.io/@std/path/doc/~/format | format()} to reverse
+ * the result.
+ *
+ * @example Usage
+ * ```ts
+ * import { parse } from "parse.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   const parsedPathObj = parse("C:\\path\\to\\script.ts");
+ *   assertEquals(parsedPathObj.root, "C:\\");
+ *   assertEquals(parsedPathObj.dir, "C:\\path\\to");
+ *   assertEquals(parsedPathObj.base, "script.ts");
+ *   assertEquals(parsedPathObj.ext, ".ts");
+ *   assertEquals(parsedPathObj.name, "script");
+ * } else {
+ *   const parsedPathObj = parse("/path/to/dir/script.ts");
+ *   parsedPathObj.root; // "/"
+ *   parsedPathObj.dir; // "/path/to/dir"
+ *   parsedPathObj.base; // "script.ts"
+ *   parsedPathObj.ext; // ".ts"
+ *   parsedPathObj.name; // "script"
+ * }
+ * ```
+ *
+ * @param path Path to process
+ * @returns An object with the parsed path components.
+ */
+function parse(path) {
+    return _os_js_1.isWindows ? (0, parse_js_2.parse)(path) : (0, parse_js_1.parse)(path);
+}
+exports.parse = parse;

package/script/std/path/posix/_util.d.ts

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

package/script/std/path/posix/_util.js

@@ -0,0 +1,12 @@
+"use strict";
+// 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.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPosixPathSeparator = void 0;
+const constants_js_1 = require("../_common/constants.js");
+function isPosixPathSeparator(code) {
+    return code === constants_js_1.CHAR_FORWARD_SLASH;
+}
+exports.isPosixPathSeparator = isPosixPathSeparator;

package/script/std/path/posix/basename.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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("/home/user/Documents/"), "Documents");
+ * assertEquals(basename("/home/user/Documents/image.png"), "image.png");
+ * assertEquals(basename("/home/user/Documents/image.png", ".png"), "image");
+ * ```
+ *
+ * @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 { basename } from "basename.ts";
+ * import { assertEquals } from "../../assert/mod.ts";
+ *
+ * assertEquals(basename("https://deno.land/std/path/mod.ts"), "mod.ts");
+ * assertEquals(basename("https://deno.land/std/path/mod.ts", ".ts"), "mod");
+ * assertEquals(basename("https://deno.land/std/path/mod.ts?a=b"), "mod.ts?a=b");
+ * assertEquals(basename("https://deno.land/std/path/mod.ts#header"), "mod.ts#header");
+ * ```
+ *
+ * Note: If you are working with file URLs,
+ * use the new version of `basename` from `@std/path/posix/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;