@tuwaio/docs-ui 0.5.7 → 0.7.0

package/dist/components/LocalizedPage.d.cts

@@ -0,0 +1,37 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { Heading, $NextraMetadata } from 'nextra';
+import { TuwaLocale } from '../locale.cjs';
+
+/** One language of a page: the rendered MDX and what the Nextra page wrapper needs. */
+interface LocalizedPageVariant {
+    /** The rendered MDX content. */
+    content: ReactNode;
+    /** The table of contents of the MDX file (its `toc` export). */
+    toc: Heading[];
+    /** The metadata of the MDX file (its `metadata` export): the title, the file of the edit link, the last change. */
+    metadata: $NextraMetadata;
+    /** The source of the MDX file (its `sourceCode` export), for the copy-page button. */
+    sourceCode?: string;
+}
+/** Props of {@link LocalizedPage}. */
+interface LocalizedPageProps {
+    /** The page in English (the server renders it) and in the languages it is translated into. */
+    variants: Partial<Record<TuwaLocale, LocalizedPageVariant>> & {
+        en: LocalizedPageVariant;
+    };
+}
+/**
+ * A page of a TUWA documentation site in the language of the reader, inside the Nextra page wrapper (sidebar, table of
+ * contents, breadcrumbs, pagination). All variants come prerendered from the server, so switching the language makes no
+ * request and the URL stays the same; the server HTML and the search index hold English. A page without a translation
+ * in the active language (package READMEs and the generated API reference) shows English with a short note in that
+ * language. Must be rendered inside {@link DocsLayout}; `createDocsPage` (`@tuwaio/docs-ui/nextra/page`) renders it.
+ *
+ * @param props - See {@link LocalizedPageProps}.
+ * @returns The page.
+ */
+declare function LocalizedPage({ variants }: LocalizedPageProps): react.JSX.Element;
+
+export { LocalizedPage };
+export type { LocalizedPageProps, LocalizedPageVariant };

package/dist/components/LocalizedPage.d.ts

@@ -0,0 +1,37 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { Heading, $NextraMetadata } from 'nextra';
+import { TuwaLocale } from '../locale.js';
+
+/** One language of a page: the rendered MDX and what the Nextra page wrapper needs. */
+interface LocalizedPageVariant {
+    /** The rendered MDX content. */
+    content: ReactNode;
+    /** The table of contents of the MDX file (its `toc` export). */
+    toc: Heading[];
+    /** The metadata of the MDX file (its `metadata` export): the title, the file of the edit link, the last change. */
+    metadata: $NextraMetadata;
+    /** The source of the MDX file (its `sourceCode` export), for the copy-page button. */
+    sourceCode?: string;
+}
+/** Props of {@link LocalizedPage}. */
+interface LocalizedPageProps {
+    /** The page in English (the server renders it) and in the languages it is translated into. */
+    variants: Partial<Record<TuwaLocale, LocalizedPageVariant>> & {
+        en: LocalizedPageVariant;
+    };
+}
+/**
+ * A page of a TUWA documentation site in the language of the reader, inside the Nextra page wrapper (sidebar, table of
+ * contents, breadcrumbs, pagination). All variants come prerendered from the server, so switching the language makes no
+ * request and the URL stays the same; the server HTML and the search index hold English. A page without a translation
+ * in the active language (package READMEs and the generated API reference) shows English with a short note in that
+ * language. Must be rendered inside {@link DocsLayout}; `createDocsPage` (`@tuwaio/docs-ui/nextra/page`) renders it.
+ *
+ * @param props - See {@link LocalizedPageProps}.
+ * @returns The page.
+ */
+declare function LocalizedPage({ variants }: LocalizedPageProps): react.JSX.Element;
+
+export { LocalizedPage };
+export type { LocalizedPageProps, LocalizedPageVariant };

package/dist/components/LocalizedPage.js

@@ -0,0 +1,18 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Callout } from "nextra/components";
+import { useMDXComponents } from "nextra-theme-docs";
+import { useDocsI18n } from "../docsI18n";
+function LocalizedPage({ variants }) {
+  const { locale, t } = useDocsI18n();
+  const Wrapper = useMDXComponents().wrapper;
+  const translated = variants[locale];
+  const page = translated ?? variants.en;
+  return /* @__PURE__ */ jsxs(Wrapper, { toc: page.toc, metadata: page.metadata, sourceCode: page.sourceCode, children: [
+    !translated && /* @__PURE__ */ jsx("div", { className: "tuwadocs:clear-both", children: /* @__PURE__ */ jsx(Callout, { type: "info", children: t.englishOnly }) }),
+    page.content
+  ] });
+}
+export {
+  LocalizedPage
+};

package/dist/docsI18n.cjs

@@ -0,0 +1,33 @@
+"use strict";
+"use client";
+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 docsI18n_exports = {};
+__export(docsI18n_exports, {
+  DocsI18nProvider: () => DocsI18nProvider,
+  useDocsI18n: () => useDocsI18n
+});
+module.exports = __toCommonJS(docsI18n_exports);
+var import_docsLabels = require("./docsLabels");
+var import_i18n = require("./i18n");
+const { I18nProvider: DocsI18nProvider, useI18n: useDocsI18n } = (0, import_i18n.createI18n)(import_docsLabels.docsLabels);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DocsI18nProvider,
+  useDocsI18n
+});

package/dist/docsI18n.d.cts

@@ -0,0 +1,16 @@
+import { DocsLabels } from './docsLabels.cjs';
+import * as react from 'react';
+import { I18nProviderProps, I18nContextValue } from './i18n.cjs';
+import './locale.cjs';
+import './policies.cjs';
+
+/**
+ * The i18n kit of the TUWA documentation sites, on {@link docsLabels}: `DocsI18nProvider` provides the language of the
+ * reader and the interface texts, `useDocsI18n` reads them (outside the provider: English and a no-op setter).
+ * `DocsLayout` renders the provider, so a site's client components inside the layout call `useDocsI18n` directly.
+ * The language is detected after mount and kept under `tuwa-locale` in Local Storage (list it in `PreferenceExpiry`).
+ */
+declare const DocsI18nProvider: react.ComponentType<I18nProviderProps>;
+declare const useDocsI18n: () => I18nContextValue<DocsLabels>;
+
+export { DocsI18nProvider, useDocsI18n };

package/dist/docsI18n.d.ts

@@ -0,0 +1,16 @@
+import { DocsLabels } from './docsLabels.js';
+import * as react from 'react';
+import { I18nProviderProps, I18nContextValue } from './i18n.js';
+import './locale.js';
+import './policies.js';
+
+/**
+ * The i18n kit of the TUWA documentation sites, on {@link docsLabels}: `DocsI18nProvider` provides the language of the
+ * reader and the interface texts, `useDocsI18n` reads them (outside the provider: English and a no-op setter).
+ * `DocsLayout` renders the provider, so a site's client components inside the layout call `useDocsI18n` directly.
+ * The language is detected after mount and kept under `tuwa-locale` in Local Storage (list it in `PreferenceExpiry`).
+ */
+declare const DocsI18nProvider: react.ComponentType<I18nProviderProps>;
+declare const useDocsI18n: () => I18nContextValue<DocsLabels>;
+
+export { DocsI18nProvider, useDocsI18n };

package/dist/docsI18n.js

@@ -0,0 +1,8 @@
+"use client";
+import { docsLabels } from "./docsLabels";
+import { createI18n } from "./i18n";
+const { I18nProvider: DocsI18nProvider, useI18n: useDocsI18n } = createI18n(docsLabels);
+export {
+  DocsI18nProvider,
+  useDocsI18n
+};

package/dist/docsLabels.cjs

@@ -0,0 +1,140 @@
+"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 docsLabels_exports = {};
+__export(docsLabels_exports, {
+  docsLabels: () => docsLabels
+});
+module.exports = __toCommonJS(docsLabels_exports);
+const en = {
+  selectLanguage: "Select language",
+  nextra: {
+    onThisPage: "On This Page",
+    scrollToTop: "Scroll to top",
+    editThisPage: "Edit this page",
+    feedback: "Question? Give us feedback",
+    lastUpdated: "Last updated on",
+    searchPlaceholder: "Search documentation\u2026",
+    searchEmpty: "No results found.",
+    searchError: "Failed to load search index.",
+    searchLoading: "Loading\u2026",
+    themeLight: "Light",
+    themeDark: "Dark",
+    themeSystem: "System"
+  },
+  footer: {
+    description: "The modular, headless-first Web3 infrastructure. Build self-custodial applications on open-source, portable building blocks.",
+    license: "Licensed under Apache 2.0. Open source and free to use.",
+    policiesAriaLabel: "Policies",
+    allPolicies: "All policies",
+    copyright: "All rights reserved.",
+    policyTitles: {
+      terms: "Terms of Service",
+      privacy: "Privacy Policy",
+      cookie: "Cookie Policy",
+      refund: "Refund Policy",
+      security: "Security Policy",
+      dpa: "Data Processing Addendum"
+    }
+  },
+  englishOnly: "This page is in English only: package READMEs and the API reference are generated from the source code and are not translated.",
+  sidebar: {}
+};
+const uk = {
+  selectLanguage: "\u041E\u0431\u0435\u0440\u0456\u0442\u044C \u043C\u043E\u0432\u0443",
+  nextra: {
+    onThisPage: "\u041D\u0430 \u0446\u0456\u0439 \u0441\u0442\u043E\u0440\u0456\u043D\u0446\u0456",
+    scrollToTop: "\u041F\u0440\u043E\u043A\u0440\u0443\u0442\u0438\u0442\u0438 \u0432\u0433\u043E\u0440\u0443",
+    editThisPage: "\u0420\u0435\u0434\u0430\u0433\u0443\u0432\u0430\u0442\u0438 \u0446\u044E \u0441\u0442\u043E\u0440\u0456\u043D\u043A\u0443",
+    feedback: "\u0404 \u0437\u0430\u043F\u0438\u0442\u0430\u043D\u043D\u044F? \u0417\u0430\u043B\u0438\u0448\u0442\u0435 \u0432\u0456\u0434\u0433\u0443\u043A",
+    lastUpdated: "\u0412\u043E\u0441\u0442\u0430\u043D\u043D\u0454 \u043E\u043D\u043E\u0432\u043B\u0435\u043D\u043E",
+    searchPlaceholder: "\u041F\u043E\u0448\u0443\u043A \u0443 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0456\u0457\u2026",
+    searchEmpty: "\u041D\u0456\u0447\u043E\u0433\u043E \u043D\u0435 \u0437\u043D\u0430\u0439\u0434\u0435\u043D\u043E.",
+    searchError: "\u041D\u0435 \u0432\u0434\u0430\u043B\u043E\u0441\u044F \u0437\u0430\u0432\u0430\u043D\u0442\u0430\u0436\u0438\u0442\u0438 \u043F\u043E\u0448\u0443\u043A\u043E\u0432\u0438\u0439 \u0456\u043D\u0434\u0435\u043A\u0441.",
+    searchLoading: "\u0417\u0430\u0432\u0430\u043D\u0442\u0430\u0436\u0435\u043D\u043D\u044F\u2026",
+    themeLight: "\u0421\u0432\u0456\u0442\u043B\u0430",
+    themeDark: "\u0422\u0435\u043C\u043D\u0430",
+    themeSystem: "\u0421\u0438\u0441\u0442\u0435\u043C\u043D\u0430"
+  },
+  footer: {
+    description: "\u041C\u043E\u0434\u0443\u043B\u044C\u043D\u0430, headless-first Web3-\u0456\u043D\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0430. \u0411\u0443\u0434\u0443\u0439\u0442\u0435 self-custodial \u0437\u0430\u0441\u0442\u043E\u0441\u0443\u043D\u043A\u0438 \u043D\u0430 \u0431\u0430\u0437\u0456 \u0432\u0456\u0434\u043A\u0440\u0438\u0442\u0438\u0445 \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u0456\u0432.",
+    license: "\u041B\u0456\u0446\u0435\u043D\u0437\u043E\u0432\u0430\u043D\u043E \u043F\u0456\u0434 Apache 2.0. \u0412\u0456\u0434\u043A\u0440\u0438\u0442\u0438\u0439 \u043A\u043E\u0434 \u0442\u0430 \u0431\u0435\u0437\u043A\u043E\u0448\u0442\u043E\u0432\u043D\u0435 \u0432\u0438\u043A\u043E\u0440\u0438\u0441\u0442\u0430\u043D\u043D\u044F.",
+    policiesAriaLabel: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0438",
+    allPolicies: "\u0423\u0441\u0456 \u043F\u043E\u043B\u0456\u0442\u0438\u043A\u0438",
+    copyright: "\u0423\u0441\u0456 \u043F\u0440\u0430\u0432\u0430 \u0437\u0430\u0445\u0438\u0449\u0435\u043D\u043E.",
+    policyTitles: {
+      terms: "\u0423\u043C\u043E\u0432\u0438 \u0432\u0438\u043A\u043E\u0440\u0438\u0441\u0442\u0430\u043D\u043D\u044F",
+      privacy: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u043A\u043E\u043D\u0444\u0456\u0434\u0435\u043D\u0446\u0456\u0439\u043D\u043E\u0441\u0442\u0456",
+      cookie: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u0444\u0430\u0439\u043B\u0456\u0432 cookie",
+      refund: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u043F\u043E\u0432\u0435\u0440\u043D\u0435\u043D\u043D\u044F \u043A\u043E\u0448\u0442\u0456\u0432",
+      security: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u0431\u0435\u0437\u043F\u0435\u043A\u0438",
+      dpa: "\u0414\u043E\u043F\u043E\u0432\u043D\u0435\u043D\u043D\u044F \u0449\u043E\u0434\u043E \u043E\u0431\u0440\u043E\u0431\u043A\u0438 \u0434\u0430\u043D\u0438\u0445"
+    }
+  },
+  englishOnly: "\u0426\u044F \u0441\u0442\u043E\u0440\u0456\u043D\u043A\u0430 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u0430 \u043B\u0438\u0448\u0435 \u0430\u043D\u0433\u043B\u0456\u0439\u0441\u044C\u043A\u043E\u044E: README \u043F\u0430\u043A\u0435\u0442\u0456\u0432 \u0456 \u0434\u043E\u0432\u0456\u0434\u043D\u0438\u043A API \u0433\u0435\u043D\u0435\u0440\u0443\u044E\u0442\u044C\u0441\u044F \u0437 \u0432\u0438\u0445\u0456\u0434\u043D\u043E\u0433\u043E \u043A\u043E\u0434\u0443 \u0439 \u043D\u0435 \u043F\u0435\u0440\u0435\u043A\u043B\u0430\u0434\u0430\u044E\u0442\u044C\u0441\u044F.",
+  sidebar: {
+    Introduction: "\u0412\u0441\u0442\u0443\u043F",
+    Packages: "\u041F\u0430\u043A\u0435\u0442\u0438",
+    Guides: "\u041F\u043E\u0441\u0456\u0431\u043D\u0438\u043A\u0438",
+    Overview: "\u041E\u0433\u043B\u044F\u0434"
+  }
+};
+const zhCN = {
+  selectLanguage: "\u9009\u62E9\u8BED\u8A00",
+  nextra: {
+    onThisPage: "\u672C\u9875\u76EE\u5F55",
+    scrollToTop: "\u8FD4\u56DE\u9876\u90E8",
+    editThisPage: "\u7F16\u8F91\u6B64\u9875",
+    feedback: "\u6709\u7591\u95EE\uFF1F\u5411\u6211\u4EEC\u53CD\u9988",
+    lastUpdated: "\u6700\u540E\u66F4\u65B0\u4E8E",
+    searchPlaceholder: "\u641C\u7D22\u6587\u6863\u2026",
+    searchEmpty: "\u672A\u627E\u5230\u5339\u914D\u7ED3\u679C\u3002",
+    searchError: "\u52A0\u8F7D\u641C\u7D22\u7D22\u5F15\u5931\u8D25\u3002",
+    searchLoading: "\u6B63\u5728\u52A0\u8F7D\u2026",
+    themeLight: "\u6D45\u8272",
+    themeDark: "\u6DF1\u8272",
+    themeSystem: "\u8DDF\u968F\u7CFB\u7EDF"
+  },
+  footer: {
+    description: "\u6A21\u5757\u5316\u3001\u65E0\u5934\u4F18\u5148\u7684 Web3 \u57FA\u7840\u8BBE\u65BD\u3002\u501F\u52A9\u5F00\u6E90\u4E14\u9AD8\u5EA6\u53EF\u79FB\u690D\u7684\u5E95\u5C42\u6784\u5EFA\u5757\uFF0C\u6253\u9020\u771F\u6B63\u7684\u81EA\u6258\u7BA1\u5E94\u7528\u3002",
+    license: "\u57FA\u4E8E Apache 2.0 \u534F\u8BAE\u5F00\u6E90\u3002\u5B8C\u5168\u514D\u8D39\u4F7F\u7528\u3002",
+    policiesAriaLabel: "\u6CD5\u5F8B\u4E0E\u5B89\u5168\u653F\u7B56",
+    allPolicies: "\u5168\u90E8\u653F\u7B56",
+    copyright: "\u4FDD\u7559\u6240\u6709\u6743\u5229\u3002",
+    policyTitles: {
+      terms: "\u670D\u52A1\u6761\u6B3E",
+      privacy: "\u9690\u79C1\u653F\u7B56",
+      cookie: "Cookie \u653F\u7B56",
+      refund: "\u9000\u6B3E\u653F\u7B56",
+      security: "\u5B89\u5168\u653F\u7B56",
+      dpa: "\u6570\u636E\u5904\u7406\u9644\u5F55 (DPA)"
+    }
+  },
+  englishOnly: "\u672C\u9875\u4EC5\u63D0\u4F9B\u82F1\u6587\u7248\uFF1A\u8F6F\u4EF6\u5305 README \u4E0E API \u53C2\u8003\u7531\u6E90\u4EE3\u7801\u751F\u6210\uFF0C\u4E0D\u63D0\u4F9B\u7FFB\u8BD1\u3002",
+  sidebar: {
+    Introduction: "\u7B80\u4ECB",
+    Packages: "\u8F6F\u4EF6\u5305",
+    Guides: "\u6307\u5357",
+    Overview: "\u6982\u89C8"
+  }
+};
+const docsLabels = { en, uk, "zh-CN": zhCN };
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  docsLabels
+});

package/dist/docsLabels.d.cts

@@ -0,0 +1,72 @@
+import { TuwaLocale } from './locale.cjs';
+import { PolicySlug } from './policies.cjs';
+
+/**
+ * Texts of the interface of a TUWA documentation site (the Nextra chrome, the footer, the language switch and the
+ * note on pages that stay in English), shared by the project sites and the docs hub so every site words them the same
+ * way. Page content is not part of it: each site keeps its own translated pages.
+ */
+interface DocsLabels {
+    /** Accessible name of the language switch in the navbar. */
+    selectLanguage: string;
+    /** The parts of the Nextra layout, passed to its props by `DocsLayout`. */
+    nextra: {
+        /** Title of the table of contents. */
+        onThisPage: string;
+        /** The button below the table of contents. */
+        scrollToTop: string;
+        /** The link to the source of the page on GitHub. */
+        editThisPage: string;
+        /** The link to a new GitHub issue about the page. */
+        feedback: string;
+        /** Text before the date of the last change of the page. */
+        lastUpdated: string;
+        /** Placeholder of the search field. */
+        searchPlaceholder: string;
+        /** Shown when the search finds nothing. */
+        searchEmpty: string;
+        /** Shown when the search index cannot be loaded. */
+        searchError: string;
+        /** Shown while the search index loads. */
+        searchLoading: string;
+        /** The light option of the theme switch. */
+        themeLight: string;
+        /** The dark option of the theme switch. */
+        themeDark: string;
+        /** The system option of the theme switch. */
+        themeSystem: string;
+    };
+    /** The texts of the docs-ui `Footer` (its `labels` prop). */
+    footer: {
+        /** Description of TUWA. */
+        description: string;
+        /** License notice. */
+        license: string;
+        /** Accessible name of the policies nav. */
+        policiesAriaLabel: string;
+        /** The link to all policies. */
+        allPolicies: string;
+        /** Copyright text after the year. */
+        copyright: string;
+        /** Titles of the policies. */
+        policyTitles: Record<PolicySlug, string>;
+    };
+    /**
+     * The note above a page that has no translation in the active language: on the project sites these are the package
+     * READMEs and the generated API reference, which stay in English.
+     */
+    englishOnly: string;
+    /**
+     * Sidebar titles that every documentation site uses, by their English title (`Introduction`, `Packages`, `Guides`,
+     * `Overview`). Empty for English.
+     */
+    sidebar: Record<string, string>;
+}
+/**
+ * The {@link DocsLabels} of every {@link TuwaLocale}. `DocsLayout` and `LocalizedPage` (`@tuwaio/docs-ui/nextra`) read
+ * them; the docs hub builds its own dictionaries on them.
+ */
+declare const docsLabels: Readonly<Record<TuwaLocale, DocsLabels>>;
+
+export { docsLabels };
+export type { DocsLabels };

package/dist/docsLabels.d.ts

@@ -0,0 +1,72 @@
+import { TuwaLocale } from './locale.js';
+import { PolicySlug } from './policies.js';
+
+/**
+ * Texts of the interface of a TUWA documentation site (the Nextra chrome, the footer, the language switch and the
+ * note on pages that stay in English), shared by the project sites and the docs hub so every site words them the same
+ * way. Page content is not part of it: each site keeps its own translated pages.
+ */
+interface DocsLabels {
+    /** Accessible name of the language switch in the navbar. */
+    selectLanguage: string;
+    /** The parts of the Nextra layout, passed to its props by `DocsLayout`. */
+    nextra: {
+        /** Title of the table of contents. */
+        onThisPage: string;
+        /** The button below the table of contents. */
+        scrollToTop: string;
+        /** The link to the source of the page on GitHub. */
+        editThisPage: string;
+        /** The link to a new GitHub issue about the page. */
+        feedback: string;
+        /** Text before the date of the last change of the page. */
+        lastUpdated: string;
+        /** Placeholder of the search field. */
+        searchPlaceholder: string;
+        /** Shown when the search finds nothing. */
+        searchEmpty: string;
+        /** Shown when the search index cannot be loaded. */
+        searchError: string;
+        /** Shown while the search index loads. */
+        searchLoading: string;
+        /** The light option of the theme switch. */
+        themeLight: string;
+        /** The dark option of the theme switch. */
+        themeDark: string;
+        /** The system option of the theme switch. */
+        themeSystem: string;
+    };
+    /** The texts of the docs-ui `Footer` (its `labels` prop). */
+    footer: {
+        /** Description of TUWA. */
+        description: string;
+        /** License notice. */
+        license: string;
+        /** Accessible name of the policies nav. */
+        policiesAriaLabel: string;
+        /** The link to all policies. */
+        allPolicies: string;
+        /** Copyright text after the year. */
+        copyright: string;
+        /** Titles of the policies. */
+        policyTitles: Record<PolicySlug, string>;
+    };
+    /**
+     * The note above a page that has no translation in the active language: on the project sites these are the package
+     * READMEs and the generated API reference, which stay in English.
+     */
+    englishOnly: string;
+    /**
+     * Sidebar titles that every documentation site uses, by their English title (`Introduction`, `Packages`, `Guides`,
+     * `Overview`). Empty for English.
+     */
+    sidebar: Record<string, string>;
+}
+/**
+ * The {@link DocsLabels} of every {@link TuwaLocale}. `DocsLayout` and `LocalizedPage` (`@tuwaio/docs-ui/nextra`) read
+ * them; the docs hub builds its own dictionaries on them.
+ */
+declare const docsLabels: Readonly<Record<TuwaLocale, DocsLabels>>;
+
+export { docsLabels };
+export type { DocsLabels };

package/dist/docsLabels.js

@@ -0,0 +1,116 @@
+const en = {
+  selectLanguage: "Select language",
+  nextra: {
+    onThisPage: "On This Page",
+    scrollToTop: "Scroll to top",
+    editThisPage: "Edit this page",
+    feedback: "Question? Give us feedback",
+    lastUpdated: "Last updated on",
+    searchPlaceholder: "Search documentation\u2026",
+    searchEmpty: "No results found.",
+    searchError: "Failed to load search index.",
+    searchLoading: "Loading\u2026",
+    themeLight: "Light",
+    themeDark: "Dark",
+    themeSystem: "System"
+  },
+  footer: {
+    description: "The modular, headless-first Web3 infrastructure. Build self-custodial applications on open-source, portable building blocks.",
+    license: "Licensed under Apache 2.0. Open source and free to use.",
+    policiesAriaLabel: "Policies",
+    allPolicies: "All policies",
+    copyright: "All rights reserved.",
+    policyTitles: {
+      terms: "Terms of Service",
+      privacy: "Privacy Policy",
+      cookie: "Cookie Policy",
+      refund: "Refund Policy",
+      security: "Security Policy",
+      dpa: "Data Processing Addendum"
+    }
+  },
+  englishOnly: "This page is in English only: package READMEs and the API reference are generated from the source code and are not translated.",
+  sidebar: {}
+};
+const uk = {
+  selectLanguage: "\u041E\u0431\u0435\u0440\u0456\u0442\u044C \u043C\u043E\u0432\u0443",
+  nextra: {
+    onThisPage: "\u041D\u0430 \u0446\u0456\u0439 \u0441\u0442\u043E\u0440\u0456\u043D\u0446\u0456",
+    scrollToTop: "\u041F\u0440\u043E\u043A\u0440\u0443\u0442\u0438\u0442\u0438 \u0432\u0433\u043E\u0440\u0443",
+    editThisPage: "\u0420\u0435\u0434\u0430\u0433\u0443\u0432\u0430\u0442\u0438 \u0446\u044E \u0441\u0442\u043E\u0440\u0456\u043D\u043A\u0443",
+    feedback: "\u0404 \u0437\u0430\u043F\u0438\u0442\u0430\u043D\u043D\u044F? \u0417\u0430\u043B\u0438\u0448\u0442\u0435 \u0432\u0456\u0434\u0433\u0443\u043A",
+    lastUpdated: "\u0412\u043E\u0441\u0442\u0430\u043D\u043D\u0454 \u043E\u043D\u043E\u0432\u043B\u0435\u043D\u043E",
+    searchPlaceholder: "\u041F\u043E\u0448\u0443\u043A \u0443 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0456\u0457\u2026",
+    searchEmpty: "\u041D\u0456\u0447\u043E\u0433\u043E \u043D\u0435 \u0437\u043D\u0430\u0439\u0434\u0435\u043D\u043E.",
+    searchError: "\u041D\u0435 \u0432\u0434\u0430\u043B\u043E\u0441\u044F \u0437\u0430\u0432\u0430\u043D\u0442\u0430\u0436\u0438\u0442\u0438 \u043F\u043E\u0448\u0443\u043A\u043E\u0432\u0438\u0439 \u0456\u043D\u0434\u0435\u043A\u0441.",
+    searchLoading: "\u0417\u0430\u0432\u0430\u043D\u0442\u0430\u0436\u0435\u043D\u043D\u044F\u2026",
+    themeLight: "\u0421\u0432\u0456\u0442\u043B\u0430",
+    themeDark: "\u0422\u0435\u043C\u043D\u0430",
+    themeSystem: "\u0421\u0438\u0441\u0442\u0435\u043C\u043D\u0430"
+  },
+  footer: {
+    description: "\u041C\u043E\u0434\u0443\u043B\u044C\u043D\u0430, headless-first Web3-\u0456\u043D\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0430. \u0411\u0443\u0434\u0443\u0439\u0442\u0435 self-custodial \u0437\u0430\u0441\u0442\u043E\u0441\u0443\u043D\u043A\u0438 \u043D\u0430 \u0431\u0430\u0437\u0456 \u0432\u0456\u0434\u043A\u0440\u0438\u0442\u0438\u0445 \u043A\u043E\u043C\u043F\u043E\u043D\u0435\u043D\u0442\u0456\u0432.",
+    license: "\u041B\u0456\u0446\u0435\u043D\u0437\u043E\u0432\u0430\u043D\u043E \u043F\u0456\u0434 Apache 2.0. \u0412\u0456\u0434\u043A\u0440\u0438\u0442\u0438\u0439 \u043A\u043E\u0434 \u0442\u0430 \u0431\u0435\u0437\u043A\u043E\u0448\u0442\u043E\u0432\u043D\u0435 \u0432\u0438\u043A\u043E\u0440\u0438\u0441\u0442\u0430\u043D\u043D\u044F.",
+    policiesAriaLabel: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0438",
+    allPolicies: "\u0423\u0441\u0456 \u043F\u043E\u043B\u0456\u0442\u0438\u043A\u0438",
+    copyright: "\u0423\u0441\u0456 \u043F\u0440\u0430\u0432\u0430 \u0437\u0430\u0445\u0438\u0449\u0435\u043D\u043E.",
+    policyTitles: {
+      terms: "\u0423\u043C\u043E\u0432\u0438 \u0432\u0438\u043A\u043E\u0440\u0438\u0441\u0442\u0430\u043D\u043D\u044F",
+      privacy: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u043A\u043E\u043D\u0444\u0456\u0434\u0435\u043D\u0446\u0456\u0439\u043D\u043E\u0441\u0442\u0456",
+      cookie: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u0444\u0430\u0439\u043B\u0456\u0432 cookie",
+      refund: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u043F\u043E\u0432\u0435\u0440\u043D\u0435\u043D\u043D\u044F \u043A\u043E\u0448\u0442\u0456\u0432",
+      security: "\u041F\u043E\u043B\u0456\u0442\u0438\u043A\u0430 \u0431\u0435\u0437\u043F\u0435\u043A\u0438",
+      dpa: "\u0414\u043E\u043F\u043E\u0432\u043D\u0435\u043D\u043D\u044F \u0449\u043E\u0434\u043E \u043E\u0431\u0440\u043E\u0431\u043A\u0438 \u0434\u0430\u043D\u0438\u0445"
+    }
+  },
+  englishOnly: "\u0426\u044F \u0441\u0442\u043E\u0440\u0456\u043D\u043A\u0430 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u0430 \u043B\u0438\u0448\u0435 \u0430\u043D\u0433\u043B\u0456\u0439\u0441\u044C\u043A\u043E\u044E: README \u043F\u0430\u043A\u0435\u0442\u0456\u0432 \u0456 \u0434\u043E\u0432\u0456\u0434\u043D\u0438\u043A API \u0433\u0435\u043D\u0435\u0440\u0443\u044E\u0442\u044C\u0441\u044F \u0437 \u0432\u0438\u0445\u0456\u0434\u043D\u043E\u0433\u043E \u043A\u043E\u0434\u0443 \u0439 \u043D\u0435 \u043F\u0435\u0440\u0435\u043A\u043B\u0430\u0434\u0430\u044E\u0442\u044C\u0441\u044F.",
+  sidebar: {
+    Introduction: "\u0412\u0441\u0442\u0443\u043F",
+    Packages: "\u041F\u0430\u043A\u0435\u0442\u0438",
+    Guides: "\u041F\u043E\u0441\u0456\u0431\u043D\u0438\u043A\u0438",
+    Overview: "\u041E\u0433\u043B\u044F\u0434"
+  }
+};
+const zhCN = {
+  selectLanguage: "\u9009\u62E9\u8BED\u8A00",
+  nextra: {
+    onThisPage: "\u672C\u9875\u76EE\u5F55",
+    scrollToTop: "\u8FD4\u56DE\u9876\u90E8",
+    editThisPage: "\u7F16\u8F91\u6B64\u9875",
+    feedback: "\u6709\u7591\u95EE\uFF1F\u5411\u6211\u4EEC\u53CD\u9988",
+    lastUpdated: "\u6700\u540E\u66F4\u65B0\u4E8E",
+    searchPlaceholder: "\u641C\u7D22\u6587\u6863\u2026",
+    searchEmpty: "\u672A\u627E\u5230\u5339\u914D\u7ED3\u679C\u3002",
+    searchError: "\u52A0\u8F7D\u641C\u7D22\u7D22\u5F15\u5931\u8D25\u3002",
+    searchLoading: "\u6B63\u5728\u52A0\u8F7D\u2026",
+    themeLight: "\u6D45\u8272",
+    themeDark: "\u6DF1\u8272",
+    themeSystem: "\u8DDF\u968F\u7CFB\u7EDF"
+  },
+  footer: {
+    description: "\u6A21\u5757\u5316\u3001\u65E0\u5934\u4F18\u5148\u7684 Web3 \u57FA\u7840\u8BBE\u65BD\u3002\u501F\u52A9\u5F00\u6E90\u4E14\u9AD8\u5EA6\u53EF\u79FB\u690D\u7684\u5E95\u5C42\u6784\u5EFA\u5757\uFF0C\u6253\u9020\u771F\u6B63\u7684\u81EA\u6258\u7BA1\u5E94\u7528\u3002",
+    license: "\u57FA\u4E8E Apache 2.0 \u534F\u8BAE\u5F00\u6E90\u3002\u5B8C\u5168\u514D\u8D39\u4F7F\u7528\u3002",
+    policiesAriaLabel: "\u6CD5\u5F8B\u4E0E\u5B89\u5168\u653F\u7B56",
+    allPolicies: "\u5168\u90E8\u653F\u7B56",
+    copyright: "\u4FDD\u7559\u6240\u6709\u6743\u5229\u3002",
+    policyTitles: {
+      terms: "\u670D\u52A1\u6761\u6B3E",
+      privacy: "\u9690\u79C1\u653F\u7B56",
+      cookie: "Cookie \u653F\u7B56",
+      refund: "\u9000\u6B3E\u653F\u7B56",
+      security: "\u5B89\u5168\u653F\u7B56",
+      dpa: "\u6570\u636E\u5904\u7406\u9644\u5F55 (DPA)"
+    }
+  },
+  englishOnly: "\u672C\u9875\u4EC5\u63D0\u4F9B\u82F1\u6587\u7248\uFF1A\u8F6F\u4EF6\u5305 README \u4E0E API \u53C2\u8003\u7531\u6E90\u4EE3\u7801\u751F\u6210\uFF0C\u4E0D\u63D0\u4F9B\u7FFB\u8BD1\u3002",
+  sidebar: {
+    Introduction: "\u7B80\u4ECB",
+    Packages: "\u8F6F\u4EF6\u5305",
+    Guides: "\u6307\u5357",
+    Overview: "\u6982\u89C8"
+  }
+};
+const docsLabels = { en, uk, "zh-CN": zhCN };
+export {
+  docsLabels
+};

package/dist/docsPage.cjs

@@ -0,0 +1,70 @@
+"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 docsPage_exports = {};
+__export(docsPage_exports, {
+  createDocsPage: () => createDocsPage
+});
+module.exports = __toCommonJS(docsPage_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_navigation = require("next/navigation");
+var import_pages = require("nextra/pages");
+var import_LocalizedPage = require("./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(module2, props, params) {
+  const { default: MDXContent, toc, metadata, sourceCode } = module2;
+  return { content: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(MDXContent, { ...props, params }), toc, metadata, sourceCode };
+}
+function createDocsPage({ localizedPages = {} } = {}) {
+  const generateStaticParams = (0, import_pages.generateStaticParamsFor)("mdxPath");
+  async function generateMetadata(props) {
+    const { mdxPath } = await props.params;
+    if (isAssetOrInternal(mdxPath)) return {};
+    try {
+      const { metadata } = await (0, import_pages.importPage)(mdxPath);
+      return metadata;
+    } catch {
+      return {};
+    }
+  }
+  async function Page(props) {
+    const params = await props.params;
+    if (isAssetOrInternal(params.mdxPath)) (0, import_navigation.notFound)();
+    let english;
+    try {
+      english = await (0, import_pages.importPage)(params.mdxPath);
+    } catch {
+      (0, import_navigation.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__ */ (0, import_jsx_runtime.jsx)(import_LocalizedPage.LocalizedPage, { variants: { ...Object.fromEntries(translations), en: variantOf(english, props, params) } });
+  }
+  return { generateStaticParams, generateMetadata, Page };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDocsPage
+});