@lexibase/rdx-next 3.2.0 → 4.1.0

package/bin/plugin-config.mjs

@@ -1,7 +1,29 @@
 import ts from 'typescript'
 
 export const versioningPackage = '@lexibase/rdx-versioning'
-const manual = `Cannot safely edit rdx.config.ts. Add "import { versioning } from '${versioningPackage}'" and versioning() to plugins manually, then run rdx prepare.`
+export const i18nPackage = '@lexibase/rdx-i18n'
+const versioning = {
+  packageName: versioningPackage,
+  name: 'versioning',
+  label: 'Versioning',
+}
+const localization = { packageName: i18nPackage, name: 'i18n', label: 'i18n' }
+
+export function activateVersioning(source) {
+  return editPluginConfig(source, versioning)
+}
+
+export function inspectI18n(source) {
+  return editPluginConfig(source, localization, '', true)
+}
+
+export function activateI18n(source, locales) {
+  return editPluginConfig(
+    source,
+    localization,
+    JSON.stringify({ locales }, null, 2)
+  )
+}
 
 function unwrap(node) {
   while (
@@ -14,7 +36,9 @@ function unwrap(node) {
 }
 
 // Edit only known literal shapes; never print/reconstruct the user's entire file.
-export function activateVersioning(source) {
+function editPluginConfig(source, plugin, argument = '', inspect = false) {
+  const { packageName, name: pluginName, label } = plugin
+  const manual = `Cannot safely edit rdx.config.ts. Add "import { ${pluginName} } from '${packageName}'" and ${pluginName}(${pluginName === 'i18n' ? '{ locales: [...] }' : ''}) to plugins manually, then run rdx prepare.`
   const file = ts.createSourceFile(
     'rdx.config.ts',
     source,
@@ -44,7 +68,7 @@ export function activateVersioning(source) {
           imported === 'defineConfig'
         )
           definitions.add(specifier.name.text)
-        if (name === versioningPackage && imported === 'versioning') {
+        if (name === packageName && imported === pluginName) {
           if (factory) throw new Error(manual)
           factory = specifier.name.text
         }
@@ -52,10 +76,10 @@ export function activateVersioning(source) {
     } else if (
       bindings &&
       ts.isNamespaceImport(bindings) &&
-      name === versioningPackage
+      name === packageName
     ) {
       if (factory) throw new Error(manual)
-      factory = `${bindings.name.text}.versioning`
+      factory = `${bindings.name.text}.${pluginName}`
     }
   }
   const exports = file.statements.filter(ts.isExportAssignment)
@@ -100,9 +124,18 @@ export function activateVersioning(source) {
     )
     if (matches.length > 1)
       throw new Error(
-        'Versioning is configured more than once. Remove the duplicate plugin before retrying.'
+        `${label} is configured more than once. Remove the duplicate plugin before retrying.`
       )
-    if (matches.length === 1) return source
+    if (matches.length === 1) return inspect ? { configured: true } : source
+  }
+  if (inspect) {
+    const languages = properties.filter((entry) => entry.name.text === 'lang')
+    if (languages.length > 1) throw new Error(manual)
+    const language = languages.length
+      ? unwrap(languages[0].initializer)
+      : undefined
+    if (language && !ts.isStringLiteral(language)) throw new Error(manual)
+    return { configured: false, lang: language?.text ?? 'en' }
   }
   const newline = source.includes('\r\n') ? '\r\n' : '\n'
   const edits = []
@@ -113,11 +146,12 @@ export function activateVersioning(source) {
       ts.forEachChild(node, visit)
     }
     visit(file)
-    factory = 'versioning'
+    factory = pluginName
     let suffix = 1
-    while (identifiers.has(factory)) factory = `rdxVersioning${suffix++}`
+    const alias = `rdx${pluginName[0].toUpperCase()}${pluginName.slice(1)}`
+    while (identifiers.has(factory)) factory = `${alias}${suffix++}`
     const specifier =
-      factory === 'versioning' ? 'versioning' : `versioning as ${factory}`
+      factory === pluginName ? pluginName : `${pluginName} as ${factory}`
     let position = imports.length
       ? imports.at(-1).end
       : file.statements[0].getStart(file)
@@ -133,7 +167,7 @@ export function activateVersioning(source) {
     }
     edits.push({
       position,
-      text: `${newline}import { ${specifier} } from '${versioningPackage}'${newline}`,
+      text: `${newline}import { ${specifier} } from '${packageName}'${newline}`,
     })
   }
   if (plugins) {
@@ -142,14 +176,14 @@ export function activateVersioning(source) {
       : plugins.getStart(file) + 1
     edits.push({
       position,
-      text: `${plugins.elements.length ? ',' : ''} ${factory}()`,
+      text: `${plugins.elements.length ? ',' : ''} ${factory}(${argument.replaceAll('\n', newline)})`,
     })
   } else {
     if (properties.length && !properties.hasTrailingComma)
       edits.push({ position: properties.at(-1).end, text: ',' })
     edits.push({
       position: config.end - 1,
-      text: `${newline}  plugins: [${factory}()],${newline}`,
+      text: `${newline}  plugins: [${factory}(${argument.replaceAll('\n', newline)})],${newline}`,
     })
   }
   for (const edit of edits.sort((a, b) => b.position - a.position))

package/config.mjs

@@ -2,7 +2,11 @@ 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 {
+  createRdxProject,
+  resolveProjectPath,
+  getContentSources,
+} from '@lexibase/rdx-core/config'
 import { createJiti } from 'jiti'
 
 /** Include the project and the real Next.js installation in Turbopack's root. */
@@ -77,7 +81,7 @@ export async function getRdxTracingConfig({ rootDir, appDir = rootDir }) {
   const project = await createRdxProject(input, { rootDir })
   const files = (
     await Promise.all(
-      project.sources
+      getContentSources(project)
         .filter((source) => source.redirectTo === undefined)
         .map((source) =>
           contentFiles(
@@ -102,11 +106,28 @@ export async function getRdxTracingConfig({ rootDir, appDir = rootDir }) {
   }
   const redirects = project.sources
     .filter((source) => source.redirectTo !== undefined)
-    .map((source) => ({
-      source: `/docs/${source.routePrefix}/:path*`,
-      destination: `/docs/${source.redirectTo}/:path*`,
+    .flatMap((source) =>
+      [
+        '/docs',
+        ...(project.localization?.locales.map(
+          (locale) => `/${locale.path}/docs`
+        ) ?? []),
+      ].map((base) => ({
+        source: `${base}/${source.routePrefix}/:path*`,
+        destination: `${base}/${source.redirectTo}/:path*`,
+        permanent: true,
+      }))
+    )
+  if (project.localization) {
+    const primary = project.localization.locales.find(
+      (locale) => locale.code === project.localization.defaultLocale
+    )
+    redirects.push({
+      source: '/docs/:path*',
+      destination: `/${primary.path}/docs/:path*`,
       permanent: true,
-    }))
+    })
+  }
   return {
     ...(redirects.length ? { redirects: async () => redirects } : {}),
     outputFileTracingIncludes: {

package/dist/runtime/index.d.ts

@@ -1,14 +1,26 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { RdxProject, RDXConfig, RdxDocPage } from '@lexibase/rdx-types';
-export { createRdxProject, getProjectDocsPaths } from '@lexibase/rdx-core';
-import { Metadata } from 'next';
+import { RdxProject, RDXConfig, RdxContentSource, RdxDocPage } from '@lexibase/rdx-types';
+export { createRdxProject, getLocalizedProject, getProjectDocsPaths } from '@lexibase/rdx-core';
+import { MetadataRoute, Metadata } from 'next';
 
 declare function getSearchSources(project: RdxProject): {
     source: string;
 }[];
 declare function getSearchResponse(project: RdxProject, key: string): Response;
 
+/** Published editions replace live development content in search results. */
+declare function getSourceRobots(project: RdxProject, source: RdxContentSource): {
+    index: boolean;
+    follow: boolean;
+};
+/** Use the configured public URL only; development hosts are never inferred. */
+declare function getRdxRobots(config: RDXConfig): MetadataRoute.Robots;
+/** Share the indexing policy while allowing host applications to map their URLs. */
+declare function getRdxSitemap(project: RdxProject, { documentPath, }?: {
+    documentPath?: (source: RdxContentSource, page: RdxDocPage) => string;
+}): MetadataRoute.Sitemap;
+
 /** Read metadata from the same content source and index used by the page. */
 declare function getDocumentMetadata({ project, slug, }: {
     project: RdxProject;
@@ -35,4 +47,4 @@ declare function DocsPage({ slug, project, }: {
     project: RdxProject;
 }): Promise<react.JSX.Element>;
 
-export { DocsPage, HomePage, NotFoundPage, RdxLayout, getDocumentMetadata, getPageMetadata, getRdxMetadata, getSearchResponse, getSearchSources };
+export { DocsPage, HomePage, NotFoundPage, RdxLayout, getDocumentMetadata, getPageMetadata, getRdxMetadata, getRdxRobots, getRdxSitemap, getSearchResponse, getSearchSources, getSourceRobots };

package/dist/runtime/index.js

@@ -1,11 +1,17 @@
 // src/runtime/index.tsx
 import {
-  getDocument as getDocument2,
+  getDocument as getDocument3,
   getDocsPaths,
-  getSourceOptions as getSourceOptions2,
-  resolveDocsRoute as resolveDocsRoute2
+  getSourceOptions as getSourceOptions4,
+  resolveDocsRoute as resolveDocsRoute2,
+  getLocalizedProject as getLocalizedProject2,
+  getDocsHref as getDocsHref3,
+  getLanguageLinks,
+  isFallbackPage as isFallbackPage3
 } from "@lexibase/rdx-core";
 import { Button } from "@lexibase/rdx-ui/components/button";
+import { Callout } from "@lexibase/rdx-ui/components/callout";
+import { LanguageDropdown } from "@lexibase/rdx-ui/components/language-dropdown";
 import { DocsSidebar } from "@lexibase/rdx-ui/components/docs-sidebar";
 import { DocsToc } from "@lexibase/rdx-ui/components/docs-toc";
 import { DocsPageTransition } from "@lexibase/rdx-ui/components/docs-page-transition";
@@ -19,6 +25,7 @@ import { getMessages, formatMessage } from "@lexibase/rdx-ui/lib/i18n";
 import { LocaleProvider } from "@lexibase/rdx-ui/providers/locale-provider";
 import { Navbar } from "@lexibase/rdx-ui/components/navbar";
 import { NotFound } from "@lexibase/rdx-ui/components/not-found";
+import { LocalizedNotFound } from "@lexibase/rdx-ui/components/localized-not-found";
 import {
   VersionDropdown
 } from "@lexibase/rdx-ui/components/version-dropdown";
@@ -54,50 +61,156 @@ function compileDocumentation(source, components, links) {
 }
 
 // src/runtime/index.tsx
-import { createRdxProject, getProjectDocsPaths } from "@lexibase/rdx-core";
+import {
+  createRdxProject,
+  getProjectDocsPaths,
+  getLocalizedProject as getLocalizedProject3
+} from "@lexibase/rdx-core";
 
 // src/runtime/search.ts
-import { getDocsIndex, getDocument, getSourceOptions } from "@lexibase/rdx-core";
+import {
+  getDocsIndex,
+  getDocument,
+  getSourceOptions,
+  getDocsHref
+} from "@lexibase/rdx-core";
 import { buildSearchIndex } from "@lexibase/rdx-core/search";
 function getSearchSources(project) {
   return project.config.search ? project.sources.filter((source) => source.redirectTo === void 0).map((source) => ({ source: source.routePrefix || "_" })) : [];
 }
 function getSearchResponse(project, key) {
-  if (!project.config.search) return new Response(null, { status: 404 });
+  const headers = { "X-Robots-Tag": "noindex, follow" };
+  if (!project.config.search)
+    return new Response(null, { status: 404, headers });
   const source = project.sources.find(
     (entry) => entry.redirectTo === void 0 && (entry.routePrefix || "_") === key
   );
-  if (!source) return new Response(null, { status: 404 });
-  const options = getSourceOptions(project, source);
+  if (!source) return new Response(null, { status: 404, headers });
+  if (source.fallbackOnly)
+    return Response.json(buildSearchIndex([]), { headers });
+  const { docsDir } = getSourceOptions(project, source);
+  const options = { docsDir };
   const documents = getDocsIndex(options).flatMap(
     (category) => category.pages.map((page) => ({
       title: page.title,
       description: page.description,
       category: category.title,
-      href: [
-        "/docs",
-        source.routePrefix,
-        page.slug.split("/").map(encodeURIComponent).join("/")
-      ].filter(Boolean).join("/"),
+      href: getDocsHref(project, source, page.slug),
       content: getDocument(page.slug, options)?.content ?? ""
     }))
   );
-  return Response.json(buildSearchIndex(documents));
+  return Response.json(buildSearchIndex(documents), { headers });
+}
+
+// src/runtime/indexing.ts
+import {
+  getDocsIndex as getDocsIndex2,
+  getSourceOptions as getSourceOptions2,
+  getContentSources,
+  isFallbackPage
+} from "@lexibase/rdx-core";
+function getSourceRobots(project, source) {
+  const published = project.sources.some(
+    (entry) => entry.id !== "current" && entry.redirectTo === void 0 && entry.badge !== "Archived"
+  );
+  return {
+    index: source.redirectTo === void 0 && source.badge !== "Archived" && (source.id !== "current" || !published),
+    follow: true
+  };
+}
+function getRdxRobots(config) {
+  return {
+    // Do not disallow noindex pages: crawlers must read their HTML directive.
+    rules: { userAgent: "*", allow: "/" },
+    ...config.metadata.metadataBase ? { sitemap: new URL("/sitemap.xml", config.metadata.metadataBase).href } : {}
+  };
+}
+function getRdxSitemap(project, {
+  documentPath = (source, page) => [
+    source.basePath ?? "/docs",
+    source.routePrefix,
+    page.slug.split("/").map(encodeURIComponent).join("/")
+  ].filter(Boolean).join("/")
+} = {}) {
+  const base = project.config.metadata.metadataBase;
+  if (!base) return [];
+  const urls = /* @__PURE__ */ new Set();
+  if (project.config.homepage?.enabled) urls.add(new URL("/", base).href);
+  for (const source of getContentSources(project)) {
+    if (!getSourceRobots(project, source).index) continue;
+    for (const category of getDocsIndex2(getSourceOptions2(project, source))) {
+      for (const page of category.pages) {
+        if (isFallbackPage(project, source, page.sourcePath)) continue;
+        urls.add(new URL(documentPath(source, page), base).href);
+      }
+    }
+  }
+  return [...urls].map((url) => ({ url }));
 }
 
 // src/runtime/metadata.ts
-import { resolveDocsRoute } from "@lexibase/rdx-core";
+import {
+  resolveDocsRoute,
+  getLocalizedProject,
+  getDocsHref as getDocsHref2,
+  isFallbackPage as isFallbackPage2,
+  getDocument as getDocument2,
+  getSourceOptions as getSourceOptions3
+} from "@lexibase/rdx-core";
 import { notFound } from "next/navigation";
 function getDocumentMetadata({
   project,
   slug
 }) {
+  if (project.localization && !project.locale)
+    return { robots: { index: false, follow: true } };
   const route = resolveDocsRoute(project, slug);
-  if (route.source.redirectTo !== void 0) return {};
-  if (!route.slug) return {};
+  if (route.source.redirectTo !== void 0)
+    return { robots: getSourceRobots(project, route.source) };
+  if (!route.slug) return { robots: { index: false, follow: true } };
   if (!route.document) notFound();
   const page = route.categories.flatMap((category) => category.pages).find((page2) => page2.slug === route.slug);
-  return getPageMetadata(project.config, page);
+  const fallback = isFallbackPage2(project, route.source, page.sourcePath);
+  const primary = project.localization?.locales.find(
+    (locale) => locale.code === project.localization.defaultLocale
+  );
+  const canonicalProject = fallback ? getLocalizedProject(project, primary.path) : project;
+  const base = project.config.metadata.metadataBase;
+  const languages = project.localization && base ? Object.fromEntries(
+    project.localization.locales.flatMap((locale) => {
+      const view = getLocalizedProject(project, locale.path);
+      const source = view.sources.find(
+        (entry) => entry.id === route.source.id
+      );
+      return !source.fallbackOnly && getDocument2(page.slug, {
+        docsDir: getSourceOptions3(view, source).docsDir
+      }) ? [
+        [
+          locale.code,
+          new URL(getDocsHref2(view, source, page.slug), base).href
+        ]
+      ] : [];
+    })
+  ) : void 0;
+  return {
+    ...getPageMetadata(project.config, page),
+    robots: fallback ? { index: false, follow: true } : getSourceRobots(project, route.source),
+    ...project.localization && base ? {
+      alternates: {
+        canonical: new URL(
+          getDocsHref2(
+            canonicalProject,
+            canonicalProject.sources.find(
+              (entry) => entry.id === route.source.id
+            ),
+            page.slug
+          ),
+          base
+        ).href,
+        ...fallback ? {} : { languages }
+      }
+    } : {}
+  };
 }
 function getPageMetadata(config, page) {
   const title = page.title;
@@ -117,6 +230,7 @@ function getRdxMetadata(config) {
     title: { default: name, template: `%s | ${name}` },
     description: config.description,
     ...metadata,
+    robots: { index: true, follow: true },
     ...metadataBase ? { metadataBase: new URL(metadataBase) } : {},
     ...metadata.openGraph ? {
       openGraph: {
@@ -164,13 +278,13 @@ function RdxHeader({
   const messages = getMessages(config.lang);
   const { source, slug: currentSlug } = resolveDocsRoute2(project, slug);
   const options = project.sources.filter((edition) => edition.redirectTo === void 0).map((edition) => {
-    const docs = getSourceOptions2(project, edition);
-    const destination = currentSlug && getDocument2(currentSlug, docs) ? currentSlug : getDocsPaths(docs)[0];
+    const docs = getSourceOptions4(project, edition);
+    const destination = currentSlug && getDocument3(currentSlug, docs) ? currentSlug : getDocsPaths(docs)[0];
     return {
       id: edition.id,
       label: edition.id === "current" ? messages.current : formatMessage(messages.version, { version: edition.label }),
       kind: edition.id === "current" ? "live" : edition.badge === "Archived" ? "archived" : "version",
-      href: ["/docs", edition.routePrefix, destination].filter(Boolean).join("/")
+      href: getDocsHref3(project, edition, destination)
     };
   });
   const BrandLogo = config.navbar?.logo ?? Logo;
@@ -182,14 +296,23 @@ function RdxHeader({
       search: config.search ? /* @__PURE__ */ jsx(
         DocsSearch,
         {
-          indexUrl: `/rdx-search/${encodeURIComponent(source.routePrefix || "_")}`,
+          indexUrl: `${project.locale ? `/${project.locale.path}` : ""}/rdx-search/${encodeURIComponent(source.routePrefix || "_")}`,
           version: source.id === "current" ? messages.current : formatMessage(messages.version, { version: source.label })
         }
       ) : void 0,
       siteTitle: config.metadata.applicationName,
       logo: /* @__PURE__ */ jsx(BrandLogo, { className: "size-5" }),
-      homeHref: config.homepage?.enabled ? "/" : "/docs",
-      docsHref: ["/docs", source.routePrefix].filter(Boolean).join("/"),
+      homeHref: config.homepage?.enabled ? "/" : getDocsHref3(project),
+      docsHref: getDocsHref3(project, source),
+      languageMenu: project.localization ? /* @__PURE__ */ jsx(
+        LanguageDropdown,
+        {
+          lang: config.lang,
+          current: project.locale?.code ?? project.localization.defaultLocale,
+          options: getLanguageLinks(project, source, currentSlug),
+          contributionUrl: project.localization.contributionUrl
+        }
+      ) : void 0,
       versionMenu: project.sources.length > 1 ? /* @__PURE__ */ jsx(VersionDropdown, { options, currentId: source.id }) : void 0,
       github: config.navbar?.actions?.github,
       showToggleMode: config.navbar?.actions?.showToggleMode
@@ -198,7 +321,7 @@ function RdxHeader({
 }
 function HomePage({ project }) {
   const { config } = project;
-  if (!config.homepage?.enabled) redirect("/docs");
+  if (!config.homepage?.enabled) redirect(getDocsHref3(project));
   const homepage = config.homepage;
   const CustomHome = homepage.component;
   const BrandLogo = config.navbar?.logo ?? Logo;
@@ -224,6 +347,25 @@ function HomePage({ project }) {
   ] });
 }
 function NotFoundPage({ project }) {
+  if (project.localization) {
+    const { config, localization } = project;
+    const BrandLogo = config.navbar?.logo ?? Logo;
+    return /* @__PURE__ */ jsx(
+      LocalizedNotFound,
+      {
+        locales: localization.locales,
+        defaultLocale: localization.defaultLocale,
+        homepage: !!config.homepage?.enabled,
+        brand: {
+          title: config.navbar?.title,
+          siteTitle: config.metadata.applicationName,
+          github: config.navbar?.actions?.github,
+          showToggleMode: config.navbar?.actions?.showToggleMode,
+          logo: /* @__PURE__ */ jsx(BrandLogo, { className: "size-5" })
+        }
+      }
+    );
+  }
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(RdxHeader, { project }),
     /* @__PURE__ */ jsx(NotFound, { lang: project.config.lang })
@@ -233,6 +375,8 @@ async function DocsPage({
   slug,
   project
 }) {
+  if (project.localization && !project.locale)
+    permanentRedirect(getDocsHref3(project, project.sources[0], slug?.join("/")));
   const messages = getMessages(project.config.lang);
   const {
     source,
@@ -242,11 +386,13 @@ async function DocsPage({
   } = resolveDocsRoute2(project, slug);
   if (source.redirectTo !== void 0)
     permanentRedirect(
-      [
-        "/docs",
-        source.redirectTo,
-        ...slug?.slice(1).map(encodeURIComponent) ?? []
-      ].join("/")
+      getDocsHref3(
+        project,
+        project.sources.find(
+          (entry) => entry.routePrefix === source.redirectTo
+        ),
+        slug?.slice(1).join("/")
+      )
     );
   if (!currentSlug)
     return /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -257,19 +403,32 @@ async function DocsPage({
       ] })
     ] });
   if (!document) notFound2();
+  const fallback = isFallbackPage3(project, source, document.sourcePath);
+  const primaryLocale = (source.localization ?? project.localization)?.locales.find(
+    (locale) => locale.code === project.localization.defaultLocale
+  );
+  const originalProject = fallback && primaryLocale ? getLocalizedProject2(project, primaryLocale.path) : project;
+  const contentSource = originalProject.sources.find(
+    (entry) => entry.id === source.id
+  );
+  const contentOptions = getSourceOptions4(originalProject, contentSource);
+  const contentCategories = fallback ? resolveDocsRoute2(originalProject, slug).categories : categories;
+  const contentLanguage = fallback ? primaryLocale.code : project.config.lang;
   const { content } = await compileDocumentation(
     document.content,
     getMdxComponents(project.config.lang),
     {
-      sourceRoot: getSourceOptions2(project, source).docsDir,
+      sourceRoot: contentOptions.docsDir,
       sourcePath: document.sourcePath,
       routePrefix: source.routePrefix,
-      documents: categories.flatMap((category2) => category2.pages)
+      basePath: contentSource.basePath,
+      virtualPaths: !!contentOptions.fallbackDocsDir,
+      documents: contentCategories.flatMap((category2) => category2.pages)
     }
   );
   const title = typeof document.frontmatter.title === "string" ? document.frontmatter.title : currentSlug;
   const description = typeof document.frontmatter.description === "string" ? document.frontmatter.description : null;
-  const hrefFor = (pageSlug) => ["/docs", source.routePrefix, pageSlug].filter(Boolean).join("/");
+  const hrefFor = (pageSlug) => getDocsHref3(project, source, pageSlug);
   const sidebarCategories = categories.map((category2) => ({
     title: category2.title,
     links: category2.pages.map((page) => ({
@@ -315,9 +474,58 @@ async function DocsPage({
                         "main",
                         {
                           id: "rdx-main",
+                          lang: contentLanguage,
                           tabIndex: -1,
                           className: "w-full flex flex-col gap-5 md:mx-auto md:max-w-[860px] pt-14 md:pt-0 flex-1 outline-none",
                           children: [
+                            fallback && /* @__PURE__ */ jsxs(
+                              Callout,
+                              {
+                                lang: project.config.lang,
+                                variant: "note",
+                                title: messages.translationUnavailable,
+                                "data-rdx-translation-fallback": true,
+                                children: [
+                                  /* @__PURE__ */ jsx("p", { children: formatMessage(messages.translationFallback, {
+                                    requested: project.locale.label,
+                                    original: primaryLocale.label
+                                  }) }),
+                                  /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-2", children: [
+                                    /* @__PURE__ */ jsx(
+                                      Button,
+                                      {
+                                        variant: "link",
+                                        href: getDocsHref3(
+                                          originalProject,
+                                          contentSource,
+                                          currentSlug
+                                        ),
+                                        children: messages.viewOriginal
+                                      }
+                                    ),
+                                    project.localization?.contributionUrl && /* @__PURE__ */ jsxs(
+                                      Button,
+                                      {
+                                        variant: "link",
+                                        href: project.localization.contributionUrl,
+                                        target: "_blank",
+                                        rel: "noopener noreferrer",
+                                        "data-rdx-translate-page": true,
+                                        children: [
+                                          messages.translateThisPage,
+                                          /* @__PURE__ */ jsxs("span", { className: "sr-only", children: [
+                                            " ",
+                                            "(",
+                                            messages.opensInNewTab,
+                                            ")"
+                                          ] })
+                                        ]
+                                      }
+                                    )
+                                  ] })
+                                ]
+                              }
+                            ),
                             /* @__PURE__ */ jsxs("header", { className: "mb-6", children: [
                               source.badge && /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground mb-4", children: source.badge === "Archived" ? messages.archivedVersion : source.badge }),
                               /* @__PURE__ */ jsx("span", { className: "text-xs text-zinc-600 font-semibold uppercase block -mb-0.5", children: category?.title }),
@@ -378,9 +586,13 @@ export {
   RdxLayout,
   createRdxProject,
   getDocumentMetadata,
+  getLocalizedProject3 as getLocalizedProject,
   getPageMetadata,
   getProjectDocsPaths,
   getRdxMetadata,
+  getRdxRobots,
+  getRdxSitemap,
   getSearchResponse,
-  getSearchSources
+  getSearchSources,
+  getSourceRobots
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexibase/rdx-next",
-  "version": "3.2.0",
+  "version": "4.1.0",
   "description": "The Next.js runtime for RDX documentation projects.",
   "license": "MIT",
   "type": "module",
@@ -48,14 +48,15 @@
   "dependencies": {
     "cross-spawn": "^7.0.6",
     "jiti": "^2.6.1",
+    "prompts": "^2.4.2",
     "next-mdx-remote": "^6.0.0",
     "remark-gfm": "^4",
     "typescript": "6.0.3",
-    "@lexibase/rdx-core": "1.4.0",
-    "@lexibase/rdx-types": "1.2.0"
+    "@lexibase/rdx-core": "2.1.0",
+    "@lexibase/rdx-types": "2.1.0"
   },
   "peerDependencies": {
-    "@lexibase/rdx-ui": "^3.2.0",
+    "@lexibase/rdx-ui": "^3.3.0",
     "next": "^16.4.2",
     "react": "^19.3.1",
     "react-dom": "^19.3.1"
@@ -80,7 +81,7 @@
     "next": "^16.4.2",
     "react": "19.3.1",
     "react-dom": "19.3.1",
-    "@lexibase/rdx-ui": "3.2.0",
+    "@lexibase/rdx-ui": "3.3.0",
     "@rdx/typescript-config": "1.0.0",
     "@rdx/eslint-config": "1.0.0"
   },