@devicai/ui 0.57.0 → 0.58.0

package/dist/esm/i18n/translate.js

@@ -0,0 +1,43 @@
+/**
+ * Replace `{name}` placeholders. A placeholder with no matching value is
+ * dropped rather than left in the text — half-substituted braces on screen
+ * read as a bug to the end user.
+ */
+function fillTemplate(template, vars) {
+    if (!vars)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (_, name) => {
+        const value = vars[name];
+        return value === undefined || value === null ? '' : String(value);
+    });
+}
+/**
+ * Look one English text up in the dictionary, then fill its placeholders.
+ * An absent entry falls back to the English text itself, so a partial
+ * dictionary is perfectly usable.
+ */
+function translate(dictionary, text, vars) {
+    return fillTemplate(dictionary?.[text] ?? text, vars);
+}
+/**
+ * Build a translator bound to one dictionary. Stable for as long as the
+ * dictionary is, so it is safe in a dependency list.
+ */
+function createTranslator(dictionary) {
+    return (text, vars) => translate(dictionary, text, vars);
+}
+/**
+ * Merge dictionaries, later ones winning. `undefined` layers are skipped so
+ * callers can pass optional ones straight in.
+ */
+function mergeTranslations(...layers) {
+    const present = layers.filter(Boolean);
+    if (present.length === 0)
+        return undefined;
+    if (present.length === 1)
+        return present[0];
+    return Object.assign({}, ...present);
+}
+
+export { createTranslator, fillTemplate, mergeTranslations, translate };
+//# sourceMappingURL=translate.js.map

package/dist/esm/i18n/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sources":["../../../src/i18n/translate.ts"],"sourcesContent":["import type { DevicTranslations, Translator } from './types';\n\n/**\n * Replace `{name}` placeholders. A placeholder with no matching value is\n * dropped rather than left in the text — half-substituted braces on screen\n * read as a bug to the end user.\n */\nexport function fillTemplate(\n  template: string,\n  vars?: Record<string, string | number>\n): string {\n  if (!vars) return template;\n  return template.replace(/\\{(\\w+)\\}/g, (_, name: string) => {\n    const value = vars[name];\n    return value === undefined || value === null ? '' : String(value);\n  });\n}\n\n/**\n * Look one English text up in the dictionary, then fill its placeholders.\n * An absent entry falls back to the English text itself, so a partial\n * dictionary is perfectly usable.\n */\nexport function translate(\n  dictionary: DevicTranslations | undefined,\n  text: string,\n  vars?: Record<string, string | number>\n): string {\n  return fillTemplate(dictionary?.[text] ?? text, vars);\n}\n\n/**\n * Build a translator bound to one dictionary. Stable for as long as the\n * dictionary is, so it is safe in a dependency list.\n */\nexport function createTranslator(dictionary?: DevicTranslations): Translator {\n  return (text, vars) => translate(dictionary, text, vars);\n}\n\n/**\n * Merge dictionaries, later ones winning. `undefined` layers are skipped so\n * callers can pass optional ones straight in.\n */\nexport function mergeTranslations(\n  ...layers: (DevicTranslations | undefined)[]\n): DevicTranslations | undefined {\n  const present = layers.filter(Boolean) as DevicTranslations[];\n  if (present.length === 0) return undefined;\n  if (present.length === 1) return present[0];\n  return Object.assign({}, ...present) as DevicTranslations;\n}\n"],"names":[],"mappings":"AAEA;;;;AAIG;AACG,SAAU,YAAY,CAC1B,QAAgB,EAChB,IAAsC,EAAA;AAEtC,IAAA,IAAI,CAAC,IAAI;AAAE,QAAA,OAAO,QAAQ;IAC1B,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,IAAY,KAAI;AACxD,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;AACxB,QAAA,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;AACnE,IAAA,CAAC,CAAC;AACJ;AAEA;;;;AAIG;SACa,SAAS,CACvB,UAAyC,EACzC,IAAY,EACZ,IAAsC,EAAA;AAEtC,IAAA,OAAO,YAAY,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC;AACvD;AAEA;;;AAGG;AACG,SAAU,gBAAgB,CAAC,UAA8B,EAAA;AAC7D,IAAA,OAAO,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC;AAC1D;AAEA;;;AAGG;AACG,SAAU,iBAAiB,CAC/B,GAAG,MAAyC,EAAA;IAE5C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAwB;AAC7D,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,SAAS;AAC1C,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAsB;AAC3D;;"}

package/dist/esm/i18n/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Dictionary of translations for the texts this library renders itself.
+ *
+ * The key is the exact English text the widget shows; the value is what to
+ * show instead. Nothing else is needed — no key catalogue to learn, and no
+ * i18n runtime bundled here: you keep whatever you already use (i18next,
+ * react-intl, a plain object per locale) and hand over the resulting strings.
+ *
+ * ```ts
+ * const translations = {
+ *   'New chat': 'Nueva conversación',
+ *   'Type a message...': 'Escribe un mensaje...',
+ *   '{count} left': 'Quedan {count}',
+ * };
+ * ```
+ *
+ * A text that carries a `{name}` placeholder keeps it in the translation:
+ * placeholders are filled after the lookup, so they can be reordered or
+ * dropped freely. A text with no entry is shown in English.
+ */
+export type DevicTranslations = Record<string, string>;
+/**
+ * Resolves one English text to what should be rendered.
+ *
+ * `vars` fills the `{name}` placeholders of the result.
+ */
+export type Translator = (text: string, vars?: Record<string, string | number>) => string;

package/dist/esm/i18n/useTranslations.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { DevicTranslations, Translator } from './types';
+export interface DevicTranslationsProviderProps {
+    /** Entries added on top of the enclosing dictionaries. */
+    translations?: DevicTranslations;
+    children: React.ReactNode;
+}
+/**
+ * Scopes a dictionary to a subtree. Rarely needed directly — the components
+ * that take a `translations` option already wrap their own subtree with it —
+ * but useful to translate one region of a page differently.
+ */
+export declare function DevicTranslationsProvider({ translations, children, }: DevicTranslationsProviderProps): JSX.Element;
+/**
+ * The dictionary in force here: the provider's, plus any scoped by an
+ * enclosing component, plus the `local` argument. Later layers win.
+ */
+export declare function useTranslationsDictionary(local?: DevicTranslations): DevicTranslations | undefined;
+/**
+ * Returns `t`, the translator for every text this library renders itself.
+ *
+ * Works with or without a `DevicProvider`: with no dictionary anywhere it
+ * returns the English text unchanged, which is what a component mounted
+ * standalone gets.
+ *
+ * @example
+ * ```tsx
+ * const t = useTranslations();
+ * <button aria-label={t('New chat')}>…</button>
+ * ```
+ */
+export declare function useTranslations(local?: DevicTranslations): Translator;

package/dist/esm/i18n/useTranslations.js

@@ -0,0 +1,53 @@
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useMemo, useContext } from 'react';
+import { useOptionalDevicContext } from '../provider/DevicContext.js';
+import { createTranslator, mergeTranslations } from './translate.js';
+
+/**
+ * Dictionary contributed by an enclosing component, on top of the provider's.
+ *
+ * It exists so `<ChatDrawer options={{ translations }}>` reaches the input,
+ * the message list and the dialogs it opens without every one of them taking
+ * a prop for it. Nesting merges rather than replaces.
+ */
+const TranslationsScope = createContext(undefined);
+/**
+ * Scopes a dictionary to a subtree. Rarely needed directly — the components
+ * that take a `translations` option already wrap their own subtree with it —
+ * but useful to translate one region of a page differently.
+ */
+function DevicTranslationsProvider({ translations, children, }) {
+    const outer = useContext(TranslationsScope);
+    const value = useMemo(() => mergeTranslations(outer, translations), [outer, translations]);
+    return (jsx(TranslationsScope.Provider, { value: value, children: children }));
+}
+/**
+ * The dictionary in force here: the provider's, plus any scoped by an
+ * enclosing component, plus the `local` argument. Later layers win.
+ */
+function useTranslationsDictionary(local) {
+    const context = useOptionalDevicContext();
+    const scoped = useContext(TranslationsScope);
+    const global = context?.translations;
+    return useMemo(() => mergeTranslations(global, scoped, local), [global, scoped, local]);
+}
+/**
+ * Returns `t`, the translator for every text this library renders itself.
+ *
+ * Works with or without a `DevicProvider`: with no dictionary anywhere it
+ * returns the English text unchanged, which is what a component mounted
+ * standalone gets.
+ *
+ * @example
+ * ```tsx
+ * const t = useTranslations();
+ * <button aria-label={t('New chat')}>…</button>
+ * ```
+ */
+function useTranslations(local) {
+    const dictionary = useTranslationsDictionary(local);
+    return useMemo(() => createTranslator(dictionary), [dictionary]);
+}
+
+export { DevicTranslationsProvider, useTranslations, useTranslationsDictionary };
+//# sourceMappingURL=useTranslations.js.map

package/dist/esm/i18n/useTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslations.js","sources":["../../../src/i18n/useTranslations.tsx"],"sourcesContent":["import React, { createContext, useContext, useMemo } from 'react';\nimport { useOptionalDevicContext } from '../provider/DevicContext';\nimport { createTranslator, mergeTranslations } from './translate';\nimport type { DevicTranslations, Translator } from './types';\n\n/**\n * Dictionary contributed by an enclosing component, on top of the provider's.\n *\n * It exists so `<ChatDrawer options={{ translations }}>` reaches the input,\n * the message list and the dialogs it opens without every one of them taking\n * a prop for it. Nesting merges rather than replaces.\n */\nconst TranslationsScope = createContext<DevicTranslations | undefined>(undefined);\n\nexport interface DevicTranslationsProviderProps {\n  /** Entries added on top of the enclosing dictionaries. */\n  translations?: DevicTranslations;\n  children: React.ReactNode;\n}\n\n/**\n * Scopes a dictionary to a subtree. Rarely needed directly — the components\n * that take a `translations` option already wrap their own subtree with it —\n * but useful to translate one region of a page differently.\n */\nexport function DevicTranslationsProvider({\n  translations,\n  children,\n}: DevicTranslationsProviderProps): JSX.Element {\n  const outer = useContext(TranslationsScope);\n  const value = useMemo(\n    () => mergeTranslations(outer, translations),\n    [outer, translations]\n  );\n  return (\n    <TranslationsScope.Provider value={value}>\n      {children}\n    </TranslationsScope.Provider>\n  );\n}\n\n/**\n * The dictionary in force here: the provider's, plus any scoped by an\n * enclosing component, plus the `local` argument. Later layers win.\n */\nexport function useTranslationsDictionary(\n  local?: DevicTranslations\n): DevicTranslations | undefined {\n  const context = useOptionalDevicContext();\n  const scoped = useContext(TranslationsScope);\n  const global = context?.translations;\n  return useMemo(\n    () => mergeTranslations(global, scoped, local),\n    [global, scoped, local]\n  );\n}\n\n/**\n * Returns `t`, the translator for every text this library renders itself.\n *\n * Works with or without a `DevicProvider`: with no dictionary anywhere it\n * returns the English text unchanged, which is what a component mounted\n * standalone gets.\n *\n * @example\n * ```tsx\n * const t = useTranslations();\n * <button aria-label={t('New chat')}>…</button>\n * ```\n */\nexport function useTranslations(local?: DevicTranslations): Translator {\n  const dictionary = useTranslationsDictionary(local);\n  return useMemo(() => createTranslator(dictionary), [dictionary]);\n}\n"],"names":["_jsx"],"mappings":";;;;;AAKA;;;;;;AAMG;AACH,MAAM,iBAAiB,GAAG,aAAa,CAAgC,SAAS,CAAC;AAQjF;;;;AAIG;SACa,yBAAyB,CAAC,EACxC,YAAY,EACZ,QAAQ,GACuB,EAAA;AAC/B,IAAA,MAAM,KAAK,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CACnB,MAAM,iBAAiB,CAAC,KAAK,EAAE,YAAY,CAAC,EAC5C,CAAC,KAAK,EAAE,YAAY,CAAC,CACtB;AACD,IAAA,QACEA,GAAA,CAAC,iBAAiB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,KAAK,EAAA,QAAA,EACrC,QAAQ,EAAA,CACkB;AAEjC;AAEA;;;AAGG;AACG,SAAU,yBAAyB,CACvC,KAAyB,EAAA;AAEzB,IAAA,MAAM,OAAO,GAAG,uBAAuB,EAAE;AACzC,IAAA,MAAM,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC;AAC5C,IAAA,MAAM,MAAM,GAAG,OAAO,EAAE,YAAY;IACpC,OAAO,OAAO,CACZ,MAAM,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAC9C,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CACxB;AACH;AAEA;;;;;;;;;;;;AAYG;AACG,SAAU,eAAe,CAAC,KAAyB,EAAA;AACvD,IAAA,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC;AACnD,IAAA,OAAO,OAAO,CAAC,MAAM,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AAClE;;"}

package/dist/esm/index.d.ts

@@ -1,7 +1,9 @@
 export { DevicProvider, DevicContext, useDevicContext, useOptionalDevicContext } from './provider';
 export type { DevicProviderConfig, DevicProviderProps, DevicContextValue, TenantMetadata, SubtenantMetadata, AIReference, DrawerRegistration, } from './provider';
-export { ChatDrawer, ChatMessages, ChatInput, ToolTimeline, ConversationSelector, HandoffSubagentWidget, ReferenceChip, UsageBar, LimitBanner, QueueNotice, RecalledMemoriesWidget, CompactionWidget } from './components/ChatDrawer';
-export type { ChatDrawerProps, ChatDrawerOptions, ChatDrawerHandle, ChatMessagesProps, ChatInputProps, CustomPromptBoxProps, MessageBubbleRenderer, MessageBubbleRendererProps, ToolTimelineProps, AllowedFileTypes, ConversationSelectorProps, HandoffSubagentWidgetProps, ReferenceChipProps, ReferenceChipVariant, SuggestedMessage, UsageBarProps, UsageBarDisplay, UsageBarData, LimitBannerProps, QueueNoticeProps, RecalledMemoriesWidgetProps, RecalledMemoriesRenderer, RecalledMemoriesRendererProps, CompactionWidgetProps, CompactionRenderer, CompactionRendererProps, } from './components/ChatDrawer';
+export { DevicTranslationsProvider, useTranslations, useTranslationsDictionary, createTranslator, translate, mergeTranslations, fillTemplate, } from './i18n';
+export type { DevicTranslations, Translator, DevicTranslationsProviderProps, } from './i18n';
+export { ChatDrawer, ChatMessages, ChatInput, ToolTimeline, ConversationSelector, HandoffSubagentWidget, ReferenceChip, UsageBar, LimitBanner, QueueNotice, RecalledMemoriesWidget, CompactionWidget, GuardrailNotice } from './components/ChatDrawer';
+export type { ChatDrawerProps, ChatDrawerOptions, ChatDrawerHandle, ChatMessagesProps, ChatInputProps, CustomPromptBoxProps, MessageBubbleRenderer, MessageBubbleRendererProps, ToolTimelineProps, AllowedFileTypes, ConversationSelectorProps, HandoffSubagentWidgetProps, ReferenceChipProps, ReferenceChipVariant, SuggestedMessage, UsageBarProps, UsageBarDisplay, UsageBarData, LimitBannerProps, QueueNoticeProps, RecalledMemoriesWidgetProps, RecalledMemoriesRenderer, RecalledMemoriesRendererProps, CompactionWidgetProps, CompactionRenderer, CompactionRendererProps, GuardrailNoticeProps, GuardrailRenderer, GuardrailPayload, } from './components/ChatDrawer';
 export { CoreMemoryModal, DEFAULT_CORE_MEMORY_LABELS } from './components/CoreMemoryModal';
 export type { CoreMemoryModalProps, CoreMemoryLabels } from './components/CoreMemoryModal';
 export { IntegrationsModal, IntegrationsPanel, IntegrationsLauncher, IntegrationsHint, IntegrationLogo, useIntegrations, McpServersSection, McpConnectForm, useTenantMcp, integrationChoiceKey, readIntegrationChoice, writeIntegrationChoice, pruneIntegrationChoice, } from './components/IntegrationsModal';

package/dist/esm/index.js

@@ -1,5 +1,7 @@
 export { DevicProvider } from './provider/DevicProvider.js';
 export { DevicContext, useDevicContext, useOptionalDevicContext } from './provider/DevicContext.js';
+export { DevicTranslationsProvider, useTranslations, useTranslationsDictionary } from './i18n/useTranslations.js';
+export { createTranslator, fillTemplate, mergeTranslations, translate } from './i18n/translate.js';
 export { ChatDrawer } from './components/ChatDrawer/ChatDrawer.js';
 export { ChatMessages } from './components/ChatDrawer/ChatMessages.js';
 export { ChatInput } from './components/ChatDrawer/ChatInput.js';
@@ -12,6 +14,7 @@ export { LimitBanner } from './components/ChatDrawer/LimitBanner.js';
 export { QueueNotice } from './components/ChatDrawer/QueueNotice.js';
 export { RecalledMemoriesWidget } from './components/ChatDrawer/RecalledMemoriesWidget.js';
 export { CompactionWidget } from './components/ChatDrawer/CompactionWidget.js';
+export { GuardrailNotice } from './components/ChatDrawer/GuardrailNotice.js';
 export { CoreMemoryModal, DEFAULT_CORE_MEMORY_LABELS } from './components/CoreMemoryModal/CoreMemoryModal.js';
 export { IntegrationsModal } from './components/IntegrationsModal/IntegrationsModal.js';
 export { IntegrationsPanel } from './components/IntegrationsModal/IntegrationsPanel.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/provider/DevicProvider.d.ts

@@ -14,4 +14,4 @@ import type { DevicProviderProps } from './types';
  * </DevicProvider>
  * ```
  */
-export declare function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, debug, children, }: DevicProviderProps): JSX.Element;
+export declare function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, translations, debug, children, }: DevicProviderProps): JSX.Element;

package/dist/esm/provider/DevicProvider.js

@@ -21,7 +21,7 @@ const DEFAULT_BASE_URL = 'https://api.devic.ai';
  * </DevicProvider>
  * ```
  */
-function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, debug, children, }) {
+function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, translations, debug, children, }) {
     const [references, setReferences] = useState([]);
     const drawerRef = useRef(null);
     const addReference = useCallback((ref) => {
@@ -81,6 +81,7 @@ function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = D
         subtenantMetadata,
         tags,
         pollingInterval,
+        translations,
         isConfigured: !!apiKey || usesSessions,
         debug,
         references,
@@ -102,6 +103,7 @@ function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = D
         subtenantMetadata,
         tags,
         pollingInterval,
+        translations,
         debug,
         references,
         addReference,

package/dist/esm/provider/DevicProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevicProvider.js","sources":["../../../src/provider/DevicProvider.tsx"],"sourcesContent":["import React, { useMemo, useState, useRef, useCallback } from 'react';\nimport { DevicContext } from './DevicContext';\nimport { DevicApiClient } from '../api/client';\nimport { createSharedSession } from './sharedSession';\nimport { generateId } from '../utils';\nimport type {\n  DevicProviderProps,\n  DevicContextValue,\n  AIReference,\n  DrawerRegistration,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.devic.ai';\n\n/**\n * Provider component for Devic UI configuration\n *\n * @example\n * ```tsx\n * <DevicProvider\n *   apiKey=\"devic-xxx\"\n *   baseUrl=\"https://api.devic.ai\"\n *   tenantId=\"tenant-123\"\n *   tenantMetadata={{ userId: '456' }}\n * >\n *   <App />\n * </DevicProvider>\n * ```\n */\nexport function DevicProvider({\n  apiKey,\n  getTenantSession,\n  onSessionExpired,\n  baseUrl = DEFAULT_BASE_URL,\n  tenantId,\n  tenantMetadata,\n  subtenantId,\n  subtenantMetadata,\n  tags,\n  pollingInterval,\n  debug,\n  children,\n}: DevicProviderProps): JSX.Element {\n  const [references, setReferences] = useState<AIReference[]>([]);\n  const drawerRef = useRef<DrawerRegistration | null>(null);\n\n  const addReference = useCallback((ref: Omit<AIReference, 'id'>): string => {\n    const id = generateId();\n    setReferences((prev) => [...prev, { ...ref, id }]);\n    return id;\n  }, []);\n\n  const removeReference = useCallback((id: string) => {\n    setReferences((prev) => prev.filter((r) => r.id !== id));\n  }, []);\n\n  const clearReferences = useCallback(() => {\n    setReferences([]);\n  }, []);\n\n  const registerDrawer = useCallback((handle: DrawerRegistration) => {\n    drawerRef.current = handle;\n    return () => {\n      if (drawerRef.current === handle) {\n        drawerRef.current = null;\n      }\n    };\n  }, []);\n\n  const openDrawer = useCallback(() => {\n    drawerRef.current?.open();\n  }, []);\n\n  // Both callbacks are read through a ref and handed on as stable wrappers.\n  // An inline `getTenantSession={() => …}` is a new function on every render,\n  // and passing it straight through would rebuild the client — throwing away\n  // the session it holds, so the page fetches a token per render — and rebuild\n  // the context, so every component below it would do the same.\n  const sessionSourceRef = useRef(getTenantSession);\n  sessionSourceRef.current = getTenantSession;\n  const expiredRef = useRef(onSessionExpired);\n  expiredRef.current = onSessionExpired;\n  const usesSessions = !!getTenantSession;\n\n  // One session for the whole tree: every component below builds its own API\n  // client, and each dedupes only its own renewals — so without this, N clients\n  // ask for N tokens. See `createSharedSession`.\n  const tenantSession = useMemo(\n    () =>\n      usesSessions\n        ? createSharedSession(() => sessionSourceRef.current!())\n        : undefined,\n    [usesSessions]\n  );\n  const sessionExpired = useMemo(() => () => expiredRef.current?.(), []);\n\n  const client = useMemo(\n    () =>\n      new DevicApiClient({\n        apiKey,\n        baseUrl,\n        getTenantSession: tenantSession,\n        onSessionExpired: sessionExpired,\n      }),\n    [apiKey, baseUrl, tenantSession, sessionExpired]\n  );\n\n  const contextValue = useMemo<DevicContextValue>(\n    () => ({\n      client,\n      apiKey,\n      getTenantSession: tenantSession,\n      onSessionExpired: sessionExpired,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      isConfigured: !!apiKey || usesSessions,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    }),\n    [\n      client,\n      apiKey,\n      tenantSession,\n      sessionExpired,\n      usesSessions,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    ]\n  );\n\n  return (\n    <DevicContext.Provider value={contextValue}>\n      {children}\n    </DevicContext.Provider>\n  );\n}\n"],"names":["_jsx"],"mappings":";;;;;;;AAYA,MAAM,gBAAgB,GAAG,sBAAsB;AAE/C;;;;;;;;;;;;;;AAcG;AACG,SAAU,aAAa,CAAC,EAC5B,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,GAAG,gBAAgB,EAC1B,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,IAAI,EACJ,eAAe,EACf,KAAK,EACL,QAAQ,GACW,EAAA;IACnB,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC;AAC/D,IAAA,MAAM,SAAS,GAAG,MAAM,CAA4B,IAAI,CAAC;AAEzD,IAAA,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,GAA4B,KAAY;AACxE,QAAA,MAAM,EAAE,GAAG,UAAU,EAAE;AACvB,QAAA,aAAa,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;AAClD,QAAA,OAAO,EAAE;IACX,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,EAAU,KAAI;QACjD,aAAa,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,MAAM,eAAe,GAAG,WAAW,CAAC,MAAK;QACvC,aAAa,CAAC,EAAE,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,MAA0B,KAAI;AAChE,QAAA,SAAS,CAAC,OAAO,GAAG,MAAM;AAC1B,QAAA,OAAO,MAAK;AACV,YAAA,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE;AAChC,gBAAA,SAAS,CAAC,OAAO,GAAG,IAAI;YAC1B;AACF,QAAA,CAAC;IACH,CAAC,EAAE,EAAE,CAAC;AAEN,IAAA,MAAM,UAAU,GAAG,WAAW,CAAC,MAAK;AAClC,QAAA,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;IAC3B,CAAC,EAAE,EAAE,CAAC;;;;;;AAON,IAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;AACjD,IAAA,gBAAgB,CAAC,OAAO,GAAG,gBAAgB;AAC3C,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,CAAC;AAC3C,IAAA,UAAU,CAAC,OAAO,GAAG,gBAAgB;AACrC,IAAA,MAAM,YAAY,GAAG,CAAC,CAAC,gBAAgB;;;;AAKvC,IAAA,MAAM,aAAa,GAAG,OAAO,CAC3B,MACE;UACI,mBAAmB,CAAC,MAAM,gBAAgB,CAAC,OAAQ,EAAE;AACvD,UAAE,SAAS,EACf,CAAC,YAAY,CAAC,CACf;AACD,IAAA,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,MAAM,UAAU,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IAEtE,MAAM,MAAM,GAAG,OAAO,CACpB,MACE,IAAI,cAAc,CAAC;QACjB,MAAM;QACN,OAAO;AACP,QAAA,gBAAgB,EAAE,aAAa;AAC/B,QAAA,gBAAgB,EAAE,cAAc;KACjC,CAAC,EACJ,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,CAAC,CACjD;AAED,IAAA,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO;QACL,MAAM;QACN,MAAM;AACN,QAAA,gBAAgB,EAAE,aAAa;AAC/B,QAAA,gBAAgB,EAAE,cAAc;QAChC,OAAO;QACP,QAAQ;QACR,cAAc;QACd,WAAW;QACX,iBAAiB;QACjB,IAAI;QACJ,eAAe;AACf,QAAA,YAAY,EAAE,CAAC,CAAC,MAAM,IAAI,YAAY;QACtC,KAAK;QACL,UAAU;QACV,YAAY;QACZ,eAAe;QACf,eAAe;QACf,cAAc;QACd,UAAU;AACX,KAAA,CAAC,EACF;QACE,MAAM;QACN,MAAM;QACN,aAAa;QACb,cAAc;QACd,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,cAAc;QACd,WAAW;QACX,iBAAiB;QACjB,IAAI;QACJ,eAAe;QACf,KAAK;QACL,UAAU;QACV,YAAY;QACZ,eAAe;QACf,eAAe;QACf,cAAc;QACd,UAAU;AACX,KAAA,CACF;AAED,IAAA,QACEA,GAAA,CAAC,YAAY,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,YAAY,EAAA,QAAA,EACvC,QAAQ,EAAA,CACa;AAE5B;;"}
+{"version":3,"file":"DevicProvider.js","sources":["../../../src/provider/DevicProvider.tsx"],"sourcesContent":["import React, { useMemo, useState, useRef, useCallback } from 'react';\nimport { DevicContext } from './DevicContext';\nimport { DevicApiClient } from '../api/client';\nimport { createSharedSession } from './sharedSession';\nimport { generateId } from '../utils';\nimport type {\n  DevicProviderProps,\n  DevicContextValue,\n  AIReference,\n  DrawerRegistration,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.devic.ai';\n\n/**\n * Provider component for Devic UI configuration\n *\n * @example\n * ```tsx\n * <DevicProvider\n *   apiKey=\"devic-xxx\"\n *   baseUrl=\"https://api.devic.ai\"\n *   tenantId=\"tenant-123\"\n *   tenantMetadata={{ userId: '456' }}\n * >\n *   <App />\n * </DevicProvider>\n * ```\n */\nexport function DevicProvider({\n  apiKey,\n  getTenantSession,\n  onSessionExpired,\n  baseUrl = DEFAULT_BASE_URL,\n  tenantId,\n  tenantMetadata,\n  subtenantId,\n  subtenantMetadata,\n  tags,\n  pollingInterval,\n  translations,\n  debug,\n  children,\n}: DevicProviderProps): JSX.Element {\n  const [references, setReferences] = useState<AIReference[]>([]);\n  const drawerRef = useRef<DrawerRegistration | null>(null);\n\n  const addReference = useCallback((ref: Omit<AIReference, 'id'>): string => {\n    const id = generateId();\n    setReferences((prev) => [...prev, { ...ref, id }]);\n    return id;\n  }, []);\n\n  const removeReference = useCallback((id: string) => {\n    setReferences((prev) => prev.filter((r) => r.id !== id));\n  }, []);\n\n  const clearReferences = useCallback(() => {\n    setReferences([]);\n  }, []);\n\n  const registerDrawer = useCallback((handle: DrawerRegistration) => {\n    drawerRef.current = handle;\n    return () => {\n      if (drawerRef.current === handle) {\n        drawerRef.current = null;\n      }\n    };\n  }, []);\n\n  const openDrawer = useCallback(() => {\n    drawerRef.current?.open();\n  }, []);\n\n  // Both callbacks are read through a ref and handed on as stable wrappers.\n  // An inline `getTenantSession={() => …}` is a new function on every render,\n  // and passing it straight through would rebuild the client — throwing away\n  // the session it holds, so the page fetches a token per render — and rebuild\n  // the context, so every component below it would do the same.\n  const sessionSourceRef = useRef(getTenantSession);\n  sessionSourceRef.current = getTenantSession;\n  const expiredRef = useRef(onSessionExpired);\n  expiredRef.current = onSessionExpired;\n  const usesSessions = !!getTenantSession;\n\n  // One session for the whole tree: every component below builds its own API\n  // client, and each dedupes only its own renewals — so without this, N clients\n  // ask for N tokens. See `createSharedSession`.\n  const tenantSession = useMemo(\n    () =>\n      usesSessions\n        ? createSharedSession(() => sessionSourceRef.current!())\n        : undefined,\n    [usesSessions]\n  );\n  const sessionExpired = useMemo(() => () => expiredRef.current?.(), []);\n\n  const client = useMemo(\n    () =>\n      new DevicApiClient({\n        apiKey,\n        baseUrl,\n        getTenantSession: tenantSession,\n        onSessionExpired: sessionExpired,\n      }),\n    [apiKey, baseUrl, tenantSession, sessionExpired]\n  );\n\n  const contextValue = useMemo<DevicContextValue>(\n    () => ({\n      client,\n      apiKey,\n      getTenantSession: tenantSession,\n      onSessionExpired: sessionExpired,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      translations,\n      isConfigured: !!apiKey || usesSessions,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    }),\n    [\n      client,\n      apiKey,\n      tenantSession,\n      sessionExpired,\n      usesSessions,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      translations,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    ]\n  );\n\n  return (\n    <DevicContext.Provider value={contextValue}>\n      {children}\n    </DevicContext.Provider>\n  );\n}\n"],"names":["_jsx"],"mappings":"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"}

package/dist/esm/provider/types.d.ts

@@ -1,4 +1,5 @@
 import type { DevicApiClient } from '../api/client';
+import type { DevicTranslations } from '../i18n/types';
 /**
  * Tenant-level identity metadata sent to the Devic API. Used for per-tenant
  * cost attribution and to enrich the tenant record (name, contact, logo).
@@ -138,6 +139,33 @@ export interface DevicProviderConfig {
      * @default 1000
      */
     pollingInterval?: number;
+    /**
+     * Translations for the texts the library renders itself — the drawer
+     * header, the input placeholder, the buttons and tooltips of every widget.
+     *
+     * A plain `English text → your text` map, so the values come from whatever
+     * i18n system the host already runs (i18next, react-intl, a JSON per
+     * locale): nothing is looked up here beyond the key. Anything absent stays
+     * in English, so a partial dictionary is fine, and texts already
+     * configurable on their own (`welcomeMessage`, `inputPlaceholder`, …) keep
+     * winning over it.
+     *
+     * Texts with a `{name}` placeholder keep it in the translation; the
+     * placeholders are filled after the lookup, so they may be reordered.
+     *
+     * @example
+     * ```tsx
+     * <DevicProvider
+     *   apiKey="devic-xxx"
+     *   translations={{
+     *     'New chat': 'Nueva conversación',
+     *     'Type a message...': 'Escribe un mensaje...',
+     *     'Close chat': 'Cerrar el chat',
+     *   }}
+     * >
+     * ```
+     */
+    translations?: DevicTranslations;
     /**
      * Enable debug logging to the browser console
      * @default false
@@ -219,6 +247,11 @@ export interface DevicContextValue {
      * integrator did not configure one, so each component keeps its own default.
      */
     pollingInterval?: number;
+    /**
+     * Translations for the texts the library renders itself, keyed by the
+     * English text. Undefined when the integrator configured none.
+     */
+    translations?: DevicTranslations;
     /**
      * Whether the provider is properly configured
      */