@gabrielbourget/i18n-foundation 0.1.0

package/dist/core/initCommon.js

@@ -0,0 +1,51 @@
+import ICU from "i18next-icu";
+import resourcesToBackend from "i18next-resources-to-backend";
+import { initReactI18next } from "react-i18next/initReactI18next";
+import { createPseudolocalizationPostProcessor, } from "../pseudolocalization/index.js";
+import { buildCoreConfig } from "./configuration.js";
+import { createI18nResourceLoader } from "./resourceLoader.js";
+const createResourceLoaderArgs = (runtimeConfig) => {
+    const args = { version: runtimeConfig.version };
+    if (runtimeConfig.assetBaseURL) {
+        args.assetBaseURL = runtimeConfig.assetBaseURL;
+    }
+    if (runtimeConfig.preferSameOrigin !== undefined) {
+        args.preferSameOrigin = runtimeConfig.preferSameOrigin;
+    }
+    if (runtimeConfig.fallbackToSameOriginOnError !== undefined) {
+        args.fallbackToSameOriginOnError = runtimeConfig.fallbackToSameOriginOnError;
+    }
+    return args;
+};
+const createPostProcessorOptions = (runtimeConfig) => {
+    const options = {};
+    if (runtimeConfig.pseudolocalizationCharacterSet) {
+        options.characterSet = runtimeConfig.pseudolocalizationCharacterSet;
+    }
+    if (runtimeConfig.pseudolocalizationPostProcessorName) {
+        options.name = runtimeConfig.pseudolocalizationPostProcessorName;
+    }
+    return options;
+};
+export const initI18nCommon = async ({ instance, locale, namespaces, registry, runtimeConfig, productionLike = false, installReactPlugin = true, environment, missingKeyWarnings, }) => {
+    const backend = resourcesToBackend(createI18nResourceLoader(createResourceLoaderArgs(runtimeConfig)));
+    if (installReactPlugin) {
+        instance.use(initReactI18next);
+    }
+    instance.use(ICU);
+    if (runtimeConfig.pseudolocalizationActive) {
+        instance.use(createPseudolocalizationPostProcessor(createPostProcessorOptions(runtimeConfig)));
+    }
+    await instance.use(backend).init(buildCoreConfig({
+        environment,
+        locale,
+        missingKeyWarnings,
+        namespaces,
+        productionLike,
+        pseudolocalizationActive: runtimeConfig.pseudolocalizationActive,
+        pseudolocalizationCharacterSet: runtimeConfig.pseudolocalizationCharacterSet,
+        pseudolocalizationPostProcessorName: runtimeConfig.pseudolocalizationPostProcessorName,
+        registry,
+    }));
+    return instance;
+};

package/dist/core/resourceLoader.d.ts

@@ -0,0 +1,9 @@
+import type { Resource } from "i18next";
+export type TCreateI18nResourceLoaderArgs = {
+    version: string;
+    preferSameOrigin?: boolean;
+    assetBaseURL?: string;
+    fallbackToSameOriginOnError?: boolean;
+};
+export declare const createI18nResourceLoader: ({ version, preferSameOrigin, assetBaseURL, fallbackToSameOriginOnError, }: TCreateI18nResourceLoaderArgs) => (locale: string, namespace: string) => Promise<Resource>;
+//# sourceMappingURL=resourceLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceLoader.d.ts","sourceRoot":"","sources":["../../src/core/resourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACtC,CAAA;AA8BD,eAAO,MAAM,wBAAwB,GAClC,2EAKE,6BAA6B,MACzB,QAAQ,MAAM,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,QAAQ,CAsC1D,CAAA"}

package/dist/core/resourceLoader.js

@@ -0,0 +1,56 @@
+const stripTrailingSlashes = (value) => value.replace(/\/+$/, "");
+const warnedFallbacks = new Set();
+const formatError = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+};
+const fetchResourceJSON = async (url) => {
+    let response;
+    try {
+        response = await fetch(url, { cache: "no-store" });
+    }
+    catch (error) {
+        throw new Error(`Network failure for ${url}: ${formatError(error)}`);
+    }
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} ${response.statusText} for ${url}`);
+    }
+    try {
+        return (await response.json());
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON for ${url}: ${formatError(error)}`);
+    }
+};
+export const createI18nResourceLoader = ({ version, preferSameOrigin = false, assetBaseURL, fallbackToSameOriginOnError = true, }) => async (locale, namespace) => {
+    const path = `/i18n/${version}/${locale}/${namespace}.json`;
+    const useCDN = Boolean(assetBaseURL) && !preferSameOrigin;
+    if (!useCDN) {
+        return await fetchResourceJSON(path);
+    }
+    const cdnBase = stripTrailingSlashes(assetBaseURL);
+    const cdnURL = `${cdnBase}${path}`;
+    try {
+        return await fetchResourceJSON(cdnURL);
+    }
+    catch (cdnError) {
+        if (!fallbackToSameOriginOnError) {
+            throw new Error(`[i18n] CDN fetch failed for ${cdnURL}: ${formatError(cdnError)}`);
+        }
+        try {
+            const resource = await fetchResourceJSON(path);
+            const warnKey = `${version}:${locale}:${namespace}`;
+            if (!warnedFallbacks.has(warnKey)) {
+                warnedFallbacks.add(warnKey);
+                console.warn(`[i18n] CDN fetch failed; falling back to same-origin for version=${version}, locale=${locale}, ns=${namespace}.`);
+            }
+            return resource;
+        }
+        catch (originError) {
+            throw new Error(`[i18n] Translation load failed for version=${version}, locale=${locale}, ns=${namespace}. ` +
+                `CDN attempt (${cdnURL}) failed: ${formatError(cdnError)}. ` +
+                `Same-origin attempt (${path}) failed: ${formatError(originError)}.`);
+        }
+    }
+};

package/dist/core/server.d.ts

@@ -0,0 +1,21 @@
+import type { i18n, TFunction } from "i18next";
+import type { TI18nRegistry, TI18nRuntimeConfig } from "./types.js";
+export type TGetServerTranslationArgs<Locale extends string, Namespace extends string> = {
+    locale: Locale;
+    namespaces?: readonly Namespace[] | undefined;
+    registry: TI18nRegistry<Locale, Namespace>;
+    runtimeConfig: TI18nRuntimeConfig;
+    productionLike?: boolean | undefined;
+};
+export type TServerTranslationResult = {
+    t: TFunction;
+    i18n: i18n;
+};
+export declare const getServerTranslation: <Locale extends string, Namespace extends string>({ locale, namespaces, registry, runtimeConfig, productionLike, }: TGetServerTranslationArgs<Locale, Namespace>) => Promise<TServerTranslationResult>;
+export type TCreateServerTranslationGetterArgs<Locale extends string, Namespace extends string> = {
+    registry: TI18nRegistry<Locale, Namespace>;
+    getRuntimeConfig: () => TI18nRuntimeConfig;
+    productionLike?: boolean | undefined;
+};
+export declare const createServerTranslationGetter: <Locale extends string, Namespace extends string>({ registry, getRuntimeConfig, productionLike, }: TCreateServerTranslationGetterArgs<Locale, Namespace>) => (locale: Locale, namespaces?: readonly Namespace[]) => Promise<TServerTranslationResult>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/core/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEnE,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACvF,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;CACrC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,CAAC,EAAE,SAAS,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;CACX,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,kEAMzF,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,wBAAwB,CAUjF,CAAA;AAED,MAAM,MAAM,kCAAkC,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IAChG,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;IAC1C,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,6BAA6B,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,iDAI5F,kCAAkC,CAAC,MAAM,EAAE,SAAS,CAAC,MACxC,QAAQ,MAAM,EAAE,aAAa,SAAS,SAAS,EAAE,KAAG,OAAO,CAAC,wBAAwB,CAQnG,CAAA"}

package/dist/core/server.js

@@ -0,0 +1,20 @@
+import { createIsolatedI18nInstance } from "./createIsolatedI18nInstance.js";
+export const getServerTranslation = async ({ locale, namespaces, registry, runtimeConfig, productionLike = true, }) => {
+    const i18nInstance = await createIsolatedI18nInstance({
+        locale,
+        namespaces,
+        productionLike,
+        registry,
+        runtimeConfig,
+    });
+    return { t: i18nInstance.getFixedT(locale), i18n: i18nInstance };
+};
+export const createServerTranslationGetter = ({ registry, getRuntimeConfig, productionLike = true, }) => {
+    return async (locale, namespaces) => getServerTranslation({
+        locale,
+        namespaces,
+        productionLike,
+        registry,
+        runtimeConfig: getRuntimeConfig(),
+    });
+};

package/dist/core/types.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from "react";
+import type { TPseudolocalizationCharacterSet } from "../pseudolocalization/index.js";
+export type TI18nRegistry<Locale extends string = string, Namespace extends string = string> = {
+    defaultLocale: Locale;
+    availableLocales: readonly Locale[];
+    availableNamespaces: readonly Namespace[];
+    initialLoadNamespaces: readonly Namespace[];
+    defaultNamespace?: Namespace | undefined;
+};
+export type TI18nRuntimeConfig = {
+    version: string;
+    assetBaseURL?: string | undefined;
+    preferSameOrigin?: boolean | undefined;
+    fallbackToSameOriginOnError?: boolean | undefined;
+    pseudolocalizationActive?: boolean | undefined;
+    pseudolocalizationCharacterSet?: TPseudolocalizationCharacterSet | undefined;
+    pseudolocalizationPostProcessorName?: string | undefined;
+};
+export type TI18nProviderFallback = ReactNode;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAA;AAErF,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IAC7F,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,mBAAmB,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,qBAAqB,EAAE,SAAS,SAAS,EAAE,CAAA;IAC3C,gBAAgB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,2BAA2B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACjD,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,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAA"}

package/dist/core/types.js

@@ -0,0 +1 @@
+export {};

package/dist/env/client.d.ts

@@ -0,0 +1,29 @@
+import type { TI18nRuntimeConfig } from "../core/types.js";
+import type { TPseudolocalizationCharacterSet } from "../pseudolocalization/index.js";
+import { type TI18nEnvParserConfig, type TI18nEnvSource, type TPseudolocalizationActiveEnvValue } from "./utils.js";
+export declare const AVAILABLE_I18N_CLIENT_ENV_VARS: readonly ["NEXT_PUBLIC_AVAILABLE_LOCALES", "NEXT_PUBLIC_DEFAULT_LOCALE", "NEXT_PUBLIC_I18N_VERSION", "NEXT_PUBLIC_I18N_CDN_BASE_URL", "NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE", "NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET"];
+export type TI18nClientEnvKey = (typeof AVAILABLE_I18N_CLIENT_ENV_VARS)[number];
+export type TI18nClientEnv<Locale extends string = string> = {
+    NEXT_PUBLIC_AVAILABLE_LOCALES?: string | undefined;
+    NEXT_PUBLIC_DEFAULT_LOCALE: Locale;
+    NEXT_PUBLIC_I18N_VERSION: string;
+    NEXT_PUBLIC_I18N_CDN_BASE_URL?: string | undefined;
+    NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE: TPseudolocalizationActiveEnvValue;
+    NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET: TPseudolocalizationCharacterSet;
+    AVAILABLE_LOCALE_LIST: readonly Locale[];
+};
+export type TParseI18nClientEnvArgs<Locale extends string> = {
+    source: TI18nEnvSource;
+    config: TI18nEnvParserConfig<Locale>;
+};
+export type TCreateI18nClientEnvReaderArgs<Locale extends string> = {
+    config: TI18nEnvParserConfig<Locale>;
+    source?: (() => TI18nEnvSource) | undefined;
+};
+export declare const parseI18nClientEnv: <Locale extends string>({ source, config, }: TParseI18nClientEnvArgs<Locale>) => TI18nClientEnv<Locale>;
+export declare const buildClientRuntimeConfig: <Locale extends string>(env: TI18nClientEnv<Locale>) => TI18nRuntimeConfig;
+export declare const createI18nClientEnvReader: <Locale extends string>({ config, source, }: TCreateI18nClientEnvReaderArgs<Locale>) => {
+    get: () => TI18nClientEnv<Locale>;
+    resetForTests: () => void;
+};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/env/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAA;AAErF,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iCAAiC,EACvC,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,8BAA8B,gOAOjC,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAC3D,6BAA6B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClD,0BAA0B,EAAE,MAAM,CAAA;IAClC,wBAAwB,EAAE,MAAM,CAAA;IAChC,6BAA6B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClD,qCAAqC,EAAE,iCAAiC,CAAA;IACxE,4CAA4C,EAAE,+BAA+B,CAAA;IAC7E,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,SAAS,MAAM,IAAI;IAC3D,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,MAAM,IAAI;IAClE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAA;CAC5C,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,MAAM,EAAE,qBAGvD,uBAAuB,CAAC,MAAM,CAAC,KAAG,cAAc,CAAC,MAAM,CAmBzD,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,MAAM,EAAE,KAAK,cAAc,CAAC,MAAM,CAAC,KAAG,kBAM1F,CAAA;AAEJ,eAAO,MAAM,yBAAyB,GAAI,MAAM,SAAS,MAAM,EAAE,qBAG9D,8BAA8B,CAAC,MAAM,CAAC;eAI5B,cAAc,CAAC,MAAM,CAAC;yBAMZ,IAAI;CAI1B,CAAA"}

package/dist/env/client.js

@@ -0,0 +1,42 @@
+import { buildRuntimeConfigFromEnvValues, parseAssetBaseURL, parseAvailableLocaleList, parseDefaultLocale, parseI18nVersion, parsePseudolocalizationActive, parsePseudolocalizationCharacterSet, } from "./utils.js";
+export const AVAILABLE_I18N_CLIENT_ENV_VARS = [
+    "NEXT_PUBLIC_AVAILABLE_LOCALES",
+    "NEXT_PUBLIC_DEFAULT_LOCALE",
+    "NEXT_PUBLIC_I18N_VERSION",
+    "NEXT_PUBLIC_I18N_CDN_BASE_URL",
+    "NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE",
+    "NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET",
+];
+export const parseI18nClientEnv = ({ source, config, }) => {
+    const availableLocales = source.NEXT_PUBLIC_AVAILABLE_LOCALES;
+    const cdnBaseURL = parseAssetBaseURL(source.NEXT_PUBLIC_I18N_CDN_BASE_URL, "NEXT_PUBLIC_I18N_CDN_BASE_URL");
+    return {
+        AVAILABLE_LOCALE_LIST: parseAvailableLocaleList(availableLocales, config),
+        NEXT_PUBLIC_AVAILABLE_LOCALES: availableLocales,
+        NEXT_PUBLIC_DEFAULT_LOCALE: parseDefaultLocale(source.NEXT_PUBLIC_DEFAULT_LOCALE, config),
+        NEXT_PUBLIC_I18N_CDN_BASE_URL: cdnBaseURL,
+        NEXT_PUBLIC_I18N_VERSION: parseI18nVersion(source.NEXT_PUBLIC_I18N_VERSION, config),
+        NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE: parsePseudolocalizationActive(source.NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE, "NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE"),
+        NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET: parsePseudolocalizationCharacterSet(source.NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET, "NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET"),
+    };
+};
+export const buildClientRuntimeConfig = (env) => buildRuntimeConfigFromEnvValues({
+    assetBaseURL: env.NEXT_PUBLIC_I18N_CDN_BASE_URL,
+    pseudolocalizationActive: env.NEXT_PUBLIC_PSEUDOLOCALIZATION_ACTIVE,
+    pseudolocalizationCharacterSet: env.NEXT_PUBLIC_PSEUDOLOCALIZATION_CHARACTER_SET,
+    version: env.NEXT_PUBLIC_I18N_VERSION,
+});
+export const createI18nClientEnvReader = ({ config, source = () => process.env, }) => {
+    let cached = null;
+    return {
+        get: () => {
+            if (cached)
+                return cached;
+            cached = parseI18nClientEnv({ config, source: source() });
+            return cached;
+        },
+        resetForTests: () => {
+            cached = null;
+        },
+    };
+};

package/dist/env/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./client.js";
+export * from "./server.js";
+export * from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/env/index.js

@@ -0,0 +1,3 @@
+export * from "./client.js";
+export * from "./server.js";
+export * from "./utils.js";

package/dist/env/server.d.ts

@@ -0,0 +1,30 @@
+import type { TI18nRuntimeConfig } from "../core/types.js";
+import type { TPseudolocalizationCharacterSet } from "../pseudolocalization/index.js";
+import { type TI18nEnvParserConfig, type TI18nEnvSource, type TPseudolocalizationActiveEnvValue } from "./utils.js";
+export declare const AVAILABLE_I18N_SERVER_ENV_VARS: readonly ["AVAILABLE_LOCALES", "DEFAULT_LOCALE", "I18N_VERSION", "I18N_CDN_BASE_URL", "PSEUDOLOCALIZATION_ACTIVE", "PSEUDOLOCALIZATION_CHARACTER_SET"];
+export type TI18nServerEnvKey = (typeof AVAILABLE_I18N_SERVER_ENV_VARS)[number];
+export type TI18nServerEnv<Locale extends string = string> = {
+    AVAILABLE_LOCALES?: string | undefined;
+    DEFAULT_LOCALE: Locale;
+    I18N_VERSION: string;
+    I18N_CDN_BASE_URL?: string | undefined;
+    PSEUDOLOCALIZATION_ACTIVE: TPseudolocalizationActiveEnvValue;
+    PSEUDOLOCALIZATION_CHARACTER_SET: TPseudolocalizationCharacterSet;
+    AVAILABLE_LOCALE_LIST: readonly Locale[];
+};
+export type TParseI18nServerEnvArgs<Locale extends string> = {
+    source: TI18nEnvSource;
+    config: TI18nEnvParserConfig<Locale>;
+};
+export type TCreateI18nServerEnvReaderArgs<Locale extends string> = {
+    config: TI18nEnvParserConfig<Locale>;
+    source?: (() => TI18nEnvSource) | undefined;
+    clientImportErrorMessage?: string | undefined;
+};
+export declare const parseI18nServerEnv: <Locale extends string>({ source, config, }: TParseI18nServerEnvArgs<Locale>) => TI18nServerEnv<Locale>;
+export declare const buildServerRuntimeConfig: <Locale extends string>(env: TI18nServerEnv<Locale>) => TI18nRuntimeConfig;
+export declare const createI18nServerEnvReader: <Locale extends string>({ config, source, clientImportErrorMessage, }: TCreateI18nServerEnvReaderArgs<Locale>) => {
+    get: () => TI18nServerEnv<Locale>;
+    resetForTests: () => void;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/env/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/env/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAA;AAErF,OAAO,EAQL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iCAAiC,EACvC,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,8BAA8B,wJAOjC,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAC3D,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,yBAAyB,EAAE,iCAAiC,CAAA;IAC5D,gCAAgC,EAAE,+BAA+B,CAAA;IACjE,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,SAAS,MAAM,IAAI;IAC3D,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,8BAA8B,CAAC,MAAM,SAAS,MAAM,IAAI;IAClE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAA;IAC3C,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,MAAM,EAAE,qBAGvD,uBAAuB,CAAC,MAAM,CAAC,KAAG,cAAc,CAAC,MAAM,CAmBzD,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,MAAM,EAAE,KAAK,cAAc,CAAC,MAAM,CAAC,KAAG,kBAM1F,CAAA;AAEJ,eAAO,MAAM,yBAAyB,GAAI,MAAM,SAAS,MAAM,EAAE,+CAI9D,8BAA8B,CAAC,MAAM,CAAC;eAI5B,cAAc,CAAC,MAAM,CAAC;yBAUZ,IAAI;CAI1B,CAAA"}

package/dist/env/server.js

@@ -0,0 +1,45 @@
+import { buildRuntimeConfigFromEnvValues, parseAssetBaseURL, parseAvailableLocaleList, parseDefaultLocale, parseI18nVersion, parsePseudolocalizationActive, parsePseudolocalizationCharacterSet, } from "./utils.js";
+export const AVAILABLE_I18N_SERVER_ENV_VARS = [
+    "AVAILABLE_LOCALES",
+    "DEFAULT_LOCALE",
+    "I18N_VERSION",
+    "I18N_CDN_BASE_URL",
+    "PSEUDOLOCALIZATION_ACTIVE",
+    "PSEUDOLOCALIZATION_CHARACTER_SET",
+];
+export const parseI18nServerEnv = ({ source, config, }) => {
+    const availableLocales = source.AVAILABLE_LOCALES;
+    const cdnBaseURL = parseAssetBaseURL(source.I18N_CDN_BASE_URL, "I18N_CDN_BASE_URL");
+    return {
+        AVAILABLE_LOCALE_LIST: parseAvailableLocaleList(availableLocales, config),
+        AVAILABLE_LOCALES: availableLocales,
+        DEFAULT_LOCALE: parseDefaultLocale(source.DEFAULT_LOCALE, config),
+        I18N_CDN_BASE_URL: cdnBaseURL,
+        I18N_VERSION: parseI18nVersion(source.I18N_VERSION, config),
+        PSEUDOLOCALIZATION_ACTIVE: parsePseudolocalizationActive(source.PSEUDOLOCALIZATION_ACTIVE, "PSEUDOLOCALIZATION_ACTIVE"),
+        PSEUDOLOCALIZATION_CHARACTER_SET: parsePseudolocalizationCharacterSet(source.PSEUDOLOCALIZATION_CHARACTER_SET, "PSEUDOLOCALIZATION_CHARACTER_SET"),
+    };
+};
+export const buildServerRuntimeConfig = (env) => buildRuntimeConfigFromEnvValues({
+    assetBaseURL: env.I18N_CDN_BASE_URL,
+    pseudolocalizationActive: env.PSEUDOLOCALIZATION_ACTIVE,
+    pseudolocalizationCharacterSet: env.PSEUDOLOCALIZATION_CHARACTER_SET,
+    version: env.I18N_VERSION,
+});
+export const createI18nServerEnvReader = ({ config, source = () => process.env, clientImportErrorMessage = "[i18n server env] Imported in a client/browser context. Use the client env reader instead.", }) => {
+    let cached = null;
+    return {
+        get: () => {
+            if (typeof window !== "undefined") {
+                throw new Error(clientImportErrorMessage);
+            }
+            if (cached)
+                return cached;
+            cached = parseI18nServerEnv({ config, source: source() });
+            return cached;
+        },
+        resetForTests: () => {
+            cached = null;
+        },
+    };
+};

package/dist/env/utils.d.ts

@@ -0,0 +1,23 @@
+import type { TI18nRuntimeConfig } from "../core/types.js";
+import { type TPseudolocalizationCharacterSet } from "../pseudolocalization/index.js";
+export type TI18nEnvSource = Record<string, string | undefined>;
+export type TI18nEnvParserConfig<Locale extends string = string> = {
+    declaredLocales: readonly Locale[];
+    defaultLocale: Locale;
+    i18nVersion: string;
+};
+export type TPseudolocalizationActiveEnvValue = "true" | "false";
+export declare const isDeclaredLocaleValue: <Locale extends string>(value: string, config: TI18nEnvParserConfig<Locale>) => value is Locale;
+export declare const parseAvailableLocaleList: <Locale extends string>(rawValue: string | undefined, config: TI18nEnvParserConfig<Locale>) => readonly Locale[];
+export declare const parseDefaultLocale: <Locale extends string>(rawValue: string | undefined, config: TI18nEnvParserConfig<Locale>) => Locale;
+export declare const parseI18nVersion: <Locale extends string>(rawValue: string | undefined, config: TI18nEnvParserConfig<Locale>) => string;
+export declare const parseAssetBaseURL: (rawValue: string | undefined, envKey: string) => string | undefined;
+export declare const parsePseudolocalizationActive: (rawValue: string | undefined, envKey: string) => TPseudolocalizationActiveEnvValue;
+export declare const parsePseudolocalizationCharacterSet: (rawValue: string | undefined, envKey: string) => TPseudolocalizationCharacterSet;
+export declare const buildRuntimeConfigFromEnvValues: ({ version, assetBaseURL, pseudolocalizationActive, pseudolocalizationCharacterSet, }: {
+    version: string;
+    assetBaseURL?: string | undefined;
+    pseudolocalizationActive: TPseudolocalizationActiveEnvValue;
+    pseudolocalizationCharacterSet: TPseudolocalizationCharacterSet;
+}) => TI18nRuntimeConfig;
+//# sourceMappingURL=utils.d.ts.map

package/dist/env/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/env/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,gCAAgC,CAAA;AAEvC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAE/D,MAAM,MAAM,oBAAoB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IACjE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG,OAAO,CAAA;AAIhE,eAAO,MAAM,qBAAqB,GAAI,MAAM,SAAS,MAAM,EACzD,OAAO,MAAM,EACb,QAAQ,oBAAoB,CAAC,MAAM,CAAC,KACnC,KAAK,IAAI,MAA0D,CAAA;AAEtE,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,MAAM,EAC5D,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,oBAAoB,CAAC,MAAM,CAAC,KACnC,SAAS,MAAM,EAWjB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,MAAM,EACtD,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,oBAAoB,CAAC,MAAM,CAAC,KACnC,MAIF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,SAAS,MAAM,EACpD,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,oBAAoB,CAAC,MAAM,CAAC,KACnC,MAIF,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MAAM,GAAG,SAkBzF,CAAA;AAED,eAAO,MAAM,6BAA6B,GACxC,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,MAAM,KACb,iCAOF,CAAA;AAED,eAAO,MAAM,mCAAmC,GAC9C,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,MAAM,KACb,+BASF,CAAA;AAED,eAAO,MAAM,+BAA+B,GAAI,sFAK7C;IACD,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,wBAAwB,EAAE,iCAAiC,CAAA;IAC3D,8BAA8B,EAAE,+BAA+B,CAAA;CAChE,KAAG,kBAYH,CAAA"}

package/dist/env/utils.js

@@ -0,0 +1,65 @@
+import { DEFAULT_PSEUDOLOCALIZATION_CHARACTER_SET, PSEUDOLOCALIZATION_CHARACTER_SETS, } from "../pseudolocalization/index.js";
+const normalizeLocale = (value) => value.trim().toLowerCase();
+export const isDeclaredLocaleValue = (value, config) => config.declaredLocales.includes(value);
+export const parseAvailableLocaleList = (rawValue, config) => {
+    if (!rawValue?.trim())
+        return config.declaredLocales;
+    const requestedLocales = rawValue
+        .split(",")
+        .map((value) => normalizeLocale(value))
+        .filter((value) => value.length > 0);
+    const validatedLocales = requestedLocales.filter((value) => isDeclaredLocaleValue(value, config));
+    return validatedLocales.length > 0 ? validatedLocales : config.declaredLocales;
+};
+export const parseDefaultLocale = (rawValue, config) => {
+    const normalizedValue = rawValue ? normalizeLocale(rawValue) : undefined;
+    return normalizedValue && isDeclaredLocaleValue(normalizedValue, config) ? normalizedValue : config.defaultLocale;
+};
+export const parseI18nVersion = (rawValue, config) => {
+    const normalizedValue = rawValue?.trim();
+    return normalizedValue && normalizedValue.length > 0 ? normalizedValue : config.i18nVersion;
+};
+export const parseAssetBaseURL = (rawValue, envKey) => {
+    const normalizedValue = rawValue?.trim().replace(/\/+$/, "");
+    if (!normalizedValue)
+        return undefined;
+    let url;
+    try {
+        url = new URL(normalizedValue);
+    }
+    catch {
+        throw new Error(`[i18n env] ${envKey} must be an absolute HTTP(S) URL.`);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`[i18n env] ${envKey} must use the http: or https: protocol.`);
+    }
+    return normalizedValue;
+};
+export const parsePseudolocalizationActive = (rawValue, envKey) => {
+    const normalizedValue = rawValue?.trim().toLowerCase();
+    if (!normalizedValue)
+        return "false";
+    if (normalizedValue === "true" || normalizedValue === "false")
+        return normalizedValue;
+    throw new Error(`[i18n env] ${envKey} must be "true" or "false".`);
+};
+export const parsePseudolocalizationCharacterSet = (rawValue, envKey) => {
+    const normalizedValue = rawValue?.trim().toLowerCase();
+    if (!normalizedValue)
+        return DEFAULT_PSEUDOLOCALIZATION_CHARACTER_SET;
+    if (PSEUDOLOCALIZATION_CHARACTER_SETS.includes(normalizedValue)) {
+        return normalizedValue;
+    }
+    throw new Error(`[i18n env] ${envKey} must be one of: ${PSEUDOLOCALIZATION_CHARACTER_SETS.join(", ")}.`);
+};
+export const buildRuntimeConfigFromEnvValues = ({ version, assetBaseURL, pseudolocalizationActive, pseudolocalizationCharacterSet, }) => {
+    const runtimeConfig = {
+        pseudolocalizationActive: pseudolocalizationActive === "true",
+        pseudolocalizationCharacterSet,
+        version,
+    };
+    if (assetBaseURL) {
+        runtimeConfig.assetBaseURL = assetBaseURL;
+    }
+    return runtimeConfig;
+};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./common/index.js";
+export * from "./core/index.js";
+export * from "./env/index.js";
+export * from "./manifest/index.js";
+export * from "./pseudolocalization/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,+BAA+B,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./common/index.js";
+export * from "./core/index.js";
+export * from "./env/index.js";
+export * from "./manifest/index.js";
+export * from "./pseudolocalization/index.js";

package/dist/manifest/index.d.ts

@@ -0,0 +1,37 @@
+export declare const I18N_ASSET_BASE_PATH: "/i18n";
+export type TI18nManifest<Locale extends string = string, Namespace extends string = string> = {
+    defaultLocale: Locale;
+    locales: readonly Locale[];
+    namespaces: readonly Namespace[];
+    version: string;
+};
+export type TBuildI18nManifestArgs<Locale extends string, Namespace extends string> = {
+    defaultLocale: Locale;
+    locales: readonly Locale[];
+    namespaces: readonly Namespace[];
+    version: string;
+};
+export type TBuildI18nResourcePathArgs<Locale extends string = string, Namespace extends string = string> = {
+    locale: Locale;
+    namespace: Namespace;
+    version: string;
+    assetBasePath?: string | undefined;
+};
+export type TBuildI18nManifestPathArgs = {
+    version: string;
+    assetBasePath?: string | undefined;
+};
+export type TValidateDevManifestArgs<Locale extends string = string, Namespace extends string = string> = {
+    version: string;
+    expectedLocales: readonly Locale[];
+    expectedNamespaces: readonly Namespace[];
+    environment?: string | undefined;
+    developmentEnvironmentName?: string | undefined;
+    fetcher?: typeof fetch | undefined;
+    manifestPath?: string | undefined;
+};
+export declare const buildI18nManifest: <Locale extends string, Namespace extends string>({ defaultLocale, locales, namespaces, version, }: TBuildI18nManifestArgs<Locale, Namespace>) => TI18nManifest<Locale, Namespace>;
+export declare const buildI18nManifestPath: ({ assetBasePath, version, }: TBuildI18nManifestPathArgs) => string;
+export declare const buildI18nResourcePath: <Locale extends string, Namespace extends string>({ assetBasePath, locale, namespace, version, }: TBuildI18nResourcePathArgs<Locale, Namespace>) => string;
+export declare const validateDevManifest: <Locale extends string, Namespace extends string>({ version, expectedLocales, expectedNamespaces, environment, developmentEnvironmentName, fetcher, manifestPath, }: TValidateDevManifestArgs<Locale, Namespace>) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,OAAgB,CAAA;AAEpD,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IAC7F,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,sBAAsB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACpF,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,0BAA0B,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IAC1G,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,wBAAwB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACxG,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,kBAAkB,EAAE,SAAS,SAAS,EAAE,CAAA;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/C,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,kDAKhF,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAK5E,CAAA;AAEF,eAAO,MAAM,qBAAqB,GAAI,6BAGnC,0BAA0B,KAAG,MAE/B,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,gDAKpF,0BAA0B,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,MAElD,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAU,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,mHAQxF,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,IAAI,CAuC5D,CAAA"}

package/dist/manifest/index.js

@@ -0,0 +1,46 @@
+export const I18N_ASSET_BASE_PATH = "/i18n";
+export const buildI18nManifest = ({ defaultLocale, locales, namespaces, version, }) => ({
+    defaultLocale,
+    locales,
+    namespaces,
+    version,
+});
+export const buildI18nManifestPath = ({ assetBasePath = I18N_ASSET_BASE_PATH, version, }) => {
+    return `${assetBasePath}/${version}/manifest.json`;
+};
+export const buildI18nResourcePath = ({ assetBasePath = I18N_ASSET_BASE_PATH, locale, namespace, version, }) => {
+    return `${assetBasePath}/${version}/${locale}/${namespace}.json`;
+};
+export const validateDevManifest = async ({ version, expectedLocales, expectedNamespaces, environment = process.env.NODE_ENV, developmentEnvironmentName = "development", fetcher = fetch, manifestPath, }) => {
+    if (environment !== developmentEnvironmentName)
+        return;
+    if (!version) {
+        console.warn("[i18n] I18N_VERSION is not set; skipping dev manifest validation.");
+        return;
+    }
+    const url = manifestPath ?? buildI18nManifestPath({ version });
+    try {
+        const response = await fetcher(url, { cache: "no-store" });
+        if (!response.ok) {
+            console.warn(`[i18n] dev manifest fetch failed (${response.status}) for ${url}`);
+            return;
+        }
+        const manifest = (await response.json());
+        if (manifest.version !== version) {
+            console.warn(`[i18n] dev manifest version mismatch: env=${version} manifest=${manifest.version}`);
+        }
+        const manifestLocales = new Set(manifest.locales);
+        const manifestNamespaces = new Set(manifest.namespaces);
+        const missingLocales = expectedLocales.filter((locale) => !manifestLocales.has(locale));
+        const missingNamespaces = expectedNamespaces.filter((namespace) => !manifestNamespaces.has(namespace));
+        if (missingLocales.length > 0) {
+            console.warn(`[i18n] locales missing on disk: ${missingLocales.join(", ")}`);
+        }
+        if (missingNamespaces.length > 0) {
+            console.warn(`[i18n] namespaces missing on disk: ${missingNamespaces.join(", ")}`);
+        }
+    }
+    catch (error) {
+        console.warn(`[i18n] An error was encountered during a development i18n manifest validation -> ${error}`);
+    }
+};