angular-intlayer 9.1.1 → 9.1.3

package/dist/cjs/client/installIntlayer.cjs

@@ -14,6 +14,13 @@ const require_editor_useEditor = require('../editor/useEditor.cjs');
 *
 * @param locale - Initial locale to use.
 * @param isCookieEnabled - Whether to store the locale in cookies.
+* @param variant - Ambient variant applied to every dictionary read in the app
+*   — for a dimension fixed for the whole session (tenant, school type, plan
+*   tier…) that no component should have to pass by hand. Accepts a name
+*   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a
+*   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is
+*   always the per-key map; nest a structured variant as
+*   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.
 * @returns An array of Angular providers for Intlayer.
 *
 * @example
@@ -27,8 +34,8 @@ const require_editor_useEditor = require('../editor/useEditor.cjs');
 * };
 * ```
 */
-const provideIntlayer = (locale, isCookieEnabled = true) => {
-	const client = installIntlayer(locale, isCookieEnabled);
+const provideIntlayer = (locale, isCookieEnabled = true, variant) => {
+	const client = installIntlayer(locale, isCookieEnabled, variant);
 	return [
 		{
 			provide: require_client_intlayerToken.INTLAYER_TOKEN,
@@ -41,8 +48,8 @@ const provideIntlayer = (locale, isCookieEnabled = true) => {
 /**
 * Helper to install the Intlayer provider.
 */
-const installIntlayer = (locale, isCookieEnabled = true) => {
-	return require_client_intlayerToken.createIntlayerClient(locale, isCookieEnabled);
+const installIntlayer = (locale, isCookieEnabled = true, variant) => {
+	return require_client_intlayerToken.createIntlayerClient(locale, isCookieEnabled, variant);
 };
 
 //#endregion

package/dist/cjs/client/installIntlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"installIntlayer.cjs","names":["INTLAYER_TOKEN","provideIntlayerEditor","provideIntlayerAnalytics","createIntlayerClient"],"sources":["../../../src/client/installIntlayer.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { provideIntlayerAnalytics } from '../analytics/useAnalytics';\nimport { provideIntlayerEditor } from '../editor/useEditor';\nimport {\n  createIntlayerClient,\n  INTLAYER_TOKEN,\n  IntlayerProvider,\n} from './intlayerToken';\n\nexport { createIntlayerClient, INTLAYER_TOKEN, IntlayerProvider };\n\n/**\n * Provides Intlayer to your Angular application.\n *\n * Registers the Intlayer locale token **and** automatically starts the Intlayer\n * editor client (when the editor is enabled) via `provideAppInitializer`.\n *\n * This is the recommended way to set up Intlayer in `app.config.ts`.\n *\n * @param locale - Initial locale to use.\n * @param isCookieEnabled - Whether to store the locale in cookies.\n * @returns An array of Angular providers for Intlayer.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { ApplicationConfig } from '@angular/core';\n * import { provideIntlayer } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer()],\n * };\n * ```\n */\nexport const provideIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  const client = installIntlayer(locale, isCookieEnabled);\n\n  return [\n    { provide: INTLAYER_TOKEN, useValue: client },\n    provideIntlayerEditor(client),\n    provideIntlayerAnalytics(client),\n  ];\n};\n\n/**\n * Helper to install the Intlayer provider.\n */\nexport const installIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  return createIntlayerClient(locale, isCookieEnabled);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,mBACX,QACA,kBAAkB,SACf;CACH,MAAM,SAAS,gBAAgB,QAAQ,eAAe;CAEtD,OAAO;EACL;GAAE,SAASA;GAAgB,UAAU;EAAO;EAC5CC,+CAAsB,MAAM;EAC5BC,wDAAyB,MAAM;CACjC;AACF;;;;AAKA,MAAa,mBACX,QACA,kBAAkB,SACf;CACH,OAAOC,kDAAqB,QAAQ,eAAe;AACrD"}
+{"version":3,"file":"installIntlayer.cjs","names":["INTLAYER_TOKEN","provideIntlayerEditor","provideIntlayerAnalytics","createIntlayerClient"],"sources":["../../../src/client/installIntlayer.ts"],"sourcesContent":["import type {\n  LocalesValues,\n  ProviderVariant,\n} from '@intlayer/types/module_augmentation';\nimport { provideIntlayerAnalytics } from '../analytics/useAnalytics';\nimport { provideIntlayerEditor } from '../editor/useEditor';\nimport {\n  createIntlayerClient,\n  INTLAYER_TOKEN,\n  IntlayerProvider,\n} from './intlayerToken';\n\nexport { createIntlayerClient, INTLAYER_TOKEN, IntlayerProvider };\n\n/**\n * Provides Intlayer to your Angular application.\n *\n * Registers the Intlayer locale token **and** automatically starts the Intlayer\n * editor client (when the editor is enabled) via `provideAppInitializer`.\n *\n * This is the recommended way to set up Intlayer in `app.config.ts`.\n *\n * @param locale - Initial locale to use.\n * @param isCookieEnabled - Whether to store the locale in cookies.\n * @param variant - Ambient variant applied to every dictionary read in the app\n *   — for a dimension fixed for the whole session (tenant, school type, plan\n *   tier…) that no component should have to pass by hand. Accepts a name\n *   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a\n *   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is\n *   always the per-key map; nest a structured variant as\n *   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.\n * @returns An array of Angular providers for Intlayer.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { ApplicationConfig } from '@angular/core';\n * import { provideIntlayer } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer()],\n * };\n * ```\n */\nexport const provideIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true,\n  variant?: ProviderVariant\n) => {\n  const client = installIntlayer(locale, isCookieEnabled, variant);\n\n  return [\n    { provide: INTLAYER_TOKEN, useValue: client },\n    provideIntlayerEditor(client),\n    provideIntlayerAnalytics(client),\n  ];\n};\n\n/**\n * Helper to install the Intlayer provider.\n */\nexport const installIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true,\n  variant?: ProviderVariant\n) => {\n  return createIntlayerClient(locale, isCookieEnabled, variant);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,mBACX,QACA,kBAAkB,MAClB,YACG;CACH,MAAM,SAAS,gBAAgB,QAAQ,iBAAiB,OAAO;CAE/D,OAAO;EACL;GAAE,SAASA;GAAgB,UAAU;EAAO;EAC5CC,+CAAsB,MAAM;EAC5BC,wDAAyB,MAAM;CACjC;AACF;;;;AAKA,MAAa,mBACX,QACA,kBAAkB,MAClB,YACG;CACH,OAAOC,kDAAqB,QAAQ,iBAAiB,OAAO;AAC9D"}

package/dist/cjs/client/intlayerToken.cjs

@@ -7,13 +7,22 @@ let _intlayer_config_client = require("@intlayer/config/client");
 var IntlayerProvider = class {
 	isCookieEnabled = (0, _angular_core.signal)(true);
 	_locale = (0, _angular_core.signal)(_intlayer_config_built.internationalization.defaultLocale);
+	_variant = (0, _angular_core.signal)(void 0);
 	locale = this._locale.asReadonly();
+	/**
+	* Ambient variant applied to every dictionary read in the app, the same way
+	* `locale` is. Overridden per call by an explicit selector.
+	*/
+	variant = this._variant.asReadonly();
 	constructor() {
 		(0, _intlayer_config_client.setIntlayerIdentifier)();
 	}
 	setLocale = (locale) => {
 		this._locale.set(locale);
 	};
+	setVariant = (variant) => {
+		this._variant.set(variant);
+	};
 };
 const INTLAYER_TOKEN = new _angular_core.InjectionToken("intlayer");
 /**
@@ -23,10 +32,11 @@ let instance = null;
 /**
 * Create and return a single IntlayerProvider instance
 */
-const createIntlayerClient = (locale, isCookieEnabled = true) => {
+const createIntlayerClient = (locale, isCookieEnabled = true, variant) => {
 	if (instance) return instance;
 	instance = new IntlayerProvider();
 	if (locale) instance.setLocale(locale);
+	if (variant !== void 0) instance.setVariant(variant);
 	instance.isCookieEnabled.set(isCookieEnabled);
 	return instance;
 };

package/dist/cjs/client/intlayerToken.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"intlayerToken.cjs","names":["internationalization","InjectionToken"],"sources":["../../../src/client/intlayerToken.ts"],"sourcesContent":["import { InjectionToken, type Signal, signal } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport { setIntlayerIdentifier } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport class IntlayerProvider {\n  isCookieEnabled = signal(true);\n  private _locale = signal<LocalesValues>(\n    internationalization.defaultLocale as LocalesValues\n  );\n\n  readonly locale: Signal<LocalesValues> = this._locale.asReadonly();\n\n  constructor() {\n    setIntlayerIdentifier();\n  }\n\n  setLocale = (locale: LocalesValues) => {\n    this._locale.set(locale);\n  };\n}\n\nexport const INTLAYER_TOKEN = new InjectionToken<IntlayerProvider>('intlayer');\n\n/**\n * Singleton instance\n */\nlet instance: IntlayerProvider | null = null;\n\n/**\n * Create and return a single IntlayerProvider instance\n */\nexport const createIntlayerClient = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n): IntlayerProvider => {\n  if (instance) return instance;\n\n  instance = new IntlayerProvider();\n\n  if (locale) {\n    instance.setLocale(locale);\n  }\n  instance.isCookieEnabled.set(isCookieEnabled);\n\n  return instance;\n};\n"],"mappings":";;;;;;AAKA,IAAa,mBAAb,MAA8B;CAC5B,4CAAyB,IAAI;CAC7B,AAAQ,oCACNA,4CAAqB,aACvB;CAEA,AAAS,SAAgC,KAAK,QAAQ,WAAW;CAEjE,cAAc;EACZ,mDAAsB;CACxB;CAEA,aAAa,WAA0B;EACrC,KAAK,QAAQ,IAAI,MAAM;CACzB;AACF;AAEA,MAAa,iBAAiB,IAAIC,6BAAiC,UAAU;;;;AAK7E,IAAI,WAAoC;;;;AAKxC,MAAa,wBACX,QACA,kBAAkB,SACG;CACrB,IAAI,UAAU,OAAO;CAErB,WAAW,IAAI,iBAAiB;CAEhC,IAAI,QACF,SAAS,UAAU,MAAM;CAE3B,SAAS,gBAAgB,IAAI,eAAe;CAE5C,OAAO;AACT"}
+{"version":3,"file":"intlayerToken.cjs","names":["internationalization","InjectionToken"],"sources":["../../../src/client/intlayerToken.ts"],"sourcesContent":["import { InjectionToken, type Signal, signal } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport { setIntlayerIdentifier } from '@intlayer/config/client';\nimport type {\n  LocalesValues,\n  ProviderVariant,\n} from '@intlayer/types/module_augmentation';\n\nexport class IntlayerProvider {\n  isCookieEnabled = signal(true);\n  private _locale = signal<LocalesValues>(\n    internationalization.defaultLocale as LocalesValues\n  );\n\n  private _variant = signal<ProviderVariant | undefined>(undefined);\n\n  readonly locale: Signal<LocalesValues> = this._locale.asReadonly();\n\n  /**\n   * Ambient variant applied to every dictionary read in the app, the same way\n   * `locale` is. Overridden per call by an explicit selector.\n   */\n  readonly variant: Signal<ProviderVariant | undefined> =\n    this._variant.asReadonly();\n\n  constructor() {\n    setIntlayerIdentifier();\n  }\n\n  setLocale = (locale: LocalesValues) => {\n    this._locale.set(locale);\n  };\n\n  setVariant = (variant: ProviderVariant | undefined) => {\n    this._variant.set(variant);\n  };\n}\n\nexport const INTLAYER_TOKEN = new InjectionToken<IntlayerProvider>('intlayer');\n\n/**\n * Singleton instance\n */\nlet instance: IntlayerProvider | null = null;\n\n/**\n * Create and return a single IntlayerProvider instance\n */\nexport const createIntlayerClient = (\n  locale?: LocalesValues,\n  isCookieEnabled = true,\n  variant?: ProviderVariant\n): IntlayerProvider => {\n  if (instance) return instance;\n\n  instance = new IntlayerProvider();\n\n  if (locale) {\n    instance.setLocale(locale);\n  }\n  if (variant !== undefined) {\n    instance.setVariant(variant);\n  }\n  instance.isCookieEnabled.set(isCookieEnabled);\n\n  return instance;\n};\n"],"mappings":";;;;;;AAQA,IAAa,mBAAb,MAA8B;CAC5B,4CAAyB,IAAI;CAC7B,AAAQ,oCACNA,4CAAqB,aACvB;CAEA,AAAQ,qCAA+C,MAAS;CAEhE,AAAS,SAAgC,KAAK,QAAQ,WAAW;;;;;CAMjE,AAAS,UACP,KAAK,SAAS,WAAW;CAE3B,cAAc;EACZ,mDAAsB;CACxB;CAEA,aAAa,WAA0B;EACrC,KAAK,QAAQ,IAAI,MAAM;CACzB;CAEA,cAAc,YAAyC;EACrD,KAAK,SAAS,IAAI,OAAO;CAC3B;AACF;AAEA,MAAa,iBAAiB,IAAIC,6BAAiC,UAAU;;;;AAK7E,IAAI,WAAoC;;;;AAKxC,MAAa,wBACX,QACA,kBAAkB,MAClB,YACqB;CACrB,IAAI,UAAU,OAAO;CAErB,WAAW,IAAI,iBAAiB;CAEhC,IAAI,QACF,SAAS,UAAU,MAAM;CAE3B,IAAI,YAAY,QACd,SAAS,WAAW,OAAO;CAE7B,SAAS,gBAAgB,IAAI,eAAe;CAE5C,OAAO;AACT"}

package/dist/cjs/client/useDictionary.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_getDictionary = require('../getDictionary.cjs');
 const require_client_intlayerToken = require('./intlayerToken.cjs');
 let _angular_core = require("@angular/core");
+let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useDictionary.ts
 /**
@@ -10,13 +11,14 @@ let _angular_core = require("@angular/core");
 */
 const useDictionary = (dictionary, localeOrSelector) => {
 	const intlayer = (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN);
-	const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && 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
-		});
+		if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false") return require_getDictionary.getDictionary(dictionary, (0, _intlayer_core_dictionaryManipulator.resolveDictionaryArgument)({
+			localeOrSelector,
+			contextLocale: currentLocale,
+			contextVariant: intlayer?.variant?.(),
+			dictionaryKey: dictionary.key
+		}));
 		return require_getDictionary.getDictionary(dictionary, localeOrSelector ?? currentLocale);
 	});
 };

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 {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\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    | DeclaredLocales\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    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    typeof localeOrSelector === 'object' &&\n    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":";;;;;;;;;;AAoBA,MAAa,iBAMX,YACA,qBAMG;CACH,MAAM,qCAAoCA,2CAAc;CAExD,MAAM,aACJ,QAAQ,IAAI,iCAAiC,WAC7C,OAAO,qBAAqB,YAC5B,qBAAqB;CAmBvB,yCAhB+B;EAC7B,MAAM,gBAAgB,UAAU,OAAO;EAEvC,IAAI,YACF,OAAOC,oCAAc,YAAY;GAC/B,GAAG;GACH,QAAQ,iBAAiB,UAAU;EACrC,CAAM;EAGR,OAAOA,oCACL,YACC,oBAAoB,aACvB;CACF,CAEa;AACf"}
+{"version":3,"file":"useDictionary.cjs","names":["INTLAYER_TOKEN","getDictionary"],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport { resolveDictionaryArgument } from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\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  /** a *stable* reactive dictionary object */\n  const content = computed(() => {\n    const currentLocale = intlayer?.locale();\n\n    if (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {\n      // Layers the provider's locale and variant under the call-site argument.\n      // This is also the seam the build-time optimize transform lands on, which\n      // rewrites `useIntlayer('key', selector)` into `useDictionary(dict, …)`.\n      return getDictionary(\n        dictionary,\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: currentLocale,\n          contextVariant: intlayer?.variant?.(),\n          dictionaryKey: dictionary.key,\n        }) as A\n      ) 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,2CAAc;CA2BxD,yCAxB+B;EAC7B,MAAM,gBAAgB,UAAU,OAAO;EAEvC,IAAI,QAAQ,IAAI,iCAAiC,SAI/C,OAAOC,oCACL,gFAC0B;GACxB;GACA,eAAe;GACf,gBAAgB,UAAU,UAAU;GACpC,eAAe,WAAW;EAC5B,CAAC,CACH;EAGF,OAAOA,oCACL,YACC,oBAAoB,aACvB;CACF,CAEa;AACf"}

package/dist/cjs/client/useDictionaryDynamic.cjs

@@ -24,8 +24,13 @@ let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryMan
 const useDictionaryDynamic = (dictionaryPromise, key, localeOrSelector) => {
 	const intlayer = (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN);
 	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && (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 { locale: selectorLocale, selector } = (0, _intlayer_core_dictionaryManipulator.parseDictionarySelector)((0, _intlayer_core_dictionaryManipulator.resolveDictionaryArgument)({
+			localeOrSelector,
+			contextLocale: intlayer?.locale(),
+			contextVariant: intlayer?.variant?.(),
+			dictionaryKey: String(key)
+		}));
+		const localeTarget = selectorLocale ?? _intlayer_config_built.internationalization.defaultLocale;
 		const container = (0, _angular_core.signal)(void 0);
 		(0, _intlayer_core_dictionaryManipulator.resolveQualifiedDynamicContentAsync)({
 			loaderMap: dictionaryPromise,

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

@@ -1 +1 @@
-{"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 { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\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, 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\n    | DeclaredLocales\n    | DictionarySelectorForKey<K> = DeclaredLocales,\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 (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryPromise)\n  ) {\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":";;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,wBAOX,mBAGA,KACA,qBACG;CACH,MAAM,qCAAoCA,2CAAc;CAExD,IACE,QAAQ,IAAI,iCAAiC,iFACjB,iBAAiB,GAC7C;EACA,MAAM,EAAE,QAAQ,gBAAgB,+EACS,gBAAgB;EAEzD,MAAM,eACJ,kBACA,UAAU,OAAO,KACjBC,4CAAqB;EAEvB,MAAM,sCAA4B,MAAS;EAE3C,8EAAoC;GAClC,WAAW;GACX,KAAK,OAAO,GAAG;GACf,QAAQ;GACR;GACA,YAAY,eAAeC,oCAAc,YAAY,YAAY;EACnE,CAAC,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,QAAQ,CAAC;EAE7C,yCAAsB,UAAU,CAAQ;CAC1C;CAEA,MAAM,SACJ,OAAO,qBAAqB,WACvB,mBACD;CAEN,MAAM,iDACE,UAAU,UAAU,OAAO,KAAKD,4CAAqB,aAC7D;CAOA,OAAOE,2CALYC,6CACjB,GAAG,OAAO,GAAG,EAAE,GAAG,aAAa,KAC9B,kBAA0B,aAAa,EAAE,GAAG,CAGjB,GAAG,aAAa,CAAQ;AACxD"}
+{"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  resolveDictionaryArgument,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\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, 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> = DeclaredLocales,\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 (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryPromise)\n  ) {\n    // Layers the provider's ambient variant under the call-site argument\n    // before the chunk walk, so only the targeted chunk is loaded.\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: intlayer?.locale(),\n          contextVariant: intlayer?.variant?.(),\n          dictionaryKey: String(key),\n        })\n      );\n\n    const localeTarget = selectorLocale ?? 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":";;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,wBAKX,mBAGA,KACA,qBACG;CACH,MAAM,qCAAoCA,2CAAc;CAExD,IACE,QAAQ,IAAI,iCAAiC,iFACjB,iBAAiB,GAC7C;EAGA,MAAM,EAAE,QAAQ,gBAAgB,mJAEF;GACxB;GACA,eAAe,UAAU,OAAO;GAChC,gBAAgB,UAAU,UAAU;GACpC,eAAe,OAAO,GAAG;EAC3B,CAAC,CACH;EAEF,MAAM,eAAe,kBAAkBC,4CAAqB;EAE5D,MAAM,sCAA4B,MAAS;EAE3C,8EAAoC;GAClC,WAAW;GACX,KAAK,OAAO,GAAG;GACf,QAAQ;GACR;GACA,YAAY,eAAeC,oCAAc,YAAY,YAAY;EACnE,CAAC,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,QAAQ,CAAC;EAE7C,yCAAsB,UAAU,CAAQ;CAC1C;CAEA,MAAM,SACJ,OAAO,qBAAqB,WACvB,mBACD;CAEN,MAAM,iDACE,UAAU,UAAU,OAAO,KAAKD,4CAAqB,aAC7D;CAOA,OAAOE,2CALYC,6CACjB,GAAG,OAAO,GAAG,EAAE,GAAG,aAAa,KAC9B,kBAA0B,aAAa,EAAE,GAAG,CAGjB,GAAG,aAAa,CAAQ;AACxD"}

package/dist/cjs/client/useIntlayer.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_getIntlayer = require('../getIntlayer.cjs');
 const require_client_intlayerToken = require('./intlayerToken.cjs');
 let _angular_core = require("@angular/core");
+let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useIntlayer.ts
 /** guard utility - true only for objects generated by `renderIntlayerNode()` */
@@ -33,13 +34,14 @@ const isUpdatableNode = (val) => !!val && typeof val === "object" && typeof val.
 */
 const useIntlayer = (key, localeOrSelector) => {
 	const intlayer = (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN);
-	const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && 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
-		});
+		if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false") return require_getIntlayer.getIntlayer(key, (0, _intlayer_core_dictionaryManipulator.resolveDictionaryArgument)({
+			localeOrSelector,
+			contextLocale: currentLocale,
+			contextVariant: intlayer.variant?.(),
+			dictionaryKey: key
+		}));
 		return require_getIntlayer.getIntlayer(key, localeOrSelector ?? currentLocale);
 	});
 };

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 { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\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\n    | DeclaredLocales\n    | 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    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    typeof localeOrSelector === 'object' &&\n    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":";;;;;;;AAcA,MAAa,mBACX,QAEA,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,OAAQ,IAAY,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BnC,MAAa,eAMX,KACA,qBAGG;CACH,MAAM,qCAAoCA,2CAAc;CAExD,MAAM,aACJ,QAAQ,IAAI,iCAAiC,WAC7C,OAAO,qBAAqB,YAC5B,qBAAqB;CAiBvB,yCAb+B;EAC7B,MAAM,gBAAgB,SAAS,OAAO;EAEtC,IAAI,YACF,OAAOC,gCAAY,KAAK;GACtB,GAAG;GACH,QAAQ,iBAAiB,UAAU;EACrC,CAAM;EAGR,OAAOA,gCAAY,KAAM,oBAAoB,aAAmB;CAClE,CAEa;AACf"}
+{"version":3,"file":"useIntlayer.cjs","names":["INTLAYER_TOKEN","getIntlayer"],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport { resolveDictionaryArgument } from '@intlayer/core/dictionaryManipulator';\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  /** 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 (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {\n      // Layers the provider's locale and variant under the call-site argument.\n      return getIntlayer(\n        key,\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: currentLocale,\n          contextVariant: intlayer.variant?.(),\n          dictionaryKey: key as string,\n        }) as A\n      ) 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,2CAAc;CAuBxD,yCAnB+B;EAC7B,MAAM,gBAAgB,SAAS,OAAO;EAEtC,IAAI,QAAQ,IAAI,iCAAiC,SAE/C,OAAOC,gCACL,yEAC0B;GACxB;GACA,eAAe;GACf,gBAAgB,SAAS,UAAU;GACnC,eAAe;EACjB,CAAC,CACH;EAGF,OAAOA,gCAAY,KAAM,oBAAoB,aAAmB;CAClE,CAEa;AACf"}

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 {\n  Dictionary,\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 * optionally combined with `locale`).\n */\nexport const getDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | DeclaredLocales\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":";;;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAIG;CAOH,qDACE,YACA,kBACAA,2BARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAMa,CACnB;AACF"}
+{"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  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 * 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":";;;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAIG;CAOH,qDACE,YACA,kBACAA,2BARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAMa,CACnB;AACF"}

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  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 }`,\n * optionally combined with `locale`).\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends\n    | DeclaredLocales\n    | 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":";;;;;;;;;;AAgBA,MAAa,eAMX,KACA,qBAIG;CAOH,mDAAuB,KAAK,kBAAkBA,2BAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAGyD,CAAC;AAClE"}
+{"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  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 }`,\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":";;;;;;;;;;AAgBA,MAAa,eAIX,KACA,qBAIG;CAOH,mDAAuB,KAAK,kBAAkBA,2BAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAGyD,CAAC;AAClE"}

package/dist/esm/client/installIntlayer.mjs

@@ -13,6 +13,13 @@ import { provideIntlayerEditor } from "../editor/useEditor.mjs";
 *
 * @param locale - Initial locale to use.
 * @param isCookieEnabled - Whether to store the locale in cookies.
+* @param variant - Ambient variant applied to every dictionary read in the app
+*   — for a dimension fixed for the whole session (tenant, school type, plan
+*   tier…) that no component should have to pass by hand. Accepts a name
+*   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a
+*   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is
+*   always the per-key map; nest a structured variant as
+*   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.
 * @returns An array of Angular providers for Intlayer.
 *
 * @example
@@ -26,8 +33,8 @@ import { provideIntlayerEditor } from "../editor/useEditor.mjs";
 * };
 * ```
 */
-const provideIntlayer = (locale, isCookieEnabled = true) => {
-	const client = installIntlayer(locale, isCookieEnabled);
+const provideIntlayer = (locale, isCookieEnabled = true, variant) => {
+	const client = installIntlayer(locale, isCookieEnabled, variant);
 	return [
 		{
 			provide: INTLAYER_TOKEN,
@@ -40,8 +47,8 @@ const provideIntlayer = (locale, isCookieEnabled = true) => {
 /**
 * Helper to install the Intlayer provider.
 */
-const installIntlayer = (locale, isCookieEnabled = true) => {
-	return createIntlayerClient(locale, isCookieEnabled);
+const installIntlayer = (locale, isCookieEnabled = true, variant) => {
+	return createIntlayerClient(locale, isCookieEnabled, variant);
 };
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"installIntlayer.mjs","names":[],"sources":["../../../src/client/installIntlayer.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { provideIntlayerAnalytics } from '../analytics/useAnalytics';\nimport { provideIntlayerEditor } from '../editor/useEditor';\nimport {\n  createIntlayerClient,\n  INTLAYER_TOKEN,\n  IntlayerProvider,\n} from './intlayerToken';\n\nexport { createIntlayerClient, INTLAYER_TOKEN, IntlayerProvider };\n\n/**\n * Provides Intlayer to your Angular application.\n *\n * Registers the Intlayer locale token **and** automatically starts the Intlayer\n * editor client (when the editor is enabled) via `provideAppInitializer`.\n *\n * This is the recommended way to set up Intlayer in `app.config.ts`.\n *\n * @param locale - Initial locale to use.\n * @param isCookieEnabled - Whether to store the locale in cookies.\n * @returns An array of Angular providers for Intlayer.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { ApplicationConfig } from '@angular/core';\n * import { provideIntlayer } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer()],\n * };\n * ```\n */\nexport const provideIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  const client = installIntlayer(locale, isCookieEnabled);\n\n  return [\n    { provide: INTLAYER_TOKEN, useValue: client },\n    provideIntlayerEditor(client),\n    provideIntlayerAnalytics(client),\n  ];\n};\n\n/**\n * Helper to install the Intlayer provider.\n */\nexport const installIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  return createIntlayerClient(locale, isCookieEnabled);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,mBACX,QACA,kBAAkB,SACf;CACH,MAAM,SAAS,gBAAgB,QAAQ,eAAe;CAEtD,OAAO;EACL;GAAE,SAAS;GAAgB,UAAU;EAAO;EAC5C,sBAAsB,MAAM;EAC5B,yBAAyB,MAAM;CACjC;AACF;;;;AAKA,MAAa,mBACX,QACA,kBAAkB,SACf;CACH,OAAO,qBAAqB,QAAQ,eAAe;AACrD"}
+{"version":3,"file":"installIntlayer.mjs","names":[],"sources":["../../../src/client/installIntlayer.ts"],"sourcesContent":["import type {\n  LocalesValues,\n  ProviderVariant,\n} from '@intlayer/types/module_augmentation';\nimport { provideIntlayerAnalytics } from '../analytics/useAnalytics';\nimport { provideIntlayerEditor } from '../editor/useEditor';\nimport {\n  createIntlayerClient,\n  INTLAYER_TOKEN,\n  IntlayerProvider,\n} from './intlayerToken';\n\nexport { createIntlayerClient, INTLAYER_TOKEN, IntlayerProvider };\n\n/**\n * Provides Intlayer to your Angular application.\n *\n * Registers the Intlayer locale token **and** automatically starts the Intlayer\n * editor client (when the editor is enabled) via `provideAppInitializer`.\n *\n * This is the recommended way to set up Intlayer in `app.config.ts`.\n *\n * @param locale - Initial locale to use.\n * @param isCookieEnabled - Whether to store the locale in cookies.\n * @param variant - Ambient variant applied to every dictionary read in the app\n *   — for a dimension fixed for the whole session (tenant, school type, plan\n *   tier…) that no component should have to pass by hand. Accepts a name\n *   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a\n *   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is\n *   always the per-key map; nest a structured variant as\n *   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.\n * @returns An array of Angular providers for Intlayer.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { ApplicationConfig } from '@angular/core';\n * import { provideIntlayer } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer()],\n * };\n * ```\n */\nexport const provideIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true,\n  variant?: ProviderVariant\n) => {\n  const client = installIntlayer(locale, isCookieEnabled, variant);\n\n  return [\n    { provide: INTLAYER_TOKEN, useValue: client },\n    provideIntlayerEditor(client),\n    provideIntlayerAnalytics(client),\n  ];\n};\n\n/**\n * Helper to install the Intlayer provider.\n */\nexport const installIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true,\n  variant?: ProviderVariant\n) => {\n  return createIntlayerClient(locale, isCookieEnabled, variant);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,mBACX,QACA,kBAAkB,MAClB,YACG;CACH,MAAM,SAAS,gBAAgB,QAAQ,iBAAiB,OAAO;CAE/D,OAAO;EACL;GAAE,SAAS;GAAgB,UAAU;EAAO;EAC5C,sBAAsB,MAAM;EAC5B,yBAAyB,MAAM;CACjC;AACF;;;;AAKA,MAAa,mBACX,QACA,kBAAkB,MAClB,YACG;CACH,OAAO,qBAAqB,QAAQ,iBAAiB,OAAO;AAC9D"}

package/dist/esm/client/intlayerToken.mjs

@@ -6,13 +6,22 @@ import { setIntlayerIdentifier } from "@intlayer/config/client";
 var IntlayerProvider = class {
 	isCookieEnabled = signal(true);
 	_locale = signal(internationalization.defaultLocale);
+	_variant = signal(void 0);
 	locale = this._locale.asReadonly();
+	/**
+	* Ambient variant applied to every dictionary read in the app, the same way
+	* `locale` is. Overridden per call by an explicit selector.
+	*/
+	variant = this._variant.asReadonly();
 	constructor() {
 		setIntlayerIdentifier();
 	}
 	setLocale = (locale) => {
 		this._locale.set(locale);
 	};
+	setVariant = (variant) => {
+		this._variant.set(variant);
+	};
 };
 const INTLAYER_TOKEN = new InjectionToken("intlayer");
 /**
@@ -22,10 +31,11 @@ let instance = null;
 /**
 * Create and return a single IntlayerProvider instance
 */
-const createIntlayerClient = (locale, isCookieEnabled = true) => {
+const createIntlayerClient = (locale, isCookieEnabled = true, variant) => {
 	if (instance) return instance;
 	instance = new IntlayerProvider();
 	if (locale) instance.setLocale(locale);
+	if (variant !== void 0) instance.setVariant(variant);
 	instance.isCookieEnabled.set(isCookieEnabled);
 	return instance;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"intlayerToken.mjs","names":[],"sources":["../../../src/client/intlayerToken.ts"],"sourcesContent":["import { InjectionToken, type Signal, signal } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport { setIntlayerIdentifier } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport class IntlayerProvider {\n  isCookieEnabled = signal(true);\n  private _locale = signal<LocalesValues>(\n    internationalization.defaultLocale as LocalesValues\n  );\n\n  readonly locale: Signal<LocalesValues> = this._locale.asReadonly();\n\n  constructor() {\n    setIntlayerIdentifier();\n  }\n\n  setLocale = (locale: LocalesValues) => {\n    this._locale.set(locale);\n  };\n}\n\nexport const INTLAYER_TOKEN = new InjectionToken<IntlayerProvider>('intlayer');\n\n/**\n * Singleton instance\n */\nlet instance: IntlayerProvider | null = null;\n\n/**\n * Create and return a single IntlayerProvider instance\n */\nexport const createIntlayerClient = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n): IntlayerProvider => {\n  if (instance) return instance;\n\n  instance = new IntlayerProvider();\n\n  if (locale) {\n    instance.setLocale(locale);\n  }\n  instance.isCookieEnabled.set(isCookieEnabled);\n\n  return instance;\n};\n"],"mappings":";;;;;AAKA,IAAa,mBAAb,MAA8B;CAC5B,kBAAkB,OAAO,IAAI;CAC7B,AAAQ,UAAU,OAChB,qBAAqB,aACvB;CAEA,AAAS,SAAgC,KAAK,QAAQ,WAAW;CAEjE,cAAc;EACZ,sBAAsB;CACxB;CAEA,aAAa,WAA0B;EACrC,KAAK,QAAQ,IAAI,MAAM;CACzB;AACF;AAEA,MAAa,iBAAiB,IAAI,eAAiC,UAAU;;;;AAK7E,IAAI,WAAoC;;;;AAKxC,MAAa,wBACX,QACA,kBAAkB,SACG;CACrB,IAAI,UAAU,OAAO;CAErB,WAAW,IAAI,iBAAiB;CAEhC,IAAI,QACF,SAAS,UAAU,MAAM;CAE3B,SAAS,gBAAgB,IAAI,eAAe;CAE5C,OAAO;AACT"}
+{"version":3,"file":"intlayerToken.mjs","names":[],"sources":["../../../src/client/intlayerToken.ts"],"sourcesContent":["import { InjectionToken, type Signal, signal } from '@angular/core';\nimport { internationalization } from '@intlayer/config/built';\nimport { setIntlayerIdentifier } from '@intlayer/config/client';\nimport type {\n  LocalesValues,\n  ProviderVariant,\n} from '@intlayer/types/module_augmentation';\n\nexport class IntlayerProvider {\n  isCookieEnabled = signal(true);\n  private _locale = signal<LocalesValues>(\n    internationalization.defaultLocale as LocalesValues\n  );\n\n  private _variant = signal<ProviderVariant | undefined>(undefined);\n\n  readonly locale: Signal<LocalesValues> = this._locale.asReadonly();\n\n  /**\n   * Ambient variant applied to every dictionary read in the app, the same way\n   * `locale` is. Overridden per call by an explicit selector.\n   */\n  readonly variant: Signal<ProviderVariant | undefined> =\n    this._variant.asReadonly();\n\n  constructor() {\n    setIntlayerIdentifier();\n  }\n\n  setLocale = (locale: LocalesValues) => {\n    this._locale.set(locale);\n  };\n\n  setVariant = (variant: ProviderVariant | undefined) => {\n    this._variant.set(variant);\n  };\n}\n\nexport const INTLAYER_TOKEN = new InjectionToken<IntlayerProvider>('intlayer');\n\n/**\n * Singleton instance\n */\nlet instance: IntlayerProvider | null = null;\n\n/**\n * Create and return a single IntlayerProvider instance\n */\nexport const createIntlayerClient = (\n  locale?: LocalesValues,\n  isCookieEnabled = true,\n  variant?: ProviderVariant\n): IntlayerProvider => {\n  if (instance) return instance;\n\n  instance = new IntlayerProvider();\n\n  if (locale) {\n    instance.setLocale(locale);\n  }\n  if (variant !== undefined) {\n    instance.setVariant(variant);\n  }\n  instance.isCookieEnabled.set(isCookieEnabled);\n\n  return instance;\n};\n"],"mappings":";;;;;AAQA,IAAa,mBAAb,MAA8B;CAC5B,kBAAkB,OAAO,IAAI;CAC7B,AAAQ,UAAU,OAChB,qBAAqB,aACvB;CAEA,AAAQ,WAAW,OAAoC,MAAS;CAEhE,AAAS,SAAgC,KAAK,QAAQ,WAAW;;;;;CAMjE,AAAS,UACP,KAAK,SAAS,WAAW;CAE3B,cAAc;EACZ,sBAAsB;CACxB;CAEA,aAAa,WAA0B;EACrC,KAAK,QAAQ,IAAI,MAAM;CACzB;CAEA,cAAc,YAAyC;EACrD,KAAK,SAAS,IAAI,OAAO;CAC3B;AACF;AAEA,MAAa,iBAAiB,IAAI,eAAiC,UAAU;;;;AAK7E,IAAI,WAAoC;;;;AAKxC,MAAa,wBACX,QACA,kBAAkB,MAClB,YACqB;CACrB,IAAI,UAAU,OAAO;CAErB,WAAW,IAAI,iBAAiB;CAEhC,IAAI,QACF,SAAS,UAAU,MAAM;CAE3B,IAAI,YAAY,QACd,SAAS,WAAW,OAAO;CAE7B,SAAS,gBAAgB,IAAI,eAAe;CAE5C,OAAO;AACT"}

package/dist/esm/client/useDictionary.mjs

@@ -1,6 +1,7 @@
 import { getDictionary } from "../getDictionary.mjs";
 import { INTLAYER_TOKEN } from "./intlayerToken.mjs";
 import { computed, inject } from "@angular/core";
+import { resolveDictionaryArgument } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/client/useDictionary.ts
 /**
@@ -9,13 +10,14 @@ import { computed, inject } from "@angular/core";
 */
 const useDictionary = (dictionary, localeOrSelector) => {
 	const intlayer = inject(INTLAYER_TOKEN);
-	const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && typeof localeOrSelector === "object" && localeOrSelector !== null;
 	return computed(() => {
 		const currentLocale = intlayer?.locale();
-		if (isSelector) return getDictionary(dictionary, {
-			...localeOrSelector,
-			locale: localeOrSelector.locale ?? currentLocale
-		});
+		if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false") return getDictionary(dictionary, resolveDictionaryArgument({
+			localeOrSelector,
+			contextLocale: currentLocale,
+			contextVariant: intlayer?.variant?.(),
+			dictionaryKey: dictionary.key
+		}));
 		return getDictionary(dictionary, localeOrSelector ?? currentLocale);
 	});
 };

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 {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\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    | DeclaredLocales\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    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    typeof localeOrSelector === 'object' &&\n    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":";;;;;;;;;AAoBA,MAAa,iBAMX,YACA,qBAMG;CACH,MAAM,WAAW,OAAyB,cAAc;CAExD,MAAM,aACJ,QAAQ,IAAI,iCAAiC,WAC7C,OAAO,qBAAqB,YAC5B,qBAAqB;CAmBvB,OAhBgB,eAAe;EAC7B,MAAM,gBAAgB,UAAU,OAAO;EAEvC,IAAI,YACF,OAAO,cAAc,YAAY;GAC/B,GAAG;GACH,QAAQ,iBAAiB,UAAU;EACrC,CAAM;EAGR,OAAO,cACL,YACC,oBAAoB,aACvB;CACF,CAEa;AACf"}
+{"version":3,"file":"useDictionary.mjs","names":[],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport { resolveDictionaryArgument } from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\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  /** a *stable* reactive dictionary object */\n  const content = computed(() => {\n    const currentLocale = intlayer?.locale();\n\n    if (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {\n      // Layers the provider's locale and variant under the call-site argument.\n      // This is also the seam the build-time optimize transform lands on, which\n      // rewrites `useIntlayer('key', selector)` into `useDictionary(dict, …)`.\n      return getDictionary(\n        dictionary,\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: currentLocale,\n          contextVariant: intlayer?.variant?.(),\n          dictionaryKey: dictionary.key,\n        }) as A\n      ) 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,cAAc;CA2BxD,OAxBgB,eAAe;EAC7B,MAAM,gBAAgB,UAAU,OAAO;EAEvC,IAAI,QAAQ,IAAI,iCAAiC,SAI/C,OAAO,cACL,YACA,0BAA0B;GACxB;GACA,eAAe;GACf,gBAAgB,UAAU,UAAU;GACpC,eAAe,WAAW;EAC5B,CAAC,CACH;EAGF,OAAO,cACL,YACC,oBAAoB,aACvB;CACF,CAEa;AACf"}

package/dist/esm/client/useDictionaryDynamic.mjs

@@ -6,7 +6,7 @@ import { useDictionary } from "./useDictionary.mjs";
 import { useLoadDynamic } from "./useLoadDynamic.mjs";
 import { internationalization } from "@intlayer/config/built";
 import { computed, inject, signal } from "@angular/core";
-import { isQualifiedDynamicLoaderMap, parseDictionarySelector, resolveQualifiedDynamicContentAsync } from "@intlayer/core/dictionaryManipulator";
+import { isQualifiedDynamicLoaderMap, parseDictionarySelector, resolveDictionaryArgument, resolveQualifiedDynamicContentAsync } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/client/useDictionaryDynamic.ts
 /**
@@ -23,8 +23,13 @@ import { isQualifiedDynamicLoaderMap, parseDictionarySelector, resolveQualifiedD
 const useDictionaryDynamic = (dictionaryPromise, key, localeOrSelector) => {
 	const intlayer = inject(INTLAYER_TOKEN);
 	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && isQualifiedDynamicLoaderMap(dictionaryPromise)) {
-		const { locale: selectorLocale, selector } = parseDictionarySelector(localeOrSelector);
-		const localeTarget = selectorLocale ?? intlayer?.locale() ?? internationalization.defaultLocale;
+		const { locale: selectorLocale, selector } = parseDictionarySelector(resolveDictionaryArgument({
+			localeOrSelector,
+			contextLocale: intlayer?.locale(),
+			contextVariant: intlayer?.variant?.(),
+			dictionaryKey: String(key)
+		}));
+		const localeTarget = selectorLocale ?? internationalization.defaultLocale;
 		const container = signal(void 0);
 		resolveQualifiedDynamicContentAsync({
 			loaderMap: dictionaryPromise,

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, 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 { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\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, 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\n    | DeclaredLocales\n    | DictionarySelectorForKey<K> = DeclaredLocales,\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 (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryPromise)\n  ) {\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":";;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,wBAOX,mBAGA,KACA,qBACG;CACH,MAAM,WAAW,OAAyB,cAAc;CAExD,IACE,QAAQ,IAAI,iCAAiC,WAC7C,4BAA4B,iBAAiB,GAC7C;EACA,MAAM,EAAE,QAAQ,gBAAgB,aAC9B,wBAAuC,gBAAgB;EAEzD,MAAM,eACJ,kBACA,UAAU,OAAO,KACjB,qBAAqB;EAEvB,MAAM,YAAY,OAAgB,MAAS;EAE3C,oCAAoC;GAClC,WAAW;GACX,KAAK,OAAO,GAAG;GACf,QAAQ;GACR;GACA,YAAY,eAAe,cAAc,YAAY,YAAY;EACnE,CAAC,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,QAAQ,CAAC;EAE7C,OAAO,eAAe,UAAU,CAAQ;CAC1C;CAEA,MAAM,SACJ,OAAO,qBAAqB,WACvB,mBACD;CAEN,MAAM,eAAe,eACb,UAAU,UAAU,OAAO,KAAK,qBAAqB,aAC7D;CAOA,OAAO,cALY,eACjB,GAAG,OAAO,GAAG,EAAE,GAAG,aAAa,KAC9B,kBAA0B,aAAa,EAAE,GAAG,CAGjB,GAAG,aAAa,CAAQ;AACxD"}
+{"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  resolveDictionaryArgument,\n  resolveQualifiedDynamicContentAsync,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\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, 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> = DeclaredLocales,\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 (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryPromise)\n  ) {\n    // Layers the provider's ambient variant under the call-site argument\n    // before the chunk walk, so only the targeted chunk is loaded.\n    const { locale: selectorLocale, selector } =\n      parseDictionarySelector<LocalesValues>(\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: intlayer?.locale(),\n          contextVariant: intlayer?.variant?.(),\n          dictionaryKey: String(key),\n        })\n      );\n\n    const localeTarget = selectorLocale ?? 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":";;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,wBAKX,mBAGA,KACA,qBACG;CACH,MAAM,WAAW,OAAyB,cAAc;CAExD,IACE,QAAQ,IAAI,iCAAiC,WAC7C,4BAA4B,iBAAiB,GAC7C;EAGA,MAAM,EAAE,QAAQ,gBAAgB,aAC9B,wBACE,0BAA0B;GACxB;GACA,eAAe,UAAU,OAAO;GAChC,gBAAgB,UAAU,UAAU;GACpC,eAAe,OAAO,GAAG;EAC3B,CAAC,CACH;EAEF,MAAM,eAAe,kBAAkB,qBAAqB;EAE5D,MAAM,YAAY,OAAgB,MAAS;EAE3C,oCAAoC;GAClC,WAAW;GACX,KAAK,OAAO,GAAG;GACf,QAAQ;GACR;GACA,YAAY,eAAe,cAAc,YAAY,YAAY;EACnE,CAAC,CAAC,CAAC,MAAM,aAAa,UAAU,IAAI,QAAQ,CAAC;EAE7C,OAAO,eAAe,UAAU,CAAQ;CAC1C;CAEA,MAAM,SACJ,OAAO,qBAAqB,WACvB,mBACD;CAEN,MAAM,eAAe,eACb,UAAU,UAAU,OAAO,KAAK,qBAAqB,aAC7D;CAOA,OAAO,cALY,eACjB,GAAG,OAAO,GAAG,EAAE,GAAG,aAAa,KAC9B,kBAA0B,aAAa,EAAE,GAAG,CAGjB,GAAG,aAAa,CAAQ;AACxD"}

package/dist/esm/client/useIntlayer.mjs

@@ -1,6 +1,7 @@
 import { getIntlayer } from "../getIntlayer.mjs";
 import { INTLAYER_TOKEN } from "./intlayerToken.mjs";
 import { computed, inject } from "@angular/core";
+import { resolveDictionaryArgument } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/client/useIntlayer.ts
 /** guard utility - true only for objects generated by `renderIntlayerNode()` */
@@ -32,13 +33,14 @@ const isUpdatableNode = (val) => !!val && typeof val === "object" && typeof val.
 */
 const useIntlayer = (key, localeOrSelector) => {
 	const intlayer = inject(INTLAYER_TOKEN);
-	const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && typeof localeOrSelector === "object" && localeOrSelector !== null;
 	return computed(() => {
 		const currentLocale = intlayer.locale();
-		if (isSelector) return getIntlayer(key, {
-			...localeOrSelector,
-			locale: localeOrSelector.locale ?? currentLocale
-		});
+		if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false") return getIntlayer(key, resolveDictionaryArgument({
+			localeOrSelector,
+			contextLocale: currentLocale,
+			contextVariant: intlayer.variant?.(),
+			dictionaryKey: key
+		}));
 		return getIntlayer(key, localeOrSelector ?? currentLocale);
 	});
 };

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 { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\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\n    | DeclaredLocales\n    | 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    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    typeof localeOrSelector === 'object' &&\n    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":";;;;;;AAcA,MAAa,mBACX,QAEA,CAAC,CAAC,OACF,OAAO,QAAQ,YACf,OAAQ,IAAY,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BnC,MAAa,eAMX,KACA,qBAGG;CACH,MAAM,WAAW,OAAyB,cAAc;CAExD,MAAM,aACJ,QAAQ,IAAI,iCAAiC,WAC7C,OAAO,qBAAqB,YAC5B,qBAAqB;CAiBvB,OAbgB,eAAe;EAC7B,MAAM,gBAAgB,SAAS,OAAO;EAEtC,IAAI,YACF,OAAO,YAAY,KAAK;GACtB,GAAG;GACH,QAAQ,iBAAiB,UAAU;EACrC,CAAM;EAGR,OAAO,YAAY,KAAM,oBAAoB,aAAmB;CAClE,CAEa;AACf"}
+{"version":3,"file":"useIntlayer.mjs","names":[],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["import { computed, inject, type Signal } from '@angular/core';\nimport { resolveDictionaryArgument } from '@intlayer/core/dictionaryManipulator';\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  /** 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 (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {\n      // Layers the provider's locale and variant under the call-site argument.\n      return getIntlayer(\n        key,\n        resolveDictionaryArgument({\n          localeOrSelector,\n          contextLocale: currentLocale,\n          contextVariant: intlayer.variant?.(),\n          dictionaryKey: key as string,\n        }) as A\n      ) 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,cAAc;CAuBxD,OAnBgB,eAAe;EAC7B,MAAM,gBAAgB,SAAS,OAAO;EAEtC,IAAI,QAAQ,IAAI,iCAAiC,SAE/C,OAAO,YACL,KACA,0BAA0B;GACxB;GACA,eAAe;GACf,gBAAgB,SAAS,UAAU;GACnC,eAAe;EACjB,CAAC,CACH;EAGF,OAAO,YAAY,KAAM,oBAAoB,aAAmB;CAClE,CAEa;AACf"}

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 {\n  Dictionary,\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 * optionally combined with `locale`).\n */\nexport const getDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | DeclaredLocales\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":";;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAIG;CAOH,OAAOA,gBACL,YACA,kBACA,WARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAMa,CACnB;AACF"}
+{"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  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 * 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":";;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAIG;CAOH,OAAOA,gBACL,YACA,kBACA,WARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAMa,CACnB;AACF"}

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  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 }`,\n * optionally combined with `locale`).\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends\n    | DeclaredLocales\n    | 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":";;;;;;;;;AAgBA,MAAa,eAMX,KACA,qBAIG;CAOH,OAAOA,cAAgB,KAAK,kBAAkB,WAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAGyD,CAAC;AAClE"}
+{"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  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 }`,\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":";;;;;;;;;AAgBA,MAAa,eAIX,KACA,qBAIG;CAOH,OAAOA,cAAgB,KAAK,kBAAkB,WAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,gBAGyD,CAAC;AAClE"}

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

@@ -1,5 +1,5 @@
 import { INTLAYER_TOKEN, IntlayerProvider, createIntlayerClient } from "./intlayerToken.js";
-import { LocalesValues } from "@intlayer/types/module_augmentation";
+import { LocalesValues, ProviderVariant } from "@intlayer/types/module_augmentation";
 //#region src/client/installIntlayer.d.ts
 /**
  * Provides Intlayer to your Angular application.
@@ -11,6 +11,13 @@ import { LocalesValues } from "@intlayer/types/module_augmentation";
  *
  * @param locale - Initial locale to use.
  * @param isCookieEnabled - Whether to store the locale in cookies.
+ * @param variant - Ambient variant applied to every dictionary read in the app
+ *   — for a dimension fixed for the whole session (tenant, school type, plan
+ *   tier…) that no component should have to pass by hand. Accepts a name
+ *   (`'school1'`), an ordered preference chain (`['school1', 'default']`), or a
+ *   per-key map (`{ key1: 'school1', default: 'base' }`). A plain object is
+ *   always the per-key map; nest a structured variant as
+ *   `{ default: { id: 'prod_abc' } }`. A call-site selector always wins.
  * @returns An array of Angular providers for Intlayer.
  *
  * @example
@@ -24,14 +31,14 @@ import { LocalesValues } from "@intlayer/types/module_augmentation";
  * };
  * ```
  */
-declare const provideIntlayer: (locale?: LocalesValues, isCookieEnabled?: boolean) => (import("@angular/core").EnvironmentProviders | {
+declare const provideIntlayer: (locale?: LocalesValues, isCookieEnabled?: boolean, variant?: ProviderVariant) => (import("@angular/core").EnvironmentProviders | {
   provide: import("@angular/core").InjectionToken<IntlayerProvider>;
   useValue: IntlayerProvider;
 })[];
 /**
  * Helper to install the Intlayer provider.
  */
-declare const installIntlayer: (locale?: LocalesValues, isCookieEnabled?: boolean) => IntlayerProvider;
+declare const installIntlayer: (locale?: LocalesValues, isCookieEnabled?: boolean, variant?: ProviderVariant) => IntlayerProvider;
 //#endregion
 export { INTLAYER_TOKEN, IntlayerProvider, createIntlayerClient, installIntlayer, provideIntlayer };
 //# sourceMappingURL=installIntlayer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"installIntlayer.d.ts","names":[],"sources":["../../../src/client/installIntlayer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;cAkCa,kBAAe,SACjB,eAAa,uDAAA;;;;;;;cAeX,kBAAe,SACjB,eAAa,8BAAA"}
+{"version":3,"file":"installIntlayer.d.ts","names":[],"sources":["../../../src/client/installIntlayer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4Ca,kBAAe,SACjB,eAAa,2BAAA,UAEZ,6CAAe;;;;;;;cAcd,kBAAe,SACjB,eAAa,2BAAA,UAEZ,oBAAe"}

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

@@ -1,18 +1,25 @@
 import { InjectionToken, Signal } from "@angular/core";
-import { LocalesValues } from "@intlayer/types/module_augmentation";
+import { LocalesValues, ProviderVariant } from "@intlayer/types/module_augmentation";
 //#region src/client/intlayerToken.d.ts
 declare class IntlayerProvider {
   isCookieEnabled: import("@angular/core").WritableSignal<boolean>;
   private _locale;
+  private _variant;
   readonly locale: Signal<LocalesValues>;
+  /**
+   * Ambient variant applied to every dictionary read in the app, the same way
+   * `locale` is. Overridden per call by an explicit selector.
+   */
+  readonly variant: Signal<ProviderVariant | undefined>;
   constructor();
   setLocale: (locale: LocalesValues) => void;
+  setVariant: (variant: ProviderVariant | undefined) => void;
 }
 declare const INTLAYER_TOKEN: InjectionToken<IntlayerProvider>;
 /**
  * Create and return a single IntlayerProvider instance
  */
-declare const createIntlayerClient: (locale?: LocalesValues, isCookieEnabled?: boolean) => IntlayerProvider;
+declare const createIntlayerClient: (locale?: LocalesValues, isCookieEnabled?: boolean, variant?: ProviderVariant) => IntlayerProvider;
 //#endregion
 export { INTLAYER_TOKEN, IntlayerProvider, createIntlayerClient };
 //# sourceMappingURL=intlayerToken.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"intlayerToken.d.ts","names":[],"sources":["../../../src/client/intlayerToken.ts"],"mappings":";;;cAKa;EACX,yCAAe;UACP;WAIC,QAAQ,OAAO;EAExB;EAIA,YAAS,QAAY;;cAKV,gBAAc,eAAA;;;;cAUd,uBAAoB,SACtB,eAAa,8BAErB"}
+{"version":3,"file":"intlayerToken.d.ts","names":[],"sources":["../../../src/client/intlayerToken.ts"],"mappings":";;;cAQa;EACX,yCAAe;UACP;UAIA;WAEC,QAAQ,OAAO;;;;;WAMf,SAAS,OAAO;EAGzB;EAIA,YAAS,QAAY;EAIrB,aAAU,SAAa;;cAKZ,gBAAc,eAAA;;;;cAUd,uBAAoB,SACtB,eAAa,2BAAA,UAEZ,oBACT"}

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

@@ -1,13 +1,13 @@
 import { DeepTransformContent } from "../plugins.js";
 import { Signal } from "@angular/core";
-import { DeclaredLocales, ExtractSelectorLocale } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 import { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from "@intlayer/types/dictionary";
 //#region src/client/useDictionary.d.ts
 /**
  * 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 DeclaredLocales | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => Signal<DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>>;
+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":";;;;;;;;;cAoBa,sBACL,UAAU,aAAa,gCACvB,UACF,kBACA,2BAA2B,KAAK,iBAAe,YAEvC,GAAC,mBACM,MAClB,OACD,qBACE,kCAAkC,GAAG,IACrC,sBAAsB"}
+{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../../src/client/useDictionary.ts"],"mappings":";;;;;;;;;cAqBa,sBACL,UAAU,aAAa,gCACvB,UACF,gBACA,2BAA2B,KAAK,iBAAe,YAEvC,GAAC,mBACM,MAClB,OACD,qBACE,kCAAkC,GAAG,IACrC,sBAAsB"}

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

@@ -1,4 +1,4 @@
-import { DeclaredLocales, DictionaryKeys, DictionarySelectorForKey, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, DictionaryKeys, DictionarySelectorForKey, LocalesValues, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
 import { Dictionary } from "@intlayer/types/dictionary";
 import { QualifiedDynamicLoaderMap } from "@intlayer/core/dictionaryManipulator";
 //#region src/client/useDictionaryDynamic.d.ts
@@ -13,7 +13,7 @@ import { QualifiedDynamicLoaderMap } from "@intlayer/core/dictionaryManipulator"
  * 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, const A extends DeclaredLocales | DictionarySelectorForKey<K> = DeclaredLocales>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>> | QualifiedDynamicLoaderMap, key: K, localeOrSelector?: A) => import("@angular/core").Signal<any>;
+declare const useDictionaryDynamic: <const T extends Dictionary, const K extends DictionaryKeys, const A extends LocalesValues | DictionarySelectorForKey<K> = DeclaredLocales>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>> | QualifiedDynamicLoaderMap, key: K, localeOrSelector?: A) => import("@angular/core").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":";;;;;;;;;;;;;;;cAkCa,6BACL,UAAU,kBACV,UAAU,sBACV,UACF,kBACA,yBAAyB,KAAK,iBAAe,mBAG7C,0BAA0B,QAAQ,MAClC,2BAAyB,KACxB,GAAC,mBACa,8BAAC"}
+{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../../src/client/useDictionaryDynamic.ts"],"mappings":";;;;;;;;;;;;;;;cAmCa,6BACL,UAAU,kBACV,UAAU,sBACV,UAAU,gBAAgB,yBAAyB,KAAK,iBAAe,mBAGzE,0BAA0B,QAAQ,MAClC,2BAAyB,KACxB,GAAC,mBACa,8BAAC"}

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

@@ -1,6 +1,6 @@
 import { DeepTransformContent } from "../plugins.js";
 import { Signal } from "@angular/core";
-import { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale } 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()` */
 declare const isUpdatableNode: (val: unknown) => val is {
@@ -31,7 +31,7 @@ declare const isUpdatableNode: (val: unknown) => val is {
  * }
  * ```
  */
-declare const useIntlayer: <const T extends DictionaryKeys, const A extends DeclaredLocales | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => Signal<DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>>;
+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":";;;;;cAca,kBAAe,iBAEzB;EAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BV,oBACL,UAAU,sBACV,UACF,kBACA,yBAAyB,KAAK,iBAAe,KAE5C,GAAC,mBACa,MAClB,OACD,qBAAqB,yBAAyB,GAAG,IAAI,sBAAsB"}
+{"version":3,"file":"useIntlayer.d.ts","names":[],"sources":["../../../src/client/useIntlayer.ts"],"mappings":";;;;;cAea,kBAAe,iBAEzB;EAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BV,oBACL,UAAU,sBACV,UAAU,gBAAgB,yBAAyB,KAAK,iBAAe,KAExE,GAAC,mBACa,MAClB,OACD,qBAAqB,yBAAyB,GAAG,IAAI,sBAAsB"}

package/dist/types/getDictionary.d.ts

@@ -1,5 +1,5 @@
 import { DeepTransformContent } from "./plugins.js";
-import { DeclaredLocales, ExtractSelectorLocale } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 import { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from "@intlayer/types/dictionary";
 //#region src/getDictionary.d.ts
 /**
@@ -7,7 +7,7 @@ import { Dictionary, DictionarySelectorForGroup, QualifiedDictionaryGroup, Resol
  * content for the given locale or selector (`{ item }`, `{ variant }`,
  * optionally combined with `locale`).
  */
-declare const getDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends DeclaredLocales | DictionarySelectorForGroup<T> = DeclaredLocales>(dictionary: T, localeOrSelector?: A) => DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, ExtractSelectorLocale<A>>;
+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":";;;;;;;;;cAmBa,sBACL,UAAU,aAAa,gCACvB,UACF,kBACA,2BAA2B,KAAK,iBAAe,YAEvC,GAAC,mBACM,MAClB,qBACD,kCAAkC,GAAG,IACrC,sBAAsB"}
+{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../src/getDictionary.ts"],"mappings":";;;;;;;;;cAmBa,sBACL,UAAU,aAAa,gCACvB,UACF,gBACA,2BAA2B,KAAK,iBAAe,YAEvC,GAAC,mBACM,MAClB,qBACD,kCAAkC,GAAG,IACrC,sBAAsB"}

package/dist/types/getIntlayer.d.ts

@@ -1,12 +1,12 @@
 import { DeepTransformContent } from "./plugins.js";
-import { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, DictionarySelectorForKey, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 //#region src/getIntlayer.d.ts
 /**
  * Picks one dictionary by its key and returns its content for the given
  * locale or selector (`{ item }`, `{ variant }`,
  * optionally combined with `locale`).
  */
-declare const getIntlayer: <const T extends DictionaryKeys, const A extends DeclaredLocales | DictionarySelectorForKey<T> = DeclaredLocales>(key: T, localeOrSelector?: A) => DeepTransformContent<DictionaryRegistryResult<T, A>, ExtractSelectorLocale<A>>;
+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":";;;;;;;;cAgBa,oBACL,UAAU,sBACV,UACF,kBACA,yBAAyB,KAAK,iBAAe,KAE5C,GAAC,mBACa,MAClB,qBACD,yBAAyB,GAAG,IAC5B,sBAAsB"}
+{"version":3,"file":"getIntlayer.d.ts","names":[],"sources":["../../src/getIntlayer.ts"],"mappings":";;;;;;;;cAgBa,oBACL,UAAU,sBACV,UAAU,gBAAgB,yBAAyB,KAAK,iBAAe,KAExE,GAAC,mBACa,MAClB,qBACD,yBAAyB,GAAG,IAC5B,sBAAsB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-intlayer",
-  "version": "9.1.1",
+  "version": "9.1.3",
   "private": false,
   "description": "Easily internationalize i18n your Angular applications with type-safe multilingual content management.",
   "keywords": [
@@ -119,13 +119,13 @@
     "@babel/core": "^7.26.9",
     "@babel/plugin-syntax-import-attributes": "7.28.6",
     "@babel/preset-env": "7.29.2",
-    "@intlayer/config": "9.1.1",
-    "@intlayer/core": "9.1.1",
-    "@intlayer/dictionaries-entry": "9.1.1",
-    "@intlayer/editor": "9.1.1",
-    "@intlayer/engine": "9.1.1",
-    "@intlayer/types": "9.1.1",
-    "@intlayer/webpack": "9.1.1",
+    "@intlayer/config": "9.1.3",
+    "@intlayer/core": "9.1.3",
+    "@intlayer/dictionaries-entry": "9.1.3",
+    "@intlayer/editor": "9.1.3",
+    "@intlayer/engine": "9.1.3",
+    "@intlayer/types": "9.1.3",
+    "@intlayer/webpack": "9.1.3",
     "babel-loader": "10.1.1",
     "defu": "6.1.7"
   },
@@ -155,7 +155,7 @@
     }
   },
   "optionalDependencies": {
-    "@intlayer/analytics": "9.1.1"
+    "@intlayer/analytics": "9.1.3"
   },
   "engines": {
     "node": ">=14.18"