@gsa-tts/graymatter-ui 0.3.13 → 0.3.15

package/src/utils/generateApiNavData.ts

@@ -0,0 +1,113 @@
+import type { SubNavData } from '../types/subnav.js';
+
+// Interface for API documentation metadata
+export interface ApiDocMetadata {
+  id: string;
+  slug: string;
+  title: string;
+  description: string;
+  sortOrder: number;
+  content?: string; // Raw MDX content for heading extraction
+}
+
+// Interface for navigation items with recursive children
+interface NavItem {
+  id: string;
+  title: string;
+  href: string;
+  children: NavItem[];
+}
+
+// Extract headings from MDX content
+function extractHeadings(content: string) {
+  const headingRegex = /^(#{1,6})\s+(.+)$/gm;
+  const headings: Array<{ level: number; text: string; id: string }> = [];
+  let match;
+
+  while ((match = headingRegex.exec(content)) !== null) {
+    const level = match[1]?.length || 0;
+    const text = match[2]?.trim() || '';
+    // Create a simple ID from the heading text
+    const id = text
+      .toLowerCase()
+      .replace(/[^a-z0-9\s-]/g, '')
+      .replace(/\s+/g, '-');
+    headings.push({ level, text, id });
+  }
+
+  return headings;
+}
+
+// Convert headings to nested navigation structure
+function headingsToNavItems(
+  headings: Array<{ level: number; text: string; id: string }>
+): NavItem[] {
+  const items: NavItem[] = [];
+  const stack: Array<NavItem & { level: number }> = [];
+
+  headings.forEach(heading => {
+    const item = {
+      id: heading.id,
+      title: heading.text,
+      href: `#${heading.id}`,
+      children: [],
+    };
+
+    // Find the correct parent level
+    while (stack.length > 0) {
+      const lastItem = stack[stack.length - 1];
+      if (lastItem && lastItem.level >= heading.level) {
+        stack.pop();
+      } else {
+        break;
+      }
+    }
+
+    if (stack.length === 0) {
+      // Top level item
+      items.push(item);
+    } else {
+      // Nested item
+      const parent = stack[stack.length - 1];
+      if (parent) {
+        parent.children.push(item);
+      }
+    }
+
+    stack.push({ ...item, level: heading.level });
+  });
+
+  return items;
+}
+
+// Generate navigation data dynamically from API documentation metadata
+export function generateApiDocumentationNavData(
+  apiDocs: ApiDocMetadata[]
+): SubNavData {
+  // Sort by sortOrder
+  const sortedDocs = [...apiDocs].sort((a, b) => a.sortOrder - b.sortOrder);
+
+  // Convert to navigation items with dynamic heading extraction
+  const items = sortedDocs.map(doc => {
+    // Extract headings from content if provided
+    const children = doc.content
+      ? headingsToNavItems(extractHeadings(doc.content))
+      : [];
+
+    return {
+      id: doc.slug,
+      title: doc.title,
+      href: `/api/documentation#${doc.slug}`,
+      children,
+    };
+  });
+
+  return {
+    sections: [
+      {
+        header: 'API Documentation',
+        items,
+      },
+    ],
+  };
+}

package/src/utils/index.ts

@@ -1,2 +1,4 @@
 export * from './getAppUrls.js';
 export * from './navigationControl.js';
+export * from './copyButtonScript.js';
+export * from './generateApiNavData.js';