@tuwaio/docs-ui 0.5.3 → 0.5.4

package/dist/index.css

@@ -651,8 +651,8 @@ html {
     --tuwadocs-color-red-600: oklch(57.7% 0.245 27.325);
     --tuwadocs-color-yellow-400: oklch(85.2% 0.199 91.936);
     --tuwadocs-color-yellow-500: oklch(79.5% 0.184 86.047);
-    --tuwadocs-color-indigo-300: oklch(78.5% 0.115 274.713);
-    --tuwadocs-color-indigo-400: oklch(67.3% 0.182 276.935);
+    --tuwadocs-color-cyan-300: oklch(86.5% 0.127 207.078);
+    --tuwadocs-color-cyan-400: oklch(78.9% 0.154 211.53);
     --tuwadocs-color-slate-200: oklch(92.9% 0.013 255.508);
     --tuwadocs-color-slate-500: oklch(55.4% 0.046 257.417);
     --tuwadocs-color-black: #000;
@@ -770,6 +770,9 @@ html {
   .tuwadocs\:mb-8 {
     margin-bottom: calc(var(--tuwadocs-spacing) * 8);
   }
+  .tuwadocs\:block {
+    display: block;
+  }
   .tuwadocs\:flex {
     display: flex;
   }
@@ -809,6 +812,9 @@ html {
   .tuwadocs\:h-10 {
     height: calc(var(--tuwadocs-spacing) * 10);
   }
+  .tuwadocs\:h-auto {
+    height: auto;
+  }
   .tuwadocs\:h-full {
     height: 100%;
   }
@@ -1109,9 +1115,6 @@ html {
   .tuwadocs\:pt-4 {
     padding-top: calc(var(--tuwadocs-spacing) * 4);
   }
-  .tuwadocs\:pt-8 {
-    padding-top: calc(var(--tuwadocs-spacing) * 8);
-  }
   .tuwadocs\:pb-6 {
     padding-bottom: calc(var(--tuwadocs-spacing) * 6);
   }
@@ -1175,8 +1178,8 @@ html {
   .tuwadocs\:text-\[var\(--tuwa-text-tertiary\)\] {
     color: var(--tuwa-text-tertiary);
   }
-  .tuwadocs\:text-indigo-400 {
-    color: var(--tuwadocs-color-indigo-400);
+  .tuwadocs\:text-cyan-400 {
+    color: var(--tuwadocs-color-cyan-400);
   }
   .tuwadocs\:text-slate-500 {
     color: var(--tuwadocs-color-slate-500);
@@ -1230,6 +1233,11 @@ html {
     transition-timing-function: var(--tw-ease, var(--tuwadocs-default-transition-timing-function));
     transition-duration: var(--tw-duration, var(--tuwadocs-default-transition-duration));
   }
+  .tuwadocs\:transition-opacity {
+    transition-property: opacity;
+    transition-timing-function: var(--tw-ease, var(--tuwadocs-default-transition-timing-function));
+    transition-duration: var(--tw-duration, var(--tuwadocs-default-transition-duration));
+  }
   .tuwadocs\:duration-300 {
     --tw-duration: 300ms;
     transition-duration: 300ms;
@@ -1254,8 +1262,8 @@ html {
     .tuwadocs\:group-hover\:text-\[var\(--tuwa-text-primary\)\]:is(:where(.tuwadocs\:group):hover *) {
       color: var(--tuwa-text-primary);
     }
-    .tuwadocs\:group-hover\:text-indigo-300:is(:where(.tuwadocs\:group):hover *) {
-      color: var(--tuwadocs-color-indigo-300);
+    .tuwadocs\:group-hover\:text-cyan-300:is(:where(.tuwadocs\:group):hover *) {
+      color: var(--tuwadocs-color-cyan-300);
     }
     .tuwadocs\:group-hover\:text-yellow-400:is(:where(.tuwadocs\:group):hover *) {
       color: var(--tuwadocs-color-yellow-400);
@@ -1397,6 +1405,12 @@ html {
       width: calc(var(--tuwadocs-spacing) * 6);
     }
   }
+  .tuwadocs\:dark\:block:where(.dark, .dark *) {
+    display: block;
+  }
+  .tuwadocs\:dark\:hidden:where(.dark, .dark *) {
+    display: none;
+  }
   .tuwadocs\:dark\:border-white\/10:where(.dark, .dark *) {
     border-color: var(--tuwadocs-color-white);
     @supports (color: color-mix(in lab, red, red)) {
@@ -1457,53 +1471,66 @@ html {
   }
 }
 :root {
-  --tuwa-primary: #6366f1;
-  --tuwa-secondary: #8b5cf6;
+  --tuwa-primary: #0052ff;
+  --tuwa-secondary: #00d2ff;
   --tuwa-success: #10b981;
   --tuwa-warning: #f59e0b;
   --tuwa-error: #ef4444;
-  --tuwa-gradient: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-  --nextra-primary-hue: 240;
+  --tuwa-gradient: linear-gradient(135deg, #0052ff 0%, #00d2ff 100%);
+  --tuwa-button-gradient-from: #0052ff;
+  --tuwa-button-gradient-to: #00d2ff;
+  --tuwa-button-gradient-from-hover: #0045d8;
+  --tuwa-button-gradient-to-hover: #00bce6;
+  --nextra-primary-hue: 212;
   --nextra-primary-saturation: 100%;
-  --x-color-primary-50: rgb(238 242 255);
-  --x-color-primary-100: rgb(224 231 255);
-  --x-color-primary-200: rgb(199 210 254);
-  --x-color-primary-300: rgb(165 180 252);
-  --x-color-primary-400: rgb(129 140 248);
-  --x-color-primary-500: #6366f1;
-  --x-color-primary-600: rgb(79 70 229);
-  --x-color-primary-700: rgb(67 56 202);
-  --x-color-primary-800: rgb(55 48 163);
-  --x-color-primary-900: rgb(49 46 129);
-  --x-color-primary-950: rgb(30 27 75);
+  --x-color-primary-50: rgb(239 246 255);
+  --x-color-primary-100: rgb(219 234 254);
+  --x-color-primary-200: rgb(191 219 254);
+  --x-color-primary-300: rgb(147 197 253);
+  --x-color-primary-400: rgb(96 165 250);
+  --x-color-primary-500: #0052ff;
+  --x-color-primary-600: #2563eb;
+  --x-color-primary-700: #1d4ed8;
+  --x-color-primary-800: #1e40af;
+  --x-color-primary-900: #1e3a8a;
+  --x-color-primary-950: #172554;
   --tuwa-footer-border: rgb(229 231 235);
   --tuwa-footer-text-primary: rgb(75 85 99);
   --tuwa-footer-text-secondary: rgb(107 114 128);
   --tuwa-footer-text-muted: rgb(156 163 175);
   --tuwa-footer-link-color: rgb(107 114 128);
-  --tuwa-footer-link-hover: rgb(55 65 81);
+  --tuwa-footer-link-hover: #0052ff;
   --tuwa-footer-npm-hover: rgb(220 38 38);
   --tuwa-footer-discord-hover: var(--tuwa-primary);
   --tuwa-footer-github-hover: rgb(31 41 55);
 }
 .dark {
-  --x-color-primary-50: rgb(30 27 75);
-  --x-color-primary-100: rgb(49 46 129);
-  --x-color-primary-200: rgb(55 48 163);
-  --x-color-primary-300: rgb(67 56 202);
-  --x-color-primary-400: rgb(79 70 229);
-  --x-color-primary-500: var(--tuwa-secondary);
-  --x-color-primary-600: rgb(129 140 248);
-  --x-color-primary-700: rgb(165 180 252);
-  --x-color-primary-800: rgb(199 210 254);
-  --x-color-primary-900: rgb(224 231 255);
-  --x-color-primary-950: rgb(238 242 255);
-  --tuwa-footer-border: rgb(55 65 81);
+  --tuwa-primary: #38bdf8;
+  --tuwa-secondary: #00d2ff;
+  --nextra-bg: 10 14 39;
+  --tuwa-bg-dark: #0a0e27;
+  --tuwa-button-gradient-from: #2563eb;
+  --tuwa-button-gradient-to: #00d2ff;
+  --tuwa-button-gradient-from-hover: #1d4ed8;
+  --tuwa-button-gradient-to-hover: #38bdf8;
+  --x-color-primary-50: rgb(15 23 42);
+  --x-color-primary-100: rgb(23 37 84);
+  --x-color-primary-200: rgb(30 58 138);
+  --x-color-primary-300: rgb(30 64 175);
+  --x-color-primary-400: #38bdf8;
+  --x-color-primary-500: #38bdf8;
+  --x-color-primary-600: #38bdf8;
+  --x-color-primary-700: #7dd3fc;
+  --x-color-primary-800: rgb(191 219 254);
+  --x-color-primary-900: rgb(219 234 254);
+  --x-color-primary-950: rgb(239 246 255);
+  --x-color-neutral-900: #0a0e27;
+  --tuwa-footer-border: rgba(255, 255, 255, 0.08);
   --tuwa-footer-text-primary: rgb(209 213 219);
   --tuwa-footer-text-secondary: rgb(156 163 175);
   --tuwa-footer-text-muted: rgb(107 114 128);
   --tuwa-footer-link-color: rgb(156 163 175);
-  --tuwa-footer-link-hover: rgb(243 244 246);
+  --tuwa-footer-link-hover: #38bdf8;
   --tuwa-footer-npm-hover: rgb(248 113 113);
   --tuwa-footer-discord-hover: var(--tuwa-secondary);
   --tuwa-footer-github-hover: rgb(243 244 246);
@@ -1534,6 +1561,47 @@ html {
   border-color: var(--tuwa-footer-border);
   border-top-width: 1px;
 }
+.dark .nextra-sidebar-footer,
+html.dark .nextra-sidebar-footer {
+  background-color: #0a0e27 !important;
+  border-color: rgba(255, 255, 255, 0.08) !important;
+}
+.dark .nextra-sidebar,
+html.dark .nextra-sidebar {
+  background-color: #0a0e27 !important;
+}
+.nextra-callout.x\:border-purple-600,
+.nextra-callout[class*='border-purple'],
+.x\:border-purple-600,
+.x\:dark\:border-purple-600,
+[class*='border-purple'] {
+  border-color: #0052ff !important;
+}
+.nextra-callout.x\:border-purple-600 svg,
+.nextra-callout[class*='border-purple'] svg,
+.x\:text-purple-600,
+.x\:dark\:text-purple-400,
+[class*='text-purple'] {
+  color: #38bdf8 !important;
+  fill: #38bdf8 !important;
+}
+.nextra-callout.x\:border-purple-600,
+.nextra-callout[class*='bg-purple'],
+.x\:bg-purple-100 {
+  background-color: rgba(0, 82, 255, 0.08) !important;
+}
+.dark .nextra-callout.x\:border-purple-600,
+.dark .nextra-callout[class*='dark:bg-purple'],
+.dark .x\:dark\:bg-purple-900\/30,
+[class*='dark:bg-purple'] {
+  background-color: rgba(0, 82, 255, 0.12) !important;
+}
+.dark hr.nextra-border,
+html.dark hr.nextra-border,
+.dark .nextra-border,
+html.dark .nextra-border {
+  border-color: rgba(255, 255, 255, 0.08) !important;
+}
 .tuwa-footer-description {
   font-size: var(--tuwadocs-text-sm);
   line-height: var(--tw-leading, var(--tuwadocs-text-sm--line-height));
@@ -1587,22 +1655,31 @@ html {
 }
 .tuwa-badge:hover {
   transform: translateY(-1px);
-  box-shadow: 0 2px 8px rgb(99 102 241 / 0.25);
+  box-shadow: 0 2px 8px rgb(0 82 255 / 0.25);
 }
 .tuwa-badge--secondary {
-  background: linear-gradient(135deg, var(--tuwa-secondary) 0%, #a855f7 100%);
+  background: linear-gradient(135deg, var(--tuwa-primary) 0%, var(--tuwa-secondary) 100%);
 }
 .tuwa-badge--success {
   background: linear-gradient(135deg, var(--tuwa-success) 0%, #059669 100%);
 }
 .nextra-sidebar a[data-active] {
   color: var(--tuwa-primary) !important;
-  background-color: rgb(99 102 241 / 0.1) !important;
+  background-color: rgb(0 82 255 / 0.1) !important;
   border-color: var(--tuwa-primary) !important;
 }
+.dark .nextra-sidebar a[data-active] {
+  color: var(--tuwa-secondary) !important;
+  background-color: rgb(0 210 255 / 0.1) !important;
+  border-color: var(--tuwa-secondary) !important;
+}
 .nextra-sidebar a:hover {
   color: var(--tuwa-primary) !important;
-  background-color: rgb(99 102 241 / 0.05) !important;
+  background-color: rgb(0 82 255 / 0.05) !important;
+}
+.dark .nextra-sidebar a:hover {
+  color: var(--tuwa-secondary) !important;
+  background-color: rgb(0 210 255 / 0.05) !important;
 }
 .nextra-search input {
   border-color: rgb(229 231 235);
@@ -1611,7 +1688,11 @@ html {
 }
 .nextra-search input:focus {
   border-color: var(--tuwa-primary) !important;
-  box-shadow: 0 0 0 3px rgb(99 102 241 / 0.1) !important;
+  box-shadow: 0 0 0 3px rgb(0 82 255 / 0.15) !important;
+}
+.dark .nextra-search input:focus {
+  border-color: var(--tuwa-secondary) !important;
+  box-shadow: 0 0 0 3px rgb(0 210 255 / 0.15) !important;
 }
 .nextra-breadcrumb,
 .nextra-breadcrumbs {
@@ -1691,16 +1772,40 @@ article h6 {
   font-weight: var(--tuwadocs-font-weight-semibold);
 }
 .nextra-code button:hover {
-  background-color: var(--tuwa-primary) !important;
+  background-color: rgba(0, 0, 0, 0.06) !important;
+  color: var(--tuwa-primary) !important;
+}
+.dark .nextra-code button:hover {
+  background-color: rgba(255, 255, 255, 0.1) !important;
+  color: #38bdf8 !important;
 }
 article a {
   color: var(--tuwa-primary) !important;
-  text-decoration-color: rgb(99 102 241 / 0.3);
+  text-decoration-color: rgba(0, 82, 255, 0.3);
   transition: all 0.2s ease;
 }
 article a:hover {
   color: var(--tuwa-secondary) !important;
-  text-decoration-color: var(--tuwa-primary);
+  text-decoration-color: var(--tuwa-secondary);
+}
+.dark article a {
+  color: #38bdf8 !important;
+  text-decoration-color: rgba(56, 189, 248, 0.4) !important;
+}
+.dark article a:hover {
+  color: #7dd3fc !important;
+  text-decoration-color: #7dd3fc !important;
+}
+.dark .nextra-toc a:hover {
+  color: #38bdf8 !important;
+}
+.dark .nextra-toc a[data-active] {
+  color: #38bdf8 !important;
+  border-color: #38bdf8 !important;
+}
+.dark .x\:text-primary-600,
+.dark [class*='text-primary-600'] {
+  color: #38bdf8 !important;
 }
 .nextra-callout[class*='border-blue-'] {
   border-color: var(--tuwa-primary) !important;
@@ -1911,13 +2016,16 @@ article a[href^='http']:after {
     backdrop-filter: none;
     background: white;
   }
-  .dark .nextra-navbar {
-    background: rgb(15 23 42);
-  }
   .tuwa-footer-link span {
     display: none;
   }
 }
+html.dark {
+  background-color: #0a0e27;
+}
+html.dark body {
+  background-color: #0a0e27;
+}
 @keyframes tuwa-float {
   0%,
   100% {

package/dist/index.d.cts

@@ -1,13 +1,15 @@
-export { Footer } from './components/Footer.cjs';
+export { Footer, FooterLabels, FooterProps } from './components/Footer.cjs';
 export { DEFAULT_LOCALES, LocaleOption, LocaleSwitcher, LocaleSwitcherProps, getLocaleFlag } from './components/LocaleSwitcher.cjs';
-export { RemoteLogo, RemoteLogoProps } from './components/Logo.cjs';
+export { RemoteLogo, RemoteLogoProps, SiteLogo, SiteLogoProps, TuwaLogo } from './components/Logo.cjs';
 export { NavProps, Navbar, SocialLink } from './components/NavBar.cjs';
 export { default as NoSSR } from './components/NoSSR.cjs';
 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_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 { 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 { 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';

package/dist/index.d.ts

@@ -1,13 +1,15 @@
-export { Footer } from './components/Footer.js';
+export { Footer, FooterLabels, FooterProps } from './components/Footer.js';
 export { DEFAULT_LOCALES, LocaleOption, LocaleSwitcher, LocaleSwitcherProps, getLocaleFlag } from './components/LocaleSwitcher.js';
-export { RemoteLogo, RemoteLogoProps } from './components/Logo.js';
+export { RemoteLogo, RemoteLogoProps, SiteLogo, SiteLogoProps, TuwaLogo } from './components/Logo.js';
 export { NavProps, Navbar, SocialLink } from './components/NavBar.js';
 export { default as NoSSR } from './components/NoSSR.js';
 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_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 { 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 { 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';

package/dist/index.js

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

package/dist/locale.cjs

@@ -0,0 +1,131 @@
+"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 locale_exports = {};
+__export(locale_exports, {
+  DEFAULT_LOCALE: () => DEFAULT_LOCALE,
+  LOCALE_STORAGE_KEY: () => LOCALE_STORAGE_KEY,
+  TUWA_LOCALES: () => TUWA_LOCALES,
+  detectLocale: () => detectLocale,
+  formatLabel: () => formatLabel,
+  normalizeLocale: () => normalizeLocale,
+  policyLanguageOf: () => policyLanguageOf,
+  resolveClientLocale: () => resolveClientLocale
+});
+module.exports = __toCommonJS(locale_exports);
+const TUWA_LOCALES = ["en", "uk", "zh-CN"];
+const DEFAULT_LOCALE = "en";
+const LOCALE_STORAGE_KEY = "tuwa-locale";
+const UKRAINE_TIMEZONES = /* @__PURE__ */ new Set([
+  "europe/kyiv",
+  "europe/kiev",
+  "europe/uzhgorod",
+  "europe/zaporozhye",
+  "europe/simferopol"
+]);
+const CHINA_TIMEZONES = /* @__PURE__ */ new Set([
+  "asia/shanghai",
+  "asia/chongqing",
+  "asia/harbin",
+  "asia/urumqi",
+  "asia/beijing",
+  "prc"
+]);
+const MASKED_TIMEZONES = /* @__PURE__ */ new Set(["", "utc", "gmt", "etc/utc", "etc/gmt"]);
+function hasUkraineRegion(tag) {
+  return /(?:^|[-_])ua(?:$|[-_])/.test(tag);
+}
+function isSimplifiedChinese(tag) {
+  if (tag === "zh" || tag === "zh-cn" || tag === "zh_cn" || tag.startsWith("zh-hans") || tag.startsWith("zh_hans")) {
+    return true;
+  }
+  return tag.startsWith("zh-") && !/hant|tw|hk|mo/.test(tag);
+}
+function normalizeLocale(tag) {
+  if (!tag) return null;
+  const lower = tag.trim().toLowerCase();
+  if (!lower) return null;
+  if (lower === "uk" || lower === "ua" || lower.startsWith("uk-") || lower.startsWith("uk_")) return "uk";
+  if (isSimplifiedChinese(lower)) return "zh-CN";
+  if (lower === "en" || lower.startsWith("en-") || lower.startsWith("en_")) return "en";
+  return null;
+}
+function detectLocale(signals) {
+  const stored = normalizeLocale(signals.stored);
+  if (stored) return stored;
+  const languages = (signals.languages ?? []).map((tag) => tag.trim().toLowerCase()).filter(Boolean);
+  for (const tag of languages) {
+    const locale = normalizeLocale(tag);
+    if (locale === "uk" || locale === "zh-CN") return locale;
+    if (locale === "en" && !hasUkraineRegion(tag)) break;
+  }
+  const timeZone = (signals.timeZone ?? "").trim().toLowerCase();
+  const systemLocale = (signals.systemLocale ?? "").trim().toLowerCase();
+  const explicitEnglish = languages.some((tag) => normalizeLocale(tag) === "en" && !hasUkraineRegion(tag));
+  if (UKRAINE_TIMEZONES.has(timeZone) || hasUkraineRegion(systemLocale) || languages.some(hasUkraineRegion)) {
+    return "uk";
+  }
+  if (CHINA_TIMEZONES.has(timeZone) || systemLocale && isSimplifiedChinese(systemLocale)) {
+    return "zh-CN";
+  }
+  if (!explicitEnglish && MASKED_TIMEZONES.has(timeZone) && languages.some((tag) => tag === "ru" || tag.startsWith("ru-")) && signals.januaryOffset === -120 && signals.julyOffset === -180) {
+    return "uk";
+  }
+  return DEFAULT_LOCALE;
+}
+function resolveClientLocale(storageKey = LOCALE_STORAGE_KEY) {
+  if (typeof window === "undefined") return DEFAULT_LOCALE;
+  const signals = {};
+  try {
+    signals.stored = window.localStorage.getItem(storageKey);
+  } catch {
+  }
+  try {
+    if (typeof navigator !== "undefined") {
+      signals.languages = navigator.languages?.length ? navigator.languages : [navigator.language];
+    }
+  } catch {
+  }
+  try {
+    const options = Intl.DateTimeFormat().resolvedOptions();
+    signals.timeZone = options.timeZone;
+    signals.systemLocale = options.locale;
+    const year = (/* @__PURE__ */ new Date()).getFullYear();
+    signals.januaryOffset = new Date(year, 0, 1).getTimezoneOffset();
+    signals.julyOffset = new Date(year, 6, 1).getTimezoneOffset();
+  } catch {
+  }
+  return detectLocale(signals);
+}
+function formatLabel(template, values) {
+  return template.replace(/\{(\w+)\}/g, (match, key) => key in values ? String(values[key]) : match);
+}
+function policyLanguageOf(locale) {
+  return locale === "uk" ? "uk" : "en";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_LOCALE,
+  LOCALE_STORAGE_KEY,
+  TUWA_LOCALES,
+  detectLocale,
+  formatLabel,
+  normalizeLocale,
+  policyLanguageOf,
+  resolveClientLocale
+});

package/dist/locale.d.cts

@@ -0,0 +1,81 @@
+/**
+ * Locale primitives shared by the TUWA sites (docs hub, website, Quasar dashboard). Pure functions without React and
+ * without a `'use client'` directive, so server code (metadata, sitemaps) can call them too.
+ *
+ * Privacy: the locale is resolved from signals the browser already has (Local Storage, `navigator.languages`, the
+ * time zone). No GeoIP lookup, no cookie and no request is ever made.
+ */
+/** A locale of the TUWA sites. */
+type TuwaLocale = 'en' | 'uk' | 'zh-CN';
+/** Every supported locale, the default first. */
+declare const TUWA_LOCALES: readonly TuwaLocale[];
+/** The locale used on the server and when nothing else matches. */
+declare const DEFAULT_LOCALE: TuwaLocale;
+/**
+ * Local Storage key of the locale the visitor picked. Shared by every TUWA site, so a choice on one origin of the same
+ * site is kept; list it in `PreferenceExpiry` to forget it after 30 days (Cookie Policy).
+ */
+declare const LOCALE_STORAGE_KEY = "tuwa-locale";
+/**
+ * Maps a language tag or a stored value to a supported locale.
+ *
+ * @param tag - A BCP 47 tag (`uk-UA`, `zh-Hans`, `en-US`), a region alias (`ua`) or a stored value.
+ * @returns The matching {@link TuwaLocale}, or `null` when the tag names none.
+ */
+declare function normalizeLocale(tag: string | null | undefined): TuwaLocale | null;
+/**
+ * Browser signals read by {@link detectLocale}. Each is optional, so tests and server code can pass what they have.
+ */
+interface LocaleSignals {
+    /** The locale saved under {@link LOCALE_STORAGE_KEY}. */
+    stored?: string | null;
+    /** `navigator.languages`, or `[navigator.language]`. */
+    languages?: readonly string[];
+    /** IANA time zone, `Intl.DateTimeFormat().resolvedOptions().timeZone`. */
+    timeZone?: string;
+    /** Locale of the system, `Intl.DateTimeFormat().resolvedOptions().locale`. */
+    systemLocale?: string;
+    /** Offset of January 1 in minutes, `new Date(year, 0, 1).getTimezoneOffset()`. */
+    januaryOffset?: number;
+    /** Offset of July 1 in minutes, `new Date(year, 6, 1).getTimezoneOffset()`. */
+    julyOffset?: number;
+}
+/**
+ * Picks the locale from browser signals, in this order:
+ * 1. The locale the visitor picked (`stored`).
+ * 2. Ukrainian or Simplified Chinese in the browser languages, in the order the visitor ranked them.
+ * 3. A Ukrainian time zone, or a language or system locale with the region Ukraine (`ru-UA`, `en-UA`).
+ * 4. A mainland China time zone or system locale.
+ * 5. Russian with a masked time zone (UTC) and the Eastern European offsets (UTC+2 in winter, UTC+3 in summer).
+ * 6. English.
+ *
+ * @param signals - What the browser exposes.
+ * @returns The resolved {@link TuwaLocale}.
+ */
+declare function detectLocale(signals: LocaleSignals): TuwaLocale;
+/**
+ * Reads the browser signals and resolves the locale with {@link detectLocale}. Returns {@link DEFAULT_LOCALE} on the
+ * server. Never throws: blocked storage or a missing `Intl` only drop that signal.
+ *
+ * @param storageKey - Local Storage key of the picked locale (default: {@link LOCALE_STORAGE_KEY}).
+ * @returns The resolved {@link TuwaLocale}.
+ */
+declare function resolveClientLocale(storageKey?: string): TuwaLocale;
+/**
+ * Replaces `{name}` tokens of a template with values, as the labels of Nova UI Kit do. Unknown tokens stay.
+ *
+ * @param template - Text with `{name}` tokens.
+ * @param values - Values by token name.
+ * @returns The text with the values in place.
+ */
+declare function formatLabel(template: string, values: Record<string, string | number>): string;
+/**
+ * The language of the TUWA policies for a site locale: policies exist in English and Ukrainian only.
+ *
+ * @param locale - The site locale.
+ * @returns `uk` for Ukrainian, `en` otherwise.
+ */
+declare function policyLanguageOf(locale: TuwaLocale): 'en' | 'uk';
+
+export { DEFAULT_LOCALE, LOCALE_STORAGE_KEY, TUWA_LOCALES, detectLocale, formatLabel, normalizeLocale, policyLanguageOf, resolveClientLocale };
+export type { LocaleSignals, TuwaLocale };