@intlayer/use-intl 9.0.0-canary.2

package/dist/cjs/plugin/index.cjs

@@ -0,0 +1,80 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _intlayer_config_colors = require("@intlayer/config/colors");
+_intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
+let _intlayer_config_logger = require("@intlayer/config/logger");
+let node_path = require("node:path");
+let _intlayer_chokidar_utils = require("@intlayer/chokidar/utils");
+let _intlayer_config_node = require("@intlayer/config/node");
+let vite_intlayer = require("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 = (0, _intlayer_config_node.getConfiguration)();
+	const appLogger = (0, _intlayer_config_logger.getAppLogger)(intlayerConfig);
+	(0, _intlayer_chokidar_utils.runOnce)((0, node_path.join)(intlayerConfig.system.baseDir, ".intlayer", "cache", "intlayer-issues-invitation.lock"), () => {
+		appLogger([(0, _intlayer_config_logger.colorize)("Please report any issues you met on GitHub:", _intlayer_config_colors.GREY), (0, _intlayer_config_logger.colorize)("https://github.com/aymericzip/intlayer/issues", _intlayer_config_colors.GREY_LIGHT)]);
+	}, { cacheTimeoutMs: 1e3 * 60 * 60 });
+	const basePlugins = (0, vite_intlayer.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
+exports.default = useIntlVitePlugin;
+exports.useIntlVitePlugin = useIntlVitePlugin;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/plugin/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ANSIColors"],"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,8DAAmC;CACzC,MAAM,sDAAyB,eAAe;AAE9C,2DAEI,eAAe,OAAO,SACtB,aACA,SACA,kCACD,QACK;AACJ,YAAU,uCAEN,+CACAA,wBAAW,KACZ,wCAEC,iDACAA,wBAAW,WACZ,CACF,CAAC;IAEJ,EACE,gBAAgB,MAAO,KAAK,IAC7B,CACF;CAED,MAAM,0CAAuB;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/cjs/react/IntlProvider.cjs

@@ -0,0 +1,30 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let react_intlayer = require("react-intlayer");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _intlayer_config_built = require("@intlayer/config/built");
+let _intlayer_config_colors = require("@intlayer/config/colors");
+let _intlayer_config_logger = require("@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 (process.env.NODE_ENV === "development" && typeof _messages !== "undefined") (0, _intlayer_config_logger.getAppLogger)({ log: _intlayer_config_built.log })(`${(0, _intlayer_config_logger.colorize)("IntlProvider", _intlayer_config_colors.CYAN)} do not pass the messages prop with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_intlayer.IntlayerProvider, {
+		locale,
+		children
+	}, String(locale));
+};
+
+//#endregion
+exports.IntlProvider = IntlProvider;
+//# sourceMappingURL=IntlProvider.cjs.map

package/dist/cjs/react/IntlProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntlProvider.cjs","names":["CYAN","IntlayerProvider"],"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,KACE,QAAQ,IAAI,aAAa,iBACzB,OAAO,cAAc,YAGrB,2CAD+B,EAAE,iCAAK,CAC7B,CACP,yCAAY,gBAAgBA,6BAAK,CAAC,+HACnC;AAKH,QACE,2CAACC,iCAAD;EAEU;EAEP;EACgB,EAJZ,OAAO,OAAO,CAIF"}

package/dist/cjs/react/helpers.cjs

@@ -0,0 +1,49 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_shared_intlFormatter = require('../shared/intlFormatter.cjs');
+let react_intlayer = require("react-intlayer");
+let _intlayer_config_built = require("@intlayer/config/built");
+let _intlayer_config_colors = require("@intlayer/config/colors");
+let _intlayer_config_logger = require("@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 = () => {
+	if (process.env.NODE_ENV === "development") (0, _intlayer_config_logger.getAppLogger)({ log: _intlayer_config_built.log })(`${(0, _intlayer_config_logger.colorize)("useMessages", _intlayer_config_colors.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 } = (0, react_intlayer.useLocale)();
+	return require_shared_intlFormatter.buildIntlFormatter(locale ?? "en");
+};
+
+//#endregion
+exports.useFormatter = useFormatter;
+exports.useMessages = useMessages;
+exports.useNow = useNow;
+exports.useTimeZone = useTimeZone;
+//# sourceMappingURL=helpers.cjs.map

package/dist/cjs/react/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":["CYAN","buildIntlFormatter"],"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;AACpD,KAAI,QAAQ,IAAI,aAAa,cAE3B,2CAD+B,EAAE,iCAAK,CAC7B,CACP,yCAAY,eAAeA,6BAAK,CAAC,iHAClC;AAGH,QAAO,EAAE;;;;;;;;AASX,MAAa,qBAA2C;CACtD,MAAM,EAAE,0CAA8B;AACtC,QAAOC,gDAAoB,UAAqB,KAAK"}

package/dist/cjs/react/index.cjs

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_useDictionaryDynamic = require('../useDictionaryDynamic.cjs');
+const require_react_IntlProvider = require('./IntlProvider.cjs');
+const require_react_helpers = require('./helpers.cjs');
+const require_react_useLocale = require('./useLocale.cjs');
+const require_react_useTranslations = require('./useTranslations.cjs');
+const require_useDictionary = require('../useDictionary.cjs');
+
+//#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
+exports.IntlProvider = require_react_IntlProvider.IntlProvider;
+exports._useExtracted = _useExtracted;
+exports.useDictionary = require_useDictionary.useDictionary;
+exports.useDictionaryDynamic = require_useDictionaryDynamic.useDictionaryDynamic;
+exports.useFormatter = require_react_helpers.useFormatter;
+exports.useLocale = require_react_useLocale.useLocale;
+exports.useMessages = require_react_helpers.useMessages;
+exports.useNow = require_react_helpers.useNow;
+exports.useTimeZone = require_react_helpers.useTimeZone;
+exports.useTranslations = require_react_useTranslations.useTranslations;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","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/cjs/react/useLocale.cjs

@@ -0,0 +1,20 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let react_intlayer = require("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 } = (0, react_intlayer.useLocale)();
+	return locale;
+};
+
+//#endregion
+exports.useLocale = useLocale;
+//# sourceMappingURL=useLocale.cjs.map

package/dist/cjs/react/useLocale.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocale.cjs","names":[],"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,0CAA8B;AACtC,QAAO"}

package/dist/cjs/react/useTranslations.cjs

@@ -0,0 +1,39 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_shared_namespaceTranslator = require('../shared/namespaceTranslator.cjs');
+let react_intlayer = require("react-intlayer");
+let react = require("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 } = (0, react.useContext)(react_intlayer.IntlayerClientContext) ?? {};
+	return (0, react.useMemo)(() => require_shared_namespaceTranslator.createNamespaceTranslator(currentLocale, namespace), [currentLocale, namespace]);
+});
+
+//#endregion
+exports.useTranslations = useTranslations;
+//# sourceMappingURL=useTranslations.cjs.map

package/dist/cjs/react/useTranslations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslations.cjs","names":["IntlayerClientContext","createNamespaceTranslator"],"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,wCAA6BA,qCAAsB,IAAI,EAAE;AAEzE,iCACQC,6DAA0B,eAAgC,UAAU,EAC1E,CAAC,eAAe,UAAU,CAC3B"}

package/dist/cjs/shared/intlFormatter.cjs

@@ -0,0 +1,63 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#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
+exports.buildIntlFormatter = buildIntlFormatter;
+//# sourceMappingURL=intlFormatter.cjs.map

package/dist/cjs/shared/intlFormatter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intlFormatter.cjs","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/cjs/shared/namespaceTranslator.cjs

@@ -0,0 +1,122 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
+let _intlayer_core_messageFormat = require("@intlayer/core/messageFormat");
+let react = require("react");
+let react_jsx_runtime = require("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__ */ (0, react_jsx_runtime.jsx)(react.Fragment, { children: renderer(children) }, tokenIndex);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.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((0, _intlayer_core_interpreter.getIntlayer)(targetDictionaryKey, locale), path);
+		} catch {
+			return;
+		}
+	};
+	const resolveToString = (key, values = {}) => {
+		const rawValue = lookup(key);
+		if (rawValue === null || rawValue === void 0) return void 0;
+		return (0, _intlayer_core_messageFormat.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__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: renderRichTokens((0, _intlayer_core_messageFormat.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((0, _intlayer_core_messageFormat.parseTaggedMessage)(message), renderers);
+		}
+	});
+};
+
+//#endregion
+exports.createNamespaceTranslator = createNamespaceTranslator;
+exports.navigatePath = navigatePath;
+//# sourceMappingURL=namespaceTranslator.cjs.map

package/dist/cjs/shared/namespaceTranslator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaceTranslator.cjs","names":["Fragment"],"sources":["../../../src/shared/namespaceTranslator.tsx"],"sourcesContent":["import { getIntlayer } from '@intlayer/core/interpreter';\nimport {\n  type MessageValues,\n  parseTaggedMessage,\n  resolveMessage,\n  type TaggedMessageToken,\n} from '@intlayer/core/messageFormat';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { Fragment, type ReactNode } from 'react';\n\n/** Chunk renderer used by `t.rich()` — maps tag children to a React node. */\nexport type RichChunkRenderer = (chunks: ReactNode) => ReactNode;\n\n/** Chunk renderer used by `t.markup()` — maps tag children to a string. */\nexport type MarkupChunkRenderer = (chunks: string) => string;\n\n/**\n * Reads a dotted `path` (e.g. `counter.label`) out of a nested object value.\n *\n * @param objectValue - The object to read from.\n * @param path - Dot-separated path. An empty path returns `objectValue`.\n * @returns The value found at `path`, or `undefined` when any segment is absent.\n */\nexport const navigatePath = (objectValue: unknown, path: string): unknown => {\n  if (!path) return objectValue;\n  const parts = path.split('.');\n  let current: unknown = objectValue;\n  for (const part of parts) {\n    if (\n      current === null ||\n      current === undefined ||\n      typeof current !== 'object'\n    ) {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n};\n\n/** Splits rich values into scalar interpolation values and tag renderers. */\nconst splitRichValues = (\n  values: Record<string, unknown> = {}\n): { scalarValues: MessageValues; renderers: Record<string, unknown> } => {\n  const scalarValues: MessageValues = {};\n  const renderers: Record<string, unknown> = {};\n\n  for (const [valueKey, value] of Object.entries(values)) {\n    if (typeof value === 'function') renderers[valueKey] = value;\n    else scalarValues[valueKey] = value;\n  }\n\n  return { scalarValues, renderers };\n};\n\nconst renderRichTokens = (\n  tokens: TaggedMessageToken[],\n  renderers: Record<string, unknown>\n): ReactNode[] =>\n  tokens.map((token, tokenIndex) => {\n    if (typeof token === 'string') return token;\n\n    const children = renderRichTokens(token.children, renderers);\n    const renderer = renderers[token.tag];\n\n    if (typeof renderer === 'function') {\n      return (\n        <Fragment key={tokenIndex}>\n          {(renderer as RichChunkRenderer)(children)}\n        </Fragment>\n      );\n    }\n\n    // No renderer provided for the tag — render its children unwrapped\n    return <Fragment key={tokenIndex}>{children}</Fragment>;\n  });\n\nconst renderMarkupTokens = (\n  tokens: TaggedMessageToken[],\n  renderers: Record<string, unknown>\n): string =>\n  tokens\n    .map((token) => {\n      if (typeof token === 'string') return token;\n\n      const children = renderMarkupTokens(token.children, renderers);\n      const renderer = renderers[token.tag];\n\n      if (typeof renderer === 'function') {\n        return (renderer as MarkupChunkRenderer)(children);\n      }\n\n      return children;\n    })\n    .join('');\n\n/**\n * The untyped runtime translator shared by `useTranslations` (React hook) and\n * `createTranslator` (non-React core).\n *\n * Behaviour matches use-intl / next-intl:\n * - namespace `'about'` → keys resolved inside the `about` dictionary\n * - namespace `'about.counter'` → dictionary `about`, key prefix `counter`\n * - no namespace → the first segment of each key is the dictionary key\n * - messages support ICU syntax (plural, select, `#`, formatted arguments)\n * - `t.rich` / `t.markup` map `<tag>chunks</tag>` through the provided\n *   renderers; `t.raw` returns the raw value; `t.has` checks existence\n *\n * @param locale - The locale dictionaries are resolved for.\n * @param namespace - Optional dictionary key, optionally with a nested scope.\n * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.\n */\nexport const createNamespaceTranslator = (\n  locale: LocalesValues,\n  namespace?: string\n) => {\n  const [dictionaryKey, ...prefixSegments] = (namespace ?? '').split('.');\n  const keyPrefix = prefixSegments.join('.');\n\n  const lookup = (key: string): unknown => {\n    let targetDictionaryKey = dictionaryKey;\n    let path = keyPrefix ? `${keyPrefix}.${key}` : key;\n\n    if (!targetDictionaryKey) {\n      // Root scope — the first key segment designates the dictionary\n      const [firstSegment, ...restSegments] = key.split('.');\n      targetDictionaryKey = firstSegment;\n      path = restSegments.join('.');\n    }\n\n    try {\n      const dictionary = getIntlayer(\n        targetDictionaryKey as DictionaryKeys,\n        locale\n      );\n      return navigatePath(dictionary, path);\n    } catch {\n      return undefined;\n    }\n  };\n\n  const resolveToString = (\n    key: string,\n    values: MessageValues = {}\n  ): string | undefined => {\n    const rawValue = lookup(key);\n    if (rawValue === null || rawValue === undefined) return undefined;\n    return resolveMessage(rawValue, values, locale, 'icu');\n  };\n\n  const missingKeyFallback = (key: string): string =>\n    namespace ? `${namespace}.${key}` : key;\n\n  const translate = (key: string, values?: MessageValues): string =>\n    resolveToString(key, values) ?? missingKeyFallback(key);\n\n  return Object.assign(translate, {\n    /** Returns `true` if the given key exists in the namespace. */\n    has: (key: string): boolean => lookup(key) !== undefined,\n\n    /** Returns the raw unprocessed content for the given key. */\n    raw: (key: string): unknown => lookup(key),\n\n    /**\n     * Resolves a message containing `<tag>chunks</tag>` markup, mapping each\n     * tag through the matching renderer in `values`.\n     */\n    rich: (key: string, values?: Record<string, unknown>): ReactNode => {\n      const { scalarValues, renderers } = splitRichValues(values);\n      const message = resolveToString(key, scalarValues);\n      if (message === undefined) return missingKeyFallback(key);\n      return <>{renderRichTokens(parseTaggedMessage(message), renderers)}</>;\n    },\n\n    /**\n     * Resolves a message containing `<tag>chunks</tag>` markup into a string,\n     * mapping each tag through the matching string renderer in `values`.\n     */\n    markup: (key: string, values?: Record<string, unknown>): string => {\n      const { scalarValues, renderers } = splitRichValues(values);\n      const message = resolveToString(key, scalarValues);\n      if (message === undefined) return missingKeyFallback(key);\n      return renderMarkupTokens(parseTaggedMessage(message), renderers);\n    },\n  });\n};\n\nexport type CompatTranslator = ReturnType<typeof createNamespaceTranslator>;\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,MAAa,gBAAgB,aAAsB,SAA0B;AAC3E,KAAI,CAAC,KAAM,QAAO;CAClB,MAAM,QAAQ,KAAK,MAAM,IAAI;CAC7B,IAAI,UAAmB;AACvB,MAAK,MAAM,QAAQ,OAAO;AACxB,MACE,YAAY,QACZ,YAAY,UACZ,OAAO,YAAY,SAEnB;AAEF,YAAW,QAAoC;;AAEjD,QAAO;;;AAIT,MAAM,mBACJ,SAAkC,EAAE,KACoC;CACxE,MAAM,eAA8B,EAAE;CACtC,MAAM,YAAqC,EAAE;AAE7C,MAAK,MAAM,CAAC,UAAU,UAAU,OAAO,QAAQ,OAAO,CACpD,KAAI,OAAO,UAAU,WAAY,WAAU,YAAY;KAClD,cAAa,YAAY;AAGhC,QAAO;EAAE;EAAc;EAAW;;AAGpC,MAAM,oBACJ,QACA,cAEA,OAAO,KAAK,OAAO,eAAe;AAChC,KAAI,OAAO,UAAU,SAAU,QAAO;CAEtC,MAAM,WAAW,iBAAiB,MAAM,UAAU,UAAU;CAC5D,MAAM,WAAW,UAAU,MAAM;AAEjC,KAAI,OAAO,aAAa,WACtB,QACE,2CAACA,gBAAD,YACI,SAA+B,SAAS,EACjC,EAFI,WAEJ;AAKf,QAAO,2CAACA,gBAAD,EAA4B,UAAoB,EAAjC,WAAiC;EACvD;AAEJ,MAAM,sBACJ,QACA,cAEA,OACG,KAAK,UAAU;AACd,KAAI,OAAO,UAAU,SAAU,QAAO;CAEtC,MAAM,WAAW,mBAAmB,MAAM,UAAU,UAAU;CAC9D,MAAM,WAAW,UAAU,MAAM;AAEjC,KAAI,OAAO,aAAa,WACtB,QAAQ,SAAiC,SAAS;AAGpD,QAAO;EACP,CACD,KAAK,GAAG;;;;;;;;;;;;;;;;;AAkBb,MAAa,6BACX,QACA,cACG;CACH,MAAM,CAAC,eAAe,GAAG,mBAAmB,aAAa,IAAI,MAAM,IAAI;CACvE,MAAM,YAAY,eAAe,KAAK,IAAI;CAE1C,MAAM,UAAU,QAAyB;EACvC,IAAI,sBAAsB;EAC1B,IAAI,OAAO,YAAY,GAAG,UAAU,GAAG,QAAQ;AAE/C,MAAI,CAAC,qBAAqB;GAExB,MAAM,CAAC,cAAc,GAAG,gBAAgB,IAAI,MAAM,IAAI;AACtD,yBAAsB;AACtB,UAAO,aAAa,KAAK,IAAI;;AAG/B,MAAI;AAKF,UAAO,yDAHL,qBACA,OAE4B,EAAE,KAAK;UAC/B;AACN;;;CAIJ,MAAM,mBACJ,KACA,SAAwB,EAAE,KACH;EACvB,MAAM,WAAW,OAAO,IAAI;AAC5B,MAAI,aAAa,QAAQ,aAAa,OAAW,QAAO;AACxD,0DAAsB,UAAU,QAAQ,QAAQ,MAAM;;CAGxD,MAAM,sBAAsB,QAC1B,YAAY,GAAG,UAAU,GAAG,QAAQ;CAEtC,MAAM,aAAa,KAAa,WAC9B,gBAAgB,KAAK,OAAO,IAAI,mBAAmB,IAAI;AAEzD,QAAO,OAAO,OAAO,WAAW;;EAE9B,MAAM,QAAyB,OAAO,IAAI,KAAK;;EAG/C,MAAM,QAAyB,OAAO,IAAI;;;;;EAM1C,OAAO,KAAa,WAAgD;GAClE,MAAM,EAAE,cAAc,cAAc,gBAAgB,OAAO;GAC3D,MAAM,UAAU,gBAAgB,KAAK,aAAa;AAClD,OAAI,YAAY,OAAW,QAAO,mBAAmB,IAAI;AACzD,UAAO,mFAAG,sEAAoC,QAAQ,EAAE,UAAU,EAAI;;;;;;EAOxE,SAAS,KAAa,WAA6C;GACjE,MAAM,EAAE,cAAc,cAAc,gBAAgB,OAAO;GAC3D,MAAM,UAAU,gBAAgB,KAAK,aAAa;AAClD,OAAI,YAAY,OAAW,QAAO,mBAAmB,IAAI;AACzD,UAAO,wEAAsC,QAAQ,EAAE,UAAU;;EAEpE,CAAC"}

package/dist/cjs/useDictionary.cjs

@@ -0,0 +1,37 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_shared_namespaceTranslator = require('./shared/namespaceTranslator.cjs');
+let react_intlayer = require("react-intlayer");
+
+//#region src/useDictionary.ts
+/**
+* Dictionary-accepting variant of `useTranslations`.
+*
+* Used internally by the build-time optimization: instead of looking up the
+* dictionary at runtime by key, the babel/swc plugin pre-imports the dictionary
+* JSON at build time and passes it directly here. This enables tree-shaking of
+* unused locale content.
+*
+* @example (generated by the plugin, not written manually)
+* import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };
+* const t = useDictionary(_abc);
+*/
+const useDictionary = (dictionary, namespacePrefix) => {
+	const content = (0, react_intlayer.useDictionary)(dictionary);
+	const resolveKey = (key) => namespacePrefix ? `${namespacePrefix}.${key}` : key;
+	return Object.assign((lookup, params) => {
+		const rawValue = require_shared_namespaceTranslator.navigatePath(content, resolveKey(String(lookup)));
+		const text = String(rawValue ?? resolveKey(String(lookup)));
+		if (!params) return text;
+		return text.replace(/\{(\w+)\}/g, (_match, key) => params[key] != null ? String(params[key]) : `{${key}}`);
+	}, {
+		has: (lookup) => require_shared_namespaceTranslator.navigatePath(content, resolveKey(String(lookup))) != null,
+		raw: (lookup) => require_shared_namespaceTranslator.navigatePath(content, resolveKey(String(lookup)))
+	});
+};
+
+//#endregion
+exports.useDictionary = useDictionary;
+//# sourceMappingURL=useDictionary.cjs.map

package/dist/cjs/useDictionary.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionary.cjs","names":["navigatePath"],"sources":["../../src/useDictionary.ts"],"sourcesContent":["'use client';\n\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { useDictionary as useDictionaryBase } from 'react-intlayer';\nimport { navigatePath } from './shared/namespaceTranslator';\n\n/**\n * Dictionary-accepting variant of `useTranslations`.\n *\n * Used internally by the build-time optimization: instead of looking up the\n * dictionary at runtime by key, the babel/swc plugin pre-imports the dictionary\n * JSON at build time and passes it directly here. This enables tree-shaking of\n * unused locale content.\n *\n * @example (generated by the plugin, not written manually)\n * import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };\n * const t = useDictionary(_abc);\n */\nexport const useDictionary = <T extends Dictionary>(\n  dictionary: T,\n  namespacePrefix?: string\n) => {\n  const content = useDictionaryBase(dictionary);\n\n  const resolveKey = (key: string): string =>\n    namespacePrefix ? `${namespacePrefix}.${key}` : key;\n\n  return Object.assign(\n    <P extends ValidDotPathsFor<string>>(\n      lookup: P,\n      params?: Record<string, unknown>\n    ): string => {\n      const rawValue = navigatePath(content, resolveKey(String(lookup)));\n      const text = String(rawValue ?? resolveKey(String(lookup)));\n      if (!params) return text;\n      return text.replace(/\\{(\\w+)\\}/g, (_match, key) =>\n        params[key] != null ? String(params[key]) : `{${key}}`\n      );\n    },\n    {\n      has: <P extends ValidDotPathsFor<string>>(lookup: P): boolean =>\n        navigatePath(content, resolveKey(String(lookup))) != null,\n      raw: <P extends ValidDotPathsFor<string>>(lookup: P): unknown =>\n        navigatePath(content, resolveKey(String(lookup))),\n    }\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,iBACX,YACA,oBACG;CACH,MAAM,4CAA4B,WAAW;CAE7C,MAAM,cAAc,QAClB,kBAAkB,GAAG,gBAAgB,GAAG,QAAQ;AAElD,QAAO,OAAO,QAEV,QACA,WACW;EACX,MAAM,WAAWA,gDAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EAClE,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,OAAO,CAAC,CAAC;AAC3D,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,eAAe,QAAQ,QACzC,OAAO,QAAQ,OAAO,OAAO,OAAO,KAAK,GAAG,IAAI,IAAI,GACrD;IAEH;EACE,MAA0C,WACxCA,gDAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC,IAAI;EACvD,MAA0C,WACxCA,gDAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EACpD,CACF"}

package/dist/cjs/useDictionaryDynamic.cjs

@@ -0,0 +1,31 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_shared_namespaceTranslator = require('./shared/namespaceTranslator.cjs');
+let react_intlayer = require("react-intlayer");
+
+//#region src/useDictionaryDynamic.ts
+/**
+* Dynamic dictionary-accepting variant of `useTranslations`.
+*
+* Counterpart to {@link useDictionary} for dictionaries imported lazily per
+* locale. Used internally by the build-time optimization.
+*/
+const useDictionaryDynamic = (dictionaryPromise, key, namespacePrefix) => {
+	const content = (0, react_intlayer.useDictionaryDynamic)(dictionaryPromise, key);
+	const resolveKey = (lookupKey) => namespacePrefix ? `${namespacePrefix}.${lookupKey}` : lookupKey;
+	return Object.assign((lookup, params) => {
+		const rawValue = require_shared_namespaceTranslator.navigatePath(content, resolveKey(String(lookup)));
+		const text = String(rawValue ?? resolveKey(String(lookup)));
+		if (!params) return text;
+		return text.replace(/\{(\w+)\}/g, (_match, key) => params[key] != null ? String(params[key]) : `{${key}}`);
+	}, {
+		has: (lookup) => require_shared_namespaceTranslator.navigatePath(content, resolveKey(String(lookup))) != null,
+		raw: (lookup) => require_shared_namespaceTranslator.navigatePath(content, resolveKey(String(lookup)))
+	});
+};
+
+//#endregion
+exports.useDictionaryDynamic = useDictionaryDynamic;
+//# sourceMappingURL=useDictionaryDynamic.cjs.map

package/dist/cjs/useDictionaryDynamic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionaryDynamic.cjs","names":["navigatePath"],"sources":["../../src/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport { useDictionaryDynamic as useDictionaryDynamicBase } from 'react-intlayer';\nimport { navigatePath } from './shared/namespaceTranslator';\n\n/**\n * Dynamic dictionary-accepting variant of `useTranslations`.\n *\n * Counterpart to {@link useDictionary} for dictionaries imported lazily per\n * locale. Used internally by the build-time optimization.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends string,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  namespacePrefix?: string\n) => {\n  const content = useDictionaryDynamicBase<T, K>(dictionaryPromise, key);\n\n  const resolveKey = (lookupKey: string): string =>\n    namespacePrefix ? `${namespacePrefix}.${lookupKey}` : lookupKey;\n\n  return Object.assign(\n    <P extends ValidDotPathsFor<string>>(\n      lookup: P,\n      params?: Record<string, unknown>\n    ): string => {\n      const rawValue = navigatePath(content, resolveKey(String(lookup)));\n      const text = String(rawValue ?? resolveKey(String(lookup)));\n      if (!params) return text;\n      return text.replace(/\\{(\\w+)\\}/g, (_match, key) =>\n        params[key] != null ? String(params[key]) : `{${key}}`\n      );\n    },\n    {\n      has: <P extends ValidDotPathsFor<string>>(lookup: P): boolean =>\n        navigatePath(content, resolveKey(String(lookup))) != null,\n      raw: <P extends ValidDotPathsFor<string>>(lookup: P): unknown =>\n        navigatePath(content, resolveKey(String(lookup))),\n    }\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,wBAIX,mBACA,KACA,oBACG;CACH,MAAM,mDAAyC,mBAAmB,IAAI;CAEtE,MAAM,cAAc,cAClB,kBAAkB,GAAG,gBAAgB,GAAG,cAAc;AAExD,QAAO,OAAO,QAEV,QACA,WACW;EACX,MAAM,WAAWA,gDAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EAClE,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,OAAO,CAAC,CAAC;AAC3D,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,eAAe,QAAQ,QACzC,OAAO,QAAQ,OAAO,OAAO,OAAO,KAAK,GAAG,IAAI,IAAI,GACrD;IAEH;EACE,MAA0C,WACxCA,gDAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC,IAAI;EACvD,MAA0C,WACxCA,gDAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EACpD,CACF"}

package/dist/esm/core/createFormatter.mjs

@@ -0,0 +1,22 @@
+import { buildIntlFormatter } from "../shared/intlFormatter.mjs";
+
+//#region src/core/createFormatter.ts
+/**
+* Drop-in for use-intl's `createFormatter`.
+*
+* Returns locale-aware formatters backed by the native `Intl.*` APIs:
+* `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and
+* `displayName`. `now`, `timeZone`, `formats`, and `onError` are accepted for
+* API compatibility but only `locale` influences the output.
+*
+* @example
+* ```ts
+* const format = createFormatter({ locale: 'en' });
+* format.number(1234.5, { style: 'currency', currency: 'USD' });
+* ```
+*/
+const createFormatter = ({ locale }) => buildIntlFormatter(locale);
+
+//#endregion
+export { createFormatter };
+//# sourceMappingURL=createFormatter.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createFormatter.mjs","names":[],"sources":["../../../src/core/createFormatter.ts"],"sourcesContent":["import type { createFormatter as _createFormatter } from 'use-intl';\nimport { buildIntlFormatter } from '../shared/intlFormatter';\n\n/**\n * Drop-in for use-intl's `createFormatter`.\n *\n * Returns locale-aware formatters backed by the native `Intl.*` APIs:\n * `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and\n * `displayName`. `now`, `timeZone`, `formats`, and `onError` are accepted for\n * API compatibility but only `locale` influences the output.\n *\n * @example\n * ```ts\n * const format = createFormatter({ locale: 'en' });\n * format.number(1234.5, { style: 'currency', currency: 'USD' });\n * ```\n */\nexport const createFormatter: typeof _createFormatter = ({ locale }) =>\n  buildIntlFormatter(locale);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAa,mBAA4C,EAAE,aACzD,mBAAmB,OAAO"}