@aravindc26/velu 0.12.7 → 0.12.9

package/src/engine-core/types.ts

@@ -0,0 +1,49 @@
+export type VeluIconLibrary = 'fontawesome' | 'lucide' | 'tabler';
+
+export interface VeluDropdownOption {
+  dropdown: string;
+  slug: string;
+  description?: string;
+  icon?: string;
+  iconType?: string;
+  tabSlugs: string[];
+  defaultPath: string;
+}
+
+export interface VeluProductOption {
+  product: string;
+  slug: string;
+  description?: string;
+  icon?: string;
+  iconType?: string;
+  tabSlugs: string[];
+  defaultPath: string;
+}
+
+export interface VeluVersionOption {
+  version: string;
+  slug: string;
+  isDefault: boolean;
+  tabSlugs: string[];
+  defaultPath: string;
+}
+
+export interface VeluContextualOption {
+  id: string;
+  title: string;
+  description: string;
+  href?: string;
+  type: 'builtin' | 'custom';
+}
+
+export interface VeluAnchor {
+  anchor: string;
+  href?: string;
+  icon?: string;
+  iconType?: string;
+  color?: {
+    light: string;
+    dark: string;
+  };
+  hidden?: boolean;
+}

package/src/preview-engine/app/[sessionId]/[...slug]/page.tsx

@@ -1,41 +0,0 @@
-import { notFound } from 'next/navigation';
-import {
-  DocsBody,
-  DocsDescription,
-  DocsPage,
-  DocsTitle,
-} from 'fumadocs-ui/layouts/notebook/page';
-import { source } from '@/lib/source';
-
-interface PageProps {
-  params: Promise<{ sessionId: string; slug: string[] }>;
-}
-
-export default async function PreviewPage({ params }: PageProps) {
-  const { sessionId, slug } = await params;
-
-  // The full slug for fumadocs lookup includes the session ID prefix
-  const fullSlug = [sessionId, ...slug];
-  const page = source.getPage(fullSlug);
-
-  if (!page) notFound();
-
-  const pageDataRecord = page.data as unknown as Record<string, unknown>;
-  const MDX = pageDataRecord.body as any;
-  if (typeof MDX !== 'function') notFound();
-
-  return (
-    <DocsPage
-      toc={pageDataRecord.toc as any}
-      footer={{ enabled: false }}
-    >
-      <DocsTitle>{page.data.title}</DocsTitle>
-      {page.data.description ? (
-        <DocsDescription>{page.data.description}</DocsDescription>
-      ) : null}
-      <DocsBody>
-        <MDX />
-      </DocsBody>
-    </DocsPage>
-  );
-}

package/src/preview-engine/app/[sessionId]/layout.tsx

@@ -1,23 +0,0 @@
-import type { ReactNode } from 'react';
-import { DocsLayout } from 'fumadocs-ui/layouts/notebook';
-import { getSessionPageTree } from '@/lib/source';
-
-interface LayoutProps {
-  children: ReactNode;
-  params: Promise<{ sessionId: string }>;
-}
-
-export default async function SessionLayout({ children, params }: LayoutProps) {
-  const { sessionId } = await params;
-  const tree = getSessionPageTree(sessionId);
-
-  return (
-    <DocsLayout
-      tree={tree}
-      sidebar={{ collapsible: true }}
-      themeSwitch={{ enabled: false }}
-    >
-      {children}
-    </DocsLayout>
-  );
-}

package/src/preview-engine/app/global.css

@@ -1,3 +0,0 @@
-@import 'tailwindcss';
-@import 'fumadocs-ui/css/neutral.css';
-@import 'fumadocs-ui/css/preset.css';

package/src/preview-engine/lib/session-config.ts

@@ -1,86 +0,0 @@
-/**
- * Per-session configuration cache.
- * Reads docs.json from workspace directories and caches the parsed config.
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-const WORKSPACE_DIR = process.env.WORKSPACE_DIR || '/mnt/nfs_share/editor_sessions';
-const PRIMARY_CONFIG_NAME = 'docs.json';
-const LEGACY_CONFIG_NAME = 'velu.json';
-
-interface SessionConfig {
-  name?: string;
-  description?: string;
-  title?: string;
-  theme?: string;
-  colors?: { primary?: string; light?: string; dark?: string };
-  navigation: {
-    tabs?: any[];
-    languages?: any[];
-    anchors?: any[];
-    [key: string]: unknown;
-  };
-  languages?: string[];
-  openapi?: unknown;
-  [key: string]: unknown;
-}
-
-interface CachedSession {
-  config: SessionConfig;
-  rawConfig: Record<string, unknown>;
-  loadedAt: number;
-}
-
-const sessionCache = new Map<string, CachedSession>();
-const CACHE_TTL_MS = 60_000; // 1 minute
-
-function resolveWorkspaceConfigPath(sessionId: string): string | null {
-  const wsDir = join(WORKSPACE_DIR, sessionId);
-  const primary = join(wsDir, PRIMARY_CONFIG_NAME);
-  if (existsSync(primary)) return primary;
-  const legacy = join(wsDir, LEGACY_CONFIG_NAME);
-  if (existsSync(legacy)) return legacy;
-  return null;
-}
-
-export function getSessionConfig(sessionId: string): SessionConfig | null {
-  const cached = sessionCache.get(sessionId);
-  if (cached && Date.now() - cached.loadedAt < CACHE_TTL_MS) {
-    return cached.config;
-  }
-
-  const configPath = resolveWorkspaceConfigPath(sessionId);
-  if (!configPath) return null;
-
-  try {
-    const raw = JSON.parse(readFileSync(configPath, 'utf-8'));
-    const config = raw as SessionConfig;
-    sessionCache.set(sessionId, {
-      config,
-      rawConfig: raw,
-      loadedAt: Date.now(),
-    });
-    return config;
-  } catch {
-    return null;
-  }
-}
-
-export function getSessionRawConfig(sessionId: string): Record<string, unknown> | null {
-  getSessionConfig(sessionId); // ensure loaded
-  return sessionCache.get(sessionId)?.rawConfig ?? null;
-}
-
-export function clearSessionCache(sessionId: string): void {
-  sessionCache.delete(sessionId);
-}
-
-export function getWorkspaceDir(sessionId: string): string {
-  return join(WORKSPACE_DIR, sessionId);
-}
-
-export function getSiteName(sessionId: string): string {
-  const config = getSessionConfig(sessionId);
-  return config?.name || config?.title || 'Docs Preview';
-}

package/src/preview-engine/lib/source.ts

@@ -1,60 +0,0 @@
-import { loader } from 'fumadocs-core/source';
-import * as mdxCollections from 'fumadocs-mdx:collections/server';
-
-const docsCollection = (mdxCollections as { docs?: { toFumadocsSource?: () => unknown } }).docs;
-
-if (!docsCollection?.toFumadocsSource) {
-  throw new Error('MDX collections are not ready yet. Please retry in a moment.');
-}
-
-export const source = loader({
-  baseUrl: '/',
-  source: docsCollection.toFumadocsSource() as any,
-});
-
-/**
- * Get the page tree filtered to a specific session's content.
- * The content directory has files at {sessionId}/{slug}.mdx,
- * so the page tree has top-level folders per session.
- */
-export function getSessionPageTree(sessionId: string) {
-  const fullTree = source.getPageTree();
-  const children = Array.isArray(fullTree.children) ? fullTree.children : [];
-
-  // Find the root folder matching this session ID
-  const sessionFolder = children.find((child: any) => {
-    if (child?.type !== 'folder') return false;
-    // The folder's URL or name should match the session ID
-    const urls = collectUrls(child);
-    for (const url of urls) {
-      const firstSegment = url.replace(/^\/+/, '').split('/')[0];
-      if (firstSegment === sessionId) return true;
-    }
-    return false;
-  }) as any;
-
-  if (sessionFolder && Array.isArray(sessionFolder.children)) {
-    return { ...fullTree, children: sessionFolder.children };
-  }
-
-  // Fallback: filter children by URL prefix
-  const filtered = children.filter((child: any) => {
-    const urls = collectUrls(child);
-    return urls.some((url: string) => {
-      const segments = url.replace(/^\/+/, '').split('/');
-      return segments[0] === sessionId;
-    });
-  });
-
-  return { ...fullTree, children: filtered };
-}
-
-function collectUrls(node: any, out: string[] = []): string[] {
-  if (!node || typeof node !== 'object') return out;
-  if (typeof node.url === 'string') out.push(node.url);
-  if (node.index && typeof node.index.url === 'string') out.push(node.index.url);
-  if (Array.isArray(node.children)) {
-    for (const child of node.children) collectUrls(child, out);
-  }
-  return out;
-}

package/src/preview-engine/next.config.mjs

@@ -1,20 +0,0 @@
-import { resolve } from 'node:path';
-import { createMDX } from 'fumadocs-mdx/next';
-
-const withMDX = createMDX({
-  configPath: './source.config.ts',
-});
-
-/** @type {import('next').NextConfig} */
-const config = {
-  reactStrictMode: false,
-  devIndicators: false,
-  turbopack: {
-    root: '/',
-  },
-  images: {
-    unoptimized: true,
-  },
-};
-
-export default withMDX(config);

package/src/preview-engine/postcss.config.mjs

@@ -1,8 +0,0 @@
-import { createRequire } from 'node:module';
-const require = createRequire(import.meta.url);
-
-export default {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-};

package/src/preview-engine/source.config.ts

@@ -1,26 +0,0 @@
-import { defineConfig, defineDocs } from 'fumadocs-mdx/config';
-import { metaSchema, pageSchema } from 'fumadocs-core/source/schema';
-
-// Content directory: NFS-backed preview_content root.
-// Each session writes to {PREVIEW_CONTENT_DIR}/{sessionId}/.
-// fumadocs scans the entire directory; routes filter by session.
-const contentDir = process.env.PREVIEW_CONTENT_DIR || './content';
-
-export const docs = defineDocs({
-  dir: contentDir,
-  docs: {
-    schema: pageSchema,
-  },
-  meta: {
-    schema: metaSchema,
-  },
-});
-
-export default defineConfig({
-  mdxOptions: {
-    rehypeCodeOptions: ({
-      lazy: false,
-      fallbackLanguage: 'bash',
-    } as any),
-  },
-});

package/src/preview-engine/tsconfig.json

@@ -1,32 +0,0 @@
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "target": "ESNext",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "incremental": true,
-    "paths": {
-      "@/*": ["./*"],
-      "fumadocs-mdx:collections/*": [".source/*"]
-    },
-    "plugins": [{ "name": "next" }]
-  },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts",
-    ".next/dev/types/**/*.ts"
-  ],
-  "exclude": ["node_modules"]
-}