@uipath/apollo-vertex 0.1.0 → 0.3.0

package/README.md

@@ -23,31 +23,24 @@ import { Button, DataTable } from "@uipath/apollo-vertex";
 `tailwind.css` includes Tailwind, the Vertex theme and a `@source` for the package's built files. Use
 `@uipath/apollo-vertex/theme.css` instead if you only want the theme variables.
 
-Features that need extra packages live on subpaths. Install the optional peer dependencies for the
-subpaths you use:
-
-| Subpath | Contents | Extra packages |
-| --- | --- | --- |
-| `.` | Primitives, forms, data table, sidebar | None |
-| `./charts` | Charts, chart models, Data Fabric and Insights adapters | `recharts`, `@tanstack/react-query`, `@ts-rest/core`, `react-error-boundary` |
-| `./shell` | App shell, auth, locale and theme providers | `@tanstack/react-query`, `@tanstack/react-router`, `jwt-decode`, `pkce-challenge` |
-| `./shell/entities` | Group membership and entity table hooks | `./shell` packages, `@uipath/vs-core`, `@tanstack/react-db` |
-| `./feature-flags` | Feature flag provider, guard and hooks | None |
-| `./feature-flags/proteus` | Proteus feature flag adapter | `@uipath/proteus-client` |
-| `./solution-tests` | Presentational Solution Tests views | `@tanstack/react-router`, `recharts` |
-| `./solution-tests/data` | Solution Tests containers and hooks | `./solution-tests` packages, `@uipath/vs-core`, `@tanstack/react-db`, `@tanstack/react-query`, `@uipath/uipath-typescript` |
-| `./ai-chat` | AI chat and data fabric chat tools | `@tanstack/ai`, `@tanstack/ai-client`, `@tanstack/react-query`, `@uipath/uipath-typescript`, `eventsource-parser`, `highlight.js`, `react-markdown`, `remark-breaks`, `remark-gfm`, `recharts`, `react-error-boundary`, `@ts-rest/core` |
-| `./locales/*` | Translation JSON files | None |
-
-`@uipath/vs-core`, `@uipath/proteus-client` and `@tanstack/react-db` are declared only in
-`peerDependenciesMeta` (as optional) and not in `peerDependencies`, because they are not on the public
-npm registry and pnpm would try to install them in this workspace. The host app provides them.
+Everything, including the app shell, charts, feature flags, Solution Tests and AI chat, is exported
+from the package root. Translation JSON files are available at `@uipath/apollo-vertex/locales/*`.
+
+npm 7+ and pnpm install the packages in `peerDependencies` automatically. Install these three
+yourself, because they are not on the public npm registry:
+
+- `@uipath/vs-core`
+- `@tanstack/react-db`
+- `@uipath/proteus-client`
+
+They are declared only in `peerDependenciesMeta` (as optional) so that pnpm does not try to install them
+in this workspace.
 
 ## Layout
 
 ```text
 packages/apollo-vertex/
-├── entries/           # Public API barrels, one per package.json export
+├── entries/           # Public API barrel (index.ts)
 ├── registry/          # Component sources, one directory per registry item
 ├── registry.json      # shadcn registry manifest (items, files, theme tokens)
 ├── lib/               # Helpers shipped with registry items (cn, asserts, i18n, auth)
@@ -76,6 +69,6 @@ pnpm format        # Biome
 1. Create the component in `registry/<component>/<component>.tsx`.
 2. Add a `@/components/ui/<component>` alias to `tsconfig.json` if other components import it.
 3. Add the item to `registry.json`.
-4. Export it from the matching barrel in `entries/` (the root `entries/index.ts` for primitives).
+4. Export it from `entries/index.ts`.
 5. Document it in `apps/apollo-vertex/content/docs/components/<component>.mdx`.
 6. Run `pnpm build` and `pnpm --filter apollo-vertex registry:build` to check both outputs.

package/dist/entries/index.d.ts

@@ -67,3 +67,99 @@ export * from "../registry/timeline";
 export { useIsMobile } from "../registry/use-mobile/use-mobile";
 export { type UseDataTableOptions, useDataTable, } from "../registry/use-data-table/useDataTable";
 export { cn } from "../lib/utils";
+export { addVertexTranslations } from "../lib/i18n";
+export * from "../registry/chart/chart";
+export * from "../registry/bar-chart/bar-chart";
+export * from "../registry/distribution-chart/distribution-chart";
+export * from "../registry/kpi-chart/kpi-chart";
+export * from "../registry/line-chart/line-chart";
+export * from "../registry/multi-line-chart/multi-line-chart";
+export * from "../registry/table-chart/table-chart";
+export * from "../registry/charts-core/charts-core";
+export * from "../registry/data-fabric-adapter/data-fabric-adapter";
+export * from "../registry/insights-adapter/insights-adapter";
+export { ApolloShell, type ApolloShellProps, type CompanyLogo, type ShellNavItem, type ShellSubNavItem, } from "../registry/shell/shell";
+export { AuthContext, ShellAuthProvider, useAuth, type AuthContextValue, type UserInfo, } from "../registry/shell/shell-auth-provider";
+export { LocaleProvider } from "../registry/shell/shell-locale-provider";
+export { ThemeProvider } from "../registry/shell/shell-theme-provider";
+export { MembershipDenied, VerifyingMembership, type MembershipDeniedProps, } from "../registry/shell/group-membership-screens";
+export { Role } from "../registry/shell/shell-roles";
+export { useAccessToken } from "../registry/shell/shell-auth-provider";
+export { useTheme } from "../registry/shell/shell-theme-provider";
+export { ShellLogin } from "../registry/shell/shell-login";
+export { ShellLayout } from "../registry/shell/shell-layout";
+export { ShellSidebar } from "../registry/shell/shell-sidebar";
+export { ShellUserProvider } from "../registry/shell/shell-user-provider";
+export { SUPPORTED_LOCALES, configurei18n, type SupportedLocale, } from "../lib/i18n";
+export { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, login, logout, resolveReturnPath, toCodedAppFilePath, } from "../lib/auth";
+export { GroupMembershipGuard } from "../registry/shell/group-membership-guard";
+export { useGroupId } from "../registry/shell/use-group-id";
+export { useGroupMembers } from "../registry/shell/use-group-members";
+export { useIsGroupMember } from "../registry/shell/use-is-group-member";
+export { useEntityDataTable } from "../registry/use-data-table/useEntityDataTable";
+export { useEntityColumns } from "../registry/use-data-table/useEntityColumns";
+export { FeatureFlagContext, FeatureFlagProvider, useFeatureFlagProvider, } from "../registry/feature-flag-provider/feature-flag-provider";
+export { FeatureFlagGuard } from "../registry/feature-flag-guard/feature-flag-guard";
+export { ProtectedFeatureRoute } from "../registry/protected-feature-route/protected-feature-route";
+export { useFeatureFlag } from "../registry/use-feature-flag/use-feature-flag";
+export type { FeatureFlagProviderConfig, FeatureFlagUserContext, } from "../registry/feature-flag-provider/types";
+export { createProteusProvider, type FlagMapping, type ProteusFeatureFlagValues, } from "../registry/feature-flag-provider/proteus-adapter";
+export { SolutionTestsView } from "../registry/solution-tests/solution-tests-view";
+export type { SolutionTestsViewProps } from "../registry/solution-tests/solution-tests-view";
+export { SaveAsTestButton } from "../registry/solution-tests/save-as-test-button";
+export { SolutionTestActionError } from "../registry/solution-tests/errors";
+export type { ActionFailure } from "../registry/solution-tests/errors";
+export { SolutionTestsProvider, useSolutionTestsContext, useSolutionTestsConfig, } from "../registry/solution-tests/context";
+export type { SolutionTestsConfig, ResolvedSolutionTestsConfig, SolutionTestEventMap, SolutionTestEventName, TrackSolutionTestEvent, } from "../registry/solution-tests/config";
+export { makeRenderer, genericRenderer, resolveEvaluatorRenderer, GENERIC_RENDERER, JSON_SIMILARITY_EVALUATOR_ID, LLM_JUDGE_EVALUATOR_ID, IXP_EXTRACTION_EVALUATOR_ID, CASE_EVALUATION_EVALUATOR_ID, } from "../registry/solution-tests/evaluators/registry";
+export type { EvaluatorRenderer, EvaluatorRenderers, EvaluatorRenderArgs, EvaluatorResultProps, } from "../registry/solution-tests/evaluators/registry";
+export { makeProcessOutputRenderer, resolveProcessOutputRenderer, } from "../registry/solution-tests/outputs/registry";
+export type { ProcessOutputRenderer, ProcessOutputRenderers, ProcessOutputRenderArgs, ProcessOutputProps, } from "../registry/solution-tests/outputs/registry";
+export { ProcessOutputView } from "../registry/solution-tests/outputs/process-output-view";
+export { BaselineCompare } from "../registry/solution-tests/baseline-compare";
+export type { BaselineCompareRow } from "../registry/solution-tests/baseline-compare";
+export { VersionDeltaGlyph } from "../registry/solution-tests/version-delta-glyph";
+export { versionDelta } from "../registry/solution-tests/utils";
+export type { VersionDelta } from "../registry/solution-tests/utils";
+export { IxpOutputResult, IXP_OUTPUT_RENDERER, } from "../registry/solution-tests/outputs/ixp-extraction/ixp-output-result";
+export { IxpOutputSchema } from "../registry/solution-tests/outputs/ixp-extraction/schema";
+export { CaseEvaluationOutputResult, CASE_EVALUATION_OUTPUT_RENDERER, } from "../registry/solution-tests/outputs/case-evaluation/case-evaluation-output";
+export { CaseEvaluationOutputSchema } from "../registry/solution-tests/outputs/case-evaluation/schema";
+export type { CaseEvaluationOutput, EvaluationRecord, } from "../registry/solution-tests/outputs/case-evaluation/schema";
+export type { IxpOutput, IxpDocumentExtraction, IxpExtractionGroup, IxpFieldValue, } from "../registry/solution-tests/outputs/ixp-extraction/schema";
+export { SolutionTestStatus, RunStatus, RunResultStatus, JobRole, } from "../registry/solution-tests/types";
+export type { SolutionTest, SolutionTestJob, SolutionTestRun, SolutionTestBatchRun, SolutionTestRunResult, UserMessageItem, ResultAttachmentField, } from "../registry/solution-tests/types";
+export type { RunConfirmTarget } from "../registry/solution-tests/solution-tests-view";
+export { RunDetailsView } from "../registry/solution-tests/run-details-view";
+export type { BaselineJobMap, RunDetailsViewProps, } from "../registry/solution-tests/run-details-view";
+export { ExpandedAgentsView } from "../registry/solution-tests/expanded-agents-view";
+export type { ExpandedAgentsViewProps } from "../registry/solution-tests/expanded-agents-view";
+export { ExpandedRunTestsView } from "../registry/solution-tests/expanded-run-tests-view";
+export type { ExpandedRunTestsViewProps } from "../registry/solution-tests/expanded-run-tests-view";
+export { CaseEvaluationDetailsSchema, EvaluationPairStatus, SummaryVerdict, } from "../registry/solution-tests/evaluators/case-evaluation/schema";
+export type { CaseEvaluationDetails, EvaluationPair, EvaluationView, } from "../registry/solution-tests/evaluators/case-evaluation/schema";
+export { IxpDetailsSchema, IxpDocStatus, IxpVerdict, } from "../registry/solution-tests/evaluators/ixp-extraction/schema";
+export type { IxpDetails, IxpDocument, IxpField, IxpProvenance, IxpVerdictValue, } from "../registry/solution-tests/evaluators/ixp-extraction/schema";
+export { SolutionTests } from "../registry/solution-tests/solution-tests";
+export { RunDetails } from "../registry/solution-tests/run-details";
+export { useSolutionTests, useSolutionTestBatchRuns, useSolutionTestRuns, useBaselineJobs, useRunResults, useRunTests, useCreateTest, useToggleTestActive, useDeleteTest, useForceStopBatch, useForceStopRun, useAdoptJob, useUpdateBaseline, useRemoveJobBaseline, useJobExpectedOutput, useResultAttachment, } from "../registry/solution-tests/hooks";
+export type { UseSolutionTestsResult, UseSolutionTestBatchRunsResult, UseSolutionTestRunsResult, UseBaselineJobsResult, UseRunResultsResult, MutationHook, AttachmentFetcher, } from "../registry/solution-tests/hooks";
+export { ExpandedAgents } from "../registry/solution-tests/expanded-agents";
+export { ExpandedRunTests } from "../registry/solution-tests/expanded-run-tests";
+export { createAgentHubConnection } from "../registry/ai-chat/adapters/agenthub/adapter";
+export type { AgentHubAdapterConfig, AgentHubVendor, } from "../registry/ai-chat/adapters/agenthub/adapter";
+export { createConversationalAgentConnection } from "../registry/ai-chat/adapters/conversational-agent/adapter";
+export type { ConversationalAgentAdapterConfig } from "../registry/ai-chat/adapters/conversational-agent/adapter";
+export { AiChat } from "../registry/ai-chat/components/ai-chat";
+export { AiChatEmptyState } from "../registry/ai-chat/components/ai-chat-empty-state";
+export { AutopilotGradientIcon } from "../registry/ai-chat/components/icons/autopilot-gradient";
+export * from "../registry/ai-chat/tools/choices";
+export type { Entity } from "../registry/ai-chat/tools/data-fabric/util/entities";
+export * from "../registry/ai-chat/tools/data-fabric-bar";
+export * from "../registry/ai-chat/tools/data-fabric-distribution";
+export * from "../registry/ai-chat/tools/data-fabric-kpi";
+export * from "../registry/ai-chat/tools/data-fabric-line";
+export * from "../registry/ai-chat/tools/data-fabric-multi-line";
+export * from "../registry/ai-chat/tools/data-fabric-table";
+export * from "../registry/ai-chat/tools/data-fabric";
+export type { MessageFeedbackType } from "../registry/ai-chat/types";

package/dist/entries/index.js

@@ -2,6 +2,59 @@ import { CheckboxField, RadioGroupField, SelectField, SubmitButton, SwitchField,
 import { useIsMobile } from "../registry/use-mobile/use-mobile.js";
 import { useDataTable } from "../registry/use-data-table/useDataTable.js";
 import { cn } from "../lib/utils.js";
+import { SUPPORTED_LOCALES, addVertexTranslations, configurei18n } from "../lib/i18n.js";
+import { ApolloShell } from "../registry/shell/shell.js";
+import { AuthContext, ShellAuthProvider, useAccessToken, useAuth } from "../registry/shell/shell-auth-provider.js";
+import { LocaleProvider } from "../registry/shell/shell-locale-provider.js";
+import { ThemeProvider, useTheme } from "../registry/shell/shell-theme-provider.js";
+import { MembershipDenied, VerifyingMembership } from "../registry/shell/group-membership-screens.js";
+import { Role } from "../registry/shell/shell-roles.js";
+import { ShellLogin } from "../registry/shell/shell-login.js";
+import { ShellLayout } from "../registry/shell/shell-layout.js";
+import { ShellSidebar } from "../registry/shell/shell-sidebar.js";
+import { ShellUserProvider } from "../registry/shell/shell-user-provider.js";
+import { STORAGE_KEYS, TOKEN_QUERY_KEY, ensureValidToken, login, logout, resolveReturnPath, toCodedAppFilePath } from "../lib/auth.js";
+import { GroupMembershipGuard } from "../registry/shell/group-membership-guard.js";
+import { useGroupId } from "../registry/shell/use-group-id.js";
+import { useGroupMembers } from "../registry/shell/use-group-members.js";
+import { useIsGroupMember } from "../registry/shell/use-is-group-member.js";
+import { useEntityDataTable } from "../registry/use-data-table/useEntityDataTable.js";
+import { useEntityColumns } from "../registry/use-data-table/useEntityColumns.js";
+import { FeatureFlagContext, FeatureFlagProvider, useFeatureFlagProvider } from "../registry/feature-flag-provider/feature-flag-provider.js";
+import { FeatureFlagGuard } from "../registry/feature-flag-guard/feature-flag-guard.js";
+import { ProtectedFeatureRoute } from "../registry/protected-feature-route/protected-feature-route.js";
+import { useFeatureFlag } from "../registry/use-feature-flag/use-feature-flag.js";
+import { createProteusProvider } from "../registry/feature-flag-provider/proteus-adapter.js";
+import { SolutionTestsView } from "../registry/solution-tests/solution-tests-view.js";
+import { SaveAsTestButton } from "../registry/solution-tests/save-as-test-button.js";
+import { SolutionTestActionError } from "../registry/solution-tests/errors.js";
+import { SolutionTestsProvider, useSolutionTestsConfig, useSolutionTestsContext } from "../registry/solution-tests/context.js";
+import { CASE_EVALUATION_EVALUATOR_ID, GENERIC_RENDERER, IXP_EXTRACTION_EVALUATOR_ID, JSON_SIMILARITY_EVALUATOR_ID, LLM_JUDGE_EVALUATOR_ID, genericRenderer, makeRenderer, resolveEvaluatorRenderer } from "../registry/solution-tests/evaluators/registry.js";
+import { makeProcessOutputRenderer, resolveProcessOutputRenderer } from "../registry/solution-tests/outputs/registry.js";
+import { ProcessOutputView } from "../registry/solution-tests/outputs/process-output-view.js";
+import { BaselineCompare } from "../registry/solution-tests/baseline-compare.js";
+import { VersionDeltaGlyph } from "../registry/solution-tests/version-delta-glyph.js";
+import { versionDelta } from "../registry/solution-tests/utils.js";
+import { IXP_OUTPUT_RENDERER, IxpOutputResult } from "../registry/solution-tests/outputs/ixp-extraction/ixp-output-result.js";
+import { IxpOutputSchema } from "../registry/solution-tests/outputs/ixp-extraction/schema.js";
+import { CASE_EVALUATION_OUTPUT_RENDERER, CaseEvaluationOutputResult } from "../registry/solution-tests/outputs/case-evaluation/case-evaluation-output.js";
+import { CaseEvaluationOutputSchema } from "../registry/solution-tests/outputs/case-evaluation/schema.js";
+import { JobRole, RunResultStatus, RunStatus, SolutionTestStatus } from "../registry/solution-tests/types.js";
+import { RunDetailsView } from "../registry/solution-tests/run-details-view.js";
+import { ExpandedAgentsView } from "../registry/solution-tests/expanded-agents-view.js";
+import { ExpandedRunTestsView } from "../registry/solution-tests/expanded-run-tests-view.js";
+import { CaseEvaluationDetailsSchema, EvaluationPairStatus, SummaryVerdict } from "../registry/solution-tests/evaluators/case-evaluation/schema.js";
+import { IxpDetailsSchema, IxpDocStatus, IxpVerdict } from "../registry/solution-tests/evaluators/ixp-extraction/schema.js";
+import { SolutionTests } from "../registry/solution-tests/solution-tests.js";
+import { RunDetails } from "../registry/solution-tests/run-details.js";
+import { useAdoptJob, useBaselineJobs, useCreateTest, useDeleteTest, useForceStopBatch, useForceStopRun, useJobExpectedOutput, useRemoveJobBaseline, useResultAttachment, useRunResults, useRunTests, useSolutionTestBatchRuns, useSolutionTestRuns, useSolutionTests, useToggleTestActive, useUpdateBaseline } from "../registry/solution-tests/hooks.js";
+import { ExpandedAgents } from "../registry/solution-tests/expanded-agents.js";
+import { ExpandedRunTests } from "../registry/solution-tests/expanded-run-tests.js";
+import { createAgentHubConnection } from "../registry/ai-chat/adapters/agenthub/adapter.js";
+import { createConversationalAgentConnection } from "../registry/ai-chat/adapters/conversational-agent/adapter.js";
+import { AiChat } from "../registry/ai-chat/components/ai-chat.js";
+import { AiChatEmptyState } from "../registry/ai-chat/components/ai-chat-empty-state.js";
+import { AutopilotGradientIcon } from "../registry/ai-chat/components/icons/autopilot-gradient.js";
 export * from "../registry/accordion/accordion.js";
 export * from "../registry/ai-caveat/ai-caveat.js";
 export * from "../registry/ai-glow/ai-glow.js";
@@ -67,4 +120,22 @@ export * from "../registry/onboarding-tour-joyride/index.js";
 export * from "../registry/sidebar/sidebar.js";
 export * from "../registry/stepper/index.js";
 export * from "../registry/timeline/index.js";
-export { CheckboxField, RadioGroupField, SelectField, SubmitButton, SwitchField, TextField, TextareaField, cn, useAppForm, useDataTable, useFieldContext, useFormContext, useIsMobile, useTranslatedErrors, withForm };
+export * from "../registry/chart/chart.js";
+export * from "../registry/bar-chart/bar-chart.js";
+export * from "../registry/distribution-chart/distribution-chart.js";
+export * from "../registry/kpi-chart/kpi-chart.js";
+export * from "../registry/line-chart/line-chart.js";
+export * from "../registry/multi-line-chart/multi-line-chart.js";
+export * from "../registry/table-chart/table-chart.js";
+export * from "../registry/charts-core/charts-core.js";
+export * from "../registry/data-fabric-adapter/data-fabric-adapter.js";
+export * from "../registry/insights-adapter/insights-adapter.js";
+export * from "../registry/ai-chat/tools/choices/index.js";
+export * from "../registry/ai-chat/tools/data-fabric-bar/index.js";
+export * from "../registry/ai-chat/tools/data-fabric-distribution/index.js";
+export * from "../registry/ai-chat/tools/data-fabric-kpi/index.js";
+export * from "../registry/ai-chat/tools/data-fabric-line/index.js";
+export * from "../registry/ai-chat/tools/data-fabric-multi-line/index.js";
+export * from "../registry/ai-chat/tools/data-fabric-table/index.js";
+export * from "../registry/ai-chat/tools/data-fabric/index.js";
+export { AiChat, AiChatEmptyState, ApolloShell, AuthContext, AutopilotGradientIcon, BaselineCompare, CASE_EVALUATION_EVALUATOR_ID, CASE_EVALUATION_OUTPUT_RENDERER, CaseEvaluationDetailsSchema, CaseEvaluationOutputResult, CaseEvaluationOutputSchema, CheckboxField, EvaluationPairStatus, ExpandedAgents, ExpandedAgentsView, ExpandedRunTests, ExpandedRunTestsView, FeatureFlagContext, FeatureFlagGuard, FeatureFlagProvider, GENERIC_RENDERER, GroupMembershipGuard, IXP_EXTRACTION_EVALUATOR_ID, IXP_OUTPUT_RENDERER, IxpDetailsSchema, IxpDocStatus, IxpOutputResult, IxpOutputSchema, IxpVerdict, JSON_SIMILARITY_EVALUATOR_ID, JobRole, LLM_JUDGE_EVALUATOR_ID, LocaleProvider, MembershipDenied, ProcessOutputView, ProtectedFeatureRoute, RadioGroupField, Role, RunDetails, RunDetailsView, RunResultStatus, RunStatus, STORAGE_KEYS, SUPPORTED_LOCALES, SaveAsTestButton, SelectField, ShellAuthProvider, ShellLayout, ShellLogin, ShellSidebar, ShellUserProvider, SolutionTestActionError, SolutionTestStatus, SolutionTests, SolutionTestsProvider, SolutionTestsView, SubmitButton, SummaryVerdict, SwitchField, TOKEN_QUERY_KEY, TextField, TextareaField, ThemeProvider, VerifyingMembership, VersionDeltaGlyph, addVertexTranslations, cn, configurei18n, createAgentHubConnection, createConversationalAgentConnection, createProteusProvider, ensureValidToken, genericRenderer, login, logout, makeProcessOutputRenderer, makeRenderer, resolveEvaluatorRenderer, resolveProcessOutputRenderer, resolveReturnPath, toCodedAppFilePath, useAccessToken, useAdoptJob, useAppForm, useAuth, useBaselineJobs, useCreateTest, useDataTable, useDeleteTest, useEntityColumns, useEntityDataTable, useFeatureFlag, useFeatureFlagProvider, useFieldContext, useForceStopBatch, useForceStopRun, useFormContext, useGroupId, useGroupMembers, useIsGroupMember, useIsMobile, useJobExpectedOutput, useRemoveJobBaseline, useResultAttachment, useRunResults, useRunTests, useSolutionTestBatchRuns, useSolutionTestRuns, useSolutionTests, useSolutionTestsConfig, useSolutionTestsContext, useTheme, useToggleTestActive, useTranslatedErrors, useUpdateBaseline, versionDelta, withForm };

package/dist/lib/i18n.d.ts

@@ -1,3 +1,4 @@
+import type { i18n as I18n } from "i18next";
 declare const localeLoaders: {
     readonly en: () => Promise<{
         default: {
@@ -8812,5 +8813,15 @@ declare const localeLoaders: {
 };
 export type SupportedLocale = keyof typeof localeLoaders;
 export declare const SUPPORTED_LOCALES: SupportedLocale[];
+/**
+ * Adds the translations bundled with Apollo Vertex to an existing i18next
+ * instance, under the `apollo-vertex` namespace. Use this when the app sets up
+ * i18next itself instead of using `LocaleProvider`.
+ *
+ * Loads the current language and its fallbacks up front, and loads other
+ * languages when the app switches to them. Returns a function that stops
+ * listening.
+ */
+export declare const addVertexTranslations: (instance: I18n) => Promise<() => void>;
 export declare const configurei18n: () => Promise<void>;
 export {};

package/dist/lib/i18n.js

@@ -1,5 +1,6 @@
 import i18next from "i18next";
 import { initReactI18next } from "react-i18next";
+import { VERTEX_NAMESPACE } from "./vertex-translation.js";
 const localeLoaders = {
     en: ()=>import("../locales/en.json"),
     de: ()=>import("../locales/de.json"),
@@ -18,11 +19,35 @@ const localeLoaders = {
 };
 const SUPPORTED_LOCALES = Object.keys(localeLoaders);
 const DEFAULT_LOCALE = "en";
+const isSupportedLocale = (language)=>language in localeLoaders;
+const loadVertexLocale = async (instance, language)=>{
+    if (!isSupportedLocale(language) || instance.hasResourceBundle(language, VERTEX_NAMESPACE)) return false;
+    const { default: translations } = await localeLoaders[language]();
+    instance.addResourceBundle(language, VERTEX_NAMESPACE, translations);
+    return true;
+};
+const addVertexTranslations = async (instance)=>{
+    const loadCurrentLanguages = async ()=>{
+        const added = await Promise.all([
+            ...instance.languages,
+            DEFAULT_LOCALE
+        ].map((language)=>loadVertexLocale(instance, language)));
+        return added.includes(true);
+    };
+    const handleLanguageChanged = (language)=>{
+        loadCurrentLanguages().then((added)=>{
+            if (added && instance.language === language) return instance.changeLanguage(language);
+        });
+    };
+    instance.on("languageChanged", handleLanguageChanged);
+    await loadCurrentLanguages();
+    return ()=>instance.off("languageChanged", handleLanguageChanged);
+};
 const configurei18n = async ()=>{
     await i18next.use({
         type: "backend",
         async read (language, _namespace, callback) {
-            if (!(language in localeLoaders)) return void callback(new Error(`Locale not found: ${language}`), null);
+            if (!isSupportedLocale(language)) return void callback(new Error(`Locale not found: ${language}`), null);
             const loadLocale = localeLoaders[language];
             try {
                 const module = await loadLocale();
@@ -35,8 +60,13 @@ const configurei18n = async ()=>{
         fallbackLng: DEFAULT_LOCALE,
         lng: DEFAULT_LOCALE,
         supportedLngs: SUPPORTED_LOCALES,
+        ns: [
+            "translation",
+            VERTEX_NAMESPACE
+        ],
+        defaultNS: "translation",
         returnNull: false
     });
     document.documentElement.lang = i18next.language;
 };
-export { SUPPORTED_LOCALES, configurei18n };
+export { SUPPORTED_LOCALES, addVertexTranslations, configurei18n };

package/dist/lib/vertex-translation.d.ts

@@ -0,0 +1,14 @@
+/** i18next namespace that Apollo Vertex components read their strings from. */
+export declare const VERTEX_NAMESPACE = "apollo-vertex";
+/**
+ * `useTranslation` bound to the vertex namespace. Internal to vertex
+ * components: apps never read vertex strings themselves.
+ */
+export declare const useVertexTranslation: () => {
+    t: import("./react-i18next").TranslationFn;
+    i18n: {
+        exists: (key: string) => key is import("react-i18next").ParseKeys;
+        changeLanguage: (locale: string) => void;
+        language: string;
+    };
+};

package/dist/lib/vertex-translation.js

@@ -0,0 +1,4 @@
+import { useTranslation } from "react-i18next";
+const VERTEX_NAMESPACE = "apollo-vertex";
+const useVertexTranslation = ()=>useTranslation(VERTEX_NAMESPACE);
+export { VERTEX_NAMESPACE, useVertexTranslation };

package/dist/registry/ai-caveat/ai-caveat.js

@@ -1,10 +1,10 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Info } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { cn } from "../../lib/utils.js";
 function AiCaveat({ variant = "standalone", children, className }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const defaultCopy = t("ai_caveat_default", {
         defaultValue: "The output is AI generated. Please review."
     });

package/dist/registry/ai-chat/charts/no-data-message.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 function NoDataMessage() {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     return /*#__PURE__*/ jsx("p", {
         className: "text-sm text-muted-foreground",
         children: t("no_results")

package/dist/registry/ai-chat/charts/tool-resolution-error.js

@@ -1,9 +1,9 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { AlertTriangle } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 function ToolResolutionError({ failure }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const { reason, ...params } = failure;
     return /*#__PURE__*/ jsx("div", {
         role: "alert",

package/dist/registry/ai-chat/components/ai-chat-code-block.js

@@ -13,7 +13,7 @@ import typescript from "highlight.js/lib/languages/typescript";
 import xml from "highlight.js/lib/languages/xml";
 import { Check, Copy } from "lucide-react";
 import { useEffect, useRef } from "react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../../tooltip/tooltip.js";
 import { cn } from "../../../lib/utils.js";
 const DARK_HLJS_STYLE = `
@@ -86,7 +86,7 @@ core.registerLanguage("html", xml);
 core.registerLanguage("xml", xml);
 core.registerLanguage("sql", sql);
 function AiChatCodeBlock({ children, language }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const { copied, error, copy } = useClipboard({
         timeout: 2000
     });

package/dist/registry/ai-chat/components/ai-chat-empty-state.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 function AiChatEmptyState({ title, description, icon }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const displayTitle = title ?? t("how_can_i_help_you");
     return /*#__PURE__*/ jsxs("div", {
         className: "flex flex-col items-center justify-center h-full text-center text-ai-chat-muted-foreground gap-4",

package/dist/registry/ai-chat/components/ai-chat-error-banner.js

@@ -1,10 +1,10 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { AlertCircle, RefreshCw } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 function AiChatErrorBanner({ message, onRetry }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     return /*#__PURE__*/ jsxs("div", {
         role: "alert",
         "aria-live": "assertive",

package/dist/registry/ai-chat/components/ai-chat-header.js

@@ -2,14 +2,14 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useClipboard } from "@mantine/hooks";
 import { MoreHorizontal } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger } from "../../alert-dialog/alert-dialog.js";
 import { Button } from "../../button/button.js";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from "../../dropdown-menu/dropdown-menu.js";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../../tooltip/tooltip.js";
 import { AutopilotGradientIcon } from "./icons/autopilot-gradient.js";
 function AiChatHeader({ title, hasMessages, conversationText, onClearChat }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const { copied, error, copy } = useClipboard({
         timeout: 2000
     });

package/dist/registry/ai-chat/components/ai-chat-image-preview.js

@@ -1,9 +1,9 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Dialog, DialogContent, DialogDescription, DialogTitle } from "../../dialog/dialog.js";
 function AiChatImagePreview({ url, onClose }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     return /*#__PURE__*/ jsx(Dialog, {
         open: !!url,
         onOpenChange: (open)=>!open && onClose(),

package/dist/registry/ai-chat/components/ai-chat-input.js

@@ -2,7 +2,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { ArrowUp, CircleStop, Paperclip, X } from "lucide-react";
 import { useImperativeHandle, useRef, useState } from "react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from "../../dropdown-menu/dropdown-menu.js";
 import { Tooltip, TooltipContent, TooltipTrigger } from "../../tooltip/tooltip.js";
@@ -12,7 +12,7 @@ import { AiChatImagePreview } from "./ai-chat-image-preview.js";
 import { AiChatInputGlow } from "./ai-chat-input-glow.js";
 import { AiChatPendingFiles } from "./ai-chat-pending-files.js";
 function AiChatInput({ value, onChange, onSubmit, onStop, isLoading, disabled = false, placeholder, hasMessages = false, acceptedFileTypes, quotedText, onClearQuote, ref }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const textareaRef = useRef(null);
     const fileInputRef = useRef(null);
     const [focused, setFocused] = useState(false);

package/dist/registry/ai-chat/components/ai-chat-loading.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { motion, useReducedMotion } from "framer-motion";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { ENTRANCE_ANIMATE, ENTRANCE_EASE, ENTRANCE_INITIAL } from "../animations.js";
 import { AiChatThinking } from "./ai-chat-thinking.js";
 const ENTRANCE_DURATION = 0.5;
@@ -9,7 +9,7 @@ const TEXT_DELAY = 0.9;
 const TEXT_DURATION = 0.3;
 const TEXT_OVERLAP_PX = -7;
 function AiChatLoading() {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const prefersReducedMotion = useReducedMotion();
     const thinkingLabel = t("thinking");
     const shimmerStyle = prefersReducedMotion ? {} : {

package/dist/registry/ai-chat/components/ai-chat-message-actions.js

@@ -3,7 +3,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useClipboard } from "@mantine/hooks";
 import { Root } from "@radix-ui/react-tooltip";
 import { Check, Copy, Pencil, RefreshCw, ThumbsDown, ThumbsUp } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 import { TooltipContent, TooltipProvider, TooltipTrigger } from "../../tooltip/tooltip.js";
 import { cn } from "../../../lib/utils.js";
@@ -32,7 +32,7 @@ function IconActionButton({ icon, label, onClick, pressed }) {
     });
 }
 function CopyToClipboardButton({ value }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const { copied, error, copy } = useClipboard({
         timeout: 2000
     });
@@ -51,7 +51,7 @@ function CopyToClipboardButton({ value }) {
 }
 const ICON_CLASSES = "size-3.5 text-ai-chat-muted-foreground";
 function AiChatMessageActions({ content, messageRole, isLatest = false, feedback, onFeedback, onRegenerate, onEdit }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     return /*#__PURE__*/ jsx(TooltipProvider, {
         delayDuration: 0,
         skipDelayDuration: 150,

package/dist/registry/ai-chat/components/ai-chat-message.js

@@ -3,7 +3,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { imagePartToUrl } from "../content-parts.js";
 import { motion } from "framer-motion";
 import { useState } from "react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 import { Textarea } from "../../textarea/textarea.js";
 import { ENTRANCE_ANIMATE, ENTRANCE_EASE, ENTRANCE_INITIAL } from "../animations.js";
@@ -31,7 +31,7 @@ function getImageParts(message) {
     return message.parts.filter((p)=>"image" === p.type);
 }
 function AiChatMessage({ message, children, hideActions = false, showActionsAlwaysVisible = false, feedback, onFeedback, onRegenerate, onEditMessage }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const isUser = "user" === message.role;
     const displayContent = getDisplayText(message);
     const imageParts = getImageParts(message);

package/dist/registry/ai-chat/components/ai-chat-pending-files.js

@@ -1,7 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { FileText, X } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 function formatFileSize(bytes) {
     if (bytes < 1024) return `${bytes} B`;
@@ -9,7 +9,7 @@ function formatFileSize(bytes) {
     return `${(bytes / 1048576).toFixed(1)} MB`;
 }
 function AiChatPendingFiles({ files, onRemove, onPreview }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     if (0 === files.length) return null;
     return /*#__PURE__*/ jsx("div", {
         className: "flex flex-wrap gap-1.5 px-3 pt-2",

package/dist/registry/ai-chat/components/ai-chat-scroll-to-bottom-button.js

@@ -1,10 +1,10 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { ArrowDown } from "lucide-react";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 function AiChatScrollToBottomButton({ onClick }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     return /*#__PURE__*/ jsx(Button, {
         type: "button",
         variant: "outline",

package/dist/registry/ai-chat/components/ai-chat-selection-menu.js

@@ -2,7 +2,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useTextSelection } from "@mantine/hooks";
 import { AnimatePresence, motion } from "framer-motion";
-import { useTranslation } from "react-i18next";
+import { useVertexTranslation } from "../../../lib/vertex-translation.js";
 import { Button } from "../../button/button.js";
 import { POP_ANIMATE, POP_EXIT, POP_INITIAL, POP_TRANSITION } from "../animations.js";
 import { AutopilotIcon } from "./icons/autopilot.js";
@@ -25,7 +25,7 @@ function deriveMenuState(selection, container) {
     };
 }
 function AiChatSelectionMenu({ onAskAi, containerRef }) {
-    const { t } = useTranslation();
+    const { t } = useVertexTranslation();
     const selection = useTextSelection();
     const menu = deriveMenuState(selection, containerRef?.current ?? null);
     return /*#__PURE__*/ jsx(AnimatePresence, {