@intlayer/core 8.4.4 → 8.4.6

package/dist/esm/interpreter/getContent/deepTransform.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deepTransform.mjs","names":[],"sources":["../../../../src/interpreter/getContent/deepTransform.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';\nimport { NodeType } from '@intlayer/types/nodeType';\nimport type { NodeProps } from './plugins';\n\n/**\n * Recursively traverses a node (object/array/primitive).\n * Applies the *first* plugin that can transform a node, then stops descending further.\n * If no plugin transforms it, it recurses into its children.\n */\nexport const deepTransformNode = (node: any, props: NodeProps): any => {\n  // Otherwise, if it's an object, check if any plugin can handle it:\n  for (const plugin of props.plugins ?? []) {\n    if (plugin.canHandle(node)) {\n      // Return the transformed node => do NOT recurse further\n      return plugin.transform(node, props, (node: any, props: any) =>\n        deepTransformNode(node, props)\n      );\n    }\n  }\n\n  // If it's null/undefined or not an object, just return it directly:\n  if (node === null || typeof node !== 'object') {\n    return node;\n  }\n\n  // If it's a framework-specific virtual node or already a transformed Proxy,\n  // return it directly to avoid re-transforming its internal properties.\n  if (\n    (node as any).$$typeof !== undefined ||\n    (node as any).__v_isVNode !== undefined ||\n    (node as any)._isVNode !== undefined ||\n    (node as any).isJSX !== undefined ||\n    typeof node === 'function' // Proxies for html/markdown are functions\n  ) {\n    return node;\n  }\n\n  // If it's an array, transform each element:\n  if (Array.isArray(node)) {\n    return node.map((child, index) => {\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeType.Array, key: index } as KeyPath,\n        ],\n      };\n      return deepTransformNode(child, childProps);\n    });\n  }\n\n  // If no plugin transforms it, we keep traversing its properties.\n  const result: Record<string, any> = {};\n  for (const key in node) {\n    const childProps = {\n      ...props,\n      children: node[key],\n      keyPath: [...props.keyPath, { type: NodeType.Object, key } as KeyPath],\n    };\n    result[key] = deepTransformNode(node[key], childProps);\n  }\n\n  return result;\n};\n"],"mappings":"oDASA,MAAa,GAAqB,EAAW,IAA0B,CAErE,IAAK,IAAM,KAAU,EAAM,SAAW,EAAE,CACtC,GAAI,EAAO,UAAU,EAAK,CAExB,OAAO,EAAO,UAAU,EAAM,GAAQ,EAAW,IAC/C,EAAkB,EAAM,EAAM,CAC/B,CAWL,GANqB,OAAO,GAAS,WAAjC,GAOD,EAAa,WAAa,IAAA,IAC1B,EAAa,cAAgB,IAAA,IAC7B,EAAa,WAAa,IAAA,IAC1B,EAAa,QAAU,IAAA,IACxB,OAAO,GAAS,WAEhB,OAAO,EAIT,GAAI,MAAM,QAAQ,EAAK,CACrB,OAAO,EAAK,KAAK,EAAO,IASf,EAAkB,EARN,CACjB,GAAG,EACH,SAAU,EACV,QAAS,CACP,GAAG,EAAM,QACT,CAAE,KAAM,EAAS,MAAO,IAAK,EAAO,CACrC,CACF,CAC0C,CAC3C,CAIJ,IAAM,EAA8B,EAAE,CACtC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAa,CACjB,GAAG,EACH,SAAU,EAAK,GACf,QAAS,CAAC,GAAG,EAAM,QAAS,CAAE,KAAM,EAAS,OAAQ,MAAK,CAAY,CACvE,CACD,EAAO,GAAO,EAAkB,EAAK,GAAM,EAAW,CAGxD,OAAO"}
+{"version":3,"file":"deepTransform.mjs","names":[],"sources":["../../../../src/interpreter/getContent/deepTransform.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type { NodeProps } from './plugins';\n\n/**\n * Recursively traverses a node (object/array/primitive).\n * Applies the *first* plugin that can transform a node, then stops descending further.\n * If no plugin transforms it, it recurses into its children.\n */\nexport const deepTransformNode = (node: any, props: NodeProps): any => {\n  // Otherwise, if it's an object, check if any plugin can handle it:\n  for (const plugin of props.plugins ?? []) {\n    if (plugin.canHandle(node)) {\n      // Return the transformed node => do NOT recurse further\n      return plugin.transform(node, props, (node: any, props: any) =>\n        deepTransformNode(node, props)\n      );\n    }\n  }\n\n  // If it's null/undefined or not an object, just return it directly:\n  if (node === null || typeof node !== 'object') {\n    return node;\n  }\n\n  // If it's a framework-specific virtual node or already a transformed Proxy,\n  // return it directly to avoid re-transforming its internal properties.\n  if (\n    (node as any).$$typeof !== undefined ||\n    (node as any).__v_isVNode !== undefined ||\n    (node as any)._isVNode !== undefined ||\n    (node as any).isJSX !== undefined ||\n    typeof node === 'function' // Proxies for html/markdown are functions\n  ) {\n    return node;\n  }\n\n  // If it's an array, transform each element:\n  if (Array.isArray(node)) {\n    return node.map((child, index) => {\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeTypes.ARRAY, key: index } as KeyPath,\n        ],\n      };\n      return deepTransformNode(child, childProps);\n    });\n  }\n\n  // If no plugin transforms it, we keep traversing its properties.\n  const result: Record<string, any> = {};\n  for (const key in node) {\n    const childProps = {\n      ...props,\n      children: node[key],\n      keyPath: [...props.keyPath, { type: NodeTypes.OBJECT, key } as KeyPath],\n    };\n    result[key] = deepTransformNode(node[key], childProps);\n  }\n\n  return result;\n};\n"],"mappings":";;;;;;;;AASA,MAAa,qBAAqB,MAAW,UAA0B;AAErE,MAAK,MAAM,UAAU,MAAM,WAAW,EAAE,CACtC,KAAI,OAAO,UAAU,KAAK,CAExB,QAAO,OAAO,UAAU,MAAM,QAAQ,MAAW,UAC/C,kBAAkB,MAAM,MAAM,CAC/B;AAKL,KAAI,SAAS,QAAQ,OAAO,SAAS,SACnC,QAAO;AAKT,KACG,KAAa,aAAa,UAC1B,KAAa,gBAAgB,UAC7B,KAAa,aAAa,UAC1B,KAAa,UAAU,UACxB,OAAO,SAAS,WAEhB,QAAO;AAIT,KAAI,MAAM,QAAQ,KAAK,CACrB,QAAO,KAAK,KAAK,OAAO,UAAU;AAShC,SAAO,kBAAkB,OARN;GACjB,GAAG;GACH,UAAU;GACV,SAAS,CACP,GAAG,MAAM,SACT;IAAE,MAAM,UAAU;IAAO,KAAK;IAAO,CACtC;GACF,CAC0C;GAC3C;CAIJ,MAAM,SAA8B,EAAE;AACtC,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,aAAa;GACjB,GAAG;GACH,UAAU,KAAK;GACf,SAAS,CAAC,GAAG,MAAM,SAAS;IAAE,MAAM,UAAU;IAAQ;IAAK,CAAY;GACxE;AACD,SAAO,OAAO,kBAAkB,KAAK,MAAM,WAAW;;AAGxD,QAAO"}

package/dist/esm/interpreter/getContent/getContent.mjs

@@ -1 +1,28 @@
-import{n as e,t}from"../../getContent-DKqtIZGL.mjs";export{t as getBasePlugins,e as getContent};
+import { deepTransformNode } from "./deepTransform.mjs";
+import { conditionPlugin, enumerationPlugin, filePlugin, genderPlugin, insertionPlugin, nestedPlugin, translationPlugin } from "./plugins.mjs";
+import configuration from "@intlayer/config/built";
+
+//#region src/interpreter/getContent/getContent.ts
+const getBasePlugins = (locale, fallback = true) => [
+	translationPlugin(locale ?? configuration.internationalization.defaultLocale, fallback ? configuration.internationalization.defaultLocale : void 0),
+	enumerationPlugin,
+	conditionPlugin,
+	insertionPlugin,
+	nestedPlugin(locale ?? configuration.internationalization.defaultLocale),
+	filePlugin,
+	genderPlugin
+];
+/**
+* Transforms a node in a single pass, applying each plugin as needed.
+*
+* @param node The node to transform.
+* @param locale The locale to use if your transformers need it (e.g. for translations).
+*/
+const getContent = (node, nodeProps, plugins = []) => deepTransformNode(node, {
+	...nodeProps,
+	plugins
+});
+
+//#endregion
+export { getBasePlugins, getContent };
+//# sourceMappingURL=getContent.mjs.map

package/dist/esm/interpreter/getContent/getContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getContent.mjs","names":[],"sources":["../../../../src/interpreter/getContent/getContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { ContentNode } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { deepTransformNode } from './deepTransform';\nimport {\n  conditionPlugin,\n  type DeepTransformContent,\n  enumerationPlugin,\n  filePlugin,\n  genderPlugin,\n  type IInterpreterPluginState,\n  insertionPlugin,\n  type NodeProps,\n  nestedPlugin,\n  type Plugins,\n  translationPlugin,\n} from './plugins';\n\nexport const getBasePlugins = (\n  locale?: LocalesValues,\n  fallback: boolean = true\n): Plugins[] => [\n  translationPlugin(\n    locale ?? configuration.internationalization.defaultLocale,\n    fallback ? configuration.internationalization.defaultLocale : undefined\n  ),\n  enumerationPlugin,\n  conditionPlugin,\n  insertionPlugin,\n  nestedPlugin(locale ?? configuration.internationalization.defaultLocale),\n  filePlugin,\n  genderPlugin,\n];\n\n/**\n * Transforms a node in a single pass, applying each plugin as needed.\n *\n * @param node The node to transform.\n * @param locale The locale to use if your transformers need it (e.g. for translations).\n */\nexport const getContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  nodeProps: NodeProps,\n  plugins: Plugins[] = []\n) =>\n  deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T, IInterpreterPluginState, L>;\n"],"mappings":";;;;;AAqBA,MAAa,kBACX,QACA,WAAoB,SACN;CACd,kBACE,UAAU,cAAc,qBAAqB,eAC7C,WAAW,cAAc,qBAAqB,gBAAgB,OAC/D;CACD;CACA;CACA;CACA,aAAa,UAAU,cAAc,qBAAqB,cAAc;CACxE;CACA;CACD;;;;;;;AAQD,MAAa,cAIX,MACA,WACA,UAAqB,EAAE,KAEvB,kBAAkB,MAAM;CACtB,GAAG;CACH;CACD,CAAC"}

package/dist/esm/interpreter/getContent/index.mjs

@@ -1 +1,5 @@
-import{deepTransformNode as e}from"./deepTransform.mjs";import{a as t,c as n,i as r,l as i,n as a,o,r as s,s as c,t as l}from"../../getContent-DKqtIZGL.mjs";export{s as conditionPlugin,e as deepTransformNode,r as enumerationPlugin,t as filePlugin,o as genderPlugin,l as getBasePlugins,a as getContent,c as insertionPlugin,n as nestedPlugin,i as translationPlugin};
+import { deepTransformNode } from "./deepTransform.mjs";
+import { conditionPlugin, enumerationPlugin, filePlugin, genderPlugin, insertionPlugin, nestedPlugin, translationPlugin } from "./plugins.mjs";
+import { getBasePlugins, getContent } from "./getContent.mjs";
+
+export { conditionPlugin, deepTransformNode, enumerationPlugin, filePlugin, genderPlugin, getBasePlugins, getContent, insertionPlugin, nestedPlugin, translationPlugin };

package/dist/esm/interpreter/getContent/plugins.mjs

@@ -1 +1,154 @@
-import{a as e,c as t,i as n,l as r,o as i,r as a,s as o}from"../../getContent-DKqtIZGL.mjs";export{a as conditionPlugin,n as enumerationPlugin,e as filePlugin,i as genderPlugin,o as insertionPlugin,t as nestedPlugin,r as translationPlugin};
+import { getCondition } from "../getCondition.mjs";
+import { getEnumeration } from "../getEnumeration.mjs";
+import { getGender } from "../getGender.mjs";
+import { getInsertion } from "../getInsertion.mjs";
+import { getNesting } from "../getNesting.mjs";
+import { getTranslation } from "../getTranslation.mjs";
+import * as NodeTypes from "@intlayer/types/nodeType";
+
+//#region src/interpreter/getContent/plugins.ts
+/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
+const translationPlugin = (locale, fallback) => ({
+	id: "translation-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.TRANSLATION,
+	transform: (node, props, deepTransformNode) => {
+		const result = { ...node[NodeTypes.TRANSLATION] ?? {} };
+		for (const key in result) {
+			const childProps = {
+				...props,
+				children: result[key],
+				keyPath: [...props.keyPath, {
+					type: NodeTypes.TRANSLATION,
+					key
+				}]
+			};
+			result[key] = deepTransformNode(result[key], childProps);
+		}
+		return getTranslation(result, locale, fallback);
+	}
+});
+/** Enumeration plugin. Replaces node with a function that takes quantity => string. */
+const enumerationPlugin = {
+	id: "enumeration-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.ENUMERATION,
+	transform: (node, props, deepTransformNode) => {
+		const result = { ...node[NodeTypes.ENUMERATION] };
+		for (const key in result) {
+			const child = result[key];
+			result[key] = deepTransformNode(child, {
+				...props,
+				children: child,
+				keyPath: [...props.keyPath, {
+					type: NodeTypes.ENUMERATION,
+					key
+				}]
+			});
+		}
+		return (arg) => {
+			const subResult = getEnumeration(result, typeof arg === "number" ? arg : arg.count);
+			if (typeof subResult === "function" && typeof arg === "object") return subResult(arg);
+			return subResult;
+		};
+	}
+};
+/** Condition plugin. Replaces node with a function that takes boolean => string. */
+const conditionPlugin = {
+	id: "condition-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.CONDITION,
+	transform: (node, props, deepTransformNode) => {
+		const result = { ...node[NodeTypes.CONDITION] };
+		for (const key in result) {
+			const child = result[key];
+			result[key] = deepTransformNode(child, {
+				...props,
+				children: child,
+				keyPath: [...props.keyPath, {
+					type: NodeTypes.CONDITION,
+					key
+				}]
+			});
+		}
+		return (arg) => {
+			const subResult = getCondition(result, typeof arg === "boolean" ? arg : arg.value);
+			if (typeof subResult === "function" && typeof arg === "object") return subResult(arg);
+			return subResult;
+		};
+	}
+};
+/** Insertion plugin. Replaces node with a function that takes quantity => string. */
+const insertionPlugin = {
+	id: "insertion-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.INSERTION,
+	transform: (node, props, deepTransformNode) => {
+		const newKeyPath = [...props.keyPath, { type: NodeTypes.INSERTION }];
+		const children = node[NodeTypes.INSERTION];
+		/** Insertion string plugin. Replaces string node with a component that render the insertion. */
+		const insertionStringPlugin = {
+			id: "insertion-string-plugin",
+			canHandle: (node) => typeof node === "string",
+			transform: (node, subProps, deepTransformNode) => {
+				const transformedResult = deepTransformNode(node, {
+					...subProps,
+					children: node,
+					plugins: [...(props.plugins ?? []).filter((plugin) => plugin.id !== "intlayer-node-plugin")]
+				});
+				return (values) => {
+					const children = getInsertion(transformedResult, values);
+					return deepTransformNode(children, {
+						...subProps,
+						plugins: props.plugins,
+						children
+					});
+				};
+			}
+		};
+		return deepTransformNode(children, {
+			...props,
+			children,
+			keyPath: newKeyPath,
+			plugins: [insertionStringPlugin, ...props.plugins ?? []]
+		});
+	}
+};
+/** Gender plugin. Replaces node with a function that takes gender => string. */
+const genderPlugin = {
+	id: "gender-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.GENDER,
+	transform: (node, props, deepTransformNode) => {
+		const result = { ...node[NodeTypes.GENDER] };
+		for (const key in result) {
+			const child = result[key];
+			result[key] = deepTransformNode(child, {
+				...props,
+				children: child,
+				keyPath: [...props.keyPath, {
+					type: NodeTypes.GENDER,
+					key
+				}]
+			});
+		}
+		return (value) => getGender(result, value);
+	}
+};
+/** Nested plugin. Replaces node with the result of `getNesting`. */
+const nestedPlugin = (locale) => ({
+	id: "nested-plugin",
+	canHandle: (node) => typeof node === "object" && (node?.nodeType === NodeTypes.NESTED || node?.nodeType === "n"),
+	transform: (node, props) => getNesting(node[NodeTypes.NESTED].dictionaryKey, node[NodeTypes.NESTED].path, {
+		...props,
+		locale: locale ?? props.locale
+	})
+});
+/** File plugin. Replaces node with the result of `getNesting`. */
+const filePlugin = {
+	id: "file-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.FILE,
+	transform: (node, props, deepTransform) => deepTransform(node.content, {
+		...props,
+		children: node.content
+	})
+};
+
+//#endregion
+export { conditionPlugin, enumerationPlugin, filePlugin, genderPlugin, insertionPlugin, nestedPlugin, translationPlugin };
+//# sourceMappingURL=plugins.mjs.map

package/dist/esm/interpreter/getContent/plugins.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.mjs","names":[],"sources":["../../../../src/interpreter/getContent/plugins.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type {\n  ConditionContent,\n  EnumerationContent,\n  FileContent,\n  Gender,\n  GenderContent,\n  InsertionContent,\n  NestedContent,\n  TranslationContent,\n} from '../../transpiler';\nimport { getCondition } from '../getCondition';\nimport { getEnumeration } from '../getEnumeration';\nimport { getGender } from '../getGender';\nimport { getInsertion } from '../getInsertion';\nimport { type GetNestingResult, getNesting } from '../getNesting';\nimport { getTranslation } from '../getTranslation';\n\n/** ---------------------------------------------\n * PLUGIN DEFINITION\n * --------------------------------------------- */\n\n/**\n * A plugin/transformer that can optionally transform a node during a single DFS pass.\n * - `canHandle` decides if the node is transformable by this plugin.\n * - `transform` returns the transformed node (and does not recurse further).\n *\n * > `transformFn` is a function that can be used to deeply transform inside the plugin.\n */\nexport type Plugins = {\n  id: string;\n  canHandle: (node: any) => boolean;\n  transform: (\n    node: any,\n    props: NodeProps,\n    transformFn: (node: any, props: NodeProps) => any\n  ) => any;\n};\n\n/** ---------------------------------------------\n * TRANSLATION PLUGIN\n * --------------------------------------------- */\n\nexport type UnionKeys<T> = T extends unknown ? keyof T : never;\nexport type ValueAtKey<T, K> = T extends unknown\n  ? K extends keyof T\n    ? T[K]\n    : never\n  : never;\n\nexport type TranslationCond<T, S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.TRANSLATION]: infer U;\n}\n  ? U extends Record<PropertyKey, unknown>\n    ? U[keyof U] extends Record<PropertyKey, unknown>\n      ? {\n          [K in UnionKeys<U[keyof U]>]: L extends keyof U\n            ? K extends keyof U[L]\n              ? U[L][K]\n              : ValueAtKey<U[keyof U], K>\n            : ValueAtKey<U[keyof U], K>;\n        } extends infer Content\n        ? DeepTransformContent<Content, S>\n        : never\n      : (L extends keyof U ? U[L] : U[keyof U]) extends infer Content\n        ? DeepTransformContent<Content, S>\n        : never\n    : never\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const translationPlugin = (\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Plugins => ({\n  id: 'translation-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION,\n  transform: (node: TranslationContent, props, deepTransformNode) => {\n    const result = {\n      ...(node[NodeTypes.TRANSLATION] ?? {}),\n    };\n\n    for (const key in result) {\n      const childProps = {\n        ...props,\n        children: result[key as keyof typeof result],\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeTypes.TRANSLATION, key } as KeyPath,\n        ],\n      };\n      result[key as keyof typeof result] = deepTransformNode(\n        result[key as keyof typeof result],\n        childProps\n      );\n    }\n\n    return getTranslation(result, locale, fallback);\n  },\n});\n\n/** ---------------------------------------------\n * ENUMERATION PLUGIN\n * --------------------------------------------- */\n\nexport type EnumerationCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.ENUMERATION]: object;\n}\n  ? (\n      quantity: number\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.ENUMERATION][keyof T[typeof NodeTypes.ENUMERATION]],\n      S\n    >\n  : never;\n\n/** Enumeration plugin. Replaces node with a function that takes quantity => string. */\nexport const enumerationPlugin: Plugins = {\n  id: 'enumeration-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.ENUMERATION,\n  transform: (node: EnumerationContent, props, deepTransformNode) => {\n    const result = { ...node[NodeTypes.ENUMERATION] };\n\n    for (const key in result) {\n      const child = result[key as unknown as keyof typeof result];\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeTypes.ENUMERATION, key } as KeyPath,\n        ],\n      };\n      result[key as unknown as keyof typeof result] = deepTransformNode(\n        child,\n        childProps\n      );\n    }\n\n    return (arg: number | { count: number }) => {\n      const quantity = typeof arg === 'number' ? arg : arg.count;\n      const subResult = getEnumeration(result, quantity);\n\n      if (typeof subResult === 'function' && typeof arg === 'object') {\n        return subResult(arg);\n      }\n\n      return subResult;\n    };\n  },\n};\n\n/** ---------------------------------------------\n * CONDITION PLUGIN\n * --------------------------------------------- */\n\nexport type ConditionCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.CONDITION]: object;\n}\n  ? (\n      value: boolean | { value: boolean }\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.CONDITION][keyof T[typeof NodeTypes.CONDITION]],\n      S\n    >\n  : never;\n\n/** Condition plugin. Replaces node with a function that takes boolean => string. */\nexport const conditionPlugin: Plugins = {\n  id: 'condition-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.CONDITION,\n  transform: (node: ConditionContent, props, deepTransformNode) => {\n    const result = { ...node[NodeTypes.CONDITION] };\n\n    for (const key in result) {\n      const child = result[key as keyof typeof result];\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeTypes.CONDITION, key } as KeyPath,\n        ],\n      };\n      result[key as unknown as keyof typeof result] = deepTransformNode(\n        child,\n        childProps\n      );\n    }\n\n    return (arg: boolean | { value: boolean }) => {\n      const value = typeof arg === 'boolean' ? arg : arg.value;\n      const subResult = getCondition(result, value);\n\n      if (typeof subResult === 'function' && typeof arg === 'object') {\n        return subResult(arg);\n      }\n\n      return subResult;\n    };\n  },\n};\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\nexport type InsertionCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: string;\n  fields: readonly string[];\n}\n  ? (\n      values: {\n        [K in T['fields'][number]]: string | number;\n      }\n    ) => DeepTransformContent<string, S>\n  : never;\n\n/** Insertion plugin. Replaces node with a function that takes quantity => string. */\nexport const insertionPlugin: Plugins = {\n  id: 'insertion-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n  transform: (node: InsertionContent, props, deepTransformNode) => {\n    const newKeyPath: KeyPath[] = [\n      ...props.keyPath,\n      {\n        type: NodeTypes.INSERTION,\n      },\n    ];\n\n    const children = node[NodeTypes.INSERTION];\n\n    /** Insertion string plugin. Replaces string node with a component that render the insertion. */\n    const insertionStringPlugin: Plugins = {\n      id: 'insertion-string-plugin',\n      canHandle: (node) => typeof node === 'string',\n      transform: (node: string, subProps, deepTransformNode) => {\n        const transformedResult = deepTransformNode(node, {\n          ...subProps,\n          children: node,\n          plugins: [\n            ...(props.plugins ?? ([] as Plugins[])).filter(\n              (plugin) => plugin.id !== 'intlayer-node-plugin'\n            ),\n          ],\n        });\n\n        return (\n          values: {\n            [K in InsertionContent['fields'][number]]: string | number;\n          }\n        ) => {\n          const children = getInsertion(transformedResult, values);\n\n          return deepTransformNode(children, {\n            ...subProps,\n            plugins: props.plugins,\n            children,\n          });\n        };\n      },\n    };\n\n    return deepTransformNode(children, {\n      ...props,\n      children,\n      keyPath: newKeyPath,\n      plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n    });\n  },\n};\n\n/** ---------------------------------------------\n * GENDER PLUGIN\n * --------------------------------------------- */\n\nexport type GenderCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.GENDER]: object;\n}\n  ? (\n      value: Gender\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.GENDER][keyof T[typeof NodeTypes.GENDER]],\n      S\n    >\n  : never;\n\n/** Gender plugin. Replaces node with a function that takes gender => string. */\nexport const genderPlugin: Plugins = {\n  id: 'gender-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.GENDER,\n  transform: (node: GenderContent, props, deepTransformNode) => {\n    const result = { ...node[NodeTypes.GENDER] };\n\n    for (const key in result) {\n      const child = result[key as keyof typeof result];\n      const childProps = {\n        ...props,\n        children: child,\n        keyPath: [...props.keyPath, { type: NodeTypes.GENDER, key } as KeyPath],\n      };\n      result[key as keyof typeof result] = deepTransformNode(child, childProps);\n    }\n\n    return (value: Gender) => getGender(result, value);\n  },\n};\n\n/** ---------------------------------------------\n * NESTED PLUGIN\n * --------------------------------------------- */\n\nexport type NestedCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.NESTED]: infer U;\n}\n  ? U extends {\n      dictionaryKey: infer K extends DictionaryKeys;\n      path?: infer P;\n    }\n    ? GetNestingResult<K, P, S>\n    : never\n  : never;\n\n/** Nested plugin. Replaces node with the result of `getNesting`. */\nexport const nestedPlugin = (locale?: LocalesValues): Plugins => ({\n  id: 'nested-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' &&\n    (node?.nodeType === NodeTypes.NESTED || node?.nodeType === 'n'),\n  transform: (node: NestedContent, props) =>\n    getNesting(\n      node[NodeTypes.NESTED].dictionaryKey,\n      node[NodeTypes.NESTED].path,\n      {\n        ...props,\n        locale: (locale ?? props.locale) as Locale,\n      }\n    ),\n});\n\n/** ---------------------------------------------\n * FILE PLUGIN\n * --------------------------------------------- */\n\nexport type FileCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.FILE]: string;\n  content?: string;\n}\n  ? string\n  : never;\n\n/** File plugin. Replaces node with the result of `getNesting`. */\nexport const filePlugin: Plugins = {\n  id: 'file-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeTypes.FILE,\n  transform: (node: FileContent, props, deepTransform) =>\n    deepTransform(node.content, {\n      ...props,\n      children: node.content,\n    }),\n};\n\n/**\n * PLUGIN RESULT\n */\n\n/**\n * Interface that defines the properties of a node.\n * This interface can be augmented in other packages, such as `react-intlayer`.\n */\nexport interface NodeProps {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  plugins?: Plugins[];\n  locale?: Locale;\n  dictionaryPath?: string;\n  children?: any;\n}\n\n/**\n * Interface that defines the plugins that can be used to transform a node.\n * This interface can be augmented in other packages, such as `react-intlayer`.\n */\nexport interface IInterpreterPlugin<T, S, L extends LocalesValues> {\n  translation: TranslationCond<T, S, L>;\n  enumeration: EnumerationCond<T, S, L>;\n  condition: ConditionCond<T, S, L>;\n  insertion: InsertionCond<T, S, L>;\n  gender: GenderCond<T, S, L>;\n  nested: NestedCond<T, S, L>;\n  file: FileCond<T>;\n}\n\n/**\n * Allow to avoid overwriting import from `intlayer` package when `IInterpreterPlugin<T>` interface is augmented in another package, such as `react-intlayer`.\n */\nexport type IInterpreterPluginState = {\n  translation: true;\n  enumeration: true;\n  condition: true;\n  insertion: true;\n  gender: true;\n  nested: true;\n  file: true;\n};\n\n/**\n * Utility type to check if a plugin can be applied to a node.\n */\ntype CheckApplyPlugin<\n  T,\n  K extends keyof IInterpreterPlugin<T, S, L>,\n  S,\n  L extends LocalesValues = DeclaredLocales,\n> = K extends keyof S // Test if the key is a key of S.\n  ? // Test if the key of S is true. Then the plugin can be applied.\n    S[K] extends true\n    ? // Test if the key of S exist\n      IInterpreterPlugin<T, S, L>[K] extends never\n      ? never\n      : // Test if the plugin condition is true (if it's not, the plugin is skipped for this node)\n        IInterpreterPlugin<T, S, L>[K]\n    : never\n  : never;\n\n/**\n * Traverse recursively through an object or array, applying each plugin as needed.\n */\ntype Traverse<T, S, L extends LocalesValues = DeclaredLocales> =\n  T extends ReadonlyArray<infer U> // Turn any read-only array into a plain mutable array\n    ? Array<DeepTransformContent<U, S, L>>\n    : T extends object\n      ? { [K in keyof T]: DeepTransformContent<T[K], S, L> }\n      : T;\n\nexport type IsAny<T> = 0 extends 1 & T ? true : false;\n\n/**\n * Traverse recursively through an object or array, applying each plugin as needed.\n */\nexport type DeepTransformContent<\n  T,\n  S = IInterpreterPluginState,\n  L extends LocalesValues = DeclaredLocales,\n> =\n  IsAny<T> extends true\n    ? T\n    : CheckApplyPlugin<T, keyof IInterpreterPlugin<T, S, L>, S, L> extends never // Check if there is a plugin for T:\n      ? // No plugin was found, so try to transform T recursively:\n        Traverse<T, S, L>\n      : // A plugin was found – use the plugin's transformation.\n        CheckApplyPlugin<T, keyof IInterpreterPlugin<T, S, L>, S, L>;\n"],"mappings":"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"}

package/dist/esm/interpreter/getDictionary.mjs

@@ -1 +1,24 @@
-import{f as e}from"../getContent-DKqtIZGL.mjs";export{e as getDictionary};
+import { getBasePlugins, getContent } from "./getContent/getContent.mjs";
+
+//#region src/interpreter/getDictionary.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.
+*/
+const getDictionary = (dictionary, locale, plugins = getBasePlugins(locale)) => {
+	const props = {
+		dictionaryKey: dictionary.key,
+		dictionaryPath: dictionary.filePath,
+		keyPath: [],
+		plugins
+	};
+	return getContent(dictionary.content, props, plugins);
+};
+
+//#endregion
+export { getDictionary };
+//# sourceMappingURL=getDictionary.mjs.map

package/dist/esm/interpreter/getDictionary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDictionary.mjs","names":[],"sources":["../../../src/interpreter/getDictionary.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type {\n  DeepTransformContent,\n  IInterpreterPluginState,\n  NodeProps,\n  Plugins,\n} from './getContent';\nimport { getBasePlugins, getContent } from './getContent/getContent';\n\n/**\n * Transforms a dictionary in a single pass, applying each plugin as needed.\n *\n * @param dictionary The dictionary to transform.\n * @param locale The locale to use if your transformers need it (e.g. for translations).\n * @param additionalPlugins An array of NodeTransformer that define how to transform recognized nodes.\n *                      If omitted, we’ll use a default set of plugins.\n */\nexport const getDictionary = <\n  T extends Dictionary,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  dictionary: T,\n  locale?: L,\n  plugins: Plugins[] = getBasePlugins(locale)\n): DeepTransformContent<T['content'], IInterpreterPluginState, L> => {\n  const props: NodeProps = {\n    dictionaryKey: dictionary.key,\n    dictionaryPath: dictionary.filePath,\n    keyPath: [],\n    plugins,\n  };\n\n  return getContent(dictionary.content, props, plugins);\n};\n"],"mappings":";;;;;;;;;;;AAqBA,MAAa,iBAIX,YACA,QACA,UAAqB,eAAe,OAAO,KACwB;CACnE,MAAM,QAAmB;EACvB,eAAe,WAAW;EAC1B,gBAAgB,WAAW;EAC3B,SAAS,EAAE;EACX;EACD;AAED,QAAO,WAAW,WAAW,SAAS,OAAO,QAAQ"}

package/dist/esm/interpreter/getEnumeration.mjs

@@ -1,2 +1,70 @@
-const e=(e,t)=>{let n=Object.keys(e);for(let e of n){let n=!e.startsWith(`>`)&&!e.startsWith(`<`)&&!e.startsWith(`=`)&&parseFloat(e)===t||e.startsWith(`=`)&&parseFloat(e.slice(1))===t,r=e.startsWith(`>`)&&t>parseFloat(e.slice(1)),i=e.startsWith(`>=`)&&t>=parseFloat(e.slice(2)),a=e.startsWith(`<`)&&t<parseFloat(e.slice(1)),o=e.startsWith(`<=`)&&t<=parseFloat(e.slice(2));if(n||r||i||a||o)return e}},t=(t,n)=>t[e(t,n)??`fallback`];export{e as findMatchingCondition,t as getEnumeration};
+//#region src/interpreter/getEnumeration.ts
+/**
+* Find the matching condition for a quantity.
+*
+* Usage:
+*
+* ```ts
+* const key = findMatchingCondition({
+*  '<=-2.3': 'You have less than -2.3',
+*  '<1': 'You have less than one',
+*  '2': 'You have two',
+*  '>=3': 'You have three or more',
+* }, 2);
+* // '2'
+* ```
+*
+* The order of the keys will define the priority of the content.
+*
+* ```ts
+* const key = findMatchingCondition({
+*  '<4': 'You have less than four',
+*  '2': 'You have two',
+* }, 2);
+* // '<4'
+* ```
+*
+* If no keys match, the default key is '1'.
+*/
+const findMatchingCondition = (enumerationContent, quantity) => {
+	const numericKeys = Object.keys(enumerationContent);
+	for (const key of numericKeys) {
+		const isEqual = !key.startsWith(">") && !key.startsWith("<") && !key.startsWith("=") && parseFloat(key) === quantity || key.startsWith("=") && parseFloat(key.slice(1)) === quantity;
+		const isSuperior = key.startsWith(">") && quantity > parseFloat(key.slice(1));
+		const isSuperiorOrEqual = key.startsWith(">=") && quantity >= parseFloat(key.slice(2));
+		const isInferior = key.startsWith("<") && quantity < parseFloat(key.slice(1));
+		const isInferiorOrEqual = key.startsWith("<=") && quantity <= parseFloat(key.slice(2));
+		if (isEqual || isSuperior || isSuperiorOrEqual || isInferior || isInferiorOrEqual) return key;
+	}
+};
+/**
+* Picks content from an enumeration map based on a provided quantity.
+*
+* Supported keys in the enumeration map:
+* - Specific numbers: '0', '1', '2'
+* - Comparison operators: '<5', '>=10', '<=2'
+* - Fallback: 'fallback'
+*
+* The first matching key in the object's iteration order will be selected.
+*
+* @param enumerationContent - A map of conditions/quantities to content.
+* @param quantity - The number to match against the conditions.
+* @returns The matching content.
+*
+* @example
+* ```ts
+* const content = getEnumeration({
+*   '0': 'No items',
+*   '1': 'One item',
+*   '>1': 'Many items',
+* }, 5);
+* // 'Many items'
+* ```
+*/
+const getEnumeration = (enumerationContent, quantity) => {
+	return enumerationContent[findMatchingCondition(enumerationContent, quantity) ?? "fallback"];
+};
+
+//#endregion
+export { findMatchingCondition, getEnumeration };
 //# sourceMappingURL=getEnumeration.mjs.map

package/dist/esm/interpreter/getEnumeration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getEnumeration.mjs","names":[],"sources":["../../../src/interpreter/getEnumeration.ts"],"sourcesContent":["import type { EnterFormat, EnumerationContentState } from '../transpiler';\n\n/**\n * Find the matching condition for a quantity.\n *\n * Usage:\n *\n * ```ts\n * const key = findMatchingCondition({\n *  '<=-2.3': 'You have less than -2.3',\n *  '<1': 'You have less than one',\n *  '2': 'You have two',\n *  '>=3': 'You have three or more',\n * }, 2);\n * // '2'\n * ```\n *\n * The order of the keys will define the priority of the content.\n *\n * ```ts\n * const key = findMatchingCondition({\n *  '<4': 'You have less than four',\n *  '2': 'You have two',\n * }, 2);\n * // '<4'\n * ```\n *\n * If no keys match, the default key is '1'.\n */\nexport const findMatchingCondition = <Content>(\n  enumerationContent: EnumerationContentState<Content>,\n  quantity: number\n): EnterFormat | undefined => {\n  const numericKeys = Object.keys(enumerationContent);\n\n  for (const key of numericKeys) {\n    const isEqual =\n      (!key.startsWith('>') &&\n        !key.startsWith('<') &&\n        !key.startsWith('=') &&\n        parseFloat(key) === quantity) ||\n      (key.startsWith('=') && parseFloat(key.slice(1)) === quantity);\n    const isSuperior =\n      key.startsWith('>') && quantity > parseFloat(key.slice(1));\n    const isSuperiorOrEqual =\n      key.startsWith('>=') && quantity >= parseFloat(key.slice(2));\n    const isInferior =\n      key.startsWith('<') && quantity < parseFloat(key.slice(1));\n    const isInferiorOrEqual =\n      key.startsWith('<=') && quantity <= parseFloat(key.slice(2));\n\n    if (\n      isEqual ||\n      isSuperior ||\n      isSuperiorOrEqual ||\n      isInferior ||\n      isInferiorOrEqual\n    ) {\n      return key as EnterFormat;\n    }\n  }\n};\n\n/**\n * Picks content from an enumeration map based on a provided quantity.\n *\n * Supported keys in the enumeration map:\n * - Specific numbers: '0', '1', '2'\n * - Comparison operators: '<5', '>=10', '<=2'\n * - Fallback: 'fallback'\n *\n * The first matching key in the object's iteration order will be selected.\n *\n * @param enumerationContent - A map of conditions/quantities to content.\n * @param quantity - The number to match against the conditions.\n * @returns The matching content.\n *\n * @example\n * ```ts\n * const content = getEnumeration({\n *   '0': 'No items',\n *   '1': 'One item',\n *   '>1': 'Many items',\n * }, 5);\n * // 'Many items'\n * ```\n */\nexport const getEnumeration = <Content>(\n  enumerationContent: EnumerationContentState<Content>,\n  quantity: number\n): Content => {\n  const key =\n    findMatchingCondition<Content>(enumerationContent, quantity) ?? 'fallback';\n\n  // Default or error handling if no keys match\n  return enumerationContent[key] as Content;\n};\n"],"mappings":"AA6BA,MAAa,GACX,EACA,IAC4B,CAC5B,IAAM,EAAc,OAAO,KAAK,EAAmB,CAEnD,IAAK,IAAM,KAAO,EAAa,CAC7B,IAAM,EACH,CAAC,EAAI,WAAW,IAAI,EACnB,CAAC,EAAI,WAAW,IAAI,EACpB,CAAC,EAAI,WAAW,IAAI,EACpB,WAAW,EAAI,GAAK,GACrB,EAAI,WAAW,IAAI,EAAI,WAAW,EAAI,MAAM,EAAE,CAAC,GAAK,EACjD,EACJ,EAAI,WAAW,IAAI,EAAI,EAAW,WAAW,EAAI,MAAM,EAAE,CAAC,CACtD,EACJ,EAAI,WAAW,KAAK,EAAI,GAAY,WAAW,EAAI,MAAM,EAAE,CAAC,CACxD,EACJ,EAAI,WAAW,IAAI,EAAI,EAAW,WAAW,EAAI,MAAM,EAAE,CAAC,CACtD,EACJ,EAAI,WAAW,KAAK,EAAI,GAAY,WAAW,EAAI,MAAM,EAAE,CAAC,CAE9D,GACE,GACA,GACA,GACA,GACA,EAEA,OAAO,IA6BA,GACX,EACA,IAMO,EAHL,EAA+B,EAAoB,EAAS,EAAI"}
+{"version":3,"file":"getEnumeration.mjs","names":[],"sources":["../../../src/interpreter/getEnumeration.ts"],"sourcesContent":["import type { EnterFormat, EnumerationContentState } from '../transpiler';\n\n/**\n * Find the matching condition for a quantity.\n *\n * Usage:\n *\n * ```ts\n * const key = findMatchingCondition({\n *  '<=-2.3': 'You have less than -2.3',\n *  '<1': 'You have less than one',\n *  '2': 'You have two',\n *  '>=3': 'You have three or more',\n * }, 2);\n * // '2'\n * ```\n *\n * The order of the keys will define the priority of the content.\n *\n * ```ts\n * const key = findMatchingCondition({\n *  '<4': 'You have less than four',\n *  '2': 'You have two',\n * }, 2);\n * // '<4'\n * ```\n *\n * If no keys match, the default key is '1'.\n */\nexport const findMatchingCondition = <Content>(\n  enumerationContent: EnumerationContentState<Content>,\n  quantity: number\n): EnterFormat | undefined => {\n  const numericKeys = Object.keys(enumerationContent);\n\n  for (const key of numericKeys) {\n    const isEqual =\n      (!key.startsWith('>') &&\n        !key.startsWith('<') &&\n        !key.startsWith('=') &&\n        parseFloat(key) === quantity) ||\n      (key.startsWith('=') && parseFloat(key.slice(1)) === quantity);\n    const isSuperior =\n      key.startsWith('>') && quantity > parseFloat(key.slice(1));\n    const isSuperiorOrEqual =\n      key.startsWith('>=') && quantity >= parseFloat(key.slice(2));\n    const isInferior =\n      key.startsWith('<') && quantity < parseFloat(key.slice(1));\n    const isInferiorOrEqual =\n      key.startsWith('<=') && quantity <= parseFloat(key.slice(2));\n\n    if (\n      isEqual ||\n      isSuperior ||\n      isSuperiorOrEqual ||\n      isInferior ||\n      isInferiorOrEqual\n    ) {\n      return key as EnterFormat;\n    }\n  }\n};\n\n/**\n * Picks content from an enumeration map based on a provided quantity.\n *\n * Supported keys in the enumeration map:\n * - Specific numbers: '0', '1', '2'\n * - Comparison operators: '<5', '>=10', '<=2'\n * - Fallback: 'fallback'\n *\n * The first matching key in the object's iteration order will be selected.\n *\n * @param enumerationContent - A map of conditions/quantities to content.\n * @param quantity - The number to match against the conditions.\n * @returns The matching content.\n *\n * @example\n * ```ts\n * const content = getEnumeration({\n *   '0': 'No items',\n *   '1': 'One item',\n *   '>1': 'Many items',\n * }, 5);\n * // 'Many items'\n * ```\n */\nexport const getEnumeration = <Content>(\n  enumerationContent: EnumerationContentState<Content>,\n  quantity: number\n): Content => {\n  const key =\n    findMatchingCondition<Content>(enumerationContent, quantity) ?? 'fallback';\n\n  // Default or error handling if no keys match\n  return enumerationContent[key] as Content;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,yBACX,oBACA,aAC4B;CAC5B,MAAM,cAAc,OAAO,KAAK,mBAAmB;AAEnD,MAAK,MAAM,OAAO,aAAa;EAC7B,MAAM,UACH,CAAC,IAAI,WAAW,IAAI,IACnB,CAAC,IAAI,WAAW,IAAI,IACpB,CAAC,IAAI,WAAW,IAAI,IACpB,WAAW,IAAI,KAAK,YACrB,IAAI,WAAW,IAAI,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC,KAAK;EACvD,MAAM,aACJ,IAAI,WAAW,IAAI,IAAI,WAAW,WAAW,IAAI,MAAM,EAAE,CAAC;EAC5D,MAAM,oBACJ,IAAI,WAAW,KAAK,IAAI,YAAY,WAAW,IAAI,MAAM,EAAE,CAAC;EAC9D,MAAM,aACJ,IAAI,WAAW,IAAI,IAAI,WAAW,WAAW,IAAI,MAAM,EAAE,CAAC;EAC5D,MAAM,oBACJ,IAAI,WAAW,KAAK,IAAI,YAAY,WAAW,IAAI,MAAM,EAAE,CAAC;AAE9D,MACE,WACA,cACA,qBACA,cACA,kBAEA,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6Bb,MAAa,kBACX,oBACA,aACY;AAKZ,QAAO,mBAHL,sBAA+B,oBAAoB,SAAS,IAAI"}

package/dist/esm/interpreter/getGender.mjs

@@ -1,2 +1,37 @@
-const e=e=>e===`m`||e===`male`?`male`:e===`f`||e===`female`?`female`:`fallback`,t=(t,n)=>{let r=Object.keys(t),i=r[r.length-1];return t[e(n)]??t.fallback??t[i]};export{t as getGender};
+//#region src/interpreter/getGender.ts
+const getGenderEntry = (gender) => {
+	if (gender === "m" || gender === "male") return "male";
+	if (gender === "f" || gender === "female") return "female";
+	return "fallback";
+};
+/**
+* Allow to pick a content based on a gender.
+*
+* Usage:
+*
+* ```ts
+* const content = getGender({
+*  'true': 'The gender is validated',
+*  'false': 'The gender is not validated',
+* }, true);
+* // 'The gender is validated'
+* ```
+*
+* The last key provided will be used as the fallback value.
+*
+* ```ts
+* const content = getGender({
+*  'false': 'The gender is not validated',
+*  'true': 'The gender is validated',
+* }, undefined);
+* // 'The gender is validated'
+*/
+const getGender = (genderContent, gender) => {
+	const stateList = Object.keys(genderContent);
+	const fallbackState = stateList[stateList.length - 1];
+	return genderContent[getGenderEntry(gender)] ?? genderContent.fallback ?? genderContent[fallbackState];
+};
+
+//#endregion
+export { getGender };
 //# sourceMappingURL=getGender.mjs.map

package/dist/esm/interpreter/getGender.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getGender.mjs","names":[],"sources":["../../../src/interpreter/getGender.ts"],"sourcesContent":["import type { Gender, GenderContentStates } from '../transpiler';\n\ntype GenderEntry = Gender | 'm' | 'f';\n\nconst getGenderEntry = (gender: GenderEntry): Gender => {\n  if (gender === 'm' || gender === 'male') return 'male';\n  if (gender === 'f' || gender === 'female') return 'female';\n  return 'fallback';\n};\n\n/**\n * Allow to pick a content based on a gender.\n *\n * Usage:\n *\n * ```ts\n * const content = getGender({\n *  'true': 'The gender is validated',\n *  'false': 'The gender is not validated',\n * }, true);\n * // 'The gender is validated'\n * ```\n *\n * The last key provided will be used as the fallback value.\n *\n * ```ts\n * const content = getGender({\n *  'false': 'The gender is not validated',\n *  'true': 'The gender is validated',\n * }, undefined);\n * // 'The gender is validated'\n */\nexport const getGender = <Content>(\n  genderContent: GenderContentStates<Content>,\n  gender: GenderEntry\n): Content => {\n  const stateList = Object.keys(genderContent);\n\n  const fallbackState = stateList[\n    stateList.length - 1\n  ] as keyof typeof genderContent;\n\n  const genderEntry = getGenderEntry(gender);\n\n  // Default or error handling if no keys match\n  return (\n    genderContent[genderEntry as keyof typeof genderContent] ??\n    genderContent.fallback ??\n    (genderContent[fallbackState] as Content)\n  );\n};\n"],"mappings":"AAIA,MAAM,EAAkB,GAClB,IAAW,KAAO,IAAW,OAAe,OAC5C,IAAW,KAAO,IAAW,SAAiB,SAC3C,WAyBI,GACX,EACA,IACY,CACZ,IAAM,EAAY,OAAO,KAAK,EAAc,CAEtC,EAAgB,EACpB,EAAU,OAAS,GAMrB,OACE,EAJkB,EAAe,EAAO,GAKxC,EAAc,UACb,EAAc"}
+{"version":3,"file":"getGender.mjs","names":[],"sources":["../../../src/interpreter/getGender.ts"],"sourcesContent":["import type { Gender, GenderContentStates } from '../transpiler';\n\ntype GenderEntry = Gender | 'm' | 'f';\n\nconst getGenderEntry = (gender: GenderEntry): Gender => {\n  if (gender === 'm' || gender === 'male') return 'male';\n  if (gender === 'f' || gender === 'female') return 'female';\n  return 'fallback';\n};\n\n/**\n * Allow to pick a content based on a gender.\n *\n * Usage:\n *\n * ```ts\n * const content = getGender({\n *  'true': 'The gender is validated',\n *  'false': 'The gender is not validated',\n * }, true);\n * // 'The gender is validated'\n * ```\n *\n * The last key provided will be used as the fallback value.\n *\n * ```ts\n * const content = getGender({\n *  'false': 'The gender is not validated',\n *  'true': 'The gender is validated',\n * }, undefined);\n * // 'The gender is validated'\n */\nexport const getGender = <Content>(\n  genderContent: GenderContentStates<Content>,\n  gender: GenderEntry\n): Content => {\n  const stateList = Object.keys(genderContent);\n\n  const fallbackState = stateList[\n    stateList.length - 1\n  ] as keyof typeof genderContent;\n\n  const genderEntry = getGenderEntry(gender);\n\n  // Default or error handling if no keys match\n  return (\n    genderContent[genderEntry as keyof typeof genderContent] ??\n    genderContent.fallback ??\n    (genderContent[fallbackState] as Content)\n  );\n};\n"],"mappings":";AAIA,MAAM,kBAAkB,WAAgC;AACtD,KAAI,WAAW,OAAO,WAAW,OAAQ,QAAO;AAChD,KAAI,WAAW,OAAO,WAAW,SAAU,QAAO;AAClD,QAAO;;;;;;;;;;;;;;;;;;;;;;;;AAyBT,MAAa,aACX,eACA,WACY;CACZ,MAAM,YAAY,OAAO,KAAK,cAAc;CAE5C,MAAM,gBAAgB,UACpB,UAAU,SAAS;AAMrB,QACE,cAJkB,eAAe,OAAO,KAKxC,cAAc,YACb,cAAc"}

package/dist/esm/interpreter/getHTML.mjs

@@ -1,2 +1,123 @@
-const e=e=>{let t={},n=/([a-zA-Z0-9-]+)="([^"]*)"/g,r=n.exec(e);for(;r!==null;)t[r[1]]=r[2],r=n.exec(e);return t},t=new Map,n=n=>{if(t.has(n))return t.get(n);if(typeof n!=`string`)return[];let r=/<(\/)?([a-zA-Z0-9.-]+)([\s\S]*?)(\/?)>/g,i=[],a=[],o=0,s=r.exec(n),c=e=>{(a.length>0?a[a.length-1].children:i).push(e)};for(;s!==null;){let[t,i,l,u,d]=s,f=s.index;f>o&&c(n.slice(o,f));let p=i===`/`,m=d===`/`||u.trim().endsWith(`/`)||t.endsWith(`/>`),h=u.trim().replace(/\/$/,``).trim();if(p){let e=a[a.length-1];if(e&&e.tagName===l){let e=a.pop();e&&c({tagName:e.tagName,props:e.props,children:e.children})}}else if(m)c({tagName:l,props:e(h),children:[]});else{let t=e(h);a.push({tagName:l,children:[],props:t})}o=f+t.length,s=r.exec(n)}for(o<n.length&&c(n.slice(o));a.length>0;){let e=a.pop();e&&c({tagName:e.tagName,props:e.props,children:e.children})}return t.set(n,i),i},r=(e,t)=>{let r=n(e),i=0,a=e=>{if(typeof e==`string`)return e;let{tagName:n,props:r,children:o}=e,s=o.flatMap(a),c=i++,l=t[n];if(!l){let e=n.toLowerCase(),r=Object.keys(t).find(t=>t.toLowerCase()===e);r&&(l=t[r])}let u=`html-tag-${n}-${c}`;if(typeof l==`function`)return l({...r,children:s,key:u});if(typeof l==`string`){let e=t[l];return typeof e==`function`?e({...r,children:s,key:u}):s}if(typeof l==`object`&&l&&`tag`in l){let{tag:e,props:n}=l,i=t[e];return typeof i==`function`?i({...r,...n,children:s,key:u}):s}return s},o=r.flatMap(a);return o.length===1?o[0]:o};export{r as getHTML};
+//#region src/interpreter/getHTML.ts
+/**
+* Helper to parse attributes from a tag string.
+*/
+const parseAttributes = (attributes) => {
+	const props = {};
+	const attrRegex = /([a-zA-Z0-9-]+)="([^"]*)"/g;
+	let match = attrRegex.exec(attributes);
+	while (match !== null) {
+		props[match[1]] = match[2];
+		match = attrRegex.exec(attributes);
+	}
+	return props;
+};
+const astCache = /* @__PURE__ */ new Map();
+const parseHTML = (content) => {
+	if (astCache.has(content)) return astCache.get(content);
+	if (typeof content !== "string") return [];
+	const tagRegex = /<(\/)?([a-zA-Z0-9.-]+)([\s\S]*?)(\/?)>/g;
+	const elements = [];
+	const stack = [];
+	let lastIndex = 0;
+	let match = tagRegex.exec(content);
+	const appendChild = (child) => {
+		(stack.length > 0 ? stack[stack.length - 1].children : elements).push(child);
+	};
+	while (match !== null) {
+		const [fullMatch, isClosingRaw, tagName, attributesRaw, isSelfClosingRaw] = match;
+		const matchIndex = match.index;
+		if (matchIndex > lastIndex) appendChild(content.slice(lastIndex, matchIndex));
+		const isClosing = isClosingRaw === "/";
+		const isSelfClosing = isSelfClosingRaw === "/" || attributesRaw.trim().endsWith("/") || fullMatch.endsWith("/>");
+		const cleanedAttributes = attributesRaw.trim().replace(/\/$/, "").trim();
+		if (isClosing) {
+			const last = stack[stack.length - 1];
+			if (last && last.tagName === tagName) {
+				const popped = stack.pop();
+				if (popped) appendChild({
+					tagName: popped.tagName,
+					props: popped.props,
+					children: popped.children
+				});
+			}
+		} else if (isSelfClosing) appendChild({
+			tagName,
+			props: parseAttributes(cleanedAttributes),
+			children: []
+		});
+		else {
+			const tagProps = parseAttributes(cleanedAttributes);
+			stack.push({
+				tagName,
+				children: [],
+				props: tagProps
+			});
+		}
+		lastIndex = matchIndex + fullMatch.length;
+		match = tagRegex.exec(content);
+	}
+	if (lastIndex < content.length) appendChild(content.slice(lastIndex));
+	while (stack.length > 0) {
+		const last = stack.pop();
+		if (last) appendChild({
+			tagName: last.tagName,
+			props: last.props,
+			children: last.children
+		});
+	}
+	astCache.set(content, elements);
+	return elements;
+};
+/**
+* Interprets a string containing HTML-like tags and replaces them with provided components or strings.
+*/
+const getHTML = (content, values) => {
+	const ast = parseHTML(content);
+	let keyCounter = 0;
+	const renderASTNode = (node) => {
+		if (typeof node === "string") return node;
+		const { tagName, props, children } = node;
+		const renderedChildren = children.flatMap(renderASTNode);
+		const index = keyCounter++;
+		let override = values[tagName];
+		if (!override) {
+			const lowerTagName = tagName.toLowerCase();
+			const foundKey = Object.keys(values).find((key) => key.toLowerCase() === lowerTagName);
+			if (foundKey) override = values[foundKey];
+		}
+		const key = `html-tag-${tagName}-${index}`;
+		if (typeof override === "function") return override({
+			...props,
+			children: renderedChildren,
+			key
+		});
+		if (typeof override === "string") {
+			const component = values[override];
+			if (typeof component === "function") return component({
+				...props,
+				children: renderedChildren,
+				key
+			});
+			return renderedChildren;
+		}
+		if (typeof override === "object" && override !== null && "tag" in override) {
+			const { tag: targetTag, props: extraProps } = override;
+			const component = values[targetTag];
+			if (typeof component === "function") return component({
+				...props,
+				...extraProps,
+				children: renderedChildren,
+				key
+			});
+			return renderedChildren;
+		}
+		return renderedChildren;
+	};
+	const result = ast.flatMap(renderASTNode);
+	return result.length === 1 ? result[0] : result;
+};
+
+//#endregion
+export { getHTML };
 //# sourceMappingURL=getHTML.mjs.map

package/dist/esm/interpreter/getHTML.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getHTML.mjs","names":[],"sources":["../../../src/interpreter/getHTML.ts"],"sourcesContent":["/**\n * Component function that receives properly typed props\n * Props include:\n * - children?: any[] - Array of child elements (ReactNode[], VNode[], etc.)\n * - [key: string]: any - Any HTML attributes (className, style, href, etc.)\n */\ntype Component = (props: { children?: any[]; [key: string]: any }) => any;\n\n/**\n * Component object that delegates to another component\n */\ntype ComponentObject = {\n  tag: string;\n  props?: Record<string, any>;\n};\n\n/**\n * Components map:\n * - Function components receive typed props\n * - String components delegate to another tag\n * - Object components delegate with additional props\n */\ntype Components = Record<string, Component | string | ComponentObject>;\n\n/**\n * Helper to parse attributes from a tag string.\n */\nconst parseAttributes = (attributes: string): Record<string, string> => {\n  const props: Record<string, string> = {};\n  const attrRegex = /([a-zA-Z0-9-]+)=\"([^\"]*)\"/g;\n\n  let match = attrRegex.exec(attributes);\n  while (match !== null) {\n    props[match[1]] = match[2];\n    match = attrRegex.exec(attributes);\n  }\n  return props;\n};\n\ntype ASTNode =\n  | string\n  | {\n      tagName: string;\n      props: Record<string, string>;\n      children: ASTNode[];\n    };\n\nconst astCache = new Map<string, ASTNode[]>();\n\nconst parseHTML = (content: string): ASTNode[] => {\n  if (astCache.has(content)) {\n    return astCache.get(content)!;\n  }\n\n  if (typeof content !== 'string') {\n    return [];\n  }\n\n  const tagRegex = /<(\\/)?([a-zA-Z0-9.-]+)([\\s\\S]*?)(\\/?)>/g;\n  const elements: ASTNode[] = [];\n  const stack: {\n    tagName: string;\n    children: ASTNode[];\n    props: Record<string, string>;\n  }[] = [];\n\n  let lastIndex = 0;\n  let match = tagRegex.exec(content);\n\n  const appendChild = (child: ASTNode) => {\n    const target =\n      stack.length > 0 ? stack[stack.length - 1].children : elements;\n    target.push(child);\n  };\n\n  while (match !== null) {\n    const [fullMatch, isClosingRaw, tagName, attributesRaw, isSelfClosingRaw] =\n      match;\n    const matchIndex = match.index;\n\n    if (matchIndex > lastIndex) {\n      appendChild(content.slice(lastIndex, matchIndex));\n    }\n\n    const isClosing = isClosingRaw === '/';\n    const isSelfClosing =\n      isSelfClosingRaw === '/' ||\n      attributesRaw.trim().endsWith('/') ||\n      fullMatch.endsWith('/>');\n\n    const cleanedAttributes = attributesRaw.trim().replace(/\\/$/, '').trim();\n\n    if (isClosing) {\n      const last = stack[stack.length - 1];\n\n      // Only pop if the tag names match\n      if (last && last.tagName === tagName) {\n        const popped = stack.pop();\n        if (popped) {\n          appendChild({\n            tagName: popped.tagName,\n            props: popped.props,\n            children: popped.children,\n          });\n        }\n      }\n      // If tags don't match or no open tag, silently ignore the closing tag\n    } else if (isSelfClosing) {\n      const tagProps = parseAttributes(cleanedAttributes);\n      appendChild({\n        tagName,\n        props: tagProps,\n        children: [],\n      });\n    } else {\n      const tagProps = parseAttributes(cleanedAttributes);\n      stack.push({ tagName, children: [], props: tagProps });\n    }\n\n    lastIndex = matchIndex + fullMatch.length;\n    match = tagRegex.exec(content);\n  }\n\n  if (lastIndex < content.length) {\n    appendChild(content.slice(lastIndex));\n  }\n\n  // Handle unclosed tags by appending them to the root or parent\n  while (stack.length > 0) {\n    const last = stack.pop();\n    if (last) {\n      appendChild({\n        tagName: last.tagName,\n        props: last.props,\n        children: last.children,\n      });\n    }\n  }\n\n  astCache.set(content, elements);\n  return elements;\n};\n\n/**\n * Interprets a string containing HTML-like tags and replaces them with provided components or strings.\n */\nexport const getHTML = (content: string, values: Components): any => {\n  // Parse into AST (cached)\n  const ast = parseHTML(content);\n\n  // Render AST\n  let keyCounter = 0;\n\n  const renderASTNode = (node: ASTNode): any => {\n    if (typeof node === 'string') {\n      return node;\n    }\n\n    const { tagName, props, children } = node;\n    const renderedChildren = children.flatMap(renderASTNode);\n    const index = keyCounter++;\n\n    let override = values[tagName];\n\n    if (!override) {\n      const lowerTagName = tagName.toLowerCase();\n      const foundKey = Object.keys(values).find(\n        (key) => key.toLowerCase() === lowerTagName\n      );\n\n      if (foundKey) override = values[foundKey];\n    }\n\n    const key = `html-tag-${tagName}-${index}`;\n\n    if (typeof override === 'function') {\n      return override({ ...props, children: renderedChildren, key });\n    }\n\n    if (typeof override === 'string') {\n      const component = values[override];\n\n      if (typeof component === 'function') {\n        return component({ ...props, children: renderedChildren, key });\n      }\n      return renderedChildren;\n    }\n\n    if (\n      typeof override === 'object' &&\n      override !== null &&\n      'tag' in override\n    ) {\n      const { tag: targetTag, props: extraProps } = override as ComponentObject;\n      const component = values[targetTag];\n\n      if (typeof component === 'function') {\n        return component({\n          ...props,\n          ...extraProps,\n          children: renderedChildren,\n          key,\n        });\n      }\n      return renderedChildren;\n    }\n\n    // Default: Skip tag, render children\n    return renderedChildren;\n  };\n\n  const result = ast.flatMap(renderASTNode);\n  return result.length === 1 ? result[0] : result;\n};\n"],"mappings":"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"}
+{"version":3,"file":"getHTML.mjs","names":[],"sources":["../../../src/interpreter/getHTML.ts"],"sourcesContent":["/**\n * Component function that receives properly typed props\n * Props include:\n * - children?: any[] - Array of child elements (ReactNode[], VNode[], etc.)\n * - [key: string]: any - Any HTML attributes (className, style, href, etc.)\n */\ntype Component = (props: { children?: any[]; [key: string]: any }) => any;\n\n/**\n * Component object that delegates to another component\n */\ntype ComponentObject = {\n  tag: string;\n  props?: Record<string, any>;\n};\n\n/**\n * Components map:\n * - Function components receive typed props\n * - String components delegate to another tag\n * - Object components delegate with additional props\n */\ntype Components = Record<string, Component | string | ComponentObject>;\n\n/**\n * Helper to parse attributes from a tag string.\n */\nconst parseAttributes = (attributes: string): Record<string, string> => {\n  const props: Record<string, string> = {};\n  const attrRegex = /([a-zA-Z0-9-]+)=\"([^\"]*)\"/g;\n\n  let match = attrRegex.exec(attributes);\n  while (match !== null) {\n    props[match[1]] = match[2];\n    match = attrRegex.exec(attributes);\n  }\n  return props;\n};\n\ntype ASTNode =\n  | string\n  | {\n      tagName: string;\n      props: Record<string, string>;\n      children: ASTNode[];\n    };\n\nconst astCache = new Map<string, ASTNode[]>();\n\nconst parseHTML = (content: string): ASTNode[] => {\n  if (astCache.has(content)) {\n    return astCache.get(content)!;\n  }\n\n  if (typeof content !== 'string') {\n    return [];\n  }\n\n  const tagRegex = /<(\\/)?([a-zA-Z0-9.-]+)([\\s\\S]*?)(\\/?)>/g;\n  const elements: ASTNode[] = [];\n  const stack: {\n    tagName: string;\n    children: ASTNode[];\n    props: Record<string, string>;\n  }[] = [];\n\n  let lastIndex = 0;\n  let match = tagRegex.exec(content);\n\n  const appendChild = (child: ASTNode) => {\n    const target =\n      stack.length > 0 ? stack[stack.length - 1].children : elements;\n    target.push(child);\n  };\n\n  while (match !== null) {\n    const [fullMatch, isClosingRaw, tagName, attributesRaw, isSelfClosingRaw] =\n      match;\n    const matchIndex = match.index;\n\n    if (matchIndex > lastIndex) {\n      appendChild(content.slice(lastIndex, matchIndex));\n    }\n\n    const isClosing = isClosingRaw === '/';\n    const isSelfClosing =\n      isSelfClosingRaw === '/' ||\n      attributesRaw.trim().endsWith('/') ||\n      fullMatch.endsWith('/>');\n\n    const cleanedAttributes = attributesRaw.trim().replace(/\\/$/, '').trim();\n\n    if (isClosing) {\n      const last = stack[stack.length - 1];\n\n      // Only pop if the tag names match\n      if (last && last.tagName === tagName) {\n        const popped = stack.pop();\n        if (popped) {\n          appendChild({\n            tagName: popped.tagName,\n            props: popped.props,\n            children: popped.children,\n          });\n        }\n      }\n      // If tags don't match or no open tag, silently ignore the closing tag\n    } else if (isSelfClosing) {\n      const tagProps = parseAttributes(cleanedAttributes);\n      appendChild({\n        tagName,\n        props: tagProps,\n        children: [],\n      });\n    } else {\n      const tagProps = parseAttributes(cleanedAttributes);\n      stack.push({ tagName, children: [], props: tagProps });\n    }\n\n    lastIndex = matchIndex + fullMatch.length;\n    match = tagRegex.exec(content);\n  }\n\n  if (lastIndex < content.length) {\n    appendChild(content.slice(lastIndex));\n  }\n\n  // Handle unclosed tags by appending them to the root or parent\n  while (stack.length > 0) {\n    const last = stack.pop();\n    if (last) {\n      appendChild({\n        tagName: last.tagName,\n        props: last.props,\n        children: last.children,\n      });\n    }\n  }\n\n  astCache.set(content, elements);\n  return elements;\n};\n\n/**\n * Interprets a string containing HTML-like tags and replaces them with provided components or strings.\n */\nexport const getHTML = (content: string, values: Components): any => {\n  // Parse into AST (cached)\n  const ast = parseHTML(content);\n\n  // Render AST\n  let keyCounter = 0;\n\n  const renderASTNode = (node: ASTNode): any => {\n    if (typeof node === 'string') {\n      return node;\n    }\n\n    const { tagName, props, children } = node;\n    const renderedChildren = children.flatMap(renderASTNode);\n    const index = keyCounter++;\n\n    let override = values[tagName];\n\n    if (!override) {\n      const lowerTagName = tagName.toLowerCase();\n      const foundKey = Object.keys(values).find(\n        (key) => key.toLowerCase() === lowerTagName\n      );\n\n      if (foundKey) override = values[foundKey];\n    }\n\n    const key = `html-tag-${tagName}-${index}`;\n\n    if (typeof override === 'function') {\n      return override({ ...props, children: renderedChildren, key });\n    }\n\n    if (typeof override === 'string') {\n      const component = values[override];\n\n      if (typeof component === 'function') {\n        return component({ ...props, children: renderedChildren, key });\n      }\n      return renderedChildren;\n    }\n\n    if (\n      typeof override === 'object' &&\n      override !== null &&\n      'tag' in override\n    ) {\n      const { tag: targetTag, props: extraProps } = override as ComponentObject;\n      const component = values[targetTag];\n\n      if (typeof component === 'function') {\n        return component({\n          ...props,\n          ...extraProps,\n          children: renderedChildren,\n          key,\n        });\n      }\n      return renderedChildren;\n    }\n\n    // Default: Skip tag, render children\n    return renderedChildren;\n  };\n\n  const result = ast.flatMap(renderASTNode);\n  return result.length === 1 ? result[0] : result;\n};\n"],"mappings":"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"}