angular-intlayer 9.0.0-canary.14 → 9.0.0-canary.16

package/dist/cjs/analytics/exposureSink.cjs

@@ -0,0 +1,27 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/analytics/exposureSink.ts
+let sink = null;
+/**
+* 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.
+*/
+const setExposureSink = (next) => {
+	sink = next;
+};
+/**
+* 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.
+*/
+const reportExposure = (input) => {
+	sink?.(input);
+};
+
+//#endregion
+exports.reportExposure = reportExposure;
+exports.setExposureSink = setExposureSink;
+//# sourceMappingURL=exposureSink.cjs.map

package/dist/cjs/analytics/exposureSink.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposureSink.cjs","names":[],"sources":["../../../src/analytics/exposureSink.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';\n\n/**\n * Node metadata reported for a content exposure. Kept dependency-free (types\n * only) so the interpreter hot path in `plugins.ts` never statically imports\n * `@intlayer/analytics` — the package stays optional and tree-shakeable.\n */\nexport type ExposureInput = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  locale?: string;\n  nodeType?: string;\n};\n\n/** Consumer of exposure reports, installed by `useAnalytics` after init. */\nexport type ExposureSink = (input: ExposureInput) => void;\n\nlet sink: ExposureSink | null = null;\n\n/**\n * Installs (or clears) the exposure sink. `useAnalytics` sets this once the\n * analytics client has loaded, and clears it on unmount.\n *\n * @param next - The sink to install, or `null` to clear.\n */\nexport const setExposureSink = (next: ExposureSink | null): void => {\n  sink = next;\n};\n\n/**\n * Forwards a content exposure to the installed sink. A cheap null-check when\n * analytics is not running, so it is safe to call from every node resolution.\n *\n * @param input - The node metadata to report.\n */\nexport const reportExposure = (input: ExposureInput): void => {\n  sink?.(input);\n};\n"],"mappings":";;;AAiBA,IAAI,OAA4B;;;;;;;AAQhC,MAAa,mBAAmB,SAAoC;AAClE,QAAO;;;;;;;;AAST,MAAa,kBAAkB,UAA+B;AAC5D,QAAO,MAAM"}

package/dist/cjs/analytics/index.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_analytics_useAnalytics = require('./useAnalytics.cjs');
+const require_analytics_useConversion = require('./useConversion.cjs');
+const require_analytics_useExperiment = require('./useExperiment.cjs');
+
+exports.provideIntlayerAnalytics = require_analytics_useAnalytics.provideIntlayerAnalytics;
+exports.useAnalytics = require_analytics_useAnalytics.useAnalytics;
+exports.useConversion = require_analytics_useConversion.useConversion;
+exports.useExperiment = require_analytics_useExperiment.useExperiment;

package/dist/cjs/analytics/useAnalytics.cjs

@@ -0,0 +1,85 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_analytics_exposureSink = require('./exposureSink.cjs');
+const require_client_intlayerToken = require('../client/intlayerToken.cjs');
+let _angular_core = require("@angular/core");
+let _intlayer_analytics_isEnabled = require("@intlayer/analytics/isEnabled");
+
+//#region src/analytics/useAnalytics.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.
+*/
+const useAnalytics = (client) => {
+	if (process.env.INTLAYER_ANALYTICS_ENABLED === "false" || !_intlayer_analytics_isEnabled.isEnabled) return;
+	const destroyRef = (0, _angular_core.inject)(_angular_core.DestroyRef, { optional: true });
+	const injector = (0, _angular_core.inject)(_angular_core.Injector);
+	const resolvedClient = client ?? (0, _angular_core.inject)(require_client_intlayerToken.INTLAYER_TOKEN, { optional: true });
+	const analyticsClient = (0, _angular_core.signal)(null);
+	let stopped = false;
+	let initialized = false;
+	import("@intlayer/analytics").then(({ initAnalyticsClient, buildContentExposure }) => {
+		if (stopped) return;
+		const clientInstance = initAnalyticsClient();
+		initialized = true;
+		const currentLocale = resolvedClient?.locale();
+		if (currentLocale) clientInstance.setLocale(currentLocale);
+		clientInstance.trackPageView({ reason: "initial" });
+		require_analytics_exposureSink.setExposureSink((input) => clientInstance.trackContentExposure(buildContentExposure(input)));
+		analyticsClient.set(clientInstance);
+	}).catch(() => {});
+	let previousLocale;
+	const effectRef = (0, _angular_core.runInInjectionContext)(injector, () => (0, _angular_core.effect)(() => {
+		const clientInstance = analyticsClient();
+		const locale = resolvedClient?.locale();
+		if (!clientInstance || !locale) return;
+		if (previousLocale === void 0) {
+			previousLocale = locale;
+			return;
+		}
+		if (previousLocale === locale) return;
+		previousLocale = locale;
+		clientInstance.setLocale(locale);
+		clientInstance.trackPageView({ reason: "locale_change" });
+	}));
+	destroyRef?.onDestroy(() => {
+		stopped = true;
+		effectRef.destroy();
+		analyticsClient.set(null);
+		require_analytics_exposureSink.setExposureSink(null);
+		import("@intlayer/analytics").then(({ stopAnalyticsClient }) => {
+			if (initialized) stopAnalyticsClient();
+		}).catch(() => {});
+	});
+};
+/**
+* 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()],
+* };
+* ```
+*/
+const provideIntlayerAnalytics = (client) => (0, _angular_core.provideAppInitializer)(() => useAnalytics(client));
+
+//#endregion
+exports.provideIntlayerAnalytics = provideIntlayerAnalytics;
+exports.useAnalytics = useAnalytics;
+//# sourceMappingURL=useAnalytics.cjs.map

package/dist/cjs/analytics/useAnalytics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.cjs","names":["isEnabled","DestroyRef","Injector","INTLAYER_TOKEN"],"sources":["../../../src/analytics/useAnalytics.ts"],"sourcesContent":["import {\n  DestroyRef,\n  effect,\n  Injector,\n  inject,\n  provideAppInitializer,\n  runInInjectionContext,\n  signal,\n} from '@angular/core';\nimport type { AnalyticsClient } from '@intlayer/analytics';\nimport { isEnabled } from '@intlayer/analytics/isEnabled';\n// Import from the standalone token file to avoid a circular dependency:\n//   installIntlayer.ts → useAnalytics.ts → ../client → installIntlayer.ts\nimport { INTLAYER_TOKEN, type IntlayerProvider } from '../client/intlayerToken';\nimport { setExposureSink } from './exposureSink';\n\n/**\n * Initializes the Intlayer analytics client singleton when analytics is\n * enabled (mirrors {@link useEditor}). Records an initial page view, keeps the\n * client aware of the current locale, and wires node-level content exposures.\n *\n * Must be called inside an Angular injection context (e.g. a component\n * constructor, `provideAppInitializer`, or `runInInjectionContext`).\n *\n * @param client - The IntlayerProvider instance to sync locale from.\n *   When omitted the function injects `INTLAYER_TOKEN` from the DI tree,\n *   so it still works when called directly from a component.\n */\nexport const useAnalytics = (client?: IntlayerProvider | null): void => {\n  if (process.env.INTLAYER_ANALYTICS_ENABLED === 'false' || !isEnabled) return;\n\n  const destroyRef = inject(DestroyRef, { optional: true });\n  const injector = inject(Injector);\n\n  // Resolve the client: use the passed-in reference or fall back to injection.\n  const resolvedClient =\n    client ??\n    inject<IntlayerProvider>(INTLAYER_TOKEN, { optional: true } as any);\n\n  // `analyticsClient` signal is set once the async import resolves.\n  // Using a signal lets an `effect()` react to it becoming available.\n  const analyticsClient = signal<AnalyticsClient | null>(null);\n\n  // Guard: prevents the async callback from acting after the view is destroyed.\n  let stopped = false;\n  // Tracks whether initAnalyticsClient actually ran, so teardown never calls\n  // stopAnalyticsClient for an init that was cancelled — that would decrement\n  // the shared reference count once too many.\n  let initialized = false;\n\n  import('@intlayer/analytics')\n    .then(({ initAnalyticsClient, buildContentExposure }) => {\n      if (stopped) return;\n\n      const clientInstance = initAnalyticsClient();\n      initialized = true;\n\n      const currentLocale = resolvedClient?.locale();\n      if (currentLocale) clientInstance.setLocale(currentLocale);\n      clientInstance.trackPageView({ reason: 'initial' });\n\n      // Route node-level exposures (from the interpreter plugins) into the\n      // client. Serialization happens here, off the hot render path.\n      setExposureSink((input) =>\n        clientInstance.trackContentExposure(buildContentExposure(input))\n      );\n\n      analyticsClient.set(clientInstance);\n    })\n    .catch(() => {\n      /* chunk failed to load — analytics stays a no-op */\n    });\n\n  // Locale switches are a real signal — record them as page views.\n  let previousLocale: string | undefined;\n  const effectRef = runInInjectionContext(injector, () =>\n    effect(() => {\n      const clientInstance = analyticsClient();\n      const locale = resolvedClient?.locale();\n\n      if (!clientInstance || !locale) return;\n\n      if (previousLocale === undefined) {\n        // First run after init — the initial page view already covered it.\n        previousLocale = locale;\n        return;\n      }\n      if (previousLocale === locale) return;\n\n      previousLocale = locale;\n      clientInstance.setLocale(locale);\n      clientInstance.trackPageView({ reason: 'locale_change' });\n    })\n  );\n\n  // Tear down on destroy\n  destroyRef?.onDestroy(() => {\n    stopped = true;\n    effectRef.destroy();\n    analyticsClient.set(null);\n    setExposureSink(null);\n    import('@intlayer/analytics')\n      .then(({ stopAnalyticsClient }) => {\n        if (initialized) stopAnalyticsClient();\n      })\n      .catch(() => {});\n  });\n};\n\n/**\n * Angular provider that wires `useAnalytics` into the application\n * initialisation phase via `provideAppInitializer`.\n *\n * `provideIntlayer()` already calls this internally, so you only need this\n * function when you want to manage providers individually.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { provideIntlayer, provideIntlayerAnalytics } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer(), provideIntlayerAnalytics()],\n * };\n * ```\n */\nexport const provideIntlayerAnalytics = (client?: IntlayerProvider | null) =>\n  provideAppInitializer(() => useAnalytics(client));\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,gBAAgB,WAA2C;AACtE,KAAI,QAAQ,IAAI,+BAA+B,WAAW,CAACA,wCAAW;CAEtE,MAAM,uCAAoBC,0BAAY,EAAE,UAAU,MAAM,CAAC;CACzD,MAAM,qCAAkBC,uBAAS;CAGjC,MAAM,iBACJ,oCACyBC,6CAAgB,EAAE,UAAU,MAAM,CAAQ;CAIrE,MAAM,4CAAiD,KAAK;CAG5D,IAAI,UAAU;CAId,IAAI,cAAc;AAElB,QAAO,uBACJ,MAAM,EAAE,qBAAqB,2BAA2B;AACvD,MAAI,QAAS;EAEb,MAAM,iBAAiB,qBAAqB;AAC5C,gBAAc;EAEd,MAAM,gBAAgB,gBAAgB,QAAQ;AAC9C,MAAI,cAAe,gBAAe,UAAU,cAAc;AAC1D,iBAAe,cAAc,EAAE,QAAQ,WAAW,CAAC;AAInD,kDAAiB,UACf,eAAe,qBAAqB,qBAAqB,MAAM,CAAC,CACjE;AAED,kBAAgB,IAAI,eAAe;GACnC,CACD,YAAY,GAEX;CAGJ,IAAI;CACJ,MAAM,qDAAkC,gDACzB;EACX,MAAM,iBAAiB,iBAAiB;EACxC,MAAM,SAAS,gBAAgB,QAAQ;AAEvC,MAAI,CAAC,kBAAkB,CAAC,OAAQ;AAEhC,MAAI,mBAAmB,QAAW;AAEhC,oBAAiB;AACjB;;AAEF,MAAI,mBAAmB,OAAQ;AAE/B,mBAAiB;AACjB,iBAAe,UAAU,OAAO;AAChC,iBAAe,cAAc,EAAE,QAAQ,iBAAiB,CAAC;GACzD,CACH;AAGD,aAAY,gBAAgB;AAC1B,YAAU;AACV,YAAU,SAAS;AACnB,kBAAgB,IAAI,KAAK;AACzB,iDAAgB,KAAK;AACrB,SAAO,uBACJ,MAAM,EAAE,0BAA0B;AACjC,OAAI,YAAa,sBAAqB;IACtC,CACD,YAAY,GAAG;GAClB;;;;;;;;;;;;;;;;;;;AAoBJ,MAAa,4BAA4B,0DACX,aAAa,OAAO,CAAC"}

package/dist/cjs/analytics/useConversion.cjs

@@ -0,0 +1,37 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _intlayer_analytics_isEnabled = require("@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" || !_intlayer_analytics_isEnabled.isEnabled) return;
+		import("@intlayer/analytics").then(({ getGlobalAnalyticsClient }) => {
+			getGlobalAnalyticsClient()?.trackConversion(params);
+		}).catch(() => {});
+	};
+};
+
+//#endregion
+exports.useConversion = useConversion;
+//# sourceMappingURL=useConversion.cjs.map

package/dist/cjs/analytics/useConversion.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversion.cjs","names":["isEnabled"],"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,CAACA,wCACzD;AAGF,SAAO,uBACJ,MAAM,EAAE,+BAA+B;AACtC,6BAA0B,EAAE,gBAAgB,OAAO;IACnD,CACD,YAAY,GAAG"}

package/dist/cjs/analytics/useExperiment.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _angular_core = require("@angular/core");
+let _intlayer_analytics_isEnabled = require("@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 = (0, _angular_core.signal)(variants[0] ?? "");
+	const isAssigned = (0, _angular_core.signal)(false);
+	if (process.env.INTLAYER_ANALYTICS_ENABLED === "false" || !_intlayer_analytics_isEnabled.isEnabled) return {
+		variant: variant.asReadonly(),
+		isAssigned: isAssigned.asReadonly()
+	};
+	const destroyRef = (0, _angular_core.inject)(_angular_core.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
+exports.useExperiment = useExperiment;
+//# sourceMappingURL=useExperiment.cjs.map

package/dist/cjs/analytics/useExperiment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExperiment.cjs","names":["isEnabled","DestroyRef"],"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,oCAAiB,SAAS,MAAM,GAAG;CACzC,MAAM,uCAAoB,MAAM;AAEhC,KAAI,QAAQ,IAAI,+BAA+B,WAAW,CAACA,wCACzD,QAAO;EACL,SAAS,QAAQ,YAAY;EAC7B,YAAY,WAAW,YAAY;EACpC;CAGH,MAAM,uCAAoBC,0BAAY,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/cjs/client/installIntlayer.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_client_intlayerToken = require('./intlayerToken.cjs');
+const require_analytics_useAnalytics = require('../analytics/useAnalytics.cjs');
 const require_editor_useEditor = require('../editor/useEditor.cjs');
 
 //#region src/client/installIntlayer.ts
@@ -28,10 +29,14 @@ const require_editor_useEditor = require('../editor/useEditor.cjs');
 */
 const provideIntlayer = (locale, isCookieEnabled = true) => {
 	const client = installIntlayer(locale, isCookieEnabled);
-	return [{
-		provide: require_client_intlayerToken.INTLAYER_TOKEN,
-		useValue: client
-	}, require_editor_useEditor.provideIntlayerEditor(client)];
+	return [
+		{
+			provide: require_client_intlayerToken.INTLAYER_TOKEN,
+			useValue: client
+		},
+		require_editor_useEditor.provideIntlayerEditor(client),
+		require_analytics_useAnalytics.provideIntlayerAnalytics(client)
+	];
 };
 /**
 * Helper to install the Intlayer provider.

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

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

package/dist/cjs/index.cjs

@@ -3,6 +3,9 @@ const require_plugins = require('./plugins.cjs');
 const require_getIntlayer = require('./getIntlayer.cjs');
 const require_getDictionary = require('./getDictionary.cjs');
 const require_client_intlayerToken = require('./client/intlayerToken.cjs');
+const require_analytics_useAnalytics = require('./analytics/useAnalytics.cjs');
+const require_analytics_useConversion = require('./analytics/useConversion.cjs');
+const require_analytics_useExperiment = require('./analytics/useExperiment.cjs');
 const require_client_installIntlayer = require('./client/installIntlayer.cjs');
 const require_client_useDictionary = require('./client/useDictionary.cjs');
 const require_client_useDictionaryAsync = require('./client/useDictionaryAsync.cjs');
@@ -33,9 +36,13 @@ exports.isUpdatableNode = require_client_useIntlayer.isUpdatableNode;
 exports.markdownPlugin = require_plugins.markdownPlugin;
 exports.markdownStringPlugin = require_plugins.markdownStringPlugin;
 exports.provideIntlayer = require_client_installIntlayer.provideIntlayer;
+exports.provideIntlayerAnalytics = require_analytics_useAnalytics.provideIntlayerAnalytics;
+exports.useAnalytics = require_analytics_useAnalytics.useAnalytics;
+exports.useConversion = require_analytics_useConversion.useConversion;
 exports.useDictionary = require_client_useDictionary.useDictionary;
 exports.useDictionaryAsync = require_client_useDictionaryAsync.useDictionaryAsync;
 exports.useDictionaryDynamic = require_client_useDictionaryDynamic.useDictionaryDynamic;
+exports.useExperiment = require_analytics_useExperiment.useExperiment;
 exports.useIntlayer = require_client_useIntlayer.useIntlayer;
 exports.useLoadDynamic = require_client_useLoadDynamic.useLoadDynamic;
 exports.useLocale = require_client_useLocale.useLocale;

package/dist/cjs/plugins.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_renderIntlayerNode = require('./renderIntlayerNode.cjs');
+const require_analytics_exposureSink = require('./analytics/exposureSink.cjs');
 const require_editor_ContentSelector_component = require('./editor/ContentSelector.component.cjs');
 let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 let _intlayer_config_built = require("@intlayer/config/built");
@@ -40,18 +41,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 }) => require_renderIntlayerNode.renderIntlayerNode({
-		...rest,
-		value: children,
-		children: () => ({
-			component: process.env.INTLAYER_EDITOR_ENABLED === "false" || !_intlayer_config_built.editor.enabled ? children : require_editor_ContentSelector_component.ContentSelectorWrapperComponent,
-			props: {
-				dictionaryKey: rest.dictionaryKey,
-				keyPath: rest.keyPath
-			},
-			children
-		})
-	})
+	transform: (_node, { children, ...rest }) => {
+		if (process.env.INTLAYER_ANALYTICS_ENABLED !== "false") require_analytics_exposureSink.reportExposure({
+			dictionaryKey: rest.dictionaryKey,
+			keyPath: rest.keyPath,
+			locale: rest.locale,
+			nodeType: "text"
+		});
+		return require_renderIntlayerNode.renderIntlayerNode({
+			...rest,
+			value: children,
+			children: () => ({
+				component: process.env.INTLAYER_EDITOR_ENABLED === "false" || !_intlayer_config_built.editor.enabled ? children : require_editor_ContentSelector_component.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" ? _intlayer_core_interpreter.fallbackPlugin : {

package/dist/cjs/plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.cjs","names":["renderIntlayerNode","editor","ContentSelectorWrapperComponent","fallbackPlugin","compile","NodeTypes","internationalization","enumerationPlugin","conditionPlugin","filePlugin","genderPlugin"],"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":"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"}
+{"version":3,"file":"plugins.cjs","names":["renderIntlayerNode","editor","ContentSelectorWrapperComponent","fallbackPlugin","compile","NodeTypes","internationalization","enumerationPlugin","conditionPlugin","filePlugin","genderPlugin"],"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":"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"}

package/dist/esm/analytics/exposureSink.mjs

@@ -0,0 +1,24 @@
+//#region src/analytics/exposureSink.ts
+let sink = null;
+/**
+* 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.
+*/
+const setExposureSink = (next) => {
+	sink = next;
+};
+/**
+* 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.
+*/
+const reportExposure = (input) => {
+	sink?.(input);
+};
+
+//#endregion
+export { reportExposure, setExposureSink };
+//# sourceMappingURL=exposureSink.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exposureSink.mjs","names":[],"sources":["../../../src/analytics/exposureSink.ts"],"sourcesContent":["import type { KeyPath } from '@intlayer/types/keyPath';\n\n/**\n * Node metadata reported for a content exposure. Kept dependency-free (types\n * only) so the interpreter hot path in `plugins.ts` never statically imports\n * `@intlayer/analytics` — the package stays optional and tree-shakeable.\n */\nexport type ExposureInput = {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  locale?: string;\n  nodeType?: string;\n};\n\n/** Consumer of exposure reports, installed by `useAnalytics` after init. */\nexport type ExposureSink = (input: ExposureInput) => void;\n\nlet sink: ExposureSink | null = null;\n\n/**\n * Installs (or clears) the exposure sink. `useAnalytics` sets this once the\n * analytics client has loaded, and clears it on unmount.\n *\n * @param next - The sink to install, or `null` to clear.\n */\nexport const setExposureSink = (next: ExposureSink | null): void => {\n  sink = next;\n};\n\n/**\n * Forwards a content exposure to the installed sink. A cheap null-check when\n * analytics is not running, so it is safe to call from every node resolution.\n *\n * @param input - The node metadata to report.\n */\nexport const reportExposure = (input: ExposureInput): void => {\n  sink?.(input);\n};\n"],"mappings":";AAiBA,IAAI,OAA4B;;;;;;;AAQhC,MAAa,mBAAmB,SAAoC;AAClE,QAAO;;;;;;;;AAST,MAAa,kBAAkB,UAA+B;AAC5D,QAAO,MAAM"}

package/dist/esm/analytics/index.mjs

@@ -0,0 +1,5 @@
+import { provideIntlayerAnalytics, useAnalytics } from "./useAnalytics.mjs";
+import { useConversion } from "./useConversion.mjs";
+import { useExperiment } from "./useExperiment.mjs";
+
+export { provideIntlayerAnalytics, useAnalytics, useConversion, useExperiment };

package/dist/esm/analytics/useAnalytics.mjs

@@ -0,0 +1,82 @@
+import { setExposureSink } from "./exposureSink.mjs";
+import { INTLAYER_TOKEN } from "../client/intlayerToken.mjs";
+import { DestroyRef, Injector, effect, inject, provideAppInitializer, runInInjectionContext, signal } from "@angular/core";
+import { isEnabled } from "@intlayer/analytics/isEnabled";
+
+//#region src/analytics/useAnalytics.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.
+*/
+const useAnalytics = (client) => {
+	if (process.env.INTLAYER_ANALYTICS_ENABLED === "false" || !isEnabled) return;
+	const destroyRef = inject(DestroyRef, { optional: true });
+	const injector = inject(Injector);
+	const resolvedClient = client ?? inject(INTLAYER_TOKEN, { optional: true });
+	const analyticsClient = signal(null);
+	let stopped = false;
+	let initialized = false;
+	import("@intlayer/analytics").then(({ initAnalyticsClient, buildContentExposure }) => {
+		if (stopped) return;
+		const clientInstance = initAnalyticsClient();
+		initialized = true;
+		const currentLocale = resolvedClient?.locale();
+		if (currentLocale) clientInstance.setLocale(currentLocale);
+		clientInstance.trackPageView({ reason: "initial" });
+		setExposureSink((input) => clientInstance.trackContentExposure(buildContentExposure(input)));
+		analyticsClient.set(clientInstance);
+	}).catch(() => {});
+	let previousLocale;
+	const effectRef = runInInjectionContext(injector, () => effect(() => {
+		const clientInstance = analyticsClient();
+		const locale = resolvedClient?.locale();
+		if (!clientInstance || !locale) return;
+		if (previousLocale === void 0) {
+			previousLocale = locale;
+			return;
+		}
+		if (previousLocale === locale) return;
+		previousLocale = locale;
+		clientInstance.setLocale(locale);
+		clientInstance.trackPageView({ reason: "locale_change" });
+	}));
+	destroyRef?.onDestroy(() => {
+		stopped = true;
+		effectRef.destroy();
+		analyticsClient.set(null);
+		setExposureSink(null);
+		import("@intlayer/analytics").then(({ stopAnalyticsClient }) => {
+			if (initialized) stopAnalyticsClient();
+		}).catch(() => {});
+	});
+};
+/**
+* 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()],
+* };
+* ```
+*/
+const provideIntlayerAnalytics = (client) => provideAppInitializer(() => useAnalytics(client));
+
+//#endregion
+export { provideIntlayerAnalytics, useAnalytics };
+//# sourceMappingURL=useAnalytics.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.mjs","names":[],"sources":["../../../src/analytics/useAnalytics.ts"],"sourcesContent":["import {\n  DestroyRef,\n  effect,\n  Injector,\n  inject,\n  provideAppInitializer,\n  runInInjectionContext,\n  signal,\n} from '@angular/core';\nimport type { AnalyticsClient } from '@intlayer/analytics';\nimport { isEnabled } from '@intlayer/analytics/isEnabled';\n// Import from the standalone token file to avoid a circular dependency:\n//   installIntlayer.ts → useAnalytics.ts → ../client → installIntlayer.ts\nimport { INTLAYER_TOKEN, type IntlayerProvider } from '../client/intlayerToken';\nimport { setExposureSink } from './exposureSink';\n\n/**\n * Initializes the Intlayer analytics client singleton when analytics is\n * enabled (mirrors {@link useEditor}). Records an initial page view, keeps the\n * client aware of the current locale, and wires node-level content exposures.\n *\n * Must be called inside an Angular injection context (e.g. a component\n * constructor, `provideAppInitializer`, or `runInInjectionContext`).\n *\n * @param client - The IntlayerProvider instance to sync locale from.\n *   When omitted the function injects `INTLAYER_TOKEN` from the DI tree,\n *   so it still works when called directly from a component.\n */\nexport const useAnalytics = (client?: IntlayerProvider | null): void => {\n  if (process.env.INTLAYER_ANALYTICS_ENABLED === 'false' || !isEnabled) return;\n\n  const destroyRef = inject(DestroyRef, { optional: true });\n  const injector = inject(Injector);\n\n  // Resolve the client: use the passed-in reference or fall back to injection.\n  const resolvedClient =\n    client ??\n    inject<IntlayerProvider>(INTLAYER_TOKEN, { optional: true } as any);\n\n  // `analyticsClient` signal is set once the async import resolves.\n  // Using a signal lets an `effect()` react to it becoming available.\n  const analyticsClient = signal<AnalyticsClient | null>(null);\n\n  // Guard: prevents the async callback from acting after the view is destroyed.\n  let stopped = false;\n  // Tracks whether initAnalyticsClient actually ran, so teardown never calls\n  // stopAnalyticsClient for an init that was cancelled — that would decrement\n  // the shared reference count once too many.\n  let initialized = false;\n\n  import('@intlayer/analytics')\n    .then(({ initAnalyticsClient, buildContentExposure }) => {\n      if (stopped) return;\n\n      const clientInstance = initAnalyticsClient();\n      initialized = true;\n\n      const currentLocale = resolvedClient?.locale();\n      if (currentLocale) clientInstance.setLocale(currentLocale);\n      clientInstance.trackPageView({ reason: 'initial' });\n\n      // Route node-level exposures (from the interpreter plugins) into the\n      // client. Serialization happens here, off the hot render path.\n      setExposureSink((input) =>\n        clientInstance.trackContentExposure(buildContentExposure(input))\n      );\n\n      analyticsClient.set(clientInstance);\n    })\n    .catch(() => {\n      /* chunk failed to load — analytics stays a no-op */\n    });\n\n  // Locale switches are a real signal — record them as page views.\n  let previousLocale: string | undefined;\n  const effectRef = runInInjectionContext(injector, () =>\n    effect(() => {\n      const clientInstance = analyticsClient();\n      const locale = resolvedClient?.locale();\n\n      if (!clientInstance || !locale) return;\n\n      if (previousLocale === undefined) {\n        // First run after init — the initial page view already covered it.\n        previousLocale = locale;\n        return;\n      }\n      if (previousLocale === locale) return;\n\n      previousLocale = locale;\n      clientInstance.setLocale(locale);\n      clientInstance.trackPageView({ reason: 'locale_change' });\n    })\n  );\n\n  // Tear down on destroy\n  destroyRef?.onDestroy(() => {\n    stopped = true;\n    effectRef.destroy();\n    analyticsClient.set(null);\n    setExposureSink(null);\n    import('@intlayer/analytics')\n      .then(({ stopAnalyticsClient }) => {\n        if (initialized) stopAnalyticsClient();\n      })\n      .catch(() => {});\n  });\n};\n\n/**\n * Angular provider that wires `useAnalytics` into the application\n * initialisation phase via `provideAppInitializer`.\n *\n * `provideIntlayer()` already calls this internally, so you only need this\n * function when you want to manage providers individually.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { provideIntlayer, provideIntlayerAnalytics } from 'angular-intlayer';\n *\n * export const appConfig: ApplicationConfig = {\n *   providers: [provideIntlayer(), provideIntlayerAnalytics()],\n * };\n * ```\n */\nexport const provideIntlayerAnalytics = (client?: IntlayerProvider | null) =>\n  provideAppInitializer(() => useAnalytics(client));\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4BA,MAAa,gBAAgB,WAA2C;AACtE,KAAI,QAAQ,IAAI,+BAA+B,WAAW,CAAC,UAAW;CAEtE,MAAM,aAAa,OAAO,YAAY,EAAE,UAAU,MAAM,CAAC;CACzD,MAAM,WAAW,OAAO,SAAS;CAGjC,MAAM,iBACJ,UACA,OAAyB,gBAAgB,EAAE,UAAU,MAAM,CAAQ;CAIrE,MAAM,kBAAkB,OAA+B,KAAK;CAG5D,IAAI,UAAU;CAId,IAAI,cAAc;AAElB,QAAO,uBACJ,MAAM,EAAE,qBAAqB,2BAA2B;AACvD,MAAI,QAAS;EAEb,MAAM,iBAAiB,qBAAqB;AAC5C,gBAAc;EAEd,MAAM,gBAAgB,gBAAgB,QAAQ;AAC9C,MAAI,cAAe,gBAAe,UAAU,cAAc;AAC1D,iBAAe,cAAc,EAAE,QAAQ,WAAW,CAAC;AAInD,mBAAiB,UACf,eAAe,qBAAqB,qBAAqB,MAAM,CAAC,CACjE;AAED,kBAAgB,IAAI,eAAe;GACnC,CACD,YAAY,GAEX;CAGJ,IAAI;CACJ,MAAM,YAAY,sBAAsB,gBACtC,aAAa;EACX,MAAM,iBAAiB,iBAAiB;EACxC,MAAM,SAAS,gBAAgB,QAAQ;AAEvC,MAAI,CAAC,kBAAkB,CAAC,OAAQ;AAEhC,MAAI,mBAAmB,QAAW;AAEhC,oBAAiB;AACjB;;AAEF,MAAI,mBAAmB,OAAQ;AAE/B,mBAAiB;AACjB,iBAAe,UAAU,OAAO;AAChC,iBAAe,cAAc,EAAE,QAAQ,iBAAiB,CAAC;GACzD,CACH;AAGD,aAAY,gBAAgB;AAC1B,YAAU;AACV,YAAU,SAAS;AACnB,kBAAgB,IAAI,KAAK;AACzB,kBAAgB,KAAK;AACrB,SAAO,uBACJ,MAAM,EAAE,0BAA0B;AACjC,OAAI,YAAa,sBAAqB;IACtC,CACD,YAAY,GAAG;GAClB;;;;;;;;;;;;;;;;;;;AAoBJ,MAAa,4BAA4B,WACvC,4BAA4B,aAAa,OAAO,CAAC"}