@ultimat3/i18n 15.0.0 → 17.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/i18n",
-  "version": "15.0.0",
+  "version": "17.0.0",
   "description": "Dependency-free translator, catalog flattening, locale negotiation and loud missing-key rendering",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "15.0.0"
+    "@ultimat3/core": "17.0.0"
   }
 }

package/src/catalogs/en.json

@@ -238,7 +238,6 @@
     },
     "policy": {
       "all-granted": "every required permission is granted",
-      "evaluated": "the policy decided this",
       "granted": "the grant list contains this permission",
       "missing": "no policy is registered for this permission",
       "not-granted": "the grant list does not contain this permission"

package/src/context.ts

@@ -3,7 +3,7 @@
  * No call site passes a locale by hand — `t()` here is the ambient translator.
  */
 
-import { cachedFormatter, canonicalLocale, tryUseContext } from '@ultimat3/core';
+import { assertLocale, cachedFormatter, canonicalLocale, tryUseContext } from '@ultimat3/core';
 import { type Catalog, mergeCatalogs } from './catalog';
 import {
   DEFAULT_LOCALE,
@@ -85,8 +85,19 @@ function freshDefaultConfig(): LocaleConfig {
 
 let config: LocaleConfig = freshDefaultConfig();
 
-/** Called once at boot from `app.config.ts`. */
+/**
+ * Called once at boot from `app.config.ts`.
+ *
+ * Screened before it is stored, and this is the ONE screen the locale path needs: `resolveLocale`
+ * can only ever answer with a member of `supported` or the fallback — every other candidate
+ * normalises away — so a tag the APP declares is the only route by which a string `Intl` cannot
+ * parse reaches `ctx.locale`, and from there `formatDate`, `formatMoney` and `Intl.PluralRules`
+ * one request at a time, several frames from the config line that caused it. Refused whole: a
+ * rejected call leaves the previous config in place rather than half of a new one.
+ */
 export function configureLocales(partial: Partial<LocaleConfig>): LocaleConfig {
+  for (const tag of partial.supported ?? []) assertLocale(tag);
+  if (partial.fallback !== undefined) assertLocale(partial.fallback);
   config = { ...config, ...partial };
   return config;
 }