@kenjura/ursa 0.72.0 → 0.75.0

package/src/jobs/generate.js

@@ -39,6 +39,7 @@ import { createWhitelistFilter } from "../helper/whitelistFilter.js";
 import { processAllImages, transformImageTags, clearImageCache, copyAllImagesFast } from "../helper/imageProcessor.js";
 import { extractImageReferences } from "../helper/imageExtractor.js";
 import { checkFileSize, readFileStreaming, formatFileSize } from "../helper/streamingReader.js";
+import { generateBreadcrumbs } from "../helper/breadcrumbs.js";
 import {
   loadNavCache,
   saveNavCache,
@@ -462,7 +463,9 @@ export async function generate({
       const searchUrl = relativePath.startsWith('/') ? relativePath : '/' + relativePath;
       
       // Generate title from filename (in title case)
-      const title = toTitleCase(base);
+      // For index/home files, use parent folder name instead
+      const titleBase = (base === 'index' || base === 'home') ? basename(dirname(file)) : base;
+      const title = toTitleCase(titleBase || base);
       
       // Always add to search index (lightweight: title + path only, content added lazily)
       searchIndex.push({
@@ -543,6 +546,18 @@ export async function generate({
         useWorker: true
       });
 
+      // Inject default H1 if body doesn't start with one
+      if (!body || !body.trimStart().startsWith('<h1')) {
+        const h1Title = fileMeta?.title || title;
+        body = `<h1>${h1Title}</h1>\n` + (body || '');
+      }
+
+      // Inject breadcrumbs before the H1
+      const breadcrumbs = generateBreadcrumbs(dir, base, fileMeta);
+      if (breadcrumbs) {
+        body = breadcrumbs + body;
+      }
+
       // Inject frontmatter table after first H1 (for markdown files with metadata)
       if ((type === '.md' || type === '.mdx') && fileMeta) {
         body = injectFrontmatterTable(body, fileMeta);
@@ -640,7 +655,7 @@ export async function generate({
       // Build final HTML with all replacements in a single regex pass
       // This avoids creating 8 intermediate strings
       const replacements = {
-        "${title}": title,
+        "${title}": fileMeta?.title || title,
         "${menu}": menu,
         "${meta}": JSON.stringify(fileMeta),
         "${transformedMetadata}": lazyTransformedMeta,
@@ -654,13 +669,19 @@ export async function generate({
       const pattern = /\$\{(title|menu|meta|transformedMetadata|body|styleLink|customScript|searchIndex|footer)\}/g;
       let finalHtml = template.replace(pattern, (match) => replacements[match] ?? match);
 
-      // If this page has a custom menu, add data attributes to body
+      // Add menu data attributes to body
       if (customMenuInfo) {
-        const menuPosition = customMenuInfo.menuPosition || 'side';
+        const menuPosition = customMenuInfo.menuPosition || 'top';
         finalHtml = finalHtml.replace(
           /<body([^>]*)>/,
           `<body$1 data-custom-menu="${customMenuInfo.menuJsonPath}" data-menu-position="${menuPosition}">`
         );
+      } else {
+        // No custom menu — default to top menu
+        finalHtml = finalHtml.replace(
+          /<body([^>]*)>/,
+          `<body$1 data-menu-position="top">`
+        );
       }
 
       // Resolve relative URLs in raw HTML elements (img src, etc.)
@@ -802,7 +823,7 @@ export async function generate({
     // Include menuPosition in the JSON so client knows how to render
     const customMenuJson = JSON.stringify({
       menuData: menuInfo.menuData,
-      menuPosition: menuInfo.menuPosition || 'side',
+      menuPosition: menuInfo.menuPosition || 'top',
     });
     progress.log(`Writing custom menu: ${menuInfo.menuJsonPath}`);
     await outputFile(customMenuPath, customMenuJson);
@@ -1027,6 +1048,9 @@ export async function generate({
   // Print profiler report
   progress.log(profiler.report());
   
+  // Terminate worker pool so threads don't keep the process alive
+  await terminateParserPool();
+
   // Return deferred processing promises if in deferred mode
   // Caller can await these to know when background processing is complete
   return {
@@ -1084,8 +1108,9 @@ export async function regenerateSingleFile(changedFile, {
       .replace(parse(changedFile).ext, ".html");
     const url = '/' + outputFilename.replace(output, '');
     
-    // Title from filename
-    const title = toTitleCase(base);
+    // Title from filename (for index/home, use parent folder name)
+    const titleBase = (base === 'index' || base === 'home') ? basename(dirname(changedFile)) : base;
+    const title = toTitleCase(titleBase || base);
     
     // Extract metadata
     const fileMeta = extractMetadata(rawBody);
@@ -1117,6 +1142,18 @@ export async function regenerateSingleFile(changedFile, {
         basename: base,
       });
     }
+
+    // Inject default H1 if body doesn't start with one
+    if (!body || !body.trimStart().startsWith('<h1')) {
+      const h1Title = fileMeta?.title || title;
+      body = `<h1>${h1Title}</h1>\n` + (body || '');
+    }
+
+    // Inject breadcrumbs before the H1
+    const breadcrumbs = generateBreadcrumbs(dir, base, fileMeta);
+    if (breadcrumbs) {
+      body = breadcrumbs + body;
+    }
     
     // Inject frontmatter table for markdown/mdx files
     if ((type === '.md' || type === '.mdx') && fileMeta) {
@@ -1191,7 +1228,7 @@ export async function regenerateSingleFile(changedFile, {
     // Build final HTML
     let finalHtml = template;
     const replacements = {
-      "${title}": title,
+      "${title}": fileMeta?.title || title,
       "${menu}": menu,
       "${meta}": JSON.stringify(fileMeta),
       "${transformedMetadata}": transformedMetadata,
@@ -1207,11 +1244,17 @@ export async function regenerateSingleFile(changedFile, {
 
     // If this page has a custom menu, add data attributes to body
     if (customMenuInfo) {
-      const menuPosition = customMenuInfo.menuPosition || 'side';
+      const menuPosition = customMenuInfo.menuPosition || 'top';
       finalHtml = finalHtml.replace(
         /<body([^>]*)>/,
         `<body$1 data-custom-menu="${customMenuInfo.menuJsonPath}" data-menu-position="${menuPosition}">`
       );
+    } else {
+      // No custom menu — default to top menu
+      finalHtml = finalHtml.replace(
+        /<body([^>]*)>/,
+        `<body$1 data-menu-position="top">`
+      );
     }
     
     // Resolve relative URLs in raw HTML elements (img src, etc.)