keep-a-changelog 2.6.0 → 2.6.2

package/esm/std/semver/try_parse_range.js

@@ -1,33 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-import { parseRange } from "./parse_range.js";
-/**
- * Parses the given range string and returns a Range object. If the range string
- * is invalid, `undefined` is returned.
- *
- * @example Usage
- * ```ts
- * import { tryParseRange } from "mod.ts";
- * import { assertEquals } from "../assert/mod.ts";
- *
- * assertEquals(tryParseRange(">=1.2.3 <1.2.4"), [
- *  [
- *    { operator: ">=", major: 1, minor: 2, patch: 3, prerelease: [], build: [] },
- *    { operator: "<", major: 1, minor: 2, patch: 4, prerelease: [], build: [] },
- *  ],
- * ]);
- * ```
- *
- * @param value The range string
- * @returns A Range object if valid otherwise `undefined`
- */
-export function tryParseRange(value) {
-    try {
-        // Return '*' instead of '' so that truthiness works.
-        // This will throw if it's invalid anyway
-        return parseRange(value);
-    }
-    catch {
-        return undefined;
-    }
-}

package/esm/std/semver/types.d.ts

@@ -1,57 +0,0 @@
-/**
- * The possible release types are used as an operator for the
- * increment function and as a result of the difference function.
- */
-export type ReleaseType = "pre" | "major" | "premajor" | "minor" | "preminor" | "patch" | "prepatch" | "prerelease";
-/**
- * SemVer comparison operators.
- */
-export type Operator = undefined | "=" | "!=" | ">" | ">=" | "<" | "<=";
-/**
- * The shape of a valid SemVer comparator.
- *
- * @example Usage
- * ```ts
- * import type { Comparator } from "types.ts";
- *
- * const comparator: Comparator = {
- *   operator: ">",
- *   major: 1,
- *   minor: 2,
- *   patch: 3,
- * }
- * ```
- */
-export interface Comparator extends SemVer {
-    /** The operator */
-    operator?: Operator;
-}
-/**
- * A SemVer object parsed into its constituent parts.
- */
-export interface SemVer {
-    /** The major version */
-    major: number;
-    /** The minor version */
-    minor: number;
-    /** The patch version */
-    patch: number;
-    /**
-     * The prerelease version
-     *
-     * @default {[]}
-     */
-    prerelease?: (string | number)[];
-    /**
-     * The build metadata
-     *
-     * @default {[]}
-     */
-    build?: string[];
-}
-/**
- * A type representing a semantic version range. The ranges consist of
- * a nested array, which represents a set of OR comparisons while the
- * inner array represents AND comparisons.
- */
-export type Range = Comparator[][];

package/esm/std/semver/types.js

@@ -1,3 +0,0 @@
-// Copyright 2018-2025 the Deno authors. MIT license.
-// This module is browser compatible.
-export {};

package/script/keep-a-changelog/bin.d.ts

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

package/script/keep-a-changelog/bin.js

@@ -1,229 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-require("../_dnt.polyfills.js");
-const dntShim = __importStar(require("../_dnt.shims.js"));
-const mod_js_1 = require("../std/path/mod.js");
-const mod_js_2 = require("./mod.js");
-const parse_args_js_1 = require("../std/cli/parse_args.js");
-const mod_js_3 = require("../std/ini/mod.js");
-const settings_js_1 = __importDefault(require("./src/settings.js"));
-const argv = (0, parse_args_js_1.parseArgs)(dntShim.Deno.args, {
-    default: {
-        file: "CHANGELOG.md",
-        format: "compact",
-        release: null,
-        create: null,
-        url: null,
-        https: true,
-        quiet: false,
-        head: null,
-        combine: false,
-        "bullet-style": "-",
-    },
-    string: ["file", "format", "url", "head", "bullet-style"],
-    boolean: [
-        "https",
-        "init",
-        "latest-release",
-        "quiet",
-        "help",
-        "combine",
-        "no-v-prefix",
-        "no-sort-releases",
-    ],
-    alias: {
-        h: "help",
-    },
-});
-const file = (0, mod_js_1.join)(dntShim.Deno.cwd(), argv.file);
-try {
-    if (argv.help) {
-        showHelp();
-        dntShim.Deno.exit(0);
-    }
-    if (argv.init) {
-        const changelog = new mod_js_2.Changelog("Changelog").addRelease(new mod_js_2.Release("0.1.0", new Date(), "First version"));
-        changelog.format = argv.format;
-        changelog.bulletStyle = argv["bullet-style"];
-        save(file, changelog, true);
-        dntShim.Deno.exit(0);
-    }
-    const changelog = (0, mod_js_2.parser)(dntShim.Deno.readTextFileSync(file), {
-        autoSortReleases: !argv["no-sort-releases"],
-    });
-    changelog.format = argv.format;
-    changelog.bulletStyle = argv["bullet-style"];
-    if (argv["no-v-prefix"]) {
-        changelog.tagNameBuilder = (release) => String(release.version);
-    }
-    if (argv["latest-release"]) {
-        const release = changelog.releases.find((release) => release.date && release.version);
-        if (release) {
-            console.log(release.version?.toString());
-        }
-        dntShim.Deno.exit(0);
-    }
-    if (argv.release) {
-        const release = changelog.releases.find((release) => {
-            if (release.date) {
-                return false;
-            }
-            if (typeof argv.release === "string") {
-                return !release.version || argv.release === release.version.toString();
-            }
-            return !!release.version;
-        });
-        if (release) {
-            release.date = new Date();
-            if (typeof argv.release === "string") {
-                release.setVersion(argv.release);
-            }
-        }
-        else {
-            console.error("Not found any valid unreleased version");
-            dntShim.Deno.exit(1);
-        }
-    }
-    if (argv.combine) {
-        const combinedReleases = changelog.releases.reduce((acc, release) => {
-            if (release.version) {
-                if (acc[release.version]) {
-                    acc[release.version].combineChanges(release.changes);
-                }
-                else {
-                    acc[release.version] = release;
-                }
-            }
-            return acc;
-        }, {});
-        changelog.releases = Object.values(combinedReleases);
-    }
-    if (argv.create) {
-        const version = typeof argv.create === "string" ? argv.create : undefined;
-        const release = changelog.releases.find((release) => {
-            return release.version === version;
-        });
-        if (release) {
-            console.warn("Release already exists.");
-        }
-        else {
-            changelog.addRelease(new mod_js_2.Release(version));
-        }
-    }
-    save(file, changelog);
-}
-catch (err) {
-    console.error(red(err.message));
-    if (!argv.quiet) {
-        dntShim.Deno.exit(1);
-    }
-}
-function save(file, changelog, isNew = false) {
-    changelog.url = argv.url || changelog.url || getRemoteUrl(argv.https);
-    if (!changelog.url) {
-        console.error(red('Please, set the repository url with --url="https://github.com/username/repository"'));
-        changelog.url = "https://example.com";
-    }
-    if (changelog.url) {
-        const settings = (0, settings_js_1.default)(changelog.url);
-        if (settings) {
-            changelog.head = settings.head;
-            changelog.tagLinkBuilder = settings.tagLink;
-        }
-    }
-    if (argv.head) {
-        changelog.head = argv.head;
-    }
-    dntShim.Deno.writeTextFileSync(file, changelog.toString());
-    if (isNew) {
-        console.log(green("Generated new file"), file);
-    }
-    else {
-        console.log(green("Updated file"), file);
-    }
-}
-function red(message) {
-    return "\u001b[" + 31 + "m" + message + "\u001b[" + 39 + "m";
-}
-function green(message) {
-    return "\u001b[" + 32 + "m" + message + "\u001b[" + 39 + "m";
-}
-function normalizeUrl(url, https) {
-    // remove .git suffix
-    url = url.replace(/\.git$/, "");
-    // normalize git@host urls
-    if (url.startsWith("git@")) {
-        url = url.replace(/^git@([^:]+):(.*)$/, (https ? "https" : "http") + "://$1/$2");
-    }
-    // remove trailing slashes
-    url = url.replace(/\/+$/, "");
-    return new URL(url);
-}
-function getRemoteUrl(https = true) {
-    try {
-        const file = (0, mod_js_1.join)(dntShim.Deno.cwd(), ".git", "config");
-        const content = dntShim.Deno.readTextFileSync(file);
-        const data = (0, mod_js_3.parse)(content);
-        const origin = data['remote "origin"'];
-        if (!origin?.url) {
-            return;
-        }
-        return normalizeUrl(origin.url, https).href;
-    }
-    catch (err) {
-        console.error(red(err.message));
-        // Ignore
-    }
-}
-function showHelp() {
-    console.log(`keep-a-changelog
-
-Usage: keep-a-changelog [options]
-
-Options:
-  --file, -f          Changelog file (default: CHANGELOG.md)
-  --format            Output format (default: compact)
-  --bullet-style      Bullet point style (default: -)
-  --url               Repository URL
-
-  --init              Initialize a new changelog file
-  --latest-release    Print the latest release version
-
-  --release           Set the date of the specified release
-  --combine           Combine changes from releases with the same version
-  --create            Create a new release
-
-  --no-v-prefix       Do not add a "v" prefix to the version
-  --no-sort-releases  Do not sort releases
-  --head              Set the HEAD link
-  --quiet             Do not print errors
-  --help, -h          Show this help message
-`);
-}

package/script/keep-a-changelog/mod.d.ts

@@ -1,6 +0,0 @@
-import "../_dnt.polyfills.js";
-import parser from "./src/parser.js";
-import Change from "./src/Change.js";
-import Changelog from "./src/Changelog.js";
-import Release from "./src/Release.js";
-export { Change, Changelog, parser, Release };

package/script/keep-a-changelog/mod.js

@@ -1,15 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Release = exports.parser = exports.Changelog = exports.Change = void 0;
-require("../_dnt.polyfills.js");
-const parser_js_1 = __importDefault(require("./src/parser.js"));
-exports.parser = parser_js_1.default;
-const Change_js_1 = __importDefault(require("./src/Change.js"));
-exports.Change = Change_js_1.default;
-const Changelog_js_1 = __importDefault(require("./src/Changelog.js"));
-exports.Changelog = Changelog_js_1.default;
-const Release_js_1 = __importDefault(require("./src/Release.js"));
-exports.Release = Release_js_1.default;

package/script/std/cli/parse_args.d.ts

@@ -1,193 +0,0 @@
-/** The value returned from {@linkcode parseArgs}. */
-export type Args<TArgs extends Record<string, unknown> = Record<string, any>, TDoubleDash extends boolean | undefined = undefined> = Id<TArgs & {
-    /** Contains all the arguments that didn't have an option associated with
-     * them. */
-    _: Array<string | number>;
-} & (boolean extends TDoubleDash ? DoubleDash : true extends TDoubleDash ? Required<DoubleDash> : Record<never, never>)>;
-/** Options for {@linkcode parseArgs}. */
-export interface ParseOptions<TBooleans extends BooleanType = BooleanType, TStrings extends StringType = StringType, TCollectable extends Collectable = Collectable, TNegatable extends Negatable = Negatable, TDefault extends Record<string, unknown> | undefined = Record<string, unknown> | undefined, TAliases extends Aliases | undefined = Aliases | undefined, TDoubleDash extends boolean | undefined = boolean | undefined> {
-    /**
-     * When `true`, populate the result `_` with everything before the `--` and
-     * the result `['--']` with everything after the `--`.
-     *
-     * @default {false}
-     *
-     * @example Double dash option is false
-     * ```ts
-     * // $ deno run example.ts -- a arg1
-     * import { parseArgs } from "parse_args.ts";
-     * const args = parseArgs(Deno.args, { "--": false }); // args equals { _: [ "a", "arg1" ] }
-     * ```
-     *
-     * @example Double dash option is true
-     * ```ts
-     * // $ deno run example.ts -- a arg1
-     * import { parseArgs } from "parse_args.ts";
-     * const args = parseArgs(Deno.args, { "--": true }); // args equals { _: [], --: [ "a", "arg1" ] }
-     * ```
-     */
-    "--"?: TDoubleDash;
-    /**
-     * An object mapping string names to strings or arrays of string argument
-     * names to use as aliases.
-     *
-     * @default {{}}
-     */
-    alias?: TAliases;
-    /**
-     * A boolean, string or array of strings to always treat as booleans. If
-     * `true` will treat all double hyphenated arguments without equal signs as
-     * `boolean` (e.g. affects `--foo`, not `-f` or `--foo=bar`).
-     *  All `boolean` arguments will be set to `false` by default.
-     *
-     * @default {false}
-     */
-    boolean?: TBooleans | ReadonlyArray<Extract<TBooleans, string>>;
-    /**
-     * An object mapping string argument names to default values.
-     *
-     * @default {{}}
-     */
-    default?: TDefault & Defaults<TBooleans, TStrings>;
-    /**
-     * When `true`, populate the result `_` with everything after the first
-     * non-option.
-     *
-     * @default {false}
-     */
-    stopEarly?: boolean;
-    /**
-     * A string or array of strings argument names to always treat as strings.
-     *
-     * @default {[]}
-     */
-    string?: TStrings | ReadonlyArray<Extract<TStrings, string>>;
-    /**
-     * A string or array of strings argument names to always treat as arrays.
-     * Collectable options can be used multiple times. All values will be
-     * collected into one array. If a non-collectable option is used multiple
-     * times, the last value is used.
-     *
-     * @default {[]}
-     */
-    collect?: TCollectable | ReadonlyArray<Extract<TCollectable, string>>;
-    /**
-     * A string or array of strings argument names which can be negated
-     * by prefixing them with `--no-`, like `--no-config`.
-     *
-     * @default {[]}
-     */
-    negatable?: TNegatable | ReadonlyArray<Extract<TNegatable, string>>;
-    /**
-     * A function which is invoked with a command line parameter not defined in
-     * the `options` configuration object. If the function returns `false`, the
-     * unknown option is not added to `parsedArgs`.
-     *
-     * @default {unknown}
-     */
-    unknown?: (arg: string, key?: string, value?: unknown) => unknown;
-}
-/**
- * Take a set of command line arguments, optionally with a set of options, and
- * return an object representing the flags found in the passed arguments.
- *
- * By default, any arguments starting with `-` or `--` are considered boolean
- * flags. If the argument name is followed by an equal sign (`=`) it is
- * considered a key-value pair. Any arguments which could not be parsed are
- * available in the `_` property of the returned object.
- *
- * By default, this module tries to determine the type of all arguments
- * automatically and the return type of this function will have an index
- * signature with `any` as value (`{ [x: string]: any }`).
- *
- * If the `string`, `boolean` or `collect` option is set, the return value of
- * this function will be fully typed and the index signature of the return
- * type will change to `{ [x: string]: unknown }`.
- *
- * Any arguments after `'--'` will not be parsed and will end up in `parsedArgs._`.
- *
- * Numeric-looking arguments will be returned as numbers unless `options.string`
- * or `options.boolean` is set for that argument name.
- *
- * See {@linkcode ParseOptions} for more information.
- *
- * @param args An array of command line arguments.
- * @param options Options for the parse function.
- *
- * @typeParam TArgs Type of result.
- * @typeParam TDoubleDash Used by `TArgs` for the result.
- * @typeParam TBooleans Used by `TArgs` for the result.
- * @typeParam TStrings Used by `TArgs` for the result.
- * @typeParam TCollectable Used by `TArgs` for the result.
- * @typeParam TNegatable Used by `TArgs` for the result.
- * @typeParam TDefaults Used by `TArgs` for the result.
- * @typeParam TAliases Used by `TArgs` for the result.
- * @typeParam TAliasArgNames Used by `TArgs` for the result.
- * @typeParam TAliasNames Used by `TArgs` for the result.
- *
- * @return The parsed arguments.
- *
- * @example Usage
- * ```ts
- * import { parseArgs } from "parse_args.ts";
- * import { assertEquals } from "../assert/equals.ts";
- *
- * // For proper use, one should use `parseArgs(Deno.args)`
- * assertEquals(parseArgs(["--foo", "--bar=baz", "./quux.txt"]), {
- *   foo: true,
- *   bar: "baz",
- *   _: ["./quux.txt"],
- * });
- * ```
- *
- * @example `string` and `boolean` options
- *
- * Use `string` and `boolean` options to specify the type of the argument.
- *
- * ```ts
- * import { parseArgs } from "parse_args.ts";
- * import { assertEquals } from "../assert/equals.ts";
- *
- * const args = parseArgs(["--foo", "--bar", "baz"], {
- *   boolean: ["foo"],
- *   string: ["bar"],
- * });
- *
- * assertEquals(args, { foo: true, bar: "baz", _: [] });
- * ```
- *
- * @example `collect` option
- *
- * `collect` option tells the parser to treat the option as an array. All
- * values will be collected into one array. If a non-collectable option is used
- * multiple times, the last value is used.
- *
- * ```ts
- * import { parseArgs } from "parse_args.ts";
- * import { assertEquals } from "../assert/equals.ts";
- *
- * const args = parseArgs(["--foo", "bar", "--foo", "baz"], {
- *  collect: ["foo"],
- * });
- *
- * assertEquals(args, { foo: ["bar", "baz"], _: [] });
- * ```
- *
- * @example `negatable` option
- *
- * `negatable` option tells the parser to treat the option can be negated by
- * prefixing them with `--no-`, like `--no-config`.
- *
- * ```ts
- * import { parseArgs } from "parse_args.ts";
- * import { assertEquals } from "../assert/equals.ts";
- *
- * const args = parseArgs(["--no-foo"], {
- *   boolean: ["foo"],
- *   negatable: ["foo"],
- * });
- *
- * assertEquals(args, { foo: false, _: [] });
- * ```
- */
-export declare function parseArgs<TArgs extends Values<TBooleans, TStrings, TCollectable, TNegatable, TDefaults, TAliases>, TDoubleDash extends boolean | undefined = undefined, TBooleans extends BooleanType = undefined, TStrings extends StringType = undefined, TCollectable extends Collectable = undefined, TNegatable extends Negatable = undefined, TDefaults extends Record<string, unknown> | undefined = undefined, TAliases extends Aliases<TAliasArgNames, TAliasNames> | undefined = undefined, TAliasArgNames extends string = string, TAliasNames extends string = string>(args: string[], options?: ParseOptions<TBooleans, TStrings, TCollectable, TNegatable, TDefaults, TAliases, TDoubleDash>): Args<TArgs, TDoubleDash>;