@kenjura/ursa 0.34.0 → 0.39.0

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+# 0.39.0
+2025-12-13
+
+- Updated to node 24.5 to satisfy npm Trusted Publishing
+- Refactored Github Actions
+- Added CONTRIBUTING.md
+
+# 0.38.0
+2025-12-13
+
+- Updated Github Actions workflow to use OIDC for authentication
+
+# 0.37.0
+2025-12-13
+
+- Added Github Actions workflow for CI/CD (npm publish)
+
+# 0.36.0
+2025-12-13
+
+- Links to a valid .md file in source will now render as a link to the corresponding .html file (and show as an active link)
+
+# 0.35.0
+2025-12-11
+
+- Fixed issue where directory indices were empty
+
 # 0.34.0
 2025-12-11
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@kenjura/ursa",
   "author": "Andrew London <andrew@kenjura.com>",
   "type": "module",
-  "version": "0.34.0",
+  "version": "0.39.0",
   "description": "static site generator from MD/wikitext/YML",
   "main": "lib/index.js",
   "bin": {

package/src/helper/linkValidator.js

@@ -157,7 +157,24 @@ function resolveHref(href, validPaths, currentDocPath = null) {
   // Check if the href already has an extension
   const ext = extname(hrefWithoutHash);
   if (ext) {
-    // Has extension but doesn't exist
+    // Special handling for .md links - convert to .html if valid
+    if (ext.toLowerCase() === '.md') {
+      // Remove .md and check if .html version exists
+      const pathWithoutMd = normalized.slice(0, -3); // Remove '.md'
+      const htmlPath = pathWithoutMd + '.html';
+      debugTries.push(`${normalized} (.md → .html) ${htmlPath} → ${validPaths.has(htmlPath) ? '✓' : '✗'}`);
+      if (validPaths.has(htmlPath)) {
+        // Convert .md to .html in the resolved href
+        const resolvedHref = absoluteHref.slice(0, -3) + '.html' + hash;
+        return { resolvedHref, inactive: false, debug: debugTries.join(' | ') };
+      }
+      // Also check without extension (in case valid paths don't have .html suffix)
+      if (validPaths.has(pathWithoutMd)) {
+        const resolvedHref = absoluteHref.slice(0, -3) + '.html' + hash;
+        return { resolvedHref, inactive: false, debug: debugTries.join(' | ') };
+      }
+    }
+    // Has extension but doesn't exist (or is not .md)
     debugTries.push(`${normalized} → ✗`);
     return { resolvedHref: absoluteHref + hash, inactive: true, debug: debugTries.join(' | ') };
   }

package/src/jobs/generate.js

@@ -200,17 +200,42 @@ export async function generate({
     allSourceFilenamesThatAreArticles.map(async (file) => {
       try {
         const rawBody = await readFile(file, "utf8");
+        const type = parse(file).ext;
+        const ext = extname(file);
+        const base = basename(file, ext);
+        const dir = addTrailingSlash(dirname(file)).replace(source, "");
+        
+        // Calculate output paths for this file
+        const outputFilename = file
+          .replace(source, output)
+          .replace(parse(file).ext, ".html");
+        const url = '/' + outputFilename.replace(output, '');
         
         // Skip files that haven't changed (unless --clean flag is set)
         if (!_clean && !needsRegeneration(file, rawBody, hashCache)) {
           skippedCount++;
-          return; // Skip this file
+          // Still need to populate jsonCache for directory indices
+          const meta = extractMetadata(rawBody);
+          const body = renderFile({
+            fileContents: rawBody,
+            type,
+            dirname: dir,
+            basename: base,
+          });
+          jsonCache.set(file, {
+            name: base,
+            url,
+            contents: rawBody,
+            bodyHtml: body,
+            metadata: meta,
+            transformedMetadata: '',
+          });
+          return; // Skip regenerating this file
         }
         
         console.log(`processing article ${file}`);
         regeneratedCount++;
 
-        const type = parse(file).ext;
         const meta = extractMetadata(rawBody);
         const rawMeta = extractRawMetadata(rawBody);
         const bodyLessMeta = rawMeta ? rawBody.replace(rawMeta, "") : rawBody;
@@ -218,9 +243,6 @@ export async function generate({
           dirname(file),
           meta
         );
-        const ext = extname(file);
-        const base = basename(file, ext);
-        const dir = addTrailingSlash(dirname(file)).replace(source, "");
         
         // Calculate the document's URL path (e.g., "/character/index.html")
         const docUrlPath = '/' + dir + base + '.html';
@@ -269,10 +291,6 @@ export async function generate({
         // Pass docUrlPath so relative links can be resolved correctly
         finalHtml = markInactiveLinks(finalHtml, validPaths, docUrlPath, false);
 
-        const outputFilename = file
-          .replace(source, output)
-          .replace(parse(file).ext, ".html");
-
         console.log(`writing article to ${outputFilename}`);
 
         await outputFile(outputFilename, finalHtml);
@@ -280,7 +298,6 @@ export async function generate({
         // json
 
         const jsonOutputFilename = outputFilename.replace(".html", ".json");
-        const url = '/' + outputFilename.replace(output, '');
         const jsonObject = {
           name: base,
           url,