keep-a-changelog 2.5.2 → 2.6.0

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

@@ -0,0 +1,31 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toFileUrl = void 0;
+const to_file_url_js_1 = require("../_common/to_file_url.js");
+const is_absolute_js_1 = require("./is_absolute.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";
+ *
+ * assertEquals(toFileUrl("/home/foo"), new URL("file:///home/foo"));
+ * assertEquals(toFileUrl("/home/foo bar"), new URL("file:///home/foo%20bar"));
+ * ```
+ *
+ * @param path The path to convert.
+ * @returns The file URL.
+ */
+function toFileUrl(path) {
+    if (!(0, is_absolute_js_1.isAbsolute)(path)) {
+        throw new TypeError(`Path must be absolute: received "${path}"`);
+    }
+    const url = new URL("file:///");
+    url.pathname = (0, to_file_url_js_1.encodeWhitespace)(path.replace(/%/g, "%25").replace(/\\/g, "%5C"));
+    return url;
+}
+exports.toFileUrl = toFileUrl;

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

@@ -0,0 +1,15 @@
+/**
+ * Converts a path to a namespaced path. This function returns the path as is on posix.
+ *
+ * @example Usage
+ * ```ts
+ * import { toNamespacedPath } from "to_namespaced_path.ts";
+ * import { assertEquals } from "../../assert/mod.ts";
+ *
+ * assertEquals(toNamespacedPath("/home/foo"), "/home/foo");
+ * ```
+ *
+ * @param path The path.
+ * @returns The namespaced path.
+ */
+export declare function toNamespacedPath(path: string): string;

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

@@ -0,0 +1,24 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNamespacedPath = void 0;
+/**
+ * Converts a path to a namespaced path. This function returns the path as is on posix.
+ *
+ * @example Usage
+ * ```ts
+ * import { toNamespacedPath } from "to_namespaced_path.ts";
+ * import { assertEquals } from "../../assert/mod.ts";
+ *
+ * assertEquals(toNamespacedPath("/home/foo"), "/home/foo");
+ * ```
+ *
+ * @param path The path.
+ * @returns The namespaced path.
+ */
+function toNamespacedPath(path) {
+    // Non-op on posix systems
+    return path;
+}
+exports.toNamespacedPath = toNamespacedPath;

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

@@ -0,0 +1,23 @@
+/**
+ * Return the relative path from `from` to `to` based on current working
+ * directory.
+ *
+ * @example Usage
+ * ```ts
+ * import { relative } from "relative.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   const path = relative("C:\\foobar\\test\\aaa", "C:\\foobar\\impl\\bbb");
+ *   assertEquals(path, "..\\..\\impl\\bbb");
+ * } else {
+ *   const path = relative("/data/foobar/test/aaa", "/data/foobar/impl/bbb");
+ *   assertEquals(path, "../../impl/bbb");
+ * }
+ * ```
+ *
+ * @param from Path in current working directory.
+ * @param to Path in current working directory.
+ * @returns The relative path from `from` to `to`.
+ */
+export declare function relative(from: string, to: string): string;

package/script/std/path/relative.js

@@ -0,0 +1,34 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relative = void 0;
+const _os_js_1 = require("./_os.js");
+const relative_js_1 = require("./posix/relative.js");
+const relative_js_2 = require("./windows/relative.js");
+/**
+ * Return the relative path from `from` to `to` based on current working
+ * directory.
+ *
+ * @example Usage
+ * ```ts
+ * import { relative } from "relative.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   const path = relative("C:\\foobar\\test\\aaa", "C:\\foobar\\impl\\bbb");
+ *   assertEquals(path, "..\\..\\impl\\bbb");
+ * } else {
+ *   const path = relative("/data/foobar/test/aaa", "/data/foobar/impl/bbb");
+ *   assertEquals(path, "../../impl/bbb");
+ * }
+ * ```
+ *
+ * @param from Path in current working directory.
+ * @param to Path in current working directory.
+ * @returns The relative path from `from` to `to`.
+ */
+function relative(from, to) {
+    return _os_js_1.isWindows ? (0, relative_js_2.relative)(from, to) : (0, relative_js_1.relative)(from, to);
+}
+exports.relative = relative;

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

@@ -0,0 +1,21 @@
+/**
+ * Resolves path segments into a path.
+ *
+ * @example Usage
+ * ```ts
+ * import { resolve } from "resolve.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(resolve("C:\\foo", "bar", "baz"), "C:\\foo\\bar\\baz");
+ *   assertEquals(resolve("C:\\foo", "C:\\bar", "baz"), "C:\\bar\\baz");
+ * } else {
+ *   assertEquals(resolve("/foo", "bar", "baz"), "/foo/bar/baz");
+ *   assertEquals(resolve("/foo", "/bar", "baz"), "/bar/baz");
+ * }
+ * ```
+ *
+ * @param pathSegments Path segments to process to path.
+ * @returns The resolved path.
+ */
+export declare function resolve(...pathSegments: string[]): string;

package/script/std/path/resolve.js

@@ -0,0 +1,34 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolve = void 0;
+const _os_js_1 = require("./_os.js");
+const resolve_js_1 = require("./posix/resolve.js");
+const resolve_js_2 = require("./windows/resolve.js");
+/**
+ * Resolves path segments into a path.
+ *
+ * @example Usage
+ * ```ts
+ * import { resolve } from "resolve.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * if (Deno.build.os === "windows") {
+ *   assertEquals(resolve("C:\\foo", "bar", "baz"), "C:\\foo\\bar\\baz");
+ *   assertEquals(resolve("C:\\foo", "C:\\bar", "baz"), "C:\\bar\\baz");
+ * } else {
+ *   assertEquals(resolve("/foo", "bar", "baz"), "/foo/bar/baz");
+ *   assertEquals(resolve("/foo", "/bar", "baz"), "/bar/baz");
+ * }
+ * ```
+ *
+ * @param pathSegments Path segments to process to path.
+ * @returns The resolved path.
+ */
+function resolve(...pathSegments) {
+    return _os_js_1.isWindows
+        ? (0, resolve_js_2.resolve)(...pathSegments)
+        : (0, resolve_js_1.resolve)(...pathSegments);
+}
+exports.resolve = resolve;

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

@@ -0,0 +1,22 @@
+/// <reference types="node" />
+/**
+ * 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 declare function toFileUrl(path: string): URL;

package/script/std/path/to_file_url.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.toFileUrl = void 0;
+const _os_js_1 = require("./_os.js");
+const to_file_url_js_1 = require("./posix/to_file_url.js");
+const to_file_url_js_2 = require("./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.
+ */
+function toFileUrl(path) {
+    return _os_js_1.isWindows ? (0, to_file_url_js_2.toFileUrl)(path) : (0, to_file_url_js_1.toFileUrl)(path);
+}
+exports.toFileUrl = toFileUrl;

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

@@ -0,0 +1,20 @@
+/**
+ * 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/script/std/path/to_namespaced_path.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.toNamespacedPath = void 0;
+const _os_js_1 = require("./_os.js");
+const to_namespaced_path_js_1 = require("./posix/to_namespaced_path.js");
+const to_namespaced_path_js_2 = require("./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.
+ */
+function toNamespacedPath(path) {
+    return _os_js_1.isWindows
+        ? (0, to_namespaced_path_js_2.toNamespacedPath)(path)
+        : (0, to_namespaced_path_js_1.toNamespacedPath)(path);
+}
+exports.toNamespacedPath = toNamespacedPath;

package/script/{deps/deno.land/std@0.189.0/path/_interface.d.ts → std/path/types.d.ts}

@@ -1,5 +1,17 @@
 /**
  * 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 {
     /**
@@ -7,7 +19,7 @@ export interface ParsedPath {
      */
     root: string;
     /**
-     * The full directory path such as '/home/user/dir' or 'c:\path\dir'
+     * The full directory path of the parent such as '/home/user/dir' or 'c:\path\dir'
      */
     dir: string;
     /**
@@ -23,4 +35,3 @@ export interface ParsedPath {
      */
     name: string;
 }
-export type FormatInputPathObject = Partial<ParsedPath>;

package/script/{deps/deno.land/std@0.189.0/path/_interface.js → std/path/types.js}

@@ -1,4 +1,4 @@
 "use strict";
-// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+// Copyright 2018-2025 the Deno authors. MIT license.
 // This module is browser compatible.
 Object.defineProperty(exports, "__esModule", { value: true });

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

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

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

@@ -0,0 +1,21 @@
+"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.isWindowsDeviceRoot = exports.isPathSeparator = 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;
+function isPathSeparator(code) {
+    return code === constants_js_1.CHAR_FORWARD_SLASH || code === constants_js_1.CHAR_BACKWARD_SLASH;
+}
+exports.isPathSeparator = isPathSeparator;
+function isWindowsDeviceRoot(code) {
+    return ((code >= constants_js_1.CHAR_LOWERCASE_A && code <= constants_js_1.CHAR_LOWERCASE_Z) ||
+        (code >= constants_js_1.CHAR_UPPERCASE_A && code <= constants_js_1.CHAR_UPPERCASE_Z));
+}
+exports.isWindowsDeviceRoot = isWindowsDeviceRoot;

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

@@ -0,0 +1,22 @@
+/**
+ * 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/script/std/path/windows/basename.js

@@ -0,0 +1,48 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.basename = void 0;
+const basename_js_1 = require("../_common/basename.js");
+const constants_js_1 = require("../_common/constants.js");
+const strip_trailing_separators_js_1 = require("../_common/strip_trailing_separators.js");
+const _util_js_1 = require("./_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.
+ */
+function basename(path, suffix = "") {
+    (0, basename_js_1.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 ((0, _util_js_1.isWindowsDeviceRoot)(drive)) {
+            if (path.charCodeAt(1) === constants_js_1.CHAR_COLON)
+                start = 2;
+        }
+    }
+    const lastSegment = (0, basename_js_1.lastPathSegment)(path, _util_js_1.isPathSeparator, start);
+    const strippedSegment = (0, strip_trailing_separators_js_1.stripTrailingSeparators)(lastSegment, _util_js_1.isPathSeparator);
+    return suffix ? (0, basename_js_1.stripSuffix)(strippedSegment, suffix) : strippedSegment;
+}
+exports.basename = basename;

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

@@ -0,0 +1,12 @@
+/**
+ * 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/script/std/path/windows/constants.js

@@ -0,0 +1,17 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEPARATOR_PATTERN = exports.SEPARATOR = exports.DELIMITER = void 0;
+/**
+ * The character used to separate entries in the PATH environment variable.
+ */
+exports.DELIMITER = ";";
+/**
+ * The character used to separate components of a file path.
+ */
+exports.SEPARATOR = "\\";
+/**
+ * A regular expression that matches one or more path separators.
+ */
+exports.SEPARATOR_PATTERN = /[\\/]+/;

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

@@ -0,0 +1,19 @@
+/**
+ * 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/script/std/path/windows/dirname.js

@@ -0,0 +1,116 @@
+"use strict";
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dirname = void 0;
+const dirname_js_1 = require("../_common/dirname.js");
+const constants_js_1 = require("../_common/constants.js");
+const strip_trailing_separators_js_1 = require("../_common/strip_trailing_separators.js");
+const _util_js_1 = require("./_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.
+ */
+function dirname(path) {
+    (0, dirname_js_1.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 ((0, _util_js_1.isPathSeparator)(code)) {
+            // Possible UNC root
+            rootEnd = offset = 1;
+            if ((0, _util_js_1.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 ((0, _util_js_1.isPathSeparator)(path.charCodeAt(j)))
+                        break;
+                }
+                if (j < len && j !== last) {
+                    // Matched!
+                    last = j;
+                    // Match 1 or more path separators
+                    for (; j < len; ++j) {
+                        if (!(0, _util_js_1.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 ((0, _util_js_1.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 ((0, _util_js_1.isWindowsDeviceRoot)(code)) {
+            // Possible device root
+            if (path.charCodeAt(1) === constants_js_1.CHAR_COLON) {
+                rootEnd = offset = 2;
+                if (len > 2) {
+                    if ((0, _util_js_1.isPathSeparator)(path.charCodeAt(2)))
+                        rootEnd = offset = 3;
+                }
+            }
+        }
+    }
+    else if ((0, _util_js_1.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 ((0, _util_js_1.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 (0, strip_trailing_separators_js_1.stripTrailingSeparators)(path.slice(0, end), _util_js_1.isPosixPathSeparator);
+}
+exports.dirname = dirname;

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

@@ -0,0 +1,19 @@
+/**
+ * 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;