@aravindc26/velu 0.12.7 → 0.12.9

package/src/engine-core/lib/remark-plugins.ts

@@ -0,0 +1,102 @@
+/**
+ * Shared remark plugins used by both main engine and preview engine.
+ */
+
+const booleanMetaFlags = new Set([
+  'wrap',
+  'copy',
+  'nocopy',
+  'lineNumbers',
+  'linenumbers',
+  'showLineNumbers',
+]);
+
+function quoteTitle(value: string): string {
+  return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
+function ensureTitleMeta(meta: string): string {
+  const trimmed = meta.trim();
+  if (!trimmed) return trimmed;
+  if (/\btitle\s*=/.test(trimmed)) return trimmed;
+
+  const fileWithRest = trimmed.match(/^([^\s]+?\.[a-z0-9_-]+)(\s+.*)?$/i);
+  if (fileWithRest) {
+    const file = fileWithRest[1];
+    const rest = (fileWithRest[2] ?? '').trim();
+    return rest ? `title="${quoteTitle(file)}" ${rest}` : `title="${quoteTitle(file)}"`;
+  }
+
+  if (!trimmed.includes('=') && !trimmed.includes('{') && !trimmed.includes('}')) {
+    if (booleanMetaFlags.has(trimmed)) return trimmed;
+    return `title="${quoteTitle(trimmed)}"`;
+  }
+
+  return trimmed;
+}
+
+/**
+ * Remark plugin that converts Mint-style code fence metadata into
+ * standard title/highlight syntax that fumadocs understands.
+ *
+ * Handles:
+ * - ```lang filename.ext  →  title="filename.ext"
+ * - highlight=1 or highlight="1,3-5"  →  {1,3-5}
+ * - theme={null} removal
+ */
+export function remarkCodeFilenameToTitle() {
+  function visit(node: any) {
+    if (!node || typeof node !== 'object') return;
+
+    if (node.type === 'code' && typeof node.meta === 'string') {
+      let meta = node.meta.trim();
+      meta = ensureTitleMeta(meta);
+
+      const hlMatch = meta.match(/(?:^|\s)highlight=(?:"([^"]+)"|'([^']+)'|([^\s]+))/i);
+      if (hlMatch) {
+        const raw = (hlMatch[1] ?? hlMatch[2] ?? hlMatch[3] ?? '').trim();
+        const lineSpec = raw.replace(/[{}]/g, '');
+        meta = meta.replace(hlMatch[0], '').replace(/\s+/g, ' ').trim();
+        if (lineSpec && !/\{\s*\d[\d,\-\s]*\s*\}/.test(meta)) {
+          meta = `${meta} {${lineSpec}}`.trim();
+        }
+      }
+
+      meta = meta.replace(/\btheme=\{null\}\b/g, '').replace(/\s+/g, ' ').trim();
+      node.meta = meta;
+    }
+    if (node.type === 'code' && typeof node.meta !== 'string') {
+      return;
+    }
+
+    if (node.type === 'code' && node.meta === '') {
+      delete node.meta;
+    }
+
+    if (node.type === 'code' && typeof node.meta === 'string') {
+      node.meta = node.meta.trim();
+      if (!node.meta) {
+        delete node.meta;
+      }
+    }
+
+    const children = node.children;
+    if (Array.isArray(children)) {
+      for (const child of children) visit(child);
+    }
+  }
+
+  return (tree: any) => visit(tree);
+}
+
+/**
+ * Shared rehype code options for consistent syntax highlighting.
+ */
+export const sharedRehypeCodeOptions = {
+  lazy: false,
+  fallbackLanguage: 'bash',
+  langAlias: {
+    gradle: 'groovy',
+    proguard: 'properties',
+  },
+} as const;

package/src/engine-core/lib/source-plugins.ts

@@ -0,0 +1,105 @@
+/**
+ * Shared source loader plugins for fumadocs page tree transformations.
+ * Used by both main engine and preview engine.
+ */
+import { createElement } from 'react';
+import { statusBadgesPlugin } from 'fumadocs-core/source/status-badges';
+
+const OPENAPI_METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD', 'TRACE', 'WEBHOOK']);
+
+function methodBadgeClass(method: string): string {
+  const upper = method.toUpperCase();
+  if (upper === 'POST') return 'velu-openapi-method-badge velu-openapi-method-post';
+  if (upper === 'PUT') return 'velu-openapi-method-badge velu-openapi-method-put';
+  if (upper === 'PATCH') return 'velu-openapi-method-badge velu-openapi-method-patch';
+  if (upper === 'DELETE') return 'velu-openapi-method-badge velu-openapi-method-delete';
+  if (upper === 'WEBHOOK') return 'velu-openapi-method-badge velu-openapi-method-webhook';
+  return 'velu-openapi-method-badge velu-openapi-method-get';
+}
+
+function parseOperationReference(value: string, requireUppercaseMethod = false): { method: string; target: string } | null {
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  const withSpec = trimmed.match(/^(\S+)\s+([A-Za-z]+)\s+(.+)$/);
+  if (withSpec) {
+    const rawMethod = withSpec[2];
+    const method = withSpec[2].toUpperCase();
+    if (requireUppercaseMethod && rawMethod !== method) return null;
+    if (!OPENAPI_METHODS.has(method)) return null;
+    return { method, target: withSpec[3].trim() };
+  }
+  const noSpec = trimmed.match(/^([A-Za-z]+)\s+(.+)$/);
+  if (noSpec) {
+    const rawMethod = noSpec[1];
+    const method = noSpec[1].toUpperCase();
+    if (requireUppercaseMethod && rawMethod !== method) return null;
+    if (!OPENAPI_METHODS.has(method)) return null;
+    return { method, target: noSpec[2].trim() };
+  }
+  return null;
+}
+
+function stripMethodPrefix(name: string, method: string): string {
+  const regex = new RegExp(`^${method}\\s+`, 'i');
+  return name.replace(regex, '').trim();
+}
+
+export function openApiSidebarMethodBadgePlugin() {
+  return {
+    name: 'velu:openapi-sidebar-method-badge',
+    transformPageTree: {
+      file(node: Record<string, unknown>, filePath?: string) {
+        let data: Record<string, unknown> = {};
+        if (filePath) {
+          const file = (this as { storage?: { read?: (path: string) => unknown } }).storage?.read?.(filePath) as
+            | { format?: string; data?: Record<string, unknown> }
+            | undefined;
+          if (file?.format === 'page') data = file.data ?? {};
+        }
+
+        const nameCandidate = typeof node.name === 'string' ? node.name.trim() : '';
+        const titleCandidate = typeof data.title === 'string' ? data.title.trim() : '';
+        const openApiCandidate = typeof data.openapi === 'string' ? data.openapi.trim() : '';
+        const parsed = openApiCandidate
+          ? parseOperationReference(openApiCandidate)
+          : parseOperationReference(nameCandidate, true) ?? parseOperationReference(titleCandidate, true);
+        if (!parsed) return node;
+
+        const method = parsed.method;
+        const rawName = nameCandidate || titleCandidate || parsed.target;
+        const text = stripMethodPrefix(rawName, method) || parsed.target || rawName || method;
+        const stableIdRaw = filePath || openApiCandidate || rawName || `${method}-${parsed.target}`;
+        const stableId = stableIdRaw.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+
+        node.name = createElement(
+          'span',
+          { className: 'velu-openapi-sidebar-item', key: `openapi-item-${stableId || 'unknown'}` },
+          createElement(
+            'span',
+            { className: methodBadgeClass(method), key: `openapi-item-${stableId || 'unknown'}-method` },
+            method,
+          ),
+          createElement(
+            'span',
+            { className: 'velu-openapi-sidebar-label', key: `openapi-item-${stableId || 'unknown'}-label` },
+            text,
+          ),
+        );
+        return node;
+      },
+    },
+  };
+}
+
+export function createStatusBadgesPlugin() {
+  return statusBadgesPlugin({
+    renderBadge: (status: string) => {
+      const normalized = status.trim().toLowerCase();
+      const label = normalized === 'deprecated' ? 'Deprecated' : status;
+      const className = normalized === 'deprecated'
+        ? 'velu-status-badge velu-status-badge-deprecated'
+        : 'velu-status-badge';
+      return createElement('span', { className, 'data-status': normalized }, label);
+    },
+  });
+}