Some cleanup from 0.24.0

Resolves #2222
Resolves #2223

Author: Gerrit0

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Unreleased
 
+### Bug Fixes
+
+-   Improve detection for legacy JSDoc `@example` tags, #2222.
+-   The page footer will now appear at the bottom of the page even if the page is short, #2223.
+
 # v0.24.0 (2023-04-08)
 
 ### Breaking Changes

src/lib/converter/comments/parser.ts

@@ -268,7 +268,11 @@ function exampleBlockContent(
     const end = lexer.done() || lexer.peek();
     lexer.release();
 
-    if (content.some((part) => part.kind === "code")) {
+    if (
+        content.some(
+            (part) => part.kind === "code" && part.text.startsWith("```")
+        )
+    ) {
         return blockContent(comment, lexer, config, warning);
     }
 

src/test/converter/inheritance/specs.json

@@ -527,17 +527,9 @@
                   {
                     "tag": "@example",
                     "content": [
-                      {
-                        "kind": "text",
-                        "text": "This function inherited commentary from the "
-                      },
                       {
                         "kind": "code",
-                        "text": "`functionSource`"
-                      },
-                      {
-                        "kind": "text",
-                        "text": " function"
+                        "text": "```ts\nThis function inherited commentary from the `functionSource` function\n```"
                       }
                     ]
                   },

src/test/converter2/issues/gh2222.ts

@@ -0,0 +1,5 @@
+/**
+ * @example
+ * let x = `str`
+ */
+export const example = 1;

src/test/issues.c2.test.ts

@@ -1039,4 +1039,15 @@ describe("Issue Tests", () => {
         equal(param.type?.type, "query");
         equal(param.type.queryType.reflection?.name, "TypeEmitter");
     });
+
+    it("#2222", () => {
+        const project = convert();
+        const example = query(project, "example");
+        equal(
+            Comment.combineDisplayParts(
+                example.comment?.getTag("@example")?.content
+            ),
+            "```ts\nlet x = `str`\n```"
+        );
+    });
 });

static/style.css

@@ -228,6 +228,8 @@ dd {
 
 .container-main {
     margin: 0 auto;
+    /* toolbar, footer, margin */
+    min-height: calc(100vh - 41px - 56px - 4rem);
 }
 
 @keyframes fade-in {