@open-mercato/shared 0.6.8-develop.6975.1.b21e19d444 → 0.6.8-develop.6976.1.9b79145ac4

package/dist/lib/i18n/context.js

@@ -55,6 +55,10 @@ function useLocale() {
   if (!ctx) throw new Error("useLocale must be used within I18nProvider");
   return ctx.locale;
 }
+function useOptionalLocale() {
+  const ctx = useContext(I18nContext);
+  return ctx?.locale;
+}
 function useLocaleLocked() {
   const ctx = useContext(I18nContext);
   return ctx?.localeLocked ?? false;
@@ -63,6 +67,7 @@ export {
   I18nProvider,
   useLocale,
   useLocaleLocked,
+  useOptionalLocale,
   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  /** 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;",
+  "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 * Like `useLocale`, but returns `undefined` instead of throwing when no\n * `I18nProvider` is in scope. Use in shared components that receive their\n * translator as a prop and may render outside a provider (galleries, tests).\n */\nexport function useOptionalLocale(): Locale | undefined {\n  const ctx = useContext(I18nContext)\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;AAOO,SAAS,oBAAwC;AACtD,QAAM,MAAM,WAAW,WAAW;AAClC,SAAO,KAAK;AACd;AAMO,SAAS,kBAAkB;AAChC,QAAM,MAAM,WAAW,WAAW;AAClC,SAAO,KAAK,gBAAgB;AAC9B;",
   "names": []
 }

package/dist/lib/time.js

@@ -15,18 +15,13 @@ function formatRelativeTime(value, options) {
   const rtf = typeof Intl !== "undefined" && typeof Intl.RelativeTimeFormat === "function" ? new Intl.RelativeTimeFormat(options?.locale, { numeric: "auto" }) : null;
   const format = (unit, divisor) => {
     const valueToFormat = Math.round(diffSeconds / divisor);
-    const isPast = diffSeconds < 0;
-    if (translate) {
-      const suffixKey = isPast ? "time.relative.ago" : "time.relative.fromNow";
-      const fallbackSuffix2 = isPast ? "ago" : "from now";
-      const suffix = translate(suffixKey, fallbackSuffix2);
-      const magnitude2 = Math.abs(valueToFormat);
-      return `${magnitude2} ${unit}${magnitude2 === 1 ? "" : "s"} ${suffix}`;
-    }
     if (rtf) return rtf.format(valueToFormat, unit);
+    const isPast = diffSeconds < 0;
     const fallbackSuffix = isPast ? "ago" : "from now";
+    const suffixKey = isPast ? "time.relative.ago" : "time.relative.fromNow";
+    const suffix = translate ? translate(suffixKey, fallbackSuffix) : fallbackSuffix;
     const magnitude = Math.abs(valueToFormat);
-    return `${magnitude} ${unit}${magnitude === 1 ? "" : "s"} ${fallbackSuffix}`;
+    return `${magnitude} ${unit}${magnitude === 1 ? "" : "s"} ${suffix}`;
   };
   if (absSeconds < 45) return format("second", 1);
   if (absSeconds < 45 * 60) return format("minute", 60);

package/dist/lib/time.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/time.ts"],
-  "sourcesContent": ["\nexport function formatDateTime(value?: string | null): string | null {\n  if (!value) return null\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) return null\n  return date.toLocaleString()\n}\nexport type RelativeTimeTranslator = (\n  key: string,\n  fallback?: string,\n  params?: Record<string, string | number>\n) => string\n\nexport type FormatRelativeTimeOptions = {\n  translate?: RelativeTimeTranslator\n  locale?: string | string[]\n}\n\ntype RelativeTimeUnit = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'\n\nexport function formatRelativeTime(\n  value?: string | null,\n  options?: FormatRelativeTimeOptions\n): string | null {\n  if (!value) return null\n\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) return null\n\n  const now = Date.now()\n  const diffSeconds = (date.getTime() - now) / 1000\n  const absSeconds = Math.abs(diffSeconds)\n  const translate = options?.translate\n\n  const rtf =\n    typeof Intl !== 'undefined' && typeof Intl.RelativeTimeFormat === 'function'\n      ? new Intl.RelativeTimeFormat(options?.locale, { numeric: 'auto' })\n      : null\n\nconst format = (unit: RelativeTimeUnit, divisor: number) => {\n  const valueToFormat = Math.round(diffSeconds / divisor)\n  const isPast = diffSeconds < 0\n\n  if (translate) {\n    const suffixKey = isPast ? 'time.relative.ago' : 'time.relative.fromNow'\n    const fallbackSuffix = isPast ? 'ago' : 'from now'\n    const suffix = translate(suffixKey, fallbackSuffix)\n    const magnitude = Math.abs(valueToFormat)\n    return `${magnitude} ${unit}${magnitude === 1 ? '' : 's'} ${suffix}`\n  }\n\n  if (rtf) return rtf.format(valueToFormat, unit)\n\n  const fallbackSuffix = isPast ? 'ago' : 'from now'\n  const magnitude = Math.abs(valueToFormat)\n  return `${magnitude} ${unit}${magnitude === 1 ? '' : 's'} ${fallbackSuffix}`\n  }\n\n  if (absSeconds < 45) return format('second', 1)\n  if (absSeconds < 45 * 60) return format('minute', 60)\n  if (absSeconds < 24 * 60 * 60) return format('hour', 60 * 60)\n  if (absSeconds < 7 * 24 * 60 * 60) return format('day', 24 * 60 * 60)\n  if (absSeconds < 30 * 24 * 60 * 60) return format('week', 7 * 24 * 60 * 60)\n  if (absSeconds < 365 * 24 * 60 * 60) return format('month', 30 * 24 * 60 * 60)\n  return format('year', 365 * 24 * 60 * 60)\n}\n"],
-  "mappings": "AACO,SAAS,eAAe,OAAsC;AACnE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO;AACzC,SAAO,KAAK,eAAe;AAC7B;AAcO,SAAS,mBACd,OACA,SACe;AACf,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO;AAEzC,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,eAAe,KAAK,QAAQ,IAAI,OAAO;AAC7C,QAAM,aAAa,KAAK,IAAI,WAAW;AACvC,QAAM,YAAY,SAAS;AAE3B,QAAM,MACJ,OAAO,SAAS,eAAe,OAAO,KAAK,uBAAuB,aAC9D,IAAI,KAAK,mBAAmB,SAAS,QAAQ,EAAE,SAAS,OAAO,CAAC,IAChE;AAER,QAAM,SAAS,CAAC,MAAwB,YAAoB;AAC1D,UAAM,gBAAgB,KAAK,MAAM,cAAc,OAAO;AACtD,UAAM,SAAS,cAAc;AAE7B,QAAI,WAAW;AACb,YAAM,YAAY,SAAS,sBAAsB;AACjD,YAAMA,kBAAiB,SAAS,QAAQ;AACxC,YAAM,SAAS,UAAU,WAAWA,eAAc;AAClD,YAAMC,aAAY,KAAK,IAAI,aAAa;AACxC,aAAO,GAAGA,UAAS,IAAI,IAAI,GAAGA,eAAc,IAAI,KAAK,GAAG,IAAI,MAAM;AAAA,IACpE;AAEA,QAAI,IAAK,QAAO,IAAI,OAAO,eAAe,IAAI;AAE9C,UAAM,iBAAiB,SAAS,QAAQ;AACxC,UAAM,YAAY,KAAK,IAAI,aAAa;AACxC,WAAO,GAAG,SAAS,IAAI,IAAI,GAAG,cAAc,IAAI,KAAK,GAAG,IAAI,cAAc;AAAA,EAC1E;AAEA,MAAI,aAAa,GAAI,QAAO,OAAO,UAAU,CAAC;AAC9C,MAAI,aAAa,KAAK,GAAI,QAAO,OAAO,UAAU,EAAE;AACpD,MAAI,aAAa,KAAK,KAAK,GAAI,QAAO,OAAO,QAAQ,KAAK,EAAE;AAC5D,MAAI,aAAa,IAAI,KAAK,KAAK,GAAI,QAAO,OAAO,OAAO,KAAK,KAAK,EAAE;AACpE,MAAI,aAAa,KAAK,KAAK,KAAK,GAAI,QAAO,OAAO,QAAQ,IAAI,KAAK,KAAK,EAAE;AAC1E,MAAI,aAAa,MAAM,KAAK,KAAK,GAAI,QAAO,OAAO,SAAS,KAAK,KAAK,KAAK,EAAE;AAC7E,SAAO,OAAO,QAAQ,MAAM,KAAK,KAAK,EAAE;AAC1C;",
-  "names": ["fallbackSuffix", "magnitude"]
+  "sourcesContent": ["\nexport function formatDateTime(value?: string | null): string | null {\n  if (!value) return null\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) return null\n  return date.toLocaleString()\n}\nexport type RelativeTimeTranslator = (\n  key: string,\n  fallback?: string,\n  params?: Record<string, string | number>\n) => string\n\nexport type FormatRelativeTimeOptions = {\n  /**\n   * Supplies the suffix only when the runtime has no `Intl.RelativeTimeFormat`.\n   * Otherwise the number, unit name, plural form and suffix all come from\n   * `Intl` in `locale` \u2014 pass `useLocale()` client-side so the text follows the\n   * application language rather than the runtime one.\n   */\n  translate?: RelativeTimeTranslator\n  locale?: string | string[]\n}\n\ntype RelativeTimeUnit = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year'\n\nexport function formatRelativeTime(\n  value?: string | null,\n  options?: FormatRelativeTimeOptions\n): string | null {\n  if (!value) return null\n\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) return null\n\n  const now = Date.now()\n  const diffSeconds = (date.getTime() - now) / 1000\n  const absSeconds = Math.abs(diffSeconds)\n  const translate = options?.translate\n\n  const rtf =\n    typeof Intl !== 'undefined' && typeof Intl.RelativeTimeFormat === 'function'\n      ? new Intl.RelativeTimeFormat(options?.locale, { numeric: 'auto' })\n      : null\n\n  const format = (unit: RelativeTimeUnit, divisor: number) => {\n    const valueToFormat = Math.round(diffSeconds / divisor)\n    if (rtf) return rtf.format(valueToFormat, unit)\n\n    const isPast = diffSeconds < 0\n    const fallbackSuffix = isPast ? 'ago' : 'from now'\n    const suffixKey = isPast ? 'time.relative.ago' : 'time.relative.fromNow'\n    const suffix = translate ? translate(suffixKey, fallbackSuffix) : fallbackSuffix\n    const magnitude = Math.abs(valueToFormat)\n    return `${magnitude} ${unit}${magnitude === 1 ? '' : 's'} ${suffix}`\n  }\n\n  if (absSeconds < 45) return format('second', 1)\n  if (absSeconds < 45 * 60) return format('minute', 60)\n  if (absSeconds < 24 * 60 * 60) return format('hour', 60 * 60)\n  if (absSeconds < 7 * 24 * 60 * 60) return format('day', 24 * 60 * 60)\n  if (absSeconds < 30 * 24 * 60 * 60) return format('week', 7 * 24 * 60 * 60)\n  if (absSeconds < 365 * 24 * 60 * 60) return format('month', 30 * 24 * 60 * 60)\n  return format('year', 365 * 24 * 60 * 60)\n}\n"],
+  "mappings": "AACO,SAAS,eAAe,OAAsC;AACnE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO;AACzC,SAAO,KAAK,eAAe;AAC7B;AAoBO,SAAS,mBACd,OACA,SACe;AACf,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO;AAEzC,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,eAAe,KAAK,QAAQ,IAAI,OAAO;AAC7C,QAAM,aAAa,KAAK,IAAI,WAAW;AACvC,QAAM,YAAY,SAAS;AAE3B,QAAM,MACJ,OAAO,SAAS,eAAe,OAAO,KAAK,uBAAuB,aAC9D,IAAI,KAAK,mBAAmB,SAAS,QAAQ,EAAE,SAAS,OAAO,CAAC,IAChE;AAEN,QAAM,SAAS,CAAC,MAAwB,YAAoB;AAC1D,UAAM,gBAAgB,KAAK,MAAM,cAAc,OAAO;AACtD,QAAI,IAAK,QAAO,IAAI,OAAO,eAAe,IAAI;AAE9C,UAAM,SAAS,cAAc;AAC7B,UAAM,iBAAiB,SAAS,QAAQ;AACxC,UAAM,YAAY,SAAS,sBAAsB;AACjD,UAAM,SAAS,YAAY,UAAU,WAAW,cAAc,IAAI;AAClE,UAAM,YAAY,KAAK,IAAI,aAAa;AACxC,WAAO,GAAG,SAAS,IAAI,IAAI,GAAG,cAAc,IAAI,KAAK,GAAG,IAAI,MAAM;AAAA,EACpE;AAEA,MAAI,aAAa,GAAI,QAAO,OAAO,UAAU,CAAC;AAC9C,MAAI,aAAa,KAAK,GAAI,QAAO,OAAO,UAAU,EAAE;AACpD,MAAI,aAAa,KAAK,KAAK,GAAI,QAAO,OAAO,QAAQ,KAAK,EAAE;AAC5D,MAAI,aAAa,IAAI,KAAK,KAAK,GAAI,QAAO,OAAO,OAAO,KAAK,KAAK,EAAE;AACpE,MAAI,aAAa,KAAK,KAAK,KAAK,GAAI,QAAO,OAAO,QAAQ,IAAI,KAAK,KAAK,EAAE;AAC1E,MAAI,aAAa,MAAM,KAAK,KAAK,GAAI,QAAO,OAAO,SAAS,KAAK,KAAK,KAAK,EAAE;AAC7E,SAAO,OAAO,QAAQ,MAAM,KAAK,KAAK,EAAE;AAC1C;",
+  "names": []
 }

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.6.8-develop.6975.1.b21e19d444";
+const APP_VERSION = "0.6.8-develop.6976.1.9b79145ac4";
 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.8-develop.6975.1.b21e19d444';\nexport const appVersion = APP_VERSION;\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.8-develop.6976.1.9b79145ac4';\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.8-develop.6975.1.b21e19d444",
+  "version": "0.6.8-develop.6976.1.9b79145ac4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -105,7 +105,7 @@
     "@mikro-orm/core": "^7.1.8",
     "@mikro-orm/decorators": "^7.1.8",
     "@mikro-orm/postgresql": "^7.1.8",
-    "@open-mercato/cache": "0.6.8-develop.6975.1.b21e19d444",
+    "@open-mercato/cache": "0.6.8-develop.6976.1.9b79145ac4",
     "@types/sanitize-html": "^2.16.1",
     "dotenv": "^17.4.2",
     "pino": "^10.3.1",

package/src/lib/__tests__/time.test.ts

@@ -82,22 +82,54 @@ describe('formatRelativeTime', () => {
     expect(/year|month/.test(future!)).toBeTruthy()
   })
 
-it('uses fallback if Intl.RelativeTimeFormat is not available', () => {
-  const descriptor = Object.getOwnPropertyDescriptor(Intl, 'RelativeTimeFormat')
-  Object.defineProperty(Intl, 'RelativeTimeFormat', { value: undefined, configurable: true })
-  try {
-    expect(formatRelativeTime(sub(3_600_000))).toMatch(/ago/)
-    expect(formatRelativeTime(add(3_600_000))).toMatch(/from now/)
-  } finally {
-    Object.defineProperty(Intl, 'RelativeTimeFormat', descriptor!)
-  }
-})
+  it('uses fallback if Intl.RelativeTimeFormat is not available', () => {
+    const descriptor = Object.getOwnPropertyDescriptor(Intl, 'RelativeTimeFormat')
+    Object.defineProperty(Intl, 'RelativeTimeFormat', { value: undefined, configurable: true })
+    try {
+      expect(formatRelativeTime(sub(3_600_000))).toMatch(/ago/)
+      expect(formatRelativeTime(add(3_600_000))).toMatch(/from now/)
+    } finally {
+      Object.defineProperty(Intl, 'RelativeTimeFormat', descriptor!)
+    }
+  })
 
-it('uses custom translate if provided', () => {
-  const translate = (key: string, fallback?: string) => `T(${key})`
-  expect(formatRelativeTime(sub(3_600_000), { translate })).toMatch(/T\(time\.relative\.ago\)/)
-  expect(formatRelativeTime(add(3_600_000), { translate })).toMatch(/T\(time\.relative\.fromNow\)/)
-})
+  it('uses custom translate for the fallback suffix when Intl.RelativeTimeFormat is not available', () => {
+    const translate = (key: string) => `T(${key})`
+    const descriptor = Object.getOwnPropertyDescriptor(Intl, 'RelativeTimeFormat')
+    Object.defineProperty(Intl, 'RelativeTimeFormat', { value: undefined, configurable: true })
+    try {
+      expect(formatRelativeTime(sub(3_600_000), { translate })).toMatch(/T\(time\.relative\.ago\)/)
+      expect(formatRelativeTime(add(3_600_000), { translate })).toMatch(/T\(time\.relative\.fromNow\)/)
+    } finally {
+      Object.defineProperty(Intl, 'RelativeTimeFormat', descriptor!)
+    }
+  })
+
+  it('localizes unit, number and suffix in a non-English locale', () => {
+    expect(formatRelativeTime(sub(3_600_000), { locale: 'pl' })).toBe('1 godzinę temu')
+    expect(formatRelativeTime(sub(600_000), { locale: 'pl' })).toBe('10 minut temu')
+    expect(formatRelativeTime(add(18_000_000), { locale: 'pl' })).toBe('za 5 godzin')
+  })
+
+  it('localizes in the requested locale even when a translate function is supplied', () => {
+    const translate = (_key: string, fallback?: string) => fallback ?? _key
+    const polish = formatRelativeTime(sub(600_000), { locale: 'pl', translate })
+    const english = formatRelativeTime(sub(600_000), { locale: 'en', translate })
+    expect(polish).toBe('10 minut temu')
+    expect(polish).not.toMatch(/minutes|ago/)
+    expect(english).not.toEqual(polish)
+  })
+
+  it('applies the locale plural rules instead of English pluralization', () => {
+    expect(formatRelativeTime(sub(120_000), { locale: 'pl' })).toBe('2 minuty temu')
+    expect(formatRelativeTime(sub(300_000), { locale: 'pl' })).toBe('5 minut temu')
+  })
+
+  it('renders differently per locale for the same instant', () => {
+    const value = sub(172_800_000)
+    const rendered = ['en', 'pl', 'de', 'es'].map((locale) => formatRelativeTime(value, { locale }))
+    expect(new Set(rendered).size).toBe(rendered.length)
+  })
 })
 describe('formatDateTime', () => {
   it('returns null for invalid or missing values', () => {

package/src/lib/i18n/context.tsx

@@ -93,6 +93,16 @@ export function useLocale() {
   return ctx.locale
 }
 
+/**
+ * Like `useLocale`, but returns `undefined` instead of throwing when no
+ * `I18nProvider` is in scope. Use in shared components that receive their
+ * translator as a prop and may render outside a provider (galleries, tests).
+ */
+export function useOptionalLocale(): Locale | undefined {
+  const ctx = useContext(I18nContext)
+  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.

package/src/lib/time.ts

@@ -12,6 +12,12 @@ export type RelativeTimeTranslator = (
 ) => string
 
 export type FormatRelativeTimeOptions = {
+  /**
+   * Supplies the suffix only when the runtime has no `Intl.RelativeTimeFormat`.
+   * Otherwise the number, unit name, plural form and suffix all come from
+   * `Intl` in `locale` — pass `useLocale()` client-side so the text follows the
+   * application language rather than the runtime one.
+   */
   translate?: RelativeTimeTranslator
   locale?: string | string[]
 }
@@ -37,25 +43,18 @@ export function formatRelativeTime(
       ? new Intl.RelativeTimeFormat(options?.locale, { numeric: 'auto' })
       : null
 
-const format = (unit: RelativeTimeUnit, divisor: number) => {
-  const valueToFormat = Math.round(diffSeconds / divisor)
-  const isPast = diffSeconds < 0
+  const format = (unit: RelativeTimeUnit, divisor: number) => {
+    const valueToFormat = Math.round(diffSeconds / divisor)
+    if (rtf) return rtf.format(valueToFormat, unit)
 
-  if (translate) {
-    const suffixKey = isPast ? 'time.relative.ago' : 'time.relative.fromNow'
+    const isPast = diffSeconds < 0
     const fallbackSuffix = isPast ? 'ago' : 'from now'
-    const suffix = translate(suffixKey, fallbackSuffix)
+    const suffixKey = isPast ? 'time.relative.ago' : 'time.relative.fromNow'
+    const suffix = translate ? translate(suffixKey, fallbackSuffix) : fallbackSuffix
     const magnitude = Math.abs(valueToFormat)
     return `${magnitude} ${unit}${magnitude === 1 ? '' : 's'} ${suffix}`
   }
 
-  if (rtf) return rtf.format(valueToFormat, unit)
-
-  const fallbackSuffix = isPast ? 'ago' : 'from now'
-  const magnitude = Math.abs(valueToFormat)
-  return `${magnitude} ${unit}${magnitude === 1 ? '' : 's'} ${fallbackSuffix}`
-  }
-
   if (absSeconds < 45) return format('second', 1)
   if (absSeconds < 45 * 60) return format('minute', 60)
   if (absSeconds < 24 * 60 * 60) return format('hour', 60 * 60)