angular-intlayer 8.12.5-canary.0 → 9.0.0-canary.0

package/dist/cjs/client/useDictionary.cjs

@@ -5,10 +5,21 @@ const require_client_intlayerToken = require('./intlayerToken.cjs');
 let _angular_core = require("@angular/core");
 
 //#region src/client/useDictionary.ts
-const useDictionary = (dictionary, locale) => {
+/**
+* Angular hook that transforms a dictionary (or qualified dictionary group)
+* and returns its reactive content for the given locale or selector.
+*/
+const useDictionary = (dictionary, localeOrSelector) => {
 	const intlayer = (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN);
-	const localeTarget = (0, _angular_core.computed)(() => locale ?? intlayer?.locale());
-	return (0, _angular_core.computed)(() => require_getDictionary.getDictionary(dictionary, localeTarget()));
+	const isSelector = typeof localeOrSelector === "object" && localeOrSelector !== null;
+	return (0, _angular_core.computed)(() => {
+		const currentLocale = intlayer?.locale();
+		if (isSelector) return require_getDictionary.getDictionary(dictionary, {
+			...localeOrSelector,
+			locale: localeOrSelector.locale ?? currentLocale
+		});
+		return require_getDictionary.getDictionary(dictionary, localeOrSelector ?? currentLocale);
+	});
 };
 
 //#endregion

package/dist/cjs/client/useDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.cjs","names":["INTLAYER_TOKEN","getDictionary"],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\nexport const useDictionary = <const T extends Dictionary>(\n  dictionary: T,\n  locale?: LocalesValues\n): Signal<DeepTransformContent<T['content']>> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  const localeTarget = computed(() => locale ?? intlayer?.locale());\n\n  /** a *stable* reactive dictionary object */\n  const content = computed(\n    () => getDictionary<T, LocalesValues>(dictionary, localeTarget()) as any\n  );\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;;AAOA,MAAa,iBACX,YACA,WAC+C;CAC/C,MAAM,qCAAoCA,4CAAe;CAEzD,MAAM,iDAA8B,UAAU,UAAU,QAAQ,CAAC;AAOjE,0CAHQC,oCAAgC,YAAY,cAAc,CAAC,CAGrD"}
+{"version":3,"file":"useDictionary.cjs","names":["INTLAYER_TOKEN","getDictionary"],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\n/**\n * Angular hook that transforms a dictionary (or qualified dictionary group)\n * and returns its reactive content for the given locale or selector.\n */\nexport const useDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): Signal<\n  DeepTransformContent<\n    ResolveQualifiedDictionaryContent<T, A>,\n    ExtractSelectorLocale<A>\n  >\n> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  const isSelector =\n    typeof localeOrSelector === 'object' && localeOrSelector !== null;\n\n  /** a *stable* reactive dictionary object */\n  const content = computed(() => {\n    const currentLocale = intlayer?.locale();\n\n    if (isSelector) {\n      return getDictionary(dictionary, {\n        ...localeOrSelector,\n        locale: localeOrSelector.locale ?? currentLocale,\n      } as A) as any;\n    }\n\n    return getDictionary(\n      dictionary,\n      (localeOrSelector ?? currentLocale) as A\n    ) as any;\n  });\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;;;;;;AAqBA,MAAa,iBAMX,YACA,qBAMG;CACH,MAAM,qCAAoCA,4CAAe;CAEzD,MAAM,aACJ,OAAO,qBAAqB,YAAY,qBAAqB;AAmB/D,0CAhB+B;EAC7B,MAAM,gBAAgB,UAAU,QAAQ;AAExC,MAAI,WACF,QAAOC,oCAAc,YAAY;GAC/B,GAAG;GACH,QAAQ,iBAAiB,UAAU;GACpC,CAAM;AAGT,SAAOA,oCACL,YACC,oBAAoB,cACtB;GAGW"}

package/dist/cjs/client/useDictionaryDynamic.cjs

@@ -2,20 +2,42 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_getDictionary = require('../getDictionary.cjs');
 const require_client_intlayerToken = require('./intlayerToken.cjs');
 const require_client_useDictionary = require('./useDictionary.cjs');
 const require_client_useLoadDynamic = require('./useLoadDynamic.cjs');
 let _intlayer_config_built = require("@intlayer/config/built");
 let _angular_core = require("@angular/core");
+let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useDictionaryDynamic.ts
 /**
-* On the server side, Hook that transform a dictionary and return the content
+* Lazily loads a dictionary (plain or qualified) and returns its reactive
+* content.
 *
-* If the locale is not provided, it will use the locale from the client context
+* For a qualified loader map (collection / variant / meta record, possibly
+* combined), only the chunk(s) the selector targets are loaded. For a plain
+* loader map, the locale chunk is loaded.
+*
+* If the locale is not provided (directly or through the selector), it will use
+* the locale from the client context.
 */
-const useDictionaryDynamic = (dictionaryPromise, key, locale) => {
+const useDictionaryDynamic = (dictionaryPromise, key, localeOrSelector) => {
 	const intlayer = (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN);
+	if ((0, _intlayer_core_dictionaryManipulator.isQualifiedDynamicLoaderMap)(dictionaryPromise)) {
+		const { locale: selectorLocale, selector } = (0, _intlayer_core_dictionaryManipulator.parseDictionarySelector)(localeOrSelector);
+		const localeTarget = selectorLocale ?? intlayer?.locale() ?? _intlayer_config_built.internationalization.defaultLocale;
+		const container = (0, _angular_core.signal)(void 0);
+		(0, _intlayer_core_dictionaryManipulator.resolveQualifiedDynamicContentAsync)({
+			loaderMap: dictionaryPromise,
+			key: String(key),
+			locale: localeTarget,
+			selector,
+			transform: (dictionary) => require_getDictionary.getDictionary(dictionary, localeTarget)
+		}).then((resolved) => container.set(resolved));
+		return (0, _angular_core.computed)(() => container());
+	}
+	const locale = typeof localeOrSelector === "string" ? localeOrSelector : void 0;
 	const localeTarget = (0, _angular_core.computed)(() => locale ?? intlayer?.locale() ?? _intlayer_config_built.internationalization.defaultLocale);
 	return require_client_useDictionary.useDictionary(require_client_useLoadDynamic.useLoadDynamic(`${String(key)}.${localeTarget()}`, dictionaryPromise[localeTarget()]?.()), localeTarget());
 };

package/dist/cjs/client/useDictionaryDynamic.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.cjs","names":["INTLAYER_TOKEN","internationalization","useDictionary","useLoadDynamic"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport { computed, inject } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\nimport { useDictionary } from './useDictionary';\nimport { useLoadDynamic } from './useLoadDynamic';\n\n/**\n * On the server side, Hook that transform a dictionary and return the content\n *\n * If the locale is not provided, it will use the locale from the client context\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  locale?: LocalesValues\n) => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  const localeTarget = computed(\n    () => locale ?? intlayer?.locale() ?? internationalization.defaultLocale\n  );\n\n  const dictionary = useLoadDynamic<T>(\n    `${String(key)}.${localeTarget()}`,\n    (dictionaryPromise as any)[localeTarget()]?.()\n  ) as T;\n\n  return useDictionary(dictionary, localeTarget() as any);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAa,wBAIX,mBACA,KACA,WACG;CACH,MAAM,qCAAoCA,4CAAe;CAEzD,MAAM,iDACE,UAAU,UAAU,QAAQ,IAAIC,4CAAqB,cAC5D;AAOD,QAAOC,2CALYC,6CACjB,GAAG,OAAO,IAAI,CAAC,GAAG,cAAc,IAC/B,kBAA0B,cAAc,KAAK,CAGjB,EAAE,cAAc,CAAQ"}
+{"version":3,"file":"useDictionaryDynamic.cjs","names":["INTLAYER_TOKEN","internationalization","getDictionary","useDictionary","useLoadDynamic"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport { computed, inject, signal } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport {\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\n  DictionarySelector,\n} from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\nimport { useDictionary } from './useDictionary';\nimport { useLoadDynamic } from './useLoadDynamic';\n\n/**\n * Lazily loads a dictionary (plain or qualified) and returns its reactive\n * content.\n *\n * For a qualified loader map (collection / variant / meta record, possibly\n * combined), only the chunk(s) the selector targets are loaded. For a plain\n * loader map, the locale chunk is loaded.\n *\n * If the locale is not provided (directly or through the selector), it will use\n * the locale from the client context.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = LocalesValues,\n>(\n  dictionaryPromise:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n) => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  if (isQualifiedDynamicLoaderMap(dictionaryPromise)) {\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(localeOrSelector);\n\n    const localeTarget =\n      selectorLocale ??\n      intlayer?.locale() ??\n      internationalization.defaultLocale;\n\n    const container = signal<unknown>(undefined);\n\n    resolveQualifiedDynamicContentAsync({\n      loaderMap: dictionaryPromise,\n      key: String(key),\n      locale: localeTarget,\n      selector,\n      transform: (dictionary) => getDictionary(dictionary, localeTarget),\n    }).then((resolved) => container.set(resolved));\n\n    return computed(() => container() as any);\n  }\n\n  const locale =\n    typeof localeOrSelector === 'string'\n      ? (localeOrSelector as LocalesValues)\n      : undefined;\n\n  const localeTarget = computed(\n    () => locale ?? intlayer?.locale() ?? internationalization.defaultLocale\n  );\n\n  const dictionary = useLoadDynamic<T>(\n    `${String(key)}.${localeTarget()}`,\n    (dictionaryPromise as any)[localeTarget()]?.()\n  ) as T;\n\n  return useDictionary(dictionary, localeTarget() as any);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,wBAKX,mBAGA,KACA,qBACG;CACH,MAAM,qCAAoCA,4CAAe;AAEzD,2EAAgC,kBAAkB,EAAE;EAClD,MAAM,EAAE,QAAQ,gBAAgB,+EACS,iBAAiB;EAE1D,MAAM,eACJ,kBACA,UAAU,QAAQ,IAClBC,4CAAqB;EAEvB,MAAM,sCAA4B,OAAU;AAE5C,gFAAoC;GAClC,WAAW;GACX,KAAK,OAAO,IAAI;GAChB,QAAQ;GACR;GACA,YAAY,eAAeC,oCAAc,YAAY,aAAa;GACnE,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,SAAS,CAAC;AAE9C,2CAAsB,WAAW,CAAQ;;CAG3C,MAAM,SACJ,OAAO,qBAAqB,WACvB,mBACD;CAEN,MAAM,iDACE,UAAU,UAAU,QAAQ,IAAID,4CAAqB,cAC5D;AAOD,QAAOE,2CALYC,6CACjB,GAAG,OAAO,IAAI,CAAC,GAAG,cAAc,IAC/B,kBAA0B,cAAc,KAAK,CAGjB,EAAE,cAAc,CAAQ"}

package/dist/cjs/client/useIntlayer.cjs

@@ -32,11 +32,17 @@ const isUpdatableNode = (val) => !!val && typeof val === "object" && typeof val.
 * }
 * ```
 */
-const useIntlayer = (key, locale) => {
+const useIntlayer = (key, localeOrSelector) => {
 	const intlayer = (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN);
-	/** which locale should we use right now? */
-	const localeTarget = (0, _angular_core.computed)(() => locale ?? intlayer.locale());
-	return (0, _angular_core.computed)(() => require_getIntlayer.getIntlayer(key, localeTarget()));
+	const isSelector = typeof localeOrSelector === "object" && localeOrSelector !== null;
+	return (0, _angular_core.computed)(() => {
+		const currentLocale = intlayer.locale();
+		if (isSelector) return require_getIntlayer.getIntlayer(key, {
+			...localeOrSelector,
+			locale: localeOrSelector.locale ?? currentLocale
+		});
+		return require_getIntlayer.getIntlayer(key, localeOrSelector ?? currentLocale);
+	});
 };
 
 //#endregion

package/dist/cjs/client/useIntlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useIntlayer.cjs","names":["INTLAYER_TOKEN","getIntlayer"],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type {\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayer } from '../getIntlayer';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\n/** guard utility - true only for objects generated by `renderIntlayerNode()` */\nexport const isUpdatableNode = (\n  val: unknown\n): val is { __update: (n: unknown) => void } =>\n  !!val &&\n  typeof val === 'object' &&\n  typeof (val as any).__update === 'function';\n\n/**\n * Angular hook that picks one dictionary by its key and returns its reactive content.\n *\n * It utilizes Angular signals to provide deep reactivity, ensuring your components\n * update automatically when the locale changes.\n *\n * @param key - The unique key of the dictionary to retrieve.\n * @param locale - Optional locale to override the current context locale.\n * @returns The transformed dictionary content.\n *\n * @example\n * ```ts\n * import { Component } from '@angular/core';\n * import { useIntlayer } from 'angular-intlayer';\n *\n * @Component({\n *   standalone: true,\n *   selector: 'app-my-component',\n *   template: `<div>{{ content().myField.value }}</div>`,\n * })\n * export class MyComponent {\n *   content = useIntlayer('my-dictionary-key');\n * }\n * ```\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const L extends LocalesValues,\n>(\n  key: T,\n  locale?: LocalesValues\n): Signal<DeepTransformContent<DictionaryRegistryContent<T>>> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN)!;\n\n  /** which locale should we use right now? */\n  const localeTarget = computed(() => locale ?? intlayer.locale());\n\n  /** a *stable* reactive dictionary object */\n  // @ts-ignore Type instantiation is excessively deep and possibly infinite\n  const content = computed(\n    () => getIntlayer<T, L>(key, localeTarget() as L) as any\n  );\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;;;AAWA,MAAa,mBACX,QAEA,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,OAAQ,IAAY,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BnC,MAAa,eAIX,KACA,WAC+D;CAC/D,MAAM,qCAAoCA,4CAAe;;CAGzD,MAAM,iDAA8B,UAAU,SAAS,QAAQ,CAAC;AAQhE,0CAHQC,gCAAkB,KAAK,cAAc,CAAM,CAGrC"}
+{"version":3,"file":"useIntlayer.cjs","names":["INTLAYER_TOKEN","getIntlayer"],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayer } from '../getIntlayer';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\n/** guard utility - true only for objects generated by `renderIntlayerNode()` */\nexport const isUpdatableNode = (\n  val: unknown\n): val is { __update: (n: unknown) => void } =>\n  !!val &&\n  typeof val === 'object' &&\n  typeof (val as any).__update === 'function';\n\n/**\n * Angular hook that picks one dictionary by its key and returns its reactive content.\n *\n * It utilizes Angular signals to provide deep reactivity, ensuring your components\n * update automatically when the locale changes.\n *\n * @param key - The unique key of the dictionary to retrieve.\n * @param locale - Optional locale to override the current context locale.\n * @returns The transformed dictionary content.\n *\n * @example\n * ```ts\n * import { Component } from '@angular/core';\n * import { useIntlayer } from 'angular-intlayer';\n *\n * @Component({\n *   standalone: true,\n *   selector: 'app-my-component',\n *   template: `<div>{{ content().myField.value }}</div>`,\n * })\n * export class MyComponent {\n *   content = useIntlayer('my-dictionary-key');\n * }\n * ```\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): Signal<\n  DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>\n> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN)!;\n\n  const isSelector =\n    typeof localeOrSelector === 'object' && localeOrSelector !== null;\n\n  /** a *stable* reactive dictionary object */\n  // @ts-ignore Type instantiation is excessively deep and possibly infinite\n  const content = computed(() => {\n    const currentLocale = intlayer.locale();\n\n    if (isSelector) {\n      return getIntlayer(key, {\n        ...localeOrSelector,\n        locale: localeOrSelector.locale ?? currentLocale,\n      } as A) as any;\n    }\n\n    return getIntlayer(key, (localeOrSelector ?? currentLocale) as A) as any;\n  });\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;;;AAeA,MAAa,mBACX,QAEA,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,OAAQ,IAAY,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BnC,MAAa,eAIX,KACA,qBAGG;CACH,MAAM,qCAAoCA,4CAAe;CAEzD,MAAM,aACJ,OAAO,qBAAqB,YAAY,qBAAqB;AAiB/D,0CAb+B;EAC7B,MAAM,gBAAgB,SAAS,QAAQ;AAEvC,MAAI,WACF,QAAOC,gCAAY,KAAK;GACtB,GAAG;GACH,QAAQ,iBAAiB,UAAU;GACpC,CAAM;AAGT,SAAOA,gCAAY,KAAM,oBAAoB,cAAoB;GAGrD"}

package/dist/cjs/esbuild/plugin.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let node_path = require("node:path");
+let _intlayer_config_node = require("@intlayer/config/node");
+let _intlayer_config_utils = require("@intlayer/config/utils");
 let _intlayer_chokidar_build = require("@intlayer/chokidar/build");
 let _intlayer_chokidar_cli = require("@intlayer/chokidar/cli");
 let _intlayer_chokidar_watcher = require("@intlayer/chokidar/watcher");
 let _intlayer_config_envVars = require("@intlayer/config/envVars");
 let _intlayer_config_logger = require("@intlayer/config/logger");
-let _intlayer_config_node = require("@intlayer/config/node");
-let _intlayer_config_utils = require("@intlayer/config/utils");
 let _intlayer_dictionaries_entry = require("@intlayer/dictionaries-entry");
 
 //#region src/esbuild/plugin.ts

package/dist/cjs/getDictionary.cjs

@@ -4,7 +4,14 @@ const require_plugins = require('./plugins.cjs');
 let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 
 //#region src/getDictionary.ts
-const getDictionary = (dictionary, locale) => (0, _intlayer_core_interpreter.getDictionary)(dictionary, locale, require_plugins.getPlugins(locale));
+/**
+* Transforms a dictionary (or qualified dictionary group) and returns its
+* content for the given locale or selector (`{ item }`, `{ variant }`,
+* `{ id, ...meta }`, optionally combined with `locale`).
+*/
+const getDictionary = (dictionary, localeOrSelector) => {
+	return (0, _intlayer_core_interpreter.getDictionary)(dictionary, localeOrSelector, require_plugins.getPlugins(typeof localeOrSelector === "object" && localeOrSelector !== null ? localeOrSelector.locale : localeOrSelector));
+};
 
 //#endregion
 exports.getDictionary = getDictionary;

package/dist/cjs/getDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getDictionary.cjs","names":["getPlugins"],"sources":["../../src/getDictionary.ts"],"sourcesContent":["import { getDictionary as getDictionaryCore } from '@intlayer/core/interpreter';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getPlugins } from './plugins';\n\nexport const getDictionary = <\n  const T extends Dictionary,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  dictionary: T,\n  locale?: L\n) => getDictionaryCore<T, L>(dictionary, locale, getPlugins(locale));\n"],"mappings":";;;;;;AAQA,MAAa,iBAIX,YACA,yDAC2B,YAAY,QAAQA,2BAAW,OAAO,CAAC"}
+{"version":3,"file":"getDictionary.cjs","names":["getPlugins"],"sources":["../../src/getDictionary.ts"],"sourcesContent":["import { getDictionary as getDictionaryCore } from '@intlayer/core/interpreter';\nimport type {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\n/**\n * Transforms a dictionary (or qualified dictionary group) and returns its\n * content for the given locale or selector (`{ item }`, `{ variant }`,\n * `{ id, ...meta }`, optionally combined with `locale`).\n */\nexport const getDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): DeepTransformContent<\n  ResolveQualifiedDictionaryContent<T, A>,\n  ExtractSelectorLocale<A>\n> => {\n  const locale = (\n    typeof localeOrSelector === 'object' && localeOrSelector !== null\n      ? localeOrSelector.locale\n      : localeOrSelector\n  ) as LocalesValues | undefined;\n\n  return getDictionaryCore(\n    dictionary,\n    localeOrSelector,\n    getPlugins(locale)\n  ) as any;\n};\n"],"mappings":";;;;;;;;;;;AAoBA,MAAa,iBAMX,YACA,qBAIG;AAOH,sDACE,YACA,kBACAA,2BARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,iBAMc,CACnB"}

package/dist/cjs/getIntlayer.cjs

@@ -4,7 +4,14 @@ const require_plugins = require('./plugins.cjs');
 let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 
 //#region src/getIntlayer.ts
-const getIntlayer = (key, locale) => (0, _intlayer_core_interpreter.getIntlayer)(key, locale, require_plugins.getPlugins(locale));
+/**
+* Picks one dictionary by its key and returns its content for the given
+* locale or selector (`{ item }`, `{ variant }`, `{ id, ...meta }`,
+* optionally combined with `locale`).
+*/
+const getIntlayer = (key, localeOrSelector) => {
+	return (0, _intlayer_core_interpreter.getIntlayer)(key, localeOrSelector, require_plugins.getPlugins(typeof localeOrSelector === "object" && localeOrSelector !== null ? localeOrSelector.locale : localeOrSelector));
+};
 
 //#endregion
 exports.getIntlayer = getIntlayer;

package/dist/cjs/getIntlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.cjs","names":["getPlugins"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore } from '@intlayer/core/interpreter';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L\n) =>\n  getIntlayerCore<T, L>(\n    key,\n    locale,\n    getPlugins(locale)\n  ) as DeepTransformContent<DictionaryRegistryContent<T>>;\n"],"mappings":";;;;;;AASA,MAAa,eAIX,KACA,uDAGE,KACA,QACAA,2BAAW,OAAO,CACnB"}
+{"version":3,"file":"getIntlayer.cjs","names":["getPlugins"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore } from '@intlayer/core/interpreter';\nimport type { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\n/**\n * Picks one dictionary by its key and returns its content for the given\n * locale or selector (`{ item }`, `{ variant }`, `{ id, ...meta }`,\n * optionally combined with `locale`).\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): DeepTransformContent<\n  DictionaryRegistryResult<T, A>,\n  ExtractSelectorLocale<A>\n> => {\n  const locale = (\n    typeof localeOrSelector === 'object' && localeOrSelector !== null\n      ? localeOrSelector.locale\n      : localeOrSelector\n  ) as LocalesValues | undefined;\n\n  return getIntlayerCore(key, localeOrSelector, getPlugins(locale)) as any;\n};\n"],"mappings":";;;;;;;;;;;AAiBA,MAAa,eAIX,KACA,qBAIG;AAOH,oDAAuB,KAAK,kBAAkBA,2BAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,iBAG0D,CAAC"}

package/dist/esm/client/useDictionary.mjs

@@ -3,10 +3,21 @@ import { INTLAYER_TOKEN } from "./intlayerToken.mjs";
 import { computed, inject } from "@angular/core";
 
 //#region src/client/useDictionary.ts
-const useDictionary = (dictionary, locale) => {
+/**
+* Angular hook that transforms a dictionary (or qualified dictionary group)
+* and returns its reactive content for the given locale or selector.
+*/
+const useDictionary = (dictionary, localeOrSelector) => {
 	const intlayer = inject(INTLAYER_TOKEN);
-	const localeTarget = computed(() => locale ?? intlayer?.locale());
-	return computed(() => getDictionary(dictionary, localeTarget()));
+	const isSelector = typeof localeOrSelector === "object" && localeOrSelector !== null;
+	return computed(() => {
+		const currentLocale = intlayer?.locale();
+		if (isSelector) return getDictionary(dictionary, {
+			...localeOrSelector,
+			locale: localeOrSelector.locale ?? currentLocale
+		});
+		return getDictionary(dictionary, localeOrSelector ?? currentLocale);
+	});
 };
 
 //#endregion

package/dist/esm/client/useDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.mjs","names":[],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\nexport const useDictionary = <const T extends Dictionary>(\n  dictionary: T,\n  locale?: LocalesValues\n): Signal<DeepTransformContent<T['content']>> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  const localeTarget = computed(() => locale ?? intlayer?.locale());\n\n  /** a *stable* reactive dictionary object */\n  const content = computed(\n    () => getDictionary<T, LocalesValues>(dictionary, localeTarget()) as any\n  );\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;AAOA,MAAa,iBACX,YACA,WAC+C;CAC/C,MAAM,WAAW,OAAyB,eAAe;CAEzD,MAAM,eAAe,eAAe,UAAU,UAAU,QAAQ,CAAC;AAOjE,QAJgB,eACR,cAAgC,YAAY,cAAc,CAAC,CAGrD"}
+{"version":3,"file":"useDictionary.mjs","names":[],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\n/**\n * Angular hook that transforms a dictionary (or qualified dictionary group)\n * and returns its reactive content for the given locale or selector.\n */\nexport const useDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): Signal<\n  DeepTransformContent<\n    ResolveQualifiedDictionaryContent<T, A>,\n    ExtractSelectorLocale<A>\n  >\n> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  const isSelector =\n    typeof localeOrSelector === 'object' && localeOrSelector !== null;\n\n  /** a *stable* reactive dictionary object */\n  const content = computed(() => {\n    const currentLocale = intlayer?.locale();\n\n    if (isSelector) {\n      return getDictionary(dictionary, {\n        ...localeOrSelector,\n        locale: localeOrSelector.locale ?? currentLocale,\n      } as A) as any;\n    }\n\n    return getDictionary(\n      dictionary,\n      (localeOrSelector ?? currentLocale) as A\n    ) as any;\n  });\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;;;;AAqBA,MAAa,iBAMX,YACA,qBAMG;CACH,MAAM,WAAW,OAAyB,eAAe;CAEzD,MAAM,aACJ,OAAO,qBAAqB,YAAY,qBAAqB;AAmB/D,QAhBgB,eAAe;EAC7B,MAAM,gBAAgB,UAAU,QAAQ;AAExC,MAAI,WACF,QAAO,cAAc,YAAY;GAC/B,GAAG;GACH,QAAQ,iBAAiB,UAAU;GACpC,CAAM;AAGT,SAAO,cACL,YACC,oBAAoB,cACtB;GAGW"}

package/dist/esm/client/useDictionaryDynamic.mjs

@@ -1,19 +1,41 @@
 'use client';
 
+import { getDictionary } from "../getDictionary.mjs";
 import { INTLAYER_TOKEN } from "./intlayerToken.mjs";
 import { useDictionary } from "./useDictionary.mjs";
 import { useLoadDynamic } from "./useLoadDynamic.mjs";
 import { internationalization } from "@intlayer/config/built";
-import { computed, inject } from "@angular/core";
+import { computed, inject, signal } from "@angular/core";
+import { isQualifiedDynamicLoaderMap, parseDictionarySelector, resolveQualifiedDynamicContentAsync } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/client/useDictionaryDynamic.ts
 /**
-* On the server side, Hook that transform a dictionary and return the content
+* Lazily loads a dictionary (plain or qualified) and returns its reactive
+* content.
 *
-* If the locale is not provided, it will use the locale from the client context
+* For a qualified loader map (collection / variant / meta record, possibly
+* combined), only the chunk(s) the selector targets are loaded. For a plain
+* loader map, the locale chunk is loaded.
+*
+* If the locale is not provided (directly or through the selector), it will use
+* the locale from the client context.
 */
-const useDictionaryDynamic = (dictionaryPromise, key, locale) => {
+const useDictionaryDynamic = (dictionaryPromise, key, localeOrSelector) => {
 	const intlayer = inject(INTLAYER_TOKEN);
+	if (isQualifiedDynamicLoaderMap(dictionaryPromise)) {
+		const { locale: selectorLocale, selector } = parseDictionarySelector(localeOrSelector);
+		const localeTarget = selectorLocale ?? intlayer?.locale() ?? internationalization.defaultLocale;
+		const container = signal(void 0);
+		resolveQualifiedDynamicContentAsync({
+			loaderMap: dictionaryPromise,
+			key: String(key),
+			locale: localeTarget,
+			selector,
+			transform: (dictionary) => getDictionary(dictionary, localeTarget)
+		}).then((resolved) => container.set(resolved));
+		return computed(() => container());
+	}
+	const locale = typeof localeOrSelector === "string" ? localeOrSelector : void 0;
 	const localeTarget = computed(() => locale ?? intlayer?.locale() ?? internationalization.defaultLocale);
 	return useDictionary(useLoadDynamic(`${String(key)}.${localeTarget()}`, dictionaryPromise[localeTarget()]?.()), localeTarget());
 };

package/dist/esm/client/useDictionaryDynamic.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.mjs","names":[],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport { computed, inject } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\nimport { useDictionary } from './useDictionary';\nimport { useLoadDynamic } from './useLoadDynamic';\n\n/**\n * On the server side, Hook that transform a dictionary and return the content\n *\n * If the locale is not provided, it will use the locale from the client context\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  locale?: LocalesValues\n) => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  const localeTarget = computed(\n    () => locale ?? intlayer?.locale() ?? internationalization.defaultLocale\n  );\n\n  const dictionary = useLoadDynamic<T>(\n    `${String(key)}.${localeTarget()}`,\n    (dictionaryPromise as any)[localeTarget()]?.()\n  ) as T;\n\n  return useDictionary(dictionary, localeTarget() as any);\n};\n"],"mappings":";;;;;;;;;;;;;;AAmBA,MAAa,wBAIX,mBACA,KACA,WACG;CACH,MAAM,WAAW,OAAyB,eAAe;CAEzD,MAAM,eAAe,eACb,UAAU,UAAU,QAAQ,IAAI,qBAAqB,cAC5D;AAOD,QAAO,cALY,eACjB,GAAG,OAAO,IAAI,CAAC,GAAG,cAAc,IAC/B,kBAA0B,cAAc,KAAK,CAGjB,EAAE,cAAc,CAAQ"}
+{"version":3,"file":"useDictionaryDynamic.mjs","names":[],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport { computed, inject, signal } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport {\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\n  DictionarySelector,\n} from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { getDictionary } from '../getDictionary';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\nimport { useDictionary } from './useDictionary';\nimport { useLoadDynamic } from './useLoadDynamic';\n\n/**\n * Lazily loads a dictionary (plain or qualified) and returns its reactive\n * content.\n *\n * For a qualified loader map (collection / variant / meta record, possibly\n * combined), only the chunk(s) the selector targets are loaded. For a plain\n * loader map, the locale chunk is loaded.\n *\n * If the locale is not provided (directly or through the selector), it will use\n * the locale from the client context.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = LocalesValues,\n>(\n  dictionaryPromise:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n) => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN);\n\n  if (isQualifiedDynamicLoaderMap(dictionaryPromise)) {\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(localeOrSelector);\n\n    const localeTarget =\n      selectorLocale ??\n      intlayer?.locale() ??\n      internationalization.defaultLocale;\n\n    const container = signal<unknown>(undefined);\n\n    resolveQualifiedDynamicContentAsync({\n      loaderMap: dictionaryPromise,\n      key: String(key),\n      locale: localeTarget,\n      selector,\n      transform: (dictionary) => getDictionary(dictionary, localeTarget),\n    }).then((resolved) => container.set(resolved));\n\n    return computed(() => container() as any);\n  }\n\n  const locale =\n    typeof localeOrSelector === 'string'\n      ? (localeOrSelector as LocalesValues)\n      : undefined;\n\n  const localeTarget = computed(\n    () => locale ?? intlayer?.locale() ?? internationalization.defaultLocale\n  );\n\n  const dictionary = useLoadDynamic<T>(\n    `${String(key)}.${localeTarget()}`,\n    (dictionaryPromise as any)[localeTarget()]?.()\n  ) as T;\n\n  return useDictionary(dictionary, localeTarget() as any);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,wBAKX,mBAGA,KACA,qBACG;CACH,MAAM,WAAW,OAAyB,eAAe;AAEzD,KAAI,4BAA4B,kBAAkB,EAAE;EAClD,MAAM,EAAE,QAAQ,gBAAgB,aAC9B,wBAAuC,iBAAiB;EAE1D,MAAM,eACJ,kBACA,UAAU,QAAQ,IAClB,qBAAqB;EAEvB,MAAM,YAAY,OAAgB,OAAU;AAE5C,sCAAoC;GAClC,WAAW;GACX,KAAK,OAAO,IAAI;GAChB,QAAQ;GACR;GACA,YAAY,eAAe,cAAc,YAAY,aAAa;GACnE,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,SAAS,CAAC;AAE9C,SAAO,eAAe,WAAW,CAAQ;;CAG3C,MAAM,SACJ,OAAO,qBAAqB,WACvB,mBACD;CAEN,MAAM,eAAe,eACb,UAAU,UAAU,QAAQ,IAAI,qBAAqB,cAC5D;AAOD,QAAO,cALY,eACjB,GAAG,OAAO,IAAI,CAAC,GAAG,cAAc,IAC/B,kBAA0B,cAAc,KAAK,CAGjB,EAAE,cAAc,CAAQ"}

package/dist/esm/client/useIntlayer.mjs

@@ -30,11 +30,17 @@ const isUpdatableNode = (val) => !!val && typeof val === "object" && typeof val.
 * }
 * ```
 */
-const useIntlayer = (key, locale) => {
+const useIntlayer = (key, localeOrSelector) => {
 	const intlayer = inject(INTLAYER_TOKEN);
-	/** which locale should we use right now? */
-	const localeTarget = computed(() => locale ?? intlayer.locale());
-	return computed(() => getIntlayer(key, localeTarget()));
+	const isSelector = typeof localeOrSelector === "object" && localeOrSelector !== null;
+	return computed(() => {
+		const currentLocale = intlayer.locale();
+		if (isSelector) return getIntlayer(key, {
+			...localeOrSelector,
+			locale: localeOrSelector.locale ?? currentLocale
+		});
+		return getIntlayer(key, localeOrSelector ?? currentLocale);
+	});
 };
 
 //#endregion

package/dist/esm/client/useIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useIntlayer.mjs","names":[],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type {\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayer } from '../getIntlayer';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\n/** guard utility - true only for objects generated by `renderIntlayerNode()` */\nexport const isUpdatableNode = (\n  val: unknown\n): val is { __update: (n: unknown) => void } =>\n  !!val &&\n  typeof val === 'object' &&\n  typeof (val as any).__update === 'function';\n\n/**\n * Angular hook that picks one dictionary by its key and returns its reactive content.\n *\n * It utilizes Angular signals to provide deep reactivity, ensuring your components\n * update automatically when the locale changes.\n *\n * @param key - The unique key of the dictionary to retrieve.\n * @param locale - Optional locale to override the current context locale.\n * @returns The transformed dictionary content.\n *\n * @example\n * ```ts\n * import { Component } from '@angular/core';\n * import { useIntlayer } from 'angular-intlayer';\n *\n * @Component({\n *   standalone: true,\n *   selector: 'app-my-component',\n *   template: `<div>{{ content().myField.value }}</div>`,\n * })\n * export class MyComponent {\n *   content = useIntlayer('my-dictionary-key');\n * }\n * ```\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const L extends LocalesValues,\n>(\n  key: T,\n  locale?: LocalesValues\n): Signal<DeepTransformContent<DictionaryRegistryContent<T>>> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN)!;\n\n  /** which locale should we use right now? */\n  const localeTarget = computed(() => locale ?? intlayer.locale());\n\n  /** a *stable* reactive dictionary object */\n  // @ts-ignore Type instantiation is excessively deep and possibly infinite\n  const content = computed(\n    () => getIntlayer<T, L>(key, localeTarget() as L) as any\n  );\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;AAWA,MAAa,mBACX,QAEA,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,OAAQ,IAAY,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BnC,MAAa,eAIX,KACA,WAC+D;CAC/D,MAAM,WAAW,OAAyB,eAAe;;CAGzD,MAAM,eAAe,eAAe,UAAU,SAAS,QAAQ,CAAC;AAQhE,QAJgB,eACR,YAAkB,KAAK,cAAc,CAAM,CAGrC"}
+{"version":3,"file":"useIntlayer.mjs","names":[],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport type { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getIntlayer } from '../getIntlayer';\nimport type { DeepTransformContent } from '../plugins';\nimport { INTLAYER_TOKEN, type IntlayerProvider } from './installIntlayer';\n\n/** guard utility - true only for objects generated by `renderIntlayerNode()` */\nexport const isUpdatableNode = (\n  val: unknown\n): val is { __update: (n: unknown) => void } =>\n  !!val &&\n  typeof val === 'object' &&\n  typeof (val as any).__update === 'function';\n\n/**\n * Angular hook that picks one dictionary by its key and returns its reactive content.\n *\n * It utilizes Angular signals to provide deep reactivity, ensuring your components\n * update automatically when the locale changes.\n *\n * @param key - The unique key of the dictionary to retrieve.\n * @param locale - Optional locale to override the current context locale.\n * @returns The transformed dictionary content.\n *\n * @example\n * ```ts\n * import { Component } from '@angular/core';\n * import { useIntlayer } from 'angular-intlayer';\n *\n * @Component({\n *   standalone: true,\n *   selector: 'app-my-component',\n *   template: `<div>{{ content().myField.value }}</div>`,\n * })\n * export class MyComponent {\n *   content = useIntlayer('my-dictionary-key');\n * }\n * ```\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): Signal<\n  DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>\n> => {\n  const intlayer = inject<IntlayerProvider>(INTLAYER_TOKEN)!;\n\n  const isSelector =\n    typeof localeOrSelector === 'object' && localeOrSelector !== null;\n\n  /** a *stable* reactive dictionary object */\n  // @ts-ignore Type instantiation is excessively deep and possibly infinite\n  const content = computed(() => {\n    const currentLocale = intlayer.locale();\n\n    if (isSelector) {\n      return getIntlayer(key, {\n        ...localeOrSelector,\n        locale: localeOrSelector.locale ?? currentLocale,\n      } as A) as any;\n    }\n\n    return getIntlayer(key, (localeOrSelector ?? currentLocale) as A) as any;\n  });\n\n  return content; // all consumers keep full reactivity\n};\n"],"mappings":";;;;;;AAeA,MAAa,mBACX,QAEA,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,OAAQ,IAAY,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BnC,MAAa,eAIX,KACA,qBAGG;CACH,MAAM,WAAW,OAAyB,eAAe;CAEzD,MAAM,aACJ,OAAO,qBAAqB,YAAY,qBAAqB;AAiB/D,QAbgB,eAAe;EAC7B,MAAM,gBAAgB,SAAS,QAAQ;AAEvC,MAAI,WACF,QAAO,YAAY,KAAK;GACtB,GAAG;GACH,QAAQ,iBAAiB,UAAU;GACpC,CAAM;AAGT,SAAO,YAAY,KAAM,oBAAoB,cAAoB;GAGrD"}

package/dist/esm/esbuild/plugin.mjs

@@ -1,11 +1,11 @@
 import { join } from "node:path";
+import { getConfiguration } from "@intlayer/config/node";
+import { getAlias, getUnusedNodeTypesAsync } from "@intlayer/config/utils";
 import { prepareIntlayer } from "@intlayer/chokidar/build";
 import { logConfigDetails } from "@intlayer/chokidar/cli";
 import { watch } from "@intlayer/chokidar/watcher";
 import { formatNodeTypeToEnvVar, getConfigEnvVars } from "@intlayer/config/envVars";
 import { getAppLogger } from "@intlayer/config/logger";
-import { getConfiguration } from "@intlayer/config/node";
-import { getAlias, getUnusedNodeTypesAsync } from "@intlayer/config/utils";
 import { getDictionaries } from "@intlayer/dictionaries-entry";
 
 //#region src/esbuild/plugin.ts

package/dist/esm/getDictionary.mjs

@@ -2,7 +2,14 @@ import { getPlugins } from "./plugins.mjs";
 import { getDictionary as getDictionary$1 } from "@intlayer/core/interpreter";
 
 //#region src/getDictionary.ts
-const getDictionary = (dictionary, locale) => getDictionary$1(dictionary, locale, getPlugins(locale));
+/**
+* Transforms a dictionary (or qualified dictionary group) and returns its
+* content for the given locale or selector (`{ item }`, `{ variant }`,
+* `{ id, ...meta }`, optionally combined with `locale`).
+*/
+const getDictionary = (dictionary, localeOrSelector) => {
+	return getDictionary$1(dictionary, localeOrSelector, getPlugins(typeof localeOrSelector === "object" && localeOrSelector !== null ? localeOrSelector.locale : localeOrSelector));
+};
 
 //#endregion
 export { getDictionary };

package/dist/esm/getDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getDictionary.mjs","names":["getDictionaryCore"],"sources":["../../src/getDictionary.ts"],"sourcesContent":["import { getDictionary as getDictionaryCore } from '@intlayer/core/interpreter';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getPlugins } from './plugins';\n\nexport const getDictionary = <\n  const T extends Dictionary,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  dictionary: T,\n  locale?: L\n) => getDictionaryCore<T, L>(dictionary, locale, getPlugins(locale));\n"],"mappings":";;;;AAQA,MAAa,iBAIX,YACA,WACGA,gBAAwB,YAAY,QAAQ,WAAW,OAAO,CAAC"}
+{"version":3,"file":"getDictionary.mjs","names":["getDictionaryCore"],"sources":["../../src/getDictionary.ts"],"sourcesContent":["import { getDictionary as getDictionaryCore } from '@intlayer/core/interpreter';\nimport type {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\n/**\n * Transforms a dictionary (or qualified dictionary group) and returns its\n * content for the given locale or selector (`{ item }`, `{ variant }`,\n * `{ id, ...meta }`, optionally combined with `locale`).\n */\nexport const getDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): DeepTransformContent<\n  ResolveQualifiedDictionaryContent<T, A>,\n  ExtractSelectorLocale<A>\n> => {\n  const locale = (\n    typeof localeOrSelector === 'object' && localeOrSelector !== null\n      ? localeOrSelector.locale\n      : localeOrSelector\n  ) as LocalesValues | undefined;\n\n  return getDictionaryCore(\n    dictionary,\n    localeOrSelector,\n    getPlugins(locale)\n  ) as any;\n};\n"],"mappings":";;;;;;;;;AAoBA,MAAa,iBAMX,YACA,qBAIG;AAOH,QAAOA,gBACL,YACA,kBACA,WARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,iBAMc,CACnB"}

package/dist/esm/getIntlayer.mjs

@@ -2,7 +2,14 @@ import { getPlugins } from "./plugins.mjs";
 import { getIntlayer as getIntlayer$1 } from "@intlayer/core/interpreter";
 
 //#region src/getIntlayer.ts
-const getIntlayer = (key, locale) => getIntlayer$1(key, locale, getPlugins(locale));
+/**
+* Picks one dictionary by its key and returns its content for the given
+* locale or selector (`{ item }`, `{ variant }`, `{ id, ...meta }`,
+* optionally combined with `locale`).
+*/
+const getIntlayer = (key, localeOrSelector) => {
+	return getIntlayer$1(key, localeOrSelector, getPlugins(typeof localeOrSelector === "object" && localeOrSelector !== null ? localeOrSelector.locale : localeOrSelector));
+};
 
 //#endregion
 export { getIntlayer };

package/dist/esm/getIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.mjs","names":["getIntlayerCore"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore } from '@intlayer/core/interpreter';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L\n) =>\n  getIntlayerCore<T, L>(\n    key,\n    locale,\n    getPlugins(locale)\n  ) as DeepTransformContent<DictionaryRegistryContent<T>>;\n"],"mappings":";;;;AASA,MAAa,eAIX,KACA,WAEAA,cACE,KACA,QACA,WAAW,OAAO,CACnB"}
+{"version":3,"file":"getIntlayer.mjs","names":["getIntlayerCore"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore } from '@intlayer/core/interpreter';\nimport type { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\n/**\n * Picks one dictionary by its key and returns its content for the given\n * locale or selector (`{ item }`, `{ variant }`, `{ id, ...meta }`,\n * optionally combined with `locale`).\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): DeepTransformContent<\n  DictionaryRegistryResult<T, A>,\n  ExtractSelectorLocale<A>\n> => {\n  const locale = (\n    typeof localeOrSelector === 'object' && localeOrSelector !== null\n      ? localeOrSelector.locale\n      : localeOrSelector\n  ) as LocalesValues | undefined;\n\n  return getIntlayerCore(key, localeOrSelector, getPlugins(locale)) as any;\n};\n"],"mappings":";;;;;;;;;AAiBA,MAAa,eAIX,KACA,qBAIG;AAOH,QAAOA,cAAgB,KAAK,kBAAkB,WAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,iBAG0D,CAAC"}

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

@@ -1,10 +1,14 @@
 import { DeepTransformContent } from "../plugins.js";
 import { Signal } from "@angular/core";
-import { LocalesValues } from "@intlayer/types/module_augmentation";
-import { Dictionary } from "@intlayer/types/dictionary";
+import { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
+import { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from "@intlayer/types/dictionary";
 
 //#region src/client/useDictionary.d.ts
-declare const useDictionary: <const T extends Dictionary>(dictionary: T, locale?: LocalesValues) => Signal<DeepTransformContent<T["content"]>>;
+/**
+ * Angular hook that transforms a dictionary (or qualified dictionary group)
+ * and returns its reactive content for the given locale or selector.
+ */
+declare const useDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends LocalesValues | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => Signal<DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>>;
 //#endregion
 export { useDictionary };
 //# sourceMappingURL=useDictionary.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../../src/client/useDictionary.ts"],"mappings":";;;;;;cAOa,aAAA,mBAAiC,UAAA,EAC5C,UAAA,EAAY,CAAA,EACZ,MAAA,GAAS,aAAA,KACR,MAAA,CAAO,oBAAA,CAAqB,CAAA"}
+{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../../src/client/useDictionary.ts"],"mappings":";;;;;;;;AAqBA;;cAAa,aAAA,mBACK,UAAA,GAAa,wBAAA,kBAEzB,aAAA,GACA,0BAAA,CAA2B,CAAA,IAAK,eAAA,EAEpC,UAAA,EAAY,CAAA,EACZ,gBAAA,GAAmB,CAAA,KAClB,MAAA,CACD,oBAAA,CACE,iCAAA,CAAkC,CAAA,EAAG,CAAA,GACrC,qBAAA,CAAsB,CAAA"}

package/dist/types/client/useDictionaryAsync.d.ts

@@ -8,7 +8,7 @@ import { Dictionary } from "@intlayer/types/dictionary";
  *
  * If the locale is not provided, it will use the locale from the client context
  */
-declare const useDictionaryAsync: <const T extends Dictionary>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, locale?: LocalesValues) => Promise<_$_angular_core0.Signal<any>>;
+declare const useDictionaryAsync: <const T extends Dictionary>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, locale?: LocalesValues) => Promise<_$_angular_core0.Signal<unknown>>;
 //#endregion
 export { useDictionaryAsync };
 //# sourceMappingURL=useDictionaryAsync.d.ts.map

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

@@ -1,17 +1,21 @@
-import { IInterpreterPluginState as IInterpreterPluginState$1 } from "../plugins.js";
-import { Locale } from "../intlayer/dist/types/index.js";
 import * as _$_angular_core0 from "@angular/core";
-import { DictionaryKeys, LocalesValues, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
+import { DictionaryKeys, DictionarySelectorForKey, LocalesValues, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
 import { Dictionary } from "@intlayer/types/dictionary";
-import * as _$_intlayer_core_interpreter0 from "@intlayer/core/interpreter";
+import { QualifiedDynamicLoaderMap } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/client/useDictionaryDynamic.d.ts
 /**
- * On the server side, Hook that transform a dictionary and return the content
+ * Lazily loads a dictionary (plain or qualified) and returns its reactive
+ * content.
  *
- * If the locale is not provided, it will use the locale from the client context
+ * For a qualified loader map (collection / variant / meta record, possibly
+ * combined), only the chunk(s) the selector targets are loaded. For a plain
+ * loader map, the locale chunk is loaded.
+ *
+ * If the locale is not provided (directly or through the selector), it will use
+ * the locale from the client context.
  */
-declare const useDictionaryDynamic: <const T extends Dictionary, const K extends DictionaryKeys>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K, locale?: LocalesValues) => _$_angular_core0.Signal<_$_intlayer_core_interpreter0.DeepTransformContent<T["content"], IInterpreterPluginState$1, Locale>>;
+declare const useDictionaryDynamic: <const T extends Dictionary, const K extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<K> = LocalesValues>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>> | QualifiedDynamicLoaderMap, key: K, localeOrSelector?: A) => _$_angular_core0.Signal<any>;
 //#endregion
 export { useDictionaryDynamic };
 //# sourceMappingURL=useDictionaryDynamic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../../src/client/useDictionaryDynamic.ts"],"mappings":";;;;;;;;;;;;;cAmBa,oBAAA,mBACK,UAAA,kBACA,cAAA,EAEhB,iBAAA,EAAmB,mBAAA,OAA0B,OAAA,CAAQ,CAAA,IACrD,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,aAAA,KAAa,gBAAA,CAAA,MAAA,CAAA,6BAAA,CAAA,oBAAA,CAAA,CAAA,aAAA,yBAAA,EAAA,MAAA"}
+{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../../src/client/useDictionaryDynamic.ts"],"mappings":";;;;;;;;;AAoCA;;;;;;;;cAAa,oBAAA,mBACK,UAAA,kBACA,cAAA,kBACA,aAAA,GAAgB,wBAAA,CAAyB,CAAA,IAAK,aAAA,EAE9D,iBAAA,EACI,mBAAA,OAA0B,OAAA,CAAQ,CAAA,KAClC,yBAAA,EACJ,GAAA,EAAK,CAAA,EACL,gBAAA,GAAmB,CAAA,KAAC,gBAAA,CAAA,MAAA"}

package/dist/types/client/useIntlayer.d.ts

@@ -1,6 +1,6 @@
 import { DeepTransformContent } from "../plugins.js";
 import { Signal } from "@angular/core";
-import { DictionaryKeys, DictionaryRegistryContent, LocalesValues } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 
 //#region src/client/useIntlayer.d.ts
 /** guard utility - true only for objects generated by `renderIntlayerNode()` */
@@ -32,7 +32,7 @@ declare const isUpdatableNode: (val: unknown) => val is {
  * }
  * ```
  */
-declare const useIntlayer: <const T extends DictionaryKeys, const L extends LocalesValues>(key: T, locale?: LocalesValues) => Signal<DeepTransformContent<DictionaryRegistryContent<T>>>;
+declare const useIntlayer: <const T extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => Signal<DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>>;
 //#endregion
 export { isUpdatableNode, useIntlayer };
 //# sourceMappingURL=useIntlayer.d.ts.map

package/dist/types/client/useIntlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIntlayer.d.ts","names":[],"sources":["../../../src/client/useIntlayer.ts"],"mappings":";;;;;;cAWa,eAAA,GACX,GAAA,cACC,GAAA;EAAS,QAAA,GAAW,CAAA;AAAA;;;;;;;;;AA8BvB;;;;;;;;;;;;;;;;;cAAa,WAAA,mBACK,cAAA,kBACA,aAAA,EAEhB,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,aAAA,KACR,MAAA,CAAO,oBAAA,CAAqB,yBAAA,CAA0B,CAAA"}
+{"version":3,"file":"useIntlayer.d.ts","names":[],"sources":["../../../src/client/useIntlayer.ts"],"mappings":";;;;;;cAea,eAAA,GACX,GAAA,cACC,GAAA;EAAS,QAAA,GAAW,CAAA;AAAA;;;;;;;;;AA8BvB;;;;;;;;;;;;;;;;;cAAa,WAAA,mBACK,cAAA,kBACA,aAAA,GAAgB,wBAAA,CAAyB,CAAA,IAAK,eAAA,EAE9D,GAAA,EAAK,CAAA,EACL,gBAAA,GAAmB,CAAA,KAClB,MAAA,CACD,oBAAA,CAAqB,wBAAA,CAAyB,CAAA,EAAG,CAAA,GAAI,qBAAA,CAAsB,CAAA"}

package/dist/types/format/useRelativeTime.d.ts

@@ -1,9 +1,9 @@
+import { LocalesValues } from "../intlayer/dist/types/index.js";
 import * as _$_angular_core0 from "@angular/core";
-import * as _$_intlayer_types0 from "@intlayer/types";
 
 //#region src/format/useRelativeTime.d.ts
 declare const useRelativeTime: () => _$_angular_core0.Signal<(from: string | number | Date, to?: string | number | Date, options?: Intl.RelativeTimeFormatOptions & {
-  locale?: _$_intlayer_types0.LocalesValues;
+  locale?: LocalesValues;
   unit?: Intl.RelativeTimeFormatUnit;
 }) => string>;
 //#endregion

package/dist/types/format/useRelativeTime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRelativeTime.d.ts","names":[],"sources":["../../../src/format/useRelativeTime.ts"],"mappings":";;;;cAIa,eAAA,yBAAe,MAAA,EAAA,IAAA,oBAAA,IAAA,EAAA,EAAA,qBAAA,IAAA,EAAA,OAAA,GAAA,IAAA,CAAA,yBAAA;WAAA,kBAAA,CAAA,aAAA"}
+{"version":3,"file":"useRelativeTime.d.ts","names":[],"sources":["../../../src/format/useRelativeTime.ts"],"mappings":";;;;cAIa,eAAA,yBAAe,MAAA,EAAA,IAAA,oBAAA,IAAA,EAAA,EAAA,qBAAA,IAAA,EAAA,OAAA,GAAA,IAAA,CAAA,yBAAA;WAAA,aAAA"}

package/dist/types/getDictionary.d.ts

@@ -1,9 +1,14 @@
-import { DeclaredLocales, LocalesValues } from "@intlayer/types/module_augmentation";
-import { Dictionary } from "@intlayer/types/dictionary";
-import * as _$_intlayer_core_interpreter0 from "@intlayer/core/interpreter";
+import { DeepTransformContent } from "./plugins.js";
+import { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
+import { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from "@intlayer/types/dictionary";
 
 //#region src/getDictionary.d.ts
-declare const getDictionary: <const T extends Dictionary, const L extends LocalesValues = DeclaredLocales>(dictionary: T, locale?: L) => _$_intlayer_core_interpreter0.DeepTransformContent<T["content"], _$_intlayer_core_interpreter0.IInterpreterPluginState, L>;
+/**
+ * Transforms a dictionary (or qualified dictionary group) and returns its
+ * content for the given locale or selector (`{ item }`, `{ variant }`,
+ * `{ id, ...meta }`, optionally combined with `locale`).
+ */
+declare const getDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends LocalesValues | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>;
 //#endregion
 export { getDictionary };
 //# sourceMappingURL=getDictionary.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../src/getDictionary.ts"],"mappings":";;;;;cAQa,aAAA,mBACK,UAAA,kBACA,aAAA,GAAgB,eAAA,EAEhC,UAAA,EAAY,CAAA,EACZ,MAAA,GAAS,CAAA,KAAC,6BAAA,CAAA,oBAAA,CAAA,CAAA,aAAA,6BAAA,CAAA,uBAAA,EAAA,CAAA"}
+{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../src/getDictionary.ts"],"mappings":";;;;;;;AAoBA;;;cAAa,aAAA,mBACK,UAAA,GAAa,wBAAA,kBAEzB,aAAA,GACA,0BAAA,CAA2B,CAAA,IAAK,eAAA,EAEpC,UAAA,EAAY,CAAA,EACZ,gBAAA,GAAmB,CAAA,KAClB,oBAAA,CACD,iCAAA,CAAkC,CAAA,EAAG,CAAA,GACrC,qBAAA,CAAsB,CAAA"}

package/dist/types/getIntlayer.d.ts

@@ -1,8 +1,13 @@
 import { DeepTransformContent } from "./plugins.js";
-import { DeclaredLocales, DictionaryKeys, DictionaryRegistryContent, LocalesValues } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 
 //#region src/getIntlayer.d.ts
-declare const getIntlayer: <const T extends DictionaryKeys, const L extends LocalesValues = DeclaredLocales>(key: T, locale?: L) => DeepTransformContent<DictionaryRegistryContent<T>>;
+/**
+ * Picks one dictionary by its key and returns its content for the given
+ * locale or selector (`{ item }`, `{ variant }`, `{ id, ...meta }`,
+ * optionally combined with `locale`).
+ */
+declare const getIntlayer: <const T extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>;
 //#endregion
 export { getIntlayer };
 //# sourceMappingURL=getIntlayer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.d.ts","names":[],"sources":["../../src/getIntlayer.ts"],"mappings":";;;;cASa,WAAA,mBACK,cAAA,kBACA,aAAA,GAAgB,eAAA,EAEhC,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,CAAA,KAMJ,oBAAA,CAAqB,yBAAA,CAA0B,CAAA"}
+{"version":3,"file":"getIntlayer.d.ts","names":[],"sources":["../../src/getIntlayer.ts"],"mappings":";;;;;;AAiBA;;;cAAa,WAAA,mBACK,cAAA,kBACA,aAAA,GAAgB,wBAAA,CAAyB,CAAA,IAAK,eAAA,EAE9D,GAAA,EAAK,CAAA,EACL,gBAAA,GAAmB,CAAA,KAClB,oBAAA,CACD,wBAAA,CAAyB,CAAA,EAAG,CAAA,GAC5B,qBAAA,CAAsB,CAAA"}

package/dist/types/index.d.ts

@@ -4,12 +4,12 @@ import { installIntlayer, provideIntlayer } from "./client/installIntlayer.js";
 import { DeepTransformContent, HTMLPluginCond, IInterpreterPluginAngular, IInterpreterPluginState, InsertionPluginCond, IntlayerNode, IntlayerNodeCond, MarkdownCond, MarkdownStringCond, getPlugins, htmlPlugin, insertionPlugin, intlayerNodePlugins, markdownPlugin, markdownStringPlugin } from "./plugins.js";
 import { useDictionary } from "./client/useDictionary.js";
 import { useDictionaryAsync } from "./client/useDictionaryAsync.js";
-import { getDictionary } from "./getDictionary.js";
-import { getIntlayer } from "./getIntlayer.js";
 import { useDictionaryDynamic } from "./client/useDictionaryDynamic.js";
 import { isUpdatableNode, useIntlayer } from "./client/useIntlayer.js";
 import { useLoadDynamic } from "./client/useLoadDynamic.js";
 import { UseLocaleProps, UseLocaleResult, useLocale } from "./client/useLocale.js";
+import { getDictionary } from "./getDictionary.js";
+import { getIntlayer } from "./getIntlayer.js";
 import { LocalesValues } from "@intlayer/types/module_augmentation";
 
 //#region src/index.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-intlayer",
-  "version": "8.12.5-canary.0",
+  "version": "9.0.0-canary.0",
   "private": false,
   "description": "Easily internationalize i18n your Angular applications with type-safe multilingual content management.",
   "keywords": [
@@ -118,18 +118,18 @@
   "dependencies": {
     "@babel/plugin-syntax-import-attributes": "7.28.6",
     "@babel/preset-env": "7.29.2",
-    "@intlayer/chokidar": "8.12.5-canary.0",
-    "@intlayer/config": "8.12.5-canary.0",
-    "@intlayer/core": "8.12.5-canary.0",
-    "@intlayer/dictionaries-entry": "8.12.5-canary.0",
-    "@intlayer/editor": "8.12.5-canary.0",
-    "@intlayer/types": "8.12.5-canary.0",
-    "@intlayer/webpack": "8.12.5-canary.0",
+    "@intlayer/chokidar": "9.0.0-canary.0",
+    "@intlayer/config": "9.0.0-canary.0",
+    "@intlayer/core": "9.0.0-canary.0",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.0",
+    "@intlayer/editor": "9.0.0-canary.0",
+    "@intlayer/types": "9.0.0-canary.0",
+    "@intlayer/webpack": "9.0.0-canary.0",
     "babel-loader": "10.1.1",
     "defu": "6.1.7"
   },
   "devDependencies": {
-    "@types/node": "25.9.2",
+    "@types/node": "25.9.3",
     "@types/webpack": "5.28.5",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",