angular-intlayer 9.0.0-canary.15 → 9.0.0-canary.17

package/dist/esm/analytics/useConversion.mjs

@@ -0,0 +1,35 @@
+import { isEnabled } from "@intlayer/analytics/isEnabled";
+
+//#region src/analytics/useConversion.ts
+/**
+* Returns a `trackConversion` callback for content A/B testing. Safe to call
+* from any component: it resolves to a no-op when analytics is disabled or the
+* client has not been initialized yet.
+*
+* @example
+* ```ts
+* export class CtaComponent {
+*   trackConversion = useConversion();
+*
+*   onClick() {
+*     this.trackConversion({
+*       experimentKey: 'homepage-hero',
+*       variant: 'b',
+*       goal: 'cta_click',
+*     });
+*   }
+* }
+* ```
+*/
+const useConversion = () => {
+	return (params) => {
+		if (process.env.INTLAYER_ANALYTICS_ENABLED === "false" || !isEnabled) return;
+		import("@intlayer/analytics").then(({ getGlobalAnalyticsClient }) => {
+			getGlobalAnalyticsClient()?.trackConversion(params);
+		}).catch(() => {});
+	};
+};
+
+//#endregion
+export { useConversion };
+//# sourceMappingURL=useConversion.mjs.map

package/dist/esm/analytics/useConversion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversion.mjs","names":[],"sources":["../../../src/analytics/useConversion.ts"],"sourcesContent":["import { isEnabled } from '@intlayer/analytics/isEnabled';\n\n/**\n * Parameters describing a conversion to record.\n */\nexport type ConversionParams = {\n  /** The experiment this conversion is attributed to. */\n  experimentKey: string;\n  /** The variant the session was assigned. */\n  variant: string;\n  /** The goal reached (e.g. `\"signup\"`, `\"cta_click\"`). */\n  goal: string;\n  /** Optional numeric value (e.g. revenue). */\n  value?: number;\n};\n\n/**\n * Returns a `trackConversion` callback for content A/B testing. Safe to call\n * from any component: it resolves to a no-op when analytics is disabled or the\n * client has not been initialized yet.\n *\n * @example\n * ```ts\n * export class CtaComponent {\n *   trackConversion = useConversion();\n *\n *   onClick() {\n *     this.trackConversion({\n *       experimentKey: 'homepage-hero',\n *       variant: 'b',\n *       goal: 'cta_click',\n *     });\n *   }\n * }\n * ```\n */\nexport const useConversion = () => {\n  return (params: ConversionParams): void => {\n    if (process.env.INTLAYER_ANALYTICS_ENABLED === 'false' || !isEnabled) {\n      return;\n    }\n\n    import('@intlayer/analytics')\n      .then(({ getGlobalAnalyticsClient }) => {\n        getGlobalAnalyticsClient()?.trackConversion(params);\n      })\n      .catch(() => {});\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,sBAAsB;AACjC,SAAQ,WAAmC;AACzC,MAAI,QAAQ,IAAI,+BAA+B,WAAW,CAAC,UACzD;AAGF,SAAO,uBACJ,MAAM,EAAE,+BAA+B;AACtC,6BAA0B,EAAE,gBAAgB,OAAO;IACnD,CACD,YAAY,GAAG"}

package/dist/esm/analytics/useExperiment.mjs

@@ -0,0 +1,68 @@
+import { DestroyRef, inject, signal } from "@angular/core";
+import { isEnabled } from "@intlayer/analytics/isEnabled";
+
+//#region src/analytics/useExperiment.ts
+/**
+* Assigns this session to a variant of an A/B experiment and records the
+* exposure, scoped to `experimentKey`, so the backend can compute per-variant
+* conversion rates against `useConversion` events.
+*
+* Assignment is deterministic per session (no server round-trip, stable across
+* re-mounts). The exposure is recorded once per call.
+*
+* Must be called inside an Angular injection context (e.g. a component
+* constructor or field initializer).
+*
+* @param experimentKey - Unique key identifying the experiment.
+* @param variants - The candidate variant names; the first one is the control.
+* @param weights - Optional relative weights, one per variant (e.g. `[9, 1]`).
+* @returns The {@link ExperimentState} for this session.
+*
+* @example
+* ```ts
+* export class HeroComponent {
+*   experiment = useExperiment('homepage-hero', ['a', 'b']);
+*   content = useIntlayer('hero');
+* }
+* ```
+*/
+const useExperiment = (experimentKey, variants, weights) => {
+	const variant = signal(variants[0] ?? "");
+	const isAssigned = signal(false);
+	if (process.env.INTLAYER_ANALYTICS_ENABLED === "false" || !isEnabled) return {
+		variant: variant.asReadonly(),
+		isAssigned: isAssigned.asReadonly()
+	};
+	const destroyRef = inject(DestroyRef, { optional: true });
+	let cancelled = false;
+	let initialized = false;
+	import("@intlayer/analytics").then(({ initAnalyticsClient }) => {
+		if (cancelled) return;
+		const client = initAnalyticsClient();
+		initialized = true;
+		const assigned = client.getVariant(experimentKey, variants, weights);
+		variant.set(assigned);
+		isAssigned.set(true);
+		client.trackContentExposure({
+			dictionaryKey: experimentKey,
+			keyPath: "",
+			nodeType: "experiment",
+			experimentKey,
+			variant: assigned
+		});
+	}).catch(() => {});
+	destroyRef?.onDestroy(() => {
+		cancelled = true;
+		import("@intlayer/analytics").then(({ stopAnalyticsClient }) => {
+			if (initialized) stopAnalyticsClient();
+		}).catch(() => {});
+	});
+	return {
+		variant: variant.asReadonly(),
+		isAssigned: isAssigned.asReadonly()
+	};
+};
+
+//#endregion
+export { useExperiment };
+//# sourceMappingURL=useExperiment.mjs.map

package/dist/esm/analytics/useExperiment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExperiment.mjs","names":[],"sources":["../../../src/analytics/useExperiment.ts"],"sourcesContent":["import { DestroyRef, inject, type Signal, signal } from '@angular/core';\nimport { isEnabled } from '@intlayer/analytics/isEnabled';\n\n/**\n * The state of an A/B experiment for the current session.\n */\nexport type ExperimentState = {\n  /**\n   * The variant assigned to this session. Until assignment resolves (and on\n   * the server, or when analytics is disabled), this is the first variant —\n   * treat the first variant as the control.\n   */\n  variant: Signal<string>;\n  /**\n   * `true` once the variant has been deterministically assigned and its\n   * exposure recorded. Useful to defer rendering when a flash of the control\n   * variant is not acceptable.\n   */\n  isAssigned: Signal<boolean>;\n};\n\n/**\n * Assigns this session to a variant of an A/B experiment and records the\n * exposure, scoped to `experimentKey`, so the backend can compute per-variant\n * conversion rates against `useConversion` events.\n *\n * Assignment is deterministic per session (no server round-trip, stable across\n * re-mounts). The exposure is recorded once per call.\n *\n * Must be called inside an Angular injection context (e.g. a component\n * constructor or field initializer).\n *\n * @param experimentKey - Unique key identifying the experiment.\n * @param variants - The candidate variant names; the first one is the control.\n * @param weights - Optional relative weights, one per variant (e.g. `[9, 1]`).\n * @returns The {@link ExperimentState} for this session.\n *\n * @example\n * ```ts\n * export class HeroComponent {\n *   experiment = useExperiment('homepage-hero', ['a', 'b']);\n *   content = useIntlayer('hero');\n * }\n * ```\n */\nexport const useExperiment = (\n  experimentKey: string,\n  variants: string[],\n  weights?: number[]\n): ExperimentState => {\n  const variant = signal(variants[0] ?? '');\n  const isAssigned = signal(false);\n\n  if (process.env.INTLAYER_ANALYTICS_ENABLED === 'false' || !isEnabled) {\n    return {\n      variant: variant.asReadonly(),\n      isAssigned: isAssigned.asReadonly(),\n    };\n  }\n\n  const destroyRef = inject(DestroyRef, { optional: true });\n\n  let cancelled = false;\n  let initialized = false;\n\n  import('@intlayer/analytics')\n    .then(({ initAnalyticsClient }) => {\n      if (cancelled) return;\n\n      // Ref-counted: guarantees a live client even when this call's import\n      // resolves before the provider's. Balanced by stop on destroy.\n      const client = initAnalyticsClient();\n      initialized = true;\n\n      const assigned = client.getVariant(experimentKey, variants, weights);\n      variant.set(assigned);\n      isAssigned.set(true);\n\n      // Experiment-level exposure — the denominator of the conversion rate.\n      client.trackContentExposure({\n        dictionaryKey: experimentKey,\n        keyPath: '',\n        nodeType: 'experiment',\n        experimentKey,\n        variant: assigned,\n      });\n    })\n    .catch(() => {\n      /* chunk failed to load — control variant stays in place */\n    });\n\n  destroyRef?.onDestroy(() => {\n    cancelled = true;\n    import('@intlayer/analytics')\n      .then(({ stopAnalyticsClient }) => {\n        if (initialized) stopAnalyticsClient();\n      })\n      .catch(() => {});\n  });\n\n  return { variant: variant.asReadonly(), isAssigned: isAssigned.asReadonly() };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,MAAa,iBACX,eACA,UACA,YACoB;CACpB,MAAM,UAAU,OAAO,SAAS,MAAM,GAAG;CACzC,MAAM,aAAa,OAAO,MAAM;AAEhC,KAAI,QAAQ,IAAI,+BAA+B,WAAW,CAAC,UACzD,QAAO;EACL,SAAS,QAAQ,YAAY;EAC7B,YAAY,WAAW,YAAY;EACpC;CAGH,MAAM,aAAa,OAAO,YAAY,EAAE,UAAU,MAAM,CAAC;CAEzD,IAAI,YAAY;CAChB,IAAI,cAAc;AAElB,QAAO,uBACJ,MAAM,EAAE,0BAA0B;AACjC,MAAI,UAAW;EAIf,MAAM,SAAS,qBAAqB;AACpC,gBAAc;EAEd,MAAM,WAAW,OAAO,WAAW,eAAe,UAAU,QAAQ;AACpE,UAAQ,IAAI,SAAS;AACrB,aAAW,IAAI,KAAK;AAGpB,SAAO,qBAAqB;GAC1B,eAAe;GACf,SAAS;GACT,UAAU;GACV;GACA,SAAS;GACV,CAAC;GACF,CACD,YAAY,GAEX;AAEJ,aAAY,gBAAgB;AAC1B,cAAY;AACZ,SAAO,uBACJ,MAAM,EAAE,0BAA0B;AACjC,OAAI,YAAa,sBAAqB;IACtC,CACD,YAAY,GAAG;GAClB;AAEF,QAAO;EAAE,SAAS,QAAQ,YAAY;EAAE,YAAY,WAAW,YAAY;EAAE"}

package/dist/esm/client/installIntlayer.mjs

@@ -1,4 +1,5 @@
 import { INTLAYER_TOKEN, IntlayerProvider, createIntlayerClient } from "./intlayerToken.mjs";
+import { provideIntlayerAnalytics } from "../analytics/useAnalytics.mjs";
 import { provideIntlayerEditor } from "../editor/useEditor.mjs";
 
 //#region src/client/installIntlayer.ts
@@ -27,10 +28,14 @@ import { provideIntlayerEditor } from "../editor/useEditor.mjs";
 */
 const provideIntlayer = (locale, isCookieEnabled = true) => {
 	const client = installIntlayer(locale, isCookieEnabled);
-	return [{
-		provide: INTLAYER_TOKEN,
-		useValue: client
-	}, provideIntlayerEditor(client)];
+	return [
+		{
+			provide: INTLAYER_TOKEN,
+			useValue: client
+		},
+		provideIntlayerEditor(client),
+		provideIntlayerAnalytics(client)
+	];
 };
 /**
 * Helper to install the Intlayer provider.

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

@@ -1 +1 @@
-{"version":3,"file":"installIntlayer.mjs","names":[],"sources":["../../../src/client/installIntlayer.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { provideIntlayerEditor } from '../editor/useEditor';\nimport {\n  createIntlayerClient,\n  INTLAYER_TOKEN,\n  IntlayerProvider,\n} from './intlayerToken';\n\nexport { createIntlayerClient, INTLAYER_TOKEN, IntlayerProvider };\n\n/**\n * Provides Intlayer to your Angular application.\n *\n * Registers the Intlayer locale token **and** automatically starts the Intlayer\n * editor client (when the editor is enabled) via `provideAppInitializer`.\n *\n * This is the recommended way to set up Intlayer in `app.config.ts`.\n *\n * @param locale - Initial locale to use.\n * @param isCookieEnabled - Whether to store the locale in cookies.\n * @returns An array of Angular providers for Intlayer.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { ApplicationConfig } from '@angular/core';\n * import { provideIntlayer } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer()],\n * };\n * ```\n */\nexport const provideIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  const client = installIntlayer(locale, isCookieEnabled);\n\n  return [\n    { provide: INTLAYER_TOKEN, useValue: client },\n    provideIntlayerEditor(client),\n  ];\n};\n\n/**\n * Helper to install the Intlayer provider.\n */\nexport const installIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  return createIntlayerClient(locale, isCookieEnabled);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAa,mBACX,QACA,kBAAkB,SACf;CACH,MAAM,SAAS,gBAAgB,QAAQ,gBAAgB;AAEvD,QAAO,CACL;EAAE,SAAS;EAAgB,UAAU;EAAQ,EAC7C,sBAAsB,OAAO,CAC9B;;;;;AAMH,MAAa,mBACX,QACA,kBAAkB,SACf;AACH,QAAO,qBAAqB,QAAQ,gBAAgB"}
+{"version":3,"file":"installIntlayer.mjs","names":[],"sources":["../../../src/client/installIntlayer.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { provideIntlayerAnalytics } from '../analytics/useAnalytics';\nimport { provideIntlayerEditor } from '../editor/useEditor';\nimport {\n  createIntlayerClient,\n  INTLAYER_TOKEN,\n  IntlayerProvider,\n} from './intlayerToken';\n\nexport { createIntlayerClient, INTLAYER_TOKEN, IntlayerProvider };\n\n/**\n * Provides Intlayer to your Angular application.\n *\n * Registers the Intlayer locale token **and** automatically starts the Intlayer\n * editor client (when the editor is enabled) via `provideAppInitializer`.\n *\n * This is the recommended way to set up Intlayer in `app.config.ts`.\n *\n * @param locale - Initial locale to use.\n * @param isCookieEnabled - Whether to store the locale in cookies.\n * @returns An array of Angular providers for Intlayer.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { ApplicationConfig } from '@angular/core';\n * import { provideIntlayer } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer()],\n * };\n * ```\n */\nexport const provideIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  const client = installIntlayer(locale, isCookieEnabled);\n\n  return [\n    { provide: INTLAYER_TOKEN, useValue: client },\n    provideIntlayerEditor(client),\n    provideIntlayerAnalytics(client),\n  ];\n};\n\n/**\n * Helper to install the Intlayer provider.\n */\nexport const installIntlayer = (\n  locale?: LocalesValues,\n  isCookieEnabled = true\n) => {\n  return createIntlayerClient(locale, isCookieEnabled);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,mBACX,QACA,kBAAkB,SACf;CACH,MAAM,SAAS,gBAAgB,QAAQ,gBAAgB;AAEvD,QAAO;EACL;GAAE,SAAS;GAAgB,UAAU;GAAQ;EAC7C,sBAAsB,OAAO;EAC7B,yBAAyB,OAAO;EACjC;;;;;AAMH,MAAa,mBACX,QACA,kBAAkB,SACf;AACH,QAAO,qBAAqB,QAAQ,gBAAgB"}

package/dist/esm/index.mjs

@@ -2,6 +2,9 @@ import { getPlugins, htmlPlugin, insertionPlugin, intlayerNodePlugins, markdownP
 import { getIntlayer } from "./getIntlayer.mjs";
 import { getDictionary } from "./getDictionary.mjs";
 import { INTLAYER_TOKEN, IntlayerProvider, createIntlayerClient } from "./client/intlayerToken.mjs";
+import { provideIntlayerAnalytics, useAnalytics } from "./analytics/useAnalytics.mjs";
+import { useConversion } from "./analytics/useConversion.mjs";
+import { useExperiment } from "./analytics/useExperiment.mjs";
 import { installIntlayer, provideIntlayer } from "./client/installIntlayer.mjs";
 import { useDictionary } from "./client/useDictionary.mjs";
 import { useDictionaryAsync } from "./client/useDictionaryAsync.mjs";
@@ -12,4 +15,4 @@ import { useLocale } from "./client/useLocale.mjs";
 import { usePathname } from "./client/usePathname.mjs";
 import { IntlayerNodeComponent } from "./UI/IntlayerNode.component.mjs";
 
-export { INTLAYER_TOKEN, IntlayerNodeComponent, IntlayerProvider, createIntlayerClient, getDictionary, getIntlayer, getPlugins, htmlPlugin, insertionPlugin, installIntlayer, intlayerNodePlugins, isUpdatableNode, markdownPlugin, markdownStringPlugin, provideIntlayer, useDictionary, useDictionaryAsync, useDictionaryDynamic, useIntlayer, useLoadDynamic, useLocale, usePathname };
+export { INTLAYER_TOKEN, IntlayerNodeComponent, IntlayerProvider, createIntlayerClient, getDictionary, getIntlayer, getPlugins, htmlPlugin, insertionPlugin, installIntlayer, intlayerNodePlugins, isUpdatableNode, markdownPlugin, markdownStringPlugin, provideIntlayer, provideIntlayerAnalytics, useAnalytics, useConversion, useDictionary, useDictionaryAsync, useDictionaryDynamic, useExperiment, useIntlayer, useLoadDynamic, useLocale, usePathname };

package/dist/esm/plugins.mjs

@@ -1,4 +1,5 @@
 import { renderIntlayerNode } from "./renderIntlayerNode.mjs";
+import { reportExposure } from "./analytics/exposureSink.mjs";
 import { ContentSelectorWrapperComponent } from "./editor/ContentSelector.component.mjs";
 import { conditionPlugin, enumerationPlugin, fallbackPlugin, filePlugin, genderPlugin, nestedPlugin, pluralPlugin, translationPlugin } from "@intlayer/core/interpreter";
 import { editor, internationalization } from "@intlayer/config/built";
@@ -37,18 +38,26 @@ const createRuntimeWithOverides = (baseRuntime, overrides) => ({
 const intlayerNodePlugins = {
 	id: "intlayer-node-plugin",
 	canHandle: (node) => typeof node === "bigint" || typeof node === "string" || typeof node === "number",
-	transform: (_node, { children, ...rest }) => renderIntlayerNode({
-		...rest,
-		value: children,
-		children: () => ({
-			component: process.env.INTLAYER_EDITOR_ENABLED === "false" || !editor.enabled ? children : ContentSelectorWrapperComponent,
-			props: {
-				dictionaryKey: rest.dictionaryKey,
-				keyPath: rest.keyPath
-			},
-			children
-		})
-	})
+	transform: (_node, { children, ...rest }) => {
+		if (process.env.INTLAYER_ANALYTICS_ENABLED !== "false") reportExposure({
+			dictionaryKey: rest.dictionaryKey,
+			keyPath: rest.keyPath,
+			locale: rest.locale,
+			nodeType: "text"
+		});
+		return renderIntlayerNode({
+			...rest,
+			value: children,
+			children: () => ({
+				component: process.env.INTLAYER_EDITOR_ENABLED === "false" || !editor.enabled ? children : ContentSelectorWrapperComponent,
+				props: {
+					dictionaryKey: rest.dictionaryKey,
+					keyPath: rest.keyPath
+				},
+				children
+			})
+		});
+	}
 };
 /** Markdown string plugin. Replaces string node with a component that render the markdown. */
 const markdownStringPlugin = process.env.INTLAYER_NODE_TYPE_MARKDOWN === "false" ? fallbackPlugin : {

package/dist/esm/plugins.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.mjs","names":[],"sources":["../../src/plugins.ts"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport type { MarkdownContent } from '@intlayer/core/markdown';\nimport { compile, getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type { HTMLContent, InsertionContent } from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport { ContentSelectorWrapperComponent } from './editor/ContentSelector.component';\nimport { renderIntlayerNode } from './renderIntlayerNode';\n\nlet _markdownInstall: {\n  htmlRuntime: any;\n  useMarkdown: () => { renderMarkdown: (s: string, components?: any) => any };\n} | null = null;\nif (\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN !== 'false' ||\n  process.env.INTLAYER_NODE_TYPE_HTML !== 'false'\n) {\n  void import('./markdown/installIntlayerMarkdown').then((m) => {\n    _markdownInstall = m as any;\n  });\n}\n\n/** ---------------------------------------------\n *  UTILS\n *  --------------------------------------------- */\n\nconst createRuntimeWithOverides = (baseRuntime: any, overrides: any) => ({\n  ...baseRuntime,\n  createElement: (tag: string, props: any, ...children: any[]) => {\n    const override = overrides?.[tag];\n\n    if (override) {\n      const newProps = { ...props, ...override };\n\n      // Merge class attributes intelligently\n      const originalClass = props?.class || props?.className;\n      const overrideClass = override.class || override.className;\n\n      if (originalClass && overrideClass) {\n        newProps.class = `${originalClass} ${overrideClass}`;\n        newProps.className = undefined;\n      }\n\n      return baseRuntime.createElement(tag, newProps, ...children);\n    }\n\n    return baseRuntime.createElement(tag, props, ...children);\n  },\n});\n\n/** ---------------------------------------------\n *  INTLAYER NODE PLUGIN\n *  --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\nexport interface IntlayerNode<T, P = {}> {\n  value: T;\n  children?: any;\n  additionalProps?: P;\n}\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (_node, { children, ...rest }) =>\n    renderIntlayerNode({\n      ...rest,\n      value: children,\n      children: () => ({\n        component:\n          process.env.INTLAYER_EDITOR_ENABLED === 'false' || !editor.enabled\n            ? children\n            : ContentSelectorWrapperComponent,\n        props: {\n          dictionaryKey: rest.dictionaryKey,\n          keyPath: rest.keyPath,\n        },\n        children: children,\n      }),\n    }),\n};\n\n/**\n * MARKDOWN PLUGIN\n */\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<string, { metadata: DeepTransformContent<string> }>\n  : never;\n\n/** Markdown string plugin. Replaces string node with a component that render the markdown. */\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const {\n            plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n            ...rest\n          } = props;\n\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, props) =>\n              renderIntlayerNode({\n                ...props,\n                value: metadataNode,\n                children: node,\n              }),\n          };\n\n          // Transform metadata while keeping the same structure\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const render = (components?: any) =>\n            renderIntlayerNode({\n              ...rest,\n              value: node,\n              children:\n                process.env.INTLAYER_EDITOR_ENABLED === 'false' ||\n                !editor.enabled\n                  ? () => {\n                      const { renderMarkdown } =\n                        _markdownInstall?.useMarkdown() ?? {\n                          renderMarkdown: () => node,\n                        };\n                      return renderMarkdown(node, components);\n                    }\n                  : () => ({\n                      component: ContentSelectorWrapperComponent,\n                      props: {\n                        dictionaryKey: rest.dictionaryKey,\n                        keyPath: rest.keyPath,\n                        ...components,\n                      },\n                      children: () => {\n                        const { renderMarkdown } =\n                          _markdownInstall?.useMarkdown() ?? {\n                            renderMarkdown: () => node,\n                          };\n                        return renderMarkdown(node, components);\n                      },\n                    }),\n              additionalProps: {\n                metadata: metadataNodes,\n              },\n            });\n\n          const createProxy = (element: any, components?: any) =>\n            new Proxy(element, {\n              get(target, prop, receiver) {\n                if (prop === 'value') {\n                  return node;\n                }\n                if (prop === 'metadata') {\n                  return metadataNodes;\n                }\n\n                if (prop === 'toString') {\n                  return () => {\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return node;\n                    const runtime = components\n                      ? createRuntimeWithOverides(htmlRuntime, components)\n                      : htmlRuntime;\n                    return compile(node, { runtime }) as string;\n                  };\n                }\n\n                if (prop === Symbol.toPrimitive) {\n                  return () => {\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return node;\n                    const runtime = components\n                      ? createRuntimeWithOverides(htmlRuntime, components)\n                      : htmlRuntime;\n                    return compile(node, { runtime }) as string;\n                  };\n                }\n\n                if (prop === 'use') {\n                  return (newComponents?: any) => {\n                    const mergedComponents = {\n                      ...components,\n                      ...newComponents,\n                    };\n                    return createProxy(\n                      render(mergedComponents),\n                      mergedComponents\n                    );\n                  };\n                }\n\n                return Reflect.get(target, prop, receiver);\n              },\n            }) as any;\n\n          return createProxy(render() as any);\n        },\n      };\n\nexport type MarkdownCond<T, _S, _L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  tags?: infer U;\n  metadata?: infer V;\n}\n  ? IntlayerNode<\n      M,\n      {\n        use: (components?: Record<keyof U, any>) => any;\n        metadata: DeepTransformContent<V>;\n      }\n    >\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.MARKDOWN,\n            },\n          ];\n\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n *  HTML PLUGIN\n *  --------------------------------------------- */\n\n/**\n * HTML conditional type.\n *\n * This ensures type safety:\n * - `html('<div>Hello <CustomComponent /></div>').use({ CustomComponent: ... })` - optional but typed\n */\nexport type HTMLPluginCond<T, _S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? IntlayerNode<\n      I,\n      {\n        use: (components?: Record<keyof U, any>) => any;\n      }\n    >\n  : never;\n\n/** HTML plugin. Replaces node with a function that takes components => IntlayerNode. */\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n\n        transform: (node: HTMLContent<string>, props) => {\n          const html = node[NodeTypes.HTML];\n          const { plugins, ...rest } = props;\n\n          // Type-safe render function that accepts properly typed components\n          const render = (userComponents?: any) =>\n            renderIntlayerNode({\n              ...rest,\n              value: html,\n              children:\n                process.env.INTLAYER_EDITOR_ENABLED === 'false' ||\n                !editor.enabled\n                  ? html\n                  : () => ({\n                      component: ContentSelectorWrapperComponent,\n                      props: {\n                        dictionaryKey: rest.dictionaryKey,\n                        keyPath: rest.keyPath,\n                        ...userComponents,\n                      },\n                      children: html,\n                    }),\n            });\n\n          const createProxy = (element: any, components?: any) =>\n            new Proxy(element, {\n              get(target, prop, receiver) {\n                if (prop === 'value') {\n                  return html;\n                }\n\n                if (prop === 'toString') {\n                  return () => {\n                    if (\n                      !components ||\n                      (typeof components === 'object' &&\n                        Object.keys(components).length === 0)\n                    ) {\n                      return String(html);\n                    }\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return String(html);\n                    const runtime = createRuntimeWithOverides(\n                      htmlRuntime,\n                      components\n                    );\n                    return compile(html, { runtime }) as string;\n                  };\n                }\n\n                if (prop === Symbol.toPrimitive) {\n                  return () => {\n                    if (\n                      !components ||\n                      (typeof components === 'object' &&\n                        Object.keys(components).length === 0)\n                    ) {\n                      return String(html);\n                    }\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return String(html);\n                    const runtime = createRuntimeWithOverides(\n                      htmlRuntime,\n                      components\n                    );\n                    return compile(html, { runtime }) as string;\n                  };\n                }\n\n                if (prop === 'use') {\n                  // Return a properly typed function based on custom components\n                  return (userComponents?: any) => {\n                    const mergedComponents = {\n                      ...components,\n                      ...userComponents,\n                    };\n                    return createProxy(\n                      render(mergedComponents),\n                      mergedComponents\n                    );\n                  };\n                }\n\n                return Reflect.get(target, prop, receiver);\n              },\n            }) as any;\n\n          return createProxy(render() as any);\n        },\n      };\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\n/**\n * Insertion conditional type.\n */\nexport type InsertionPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer _I;\n}\n  ? (args: Record<string, string | number>) => string\n  : never;\n\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props) => {\n          const { plugins, ...rest } = props;\n\n          // Return a function that performs the interpolation\n          const render = (args: Record<string, string | number> = {}) => {\n            let text = node[NodeTypes.INSERTION] as string;\n            if (args) {\n              Object.entries(args).forEach(([key, value]) => {\n                text = text.replace(\n                  new RegExp(`{{\\\\s*${key}\\\\s*}}`, 'g'),\n                  String(value)\n                );\n              });\n            }\n            return text;\n          };\n\n          return renderIntlayerNode({\n            ...rest,\n            value: render as any,\n            children: render,\n          });\n        },\n      };\n\nexport interface IInterpreterPluginAngular<T, S, L extends LocalesValues> {\n  angularIntlayerNode: IntlayerNodeCond<T>;\n  angularMarkdown: MarkdownCond<T, S, L>;\n  angularHtml: HTMLPluginCond<T, S, L>;\n  angularInsertion: InsertionPluginCond<T>;\n}\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the the `angular-intlayer` plugins will override the types of `intlayer` functions.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion' // Remove insertion type from core package\n> & {\n  angularIntlayerNode: true;\n  angularMarkdown: true;\n  angularHtml: true;\n  angularInsertion: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for Angular content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback: boolean = true\n): Plugins[] => {\n  const currentLocale = locale ?? internationalization.defaultLocale;\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    translationPlugin(\n      locale ?? internationalization.defaultLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(locale ?? internationalization.defaultLocale),\n    conditionPlugin,\n    nestedPlugin(locale ?? internationalization.defaultLocale),\n    filePlugin,\n    genderPlugin,\n    intlayerNodePlugins,\n    markdownPlugin,\n    htmlPlugin,\n    insertionPlugin,\n  ] as Plugins[];\n\n  pluginsCache.set(cacheKey, plugins);\n\n  return plugins;\n};\n"],"mappings":";;;;;;;;AA2BA,IAAI,mBAGO;AACX,IACE,QAAQ,IAAI,gCAAgC,WAC5C,QAAQ,IAAI,4BAA4B,QAExC,CAAK,OAAO,0CAAsC,MAAM,MAAM;AAC5D,oBAAmB;EACnB;;;;AAOJ,MAAM,6BAA6B,aAAkB,eAAoB;CACvE,GAAG;CACH,gBAAgB,KAAa,OAAY,GAAG,aAAoB;EAC9D,MAAM,WAAW,YAAY;AAE7B,MAAI,UAAU;GACZ,MAAM,WAAW;IAAE,GAAG;IAAO,GAAG;IAAU;GAG1C,MAAM,gBAAgB,OAAO,SAAS,OAAO;GAC7C,MAAM,gBAAgB,SAAS,SAAS,SAAS;AAEjD,OAAI,iBAAiB,eAAe;AAClC,aAAS,QAAQ,GAAG,cAAc,GAAG;AACrC,aAAS,YAAY;;AAGvB,UAAO,YAAY,cAAc,KAAK,UAAU,GAAG,SAAS;;AAG9D,SAAO,YAAY,cAAc,KAAK,OAAO,GAAG,SAAS;;CAE5D;;AAiBD,MAAa,sBAA+B;CAC1C,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,OAAO,SAAS;CAClB,YAAY,OAAO,EAAE,UAAU,GAAG,WAChC,mBAAmB;EACjB,GAAG;EACH,OAAO;EACP,iBAAiB;GACf,WACE,QAAQ,IAAI,4BAA4B,WAAW,CAAC,OAAO,UACvD,WACA;GACN,OAAO;IACL,eAAe,KAAK;IACpB,SAAS,KAAK;IACf;GACS;GACX;EACF,CAAC;CACL;;AAWD,MAAa,uBACX,QAAQ,IAAI,gCAAgC,UACxC,iBACA;CACE,IAAI;CACJ,YAAY,SAAS,OAAO,SAAS;CACrC,YAAY,MAAc,OAAO,sBAAsB;EACrD,MAAM,EACJ,SACA,GAAG,SACD;EAoBJ,MAAM,gBAAgB,kBAlBL,oBAAoB,KAAK,IAAI,EAAE,EAkBE;GAChD,SAAS,CAAC;IAhBV,IAAI;IACJ,YAAY,iBACV,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,aACxB,CAAC;IACH,YAAY,cAAc,UACxB,mBAAmB;KACjB,GAAG;KACH,OAAO;KACP,UAAU;KACX,CAAC;IAKqB,CAAC;GAC1B,eAAe,KAAK;GACpB,SAAS,EAAE;GACZ,CAAC;EAEF,MAAM,UAAU,eACd,mBAAmB;GACjB,GAAG;GACH,OAAO;GACP,UACE,QAAQ,IAAI,4BAA4B,WACxC,CAAC,OAAO,gBACE;IACJ,MAAM,EAAE,mBACN,kBAAkB,aAAa,IAAI,EACjC,sBAAsB,MACvB;AACH,WAAO,eAAe,MAAM,WAAW;cAElC;IACL,WAAW;IACX,OAAO;KACL,eAAe,KAAK;KACpB,SAAS,KAAK;KACd,GAAG;KACJ;IACD,gBAAgB;KACd,MAAM,EAAE,mBACN,kBAAkB,aAAa,IAAI,EACjC,sBAAsB,MACvB;AACH,YAAO,eAAe,MAAM,WAAW;;IAE1C;GACP,iBAAiB,EACf,UAAU,eACX;GACF,CAAC;EAEJ,MAAM,eAAe,SAAc,eACjC,IAAI,MAAM,SAAS,EACjB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,SAAS,QACX,QAAO;AAET,OAAI,SAAS,WACX,QAAO;AAGT,OAAI,SAAS,WACX,cAAa;IACX,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO;AAIrC,WAAO,QAAQ,MAAM,EAAE,SAHP,aACZ,0BAA0B,aAAa,WAAW,GAClD,aAC4B,CAAC;;AAIrC,OAAI,SAAS,OAAO,YAClB,cAAa;IACX,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO;AAIrC,WAAO,QAAQ,MAAM,EAAE,SAHP,aACZ,0BAA0B,aAAa,WAAW,GAClD,aAC4B,CAAC;;AAIrC,OAAI,SAAS,MACX,SAAQ,kBAAwB;IAC9B,MAAM,mBAAmB;KACvB,GAAG;KACH,GAAG;KACJ;AACD,WAAO,YACL,OAAO,iBAAiB,EACxB,iBACD;;AAIL,UAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;KAE7C,CAAC;AAEJ,SAAO,YAAY,QAAQ,CAAQ;;CAEtC;AAiBP,MAAa,iBACX,QAAQ,IAAI,gCAAgC,UACxC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAuB,OAAO,sBAAsB;EAC9D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EACE,MAAM,UAAU,UACjB,CACF;EAED,MAAM,WAAW,KAAK,UAAU;AAEhC,SAAO,kBAAkB,UAAU;GACjC,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,sBAAsB,GAAI,MAAM,WAAW,EAAE,CAAE;GAC1D,CAAC;;CAEL;;AA0BP,MAAa,aACX,QAAQ,IAAI,4BAA4B,UACpC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAE3D,YAAY,MAA2B,UAAU;EAC/C,MAAM,OAAO,KAAK,UAAU;EAC5B,MAAM,EAAE,SAAS,GAAG,SAAS;EAG7B,MAAM,UAAU,mBACd,mBAAmB;GACjB,GAAG;GACH,OAAO;GACP,UACE,QAAQ,IAAI,4BAA4B,WACxC,CAAC,OAAO,UACJ,cACO;IACL,WAAW;IACX,OAAO;KACL,eAAe,KAAK;KACpB,SAAS,KAAK;KACd,GAAG;KACJ;IACD,UAAU;IACX;GACR,CAAC;EAEJ,MAAM,eAAe,SAAc,eACjC,IAAI,MAAM,SAAS,EACjB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,SAAS,QACX,QAAO;AAGT,OAAI,SAAS,WACX,cAAa;AACX,QACE,CAAC,cACA,OAAO,eAAe,YACrB,OAAO,KAAK,WAAW,CAAC,WAAW,EAErC,QAAO,OAAO,KAAK;IAErB,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO,OAAO,KAAK;AAKjD,WAAO,QAAQ,MAAM,EAAE,SAJP,0BACd,aACA,WAE4B,EAAE,CAAC;;AAIrC,OAAI,SAAS,OAAO,YAClB,cAAa;AACX,QACE,CAAC,cACA,OAAO,eAAe,YACrB,OAAO,KAAK,WAAW,CAAC,WAAW,EAErC,QAAO,OAAO,KAAK;IAErB,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO,OAAO,KAAK;AAKjD,WAAO,QAAQ,MAAM,EAAE,SAJP,0BACd,aACA,WAE4B,EAAE,CAAC;;AAIrC,OAAI,SAAS,MAEX,SAAQ,mBAAyB;IAC/B,MAAM,mBAAmB;KACvB,GAAG;KACH,GAAG;KACJ;AACD,WAAO,YACL,OAAO,iBAAiB,EACxB,iBACD;;AAIL,UAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;KAE7C,CAAC;AAEJ,SAAO,YAAY,QAAQ,CAAQ;;CAEtC;AAgBP,MAAa,kBACX,QAAQ,IAAI,iCAAiC,UACzC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAwB,UAAU;EAC5C,MAAM,EAAE,SAAS,GAAG,SAAS;EAG7B,MAAM,UAAU,OAAwC,EAAE,KAAK;GAC7D,IAAI,OAAO,KAAK,UAAU;AAC1B,OAAI,KACF,QAAO,QAAQ,KAAK,CAAC,SAAS,CAAC,KAAK,WAAW;AAC7C,WAAO,KAAK,QACV,IAAI,OAAO,SAAS,IAAI,SAAS,IAAI,EACrC,OAAO,MAAM,CACd;KACD;AAEJ,UAAO;;AAGT,SAAO,mBAAmB;GACxB,GAAG;GACH,OAAO;GACP,UAAU;GACX,CAAC;;CAEL;AA6BP,MAAM,+BAAe,IAAI,KAAwB;;;;;AAMjD,MAAa,cACX,QACA,WAAoB,SACN;CAEd,MAAM,WAAW,GADK,UAAU,qBAAqB,cACnB,GAAG;AAErC,KAAI,aAAa,IAAI,SAAS,CAC5B,QAAO,aAAa,IAAI,SAAS;CAGnC,MAAM,UAAU;EACd,kBACE,UAAU,qBAAqB,eAC/B,WAAW,qBAAqB,gBAAgB,OACjD;EACD;EACA,aAAa,UAAU,qBAAqB,cAAc;EAC1D;EACA,aAAa,UAAU,qBAAqB,cAAc;EAC1D;EACA;EACA;EACA;EACA;EACA;EACD;AAED,cAAa,IAAI,UAAU,QAAQ;AAEnC,QAAO"}
+{"version":3,"file":"plugins.mjs","names":[],"sources":["../../src/plugins.ts"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport type { MarkdownContent } from '@intlayer/core/markdown';\nimport { compile, getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type { HTMLContent, InsertionContent } from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport { reportExposure } from './analytics/exposureSink';\nimport { ContentSelectorWrapperComponent } from './editor/ContentSelector.component';\nimport { renderIntlayerNode } from './renderIntlayerNode';\n\nlet _markdownInstall: {\n  htmlRuntime: any;\n  useMarkdown: () => { renderMarkdown: (s: string, components?: any) => any };\n} | null = null;\nif (\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN !== 'false' ||\n  process.env.INTLAYER_NODE_TYPE_HTML !== 'false'\n) {\n  void import('./markdown/installIntlayerMarkdown').then((m) => {\n    _markdownInstall = m as any;\n  });\n}\n\n/** ---------------------------------------------\n *  UTILS\n *  --------------------------------------------- */\n\nconst createRuntimeWithOverides = (baseRuntime: any, overrides: any) => ({\n  ...baseRuntime,\n  createElement: (tag: string, props: any, ...children: any[]) => {\n    const override = overrides?.[tag];\n\n    if (override) {\n      const newProps = { ...props, ...override };\n\n      // Merge class attributes intelligently\n      const originalClass = props?.class || props?.className;\n      const overrideClass = override.class || override.className;\n\n      if (originalClass && overrideClass) {\n        newProps.class = `${originalClass} ${overrideClass}`;\n        newProps.className = undefined;\n      }\n\n      return baseRuntime.createElement(tag, newProps, ...children);\n    }\n\n    return baseRuntime.createElement(tag, props, ...children);\n  },\n});\n\n/** ---------------------------------------------\n *  INTLAYER NODE PLUGIN\n *  --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\nexport interface IntlayerNode<T, P = {}> {\n  value: T;\n  children?: any;\n  additionalProps?: P;\n}\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (_node, { children, ...rest }) => {\n    // Node-level analytics: record which content is resolved for display.\n    // No-op (and dead-code-eliminated) when analytics is disabled.\n    if (process.env.INTLAYER_ANALYTICS_ENABLED !== 'false') {\n      reportExposure({\n        dictionaryKey: rest.dictionaryKey,\n        keyPath: rest.keyPath,\n        locale: rest.locale,\n        nodeType: 'text',\n      });\n    }\n\n    return renderIntlayerNode({\n      ...rest,\n      value: children,\n      children: () => ({\n        component:\n          process.env.INTLAYER_EDITOR_ENABLED === 'false' || !editor.enabled\n            ? children\n            : ContentSelectorWrapperComponent,\n        props: {\n          dictionaryKey: rest.dictionaryKey,\n          keyPath: rest.keyPath,\n        },\n        children: children,\n      }),\n    });\n  },\n};\n\n/**\n * MARKDOWN PLUGIN\n */\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<string, { metadata: DeepTransformContent<string> }>\n  : never;\n\n/** Markdown string plugin. Replaces string node with a component that render the markdown. */\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const {\n            plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n            ...rest\n          } = props;\n\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, props) =>\n              renderIntlayerNode({\n                ...props,\n                value: metadataNode,\n                children: node,\n              }),\n          };\n\n          // Transform metadata while keeping the same structure\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const render = (components?: any) =>\n            renderIntlayerNode({\n              ...rest,\n              value: node,\n              children:\n                process.env.INTLAYER_EDITOR_ENABLED === 'false' ||\n                !editor.enabled\n                  ? () => {\n                      const { renderMarkdown } =\n                        _markdownInstall?.useMarkdown() ?? {\n                          renderMarkdown: () => node,\n                        };\n                      return renderMarkdown(node, components);\n                    }\n                  : () => ({\n                      component: ContentSelectorWrapperComponent,\n                      props: {\n                        dictionaryKey: rest.dictionaryKey,\n                        keyPath: rest.keyPath,\n                        ...components,\n                      },\n                      children: () => {\n                        const { renderMarkdown } =\n                          _markdownInstall?.useMarkdown() ?? {\n                            renderMarkdown: () => node,\n                          };\n                        return renderMarkdown(node, components);\n                      },\n                    }),\n              additionalProps: {\n                metadata: metadataNodes,\n              },\n            });\n\n          const createProxy = (element: any, components?: any) =>\n            new Proxy(element, {\n              get(target, prop, receiver) {\n                if (prop === 'value') {\n                  return node;\n                }\n                if (prop === 'metadata') {\n                  return metadataNodes;\n                }\n\n                if (prop === 'toString') {\n                  return () => {\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return node;\n                    const runtime = components\n                      ? createRuntimeWithOverides(htmlRuntime, components)\n                      : htmlRuntime;\n                    return compile(node, { runtime }) as string;\n                  };\n                }\n\n                if (prop === Symbol.toPrimitive) {\n                  return () => {\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return node;\n                    const runtime = components\n                      ? createRuntimeWithOverides(htmlRuntime, components)\n                      : htmlRuntime;\n                    return compile(node, { runtime }) as string;\n                  };\n                }\n\n                if (prop === 'use') {\n                  return (newComponents?: any) => {\n                    const mergedComponents = {\n                      ...components,\n                      ...newComponents,\n                    };\n                    return createProxy(\n                      render(mergedComponents),\n                      mergedComponents\n                    );\n                  };\n                }\n\n                return Reflect.get(target, prop, receiver);\n              },\n            }) as any;\n\n          return createProxy(render() as any);\n        },\n      };\n\nexport type MarkdownCond<T, _S, _L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  tags?: infer U;\n  metadata?: infer V;\n}\n  ? IntlayerNode<\n      M,\n      {\n        use: (components?: Record<keyof U, any>) => any;\n        metadata: DeepTransformContent<V>;\n      }\n    >\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.MARKDOWN,\n            },\n          ];\n\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n *  HTML PLUGIN\n *  --------------------------------------------- */\n\n/**\n * HTML conditional type.\n *\n * This ensures type safety:\n * - `html('<div>Hello <CustomComponent /></div>').use({ CustomComponent: ... })` - optional but typed\n */\nexport type HTMLPluginCond<T, _S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? IntlayerNode<\n      I,\n      {\n        use: (components?: Record<keyof U, any>) => any;\n      }\n    >\n  : never;\n\n/** HTML plugin. Replaces node with a function that takes components => IntlayerNode. */\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n\n        transform: (node: HTMLContent<string>, props) => {\n          const html = node[NodeTypes.HTML];\n          const { plugins, ...rest } = props;\n\n          // Type-safe render function that accepts properly typed components\n          const render = (userComponents?: any) =>\n            renderIntlayerNode({\n              ...rest,\n              value: html,\n              children:\n                process.env.INTLAYER_EDITOR_ENABLED === 'false' ||\n                !editor.enabled\n                  ? html\n                  : () => ({\n                      component: ContentSelectorWrapperComponent,\n                      props: {\n                        dictionaryKey: rest.dictionaryKey,\n                        keyPath: rest.keyPath,\n                        ...userComponents,\n                      },\n                      children: html,\n                    }),\n            });\n\n          const createProxy = (element: any, components?: any) =>\n            new Proxy(element, {\n              get(target, prop, receiver) {\n                if (prop === 'value') {\n                  return html;\n                }\n\n                if (prop === 'toString') {\n                  return () => {\n                    if (\n                      !components ||\n                      (typeof components === 'object' &&\n                        Object.keys(components).length === 0)\n                    ) {\n                      return String(html);\n                    }\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return String(html);\n                    const runtime = createRuntimeWithOverides(\n                      htmlRuntime,\n                      components\n                    );\n                    return compile(html, { runtime }) as string;\n                  };\n                }\n\n                if (prop === Symbol.toPrimitive) {\n                  return () => {\n                    if (\n                      !components ||\n                      (typeof components === 'object' &&\n                        Object.keys(components).length === 0)\n                    ) {\n                      return String(html);\n                    }\n                    const htmlRuntime = _markdownInstall?.htmlRuntime;\n                    if (!htmlRuntime || !compile) return String(html);\n                    const runtime = createRuntimeWithOverides(\n                      htmlRuntime,\n                      components\n                    );\n                    return compile(html, { runtime }) as string;\n                  };\n                }\n\n                if (prop === 'use') {\n                  // Return a properly typed function based on custom components\n                  return (userComponents?: any) => {\n                    const mergedComponents = {\n                      ...components,\n                      ...userComponents,\n                    };\n                    return createProxy(\n                      render(mergedComponents),\n                      mergedComponents\n                    );\n                  };\n                }\n\n                return Reflect.get(target, prop, receiver);\n              },\n            }) as any;\n\n          return createProxy(render() as any);\n        },\n      };\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\n/**\n * Insertion conditional type.\n */\nexport type InsertionPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer _I;\n}\n  ? (args: Record<string, string | number>) => string\n  : never;\n\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props) => {\n          const { plugins, ...rest } = props;\n\n          // Return a function that performs the interpolation\n          const render = (args: Record<string, string | number> = {}) => {\n            let text = node[NodeTypes.INSERTION] as string;\n            if (args) {\n              Object.entries(args).forEach(([key, value]) => {\n                text = text.replace(\n                  new RegExp(`{{\\\\s*${key}\\\\s*}}`, 'g'),\n                  String(value)\n                );\n              });\n            }\n            return text;\n          };\n\n          return renderIntlayerNode({\n            ...rest,\n            value: render as any,\n            children: render,\n          });\n        },\n      };\n\nexport interface IInterpreterPluginAngular<T, S, L extends LocalesValues> {\n  angularIntlayerNode: IntlayerNodeCond<T>;\n  angularMarkdown: MarkdownCond<T, S, L>;\n  angularHtml: HTMLPluginCond<T, S, L>;\n  angularInsertion: InsertionPluginCond<T>;\n}\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the the `angular-intlayer` plugins will override the types of `intlayer` functions.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion' // Remove insertion type from core package\n> & {\n  angularIntlayerNode: true;\n  angularMarkdown: true;\n  angularHtml: true;\n  angularInsertion: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for Angular content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback: boolean = true\n): Plugins[] => {\n  const currentLocale = locale ?? internationalization.defaultLocale;\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    translationPlugin(\n      locale ?? internationalization.defaultLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(locale ?? internationalization.defaultLocale),\n    conditionPlugin,\n    nestedPlugin(locale ?? internationalization.defaultLocale),\n    filePlugin,\n    genderPlugin,\n    intlayerNodePlugins,\n    markdownPlugin,\n    htmlPlugin,\n    insertionPlugin,\n  ] as Plugins[];\n\n  pluginsCache.set(cacheKey, plugins);\n\n  return plugins;\n};\n"],"mappings":";;;;;;;;;AA4BA,IAAI,mBAGO;AACX,IACE,QAAQ,IAAI,gCAAgC,WAC5C,QAAQ,IAAI,4BAA4B,QAExC,CAAK,OAAO,0CAAsC,MAAM,MAAM;AAC5D,oBAAmB;EACnB;;;;AAOJ,MAAM,6BAA6B,aAAkB,eAAoB;CACvE,GAAG;CACH,gBAAgB,KAAa,OAAY,GAAG,aAAoB;EAC9D,MAAM,WAAW,YAAY;AAE7B,MAAI,UAAU;GACZ,MAAM,WAAW;IAAE,GAAG;IAAO,GAAG;IAAU;GAG1C,MAAM,gBAAgB,OAAO,SAAS,OAAO;GAC7C,MAAM,gBAAgB,SAAS,SAAS,SAAS;AAEjD,OAAI,iBAAiB,eAAe;AAClC,aAAS,QAAQ,GAAG,cAAc,GAAG;AACrC,aAAS,YAAY;;AAGvB,UAAO,YAAY,cAAc,KAAK,UAAU,GAAG,SAAS;;AAG9D,SAAO,YAAY,cAAc,KAAK,OAAO,GAAG,SAAS;;CAE5D;;AAiBD,MAAa,sBAA+B;CAC1C,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,OAAO,SAAS;CAClB,YAAY,OAAO,EAAE,UAAU,GAAG,WAAW;AAG3C,MAAI,QAAQ,IAAI,+BAA+B,QAC7C,gBAAe;GACb,eAAe,KAAK;GACpB,SAAS,KAAK;GACd,QAAQ,KAAK;GACb,UAAU;GACX,CAAC;AAGJ,SAAO,mBAAmB;GACxB,GAAG;GACH,OAAO;GACP,iBAAiB;IACf,WACE,QAAQ,IAAI,4BAA4B,WAAW,CAAC,OAAO,UACvD,WACA;IACN,OAAO;KACL,eAAe,KAAK;KACpB,SAAS,KAAK;KACf;IACS;IACX;GACF,CAAC;;CAEL;;AAWD,MAAa,uBACX,QAAQ,IAAI,gCAAgC,UACxC,iBACA;CACE,IAAI;CACJ,YAAY,SAAS,OAAO,SAAS;CACrC,YAAY,MAAc,OAAO,sBAAsB;EACrD,MAAM,EACJ,SACA,GAAG,SACD;EAoBJ,MAAM,gBAAgB,kBAlBL,oBAAoB,KAAK,IAAI,EAAE,EAkBE;GAChD,SAAS,CAAC;IAhBV,IAAI;IACJ,YAAY,iBACV,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,aACxB,CAAC;IACH,YAAY,cAAc,UACxB,mBAAmB;KACjB,GAAG;KACH,OAAO;KACP,UAAU;KACX,CAAC;IAKqB,CAAC;GAC1B,eAAe,KAAK;GACpB,SAAS,EAAE;GACZ,CAAC;EAEF,MAAM,UAAU,eACd,mBAAmB;GACjB,GAAG;GACH,OAAO;GACP,UACE,QAAQ,IAAI,4BAA4B,WACxC,CAAC,OAAO,gBACE;IACJ,MAAM,EAAE,mBACN,kBAAkB,aAAa,IAAI,EACjC,sBAAsB,MACvB;AACH,WAAO,eAAe,MAAM,WAAW;cAElC;IACL,WAAW;IACX,OAAO;KACL,eAAe,KAAK;KACpB,SAAS,KAAK;KACd,GAAG;KACJ;IACD,gBAAgB;KACd,MAAM,EAAE,mBACN,kBAAkB,aAAa,IAAI,EACjC,sBAAsB,MACvB;AACH,YAAO,eAAe,MAAM,WAAW;;IAE1C;GACP,iBAAiB,EACf,UAAU,eACX;GACF,CAAC;EAEJ,MAAM,eAAe,SAAc,eACjC,IAAI,MAAM,SAAS,EACjB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,SAAS,QACX,QAAO;AAET,OAAI,SAAS,WACX,QAAO;AAGT,OAAI,SAAS,WACX,cAAa;IACX,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO;AAIrC,WAAO,QAAQ,MAAM,EAAE,SAHP,aACZ,0BAA0B,aAAa,WAAW,GAClD,aAC4B,CAAC;;AAIrC,OAAI,SAAS,OAAO,YAClB,cAAa;IACX,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO;AAIrC,WAAO,QAAQ,MAAM,EAAE,SAHP,aACZ,0BAA0B,aAAa,WAAW,GAClD,aAC4B,CAAC;;AAIrC,OAAI,SAAS,MACX,SAAQ,kBAAwB;IAC9B,MAAM,mBAAmB;KACvB,GAAG;KACH,GAAG;KACJ;AACD,WAAO,YACL,OAAO,iBAAiB,EACxB,iBACD;;AAIL,UAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;KAE7C,CAAC;AAEJ,SAAO,YAAY,QAAQ,CAAQ;;CAEtC;AAiBP,MAAa,iBACX,QAAQ,IAAI,gCAAgC,UACxC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAuB,OAAO,sBAAsB;EAC9D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EACE,MAAM,UAAU,UACjB,CACF;EAED,MAAM,WAAW,KAAK,UAAU;AAEhC,SAAO,kBAAkB,UAAU;GACjC,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,sBAAsB,GAAI,MAAM,WAAW,EAAE,CAAE;GAC1D,CAAC;;CAEL;;AA0BP,MAAa,aACX,QAAQ,IAAI,4BAA4B,UACpC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAE3D,YAAY,MAA2B,UAAU;EAC/C,MAAM,OAAO,KAAK,UAAU;EAC5B,MAAM,EAAE,SAAS,GAAG,SAAS;EAG7B,MAAM,UAAU,mBACd,mBAAmB;GACjB,GAAG;GACH,OAAO;GACP,UACE,QAAQ,IAAI,4BAA4B,WACxC,CAAC,OAAO,UACJ,cACO;IACL,WAAW;IACX,OAAO;KACL,eAAe,KAAK;KACpB,SAAS,KAAK;KACd,GAAG;KACJ;IACD,UAAU;IACX;GACR,CAAC;EAEJ,MAAM,eAAe,SAAc,eACjC,IAAI,MAAM,SAAS,EACjB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,SAAS,QACX,QAAO;AAGT,OAAI,SAAS,WACX,cAAa;AACX,QACE,CAAC,cACA,OAAO,eAAe,YACrB,OAAO,KAAK,WAAW,CAAC,WAAW,EAErC,QAAO,OAAO,KAAK;IAErB,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO,OAAO,KAAK;AAKjD,WAAO,QAAQ,MAAM,EAAE,SAJP,0BACd,aACA,WAE4B,EAAE,CAAC;;AAIrC,OAAI,SAAS,OAAO,YAClB,cAAa;AACX,QACE,CAAC,cACA,OAAO,eAAe,YACrB,OAAO,KAAK,WAAW,CAAC,WAAW,EAErC,QAAO,OAAO,KAAK;IAErB,MAAM,cAAc,kBAAkB;AACtC,QAAI,CAAC,eAAe,CAAC,QAAS,QAAO,OAAO,KAAK;AAKjD,WAAO,QAAQ,MAAM,EAAE,SAJP,0BACd,aACA,WAE4B,EAAE,CAAC;;AAIrC,OAAI,SAAS,MAEX,SAAQ,mBAAyB;IAC/B,MAAM,mBAAmB;KACvB,GAAG;KACH,GAAG;KACJ;AACD,WAAO,YACL,OAAO,iBAAiB,EACxB,iBACD;;AAIL,UAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;KAE7C,CAAC;AAEJ,SAAO,YAAY,QAAQ,CAAQ;;CAEtC;AAgBP,MAAa,kBACX,QAAQ,IAAI,iCAAiC,UACzC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAwB,UAAU;EAC5C,MAAM,EAAE,SAAS,GAAG,SAAS;EAG7B,MAAM,UAAU,OAAwC,EAAE,KAAK;GAC7D,IAAI,OAAO,KAAK,UAAU;AAC1B,OAAI,KACF,QAAO,QAAQ,KAAK,CAAC,SAAS,CAAC,KAAK,WAAW;AAC7C,WAAO,KAAK,QACV,IAAI,OAAO,SAAS,IAAI,SAAS,IAAI,EACrC,OAAO,MAAM,CACd;KACD;AAEJ,UAAO;;AAGT,SAAO,mBAAmB;GACxB,GAAG;GACH,OAAO;GACP,UAAU;GACX,CAAC;;CAEL;AA6BP,MAAM,+BAAe,IAAI,KAAwB;;;;;AAMjD,MAAa,cACX,QACA,WAAoB,SACN;CAEd,MAAM,WAAW,GADK,UAAU,qBAAqB,cACnB,GAAG;AAErC,KAAI,aAAa,IAAI,SAAS,CAC5B,QAAO,aAAa,IAAI,SAAS;CAGnC,MAAM,UAAU;EACd,kBACE,UAAU,qBAAqB,eAC/B,WAAW,qBAAqB,gBAAgB,OACjD;EACD;EACA,aAAa,UAAU,qBAAqB,cAAc;EAC1D;EACA,aAAa,UAAU,qBAAqB,cAAc;EAC1D;EACA;EACA;EACA;EACA;EACA;EACD;AAED,cAAa,IAAI,UAAU,QAAQ;AAEnC,QAAO"}

package/dist/types/analytics/exposureSink.d.ts

@@ -0,0 +1,33 @@
+import { KeyPath } from "@intlayer/types/keyPath";
+
+//#region src/analytics/exposureSink.d.ts
+/**
+ * Node metadata reported for a content exposure. Kept dependency-free (types
+ * only) so the interpreter hot path in `plugins.ts` never statically imports
+ * `@intlayer/analytics` — the package stays optional and tree-shakeable.
+ */
+type ExposureInput = {
+  dictionaryKey: string;
+  keyPath: KeyPath[];
+  locale?: string;
+  nodeType?: string;
+};
+/** Consumer of exposure reports, installed by `useAnalytics` after init. */
+type ExposureSink = (input: ExposureInput) => void;
+/**
+ * Installs (or clears) the exposure sink. `useAnalytics` sets this once the
+ * analytics client has loaded, and clears it on unmount.
+ *
+ * @param next - The sink to install, or `null` to clear.
+ */
+declare const setExposureSink: (next: ExposureSink | null) => void;
+/**
+ * Forwards a content exposure to the installed sink. A cheap null-check when
+ * analytics is not running, so it is safe to call from every node resolution.
+ *
+ * @param input - The node metadata to report.
+ */
+declare const reportExposure: (input: ExposureInput) => void;
+//#endregion
+export { ExposureInput, ExposureSink, reportExposure, setExposureSink };
+//# sourceMappingURL=exposureSink.d.ts.map

package/dist/types/analytics/exposureSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposureSink.d.ts","names":[],"sources":["../../../src/analytics/exposureSink.ts"],"mappings":";;;;;AAOA;;;KAAY,aAAA;EACV,aAAA;EACA,OAAA,EAAS,OAAA;EACT,MAAA;EACA,QAAA;AAAA;;KAIU,YAAA,IAAgB,KAAA,EAAO,aAAA;AAAnC;;;;;AAUA;AAVA,cAUa,eAAA,GAAmB,IAAA,EAAM,YAAA;;;;AAUtC;;;cAAa,cAAA,GAAkB,KAAA,EAAO,aAAA"}

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

@@ -0,0 +1,4 @@
+import { provideIntlayerAnalytics, useAnalytics } from "./useAnalytics.js";
+import { ConversionParams, useConversion } from "./useConversion.js";
+import { ExperimentState, useExperiment } from "./useExperiment.js";
+export { ConversionParams, ExperimentState, provideIntlayerAnalytics, useAnalytics, useConversion, useExperiment };

package/dist/types/analytics/useAnalytics.d.ts

@@ -0,0 +1,38 @@
+import { IntlayerProvider } from "../client/intlayerToken.js";
+import * as _$_angular_core0 from "@angular/core";
+
+//#region src/analytics/useAnalytics.d.ts
+/**
+ * Initializes the Intlayer analytics client singleton when analytics is
+ * enabled (mirrors {@link useEditor}). Records an initial page view, keeps the
+ * client aware of the current locale, and wires node-level content exposures.
+ *
+ * Must be called inside an Angular injection context (e.g. a component
+ * constructor, `provideAppInitializer`, or `runInInjectionContext`).
+ *
+ * @param client - The IntlayerProvider instance to sync locale from.
+ *   When omitted the function injects `INTLAYER_TOKEN` from the DI tree,
+ *   so it still works when called directly from a component.
+ */
+declare const useAnalytics: (client?: IntlayerProvider | null) => void;
+/**
+ * Angular provider that wires `useAnalytics` into the application
+ * initialisation phase via `provideAppInitializer`.
+ *
+ * `provideIntlayer()` already calls this internally, so you only need this
+ * function when you want to manage providers individually.
+ *
+ * @example
+ * ```ts
+ * // app.config.ts
+ * import { provideIntlayer, provideIntlayerAnalytics } from 'angular-intlayer';
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [provideIntlayer(), provideIntlayerAnalytics()],
+ * };
+ * ```
+ */
+declare const provideIntlayerAnalytics: (client?: IntlayerProvider | null) => _$_angular_core0.EnvironmentProviders;
+//#endregion
+export { provideIntlayerAnalytics, useAnalytics };
+//# sourceMappingURL=useAnalytics.d.ts.map

package/dist/types/analytics/useAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.d.ts","names":[],"sources":["../../../src/analytics/useAnalytics.ts"],"mappings":";;;;;;;AA4BA;;;;;AAkGA;;;;cAlGa,YAAA,GAAgB,MAAA,GAAS,gBAAA;;;;;;;;;;;;;;;;;;cAkGzB,wBAAA,GAA4B,MAAA,GAAS,gBAAA,YAAgB,gBAAA,CAAO,oBAAA"}

package/dist/types/analytics/useConversion.d.ts

@@ -0,0 +1,34 @@
+//#region src/analytics/useConversion.d.ts
+/**
+ * Parameters describing a conversion to record.
+ */
+type ConversionParams = {
+  /** The experiment this conversion is attributed to. */experimentKey: string; /** The variant the session was assigned. */
+  variant: string; /** The goal reached (e.g. `"signup"`, `"cta_click"`). */
+  goal: string; /** Optional numeric value (e.g. revenue). */
+  value?: number;
+};
+/**
+ * Returns a `trackConversion` callback for content A/B testing. Safe to call
+ * from any component: it resolves to a no-op when analytics is disabled or the
+ * client has not been initialized yet.
+ *
+ * @example
+ * ```ts
+ * export class CtaComponent {
+ *   trackConversion = useConversion();
+ *
+ *   onClick() {
+ *     this.trackConversion({
+ *       experimentKey: 'homepage-hero',
+ *       variant: 'b',
+ *       goal: 'cta_click',
+ *     });
+ *   }
+ * }
+ * ```
+ */
+declare const useConversion: () => (params: ConversionParams) => void;
+//#endregion
+export { ConversionParams, useConversion };
+//# sourceMappingURL=useConversion.d.ts.map

package/dist/types/analytics/useConversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversion.d.ts","names":[],"sources":["../../../src/analytics/useConversion.ts"],"mappings":";;AAKA;;KAAY,gBAAA;EAAgB,uDAE1B,aAAA,UAEA;EAAA,OAAA,UAIA;EAFA,IAAA,UAEK;EAAL,KAAA;AAAA;;;;;;;;;;;;;;;;;;;;;cAuBW,aAAA,SACH,MAAA,EAAQ,gBAAA"}

package/dist/types/analytics/useExperiment.d.ts

@@ -0,0 +1,48 @@
+import { Signal } from "@angular/core";
+
+//#region src/analytics/useExperiment.d.ts
+/**
+ * The state of an A/B experiment for the current session.
+ */
+type ExperimentState = {
+  /**
+   * The variant assigned to this session. Until assignment resolves (and on
+   * the server, or when analytics is disabled), this is the first variant —
+   * treat the first variant as the control.
+   */
+  variant: Signal<string>;
+  /**
+   * `true` once the variant has been deterministically assigned and its
+   * exposure recorded. Useful to defer rendering when a flash of the control
+   * variant is not acceptable.
+   */
+  isAssigned: Signal<boolean>;
+};
+/**
+ * Assigns this session to a variant of an A/B experiment and records the
+ * exposure, scoped to `experimentKey`, so the backend can compute per-variant
+ * conversion rates against `useConversion` events.
+ *
+ * Assignment is deterministic per session (no server round-trip, stable across
+ * re-mounts). The exposure is recorded once per call.
+ *
+ * Must be called inside an Angular injection context (e.g. a component
+ * constructor or field initializer).
+ *
+ * @param experimentKey - Unique key identifying the experiment.
+ * @param variants - The candidate variant names; the first one is the control.
+ * @param weights - Optional relative weights, one per variant (e.g. `[9, 1]`).
+ * @returns The {@link ExperimentState} for this session.
+ *
+ * @example
+ * ```ts
+ * export class HeroComponent {
+ *   experiment = useExperiment('homepage-hero', ['a', 'b']);
+ *   content = useIntlayer('hero');
+ * }
+ * ```
+ */
+declare const useExperiment: (experimentKey: string, variants: string[], weights?: number[]) => ExperimentState;
+//#endregion
+export { ExperimentState, useExperiment };
+//# sourceMappingURL=useExperiment.d.ts.map

package/dist/types/analytics/useExperiment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExperiment.d.ts","names":[],"sources":["../../../src/analytics/useExperiment.ts"],"mappings":";;;;;AAMA;KAAY,eAAA;;;;;;EAMV,OAAA,EAAS,MAAA;EAMS;;AA2BpB;;;EA3BE,UAAA,EAAY,MAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cA2BD,aAAA,GACX,aAAA,UACA,QAAA,YACA,OAAA,gBACC,eAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"installIntlayer.d.ts","names":[],"sources":["../../../src/client/installIntlayer.ts"],"mappings":";;;;;;;AAiCA;;;;;;;;;;;;;;;;;;;;;cAAa,eAAA,GACX,MAAA,GAAS,aAAA,EACT,eAAA,gBADsB,gBAAA,CACA,oBAAA;;;;;;;cAaX,eAAA,GACX,MAAA,GAAS,aAAA,EACT,eAAA,eAAsB,gBAAA"}
+{"version":3,"file":"installIntlayer.d.ts","names":[],"sources":["../../../src/client/installIntlayer.ts"],"mappings":";;;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;cAAa,eAAA,GACX,MAAA,GAAS,aAAA,EACT,eAAA,gBADsB,gBAAA,CACA,oBAAA;;;;;;;cAcX,eAAA,GACX,MAAA,GAAS,aAAA,EACT,eAAA,eAAsB,gBAAA"}

package/dist/types/index.d.ts

@@ -1,5 +1,8 @@
 import { IntlayerNodeComponent } from "./UI/IntlayerNode.component.js";
 import { INTLAYER_TOKEN, IntlayerProvider, createIntlayerClient } from "./client/intlayerToken.js";
+import { provideIntlayerAnalytics, useAnalytics } from "./analytics/useAnalytics.js";
+import { ConversionParams, useConversion } from "./analytics/useConversion.js";
+import { ExperimentState, useExperiment } from "./analytics/useExperiment.js";
 import { installIntlayer, provideIntlayer } from "./client/installIntlayer.js";
 import { DeepTransformContent, HTMLPluginCond, IInterpreterPluginAngular, IInterpreterPluginState, InsertionPluginCond, IntlayerNode, IntlayerNodeCond, MarkdownCond, MarkdownStringCond, getPlugins, htmlPlugin, insertionPlugin, intlayerNodePlugins, markdownPlugin, markdownStringPlugin } from "./plugins.js";
 import { useDictionary } from "./client/useDictionary.js";
@@ -18,5 +21,5 @@ declare module '@intlayer/core/interpreter' {
   interface IInterpreterPlugin<T, S, L extends LocalesValues> extends IInterpreterPluginAngular<T, S, L> {}
 }
 //#endregion
-export { DeepTransformContent, HTMLPluginCond, IInterpreterPluginAngular, IInterpreterPluginState, INTLAYER_TOKEN, InsertionPluginCond, IntlayerNode, IntlayerNodeComponent, IntlayerNodeCond, IntlayerProvider, MarkdownCond, MarkdownStringCond, UseLocaleProps, UseLocaleResult, createIntlayerClient, getDictionary, getIntlayer, getPlugins, htmlPlugin, insertionPlugin, installIntlayer, intlayerNodePlugins, isUpdatableNode, markdownPlugin, markdownStringPlugin, provideIntlayer, useDictionary, useDictionaryAsync, useDictionaryDynamic, useIntlayer, useLoadDynamic, useLocale, usePathname };
+export { ConversionParams, DeepTransformContent, ExperimentState, HTMLPluginCond, IInterpreterPluginAngular, IInterpreterPluginState, INTLAYER_TOKEN, InsertionPluginCond, IntlayerNode, IntlayerNodeComponent, IntlayerNodeCond, IntlayerProvider, MarkdownCond, MarkdownStringCond, UseLocaleProps, UseLocaleResult, createIntlayerClient, getDictionary, getIntlayer, getPlugins, htmlPlugin, insertionPlugin, installIntlayer, intlayerNodePlugins, isUpdatableNode, markdownPlugin, markdownStringPlugin, provideIntlayer, provideIntlayerAnalytics, useAnalytics, useConversion, useDictionary, useDictionaryAsync, useDictionaryDynamic, useExperiment, useIntlayer, useLoadDynamic, useLocale, usePathname };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;YAIY,kBAAA,iBAAmC,aAAA,UACnC,yBAAA,CAA0B,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;YAIY,kBAAA,iBAAmC,aAAA,UACnC,yBAAA,CAA0B,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","names":[],"sources":["../../src/plugins.ts"],"mappings":";;;;;;;;AAwEA;KAAY,gBAAA,MAAsB,CAAA,2BAC9B,YAAA,CAAa,CAAA;AAAA,UAGA,YAAA;EACf,KAAA,EAAO,CAAA;EACP,QAAA;EACA,eAAA,GAAkB,CAAA;AAAA;;cAIP,mBAAA,EAAqB,OAAA;;;;KA4BtB,kBAAA,MAAwB,CAAA,kBAChC,YAAA;EAAuB,QAAA,EAAU,oBAAA;AAAA;;cAIxB,oBAAA,EAAsB,OAAA;AAAA,KA2HvB,YAAA,mBAA+B,aAAA,IAAiB,CAAA;EAC1D,QAAA,EAAU,QAAA;EAAA,CACT,SAAA,CAAU,QAAA;EACX,IAAA;EACA,QAAA;AAAA,IAEE,YAAA,CACE,CAAA;EAEE,GAAA,GAAM,UAAA,GAAa,MAAA,OAAa,CAAA;EAChC,QAAA,EAAU,oBAAA,CAAqB,CAAA;AAAA;AAAA,cAK1B,cAAA,EAAgB,OAAA;AA3K7B;;;;;AA4BA;;;;KAmLY,cAAA,cAA4B,CAAA;EACtC,QAAA,EAAU,QAAA;EAAA,CACT,SAAA,CAAU,IAAA;EACX,IAAA;AAAA,IAEE,YAAA,CACE,CAAA;EAEE,GAAA,GAAM,UAAA,GAAa,MAAA,OAAa,CAAA;AAAA;;cAM3B,UAAA,EAAY,OAAA;;;AA5LzB;;;;KAsSY,mBAAA,MAAyB,CAAA;EACnC,QAAA,EAAU,QAAA;EAAA,CACT,SAAA,CAAU,SAAA;AAAA,KAER,IAAA,EAAM,MAAA;AAAA,cAGE,eAAA,EAAiB,OAAA;AAAA,UAgCb,yBAAA,iBAA0C,aAAA;EACzD,mBAAA,EAAqB,gBAAA,CAAiB,CAAA;EACtC,eAAA,EAAiB,YAAA,CAAa,CAAA,EAAG,CAAA,EAAG,CAAA;EACpC,WAAA,EAAa,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,CAAA;EAClC,gBAAA,EAAkB,mBAAA,CAAoB,CAAA;AAAA;;;;;;KAQ5B,uBAAA,GAA0B,IAAA,CACpC,yBAAA;EAGA,mBAAA;EACA,eAAA;EACA,WAAA;EACA,gBAAA;AAAA;AAAA,KAGU,oBAAA,cAEA,aAAA,GAAgB,eAAA,IACxB,sBAAA,CAAyB,CAAA,EAAG,uBAAA,EAAyB,CAAA;;;;;cAQ5C,UAAA,GACX,MAAA,GAAS,aAAA,EACT,QAAA,eACC,OAAA"}
+{"version":3,"file":"plugins.d.ts","names":[],"sources":["../../src/plugins.ts"],"mappings":";;;;;;;;AAyEA;KAAY,gBAAA,MAAsB,CAAA,2BAC9B,YAAA,CAAa,CAAA;AAAA,UAGA,YAAA;EACf,KAAA,EAAO,CAAA;EACP,QAAA;EACA,eAAA,GAAkB,CAAA;AAAA;;cAIP,mBAAA,EAAqB,OAAA;;;;KAwCtB,kBAAA,MAAwB,CAAA,kBAChC,YAAA;EAAuB,QAAA,EAAU,oBAAA;AAAA;;cAIxB,oBAAA,EAAsB,OAAA;AAAA,KA2HvB,YAAA,mBAA+B,aAAA,IAAiB,CAAA;EAC1D,QAAA,EAAU,QAAA;EAAA,CACT,SAAA,CAAU,QAAA;EACX,IAAA;EACA,QAAA;AAAA,IAEE,YAAA,CACE,CAAA;EAEE,GAAA,GAAM,UAAA,GAAa,MAAA,OAAa,CAAA;EAChC,QAAA,EAAU,oBAAA,CAAqB,CAAA;AAAA;AAAA,cAK1B,cAAA,EAAgB,OAAA;AAvL7B;;;;;AAwCA;;;;KAmLY,cAAA,cAA4B,CAAA;EACtC,QAAA,EAAU,QAAA;EAAA,CACT,SAAA,CAAU,IAAA;EACX,IAAA;AAAA,IAEE,YAAA,CACE,CAAA;EAEE,GAAA,GAAM,UAAA,GAAa,MAAA,OAAa,CAAA;AAAA;;cAM3B,UAAA,EAAY,OAAA;;;AA5LzB;;;;KAsSY,mBAAA,MAAyB,CAAA;EACnC,QAAA,EAAU,QAAA;EAAA,CACT,SAAA,CAAU,SAAA;AAAA,KAER,IAAA,EAAM,MAAA;AAAA,cAGE,eAAA,EAAiB,OAAA;AAAA,UAgCb,yBAAA,iBAA0C,aAAA;EACzD,mBAAA,EAAqB,gBAAA,CAAiB,CAAA;EACtC,eAAA,EAAiB,YAAA,CAAa,CAAA,EAAG,CAAA,EAAG,CAAA;EACpC,WAAA,EAAa,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,CAAA;EAClC,gBAAA,EAAkB,mBAAA,CAAoB,CAAA;AAAA;;;;;;KAQ5B,uBAAA,GAA0B,IAAA,CACpC,yBAAA;EAGA,mBAAA;EACA,eAAA;EACA,WAAA;EACA,gBAAA;AAAA;AAAA,KAGU,oBAAA,cAEA,aAAA,GAAgB,eAAA,IACxB,sBAAA,CAAyB,CAAA,EAAG,uBAAA,EAAyB,CAAA;;;;;cAQ5C,UAAA,GACX,MAAA,GAAS,aAAA,EACT,QAAA,eACC,OAAA"}

package/dist/types/webpack/mergeConfig.d.ts

@@ -1,4 +1,4 @@
-import * as _$webpack from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/@types+webpack@5.28.5+9e3c06e9a1a2edab/node_modules/@types/webpack/index.js";
+import * as _$webpack from "/Users/aymericpineau/Documents/intlayer_/node_modules/.bun/@types+webpack@5.28.5+347853244a8d2414/node_modules/@types/webpack/index.js";
 
 //#region src/webpack/mergeConfig.d.ts
 declare const mergeConfig: (baseConfig: _$webpack.Configuration) => _$webpack.Configuration;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-intlayer",
-  "version": "9.0.0-canary.15",
+  "version": "9.0.0-canary.17",
   "private": false,
   "description": "Easily internationalize i18n your Angular applications with type-safe multilingual content management.",
   "keywords": [
@@ -119,13 +119,13 @@
     "@babel/core": "^7.26.9",
     "@babel/plugin-syntax-import-attributes": "7.28.6",
     "@babel/preset-env": "7.29.2",
-    "@intlayer/config": "9.0.0-canary.15",
-    "@intlayer/core": "9.0.0-canary.15",
-    "@intlayer/dictionaries-entry": "9.0.0-canary.15",
-    "@intlayer/editor": "9.0.0-canary.15",
-    "@intlayer/engine": "9.0.0-canary.15",
-    "@intlayer/types": "9.0.0-canary.15",
-    "@intlayer/webpack": "9.0.0-canary.15",
+    "@intlayer/config": "9.0.0-canary.17",
+    "@intlayer/core": "9.0.0-canary.17",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.17",
+    "@intlayer/editor": "9.0.0-canary.17",
+    "@intlayer/engine": "9.0.0-canary.17",
+    "@intlayer/types": "9.0.0-canary.17",
+    "@intlayer/webpack": "9.0.0-canary.17",
     "babel-loader": "10.1.1",
     "defu": "6.1.7"
   },
@@ -141,7 +141,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.21.10",
     "typescript": "6.0.3",
-    "vitest": "4.1.9"
+    "vitest": "4.1.10"
   },
   "peerDependencies": {
     "@angular/common": ">=15",
@@ -154,6 +154,9 @@
       "optional": true
     }
   },
+  "optionalDependencies": {
+    "@intlayer/analytics": "9.0.0-canary.17"
+  },
   "engines": {
     "node": ">=14.18"
   },