@uipath/apollo-vertex 1.4.0 → 2.0.0

package/README.md

@@ -26,15 +26,10 @@ import { Button, DataTable } from "@uipath/apollo-vertex";
 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:
-
-- `@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. The two `@uipath` packages are not on the public npm registry.
+The Proteus feature flag adapter, `createProteusProvider`, is exported from
+`@uipath/apollo-vertex/proteus` instead of the root. It needs `@uipath/proteus-client`, which is not on
+the public npm registry, so it is declared only in `peerDependenciesMeta` (as optional). Install it
+yourself if you import that subpath.
 
 ## Layout
 

package/dist/entries/index.d.ts

@@ -106,7 +106,6 @@ export { FeatureFlagGuard } from "../registry/feature-flag-guard/feature-flag-gu
 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";

package/dist/entries/index.js

@@ -27,7 +27,6 @@ import { FeatureFlagContext, FeatureFlagProvider, useFeatureFlagProvider } from
 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";
@@ -145,4 +144,4 @@ 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, AiChatLoading, AiChatMarkdown, AiChatThinking, 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, getStoredIdToken, getTokenQueryKey, 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 };
+export { AiChat, AiChatEmptyState, AiChatLoading, AiChatMarkdown, AiChatThinking, 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, ensureValidToken, genericRenderer, getStoredIdToken, getTokenQueryKey, 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/entries/proteus.d.ts

@@ -0,0 +1 @@
+export { createProteusProvider, type FlagMapping, type ProteusFeatureFlagValues, } from "../registry/feature-flag-provider/proteus-adapter";

package/dist/entries/proteus.js

@@ -0,0 +1,2 @@
+import { createProteusProvider } from "../registry/feature-flag-provider/proteus-adapter.js";
+export { createProteusProvider };

package/dist/registry/solution-tests/use-solution-test-collection.d.ts

@@ -4,6 +4,7 @@
  * outside a SolutionProvider or when the named collection is not registered.
  */
 import type { Collection } from "@tanstack/react-db";
+import { useSolution } from "@uipath/vs-core";
 import { ENTITY } from "./constants";
 import type { SolutionTest, SolutionTestBatchRun, SolutionTestJob, SolutionTestRun, SolutionTestRunResult } from "./types";
 /** Row type stored in each Solution Tests collection, keyed by its entity name. */
@@ -14,5 +15,9 @@ type SolutionTestRow = {
     [ENTITY.jobs]: SolutionTestJob;
     [ENTITY.runResults]: SolutionTestRunResult;
 };
-export declare function useSolutionTestCollection<K extends keyof SolutionTestRow>(entity: K): Collection<SolutionTestRow[K]>;
+type SolutionTestCollection<T extends object> = Collection<T, string, {
+    refetch: () => Promise<void>;
+}>;
+export declare function getSolutionTestCollection<K extends keyof SolutionTestRow>(solution: ReturnType<typeof useSolution>, entity: K): SolutionTestCollection<SolutionTestRow[K]> | undefined;
+export declare function useSolutionTestCollection<K extends keyof SolutionTestRow>(entity: K): SolutionTestCollection<SolutionTestRow[K]>;
 export {};

package/dist/registry/solution-tests/use-solution-test-collection.js

@@ -1,11 +1,14 @@
 "use client";
 import { useSolution } from "@uipath/vs-core";
+function getSolutionTestCollection(solution, entity) {
+    const collections = solution.api.collections.solutionTests;
+    return collections[entity];
+}
 function useSolutionTestCollection(entity) {
     const solution = useSolution();
     if (!solution) throw new Error("useSolutionTestCollection must be used within a SolutionProvider.");
-    const selected = solution.api.collections.solutionTests[entity];
-    const collection = selected;
+    const collection = getSolutionTestCollection(solution, entity);
     if (!collection) throw new Error(`Solution Tests collection "${entity}" is unavailable.`);
     return collection;
 }
-export { useSolutionTestCollection };
+export { getSolutionTestCollection, useSolutionTestCollection };

package/dist/registry/solution-tests/use-solution-tests.js

@@ -4,7 +4,7 @@ import { useMutation } from "@tanstack/react-query";
 import { useSolution } from "@uipath/vs-core";
 import { ENTITY } from "./constants.js";
 import { useSolutionTestsActions, useSolutionTestsConfig } from "./context.js";
-import { useSolutionTestCollection } from "./use-solution-test-collection.js";
+import { getSolutionTestCollection, useSolutionTestCollection } from "./use-solution-test-collection.js";
 function useSolutionTests() {
     const collection = useSolutionTestCollection(ENTITY.tests);
     const { data, isLoading } = useLiveQuery((q)=>q.from({
@@ -47,7 +47,7 @@ function useToggleTestActive() {
     const { track } = useSolutionTestsConfig();
     return useMutation({
         mutationFn: async ({ testId, isActive })=>{
-            const collection = solution?.api.collections.solutionTests[ENTITY.tests];
+            const collection = solution && getSolutionTestCollection(solution, ENTITY.tests);
             if (!collection) throw new Error("Solution Tests collection is unavailable.");
             const transaction = collection.update(testId, (draft)=>{
                 draft.IsActive = isActive;

package/dist/registry/sonner/sonner.js

@@ -2,7 +2,6 @@
 import { jsx } from "react/jsx-runtime";
 import { CircleCheckIcon, InfoIcon, Loader2Icon, OctagonXIcon, TriangleAlertIcon } from "lucide-react";
 import { Toaster } from "sonner";
-import { useTheme } from "../shell/shell-theme-provider.js";
 const iconAlign = "[&>[data-icon]]:!items-start [&>[data-icon]>svg]:!mt-0.5";
 const statusTextClasses = "[&>[data-icon]>svg]:!text-[oklch(0.166_0.0283_203.34)] dark:[&>[data-icon]>svg]:!text-foreground [&_[data-title]]:!text-[oklch(0.166_0.0283_203.34)] dark:[&_[data-title]]:!text-foreground [&_[data-description]]:!text-[oklch(0.166_0.0283_203.34)] dark:[&_[data-description]]:!text-foreground [&_[data-close-button]]:!text-[oklch(0.166_0.0283_203.34)] dark:[&_[data-close-button]]:!text-foreground";
 const apolloToastClassNames = {
@@ -10,12 +9,11 @@ const apolloToastClassNames = {
     success: `!border-success !bg-[color-mix(in_srgb,var(--success)_25%,var(--card)_75%)] dark:!bg-[color-mix(in_srgb,var(--success)_25%,var(--popover)_75%)] ${statusTextClasses} ${iconAlign}`,
     warning: `!border-warning !bg-[color-mix(in_srgb,var(--warning)_60%,var(--card)_40%)] dark:!bg-[color-mix(in_srgb,var(--warning)_60%,var(--popover)_40%)] ${statusTextClasses} ${iconAlign}`,
     error: `!border-destructive !bg-[color-mix(in_srgb,var(--destructive)_50%,var(--card)_50%)] dark:!bg-[color-mix(in_srgb,var(--destructive)_50%,var(--popover)_50%)] ${statusTextClasses} ${iconAlign}`,
-    closeButton: "!left-auto !right-2 !top-2 !transform-none !border-none !bg-transparent !rounded-sm"
+    description: "!text-popover-foreground",
+    cancelButton: "dark:!bg-white/30",
+    closeButton: "!left-auto !right-2 !top-2 !transform-none !border-none !bg-transparent !rounded-sm !text-popover-foreground"
 };
-const sonner_Toaster = ({ theme: _theme, ...props })=>{
-    const { resolvedTheme } = useTheme();
-    return /*#__PURE__*/ jsx(Toaster, {
-        theme: resolvedTheme,
+const sonner_Toaster = ({ theme: _theme, ...props })=>/*#__PURE__*/ jsx(Toaster, {
         className: "toaster group",
         position: "top-center",
         duration: 5000,
@@ -48,5 +46,4 @@ const sonner_Toaster = ({ theme: _theme, ...props })=>{
         },
         ...props
     });
-};
 export { sonner_Toaster as Toaster, apolloToastClassNames };

package/dist/registry/use-data-table/useEntityDataTable.d.ts

@@ -10,7 +10,12 @@ export interface UseEntityDataTableOptions<TRecord extends EntityRecord = Entity
     columnOverrides?: Record<string, (baseDef: ColumnDefWithAccessorKey<TRecord>) => ColumnDefWithAccessorKey<TRecord>>;
 }
 export declare function useEntityDataTable<TRecord extends EntityRecord = EntityRecord>({ entity, storageKey: storageKeyProp, initialVisibleColumnCount, systemFields, columnOrder: columnOrderProp, extraColumns, columnOverrides, }: UseEntityDataTableOptions<TRecord>): {
-    data: Record<string, unknown>[];
+    data: {
+        readonly $synced: boolean;
+        readonly $origin: import("@tanstack/react-db").VirtualOrigin;
+        readonly $key: string;
+        readonly $collectionId: string;
+    }[];
     isLoading: boolean;
     columns: import("../data-table").ColumnDef<TRecord>[];
     sorting: import("@tanstack/react-table").SortingState;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uipath/apollo-vertex",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "UiPath Apollo Vertex design system components",
   "license": "MIT",
   "keywords": [
@@ -17,6 +17,10 @@
       "types": "./dist/entries/index.d.ts",
       "default": "./dist/entries/index.js"
     },
+    "./proteus": {
+      "types": "./dist/entries/proteus.d.ts",
+      "default": "./dist/entries/proteus.js"
+    },
     "./theme.css": "./dist/theme.css",
     "./tailwind.css": "./dist/tailwind.css",
     "./locales/*": "./dist/locales/*"
@@ -80,10 +84,12 @@
   "peerDependencies": {
     "@tanstack/ai": "^0.14.0",
     "@tanstack/ai-client": "^0.8.0",
+    "@tanstack/react-db": "^0.1.83",
     "@tanstack/react-query": "^5.90.21",
     "@tanstack/react-router": "^1.132.31",
     "@ts-rest/core": "^3.53.0-rc.1",
     "@uipath/uipath-typescript": "^1.7.1",
+    "@uipath/vs-core": "^4.4.0",
     "eventsource-parser": "^3.0.6",
     "highlight.js": "^11.11.1",
     "i18next": "^25.8.1 || ^26.0.0",
@@ -100,14 +106,8 @@
     "tailwindcss": "^4.0.0"
   },
   "peerDependenciesMeta": {
-    "@tanstack/react-db": {
-      "optional": true
-    },
     "@uipath/proteus-client": {
       "optional": true
-    },
-    "@uipath/vs-core": {
-      "optional": true
     }
   },
   "devDependencies": {
@@ -116,8 +116,11 @@
     "@rslib/core": "^0.19.6",
     "@tanstack/ai": "0.14.0",
     "@tanstack/ai-client": "0.8.0",
+    "@tanstack/db": "0.6.5",
     "@tanstack/intent": "0.4.0",
-    "@tanstack/react-query": "^5.104.0",
+    "@tanstack/query-db-collection": "1.0.36",
+    "@tanstack/react-db": "0.1.83",
+    "@tanstack/react-query": "^5.104.1",
     "@tanstack/react-router": "^1.170.40",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
@@ -126,6 +129,7 @@
     "@types/react": "^19.2.6",
     "@types/react-dom": "^19.2.2",
     "@uipath/uipath-typescript": "^1.8.0",
+    "@uipath/vs-core": "^4.5.0",
     "@vitest/coverage-v8": "^4.1.5",
     "dependency-cruiser": "^17.3.6",
     "eslint-plugin-react": "^7.37.5",

package/skills/setup/SKILL.md

@@ -30,14 +30,16 @@ Install `@uipath/apollo-vertex` if the project doesn't have it yet.
 
 Then read `peerDependencies` in
 `node_modules/@uipath/apollo-vertex/package.json` and make sure the app has
-every package listed there, in a version that matches the range. Also install
-every package listed in `peerDependenciesMeta`, even the ones marked optional
-or missing from `peerDependencies`: the package entry imports them, so the
-app's bundler fails to resolve the entry without them.
+every package listed there, in a version that matches the range. Install
+`@uipath/proteus-client` only if the app uses Proteus feature flags (it imports
+`@uipath/apollo-vertex/proteus`).
 
 - If the app already has a peer in a version outside the range, tell the user
   about the conflict instead of upgrading it on your own.
-- Some `@uipath` peers are not on the public npm registry. If installing one
+- Pick the `@tanstack/react-db` release whose `@tanstack/db` dependency matches
+  the one `@tanstack/query-db-collection` uses in the app. Each release pins an
+  exact `@tanstack/db`, and two copies do not work together.
+- `@uipath/proteus-client` is not on the public npm registry. If installing it
   fails with a 404 or an authentication error, stop and ask the user for access
   to UiPath's package registry. Do not install look-alike packages from npm.
 - If the app doesn't use Tailwind yet, set it up for the app's bundler with