@gabrielbourget/i18n-foundation 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# i18n Foundation
+
+Shared i18n runtime foundation for the Wavemap and Waveguide app-owned i18n
+facade packages.
+
+This package is intentionally not an application-facing API. Application code
+should import from `@wavemap/i18n` or `@waveguide/i18n`; those facades own app
+locale registries, namespace lists, generated assets, and product vocabulary.
+
+## First Extraction Boundary
+
+Included first:
+
+- Shared `common--*` namespace content that has been promoted into the
+  foundation package.
+- Core i18next runtime factories.
+- Pseudolocalization helpers.
+- Environment parsing primitives.
+- Manifest helpers.
+- Generated asset helpers.
+- Source verification helpers.
+
+Excluded first:
+
+- App-owned `common--*` namespace content.
+- `page--*` namespace content.
+- `wavemap--*` and `waveguide--*` namespace content.
+- Email i18n utilities.
+- CDN publish and prune scripts.
+
+## Published Name
+
+The intended private npm package name is:
+
+```text
+@gabrielbourget/i18n-foundation
+```
+
+The package omits `"private": true` so it can be published, and sets
+`publishConfig.access` to `restricted` so npm publishes it as a private scoped
+package.
+
+## Export Surface
+
+```text
+@gabrielbourget/i18n-foundation
+@gabrielbourget/i18n-foundation/common
+@gabrielbourget/i18n-foundation/core
+@gabrielbourget/i18n-foundation/core/client
+@gabrielbourget/i18n-foundation/core/server
+@gabrielbourget/i18n-foundation/env
+@gabrielbourget/i18n-foundation/env/client
+@gabrielbourget/i18n-foundation/env/server
+@gabrielbourget/i18n-foundation/manifest
+@gabrielbourget/i18n-foundation/pseudolocalization
+@gabrielbourget/i18n-foundation/assets
+@gabrielbourget/i18n-foundation/verifier
+```
+
+## Foundation-Owned Common Namespaces
+
+These namespaces and their locale JSON files are owned by this package:
+
+```text
+common--carousel
+common--delete-entity-modal
+common--file-upload
+common--form-rules
+common--form-validation
+common--pagination
+common--saved-views
+common--searching
+common--sort-and-filter-panel
+common--theme
+common--ui
+```
+
+These common namespaces remain app-facade owned:
+
+```text
+common--entities
+common--external-institutions
+common--nav-panel
+common--navbar
+```
+
+Facade asset generation should treat each namespace as having exactly one
+source root. Do not overlay foundation and app-owned JSON for the same
+namespace.
+
+## Facade Usage Shape
+
+The app facade owns all app-specific registry values:
+
+```ts
+import {
+  buildClientRuntimeConfig,
+  createI18nClientEnvReader,
+  createI18nProvider,
+  validateDevManifest,
+} from "@gabrielbourget/i18n-foundation"
+
+const registry = {
+  defaultLocale: DEFAULT_LOCALE,
+  availableLocales: DECLARED_LOCALES,
+  availableNamespaces: AVAILABLE_NAMESPACES,
+  initialLoadNamespaces: INITIAL_LOAD_NAMESPACES,
+}
+
+const clientEnvReader = createI18nClientEnvReader({
+  config: {
+    declaredLocales: DECLARED_LOCALES,
+    defaultLocale: DEFAULT_LOCALE,
+    i18nVersion: I18N_VERSION,
+  },
+})
+
+export const I18nProvider = createI18nProvider({
+  registry,
+  getRuntimeConfig: () => buildClientRuntimeConfig(clientEnvReader.get()),
+  validateManifest: validateDevManifest,
+})
+```
+
+The facade should continue to export app-owned constants, resource maps, and
+script entrypoints. Application code should keep importing the facade package.
+
+## Asset And Verifier Usage Shape
+
+Facade scripts should pass explicit app paths and registries into foundation
+helpers:
+
+```ts
+import { buildI18nManifest, generateI18nAssets, verifyI18nSource } from "@gabrielbourget/i18n-foundation"
+
+const manifest = buildI18nManifest({
+  defaultLocale: DEFAULT_LOCALE,
+  locales: DECLARED_LOCALES,
+  namespaces: AVAILABLE_NAMESPACES,
+  version: I18N_VERSION,
+})
+
+generateI18nAssets({
+  localesRoot,
+  outputRoot,
+  manifest,
+})
+
+await verifyI18nSource({
+  localesRoot,
+  availableNamespaces: AVAILABLE_NAMESPACES,
+  declaredLocales: DECLARED_LOCALES,
+  defaultLocale: DEFAULT_LOCALE,
+  initialLoadNamespaces: INITIAL_LOAD_NAMESPACES,
+  repoRoot,
+  domainTranslationContracts,
+  domainSeedSourceContracts,
+})
+```

package/dist/assets/index.d.ts

@@ -0,0 +1,35 @@
+import type { TI18nManifest } from "../manifest/index.js";
+export type TGeneratedI18nAsset<Locale extends string = string, Namespace extends string = string> = {
+    locale: Locale;
+    namespace: Namespace;
+    sourcePath: string;
+    outputPath: string;
+};
+export type TGenerateI18nAssetsArgs<Locale extends string, Namespace extends string> = {
+    localesRoot: string;
+    outputRoot: string;
+    manifest: TI18nManifest<Locale, Namespace>;
+    cleanOutputRoot?: boolean | undefined;
+};
+export type TGenerateI18nAssetsResult<Locale extends string, Namespace extends string> = {
+    outputRoot: string;
+    manifestPath: string;
+    assets: readonly TGeneratedI18nAsset<Locale, Namespace>[];
+};
+export type TValidateGeneratedI18nAssetsArgs<Locale extends string, Namespace extends string> = {
+    localesRoot: string;
+    generatedRoot: string;
+    manifest: TI18nManifest<Locale, Namespace>;
+};
+export declare const readUTF8: (filePath: string) => string;
+export declare const writeUTF8: (filePath: string, value: string) => void;
+export declare const readJSONFile: (filePath: string) => unknown;
+export declare const writeJSONFile: (filePath: string, value: unknown) => void;
+export declare const listDirectoryNames: (directoryPath: string) => string[];
+export declare const listJSONFileNames: (directoryPath: string) => string[];
+export declare const assertEqualArrays: (label: string, expected: readonly string[], actual: readonly string[]) => void;
+export declare const ensureDirectory: (directoryPath: string) => void;
+export declare const removeDirectoryIfExists: (directoryPath: string) => void;
+export declare const generateI18nAssets: <Locale extends string, Namespace extends string>({ localesRoot, outputRoot, manifest, cleanOutputRoot, }: TGenerateI18nAssetsArgs<Locale, Namespace>) => TGenerateI18nAssetsResult<Locale, Namespace>;
+export declare const validateGeneratedI18nAssets: <Locale extends string, Namespace extends string>({ localesRoot, generatedRoot, manifest, }: TValidateGeneratedI18nAssetsArgs<Locale, Namespace>) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/assets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACnG,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACrF,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACvF,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,SAAS,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAA;CAC1D,CAAA;AAED,MAAM,MAAM,gCAAgC,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IAC9F,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAC3C,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,KAAG,MAA2C,CAAA;AAEvF,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,KAAG,IAE3D,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,OAQ/C,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,OAAO,KAAG,IAEhE,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,eAAe,MAAM,KAAG,MAAM,EAMhE,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,eAAe,MAAM,KAAG,MAAM,EAM/D,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,UAAU,SAAS,MAAM,EAAE,EAAE,QAAQ,SAAS,MAAM,EAAE,KAAG,IAOzG,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,eAAe,MAAM,KAAG,IAEvD,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,eAAe,MAAM,KAAG,IAE/D,CAAA;AAWD,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,yDAKjF,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAgC1F,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,2CAI1F,gCAAgC,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,IA0CxD,CAAA"}

package/dist/assets/index.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import path from "node:path";
+export const readUTF8 = (filePath) => fs.readFileSync(filePath, "utf8");
+export const writeUTF8 = (filePath, value) => {
+    fs.writeFileSync(filePath, value, "utf8");
+};
+export const readJSONFile = (filePath) => {
+    try {
+        return JSON.parse(readUTF8(filePath));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${filePath} is not valid JSON: ${message}`);
+    }
+};
+export const writeJSONFile = (filePath, value) => {
+    writeUTF8(filePath, `${JSON.stringify(value, null, 2)}\n`);
+};
+export const listDirectoryNames = (directoryPath) => {
+    return fs
+        .readdirSync(directoryPath, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+};
+export const listJSONFileNames = (directoryPath) => {
+    return fs
+        .readdirSync(directoryPath, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+};
+export const assertEqualArrays = (label, expected, actual) => {
+    const expectedKey = JSON.stringify(expected);
+    const actualKey = JSON.stringify(actual);
+    if (expectedKey !== actualKey) {
+        throw new Error(`${label} mismatch\nexpected: ${expectedKey}\nactual:   ${actualKey}`);
+    }
+};
+export const ensureDirectory = (directoryPath) => {
+    fs.mkdirSync(directoryPath, { recursive: true });
+};
+export const removeDirectoryIfExists = (directoryPath) => {
+    fs.rmSync(directoryPath, { recursive: true, force: true });
+};
+const assertFileContentMatches = (label, expectedPath, actualPath) => {
+    const expected = readUTF8(expectedPath);
+    const actual = readUTF8(actualPath);
+    if (actual !== expected) {
+        throw new Error(`${label} does not match source file.\nsource: ${expectedPath}\nasset:  ${actualPath}`);
+    }
+};
+export const generateI18nAssets = ({ localesRoot, outputRoot, manifest, cleanOutputRoot = true, }) => {
+    if (cleanOutputRoot) {
+        removeDirectoryIfExists(outputRoot);
+    }
+    ensureDirectory(outputRoot);
+    const assets = [];
+    for (const locale of manifest.locales) {
+        const localeOutputPath = path.join(outputRoot, locale);
+        ensureDirectory(localeOutputPath);
+        for (const namespace of manifest.namespaces) {
+            const sourcePath = path.join(localesRoot, locale, `${namespace}.json`);
+            const outputPath = path.join(localeOutputPath, `${namespace}.json`);
+            readJSONFile(sourcePath);
+            writeUTF8(outputPath, readUTF8(sourcePath));
+            assets.push({ locale, namespace, outputPath, sourcePath });
+        }
+    }
+    const manifestPath = path.join(outputRoot, "manifest.json");
+    writeJSONFile(manifestPath, manifest);
+    return {
+        assets,
+        manifestPath,
+        outputRoot,
+    };
+};
+export const validateGeneratedI18nAssets = ({ localesRoot, generatedRoot, manifest, }) => {
+    const manifestPath = path.join(generatedRoot, "manifest.json");
+    if (!fs.existsSync(generatedRoot))
+        throw new Error(`[i18n assets] Generated root not found: ${generatedRoot}`);
+    if (!fs.existsSync(manifestPath))
+        throw new Error(`[i18n assets] Manifest not found: ${manifestPath}`);
+    const generatedManifest = readJSONFile(manifestPath);
+    if (generatedManifest.version !== manifest.version) {
+        throw new Error(`[i18n assets] Manifest version mismatch. expected=${manifest.version}, actual=${generatedManifest.version}`);
+    }
+    if (generatedManifest.defaultLocale !== manifest.defaultLocale) {
+        throw new Error(`[i18n assets] Manifest defaultLocale mismatch. expected=${manifest.defaultLocale}, actual=${generatedManifest.defaultLocale}`);
+    }
+    assertEqualArrays("[i18n assets] manifest.locales", manifest.locales, generatedManifest.locales);
+    assertEqualArrays("[i18n assets] manifest.namespaces", manifest.namespaces, generatedManifest.namespaces);
+    assertEqualArrays("[i18n assets] generated locale folders", manifest.locales, listDirectoryNames(generatedRoot));
+    for (const locale of manifest.locales) {
+        const generatedLocalePath = path.join(generatedRoot, locale);
+        const expectedFileNames = manifest.namespaces.map((namespace) => `${namespace}.json`);
+        assertEqualArrays(`[i18n assets] generated namespace files for ${locale}`, expectedFileNames, listJSONFileNames(generatedLocalePath));
+        for (const namespace of manifest.namespaces) {
+            assertFileContentMatches(`[i18n assets] ${locale}/${namespace}.json`, path.join(localesRoot, locale, `${namespace}.json`), path.join(generatedLocalePath, `${namespace}.json`));
+        }
+    }
+};

package/dist/common/index.d.ts

@@ -0,0 +1,18 @@
+export declare const FOUNDATION_COMMON_LOCALE__EN: "en";
+export declare const FOUNDATION_COMMON_LOCALE__FR: "fr";
+export declare const FOUNDATION_COMMON_LOCALES: readonly ["en", "fr"];
+export declare const NAMESPACE__COMMON__CAROUSEL: "common--carousel";
+export declare const NAMESPACE__COMMON__DELETE_ENTITY_MODAL: "common--delete-entity-modal";
+export declare const NAMESPACE__COMMON__FILE_UPLOAD: "common--file-upload";
+export declare const NAMESPACE__COMMON__FORM_RULES: "common--form-rules";
+export declare const NAMESPACE__COMMON__FORM_VALIDATION: "common--form-validation";
+export declare const NAMESPACE__COMMON__PAGINATION: "common--pagination";
+export declare const NAMESPACE__COMMON__SAVED_VIEWS: "common--saved-views";
+export declare const NAMESPACE__COMMON__SEARCHING: "common--searching";
+export declare const NAMESPACE__COMMON__SORT_AND_FILTER_PANEL: "common--sort-and-filter-panel";
+export declare const NAMESPACE__COMMON__THEME: "common--theme";
+export declare const NAMESPACE__COMMON__UI: "common--ui";
+export declare const FOUNDATION_COMMON_NAMESPACES: readonly ["common--carousel", "common--delete-entity-modal", "common--file-upload", "common--form-rules", "common--form-validation", "common--pagination", "common--saved-views", "common--searching", "common--sort-and-filter-panel", "common--theme", "common--ui"];
+export type TFoundationCommonLocale = (typeof FOUNDATION_COMMON_LOCALES)[number];
+export type TFoundationCommonNamespace = (typeof FOUNDATION_COMMON_NAMESPACES)[number];
+//# sourceMappingURL=index.d.ts.map

package/dist/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,EAAG,IAAa,CAAA;AACzD,eAAO,MAAM,4BAA4B,EAAG,IAAa,CAAA;AAEzD,eAAO,MAAM,yBAAyB,uBAAwE,CAAA;AAE9G,eAAO,MAAM,2BAA2B,EAAG,kBAA2B,CAAA;AACtE,eAAO,MAAM,sCAAsC,EAAG,6BAAsC,CAAA;AAC5F,eAAO,MAAM,8BAA8B,EAAG,qBAA8B,CAAA;AAC5E,eAAO,MAAM,6BAA6B,EAAG,oBAA6B,CAAA;AAC1E,eAAO,MAAM,kCAAkC,EAAG,yBAAkC,CAAA;AACpF,eAAO,MAAM,6BAA6B,EAAG,oBAA6B,CAAA;AAC1E,eAAO,MAAM,8BAA8B,EAAG,qBAA8B,CAAA;AAC5E,eAAO,MAAM,4BAA4B,EAAG,mBAA4B,CAAA;AACxE,eAAO,MAAM,wCAAwC,EAAG,+BAAwC,CAAA;AAChG,eAAO,MAAM,wBAAwB,EAAG,eAAwB,CAAA;AAChE,eAAO,MAAM,qBAAqB,EAAG,YAAqB,CAAA;AAE1D,eAAO,MAAM,4BAA4B,wQAY/B,CAAA;AAEV,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/common/index.js

@@ -0,0 +1,27 @@
+export const FOUNDATION_COMMON_LOCALE__EN = "en";
+export const FOUNDATION_COMMON_LOCALE__FR = "fr";
+export const FOUNDATION_COMMON_LOCALES = [FOUNDATION_COMMON_LOCALE__EN, FOUNDATION_COMMON_LOCALE__FR];
+export const NAMESPACE__COMMON__CAROUSEL = "common--carousel";
+export const NAMESPACE__COMMON__DELETE_ENTITY_MODAL = "common--delete-entity-modal";
+export const NAMESPACE__COMMON__FILE_UPLOAD = "common--file-upload";
+export const NAMESPACE__COMMON__FORM_RULES = "common--form-rules";
+export const NAMESPACE__COMMON__FORM_VALIDATION = "common--form-validation";
+export const NAMESPACE__COMMON__PAGINATION = "common--pagination";
+export const NAMESPACE__COMMON__SAVED_VIEWS = "common--saved-views";
+export const NAMESPACE__COMMON__SEARCHING = "common--searching";
+export const NAMESPACE__COMMON__SORT_AND_FILTER_PANEL = "common--sort-and-filter-panel";
+export const NAMESPACE__COMMON__THEME = "common--theme";
+export const NAMESPACE__COMMON__UI = "common--ui";
+export const FOUNDATION_COMMON_NAMESPACES = [
+    NAMESPACE__COMMON__CAROUSEL,
+    NAMESPACE__COMMON__DELETE_ENTITY_MODAL,
+    NAMESPACE__COMMON__FILE_UPLOAD,
+    NAMESPACE__COMMON__FORM_RULES,
+    NAMESPACE__COMMON__FORM_VALIDATION,
+    NAMESPACE__COMMON__PAGINATION,
+    NAMESPACE__COMMON__SAVED_VIEWS,
+    NAMESPACE__COMMON__SEARCHING,
+    NAMESPACE__COMMON__SORT_AND_FILTER_PANEL,
+    NAMESPACE__COMMON__THEME,
+    NAMESPACE__COMMON__UI,
+];

package/dist/core/client.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+import type { TI18nProviderFallback, TI18nRegistry, TI18nRuntimeConfig } from "./types.js";
+export type TI18nProviderProps<Locale extends string, Namespace extends string> = {
+    locale: Locale;
+    preloadNamespaces?: readonly Namespace[] | undefined;
+    children: React.ReactNode;
+};
+export type TValidateI18nManifestArgs<Locale extends string, Namespace extends string> = {
+    version: string;
+    expectedLocales: readonly Locale[];
+    expectedNamespaces: readonly Namespace[];
+};
+export type TCreateI18nProviderArgs<Locale extends string, Namespace extends string> = {
+    registry: TI18nRegistry<Locale, Namespace>;
+    getRuntimeConfig: () => TI18nRuntimeConfig;
+    validateManifest?: ((args: TValidateI18nManifestArgs<Locale, Namespace>) => Promise<void> | void) | undefined;
+    environment?: string | undefined;
+    loadingFallback?: TI18nProviderFallback | undefined;
+};
+export declare const createI18nProvider: <Locale extends string, Namespace extends string>({ registry, getRuntimeConfig, validateManifest, environment, loadingFallback, }: TCreateI18nProviderArgs<Locale, Namespace>) => React.FC<TI18nProviderProps<Locale, Namespace>>;
+export declare const useTypedTranslation: <Namespace extends string>(namespace?: Namespace | readonly Namespace[]) => import("react-i18next").UseTranslationResponse<string | readonly string[], undefined>;
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA+C,MAAM,OAAO,CAAA;AAKnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE1F,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IAChF,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IACpD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACvF,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,kBAAkB,EAAE,SAAS,SAAS,EAAE,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACrF,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;IAC1C,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,CAAA;IAC7G,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,eAAe,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAA;CACpD,CAAA;AAaD,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,iFAMjF,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,oDAiF5C,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,SAAS,SAAS,MAAM,EAAE,YAAY,SAAS,GAAG,SAAS,SAAS,EAAE,0FACrC,CAAA"}

package/dist/core/client.js

@@ -0,0 +1,89 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import i18next from "i18next";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { I18nextProvider, useTranslation } from "react-i18next";
+import { initReactI18next } from "react-i18next/initReactI18next";
+import { initI18nCommon } from "./initCommon.js";
+const defaultLoadingFallback = (_jsx("div", { style: {
+        backgroundColor: "#2c2c2c",
+        height: "100vh",
+        padding: 15,
+        width: "100vw",
+    } }));
+export const createI18nProvider = ({ registry, getRuntimeConfig, validateManifest, environment = process.env.NODE_ENV, loadingFallback = defaultLoadingFallback, }) => {
+    const I18nProvider = ({ locale, preloadNamespaces, children }) => {
+        const i18nRef = useRef(null);
+        const devCheckedRef = useRef(false);
+        const isDev = environment === "development";
+        if (!i18nRef.current) {
+            const instance = i18next.createInstance();
+            instance.use(initReactI18next);
+            i18nRef.current = instance;
+        }
+        const i18n = i18nRef.current;
+        const [ready, setReady] = useState(i18n.isInitialized);
+        const preloadKey = useMemo(() => (preloadNamespaces ? preloadNamespaces.join("|") : ""), [preloadNamespaces]);
+        useEffect(() => {
+            if (!isDev)
+                return;
+            if (devCheckedRef.current)
+                return;
+            if (!validateManifest)
+                return;
+            devCheckedRef.current = true;
+            const runtimeConfig = getRuntimeConfig();
+            if (!runtimeConfig.version) {
+                console.warn("[i18n] I18N_VERSION missing; skipping dev manifest validation.");
+                return;
+            }
+            void validateManifest({
+                expectedLocales: registry.availableLocales,
+                expectedNamespaces: registry.availableNamespaces,
+                version: runtimeConfig.version,
+            });
+        }, [isDev]);
+        useEffect(() => {
+            let cancelled = false;
+            const runtimeConfig = getRuntimeConfig();
+            if (!runtimeConfig.version) {
+                console.error("[i18n] I18N_VERSION is missing; cannot init i18n.");
+                return;
+            }
+            void (async () => {
+                try {
+                    if (!i18n.isInitialized) {
+                        await initI18nCommon({
+                            environment,
+                            installReactPlugin: false,
+                            instance: i18n,
+                            locale,
+                            namespaces: preloadNamespaces,
+                            registry,
+                            runtimeConfig,
+                        });
+                    }
+                    else {
+                        await i18n.changeLanguage(locale);
+                    }
+                    if (!cancelled)
+                        setReady(true);
+                }
+                catch (error) {
+                    console.error("[I18nProvider] init failed", error);
+                    if (!cancelled)
+                        setReady(true);
+                }
+            })();
+            return () => {
+                cancelled = true;
+            };
+        }, [i18n, locale, preloadKey]);
+        if (!ready) {
+            return loadingFallback;
+        }
+        return _jsx(I18nextProvider, { i18n: i18n, children: children });
+    };
+    return I18nProvider;
+};
+export const useTypedTranslation = (namespace) => useTranslation(namespace);

package/dist/core/configuration.d.ts

@@ -0,0 +1,18 @@
+import type { InitOptions } from "i18next";
+import { type TPseudolocalizationCharacterSet } from "../pseudolocalization/index.js";
+import type { TI18nRegistry } from "./types.js";
+export type TBuildCoreConfigArgs<Locale extends string = string, Namespace extends string = string> = {
+    locale: Locale;
+    namespaces?: readonly Namespace[] | undefined;
+    registry: TI18nRegistry<Locale, Namespace>;
+    productionLike?: boolean | undefined;
+    environment?: string | undefined;
+    developmentEnvironmentName?: string | undefined;
+    initializePseudolocalizationInDevelopment?: boolean | undefined;
+    missingKeyWarnings?: boolean | undefined;
+    pseudolocalizationActive?: boolean | undefined;
+    pseudolocalizationCharacterSet?: TPseudolocalizationCharacterSet | undefined;
+    pseudolocalizationPostProcessorName?: string | undefined;
+};
+export declare const buildCoreConfig: <Locale extends string, Namespace extends string>({ locale, namespaces, registry, productionLike, environment, developmentEnvironmentName, initializePseudolocalizationInDevelopment, missingKeyWarnings, pseudolocalizationActive, pseudolocalizationCharacterSet, pseudolocalizationPostProcessorName, }: TBuildCoreConfigArgs<Locale, Namespace>) => InitOptions;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/core/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/core/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,gCAAgC,CAAA;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,MAAM,oBAAoB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACpG,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IAC7C,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/C,yCAAyC,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/D,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9C,8BAA8B,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAA;IAC5E,mCAAmC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzD,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,0PAY9E,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,WAwC5C,CAAA"}

package/dist/core/configuration.js

@@ -0,0 +1,36 @@
+import { getPseudolocalizationPostProcessConfig, initializePseudolocalization, } from "../pseudolocalization/index.js";
+import { makeMissingKeyHandler, parseMissingKey } from "./i18nStrictMode.js";
+export const buildCoreConfig = ({ locale, namespaces, registry, productionLike = false, environment = process.env.NODE_ENV, developmentEnvironmentName = "development", initializePseudolocalizationInDevelopment = true, missingKeyWarnings, pseudolocalizationActive, pseudolocalizationCharacterSet, pseudolocalizationPostProcessorName, }) => {
+    const ns = [...(namespaces ?? registry.initialLoadNamespaces)];
+    const defaultNS = registry.defaultNamespace ?? ns[0];
+    const shouldWarnForMissingKeys = missingKeyWarnings ?? !productionLike;
+    const config = {
+        fallbackLng: registry.defaultLocale,
+        interpolation: { escapeValue: false },
+        keySeparator: false,
+        lng: locale,
+        ns,
+        nsSeparator: false,
+        partialBundledLanguages: true,
+        react: { useSuspense: false },
+        returnEmptyString: false,
+        returnNull: false,
+        supportedLngs: [...registry.availableLocales],
+    };
+    if (defaultNS) {
+        config.defaultNS = defaultNS;
+    }
+    if (shouldWarnForMissingKeys) {
+        config.saveMissing = true;
+        config.parseMissingKeyHandler = parseMissingKey;
+        config.missingKeyHandler = makeMissingKeyHandler();
+    }
+    if (pseudolocalizationActive) {
+        config.postProcess = getPseudolocalizationPostProcessConfig(pseudolocalizationPostProcessorName);
+    }
+    const isDevelopment = environment === developmentEnvironmentName;
+    if (!productionLike && isDevelopment && pseudolocalizationActive && initializePseudolocalizationInDevelopment) {
+        initializePseudolocalization({ characterSet: pseudolocalizationCharacterSet });
+    }
+    return config;
+};

package/dist/core/createIsolatedI18nInstance.d.ts

@@ -0,0 +1,13 @@
+import { type i18n } from "i18next";
+import type { TI18nRegistry, TI18nRuntimeConfig } from "./types.js";
+export type TCreateIsolatedI18nInstanceArgs<Locale extends string, Namespace extends string> = {
+    locale: Locale;
+    namespaces?: readonly Namespace[] | undefined;
+    registry: TI18nRegistry<Locale, Namespace>;
+    runtimeConfig: TI18nRuntimeConfig;
+    productionLike?: boolean | undefined;
+    environment?: string | undefined;
+    missingKeyWarnings?: boolean | undefined;
+};
+export declare const createIsolatedI18nInstance: <Locale extends string, Namespace extends string>({ locale, namespaces, registry, runtimeConfig, productionLike, environment, missingKeyWarnings, }: TCreateIsolatedI18nInstanceArgs<Locale, Namespace>) => Promise<i18n>;
+//# sourceMappingURL=createIsolatedI18nInstance.d.ts.map

package/dist/core/createIsolatedI18nInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIsolatedI18nInstance.d.ts","sourceRoot":"","sources":["../../src/core/createIsolatedI18nInstance.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,IAAI,EAAE,MAAM,SAAS,CAAA;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEnE,MAAM,MAAM,+BAA+B,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IAC7F,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IAC7C,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,aAAa,EAAE,kBAAkB,CAAA;IACjC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACzC,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAU,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,mGAQ/F,+BAA+B,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,IAAI,CAcnE,CAAA"}

package/dist/core/createIsolatedI18nInstance.js

@@ -0,0 +1,16 @@
+import i18next from "i18next";
+import { initI18nCommon } from "./initCommon.js";
+export const createIsolatedI18nInstance = async ({ locale, namespaces, registry, runtimeConfig, productionLike = true, environment, missingKeyWarnings, }) => {
+    const instance = i18next.createInstance();
+    return await initI18nCommon({
+        environment,
+        installReactPlugin: false,
+        instance,
+        locale,
+        missingKeyWarnings,
+        namespaces,
+        productionLike,
+        registry,
+        runtimeConfig,
+    });
+};

package/dist/core/i18nStrictMode.d.ts

@@ -0,0 +1,11 @@
+export declare const parseMissingKey: (key: string) => string;
+export type TMissingKeyHandlerArgs = {
+    lngs: readonly string[] | string;
+    ns: string;
+    key: string;
+    fallbackValue: string;
+    updateMissing: boolean;
+    options: Record<string, unknown>;
+};
+export declare const makeMissingKeyHandler: () => ((...unsafeArgs: unknown[]) => void);
+//# sourceMappingURL=i18nStrictMode.d.ts.map

package/dist/core/i18nStrictMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18nStrictMode.d.ts","sourceRoot":"","sources":["../../src/core/i18nStrictMode.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAAoB,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAA;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AASD,eAAO,MAAM,qBAAqB,QAAO,CAAC,CAAC,GAAG,UAAU,EAAE,OAAO,EAAE,KAAK,IAAI,CAoB3E,CAAA"}

package/dist/core/i18nStrictMode.js

@@ -0,0 +1,19 @@
+export const parseMissingKey = (key) => `⟦${key}⟧`;
+const handleMissingKey = ({ lngs, ns, key }) => {
+    const normalizedLngs = Array.isArray(lngs) ? lngs : [String(lngs)];
+    const lng = normalizedLngs[0];
+    console.warn(`[i18n] Missing key: ns="${ns}" key="${key}" (lng=${lng})`);
+};
+export const makeMissingKeyHandler = () => {
+    return (...unsafeArgs) => {
+        const [lngs, ns, key, fallbackValue, updateMissing, options] = unsafeArgs;
+        handleMissingKey({
+            fallbackValue,
+            key,
+            lngs,
+            ns,
+            options,
+            updateMissing,
+        });
+    };
+};

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./configuration.js";
+export * from "./createIsolatedI18nInstance.js";
+export * from "./i18nStrictMode.js";
+export * from "./initCommon.js";
+export * from "./resourceLoader.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from "./configuration.js";
+export * from "./createIsolatedI18nInstance.js";
+export * from "./i18nStrictMode.js";
+export * from "./initCommon.js";
+export * from "./resourceLoader.js";
+export * from "./types.js";

package/dist/core/initCommon.d.ts

@@ -0,0 +1,15 @@
+import type { i18n } from "i18next";
+import type { TI18nRegistry, TI18nRuntimeConfig } from "./types.js";
+export type TInitI18nCommonArgs<Locale extends string, Namespace extends string> = {
+    instance: i18n;
+    locale: Locale;
+    namespaces?: readonly Namespace[] | undefined;
+    registry: TI18nRegistry<Locale, Namespace>;
+    runtimeConfig: TI18nRuntimeConfig;
+    productionLike?: boolean | undefined;
+    installReactPlugin?: boolean | undefined;
+    environment?: string | undefined;
+    missingKeyWarnings?: boolean | undefined;
+};
+export declare const initI18nCommon: <Locale extends string, Namespace extends string>({ instance, locale, namespaces, registry, runtimeConfig, productionLike, installReactPlugin, environment, missingKeyWarnings, }: TInitI18nCommonArgs<Locale, Namespace>) => Promise<i18n>;
+//# sourceMappingURL=initCommon.d.ts.map

package/dist/core/initCommon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initCommon.d.ts","sourceRoot":"","sources":["../../src/core/initCommon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAYnC,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEnE,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACjF,QAAQ,EAAE,IAAI,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IAC7C,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,aAAa,EAAE,kBAAkB,CAAA;IACjC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACzC,CAAA;AAwCD,eAAO,MAAM,cAAc,GAAU,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,iIAUnF,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,IAAI,CA4BvD,CAAA"}