keep-a-changelog 2.5.3 → 2.6.0

package/esm/std/ini/stringify.js

@@ -0,0 +1,66 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { IniMap } from "./_ini_map.js";
+/**
+ * Compile an object into an INI config string. Provide formatting options to modify the output.
+ *
+ * @example Usage
+ * ```ts
+ * import { stringify } from "stringify.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * const str = stringify({
+ *   key1: "value1",
+ *   key2: "value2",
+ *   section1: {
+ *     foo: "bar",
+ *   },
+ *   section2: {
+ *     hello: "world",
+ *   },
+ * });
+ *
+ * assertEquals(str, `key1=value1
+ * key2=value2
+ * [section1]
+ * foo=bar
+ * [section2]
+ * hello=world`);
+ * ```
+ *
+ * @example Using replacer option
+ * ```ts
+ * import { stringify } from "stringify.ts";
+ * import { assertEquals } from "../assert/mod.ts";
+ *
+ * const str = stringify({
+ *   "section X": {
+ *     date: new Date("2024-06-10"),
+ *   },
+ *   "section Y": {
+ *     name: "John"
+ *   }
+ * }, {
+ *   replacer(key, value, section) {
+ *     if (section === "section X" && key === "date") {
+ *       return value.toISOString().slice(0, 10);
+ *     }
+ *     return value;
+ *   },
+ * });
+ *
+ * assertEquals(str, `[section X]
+ * date=2024-06-10
+ * [section Y]
+ * name=John`);
+ * ```
+ *
+ * @param object The object to stringify
+ * @param options The option to use
+ * @returns The INI string
+ */
+export function stringify(
+// deno-lint-ignore no-explicit-any
+object, options) {
+    return IniMap.from(object, options).toString(options?.replacer);
+}

package/esm/std/path/_common/assert_path.d.ts

@@ -0,0 +1 @@
+export declare function assertPath(path?: string): void;

package/esm/std/path/_common/assert_path.js

@@ -0,0 +1,7 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// Copyright the Browserify authors. MIT License.
+export function assertPath(path) {
+    if (typeof path !== "string") {
+        throw new TypeError(`Path must be a string, received "${JSON.stringify(path)}"`);
+    }
+}

package/esm/std/path/_common/basename.d.ts

@@ -0,0 +1,3 @@
+export declare function stripSuffix(name: string, suffix: string): string;
+export declare function lastPathSegment(path: string, isSep: (char: number) => boolean, start?: number): string;
+export declare function assertArgs(path: string, suffix: string): string | undefined;

package/esm/std/path/_common/basename.js

@@ -0,0 +1,40 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { assertPath } from "./assert_path.js";
+export function stripSuffix(name, suffix) {
+    if (suffix.length >= name.length) {
+        return name;
+    }
+    const lenDiff = name.length - suffix.length;
+    for (let i = suffix.length - 1; i >= 0; --i) {
+        if (name.charCodeAt(lenDiff + i) !== suffix.charCodeAt(i)) {
+            return name;
+        }
+    }
+    return name.slice(0, -suffix.length);
+}
+export function lastPathSegment(path, isSep, start = 0) {
+    let matchedNonSeparator = false;
+    let end = path.length;
+    for (let i = path.length - 1; i >= start; --i) {
+        if (isSep(path.charCodeAt(i))) {
+            if (matchedNonSeparator) {
+                start = i + 1;
+                break;
+            }
+        }
+        else if (!matchedNonSeparator) {
+            matchedNonSeparator = true;
+            end = i + 1;
+        }
+    }
+    return path.slice(start, end);
+}
+export function assertArgs(path, suffix) {
+    assertPath(path);
+    if (path.length === 0)
+        return path;
+    if (typeof suffix !== "string") {
+        throw new TypeError(`Suffix must be a string, received "${JSON.stringify(suffix)}"`);
+    }
+}

package/esm/std/path/_common/common.d.ts

@@ -0,0 +1 @@
+export declare function common(paths: string[], sep: string): string;

package/esm/std/path/_common/common.js

@@ -0,0 +1,23 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+export function common(paths, sep) {
+    const [first = "", ...remaining] = paths;
+    const parts = first.split(sep);
+    let endOfPrefix = parts.length;
+    let append = "";
+    for (const path of remaining) {
+        const compare = path.split(sep);
+        if (compare.length <= endOfPrefix) {
+            endOfPrefix = compare.length;
+            append = "";
+        }
+        for (let i = 0; i < endOfPrefix; i++) {
+            if (compare[i] !== parts[i]) {
+                endOfPrefix = i;
+                append = i === 0 ? "" : sep;
+                break;
+            }
+        }
+    }
+    return parts.slice(0, endOfPrefix).join(sep) + append;
+}

package/esm/{deps/deno.land/std@0.189.0/path/_constants.js → std/path/_common/constants.js}

@@ -1,4 +1,4 @@
-// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+// 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.

package/esm/std/path/_common/dirname.d.ts

@@ -0,0 +1 @@
+export declare function assertArg(path: string): "." | undefined;

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

@@ -0,0 +1,8 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { assertPath } from "./assert_path.js";
+export function assertArg(path) {
+    assertPath(path);
+    if (path.length === 0)
+        return ".";
+}

package/esm/std/path/_common/format.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPath } from "../types.js";
+export declare function _format(sep: string, pathObject: Partial<ParsedPath>): string;
+export declare function assertArg(pathObject: Partial<ParsedPath>): void;

package/esm/std/path/_common/format.js

@@ -0,0 +1,19 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+export function _format(sep, pathObject) {
+    const dir = pathObject.dir || pathObject.root;
+    const base = pathObject.base ||
+        (pathObject.name ?? "") + (pathObject.ext ?? "");
+    if (!dir)
+        return base;
+    if (base === sep)
+        return dir;
+    if (dir === pathObject.root)
+        return dir + base;
+    return dir + sep + base;
+}
+export function assertArg(pathObject) {
+    if (pathObject === null || typeof pathObject !== "object") {
+        throw new TypeError(`The "pathObject" argument must be of type Object, received type "${typeof pathObject}"`);
+    }
+}

package/esm/std/path/_common/from_file_url.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="node" />
+export declare function assertArg(url: URL | string): URL;

package/esm/std/path/_common/from_file_url.js

@@ -0,0 +1,9 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+export function assertArg(url) {
+    url = url instanceof URL ? url : new URL(url);
+    if (url.protocol !== "file:") {
+        throw new TypeError(`URL must be a file URL: received "${url.protocol}"`);
+    }
+    return url;
+}

package/esm/std/path/_common/glob_to_reg_exp.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Options for {@linkcode globToRegExp}, {@linkcode joinGlobs},
+ * {@linkcode normalizeGlob} and {@linkcode expandGlob}.
+ */
+export interface GlobOptions {
+    /** Extended glob syntax.
+     * See https://www.linuxjournal.com/content/bash-extended-globbing.
+     *
+     * @default {true}
+     */
+    extended?: boolean;
+    /** Globstar syntax.
+     * See https://www.linuxjournal.com/content/globstar-new-bash-globbing-option.
+     * If false, `**` is treated like `*`.
+     *
+     * @default {true}
+     */
+    globstar?: boolean;
+    /**
+     * Whether globstar should be case-insensitive.
+     *
+     * @default {false}
+     */
+    caseInsensitive?: boolean;
+}
+export interface GlobConstants {
+    sep: string;
+    sepMaybe: string;
+    seps: string[];
+    globstar: string;
+    wildcard: string;
+    escapePrefix: string;
+}
+export declare function _globToRegExp(c: GlobConstants, glob: string, { extended, globstar: globstarOption, caseInsensitive, }?: GlobOptions): RegExp;

package/esm/std/path/_common/glob_to_reg_exp.js

@@ -0,0 +1,234 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+const REG_EXP_ESCAPE_CHARS = [
+    "!",
+    "$",
+    "(",
+    ")",
+    "*",
+    "+",
+    ".",
+    "=",
+    "?",
+    "[",
+    "\\",
+    "^",
+    "{",
+    "|",
+];
+const RANGE_ESCAPE_CHARS = ["-", "\\", "]"];
+export function _globToRegExp(c, glob, { extended = true, globstar: globstarOption = true, 
+// os = osType,
+caseInsensitive = false, } = {}) {
+    if (glob === "") {
+        return /(?!)/;
+    }
+    // Remove trailing separators.
+    let newLength = glob.length;
+    for (; newLength > 1 && c.seps.includes(glob[newLength - 1]); newLength--)
+        ;
+    glob = glob.slice(0, newLength);
+    let regExpString = "";
+    // Terminates correctly. Trust that `j` is incremented every iteration.
+    for (let j = 0; j < glob.length;) {
+        let segment = "";
+        const groupStack = [];
+        let inRange = false;
+        let inEscape = false;
+        let endsWithSep = false;
+        let i = j;
+        // Terminates with `i` at the non-inclusive end of the current segment.
+        for (; i < glob.length && !c.seps.includes(glob[i]); i++) {
+            if (inEscape) {
+                inEscape = false;
+                const escapeChars = (inRange
+                    ? RANGE_ESCAPE_CHARS
+                    : REG_EXP_ESCAPE_CHARS);
+                segment += escapeChars.includes(glob[i])
+                    ? `\\${glob[i]}`
+                    : glob[i];
+                continue;
+            }
+            if (glob[i] === c.escapePrefix) {
+                inEscape = true;
+                continue;
+            }
+            if (glob[i] === "[") {
+                if (!inRange) {
+                    inRange = true;
+                    segment += "[";
+                    if (glob[i + 1] === "!") {
+                        i++;
+                        segment += "^";
+                    }
+                    else if (glob[i + 1] === "^") {
+                        i++;
+                        segment += "\\^";
+                    }
+                    continue;
+                }
+                else if (glob[i + 1] === ":") {
+                    let k = i + 1;
+                    let value = "";
+                    while (glob[k + 1] !== undefined && glob[k + 1] !== ":") {
+                        value += glob[k + 1];
+                        k++;
+                    }
+                    if (glob[k + 1] === ":" && glob[k + 2] === "]") {
+                        i = k + 2;
+                        if (value === "alnum")
+                            segment += "\\dA-Za-z";
+                        else if (value === "alpha")
+                            segment += "A-Za-z";
+                        else if (value === "ascii")
+                            segment += "\x00-\x7F";
+                        else if (value === "blank")
+                            segment += "\t ";
+                        else if (value === "cntrl")
+                            segment += "\x00-\x1F\x7F";
+                        else if (value === "digit")
+                            segment += "\\d";
+                        else if (value === "graph")
+                            segment += "\x21-\x7E";
+                        else if (value === "lower")
+                            segment += "a-z";
+                        else if (value === "print")
+                            segment += "\x20-\x7E";
+                        else if (value === "punct") {
+                            segment += "!\"#$%&'()*+,\\-./:;<=>?@[\\\\\\]^_‘{|}~";
+                        }
+                        else if (value === "space")
+                            segment += "\\s\v";
+                        else if (value === "upper")
+                            segment += "A-Z";
+                        else if (value === "word")
+                            segment += "\\w";
+                        else if (value === "xdigit")
+                            segment += "\\dA-Fa-f";
+                        continue;
+                    }
+                }
+            }
+            if (glob[i] === "]" && inRange) {
+                inRange = false;
+                segment += "]";
+                continue;
+            }
+            if (inRange) {
+                segment += glob[i];
+                continue;
+            }
+            if (glob[i] === ")" && groupStack.length > 0 &&
+                groupStack[groupStack.length - 1] !== "BRACE") {
+                segment += ")";
+                const type = groupStack.pop();
+                if (type === "!") {
+                    segment += c.wildcard;
+                }
+                else if (type !== "@") {
+                    segment += type;
+                }
+                continue;
+            }
+            if (glob[i] === "|" && groupStack.length > 0 &&
+                groupStack[groupStack.length - 1] !== "BRACE") {
+                segment += "|";
+                continue;
+            }
+            if (glob[i] === "+" && extended && glob[i + 1] === "(") {
+                i++;
+                groupStack.push("+");
+                segment += "(?:";
+                continue;
+            }
+            if (glob[i] === "@" && extended && glob[i + 1] === "(") {
+                i++;
+                groupStack.push("@");
+                segment += "(?:";
+                continue;
+            }
+            if (glob[i] === "?") {
+                if (extended && glob[i + 1] === "(") {
+                    i++;
+                    groupStack.push("?");
+                    segment += "(?:";
+                }
+                else {
+                    segment += ".";
+                }
+                continue;
+            }
+            if (glob[i] === "!" && extended && glob[i + 1] === "(") {
+                i++;
+                groupStack.push("!");
+                segment += "(?!";
+                continue;
+            }
+            if (glob[i] === "{") {
+                groupStack.push("BRACE");
+                segment += "(?:";
+                continue;
+            }
+            if (glob[i] === "}" && groupStack[groupStack.length - 1] === "BRACE") {
+                groupStack.pop();
+                segment += ")";
+                continue;
+            }
+            if (glob[i] === "," && groupStack[groupStack.length - 1] === "BRACE") {
+                segment += "|";
+                continue;
+            }
+            if (glob[i] === "*") {
+                if (extended && glob[i + 1] === "(") {
+                    i++;
+                    groupStack.push("*");
+                    segment += "(?:";
+                }
+                else {
+                    const prevChar = glob[i - 1];
+                    let numStars = 1;
+                    while (glob[i + 1] === "*") {
+                        i++;
+                        numStars++;
+                    }
+                    const nextChar = glob[i + 1];
+                    if (globstarOption && numStars === 2 &&
+                        [...c.seps, undefined].includes(prevChar) &&
+                        [...c.seps, undefined].includes(nextChar)) {
+                        segment += c.globstar;
+                        endsWithSep = true;
+                    }
+                    else {
+                        segment += c.wildcard;
+                    }
+                }
+                continue;
+            }
+            segment += REG_EXP_ESCAPE_CHARS.includes(glob[i])
+                ? `\\${glob[i]}`
+                : glob[i];
+        }
+        // Check for unclosed groups or a dangling backslash.
+        if (groupStack.length > 0 || inRange || inEscape) {
+            // Parse failure. Take all characters from this segment literally.
+            segment = "";
+            for (const c of glob.slice(j, i)) {
+                segment += REG_EXP_ESCAPE_CHARS.includes(c)
+                    ? `\\${c}`
+                    : c;
+                endsWithSep = false;
+            }
+        }
+        regExpString += segment;
+        if (!endsWithSep) {
+            regExpString += i < glob.length ? c.sep : c.sepMaybe;
+            endsWithSep = true;
+        }
+        // Terminates with `i` at the start of the next segment.
+        while (c.seps.includes(glob[i]))
+            i++;
+        j = i;
+    }
+    regExpString = `^${regExpString}$`;
+    return new RegExp(regExpString, caseInsensitive ? "i" : "");
+}

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

@@ -0,0 +1 @@
+export declare function assertArg(path: string): "." | undefined;

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

@@ -0,0 +1,8 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { assertPath } from "./assert_path.js";
+export function assertArg(path) {
+    assertPath(path);
+    if (path.length === 0)
+        return ".";
+}

package/esm/std/path/_common/normalize_string.d.ts

@@ -0,0 +1 @@
+export declare function normalizeString(path: string, allowAboveRoot: boolean, separator: string, isPathSeparator: (code: number) => boolean): string;

package/esm/std/path/_common/normalize_string.js

@@ -0,0 +1,77 @@
+// 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.
+import { CHAR_DOT, CHAR_FORWARD_SLASH } from "./constants.js";
+// Resolves . and .. elements in a path with directory names
+export function normalizeString(path, allowAboveRoot, separator, isPathSeparator) {
+    let res = "";
+    let lastSegmentLength = 0;
+    let lastSlash = -1;
+    let dots = 0;
+    let code;
+    for (let i = 0; i <= path.length; ++i) {
+        if (i < path.length)
+            code = path.charCodeAt(i);
+        else if (isPathSeparator(code))
+            break;
+        else
+            code = CHAR_FORWARD_SLASH;
+        if (isPathSeparator(code)) {
+            if (lastSlash === i - 1 || dots === 1) {
+                // NOOP
+            }
+            else if (lastSlash !== i - 1 && dots === 2) {
+                if (res.length < 2 ||
+                    lastSegmentLength !== 2 ||
+                    res.charCodeAt(res.length - 1) !== CHAR_DOT ||
+                    res.charCodeAt(res.length - 2) !== CHAR_DOT) {
+                    if (res.length > 2) {
+                        const lastSlashIndex = res.lastIndexOf(separator);
+                        if (lastSlashIndex === -1) {
+                            res = "";
+                            lastSegmentLength = 0;
+                        }
+                        else {
+                            res = res.slice(0, lastSlashIndex);
+                            lastSegmentLength = res.length - 1 - res.lastIndexOf(separator);
+                        }
+                        lastSlash = i;
+                        dots = 0;
+                        continue;
+                    }
+                    else if (res.length === 2 || res.length === 1) {
+                        res = "";
+                        lastSegmentLength = 0;
+                        lastSlash = i;
+                        dots = 0;
+                        continue;
+                    }
+                }
+                if (allowAboveRoot) {
+                    if (res.length > 0)
+                        res += `${separator}..`;
+                    else
+                        res = "..";
+                    lastSegmentLength = 2;
+                }
+            }
+            else {
+                if (res.length > 0)
+                    res += separator + path.slice(lastSlash + 1, i);
+                else
+                    res = path.slice(lastSlash + 1, i);
+                lastSegmentLength = i - lastSlash - 1;
+            }
+            lastSlash = i;
+            dots = 0;
+        }
+        else if (code === CHAR_DOT && dots !== -1) {
+            ++dots;
+        }
+        else {
+            dots = -1;
+        }
+    }
+    return res;
+}

package/esm/std/path/_common/relative.d.ts

@@ -0,0 +1 @@
+export declare function assertArgs(from: string, to: string): "" | undefined;

package/esm/std/path/_common/relative.js

@@ -0,0 +1,9 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+import { assertPath } from "./assert_path.js";
+export function assertArgs(from, to) {
+    assertPath(from);
+    assertPath(to);
+    if (from === to)
+        return "";
+}

package/esm/std/path/_common/strip_trailing_separators.d.ts

@@ -0,0 +1 @@
+export declare function stripTrailingSeparators(segment: string, isSep: (char: number) => boolean): string;

package/esm/std/path/_common/strip_trailing_separators.js

@@ -0,0 +1,19 @@
+// 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.
+export function stripTrailingSeparators(segment, isSep) {
+    if (segment.length <= 1) {
+        return segment;
+    }
+    let end = segment.length;
+    for (let i = segment.length - 1; i > 0; i--) {
+        if (isSep(segment.charCodeAt(i))) {
+            end = i;
+        }
+        else {
+            break;
+        }
+    }
+    return segment.slice(0, end);
+}

package/esm/std/path/_common/to_file_url.d.ts

@@ -0,0 +1 @@
+export declare function encodeWhitespace(string: string): string;

package/esm/std/path/_common/to_file_url.js

@@ -0,0 +1,15 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+const WHITESPACE_ENCODINGS = {
+    "\u0009": "%09",
+    "\u000A": "%0A",
+    "\u000B": "%0B",
+    "\u000C": "%0C",
+    "\u000D": "%0D",
+    "\u0020": "%20",
+};
+export function encodeWhitespace(string) {
+    return string.replaceAll(/[\s]/g, (c) => {
+        return WHITESPACE_ENCODINGS[c] ?? c;
+    });
+}

package/esm/std/path/_os.d.ts

@@ -0,0 +1 @@
+export declare const isWindows: boolean;

package/esm/std/path/_os.js

@@ -0,0 +1,9 @@
+// deno-lint-ignore-file no-explicit-any
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+// Check Deno, then the remaining runtimes (e.g. Node, Bun and the browser)
+import * as dntShim from "../../_dnt.shims.js";
+export const isWindows = dntShim.dntGlobalThis.Deno?.build.os === "windows" ||
+    dntShim.dntGlobalThis.navigator?.platform?.startsWith("Win") ||
+    dntShim.dntGlobalThis.process?.platform?.startsWith("win") ||
+    false;