@kenjura/ursa 0.43.0 → 0.44.0

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 0.44.0
+2025-12-16
+
+- Added 'sections' metadata property with hierarchical section structure
+
 # 0.43.0
 2025-12-14
 

package/package.json

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

package/src/helper/sectionExtractor.js

@@ -0,0 +1,76 @@
+/**
+ * Extract sections from markdown content based on headings
+ * Creates a hierarchical structure of sections
+ */
+
+/**
+ * Extract sections from markdown content
+ * @param {string} content - The markdown content
+ * @returns {Array} Array of section objects with name and optional children
+ */
+export function extractSections(content) {
+  if (!content) return [];
+  
+  // Match all markdown headings (# to ######)
+  // Handles both "# Heading" and "#Heading" formats
+  const headingRegex = /^(#{1,6})\s*(.+?)$/gm;
+  
+  const headings = [];
+  let match;
+  
+  while ((match = headingRegex.exec(content)) !== null) {
+    const level = match[1].length; // Number of # characters
+    const name = match[2].trim();
+    headings.push({ level, name });
+  }
+  
+  if (headings.length === 0) return [];
+  
+  // Build hierarchical structure
+  return buildSectionTree(headings);
+}
+
+/**
+ * Build a hierarchical tree from flat heading list
+ * @param {Array} headings - Array of {level, name} objects
+ * @returns {Array} Hierarchical section tree
+ */
+function buildSectionTree(headings) {
+  const root = { level: 0, children: [] };
+  const stack = [root];
+  
+  for (const heading of headings) {
+    const section = { name: heading.name, level: heading.level, children: [] };
+    
+    // Pop stack until we find a parent with lower level
+    while (stack.length > 1 && stack[stack.length - 1].level >= heading.level) {
+      stack.pop();
+    }
+    
+    // Add to parent's children
+    const parent = stack[stack.length - 1];
+    parent.children.push(section);
+    
+    // Push this section onto stack (it might have children)
+    stack.push(section);
+  }
+  
+  // Clean up: remove level and empty children arrays
+  cleanupTree(root.children);
+  
+  return root.children;
+}
+
+/**
+ * Remove level property and empty children arrays from the tree
+ */
+function cleanupTree(sections) {
+  for (const section of sections) {
+    delete section.level;
+    if (section.children && section.children.length > 0) {
+      cleanupTree(section.children);
+    } else {
+      delete section.children;
+    }
+  }
+}

package/src/jobs/generate.js

@@ -21,6 +21,7 @@ import {
   markInactiveLinks,
 } from "../helper/linkValidator.js";
 import { getAndIncrementBuildId } from "../helper/ursaConfig.js";
+import { extractSections } from "../helper/sectionExtractor.js";
 
 // Helper function to build search index from processed files
 function buildSearchIndex(jsonCache, source, output) {
@@ -230,12 +231,16 @@ export async function generate({
             dirname: dir,
             basename: base,
           });
+          // Extract sections for markdown files
+          const sections = type === '.md' ? extractSections(rawBody) : [];
+          
           jsonCache.set(file, {
             name: base,
             url,
             contents: rawBody,
             bodyHtml: body,
             metadata: meta,
+            sections,
             transformedMetadata: '',
           });
           return; // Skip regenerating this file
@@ -307,6 +312,10 @@ export async function generate({
         // json
 
         const jsonOutputFilename = outputFilename.replace(".html", ".json");
+        
+        // Extract sections for markdown files
+        const sections = type === '.md' ? extractSections(rawBody) : [];
+        
         const jsonObject = {
           name: base,
           url,
@@ -314,6 +323,7 @@ export async function generate({
           // bodyLessMeta: bodyLessMeta,
           bodyHtml: body,
           metadata: meta,
+          sections,
           transformedMetadata,
           // html: finalHtml,
         };