@tuwaio/docs-ui 0.4.1 → 0.5.0

package/README.md

@@ -14,7 +14,7 @@
 - **Theme switch:** `ThemeSwitcher` is a light/dark switch for any theme state (for example `next-themes`).
 - **Interface settings for 30 days:** `PreferenceExpiry` is an inline script for the `<head>` of a site's root layout. It forgets the Local Storage values of the given keys (by default `theme`) 30 days after they were written, as the [Cookie Policy](https://tuwa.io/cookie) states, and dates each later write, whatever library writes it (`next-themes`, the `Tabs` of Nextra).
 - **Decoration:** `Orb` (an animated sphere in the brand color of a TUWA project), `StarryBackground` (an animated star field on a canvas) and `NoSSR` (renders its children only on the client).
-- **Policy pages:** `policies` lists the TUWA policies (Terms, Privacy, Cookie, Refund, Security, Data Processing Addendum) with their paths and whether they are in force (`publishedPolicies`; footers use `footerPolicies`). `loadPolicy` loads the text of a policy, and `PolicyDocument` renders it with the date of the version, a Download PDF button, anchored sections and a list of sections. The texts and PDFs come from [`TuwaIO/workflows/docs`](https://github.com/TuwaIO/workflows/tree/main/docs). Code that needs only the list or `loadPolicy` (footers, sitemaps, route handlers) imports them from `@tuwaio/docs-ui/policies`, which has no React, Next.js or Nextra imports.
+- **Policy pages:** `policies` lists the TUWA policies (Terms, Privacy, Cookie, Refund, Security, Data Processing Addendum) with their paths and whether they are in force (`publishedPolicies`; footers use `footerPolicies`). `loadPolicy` loads the text of a policy in a language, and `PolicyDocument` renders it with the date of the version, a Download PDF button, a language switch (English, Українська) when the policy is translated, anchored sections (the same anchors in every language) and a list of sections. The texts and PDFs come from [`TuwaIO/workflows/docs`](https://github.com/TuwaIO/workflows/tree/main/docs). Code that needs only the list or `loadPolicy` (footers, sitemaps, route handlers) imports them from `@tuwaio/docs-ui/policies`, which has no React, Next.js or Nextra imports.
 - **Search index:** the `tuwa-docs-search-index` command builds the [Pagefind](https://pagefind.app) index that the Nextra search loads from `/_pagefind`, from the pages `next build` prerendered. It reads both places Next.js keeps them: `.next/server/app` and, in builds with a deployment adapter (Next.js 16.3.8 and later on Vercel), `.next/server/route-cache`, where `pagefind --site .next/server/app` finds no pages.
 - **Stylesheet:** `dist/index.css` contains the `--tuwa-*` theme variables of [`@tuwaio/nova-core`](https://stories.tuwa.io/?path=/docs/packages-nova-core-overview--docs) (light and `.dark`), the styles of the Nextra parts and the Tailwind CSS v4 utilities used by the components, prefixed with `tuwadocs:`.
 
@@ -85,13 +85,13 @@ export default async function RootLayout({ children }: { children: ReactNode })
 
 ### Policy pages
 
-A policy page in the Next.js App Router (a Server Component; the content is cached for an hour):
+A policy page in the Next.js App Router (a Server Component; the content is cached for an hour). The language comes from `?lang=` (`en` by default, `uk` for Ukrainian); a policy without a translation loads in English, and the switch links each language with `?lang=<language>`:
 
 ```tsx
-import { loadPolicy, PolicyDocument } from '@tuwaio/docs-ui';
+import { loadPolicy, PolicyDocument, policyLanguageFrom } from '@tuwaio/docs-ui';
 
-export default async function RefundPage() {
-  const content = await loadPolicy('refund');
+export default async function RefundPage({ searchParams }: { searchParams: Promise<{ lang?: string | string[] }> }) {
+  const content = await loadPolicy('refund', { language: policyLanguageFrom((await searchParams).lang) });
 
   return (
     <main className="mx-auto max-w-6xl px-4 py-12">
@@ -147,7 +147,7 @@ It writes the index to `public/_pagefind` (keep that directory in `.gitignore`)
 
 ## 🌐 External Services
 
-`RemoteLogo` requests its `url` on the server (by default `cdn.jsdelivr.net/gh/TuwaIO/workflows@main/preview/logo_v2.svg`), cached by Next.js for 24 hours. `loadPolicy` requests `raw.githubusercontent.com/TuwaIO/workflows/main/docs/<slug>.json` on the server, cached by Next.js for an hour by default. The Download PDF button of `PolicyDocument` links to the PDF on the same host; the browser requests it only when it is clicked. The other components send no requests.
+`RemoteLogo` requests its `url` on the server (by default `cdn.jsdelivr.net/gh/TuwaIO/workflows@main/preview/logo_v2.svg`), cached by Next.js for 24 hours. `loadPolicy` requests `raw.githubusercontent.com/TuwaIO/workflows/main/docs/<slug>.json` (a translation: `docs/<language>/<slug>.json`, and the English file when it does not exist) on the server, cached by Next.js for an hour by default. The Download PDF button of `PolicyDocument` links to the PDF on the same host; the browser requests it only when it is clicked. The other components send no requests.
 
 ---
 

package/dist/components/PolicyDocument.cjs

@@ -73,13 +73,18 @@ function PolicyDocument({
   content,
   source = import_policies.POLICY_SOURCE,
   labels,
+  languageHref = (language) => `?lang=${language}`,
   className,
   classNames
 }) {
-  const tocLabel = labels?.toc ?? "On this page";
+  const language = content.language ?? "en";
+  const languages = content.languages ?? ["en"];
+  const texts = { ...import_policies.POLICY_DOCUMENT_LABELS[language], ...labels };
+  const tocLabel = texts.toc;
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
     "div",
     {
+      lang: language,
       className: (0, import_utils.cn)(
         "tuwadocs:grid tuwadocs:grid-cols-1 tuwadocs:gap-10 tuwadocs:lg:grid-cols-[minmax(0,1fr)_14rem]",
         className
@@ -106,26 +111,53 @@ function PolicyDocument({
                 ),
                 /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "tuwadocs:flex tuwadocs:flex-wrap tuwadocs:items-center tuwadocs:justify-between tuwadocs:gap-3", children: [
                   /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", { className: (0, import_utils.cn)("tuwadocs:text-sm tuwadocs:text-[var(--tuwa-text-secondary)]", classNames?.updated), children: [
-                    labels?.updated ?? "Last updated",
+                    texts.updated,
                     " ",
                     content.updated
                   ] }),
-                  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-                    "a",
-                    {
-                      href: (0, import_policies.getPolicyFileUrl)(slug, "pdf", source),
-                      target: "_blank",
-                      rel: "noopener noreferrer",
-                      className: (0, import_utils.cn)(
-                        "tuwadocs-policy-title tuwadocs:inline-flex tuwadocs:h-10 tuwadocs:no-underline tuwadocs:items-center tuwadocs:gap-2 tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:border tuwadocs:border-[var(--tuwa-border-primary)] tuwadocs:bg-[var(--tuwa-bg-primary)] tuwadocs:px-4 tuwadocs:text-sm tuwadocs:font-bold tuwadocs:text-[var(--tuwa-text-primary)] tuwadocs:transition-colors tuwadocs:hover:bg-[var(--tuwa-bg-muted)]",
-                        classNames?.download
-                      ),
-                      children: [
-                        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_outline.ArrowDownTrayIcon, { className: "tuwadocs:h-4 tuwadocs:w-4", "aria-hidden": "true" }),
-                        labels?.download ?? "Download PDF"
-                      ]
-                    }
-                  )
+                  /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "tuwadocs:flex tuwadocs:flex-wrap tuwadocs:items-center tuwadocs:gap-2", children: [
+                    languages.length > 1 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                      "nav",
+                      {
+                        "aria-label": texts.language,
+                        className: (0, import_utils.cn)(
+                          "tuwadocs:inline-flex tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:border tuwadocs:border-[var(--tuwa-border-primary)] tuwadocs:p-0.5",
+                          classNames?.languages
+                        ),
+                        children: languages.map((item) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                          "a",
+                          {
+                            href: languageHref(item),
+                            hrefLang: item,
+                            lang: item,
+                            "aria-current": item === language ? "page" : void 0,
+                            className: (0, import_utils.cn)(
+                              "tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:px-3 tuwadocs:py-1.5 tuwadocs:text-xs tuwadocs:font-bold tuwadocs:no-underline tuwadocs:transition-colors",
+                              item === language ? "tuwadocs:bg-[var(--tuwa-bg-muted)] tuwadocs:text-[var(--tuwa-text-primary)]" : "tuwadocs:text-[var(--tuwa-text-secondary)] tuwadocs:hover:text-[var(--tuwa-text-primary)]"
+                            ),
+                            children: import_policies.POLICY_LANGUAGE_NAMES[item]
+                          },
+                          item
+                        ))
+                      }
+                    ),
+                    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+                      "a",
+                      {
+                        href: (0, import_policies.getPolicyFileUrl)(slug, "pdf", source, language),
+                        target: "_blank",
+                        rel: "noopener noreferrer",
+                        className: (0, import_utils.cn)(
+                          "tuwadocs-policy-title tuwadocs:inline-flex tuwadocs:h-10 tuwadocs:no-underline tuwadocs:items-center tuwadocs:gap-2 tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:border tuwadocs:border-[var(--tuwa-border-primary)] tuwadocs:bg-[var(--tuwa-bg-primary)] tuwadocs:px-4 tuwadocs:text-sm tuwadocs:font-bold tuwadocs:text-[var(--tuwa-text-primary)] tuwadocs:transition-colors tuwadocs:hover:bg-[var(--tuwa-bg-muted)]",
+                          classNames?.download
+                        ),
+                        children: [
+                          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_outline.ArrowDownTrayIcon, { className: "tuwadocs:h-4 tuwadocs:w-4", "aria-hidden": "true" }),
+                          texts.download
+                        ]
+                      }
+                    )
+                  ] })
                 ] })
               ]
             }

package/dist/components/PolicyDocument.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { PolicySlug, PolicyContent } from '../policies.cjs';
+import { PolicySlug, PolicyContent, PolicyDocumentLabels, PolicyLanguage } from '../policies.cjs';
 
 /**
  * Props of {@link PolicyDocument}.
@@ -11,15 +11,13 @@ interface PolicyDocumentProps {
     content: PolicyContent;
     /** Base URL of the policy files for the PDF link (default: `POLICY_SOURCE`). */
     source?: string;
-    /** Texts of the page. */
-    labels?: {
-        /** Text before the date of the version (default: `Last updated`). */
-        updated?: string;
-        /** Text of the button that opens the PDF (default: `Download PDF`). */
-        download?: string;
-        /** Heading and accessible name of the list of sections (default: `On this page`). */
-        toc?: string;
-    };
+    /** Texts of the page; the defaults are those of the language of `content` ({@link POLICY_DOCUMENT_LABELS}). */
+    labels?: PolicyDocumentLabels;
+    /**
+     * Link of each choice of the language switch (default: `?lang=<language>`, the page itself in that language). The
+     * switch shows when `content.languages` has more than one language.
+     */
+    languageHref?: (language: PolicyLanguage) => string;
     /** Classes of the root element. */
     className?: string;
     /** Classes of the parts of the page. */
@@ -36,12 +34,16 @@ interface PolicyDocumentProps {
         body?: string;
         /** The list of sections (shown from the `lg` breakpoint). */
         toc?: string;
+        /** The language switch. */
+        languages?: string;
     };
 }
 /**
  * A TUWA policy page (Terms, Privacy, Cookie, Refund, Security): the title, the date of the version, a Download PDF
- * button with the official document, the text with anchored sections and, from the `lg` breakpoint, a sticky list of
- * the sections. The text is selectable and readable on phones, by search engines and by screen readers; the PDF is
+ * button with the official document in the language of the text, a language switch when the policy exists in more
+ * than one language, the text with anchored sections and, from the `lg` breakpoint, a sticky list of the sections.
+ * The sections keep their anchors in every language, and the page marks its language (`lang`) for screen readers and
+ * search engines. The text is selectable and readable on phones, by search engines and by screen readers; the PDF is
  * generated from the same source.
  *
  * Load the content on the server with `loadPolicy` and render the page inside the layout of the site. The body is
@@ -52,7 +54,7 @@ interface PolicyDocumentProps {
  * @param props - See {@link PolicyDocumentProps}.
  * @returns The policy page.
  */
-declare function PolicyDocument({ slug, content, source, labels, className, classNames, }: PolicyDocumentProps): React.JSX.Element;
+declare function PolicyDocument({ slug, content, source, labels, languageHref, className, classNames, }: PolicyDocumentProps): React.JSX.Element;
 
 export { PolicyDocument };
 export type { PolicyDocumentProps };

package/dist/components/PolicyDocument.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { PolicySlug, PolicyContent } from '../policies.js';
+import { PolicySlug, PolicyContent, PolicyDocumentLabels, PolicyLanguage } from '../policies.js';
 
 /**
  * Props of {@link PolicyDocument}.
@@ -11,15 +11,13 @@ interface PolicyDocumentProps {
     content: PolicyContent;
     /** Base URL of the policy files for the PDF link (default: `POLICY_SOURCE`). */
     source?: string;
-    /** Texts of the page. */
-    labels?: {
-        /** Text before the date of the version (default: `Last updated`). */
-        updated?: string;
-        /** Text of the button that opens the PDF (default: `Download PDF`). */
-        download?: string;
-        /** Heading and accessible name of the list of sections (default: `On this page`). */
-        toc?: string;
-    };
+    /** Texts of the page; the defaults are those of the language of `content` ({@link POLICY_DOCUMENT_LABELS}). */
+    labels?: PolicyDocumentLabels;
+    /**
+     * Link of each choice of the language switch (default: `?lang=<language>`, the page itself in that language). The
+     * switch shows when `content.languages` has more than one language.
+     */
+    languageHref?: (language: PolicyLanguage) => string;
     /** Classes of the root element. */
     className?: string;
     /** Classes of the parts of the page. */
@@ -36,12 +34,16 @@ interface PolicyDocumentProps {
         body?: string;
         /** The list of sections (shown from the `lg` breakpoint). */
         toc?: string;
+        /** The language switch. */
+        languages?: string;
     };
 }
 /**
  * A TUWA policy page (Terms, Privacy, Cookie, Refund, Security): the title, the date of the version, a Download PDF
- * button with the official document, the text with anchored sections and, from the `lg` breakpoint, a sticky list of
- * the sections. The text is selectable and readable on phones, by search engines and by screen readers; the PDF is
+ * button with the official document in the language of the text, a language switch when the policy exists in more
+ * than one language, the text with anchored sections and, from the `lg` breakpoint, a sticky list of the sections.
+ * The sections keep their anchors in every language, and the page marks its language (`lang`) for screen readers and
+ * search engines. The text is selectable and readable on phones, by search engines and by screen readers; the PDF is
  * generated from the same source.
  *
  * Load the content on the server with `loadPolicy` and render the page inside the layout of the site. The body is
@@ -52,7 +54,7 @@ interface PolicyDocumentProps {
  * @param props - See {@link PolicyDocumentProps}.
  * @returns The policy page.
  */
-declare function PolicyDocument({ slug, content, source, labels, className, classNames, }: PolicyDocumentProps): React.JSX.Element;
+declare function PolicyDocument({ slug, content, source, labels, languageHref, className, classNames, }: PolicyDocumentProps): React.JSX.Element;
 
 export { PolicyDocument };
 export type { PolicyDocumentProps };

package/dist/components/PolicyDocument.js

@@ -2,7 +2,12 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { ArrowDownTrayIcon } from "@heroicons/react/24/outline";
 import { cn } from "@tuwaio/nova-core/utils";
 import parse, { Element } from "html-react-parser";
-import { getPolicyFileUrl, POLICY_SOURCE } from "../policies";
+import {
+  getPolicyFileUrl,
+  POLICY_DOCUMENT_LABELS,
+  POLICY_LANGUAGE_NAMES,
+  POLICY_SOURCE
+} from "../policies";
 const BLOCKED_ELEMENTS = /* @__PURE__ */ new Set([
   "script",
   "style",
@@ -40,13 +45,18 @@ function PolicyDocument({
   content,
   source = POLICY_SOURCE,
   labels,
+  languageHref = (language) => `?lang=${language}`,
   className,
   classNames
 }) {
-  const tocLabel = labels?.toc ?? "On this page";
+  const language = content.language ?? "en";
+  const languages = content.languages ?? ["en"];
+  const texts = { ...POLICY_DOCUMENT_LABELS[language], ...labels };
+  const tocLabel = texts.toc;
   return /* @__PURE__ */ jsxs(
     "div",
     {
+      lang: language,
       className: cn(
         "tuwadocs:grid tuwadocs:grid-cols-1 tuwadocs:gap-10 tuwadocs:lg:grid-cols-[minmax(0,1fr)_14rem]",
         className
@@ -73,26 +83,53 @@ function PolicyDocument({
                 ),
                 /* @__PURE__ */ jsxs("div", { className: "tuwadocs:flex tuwadocs:flex-wrap tuwadocs:items-center tuwadocs:justify-between tuwadocs:gap-3", children: [
                   /* @__PURE__ */ jsxs("p", { className: cn("tuwadocs:text-sm tuwadocs:text-[var(--tuwa-text-secondary)]", classNames?.updated), children: [
-                    labels?.updated ?? "Last updated",
+                    texts.updated,
                     " ",
                     content.updated
                   ] }),
-                  /* @__PURE__ */ jsxs(
-                    "a",
-                    {
-                      href: getPolicyFileUrl(slug, "pdf", source),
-                      target: "_blank",
-                      rel: "noopener noreferrer",
-                      className: cn(
-                        "tuwadocs-policy-title tuwadocs:inline-flex tuwadocs:h-10 tuwadocs:no-underline tuwadocs:items-center tuwadocs:gap-2 tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:border tuwadocs:border-[var(--tuwa-border-primary)] tuwadocs:bg-[var(--tuwa-bg-primary)] tuwadocs:px-4 tuwadocs:text-sm tuwadocs:font-bold tuwadocs:text-[var(--tuwa-text-primary)] tuwadocs:transition-colors tuwadocs:hover:bg-[var(--tuwa-bg-muted)]",
-                        classNames?.download
-                      ),
-                      children: [
-                        /* @__PURE__ */ jsx(ArrowDownTrayIcon, { className: "tuwadocs:h-4 tuwadocs:w-4", "aria-hidden": "true" }),
-                        labels?.download ?? "Download PDF"
-                      ]
-                    }
-                  )
+                  /* @__PURE__ */ jsxs("div", { className: "tuwadocs:flex tuwadocs:flex-wrap tuwadocs:items-center tuwadocs:gap-2", children: [
+                    languages.length > 1 && /* @__PURE__ */ jsx(
+                      "nav",
+                      {
+                        "aria-label": texts.language,
+                        className: cn(
+                          "tuwadocs:inline-flex tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:border tuwadocs:border-[var(--tuwa-border-primary)] tuwadocs:p-0.5",
+                          classNames?.languages
+                        ),
+                        children: languages.map((item) => /* @__PURE__ */ jsx(
+                          "a",
+                          {
+                            href: languageHref(item),
+                            hrefLang: item,
+                            lang: item,
+                            "aria-current": item === language ? "page" : void 0,
+                            className: cn(
+                              "tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:px-3 tuwadocs:py-1.5 tuwadocs:text-xs tuwadocs:font-bold tuwadocs:no-underline tuwadocs:transition-colors",
+                              item === language ? "tuwadocs:bg-[var(--tuwa-bg-muted)] tuwadocs:text-[var(--tuwa-text-primary)]" : "tuwadocs:text-[var(--tuwa-text-secondary)] tuwadocs:hover:text-[var(--tuwa-text-primary)]"
+                            ),
+                            children: POLICY_LANGUAGE_NAMES[item]
+                          },
+                          item
+                        ))
+                      }
+                    ),
+                    /* @__PURE__ */ jsxs(
+                      "a",
+                      {
+                        href: getPolicyFileUrl(slug, "pdf", source, language),
+                        target: "_blank",
+                        rel: "noopener noreferrer",
+                        className: cn(
+                          "tuwadocs-policy-title tuwadocs:inline-flex tuwadocs:h-10 tuwadocs:no-underline tuwadocs:items-center tuwadocs:gap-2 tuwadocs:rounded-[var(--tuwa-rounded-corners)] tuwadocs:border tuwadocs:border-[var(--tuwa-border-primary)] tuwadocs:bg-[var(--tuwa-bg-primary)] tuwadocs:px-4 tuwadocs:text-sm tuwadocs:font-bold tuwadocs:text-[var(--tuwa-text-primary)] tuwadocs:transition-colors tuwadocs:hover:bg-[var(--tuwa-bg-muted)]",
+                          classNames?.download
+                        ),
+                        children: [
+                          /* @__PURE__ */ jsx(ArrowDownTrayIcon, { className: "tuwadocs:h-4 tuwadocs:w-4", "aria-hidden": "true" }),
+                          texts.download
+                        ]
+                      }
+                    )
+                  ] })
                 ] })
               ]
             }

package/dist/index.css

@@ -749,6 +749,9 @@ html {
       border-color: color-mix(in oklab, var(--tuwadocs-color-black) 5%, transparent);
     }
   }
+  .tuwadocs\:bg-\[var\(--tuwa-bg-muted\)\] {
+    background-color: var(--tuwa-bg-muted);
+  }
   .tuwadocs\:bg-\[var\(--tuwa-bg-primary\)\] {
     background-color: var(--tuwa-bg-primary);
   }
@@ -766,6 +769,9 @@ html {
     --tw-gradient-from: var(--tuwadocs-color-slate-200);
     --tw-gradient-stops: var(--tw-gradient-via-stops, var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position));
   }
+  .tuwadocs\:p-0\.5 {
+    padding: calc(var(--tuwadocs-spacing) * 0.5);
+  }
   .tuwadocs\:p-1 {
     padding: var(--tuwadocs-spacing);
   }

package/dist/index.d.cts

@@ -6,7 +6,7 @@ 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 { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, Policy, PolicyContent, PolicySection, PolicySlug, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies } from './policies.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, 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';

package/dist/index.d.ts

@@ -6,7 +6,7 @@ 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 { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, Policy, PolicyContent, PolicySection, PolicySlug, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies } from './policies.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, 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';

package/dist/policies.cjs

@@ -19,6 +19,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var policies_exports = {};
 __export(policies_exports, {
   POLICIES_INDEX_URL: () => POLICIES_INDEX_URL,
+  POLICY_DOCUMENT_LABELS: () => POLICY_DOCUMENT_LABELS,
+  POLICY_LANGUAGES: () => POLICY_LANGUAGES,
+  POLICY_LANGUAGE_NAMES: () => POLICY_LANGUAGE_NAMES,
   POLICY_SITE_URL: () => POLICY_SITE_URL,
   POLICY_SOURCE: () => POLICY_SOURCE,
   footerPolicies: () => footerPolicies,
@@ -26,9 +29,23 @@ __export(policies_exports, {
   getPolicyPageUrl: () => getPolicyPageUrl,
   loadPolicy: () => loadPolicy,
   policies: () => policies,
+  policyLanguageFrom: () => policyLanguageFrom,
   publishedPolicies: () => publishedPolicies
 });
 module.exports = __toCommonJS(policies_exports);
+const POLICY_LANGUAGES = ["en", "uk"];
+const POLICY_LANGUAGE_NAMES = {
+  en: "English",
+  uk: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430"
+};
+function policyLanguageFrom(value) {
+  const first = Array.isArray(value) ? value[0] : value;
+  return POLICY_LANGUAGES.find((language) => language === first) ?? "en";
+}
+const POLICY_DOCUMENT_LABELS = {
+  en: { updated: "Last updated", download: "Download PDF", toc: "On this page", language: "Language" },
+  uk: { updated: "\u041E\u0441\u0442\u0430\u043D\u043D\u0454 \u043E\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044F", download: "\u0417\u0430\u0432\u0430\u043D\u0442\u0430\u0436\u0438\u0442\u0438 PDF", toc: "\u041D\u0430 \u0446\u0456\u0439 \u0441\u0442\u043E\u0440\u0456\u043D\u0446\u0456", language: "\u041C\u043E\u0432\u0430" }
+};
 const POLICY_SOURCE = "https://raw.githubusercontent.com/TuwaIO/workflows/main/docs";
 const POLICY_SITE_URL = "https://tuwa.io";
 const POLICIES_INDEX_URL = "https://docs.tuwa.io/policies";
@@ -79,11 +96,11 @@ const policies = [
 ];
 const publishedPolicies = policies.filter((policy) => policy.published);
 const footerPolicies = publishedPolicies.filter((policy) => policy.footer !== false);
-function getPolicyPageUrl(slug, site = POLICY_SITE_URL) {
-  return `${site.replace(/\/+$/, "")}/${slug}`;
+function getPolicyPageUrl(slug, site = POLICY_SITE_URL, language = "en") {
+  return `${site.replace(/\/+$/, "")}/${slug}${language === "en" ? "" : `?lang=${language}`}`;
 }
-function getPolicyFileUrl(slug, format, source = POLICY_SOURCE) {
-  return `${source.replace(/\/+$/, "")}/${slug}.${format}`;
+function getPolicyFileUrl(slug, format, source = POLICY_SOURCE, language = "en") {
+  return `${source.replace(/\/+$/, "")}${language === "en" ? "" : `/${language}`}/${slug}.${format}`;
 }
 function isPolicyContent(value) {
   if (!value || typeof value !== "object") return false;
@@ -93,8 +110,12 @@ function isPolicyContent(value) {
   );
 }
 async function loadPolicy(slug, options = {}) {
-  const url = getPolicyFileUrl(slug, "json", options.source);
+  const language = options.language ?? "en";
+  const url = getPolicyFileUrl(slug, "json", options.source, language);
   const response = await fetch(url, { next: { revalidate: options.revalidate ?? 3600 } });
+  if (response.status === 404 && language !== "en") {
+    return loadPolicy(slug, { ...options, language: "en" });
+  }
   if (!response.ok) {
     throw new Error(`loadPolicy: ${url} answered ${response.status}`);
   }
@@ -102,16 +123,23 @@ async function loadPolicy(slug, options = {}) {
   if (!isPolicyContent(content)) {
     throw new Error(`loadPolicy: ${url} is not a policy page`);
   }
+  const raw = content;
+  const languages = Array.isArray(raw.languages) ? POLICY_LANGUAGES.filter((item) => raw.languages.includes(item)) : [];
   return {
     title: content.title,
     updated: content.updated,
     sections: content.sections.map(({ id, title }) => ({ id, title })),
-    html: content.html
+    html: content.html,
+    language: policyLanguageFrom(raw.language ?? language),
+    languages: languages.length > 0 ? languages : ["en"]
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   POLICIES_INDEX_URL,
+  POLICY_DOCUMENT_LABELS,
+  POLICY_LANGUAGES,
+  POLICY_LANGUAGE_NAMES,
   POLICY_SITE_URL,
   POLICY_SOURCE,
   footerPolicies,
@@ -119,5 +147,6 @@ async function loadPolicy(slug, options = {}) {
   getPolicyPageUrl,
   loadPolicy,
   policies,
+  policyLanguageFrom,
   publishedPolicies
 });

package/dist/policies.d.cts

@@ -15,6 +15,35 @@ interface Policy {
     /** Whether footers link the policy (default: `true`); documents linked from other policies set `false`. */
     footer?: boolean;
 }
+/**
+ * A language of the TUWA policies: English, the original, and the translations generated next to it in
+ * `TuwaIO/workflows/docs/<language>/`.
+ */
+type PolicyLanguage = 'en' | 'uk';
+/** The languages of the policies, the original first. */
+declare const POLICY_LANGUAGES: readonly PolicyLanguage[];
+/** The name of each language in that language, for language switches. */
+declare const POLICY_LANGUAGE_NAMES: Readonly<Record<PolicyLanguage, string>>;
+/**
+ * Reads the language of a policy page from a value such as the `lang` search parameter.
+ *
+ * @param value - The value: a string, an array of strings (the first counts) or nothing.
+ * @returns The language it names, or `en` when it names none of {@link POLICY_LANGUAGES}.
+ */
+declare function policyLanguageFrom(value: unknown): PolicyLanguage;
+/** Texts of a policy page. */
+interface PolicyDocumentLabels {
+    /** Text before the date of the version (default in English: `Last updated`). */
+    updated?: string;
+    /** Text of the button that opens the PDF (default in English: `Download PDF`). */
+    download?: string;
+    /** Heading and accessible name of the list of sections (default in English: `On this page`). */
+    toc?: string;
+    /** Accessible name of the language switch (default in English: `Language`). */
+    language?: string;
+}
+/** The texts of `PolicyDocument` in each language of the policies; its `labels` override them. */
+declare const POLICY_DOCUMENT_LABELS: Readonly<Record<PolicyLanguage, Required<PolicyDocumentLabels>>>;
 /** A section of a policy: a level-2 heading with its anchor. */
 interface PolicySection {
     /** Anchor of the heading, without `#` (stable when sections are renumbered). */
@@ -28,10 +57,14 @@ interface PolicyContent {
     title: string;
     /** Date of the current version as written in the document (`October 8, 2026`). */
     updated: string;
-    /** Level-2 sections in document order. */
+    /** Level-2 sections in document order; a translation keeps the anchors of the English sections. */
     sections: PolicySection[];
     /** Body of the document as HTML, without the title and the date line; headings carry their anchors as `id`. */
     html: string;
+    /** Language of this text. */
+    language: PolicyLanguage;
+    /** Languages the policy exists in, the original first: the choices of the language switch. */
+    languages: PolicyLanguage[];
 }
 /** Where the policy files live: the `docs` folder of `TuwaIO/workflows` on GitHub, branch `main`. */
 declare const POLICY_SOURCE = "https://raw.githubusercontent.com/TuwaIO/workflows/main/docs";
@@ -53,37 +86,44 @@ declare const footerPolicies: readonly Policy[];
  *
  * @param slug - Slug of the policy.
  * @param site - Origin of the site with the policy pages (default: {@link POLICY_SITE_URL}).
- * @returns The URL of the page, for example `https://tuwa.io/terms`.
+ * @param language - Language of the page (default: `en`); a translation adds `?lang=<language>`.
+ * @returns The URL of the page, for example `https://tuwa.io/terms` or `https://tuwa.io/terms?lang=uk`.
  */
-declare function getPolicyPageUrl(slug: PolicySlug, site?: string): string;
+declare function getPolicyPageUrl(slug: PolicySlug, site?: string, language?: PolicyLanguage): string;
 /**
  * Returns the URL of a policy file.
  *
  * @param slug - Slug of the policy.
  * @param format - `json` for the page content, `pdf` for the official document, `md` for the source text.
  * @param source - Base URL of the policy files (default: {@link POLICY_SOURCE}).
- * @returns The URL of the file.
+ * @param language - Language of the file (default: `en`); a translation lives in the folder of its language.
+ * @returns The URL of the file, for example `…/docs/terms.pdf` or `…/docs/uk/terms.pdf`.
  */
-declare function getPolicyFileUrl(slug: PolicySlug, format: 'json' | 'pdf' | 'md', source?: string): string;
+declare function getPolicyFileUrl(slug: PolicySlug, format: 'json' | 'pdf' | 'md', source?: string, language?: PolicyLanguage): string;
 /**
- * Loads the content of a policy page (its `json` file). Call it on the server, for example in a Server Component of
- * the Next.js App Router, and pass the result to `PolicyDocument`.
+ * Loads the content of a policy page (its `json` file) in a language. Call it on the server, for example in a Server
+ * Component of the Next.js App Router, and pass the result to `PolicyDocument`. A policy not translated into the
+ * language loads in English, so a page asked for in that language still shows the policy.
  *
- * Network: one request to `getPolicyFileUrl(slug, 'json', source)` per revalidation, cached by the Next.js `fetch`
- * cache for `revalidate` seconds (outside Next.js, a plain request).
+ * Network: one request to `getPolicyFileUrl(slug, 'json', source, language)` per revalidation, and one more for the
+ * English file when the translation does not exist; cached by the Next.js `fetch` cache for `revalidate` seconds
+ * (outside Next.js, plain requests).
  *
  * @param slug - Slug of the policy.
  * @param options - Optional settings.
  * @param options.source - Base URL of the policy files (default: {@link POLICY_SOURCE}).
  * @param options.revalidate - Seconds the Next.js `fetch` cache keeps the content, or `false` to cache it until the
  *   next deployment (default: 3600).
- * @returns The content of the policy.
- * @throws Error when the request fails, the response is not `2xx`, or the file is not a policy page.
+ * @param options.language - Language of the text (default: `en`).
+ * @returns The content of the policy, with its language and the languages it exists in.
+ * @throws Error when the request fails, the response is not `2xx` (other than a missing translation), or the file is
+ *   not a policy page.
  */
 declare function loadPolicy(slug: PolicySlug, options?: {
     source?: string;
     revalidate?: number | false;
+    language?: PolicyLanguage;
 }): Promise<PolicyContent>;
 
-export { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies };
-export type { Policy, PolicyContent, PolicySection, PolicySlug };
+export { POLICIES_INDEX_URL, POLICY_DOCUMENT_LABELS, POLICY_LANGUAGES, POLICY_LANGUAGE_NAMES, POLICY_SITE_URL, POLICY_SOURCE, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, policyLanguageFrom, publishedPolicies };
+export type { Policy, PolicyContent, PolicyDocumentLabels, PolicyLanguage, PolicySection, PolicySlug };

package/dist/policies.d.ts

@@ -15,6 +15,35 @@ interface Policy {
     /** Whether footers link the policy (default: `true`); documents linked from other policies set `false`. */
     footer?: boolean;
 }
+/**
+ * A language of the TUWA policies: English, the original, and the translations generated next to it in
+ * `TuwaIO/workflows/docs/<language>/`.
+ */
+type PolicyLanguage = 'en' | 'uk';
+/** The languages of the policies, the original first. */
+declare const POLICY_LANGUAGES: readonly PolicyLanguage[];
+/** The name of each language in that language, for language switches. */
+declare const POLICY_LANGUAGE_NAMES: Readonly<Record<PolicyLanguage, string>>;
+/**
+ * Reads the language of a policy page from a value such as the `lang` search parameter.
+ *
+ * @param value - The value: a string, an array of strings (the first counts) or nothing.
+ * @returns The language it names, or `en` when it names none of {@link POLICY_LANGUAGES}.
+ */
+declare function policyLanguageFrom(value: unknown): PolicyLanguage;
+/** Texts of a policy page. */
+interface PolicyDocumentLabels {
+    /** Text before the date of the version (default in English: `Last updated`). */
+    updated?: string;
+    /** Text of the button that opens the PDF (default in English: `Download PDF`). */
+    download?: string;
+    /** Heading and accessible name of the list of sections (default in English: `On this page`). */
+    toc?: string;
+    /** Accessible name of the language switch (default in English: `Language`). */
+    language?: string;
+}
+/** The texts of `PolicyDocument` in each language of the policies; its `labels` override them. */
+declare const POLICY_DOCUMENT_LABELS: Readonly<Record<PolicyLanguage, Required<PolicyDocumentLabels>>>;
 /** A section of a policy: a level-2 heading with its anchor. */
 interface PolicySection {
     /** Anchor of the heading, without `#` (stable when sections are renumbered). */
@@ -28,10 +57,14 @@ interface PolicyContent {
     title: string;
     /** Date of the current version as written in the document (`October 8, 2026`). */
     updated: string;
-    /** Level-2 sections in document order. */
+    /** Level-2 sections in document order; a translation keeps the anchors of the English sections. */
     sections: PolicySection[];
     /** Body of the document as HTML, without the title and the date line; headings carry their anchors as `id`. */
     html: string;
+    /** Language of this text. */
+    language: PolicyLanguage;
+    /** Languages the policy exists in, the original first: the choices of the language switch. */
+    languages: PolicyLanguage[];
 }
 /** Where the policy files live: the `docs` folder of `TuwaIO/workflows` on GitHub, branch `main`. */
 declare const POLICY_SOURCE = "https://raw.githubusercontent.com/TuwaIO/workflows/main/docs";
@@ -53,37 +86,44 @@ declare const footerPolicies: readonly Policy[];
  *
  * @param slug - Slug of the policy.
  * @param site - Origin of the site with the policy pages (default: {@link POLICY_SITE_URL}).
- * @returns The URL of the page, for example `https://tuwa.io/terms`.
+ * @param language - Language of the page (default: `en`); a translation adds `?lang=<language>`.
+ * @returns The URL of the page, for example `https://tuwa.io/terms` or `https://tuwa.io/terms?lang=uk`.
  */
-declare function getPolicyPageUrl(slug: PolicySlug, site?: string): string;
+declare function getPolicyPageUrl(slug: PolicySlug, site?: string, language?: PolicyLanguage): string;
 /**
  * Returns the URL of a policy file.
  *
  * @param slug - Slug of the policy.
  * @param format - `json` for the page content, `pdf` for the official document, `md` for the source text.
  * @param source - Base URL of the policy files (default: {@link POLICY_SOURCE}).
- * @returns The URL of the file.
+ * @param language - Language of the file (default: `en`); a translation lives in the folder of its language.
+ * @returns The URL of the file, for example `…/docs/terms.pdf` or `…/docs/uk/terms.pdf`.
  */
-declare function getPolicyFileUrl(slug: PolicySlug, format: 'json' | 'pdf' | 'md', source?: string): string;
+declare function getPolicyFileUrl(slug: PolicySlug, format: 'json' | 'pdf' | 'md', source?: string, language?: PolicyLanguage): string;
 /**
- * Loads the content of a policy page (its `json` file). Call it on the server, for example in a Server Component of
- * the Next.js App Router, and pass the result to `PolicyDocument`.
+ * Loads the content of a policy page (its `json` file) in a language. Call it on the server, for example in a Server
+ * Component of the Next.js App Router, and pass the result to `PolicyDocument`. A policy not translated into the
+ * language loads in English, so a page asked for in that language still shows the policy.
  *
- * Network: one request to `getPolicyFileUrl(slug, 'json', source)` per revalidation, cached by the Next.js `fetch`
- * cache for `revalidate` seconds (outside Next.js, a plain request).
+ * Network: one request to `getPolicyFileUrl(slug, 'json', source, language)` per revalidation, and one more for the
+ * English file when the translation does not exist; cached by the Next.js `fetch` cache for `revalidate` seconds
+ * (outside Next.js, plain requests).
  *
  * @param slug - Slug of the policy.
  * @param options - Optional settings.
  * @param options.source - Base URL of the policy files (default: {@link POLICY_SOURCE}).
  * @param options.revalidate - Seconds the Next.js `fetch` cache keeps the content, or `false` to cache it until the
  *   next deployment (default: 3600).
- * @returns The content of the policy.
- * @throws Error when the request fails, the response is not `2xx`, or the file is not a policy page.
+ * @param options.language - Language of the text (default: `en`).
+ * @returns The content of the policy, with its language and the languages it exists in.
+ * @throws Error when the request fails, the response is not `2xx` (other than a missing translation), or the file is
+ *   not a policy page.
  */
 declare function loadPolicy(slug: PolicySlug, options?: {
     source?: string;
     revalidate?: number | false;
+    language?: PolicyLanguage;
 }): Promise<PolicyContent>;
 
-export { POLICIES_INDEX_URL, POLICY_SITE_URL, POLICY_SOURCE, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, publishedPolicies };
-export type { Policy, PolicyContent, PolicySection, PolicySlug };
+export { POLICIES_INDEX_URL, POLICY_DOCUMENT_LABELS, POLICY_LANGUAGES, POLICY_LANGUAGE_NAMES, POLICY_SITE_URL, POLICY_SOURCE, footerPolicies, getPolicyFileUrl, getPolicyPageUrl, loadPolicy, policies, policyLanguageFrom, publishedPolicies };
+export type { Policy, PolicyContent, PolicyDocumentLabels, PolicyLanguage, PolicySection, PolicySlug };

package/dist/policies.js

@@ -1,3 +1,16 @@
+const POLICY_LANGUAGES = ["en", "uk"];
+const POLICY_LANGUAGE_NAMES = {
+  en: "English",
+  uk: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430"
+};
+function policyLanguageFrom(value) {
+  const first = Array.isArray(value) ? value[0] : value;
+  return POLICY_LANGUAGES.find((language) => language === first) ?? "en";
+}
+const POLICY_DOCUMENT_LABELS = {
+  en: { updated: "Last updated", download: "Download PDF", toc: "On this page", language: "Language" },
+  uk: { updated: "\u041E\u0441\u0442\u0430\u043D\u043D\u0454 \u043E\u043D\u043E\u0432\u043B\u0435\u043D\u043D\u044F", download: "\u0417\u0430\u0432\u0430\u043D\u0442\u0430\u0436\u0438\u0442\u0438 PDF", toc: "\u041D\u0430 \u0446\u0456\u0439 \u0441\u0442\u043E\u0440\u0456\u043D\u0446\u0456", language: "\u041C\u043E\u0432\u0430" }
+};
 const POLICY_SOURCE = "https://raw.githubusercontent.com/TuwaIO/workflows/main/docs";
 const POLICY_SITE_URL = "https://tuwa.io";
 const POLICIES_INDEX_URL = "https://docs.tuwa.io/policies";
@@ -48,11 +61,11 @@ const policies = [
 ];
 const publishedPolicies = policies.filter((policy) => policy.published);
 const footerPolicies = publishedPolicies.filter((policy) => policy.footer !== false);
-function getPolicyPageUrl(slug, site = POLICY_SITE_URL) {
-  return `${site.replace(/\/+$/, "")}/${slug}`;
+function getPolicyPageUrl(slug, site = POLICY_SITE_URL, language = "en") {
+  return `${site.replace(/\/+$/, "")}/${slug}${language === "en" ? "" : `?lang=${language}`}`;
 }
-function getPolicyFileUrl(slug, format, source = POLICY_SOURCE) {
-  return `${source.replace(/\/+$/, "")}/${slug}.${format}`;
+function getPolicyFileUrl(slug, format, source = POLICY_SOURCE, language = "en") {
+  return `${source.replace(/\/+$/, "")}${language === "en" ? "" : `/${language}`}/${slug}.${format}`;
 }
 function isPolicyContent(value) {
   if (!value || typeof value !== "object") return false;
@@ -62,8 +75,12 @@ function isPolicyContent(value) {
   );
 }
 async function loadPolicy(slug, options = {}) {
-  const url = getPolicyFileUrl(slug, "json", options.source);
+  const language = options.language ?? "en";
+  const url = getPolicyFileUrl(slug, "json", options.source, language);
   const response = await fetch(url, { next: { revalidate: options.revalidate ?? 3600 } });
+  if (response.status === 404 && language !== "en") {
+    return loadPolicy(slug, { ...options, language: "en" });
+  }
   if (!response.ok) {
     throw new Error(`loadPolicy: ${url} answered ${response.status}`);
   }
@@ -71,15 +88,22 @@ async function loadPolicy(slug, options = {}) {
   if (!isPolicyContent(content)) {
     throw new Error(`loadPolicy: ${url} is not a policy page`);
   }
+  const raw = content;
+  const languages = Array.isArray(raw.languages) ? POLICY_LANGUAGES.filter((item) => raw.languages.includes(item)) : [];
   return {
     title: content.title,
     updated: content.updated,
     sections: content.sections.map(({ id, title }) => ({ id, title })),
-    html: content.html
+    html: content.html,
+    language: policyLanguageFrom(raw.language ?? language),
+    languages: languages.length > 0 ? languages : ["en"]
   };
 }
 export {
   POLICIES_INDEX_URL,
+  POLICY_DOCUMENT_LABELS,
+  POLICY_LANGUAGES,
+  POLICY_LANGUAGE_NAMES,
   POLICY_SITE_URL,
   POLICY_SOURCE,
   footerPolicies,
@@ -87,5 +111,6 @@ export {
   getPolicyPageUrl,
   loadPolicy,
   policies,
+  policyLanguageFrom,
   publishedPolicies
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/docs-ui",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -61,7 +61,7 @@
     }
   ],
   "dependencies": {
-    "@tuwaio/nova-core": "^0.10.0",
+    "@tuwaio/nova-core": "^0.10.1",
     "clsx": "^2.1.1",
     "html-react-parser": "^6.1.8",
     "tailwind-merge": "^3.7.0"
@@ -82,7 +82,7 @@
     "next": "16.4.1",
     "nextra": "^4.6.1",
     "nextra-theme-docs": "^4.6.1",
-    "postcss": "^8.5.30",
+    "postcss": "^8.5.31",
     "postcss-cli": "^12.0.0",
     "react": "^19.3.1",
     "tailwindcss": "^4.3.3",