changelog-tool 0.7.2 → 1.0.0

package/.github/workflows/node.yml

@@ -18,7 +18,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [16.x, 18.x]
+        node-version: [16.x, 18.x, 20.x]
         # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
 
     steps:

package/changelog.md

@@ -1,6 +1,22 @@
 Changelog
 =========
 
+1.0.0 (2023-06-20)
+------------------
+
+First stable release! Just kidding, it was already stable.
+
+* Add support for [Markdown reference links][1]. References are a Markdown
+  feature that lets you write links in paragraphs, but put the actual target
+  near the end of the document similar to references in technical documents.
+  This can declutter the reading experience for those reading the Markdown
+  sources. The tool doesn't let you quickly add links via the CLI yet, but it
+  will no longer mangle them when they appear.
+* Testing Node 20
+* Bugfix: Always insert an empty line between the 'preface' and bulletpoints
+  sections of a version block.
+
+
 0.7.2 (2023-02-17)
 ------------------
 
@@ -70,4 +86,7 @@ Changelog
 0.1.0 (2023-02-08)
 ------------------
 
-* Implemented the 'help' and 'init' commands.
+* Implemented the 'help' and 'init' commands
+
+[1]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#link "Markdown cheatsheet: Links"
+

package/changelog.mjs

@@ -10,13 +10,21 @@ export class Changelog {
    */
   versions = [];
 
+  /**
+   * @type {Link[]}
+   */
+  links = [];
+
   toString() {
 
     return (
       this.title + '\n' +
       ('='.repeat(this.title.length)) + '\n' +
       '\n' +
-      this.versions.map(version => version.toString()).join('\n\n')
+      this.versions.map(version => version.toString()).join('\n\n') +
+
+      // Sorry about this line future me (or someone else)
+      (this.links.length > 0 ? ('\n' + this.links.map( link => wrap(`[${link.name}]: ${link.href}${link.title?` "${link.title}"`:''}`, link.name.length+4)).join('\n') + '\n') : '')
     );
 
   }
@@ -133,7 +141,7 @@ export class VersionLog {
     return (
       title + '\n' +
       ('-'.repeat(title.length)) + '\n' +
-      (this.preface ? '\n' + wrap(this.preface, 0, lineLength) : '') +
+      (this.preface ? '\n' + wrap(this.preface, 0, lineLength) + '\n' : '') +
       '\n' +
       this.items.map(version => version.output(lineWrap)).join('\n') +
       '\n' +
@@ -147,7 +155,7 @@ export class VersionLog {
 export class LogItem {
 
   /**
-   * @type string
+   * @type {string}
    */
   message;
 
@@ -177,4 +185,9 @@ export class LogItem {
 
 }
 
-
+/**
+ * @typedef Link {Object}
+ * @property Link.href {string}
+ * @property Link.name {string}
+ * @property Link.title {string|null}
+ */

package/package.json

@@ -1,13 +1,20 @@
 {
   "name": "changelog-tool",
-  "version": "0.7.2",
+  "version": "1.0.0",
   "description": "A CLI tool for manipulating changelogs",
   "type": "module",
   "main": "index.mjs",
+  "homepage": "https://github.com/evert/changelog-tool",
+  "author": "Evert Pot (https://evertpot.com/)",
+  "license": "MIT",
   "scripts": {
     "test": "node --test",
     "watch": "tsc --watch"
   },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:evert/changelog-tool.git"
+  },
   "keywords": [
     "changelog",
     "markdown"

package/parse.mjs

@@ -14,6 +14,10 @@ export async function parseFile(filename) {
 
 }
 
+const linkReferenceRe = /^\[([a-zA-Z0-9])+\]:/;
+const versionRe = /^([0-9\.]{3,}(?:-(?:alpha|beta)\.[0-9]+)?) \(([0-9]{4}-[0-9]{2}-[0-9]{2}|\?\?\?\?-\?\?-\?\?)\)$/;
+
+
 /**
  * @param {string} changelogInput
  * @returns {Changelog}
@@ -51,10 +55,31 @@ export function parse(changelogInput) {
       continue;
     }
 
+    // Look for link references
+    if (linkReferenceRe.test(line)) {
+
+      let linkRefLine = line;
+      while(lines[idx+1]?.match(/^\W\W/)) {
+        // If the line was folded over multiple lines, read those too.
+        linkRefLine += ' ' + lines[idx+1].trim();
+        idx++;
+      }
+      const name = linkRefLine.match(linkReferenceRe)?.[1];
+      const href = linkRefLine.split(' ')[1];
+      const title = linkRefLine.includes('"') ? linkRefLine.substring(linkRefLine.indexOf('"')+1,linkRefLine.lastIndexOf('"')) : null;
+      changelog.links.push({
+        name: /** @type {string} */(name),
+        href,
+        title
+      });
+      continue;
+
+    }
+
     // Look to the next line for ----
     if (lines[idx+1]?.match(/^-{1,}$/)) {
       // Found a new Version
-      const matches = line.match(/^([0-9\.]{3,}(?:-(?:alpha|beta)\.[0-9]+)?) \(([0-9]{4}-[0-9]{2}-[0-9]{2}|\?\?\?\?-\?\?-\?\?)\)$/);
+      const matches = line.match(versionRe);
 
       if (!matches) {
         throw new Error(`A version title must have the format "1.0.0 (YYYY-MM-DD)" or "1.0.0 (????-??-??)" for unreleased versions. We found: "${line}"`);

package/readme.md

@@ -8,6 +8,9 @@ This tool currently expects to work with a file named 'changelog.md' in the
 current working directory. This is a markdown file that looks like this:
 
 ```
+Changelog
+=========
+
 0.4.0 (????-??-??)
 ------------------
 

package/test/parse.mjs

@@ -83,7 +83,6 @@ Well, that's all folks.
 *
 `;
 
-  debugger;
   const result = await parse(input);
 
   const latest = result.get('0.2.0');
@@ -93,3 +92,44 @@ Well, that's all folks.
 
 
 });
+
+test('Link references', async() => {
+
+
+  const input = `Changesss
+=========
+
+0.2.0 (????-??-??)
+------------------
+
+WOW another release. How good is that?
+Here's another line.
+
+* Implemented the 'list' command.
+* Added testing framework. See [the blog post][1] for more information.
+
+0.1.0 (2023-02-08)
+------------------
+
+* Implemented the ['help'][2] and 'init' commands.
+
+[1]: https://evertpot.com/ "My Blog"
+[2]: https://indieweb.social/@evert "My Mastodon account, but it's split
+  over two lines"
+`;
+
+  debugger;
+  const result = await parse(input);
+
+  assert.deepEqual({
+    name: '1',
+    href: 'https://evertpot.com/',
+    title: 'My Blog',
+  }, result.links[0]);
+  assert.deepEqual({
+    name: '2',
+    href: 'https://indieweb.social/@evert',
+    title: 'My Mastodon account, but it\'s split over two lines',
+  }, result.links[1]);
+
+});