@intlayer/use-intl 9.0.0-canary.2

package/dist/esm/core/createTranslator.mjs

@@ -0,0 +1,28 @@
+import { createNamespaceTranslator } from "../shared/namespaceTranslator.mjs";
+import { log } from "@intlayer/config/built";
+import { CYAN } from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+
+//#region src/core/createTranslator.ts
+/**
+* Drop-in for use-intl's `createTranslator`.
+*
+* Returns a translate function (with `rich`, `markup`, `raw`, `has`) that
+* resolves messages from Intlayer's compiled dictionaries for the given
+* `locale`. Messages support ICU MessageFormat syntax.
+*
+* @example
+* ```ts
+* const t = createTranslator({ locale: 'en', namespace: 'about' });
+* t('counter.label'); // ✓ typed
+* t('items', { count: 3 }); // ICU plural
+* ```
+*/
+const createTranslator = (({ locale, namespace, messages: _messages }) => {
+	if (_messages !== void 0) getAppLogger({ log })(`${colorize("createTranslator", CYAN)} do not pass the messages option with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`);
+	return createNamespaceTranslator(locale, namespace);
+});
+
+//#endregion
+export { createTranslator };
+//# sourceMappingURL=createTranslator.mjs.map

package/dist/esm/core/createTranslator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTranslator.mjs","names":[],"sources":["../../../src/core/createTranslator.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { createNamespaceTranslator } from '../shared/namespaceTranslator';\nimport type {\n  LooseTranslateFunction,\n  TranslateFunction,\n} from '../shared/translateFunctionTypes';\n\n/**\n * Configuration accepted by {@link createTranslator}.\n *\n * Mirrors use-intl's `IntlConfig`, but `messages`, `formats`, `now`,\n * `timeZone`, `onError`, and `getMessageFallback` have no effect — Intlayer\n * resolves content from its own compiled dictionaries.\n */\nexport type CreateTranslatorConfig<N extends DictionaryKeys> = {\n  /** The locale dictionaries are resolved for. */\n  locale: LocalesValues;\n  /** A bare dictionary key, or a nested `'dictionary.scope'` namespace. */\n  namespace?: N | (string & {});\n  /**\n   * @deprecated has no use case with intlayer. Messages are loaded\n   * automatically under the hood for bundle optimization reason.\n   */\n  messages?: never;\n} & Record<string, unknown>;\n\n/**\n * Overload set for {@link createTranslator}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    `string` paths, matching use-intl's scoped-namespace behaviour.\n * 3. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype CreateTranslator = {\n  <N extends DictionaryKeys>(\n    config: CreateTranslatorConfig<N> & { namespace: N }\n  ): TranslateFunction<N>;\n  (\n    config: CreateTranslatorConfig<DictionaryKeys> & {\n      namespace: `${string}.${string}`;\n    }\n  ): LooseTranslateFunction;\n  (config: CreateTranslatorConfig<DictionaryKeys>): LooseTranslateFunction;\n};\n\n/**\n * Drop-in for use-intl's `createTranslator`.\n *\n * Returns a translate function (with `rich`, `markup`, `raw`, `has`) that\n * resolves messages from Intlayer's compiled dictionaries for the given\n * `locale`. Messages support ICU MessageFormat syntax.\n *\n * @example\n * ```ts\n * const t = createTranslator({ locale: 'en', namespace: 'about' });\n * t('counter.label'); // ✓ typed\n * t('items', { count: 3 }); // ICU plural\n * ```\n */\nexport const createTranslator = (({\n  locale,\n  namespace,\n  messages: _messages,\n}: CreateTranslatorConfig<DictionaryKeys>) => {\n  if (process.env.NODE_ENV === 'development' && _messages !== undefined) {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('createTranslator', CYAN)} do not pass the messages option with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return createNamespaceTranslator(locale, namespace);\n}) as CreateTranslator;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,qBAAqB,EAChC,QACA,WACA,UAAU,gBACkC;AAC5C,KAA8C,cAAc,OAE1D,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,oBAAoB,KAAK,CAAC,iIACvC;AAGH,QAAO,0BAA0B,QAAQ,UAAU"}

package/dist/esm/core/errors.mjs

@@ -0,0 +1,39 @@
+//#region src/core/errors.ts
+/**
+* Drop-in for use-intl's `IntlErrorCode` enum.
+*
+* Re-implemented locally (rather than re-exported) because `use-intl` is
+* aliased to this package at build time, so importing its runtime value would
+* be circular.
+*/
+let IntlErrorCode = /* @__PURE__ */ function(IntlErrorCode) {
+	IntlErrorCode["MISSING_MESSAGE"] = "MISSING_MESSAGE";
+	IntlErrorCode["MISSING_FORMAT"] = "MISSING_FORMAT";
+	IntlErrorCode["ENVIRONMENT_FALLBACK"] = "ENVIRONMENT_FALLBACK";
+	IntlErrorCode["INSUFFICIENT_PATH"] = "INSUFFICIENT_PATH";
+	IntlErrorCode["INVALID_MESSAGE"] = "INVALID_MESSAGE";
+	IntlErrorCode["INVALID_KEY"] = "INVALID_KEY";
+	IntlErrorCode["FORMATTING_ERROR"] = "FORMATTING_ERROR";
+	return IntlErrorCode;
+}({});
+/**
+* Drop-in for use-intl's `IntlError`.
+*
+* Carries the {@link IntlErrorCode} and the original message, matching
+* use-intl's error shape so consumer `onError` handlers keep working.
+*/
+var IntlError = class extends Error {
+	code;
+	originalMessage;
+	constructor(code, originalMessage) {
+		let message = code;
+		if (originalMessage) message += `: ${originalMessage}`;
+		super(message);
+		this.code = code;
+		if (originalMessage) this.originalMessage = originalMessage;
+	}
+};
+
+//#endregion
+export { IntlError, IntlErrorCode };
+//# sourceMappingURL=errors.mjs.map

package/dist/esm/core/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/core/errors.ts"],"sourcesContent":["/**\n * Drop-in for use-intl's `IntlErrorCode` enum.\n *\n * Re-implemented locally (rather than re-exported) because `use-intl` is\n * aliased to this package at build time, so importing its runtime value would\n * be circular.\n */\nexport enum IntlErrorCode {\n  MISSING_MESSAGE = 'MISSING_MESSAGE',\n  MISSING_FORMAT = 'MISSING_FORMAT',\n  ENVIRONMENT_FALLBACK = 'ENVIRONMENT_FALLBACK',\n  INSUFFICIENT_PATH = 'INSUFFICIENT_PATH',\n  INVALID_MESSAGE = 'INVALID_MESSAGE',\n  INVALID_KEY = 'INVALID_KEY',\n  FORMATTING_ERROR = 'FORMATTING_ERROR',\n}\n\n/**\n * Drop-in for use-intl's `IntlError`.\n *\n * Carries the {@link IntlErrorCode} and the original message, matching\n * use-intl's error shape so consumer `onError` handlers keep working.\n */\nexport class IntlError extends Error {\n  public readonly code: IntlErrorCode;\n  public readonly originalMessage: string | undefined;\n\n  constructor(code: IntlErrorCode, originalMessage?: string) {\n    let message: string = code;\n    if (originalMessage) {\n      message += `: ${originalMessage}`;\n    }\n    super(message);\n\n    this.code = code;\n    if (originalMessage) {\n      this.originalMessage = originalMessage;\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAY,gBAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;;KACD;;;;;;;AAQD,IAAa,YAAb,cAA+B,MAAM;CACnC,AAAgB;CAChB,AAAgB;CAEhB,YAAY,MAAqB,iBAA0B;EACzD,IAAI,UAAkB;AACtB,MAAI,gBACF,YAAW,KAAK;AAElB,QAAM,QAAQ;AAEd,OAAK,OAAO;AACZ,MAAI,gBACF,MAAK,kBAAkB"}

package/dist/esm/core/hasLocale.mjs

@@ -0,0 +1,21 @@
+import { internationalization } from "@intlayer/config/built";
+
+//#region src/core/hasLocale.ts
+/**
+* Drop-in for use-intl's `hasLocale`.
+*
+* Narrows a locale candidate to the given locales list. When the list is
+* omitted, the locales configured in intlayer are used.
+*
+* @example
+* ```ts
+* if (hasLocale(['en', 'fr'], requested)) { … }
+* ```
+*/
+const hasLocale = ((locales, candidate) => {
+	return (locales ?? internationalization?.locales?.map(String) ?? []).includes(candidate);
+});
+
+//#endregion
+export { hasLocale };
+//# sourceMappingURL=hasLocale.mjs.map

package/dist/esm/core/hasLocale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasLocale.mjs","names":[],"sources":["../../../src/core/hasLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { hasLocale as _hasLocale } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `hasLocale`.\n *\n * Narrows a locale candidate to the given locales list. When the list is\n * omitted, the locales configured in intlayer are used.\n *\n * @example\n * ```ts\n * if (hasLocale(['en', 'fr'], requested)) { … }\n * ```\n */\nexport const hasLocale: typeof _hasLocale = ((\n  locales: readonly string[],\n  candidate: unknown\n): boolean => {\n  const availableLocales =\n    locales ?? internationalization?.locales?.map(String) ?? [];\n  return availableLocales.includes(candidate as string);\n}) as typeof _hasLocale;\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,cACX,SACA,cACY;AAGZ,SADE,WAAW,sBAAsB,SAAS,IAAI,OAAO,IAAI,EAAE,EACrC,SAAS,UAAoB"}

package/dist/esm/core/index.mjs

@@ -0,0 +1,7 @@
+import { createFormatter } from "./createFormatter.mjs";
+import { createTranslator } from "./createTranslator.mjs";
+import { IntlError, IntlErrorCode } from "./errors.mjs";
+import { hasLocale } from "./hasLocale.mjs";
+import { initializeConfig } from "./initializeConfig.mjs";
+
+export { IntlError, IntlErrorCode, createFormatter, createTranslator, hasLocale, initializeConfig };

package/dist/esm/core/initializeConfig.mjs

@@ -0,0 +1,23 @@
+//#region src/core/initializeConfig.ts
+/**
+* Drop-in for use-intl's `initializeConfig`.
+*
+* Enhances an incoming config with defaults. With intlayer, `messages` and
+* `formats` are not consumed at runtime (content comes from compiled
+* dictionaries) but the shape is preserved so callers keep type-checking.
+*/
+const initializeConfig = ({ formats, getMessageFallback, messages, onError, ...rest }) => {
+	const finalOnError = onError ?? ((error) => error);
+	const finalGetMessageFallback = getMessageFallback ?? (({ key, namespace }) => [namespace, key].filter(Boolean).join("."));
+	return {
+		...rest,
+		formats: formats || void 0,
+		messages: messages || void 0,
+		onError: finalOnError,
+		getMessageFallback: finalGetMessageFallback
+	};
+};
+
+//#endregion
+export { initializeConfig };
+//# sourceMappingURL=initializeConfig.mjs.map

package/dist/esm/core/initializeConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializeConfig.mjs","names":[],"sources":["../../../src/core/initializeConfig.ts"],"sourcesContent":["import type { initializeConfig as _initializeConfig } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `initializeConfig`.\n *\n * Enhances an incoming config with defaults. With intlayer, `messages` and\n * `formats` are not consumed at runtime (content comes from compiled\n * dictionaries) but the shape is preserved so callers keep type-checking.\n */\nexport const initializeConfig: typeof _initializeConfig = ({\n  formats,\n  getMessageFallback,\n  messages,\n  onError,\n  ...rest\n}) => {\n  const finalOnError = onError ?? ((error) => error);\n  const finalGetMessageFallback =\n    getMessageFallback ?? (({ key, namespace }) => [namespace, key]\n      .filter(Boolean)\n      .join('.'));\n\n  return {\n    ...rest,\n    formats: formats || undefined,\n    messages: messages || undefined,\n    onError: finalOnError,\n    getMessageFallback: finalGetMessageFallback,\n  };\n};\n"],"mappings":";;;;;;;;AASA,MAAa,oBAA8C,EACzD,SACA,oBACA,UACA,SACA,GAAG,WACC;CACJ,MAAM,eAAe,aAAa,UAAU;CAC5C,MAAM,0BACJ,wBAAwB,EAAE,KAAK,gBAAgB,CAAC,WAAW,IAAI,CAC5D,OAAO,QAAQ,CACf,KAAK,IAAI;AAEd,QAAO;EACL,GAAG;EACH,SAAS,WAAW;EACpB,UAAU,YAAY;EACtB,SAAS;EACT,oBAAoB;EACrB"}

package/dist/esm/index.mjs

@@ -0,0 +1,14 @@
+import { useDictionaryDynamic } from "./useDictionaryDynamic.mjs";
+import { createFormatter } from "./core/createFormatter.mjs";
+import { createTranslator } from "./core/createTranslator.mjs";
+import { IntlError, IntlErrorCode } from "./core/errors.mjs";
+import { hasLocale } from "./core/hasLocale.mjs";
+import { initializeConfig } from "./core/initializeConfig.mjs";
+import { IntlProvider } from "./react/IntlProvider.mjs";
+import { useFormatter, useMessages, useNow, useTimeZone } from "./react/helpers.mjs";
+import { useLocale } from "./react/useLocale.mjs";
+import { useTranslations } from "./react/useTranslations.mjs";
+import { useDictionary } from "./useDictionary.mjs";
+import { _useExtracted } from "./react/index.mjs";
+
+export { IntlError, IntlErrorCode, IntlProvider, _useExtracted, createFormatter, createTranslator, hasLocale, initializeConfig, useDictionary, useDictionaryDynamic, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };

package/dist/esm/plugin/index.mjs

@@ -0,0 +1,76 @@
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+import { join } from "node:path";
+import { runOnce } from "@intlayer/chokidar/utils";
+import { getConfiguration } from "@intlayer/config/node";
+import { intlayer } from "vite-intlayer";
+
+//#region src/plugin/index.ts
+/**
+* Caller configurations for use-intl's translation entry points.
+*
+* Tells the intlayer field-usage analyser how to extract the dictionary key
+* (namespace) and consumed fields from `useTranslations` / `createTranslator`
+* call sites, enabling accurate dictionary pruning for projects using
+* `@intlayer/use-intl`.
+*/
+const USE_INTL_COMPAT_CALLERS = [{
+	callerName: "useTranslations",
+	importSources: [
+		"use-intl",
+		"use-intl/react",
+		"@intlayer/use-intl"
+	],
+	namespace: {
+		from: "argument",
+		index: 0
+	},
+	translationFunction: "return-value"
+}, {
+	callerName: "createTranslator",
+	importSources: [
+		"use-intl",
+		"use-intl/core",
+		"@intlayer/use-intl"
+	],
+	namespace: {
+		from: "option",
+		argumentIndex: 0,
+		property: "namespace"
+	},
+	translationFunction: "return-value"
+}];
+/**
+* A Vite plugin for use-intl compat that wraps vite-intlayer and configures
+* resolve aliases so `use-intl` imports are served by `@intlayer/use-intl`.
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import useIntlVitePlugin from '@intlayer/use-intl/plugin';
+*
+* export default defineConfig({
+*   plugins: [useIntlVitePlugin()],
+* });
+* ```
+*/
+const useIntlVitePlugin = (options) => {
+	const intlayerConfig = getConfiguration();
+	const appLogger = getAppLogger(intlayerConfig);
+	runOnce(join(intlayerConfig.system.baseDir, ".intlayer", "cache", "intlayer-issues-invitation.lock"), () => {
+		appLogger([colorize("Please report any issues you met on GitHub:", ANSIColors.GREY), colorize("https://github.com/aymericzip/intlayer/issues", ANSIColors.GREY_LIGHT)]);
+	}, { cacheTimeoutMs: 1e3 * 60 * 60 });
+	const basePlugins = intlayer({
+		...options,
+		compatCallers: [...options?.compatCallers ?? [], ...USE_INTL_COMPAT_CALLERS]
+	});
+	const compatPlugin = {
+		name: "vite-use-intl-compat-plugin",
+		config: () => ({ resolve: { alias: { "use-intl": "@intlayer/use-intl" } } })
+	};
+	return [...Array.isArray(basePlugins) ? basePlugins : [basePlugins], compatPlugin];
+};
+
+//#endregion
+export { useIntlVitePlugin as default, useIntlVitePlugin };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/plugin/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugin/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { runOnce } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport type { PluginOption } from 'vite';\nimport { type CompatCallerConfig, intlayer } from 'vite-intlayer';\n\n/**\n * Caller configurations for use-intl's translation entry points.\n *\n * Tells the intlayer field-usage analyser how to extract the dictionary key\n * (namespace) and consumed fields from `useTranslations` / `createTranslator`\n * call sites, enabling accurate dictionary pruning for projects using\n * `@intlayer/use-intl`.\n */\nconst USE_INTL_COMPAT_CALLERS: CompatCallerConfig[] = [\n  {\n    callerName: 'useTranslations',\n    importSources: ['use-intl', 'use-intl/react', '@intlayer/use-intl'],\n    namespace: { from: 'argument', index: 0 },\n    translationFunction: 'return-value',\n  },\n  {\n    callerName: 'createTranslator',\n    importSources: ['use-intl', 'use-intl/core', '@intlayer/use-intl'],\n    namespace: { from: 'option', argumentIndex: 0, property: 'namespace' },\n    translationFunction: 'return-value',\n  },\n];\n\n/**\n * A Vite plugin for use-intl compat that wraps vite-intlayer and configures\n * resolve aliases so `use-intl` imports are served by `@intlayer/use-intl`.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import useIntlVitePlugin from '@intlayer/use-intl/plugin';\n *\n * export default defineConfig({\n *   plugins: [useIntlVitePlugin()],\n * });\n * ```\n */\nexport const useIntlVitePlugin = (\n  options?: Parameters<typeof intlayer>[0]\n): PluginOption[] => {\n  const intlayerConfig = getConfiguration();\n  const appLogger = getAppLogger(intlayerConfig);\n\n  runOnce(\n    join(\n      intlayerConfig.system.baseDir,\n      '.intlayer',\n      'cache',\n      'intlayer-issues-invitation.lock'\n    ),\n    () => {\n      appLogger([\n        colorize(\n          'Please report any issues you met on GitHub:',\n          ANSIColors.GREY\n        ),\n        colorize(\n          'https://github.com/aymericzip/intlayer/issues',\n          ANSIColors.GREY_LIGHT\n        ),\n      ]);\n    },\n    {\n      cacheTimeoutMs: 1000 * 60 * 60, // 1 hour\n    }\n  );\n\n  const basePlugins = intlayer({\n    ...options,\n    compatCallers: [\n      ...(options?.compatCallers ?? []),\n      ...USE_INTL_COMPAT_CALLERS,\n    ],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-use-intl-compat-plugin',\n    config: () => ({\n      resolve: {\n        alias: {\n          'use-intl': '@intlayer/use-intl',\n        },\n      },\n    }),\n  };\n\n  return [\n    ...(Array.isArray(basePlugins) ? basePlugins : [basePlugins]),\n    compatPlugin,\n  ];\n};\n\nexport default useIntlVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,0BAAgD,CACpD;CACE,YAAY;CACZ,eAAe;EAAC;EAAY;EAAkB;EAAqB;CACnE,WAAW;EAAE,MAAM;EAAY,OAAO;EAAG;CACzC,qBAAqB;CACtB,EACD;CACE,YAAY;CACZ,eAAe;EAAC;EAAY;EAAiB;EAAqB;CAClE,WAAW;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa;CACtE,qBAAqB;CACtB,CACF;;;;;;;;;;;;;;;AAgBD,MAAa,qBACX,YACmB;CACnB,MAAM,iBAAiB,kBAAkB;CACzC,MAAM,YAAY,aAAa,eAAe;AAE9C,SACE,KACE,eAAe,OAAO,SACtB,aACA,SACA,kCACD,QACK;AACJ,YAAU,CACR,SACE,+CACA,WAAW,KACZ,EACD,SACE,iDACA,WAAW,WACZ,CACF,CAAC;IAEJ,EACE,gBAAgB,MAAO,KAAK,IAC7B,CACF;CAED,MAAM,cAAc,SAAS;EAC3B,GAAG;EACH,eAAe,CACb,GAAI,SAAS,iBAAiB,EAAE,EAChC,GAAG,wBACJ;EACF,CAAC;CAEF,MAAM,eAA6B;EACjC,MAAM;EACN,eAAe,EACb,SAAS,EACP,OAAO,EACL,YAAY,sBACb,EACF,EACF;EACF;AAED,QAAO,CACL,GAAI,MAAM,QAAQ,YAAY,GAAG,cAAc,CAAC,YAAY,EAC5D,aACD"}

package/dist/esm/react/IntlProvider.mjs

@@ -0,0 +1,28 @@
+'use client';
+
+import { IntlayerProvider } from "react-intlayer";
+import { jsx } from "react/jsx-runtime";
+import { log } from "@intlayer/config/built";
+import { CYAN } from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+
+//#region src/react/IntlProvider.tsx
+/**
+* Drop-in for use-intl's `IntlProvider`.
+*
+* Wraps Intlayer's `IntlayerProvider`, seeding the client locale from the
+* `locale` prop. `messages`, `formats`, `now`, `timeZone`, `onError`, and
+* `getMessageFallback` are accepted for API compatibility but have no effect —
+* Intlayer uses its own compiled dictionaries.
+*/
+const IntlProvider = ({ locale, children, messages: _messages, formats: _formats, now: _now, timeZone: _timeZone, onError: _onError, getMessageFallback: _getMessageFallback }) => {
+	if (typeof _messages !== "undefined") getAppLogger({ log })(`${colorize("IntlProvider", CYAN)} do not pass the messages prop with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`);
+	return /* @__PURE__ */ jsx(IntlayerProvider, {
+		locale,
+		children
+	}, String(locale));
+};
+
+//#endregion
+export { IntlProvider };
+//# sourceMappingURL=IntlProvider.mjs.map

package/dist/esm/react/IntlProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntlProvider.mjs","names":[],"sources":["../../../src/react/IntlProvider.tsx"],"sourcesContent":["'use client';\n\nimport { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { IntlayerProvider } from 'react-intlayer';\nimport type { ComponentProps } from 'react';\nimport type { IntlProvider as _IntlProvider } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `IntlProvider`.\n *\n * Wraps Intlayer's `IntlayerProvider`, seeding the client locale from the\n * `locale` prop. `messages`, `formats`, `now`, `timeZone`, `onError`, and\n * `getMessageFallback` are accepted for API compatibility but have no effect —\n * Intlayer uses its own compiled dictionaries.\n */\nexport const IntlProvider: typeof _IntlProvider = ({\n  locale,\n  children,\n  messages: _messages,\n  formats: _formats,\n  now: _now,\n  timeZone: _timeZone,\n  onError: _onError,\n  getMessageFallback: _getMessageFallback,\n}) => {\n  if (\n    process.env.NODE_ENV === 'development' &&\n    typeof _messages !== 'undefined'\n  ) {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('IntlProvider', CYAN)} do not pass the messages prop with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  // `key={locale}` re-seeds the client locale context when the locale changes,\n  // so consumers re-render in the new language.\n  return (\n    <IntlayerProvider\n      key={String(locale)}\n      locale={locale as LocalesValues}\n    >\n      {children}\n    </IntlayerProvider>\n  );\n};\n\n/**\n * Props accepted by {@link IntlProvider}. `messages` is deprecated — Intlayer\n * loads content from compiled dictionaries automatically.\n */\nexport type IntlProviderProps = Omit<\n  ComponentProps<typeof _IntlProvider>,\n  'messages' | 'locale'\n> & {\n  /**\n   * @deprecated has no use case with intlayer. Messages are loaded\n   * automatically under the hood for bundle optimization reason.\n   */\n  messages?: never;\n  /** The active locale. */\n  locale: LocalesValues;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,MAAa,gBAAsC,EACjD,QACA,UACA,UAAU,WACV,SAAS,UACT,KAAK,MACL,UAAU,WACV,SAAS,UACT,oBAAoB,0BAChB;AACJ,KAEE,OAAO,cAAc,YAGrB,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,gBAAgB,KAAK,CAAC,+HACnC;AAKH,QACE,oBAAC,kBAAD;EAEU;EAEP;EACgB,EAJZ,OAAO,OAAO,CAIF"}

package/dist/esm/react/helpers.mjs

@@ -0,0 +1,44 @@
+'use client';
+
+import { buildIntlFormatter } from "../shared/intlFormatter.mjs";
+import { useLocale } from "react-intlayer";
+import { log } from "@intlayer/config/built";
+import { CYAN } from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+
+//#region src/react/helpers.ts
+/**
+* Drop-in for use-intl's `useNow`.
+* Returns the current `Date`. The `updateInterval` option is ignored.
+*/
+const useNow = () => /* @__PURE__ */ new Date();
+/**
+* Drop-in for use-intl's `useTimeZone`.
+* Returns the system time zone resolved from `Intl.DateTimeFormat`.
+*/
+const useTimeZone = () => Intl.DateTimeFormat().resolvedOptions().timeZone;
+/**
+* Drop-in for use-intl's `useMessages`.
+*
+* @deprecated useMessages has no use case with intlayer.
+* Messages are loaded automatically under the hood.
+* @returns An empty object.
+*/
+const useMessages = () => {
+	getAppLogger({ log })(`${colorize("useMessages", CYAN)} has no use case with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`);
+	return {};
+};
+/**
+* Drop-in for use-intl's `useFormatter`.
+* Returns locale-aware formatters backed by the native `Intl.*` APIs:
+* `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and
+* `displayName`.
+*/
+const useFormatter = () => {
+	const { locale } = useLocale();
+	return buildIntlFormatter(locale ?? "en");
+};
+
+//#endregion
+export { useFormatter, useMessages, useNow, useTimeZone };
+//# sourceMappingURL=helpers.mjs.map

package/dist/esm/react/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":["useLocaleIntlayer"],"sources":["../../../src/react/helpers.ts"],"sourcesContent":["'use client';\n\nimport { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { useLocale as useLocaleIntlayer } from 'react-intlayer';\nimport type {\n  useFormatter as _useFormatter,\n  useMessages as _useMessages,\n  useNow as _useNow,\n  useTimeZone as _useTimeZone,\n} from 'use-intl';\nimport { buildIntlFormatter } from '../shared/intlFormatter';\n\n/**\n * Drop-in for use-intl's `useNow`.\n * Returns the current `Date`. The `updateInterval` option is ignored.\n */\nexport const useNow: typeof _useNow = () => new Date();\n\n/**\n * Drop-in for use-intl's `useTimeZone`.\n * Returns the system time zone resolved from `Intl.DateTimeFormat`.\n */\nexport const useTimeZone: typeof _useTimeZone = () =>\n  Intl.DateTimeFormat().resolvedOptions().timeZone;\n\n/**\n * Drop-in for use-intl's `useMessages`.\n *\n * @deprecated useMessages has no use case with intlayer.\n * Messages are loaded automatically under the hood.\n * @returns An empty object.\n */\nexport const useMessages: typeof _useMessages = () => {\n  if (process.env.NODE_ENV === 'development') {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('useMessages', CYAN)} has no use case with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return {} as ReturnType<typeof _useMessages>;\n};\n\n/**\n * Drop-in for use-intl's `useFormatter`.\n * Returns locale-aware formatters backed by the native `Intl.*` APIs:\n * `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and\n * `displayName`.\n */\nexport const useFormatter: typeof _useFormatter = () => {\n  const { locale } = useLocaleIntlayer();\n  return buildIntlFormatter((locale as string) ?? 'en');\n};\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAa,+BAA+B,IAAI,MAAM;;;;;AAMtD,MAAa,oBACX,KAAK,gBAAgB,CAAC,iBAAiB,CAAC;;;;;;;;AAS1C,MAAa,oBAAyC;AAGlD,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,eAAe,KAAK,CAAC,iHAClC;AAGH,QAAO,EAAE;;;;;;;;AASX,MAAa,qBAA2C;CACtD,MAAM,EAAE,WAAWA,WAAmB;AACtC,QAAO,mBAAoB,UAAqB,KAAK"}

package/dist/esm/react/index.mjs

@@ -0,0 +1,17 @@
+import { useDictionaryDynamic } from "../useDictionaryDynamic.mjs";
+import { IntlProvider } from "./IntlProvider.mjs";
+import { useFormatter, useMessages, useNow, useTimeZone } from "./helpers.mjs";
+import { useLocale } from "./useLocale.mjs";
+import { useTranslations } from "./useTranslations.mjs";
+import { useDictionary } from "../useDictionary.mjs";
+
+//#region src/react/index.ts
+/**
+* @internal Private use-intl export, kept so aliased `_useExtracted` imports
+* resolve. Not part of the supported public surface.
+*/
+const _useExtracted = () => ({});
+
+//#endregion
+export { IntlProvider, _useExtracted, useDictionary, useDictionaryDynamic, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/react/index.ts"],"sourcesContent":["export { IntlProvider, type IntlProviderProps } from './IntlProvider';\nexport { useFormatter, useMessages, useNow, useTimeZone } from './helpers';\nexport { useLocale } from './useLocale';\nexport { useTranslations } from './useTranslations';\nexport { useDictionary } from '../useDictionary';\nexport { useDictionaryDynamic } from '../useDictionaryDynamic';\n\n/**\n * @internal Private use-intl export, kept so aliased `_useExtracted` imports\n * resolve. Not part of the supported public surface.\n */\nexport const _useExtracted = (): Record<string, never> => ({});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,uBAA8C,EAAE"}

package/dist/esm/react/useLocale.mjs

@@ -0,0 +1,18 @@
+'use client';
+
+import { useLocale as useLocale$1 } from "react-intlayer";
+
+//#region src/react/useLocale.ts
+/**
+* Drop-in for use-intl's `useLocale`.
+*
+* Returns the active locale string from Intlayer's client context.
+*/
+const useLocale = () => {
+	const { locale } = useLocale$1();
+	return locale;
+};
+
+//#endregion
+export { useLocale };
+//# sourceMappingURL=useLocale.mjs.map

package/dist/esm/react/useLocale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocale.mjs","names":["useLocaleIntlayer"],"sources":["../../../src/react/useLocale.ts"],"sourcesContent":["'use client';\n\nimport { useLocale as useLocaleIntlayer } from 'react-intlayer';\nimport type { useLocale as _useLocale } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `useLocale`.\n *\n * Returns the active locale string from Intlayer's client context.\n */\nexport const useLocale: typeof _useLocale = () => {\n  const { locale } = useLocaleIntlayer();\n  return locale as ReturnType<typeof _useLocale>;\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,kBAAqC;CAChD,MAAM,EAAE,WAAWA,aAAmB;AACtC,QAAO"}

package/dist/esm/react/useTranslations.mjs

@@ -0,0 +1,37 @@
+'use client';
+
+import { createNamespaceTranslator } from "../shared/namespaceTranslator.mjs";
+import { IntlayerClientContext } from "react-intlayer";
+import { useContext, useMemo } from "react";
+
+//#region src/react/useTranslations.ts
+/**
+* Drop-in for use-intl's `useTranslations`.
+*
+* Messages support ICU MessageFormat syntax: simple arguments (`{name}`),
+* plural (`{count, plural, one {…} other {…}}`, `#`), select, and formatted
+* arguments (`{value, number}`). Rich text is available through `t.rich()`
+* and `t.markup()`.
+*
+* @example
+* ```tsx
+* const t = useTranslations('about');
+* t('counter.label'); // ✓ typed
+* t('items', { count: 3 }); // ICU plural
+*
+* // Scoped to a nested object (use-intl idiom)
+* const t = useTranslations('about.counter');
+* t('label'); // resolves about → counter.label
+*
+* // Rich text
+* t.rich('terms', { link: (chunks) => <a href="/terms">{chunks}</a> });
+* ```
+*/
+const useTranslations = ((namespace) => {
+	const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};
+	return useMemo(() => createNamespaceTranslator(currentLocale, namespace), [currentLocale, namespace]);
+});
+
+//#endregion
+export { useTranslations };
+//# sourceMappingURL=useTranslations.mjs.map

package/dist/esm/react/useTranslations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslations.mjs","names":[],"sources":["../../../src/react/useTranslations.ts"],"sourcesContent":["'use client';\n\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { IntlayerClientContext } from 'react-intlayer';\nimport { useContext, useMemo } from 'react';\nimport { createNamespaceTranslator } from '../shared/namespaceTranslator';\nimport type {\n  LooseTranslateFunction,\n  TranslateFunction,\n} from '../shared/translateFunctionTypes';\n\n/**\n * Overload set for {@link useTranslations}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    `string` paths, matching use-intl's scoped-namespace behaviour.\n * 3. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype UseTranslations = {\n  <N extends DictionaryKeys>(namespace: N): TranslateFunction<N>;\n  (namespace: `${string}.${string}`): LooseTranslateFunction;\n  (): LooseTranslateFunction;\n};\n\n/**\n * Drop-in for use-intl's `useTranslations`.\n *\n * Messages support ICU MessageFormat syntax: simple arguments (`{name}`),\n * plural (`{count, plural, one {…} other {…}}`, `#`), select, and formatted\n * arguments (`{value, number}`). Rich text is available through `t.rich()`\n * and `t.markup()`.\n *\n * @example\n * ```tsx\n * const t = useTranslations('about');\n * t('counter.label'); // ✓ typed\n * t('items', { count: 3 }); // ICU plural\n *\n * // Scoped to a nested object (use-intl idiom)\n * const t = useTranslations('about.counter');\n * t('label'); // resolves about → counter.label\n *\n * // Rich text\n * t.rich('terms', { link: (chunks) => <a href=\"/terms\">{chunks}</a> });\n * ```\n */\nexport const useTranslations = ((namespace?: string) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  return useMemo(\n    () => createNamespaceTranslator(currentLocale as LocalesValues, namespace),\n    [currentLocale, namespace]\n  );\n}) as UseTranslations;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,oBAAoB,cAAuB;CACtD,MAAM,EAAE,QAAQ,kBAAkB,WAAW,sBAAsB,IAAI,EAAE;AAEzE,QAAO,cACC,0BAA0B,eAAgC,UAAU,EAC1E,CAAC,eAAe,UAAU,CAC3B"}

package/dist/esm/shared/intlFormatter.mjs

@@ -0,0 +1,61 @@
+//#region src/shared/intlFormatter.ts
+/** Time units orderable by their duration in seconds. */
+const RELATIVE_TIME_UNITS = [
+	["year", 31536e3],
+	["month", 2628e3],
+	["week", 604800],
+	["day", 86400],
+	["hour", 3600],
+	["minute", 60],
+	["second", 1]
+];
+const toDate = (value) => value instanceof Date ? value : new Date(value);
+/**
+* Builds a use-intl compatible formatter backed by the native `Intl.*` APIs
+* for the given locale.
+*
+* Shared by `useFormatter` (React hook) and `createFormatter` (non-React core).
+*
+* @param locale - The locale used by every `Intl.*` formatter instance.
+* @returns A formatter exposing `dateTime`, `number`, `dateTimeRange`,
+*   `relativeTime`, `list`, and `displayName`.
+*/
+const buildIntlFormatter = (locale) => ({
+	dateTime: (value, options) => new Intl.DateTimeFormat(locale, options).format(value),
+	number: (value, options) => new Intl.NumberFormat(locale, options).format(value),
+	/** Formats a date range with `Intl.DateTimeFormat#formatRange`. */
+	dateTimeRange: (start, end, options) => new Intl.DateTimeFormat(locale, options).formatRange(toDate(start), toDate(end)),
+	/**
+	* Formats a date relative to now (or a reference date), automatically
+	* selecting the largest fitting unit.
+	*/
+	relativeTime: (date, nowOrOptions) => {
+		const options = nowOrOptions instanceof Date || typeof nowOrOptions === "number" ? { now: nowOrOptions } : nowOrOptions ?? {};
+		const nowDate = options.now !== void 0 ? toDate(options.now) : /* @__PURE__ */ new Date();
+		const diffInSeconds = (toDate(date).getTime() - nowDate.getTime()) / 1e3;
+		let unit = options.unit;
+		if (!unit) {
+			const absoluteDiff = Math.abs(diffInSeconds);
+			unit = RELATIVE_TIME_UNITS.find(([, unitSeconds]) => absoluteDiff >= unitSeconds)?.[0] ?? "second";
+		}
+		const unitSeconds = RELATIVE_TIME_UNITS.find(([unitName]) => unitName === unit)?.[1] ?? 1;
+		return new Intl.RelativeTimeFormat(locale, {
+			numeric: "auto",
+			style: options.style
+		}).format(Math.round(diffInSeconds / unitSeconds), unit);
+	},
+	/** Formats a list with `Intl.ListFormat`. */
+	list: (value, options) => new Intl.ListFormat(locale, options).format(value),
+	displayName: (value, optionsOrFormat, extraOptions) => {
+		const resolvedOptions = typeof optionsOrFormat === "string" ? extraOptions : optionsOrFormat;
+		try {
+			return new Intl.DisplayNames([locale], resolvedOptions ?? { type: "language" }).of(value) ?? value;
+		} catch {
+			return value;
+		}
+	}
+});
+
+//#endregion
+export { buildIntlFormatter };
+//# sourceMappingURL=intlFormatter.mjs.map

package/dist/esm/shared/intlFormatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intlFormatter.mjs","names":[],"sources":["../../../src/shared/intlFormatter.ts"],"sourcesContent":["import type { createFormatter as _createFormatter } from 'use-intl';\n\n/** The formatter object shape exposed by use-intl. */\nexport type Formatter = ReturnType<typeof _createFormatter>;\n\n/** Time units orderable by their duration in seconds. */\nconst RELATIVE_TIME_UNITS: [Intl.RelativeTimeFormatUnit, number][] = [\n  ['year', 31536000],\n  ['month', 2628000],\n  ['week', 604800],\n  ['day', 86400],\n  ['hour', 3600],\n  ['minute', 60],\n  ['second', 1],\n];\n\nconst toDate = (value: Date | number | string): Date =>\n  value instanceof Date ? value : new Date(value);\n\n/**\n * Builds a use-intl compatible formatter backed by the native `Intl.*` APIs\n * for the given locale.\n *\n * Shared by `useFormatter` (React hook) and `createFormatter` (non-React core).\n *\n * @param locale - The locale used by every `Intl.*` formatter instance.\n * @returns A formatter exposing `dateTime`, `number`, `dateTimeRange`,\n *   `relativeTime`, `list`, and `displayName`.\n */\nexport const buildIntlFormatter = (locale: string): Formatter =>\n  ({\n    dateTime: (value: Date | number, options?: Intl.DateTimeFormatOptions) =>\n      new Intl.DateTimeFormat(locale, options).format(value),\n\n    number: (value: number | bigint, options?: Intl.NumberFormatOptions) =>\n      new Intl.NumberFormat(locale, options).format(value),\n\n    /** Formats a date range with `Intl.DateTimeFormat#formatRange`. */\n    dateTimeRange: (\n      start: Date | number,\n      end: Date | number,\n      options?: Intl.DateTimeFormatOptions\n    ) =>\n      new Intl.DateTimeFormat(locale, options).formatRange(\n        toDate(start),\n        toDate(end)\n      ),\n\n    /**\n     * Formats a date relative to now (or a reference date), automatically\n     * selecting the largest fitting unit.\n     */\n    relativeTime: (\n      date: Date | number | string,\n      nowOrOptions?:\n        | Date\n        | number\n        | {\n            now?: Date | number;\n            unit?: Intl.RelativeTimeFormatUnit;\n            style?: Intl.RelativeTimeFormatStyle;\n            numberingSystem?: string;\n          }\n    ) => {\n      const options =\n        nowOrOptions instanceof Date || typeof nowOrOptions === 'number'\n          ? { now: nowOrOptions }\n          : (nowOrOptions ?? {});\n\n      const nowDate =\n        options.now !== undefined ? toDate(options.now) : new Date();\n      const diffInSeconds = (toDate(date).getTime() - nowDate.getTime()) / 1000;\n\n      let unit = options.unit;\n      if (!unit) {\n        const absoluteDiff = Math.abs(diffInSeconds);\n        unit =\n          RELATIVE_TIME_UNITS.find(\n            ([, unitSeconds]) => absoluteDiff >= unitSeconds\n          )?.[0] ?? 'second';\n      }\n\n      const unitSeconds =\n        RELATIVE_TIME_UNITS.find(([unitName]) => unitName === unit)?.[1] ?? 1;\n\n      return new Intl.RelativeTimeFormat(locale, {\n        numeric: 'auto',\n        style: options.style,\n      }).format(Math.round(diffInSeconds / unitSeconds), unit);\n    },\n\n    /** Formats a list with `Intl.ListFormat`. */\n    list: (value: Iterable<string>, options?: Intl.ListFormatOptions): string =>\n      new Intl.ListFormat(locale, options).format(value),\n\n    displayName: (\n      value: string,\n      optionsOrFormat?: Intl.DisplayNamesOptions | string,\n      extraOptions?: Intl.DisplayNamesOptions\n    ): string => {\n      const resolvedOptions =\n        typeof optionsOrFormat === 'string' ? extraOptions : optionsOrFormat;\n      try {\n        return (\n          new Intl.DisplayNames(\n            [locale],\n            resolvedOptions ?? { type: 'language' }\n          ).of(value) ?? value\n        );\n      } catch {\n        return value;\n      }\n    },\n  }) as unknown as Formatter;\n"],"mappings":";;AAMA,MAAM,sBAA+D;CACnE,CAAC,QAAQ,QAAS;CAClB,CAAC,SAAS,OAAQ;CAClB,CAAC,QAAQ,OAAO;CAChB,CAAC,OAAO,MAAM;CACd,CAAC,QAAQ,KAAK;CACd,CAAC,UAAU,GAAG;CACd,CAAC,UAAU,EAAE;CACd;AAED,MAAM,UAAU,UACd,iBAAiB,OAAO,QAAQ,IAAI,KAAK,MAAM;;;;;;;;;;;AAYjD,MAAa,sBAAsB,YAChC;CACC,WAAW,OAAsB,YAC/B,IAAI,KAAK,eAAe,QAAQ,QAAQ,CAAC,OAAO,MAAM;CAExD,SAAS,OAAwB,YAC/B,IAAI,KAAK,aAAa,QAAQ,QAAQ,CAAC,OAAO,MAAM;;CAGtD,gBACE,OACA,KACA,YAEA,IAAI,KAAK,eAAe,QAAQ,QAAQ,CAAC,YACvC,OAAO,MAAM,EACb,OAAO,IAAI,CACZ;;;;;CAMH,eACE,MACA,iBASG;EACH,MAAM,UACJ,wBAAwB,QAAQ,OAAO,iBAAiB,WACpD,EAAE,KAAK,cAAc,GACpB,gBAAgB,EAAE;EAEzB,MAAM,UACJ,QAAQ,QAAQ,SAAY,OAAO,QAAQ,IAAI,mBAAG,IAAI,MAAM;EAC9D,MAAM,iBAAiB,OAAO,KAAK,CAAC,SAAS,GAAG,QAAQ,SAAS,IAAI;EAErE,IAAI,OAAO,QAAQ;AACnB,MAAI,CAAC,MAAM;GACT,MAAM,eAAe,KAAK,IAAI,cAAc;AAC5C,UACE,oBAAoB,MACjB,GAAG,iBAAiB,gBAAgB,YACtC,GAAG,MAAM;;EAGd,MAAM,cACJ,oBAAoB,MAAM,CAAC,cAAc,aAAa,KAAK,GAAG,MAAM;AAEtE,SAAO,IAAI,KAAK,mBAAmB,QAAQ;GACzC,SAAS;GACT,OAAO,QAAQ;GAChB,CAAC,CAAC,OAAO,KAAK,MAAM,gBAAgB,YAAY,EAAE,KAAK;;;CAI1D,OAAO,OAAyB,YAC9B,IAAI,KAAK,WAAW,QAAQ,QAAQ,CAAC,OAAO,MAAM;CAEpD,cACE,OACA,iBACA,iBACW;EACX,MAAM,kBACJ,OAAO,oBAAoB,WAAW,eAAe;AACvD,MAAI;AACF,UACE,IAAI,KAAK,aACP,CAAC,OAAO,EACR,mBAAmB,EAAE,MAAM,YAAY,CACxC,CAAC,GAAG,MAAM,IAAI;UAEX;AACN,UAAO;;;CAGZ"}

package/dist/esm/shared/namespaceTranslator.mjs

@@ -0,0 +1,119 @@
+import { getIntlayer } from "@intlayer/core/interpreter";
+import { parseTaggedMessage, resolveMessage } from "@intlayer/core/messageFormat";
+import { Fragment } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+
+//#region src/shared/namespaceTranslator.tsx
+/**
+* Reads a dotted `path` (e.g. `counter.label`) out of a nested object value.
+*
+* @param objectValue - The object to read from.
+* @param path - Dot-separated path. An empty path returns `objectValue`.
+* @returns The value found at `path`, or `undefined` when any segment is absent.
+*/
+const navigatePath = (objectValue, path) => {
+	if (!path) return objectValue;
+	const parts = path.split(".");
+	let current = objectValue;
+	for (const part of parts) {
+		if (current === null || current === void 0 || typeof current !== "object") return;
+		current = current[part];
+	}
+	return current;
+};
+/** Splits rich values into scalar interpolation values and tag renderers. */
+const splitRichValues = (values = {}) => {
+	const scalarValues = {};
+	const renderers = {};
+	for (const [valueKey, value] of Object.entries(values)) if (typeof value === "function") renderers[valueKey] = value;
+	else scalarValues[valueKey] = value;
+	return {
+		scalarValues,
+		renderers
+	};
+};
+const renderRichTokens = (tokens, renderers) => tokens.map((token, tokenIndex) => {
+	if (typeof token === "string") return token;
+	const children = renderRichTokens(token.children, renderers);
+	const renderer = renderers[token.tag];
+	if (typeof renderer === "function") return /* @__PURE__ */ jsx(Fragment, { children: renderer(children) }, tokenIndex);
+	return /* @__PURE__ */ jsx(Fragment, { children }, tokenIndex);
+});
+const renderMarkupTokens = (tokens, renderers) => tokens.map((token) => {
+	if (typeof token === "string") return token;
+	const children = renderMarkupTokens(token.children, renderers);
+	const renderer = renderers[token.tag];
+	if (typeof renderer === "function") return renderer(children);
+	return children;
+}).join("");
+/**
+* The untyped runtime translator shared by `useTranslations` (React hook) and
+* `createTranslator` (non-React core).
+*
+* Behaviour matches use-intl / next-intl:
+* - namespace `'about'` → keys resolved inside the `about` dictionary
+* - namespace `'about.counter'` → dictionary `about`, key prefix `counter`
+* - no namespace → the first segment of each key is the dictionary key
+* - messages support ICU syntax (plural, select, `#`, formatted arguments)
+* - `t.rich` / `t.markup` map `<tag>chunks</tag>` through the provided
+*   renderers; `t.raw` returns the raw value; `t.has` checks existence
+*
+* @param locale - The locale dictionaries are resolved for.
+* @param namespace - Optional dictionary key, optionally with a nested scope.
+* @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.
+*/
+const createNamespaceTranslator = (locale, namespace) => {
+	const [dictionaryKey, ...prefixSegments] = (namespace ?? "").split(".");
+	const keyPrefix = prefixSegments.join(".");
+	const lookup = (key) => {
+		let targetDictionaryKey = dictionaryKey;
+		let path = keyPrefix ? `${keyPrefix}.${key}` : key;
+		if (!targetDictionaryKey) {
+			const [firstSegment, ...restSegments] = key.split(".");
+			targetDictionaryKey = firstSegment;
+			path = restSegments.join(".");
+		}
+		try {
+			return navigatePath(getIntlayer(targetDictionaryKey, locale), path);
+		} catch {
+			return;
+		}
+	};
+	const resolveToString = (key, values = {}) => {
+		const rawValue = lookup(key);
+		if (rawValue === null || rawValue === void 0) return void 0;
+		return resolveMessage(rawValue, values, locale, "icu");
+	};
+	const missingKeyFallback = (key) => namespace ? `${namespace}.${key}` : key;
+	const translate = (key, values) => resolveToString(key, values) ?? missingKeyFallback(key);
+	return Object.assign(translate, {
+		/** Returns `true` if the given key exists in the namespace. */
+		has: (key) => lookup(key) !== void 0,
+		/** Returns the raw unprocessed content for the given key. */
+		raw: (key) => lookup(key),
+		/**
+		* Resolves a message containing `<tag>chunks</tag>` markup, mapping each
+		* tag through the matching renderer in `values`.
+		*/
+		rich: (key, values) => {
+			const { scalarValues, renderers } = splitRichValues(values);
+			const message = resolveToString(key, scalarValues);
+			if (message === void 0) return missingKeyFallback(key);
+			return /* @__PURE__ */ jsx(Fragment$1, { children: renderRichTokens(parseTaggedMessage(message), renderers) });
+		},
+		/**
+		* Resolves a message containing `<tag>chunks</tag>` markup into a string,
+		* mapping each tag through the matching string renderer in `values`.
+		*/
+		markup: (key, values) => {
+			const { scalarValues, renderers } = splitRichValues(values);
+			const message = resolveToString(key, scalarValues);
+			if (message === void 0) return missingKeyFallback(key);
+			return renderMarkupTokens(parseTaggedMessage(message), renderers);
+		}
+	});
+};
+
+//#endregion
+export { createNamespaceTranslator, navigatePath };
+//# sourceMappingURL=namespaceTranslator.mjs.map