@open-mercato/shared 0.6.6-develop.6377.1.d26fed7324 → 0.6.6-develop.6381.1.042df302c3

package/dist/lib/i18n/context.js

@@ -22,9 +22,10 @@ function format(template, params) {
     return String(value);
   });
 }
-function I18nProvider({ children, locale, dict }) {
+function I18nProvider({ children, locale, dict, localeLocked = false }) {
   const value = useMemo(() => ({
     locale,
+    localeLocked,
     t: (key, fallbackOrParams, params) => {
       let fallback;
       let resolvedParams;
@@ -37,7 +38,7 @@ function I18nProvider({ children, locale, dict }) {
       const template = dict[key] ?? fallback ?? key;
       return format(template, resolvedParams);
     }
-  }), [locale, dict]);
+  }), [locale, dict, localeLocked]);
   return /* @__PURE__ */ jsx(I18nContext.Provider, { value, children });
 }
 function useT() {
@@ -54,9 +55,14 @@ function useLocale() {
   if (!ctx) throw new Error("useLocale must be used within I18nProvider");
   return ctx.locale;
 }
+function useLocaleLocked() {
+  const ctx = useContext(I18nContext);
+  return ctx?.localeLocked ?? false;
+}
 export {
   I18nProvider,
   useLocale,
+  useLocaleLocked,
   useOptionalT,
   useT
 };

package/dist/lib/i18n/context.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/i18n/context.tsx"],
-  "sourcesContent": ["\"use client\"\nimport { createContext, useContext, useMemo, type ReactNode } from 'react'\nimport type { Locale } from './config'\n\nexport type Dict = Record<string, string>\n\nexport type TranslateParams = Record<string, string | number>\n\nexport type TranslateFn = (\n  key: string,\n  fallbackOrParams?: string | TranslateParams,\n  params?: TranslateParams\n) => string\n\nexport type I18nContextValue = {\n  locale: Locale\n  t: TranslateFn\n}\n\nconst I18N_CONTEXT_KEY = '__openMercatoI18nContext'\n\ntype GlobalI18nContextStore = typeof globalThis & {\n  [I18N_CONTEXT_KEY]?: ReturnType<typeof createContext<I18nContextValue | null>>\n}\n\nfunction getI18nContext() {\n  const store = globalThis as GlobalI18nContextStore\n  if (!store[I18N_CONTEXT_KEY]) {\n    store[I18N_CONTEXT_KEY] = createContext<I18nContextValue | null>(null)\n  }\n  return store[I18N_CONTEXT_KEY]\n}\n\nconst I18nContext = getI18nContext()\n\nfunction format(template: string, params?: TranslateParams) {\n  if (!params) return template\n  return template.replace(/\\{\\{(\\w+)\\}\\}|\\{(\\w+)\\}/g, (_, doubleKey, singleKey) => {\n    const key = doubleKey ?? singleKey\n    if (!key) return _\n    const value = params[key]\n    if (value === undefined) {\n      return doubleKey ? `{{${key}}}` : `{${key}}`\n    }\n    return String(value)\n  })\n}\n\nexport function I18nProvider({ children, locale, dict }: { children: ReactNode; locale: Locale; dict: Dict }) {\n  const value = useMemo<I18nContextValue>(() => ({\n    locale,\n    t: (key, fallbackOrParams, params) => {\n      let fallback: string | undefined\n      let resolvedParams: TranslateParams | undefined\n\n      if (typeof fallbackOrParams === 'string') {\n        fallback = fallbackOrParams\n        resolvedParams = params\n      } else {\n        resolvedParams = fallbackOrParams ?? params\n      }\n\n      const template = dict[key] ?? fallback ?? key\n      return format(template, resolvedParams)\n    },\n  }), [locale, dict])\n  return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>\n}\n\nexport function useT() {\n  const ctx = useContext(I18nContext)\n  if (!ctx) throw new Error('useT must be used within I18nProvider')\n  return ctx.t\n}\n\n/**\n * Like `useT`, but returns `undefined` instead of throwing when no\n * `I18nProvider` is in scope. Use where a translator is desirable but not\n * guaranteed (e.g. plumbing `t` into side-effect handlers that may run before\n * the provider mounts) \u2014 callers MUST provide a fallback.\n */\nexport function useOptionalT(): TranslateFn | undefined {\n  const ctx = useContext(I18nContext)\n  return ctx?.t\n}\n\nexport function useLocale() {\n  const ctx = useContext(I18nContext)\n  if (!ctx) throw new Error('useLocale must be used within I18nProvider')\n  return ctx.locale\n}\n"],
-  "mappings": ";AAkES;AAjET,SAAS,eAAe,YAAY,eAA+B;AAkBnE,MAAM,mBAAmB;AAMzB,SAAS,iBAAiB;AACxB,QAAM,QAAQ;AACd,MAAI,CAAC,MAAM,gBAAgB,GAAG;AAC5B,UAAM,gBAAgB,IAAI,cAAuC,IAAI;AAAA,EACvE;AACA,SAAO,MAAM,gBAAgB;AAC/B;AAEA,MAAM,cAAc,eAAe;AAEnC,SAAS,OAAO,UAAkB,QAA0B;AAC1D,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,SAAS,QAAQ,4BAA4B,CAAC,GAAG,WAAW,cAAc;AAC/E,UAAM,MAAM,aAAa;AACzB,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,QAAQ,OAAO,GAAG;AACxB,QAAI,UAAU,QAAW;AACvB,aAAO,YAAY,KAAK,GAAG,OAAO,IAAI,GAAG;AAAA,IAC3C;AACA,WAAO,OAAO,KAAK;AAAA,EACrB,CAAC;AACH;AAEO,SAAS,aAAa,EAAE,UAAU,QAAQ,KAAK,GAAwD;AAC5G,QAAM,QAAQ,QAA0B,OAAO;AAAA,IAC7C;AAAA,IACA,GAAG,CAAC,KAAK,kBAAkB,WAAW;AACpC,UAAI;AACJ,UAAI;AAEJ,UAAI,OAAO,qBAAqB,UAAU;AACxC,mBAAW;AACX,yBAAiB;AAAA,MACnB,OAAO;AACL,yBAAiB,oBAAoB;AAAA,MACvC;AAEA,YAAM,WAAW,KAAK,GAAG,KAAK,YAAY;AAC1C,aAAO,OAAO,UAAU,cAAc;AAAA,IACxC;AAAA,EACF,IAAI,CAAC,QAAQ,IAAI,CAAC;AAClB,SAAO,oBAAC,YAAY,UAAZ,EAAqB,OAAe,UAAS;AACvD;AAEO,SAAS,OAAO;AACrB,QAAM,MAAM,WAAW,WAAW;AAClC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,uCAAuC;AACjE,SAAO,IAAI;AACb;AAQO,SAAS,eAAwC;AACtD,QAAM,MAAM,WAAW,WAAW;AAClC,SAAO,KAAK;AACd;AAEO,SAAS,YAAY;AAC1B,QAAM,MAAM,WAAW,WAAW;AAClC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4CAA4C;AACtE,SAAO,IAAI;AACb;",
+  "sourcesContent": ["\"use client\"\nimport { createContext, useContext, useMemo, type ReactNode } from 'react'\nimport type { Locale } from './config'\n\nexport type Dict = Record<string, string>\n\nexport type TranslateParams = Record<string, string | number>\n\nexport type TranslateFn = (\n  key: string,\n  fallbackOrParams?: string | TranslateParams,\n  params?: TranslateParams\n) => string\n\nexport type I18nContextValue = {\n  locale: Locale\n  t: TranslateFn\n  /** True when the locale is pinned via `OM_FORCE_LOCALE`; UI should hide switchers. */\n  localeLocked: boolean\n}\n\nconst I18N_CONTEXT_KEY = '__openMercatoI18nContext'\n\ntype GlobalI18nContextStore = typeof globalThis & {\n  [I18N_CONTEXT_KEY]?: ReturnType<typeof createContext<I18nContextValue | null>>\n}\n\nfunction getI18nContext() {\n  const store = globalThis as GlobalI18nContextStore\n  if (!store[I18N_CONTEXT_KEY]) {\n    store[I18N_CONTEXT_KEY] = createContext<I18nContextValue | null>(null)\n  }\n  return store[I18N_CONTEXT_KEY]\n}\n\nconst I18nContext = getI18nContext()\n\nfunction format(template: string, params?: TranslateParams) {\n  if (!params) return template\n  return template.replace(/\\{\\{(\\w+)\\}\\}|\\{(\\w+)\\}/g, (_, doubleKey, singleKey) => {\n    const key = doubleKey ?? singleKey\n    if (!key) return _\n    const value = params[key]\n    if (value === undefined) {\n      return doubleKey ? `{{${key}}}` : `{${key}}`\n    }\n    return String(value)\n  })\n}\n\nexport function I18nProvider({ children, locale, dict, localeLocked = false }: { children: ReactNode; locale: Locale; dict: Dict; localeLocked?: boolean }) {\n  const value = useMemo<I18nContextValue>(() => ({\n    locale,\n    localeLocked,\n    t: (key, fallbackOrParams, params) => {\n      let fallback: string | undefined\n      let resolvedParams: TranslateParams | undefined\n\n      if (typeof fallbackOrParams === 'string') {\n        fallback = fallbackOrParams\n        resolvedParams = params\n      } else {\n        resolvedParams = fallbackOrParams ?? params\n      }\n\n      const template = dict[key] ?? fallback ?? key\n      return format(template, resolvedParams)\n    },\n  }), [locale, dict, localeLocked])\n  return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>\n}\n\nexport function useT() {\n  const ctx = useContext(I18nContext)\n  if (!ctx) throw new Error('useT must be used within I18nProvider')\n  return ctx.t\n}\n\n/**\n * Like `useT`, but returns `undefined` instead of throwing when no\n * `I18nProvider` is in scope. Use where a translator is desirable but not\n * guaranteed (e.g. plumbing `t` into side-effect handlers that may run before\n * the provider mounts) \u2014 callers MUST provide a fallback.\n */\nexport function useOptionalT(): TranslateFn | undefined {\n  const ctx = useContext(I18nContext)\n  return ctx?.t\n}\n\nexport function useLocale() {\n  const ctx = useContext(I18nContext)\n  if (!ctx) throw new Error('useLocale must be used within I18nProvider')\n  return ctx.locale\n}\n\n/**\n * True when the active locale is pinned via `OM_FORCE_LOCALE`. Returns `false`\n * when no provider is in scope so callers can render unconditionally.\n */\nexport function useLocaleLocked() {\n  const ctx = useContext(I18nContext)\n  return ctx?.localeLocked ?? false\n}\n"],
+  "mappings": ";AAqES;AApET,SAAS,eAAe,YAAY,eAA+B;AAoBnE,MAAM,mBAAmB;AAMzB,SAAS,iBAAiB;AACxB,QAAM,QAAQ;AACd,MAAI,CAAC,MAAM,gBAAgB,GAAG;AAC5B,UAAM,gBAAgB,IAAI,cAAuC,IAAI;AAAA,EACvE;AACA,SAAO,MAAM,gBAAgB;AAC/B;AAEA,MAAM,cAAc,eAAe;AAEnC,SAAS,OAAO,UAAkB,QAA0B;AAC1D,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,SAAS,QAAQ,4BAA4B,CAAC,GAAG,WAAW,cAAc;AAC/E,UAAM,MAAM,aAAa;AACzB,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,QAAQ,OAAO,GAAG;AACxB,QAAI,UAAU,QAAW;AACvB,aAAO,YAAY,KAAK,GAAG,OAAO,IAAI,GAAG;AAAA,IAC3C;AACA,WAAO,OAAO,KAAK;AAAA,EACrB,CAAC;AACH;AAEO,SAAS,aAAa,EAAE,UAAU,QAAQ,MAAM,eAAe,MAAM,GAAgF;AAC1J,QAAM,QAAQ,QAA0B,OAAO;AAAA,IAC7C;AAAA,IACA;AAAA,IACA,GAAG,CAAC,KAAK,kBAAkB,WAAW;AACpC,UAAI;AACJ,UAAI;AAEJ,UAAI,OAAO,qBAAqB,UAAU;AACxC,mBAAW;AACX,yBAAiB;AAAA,MACnB,OAAO;AACL,yBAAiB,oBAAoB;AAAA,MACvC;AAEA,YAAM,WAAW,KAAK,GAAG,KAAK,YAAY;AAC1C,aAAO,OAAO,UAAU,cAAc;AAAA,IACxC;AAAA,EACF,IAAI,CAAC,QAAQ,MAAM,YAAY,CAAC;AAChC,SAAO,oBAAC,YAAY,UAAZ,EAAqB,OAAe,UAAS;AACvD;AAEO,SAAS,OAAO;AACrB,QAAM,MAAM,WAAW,WAAW;AAClC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,uCAAuC;AACjE,SAAO,IAAI;AACb;AAQO,SAAS,eAAwC;AACtD,QAAM,MAAM,WAAW,WAAW;AAClC,SAAO,KAAK;AACd;AAEO,SAAS,YAAY;AAC1B,QAAM,MAAM,WAAW,WAAW;AAClC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4CAA4C;AACtE,SAAO,IAAI;AACb;AAMO,SAAS,kBAAkB;AAChC,QAAM,MAAM,WAAW,WAAW;AAClC,SAAO,KAAK,gBAAgB;AAC9B;",
   "names": []
 }

package/dist/lib/i18n/locale.js

@@ -22,6 +22,9 @@ function resolveLocaleFromCandidates(candidates) {
   }
   return null;
 }
+function resolveForcedLocale(env) {
+  return resolveSupportedLocale(env.OM_FORCE_LOCALE);
+}
 function resolveLocaleFromAcceptLanguage(acceptLanguage) {
   if (typeof acceptLanguage !== "string" || acceptLanguage.trim().length === 0) {
     return null;
@@ -42,6 +45,7 @@ function resolveLocaleFromAcceptLanguage(acceptLanguage) {
   return resolveLocaleFromCandidates(rankedCandidates.map((entry) => entry.locale));
 }
 export {
+  resolveForcedLocale,
   resolveLocaleFromAcceptLanguage,
   resolveLocaleFromCandidates,
   resolveSupportedLocale

package/dist/lib/i18n/locale.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/i18n/locale.ts"],
-  "sourcesContent": ["import { locales, type Locale } from './config'\n\nfunction normalizeLocaleToken(value: string): string {\n  return value.trim().toLowerCase().replace(/_/g, '-')\n}\n\nexport function resolveSupportedLocale(value: string | null | undefined): Locale | null {\n  if (typeof value !== 'string') return null\n\n  const normalized = normalizeLocaleToken(value)\n  if (!normalized) return null\n\n  if (locales.includes(normalized as Locale)) {\n    return normalized as Locale\n  }\n\n  const baseLocale = normalized.split('-')[0]\n  if (baseLocale && locales.includes(baseLocale as Locale)) {\n    return baseLocale as Locale\n  }\n\n  return null\n}\n\nexport function resolveLocaleFromCandidates(\n  candidates: Iterable<string | null | undefined>,\n): Locale | null {\n  for (const candidate of candidates) {\n    const resolved = resolveSupportedLocale(candidate)\n    if (resolved) return resolved\n  }\n  return null\n}\n\nexport function resolveLocaleFromAcceptLanguage(\n  acceptLanguage: string | null | undefined,\n): Locale | null {\n  if (typeof acceptLanguage !== 'string' || acceptLanguage.trim().length === 0) {\n    return null\n  }\n\n  const rankedCandidates = acceptLanguage\n    .split(',')\n    .map((entry, index) => {\n      const [rawLocale, ...rawParams] = entry.split(';')\n      const locale = rawLocale?.trim() ?? ''\n      const qParam = rawParams.find((param) => param.trim().startsWith('q='))\n      const parsedQ = qParam ? Number.parseFloat(qParam.trim().slice(2)) : 1\n      const quality = Number.isFinite(parsedQ) ? Math.min(Math.max(parsedQ, 0), 1) : 1\n\n      return { locale, quality, index }\n    })\n    .filter((entry) => entry.locale.length > 0 && entry.quality > 0)\n    .sort((left, right) => {\n      if (right.quality !== left.quality) {\n        return right.quality - left.quality\n      }\n      return left.index - right.index\n    })\n\n  return resolveLocaleFromCandidates(rankedCandidates.map((entry) => entry.locale))\n}\n"],
-  "mappings": "AAAA,SAAS,eAA4B;AAErC,SAAS,qBAAqB,OAAuB;AACnD,SAAO,MAAM,KAAK,EAAE,YAAY,EAAE,QAAQ,MAAM,GAAG;AACrD;AAEO,SAAS,uBAAuB,OAAiD;AACtF,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,QAAM,aAAa,qBAAqB,KAAK;AAC7C,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI,QAAQ,SAAS,UAAoB,GAAG;AAC1C,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,WAAW,MAAM,GAAG,EAAE,CAAC;AAC1C,MAAI,cAAc,QAAQ,SAAS,UAAoB,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,4BACd,YACe;AACf,aAAW,aAAa,YAAY;AAClC,UAAM,WAAW,uBAAuB,SAAS;AACjD,QAAI,SAAU,QAAO;AAAA,EACvB;AACA,SAAO;AACT;AAEO,SAAS,gCACd,gBACe;AACf,MAAI,OAAO,mBAAmB,YAAY,eAAe,KAAK,EAAE,WAAW,GAAG;AAC5E,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,eACtB,MAAM,GAAG,EACT,IAAI,CAAC,OAAO,UAAU;AACrB,UAAM,CAAC,WAAW,GAAG,SAAS,IAAI,MAAM,MAAM,GAAG;AACjD,UAAM,SAAS,WAAW,KAAK,KAAK;AACpC,UAAM,SAAS,UAAU,KAAK,CAAC,UAAU,MAAM,KAAK,EAAE,WAAW,IAAI,CAAC;AACtE,UAAM,UAAU,SAAS,OAAO,WAAW,OAAO,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI;AACrE,UAAM,UAAU,OAAO,SAAS,OAAO,IAAI,KAAK,IAAI,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI;AAE/E,WAAO,EAAE,QAAQ,SAAS,MAAM;AAAA,EAClC,CAAC,EACA,OAAO,CAAC,UAAU,MAAM,OAAO,SAAS,KAAK,MAAM,UAAU,CAAC,EAC9D,KAAK,CAAC,MAAM,UAAU;AACrB,QAAI,MAAM,YAAY,KAAK,SAAS;AAClC,aAAO,MAAM,UAAU,KAAK;AAAA,IAC9B;AACA,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC5B,CAAC;AAEH,SAAO,4BAA4B,iBAAiB,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC;AAClF;",
+  "sourcesContent": ["import { locales, type Locale } from './config'\n\nfunction normalizeLocaleToken(value: string): string {\n  return value.trim().toLowerCase().replace(/_/g, '-')\n}\n\nexport function resolveSupportedLocale(value: string | null | undefined): Locale | null {\n  if (typeof value !== 'string') return null\n\n  const normalized = normalizeLocaleToken(value)\n  if (!normalized) return null\n\n  if (locales.includes(normalized as Locale)) {\n    return normalized as Locale\n  }\n\n  const baseLocale = normalized.split('-')[0]\n  if (baseLocale && locales.includes(baseLocale as Locale)) {\n    return baseLocale as Locale\n  }\n\n  return null\n}\n\nexport function resolveLocaleFromCandidates(\n  candidates: Iterable<string | null | undefined>,\n): Locale | null {\n  for (const candidate of candidates) {\n    const resolved = resolveSupportedLocale(candidate)\n    if (resolved) return resolved\n  }\n  return null\n}\n\n/**\n * Reads the optional `OM_FORCE_LOCALE` env override. When set to a supported\n * locale (e.g. `pl`), the whole app is pinned to it and cookie/Accept-Language\n * detection is bypassed. Unset (the default) \u2192 `null` \u2192 normal detection.\n * Pure: pass the env bag so it stays testable and safe to call server-side only.\n */\nexport function resolveForcedLocale(\n  env: Record<string, string | undefined>,\n): Locale | null {\n  return resolveSupportedLocale(env.OM_FORCE_LOCALE)\n}\n\nexport function resolveLocaleFromAcceptLanguage(\n  acceptLanguage: string | null | undefined,\n): Locale | null {\n  if (typeof acceptLanguage !== 'string' || acceptLanguage.trim().length === 0) {\n    return null\n  }\n\n  const rankedCandidates = acceptLanguage\n    .split(',')\n    .map((entry, index) => {\n      const [rawLocale, ...rawParams] = entry.split(';')\n      const locale = rawLocale?.trim() ?? ''\n      const qParam = rawParams.find((param) => param.trim().startsWith('q='))\n      const parsedQ = qParam ? Number.parseFloat(qParam.trim().slice(2)) : 1\n      const quality = Number.isFinite(parsedQ) ? Math.min(Math.max(parsedQ, 0), 1) : 1\n\n      return { locale, quality, index }\n    })\n    .filter((entry) => entry.locale.length > 0 && entry.quality > 0)\n    .sort((left, right) => {\n      if (right.quality !== left.quality) {\n        return right.quality - left.quality\n      }\n      return left.index - right.index\n    })\n\n  return resolveLocaleFromCandidates(rankedCandidates.map((entry) => entry.locale))\n}\n"],
+  "mappings": "AAAA,SAAS,eAA4B;AAErC,SAAS,qBAAqB,OAAuB;AACnD,SAAO,MAAM,KAAK,EAAE,YAAY,EAAE,QAAQ,MAAM,GAAG;AACrD;AAEO,SAAS,uBAAuB,OAAiD;AACtF,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,QAAM,aAAa,qBAAqB,KAAK;AAC7C,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI,QAAQ,SAAS,UAAoB,GAAG;AAC1C,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,WAAW,MAAM,GAAG,EAAE,CAAC;AAC1C,MAAI,cAAc,QAAQ,SAAS,UAAoB,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,4BACd,YACe;AACf,aAAW,aAAa,YAAY;AAClC,UAAM,WAAW,uBAAuB,SAAS;AACjD,QAAI,SAAU,QAAO;AAAA,EACvB;AACA,SAAO;AACT;AAQO,SAAS,oBACd,KACe;AACf,SAAO,uBAAuB,IAAI,eAAe;AACnD;AAEO,SAAS,gCACd,gBACe;AACf,MAAI,OAAO,mBAAmB,YAAY,eAAe,KAAK,EAAE,WAAW,GAAG;AAC5E,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,eACtB,MAAM,GAAG,EACT,IAAI,CAAC,OAAO,UAAU;AACrB,UAAM,CAAC,WAAW,GAAG,SAAS,IAAI,MAAM,MAAM,GAAG;AACjD,UAAM,SAAS,WAAW,KAAK,KAAK;AACpC,UAAM,SAAS,UAAU,KAAK,CAAC,UAAU,MAAM,KAAK,EAAE,WAAW,IAAI,CAAC;AACtE,UAAM,UAAU,SAAS,OAAO,WAAW,OAAO,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI;AACrE,UAAM,UAAU,OAAO,SAAS,OAAO,IAAI,KAAK,IAAI,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI;AAE/E,WAAO,EAAE,QAAQ,SAAS,MAAM;AAAA,EAClC,CAAC,EACA,OAAO,CAAC,UAAU,MAAM,OAAO,SAAS,KAAK,MAAM,UAAU,CAAC,EAC9D,KAAK,CAAC,MAAM,UAAU;AACrB,QAAI,MAAM,YAAY,KAAK,SAAS;AAClC,aAAO,MAAM,UAAU,KAAK;AAAA,IAC9B;AACA,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC5B,CAAC;AAEH,SAAO,4BAA4B,iBAAiB,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC;AAClF;",
   "names": []
 }

package/dist/lib/i18n/server.js

@@ -1,5 +1,5 @@
 import { defaultLocale, locales } from "./config.js";
-import { resolveLocaleFromAcceptLanguage } from "./locale.js";
+import { resolveForcedLocale, resolveLocaleFromAcceptLanguage } from "./locale.js";
 import { createFallbackTranslator, createTranslator } from "./translate.js";
 import { getModules } from "../modules/registry.js";
 import { loadAppDictionary } from "./app-dictionaries.js";
@@ -22,6 +22,8 @@ function flattenDictionary(source, prefix = "") {
   return result;
 }
 async function detectLocale() {
+  const forced = resolveForcedLocale(process.env);
+  if (forced) return forced;
   try {
     const { cookies, headers } = await import("next/headers");
     try {

package/dist/lib/i18n/server.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/i18n/server.ts"],
-  "sourcesContent": ["import { defaultLocale, locales, type Locale } from './config'\nimport type { Dict } from './context'\nimport { resolveLocaleFromAcceptLanguage } from './locale'\nimport { createFallbackTranslator, createTranslator } from './translate'\nimport { getModules } from '../modules/registry'\nimport { loadAppDictionary } from './app-dictionaries'\nimport { getCachedDictionary, setCachedDictionary } from './dictionary-cache'\n\n// Re-export for backwards compatibility\nexport { registerModules, getModules } from '../modules/registry'\nexport { registerAppDictionaryLoader } from './app-dictionaries'\nexport { invalidateDictionaryCache } from './dictionary-cache'\n\nfunction flattenDictionary(source: unknown, prefix = ''): Dict {\n  if (!source || typeof source !== 'object' || Array.isArray(source)) return {}\n  const result: Dict = {}\n  for (const [key, value] of Object.entries(source as Record<string, unknown>)) {\n    if (!key) continue\n    const nextKey = prefix ? `${prefix}.${key}` : key\n    if (typeof value === 'string') {\n      result[nextKey] = value\n    } else if (value && typeof value === 'object' && !Array.isArray(value)) {\n      Object.assign(result, flattenDictionary(value, nextKey))\n    }\n  }\n  return result\n}\n\nexport async function detectLocale(): Promise<Locale> {\n  // Dynamic import to avoid requiring Next.js in non-Next.js contexts (CLI, tests)\n  try {\n    const { cookies, headers } = await import('next/headers')\n    try {\n      const c = (await cookies()).get('locale')?.value\n      if (c && locales.includes(c as Locale)) return c as Locale\n    } catch {\n      // cookies() may not be available outside request context (e.g., in tests)\n    }\n    try {\n      const accept = (await headers()).get('accept-language') || ''\n      const match = resolveLocaleFromAcceptLanguage(accept)\n      if (match) return match\n    } catch {\n      // headers() may not be available outside request context (e.g., in tests)\n    }\n  } catch {\n    // next/headers not available (CLI context)\n  }\n  return defaultLocale\n}\n\nexport async function loadDictionary(locale: Locale): Promise<Dict> {\n  // Locale dictionaries are immutable at runtime, so the flatten+merge below\n  // only needs to run once per locale. The cache is invalidated whenever\n  // modules or the app dictionary loader are (re)registered.\n  const cached = getCachedDictionary(locale)\n  if (cached) return cached\n  // Load from registry instead of @/ import (works in standalone packages)\n  const baseRaw = await loadAppDictionary(locale)\n  const merged: Dict = { ...flattenDictionary(baseRaw) }\n  const modules = getModules()\n  for (const m of modules) {\n    const dict = m.translations?.[locale]\n    if (dict) Object.assign(merged, flattenDictionary(dict))\n  }\n  setCachedDictionary(locale, merged)\n  return merged\n}\n\nexport async function resolveTranslations() {\n  const locale = await detectLocale()\n  const dict = await loadDictionary(locale)\n  const t = createTranslator(dict)\n  const translate = createFallbackTranslator(dict)\n  return { locale, dict, t, translate }\n}\n// Hint Next.js to keep this server-only; ignore if unavailable when running scripts outside Next.\ntry {\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  require('server-only')\n} catch {\n  // noop: allows running generator scripts without Next's server-only package\n}\n"],
-  "mappings": "AAAA,SAAS,eAAe,eAA4B;AAEpD,SAAS,uCAAuC;AAChD,SAAS,0BAA0B,wBAAwB;AAC3D,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,qBAAqB,2BAA2B;AAGzD,SAAS,iBAAiB,cAAAA,mBAAkB;AAC5C,SAAS,mCAAmC;AAC5C,SAAS,iCAAiC;AAE1C,SAAS,kBAAkB,QAAiB,SAAS,IAAU;AAC7D,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO,CAAC;AAC5E,QAAM,SAAe,CAAC;AACtB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAiC,GAAG;AAC5E,QAAI,CAAC,IAAK;AACV,UAAM,UAAU,SAAS,GAAG,MAAM,IAAI,GAAG,KAAK;AAC9C,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,OAAO,IAAI;AAAA,IACpB,WAAW,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtE,aAAO,OAAO,QAAQ,kBAAkB,OAAO,OAAO,CAAC;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,eAAgC;AAEpD,MAAI;AACF,UAAM,EAAE,SAAS,QAAQ,IAAI,MAAM,OAAO,cAAc;AACxD,QAAI;AACF,YAAM,KAAK,MAAM,QAAQ,GAAG,IAAI,QAAQ,GAAG;AAC3C,UAAI,KAAK,QAAQ,SAAS,CAAW,EAAG,QAAO;AAAA,IACjD,QAAQ;AAAA,IAER;AACA,QAAI;AACF,YAAM,UAAU,MAAM,QAAQ,GAAG,IAAI,iBAAiB,KAAK;AAC3D,YAAM,QAAQ,gCAAgC,MAAM;AACpD,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AAAA,IAER;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAEA,eAAsB,eAAe,QAA+B;AAIlE,QAAM,SAAS,oBAAoB,MAAM;AACzC,MAAI,OAAQ,QAAO;AAEnB,QAAM,UAAU,MAAM,kBAAkB,MAAM;AAC9C,QAAM,SAAe,EAAE,GAAG,kBAAkB,OAAO,EAAE;AACrD,QAAM,UAAU,WAAW;AAC3B,aAAW,KAAK,SAAS;AACvB,UAAM,OAAO,EAAE,eAAe,MAAM;AACpC,QAAI,KAAM,QAAO,OAAO,QAAQ,kBAAkB,IAAI,CAAC;AAAA,EACzD;AACA,sBAAoB,QAAQ,MAAM;AAClC,SAAO;AACT;AAEA,eAAsB,sBAAsB;AAC1C,QAAM,SAAS,MAAM,aAAa;AAClC,QAAM,OAAO,MAAM,eAAe,MAAM;AACxC,QAAM,IAAI,iBAAiB,IAAI;AAC/B,QAAM,YAAY,yBAAyB,IAAI;AAC/C,SAAO,EAAE,QAAQ,MAAM,GAAG,UAAU;AACtC;AAEA,IAAI;AAEF,UAAQ,aAAa;AACvB,QAAQ;AAER;",
+  "sourcesContent": ["import { defaultLocale, locales, type Locale } from './config'\nimport type { Dict } from './context'\nimport { resolveForcedLocale, resolveLocaleFromAcceptLanguage } from './locale'\nimport { createFallbackTranslator, createTranslator } from './translate'\nimport { getModules } from '../modules/registry'\nimport { loadAppDictionary } from './app-dictionaries'\nimport { getCachedDictionary, setCachedDictionary } from './dictionary-cache'\n\n// Re-export for backwards compatibility\nexport { registerModules, getModules } from '../modules/registry'\nexport { registerAppDictionaryLoader } from './app-dictionaries'\nexport { invalidateDictionaryCache } from './dictionary-cache'\n\nfunction flattenDictionary(source: unknown, prefix = ''): Dict {\n  if (!source || typeof source !== 'object' || Array.isArray(source)) return {}\n  const result: Dict = {}\n  for (const [key, value] of Object.entries(source as Record<string, unknown>)) {\n    if (!key) continue\n    const nextKey = prefix ? `${prefix}.${key}` : key\n    if (typeof value === 'string') {\n      result[nextKey] = value\n    } else if (value && typeof value === 'object' && !Array.isArray(value)) {\n      Object.assign(result, flattenDictionary(value, nextKey))\n    }\n  }\n  return result\n}\n\nexport async function detectLocale(): Promise<Locale> {\n  // Ops-level override: pin the whole app to one locale (default: unset).\n  const forced = resolveForcedLocale(process.env)\n  if (forced) return forced\n  // Dynamic import to avoid requiring Next.js in non-Next.js contexts (CLI, tests)\n  try {\n    const { cookies, headers } = await import('next/headers')\n    try {\n      const c = (await cookies()).get('locale')?.value\n      if (c && locales.includes(c as Locale)) return c as Locale\n    } catch {\n      // cookies() may not be available outside request context (e.g., in tests)\n    }\n    try {\n      const accept = (await headers()).get('accept-language') || ''\n      const match = resolveLocaleFromAcceptLanguage(accept)\n      if (match) return match\n    } catch {\n      // headers() may not be available outside request context (e.g., in tests)\n    }\n  } catch {\n    // next/headers not available (CLI context)\n  }\n  return defaultLocale\n}\n\nexport async function loadDictionary(locale: Locale): Promise<Dict> {\n  // Locale dictionaries are immutable at runtime, so the flatten+merge below\n  // only needs to run once per locale. The cache is invalidated whenever\n  // modules or the app dictionary loader are (re)registered.\n  const cached = getCachedDictionary(locale)\n  if (cached) return cached\n  // Load from registry instead of @/ import (works in standalone packages)\n  const baseRaw = await loadAppDictionary(locale)\n  const merged: Dict = { ...flattenDictionary(baseRaw) }\n  const modules = getModules()\n  for (const m of modules) {\n    const dict = m.translations?.[locale]\n    if (dict) Object.assign(merged, flattenDictionary(dict))\n  }\n  setCachedDictionary(locale, merged)\n  return merged\n}\n\nexport async function resolveTranslations() {\n  const locale = await detectLocale()\n  const dict = await loadDictionary(locale)\n  const t = createTranslator(dict)\n  const translate = createFallbackTranslator(dict)\n  return { locale, dict, t, translate }\n}\n// Hint Next.js to keep this server-only; ignore if unavailable when running scripts outside Next.\ntry {\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  require('server-only')\n} catch {\n  // noop: allows running generator scripts without Next's server-only package\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe,eAA4B;AAEpD,SAAS,qBAAqB,uCAAuC;AACrE,SAAS,0BAA0B,wBAAwB;AAC3D,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,qBAAqB,2BAA2B;AAGzD,SAAS,iBAAiB,cAAAA,mBAAkB;AAC5C,SAAS,mCAAmC;AAC5C,SAAS,iCAAiC;AAE1C,SAAS,kBAAkB,QAAiB,SAAS,IAAU;AAC7D,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO,CAAC;AAC5E,QAAM,SAAe,CAAC;AACtB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAiC,GAAG;AAC5E,QAAI,CAAC,IAAK;AACV,UAAM,UAAU,SAAS,GAAG,MAAM,IAAI,GAAG,KAAK;AAC9C,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,OAAO,IAAI;AAAA,IACpB,WAAW,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtE,aAAO,OAAO,QAAQ,kBAAkB,OAAO,OAAO,CAAC;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,eAAgC;AAEpD,QAAM,SAAS,oBAAoB,QAAQ,GAAG;AAC9C,MAAI,OAAQ,QAAO;AAEnB,MAAI;AACF,UAAM,EAAE,SAAS,QAAQ,IAAI,MAAM,OAAO,cAAc;AACxD,QAAI;AACF,YAAM,KAAK,MAAM,QAAQ,GAAG,IAAI,QAAQ,GAAG;AAC3C,UAAI,KAAK,QAAQ,SAAS,CAAW,EAAG,QAAO;AAAA,IACjD,QAAQ;AAAA,IAER;AACA,QAAI;AACF,YAAM,UAAU,MAAM,QAAQ,GAAG,IAAI,iBAAiB,KAAK;AAC3D,YAAM,QAAQ,gCAAgC,MAAM;AACpD,UAAI,MAAO,QAAO;AAAA,IACpB,QAAQ;AAAA,IAER;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAEA,eAAsB,eAAe,QAA+B;AAIlE,QAAM,SAAS,oBAAoB,MAAM;AACzC,MAAI,OAAQ,QAAO;AAEnB,QAAM,UAAU,MAAM,kBAAkB,MAAM;AAC9C,QAAM,SAAe,EAAE,GAAG,kBAAkB,OAAO,EAAE;AACrD,QAAM,UAAU,WAAW;AAC3B,aAAW,KAAK,SAAS;AACvB,UAAM,OAAO,EAAE,eAAe,MAAM;AACpC,QAAI,KAAM,QAAO,OAAO,QAAQ,kBAAkB,IAAI,CAAC;AAAA,EACzD;AACA,sBAAoB,QAAQ,MAAM;AAClC,SAAO;AACT;AAEA,eAAsB,sBAAsB;AAC1C,QAAM,SAAS,MAAM,aAAa;AAClC,QAAM,OAAO,MAAM,eAAe,MAAM;AACxC,QAAM,IAAI,iBAAiB,IAAI;AAC/B,QAAM,YAAY,yBAAyB,IAAI;AAC/C,SAAO,EAAE,QAAQ,MAAM,GAAG,UAAU;AACtC;AAEA,IAAI;AAEF,UAAQ,aAAa;AACvB,QAAQ;AAER;",
   "names": ["getModules"]
 }

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.6.6-develop.6377.1.d26fed7324";
+const APP_VERSION = "0.6.6-develop.6381.1.042df302c3";
 const appVersion = APP_VERSION;
 export {
   APP_VERSION,

package/dist/lib/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/version.ts"],
-  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.6-develop.6377.1.d26fed7324'\nexport const appVersion = APP_VERSION\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.6-develop.6381.1.042df302c3'\nexport const appVersion = APP_VERSION\n"],
   "mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.6.6-develop.6377.1.d26fed7324",
+  "version": "0.6.6-develop.6381.1.042df302c3",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -93,7 +93,7 @@
     "@mikro-orm/core": "^7.1.4",
     "@mikro-orm/decorators": "^7.1.4",
     "@mikro-orm/postgresql": "^7.1.4",
-    "@open-mercato/cache": "0.6.6-develop.6377.1.d26fed7324",
+    "@open-mercato/cache": "0.6.6-develop.6381.1.042df302c3",
     "dotenv": "^17.4.2",
     "rate-limiter-flexible": "^11.2.0",
     "re2js": "2.8.3",

package/src/lib/i18n/__tests__/forced-locale.test.ts

@@ -0,0 +1,25 @@
+import { resolveForcedLocale } from '../locale'
+
+describe('resolveForcedLocale', () => {
+  it('returns null when OM_FORCE_LOCALE is unset (default: no forcing)', () => {
+    expect(resolveForcedLocale({})).toBeNull()
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: '' })).toBeNull()
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: undefined })).toBeNull()
+  })
+
+  it('returns the forced locale when set to a supported value', () => {
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'pl' })).toBe('pl')
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'de' })).toBe('de')
+  })
+
+  it('normalizes region and casing to a supported base locale', () => {
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'PL' })).toBe('pl')
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'pl-PL' })).toBe('pl')
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'en_US' })).toBe('en')
+  })
+
+  it('returns null for unsupported locales rather than forcing garbage', () => {
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'fr' })).toBeNull()
+    expect(resolveForcedLocale({ OM_FORCE_LOCALE: 'not-a-locale' })).toBeNull()
+  })
+})

package/src/lib/i18n/context.tsx

@@ -15,6 +15,8 @@ export type TranslateFn = (
 export type I18nContextValue = {
   locale: Locale
   t: TranslateFn
+  /** True when the locale is pinned via `OM_FORCE_LOCALE`; UI should hide switchers. */
+  localeLocked: boolean
 }
 
 const I18N_CONTEXT_KEY = '__openMercatoI18nContext'
@@ -46,9 +48,10 @@ function format(template: string, params?: TranslateParams) {
   })
 }
 
-export function I18nProvider({ children, locale, dict }: { children: ReactNode; locale: Locale; dict: Dict }) {
+export function I18nProvider({ children, locale, dict, localeLocked = false }: { children: ReactNode; locale: Locale; dict: Dict; localeLocked?: boolean }) {
   const value = useMemo<I18nContextValue>(() => ({
     locale,
+    localeLocked,
     t: (key, fallbackOrParams, params) => {
       let fallback: string | undefined
       let resolvedParams: TranslateParams | undefined
@@ -63,7 +66,7 @@ export function I18nProvider({ children, locale, dict }: { children: ReactNode;
       const template = dict[key] ?? fallback ?? key
       return format(template, resolvedParams)
     },
-  }), [locale, dict])
+  }), [locale, dict, localeLocked])
   return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>
 }
 
@@ -89,3 +92,12 @@ export function useLocale() {
   if (!ctx) throw new Error('useLocale must be used within I18nProvider')
   return ctx.locale
 }
+
+/**
+ * True when the active locale is pinned via `OM_FORCE_LOCALE`. Returns `false`
+ * when no provider is in scope so callers can render unconditionally.
+ */
+export function useLocaleLocked() {
+  const ctx = useContext(I18nContext)
+  return ctx?.localeLocked ?? false
+}

package/src/lib/i18n/locale.ts

@@ -32,6 +32,18 @@ export function resolveLocaleFromCandidates(
   return null
 }
 
+/**
+ * Reads the optional `OM_FORCE_LOCALE` env override. When set to a supported
+ * locale (e.g. `pl`), the whole app is pinned to it and cookie/Accept-Language
+ * detection is bypassed. Unset (the default) → `null` → normal detection.
+ * Pure: pass the env bag so it stays testable and safe to call server-side only.
+ */
+export function resolveForcedLocale(
+  env: Record<string, string | undefined>,
+): Locale | null {
+  return resolveSupportedLocale(env.OM_FORCE_LOCALE)
+}
+
 export function resolveLocaleFromAcceptLanguage(
   acceptLanguage: string | null | undefined,
 ): Locale | null {

package/src/lib/i18n/server.ts

@@ -1,6 +1,6 @@
 import { defaultLocale, locales, type Locale } from './config'
 import type { Dict } from './context'
-import { resolveLocaleFromAcceptLanguage } from './locale'
+import { resolveForcedLocale, resolveLocaleFromAcceptLanguage } from './locale'
 import { createFallbackTranslator, createTranslator } from './translate'
 import { getModules } from '../modules/registry'
 import { loadAppDictionary } from './app-dictionaries'
@@ -27,6 +27,9 @@ function flattenDictionary(source: unknown, prefix = ''): Dict {
 }
 
 export async function detectLocale(): Promise<Locale> {
+  // Ops-level override: pin the whole app to one locale (default: unset).
+  const forced = resolveForcedLocale(process.env)
+  if (forced) return forced
   // Dynamic import to avoid requiring Next.js in non-Next.js contexts (CLI, tests)
   try {
     const { cookies, headers } = await import('next/headers')