keep-a-changelog 2.5.3 → 2.6.0

package/esm/src/Release.js

@@ -1,220 +0,0 @@
-import { compare, format, parse } from "./deps.js";
-import Change from "./Change.js";
-export default class Release {
-    constructor(version, date, description = "") {
-        Object.defineProperty(this, "changelog", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "parsedVersion", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "date", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "yanked", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "changes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.setVersion(version);
-        this.setDate(date);
-        this.description = description;
-        this.changes = new Map([
-            ["added", []],
-            ["changed", []],
-            ["deprecated", []],
-            ["removed", []],
-            ["fixed", []],
-            ["security", []],
-        ]);
-    }
-    get version() {
-        return this.parsedVersion ? format(this.parsedVersion) : undefined;
-    }
-    compare(release) {
-        if (!this.parsedVersion && release.parsedVersion) {
-            return -1;
-        }
-        if (!release.parsedVersion) {
-            return 1;
-        }
-        if (!this.date && release.date) {
-            return -1;
-        }
-        if (!release.date) {
-            return 1;
-        }
-        if (this.parsedVersion && release.parsedVersion) {
-            return -compare(this.parsedVersion, release.parsedVersion);
-        }
-        return 0;
-    }
-    isEmpty() {
-        if (this.description.trim()) {
-            return false;
-        }
-        return Array.from(this.changes.values()).every((change) => !change.length);
-    }
-    setVersion(version) {
-        if (typeof version === "string") {
-            version = parse(version);
-        }
-        this.parsedVersion = version;
-        //Re-sort the releases of the parent changelog
-        if (this.changelog) {
-            this.changelog.sortReleases();
-        }
-    }
-    setDate(date) {
-        if (typeof date === "string") {
-            date = new Date(date);
-        }
-        this.date = date;
-    }
-    setYanked(yanked = true) {
-        this.yanked = yanked;
-        return this;
-    }
-    addChange(type, change) {
-        if (!(change instanceof Change)) {
-            change = new Change(change);
-        }
-        if (!this.changes.has(type)) {
-            throw new Error("Invalid change type");
-        }
-        this.changes.get(type).push(change);
-        return this;
-    }
-    added(change) {
-        return this.addChange("added", change);
-    }
-    changed(change) {
-        return this.addChange("changed", change);
-    }
-    deprecated(change) {
-        return this.addChange("deprecated", change);
-    }
-    removed(change) {
-        return this.addChange("removed", change);
-    }
-    fixed(change) {
-        return this.addChange("fixed", change);
-    }
-    security(change) {
-        return this.addChange("security", change);
-    }
-    toString(changelog) {
-        let t = [];
-        const hasCompareLink = this.getCompareLink(changelog) !== undefined;
-        const yanked = this.yanked ? " [YANKED]" : "";
-        const { version } = this;
-        if (version) {
-            if (hasCompareLink) {
-                t.push(`## [${version}] - ${formatDate(this.date)}${yanked}`);
-            }
-            else {
-                t.push(`## ${version} - ${formatDate(this.date)}${yanked}`);
-            }
-        }
-        else {
-            if (hasCompareLink) {
-                t.push(`## [Unreleased]${yanked}`);
-            }
-            else {
-                t.push(`## Unreleased${yanked}`);
-            }
-        }
-        if (changelog?.format === "markdownlint") {
-            t.push("");
-        }
-        if (this.description.trim()) {
-            t.push(this.description.trim());
-            t.push("");
-        }
-        this.changes.forEach((changes, type) => {
-            if (changes.length) {
-                t.push(`### ${type[0].toUpperCase()}${type.substring(1)}`);
-                if (changelog?.format === "markdownlint") {
-                    t.push("");
-                }
-                t = t.concat(changes.map((change) => change.toString()));
-                t.push("");
-            }
-        });
-        return t.join("\n").trim();
-    }
-    getCompareLink(changelog) {
-        if (!changelog?.url) {
-            return;
-        }
-        const index = changelog.releases.indexOf(this);
-        if (index === -1) {
-            return;
-        }
-        let offset = 1;
-        let previous = changelog.releases[index + offset];
-        while (previous && !previous.date) {
-            ++offset;
-            previous = changelog.releases[index + offset];
-        }
-        if (!previous && (!this.version || !this.date)) {
-            return;
-        }
-        const compareLink = changelog.compareLink(previous, this);
-        if (!compareLink) {
-            return;
-        }
-        return `[${this.version || "Unreleased"}]: ${compareLink}`;
-    }
-    getLinks(changelog) {
-        const links = [];
-        if (!changelog.url) {
-            return links;
-        }
-        this.changes.forEach((changes) => changes.forEach((change) => {
-            change.issues.forEach((issue) => {
-                if (!links.includes(issue)) {
-                    links.push(`[#${issue}]: ${changelog.url}/issues/${issue}`);
-                }
-            });
-        }));
-        return links;
-    }
-}
-function formatDate(date) {
-    if (!date) {
-        return "Unreleased";
-    }
-    const year = date.getUTCFullYear();
-    let month = date.getUTCMonth() + 1;
-    let day = date.getUTCDate();
-    if (month < 10) {
-        month = "0" + month;
-    }
-    if (day < 10) {
-        day = "0" + day;
-    }
-    return `${year}-${month}-${day}`;
-}

package/esm/src/deps.d.ts

@@ -1,2 +0,0 @@
-export { compare, eq, format, parse, } from "../deps/deno.land/std@0.205.0/semver/mod.js";
-export type { SemVer } from "../deps/deno.land/std@0.205.0/semver/mod.js";

package/esm/src/deps.js

@@ -1 +0,0 @@
-export { compare, eq, format, parse, } from "../deps/deno.land/std@0.205.0/semver/mod.js";

package/esm/src/parser.d.ts

@@ -1,11 +0,0 @@
-import Changelog from "./Changelog.js";
-import Release from "./Release.js";
-export interface Options {
-    /**
-     * Custom function to create Release instances.
-     * Needed if you want to use a custom Release class.
-     */
-    releaseCreator: (version?: string, date?: string, description?: string) => Release;
-}
-/** Parse a markdown string */
-export default function parser(markdown: string, options?: Options): Changelog;

package/esm/src/parser.js

@@ -1,178 +0,0 @@
-import Changelog from "./Changelog.js";
-import Release from "./Release.js";
-const defaultOptions = {
-    releaseCreator: (version, date, description) => new Release(version, date, description),
-};
-/** Parse a markdown string */
-export default function parser(markdown, options) {
-    const opts = Object.assign({}, defaultOptions, options);
-    const tokens = tokenize(markdown);
-    try {
-        return processTokens(tokens, opts);
-    }
-    catch (error) {
-        throw new Error(`Parse error in the line ${tokens[0][0]}: ${error.message}`);
-    }
-}
-/** Process an array of tokens to build the Changelog */
-function processTokens(tokens, opts) {
-    const changelog = new Changelog("");
-    changelog.flag = getContent(tokens, "flag");
-    changelog.title = getContent(tokens, "h1", true);
-    changelog.description = getTextContent(tokens);
-    //Releases
-    let release;
-    while ((release = getContent(tokens, "h2").toLowerCase())) {
-        const matches = release.match(/\[?([^\]]+)\]?\s*-\s*([\d]{4}-[\d]{1,2}-[\d]{1,2})(\s+\[yanked\])?$/);
-        if (matches) {
-            release = opts.releaseCreator(matches[1], matches[2]);
-            release.yanked = !!matches[3];
-        }
-        else if (release.includes("unreleased")) {
-            const matches = release.match(/\[?([^\]]+)\]?\s*-\s*unreleased(\s+\[yanked\])?$/);
-            const yanked = release.includes("[yanked]");
-            release = matches
-                ? opts.releaseCreator(matches[1])
-                : opts.releaseCreator();
-            release.yanked = yanked;
-        }
-        else {
-            throw new Error(`Syntax error in the release title`);
-        }
-        changelog.addRelease(release);
-        release.description = getTextContent(tokens);
-        let type;
-        while ((type = getContent(tokens, "h3").toLowerCase())) {
-            let change;
-            while ((change = getContent(tokens, "li"))) {
-                release.addChange(type, change);
-            }
-        }
-    }
-    //Skip release links
-    let link = getContent(tokens, "link");
-    while (link) {
-        if (!changelog.url) {
-            const matches = link.match(/^\[.*\]\:\s*(http.*?)\/(?:-\/)?compare\/.*$/);
-            if (matches) {
-                changelog.url = matches[1];
-            }
-        }
-        link = getContent(tokens, "link");
-    }
-    //Footer
-    if (getContent(tokens, "hr")) {
-        changelog.footer = getContent(tokens, "p");
-    }
-    if (tokens.length) {
-        throw new Error(`Unexpected content ${JSON.stringify(tokens)}`);
-    }
-    return changelog;
-}
-/** Returns the content of a token */
-function getContent(tokens, type, required = false) {
-    const types = Array.isArray(type) ? type : [type];
-    if (!tokens[0] || types.indexOf(tokens[0][1]) === -1) {
-        if (required) {
-            throw new Error(`Required token missing in: "${tokens[0][0]}"`);
-        }
-        return "";
-    }
-    return tokens.shift()[2].join("\n");
-}
-/** Return the next text content */
-function getTextContent(tokens) {
-    const lines = [];
-    const types = ["p", "li"];
-    while (tokens[0] && types.indexOf(tokens[0][1]) !== -1) {
-        const token = tokens.shift();
-        if (token[1] === "li") {
-            lines.push("- " + token[2].join("\n"));
-        }
-        else {
-            lines.push(token[2].join("\n"));
-        }
-    }
-    return lines.join("\n");
-}
-/** Tokenize a markdown string */
-function tokenize(markdown) {
-    const tokens = [];
-    markdown
-        .trim()
-        .split("\n")
-        .map((line, index, allLines) => {
-        const lineNumber = index + 1;
-        if (line.startsWith("---")) {
-            return [lineNumber, "hr", ["-"]];
-        }
-        if (line.startsWith("# ")) {
-            return [lineNumber, "h1", [line.substr(1).trim()]];
-        }
-        if (line.startsWith("## ")) {
-            return [lineNumber, "h2", [line.substr(2).trim()]];
-        }
-        if (line.startsWith("### ")) {
-            return [lineNumber, "h3", [line.substr(3).trim()]];
-        }
-        if (line.startsWith("-")) {
-            return [lineNumber, "li", [line.substr(1).trim()]];
-        }
-        if (line.startsWith("*")) {
-            return [lineNumber, "li", [line.substr(1).trim()]];
-        }
-        if (line.match(/^\[.*\]\:\s*http.*$/)) {
-            return [lineNumber, "link", [line.trim()]];
-        }
-        if (line.match(/^\[.*\]\:$/)) {
-            const nextLine = allLines[index + 1];
-            if (nextLine && nextLine.match(/\s+http.*$/)) {
-                // We found a multi-line link: treat it like a single line
-                allLines[index + 1] = "";
-                return [lineNumber, "link", [
-                        line.trim() + "\n" + nextLine.trimEnd(),
-                    ]];
-            }
-        }
-        const result = line.match(/^<!--(.*)-->$/);
-        if (result) {
-            return [lineNumber, "flag", [result[1].trim()]];
-        }
-        return [lineNumber, "p", [line.trimEnd()]];
-    })
-        .forEach((line, index) => {
-        const [lineNumber, type, [content]] = line;
-        if (index > 0) {
-            const prevType = tokens[0][1];
-            if (type === "p") {
-                if (prevType === "p") {
-                    return tokens[0][2].push(content);
-                }
-                if (prevType === "li") {
-                    return tokens[0][2].push(content.replace(/^\s\s/, ""));
-                }
-            }
-        }
-        tokens.unshift([lineNumber, type, [content]]);
-    });
-    return tokens
-        .filter((token) => !isEmpty(token[2]))
-        .map((token) => {
-        const content = token[2];
-        while (isEmpty(content[content.length - 1])) {
-            content.pop();
-        }
-        while (isEmpty(content[0])) {
-            content.shift();
-        }
-        return token;
-    })
-        .reverse();
-}
-/** Check if a string or array is empty */
-function isEmpty(val) {
-    if (Array.isArray(val)) {
-        val = val.join("");
-    }
-    return !val || val.trim() === "";
-}

package/esm/src/settings.d.ts

@@ -1,17 +0,0 @@
-/**
- * Temporary URLPattern shim
- * @see https://github.com/denoland/dnt/issues/336
- */
-declare class URLPatternShim {
-    private readonly pattern;
-    constructor(pattern: string | RegExp);
-    test(url: string): boolean;
-}
-export interface Settings {
-    pattern: URLPatternShim;
-    tagLink: (url: string, tag: string, previous?: string) => string;
-    head: string;
-}
-export default function getSettingsForURL(url: string): Settings | undefined;
-export declare const settings: Settings[];
-export {};

package/esm/src/settings.js

@@ -1,47 +0,0 @@
-/**
- * Temporary URLPattern shim
- * @see https://github.com/denoland/dnt/issues/336
- */
-class URLPatternShim {
-    constructor(pattern) {
-        Object.defineProperty(this, "pattern", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        if (typeof pattern === "string") {
-            pattern = pattern.replace(/\*/g, ".*");
-            pattern = new RegExp(`^${pattern}$`);
-        }
-        this.pattern = pattern;
-    }
-    test(url) {
-        return this.pattern.test(url);
-    }
-}
-export default function getSettingsForURL(url) {
-    return settings.find((settings) => settings.pattern.test(url));
-}
-export const settings = [
-    {
-        pattern: new URLPatternShim("https://github.com/*"),
-        head: "HEAD",
-        tagLink(url, tag, previous) {
-            if (!previous) {
-                return `${url}/releases/tag/${tag}`;
-            }
-            return `${url}/compare/${previous}...${tag}`;
-        },
-    },
-    {
-        pattern: new URLPatternShim("https://gitlab.*/*"),
-        head: "master",
-        tagLink(url, tag, previous) {
-            if (!previous) {
-                return `${url}/-/tags/${tag}`;
-            }
-            return `${url}/-/compare/${previous}...${tag}`;
-        },
-    },
-];

package/script/bin.d.ts

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

package/script/deps/deno.land/std@0.189.0/_util/asserts.d.ts

@@ -1,10 +0,0 @@
-/**
- * All internal non-test code, that is files that do not have `test` or `bench` in the name, must use the assertion functions within `_utils/asserts.ts` and not `testing/asserts.ts`. This is to create a separation of concerns between internal and testing assertions.
- */
-export declare class DenoStdInternalError extends Error {
-    constructor(message: string);
-}
-/** Make an assertion, if not `true`, then throw. */
-export declare function assert(expr: unknown, msg?: string): asserts expr;
-/** Use this to assert unreachable code. */
-export declare function unreachable(): never;

package/script/deps/deno.land/std@0.189.0/_util/asserts.js

@@ -1,27 +0,0 @@
-"use strict";
-// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
-// This module is browser compatible.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.unreachable = exports.assert = exports.DenoStdInternalError = void 0;
-/**
- * All internal non-test code, that is files that do not have `test` or `bench` in the name, must use the assertion functions within `_utils/asserts.ts` and not `testing/asserts.ts`. This is to create a separation of concerns between internal and testing assertions.
- */
-class DenoStdInternalError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "DenoStdInternalError";
-    }
-}
-exports.DenoStdInternalError = DenoStdInternalError;
-/** Make an assertion, if not `true`, then throw. */
-function assert(expr, msg = "") {
-    if (!expr) {
-        throw new DenoStdInternalError(msg);
-    }
-}
-exports.assert = assert;
-/** Use this to assert unreachable code. */
-function unreachable() {
-    throw new DenoStdInternalError("unreachable");
-}
-exports.unreachable = unreachable;

package/script/deps/deno.land/std@0.189.0/_util/os.d.ts

@@ -1,4 +0,0 @@
-export type OSType = "windows" | "linux" | "darwin" | "freebsd";
-export declare const osType: OSType;
-export declare const isWindows: boolean;
-export declare const isLinux: boolean;