@tuwaio/docs-ui 0.5.7 → 0.7.0

package/dist/docsPage.d.cts

@@ -0,0 +1,56 @@
+import * as react from 'react';
+import { Metadata } from 'next';
+import { EvaluateResult } from 'nextra';
+import { TuwaLocale } from './locale.cjs';
+
+/** A translated language of a page: a function that imports its MDX file (`() => import('./uk/index.mdx')`). */
+type LocalizedPageLoaders = Partial<Record<Exclude<TuwaLocale, 'en'>, () => Promise<EvaluateResult>>>;
+/** Props of the `[[...mdxPath]]` page of a documentation site. */
+interface DocsPageProps {
+    /** The route segments after the site root. */
+    params: Promise<{
+        mdxPath?: string[];
+    }>;
+    /** Query parameters of the request. */
+    searchParams?: Promise<Record<string, string | string[] | undefined>>;
+}
+/** Options of {@link createDocsPage}. */
+interface CreateDocsPageOptions {
+    /**
+     * The translated pages of the site by route (`/` for the Introduction, `/packages` for the packages overview).
+     * Pages that are not listed (package READMEs, the generated reference) stay in English in every language.
+     */
+    localizedPages?: Readonly<Record<string, LocalizedPageLoaders>>;
+}
+/**
+ * Creates the `[[...mdxPath]]` route of a TUWA documentation site (the pages of `src/content`): the static params, the
+ * metadata of each page and the page component, which renders the English page and its translations into a
+ * `LocalizedPage`. Re-export them from `src/app/[[...mdxPath]]/page.tsx`; the layout must be `DocsLayout`
+ * (`@tuwaio/docs-ui/nextra`). Side effects: imports the MDX files of the requested page and of its translations; the
+ * metadata stays English.
+ *
+ * @example
+ * ```tsx
+ * import { createDocsPage } from '@tuwaio/docs-ui/nextra/page';
+ *
+ * import { localizedPages } from '@/i18n/pages';
+ *
+ * const { generateStaticParams, generateMetadata, Page } = createDocsPage({ localizedPages });
+ *
+ * export { generateMetadata, generateStaticParams };
+ * export default Page;
+ * ```
+ *
+ * @param options - See {@link CreateDocsPageOptions}.
+ * @returns `generateStaticParams`, `generateMetadata` and `Page`.
+ */
+declare function createDocsPage({ localizedPages }?: CreateDocsPageOptions): {
+    generateStaticParams: () => Promise<{
+        [x: string]: string | string[];
+    }[]>;
+    generateMetadata: (props: DocsPageProps) => Promise<Metadata>;
+    Page: (props: DocsPageProps) => Promise<react.JSX.Element>;
+};
+
+export { createDocsPage };
+export type { CreateDocsPageOptions, DocsPageProps, LocalizedPageLoaders };

package/dist/docsPage.d.ts

@@ -0,0 +1,56 @@
+import * as react from 'react';
+import { Metadata } from 'next';
+import { EvaluateResult } from 'nextra';
+import { TuwaLocale } from './locale.js';
+
+/** A translated language of a page: a function that imports its MDX file (`() => import('./uk/index.mdx')`). */
+type LocalizedPageLoaders = Partial<Record<Exclude<TuwaLocale, 'en'>, () => Promise<EvaluateResult>>>;
+/** Props of the `[[...mdxPath]]` page of a documentation site. */
+interface DocsPageProps {
+    /** The route segments after the site root. */
+    params: Promise<{
+        mdxPath?: string[];
+    }>;
+    /** Query parameters of the request. */
+    searchParams?: Promise<Record<string, string | string[] | undefined>>;
+}
+/** Options of {@link createDocsPage}. */
+interface CreateDocsPageOptions {
+    /**
+     * The translated pages of the site by route (`/` for the Introduction, `/packages` for the packages overview).
+     * Pages that are not listed (package READMEs, the generated reference) stay in English in every language.
+     */
+    localizedPages?: Readonly<Record<string, LocalizedPageLoaders>>;
+}
+/**
+ * Creates the `[[...mdxPath]]` route of a TUWA documentation site (the pages of `src/content`): the static params, the
+ * metadata of each page and the page component, which renders the English page and its translations into a
+ * `LocalizedPage`. Re-export them from `src/app/[[...mdxPath]]/page.tsx`; the layout must be `DocsLayout`
+ * (`@tuwaio/docs-ui/nextra`). Side effects: imports the MDX files of the requested page and of its translations; the
+ * metadata stays English.
+ *
+ * @example
+ * ```tsx
+ * import { createDocsPage } from '@tuwaio/docs-ui/nextra/page';
+ *
+ * import { localizedPages } from '@/i18n/pages';
+ *
+ * const { generateStaticParams, generateMetadata, Page } = createDocsPage({ localizedPages });
+ *
+ * export { generateMetadata, generateStaticParams };
+ * export default Page;
+ * ```
+ *
+ * @param options - See {@link CreateDocsPageOptions}.
+ * @returns `generateStaticParams`, `generateMetadata` and `Page`.
+ */
+declare function createDocsPage({ localizedPages }?: CreateDocsPageOptions): {
+    generateStaticParams: () => Promise<{
+        [x: string]: string | string[];
+    }[]>;
+    generateMetadata: (props: DocsPageProps) => Promise<Metadata>;
+    Page: (props: DocsPageProps) => Promise<react.JSX.Element>;
+};
+
+export { createDocsPage };
+export type { CreateDocsPageOptions, DocsPageProps, LocalizedPageLoaders };

package/dist/docsPage.js

@@ -0,0 +1,46 @@
+import { jsx } from "react/jsx-runtime";
+import { notFound } from "next/navigation";
+import { generateStaticParamsFor, importPage } from "nextra/pages";
+import { LocalizedPage } from "./components/LocalizedPage";
+function isAssetOrInternal(mdxPath) {
+  if (!mdxPath || mdxPath.length === 0) return false;
+  if (mdxPath[0] === "_next") return true;
+  return Boolean(mdxPath[mdxPath.length - 1]?.includes("."));
+}
+const routeOf = (mdxPath) => `/${(mdxPath ?? []).join("/")}`;
+function variantOf(module, props, params) {
+  const { default: MDXContent, toc, metadata, sourceCode } = module;
+  return { content: /* @__PURE__ */ jsx(MDXContent, { ...props, params }), toc, metadata, sourceCode };
+}
+function createDocsPage({ localizedPages = {} } = {}) {
+  const generateStaticParams = generateStaticParamsFor("mdxPath");
+  async function generateMetadata(props) {
+    const { mdxPath } = await props.params;
+    if (isAssetOrInternal(mdxPath)) return {};
+    try {
+      const { metadata } = await importPage(mdxPath);
+      return metadata;
+    } catch {
+      return {};
+    }
+  }
+  async function Page(props) {
+    const params = await props.params;
+    if (isAssetOrInternal(params.mdxPath)) notFound();
+    let english;
+    try {
+      english = await importPage(params.mdxPath);
+    } catch {
+      notFound();
+    }
+    const loaders = Object.entries(localizedPages[routeOf(params.mdxPath)] ?? {});
+    const translations = await Promise.all(
+      loaders.map(async ([locale, load]) => [locale, variantOf(await load(), props, params)])
+    );
+    return /* @__PURE__ */ jsx(LocalizedPage, { variants: { ...Object.fromEntries(translations), en: variantOf(english, props, params) } });
+  }
+  return { generateStaticParams, generateMetadata, Page };
+}
+export {
+  createDocsPage
+};

package/dist/i18n.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, ReactNode } from 'react';
+import { ReactNode, ComponentType } from 'react';
 import { TuwaLocale, formatLabel } from './locale.cjs';
 
 /** State and setter returned by {@link useLocaleState}. */

package/dist/i18n.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, ReactNode } from 'react';
+import { ReactNode, ComponentType } from 'react';
 import { TuwaLocale, formatLabel } from './locale.js';
 
 /** State and setter returned by {@link useLocaleState}. */

package/dist/index.cjs

@@ -42,8 +42,10 @@ __reExport(index_exports, require("./components/Orb"), module.exports);
 __reExport(index_exports, require("./components/PolicyDocument"), module.exports);
 var import_StarryBackground = __toESM(require("./components/StarryBackground"), 1);
 __reExport(index_exports, require("./components/ThemeSwitcher"), module.exports);
+__reExport(index_exports, require("./docsLabels"), module.exports);
 __reExport(index_exports, require("./i18n"), module.exports);
 __reExport(index_exports, require("./locale"), module.exports);
+__reExport(index_exports, require("./pageMap"), module.exports);
 __reExport(index_exports, require("./policies"), module.exports);
 __reExport(index_exports, require("./preferences"), module.exports);
 __reExport(index_exports, require("./utils"), module.exports);
@@ -58,8 +60,10 @@ __reExport(index_exports, require("./utils"), module.exports);
   ...require("./components/Orb"),
   ...require("./components/PolicyDocument"),
   ...require("./components/ThemeSwitcher"),
+  ...require("./docsLabels"),
   ...require("./i18n"),
   ...require("./locale"),
+  ...require("./pageMap"),
   ...require("./policies"),
   ...require("./preferences"),
   ...require("./utils")

package/dist/index.css

@@ -750,6 +750,9 @@ html {
   .tuwadocs\:z-50 {
     z-index: 50;
   }
+  .tuwadocs\:clear-both {
+    clear: both;
+  }
   .tuwadocs\:mt-1\.5 {
     margin-top: calc(var(--tuwadocs-spacing) * 1.5);
   }

package/dist/index.d.cts

@@ -7,9 +7,12 @@ export { Orb, OrbProps, PackageType } from './components/Orb.cjs';
 export { PolicyDocument, PolicyDocumentProps } from './components/PolicyDocument.cjs';
 export { default as StarryBackground } from './components/StarryBackground.cjs';
 export { ThemeSwitcher, ThemeSwitcherProps } from './components/ThemeSwitcher.cjs';
+export { DocsLabels, docsLabels } from './docsLabels.cjs';
 export { I18nContextValue, I18nKit, I18nProviderProps, LocaleState, LocaleStateOptions, LocaleVariant, createI18n, useLocaleState } from './i18n.cjs';
 export { DEFAULT_LOCALE, LOCALE_STORAGE_KEY, LocaleSignals, TUWA_LOCALES, TuwaLocale, detectLocale, formatLabel, normalizeLocale, policyLanguageOf, resolveClientLocale } from './locale.cjs';
+export { LocalizePageMapOptions, localizePageMap } from './pageMap.cjs';
 export { POLICIES_INDEX_URL, POLICY_DOCUMENT_LABELS, POLICY_LANGUAGES, POLICY_LANGUAGE_NAMES, POLICY_SITE_URL, POLICY_SOURCE, Policy, PolicyContent, PolicyDocumentLabels, PolicyLanguage, PolicySection, PolicySlug, footerPolicies, formatPolicyDate, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, policyLanguageFrom, publishedPolicies } from './policies.cjs';
 export { PREFERENCE_DAYS, PreferenceExpiry, expireStoredPreferences } from './preferences.cjs';
 export { baseFooterLinks, baseNavLinks } from './utils.cjs';
 import 'react';
+import 'nextra';

package/dist/index.d.ts

@@ -7,9 +7,12 @@ export { Orb, OrbProps, PackageType } from './components/Orb.js';
 export { PolicyDocument, PolicyDocumentProps } from './components/PolicyDocument.js';
 export { default as StarryBackground } from './components/StarryBackground.js';
 export { ThemeSwitcher, ThemeSwitcherProps } from './components/ThemeSwitcher.js';
+export { DocsLabels, docsLabels } from './docsLabels.js';
 export { I18nContextValue, I18nKit, I18nProviderProps, LocaleState, LocaleStateOptions, LocaleVariant, createI18n, useLocaleState } from './i18n.js';
 export { DEFAULT_LOCALE, LOCALE_STORAGE_KEY, LocaleSignals, TUWA_LOCALES, TuwaLocale, detectLocale, formatLabel, normalizeLocale, policyLanguageOf, resolveClientLocale } from './locale.js';
+export { LocalizePageMapOptions, localizePageMap } from './pageMap.js';
 export { POLICIES_INDEX_URL, POLICY_DOCUMENT_LABELS, POLICY_LANGUAGES, POLICY_LANGUAGE_NAMES, POLICY_SITE_URL, POLICY_SOURCE, Policy, PolicyContent, PolicyDocumentLabels, PolicyLanguage, PolicySection, PolicySlug, footerPolicies, formatPolicyDate, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, policyLanguageFrom, publishedPolicies } from './policies.js';
 export { PREFERENCE_DAYS, PreferenceExpiry, expireStoredPreferences } from './preferences.js';
 export { baseFooterLinks, baseNavLinks } from './utils.js';
 import 'react';
+import 'nextra';

package/dist/index.js

@@ -7,8 +7,10 @@ export * from "./components/Orb";
 export * from "./components/PolicyDocument";
 import { default as default3 } from "./components/StarryBackground";
 export * from "./components/ThemeSwitcher";
+export * from "./docsLabels";
 export * from "./i18n";
 export * from "./locale";
+export * from "./pageMap";
 export * from "./policies";
 export * from "./preferences";
 export * from "./utils";

package/dist/nextra.cjs

@@ -0,0 +1,26 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var nextra_exports = {};
+module.exports = __toCommonJS(nextra_exports);
+__reExport(nextra_exports, require("./components/DocsLayout"), module.exports);
+__reExport(nextra_exports, require("./components/LocalizedPage"), module.exports);
+__reExport(nextra_exports, require("./docsI18n"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./components/DocsLayout"),
+  ...require("./components/LocalizedPage"),
+  ...require("./docsI18n")
+});

package/dist/nextra.d.cts

@@ -0,0 +1,11 @@
+export { DocsLayout, DocsLayoutProps, NextraDocsLayout, NextraDocsLayoutProps } from './components/DocsLayout.cjs';
+export { LocalizedPage, LocalizedPageProps, LocalizedPageVariant } from './components/LocalizedPage.cjs';
+export { DocsI18nProvider, useDocsI18n } from './docsI18n.cjs';
+import 'react';
+import 'nextra';
+import 'nextra-theme-docs';
+import './docsLabels.cjs';
+import './locale.cjs';
+import './policies.cjs';
+import './components/NavBar.cjs';
+import './i18n.cjs';

package/dist/nextra.d.ts

@@ -0,0 +1,11 @@
+export { DocsLayout, DocsLayoutProps, NextraDocsLayout, NextraDocsLayoutProps } from './components/DocsLayout.js';
+export { LocalizedPage, LocalizedPageProps, LocalizedPageVariant } from './components/LocalizedPage.js';
+export { DocsI18nProvider, useDocsI18n } from './docsI18n.js';
+import 'react';
+import 'nextra';
+import 'nextra-theme-docs';
+import './docsLabels.js';
+import './locale.js';
+import './policies.js';
+import './components/NavBar.js';
+import './i18n.js';

package/dist/nextra.js

@@ -0,0 +1,3 @@
+export * from "./components/DocsLayout";
+export * from "./components/LocalizedPage";
+export * from "./docsI18n";

package/dist/pageMap.cjs

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pageMap_exports = {};
+__export(pageMap_exports, {
+  localizePageMap: () => localizePageMap
+});
+module.exports = __toCommonJS(pageMap_exports);
+function localizeMetaValue(value, routeTitle, titles) {
+  if (typeof value === "string") return routeTitle ?? titles[value] ?? value;
+  if (!value || typeof value !== "object" || !("title" in value)) return value;
+  const title = value.title;
+  const translated = routeTitle ?? (typeof title === "string" ? titles[title] : void 0);
+  return translated ? { ...value, title: translated } : value;
+}
+function localizeItems(items, titles, routes, parent) {
+  const routeTitle = (name) => routes[parent ? `${parent}/${name}` : name] ?? routes[name];
+  return items.map((item) => {
+    if ("data" in item) {
+      const data = Object.fromEntries(
+        Object.entries(item.data).map(([key, value]) => [key, localizeMetaValue(value, routeTitle(key), titles)])
+      );
+      return { ...item, data };
+    }
+    const copy = { ...item };
+    const name = item.name;
+    const route = typeof name === "string" ? parent ? `${parent}/${name}` : name : parent;
+    const byRoute = typeof name === "string" ? routeTitle(name) : void 0;
+    const title = item.title;
+    if (byRoute) copy.title = byRoute;
+    else if (typeof title === "string" && titles[title]) copy.title = titles[title];
+    if ("frontMatter" in item && item.frontMatter) {
+      const frontTitle = item.frontMatter.title;
+      const translated = byRoute ?? (typeof frontTitle === "string" ? titles[frontTitle] : void 0);
+      if (translated) copy.frontMatter = { ...item.frontMatter, title: translated };
+    }
+    if ("children" in item && Array.isArray(item.children)) {
+      copy.children = localizeItems(item.children, titles, routes, route);
+    }
+    return copy;
+  });
+}
+function localizePageMap(pageMap, titles, options = {}) {
+  const routes = options.routes ?? {};
+  if (Object.keys(titles).length === 0 && Object.keys(routes).length === 0) return pageMap;
+  return localizeItems(pageMap, titles, routes);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  localizePageMap
+});

package/dist/pageMap.d.cts

@@ -0,0 +1,33 @@
+import { PageMapItem } from 'nextra';
+
+/** Options of {@link localizePageMap}. */
+interface LocalizePageMapOptions {
+    /**
+     * Translated titles by route instead of English title: `<folder>/<name>` (for example `guides/full-stack-react`),
+     * then the bare `<name>` (`guides`, `index`). A route title wins over an English title and also replaces the front
+     * matter `title`. The docs hub keys its sidebar this way.
+     */
+    routes?: Readonly<Record<string, string>>;
+}
+/**
+ * Translates the titles of a Nextra page map: the sidebar, the top-level menu, the breadcrumbs and the previous / next
+ * links all read them. The project sites match titles by their English text (the `_meta` titles, the `title` of each
+ * item and the front matter `title`), so a site lists each English title once, whatever the page; titles without a
+ * translation, such as package names, stay as they are. The docs hub matches them by route instead
+ * (`options.routes`). The page map is not modified: changed items are copied.
+ *
+ * @example
+ * ```ts
+ * localizePageMap(pageMap, { Introduction: 'Вступ', Packages: 'Пакети' });
+ * localizePageMap(pageMap, {}, { routes: { guides: 'Посібники', 'guides/starter-templates': 'Стартові шаблони' } });
+ * ```
+ *
+ * @param pageMap - The page map of the site, the result of `getPageMap()` of `nextra/page-map`.
+ * @param titles - Translated titles by English title.
+ * @param options - See {@link LocalizePageMapOptions}.
+ * @returns The page map with translated titles, or `pageMap` itself when there is nothing to translate.
+ */
+declare function localizePageMap(pageMap: PageMapItem[], titles: Readonly<Record<string, string>>, options?: LocalizePageMapOptions): PageMapItem[];
+
+export { localizePageMap };
+export type { LocalizePageMapOptions };

package/dist/pageMap.d.ts

@@ -0,0 +1,33 @@
+import { PageMapItem } from 'nextra';
+
+/** Options of {@link localizePageMap}. */
+interface LocalizePageMapOptions {
+    /**
+     * Translated titles by route instead of English title: `<folder>/<name>` (for example `guides/full-stack-react`),
+     * then the bare `<name>` (`guides`, `index`). A route title wins over an English title and also replaces the front
+     * matter `title`. The docs hub keys its sidebar this way.
+     */
+    routes?: Readonly<Record<string, string>>;
+}
+/**
+ * Translates the titles of a Nextra page map: the sidebar, the top-level menu, the breadcrumbs and the previous / next
+ * links all read them. The project sites match titles by their English text (the `_meta` titles, the `title` of each
+ * item and the front matter `title`), so a site lists each English title once, whatever the page; titles without a
+ * translation, such as package names, stay as they are. The docs hub matches them by route instead
+ * (`options.routes`). The page map is not modified: changed items are copied.
+ *
+ * @example
+ * ```ts
+ * localizePageMap(pageMap, { Introduction: 'Вступ', Packages: 'Пакети' });
+ * localizePageMap(pageMap, {}, { routes: { guides: 'Посібники', 'guides/starter-templates': 'Стартові шаблони' } });
+ * ```
+ *
+ * @param pageMap - The page map of the site, the result of `getPageMap()` of `nextra/page-map`.
+ * @param titles - Translated titles by English title.
+ * @param options - See {@link LocalizePageMapOptions}.
+ * @returns The page map with translated titles, or `pageMap` itself when there is nothing to translate.
+ */
+declare function localizePageMap(pageMap: PageMapItem[], titles: Readonly<Record<string, string>>, options?: LocalizePageMapOptions): PageMapItem[];
+
+export { localizePageMap };
+export type { LocalizePageMapOptions };

package/dist/pageMap.js

@@ -0,0 +1,42 @@
+function localizeMetaValue(value, routeTitle, titles) {
+  if (typeof value === "string") return routeTitle ?? titles[value] ?? value;
+  if (!value || typeof value !== "object" || !("title" in value)) return value;
+  const title = value.title;
+  const translated = routeTitle ?? (typeof title === "string" ? titles[title] : void 0);
+  return translated ? { ...value, title: translated } : value;
+}
+function localizeItems(items, titles, routes, parent) {
+  const routeTitle = (name) => routes[parent ? `${parent}/${name}` : name] ?? routes[name];
+  return items.map((item) => {
+    if ("data" in item) {
+      const data = Object.fromEntries(
+        Object.entries(item.data).map(([key, value]) => [key, localizeMetaValue(value, routeTitle(key), titles)])
+      );
+      return { ...item, data };
+    }
+    const copy = { ...item };
+    const name = item.name;
+    const route = typeof name === "string" ? parent ? `${parent}/${name}` : name : parent;
+    const byRoute = typeof name === "string" ? routeTitle(name) : void 0;
+    const title = item.title;
+    if (byRoute) copy.title = byRoute;
+    else if (typeof title === "string" && titles[title]) copy.title = titles[title];
+    if ("frontMatter" in item && item.frontMatter) {
+      const frontTitle = item.frontMatter.title;
+      const translated = byRoute ?? (typeof frontTitle === "string" ? titles[frontTitle] : void 0);
+      if (translated) copy.frontMatter = { ...item.frontMatter, title: translated };
+    }
+    if ("children" in item && Array.isArray(item.children)) {
+      copy.children = localizeItems(item.children, titles, routes, route);
+    }
+    return copy;
+  });
+}
+function localizePageMap(pageMap, titles, options = {}) {
+  const routes = options.routes ?? {};
+  if (Object.keys(titles).length === 0 && Object.keys(routes).length === 0) return pageMap;
+  return localizeItems(pageMap, titles, routes);
+}
+export {
+  localizePageMap
+};