keep-a-changelog 2.2.1 → 2.3.0

package/{types/deps/deno.land/std@0.173.0 → esm/deps/deno.land/std@0.189.0}/path/posix.d.ts

@@ -37,15 +37,17 @@ export declare function relative(from: string, to: string): string;
 export declare function toNamespacedPath(path: string): string;
 /**
  * Return the directory path of a `path`.
- * @param path to determine the directory path for
+ * @param path - path to extract the directory from.
  */
 export declare function dirname(path: string): string;
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract the name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export declare function basename(path: string, ext?: string): string;
+export declare function basename(path: string, suffix?: string): string;
 /**
  * Return the extension of the `path` with leading period.
  * @param path with extension

package/esm/deps/deno.land/{std@0.173.0 → std@0.189.0}/path/posix.js

@@ -3,8 +3,8 @@
 // Ported from https://github.com/browserify/path-browserify/
 // This module is browser compatible.
 import * as dntShim from "../../../../_dnt.shims.js";
-import { CHAR_DOT, CHAR_FORWARD_SLASH } from "./_constants.js";
-import { _format, assertPath, encodeWhitespace, isPosixPathSeparator, normalizeString, } from "./_util.js";
+import { CHAR_DOT } from "./_constants.js";
+import { _format, assertPath, encodeWhitespace, isPosixPathSeparator, lastPathSegment, normalizeString, stripSuffix, stripTrailingSeparators, } from "./_util.js";
 export const sep = "/";
 export const delimiter = ":";
 // path.resolve([from ...], to)
@@ -33,7 +33,7 @@ export function resolve(...pathSegments) {
             continue;
         }
         resolvedPath = `${path}/${resolvedPath}`;
-        resolvedAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+        resolvedAbsolute = isPosixPathSeparator(path.charCodeAt(0));
     }
     // At this point the path should be resolved to a full absolute path, but
     // handle relative paths to be safe (might happen when process.cwd() fails)
@@ -60,8 +60,8 @@ export function normalize(path) {
     assertPath(path);
     if (path.length === 0)
         return ".";
-    const isAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
-    const trailingSeparator = path.charCodeAt(path.length - 1) === CHAR_FORWARD_SLASH;
+    const isAbsolute = isPosixPathSeparator(path.charCodeAt(0));
+    const trailingSeparator = isPosixPathSeparator(path.charCodeAt(path.length - 1));
     // Normalize the path
     path = normalizeString(path, !isAbsolute, "/", isPosixPathSeparator);
     if (path.length === 0 && !isAbsolute)
@@ -78,7 +78,7 @@ export function normalize(path) {
  */
 export function isAbsolute(path) {
     assertPath(path);
-    return path.length > 0 && path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    return path.length > 0 && isPosixPathSeparator(path.charCodeAt(0));
 }
 /**
  * Join all given a sequence of `paths`,then normalizes the resulting path.
@@ -120,7 +120,7 @@ export function relative(from, to) {
     let fromStart = 1;
     const fromEnd = from.length;
     for (; fromStart < fromEnd; ++fromStart) {
-        if (from.charCodeAt(fromStart) !== CHAR_FORWARD_SLASH)
+        if (!isPosixPathSeparator(from.charCodeAt(fromStart)))
             break;
     }
     const fromLen = fromEnd - fromStart;
@@ -128,7 +128,7 @@ export function relative(from, to) {
     let toStart = 1;
     const toEnd = to.length;
     for (; toStart < toEnd; ++toStart) {
-        if (to.charCodeAt(toStart) !== CHAR_FORWARD_SLASH)
+        if (!isPosixPathSeparator(to.charCodeAt(toStart)))
             break;
     }
     const toLen = toEnd - toStart;
@@ -139,7 +139,7 @@ export function relative(from, to) {
     for (; i <= length; ++i) {
         if (i === length) {
             if (toLen > length) {
-                if (to.charCodeAt(toStart + i) === CHAR_FORWARD_SLASH) {
+                if (isPosixPathSeparator(to.charCodeAt(toStart + i))) {
                     // We get here if `from` is the exact base path for `to`.
                     // For example: from='/foo/bar'; to='/foo/bar/baz'
                     return to.slice(toStart + i + 1);
@@ -151,7 +151,7 @@ export function relative(from, to) {
                 }
             }
             else if (fromLen > length) {
-                if (from.charCodeAt(fromStart + i) === CHAR_FORWARD_SLASH) {
+                if (isPosixPathSeparator(from.charCodeAt(fromStart + i))) {
                     // We get here if `to` is the exact base path for `from`.
                     // For example: from='/foo/bar/baz'; to='/foo/bar'
                     lastCommonSep = i;
@@ -168,14 +168,14 @@ export function relative(from, to) {
         const toCode = to.charCodeAt(toStart + i);
         if (fromCode !== toCode)
             break;
-        else if (fromCode === CHAR_FORWARD_SLASH)
+        else if (isPosixPathSeparator(fromCode))
             lastCommonSep = i;
     }
     let out = "";
     // Generate the relative path based on the path difference between `to`
     // and `from`
     for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
-        if (i === fromEnd || from.charCodeAt(i) === CHAR_FORWARD_SLASH) {
+        if (i === fromEnd || isPosixPathSeparator(from.charCodeAt(i))) {
             if (out.length === 0)
                 out += "..";
             else
@@ -188,7 +188,7 @@ export function relative(from, to) {
         return out + to.slice(toStart + lastCommonSep);
     else {
         toStart += lastCommonSep;
-        if (to.charCodeAt(toStart) === CHAR_FORWARD_SLASH)
+        if (isPosixPathSeparator(to.charCodeAt(toStart)))
             ++toStart;
         return to.slice(toStart);
     }
@@ -203,114 +203,53 @@ export function toNamespacedPath(path) {
 }
 /**
  * Return the directory path of a `path`.
- * @param path to determine the directory path for
+ * @param path - path to extract the directory from.
  */
 export function dirname(path) {
-    assertPath(path);
     if (path.length === 0)
         return ".";
-    const hasRoot = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
     let end = -1;
-    let matchedSlash = true;
+    let matchedNonSeparator = false;
     for (let i = path.length - 1; i >= 1; --i) {
-        if (path.charCodeAt(i) === CHAR_FORWARD_SLASH) {
-            if (!matchedSlash) {
+        if (isPosixPathSeparator(path.charCodeAt(i))) {
+            if (matchedNonSeparator) {
                 end = i;
                 break;
             }
         }
         else {
-            // We saw the first non-path separator
-            matchedSlash = false;
+            matchedNonSeparator = true;
         }
     }
-    if (end === -1)
-        return hasRoot ? "/" : ".";
-    if (hasRoot && end === 1)
-        return "//";
-    return path.slice(0, end);
+    // No matches. Fallback based on provided path:
+    //
+    // - leading slashes paths
+    //     "/foo" => "/"
+    //     "///foo" => "/"
+    // - no slash path
+    //     "foo" => "."
+    if (end === -1) {
+        return isPosixPathSeparator(path.charCodeAt(0)) ? "/" : ".";
+    }
+    return stripTrailingSeparators(path.slice(0, end), isPosixPathSeparator);
 }
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract the name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export function basename(path, ext = "") {
-    if (ext !== undefined && typeof ext !== "string") {
-        throw new TypeError('"ext" argument must be a string');
-    }
+export function basename(path, suffix = "") {
     assertPath(path);
-    let start = 0;
-    let end = -1;
-    let matchedSlash = true;
-    let i;
-    if (ext !== undefined && ext.length > 0 && ext.length <= path.length) {
-        if (ext.length === path.length && ext === path)
-            return "";
-        let extIdx = ext.length - 1;
-        let firstNonSlashEnd = -1;
-        for (i = path.length - 1; i >= 0; --i) {
-            const code = path.charCodeAt(i);
-            if (isPosixPathSeparator(code)) {
-                // If we reached a path separator that was not part of a set of path
-                // separators at the end of the string, stop now
-                if (!matchedSlash) {
-                    start = i + 1;
-                    break;
-                }
-            }
-            else {
-                if (firstNonSlashEnd === -1) {
-                    // We saw the first non-path separator, mark this as the end of our
-                    // path component in case we don't match a whole suffix
-                    matchedSlash = false;
-                    firstNonSlashEnd = i + 1;
-                    end = firstNonSlashEnd;
-                }
-                if (extIdx >= 0) {
-                    // Try to match the explicit suffix
-                    if (code === ext.charCodeAt(extIdx)) {
-                        if (--extIdx === -1) {
-                            // We matched whole suffix, so mark this as the end of our path
-                            // component
-                            end = i;
-                        }
-                    }
-                    else {
-                        // Suffix character does not match, so bail out early
-                        // from checking rest of characters
-                        extIdx = -1;
-                    }
-                }
-            }
-        }
-        if (end === -1)
-            return "";
-        if (start === end)
-            end = firstNonSlashEnd;
-        return path.slice(start, end);
-    }
-    else {
-        for (i = path.length - 1; i >= 0; --i) {
-            if (isPosixPathSeparator(path.charCodeAt(i))) {
-                // If we reached a path separator that was not part of a set of path
-                // separators at the end of the string, stop now
-                if (!matchedSlash) {
-                    start = i + 1;
-                    break;
-                }
-            }
-            else if (end === -1) {
-                // We saw the first non-path separator, mark this as the end of our
-                // path component
-                matchedSlash = false;
-                end = i + 1;
-            }
-        }
-        if (end === -1)
-            return "";
-        return path.slice(start, end);
+    if (path.length === 0)
+        return path;
+    if (typeof suffix !== "string") {
+        throw new TypeError(`Suffix must be a string. Received ${JSON.stringify(suffix)}`);
     }
+    const lastSegment = lastPathSegment(path, isPosixPathSeparator);
+    const strippedSegment = stripTrailingSeparators(lastSegment, isPosixPathSeparator);
+    return suffix ? stripSuffix(strippedSegment, suffix) : strippedSegment;
 }
 /**
  * Return the extension of the `path` with leading period.
@@ -328,7 +267,7 @@ export function extname(path) {
     let preDotState = 0;
     for (let i = path.length - 1; i >= 0; --i) {
         const code = path.charCodeAt(i);
-        if (code === CHAR_FORWARD_SLASH) {
+        if (isPosixPathSeparator(code)) {
             // If we reached a path separator that was not part of a set of path
             // separators at the end of the string, stop now
             if (!matchedSlash) {
@@ -385,7 +324,7 @@ export function parse(path) {
     const ret = { root: "", dir: "", base: "", ext: "", name: "" };
     if (path.length === 0)
         return ret;
-    const isAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    const isAbsolute = isPosixPathSeparator(path.charCodeAt(0));
     let start;
     if (isAbsolute) {
         ret.root = "/";
@@ -405,7 +344,7 @@ export function parse(path) {
     // Get non-dir info
     for (; i >= start; --i) {
         const code = path.charCodeAt(i);
-        if (code === CHAR_FORWARD_SLASH) {
+        if (isPosixPathSeparator(code)) {
             // If we reached a path separator that was not part of a set of path
             // separators at the end of the string, stop now
             if (!matchedSlash) {
@@ -447,6 +386,8 @@ export function parse(path) {
                 ret.base = ret.name = path.slice(startPart, end);
             }
         }
+        // Fallback to '/' in case there is no basename
+        ret.base = ret.base || "/";
     }
     else {
         if (startPart === 0 && isAbsolute) {
@@ -459,8 +400,9 @@ export function parse(path) {
         }
         ret.ext = path.slice(startDot, end);
     }
-    if (startPart > 0)
-        ret.dir = path.slice(0, startPart - 1);
+    if (startPart > 0) {
+        ret.dir = stripTrailingSeparators(path.slice(0, startPart - 1), isPosixPathSeparator);
+    }
     else if (isAbsolute)
         ret.dir = "/";
     return ret;

package/{types/deps/deno.land/std@0.173.0 → esm/deps/deno.land/std@0.189.0}/path/win32.d.ts

@@ -38,15 +38,17 @@ export declare function relative(from: string, to: string): string;
 export declare function toNamespacedPath(path: string): string;
 /**
  * Return the directory path of a `path`.
- * @param path to determine the directory path for
+ * @param path - path to extract the directory from.
  */
 export declare function dirname(path: string): string;
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export declare function basename(path: string, ext?: string): string;
+export declare function basename(path: string, suffix?: string): string;
 /**
  * Return the extension of the `path` with leading period.
  * @param path with extension

package/esm/deps/deno.land/{std@0.173.0 → std@0.189.0}/path/win32.js

@@ -4,7 +4,7 @@
 // This module is browser compatible.
 import * as dntShim from "../../../../_dnt.shims.js";
 import { CHAR_BACKWARD_SLASH, CHAR_COLON, CHAR_DOT, CHAR_QUESTION_MARK, } from "./_constants.js";
-import { _format, assertPath, encodeWhitespace, isPathSeparator, isWindowsDeviceRoot, normalizeString, } from "./_util.js";
+import { _format, assertPath, encodeWhitespace, isPathSeparator, isPosixPathSeparator, isWindowsDeviceRoot, lastPathSegment, normalizeString, stripSuffix, stripTrailingSeparators, } from "./_util.js";
 import { assert } from "../_util/asserts.js";
 export const sep = "\\";
 export const delimiter = ";";
@@ -508,7 +508,7 @@ export function toNamespacedPath(path) {
 }
 /**
  * Return the directory path of a `path`.
- * @param path to determine the directory path for
+ * @param path - path to extract the directory from.
  */
 export function dirname(path) {
     assertPath(path);
@@ -598,25 +598,26 @@ export function dirname(path) {
         else
             end = rootEnd;
     }
-    return path.slice(0, end);
+    return stripTrailingSeparators(path.slice(0, end), isPosixPathSeparator);
 }
 /**
- * Return the last portion of a `path`. Trailing directory separators are ignored.
- * @param path to process
- * @param ext of path directory
+ * Return the last portion of a `path`.
+ * Trailing directory separators are ignored, and optional suffix is removed.
+ *
+ * @param path - path to extract name from.
+ * @param [suffix] - suffix to remove from extracted name.
  */
-export function basename(path, ext = "") {
-    if (ext !== undefined && typeof ext !== "string") {
-        throw new TypeError('"ext" argument must be a string');
-    }
+export function basename(path, suffix = "") {
     assertPath(path);
-    let start = 0;
-    let end = -1;
-    let matchedSlash = true;
-    let i;
+    if (path.length === 0)
+        return path;
+    if (typeof suffix !== "string") {
+        throw new TypeError(`Suffix must be a string. Received ${JSON.stringify(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 (isWindowsDeviceRoot(drive)) {
@@ -624,73 +625,9 @@ export function basename(path, ext = "") {
                 start = 2;
         }
     }
-    if (ext !== undefined && ext.length > 0 && ext.length <= path.length) {
-        if (ext.length === path.length && ext === path)
-            return "";
-        let extIdx = ext.length - 1;
-        let firstNonSlashEnd = -1;
-        for (i = path.length - 1; i >= start; --i) {
-            const code = path.charCodeAt(i);
-            if (isPathSeparator(code)) {
-                // If we reached a path separator that was not part of a set of path
-                // separators at the end of the string, stop now
-                if (!matchedSlash) {
-                    start = i + 1;
-                    break;
-                }
-            }
-            else {
-                if (firstNonSlashEnd === -1) {
-                    // We saw the first non-path separator, mark this as the end of our
-                    // path component in case we don't match a whole suffix
-                    matchedSlash = false;
-                    firstNonSlashEnd = i + 1;
-                    end = firstNonSlashEnd;
-                }
-                if (extIdx >= 0) {
-                    // Try to match the explicit suffix
-                    if (code === ext.charCodeAt(extIdx)) {
-                        if (--extIdx === -1) {
-                            // We matched whole suffix, so mark this as the end of our path
-                            // component
-                            end = i;
-                        }
-                    }
-                    else {
-                        // Suffix character does not match, so bail out early
-                        // from checking rest of characters
-                        extIdx = -1;
-                    }
-                }
-            }
-        }
-        if (end === -1)
-            return "";
-        if (start === end)
-            end = firstNonSlashEnd;
-        return path.slice(start, end);
-    }
-    else {
-        for (i = path.length - 1; i >= start; --i) {
-            if (isPathSeparator(path.charCodeAt(i))) {
-                // If we reached a path separator that was not part of a set of path
-                // separators at the end of the string, stop now
-                if (!matchedSlash) {
-                    start = i + 1;
-                    break;
-                }
-            }
-            else if (end === -1) {
-                // We saw the first non-path separator, mark this as the end of our
-                // path component
-                matchedSlash = false;
-                end = i + 1;
-            }
-        }
-        if (end === -1)
-            return "";
-        return path.slice(start, end);
-    }
+    const lastSegment = lastPathSegment(path, isPathSeparator, start);
+    const strippedSegment = stripTrailingSeparators(lastSegment, isPathSeparator);
+    return suffix ? stripSuffix(strippedSegment, suffix) : strippedSegment;
 }
 /**
  * Return the extension of the `path` with leading period.
@@ -829,13 +766,14 @@ export function parse(path) {
                             // `path` contains just a drive root, exit early to avoid
                             // unnecessary work
                             ret.root = ret.dir = path;
+                            ret.base = "\\";
                             return ret;
                         }
                         rootEnd = 3;
                     }
                 }
                 else {
-                    // `path` contains just a drive root, exit early to avoid
+                    // `path` contains just a relative drive root, exit early to avoid
                     // unnecessary work
                     ret.root = ret.dir = path;
                     return ret;
@@ -847,6 +785,7 @@ export function parse(path) {
         // `path` contains just a path separator, exit early to avoid
         // unnecessary work
         ret.root = ret.dir = path;
+        ret.base = "\\";
         return ret;
     }
     if (rootEnd > 0)
@@ -905,6 +844,8 @@ export function parse(path) {
         ret.base = path.slice(startPart, end);
         ret.ext = path.slice(startDot, end);
     }
+    // Fallback to '\' in case there is no basename
+    ret.base = ret.base || "\\";
     // If the directory is the root, use the entire root as the `dir` including
     // the trailing slash if any (`C:\abc` -> `C:\`). Otherwise, strip out the
     // trailing slash (`C:\abc\def` -> `C:\abc`).

package/esm/test/Change.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/test/deps.d.ts

@@ -0,0 +1 @@
+export * from "../deps/deno.land/std@0.133.0/testing/asserts.js";

package/esm/test/fixture/CustomRelease.d.ts

@@ -0,0 +1,8 @@
+import { Change, Release } from "../../mod.js";
+import { Semver } from "../../src/deps.js";
+declare class CustomRelease extends Release {
+    constructor(version?: Semver | string, date?: Date | string, description?: string);
+    maintenance(change: string | Change): this;
+}
+export default function (version?: Semver | string, date?: Date | string, description?: string): CustomRelease;
+export {};

package/esm/test/parser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/test/test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,12 +1,11 @@
 {
   "module": "./esm/mod.js",
   "main": "./script/mod.js",
-  "types": "./types/mod.d.ts",
   "bin": {
     "changelog": "./esm/bin.js"
   },
   "name": "keep-a-changelog",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Node package to parse and generate changelogs following the [keepachangelog](http://keepachangelog.com/en/1.0.0/) format.",
   "homepage": "https://github.com/oscarotero/keep-a-changelog#readme",
   "license": "MIT",
@@ -25,24 +24,18 @@
   },
   "exports": {
     ".": {
-      "import": {
-        "types": "./types/mod.d.ts",
-        "default": "./esm/mod.js"
-      },
-      "require": {
-        "types": "./types/mod.d.ts",
-        "default": "./script/mod.js"
-      }
+      "import": "./esm/mod.js",
+      "require": "./script/mod.js"
     }
   },
   "scripts": {
     "test": "node test_runner.js"
   },
   "dependencies": {
-    "@deno/shim-deno": "~0.12.0"
+    "@deno/shim-deno": "~0.16.1"
   },
   "devDependencies": {
     "@types/node": "^18.11.9",
-    "chalk": "^4.1.2"
+    "picocolors": "^1.0.0"
   }
 }

package/script/_dnt.polyfills.d.ts

@@ -0,0 +1,11 @@
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};

package/script/_dnt.shims.d.ts

@@ -0,0 +1,5 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};

package/script/_dnt.test_shims.d.ts

@@ -0,0 +1,5 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};

package/script/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "./_dnt.polyfills.js";

package/script/bin.js

@@ -26,20 +26,21 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 require("./_dnt.polyfills.js");
 const dntShim = __importStar(require("./_dnt.shims.js"));
-const mod_js_1 = require("./deps/deno.land/std@0.173.0/path/mod.js");
+const mod_js_1 = require("./deps/deno.land/std@0.189.0/path/mod.js");
 const mod_js_2 = require("./mod.js");
-const mod_js_3 = require("./deps/deno.land/std@0.173.0/flags/mod.js");
+const mod_js_3 = require("./deps/deno.land/std@0.189.0/flags/mod.js");
 const mod_js_4 = require("./deps/deno.land/x/ini@v2.1.0/mod.js");
 const argv = (0, mod_js_3.parse)(dntShim.Deno.args, {
     default: {
         file: "CHANGELOG.md",
         format: "compact",
         release: null,
+        create: null,
         url: null,
         https: true,
         quiet: false,
     },
-    string: ["file", "format", "release", "url"],
+    string: ["file", "format", "url"],
     boolean: ["https", "init", "latest-release", "quiet"],
 });
 const file = (0, mod_js_1.join)(dntShim.Deno.cwd(), argv.file);
@@ -80,6 +81,10 @@ try {
             dntShim.Deno.exit(1);
         }
     }
+    if (argv.create) {
+        const version = typeof argv.create === "string" ? argv.create : undefined;
+        changelog.addRelease(new mod_js_2.Release(version));
+    }
     if (!changelog.url) {
         if (argv.url) {
             changelog.url = argv.url;