@lexibase/rdx-next 1.0.1 → 1.2.0

package/README.md

@@ -2,6 +2,11 @@
 
 The official Next.js runtime for RDX documentation projects.
 
+Generated projects use the main `@lexibase/rdx` package. This adapter remains
+available for advanced integrations. It declares the shared UI as a compatible
+peer dependency rather than owning a fixed UI copy. The main package supplies
+the selected UI; direct adapter consumers must install a compatible UI themselves.
+
 Requires Node.js 22.18+ (22.x) or 24.11+ (24.x). Use the latest patch of either line.
 The MDX renderer keeps JavaScript expression blocking enabled. Markdown, fenced
 code and registered JSX components with literal props remain supported, but

package/bin/cli.d.mts

@@ -0,0 +1,2 @@
+/** Run the adapter CLI with an optional prepared runtime template directory. */
+export function runRdxCli(options?: { templateDir?: string }): Promise<void>

package/bin/cli.mjs

@@ -0,0 +1,129 @@
+import { spawn } from 'node:child_process'
+import { createRequire } from 'node:module'
+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'
+
+import { preparePublicAssets } from './public-assets.mjs'
+
+export async function runRdxCli({ templateDir } = {}) {
+  const supportedCommands = new Set(['dev', 'build', 'start'])
+  let command = process.argv[2]
+  const commandArgs = process.argv.slice(3)
+  const projectRoot = process.cwd()
+  const packageRoot = path.resolve(
+    path.dirname(fileURLToPath(import.meta.url)),
+    '..'
+  )
+  const runtimeTemplate =
+    templateDir ?? path.join(packageRoot, 'templates', 'runtime')
+  const runtimeDirectory = path.join(projectRoot, '.rdx')
+
+  async function prepareRuntime() {
+    await mkdir(runtimeDirectory, { recursive: true })
+    await preparePublicAssets(projectRoot, runtimeDirectory)
+    await cp(runtimeTemplate, runtimeDirectory, {
+      force: true,
+      recursive: true,
+    })
+  }
+
+  async function main() {
+    if (!command || command === 'help' || command === '--help') {
+      console.log('Usage: rdx <dev|build|start|prepare|add|plugin-command>')
+      console.log('  rdx add versioning [--package-manager npm|pnpm|yarn]')
+      console.log(
+        'Plugin commands are registered through plugins in rdx.config.ts.'
+      )
+      return
+    }
+
+    if (command === 'add') {
+      const { addVersioning, parseAddArguments } =
+        await import('./add-plugin.mjs')
+      const options = parseAddArguments(commandArgs)
+      await addVersioning(projectRoot, options)
+      command = 'prepare'
+    }
+
+    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.`
+      )
+    }
+
+    const jiti = createJiti(import.meta.url, {
+      moduleCache: false,
+      fsCache: false,
+      jsx: { runtime: 'automatic' },
+    })
+    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 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, add${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
+    }
+
+    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/bin/plugin-config.mjs

@@ -36,7 +36,11 @@ export function activateVersioning(source) {
         if (specifier.isTypeOnly) continue
         const imported = (specifier.propertyName ?? specifier.name).text
         if (
-          ['@lexibase/rdx-next', '@lexibase/rdx-core/config'].includes(name) &&
+          [
+            '@lexibase/rdx',
+            '@lexibase/rdx-next',
+            '@lexibase/rdx-core/config',
+          ].includes(name) &&
           imported === 'defineConfig'
         )
           definitions.add(specifier.name.text)

package/bin/rdx.mjs

@@ -1,124 +1,5 @@
 #!/usr/bin/env node
 
-import { spawn } from 'node:child_process'
-import { createRequire } from 'node:module'
-import { access, cp, mkdir } from 'node:fs/promises'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import process from 'node:process'
+import { runRdxCli } from './cli.mjs'
 
-import { createRdxProject } from '@lexibase/rdx-core/config'
-import { createJiti } from 'jiti'
-
-import { preparePublicAssets } from './public-assets.mjs'
-
-const supportedCommands = new Set(['dev', 'build', 'start'])
-let command = process.argv[2]
-const commandArgs = process.argv.slice(3)
-const projectRoot = process.cwd()
-const packageRoot = path.resolve(
-  path.dirname(fileURLToPath(import.meta.url)),
-  '..'
-)
-const runtimeTemplate = path.join(packageRoot, 'templates', 'runtime')
-const runtimeDirectory = path.join(projectRoot, '.rdx')
-
-async function prepareRuntime() {
-  await mkdir(runtimeDirectory, { recursive: true })
-  await preparePublicAssets(projectRoot, runtimeDirectory)
-  await cp(runtimeTemplate, runtimeDirectory, { force: true, recursive: true })
-}
-
-async function main() {
-  if (!command || command === 'help' || command === '--help') {
-    console.log('Usage: rdx <dev|build|start|prepare|add|plugin-command>')
-    console.log('  rdx add versioning [--package-manager npm|pnpm|yarn]')
-    console.log(
-      'Plugin commands are registered through plugins in rdx.config.ts.'
-    )
-    return
-  }
-
-  if (command === 'add') {
-    const { addVersioning, parseAddArguments } =
-      await import('./add-plugin.mjs')
-    const options = parseAddArguments(commandArgs)
-    await addVersioning(projectRoot, options)
-    command = 'prepare'
-  }
-
-  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.`
-    )
-  }
-
-  const jiti = createJiti(import.meta.url, {
-    moduleCache: false,
-    fsCache: false,
-    jsx: { runtime: 'automatic' },
-  })
-  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 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, add${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
-  }
-
-  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
-}
+await runRdxCli()

package/config.d.mts

@@ -1,3 +1,6 @@
+/** Common build root for the documentation project and its installed Next.js. */
+export function getRdxBuildRoot(rootDir: string): Promise<string>
+
 /** Explicit deployment files for a native Next.js application using RDX. */
 export function getRdxTracingConfig(options: {
   rootDir: string

package/config.mjs

@@ -1,9 +1,35 @@
-import { readdir, stat } from 'node:fs/promises'
+import { readdir, realpath, stat } from 'node:fs/promises'
+import { createRequire } from 'node:module'
 import path from 'node:path'
 
 import { createRdxProject, resolveProjectPath } from '@lexibase/rdx-core/config'
 import { createJiti } from 'jiti'
 
+/** Include the project and the real Next.js installation in Turbopack's root. */
+export async function getRdxBuildRoot(rootDir) {
+  const projectRoot = await realpath(path.resolve(rootDir))
+  const require = createRequire(path.join(projectRoot, 'package.json'))
+  const nextRoot = path.dirname(
+    await realpath(require.resolve('next/package.json'))
+  )
+  let root = projectRoot
+  while (true) {
+    const relative = path.relative(root, nextRoot)
+    if (
+      !path.isAbsolute(relative) &&
+      relative !== '..' &&
+      !relative.startsWith(`..${path.sep}`)
+    )
+      return root
+    const parent = path.dirname(root)
+    if (parent === root || parent === path.parse(parent).root)
+      throw new Error(
+        'RDX could not determine a bounded build root. Install Next.js inside the project or its workspace.'
+      )
+    root = parent
+  }
+}
+
 // These files are enumerated by Next's configuration loader, not by a server
 // bundle. The core's dynamic readers deliberately leave tracing to this adapter.
 async function contentFiles(directory) {

package/dist/runtime/index.js

@@ -11,6 +11,7 @@ import { DocsSidebar } from "@lexibase/rdx-ui/components/docs-sidebar";
 import { DocsToc } from "@lexibase/rdx-ui/components/docs-toc";
 import { DocsSearch } from "@lexibase/rdx-ui/components/docs-search";
 import { Home } from "@lexibase/rdx-ui/components/home";
+import { FooterCredit } from "@lexibase/rdx-ui/components/footer-credit";
 import { Logo } from "@lexibase/rdx-ui/components/logo";
 import { mdxComponents } from "@lexibase/rdx-ui/components/mdx-components";
 import { Navbar } from "@lexibase/rdx-ui/components/navbar";
@@ -93,6 +94,7 @@ function getDocumentMetadata({
 }
 function getRdxMetadata(config) {
   const { metadataBase, ...metadata } = config.metadata;
+  delete metadata.since;
   const name = metadata.applicationName;
   return {
     title: { default: name, template: `%s | ${name}` },
@@ -308,12 +310,13 @@ async function DocsPage({
                         }
                       ) : /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", disabled: true, children: "Next" })
                     ] }),
-                    /* @__PURE__ */ jsx("section", { className: "flex items-center justify-center w-full py-5", children: /* @__PURE__ */ jsxs("p", { className: "text-sm text-muted-foreground", children: [
-                      "\xA9 ",
-                      (/* @__PURE__ */ new Date()).getFullYear(),
-                      " ",
-                      /* @__PURE__ */ jsx("strong", { children: project.config.metadata.applicationName })
-                    ] }) })
+                    /* @__PURE__ */ jsx(
+                      FooterCredit,
+                      {
+                        name: project.config.metadata.applicationName,
+                        since: project.config.metadata.since
+                      }
+                    )
                   ] })
                 ]
               }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexibase/rdx-next",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "The Next.js runtime for RDX documentation projects.",
   "license": "MIT",
   "type": "module",
@@ -11,6 +11,11 @@
     "rdx": "./bin/rdx.mjs"
   },
   "exports": {
+    "./package.json": "./package.json",
+    "./cli": {
+      "types": "./bin/cli.d.mts",
+      "import": "./bin/cli.mjs"
+    },
     "./config": {
       "types": "./config.d.mts",
       "import": "./config.mjs"
@@ -46,11 +51,11 @@
     "next-mdx-remote": "^6.0.0",
     "remark-gfm": "^4",
     "typescript": "6.0.3",
-    "@lexibase/rdx-types": "1.0.0",
-    "@lexibase/rdx-core": "1.0.0",
-    "@lexibase/rdx-ui": "1.0.0"
+    "@lexibase/rdx-core": "1.1.0",
+    "@lexibase/rdx-types": "1.1.0"
   },
   "peerDependencies": {
+    "@lexibase/rdx-ui": "^1.1.0",
     "next": "^16.4.2",
     "react": "^19.3.1",
     "react-dom": "^19.3.1"
@@ -75,12 +80,13 @@
     "next": "^16.4.2",
     "react": "19.3.1",
     "react-dom": "19.3.1",
-    "@rdx/typescript-config": "1.0.0",
-    "@rdx/eslint-config": "1.0.0"
+    "@rdx/eslint-config": "1.0.0",
+    "@lexibase/rdx-ui": "1.1.0",
+    "@rdx/typescript-config": "1.0.0"
   },
   "scripts": {
-    "dev": "tsup src/index.ts src/runtime/index.tsx --format esm --dts --watch --external @lexibase/rdx-core --external @lexibase/rdx-types --external next --external react --external react-dom --external next-mdx-remote",
-    "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",
+    "dev": "tsup src/index.ts src/runtime/index.tsx --format esm --dts --watch --external @lexibase/rdx-core --external @lexibase/rdx-types --external @lexibase/rdx-ui --external next --external react --external react-dom --external next-mdx-remote",
+    "build": "tsup src/index.ts src/runtime/index.tsx --format esm --dts --clean --external @lexibase/rdx-core --external @lexibase/rdx-types --external @lexibase/rdx-ui --external next --external react --external react-dom --external next-mdx-remote",
     "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
     "test": "node --test tests/*.test.mjs",

package/templates/runtime/next.config.mjs

@@ -1,17 +1,18 @@
 import { fileURLToPath } from 'node:url'
 
-import { getRdxTracingConfig } from '@lexibase/rdx-next/config'
+import { getRdxBuildRoot, getRdxTracingConfig } from '@lexibase/rdx-next/config'
 
 const rootDir = fileURLToPath(new URL('..', import.meta.url))
 const appDir = fileURLToPath(new URL('.', import.meta.url))
+const buildRoot = await getRdxBuildRoot(rootDir)
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   ...(await getRdxTracingConfig({ rootDir, appDir })),
-  outputFileTracingRoot: rootDir,
+  outputFileTracingRoot: buildRoot,
   agentRules: false,
   turbopack: {
-    root: fileURLToPath(new URL('..', import.meta.url)),
+    root: buildRoot,
   },
   transpilePackages: [
     '@lexibase/rdx-core',