@intlayer/core 8.12.5-canary.0 → 9.0.0-canary.0

package/dist/types/@intlayer/core/dist/types/localization/validatePrefix.d.ts

@@ -0,0 +1 @@
+import { LocalesValues } from "@intlayer/types/module_augmentation";

package/dist/types/@intlayer/core/dist/types/markdown/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/types/@intlayer/core/dist/types/transpiler/collection/collection.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/types/@intlayer/core/dist/types/transpiler/condition/condition.d.ts

@@ -0,0 +1 @@
+import { CONDITION, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/enumeration/enumeration.d.ts

@@ -0,0 +1 @@
+import { ENUMERATION, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/file/file.d.ts

@@ -0,0 +1 @@
+import { FILE, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/gender/gender.d.ts

@@ -0,0 +1 @@
+import { GENDER, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/html/html.d.ts

@@ -0,0 +1 @@
+import { HTML, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/types/@intlayer/core/dist/types/transpiler/insertion/insertion.d.ts

@@ -0,0 +1 @@
+import { INSERTION, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/markdown/markdown.d.ts

@@ -0,0 +1 @@
+import { MARKDOWN, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/nesting/nesting.d.ts

@@ -0,0 +1,2 @@
+import { DictionaryKeys, DictionaryRegistryContent } from "@intlayer/types/module_augmentation";
+import { NESTED, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/plural/plural.d.ts

@@ -0,0 +1 @@
+import { PLURAL, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/translation/translation.d.ts

@@ -0,0 +1,2 @@
+import { StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
+import { TRANSLATION, TypedNodeModel } from "@intlayer/types/nodeType";

package/dist/types/@intlayer/core/dist/types/transpiler/variant/variant.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/types/@intlayer/core/dist/types/utils/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/types/@intlayer/core/dist/types/utils/intl.d.ts

@@ -0,0 +1 @@
+import { LocalesValues } from "@intlayer/types/module_augmentation";

package/dist/types/@intlayer/core/dist/types/utils/isSameKeyPath.d.ts

@@ -0,0 +1 @@
+import { KeyPath } from "@intlayer/types/keyPath";

package/dist/types/@intlayer/core/dist/types/utils/localeStorage.d.ts

@@ -0,0 +1,2 @@
+import { LocalesValues } from "@intlayer/types/module_augmentation";
+import { Locale } from "@intlayer/types/allLocales";

package/dist/types/deepTransformPlugins/getEditedContent.d.ts

@@ -0,0 +1,33 @@
+import { ContentNode, Dictionary } from "@intlayer/types/dictionary";
+import { LocalesValues } from "@intlayer/types/module_augmentation";
+
+//#region src/deepTransformPlugins/getEditedContent.d.ts
+/**
+ * Returns the partial content holding only the `translation` nodes whose
+ * source (`defaultLocale`) value was added or changed between `previousContent`
+ * and `newContent`. Each changed node is reduced to its source locale so that
+ * every target locale is regenerated when the partial is translated.
+ *
+ * Returns `{}` (empty content) when no source value changed.
+ *
+ * @example
+ * // default value of `title` changed → only `title` is returned, source-only
+ * getEditedContent(
+ *   { title: t({ en: 'Old', fr: 'Vieux' }), body: t({ en: 'B', fr: 'B' }) },
+ *   { title: t({ en: 'New', fr: 'Vieux' }), body: t({ en: 'B', fr: 'B' }) },
+ *   'en'
+ * ); // → { title: { nodeType: 'translation', translation: { en: 'New' } } }
+ */
+declare const getEditedContent: (previousContent: ContentNode | undefined, newContent: ContentNode, defaultLocale: LocalesValues) => ContentNode;
+/**
+ * Dictionary-level wrapper around {@link getEditedContent}. Returns a partial
+ * dictionary (same `key`) whose `content` holds only the changed source nodes.
+ *
+ * @param previousDictionary - Dictionary state before the edit.
+ * @param newDictionary - Dictionary state after the edit.
+ * @param defaultLocale - The source locale to diff against.
+ */
+declare const getEditedDictionary: (previousDictionary: Dictionary | undefined, newDictionary: Dictionary, defaultLocale: LocalesValues) => Dictionary;
+//#endregion
+export { getEditedContent, getEditedDictionary };
+//# sourceMappingURL=getEditedContent.d.ts.map

package/dist/types/deepTransformPlugins/getEditedContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEditedContent.d.ts","names":[],"sources":["../../../src/deepTransformPlugins/getEditedContent.ts"],"mappings":";;;;;;AA2JA;;;;;;;;;;;;;;cAAa,gBAAA,GACX,eAAA,EAAiB,WAAA,cACjB,UAAA,EAAY,WAAA,EACZ,aAAA,EAAe,aAAA,KACd,WAAA;;;;AAYH;;;;;cAAa,mBAAA,GACX,kBAAA,EAAoB,UAAA,cACpB,aAAA,EAAe,UAAA,EACf,aAAA,EAAe,aAAA,KACd,UAAA"}

package/dist/types/deepTransformPlugins/getFilterMissingTranslationsContent.d.ts

@@ -1,7 +1,7 @@
 import { NodeProps, Plugins } from "../interpreter/getContent/plugins.js";
-import * as _$_intlayer_types0 from "@intlayer/types";
 import { ContentNode, Dictionary } from "@intlayer/types/dictionary";
-import { DeclaredLocales as DeclaredLocales$1, LocalesValues } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, LocalesValues } from "@intlayer/types/module_augmentation";
+import * as _$_intlayer_types0 from "@intlayer/types";
 
 //#region src/deepTransformPlugins/getFilterMissingTranslationsContent.d.ts
 /** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
@@ -20,7 +20,7 @@ declare const filterMissingTranslationsOnlyPlugin: (localeToCheck: LocalesValues
  * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }
  *
  */
-declare const getFilterMissingTranslationsContent: <T extends ContentNode, L extends LocalesValues = DeclaredLocales$1>(node: T, localeToCheck: L, nodeProps: NodeProps) => any;
+declare const getFilterMissingTranslationsContent: <T extends ContentNode, L extends LocalesValues = DeclaredLocales>(node: T, localeToCheck: L, nodeProps: NodeProps) => any;
 declare const getFilterMissingTranslationsDictionary: (dictionary: Dictionary, localeToCheck: LocalesValues) => {
   content: any;
   $schema?: "https://intlayer.org/schema.json";
@@ -36,6 +36,9 @@ declare const getFilterMissingTranslationsDictionary: (dictionary: Dictionary, l
   version?: string;
   filePath?: string;
   tags?: string[];
+  item?: number;
+  variant?: string;
+  meta?: _$_intlayer_types0.DictionaryMeta;
   locale?: LocalesValues;
   contentAutoTransformation?: _$_intlayer_types0.ContentAutoTransformation;
   fill?: _$_intlayer_types0.Fill;

package/dist/types/deepTransformPlugins/getFilterMissingTranslationsContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFilterMissingTranslationsContent.d.ts","names":[],"sources":["../../../src/deepTransformPlugins/getFilterMissingTranslationsContent.ts"],"mappings":";;;;;;;cAoMa,mCAAA,GACX,aAAA,EAAe,aAAA,KACd,OAAA;;;AAFH;;;;;;;;;AA+LA;;;cAAa,mCAAA,aACD,WAAA,YACA,aAAA,GAAgB,iBAAA,EAE1B,IAAA,EAAM,CAAA,EACN,aAAA,EAAe,CAAA,EACf,SAAA,EAAW,SAAA;AAAA,cAoBA,sCAAA,GACX,UAAA,EAAY,UAAA,EACZ,aAAA,EAAe,aAAA;;;OAAa,kBAAA,CAAA,YAAA"}
+{"version":3,"file":"getFilterMissingTranslationsContent.d.ts","names":[],"sources":["../../../src/deepTransformPlugins/getFilterMissingTranslationsContent.ts"],"mappings":";;;;;;;cAoMa,mCAAA,GACX,aAAA,EAAe,aAAA,KACd,OAAA;;;AAFH;;;;;;;;;AA+LA;;;cAAa,mCAAA,aACD,WAAA,YACA,aAAA,GAAgB,eAAA,EAE1B,IAAA,EAAM,CAAA,EACN,aAAA,EAAe,CAAA,EACf,SAAA,EAAW,SAAA;AAAA,cAoBA,sCAAA,GACX,UAAA,EAAY,UAAA,EACZ,aAAA,EAAe,aAAA;;;OAAa,kBAAA,CAAA,YAAA"}

package/dist/types/deepTransformPlugins/getFilterTranslationsOnlyContent.d.ts

@@ -1,7 +1,7 @@
 import { DeepTransformContent, NodeProps, Plugins } from "../interpreter/getContent/plugins.js";
-import * as _$_intlayer_types0 from "@intlayer/types";
 import { ContentNode, Dictionary } from "@intlayer/types/dictionary";
-import { DeclaredLocales as DeclaredLocales$1, LocalesValues } from "@intlayer/types/module_augmentation";
+import { DeclaredLocales, LocalesValues } from "@intlayer/types/module_augmentation";
+import * as _$_intlayer_types0 from "@intlayer/types";
 
 //#region src/deepTransformPlugins/getFilterTranslationsOnlyContent.d.ts
 /** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
@@ -12,7 +12,7 @@ declare const filterTranslationsOnlyPlugin: (locale: LocalesValues, fallback?: L
  * @param node The node to transform.
  * @param locale The locale to use if your transformers need it (e.g. for translations).
  */
-declare const getFilterTranslationsOnlyContent: <T extends ContentNode, L extends LocalesValues = DeclaredLocales$1>(node: T, locale: L, nodeProps: NodeProps, fallback?: LocalesValues) => DeepTransformContent<T>;
+declare const getFilterTranslationsOnlyContent: <T extends ContentNode, L extends LocalesValues = DeclaredLocales>(node: T, locale: L, nodeProps: NodeProps, fallback?: LocalesValues) => DeepTransformContent<T>;
 declare const getFilterTranslationsOnlyDictionary: (dictionary: Dictionary, locale?: LocalesValues, fallback?: LocalesValues) => {
   content: any;
   $schema?: "https://intlayer.org/schema.json";
@@ -28,6 +28,9 @@ declare const getFilterTranslationsOnlyDictionary: (dictionary: Dictionary, loca
   version?: string;
   filePath?: string;
   tags?: string[];
+  item?: number;
+  variant?: string;
+  meta?: _$_intlayer_types0.DictionaryMeta;
   locale?: LocalesValues;
   contentAutoTransformation?: _$_intlayer_types0.ContentAutoTransformation;
   fill?: _$_intlayer_types0.Fill;

package/dist/types/deepTransformPlugins/getFilterTranslationsOnlyContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFilterTranslationsOnlyContent.d.ts","names":[],"sources":["../../../src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts"],"mappings":";;;;;;;cAqCa,4BAAA,GACX,MAAA,EAAQ,aAAA,EACR,QAAA,GAAW,aAAA,KACV,OAAA;;;AAHH;;;;cAuFa,gCAAA,aACD,WAAA,YACA,aAAA,GAAgB,iBAAA,EAE1B,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,CAAA,EAER,SAAA,EAAW,SAAA,EACX,QAAA,GAAW,aAAA,KAUL,oBAAA,CAAqB,CAAA;AAAA,cAGhB,mCAAA,GACX,UAAA,EAAY,UAAA,EACZ,MAAA,GAAQ,aAAA,EAER,QAAA,GAAW,aAAA;;;OAAa,kBAAA,CAAA,YAAA"}
+{"version":3,"file":"getFilterTranslationsOnlyContent.d.ts","names":[],"sources":["../../../src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts"],"mappings":";;;;;;;cAqCa,4BAAA,GACX,MAAA,EAAQ,aAAA,EACR,QAAA,GAAW,aAAA,KACV,OAAA;;;AAHH;;;;cAuFa,gCAAA,aACD,WAAA,YACA,aAAA,GAAgB,eAAA,EAE1B,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,CAAA,EAER,SAAA,EAAW,SAAA,EACX,QAAA,GAAW,aAAA,KAUL,oBAAA,CAAqB,CAAA;AAAA,cAGhB,mCAAA,GACX,UAAA,EAAY,UAAA,EACZ,MAAA,GAAQ,aAAA,EAER,QAAA,GAAW,aAAA;;;OAAa,kBAAA,CAAA,YAAA"}

package/dist/types/deepTransformPlugins/getFilteredLocalesContent.d.ts

@@ -1,7 +1,7 @@
 import { NodeProps } from "../interpreter/getContent/plugins.js";
-import * as _$_intlayer_types0 from "@intlayer/types";
 import { ContentNode, Dictionary } from "@intlayer/types/dictionary";
 import { LocalesValues } from "@intlayer/types/module_augmentation";
+import * as _$_intlayer_types0 from "@intlayer/types";
 
 //#region src/deepTransformPlugins/getFilteredLocalesContent.d.ts
 declare const getFilteredLocalesContent: (node: ContentNode, locales: LocalesValues | LocalesValues[], nodeProps: NodeProps) => any;
@@ -20,6 +20,9 @@ declare const getFilteredLocalesDictionary: (dictionary: Dictionary, locale: Loc
   version?: string;
   filePath?: string;
   tags?: string[];
+  item?: number;
+  variant?: string;
+  meta?: _$_intlayer_types0.DictionaryMeta;
   locale?: LocalesValues;
   contentAutoTransformation?: _$_intlayer_types0.ContentAutoTransformation;
   fill?: _$_intlayer_types0.Fill;

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

@@ -1,3 +1,4 @@
+import { getEditedContent, getEditedDictionary } from "./getEditedContent.js";
 import { filterMissingTranslationsOnlyPlugin, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary } from "./getFilterMissingTranslationsContent.js";
 import { filterTranslationsOnlyPlugin, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary } from "./getFilterTranslationsOnlyContent.js";
 import { getFilteredLocalesContent, getFilteredLocalesDictionary } from "./getFilteredLocalesContent.js";
@@ -8,4 +9,4 @@ import { getMultilingualDictionary } from "./getMultilingualDictionary.js";
 import { getReplacedValuesContent } from "./getReplacedValuesContent.js";
 import { getSplittedContent, getSplittedDictionaryContent } from "./getSplittedContent.js";
 import { insertContentInDictionary } from "./insertContentInDictionary.js";
-export { buildMaskPlugin, checkMissingLocalesPlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getLocalizedContent, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getPerLocaleDictionary, getReplacedValuesContent, getSplittedContent, getSplittedDictionaryContent, insertContentInDictionary };
+export { buildMaskPlugin, checkMissingLocalesPlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, getEditedContent, getEditedDictionary, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getLocalizedContent, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getPerLocaleDictionary, getReplacedValuesContent, getSplittedContent, getSplittedDictionaryContent, insertContentInDictionary };

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

@@ -5,9 +5,11 @@ import { getEmptyNode } from "./getEmptyNode.js";
 import { getNodeChildren } from "./getNodeChildren.js";
 import { getNodeType } from "./getNodeType.js";
 import { mergeDictionaries } from "./mergeDictionaries.js";
+import { mergeQualifiedDictionaries } from "./mergeQualifiedDictionaries.js";
 import { normalizeDictionaries, normalizeDictionary } from "./normalizeDictionary.js";
 import { orderDictionaries } from "./orderDictionaries.js";
+import { COMPOSITE_ID_SEPARATOR, DynamicDictionaryLoader, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, QualifiedDynamicLoaderMap, QualifiedDynamicLoaderTree, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, parseDictionarySelector, reconstructQualifiedEntry, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync } from "./qualifiedDictionary.js";
 import { removeContentNodeByKeyPath } from "./removeContentNodeByKeyPath.js";
 import { renameContentNodeByKeyPath } from "./renameContentNodeByKeyPath.js";
 import { updateNodeChildren } from "./updateNodeChildren.js";
-export { editDictionaryByKeyPath, getContentNodeByKeyPath, getDefaultNode, getEmptyNode, getNodeChildren, getNodeType, mergeDictionaries, normalizeDictionaries, normalizeDictionary, orderDictionaries, removeContentNodeByKeyPath, renameContentNodeByKeyPath, updateNodeChildren };
+export { COMPOSITE_ID_SEPARATOR, DynamicDictionaryLoader, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, QualifiedDynamicLoaderMap, QualifiedDynamicLoaderTree, editDictionaryByKeyPath, getContentNodeByKeyPath, getDefaultNode, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, getEmptyNode, getNodeChildren, getNodeType, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, mergeDictionaries, mergeQualifiedDictionaries, normalizeDictionaries, normalizeDictionary, orderDictionaries, parseDictionarySelector, reconstructQualifiedEntry, removeContentNodeByKeyPath, renameContentNodeByKeyPath, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync, updateNodeChildren };

package/dist/types/dictionaryManipulator/mergeQualifiedDictionaries.d.ts

@@ -0,0 +1,22 @@
+import { Dictionary, QualifiedDictionaryGroup } from "@intlayer/types/dictionary";
+
+//#region src/dictionaryManipulator/mergeQualifiedDictionaries.d.ts
+/**
+ * Merges sibling dictionaries sharing the same key, honouring qualifiers.
+ *
+ * - No dictionary declares a qualifier → behaves exactly like
+ *   `mergeDictionaries` (single merged dictionary).
+ * - At least one dictionary declares a qualifier → the group's dimension set is
+ *   the union of every declared dimension (in canonical order
+ *   `variant → meta → item`). Dictionaries are grouped by their composite id
+ *   (one segment per dimension), merged within each group (locale completion /
+ *   priority overrides preserved), and a `QualifiedDictionaryGroup` is returned.
+ *   Unqualified siblings act as shared base content merged into every entry.
+ *
+ * Every qualified entry must declare ALL dimensions of the group; an entry that
+ * declares only a subset is ambiguous and is rejected with an error log.
+ */
+declare const mergeQualifiedDictionaries: (dictionaries: Dictionary[]) => Dictionary | QualifiedDictionaryGroup;
+//#endregion
+export { mergeQualifiedDictionaries };
+//# sourceMappingURL=mergeQualifiedDictionaries.d.ts.map

package/dist/types/dictionaryManipulator/mergeQualifiedDictionaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeQualifiedDictionaries.d.ts","names":[],"sources":["../../../src/dictionaryManipulator/mergeQualifiedDictionaries.ts"],"mappings":";;;;;AA8BA;;;;;;;;;;;;;cAAa,0BAAA,GACX,YAAA,EAAc,UAAA,OACb,UAAA,GAAa,wBAAA"}

package/dist/types/dictionaryManipulator/qualifiedDictionary.d.ts

@@ -0,0 +1,176 @@
+import { Dictionary, DictionaryQualifierType, DictionarySelector, QualifiedDictionaryGroup } from "@intlayer/types/dictionary";
+import { LocalesValues } from "@intlayer/types/module_augmentation";
+
+//#region src/dictionaryManipulator/qualifiedDictionary.d.ts
+/**
+ * Canonical order of qualifier dimensions. A key that declares several
+ * dimensions always nests them in this order, with `item` innermost so it can
+ * act as the collection (array) axis.
+ */
+declare const QUALIFIER_ORDER: readonly ["variant", "meta", "item"];
+/**
+ * Separator joining per-dimension ids into a composite entry id. Also used as
+ * the chunk path separator in dynamic mode.
+ */
+declare const COMPOSITE_ID_SEPARATOR = "/";
+/**
+ * Returns the qualifier dimensions declared on a dictionary, in canonical
+ * order (`variant → meta → item`). Empty when the dictionary is unqualified
+ * (plain dictionary or shared base content of a qualified group).
+ */
+declare const getDictionaryQualifierTypes: (dictionary: Dictionary) => DictionaryQualifierType[];
+/**
+ * Returns the qualifier identifier of a dictionary for the given qualifier
+ * dimension — one segment of the composite entry id.
+ *
+ * - 'variant' → the variant name
+ * - 'meta' → the `meta.id` discriminator
+ * - 'item' → the item index as string
+ */
+declare const getDictionaryQualifierId: (dictionary: Dictionary, qualifierType: DictionaryQualifierType) => string | undefined;
+/**
+ * Returns the per-dimension id segments of a dictionary for the given ordered
+ * dimension set, or `undefined` when the dictionary does not declare every
+ * dimension of the set.
+ */
+declare const getDictionaryQualifierSegments: (dictionary: Dictionary, qualifierTypes: DictionaryQualifierType[]) => string[] | undefined;
+/**
+ * Builds the composite entry id of a dictionary — its per-dimension id segments
+ * joined in canonical order. `undefined` when a dimension is missing.
+ */
+declare const getDictionaryCompositeId: (dictionary: Dictionary, qualifierTypes: DictionaryQualifierType[]) => string | undefined;
+/**
+ * Type guard discriminating a `QualifiedDictionaryGroup` (merge output of a
+ * qualified key) from a plain `Dictionary`. Both carry a `content` field; only
+ * the group declares `qualifierTypes`, which is therefore the discriminator.
+ */
+declare const isQualifiedDictionaryGroup: (value: unknown) => value is QualifiedDictionaryGroup;
+/**
+ * Reconstructs a resolvable {@link Dictionary} from a single entry of a
+ * qualified group: the content node stored under its composite id, plus the
+ * qualifier coordinates decoded from that id (`variant`, `item`) and the
+ * preserved `meta` object for the meta dimension.
+ *
+ * This keeps the resolver's matching/transform code unchanged: it still sees a
+ * `{ key, content, variant?, item?, meta? }` shape, even though the stored
+ * format no longer duplicates those fields per entry.
+ */
+declare const reconstructQualifiedEntry: (group: QualifiedDictionaryGroup, compositeId: string) => Dictionary;
+/**
+ * Resolves a dictionary (or qualified dictionary group) against a selector,
+ * across every declared dimension.
+ *
+ * - Plain dictionary → returned as-is (selector ignored)
+ * - `item` declared but not selected → every matching entry ordered by index
+ * - `item` selected → the matching entry or null
+ * - `variant` defaults to the `default` entry when not selected
+ * - `meta` requires `{ id }` and every declared meta field to match
+ *
+ * Dimensions compose: e.g. a variant × item key with `{ variant: 'promo' }`
+ * returns every promo item as an array; adding `{ item: 2 }` narrows to one.
+ */
+declare const resolveQualifiedDictionary: (dictionaryOrGroup: Dictionary | QualifiedDictionaryGroup, selector?: DictionarySelector) => Dictionary | Dictionary[] | null;
+/**
+ * Splits the second argument of `getIntlayer` / `getDictionary` into the
+ * effective locale and the selector object (if any).
+ */
+declare const parseDictionarySelector: <L extends LocalesValues>(localeOrSelector?: L | DictionarySelector) => {
+  locale?: L;
+  selector?: DictionarySelector;
+};
+/**
+ * Builds a stable string identity of a selector (excluding `locale`), suitable
+ * for cache keys and memoization dependencies.
+ */
+declare const getDictionarySelectorCacheKey: (selector?: DictionarySelector) => string;
+/**
+ * Marker property carrying the ordered qualifier dimensions on a dynamic loader
+ * map. Its presence distinguishes a qualified group loader map (a nested tree
+ * of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed
+ * and unlikely to collide with a real locale code.
+ */
+declare const QUALIFIER_DYNAMIC_TYPES_KEY = "__intlayerQualifierTypes";
+/**
+ * A lazily-imported per-locale dictionary chunk loader.
+ */
+type DynamicDictionaryLoader = () => Promise<Dictionary>;
+/**
+ * Nested tree of chunk loaders: one nesting level per declared dimension (in
+ * canonical order), leaves are loaders.
+ */
+type QualifiedDynamicLoaderTree = {
+  [segment: string]: QualifiedDynamicLoaderTree | DynamicDictionaryLoader;
+};
+/**
+ * Default export shape of a generated dynamic entry point for a qualified key.
+ * One nesting level per dimension under each locale, plus the dimension marker.
+ *
+ * ```ts
+ * {
+ *   __intlayerQualifierTypes: ['variant', 'item'],
+ *   en: { promo: { '1': () => import('./json/x/promo/1/en.json'), … }, … },
+ *   fr: { … },
+ * }
+ * ```
+ */
+type QualifiedDynamicLoaderMap = {
+  [QUALIFIER_DYNAMIC_TYPES_KEY]: DictionaryQualifierType[];
+  [locale: string]: QualifiedDynamicLoaderTree | DictionaryQualifierType[];
+};
+/**
+ * Type guard discriminating a qualified dynamic loader map (collections /
+ * variants / meta records, possibly combined) from a plain dynamic loader map.
+ */
+declare const isQualifiedDynamicLoaderMap: (value: unknown) => value is QualifiedDynamicLoaderMap;
+/**
+ * Resolves the content of a qualified dynamic loader map against a selector,
+ * loading only the chunk(s) the selector actually targets.
+ *
+ * Walks the nested loader tree one dimension at a time (canonical order
+ * `variant → meta → item`): `variant` defaults to `default`, `meta` descends by
+ * `id`, and `item` either narrows to the selected index or — when no item is
+ * given — expands into every sibling chunk (the collection axis). Meta-equality
+ * is verified on the loaded chunk. Semantics mirror
+ * {@link resolveQualifiedDictionary} so dynamic and static modes behave alike.
+ *
+ * The Suspense mechanism is injected through `loadChunk` so the same logic
+ * serves both the client (suspender cache) and the server (`react.use`). Every
+ * targeted loader is started before the first chunk is read, so sibling chunks
+ * load in parallel rather than waterfalling.
+ *
+ * @param loaderMap - The qualified dynamic loader map (entry point default export).
+ * @param key - The dictionary key (used to build stable chunk cache keys).
+ * @param locale - The resolved locale to load chunks for.
+ * @param selector - The selector splitting the qualifier dimensions.
+ * @param loadChunk - Reads a started chunk promise, suspending until it resolves.
+ * @param transform - Turns a resolved chunk dictionary into final content.
+ */
+declare const resolveQualifiedDynamicContent: <Content>(params: {
+  loaderMap: QualifiedDynamicLoaderMap;
+  key: string;
+  locale: string;
+  selector: DictionarySelector | undefined;
+  loadChunk: (cacheKey: string, promise: Promise<Dictionary>) => Dictionary;
+  transform: (dictionary: Dictionary) => Content;
+}) => Content | Content[] | null;
+/**
+ * Async counterpart of {@link resolveQualifiedDynamicContent} for frameworks
+ * that load dictionaries with `await` instead of Suspense (Vue, Svelte, Lit,
+ * vanilla). Awaits every targeted chunk in parallel, then resolves identically.
+ *
+ * @param loaderMap - The qualified dynamic loader map.
+ * @param key - The dictionary key (used to build stable chunk cache keys).
+ * @param locale - The resolved locale to load chunks for.
+ * @param selector - The selector splitting the qualifier dimensions.
+ * @param transform - Turns a resolved chunk dictionary into final content.
+ */
+declare const resolveQualifiedDynamicContentAsync: <Content>(params: {
+  loaderMap: QualifiedDynamicLoaderMap;
+  key: string;
+  locale: string;
+  selector: DictionarySelector | undefined;
+  transform: (dictionary: Dictionary) => Content;
+}) => Promise<Content | Content[] | null>;
+//#endregion
+export { COMPOSITE_ID_SEPARATOR, DynamicDictionaryLoader, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, QualifiedDynamicLoaderMap, QualifiedDynamicLoaderTree, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, parseDictionarySelector, reconstructQualifiedEntry, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync };
+//# sourceMappingURL=qualifiedDictionary.d.ts.map

package/dist/types/dictionaryManipulator/qualifiedDictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifiedDictionary.d.ts","names":[],"sources":["../../../src/dictionaryManipulator/qualifiedDictionary.ts"],"mappings":";;;;;;AAmBA;;;cAAa,eAAA;;AAUb;;;cAAa,sBAAA;;AAOb;;;;cAAa,2BAAA,GACX,UAAA,EAAY,UAAA,KACX,uBAAA;;;;;AAmBH;;;;cAAa,wBAAA,GACX,UAAA,EAAY,UAAA,EACZ,aAAA,EAAe,uBAAA;;;;;;cAeJ,8BAAA,GACX,UAAA,EAAY,UAAA,EACZ,cAAA,EAAgB,uBAAA;;;;;cAiBL,wBAAA,GACX,UAAA,EAAY,UAAA,EACZ,cAAA,EAAgB,uBAAA;;;;;AAFlB;cAgEa,0BAAA,GACX,KAAA,cACC,KAAA,IAAS,wBAAA;;;;;;;;;AAFZ;;cAmBa,yBAAA,GACX,KAAA,EAAO,wBAAA,EACP,WAAA,aACC,UAAA;;;;;;;AAHH;;;;;;;cAwCa,0BAAA,GACX,iBAAA,EAAmB,UAAA,GAAa,wBAAA,EAChC,QAAA,GAAW,kBAAA,KACV,UAAA,GAAa,UAAA;;;AAHhB;;cAqCa,uBAAA,aAAqC,aAAA,EAChD,gBAAA,GAAmB,CAAA,GAAI,kBAAA;EACpB,MAAA,GAAS,CAAA;EAAG,QAAA,GAAW,kBAAA;AAAA;;;;;cAef,6BAAA,GACX,QAAA,GAAW,kBAAA;;;;;;;cAiBA,2BAAA;;AAnCb;;KAwCY,uBAAA,SAAgC,OAAA,CAAQ,UAAA;;;;;KAMxC,0BAAA;EAAA,CACT,OAAA,WAAkB,0BAAA,GAA6B,uBAAA;AAAA;;;;;;;;;;;;AA9BlD;KA6CY,yBAAA;EAAA,CACT,2BAAA,GAA8B,uBAAA;EAAA,CAC9B,MAAA,WAAiB,0BAAA,GAA6B,uBAAA;AAAA;AA7BjD;;;;AAAA,cAoCa,2BAAA,GACX,KAAA,cACC,KAAA,IAAS,yBAAA;AAjCZ;;;;;AAMA;;;;;;;;;AAgBA;;;;;;;;;AAtBA,cAuLa,8BAAA,YAA2C,MAAA;EACtD,SAAA,EAAW,yBAAA;EACX,GAAA;EACA,MAAA;EACA,QAAA,EAAU,kBAAA;EACV,SAAA,GAAY,QAAA,UAAkB,OAAA,EAAS,OAAA,CAAQ,UAAA,MAAgB,UAAA;EAC/D,SAAA,GAAY,UAAA,EAAY,UAAA,KAAe,OAAA;AAAA,MACrC,OAAA,GAAU,OAAA;;;;;;;;;AAPd;;;cAyCa,mCAAA,YAAsD,MAAA;EACjE,SAAA,EAAW,yBAAA;EACX,GAAA;EACA,MAAA;EACA,QAAA,EAAU,kBAAA;EACV,SAAA,GAAY,UAAA,EAAY,UAAA,KAAe,OAAA;AAAA,MACrC,OAAA,CAAQ,OAAA,GAAU,OAAA"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+import { getEditedContent, getEditedDictionary } from "./deepTransformPlugins/getEditedContent.js";
 import { ConditionContent, ConditionContentStates, cond as condition } from "./transpiler/condition/condition.js";
 import { EnterFormat, EnumerationContent, EnumerationContentState, enu as enumeration } from "./transpiler/enumeration/enumeration.js";
 import { FileContent, FileContentConstructor, file, fileContent } from "./transpiler/file/file.js";
@@ -42,8 +43,10 @@ import { getEmptyNode } from "./dictionaryManipulator/getEmptyNode.js";
 import { getNodeChildren } from "./dictionaryManipulator/getNodeChildren.js";
 import { getNodeType } from "./dictionaryManipulator/getNodeType.js";
 import { mergeDictionaries } from "./dictionaryManipulator/mergeDictionaries.js";
+import { mergeQualifiedDictionaries } from "./dictionaryManipulator/mergeQualifiedDictionaries.js";
 import { normalizeDictionaries, normalizeDictionary } from "./dictionaryManipulator/normalizeDictionary.js";
 import { orderDictionaries } from "./dictionaryManipulator/orderDictionaries.js";
+import { COMPOSITE_ID_SEPARATOR, DynamicDictionaryLoader, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, QualifiedDynamicLoaderMap, QualifiedDynamicLoaderTree, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, parseDictionarySelector, reconstructQualifiedEntry, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync } from "./dictionaryManipulator/qualifiedDictionary.js";
 import { removeContentNodeByKeyPath } from "./dictionaryManipulator/removeContentNodeByKeyPath.js";
 import { renameContentNodeByKeyPath } from "./dictionaryManipulator/renameContentNodeByKeyPath.js";
 import { updateNodeChildren } from "./dictionaryManipulator/updateNodeChildren.js";
@@ -81,12 +84,13 @@ import { allowInline, anyScopeRegex, attributeValueToNodePropValue, blockRegex,
 import { JsonValue, icuToIntlayerFormatter, intlayerToICUFormatter } from "./messageFormat/ICU.js";
 import { i18nextToIntlayerFormatter, intlayerToI18nextFormatter } from "./messageFormat/i18next.js";
 import { PortableObject, intlayerToPortableObjectFormatter, portableObjectToIntlayerFormatter } from "./messageFormat/po.js";
+import { MessageFormatDialect, MessageValues, TaggedMessageToken, interpolateMessage, parseTaggedMessage, resolveMessage, resolveMessageNode } from "./messageFormat/resolveMessage.js";
 import { intlayerToVueI18nFormatter, vueI18nToIntlayerFormatter } from "./messageFormat/vue-i18n.js";
 import { checkIsURLAbsolute } from "./utils/checkIsURLAbsolute.js";
 import { getCookie } from "./utils/getCookie.js";
 import { isSameKeyPath } from "./utils/isSameKeyPath.js";
 import { isValidElement } from "./utils/isValidReactElement.js";
 import { CookieBuildAttributes, LocaleStorage, LocaleStorageClient, LocaleStorageClientOptions, LocaleStorageOptions, LocaleStorageServer, LocaleStorageServerOptions, getLocaleFromStorage, getLocaleFromStorageClient, getLocaleFromStorageServer, localeStorageOptions, setLocaleInStorage, setLocaleInStorageClient, setLocaleInStorageServer } from "./utils/localeStorage.js";
-import { parseYaml } from "./utils/parseYaml.js";
+import { YamlRecord, YamlValue, parseYaml } from "./utils/parseYaml.js";
 import { stringifyYaml } from "./utils/stringifyYaml.js";
-export { ATTRIBUTES_TO_SANITIZE, ATTRIBUTE_TO_NODE_PROP_MAP, ATTR_EXTRACTOR_R, BLOCKQUOTE_ALERT_R, BLOCKQUOTE_R, BLOCKQUOTE_TRIM_LEFT_MULTILINE_R, BLOCK_END_R, BREAK_LINE_R, BREAK_THEMATIC_R, BlockQuoteNode, BoldTextNode, BreakLineNode, BreakThematicNode, CAPTURE_LETTER_AFTER_HYPHEN, CODE_BLOCK_FENCED_R, CODE_BLOCK_R, CODE_INLINE_R, CONSECUTIVE_NEWLINE_R, CR_NEWLINE_R, CUSTOM_COMPONENT_R, CachedIntl, CachedIntl as Intl, CodeBlockNode, CodeFencedNode, CodeInlineNode, CompileOptions, ComponentOverrides, ConditionCond, ConditionContent, ConditionContentStates, CookieBuildAttributes, CustomComponentNode, DO_NOT_PROCESS_HTML_ELEMENTS, DURATION_DELAY_TRIGGER, DateTimePreset, DeepTransformContent, DotPath, ElementType, EnterFormat, EnumerationCond, EnumerationContent, EnumerationContentState, EscapedTextNode, FOOTNOTE_R, FOOTNOTE_REFERENCE_R, FORMFEED_R, FRONT_MATTER_R, FileCond, FileContent, FileContentConstructor, FootnoteNode, FootnoteReferenceNode, GFMTaskNode, GFM_TASK_R, Gender, GenderCond, GenderContent, GenderContentStates, GenerateSitemapOptions, GetNestingResult, GetPrefixOptions, GetPrefixResult, HEADING_ATX_COMPLIANT_R, HEADING_R, HEADING_SETEXT_R, HTMLCommentNode, HTMLContent, HTMLContentConstructor, HTMLNode, HTMLSelfClosingNode, HTMLTag, HTMLTagsType, HTMLValidationIssue, HTMLValidationResult, HTML_BLOCK_ELEMENT_R, HTML_CHAR_CODE_R, HTML_COMMENT_R, HTML_CUSTOM_ATTR_R, HTML_LEFT_TRIM_AMOUNT_R, HTML_SELF_CLOSING_ELEMENT_R, HTML_TAGS, HeadingNode, HeadingSetextNode, IInterpreterPlugin, IInterpreterPluginState, INLINE_SKIP_R, INTERPOLATION_R, ImageNode, InsertionCond, InsertionContent, InsertionContentConstructor, IsAny, ItalicTextNode, JsonValue, LINK_AUTOLINK_BARE_URL_R, LINK_AUTOLINK_R, LIST_LOOKBEHIND_R, LOOKAHEAD, LinkAngleBraceNode, LinkBareURLNode, LinkNode, ListType, LocaleStorage, LocaleStorageClient, LocaleStorageClientOptions, LocaleStorageOptions, LocaleStorageServer, LocaleStorageServerOptions, LocalizedPathResult, MarkdownContent, MarkdownContentConstructor, MarkdownContext, MarkdownOptions, MarkdownRuntime, HTMLValidationIssue as MarkdownValidationIssue, MarkdownValidationResult, MarkedTextNode, NAMED_CODES_TO_UNICODE, NP_TABLE_R, NestedCond, NestedContent, NestedContentState, NestedParser, NewlineNode, NodeProps, ORDERED, ORDERED_LIST_BULLET, ORDERED_LIST_ITEM_PREFIX, ORDERED_LIST_ITEM_PREFIX_R, ORDERED_LIST_ITEM_R, ORDERED_LIST_R, OrderedListNode, PARAGRAPH_R, ParagraphNode, ParseState, ParsedMarkdown, Parser, ParserResult, Plugins, PluralCategory, PluralCond, PluralContent, PluralContentState, PortableObject, Priority, PriorityValue, REFERENCE_IMAGE_OR_LINK, REFERENCE_IMAGE_R, REFERENCE_LINK_R, ReferenceImageNode, ReferenceLinkNode, ReferenceNode, RenderRuleHook, Rule, RuleOutput, RuleType, RuleTypeValue, Rules, SHORTCODE_R, SHOULD_RENDER_AS_BLOCK_R, SitemapUrlEntry, StrikethroughTextNode, TABLE_CENTER_ALIGN, TABLE_LEFT_ALIGN, TABLE_RIGHT_ALIGN, TABLE_TRIM_PIPES, TAB_R, TEXT_BOLD_R, TEXT_EMPHASIZED_R, TEXT_ESCAPED_R, TEXT_MARKED_R, TEXT_PLAIN_R, TEXT_STRIKETHROUGHED_R, TRIM_STARTING_NEWLINES, TableNode, TableSeparatorNode, TextNode, TranslationCond, TranslationContent, UNESCAPE_R, UNORDERED, UNORDERED_LIST_BULLET, UNORDERED_LIST_ITEM_PREFIX, UNORDERED_LIST_ITEM_PREFIX_R, UNORDERED_LIST_ITEM_R, UNORDERED_LIST_R, UnionKeys, UnorderedListNode, VOID_HTML_ELEMENTS, ValidDotPathsFor, ValueAtKey, WrappedIntl, allowInline, anyScopeRegex, attributeValueToNodePropValue, bindIntl, blockRegex, buildMaskPlugin, captureNothing, checkIsURLAbsolute, checkMissingLocalesPlugin, compact, compile, compileWithOptions, condition as cond, conditionPlugin, createCompiler, createRenderer, currency, cx, date, deepTransformNode, editDictionaryByKeyPath, enumeration as enu, enumerationPlugin, fallbackPlugin, file, fileContent, filePlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, findMatchingCondition, gender, genderPlugin, generateListItemPrefix, generateListItemPrefixRegex, generateListItemRegex, generateListRegex, generateSitemap, generateSitemapUrl, get, getBasePlugins, getBrowserLocale, getCachedIntl, getCanonicalPath, getCondition, getContent, getContentNodeByKeyPath, getCookie, getDefaultNode, getDictionary, getEmptyNode, getEnumeration, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getHTML, getHTMLTextDir, getInsertionValues, getInternalPath, getIntlayer, getLocale, getLocaleFromPath, getLocaleFromStorage, getLocaleFromStorageClient, getLocaleFromStorageServer, getLocaleLang, getLocaleName, getLocalizedContent, getLocalizedPath, getLocalizedUrl, getMarkdownMetadata, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getMultilingualUrls, getNesting, getNodeChildren, getNodeType, getPathWithoutLocale, getPerLocaleDictionary, getPlural, getPrefix, getReplacedValuesContent, getRewritePath, getRewriteRules, getSplittedContent, getSplittedDictionaryContent, getTranslation, html, i18nextToIntlayerFormatter, icuToIntlayerFormatter, inlineRegex, insertion as insert, insertContentInDictionary, insertionPlugin, intlayerToI18nextFormatter, intlayerToICUFormatter, intlayerToPortableObjectFormatter, intlayerToVueI18nFormatter, isSameKeyPath, isValidElement, list, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, markdown as md, mergeDictionaries, nesting as nest, nestedPlugin, normalizeAttributeKey, normalizeDictionaries, normalizeDictionary, normalizeWhitespace, number, orderDictionaries, parseBlock, parseCaptureInline, parseInline, parseMarkdown, parseSimpleInline, parseStyleAttribute, parseTableAlign, parseTableAlignCapture, parseTableCells, parseTableRow, parseYaml, parserFor, percentage, plural, pluralPlugin, portableObjectToIntlayerFormatter, presets, qualifies, relativeTime, removeContentNodeByKeyPath, renameContentNodeByKeyPath, renderFor, renderMarkdownAst, renderNothing, sanitizer, setLocaleInStorage, setLocaleInStorageClient, setLocaleInStorageServer, simpleInlineRegex, slugify, some, splitInsertionTemplate, startsWith, stringifyYaml, translation as t, translationPlugin, trimEnd, trimLeadingWhitespaceOutsideFences, unescapeString, units, unquote, updateNodeChildren, validateHTML, validateMarkdown, validatePrefix, vueI18nToIntlayerFormatter };
+export { ATTRIBUTES_TO_SANITIZE, ATTRIBUTE_TO_NODE_PROP_MAP, ATTR_EXTRACTOR_R, BLOCKQUOTE_ALERT_R, BLOCKQUOTE_R, BLOCKQUOTE_TRIM_LEFT_MULTILINE_R, BLOCK_END_R, BREAK_LINE_R, BREAK_THEMATIC_R, BlockQuoteNode, BoldTextNode, BreakLineNode, BreakThematicNode, CAPTURE_LETTER_AFTER_HYPHEN, CODE_BLOCK_FENCED_R, CODE_BLOCK_R, CODE_INLINE_R, COMPOSITE_ID_SEPARATOR, CONSECUTIVE_NEWLINE_R, CR_NEWLINE_R, CUSTOM_COMPONENT_R, CachedIntl, CachedIntl as Intl, CodeBlockNode, CodeFencedNode, CodeInlineNode, CompileOptions, ComponentOverrides, ConditionCond, ConditionContent, ConditionContentStates, CookieBuildAttributes, CustomComponentNode, DO_NOT_PROCESS_HTML_ELEMENTS, DURATION_DELAY_TRIGGER, DateTimePreset, DeepTransformContent, DotPath, DynamicDictionaryLoader, ElementType, EnterFormat, EnumerationCond, EnumerationContent, EnumerationContentState, EscapedTextNode, FOOTNOTE_R, FOOTNOTE_REFERENCE_R, FORMFEED_R, FRONT_MATTER_R, FileCond, FileContent, FileContentConstructor, FootnoteNode, FootnoteReferenceNode, GFMTaskNode, GFM_TASK_R, Gender, GenderCond, GenderContent, GenderContentStates, GenerateSitemapOptions, GetNestingResult, GetPrefixOptions, GetPrefixResult, HEADING_ATX_COMPLIANT_R, HEADING_R, HEADING_SETEXT_R, HTMLCommentNode, HTMLContent, HTMLContentConstructor, HTMLNode, HTMLSelfClosingNode, HTMLTag, HTMLTagsType, HTMLValidationIssue, HTMLValidationResult, HTML_BLOCK_ELEMENT_R, HTML_CHAR_CODE_R, HTML_COMMENT_R, HTML_CUSTOM_ATTR_R, HTML_LEFT_TRIM_AMOUNT_R, HTML_SELF_CLOSING_ELEMENT_R, HTML_TAGS, HeadingNode, HeadingSetextNode, IInterpreterPlugin, IInterpreterPluginState, INLINE_SKIP_R, INTERPOLATION_R, ImageNode, InsertionCond, InsertionContent, InsertionContentConstructor, IsAny, ItalicTextNode, JsonValue, LINK_AUTOLINK_BARE_URL_R, LINK_AUTOLINK_R, LIST_LOOKBEHIND_R, LOOKAHEAD, LinkAngleBraceNode, LinkBareURLNode, LinkNode, ListType, LocaleStorage, LocaleStorageClient, LocaleStorageClientOptions, LocaleStorageOptions, LocaleStorageServer, LocaleStorageServerOptions, LocalizedPathResult, MarkdownContent, MarkdownContentConstructor, MarkdownContext, MarkdownOptions, MarkdownRuntime, HTMLValidationIssue as MarkdownValidationIssue, MarkdownValidationResult, MarkedTextNode, MessageFormatDialect, MessageValues, NAMED_CODES_TO_UNICODE, NP_TABLE_R, NestedCond, NestedContent, NestedContentState, NestedParser, NewlineNode, NodeProps, ORDERED, ORDERED_LIST_BULLET, ORDERED_LIST_ITEM_PREFIX, ORDERED_LIST_ITEM_PREFIX_R, ORDERED_LIST_ITEM_R, ORDERED_LIST_R, OrderedListNode, PARAGRAPH_R, ParagraphNode, ParseState, ParsedMarkdown, Parser, ParserResult, Plugins, PluralCategory, PluralCond, PluralContent, PluralContentState, PortableObject, Priority, PriorityValue, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, QualifiedDynamicLoaderMap, QualifiedDynamicLoaderTree, REFERENCE_IMAGE_OR_LINK, REFERENCE_IMAGE_R, REFERENCE_LINK_R, ReferenceImageNode, ReferenceLinkNode, ReferenceNode, RenderRuleHook, Rule, RuleOutput, RuleType, RuleTypeValue, Rules, SHORTCODE_R, SHOULD_RENDER_AS_BLOCK_R, SitemapUrlEntry, StrikethroughTextNode, TABLE_CENTER_ALIGN, TABLE_LEFT_ALIGN, TABLE_RIGHT_ALIGN, TABLE_TRIM_PIPES, TAB_R, TEXT_BOLD_R, TEXT_EMPHASIZED_R, TEXT_ESCAPED_R, TEXT_MARKED_R, TEXT_PLAIN_R, TEXT_STRIKETHROUGHED_R, TRIM_STARTING_NEWLINES, TableNode, TableSeparatorNode, TaggedMessageToken, TextNode, TranslationCond, TranslationContent, UNESCAPE_R, UNORDERED, UNORDERED_LIST_BULLET, UNORDERED_LIST_ITEM_PREFIX, UNORDERED_LIST_ITEM_PREFIX_R, UNORDERED_LIST_ITEM_R, UNORDERED_LIST_R, UnionKeys, UnorderedListNode, VOID_HTML_ELEMENTS, ValidDotPathsFor, ValueAtKey, WrappedIntl, YamlRecord, YamlValue, allowInline, anyScopeRegex, attributeValueToNodePropValue, bindIntl, blockRegex, buildMaskPlugin, captureNothing, checkIsURLAbsolute, checkMissingLocalesPlugin, compact, compile, compileWithOptions, condition as cond, conditionPlugin, createCompiler, createRenderer, currency, cx, date, deepTransformNode, editDictionaryByKeyPath, enumeration as enu, enumerationPlugin, fallbackPlugin, file, fileContent, filePlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, findMatchingCondition, gender, genderPlugin, generateListItemPrefix, generateListItemPrefixRegex, generateListItemRegex, generateListRegex, generateSitemap, generateSitemapUrl, get, getBasePlugins, getBrowserLocale, getCachedIntl, getCanonicalPath, getCondition, getContent, getContentNodeByKeyPath, getCookie, getDefaultNode, getDictionary, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, getEditedContent, getEditedDictionary, getEmptyNode, getEnumeration, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getHTML, getHTMLTextDir, getInsertionValues, getInternalPath, getIntlayer, getLocale, getLocaleFromPath, getLocaleFromStorage, getLocaleFromStorageClient, getLocaleFromStorageServer, getLocaleLang, getLocaleName, getLocalizedContent, getLocalizedPath, getLocalizedUrl, getMarkdownMetadata, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getMultilingualUrls, getNesting, getNodeChildren, getNodeType, getPathWithoutLocale, getPerLocaleDictionary, getPlural, getPrefix, getReplacedValuesContent, getRewritePath, getRewriteRules, getSplittedContent, getSplittedDictionaryContent, getTranslation, html, i18nextToIntlayerFormatter, icuToIntlayerFormatter, inlineRegex, insertion as insert, insertContentInDictionary, insertionPlugin, interpolateMessage, intlayerToI18nextFormatter, intlayerToICUFormatter, intlayerToPortableObjectFormatter, intlayerToVueI18nFormatter, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, isSameKeyPath, isValidElement, list, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, markdown as md, mergeDictionaries, mergeQualifiedDictionaries, nesting as nest, nestedPlugin, normalizeAttributeKey, normalizeDictionaries, normalizeDictionary, normalizeWhitespace, number, orderDictionaries, parseBlock, parseCaptureInline, parseDictionarySelector, parseInline, parseMarkdown, parseSimpleInline, parseStyleAttribute, parseTableAlign, parseTableAlignCapture, parseTableCells, parseTableRow, parseTaggedMessage, parseYaml, parserFor, percentage, plural, pluralPlugin, portableObjectToIntlayerFormatter, presets, qualifies, reconstructQualifiedEntry, relativeTime, removeContentNodeByKeyPath, renameContentNodeByKeyPath, renderFor, renderMarkdownAst, renderNothing, resolveMessage, resolveMessageNode, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync, sanitizer, setLocaleInStorage, setLocaleInStorageClient, setLocaleInStorageServer, simpleInlineRegex, slugify, some, splitInsertionTemplate, startsWith, stringifyYaml, translation as t, translationPlugin, trimEnd, trimLeadingWhitespaceOutsideFences, unescapeString, units, unquote, updateNodeChildren, validateHTML, validateMarkdown, validatePrefix, vueI18nToIntlayerFormatter };

package/dist/types/interpreter/getCollection.d.ts

@@ -0,0 +1,19 @@
+//#region src/interpreter/getCollection.d.ts
+/**
+ * Picks a single item from a resolved collection array, or returns the full
+ * array when no index is requested.
+ *
+ * @param items - The already-resolved collection items.
+ * @param itemIndex - Optional 0-based index of the item to retrieve.
+ * @returns The item at `itemIndex`, or the full array when no index is given.
+ *
+ * @example
+ * ```ts
+ * const all  = getCollection(['a', 'b', 'c']);      // ['a', 'b', 'c']
+ * const one  = getCollection(['a', 'b', 'c'], 1);   // 'b'
+ * ```
+ */
+declare const getCollection: <T>(items: T[], itemIndex?: number) => T | T[];
+//#endregion
+export { getCollection };
+//# sourceMappingURL=getCollection.d.ts.map

package/dist/types/interpreter/getCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCollection.d.ts","names":[],"sources":["../../../src/interpreter/getCollection.ts"],"mappings":";;AAcA;;;;;;;;;;;;;cAAa,aAAA,MAAoB,KAAA,EAAO,CAAA,IAAK,SAAA,cAAqB,CAAA,GAAI,CAAA"}

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

@@ -1,17 +1,23 @@
 import { DeepTransformContent, IInterpreterPluginState, Plugins } from "./getContent/plugins.js";
-import { Dictionary } from "@intlayer/types/dictionary";
-import { DeclaredLocales, LocalesValues } from "@intlayer/types/module_augmentation";
+import { Dictionary, DictionarySelector, QualifiedDictionaryGroup, ResolveQualifiedDictionaryContent } from "@intlayer/types/dictionary";
+import { DeclaredLocales, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 
 //#region src/interpreter/getDictionary.d.ts
 /**
  * Transforms a dictionary in a single pass, applying each plugin as needed.
  *
- * @param dictionary The dictionary to transform.
- * @param locale The locale to use if your transformers need it (e.g. for translations).
- * @param additionalPlugins An array of NodeTransformer that define how to transform recognized nodes.
- *                      If omitted, we’ll use a default set of plugins.
+ * Also accepts a `QualifiedDictionaryGroup` (collections, variants, meta
+ * records) together with a selector as second argument — the group is resolved
+ * to a single entry (or an ordered array of entries for collections without an
+ * `item` selector) before transformation.
+ *
+ * @param dictionary The dictionary (or qualified dictionary group) to transform.
+ * @param localeOrSelector The locale, or a selector object (`{ item }`,
+ *                         `{ variant }`, `{ id, ...meta }`, optionally with `locale`).
+ * @param plugins An array of NodeTransformer that define how to transform recognized nodes.
+ *                If omitted, we’ll use a default set of plugins.
  */
-declare const getDictionary: <const T extends Dictionary, const L extends LocalesValues = DeclaredLocales>(dictionary: T, locale?: L, plugins?: Plugins[]) => DeepTransformContent<T["content"], IInterpreterPluginState, L>;
+declare const getDictionary: <const T extends Dictionary | QualifiedDictionaryGroup, const A extends LocalesValues | DictionarySelector = DeclaredLocales>(dictionary: T, localeOrSelector?: A, plugins?: Plugins[]) => DeepTransformContent<ResolveQualifiedDictionaryContent<T, A>, IInterpreterPluginState, ExtractSelectorLocale<A>>;
 //#endregion
 export { getDictionary };
 //# sourceMappingURL=getDictionary.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../../src/interpreter/getDictionary.ts"],"mappings":";;;;;;;;AAqBA;;;;;cAAa,aAAA,mBACK,UAAA,kBACA,aAAA,GAAgB,eAAA,EAEhC,UAAA,EAAY,CAAA,EACZ,MAAA,GAAS,CAAA,EACT,OAAA,GAAS,OAAA,OACR,oBAAA,CAAqB,CAAA,aAAc,uBAAA,EAAyB,CAAA"}
+{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../../src/interpreter/getDictionary.ts"],"mappings":";;;;;;;;AAqCA;;;;;;;;;;;cAAa,aAAA,mBACK,UAAA,GAAa,wBAAA,kBACb,aAAA,GAAgB,kBAAA,GAAqB,eAAA,EAErD,UAAA,EAAY,CAAA,EACZ,gBAAA,GAAmB,CAAA,EACnB,OAAA,GAAU,OAAA,OACT,oBAAA,CACD,iCAAA,CAAkC,CAAA,EAAG,CAAA,GACrC,uBAAA,EACA,qBAAA,CAAsB,CAAA"}

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

@@ -1,8 +1,19 @@
 import { DeepTransformContent, IInterpreterPluginState, Plugins } from "./getContent/plugins.js";
-import { DeclaredLocales, DictionaryKeys, DictionaryRegistryContent, LocalesValues } from "@intlayer/types/module_augmentation";
+import { DictionarySelector } from "@intlayer/types/dictionary";
+import { DeclaredLocales, DictionaryKeys, DictionaryRegistryResult, ExtractSelectorLocale, LocalesValues } from "@intlayer/types/module_augmentation";
 
 //#region src/interpreter/getIntlayer.d.ts
-declare const getIntlayer: <const T extends DictionaryKeys, const L extends LocalesValues = DeclaredLocales>(key: T, locale?: L, plugins?: Plugins[]) => DeepTransformContent<DictionaryRegistryContent<T>, IInterpreterPluginState, L>;
+/**
+ * Picks one dictionary by its key and returns its content for the given
+ * locale or selector.
+ *
+ * The second argument is either a locale (`'fr'`) or a selector object:
+ * - `{ item: 2 }` — collection item (omit `item` to get every item as array)
+ * - `{ variant: 'black-friday' }` — named variant (omit for the `default` one)
+ * - `{ id: 'prod_abc', ...metaFields }` — meta record
+ * - `locale` can be combined with any selector: `{ item: 2, locale: 'fr' }`
+ */
+declare const getIntlayer: <const T extends DictionaryKeys, const A extends LocalesValues | DictionarySelector = DeclaredLocales>(key: T, localeOrSelector?: A, plugins?: Plugins[]) => DeepTransformContent<DictionaryRegistryResult<T, A>, IInterpreterPluginState, ExtractSelectorLocale<A>>;
 //#endregion
 export { getIntlayer };
 //# sourceMappingURL=getIntlayer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.d.ts","names":[],"sources":["../../../src/interpreter/getIntlayer.ts"],"mappings":";;;;cAmDa,WAAA,mBACK,cAAA,kBACA,aAAA,GAAgB,eAAA,EAEhC,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,CAAA,EACT,OAAA,GAAU,OAAA,OACT,oBAAA,CACD,yBAAA,CAA0B,CAAA,GAC1B,uBAAA,EACA,CAAA"}
+{"version":3,"file":"getIntlayer.d.ts","names":[],"sources":["../../../src/interpreter/getIntlayer.ts"],"mappings":";;;;;;;;AAkEA;;;;;;;cAAa,WAAA,mBACK,cAAA,kBACA,aAAA,GAAgB,kBAAA,GAAqB,eAAA,EAErD,GAAA,EAAK,CAAA,EACL,gBAAA,GAAmB,CAAA,EACnB,OAAA,GAAU,OAAA,OACT,oBAAA,CACD,wBAAA,CAAyB,CAAA,EAAG,CAAA,GAC5B,uBAAA,EACA,qBAAA,CAAsB,CAAA"}

package/dist/types/interpreter/getPlural.d.ts

@@ -1,6 +1,6 @@
 import { PluralContentState } from "../transpiler/plural/plural.js";
+import { LocalesValues } from "../intlayer/dist/types/index.js";
 import { DeclaredLocales } from "@intlayer/types";
-import { LocalesValues } from "intlayer";
 
 //#region src/interpreter/getPlural.d.ts
 /**