@lexibase/rdx-next 1.0.0-beta.2 → 1.0.0-beta.4

package/bin/rdx.mjs

@@ -2,11 +2,14 @@
 
 import { spawn } from 'node:child_process'
 import { createRequire } from 'node:module'
-import { cp, mkdir } from 'node:fs/promises'
+import { access, cp, mkdir } from 'node:fs/promises'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import process from 'node:process'
 
+import { createRdxProject } from '@lexibase/rdx-core/config'
+import { createJiti } from 'jiti'
+
 const supportedCommands = new Set(['dev', 'build', 'start'])
 const command = process.argv[2]
 const commandArgs = process.argv.slice(3)
@@ -23,28 +26,86 @@ async function prepareRuntime() {
   await cp(runtimeTemplate, runtimeDirectory, { force: true, recursive: true })
 }
 
-if (command === 'prepare') {
-  await prepareRuntime()
-  console.log('RDX runtime prepared in .rdx/')
-  process.exit(0)
-}
+async function main() {
+  if (!command || command === 'help' || command === '--help') {
+    console.log('Usage: rdx <dev|build|start|prepare|plugin-command>')
+    console.log(
+      'Plugin commands are registered through plugins in rdx.config.ts.'
+    )
+    return
+  }
 
-if (!command || !supportedCommands.has(command)) {
-  console.error('Usage: rdx <dev|build|start|prepare>')
-  process.exit(1)
-}
+  const configPath = path.join(projectRoot, 'rdx.config.ts')
+  try {
+    await access(configPath)
+  } catch {
+    throw new Error(
+      `Missing ${configPath}. Run rdx from the documentation project root.`
+    )
+  }
 
-await prepareRuntime()
+  const jiti = createJiti(import.meta.url, {
+    moduleCache: false,
+    fsCache: false,
+  })
+  let input
+  try {
+    input = await jiti.import(configPath, { default: true })
+  } catch (error) {
+    const hint =
+      error.code === 'MODULE_NOT_FOUND' || error.code === 'ERR_MODULE_NOT_FOUND'
+        ? ' If a configured plugin cannot be resolved, install its package in this project.'
+        : ''
+    throw new Error(`Could not load rdx.config.ts: ${error.message}${hint}`)
+  }
 
-const projectRequire = createRequire(path.join(projectRoot, 'package.json'))
-const nextCli = projectRequire.resolve('next/dist/bin/next')
-const child = spawn(
-  process.execPath,
-  [nextCli, command, runtimeDirectory, ...commandArgs],
-  { cwd: projectRoot, stdio: 'inherit' }
-)
+  const project = await createRdxProject(input, {
+    rootDir: projectRoot,
+    command,
+  })
+  if (command === 'prepare') {
+    await prepareRuntime()
+    console.log('RDX runtime prepared in .rdx/')
+    return
+  }
+  if (!supportedCommands.has(command)) {
+    const pluginCommand = project.commands.find(
+      (entry) => entry.name === command
+    )
+    if (!pluginCommand)
+      throw new Error(
+        `Unknown command "${command}". Available: dev, build, start, prepare${project.commands.map((entry) => `, ${entry.name}`).join('')}. Install and configure the plugin that provides this command.`
+      )
+    await pluginCommand.run({
+      rootDir: projectRoot,
+      config: project.config,
+      command,
+      args: commandArgs,
+    })
+    return
+  }
 
-child.on('exit', (code, signal) => {
-  if (signal) process.kill(process.pid, signal)
-  process.exit(code ?? 1)
-})
+  await prepareRuntime()
+  const projectRequire = createRequire(path.join(projectRoot, 'package.json'))
+  const nextCli = projectRequire.resolve('next/dist/bin/next')
+  const child = spawn(
+    process.execPath,
+    [nextCli, command, runtimeDirectory, ...commandArgs],
+    { cwd: projectRoot, stdio: 'inherit' }
+  )
+  child.on('error', (error) => {
+    console.error(`[RDX] Could not start Next.js: ${error.message}`)
+    process.exitCode = 1
+  })
+  child.on('exit', (code, signal) => {
+    if (signal) process.kill(process.pid, signal)
+    process.exit(code ?? 1)
+  })
+}
+
+try {
+  await main()
+} catch (error) {
+  console.error(`[RDX] ${error.message}`)
+  process.exitCode = 1
+}

package/dist/index.d.ts

@@ -1 +1,2 @@
-export { RdxRuntimeConfig } from '@lexibase/rdx-types';
+export { defineConfig } from '@lexibase/rdx-core/config';
+export { RdxConfig, RdxPlugin, RdxPluginContext, RdxRuntimeConfig } from '@lexibase/rdx-types';

package/dist/index.js

@@ -0,0 +1,5 @@
+// src/index.ts
+import { defineConfig } from "@lexibase/rdx-core/config";
+export {
+  defineConfig
+};

package/dist/runtime/index.d.ts

@@ -1,14 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-export { getDocsPaths } from '@lexibase/rdx-core';
-import { RdxRuntimeConfig } from '@lexibase/rdx-types';
+import { RdxProject, RdxRuntimeConfig } from '@lexibase/rdx-types';
+export { createRdxProject, getProjectDocsPaths } from '@lexibase/rdx-core';
 
 declare function RdxLayout({ children, config, }: {
     children: ReactNode;
     config: RdxRuntimeConfig;
 }): react_jsx_runtime.JSX.Element;
-declare function DocsPage({ slug }: {
+declare function DocsPage({ slug, project, }: {
     slug?: string[];
+    project: RdxProject;
 }): Promise<react_jsx_runtime.JSX.Element>;
 
 export { DocsPage, RdxLayout };

package/dist/runtime/index.js

@@ -1,9 +1,14 @@
 // src/runtime/index.tsx
-import { getDocument, getDocsIndex, getDocsPaths } from "@lexibase/rdx-core";
-import { getDocsPaths as getDocsPaths2 } from "@lexibase/rdx-core";
+import {
+  getDocument,
+  getDocsPaths,
+  getSourceOptions,
+  resolveDocsRoute
+} from "@lexibase/rdx-core";
 import { compileMDX } from "next-mdx-remote/rsc";
 import Link from "next/link";
 import { notFound } from "next/navigation";
+import { createRdxProject, getProjectDocsPaths } from "@lexibase/rdx-core";
 import { jsx, jsxs } from "react/jsx-runtime";
 var mdxComponents = {
   h1: (props) => /* @__PURE__ */ jsx("h1", { ...props }),
@@ -33,34 +38,47 @@ function RdxLayout({
   children,
   config
 }) {
-  const brand = config.navbar?.title || config.title;
-  return /* @__PURE__ */ jsx("html", { lang: "en", children: /* @__PURE__ */ jsxs("body", { children: [
-    /* @__PURE__ */ jsxs("header", { className: "rdx-header", children: [
-      /* @__PURE__ */ jsx(Link, { className: "rdx-brand", href: "/docs", children: brand }),
-      config.navbar?.actions?.github?.visible && config.navbar.actions.github.url && /* @__PURE__ */ jsx(
-        "a",
-        {
-          className: "rdx-github-link",
-          href: config.navbar.actions.github.url,
-          rel: "noreferrer",
-          target: "_blank",
-          children: "GitHub"
-        }
-      )
-    ] }),
-    children
-  ] }) });
+  const brand = config.navbar?.title ?? config.title;
+  return /* @__PURE__ */ jsx(
+    "html",
+    {
+      lang: config.lang ?? "en",
+      "data-theme": config.theme?.defaultTheme ?? "system",
+      children: /* @__PURE__ */ jsxs("body", { children: [
+        /* @__PURE__ */ jsxs("header", { className: "rdx-header", children: [
+          /* @__PURE__ */ jsx(Link, { className: "rdx-brand", href: "/docs", "aria-label": config.title, children: brand }),
+          config.navbar?.actions?.github?.visible && config.navbar.actions.github.url && /* @__PURE__ */ jsx(
+            "a",
+            {
+              className: "rdx-github-link",
+              href: config.navbar.actions.github.url,
+              rel: "noreferrer",
+              target: "_blank",
+              children: "GitHub"
+            }
+          )
+        ] }),
+        children
+      ] })
+    }
+  );
 }
-async function DocsPage({ slug }) {
-  const categories = getDocsIndex();
-  const currentSlug = slug?.join("/") || getDocsPaths()[0];
+async function DocsPage({
+  slug,
+  project
+}) {
+  const {
+    source,
+    slug: currentSlug,
+    document,
+    categories
+  } = resolveDocsRoute(project, slug);
   if (!currentSlug) {
     return /* @__PURE__ */ jsxs("main", { className: "rdx-empty-state", children: [
       /* @__PURE__ */ jsx("h1", { children: "Your documentation is ready." }),
       /* @__PURE__ */ jsx("p", { children: "Add an `.mdx` file inside `docs/` to create your first page." })
     ] });
   }
-  const document = getDocument(currentSlug);
   if (!document) notFound();
   const { content } = await compileMDX({
     source: document.content,
@@ -69,24 +87,44 @@ async function DocsPage({ slug }) {
   const title = typeof document.frontmatter.title === "string" ? document.frontmatter.title : currentSlug;
   const description = typeof document.frontmatter.description === "string" ? document.frontmatter.description : null;
   return /* @__PURE__ */ jsxs("div", { className: "rdx-docs-layout", children: [
-    /* @__PURE__ */ jsx("aside", { className: "rdx-sidebar", "aria-label": "Documentation navigation", children: categories.map((category) => /* @__PURE__ */ jsxs("section", { className: "rdx-sidebar-category", children: [
-      /* @__PURE__ */ jsx("h2", { children: category.title }),
-      /* @__PURE__ */ jsx("ul", { children: category.pages.map((page) => {
-        const href = `/docs/${page.slug}`;
-        const isCurrentPage = page.slug === currentSlug;
-        return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+    /* @__PURE__ */ jsxs("aside", { className: "rdx-sidebar", "aria-label": "Documentation navigation", children: [
+      project.sources.length > 1 && /* @__PURE__ */ jsx("nav", { className: "rdx-editions", "aria-label": "Documentation editions", children: project.sources.map((edition) => {
+        const options = getSourceOptions(project, edition);
+        const destination = getDocument(currentSlug, options) ? currentSlug : getDocsPaths(options)[0];
+        const href = ["/docs", edition.routePrefix, destination].filter(Boolean).join("/");
+        return /* @__PURE__ */ jsxs(
           Link,
           {
-            "aria-current": isCurrentPage ? "page" : void 0,
-            className: isCurrentPage ? "is-active" : void 0,
             href,
-            children: page.title
-          }
-        ) }, page.slug);
-      }) })
-    ] }, category.id)) }),
+            "aria-current": edition.id === source.id ? "page" : void 0,
+            children: [
+              edition.label,
+              edition.badge ? ` (${edition.badge})` : ""
+            ]
+          },
+          edition.id
+        );
+      }) }),
+      categories.map((category) => /* @__PURE__ */ jsxs("section", { className: "rdx-sidebar-category", children: [
+        /* @__PURE__ */ jsx("h2", { children: category.title }),
+        /* @__PURE__ */ jsx("ul", { children: category.pages.map((page) => {
+          const href = ["/docs", source.routePrefix, page.slug].filter(Boolean).join("/");
+          const isCurrentPage = page.slug === currentSlug;
+          return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+            Link,
+            {
+              "aria-current": isCurrentPage ? "page" : void 0,
+              className: isCurrentPage ? "is-active" : void 0,
+              href,
+              children: page.title
+            }
+          ) }, page.slug);
+        }) })
+      ] }, category.id))
+    ] }),
     /* @__PURE__ */ jsxs("main", { className: "rdx-document", children: [
       /* @__PURE__ */ jsxs("header", { className: "rdx-document-header", children: [
+        source.badge && /* @__PURE__ */ jsx("p", { className: "rdx-source-badge", children: source.badge }),
         /* @__PURE__ */ jsx("p", { className: "rdx-breadcrumb", children: currentSlug }),
         /* @__PURE__ */ jsx("h1", { children: title }),
         description && /* @__PURE__ */ jsx("p", { className: "rdx-description", children: description })
@@ -98,5 +136,6 @@ async function DocsPage({ slug }) {
 export {
   DocsPage,
   RdxLayout,
-  getDocsPaths2 as getDocsPaths
+  createRdxProject,
+  getProjectDocsPaths
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexibase/rdx-next",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "description": "The Next.js runtime for RDX documentation projects.",
   "license": "MIT",
   "type": "module",
@@ -24,9 +24,10 @@
     "README.md"
   ],
   "dependencies": {
+    "jiti": "^2.6.1",
     "next-mdx-remote": "^5.0.0",
-    "@lexibase/rdx-types": "1.0.0-beta.0",
-    "@lexibase/rdx-core": "1.0.0-beta.0"
+    "@lexibase/rdx-types": "1.0.0-beta.2",
+    "@lexibase/rdx-core": "1.0.0-beta.2"
   },
   "peerDependencies": {
     "next": "^15.5.0",
@@ -54,12 +55,13 @@
     "react": "19.1.0",
     "react-dom": "19.1.0",
     "typescript": "5.9.2",
-    "@rdx/eslint-config": "1.0.0",
-    "@rdx/typescript-config": "1.0.0"
+    "@rdx/typescript-config": "1.0.0",
+    "@rdx/eslint-config": "1.0.0"
   },
   "scripts": {
     "build": "tsup src/index.ts src/runtime/index.tsx --format esm --dts --clean --external @lexibase/rdx-core --external @lexibase/rdx-types --external next --external react --external react-dom --external next-mdx-remote",
     "lint": "eslint . --max-warnings 0",
-    "check-types": "tsc --noEmit"
+    "check-types": "tsc --noEmit",
+    "test": "node --test tests/*.test.mjs"
   }
 }

package/templates/runtime/app/docs/[[...slug]]/page.tsx

@@ -1,7 +1,11 @@
-import { DocsPage, getDocsPaths } from '@lexibase/rdx-next/runtime'
+import { DocsPage, getProjectDocsPaths } from '@lexibase/rdx-next/runtime'
 
-export function generateStaticParams() {
-  return getDocsPaths().map((slug) => ({ slug: slug.split('/') }))
+import { getProject } from '../../../rdx-project'
+
+export async function generateStaticParams() {
+  return getProjectDocsPaths(await getProject()).map((slug) => ({
+    slug: slug.split('/'),
+  }))
 }
 
 export default async function DocumentationPage({
@@ -11,5 +15,5 @@ export default async function DocumentationPage({
 }) {
   const { slug } = await params
 
-  return <DocsPage slug={slug} />
+  return <DocsPage slug={slug} project={await getProject()} />
 }

package/templates/runtime/app/globals.css

@@ -8,7 +8,7 @@
 }
 
 @media (prefers-color-scheme: dark) {
-  :root {
+  :root:not([data-theme='light']) {
     --rdx-background: #121212;
     --rdx-foreground: #f4f4f5;
     --rdx-muted: #a1a1aa;
@@ -18,6 +18,26 @@
   }
 }
 
+:root[data-theme='dark'] {
+  --rdx-background: #121212;
+  --rdx-foreground: #f4f4f5;
+  --rdx-muted: #a1a1aa;
+  --rdx-border: #303033;
+  --rdx-accent: #202022;
+  --rdx-link: #7bb0ff;
+}
+
+.rdx-editions {
+  border-bottom: 1px solid var(--rdx-border);
+  margin-bottom: 20px;
+  padding-bottom: 20px;
+}
+
+.rdx-source-badge {
+  color: var(--rdx-muted);
+  font-size: 0.85rem;
+}
+
 * {
   box-sizing: border-box;
 }

package/templates/runtime/app/layout.tsx

@@ -2,20 +2,21 @@ import type { Metadata } from 'next'
 
 import { RdxLayout } from '@lexibase/rdx-next/runtime'
 
-import config from '../../rdx.config'
+import { getProject } from '../rdx-project'
 
 import './globals.css'
 
-export const metadata: Metadata = {
-  title: {
-    default: config.title,
-    template: `%s | ${config.title}`,
-  },
-  description: config.description,
+export async function generateMetadata(): Promise<Metadata> {
+  const { config } = await getProject()
+  return {
+    title: { default: config.title, template: `%s | ${config.title}` },
+    description: config.description,
+  }
 }
 
-export default function RootLayout({
+export default async function RootLayout({
   children,
 }: Readonly<{ children: React.ReactNode }>) {
+  const { config } = await getProject()
   return <RdxLayout config={config}>{children}</RdxLayout>
 }

package/templates/runtime/rdx-project.ts

@@ -0,0 +1,7 @@
+import { createRdxProject } from '@lexibase/rdx-next/runtime'
+
+import config from '../rdx.config'
+
+export function getProject() {
+  return createRdxProject(config)
+}

package/templates/runtime/tsconfig.json

@@ -2,6 +2,8 @@
   "compilerOptions": {
     "allowJs": true,
     "esModuleInterop": true,
+    "incremental": true,
+    "isolatedModules": true,
     "jsx": "preserve",
     "lib": ["dom", "dom.iterable", "esnext"],
     "module": "esnext",
@@ -9,6 +11,7 @@
     "noEmit": true,
     "plugins": [{ "name": "next" }],
     "resolveJsonModule": true,
+    "skipLibCheck": true,
     "strict": true,
     "target": "esnext"
   },