@uipath/apollo-vertex 0.1.0 → 0.4.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)
@@ -67,6 +60,7 @@ pnpm build         # Generate theme.css, build dist/ with rslib, check every exp
 pnpm build:check   # List the external packages each public entry reaches
 pnpm lint          # oxlint (type-aware)
 pnpm lint:deps     # Check that registry files only import from registry/ and lib/
+pnpm -w knip       # Find unused files, exports and dependencies (both workspaces)
 pnpm typecheck     # tsc --noEmit
 pnpm format        # Biome
 ```
@@ -76,6 +70,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

@@ -58,7 +58,7 @@ export * from "../registry/toggle-group/toggle-group";
 export * from "../registry/tooltip/tooltip";
 export * from "../registry/confidence-signal/confidence-signal";
 export * from "../registry/data-table";
-export { CheckboxField, type CheckboxFieldProps, type FieldOption, RadioGroupField, type RadioGroupFieldProps, SelectField, type SelectFieldProps, SubmitButton, type SubmitButtonProps, SwitchField, type SwitchFieldProps, TextareaField, type TextareaFieldProps, TextField, type TextFieldProps, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm, } from "../registry/form";
+export { CheckboxField, type CheckboxFieldProps, FieldError as FormFieldError, type FieldErrorProps as FormFieldErrorProps, type FieldOption, RadioGroupField, type RadioGroupFieldProps, SelectField, type SelectFieldProps, SubmitButton, type SubmitButtonProps, SwitchField, type SwitchFieldProps, TextareaField, type TextareaFieldProps, TextField, type TextFieldProps, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm, } from "../registry/form";
 export * from "../registry/form-wizard";
 export * from "../registry/onboarding-tour-joyride";
 export * from "../registry/sidebar/sidebar";
@@ -67,3 +67,104 @@ 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 { assertDateOrString } from "../lib/asserts/assert-date-or-string";
+export { assertString } from "../lib/asserts/assert-string";
+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 { STALE_TIME_MS } from "../registry/shell/shell-constants";
+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, useUser, type User, } from "../registry/shell/shell-user-provider";
+export { SUPPORTED_LOCALES, configurei18n, type SupportedLocale, } from "../lib/i18n";
+export { STORAGE_KEYS, TOKEN_QUERY_KEY, type TokenData, ensureValidToken, login, logout, resolveReturnPath, toCodedAppFilePath, } from "../lib/auth";
+export { GroupMembershipGuard, type GroupMembershipGuardProps, } from "../registry/shell/group-membership-guard";
+export { useGroupId, type UseGroupIdOptions, type UseGroupIdResult, } from "../registry/shell/use-group-id";
+export { useGroupMembers, type UseGroupMembersOptions, type UseGroupMembersResult, } from "../registry/shell/use-group-members";
+export { useIsGroupMember } from "../registry/shell/use-is-group-member";
+export { useEntityDataTable, type UseEntityDataTableOptions, } 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, SolutionTestStatusValue, RunStatusValue, RunResultStatusValue, JobRoleValue, } 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 { NoDataMessage } from "../registry/ai-chat/charts/no-data-message";
+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 type { JoinInput } from "../registry/ai-chat/tools/data-fabric/util/joins";
+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

@@ -1,7 +1,64 @@
-import { CheckboxField, RadioGroupField, SelectField, SubmitButton, SwitchField, TextField, TextareaField, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm } from "../registry/form/index.js";
+import { CheckboxField, FieldError, RadioGroupField, SelectField, SubmitButton, SwitchField, TextField, TextareaField, useAppForm, useFieldContext, useFormContext, useTranslatedErrors, withForm } from "../registry/form/index.js";
 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 { assertDateOrString } from "../lib/asserts/assert-date-or-string.js";
+import { assertString } from "../lib/asserts/assert-string.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 { STALE_TIME_MS } from "../registry/shell/shell-constants.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, useUser } 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 { NoDataMessage } from "../registry/ai-chat/charts/no-data-message.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 +124,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, FieldError as FormFieldError, 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, NoDataMessage, ProcessOutputView, ProtectedFeatureRoute, RadioGroupField, Role, RunDetails, RunDetailsView, RunResultStatus, RunStatus, STALE_TIME_MS, 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, assertDateOrString, assertString, 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, useUser, 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",