keep-a-changelog 2.6.0 → 2.6.2

package/script/std/path/glob_to_regexp.js

@@ -1,87 +0,0 @@
-"use strict";
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.globToRegExp = void 0;
-const _os_js_1 = require("./_os.js");
-const glob_to_regexp_js_1 = require("./posix/glob_to_regexp.js");
-const glob_to_regexp_js_2 = require("./windows/glob_to_regexp.js");
-/**
- * Converts 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";
- *
- * if (Deno.build.os === "windows") {
- *   assertEquals(globToRegExp("*.js"), /^[^\\/]*\.js(?:\\|\/)*$/);
- * } else {
- *   assertEquals(globToRegExp("*.js"), /^[^/]*\.js\/*$/);
- * }
- * ```
- *
- * @param glob Glob string to convert.
- * @param options Conversion options.
- * @returns The regular expression equivalent to the glob.
- */
-function globToRegExp(glob, options = {}) {
-    return _os_js_1.isWindows
-        ? (0, glob_to_regexp_js_2.globToRegExp)(glob, options)
-        : (0, glob_to_regexp_js_1.globToRegExp)(glob, options);
-}
-exports.globToRegExp = globToRegExp;

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

@@ -1,21 +0,0 @@
-/**
- * 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
- */
-export declare function isAbsolute(path: string): boolean;

package/script/std/path/is_absolute.js

@@ -1,32 +0,0 @@
-"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

@@ -1,16 +0,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`
- */
-export declare function isGlob(str: string): boolean;

package/script/std/path/is_glob.js

@@ -1,46 +0,0 @@
-"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

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

@@ -1,33 +0,0 @@
-"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

@@ -1,27 +0,0 @@
-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

@@ -1,38 +0,0 @@
-"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

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

@@ -1,73 +0,0 @@
-"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

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

@@ -1,37 +0,0 @@
-"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

@@ -1,28 +0,0 @@
-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

@@ -1,39 +0,0 @@
-"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

@@ -1,34 +0,0 @@
-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

@@ -1,43 +0,0 @@
-"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;