@intlayer/react-intl 9.0.0-canary.2 → 9.0.0-canary.21

package/dist/esm/createIntlObject.mjs

@@ -1,6 +1,6 @@
 import { Fragment } from "react";
 import { getIntlayer } from "@intlayer/core/interpreter";
-import { parseTaggedMessage, resolveMessage } from "@intlayer/core/messageFormat";
+import { navigatePath, parseTaggedMessage, resolveMessage } from "@intlayer/core/messageFormat";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 
 //#region src/createIntlObject.tsx
@@ -16,16 +16,6 @@ const splitId = (id) => {
 		path: id.slice(dotIndex + 1)
 	};
 };
-const navigatePath = (object, path) => {
-	if (!path) return object;
-	const parts = path.split(".");
-	let current = object;
-	for (const part of parts) {
-		if (current === null || current === void 0 || typeof current !== "object") return;
-		current = current[part];
-	}
-	return current;
-};
 /** Looks up a message value by full dotted id; first segment = dictionary key. */
 const lookupMessage = (id, locale) => {
 	const { dictionaryKey, path } = splitId(id);
@@ -62,16 +52,21 @@ const isRichValues = (values) => Object.values(values).some((value) => typeof va
 * - Translation ids use the first dot-path segment as the dictionary key.
 * - Full ICU MessageFormat syntax is supported via `@intlayer/core/messageFormat`.
 * - Rich text tags (`<b>chunks</b>`) are resolved through render functions in `values`.
+*
+* @param locale - The locale messages are resolved for.
+* @param lookupOverride - Optional message lookup replacing the registry-based
+*   id resolution; used by the dictionary-bound `useDictionary` variant.
 */
-const createIntlObject = (locale) => {
+const createIntlObject = (locale, lookupOverride) => {
 	const localeString = locale;
 	const formatMessage = (descriptor, values) => {
 		const { id = "", defaultMessage } = descriptor;
-		const rawValue = lookupMessage(id, locale);
+		const rawValue = lookupOverride ? lookupOverride(id) : lookupMessage(id, locale);
 		const messageTemplate = rawValue !== void 0 && rawValue !== null ? rawValue : typeof defaultMessage === "string" ? defaultMessage : id;
 		if (!values || !isRichValues(values)) return resolveMessage(messageTemplate, values ?? {}, locale, "icu") ?? id;
 		const { scalarValues, renderers } = splitRichValues(values);
-		return renderRichTokens(parseTaggedMessage(resolveMessage(messageTemplate, scalarValues, locale, "icu") ?? id), renderers);
+		const message = resolveMessage(messageTemplate, scalarValues, locale, "icu") ?? id;
+		return renderRichTokens(parseTaggedMessage(message), renderers);
 	};
 	const toDate = (value) => value instanceof Date ? value : new Date(value);
 	const formatDate = (value, options) => {

package/dist/esm/createIntlObject.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createIntlObject.mjs","names":[],"sources":["../../src/createIntlObject.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';\nimport type { IntlShape, MessageDescriptor } from 'react-intl';\n\ntype RichRenderer = (chunks: ReactNode) => ReactNode;\n\n/** Splits a full dotted id into the dictionary key and remaining path. */\nconst splitId = (id: string): { dictionaryKey: string; path: string } => {\n  const dotIndex = id.indexOf('.');\n  if (dotIndex === -1) return { dictionaryKey: id, path: '' };\n  return {\n    dictionaryKey: id.slice(0, dotIndex),\n    path: id.slice(dotIndex + 1),\n  };\n};\n\nconst navigatePath = (object: unknown, path: string): unknown => {\n  if (!path) return object;\n  const parts = path.split('.');\n  let current: unknown = object;\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/** Looks up a message value by full dotted id; first segment = dictionary key. */\nconst lookupMessage = (id: string, locale: LocalesValues): unknown => {\n  const { dictionaryKey, path } = splitId(id);\n  if (!dictionaryKey) return undefined;\n  try {\n    const dictionary = getIntlayer(dictionaryKey as DictionaryKeys, locale);\n    return navigatePath(dictionary, path);\n  } catch {\n    return undefined;\n  }\n};\n\n/** Maps tagged tokens to React nodes using the provided renderer functions. */\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    const children = renderRichTokens(token.children, renderers);\n    const renderer = renderers[token.tag];\n    if (typeof renderer === 'function') {\n      return (\n        <Fragment key={tokenIndex}>\n          {(renderer as RichRenderer)(<>{children}</>)}\n        </Fragment>\n      );\n    }\n    return <Fragment key={tokenIndex}>{children}</Fragment>;\n  });\n\n/** Partitions values into scalar interpolation params 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  for (const [key, value] of Object.entries(values)) {\n    if (typeof value === 'function') renderers[key] = value;\n    else scalarValues[key] = value as MessageValues[string];\n  }\n  return { scalarValues, renderers };\n};\n\nconst isRichValues = (values: Record<string, unknown>): boolean =>\n  Object.values(values).some((value) => typeof value === 'function');\n\n/**\n * Builds an intlayer-backed `IntlShape` object for the given locale.\n *\n * - Translation ids use the first dot-path segment as the dictionary key.\n * - Full ICU MessageFormat syntax is supported via `@intlayer/core/messageFormat`.\n * - Rich text tags (`<b>chunks</b>`) are resolved through render functions in `values`.\n */\nexport const createIntlObject = (locale: LocalesValues): IntlShape => {\n  const localeString = locale as string;\n\n  const formatMessage = (\n    descriptor: MessageDescriptor,\n    values?: Record<string, unknown>\n  ): string | ReactNode[] => {\n    const { id = '', defaultMessage } = descriptor;\n    const rawValue = lookupMessage(id, locale);\n    const messageTemplate =\n      rawValue !== undefined && rawValue !== null\n        ? (rawValue as string)\n        : typeof defaultMessage === 'string'\n          ? defaultMessage\n          : id;\n\n    if (!values || !isRichValues(values)) {\n      return (\n        resolveMessage(\n          messageTemplate,\n          (values ?? {}) as MessageValues,\n          locale,\n          'icu'\n        ) ?? id\n      );\n    }\n\n    const { scalarValues, renderers } = splitRichValues(values);\n    const message =\n      resolveMessage(messageTemplate, scalarValues, locale, 'icu') ?? id;\n    return renderRichTokens(parseTaggedMessage(message), renderers);\n  };\n\n  const toDate = (value: Date | number | string): Date =>\n    value instanceof Date ? value : new Date(value);\n\n  const formatDate = (\n    value: string | number | Date | undefined,\n    options?: Intl.DateTimeFormatOptions\n  ): string => {\n    if (value === undefined || value === null) return '';\n    return new Intl.DateTimeFormat(localeString, options).format(toDate(value));\n  };\n\n  const formatNumber = (\n    value: number | bigint,\n    options?: Intl.NumberFormatOptions\n  ): string => new Intl.NumberFormat(localeString, options).format(value);\n\n  const formatPlural = (\n    value: number,\n    options?: Intl.PluralRulesOptions\n  ): Intl.LDMLPluralRule =>\n    new Intl.PluralRules(localeString, options).select(value);\n\n  const formatList = (\n    list: Iterable<unknown> | readonly unknown[],\n    options?: Intl.ListFormatOptions\n  ): string => {\n    const strings = Array.from(list).filter(\n      (item): item is string => typeof item === 'string'\n    );\n    return new Intl.ListFormat(localeString, options).format(strings);\n  };\n\n  const formatListToParts = (\n    list: Iterable<unknown> | readonly unknown[],\n    options?: Intl.ListFormatOptions\n  ): ReturnType<Intl.ListFormat['formatToParts']> => {\n    const strings = Array.from(list).filter(\n      (item): item is string => typeof item === 'string'\n    );\n    return new Intl.ListFormat(localeString, options).formatToParts(strings);\n  };\n\n  const formatDisplayName = (\n    value: string,\n    options?: Intl.DisplayNamesOptions\n  ): string | undefined =>\n    new Intl.DisplayNames([localeString], options ?? { type: 'language' }).of(\n      value\n    );\n\n  const formatRelativeTime = (\n    value: number,\n    unit?: Intl.RelativeTimeFormatUnit,\n    options?: Intl.RelativeTimeFormatOptions\n  ): string =>\n    new Intl.RelativeTimeFormat(localeString, {\n      numeric: 'auto',\n      ...options,\n    }).format(value, unit ?? 'second');\n\n  const formatDateTimeRange = (\n    from: Date | number,\n    to: Date | number,\n    options?: Intl.DateTimeFormatOptions\n  ): string =>\n    new Intl.DateTimeFormat(localeString, options).formatRange(\n      toDate(from),\n      toDate(to)\n    );\n\n  const formatDateToParts = (\n    value: Parameters<Intl.DateTimeFormat['format']>[0] | string,\n    options?: Intl.DateTimeFormatOptions\n  ): Intl.DateTimeFormatPart[] =>\n    new Intl.DateTimeFormat(localeString, options).formatToParts(\n      typeof value === 'string' ? new Date(value) : value\n    );\n\n  const formatNumberToParts = (\n    value: number | bigint,\n    options?: Intl.NumberFormatOptions\n  ): Intl.NumberFormatPart[] =>\n    new Intl.NumberFormat(localeString, options).formatToParts(value);\n\n  /** Alias of `formatMessage` — provided for `@formatjs/intl` v4 compatibility. */\n  const $t = formatMessage as IntlShape['$t'];\n\n  return {\n    locale: localeString,\n    defaultLocale: localeString,\n    messages: {},\n    formats: {},\n    defaultFormats: {},\n    timeZone: undefined,\n    textComponent: Fragment,\n    wrapRichTextChunksInFragment: false,\n    fallbackOnEmptyString: true,\n    onError: () => {},\n    onWarn: () => {},\n    formatters: {} as IntlShape['formatters'],\n    formatMessage: formatMessage as IntlShape['formatMessage'],\n    $t,\n    formatDate,\n    formatTime: formatDate,\n    formatNumber,\n    formatPlural,\n    formatList: formatList as IntlShape['formatList'],\n    formatListToParts: formatListToParts as IntlShape['formatListToParts'],\n    formatDisplayName: formatDisplayName as IntlShape['formatDisplayName'],\n    formatRelativeTime,\n    formatDateTimeRange,\n    formatDateToParts: formatDateToParts as IntlShape['formatDateToParts'],\n    formatTimeToParts: formatDateToParts as IntlShape['formatTimeToParts'],\n    formatNumberToParts:\n      formatNumberToParts as IntlShape['formatNumberToParts'],\n  } as unknown as IntlShape;\n};\n"],"mappings":"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"}
+{"version":3,"file":"createIntlObject.mjs","names":[],"sources":["../../src/createIntlObject.tsx"],"sourcesContent":["import { getIntlayer } from '@intlayer/core/interpreter';\nimport {\n  type MessageValues,\n  navigatePath,\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';\nimport type { IntlShape, MessageDescriptor } from 'react-intl';\n\ntype RichRenderer = (chunks: ReactNode) => ReactNode;\n\n/** Splits a full dotted id into the dictionary key and remaining path. */\nconst splitId = (id: string): { dictionaryKey: string; path: string } => {\n  const dotIndex = id.indexOf('.');\n  if (dotIndex === -1) return { dictionaryKey: id, path: '' };\n  return {\n    dictionaryKey: id.slice(0, dotIndex),\n    path: id.slice(dotIndex + 1),\n  };\n};\n\n/** Looks up a message value by full dotted id; first segment = dictionary key. */\nconst lookupMessage = (id: string, locale: LocalesValues): unknown => {\n  const { dictionaryKey, path } = splitId(id);\n  if (!dictionaryKey) return undefined;\n  try {\n    const dictionary = getIntlayer(dictionaryKey as DictionaryKeys, locale);\n    return navigatePath(dictionary, path);\n  } catch {\n    return undefined;\n  }\n};\n\n/** Maps tagged tokens to React nodes using the provided renderer functions. */\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    const children = renderRichTokens(token.children, renderers);\n    const renderer = renderers[token.tag];\n    if (typeof renderer === 'function') {\n      return (\n        <Fragment key={tokenIndex}>\n          {(renderer as RichRenderer)(<>{children}</>)}\n        </Fragment>\n      );\n    }\n    return <Fragment key={tokenIndex}>{children}</Fragment>;\n  });\n\n/** Partitions values into scalar interpolation params 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  for (const [key, value] of Object.entries(values)) {\n    if (typeof value === 'function') renderers[key] = value;\n    else scalarValues[key] = value as MessageValues[string];\n  }\n  return { scalarValues, renderers };\n};\n\nconst isRichValues = (values: Record<string, unknown>): boolean =>\n  Object.values(values).some((value) => typeof value === 'function');\n\n/**\n * Builds an intlayer-backed `IntlShape` object for the given locale.\n *\n * - Translation ids use the first dot-path segment as the dictionary key.\n * - Full ICU MessageFormat syntax is supported via `@intlayer/core/messageFormat`.\n * - Rich text tags (`<b>chunks</b>`) are resolved through render functions in `values`.\n *\n * @param locale - The locale messages are resolved for.\n * @param lookupOverride - Optional message lookup replacing the registry-based\n *   id resolution; used by the dictionary-bound `useDictionary` variant.\n */\nexport const createIntlObject = (\n  locale: LocalesValues,\n  lookupOverride?: (id: string) => unknown\n): IntlShape => {\n  const localeString = locale as string;\n\n  const formatMessage = (\n    descriptor: MessageDescriptor,\n    values?: Record<string, unknown>\n  ): string | ReactNode[] => {\n    const { id = '', defaultMessage } = descriptor;\n    const rawValue = lookupOverride\n      ? lookupOverride(id)\n      : lookupMessage(id, locale);\n    const messageTemplate =\n      rawValue !== undefined && rawValue !== null\n        ? (rawValue as string)\n        : typeof defaultMessage === 'string'\n          ? defaultMessage\n          : id;\n\n    if (!values || !isRichValues(values)) {\n      return (\n        resolveMessage(\n          messageTemplate,\n          (values ?? {}) as MessageValues,\n          locale,\n          'icu'\n        ) ?? id\n      );\n    }\n\n    const { scalarValues, renderers } = splitRichValues(values);\n    const message =\n      resolveMessage(messageTemplate, scalarValues, locale, 'icu') ?? id;\n    return renderRichTokens(parseTaggedMessage(message), renderers);\n  };\n\n  const toDate = (value: Date | number | string): Date =>\n    value instanceof Date ? value : new Date(value);\n\n  const formatDate = (\n    value: string | number | Date | undefined,\n    options?: Intl.DateTimeFormatOptions\n  ): string => {\n    if (value === undefined || value === null) return '';\n    return new Intl.DateTimeFormat(localeString, options).format(toDate(value));\n  };\n\n  const formatNumber = (\n    value: number | bigint,\n    options?: Intl.NumberFormatOptions\n  ): string => new Intl.NumberFormat(localeString, options).format(value);\n\n  const formatPlural = (\n    value: number,\n    options?: Intl.PluralRulesOptions\n  ): Intl.LDMLPluralRule =>\n    new Intl.PluralRules(localeString, options).select(value);\n\n  const formatList = (\n    list: Iterable<unknown> | readonly unknown[],\n    options?: Intl.ListFormatOptions\n  ): string => {\n    const strings = Array.from(list).filter(\n      (item): item is string => typeof item === 'string'\n    );\n    return new Intl.ListFormat(localeString, options).format(strings);\n  };\n\n  const formatListToParts = (\n    list: Iterable<unknown> | readonly unknown[],\n    options?: Intl.ListFormatOptions\n  ): ReturnType<Intl.ListFormat['formatToParts']> => {\n    const strings = Array.from(list).filter(\n      (item): item is string => typeof item === 'string'\n    );\n    return new Intl.ListFormat(localeString, options).formatToParts(strings);\n  };\n\n  const formatDisplayName = (\n    value: string,\n    options?: Intl.DisplayNamesOptions\n  ): string | undefined =>\n    new Intl.DisplayNames([localeString], options ?? { type: 'language' }).of(\n      value\n    );\n\n  const formatRelativeTime = (\n    value: number,\n    unit?: Intl.RelativeTimeFormatUnit,\n    options?: Intl.RelativeTimeFormatOptions\n  ): string =>\n    new Intl.RelativeTimeFormat(localeString, {\n      numeric: 'auto',\n      ...options,\n    }).format(value, unit ?? 'second');\n\n  const formatDateTimeRange = (\n    from: Date | number,\n    to: Date | number,\n    options?: Intl.DateTimeFormatOptions\n  ): string =>\n    new Intl.DateTimeFormat(localeString, options).formatRange(\n      toDate(from),\n      toDate(to)\n    );\n\n  const formatDateToParts = (\n    value: Parameters<Intl.DateTimeFormat['format']>[0] | string,\n    options?: Intl.DateTimeFormatOptions\n  ): Intl.DateTimeFormatPart[] =>\n    new Intl.DateTimeFormat(localeString, options).formatToParts(\n      typeof value === 'string' ? new Date(value) : value\n    );\n\n  const formatNumberToParts = (\n    value: number | bigint,\n    options?: Intl.NumberFormatOptions\n  ): Intl.NumberFormatPart[] =>\n    new Intl.NumberFormat(localeString, options).formatToParts(value);\n\n  /** Alias of `formatMessage` — provided for `@formatjs/intl` v4 compatibility. */\n  const $t = formatMessage as IntlShape['$t'];\n\n  return {\n    locale: localeString,\n    defaultLocale: localeString,\n    messages: {},\n    formats: {},\n    defaultFormats: {},\n    timeZone: undefined,\n    textComponent: Fragment,\n    wrapRichTextChunksInFragment: false,\n    fallbackOnEmptyString: true,\n    onError: () => {},\n    onWarn: () => {},\n    formatters: {} as IntlShape['formatters'],\n    formatMessage: formatMessage as IntlShape['formatMessage'],\n    $t,\n    formatDate,\n    formatTime: formatDate,\n    formatNumber,\n    formatPlural,\n    formatList: formatList as IntlShape['formatList'],\n    formatListToParts: formatListToParts as IntlShape['formatListToParts'],\n    formatDisplayName: formatDisplayName as IntlShape['formatDisplayName'],\n    formatRelativeTime,\n    formatDateTimeRange,\n    formatDateToParts: formatDateToParts as IntlShape['formatDateToParts'],\n    formatTimeToParts: formatDateToParts as IntlShape['formatTimeToParts'],\n    formatNumberToParts:\n      formatNumberToParts as IntlShape['formatNumberToParts'],\n  } as unknown as IntlShape;\n};\n"],"mappings":"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"}

package/dist/esm/index.mjs

@@ -8,5 +8,7 @@ import { InvalidConfigError, MessageFormatError, MissingDataError, MissingTransl
 import { defineMessage, defineMessages } from "./defineMessages.mjs";
 import { createIntl, createIntlCache } from "./createIntl.mjs";
 import { FormattedMessage } from "./FormattedMessage.mjs";
+import { useDictionary } from "./useDictionary.mjs";
+import { useDictionaryDynamic } from "./useDictionaryDynamic.mjs";
 
-export { FormattedDate, FormattedDateParts, FormattedDateTimeRange, FormattedDisplayName, FormattedList, FormattedListParts, FormattedMessage, FormattedNumber, FormattedNumberParts, FormattedPlural, FormattedRelativeTime, FormattedTime, FormattedTimeParts, IntlContext, IntlProvider, InvalidConfigError, MessageFormatError, MissingDataError, MissingTranslationError, RawIntlProvider, ReactIntlError, ReactIntlErrorCode, UnsupportedFormatterError, createIntl, createIntlCache, defineMessage, defineMessages, useIntl };
+export { FormattedDate, FormattedDateParts, FormattedDateTimeRange, FormattedDisplayName, FormattedList, FormattedListParts, FormattedMessage, FormattedNumber, FormattedNumberParts, FormattedPlural, FormattedRelativeTime, FormattedTime, FormattedTimeParts, IntlContext, IntlProvider, InvalidConfigError, MessageFormatError, MissingDataError, MissingTranslationError, RawIntlProvider, ReactIntlError, ReactIntlErrorCode, UnsupportedFormatterError, createIntl, createIntlCache, defineMessage, defineMessages, useDictionary, useDictionaryDynamic, useIntl };

package/dist/esm/plugin/index.mjs

@@ -1,46 +1,13 @@
 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 { REACT_INTL_CALLERS } from "@intlayer/config/callers";
 import { getConfiguration } from "@intlayer/config/node";
+import { runOnce } from "@intlayer/engine/utils";
 import { intlayer } from "vite-intlayer";
 
 //#region src/plugin/index.ts
 /**
-* Caller configurations for react-intl's two message APIs.
-*
-* react-intl encodes both the dictionary key and the field path in a single
-* dotted id string, so the `path-first-segment` namespace source extracts the
-* first segment as the dictionary key and `translationFunction: 'self'` records
-* the second segment as the consumed field:
-*
-*   `'home.title'` → dictionaryKey='home', field='title'
-*   `'greeting'`   → dictionaryKey='greeting', field='all' (single segment)
-*   dynamic id     → unresolvable → skipped (all fields kept)
-*
-* Both call sites are tracked:
-*   - `intl.formatMessage({ id })` — matched as a method on any object.
-*   - `<FormattedMessage id />`    — matched as a JSX element (import-gated).
-*
-* The JSX form is mandatory: the prune context is shared across all files, so
-* tracking only `formatMessage` would let a field referenced solely from
-* `<FormattedMessage>` be pruned away whenever the same dictionary is also read
-* through `formatMessage`.
-*/
-const REACT_INTL_COMPAT_CALLERS = [{
-	callerName: "formatMessage",
-	importSources: ["react-intl", "@intlayer/react-intl"],
-	matchAsMethod: true,
-	namespace: { from: "path-first-segment" },
-	translationFunction: "self"
-}, {
-	callerName: "FormattedMessage",
-	importSources: ["react-intl", "@intlayer/react-intl"],
-	jsxIdAttribute: "id",
-	namespace: { from: "path-first-segment" },
-	translationFunction: "self"
-}];
-/**
 * A Vite plugin for react-intl compat that wraps vite-intlayer
 * and injects a resolve alias mapping `react-intl` to
 * `@intlayer/react-intl`.
@@ -63,7 +30,7 @@ const reactIntlVitePlugin = (options) => {
 	}, { cacheTimeoutMs: 1e3 * 60 * 60 });
 	const basePlugins = intlayer({
 		...options,
-		compatCallers: [...options?.compatCallers ?? [], ...REACT_INTL_COMPAT_CALLERS]
+		compatCallers: [...options?.compatCallers ?? [], ...REACT_INTL_CALLERS]
 	});
 	const compatPlugin = {
 		name: "vite-react-intl-compat-plugin",

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

@@ -1 +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 react-intl's two message APIs.\n *\n * react-intl encodes both the dictionary key and the field path in a single\n * dotted id string, so the `path-first-segment` namespace source extracts the\n * first segment as the dictionary key and `translationFunction: 'self'` records\n * the second segment as the consumed field:\n *\n *   `'home.title'` → dictionaryKey='home', field='title'\n *   `'greeting'`   → dictionaryKey='greeting', field='all' (single segment)\n *   dynamic id     → unresolvable → skipped (all fields kept)\n *\n * Both call sites are tracked:\n *   - `intl.formatMessage({ id })` — matched as a method on any object.\n *   - `<FormattedMessage id />`    — matched as a JSX element (import-gated).\n *\n * The JSX form is mandatory: the prune context is shared across all files, so\n * tracking only `formatMessage` would let a field referenced solely from\n * `<FormattedMessage>` be pruned away whenever the same dictionary is also read\n * through `formatMessage`.\n */\nconst REACT_INTL_COMPAT_CALLERS: CompatCallerConfig[] = [\n  {\n    callerName: 'formatMessage',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    matchAsMethod: true,\n    namespace: { from: 'path-first-segment' },\n    translationFunction: 'self',\n  },\n  // `<FormattedMessage id=\"home.title\" />` — the dominant react-intl API. This\n  // JSX form MUST be tracked alongside `formatMessage`: the prune context is\n  // global across files, so a field referenced only from JSX would otherwise be\n  // pruned away when the same dictionary is also read via `formatMessage`.\n  {\n    callerName: 'FormattedMessage',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    jsxIdAttribute: 'id',\n    namespace: { from: 'path-first-segment' },\n    translationFunction: 'self',\n  },\n];\n\n/**\n * A Vite plugin for react-intl compat that wraps vite-intlayer\n * and injects a resolve alias mapping `react-intl` to\n * `@intlayer/react-intl`.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import reactIntlVitePlugin from '@intlayer/react-intl/plugin';\n *\n * export default defineConfig({\n *   plugins: [reactIntlVitePlugin()],\n * });\n * ```\n */\nexport const reactIntlVitePlugin = (\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      ...REACT_INTL_COMPAT_CALLERS,\n    ],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-react-intl-compat-plugin',\n    config: () => ({\n      resolve: {\n        alias: {\n          'react-intl': '@intlayer/react-intl',\n        },\n      },\n    }),\n  };\n\n  return [\n    ...(Array.isArray(basePlugins) ? basePlugins : [basePlugins]),\n    compatPlugin,\n  ];\n};\n\nexport default reactIntlVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAM,4BAAkD,CACtD;CACE,YAAY;CACZ,eAAe,CAAC,cAAc,sBAAsB;CACpD,eAAe;CACf,WAAW,EAAE,MAAM,qBAAqB;CACxC,qBAAqB;AACvB,GAKA;CACE,YAAY;CACZ,eAAe,CAAC,cAAc,sBAAsB;CACpD,gBAAgB;CAChB,WAAW,EAAE,MAAM,qBAAqB;CACxC,qBAAqB;AACvB,CACF;;;;;;;;;;;;;;;;AAiBA,MAAa,uBACX,YACmB;CACnB,MAAM,iBAAiB,iBAAiB;CACxC,MAAM,YAAY,aAAa,cAAc;CAE7C,QACE,KACE,eAAe,OAAO,SACtB,aACA,SACA,iCACF,SACM;EACJ,UAAU,CACR,SACE,+CACA,WAAW,IACb,GACA,SACE,iDACA,WAAW,UACb,CACF,CAAC;CACH,GACA,EACE,gBAAgB,MAAO,KAAK,GAC9B,CACF;CAEA,MAAM,cAAc,SAAS;EAC3B,GAAG;EACH,eAAe,CACb,GAAI,SAAS,iBAAiB,CAAC,GAC/B,GAAG,yBACL;CACF,CAAC;CAED,MAAM,eAA6B;EACjC,MAAM;EACN,eAAe,EACb,SAAS,EACP,OAAO,EACL,cAAc,uBAChB,EACF,EACF;CACF;CAEA,OAAO,CACL,GAAI,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW,GAC3D,YACF;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugin/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { REACT_INTL_CALLERS } from '@intlayer/config/callers';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { runOnce } from '@intlayer/engine/utils';\nimport type { PluginOption } from 'vite';\nimport { intlayer } from 'vite-intlayer';\n\n/**\n * A Vite plugin for react-intl compat that wraps vite-intlayer\n * and injects a resolve alias mapping `react-intl` to\n * `@intlayer/react-intl`.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import reactIntlVitePlugin from '@intlayer/react-intl/plugin';\n *\n * export default defineConfig({\n *   plugins: [reactIntlVitePlugin()],\n * });\n * ```\n */\nexport const reactIntlVitePlugin = (\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: [...(options?.compatCallers ?? []), ...REACT_INTL_CALLERS],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-react-intl-compat-plugin',\n    config: () => ({\n      resolve: {\n        alias: {\n          'react-intl': '@intlayer/react-intl',\n        },\n      },\n    }),\n  };\n\n  return [\n    ...(Array.isArray(basePlugins) ? basePlugins : [basePlugins]),\n    compatPlugin,\n  ];\n};\n\nexport default reactIntlVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,uBACX,YACmB;CACnB,MAAM,iBAAiB,iBAAiB;CACxC,MAAM,YAAY,aAAa,cAAc;CAE7C,QACE,KACE,eAAe,OAAO,SACtB,aACA,SACA,iCACF,SACM;EACJ,UAAU,CACR,SACE,+CACA,WAAW,IACb,GACA,SACE,iDACA,WAAW,UACb,CACF,CAAC;CACH,GACA,EACE,gBAAgB,MAAO,KAAK,GAC9B,CACF;CAEA,MAAM,cAAc,SAAS;EAC3B,GAAG;EACH,eAAe,CAAC,GAAI,SAAS,iBAAiB,CAAC,GAAI,GAAG,kBAAkB;CAC1E,CAAC;CAED,MAAM,eAA6B;EACjC,MAAM;EACN,eAAe,EACb,SAAS,EACP,OAAO,EACL,cAAc,uBAChB,EACF,EACF;CACF;CAEA,OAAO,CACL,GAAI,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW,GAC3D,YACF;AACF"}

package/dist/esm/useDictionary.mjs

@@ -0,0 +1,45 @@
+'use client';
+
+import { createIntlObject } from "./createIntlObject.mjs";
+import { useMemo } from "react";
+import { useDictionary as useDictionary$1, useLocale } from "react-intlayer";
+import { navigatePath } from "@intlayer/core/messageFormat";
+
+//#region src/useDictionary.ts
+/**
+* Builds the id lookup of a dictionary-bound intl object.
+*
+* react-intl ids encode the dictionary key as their first dot-segment
+* (`'home.title'` → dictionary `home`, field `title`). When the content is
+* supplied directly, the leading `<dictionaryKey>.` is stripped so both the
+* absolute (`'home.title'`) and relative (`'title'`) forms resolve.
+*/
+const createDictionaryLookup = (dictionaryKey, content) => (id) => {
+	return navigatePath(content, id.startsWith(`${dictionaryKey}.`) ? id.slice(dictionaryKey.length + 1) : id === dictionaryKey ? "" : id);
+};
+/**
+* Dictionary-accepting variant of `useIntl`.
+*
+* Returns an `IntlShape` whose `formatMessage` resolves ids inside the
+* supplied dictionary instead of the runtime registry, enabling tree-shaking
+* of unused locale content. All `Intl`-backed formatters (`formatNumber`,
+* `formatDate`, …) behave exactly like `useIntl()`.
+*
+* @example
+* import _abc from '.intlayer/dictionaries/home.json' with { type: 'json' };
+* const intl = useDictionary(_abc);
+* intl.formatMessage({ id: 'home.title' }); // or { id: 'title' } — both typed
+*/
+const useDictionary = (dictionary) => {
+	const content = useDictionary$1(dictionary);
+	const { locale } = useLocale();
+	return useMemo(() => createIntlObject(locale, createDictionaryLookup(dictionary.key, content)), [
+		locale,
+		dictionary.key,
+		content
+	]);
+};
+
+//#endregion
+export { createDictionaryLookup, useDictionary };
+//# sourceMappingURL=useDictionary.mjs.map

package/dist/esm/useDictionary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionary.mjs","names":["useDictionaryBase"],"sources":["../../src/useDictionary.ts"],"sourcesContent":["'use client';\n\nimport { navigatePath } from '@intlayer/core/messageFormat';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useMemo } from 'react';\nimport { useDictionary as useDictionaryBase, useLocale } from 'react-intlayer';\nimport { createIntlObject } from './createIntlObject';\nimport type { DictionaryIntlShape } from './dictionaryIntlShape';\n\n/**\n * Builds the id lookup of a dictionary-bound intl object.\n *\n * react-intl ids encode the dictionary key as their first dot-segment\n * (`'home.title'` → dictionary `home`, field `title`). When the content is\n * supplied directly, the leading `<dictionaryKey>.` is stripped so both the\n * absolute (`'home.title'`) and relative (`'title'`) forms resolve.\n */\nexport const createDictionaryLookup =\n  (dictionaryKey: string, content: unknown) =>\n  (id: string): unknown => {\n    const relativePath = id.startsWith(`${dictionaryKey}.`)\n      ? id.slice(dictionaryKey.length + 1)\n      : id === dictionaryKey\n        ? ''\n        : id;\n    return navigatePath(content, relativePath);\n  };\n\n/**\n * Dictionary-accepting variant of `useIntl`.\n *\n * Returns an `IntlShape` whose `formatMessage` resolves ids inside the\n * supplied dictionary instead of the runtime registry, enabling tree-shaking\n * of unused locale content. All `Intl`-backed formatters (`formatNumber`,\n * `formatDate`, …) behave exactly like `useIntl()`.\n *\n * @example\n * import _abc from '.intlayer/dictionaries/home.json' with { type: 'json' };\n * const intl = useDictionary(_abc);\n * intl.formatMessage({ id: 'home.title' }); // or { id: 'title' } — both typed\n */\nexport const useDictionary = <T extends Dictionary>(\n  dictionary: T\n): DictionaryIntlShape<T['key'] & DictionaryKeys> => {\n  const content = useDictionaryBase(dictionary);\n  const { locale } = useLocale();\n\n  return useMemo(\n    () =>\n      createIntlObject(\n        locale as LocalesValues,\n        createDictionaryLookup(dictionary.key, content)\n      ) as DictionaryIntlShape<T['key'] & DictionaryKeys>,\n    [locale, dictionary.key, content]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqBA,MAAa,0BACV,eAAuB,aACvB,OAAwB;CAMvB,OAAO,aAAa,SALC,GAAG,WAAW,GAAG,cAAc,EAAE,IAClD,GAAG,MAAM,cAAc,SAAS,CAAC,IACjC,OAAO,gBACL,KACA,EACmC;AAC3C;;;;;;;;;;;;;;AAeF,MAAa,iBACX,eACmD;CACnD,MAAM,UAAUA,gBAAkB,UAAU;CAC5C,MAAM,EAAE,WAAW,UAAU;CAE7B,OAAO,cAEH,iBACE,QACA,uBAAuB,WAAW,KAAK,OAAO,CAChD,GACF;EAAC;EAAQ,WAAW;EAAK;CAAO,CAClC;AACF"}

package/dist/esm/useDictionaryDynamic.mjs

@@ -0,0 +1,27 @@
+'use client';
+
+import { createIntlObject } from "./createIntlObject.mjs";
+import { createDictionaryLookup } from "./useDictionary.mjs";
+import { useMemo } from "react";
+import { useDictionaryDynamic as useDictionaryDynamic$1, useLocale } from "react-intlayer";
+
+//#region src/useDictionaryDynamic.ts
+/**
+* Dynamic dictionary-accepting variant of `useIntl`.
+*
+* Counterpart to {@link useDictionary} for dictionaries imported lazily per
+* locale. Used internally by the build-time optimization.
+*/
+const useDictionaryDynamic = (dictionaryPromise, key) => {
+	const content = useDictionaryDynamic$1(dictionaryPromise, key);
+	const { locale } = useLocale();
+	return useMemo(() => createIntlObject(locale, createDictionaryLookup(key, content)), [
+		locale,
+		key,
+		content
+	]);
+};
+
+//#endregion
+export { useDictionaryDynamic };
+//# sourceMappingURL=useDictionaryDynamic.mjs.map

package/dist/esm/useDictionaryDynamic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionaryDynamic.mjs","names":["useDictionaryDynamicBase"],"sources":["../../src/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useMemo } from 'react';\nimport {\n  useDictionaryDynamic as useDictionaryDynamicBase,\n  useLocale,\n} from 'react-intlayer';\nimport { createIntlObject } from './createIntlObject';\nimport type { DictionaryIntlShape } from './dictionaryIntlShape';\nimport { createDictionaryLookup } from './useDictionary';\n\n/**\n * Dynamic dictionary-accepting variant of `useIntl`.\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 DictionaryKeys,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K\n): DictionaryIntlShape<K> => {\n  const content = useDictionaryDynamicBase<T, K>(dictionaryPromise, key);\n  const { locale } = useLocale();\n\n  return useMemo(\n    () =>\n      createIntlObject(\n        locale as LocalesValues,\n        createDictionaryLookup(key, content)\n      ) as DictionaryIntlShape<K>,\n    [locale, key, content]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;AAuBA,MAAa,wBAIX,mBACA,QAC2B;CAC3B,MAAM,UAAUA,uBAA+B,mBAAmB,GAAG;CACrE,MAAM,EAAE,WAAW,UAAU;CAE7B,OAAO,cAEH,iBACE,QACA,uBAAuB,KAAK,OAAO,CACrC,GACF;EAAC;EAAQ;EAAK;CAAO,CACvB;AACF"}

package/dist/types/FormattedComponents.d.ts

@@ -1,5 +1,4 @@
 import { FormattedDate as FormattedDate$1, FormattedDateParts as FormattedDateParts$1, FormattedDateTimeRange as FormattedDateTimeRange$1, FormattedDisplayName as FormattedDisplayName$1, FormattedList as FormattedList$1, FormattedListParts as FormattedListParts$1, FormattedNumber as FormattedNumber$1, FormattedNumberParts as FormattedNumberParts$1, FormattedPlural as FormattedPlural$1, FormattedRelativeTime as FormattedRelativeTime$1, FormattedTime as FormattedTime$1, FormattedTimeParts as FormattedTimeParts$1 } from "react-intl";
-
 //#region src/FormattedComponents.d.ts
 /**
  * Drop-in for react-intl's `<FormattedDate>`.

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

@@ -1 +1 @@
-{"version":3,"file":"FormattedComponents.d.ts","names":[],"sources":["../../src/FormattedComponents.tsx"],"mappings":";;;;;AA8BA;;cAAa,aAAA,SAAsB,eAYlC;;AAAA;AAMD;;cAAa,aAAA,SAAsB,eAYlC;;AAAA;AAMD;;cAAa,eAAA,SAAwB,iBAYpC;;AAAA;AAMD;;cAAa,aAAA,SAAsB,eAOlC;;AAAA;AAMD;;cAAa,oBAAA,SAA6B,sBAUzC;;AAAA;AAOD;;;cAAa,qBAAA,SAA8B,uBAa1C;AAAA;AAMD;;;AANC,cAMY,eAAA,SAAwB,iBA6BpC;AAAA;AAMD;;;AANC,cAMY,sBAAA,SAA+B,wBAY3C;AAAA;AAMD;;;AANC,cAMY,kBAAA,SAA2B,oBAYvC;AAAA;AAMD;;;AANC,cAMY,kBAAA,SAA2B,oBAYvC;AAAA;AAMD;;;AANC,cAMY,oBAAA,SAA6B,sBASzC;AAAA;AAMD;;;AANC,cAMY,kBAAA,SAA2B,oBAWvC"}
+{"version":3,"file":"FormattedComponents.d.ts","names":[],"sources":["../../src/FormattedComponents.tsx"],"mappings":";;;;;;cA8Ba,sBAAsB;;;;;cAkBtB,sBAAsB;;;;;cAkBtB,wBAAwB;;;;;cAkBxB,sBAAsB;;;;;cAatB,6BAA6B;;;;;;cAiB7B,8BAA8B;;;;;cAmB9B,wBAAwB;;;;;cAmCxB,+BAA+B;;;;;cAkB/B,2BAA2B;;;;;cAkB3B,2BAA2B;;;;;cAkB3B,6BAA6B;;;;;cAe7B,2BAA2B"}

package/dist/types/FormattedMessage.d.ts

@@ -1,5 +1,4 @@
 import { FormattedMessage as FormattedMessage$1 } from "react-intl";
-
 //#region src/FormattedMessage.d.ts
 /**
  * Drop-in for react-intl's `<FormattedMessage>`.

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

@@ -1 +1 @@
-{"version":3,"file":"FormattedMessage.d.ts","names":[],"sources":["../../src/FormattedMessage.tsx"],"mappings":";;;;;AA2BA;;;;AAgCC;;;;;;;;;;;;;;;cAhCY,gBAAA,SAAyB,kBAgCrC"}
+{"version":3,"file":"FormattedMessage.d.ts","names":[],"sources":["../../src/FormattedMessage.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;cA2Ba,yBAAyB"}

package/dist/types/IntlProvider.d.ts

@@ -1,5 +1,4 @@
 import { IntlProvider as IntlProvider$1 } from "react-intl";
-
 //#region src/IntlProvider.d.ts
 /**
  * Drop-in for react-intl's `IntlProvider`.

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

@@ -1 +1 @@
-{"version":3,"file":"IntlProvider.d.ts","names":[],"sources":["../../src/IntlProvider.tsx"],"mappings":";;;;;AAqBA;;;;AAgCC;;;cAhCY,YAAA,SAAqB,cAgCjC"}
+{"version":3,"file":"IntlProvider.d.ts","names":[],"sources":["../../src/IntlProvider.tsx"],"mappings":";;;;;;;;;;;cAqBa,qBAAqB"}

package/dist/types/context.d.ts

@@ -1,5 +1,4 @@
 import { IntlShape } from "react-intl";
-
 //#region src/context.d.ts
 /**
  * React context holding the active intlayer-backed `IntlShape` instance.

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/context.tsx"],"mappings":";;;;;AAOA;;cAAa,WAAA,kBAAW,OAAA,CAAA,SAAA;;cAKX,eAAA,kBAAe,QAAA,CAAA,SAAA"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/context.tsx"],"mappings":";;;;;;cAOa,6BAAW,QAAA;;cAKX,iCAAe,SAAA"}

package/dist/types/createIntl.d.ts

@@ -1,5 +1,4 @@
 import { createIntl as createIntl$1, createIntlCache as createIntlCache$1 } from "react-intl";
-
 //#region src/createIntl.d.ts
 /**
  * Drop-in for react-intl's `createIntlCache`.

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

@@ -1 +1 @@
-{"version":3,"file":"createIntl.d.ts","names":[],"sources":["../../src/createIntl.ts"],"mappings":";;;;;AAoBA;;;;AASiB;AAmBjB;;;cA5Ba,eAAA,SAAwB,iBASpB;AAsBwC;;;;;;;;;;;;;;;;;AAAA,cAH5C,UAAA,SAAmB,YAGyB"}
+{"version":3,"file":"createIntl.d.ts","names":[],"sources":["../../src/createIntl.ts"],"mappings":";;;;;;;;;;;;cAoBa,wBAAwB;;;;;;;;;;;;;;;;;;cA4BxB,mBAAmB"}

package/dist/types/createIntlObject.d.ts

@@ -1,6 +1,5 @@
 import { IntlShape } from "react-intl";
 import { LocalesValues } from "@intlayer/types/module_augmentation";
-
 //#region src/createIntlObject.d.ts
 /**
  * Builds an intlayer-backed `IntlShape` object for the given locale.
@@ -8,8 +7,12 @@ import { LocalesValues } from "@intlayer/types/module_augmentation";
  * - Translation ids use the first dot-path segment as the dictionary key.
  * - Full ICU MessageFormat syntax is supported via `@intlayer/core/messageFormat`.
  * - Rich text tags (`<b>chunks</b>`) are resolved through render functions in `values`.
+ *
+ * @param locale - The locale messages are resolved for.
+ * @param lookupOverride - Optional message lookup replacing the registry-based
+ *   id resolution; used by the dictionary-bound `useDictionary` variant.
  */
-declare const createIntlObject: (locale: LocalesValues) => IntlShape;
+declare const createIntlObject: (locale: LocalesValues, lookupOverride?: (id: string) => unknown) => IntlShape;
 //#endregion
 export { createIntlObject };
 //# sourceMappingURL=createIntlObject.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createIntlObject.d.ts","names":[],"sources":["../../src/createIntlObject.tsx"],"mappings":";;;;;;AAiGA;;;;;cAAa,gBAAA,GAAoB,MAAA,EAAQ,aAAA,KAAgB,SAqJxD"}
+{"version":3,"file":"createIntlObject.d.ts","names":[],"sources":["../../src/createIntlObject.tsx"],"mappings":";;;;;;;;;;;;;;cAqFa,mBAAgB,QACnB,eAAa,kBACH,2BACjB"}

package/dist/types/defineMessages.d.ts

@@ -1,5 +1,4 @@
 import { defineMessage as defineMessage$1, defineMessages as defineMessages$1 } from "react-intl";
-
 //#region src/defineMessages.d.ts
 /**
  * Drop-in for react-intl's `defineMessages`.

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

@@ -1 +1 @@
-{"version":3,"file":"defineMessages.d.ts","names":[],"sources":["../../src/defineMessages.ts"],"mappings":";;;;;AAWA;;;;cAAa,cAAA,SAAuB,gBAAwC;AAM5E;;;;AAAA,cAAa,aAAA,SAAsB,eAAqC"}
+{"version":3,"file":"defineMessages.d.ts","names":[],"sources":["../../src/defineMessages.ts"],"mappings":";;;;;;;;cAWa,uBAAuB;;;;;cAMvB,sBAAsB"}

package/dist/types/dictionaryIntlShape.d.ts

@@ -0,0 +1,53 @@
+import { IntlShape, MessageDescriptor, PrimitiveType } from "react-intl";
+import { DictionaryKeys } from "@intlayer/types/module_augmentation";
+import { GetNestingResult } from "@intlayer/core/interpreter";
+import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { ReactNode } from "react";
+//#region src/dictionaryIntlShape.d.ts
+/**
+ * The interpreter-resolved content type at dot-path `P` of dictionary `N` —
+ * the same type strength as the base `useIntlayer` hook.
+ */
+type ContentAtPath<N extends DictionaryKeys, P> = GetNestingResult<N, P>;
+/**
+ * The value returned by `formatMessage` for the path `P` of dictionary `N`:
+ * string literals declared in the dictionary keep their literal type, every
+ * other node resolves to `string` at runtime.
+ */
+type TranslatedValue<N extends DictionaryKeys, P> = ContentAtPath<N, P> extends string ? ContentAtPath<N, P> : string;
+/**
+ * Ids accepted by a dictionary-bound intl object: the dictionary's dot-paths,
+ * either relative (`'title'`) or absolute (`'home.title'`).
+ */
+type DictionaryMessageIds<N extends DictionaryKeys> = ValidDotPathsFor<N> | `${N & string}.${ValidDotPathsFor<N> & string}`;
+/**
+ * Resolves the translated value type for an id: the absolute form strips the
+ * leading `<dictionaryKey>.` first, matching the runtime lookup.
+ */
+type MessageValueForId<N extends DictionaryKeys, Id extends string> = Id extends `${N & string}.${infer RelativePath}` ? TranslatedValue<N, RelativePath> : TranslatedValue<N, Id>;
+/**
+ * `formatMessage` bound to dictionary `N`: ids are validated against the
+ * dictionary's dot-paths and the return type is resolved from the content at
+ * that path. With rich-text render functions in `values`, React nodes are
+ * returned.
+ */
+type TypedFormatMessage<N extends DictionaryKeys> = {
+  <Id extends DictionaryMessageIds<N> & string>(descriptor: Omit<MessageDescriptor, 'id'> & {
+    id: Id;
+  }, values?: Record<string, PrimitiveType>): MessageValueForId<N, Id>;
+  <Id extends DictionaryMessageIds<N> & string>(descriptor: Omit<MessageDescriptor, 'id'> & {
+    id: Id;
+  }, values?: Record<string, ReactNode | PrimitiveType | ((chunks: ReactNode) => ReactNode)>): string | ReactNode[];
+};
+/**
+ * `IntlShape` whose `formatMessage` / `$t` are typed against the dictionary
+ * `N`. Returned by the dictionary-bound `useDictionary` /
+ * `useDictionaryDynamic` variants.
+ */
+type DictionaryIntlShape<N extends DictionaryKeys> = Omit<IntlShape, 'formatMessage' | '$t'> & {
+  formatMessage: TypedFormatMessage<N>;
+  $t: TypedFormatMessage<N>;
+};
+//#endregion
+export { DictionaryIntlShape, DictionaryMessageIds, MessageValueForId, TypedFormatMessage };
+//# sourceMappingURL=dictionaryIntlShape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryIntlShape.d.ts","names":[],"sources":["../../src/dictionaryIntlShape.ts"],"mappings":";;;;;;;;;;KAUK,cAAc,UAAU,gBAAgB,KAAK,iBAAiB,GAAG;;;;;;KAOjE,gBAAgB,UAAU,gBAAgB,KAC7C,cAAc,GAAG,oBAAoB,cAAc,GAAG;;;;;KAM5C,qBAAqB,UAAU,kBACvC,iBAAiB,QACd,cAAc,iBAAiB;;;;;KAM1B,kBACV,UAAU,gBACV,qBACE,cAAc,oBAAoB,iBAClC,gBAAgB,GAAG,gBACnB,gBAAgB,GAAG;;;;;;;KAQX,mBAAmB,UAAU;GACtC,WAAW,qBAAqB,aAC/B,YAAY,KAAK;IAA6B,IAAI;KAClD,SAAS,eAAe,iBACvB,kBAAkB,GAAG;GACvB,WAAW,qBAAqB,aAC/B,YAAY,KAAK;IAA6B,IAAI;KAClD,SAAS,eAEP,YAAY,kBAAkB,QAAQ,cAAc,uBAE5C;;;;;;;KAQF,oBAAoB,UAAU,kBAAkB,KAC1D;EAGA,eAAe,mBAAmB;EAClC,IAAI,mBAAmB"}

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/errors.ts"],"mappings":";;AAMA;;;;;aAAY,kBAAA;EACV,YAAA;EACA,qBAAA;EACA,cAAA;EACA,YAAA;EACA,mBAAA;AAAA;;;;;;cAQW,cAAA,SAAuB,KAAA;EAAA,SAClB,IAAA,EAAM,kBAAA;cAEV,IAAA,EAAM,kBAAA,EAAoB,OAAA;AAAA;;;;cAU3B,kBAAA,SAA2B,cAAc;cACxC,OAAA;AAAA;AAXyC;AAUvD;;AAVuD,cAoB1C,kBAAA,SAA2B,cAAc;cACxC,OAAA;AAAA;;;;cASD,gBAAA,SAAyB,cAAc;cACtC,OAAA;AAAA;;;;cASD,uBAAA,SAAgC,cAAc;cAC7C,OAAA;AAAA;AApBe;AAS7B;;AAT6B,cA6BhB,yBAAA,SAAkC,cAAc;cAC/C,OAAA;AAAA"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/errors.ts"],"mappings":";;;;;;;aAMY;EACV;EACA;EACA;EACA;EACA;;;;;;;cAQW,uBAAuB;WAClB,MAAM;EAEtB,YAAY,MAAM,oBAAoB;;;;;cAU3B,2BAA2B;EACtC,YAAY;;;;;cASD,2BAA2B;EACtC,YAAY;;;;;cASD,yBAAyB;EACpC,YAAY;;;;;cASD,gCAAgC;EAC3C,YAAY;;;;;cASD,kCAAkC;EAC7C,YAAY"}

package/dist/types/index.d.ts

@@ -4,7 +4,11 @@ import { IntlProvider } from "./IntlProvider.js";
 import { IntlContext, RawIntlProvider } from "./context.js";
 import { createIntl, createIntlCache } from "./createIntl.js";
 import { defineMessage, defineMessages } from "./defineMessages.js";
+import { DictionaryIntlShape, DictionaryMessageIds, MessageValueForId, TypedFormatMessage } from "./dictionaryIntlShape.js";
 import { InvalidConfigError, MessageFormatError, MissingDataError, MissingTranslationError, ReactIntlError, ReactIntlErrorCode, UnsupportedFormatterError } from "./errors.js";
+import { RootMessageIds } from "./typedMessageIds.js";
+import { useDictionary } from "./useDictionary.js";
+import { useDictionaryDynamic } from "./useDictionaryDynamic.js";
 import { useIntl } from "./useIntl.js";
 import { CustomFormats, FormatDateOptions, FormatDisplayNameOptions, FormatListOptions, FormatNumberOptions, FormatPluralOptions, FormatRelativeTimeOptions, Formatters, IntlCache, IntlConfig, IntlFormatters, IntlShape, MessageDescriptor, MessageFormatElement, PrimitiveType, ResolvedIntlConfig } from "react-intl";
-export { type CustomFormats, type FormatDateOptions, type FormatDisplayNameOptions, type FormatListOptions, type FormatNumberOptions, type FormatPluralOptions, type FormatRelativeTimeOptions, FormattedDate, FormattedDateParts, FormattedDateTimeRange, FormattedDisplayName, FormattedList, FormattedListParts, FormattedMessage, FormattedNumber, FormattedNumberParts, FormattedPlural, FormattedRelativeTime, FormattedTime, FormattedTimeParts, type Formatters, type IntlCache, type IntlConfig, IntlContext, type IntlFormatters, IntlProvider, type IntlShape, InvalidConfigError, type MessageDescriptor, type MessageFormatElement, MessageFormatError, MissingDataError, MissingTranslationError, type PrimitiveType, RawIntlProvider, ReactIntlError, ReactIntlErrorCode, type ResolvedIntlConfig, UnsupportedFormatterError, createIntl, createIntlCache, defineMessage, defineMessages, useIntl };
+export { type CustomFormats, type DictionaryIntlShape, type DictionaryMessageIds, type FormatDateOptions, type FormatDisplayNameOptions, type FormatListOptions, type FormatNumberOptions, type FormatPluralOptions, type FormatRelativeTimeOptions, FormattedDate, FormattedDateParts, FormattedDateTimeRange, FormattedDisplayName, FormattedList, FormattedListParts, FormattedMessage, FormattedNumber, FormattedNumberParts, FormattedPlural, FormattedRelativeTime, FormattedTime, FormattedTimeParts, type Formatters, type IntlCache, type IntlConfig, IntlContext, type IntlFormatters, IntlProvider, type IntlShape, InvalidConfigError, type MessageDescriptor, type MessageFormatElement, MessageFormatError, type MessageValueForId, MissingDataError, MissingTranslationError, type PrimitiveType, RawIntlProvider, ReactIntlError, ReactIntlErrorCode, type ResolvedIntlConfig, type RootMessageIds, type TypedFormatMessage, UnsupportedFormatterError, createIntl, createIntlCache, defineMessage, defineMessages, useDictionary, useDictionaryDynamic, useIntl };

package/dist/types/plugin/index.d.ts

@@ -1,6 +1,5 @@
 import { PluginOption } from "vite";
 import { intlayer } from "vite-intlayer";
-
 //#region src/plugin/index.d.ts
 /**
  * A Vite plugin for react-intl compat that wraps vite-intlayer

package/dist/types/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/plugin/index.ts"],"mappings":";;;;;;AAiEA;;;;;;;;;;;;;cAAa,mBAAA,GACX,OAAA,GAAU,UAAA,QAAkB,QAAA,SAC3B,YAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/plugin/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;cAwBa,sBAAmB,UACpB,kBAAkB,iBAC3B"}

package/dist/types/typedMessageIds.d.ts

@@ -0,0 +1,25 @@
+import { DictionaryKeys } from "@intlayer/types/module_augmentation";
+import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+//#region src/typedMessageIds.d.ts
+/**
+ * Every valid react-intl message id: `<dictionaryKey>.<dotPath>`, where the
+ * first segment designates the intlayer dictionary. Falls back to `string`
+ * when no dictionary registry is declared (e.g. before the first build).
+ */
+type RootMessageIds = string extends DictionaryKeys ? string : { [K in DictionaryKeys]: `${K & string}.${ValidDotPathsFor<K> & string}`; }[DictionaryKeys];
+declare global {
+  namespace FormatjsIntl {
+    interface Message {
+      /**
+       * Types every react-intl message id (`formatMessage`,
+       * `<FormattedMessage>`, `defineMessages`, …) against the intlayer
+       * dictionary registry — the same strength as the base `useIntlayer`
+       * hook.
+       */
+      ids: RootMessageIds;
+    }
+  }
+}
+//#endregion
+export { RootMessageIds };
+//# sourceMappingURL=typedMessageIds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typedMessageIds.d.ts","names":[],"sources":["../../src/typedMessageIds.ts"],"mappings":";;;;;;;;KAQY,gCAAgC,6BAGrC,KAAK,oBAAoB,cAAc,iBAAiB,iBACzD;QAEE;YACI;cACE;;;;;;;MAOR,KAAK"}

package/dist/types/useDictionary.d.ts

@@ -0,0 +1,30 @@
+import { DictionaryIntlShape } from "./dictionaryIntlShape.js";
+import { DictionaryKeys } from "@intlayer/types/module_augmentation";
+import { Dictionary } from "@intlayer/types/dictionary";
+//#region src/useDictionary.d.ts
+/**
+ * Builds the id lookup of a dictionary-bound intl object.
+ *
+ * react-intl ids encode the dictionary key as their first dot-segment
+ * (`'home.title'` → dictionary `home`, field `title`). When the content is
+ * supplied directly, the leading `<dictionaryKey>.` is stripped so both the
+ * absolute (`'home.title'`) and relative (`'title'`) forms resolve.
+ */
+declare const createDictionaryLookup: (dictionaryKey: string, content: unknown) => (id: string) => unknown;
+/**
+ * Dictionary-accepting variant of `useIntl`.
+ *
+ * Returns an `IntlShape` whose `formatMessage` resolves ids inside the
+ * supplied dictionary instead of the runtime registry, enabling tree-shaking
+ * of unused locale content. All `Intl`-backed formatters (`formatNumber`,
+ * `formatDate`, …) behave exactly like `useIntl()`.
+ *
+ * @example
+ * import _abc from '.intlayer/dictionaries/home.json' with { type: 'json' };
+ * const intl = useDictionary(_abc);
+ * intl.formatMessage({ id: 'home.title' }); // or { id: 'title' } — both typed
+ */
+declare const useDictionary: <T extends Dictionary>(dictionary: T) => DictionaryIntlShape<T['key'] & DictionaryKeys>;
+//#endregion
+export { createDictionaryLookup, useDictionary };
+//# sourceMappingURL=useDictionary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../src/useDictionary.ts"],"mappings":";;;;;;;;;;;;cAqBa,yBAAsB,uBACX,sBAAkB;;;;;;;;;;;;;;cAuB7B,gBAAiB,UAAU,YAAU,YACpC,MACX,oBAAoB,WAAW"}

package/dist/types/useDictionaryDynamic.d.ts

@@ -0,0 +1,14 @@
+import { DictionaryIntlShape } from "./dictionaryIntlShape.js";
+import { DictionaryKeys, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
+import { Dictionary } from "@intlayer/types/dictionary";
+//#region src/useDictionaryDynamic.d.ts
+/**
+ * Dynamic dictionary-accepting variant of `useIntl`.
+ *
+ * Counterpart to {@link useDictionary} for dictionaries imported lazily per
+ * locale. Used internally by the build-time optimization.
+ */
+declare const useDictionaryDynamic: <const T extends Dictionary, const K extends DictionaryKeys>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K) => DictionaryIntlShape<K>;
+//#endregion
+export { useDictionaryDynamic };
+//# sourceMappingURL=useDictionaryDynamic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../src/useDictionaryDynamic.ts"],"mappings":";;;;;;;;;;cAuBa,6BACL,UAAU,kBACV,UAAU,gBAAc,mBAEX,0BAA0B,QAAQ,KAAG,KACnD,MACJ,oBAAoB"}

package/dist/types/useIntl.d.ts

@@ -1,5 +1,4 @@
 import { useIntl as useIntl$1 } from "react-intl";
-
 //#region src/useIntl.d.ts
 /**
  * Drop-in for react-intl's `useIntl`.

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

@@ -1 +1 @@
-{"version":3,"file":"useIntl.d.ts","names":[],"sources":["../../src/useIntl.ts"],"mappings":";;;;;AAuBA;;;;AAUC;;;;;;;;cAVY,OAAA,SAAgB,SAU5B"}
+{"version":3,"file":"useIntl.d.ts","names":[],"sources":["../../src/useIntl.ts"],"mappings":";;;;;;;;;;;;;;;;cAuBa,gBAAgB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/react-intl",
-  "version": "9.0.0-canary.2",
+  "version": "9.0.0-canary.21",
   "private": false,
   "description": "react-intl API adapter for intlayer — drop-in compatibility layer",
   "keywords": [
@@ -34,17 +34,15 @@
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
-      "require": "./dist/cjs/index.cjs",
       "import": "./dist/esm/index.mjs"
     },
     "./plugin": {
       "types": "./dist/types/plugin/index.d.ts",
-      "require": "./dist/cjs/plugin/index.cjs",
       "import": "./dist/esm/plugin/index.mjs"
     },
     "./package.json": "./package.json"
   },
-  "main": "dist/cjs/index.cjs",
+  "main": "dist/esm/index.mjs",
   "module": "dist/esm/index.mjs",
   "types": "dist/types/index.d.ts",
   "typesVersions": {
@@ -76,26 +74,26 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/chokidar": "9.0.0-canary.2",
-    "@intlayer/config": "9.0.0-canary.2",
-    "@intlayer/core": "9.0.0-canary.2",
-    "@intlayer/dictionaries-entry": "9.0.0-canary.2",
-    "@intlayer/types": "9.0.0-canary.2",
-    "react-intlayer": "9.0.0-canary.2",
-    "vite-intlayer": "9.0.0-canary.2"
+    "@intlayer/config": "9.0.0-canary.21",
+    "@intlayer/core": "9.0.0-canary.21",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.21",
+    "@intlayer/engine": "9.0.0-canary.21",
+    "@intlayer/types": "9.0.0-canary.21",
+    "react-intlayer": "9.0.0-canary.21",
+    "vite-intlayer": "9.0.0-canary.21"
   },
   "devDependencies": {
-    "@types/node": "25.9.3",
+    "@types/node": "26.1.1",
     "@types/react": "19.1.8",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
-    "react-intl": "^10.1.13",
+    "react-intl": "^10.1.18",
     "rimraf": "6.1.3",
-    "tsdown": "0.22.2",
-    "typescript": "6.0.3",
-    "vite": "8.0.16",
-    "vitest": "4.1.9"
+    "tsdown": "0.22.12",
+    "typescript": "7.0.2",
+    "vite": "8.1.5",
+    "vitest": "4.1.10"
   },
   "peerDependencies": {
     "react": ">=16.0.0",