@procore/ai-translations 0.6.0 → 0.6.1

package/dist/legacy/index.js

@@ -22,10 +22,16 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ACTION: () => ACTION,
   AITranslateText: () => AITranslateText,
   AITranslationProvider: () => AITranslationProvider,
   AI_TRANSLATION_FEATURE_FLAG_KEY: () => AI_TRANSLATION_FEATURE_FLAG_KEY,
+  BUTTON_TYPE: () => BUTTON_TYPE,
+  buildAnalyticEvent: () => buildAnalyticEvent,
+  buildEventKey: () => buildEventKey,
+  buildObject: () => buildObject,
   getAITranslationLDId: () => getAITranslationLDId,
+  useAIAnalytics: () => useAIAnalytics,
   useAITranslation: () => useAITranslation,
   useConfig: () => useConfig
 });
@@ -1472,7 +1478,12 @@ function AITranslationInnerProvider(props) {
     companyId,
     userId,
     projectId,
-    enableAIT = true
+    enableAIT = true,
+    companyLocale,
+    projectLocale,
+    onTrackAnalyticsEvent,
+    page,
+    scope
   } = props;
   const [translationProgress, setTranslationProgress] = (0, import_react.useState)(null);
   const [modelDownloadProgress, setModelDownloadProgress] = (0, import_react.useState)(null);
@@ -1549,10 +1560,15 @@ function AITranslationInnerProvider(props) {
   const contextValue = {
     ait,
     locale,
+    companyLocale,
+    projectLocale,
     renderVersion: renderVersionManager.getVersion(),
     translationProgress,
     modelDownloadProgress,
-    tool
+    tool,
+    onTrackAnalyticsEvent,
+    page,
+    scope
   };
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AITranslationContext.Provider, { value: contextValue, children });
 }
@@ -1572,15 +1588,143 @@ function useAITranslation() {
   return ctx;
 }
 
+// src/hooks/useAIAnalytics.ts
+var import_react3 = require("react");
+
+// src/analytics/events.ts
+var BUTTON_TYPE = {
+  TRANSLATE: "translate",
+  HIGHLIGHT: "highlight"
+};
+var ACTION = {
+  CLICKED: "clicked"
+};
+function buildObject(pageContext, buttonType) {
+  return `${pageContext}_${buttonType}_button`;
+}
+function buildEventKey(parts) {
+  const { scope, tool, object, action } = parts;
+  return `ux.web.feature.${scope}.${tool}.${object}.${action}`;
+}
+function buildAnalyticEvent(params) {
+  const {
+    scope,
+    tool,
+    pageContext,
+    buttonType,
+    baseProperties,
+    action,
+    additionalProperties
+  } = params;
+  const resolvedAction = action ?? ACTION.CLICKED;
+  const object = buildObject(pageContext, buttonType);
+  const key = buildEventKey({
+    scope,
+    tool,
+    object,
+    action: resolvedAction
+  });
+  const properties = {
+    ...baseProperties,
+    ...additionalProperties
+  };
+  return { key, properties };
+}
+
+// src/hooks/useAIAnalytics.ts
+function useAIAnalytics() {
+  const ctx = (0, import_react3.useContext)(AITranslationContext);
+  if (!ctx) {
+    throw new Error(
+      "useAIAnalytics must be used inside an AITranslationProvider"
+    );
+  }
+  const {
+    locale,
+    companyLocale,
+    projectLocale,
+    tool,
+    page,
+    scope,
+    onTrackAnalyticsEvent
+  } = ctx;
+  const isTrackingEnabled = Boolean(onTrackAnalyticsEvent);
+  const buildBaseProperties = (0, import_react3.useCallback)(() => {
+    const props = {
+      user_locale: locale,
+      tool,
+      page: page ?? ""
+    };
+    if (companyLocale) props.company_locale = companyLocale;
+    if (projectLocale) props.project_locale = projectLocale;
+    return props;
+  }, [locale, tool, page, companyLocale, projectLocale]);
+  const trackTranslateButtonClicked = (0, import_react3.useCallback)(
+    (additionalProperties) => {
+      if (!onTrackAnalyticsEvent || !page || !scope) return;
+      onTrackAnalyticsEvent(
+        buildAnalyticEvent({
+          scope,
+          tool,
+          pageContext: page,
+          buttonType: BUTTON_TYPE.TRANSLATE,
+          baseProperties: buildBaseProperties(),
+          additionalProperties
+        })
+      );
+    },
+    [onTrackAnalyticsEvent, tool, page, scope, buildBaseProperties]
+  );
+  const trackHighlightButtonClicked = (0, import_react3.useCallback)(
+    (additionalProperties) => {
+      if (!onTrackAnalyticsEvent || !page || !scope) return;
+      onTrackAnalyticsEvent(
+        buildAnalyticEvent({
+          scope,
+          tool,
+          pageContext: page,
+          buttonType: BUTTON_TYPE.HIGHLIGHT,
+          baseProperties: buildBaseProperties(),
+          additionalProperties
+        })
+      );
+    },
+    [onTrackAnalyticsEvent, tool, page, scope, buildBaseProperties]
+  );
+  const trackCustomEvent = (0, import_react3.useCallback)(
+    (buttonType, action, additionalProperties) => {
+      if (!onTrackAnalyticsEvent || !page || !scope) return;
+      onTrackAnalyticsEvent(
+        buildAnalyticEvent({
+          scope,
+          tool,
+          pageContext: page,
+          buttonType,
+          baseProperties: buildBaseProperties(),
+          action,
+          additionalProperties
+        })
+      );
+    },
+    [onTrackAnalyticsEvent, tool, page, scope, buildBaseProperties]
+  );
+  return {
+    trackTranslateButtonClicked,
+    trackHighlightButtonClicked,
+    trackCustomEvent,
+    isTrackingEnabled
+  };
+}
+
 // src/components/AITranslateText.tsx
-var import_react4 = require("react");
+var import_react5 = require("react");
 
 // src/components/TranslatedIcon.tsx
-var import_react3 = require("react");
+var import_react4 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var TranslatedIcon = ({
-  width = 14,
-  height = 14,
+  width = 24,
+  height = 24,
   className,
   color = "#000000"
 }) => {
@@ -1598,7 +1742,7 @@ var TranslatedIcon = ({
         "path",
         {
           fill: color,
-          d: "M12.87,15.07l-2.54,-2.51 0.03,-0.03c1.74,-1.94 2.98,-4.17 3.71,-6.53L17,6L17,4h-7L10,2L8,2v2L1,4v1.99h11.17C11.5,7.92 10.44,9.75 9,11.35 8.07,10.32 7.3,9.19 6.69,8h-2c0.73,1.63 1.73,3.17 2.98,4.56l-5.09,5.02L4,19l5,-5 3.11,3.11 0.76,-2.04zM18.5,10h-2L12,22h2l1.12,-3h4.75L21,22h2l-4.5,-12zM15.88,17l1.62,-4.33L19.12,17h-3.24z"
+          d: "M11.99 2C6.47 2 2 6.48 2 12C2 17.52 6.47 22 11.99 22C17.52 22 22 17.52 22 12C22 6.48 17.52 2 11.99 2ZM18.92 8H15.97C15.65 6.75 15.19 5.55 14.59 4.44C16.43 5.07 17.96 6.35 18.92 8ZM12 4.04C12.83 5.24 13.48 6.57 13.91 8H10.09C10.52 6.57 11.17 5.24 12 4.04ZM4.26 14C4.1 13.36 4 12.69 4 12C4 11.31 4.1 10.64 4.26 10H7.64C7.56 10.66 7.5 11.32 7.5 12C7.5 12.68 7.56 13.34 7.64 14H4.26ZM5.08 16H8.03C8.35 17.25 8.81 18.45 9.41 19.56C7.57 18.93 6.04 17.66 5.08 16ZM8.03 8H5.08C6.04 6.34 7.57 5.07 9.41 4.44C8.81 5.55 8.35 6.75 8.03 8ZM12 19.96C11.17 18.76 10.52 17.43 10.09 16H13.91C13.48 17.43 12.83 18.76 12 19.96ZM14.34 14H9.66C9.57 13.34 9.5 12.68 9.5 12C9.5 11.32 9.57 10.65 9.66 10H14.34C14.43 10.65 14.5 11.32 14.5 12C14.5 12.68 14.43 13.34 14.34 14ZM14.59 19.56C15.19 18.45 15.65 17.25 15.97 16H18.92C17.96 17.65 16.43 18.93 14.59 19.56ZM16.36 14C16.44 13.34 16.5 12.68 16.5 12C16.5 11.32 16.44 10.66 16.36 10H19.74C19.9 10.64 20 11.31 20 12C20 12.69 19.9 13.36 19.74 14H16.36Z"
         }
       )
     }
@@ -1613,11 +1757,11 @@ var AITranslateText = ({
   showHighlight = false,
   translatedIconProps
 }) => {
-  const context = (0, import_react4.useContext)(AITranslationContext);
-  const [displayText, setDisplayText] = (0, import_react4.useState)(text ?? "");
-  const [showHighlightState, setShowHighlightState] = (0, import_react4.useState)(showHighlight);
-  const eventHandlerRef = (0, import_react4.useRef)(null);
-  (0, import_react4.useEffect)(() => {
+  const context = (0, import_react5.useContext)(AITranslationContext);
+  const [displayText, setDisplayText] = (0, import_react5.useState)(text ?? "");
+  const [showHighlightState, setShowHighlightState] = (0, import_react5.useState)(showHighlight);
+  const eventHandlerRef = (0, import_react5.useRef)(null);
+  (0, import_react5.useEffect)(() => {
     if (!context) return;
     if (!eventHandlerRef.current) {
       eventHandlerRef.current = new EventHandler(context.tool);
@@ -1636,14 +1780,14 @@ var AITranslateText = ({
     );
     return () => unsubscribe();
   }, [context, text, showHighlight]);
-  const reset = (0, import_react4.useCallback)(
+  const reset = (0, import_react5.useCallback)(
     (displayValue = text) => {
       setDisplayText(displayValue);
       setShowHighlightState(false);
     },
     [text]
   );
-  (0, import_react4.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     if (text == null || text === "") {
       reset(text ?? "");
       return;
@@ -1695,10 +1839,16 @@ var getAITranslationLDId = (domain) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ACTION,
   AITranslateText,
   AITranslationProvider,
   AI_TRANSLATION_FEATURE_FLAG_KEY,
+  BUTTON_TYPE,
+  buildAnalyticEvent,
+  buildEventKey,
+  buildObject,
   getAITranslationLDId,
+  useAIAnalytics,
   useAITranslation,
   useConfig
 });

package/dist/legacy/index.mjs

@@ -1449,7 +1449,12 @@ function AITranslationInnerProvider(props) {
     companyId,
     userId,
     projectId,
-    enableAIT = true
+    enableAIT = true,
+    companyLocale,
+    projectLocale,
+    onTrackAnalyticsEvent,
+    page,
+    scope
   } = props;
   const [translationProgress, setTranslationProgress] = useState(null);
   const [modelDownloadProgress, setModelDownloadProgress] = useState(null);
@@ -1526,10 +1531,15 @@ function AITranslationInnerProvider(props) {
   const contextValue = {
     ait,
     locale,
+    companyLocale,
+    projectLocale,
     renderVersion: renderVersionManager.getVersion(),
     translationProgress,
     modelDownloadProgress,
-    tool
+    tool,
+    onTrackAnalyticsEvent,
+    page,
+    scope
   };
   return /* @__PURE__ */ jsx(AITranslationContext.Provider, { value: contextValue, children });
 }
@@ -1549,12 +1559,140 @@ function useAITranslation() {
   return ctx;
 }
 
+// src/hooks/useAIAnalytics.ts
+import { useContext as useContext2, useCallback as useCallback2 } from "react";
+
+// src/analytics/events.ts
+var BUTTON_TYPE = {
+  TRANSLATE: "translate",
+  HIGHLIGHT: "highlight"
+};
+var ACTION = {
+  CLICKED: "clicked"
+};
+function buildObject(pageContext, buttonType) {
+  return `${pageContext}_${buttonType}_button`;
+}
+function buildEventKey(parts) {
+  const { scope, tool, object, action } = parts;
+  return `ux.web.feature.${scope}.${tool}.${object}.${action}`;
+}
+function buildAnalyticEvent(params) {
+  const {
+    scope,
+    tool,
+    pageContext,
+    buttonType,
+    baseProperties,
+    action,
+    additionalProperties
+  } = params;
+  const resolvedAction = action ?? ACTION.CLICKED;
+  const object = buildObject(pageContext, buttonType);
+  const key = buildEventKey({
+    scope,
+    tool,
+    object,
+    action: resolvedAction
+  });
+  const properties = {
+    ...baseProperties,
+    ...additionalProperties
+  };
+  return { key, properties };
+}
+
+// src/hooks/useAIAnalytics.ts
+function useAIAnalytics() {
+  const ctx = useContext2(AITranslationContext);
+  if (!ctx) {
+    throw new Error(
+      "useAIAnalytics must be used inside an AITranslationProvider"
+    );
+  }
+  const {
+    locale,
+    companyLocale,
+    projectLocale,
+    tool,
+    page,
+    scope,
+    onTrackAnalyticsEvent
+  } = ctx;
+  const isTrackingEnabled = Boolean(onTrackAnalyticsEvent);
+  const buildBaseProperties = useCallback2(() => {
+    const props = {
+      user_locale: locale,
+      tool,
+      page: page ?? ""
+    };
+    if (companyLocale) props.company_locale = companyLocale;
+    if (projectLocale) props.project_locale = projectLocale;
+    return props;
+  }, [locale, tool, page, companyLocale, projectLocale]);
+  const trackTranslateButtonClicked = useCallback2(
+    (additionalProperties) => {
+      if (!onTrackAnalyticsEvent || !page || !scope) return;
+      onTrackAnalyticsEvent(
+        buildAnalyticEvent({
+          scope,
+          tool,
+          pageContext: page,
+          buttonType: BUTTON_TYPE.TRANSLATE,
+          baseProperties: buildBaseProperties(),
+          additionalProperties
+        })
+      );
+    },
+    [onTrackAnalyticsEvent, tool, page, scope, buildBaseProperties]
+  );
+  const trackHighlightButtonClicked = useCallback2(
+    (additionalProperties) => {
+      if (!onTrackAnalyticsEvent || !page || !scope) return;
+      onTrackAnalyticsEvent(
+        buildAnalyticEvent({
+          scope,
+          tool,
+          pageContext: page,
+          buttonType: BUTTON_TYPE.HIGHLIGHT,
+          baseProperties: buildBaseProperties(),
+          additionalProperties
+        })
+      );
+    },
+    [onTrackAnalyticsEvent, tool, page, scope, buildBaseProperties]
+  );
+  const trackCustomEvent = useCallback2(
+    (buttonType, action, additionalProperties) => {
+      if (!onTrackAnalyticsEvent || !page || !scope) return;
+      onTrackAnalyticsEvent(
+        buildAnalyticEvent({
+          scope,
+          tool,
+          pageContext: page,
+          buttonType,
+          baseProperties: buildBaseProperties(),
+          action,
+          additionalProperties
+        })
+      );
+    },
+    [onTrackAnalyticsEvent, tool, page, scope, buildBaseProperties]
+  );
+  return {
+    trackTranslateButtonClicked,
+    trackHighlightButtonClicked,
+    trackCustomEvent,
+    isTrackingEnabled
+  };
+}
+
 // src/components/AITranslateText.tsx
 import {
   useState as useState2,
   useEffect as useEffect2,
-  useContext as useContext2,
-  useCallback as useCallback2,
+  useContext as useContext3,
+  useCallback as useCallback3,
   useRef as useRef2
 } from "react";
 
@@ -1562,8 +1700,8 @@ import {
 import "react";
 import { jsx as jsx2 } from "react/jsx-runtime";
 var TranslatedIcon = ({
-  width = 14,
-  height = 14,
+  width = 24,
+  height = 24,
   className,
   color = "#000000"
 }) => {
@@ -1581,7 +1719,7 @@ var TranslatedIcon = ({
         "path",
         {
           fill: color,
-          d: "M12.87,15.07l-2.54,-2.51 0.03,-0.03c1.74,-1.94 2.98,-4.17 3.71,-6.53L17,6L17,4h-7L10,2L8,2v2L1,4v1.99h11.17C11.5,7.92 10.44,9.75 9,11.35 8.07,10.32 7.3,9.19 6.69,8h-2c0.73,1.63 1.73,3.17 2.98,4.56l-5.09,5.02L4,19l5,-5 3.11,3.11 0.76,-2.04zM18.5,10h-2L12,22h2l1.12,-3h4.75L21,22h2l-4.5,-12zM15.88,17l1.62,-4.33L19.12,17h-3.24z"
+          d: "M11.99 2C6.47 2 2 6.48 2 12C2 17.52 6.47 22 11.99 22C17.52 22 22 17.52 22 12C22 6.48 17.52 2 11.99 2ZM18.92 8H15.97C15.65 6.75 15.19 5.55 14.59 4.44C16.43 5.07 17.96 6.35 18.92 8ZM12 4.04C12.83 5.24 13.48 6.57 13.91 8H10.09C10.52 6.57 11.17 5.24 12 4.04ZM4.26 14C4.1 13.36 4 12.69 4 12C4 11.31 4.1 10.64 4.26 10H7.64C7.56 10.66 7.5 11.32 7.5 12C7.5 12.68 7.56 13.34 7.64 14H4.26ZM5.08 16H8.03C8.35 17.25 8.81 18.45 9.41 19.56C7.57 18.93 6.04 17.66 5.08 16ZM8.03 8H5.08C6.04 6.34 7.57 5.07 9.41 4.44C8.81 5.55 8.35 6.75 8.03 8ZM12 19.96C11.17 18.76 10.52 17.43 10.09 16H13.91C13.48 17.43 12.83 18.76 12 19.96ZM14.34 14H9.66C9.57 13.34 9.5 12.68 9.5 12C9.5 11.32 9.57 10.65 9.66 10H14.34C14.43 10.65 14.5 11.32 14.5 12C14.5 12.68 14.43 13.34 14.34 14ZM14.59 19.56C15.19 18.45 15.65 17.25 15.97 16H18.92C17.96 17.65 16.43 18.93 14.59 19.56ZM16.36 14C16.44 13.34 16.5 12.68 16.5 12C16.5 11.32 16.44 10.66 16.36 10H19.74C19.9 10.64 20 11.31 20 12C20 12.69 19.9 13.36 19.74 14H16.36Z"
         }
       )
     }
@@ -1596,7 +1734,7 @@ var AITranslateText = ({
   showHighlight = false,
   translatedIconProps
 }) => {
-  const context = useContext2(AITranslationContext);
+  const context = useContext3(AITranslationContext);
   const [displayText, setDisplayText] = useState2(text ?? "");
   const [showHighlightState, setShowHighlightState] = useState2(showHighlight);
   const eventHandlerRef = useRef2(null);
@@ -1619,7 +1757,7 @@ var AITranslateText = ({
     );
     return () => unsubscribe();
   }, [context, text, showHighlight]);
-  const reset = useCallback2(
+  const reset = useCallback3(
     (displayValue = text) => {
       setDisplayText(displayValue);
       setShowHighlightState(false);
@@ -1677,10 +1815,16 @@ var getAITranslationLDId = (domain) => {
   }
 };
 export {
+  ACTION,
   AITranslateText,
   AITranslationProvider,
   AI_TRANSLATION_FEATURE_FLAG_KEY,
+  BUTTON_TYPE,
+  buildAnalyticEvent,
+  buildEventKey,
+  buildObject,
   getAITranslationLDId,
+  useAIAnalytics,
   useAITranslation,
   useConfig
 };

package/dist/modern/index.d.mts

@@ -2,6 +2,35 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 
+/** Shape of an analytic event passed to the MFE's `onTrackAnalyticsEvent` callback. */
+interface AnalyticEvent {
+    key: string;
+    properties: Record<string, unknown>;
+}
+/** Function provided by the MFE that sends the event to the analytics destination. */
+type AIAnalyticsTracker = (event: AnalyticEvent) => void;
+/** Feature scope: `'project'` for project-level tools, `'company'` for company-level tools. */
+type Scope = 'project' | 'company';
+/**
+ * Parts needed to build an event key following the pattern:
+ * `ux.web.feature.{scope}.{tool}.{object}.{action}`
+ */
+interface EventKeyParts {
+    scope: Scope;
+    tool: string;
+    object: string;
+    action: string;
+}
+/** Standard properties included in every AI analytics event. */
+interface AIAnalyticsEventProperties {
+    user_locale: string;
+    project_locale?: string;
+    company_locale?: string;
+    tool: string;
+    page: string;
+    [key: string]: unknown;
+}
+
 interface TranslationProgress {
     /**
      * Progress percentage (0-100)
@@ -39,12 +68,22 @@ interface ModelDownloadProgress {
 interface AITranslationContextValue {
     ait: (text: string) => Promise<string>;
     locale: string;
+    /** Company-level locale from environment metadata (e.g. `"de-DE"`). */
+    companyLocale?: string;
+    /** Project-level locale from environment metadata (e.g. `"fr-CA"`). */
+    projectLocale?: string;
     renderVersion?: number;
     /** Batch-translation progress; `null` while the queue is idle. */
     translationProgress: TranslationProgress | null;
     /** Chrome AI model download progress; `null` until a download begins. */
     modelDownloadProgress: ModelDownloadProgress | null;
     tool: string;
+    /** Called by `useAIAnalytics` with a fully assembled event. The MFE is responsible for sending it. */
+    onTrackAnalyticsEvent?: AIAnalyticsTracker;
+    /** Page context used to build the event key object segment (e.g. `'view'`, `'list_column_description'`). */
+    page?: string;
+    /** Feature scope: `'project'` or `'company'`. */
+    scope?: Scope;
 }
 
 interface ConfigurationResponse {
@@ -117,6 +156,59 @@ declare function useConfig(toolName: string, options?: UseConfigOptions): _tanst
  */
 declare function useAITranslation(): AITranslationContextValue;
 
+/** Button type identifiers for the event key `object` segment. */
+declare const BUTTON_TYPE: {
+    readonly TRANSLATE: "translate";
+    readonly HIGHLIGHT: "highlight";
+};
+type ButtonType = (typeof BUTTON_TYPE)[keyof typeof BUTTON_TYPE];
+/** Action identifiers for the event key `action` segment. */
+declare const ACTION: {
+    readonly CLICKED: "clicked";
+};
+type Action = (typeof ACTION)[keyof typeof ACTION];
+/**
+ * Builds the `object` segment: `{pageContext}_{buttonType}_button`
+ * e.g. `buildObject('view', 'translate')` → `'view_translate_button'`
+ */
+declare function buildObject(pageContext: string, buttonType: ButtonType): string;
+/**
+ * Builds a fully-qualified event key:
+ * `ux.web.feature.{scope}.{tool}.{object}.{action}`
+ */
+declare function buildEventKey(parts: EventKeyParts): string;
+interface BuildAnalyticEventParams {
+    scope: Scope;
+    tool: string;
+    /** Prefix for the object segment, matches the Provider `page` prop (e.g. `'view'`). */
+    pageContext: string;
+    buttonType: ButtonType;
+    baseProperties: AIAnalyticsEventProperties;
+    /** Defaults to `'clicked'` if omitted. */
+    action?: Action;
+    additionalProperties?: Record<string, unknown>;
+}
+/** Assembles a complete `AnalyticEvent` (key + merged properties) ready for `onTrackAnalyticsEvent`. */
+declare function buildAnalyticEvent(params: BuildAnalyticEventParams): AnalyticEvent;
+
+interface UseAIAnalyticsReturn {
+    /** Fires `ux.web.feature.{scope}.{tool}.{page}_translate_button.clicked`. */
+    trackTranslateButtonClicked: (additionalProperties?: Record<string, unknown>) => void;
+    /** Fires `ux.web.feature.{scope}.{tool}.{page}_highlight_button.clicked`. */
+    trackHighlightButtonClicked: (additionalProperties?: Record<string, unknown>) => void;
+    /** Generic tracking for custom button types or actions. */
+    trackCustomEvent: (buttonType: ButtonType | string, action?: Action | string, additionalProperties?: Record<string, unknown>) => void;
+    /** `true` when `onTrackAnalyticsEvent` was provided to `AITranslationProvider`. */
+    isTrackingEnabled: boolean;
+}
+/**
+ * Returns analytics tracking helpers pre-wired to the Provider context.
+ * All functions no-op if `onTrackAnalyticsEvent` was not supplied.
+ *
+ * @throws if called outside of an `AITranslationProvider`.
+ */
+declare function useAIAnalytics(): UseAIAnalyticsReturn;
+
 interface AITranslationProviderProps {
     children: ReactNode;
     locale: string;
@@ -125,6 +217,16 @@ interface AITranslationProviderProps {
     userId: number;
     projectId: number;
     enableAIT?: boolean;
+    /** Company-level locale from environment metadata (e.g. `"de-DE"`). Passed through to context for downstream consumers such as Amplitude. */
+    companyLocale?: string;
+    /** Project-level locale from environment metadata (e.g. `"fr-CA"`). Passed through to context for downstream consumers such as Amplitude. */
+    projectLocale?: string;
+    /** Called by `useAIAnalytics` with a pre-assembled event. The MFE sends it to the analytics API. */
+    onTrackAnalyticsEvent?: AIAnalyticsTracker;
+    /** Page context for the event key object segment (e.g. `'view'`, `'list_column_description'`). */
+    page?: string;
+    /** Feature scope: `'project'` or `'company'`. */
+    scope?: Scope;
 }
 declare function AITranslationProvider(props: AITranslationProviderProps): react_jsx_runtime.JSX.Element;
 
@@ -177,4 +279,4 @@ declare global {
     var _BACKEND_AI_TRANSLATION_IN_PROGRESS_: boolean;
 }
 
-export { AITranslateText, type AITranslateTextProps, AITranslationProvider, AI_TRANSLATION_FEATURE_FLAG_KEY, type TranslatedIconProps, type UseConfigOptions, getAITranslationLDId, useAITranslation, useConfig };
+export { ACTION, type AIAnalyticsEventProperties, type AIAnalyticsTracker, AITranslateText, type AITranslateTextProps, AITranslationProvider, AI_TRANSLATION_FEATURE_FLAG_KEY, type Action, type AnalyticEvent, BUTTON_TYPE, type BuildAnalyticEventParams, type ButtonType, type EventKeyParts, type Scope, type TranslatedIconProps, type UseAIAnalyticsReturn, type UseConfigOptions, buildAnalyticEvent, buildEventKey, buildObject, getAITranslationLDId, useAIAnalytics, useAITranslation, useConfig };