feat(i18n): Hebrew locale + full RTL support

2026-07-08 00:07:34 +02:00
parent 8904d724bb
commit 22418c17cf
113 changed files with 3958 additions and 494 deletions
@@ -0,0 +1,38 @@
+import { routing } from './routing';
+import { useLocaleStore } from '@/stores/locale-store';
+
+/**
+ * Pick the best supported locale for a first-time visitor from their browser
+ * language preferences. Returns `fallback` (English default) when the browser
+ * prefers English, prefers nothing we support, or is unavailable (SSR) — so we
+ * only auto-switch AWAY from English when the browser clearly prefers another
+ * language we ship. A user's explicit choice is persisted separately and is
+ * never overridden by this.
+ */
+export function detectBrowserLocale(fallback: string): string {
+  if (typeof navigator === 'undefined') return fallback;
+  const supported = new Set<string>(routing.locales as readonly string[]);
+  const prefs = navigator.languages?.length ? navigator.languages : [navigator.language];
+  for (const tag of prefs) {
+    if (!tag) continue;
+    const base = tag.toLowerCase().split('-')[0];
+    if (base === 'en') return fallback;    // English is the top preference -> keep default
+    if (supported.has(base)) return base;  // first supported non-English preference wins
+  }
+  return fallback;
+}
+
+/**
+ * The locale to actually use for Intl/formatting and the provider: the user's
+ * stored choice when it's a real locale, otherwise (empty or 'auto') the
+ * resolved UI locale — never the 'auto' sentinel, which is not a valid BCP-47
+ * tag and throws in Intl.* APIs.
+ */
+export function getEffectiveLocale(): string {
+  const choice = useLocaleStore.getState().locale;
+  if (choice && choice !== 'auto') return choice;
+  if (typeof document !== 'undefined' && document.documentElement.lang) {
+    return document.documentElement.lang;
+  }
+  return detectBrowserLocale('en');
+}