@object-ui/i18n 17.6.0 → 18.0.0

package/dist/locales/index.js

@@ -1,6 +1,21 @@
 /**
- * @object-ui/i18n - Locale index
- * Exports all 10 built-in language packs
+ * @object-ui/i18n - Locale index — the explicit ALL TEN door.
+ *
+ * ⛔ This module is NOT reachable from the package entry any more
+ * (objectui#7479). Importing it pulls every catalogue this package ships —
+ * ~1.8 MB raw / ~450 KB gzipped — which is exactly the eager payload that card
+ * removed from the console. The entry exposes `en` plus
+ * `loadBuiltInLocale()` instead; see `./registry.js`.
+ *
+ * What it is still for, and the only two things it is for:
+ *
+ *   - the parity / drift suites, which must compare all ten packs at once and
+ *     run in Node, where a megabyte of translations costs nobody anything;
+ *   - an app that deliberately wants every catalogue resident, which reaches it
+ *     through the published `@object-ui/i18n/locales` subpath — a specifier
+ *     that says what it costs.
+ *
+ * ⚠️ Anything on a page-load path belongs on `./registry.js`, not here.
  */
 export { default as en } from './en.js';
 export { default as zh } from './zh.js';
@@ -26,13 +41,37 @@ import pt from './pt.js';
 import ru from './ru.js';
 import ar from './ar.js';
 export const builtInLocales = { en, zh, ja, ko, de, fr, es, pt, ru, ar };
+// Direction and the lazy registry live in payload-free modules so the runtime
+// can reach them without reaching the ten packs above. Re-exported here so the
+// historical import path keeps answering.
+export { RTL_LANGUAGES, isRTL } from './rtl.js';
+export { BUILT_IN_LANGUAGE_CODES, DEFAULT_BUILT_IN_LANGUAGE, getLoadedBuiltInLocales, isBuiltInLanguage, isBuiltInLocaleLoaded, loadBuiltInLocale, } from './registry.js';
+import { registerBuiltInLocale } from './registry.js';
 /**
- * List of RTL language codes
+ * Make every catalogue this module holds RESIDENT — synchronously, and without
+ * a single `import()`.
+ *
+ * ⛔ Deliberately a CALL and not an import-time side effect: this package
+ * declares `"sideEffects": false`, and a module that registered on import would
+ * make that declaration false for every consumer's bundler. A caller that wants
+ * all ten resident says so.
+ *
+ * Who calls it:
+ *
+ *   - a test that renders in a non-`en` locale and asserts SYNCHRONOUSLY. One
+ *     line at module scope, next to the import that already paid for these ten
+ *     modules, is the shape AGENTS.md prescribes for a cost that belongs in the
+ *     import phase — ⛔ never a `beforeAll`, which is bounded by `hookTimeout`
+ *     and only moves the race;
+ *   - an app that deliberately ships every language resident and wants no
+ *     fetch at switch time.
+ *
+ * ⚠️ It is NOT how a normal app boots. Calling it costs the whole ~1.8 MB of
+ * catalogues on the page-load path, which is the payload objectui#7479 removed.
+ * `preloadBootstrapLocale()` — one catalogue, the active one — is that path.
  */
-export const RTL_LANGUAGES = ['ar', 'he', 'fa', 'ur'];
-/**
- * Check if a language code is RTL
- */
-export function isRTL(lang) {
-    return RTL_LANGUAGES.includes(lang);
+export function registerBuiltInLocales() {
+    for (const [code, catalogue] of Object.entries(builtInLocales)) {
+        registerBuiltInLocale(code, catalogue);
+    }
 }