fix(adr): improve frontmatter decorator (#6217)

Signed-off-by: Christoph Jerolimov <[email protected]>

Author: christoph-jerolimov

workspaces/adr/.changeset/chatty-experts-jam.md

@@ -0,0 +1,5 @@
+---
+'@backstage-community/plugin-adr': patch
+---
+
+FrontMatter decorator shows now a local date without time and timezone instead of a full `Date.toString()` string. It also uppercase the first character for lowercase-only strings.

workspaces/adr/plugins/adr/src/components/AdrReader/decorators.ts

@@ -54,14 +54,27 @@ export const adrDecoratorFactories = Object.freeze({
       let table = '';
       const attrs = parsedFrontmatter.attributes;
       if (Object.keys(attrs).length > 0) {
-        const stripNewLines = (val: unknown) =>
-          String(val).replaceAll('\n', '<br/>');
+        // Convert "alllowercase" strings into "First char uppercase" variants
+        const uppercaseFirstChar = (val: string) => {
+          if (val.match(/^[a-z]+$/)) {
+            return val.substring(0, 1).toUpperCase() + val.substring(1);
+          }
+          return val;
+        };
+        const stripNewLines = (val: unknown) => {
+          if (val instanceof Date) {
+            return val.toLocaleString(undefined, { dateStyle: 'medium' });
+          }
+          return String(val).replaceAll('\n', '<br/>');
+        };
         const row = (vals: string[]) => `|${vals.join('|')}|\n`;
-        table = `${row(Object.keys(attrs))}`;
-        table += `${row(Object.keys(attrs).map(() => '---'))}`;
-        table += `${row(Object.values(attrs).map(stripNewLines))}\n\n`;
+        table = row(Object.keys(attrs).map(uppercaseFirstChar));
+        table += row(Object.keys(attrs).map(() => '---'));
+        table += row(Object.values(attrs).map(stripNewLines));
+        table += '\n';
+        return { content: table + parsedFrontmatter.content };
       }
-      return { content: table + parsedFrontmatter.content };
+      return { content };
     };
   },
 });