@uipath/apollo-vertex 1.3.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/lib/i18n.d.ts

@@ -6,6 +6,7 @@ declare const localeLoaders: {
             access_denied: string;
             access_denied_description: string;
             actions: string;
+            active: string;
             actual_input: string;
             actual_output: string;
             add_attachment: string;
@@ -27,6 +28,7 @@ declare const localeLoaders: {
             analytics: string;
             apollo_vertex: string;
             apollo_vertex_description: string;
+            archive: string;
             are_you_sure: string;
             asc: string;
             ask_ai: string;
@@ -189,6 +191,8 @@ declare const localeLoaders: {
             more_pages: string;
             multi_line_too_few_metrics: string;
             my_template: string;
+            nav_collapse: string;
+            nav_expand: string;
             need_help: string;
             new_conversation: string;
             new_conversation_confirm_description: string;
@@ -373,6 +377,7 @@ declare const localeLoaders: {
         access_denied: string;
         access_denied_description: string;
         actions: string;
+        active: string;
         actual_input: string;
         actual_output: string;
         add_attachment: string;
@@ -394,6 +399,7 @@ declare const localeLoaders: {
         analytics: string;
         apollo_vertex: string;
         apollo_vertex_description: string;
+        archive: string;
         are_you_sure: string;
         asc: string;
         ask_ai: string;
@@ -556,6 +562,8 @@ declare const localeLoaders: {
         more_pages: string;
         multi_line_too_few_metrics: string;
         my_template: string;
+        nav_collapse: string;
+        nav_expand: string;
         need_help: string;
         new_conversation: string;
         new_conversation_confirm_description: string;

package/dist/locales/en.json

@@ -3,6 +3,7 @@
   "access_denied": "Access Denied",
   "access_denied_description": "You don't have access to this application. Ask your administrator to add you to the users group.",
   "actions": "Actions",
+  "active": "Active",
   "actual_input": "Actual input",
   "actual_output": "Actual output",
   "add_attachment": "Add attachment",
@@ -24,6 +25,7 @@
   "analytics": "Analytics",
   "apollo_vertex": "Apollo Vertex",
   "apollo_vertex_description": "- UiPath Apollo Vertex",
+  "archive": "Archive",
   "are_you_sure": "Are you sure?",
   "asc": "Asc",
   "ask_ai": "Ask AI",
@@ -186,6 +188,8 @@
   "more_pages": "More pages",
   "multi_line_too_few_metrics": "Multi-line needs two distinct metrics, but the request resolved to fewer than two.",
   "my_template": "My Template",
+  "nav_collapse": "Collapse {{label}}",
+  "nav_expand": "Expand {{label}}",
   "need_help": "Need help? Contact your administrator",
   "new_conversation": "New conversation",
   "new_conversation_confirm_description": "This will clear all messages and cannot be undone.",

package/dist/registry/shell/shell-company.js

@@ -3,11 +3,11 @@ import { Link } from "@tanstack/react-router";
 import { AnimatePresence, motion } from "framer-motion";
 import { PanelLeft } from "lucide-react";
 import { useState } from "react";
-import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { Button } from "../button/button.js";
 import { useSidebar } from "../sidebar/sidebar.js";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "../tooltip/tooltip.js";
 import { cn } from "../../lib/utils.js";
+import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { fastFadeTransition, iconHoverScale, scaleVariants, textFadeVariants } from "./shell-animations.js";
 import { CompanyLogoIcon } from "./shell-company-logo.js";
 function CollapsedLogo({ companyLogo, sidebarHovered, onExpand }) {
@@ -162,6 +162,7 @@ const Company = ({ companyName, productName, companyLogo, sidebarHovered = false
                                     children: /*#__PURE__*/ jsx(Button, {
                                         variant: "ghost",
                                         size: "icon-sm",
+                                        "aria-label": t("close_sidebar"),
                                         onClick: toggleSidebar,
                                         className: "ml-auto shrink-0 text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-foreground cursor-pointer",
                                         children: /*#__PURE__*/ jsx(PanelLeft, {

package/dist/registry/shell/shell-locale-provider.d.ts

@@ -1,7 +1,8 @@
 import { type PropsWithChildren, type ReactNode } from "react";
 interface LocaleProviderProps {
     loadingElement?: ReactNode;
+    configureI18n?: () => Promise<void>;
 }
 export declare const LocaleProviderComponent: ({ children }: PropsWithChildren) => ReactNode;
-export declare const LocaleProvider: ({ children, loadingElement, }: PropsWithChildren<LocaleProviderProps>) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element;
+export declare const LocaleProvider: ({ children, loadingElement, configureI18n, }: PropsWithChildren<LocaleProviderProps>) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/registry/shell/shell-locale-provider.js

@@ -1,9 +1,9 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { useEffect, useEffectEvent, useState } from "react";
-import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { Spinner } from "../spinner/spinner.js";
 import { configurei18n } from "../../lib/i18n.js";
+import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { LANGUAGE_CHANGED_EVENT } from "./shell-constants.js";
 const LocaleProviderComponent = ({ children })=>{
     const { i18n } = useVertexTranslation();
@@ -21,15 +21,19 @@ const LocaleProviderComponent = ({ children })=>{
     }, []);
     return children;
 };
-const LocaleProvider = ({ children, loadingElement })=>{
+const LocaleProvider = ({ children, loadingElement, configureI18n = configurei18n })=>{
     const [isConfigured, setIsConfigured] = useState(false);
-    const configure = async ()=>{
-        await configurei18n();
-        setIsConfigured(true);
-    };
     useEffect(()=>{
-        configure();
-    }, []);
+        let cancelled = false;
+        configureI18n().then(()=>{
+            if (!cancelled) setIsConfigured(true);
+        });
+        return ()=>{
+            cancelled = true;
+        };
+    }, [
+        configureI18n
+    ]);
     if (!isConfigured) return loadingElement ?? /*#__PURE__*/ jsx("div", {
         className: "flex h-full w-full items-center justify-center",
         children: /*#__PURE__*/ jsx(Spinner, {

package/dist/registry/shell/shell-minimal-nav-item.d.ts

@@ -1,7 +1,8 @@
-import type { TranslationKey } from "./shell-translation-key";
+import type { ShellNavLabel } from "./shell-translation-key";
 interface MinimalNavItemProps {
     to: string;
-    label: TranslationKey;
+    active: boolean;
+    label: ShellNavLabel;
 }
-export declare const MinimalNavItem: ({ to, label }: MinimalNavItemProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MinimalNavItem: ({ to, active, label }: MinimalNavItemProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/registry/shell/shell-minimal-nav-item.js

@@ -1,16 +1,12 @@
 import { jsx } from "react/jsx-runtime";
-import { Link, useLocation } from "@tanstack/react-router";
+import { Link } from "@tanstack/react-router";
 import { cn } from "../../lib/utils.js";
 import { Text } from "./shell-text.js";
-const MinimalNavItem = ({ to, label })=>{
-    const { pathname } = useLocation();
-    const isActive = pathname === to;
-    return /*#__PURE__*/ jsx(Link, {
+const MinimalNavItem = ({ to, active, label })=>/*#__PURE__*/ jsx(Link, {
         to: to,
-        className: cn("px-4 py-1.5 rounded-full text-sm font-medium transition-colors duration-200 shrink-0 whitespace-nowrap", isActive ? "bg-[oklch(0.92_0.035_218)] dark:bg-primary-900/30 text-primary-700 dark:text-primary-400 font-semibold" : "text-muted-foreground hover:text-foreground hover:bg-black/[0.04] dark:hover:bg-white/[0.06]"),
+        className: cn("px-4 py-1.5 rounded-full text-sm font-medium transition-colors duration-200 shrink-0 whitespace-nowrap", active ? "bg-[oklch(0.92_0.035_218)] dark:bg-primary-900/30 text-primary-700 dark:text-primary-400 font-semibold" : "text-muted-foreground hover:text-foreground hover:bg-black/[0.04] dark:hover:bg-white/[0.06]"),
         children: /*#__PURE__*/ jsx(Text, {
             value: label
         })
     });
-};
 export { MinimalNavItem };

package/dist/registry/shell/shell-nav-active.d.ts

@@ -0,0 +1,12 @@
+export declare function navPathIsActive(pathname: string, path: string): boolean;
+export declare function navItemIsCurrent(pathname: string, path: string, childPaths?: readonly string[]): boolean;
+export declare function mostSpecificActivePath(pathname: string, paths: readonly string[]): string | null;
+export declare function navItemState(pathname: string, item: {
+    path: string;
+    to?: string;
+    childPaths?: readonly string[];
+}): {
+    href: string;
+    prefixActive: boolean;
+    current: boolean;
+};

package/dist/registry/shell/shell-nav-active.js

@@ -0,0 +1,24 @@
+function navPathIsActive(pathname, path) {
+    if ("/" === path) return "/" === pathname;
+    return pathname === path || pathname.startsWith(`${path}/`);
+}
+function navItemIsCurrent(pathname, path, childPaths = []) {
+    return navPathIsActive(pathname, path) && !childPaths.some((childPath)=>navPathIsActive(pathname, childPath));
+}
+function mostSpecificActivePath(pathname, paths) {
+    let match = null;
+    for (const path of paths)if (navPathIsActive(pathname, path)) {
+        if (null === match || path.length > match.length) match = path;
+    }
+    return match;
+}
+function navItemState(pathname, item) {
+    const childPaths = item.childPaths ?? [];
+    const childActive = childPaths.some((childPath)=>navPathIsActive(pathname, childPath));
+    return {
+        href: item.to ?? item.path,
+        prefixActive: navPathIsActive(pathname, item.path) || childActive,
+        current: navItemIsCurrent(pathname, item.path, childPaths)
+    };
+}
+export { mostSpecificActivePath, navItemIsCurrent, navItemState, navPathIsActive };

package/dist/registry/shell/shell-nav-label.d.ts

@@ -0,0 +1,7 @@
+export interface NavCatalog {
+    namespaces: readonly string[];
+    exists: (key: string, namespace: string) => boolean;
+    translate: (key: string, namespace: string) => string;
+}
+export declare function navCatalogFromHook(i18n: object): NavCatalog;
+export declare function readNavLabel(catalog: NavCatalog, key: string): string;

package/dist/registry/shell/shell-nav-label.js

@@ -0,0 +1,54 @@
+import { VERTEX_NAMESPACE } from "../../lib/vertex-translation.js";
+function configuredNamespaces(defaultNS) {
+    if ("string" == typeof defaultNS) return defaultNS.length > 0 ? [
+        defaultNS
+    ] : [
+        "translation"
+    ];
+    if (!Array.isArray(defaultNS)) return [
+        "translation"
+    ];
+    const namespaces = [];
+    for (const namespace of defaultNS)if ("string" == typeof namespace && namespace.length > 0) namespaces.push(namespace);
+    return namespaces.length > 0 ? namespaces : [
+        "translation"
+    ];
+}
+function lookupNamespaces(defaultNS) {
+    const configured = configuredNamespaces(defaultNS);
+    if (configured.includes(VERTEX_NAMESPACE)) return configured;
+    return [
+        ...configured,
+        VERTEX_NAMESPACE
+    ];
+}
+function isNamespacedI18n(value) {
+    return "options" in value && "exists" in value && "function" == typeof value.exists && "t" in value && "function" == typeof value.t;
+}
+function navCatalogFromHook(i18n) {
+    if (!isNamespacedI18n(i18n)) return {
+        namespaces: [
+            "translation",
+            VERTEX_NAMESPACE
+        ],
+        exists: ()=>false,
+        translate: (key)=>key
+    };
+    return {
+        namespaces: lookupNamespaces(i18n.options.defaultNS),
+        exists: (key, namespace)=>i18n.exists(key, {
+                ns: namespace
+            }),
+        translate: (key, namespace)=>{
+            const value = i18n.t(key, {
+                ns: namespace
+            });
+            return "string" == typeof value ? value : key;
+        }
+    };
+}
+function readNavLabel(catalog, key) {
+    for (const namespace of catalog.namespaces)if (catalog.exists(key, namespace)) return catalog.translate(key, namespace);
+    return key;
+}
+export { navCatalogFromHook, readNavLabel };

package/dist/registry/shell/shell-sidebar.js

@@ -4,45 +4,54 @@ import { Link, useLocation } from "@tanstack/react-router";
 import { AnimatePresence, motion } from "framer-motion";
 import { ChevronDown } from "lucide-react";
 import { useEffect, useState } from "react";
-import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../collapsible/collapsible.js";
 import { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarHeader, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, useSidebar } from "../sidebar/sidebar.js";
 import { cn } from "../../lib/utils.js";
+import { useVertexTranslation } from "../../lib/vertex-translation.js";
 import { fastFadeTransition, iconHoverScale, textFadeVariants } from "./shell-animations.js";
 import { Company } from "./shell-company.js";
 import { MinimalCompany } from "./shell-minimal-company.js";
 import { MinimalNavItem } from "./shell-minimal-nav-item.js";
+import { mostSpecificActivePath, navItemState } from "./shell-nav-active.js";
+import { navCatalogFromHook, readNavLabel } from "./shell-nav-label.js";
 import { Text } from "./shell-text.js";
 import { UserProfile } from "./shell-user-profile.js";
 const activeNavClass = "text-sidebar-foreground/85 hover:text-sidebar-foreground data-[active=true]:text-primary-700 dark:data-[active=true]:text-primary-400 data-[active=true]:font-semibold data-[active=true]:bg-primary-100/40 dark:data-[active=true]:bg-primary-900/30";
 const navButtonClass = `font-medium ${activeNavClass}`;
 const subButtonClass = activeNavClass;
+const prefixActiveClass = "font-semibold text-primary-700 dark:text-primary-400 hover:text-primary-700 dark:hover:text-primary-400 active:text-primary-700 dark:active:text-primary-400";
+const currentPillClass = "bg-primary-100/40 dark:bg-primary-900/30";
 const ShellSidebar = ({ companyName, productName, variant, companyLogo, navItems })=>{
-    if ("minimal" === variant) return /*#__PURE__*/ jsxs("header", {
-        className: "relative flex items-center justify-between px-4 sm:px-6 lg:px-8 py-6 transition-[padding] duration-300 ease-in-out",
-        children: [
-            /*#__PURE__*/ jsx(MinimalCompany, {
-                companyName: companyName,
-                productName: productName,
-                companyLogo: companyLogo
-            }),
-            navItems.length > 0 && /*#__PURE__*/ jsx("nav", {
-                className: "absolute left-1/2 -translate-x-1/2 flex items-center bg-muted dark:bg-[oklch(0.24_0.033_254)] rounded-full p-1.5 overflow-x-auto scrollbar-thin",
-                children: navItems.map((item)=>/*#__PURE__*/ jsx(MinimalNavItem, {
-                        to: item.path,
-                        label: item.label
-                    }, item.path))
-            }),
-            /*#__PURE__*/ jsx("div", {
-                className: "flex items-center gap-2",
-                children: /*#__PURE__*/ jsx(UserProfile, {
-                    isCollapsed: true,
-                    collapsedMenuSide: "bottom",
-                    collapsedMenuAlign: "end"
+    const { pathname } = useLocation();
+    if ("minimal" === variant) {
+        const activePath = mostSpecificActivePath(pathname, navItems.map((item)=>item.path));
+        return /*#__PURE__*/ jsxs("header", {
+            className: "relative flex items-center justify-between px-4 sm:px-6 lg:px-8 py-6 transition-[padding] duration-300 ease-in-out",
+            children: [
+                /*#__PURE__*/ jsx(MinimalCompany, {
+                    companyName: companyName,
+                    productName: productName,
+                    companyLogo: companyLogo
+                }),
+                navItems.length > 0 && /*#__PURE__*/ jsx("nav", {
+                    className: "absolute left-1/2 -translate-x-1/2 flex items-center bg-muted dark:bg-[oklch(0.24_0.033_254)] rounded-full p-1.5 overflow-x-auto scrollbar-thin",
+                    children: navItems.map((item)=>/*#__PURE__*/ jsx(MinimalNavItem, {
+                            to: item.to ?? item.path,
+                            active: item.path === activePath,
+                            label: item.label
+                        }, item.path))
+                }),
+                /*#__PURE__*/ jsx("div", {
+                    className: "flex items-center gap-2",
+                    children: /*#__PURE__*/ jsx(UserProfile, {
+                        isCollapsed: true,
+                        collapsedMenuSide: "bottom",
+                        collapsedMenuAlign: "end"
+                    })
                 })
-            })
-        ]
-    });
+            ]
+        });
+    }
     return /*#__PURE__*/ jsx(SidebarNav, {
         companyName: companyName,
         productName: productName,
@@ -51,8 +60,9 @@ const ShellSidebar = ({ companyName, productName, variant, companyLogo, navItems
     });
 };
 function SidebarNav({ companyName, productName, companyLogo, navItems }) {
-    const { t } = useVertexTranslation();
-    const { state, toggleSidebar } = useSidebar();
+    const { t, i18n } = useVertexTranslation();
+    const catalog = navCatalogFromHook(i18n);
+    const { state } = useSidebar();
     const { pathname } = useLocation();
     const isCollapsed = "collapsed" === state;
     const [sidebarHovered, setSidebarHovered] = useState(false);
@@ -75,24 +85,16 @@ function SidebarNav({ companyName, productName, companyLogo, navItems }) {
         pathname,
         navItems
     ]);
-    const handleMenuClick = (path)=>{
-        if (isCollapsed) {
-            toggleSidebar();
-            setExpandedItems((prev)=>new Set(prev).add(path));
-        } else setExpandedItems((prev)=>{
+    const toggleGroup = (path)=>{
+        setExpandedItems((prev)=>{
             const next = new Set(prev);
             if (next.has(path)) next.delete(path);
             else next.add(path);
             return next;
         });
     };
-    const isActive = (path)=>{
-        if ("/" === path) return "/" === pathname;
-        return pathname === path || pathname.startsWith(`${path}/`);
-    };
-    const isParentActive = (item)=>item.subItems?.some((sub)=>isActive(sub.path)) ?? false;
     const getTooltipText = (label)=>{
-        if ("string" == typeof label) return t(label);
+        if ("string" == typeof label) return readNavLabel(catalog, label);
         return t(label.i18nKey, label.values);
     };
     return /*#__PURE__*/ jsxs(Sidebar, {
@@ -119,97 +121,107 @@ function SidebarNav({ companyName, productName, companyLogo, navItems }) {
                         children: /*#__PURE__*/ jsx(SidebarMenu, {
                             children: navItems.map((item)=>{
                                 const Icon = item.icon;
-                                const active = isActive(item.path);
-                                const parentActive = isParentActive(item);
                                 const isExpanded = expandedItems.has(item.path);
-                                if (item.subItems && item.subItems.length > 0) {
-                                    const showParentActive = isCollapsed && parentActive;
-                                    return /*#__PURE__*/ jsx(Collapsible, {
-                                        open: isExpanded && !isCollapsed,
-                                        onOpenChange: ()=>handleMenuClick(item.path),
-                                        className: "group/collapsible",
-                                        children: /*#__PURE__*/ jsxs(SidebarMenuItem, {
-                                            children: [
-                                                /*#__PURE__*/ jsx(CollapsibleTrigger, {
-                                                    asChild: true,
-                                                    children: /*#__PURE__*/ jsxs(SidebarMenuButton, {
+                                const childPaths = item.subItems?.map((sub)=>sub.path) ?? [];
+                                const row = navItemState(pathname, {
+                                    path: item.path,
+                                    to: item.to,
+                                    childPaths
+                                });
+                                if (item.subItems && item.subItems.length > 0) return /*#__PURE__*/ jsx(Collapsible, {
+                                    open: isExpanded && !isCollapsed,
+                                    onOpenChange: ()=>toggleGroup(item.path),
+                                    className: "group/collapsible",
+                                    children: /*#__PURE__*/ jsxs(SidebarMenuItem, {
+                                        children: [
+                                            /*#__PURE__*/ jsxs("div", {
+                                                className: cn("flex w-full min-w-0 items-center rounded-md", !isCollapsed && row.current && currentPillClass, !isCollapsed && !row.current && "hover:bg-sidebar-accent/50"),
+                                                children: [
+                                                    /*#__PURE__*/ jsx(SidebarMenuButton, {
+                                                        asChild: true,
                                                         tooltip: getTooltipText(item.label),
-                                                        isActive: showParentActive,
-                                                        className: navButtonClass,
-                                                        children: [
-                                                            /*#__PURE__*/ jsx(motion.span, {
-                                                                className: "inline-flex items-center justify-center shrink-0",
-                                                                ...isCollapsed ? {
-                                                                    whileHover: iconHoverScale
-                                                                } : {},
-                                                                children: /*#__PURE__*/ jsx(Icon, {
-                                                                    className: "size-4 shrink-0"
-                                                                })
-                                                            }),
-                                                            /*#__PURE__*/ jsx(AnimatePresence, {
-                                                                initial: false,
-                                                                children: !isCollapsed && /*#__PURE__*/ jsx(motion.span, {
-                                                                    variants: textFadeVariants,
-                                                                    initial: "initial",
-                                                                    animate: "animate",
-                                                                    exit: "exit",
-                                                                    transition: fastFadeTransition,
-                                                                    className: "whitespace-nowrap truncate",
-                                                                    children: /*#__PURE__*/ jsx(Text, {
-                                                                        value: item.label
+                                                        isActive: isCollapsed && row.current,
+                                                        className: cn(navButtonClass, row.prefixActive && prefixActiveClass, !isCollapsed && "w-auto min-w-0 flex-1 bg-transparent hover:bg-transparent"),
+                                                        children: /*#__PURE__*/ jsxs(Link, {
+                                                            to: row.href,
+                                                            children: [
+                                                                /*#__PURE__*/ jsx(motion.span, {
+                                                                    className: "inline-flex items-center justify-center shrink-0",
+                                                                    ...isCollapsed ? {
+                                                                        whileHover: iconHoverScale
+                                                                    } : {},
+                                                                    children: /*#__PURE__*/ jsx(Icon, {
+                                                                        className: "size-4 shrink-0"
                                                                     })
-                                                                }, "text")
+                                                                }),
+                                                                /*#__PURE__*/ jsx(AnimatePresence, {
+                                                                    initial: false,
+                                                                    children: !isCollapsed && /*#__PURE__*/ jsx(motion.span, {
+                                                                        variants: textFadeVariants,
+                                                                        initial: "initial",
+                                                                        animate: "animate",
+                                                                        exit: "exit",
+                                                                        transition: fastFadeTransition,
+                                                                        className: "whitespace-nowrap truncate",
+                                                                        children: /*#__PURE__*/ jsx(Text, {
+                                                                            value: item.label
+                                                                        })
+                                                                    }, "text")
+                                                                })
+                                                            ]
+                                                        })
+                                                    }),
+                                                    !isCollapsed && /*#__PURE__*/ jsx(CollapsibleTrigger, {
+                                                        asChild: true,
+                                                        children: /*#__PURE__*/ jsx("button", {
+                                                            type: "button",
+                                                            "aria-expanded": isExpanded,
+                                                            "aria-label": t(isExpanded ? "nav_collapse" : "nav_expand", {
+                                                                label: getTooltipText(item.label)
                                                             }),
-                                                            /*#__PURE__*/ jsx(AnimatePresence, {
-                                                                initial: false,
-                                                                children: !isCollapsed && /*#__PURE__*/ jsx(motion.div, {
-                                                                    variants: textFadeVariants,
-                                                                    initial: "initial",
-                                                                    animate: "animate",
-                                                                    exit: "exit",
-                                                                    transition: fastFadeTransition,
-                                                                    className: "ml-auto",
-                                                                    children: /*#__PURE__*/ jsx(ChevronDown, {
-                                                                        className: cn("size-4 transition-transform duration-200", isExpanded && "rotate-180")
-                                                                    })
-                                                                }, "chevron")
+                                                            className: "flex size-8 shrink-0 items-center justify-center text-sidebar-foreground/70 hover:text-sidebar-foreground",
+                                                            children: /*#__PURE__*/ jsx(ChevronDown, {
+                                                                className: cn("size-4 transition-transform duration-200", isExpanded && "rotate-180")
                                                             })
-                                                        ]
+                                                        })
                                                     })
-                                                }),
-                                                /*#__PURE__*/ jsx(CollapsibleContent, {
-                                                    children: /*#__PURE__*/ jsx(SidebarMenuSub, {
-                                                        className: "ml-4 mr-0 mt-1 gap-0.5 pl-3 pr-0",
-                                                        children: item.subItems.map((subItem)=>{
-                                                            const subActive = isActive(subItem.path);
-                                                            return /*#__PURE__*/ jsx(SidebarMenuSubItem, {
-                                                                children: /*#__PURE__*/ jsx(SidebarMenuSubButton, {
-                                                                    asChild: true,
-                                                                    isActive: subActive,
-                                                                    className: cn("cursor-pointer whitespace-nowrap", subButtonClass),
-                                                                    children: /*#__PURE__*/ jsx(Link, {
-                                                                        to: subItem.path,
-                                                                        children: /*#__PURE__*/ jsx(Text, {
-                                                                            value: subItem.label
-                                                                        })
+                                                ]
+                                            }),
+                                            /*#__PURE__*/ jsx(CollapsibleContent, {
+                                                children: /*#__PURE__*/ jsx(SidebarMenuSub, {
+                                                    className: "ml-4 mr-0 mt-1 gap-0.5 pl-3 pr-0",
+                                                    children: item.subItems.map((subItem)=>{
+                                                        const sub = navItemState(pathname, {
+                                                            path: subItem.path,
+                                                            to: subItem.to
+                                                        });
+                                                        return /*#__PURE__*/ jsx(SidebarMenuSubItem, {
+                                                            children: /*#__PURE__*/ jsx(SidebarMenuSubButton, {
+                                                                asChild: true,
+                                                                isActive: sub.current,
+                                                                className: cn("cursor-pointer whitespace-nowrap", subButtonClass),
+                                                                children: /*#__PURE__*/ jsx(Link, {
+                                                                    to: sub.href,
+                                                                    children: /*#__PURE__*/ jsx(Text, {
+                                                                        value: subItem.label
                                                                     })
                                                                 })
-                                                            }, subItem.path);
-                                                        })
+                                                            })
+                                                        }, subItem.path);
                                                     })
                                                 })
-                                            ]
-                                        })
-                                    }, item.path);
-                                }
+                                            })
+                                        ]
+                                    })
+                                }, item.path);
                                 return /*#__PURE__*/ jsx(SidebarMenuItem, {
                                     children: /*#__PURE__*/ jsx(SidebarMenuButton, {
                                         tooltip: getTooltipText(item.label),
-                                        isActive: active,
+                                        isActive: row.current,
                                         asChild: true,
                                         className: navButtonClass,
                                         children: /*#__PURE__*/ jsxs(Link, {
-                                            to: item.path,
+                                            to: row.href,
                                             children: [
                                                 /*#__PURE__*/ jsx(motion.span, {
                                                     className: "inline-flex items-center justify-center shrink-0",
@@ -252,7 +264,7 @@ function SidebarNav({ companyName, productName, companyLogo, navItems }) {
             /*#__PURE__*/ jsx("div", {
                 className: "absolute inset-0 pointer-events-none",
                 style: {
-                    boxShadow: "inset -1px 0 0 0 color-mix(in srgb, var(--color-border) 50%, transparent)"
+                    boxShadow: "inset -1px 0 0 0 color-mix(in srgb, var(--border) 50%, transparent)"
                 }
             })
         ]

package/dist/registry/shell/shell-text.d.ts

@@ -1,4 +1,4 @@
-import type { TranslationKey } from "./shell-translation-key";
+import type { ShellNavLabel } from "./shell-translation-key";
 export declare const Text: ({ value }: {
-    value: TranslationKey;
+    value: ShellNavLabel;
 }) => string | import("react/jsx-runtime").JSX.Element;

package/dist/registry/shell/shell-text.js

@@ -1,9 +1,10 @@
 import { jsx } from "react/jsx-runtime";
 import { Trans } from "react-i18next";
 import { VERTEX_NAMESPACE, useVertexTranslation } from "../../lib/vertex-translation.js";
+import { navCatalogFromHook, readNavLabel } from "./shell-nav-label.js";
 const Text = ({ value })=>{
-    const { t } = useVertexTranslation();
-    if ("string" == typeof value) return t(value);
+    const { i18n } = useVertexTranslation();
+    if ("string" == typeof value) return readNavLabel(navCatalogFromHook(i18n), value);
     return /*#__PURE__*/ jsx(Trans, {
         ns: VERTEX_NAMESPACE,
         i18nKey: value.i18nKey,

package/dist/registry/shell/shell-translation-key.d.ts

@@ -5,3 +5,8 @@ export type TranslationKey = {
     values: Record<string, string | number | string[]>;
     components: Record<string, ReactElement>;
 } | ParseKeys;
+type TranslationObject = Extract<TranslationKey, {
+    i18nKey: ParseKeys;
+}>;
+export type ShellNavLabel = string | TranslationObject;
+export {};

package/dist/registry/shell/shell.d.ts

@@ -1,6 +1,6 @@
 import type { LucideIcon } from "lucide-react";
 import type { FC, PropsWithChildren } from "react";
-import type { TranslationKey } from "./shell-translation-key";
+import type { ShellNavLabel } from "./shell-translation-key";
 export interface CompanyLogo {
     url: string;
     darkUrl?: string;
@@ -9,11 +9,13 @@ export interface CompanyLogo {
 }
 export interface ShellSubNavItem {
     path: string;
-    label: TranslationKey;
+    to?: string;
+    label: ShellNavLabel;
 }
 export interface ShellNavItem {
     path: string;
-    label: TranslationKey;
+    to?: string;
+    label: ShellNavLabel;
     icon: LucideIcon;
     subItems?: ShellSubNavItem[];
 }
@@ -24,5 +26,6 @@ export interface ApolloShellProps extends PropsWithChildren {
     companyLogo?: CompanyLogo;
     navItems: ShellNavItem[];
     loginDescription?: string;
+    configureI18n?: () => Promise<void>;
 }
 export declare const ApolloShell: FC<ApolloShellProps>;

package/dist/registry/shell/shell.js

@@ -7,9 +7,23 @@ import { ShellLayout } from "./shell-layout.js";
 import { LocaleProvider } from "./shell-locale-provider.js";
 import { ShellLogin } from "./shell-login.js";
 import { ShellUserProvider } from "./shell-user-provider.js";
+function ShellLoadingSkeleton() {
+    return /*#__PURE__*/ jsxs("div", {
+        className: "flex h-screen gap-4 p-4 bg-background dark:bg-sidebar",
+        children: [
+            /*#__PURE__*/ jsx(Skeleton, {
+                className: "h-full w-[280px]"
+            }),
+            /*#__PURE__*/ jsx(Skeleton, {
+                className: "h-full flex-1 rounded-lg"
+            })
+        ]
+    });
+}
 const ApolloShellContent = ({ children, companyName, productName, companyLogo, variant, navItems, loginDescription })=>{
     const authContext = useContext(AuthContext);
-    const { accessToken } = useAuth();
+    const { accessToken, isLoading } = useAuth();
+    if (authContext && isLoading) return /*#__PURE__*/ jsx(ShellLoadingSkeleton, {});
     if (authContext && !accessToken) return /*#__PURE__*/ jsx(ShellLogin, {
         title: productName,
         description: loginDescription
@@ -25,18 +39,9 @@ const ApolloShellContent = ({ children, companyName, productName, companyLogo, v
         })
     });
 };
-const ApolloShell = ({ children, companyName, productName, companyLogo, variant, navItems, loginDescription })=>/*#__PURE__*/ jsx(LocaleProvider, {
-        loadingElement: /*#__PURE__*/ jsxs("div", {
-            className: "flex h-screen gap-4 p-4 bg-background dark:bg-sidebar",
-            children: [
-                /*#__PURE__*/ jsx(Skeleton, {
-                    className: "h-full w-[280px]"
-                }),
-                /*#__PURE__*/ jsx(Skeleton, {
-                    className: "h-full flex-1 rounded-lg"
-                })
-            ]
-        }),
+const ApolloShell = ({ children, companyName, productName, companyLogo, variant, navItems, loginDescription, configureI18n })=>/*#__PURE__*/ jsx(LocaleProvider, {
+        configureI18n: configureI18n,
+        loadingElement: /*#__PURE__*/ jsx(ShellLoadingSkeleton, {}),
         children: /*#__PURE__*/ jsx(ApolloShellContent, {
             companyName: companyName,
             productName: productName,

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.3.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