@backstage/ui 0.17.2-next.0 → 0.18.0-next.1

package/dist/index.d.ts

@@ -1491,7 +1491,7 @@ type TabOwnProps = {
  *
  * @public
  */
-interface TabProps extends TabOwnProps, Omit<TabProps$1, keyof TabOwnProps> {
+interface TabProps extends TabOwnProps, Omit<TabProps$1, keyof TabOwnProps | 'render'> {
 }
 /**
  * Own props for the TabPanel component.
@@ -1894,6 +1894,9 @@ declare const HeaderNavItemDefinition: {
         readonly root: "bui-HeaderNavItem";
     };
     readonly analytics: true;
+    readonly navigation: {
+        readonly type: "anchor";
+    };
     readonly propDefs: {
         readonly noTrack: {};
         readonly id: {};
@@ -2012,7 +2015,7 @@ type ButtonLinkOwnProps = {
  *
  * @public
  */
-interface ButtonLinkProps extends Omit<LinkProps$1, keyof ButtonLinkOwnProps>, ButtonLinkOwnProps {
+interface ButtonLinkProps extends Omit<LinkProps$1, keyof ButtonLinkOwnProps | 'render'>, ButtonLinkOwnProps {
 }
 
 /**
@@ -2036,6 +2039,9 @@ declare const ButtonLinkDefinition: {
     };
     readonly bg: "consumer";
     readonly analytics: true;
+    readonly navigation: {
+        readonly type: "anchor";
+    };
     readonly propDefs: {
         readonly noTrack: {};
         readonly size: {
@@ -2413,7 +2419,7 @@ type ComboboxItemOwnProps = {
     className?: string;
 };
 /** @public */
-type ComboboxItemProps<T extends object = object> = ComboboxItemOwnProps & Omit<ListBoxItemProps<T>, keyof ComboboxItemOwnProps>;
+type ComboboxItemProps<T extends object = object> = ComboboxItemOwnProps & Omit<ListBoxItemProps<T>, keyof ComboboxItemOwnProps | 'render'>;
 /** @public */
 type ComboboxItemTextOwnProps = {
     title: string;
@@ -2560,6 +2566,9 @@ declare const ComboboxItemDefinition: {
         readonly indicator: "bui-ComboboxItemIndicator";
         readonly content: "bui-ComboboxItemContent";
     };
+    readonly navigation: {
+        readonly type: "anchor";
+    };
     readonly propDefs: {
         readonly children: {};
         readonly textValue: {};
@@ -3740,7 +3749,7 @@ type MenuItemOwnProps = {
     className?: string;
 };
 /** @public */
-interface MenuItemProps extends MenuItemOwnProps, Omit<MenuItemProps$1, keyof MenuItemOwnProps> {
+interface MenuItemProps extends MenuItemOwnProps, Omit<MenuItemProps$1, keyof MenuItemOwnProps | 'render'> {
 }
 /** @public */
 type MenuListBoxItemOwnProps = {
@@ -3748,7 +3757,7 @@ type MenuListBoxItemOwnProps = {
     className?: string;
 };
 /** @public */
-interface MenuListBoxItemProps extends MenuListBoxItemOwnProps, Omit<ListBoxItemProps, keyof MenuListBoxItemOwnProps> {
+interface MenuListBoxItemProps extends MenuListBoxItemOwnProps, Omit<ListBoxItemProps, keyof MenuListBoxItemOwnProps | 'render'> {
 }
 /** @public */
 type MenuSectionOwnProps = {
@@ -3962,7 +3971,7 @@ type SearchAutocompleteItemOwnProps = {
     className?: string;
 };
 /** @public */
-interface SearchAutocompleteItemProps extends SearchAutocompleteItemOwnProps, Omit<ListBoxItemProps, keyof SearchAutocompleteItemOwnProps> {
+interface SearchAutocompleteItemProps extends SearchAutocompleteItemOwnProps, Omit<ListBoxItemProps, keyof SearchAutocompleteItemOwnProps | 'render'> {
 }
 
 /**
@@ -4104,7 +4113,7 @@ type LinkOwnProps = {
     className?: string;
 };
 /** @public */
-interface LinkProps extends Omit<LinkProps$1, 'children' | 'className'>, LinkOwnProps {
+interface LinkProps extends Omit<LinkProps$1, 'children' | 'className' | 'render'>, LinkOwnProps {
 }
 
 /**
@@ -4126,6 +4135,9 @@ declare const LinkDefinition: {
         readonly root: "bui-Link";
     };
     readonly analytics: true;
+    readonly navigation: {
+        readonly type: "anchor";
+    };
     readonly propDefs: {
         readonly noTrack: {};
         readonly variant: {
@@ -4458,7 +4470,7 @@ type SelectItemOwnProps = {
     className?: string;
 };
 /** @public */
-type SelectItemProps<T extends object = object> = SelectItemOwnProps & Omit<ListBoxItemProps<T>, keyof SelectItemOwnProps | 'textValue'> & {
+type SelectItemProps<T extends object = object> = SelectItemOwnProps & Omit<ListBoxItemProps<T>, keyof SelectItemOwnProps | 'render' | 'textValue'> & {
     textValue: string;
 };
 /** @public */
@@ -4616,6 +4628,9 @@ declare const SelectItemDefinition: {
         readonly indicator: "bui-SelectItemIndicator";
         readonly content: "bui-SelectItemContent";
     };
+    readonly navigation: {
+        readonly type: "anchor";
+    };
     readonly propDefs: {
         readonly children: {};
         readonly showSelectionIndicator: {};
@@ -4972,6 +4987,15 @@ type BUIProviderProps = {
 /**
  * Provides integration capabilities to all descendant BUI components.
  *
+ * When rendered inside the Backstage app router, BUI components use
+ * client-side navigation for internal links. Relative destinations resolve
+ * from the route of the component that renders the link, and the router
+ * basename applies once.
+ *
+ * External and scheme links, downloads, and links with non-self targets use the
+ * browser's native navigation. BUI components rendered outside React Router use
+ * native links without throwing.
+ *
  * @example
  * ```tsx
  * import { BUIProvider } from '@backstage/ui';

package/dist/navigation/BUIRoutingProvider.esm.js

@@ -0,0 +1,44 @@
+import { jsx } from 'react/jsx-runtime';
+import { useCallback } from 'react';
+import { RouterProvider } from 'react-aria-components';
+import { useResolvedPath, useNavigate, useLocation, useInRouterContext, useHref, Link } from 'react-router-dom';
+import { useResolvedHref } from '../hooks/useResolvedHref.esm.js';
+
+const delegatedNavigations = /* @__PURE__ */ new WeakMap();
+const buiRoutingIntegration = {
+  Link,
+  useHref,
+  useInRouterContext,
+  useLocation,
+  useNavigate,
+  useResolvedPath,
+  createRouterOptions(action, options) {
+    const routerOptions = { ...options };
+    delegatedNavigations.set(routerOptions, action);
+    return routerOptions;
+  }
+};
+function BUIRoutingProvider({ children }) {
+  if (!useInRouterContext()) {
+    return children;
+  }
+  return /* @__PURE__ */ jsx(ReactAriaRoutingProvider, { children });
+}
+function ReactAriaRoutingProvider({ children }) {
+  const providerNavigate = useNavigate();
+  const navigate = useCallback(
+    (href, options) => {
+      const delegatedNavigation = options ? delegatedNavigations.get(options) : void 0;
+      if (delegatedNavigation) {
+        delegatedNavigation();
+        return;
+      }
+      providerNavigate(href, options);
+    },
+    [providerNavigate]
+  );
+  return /* @__PURE__ */ jsx(RouterProvider, { navigate, useHref: useResolvedHref, children });
+}
+
+export { BUIRoutingProvider, buiRoutingIntegration };
+//# sourceMappingURL=BUIRoutingProvider.esm.js.map

package/dist/navigation/BUIRoutingProvider.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BUIRoutingProvider.esm.js","sources":["../../src/navigation/BUIRoutingProvider.tsx"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useCallback, type ReactNode } from 'react';\nimport { RouterProvider } from 'react-aria-components';\nimport {\n  Link,\n  useHref,\n  useInRouterContext,\n  useLocation,\n  useNavigate,\n  useResolvedPath,\n} from 'react-router-dom';\nimport { useResolvedHref } from '../hooks/useResolvedHref';\nimport type { BUIRoutingIntegration } from './types';\n\n// BUIProvider mounts this provider centrally so older BUI components from the\n// same React Aria module instance keep delegated client-side navigation.\n// Collection roots also mount it locally so their synthetic link items and the\n// provider always use the same React Aria module instance. Preserving each\n// item's href and original activation event lets React Aria choose between\n// client navigation and temporary-anchor activation for native link behavior.\n//\n// The exact options object identifies a component-scoped action. Unregistered\n// objects, including those from older BUI components or direct React Aria\n// usage, use the provider's router context instead. A separate React Aria\n// module instance cannot reach this provider and is handled by the rendered\n// host Link in useNavigation.\nconst delegatedNavigations = new WeakMap<object, () => void>();\n\n/** @internal */\nexport const buiRoutingIntegration: BUIRoutingIntegration = {\n  Link,\n  useHref,\n  useInRouterContext,\n  useLocation,\n  useNavigate,\n  useResolvedPath,\n  createRouterOptions(action, options) {\n    const routerOptions = { ...options };\n    delegatedNavigations.set(routerOptions, action);\n    return routerOptions;\n  },\n};\n\n/** @internal */\nexport function BUIRoutingProvider({ children }: { children: ReactNode }) {\n  if (!useInRouterContext()) {\n    return children;\n  }\n  return <ReactAriaRoutingProvider>{children}</ReactAriaRoutingProvider>;\n}\n\nfunction ReactAriaRoutingProvider({ children }: { children: ReactNode }) {\n  const providerNavigate = useNavigate();\n  const navigate = useCallback(\n    (href: string, options: object | undefined) => {\n      const delegatedNavigation = options\n        ? delegatedNavigations.get(options)\n        : undefined;\n      if (delegatedNavigation) {\n        delegatedNavigation();\n        return;\n      }\n      providerNavigate(href, options);\n    },\n    [providerNavigate],\n  );\n\n  return (\n    <RouterProvider navigate={navigate} useHref={useResolvedHref}>\n      {children}\n    </RouterProvider>\n  );\n}\n"],"names":[],"mappings":";;;;;;AAyCA,MAAM,oBAAA,uBAA2B,OAAA,EAA4B;AAGtD,MAAM,qBAAA,GAA+C;AAAA,EAC1D,IAAA;AAAA,EACA,OAAA;AAAA,EACA,kBAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,mBAAA,CAAoB,QAAQ,OAAA,EAAS;AACnC,IAAA,MAAM,aAAA,GAAgB,EAAE,GAAG,OAAA,EAAQ;AACnC,IAAA,oBAAA,CAAqB,GAAA,CAAI,eAAe,MAAM,CAAA;AAC9C,IAAA,OAAO,aAAA;AAAA,EACT;AACF;AAGO,SAAS,kBAAA,CAAmB,EAAE,QAAA,EAAS,EAA4B;AACxE,EAAA,IAAI,CAAC,oBAAmB,EAAG;AACzB,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,uBAAO,GAAA,CAAC,4BAA0B,QAAA,EAAS,CAAA;AAC7C;AAEA,SAAS,wBAAA,CAAyB,EAAE,QAAA,EAAS,EAA4B;AACvE,EAAA,MAAM,mBAAmB,WAAA,EAAY;AACrC,EAAA,MAAM,QAAA,GAAW,WAAA;AAAA,IACf,CAAC,MAAc,OAAA,KAAgC;AAC7C,MAAA,MAAM,mBAAA,GAAsB,OAAA,GACxB,oBAAA,CAAqB,GAAA,CAAI,OAAO,CAAA,GAChC,MAAA;AACJ,MAAA,IAAI,mBAAA,EAAqB;AACvB,QAAA,mBAAA,EAAoB;AACpB,QAAA;AAAA,MACF;AACA,MAAA,gBAAA,CAAiB,MAAM,OAAO,CAAA;AAAA,IAChC,CAAA;AAAA,IACA,CAAC,gBAAgB;AAAA,GACnB;AAEA,EAAA,uBACE,GAAA,CAAC,cAAA,EAAA,EAAe,QAAA,EAAoB,OAAA,EAAS,iBAC1C,QAAA,EACH,CAAA;AAEJ;;;;"}

package/dist/navigation/useNavigation.esm.js

@@ -0,0 +1,130 @@
+import { jsx } from 'react/jsx-runtime';
+import { useCallback, useMemo } from 'react';
+import { createPath } from 'react-router-dom';
+import { isBrowserOwnedHref } from '../utils/linkUtils.esm.js';
+import { useRoutingIntegration, fallbackRoutingIntegration } from './useRouting.esm.js';
+
+function isNativeNavigation(props) {
+  const { href, target, download } = props;
+  return Boolean(
+    href !== void 0 && isBrowserOwnedHref(href) || target && target !== "_self" || download !== void 0 && download !== false
+  );
+}
+function useAnchorNavigation(props) {
+  const { href, routerOptions: navigateOptions } = props;
+  const routingIntegration = useRoutingIntegration();
+  const routing = routingIntegration ?? fallbackRoutingIntegration;
+  const navigate = routing.useNavigate();
+  const routerHref = href !== void 0 && !isBrowserOwnedHref(href) ? href : ".";
+  const relativeOptions = { relative: navigateOptions?.relative };
+  const resolvedPath = routing.useResolvedPath(routerHref, relativeOptions);
+  const resolvedHref = routing.useHref(routerHref, relativeOptions);
+  const navigateWithOptions = useCallback(() => {
+    if (href !== void 0) {
+      navigate(href, navigateOptions);
+    }
+  }, [navigate, href, navigateOptions]);
+  const delegatedRouterOptions = useMemo(() => {
+    if (!routingIntegration || href === void 0) {
+      return void 0;
+    }
+    return routingIntegration.createRouterOptions(
+      navigateWithOptions,
+      navigateOptions
+    );
+  }, [routingIntegration, navigateWithOptions, href, navigateOptions]);
+  let routerLinkOptions;
+  if (navigateOptions) {
+    const { flushSync: _flushSync, ...supportedOptions } = navigateOptions;
+    routerLinkOptions = supportedOptions;
+  }
+  const navigateWithFullOptions = navigateOptions?.flushSync === true ? navigateWithOptions : void 0;
+  if (href === void 0) {
+    return { type: "none", canMatchRoute: false };
+  }
+  const canMatchRoute = !isBrowserOwnedHref(href);
+  if (isNativeNavigation(props)) {
+    return {
+      type: "native",
+      canMatchRoute,
+      ariaHref: href,
+      browserHref: isBrowserOwnedHref(href) ? href : resolvedHref
+    };
+  }
+  if (routingIntegration) {
+    return {
+      type: "router",
+      canMatchRoute,
+      ariaHref: href,
+      to: href,
+      Link: routingIntegration.Link,
+      routerOptions: delegatedRouterOptions,
+      routerLinkOptions,
+      navigateWithFullOptions
+    };
+  }
+  return {
+    type: "router",
+    canMatchRoute,
+    ariaHref: createPath(resolvedPath),
+    to: href,
+    Link: fallbackRoutingIntegration.Link,
+    routerOptions: navigateOptions,
+    routerLinkOptions,
+    navigateWithFullOptions
+  };
+}
+function handleRouterLinkClick(event, navigation) {
+  const navigateWithFullOptions = navigation.type === "router" ? navigation.navigateWithFullOptions : void 0;
+  if (!navigateWithFullOptions || event.defaultPrevented || event.button !== 0 || event.currentTarget.target && event.currentTarget.target !== "_self" || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) {
+    return;
+  }
+  event.preventDefault();
+  navigateWithFullOptions();
+}
+function getReactAriaAnchorProps(navigation, props) {
+  switch (navigation.type) {
+    case "none":
+      return {
+        href: props.href,
+        routerOptions: props.routerOptions,
+        render: void 0
+      };
+    case "router":
+      return {
+        href: navigation.ariaHref,
+        routerOptions: navigation.routerOptions,
+        render: (domProps) => {
+          const {
+            href: _href,
+            onClick: reactAriaOnClick,
+            ...routerLinkProps
+          } = domProps;
+          const onClick = navigation.navigateWithFullOptions ? (event) => {
+            reactAriaOnClick?.(event);
+            handleRouterLinkClick(event, navigation);
+          } : reactAriaOnClick;
+          return /* @__PURE__ */ jsx(
+            navigation.Link,
+            {
+              ...routerLinkProps,
+              ...navigation.routerLinkOptions,
+              ...onClick ? { onClick } : {},
+              to: navigation.to
+            }
+          );
+        }
+      };
+    case "native":
+      return {
+        href: navigation.ariaHref,
+        routerOptions: props.routerOptions,
+        // React Aria classifies the raw href, while the final DOM anchor needs
+        // the router-resolved href so a basename is applied exactly once.
+        render: (domProps) => /* @__PURE__ */ jsx("a", { ...domProps, href: navigation.browserHref })
+      };
+  }
+}
+
+export { getReactAriaAnchorProps, handleRouterLinkClick, isBrowserOwnedHref, isNativeNavigation, useAnchorNavigation };
+//# sourceMappingURL=useNavigation.esm.js.map

package/dist/navigation/useNavigation.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigation.esm.js","sources":["../../src/navigation/useNavigation.tsx"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  useCallback,\n  useMemo,\n  type HTMLAttributeAnchorTarget,\n  type JSX,\n  type MouseEvent,\n  type ReactElement,\n} from 'react';\nimport { createPath, type NavigateOptions } from 'react-router-dom';\nimport { isBrowserOwnedHref } from '../utils/linkUtils';\nimport type { BUIRoutingIntegration } from './types';\nimport {\n  fallbackRoutingIntegration,\n  useRoutingIntegration,\n} from './useRouting';\n\n/** @internal */\nexport type NavigationProps = {\n  href?: string;\n  target?: HTMLAttributeAnchorTarget;\n  download?: boolean | string;\n  routerOptions?: NavigateOptions;\n};\n\n/** @internal */\nexport type AnchorNavigation = { canMatchRoute: boolean } & (\n  | { type: 'none' }\n  | { type: 'native'; ariaHref: string; browserHref: string }\n  | {\n      type: 'router';\n      ariaHref: string;\n      to: string;\n      Link: BUIRoutingIntegration['Link'];\n      routerOptions?: NavigateOptions;\n      routerLinkOptions: Omit<NavigateOptions, 'flushSync'> | undefined;\n      navigateWithFullOptions?: () => void;\n    }\n);\n\ntype PolymorphicRenderFunction = (...args: any[]) => ReactElement;\n\nexport { isBrowserOwnedHref } from '../utils/linkUtils';\n\n/** @internal */\nexport function isNativeNavigation(props: NavigationProps): boolean {\n  const { href, target, download } = props;\n  return Boolean(\n    (href !== undefined && isBrowserOwnedHref(href)) ||\n      (target && target !== '_self') ||\n      (download !== undefined && download !== false),\n  );\n}\n\n/**\n * A BUI component may come from a plugin that was built and released\n * independently from the application. We therefore cannot assume that the\n * component and the application's BUIProvider use the same BUI version or the\n * same installed copy of React Aria.\n *\n * These are two separate compatibility concerns:\n *\n * 1. BUIProvider version. A provider with routing support supplies the\n *    application's React Router hooks and Link component. An older provider\n *    does not, so the component falls back to directly imported React Router\n *    APIs. This fallback can be removed when providers without routing support\n *    are no longer supported.\n *\n * 2. React Aria package instance. React context is only visible to components\n *    using the same React Aria copy. A plugin using another copy cannot see the\n *    application's React Aria RouterProvider.\n *\n * Internal links render a React Router Link, either directly or through React\n * Aria's render prop. In both cases, React Aria's generated props, including its\n * click handler, are passed to that Link. React Router runs this supplied click\n * handler before its own navigation handler.\n *\n * - If the component can see the application's React Aria RouterProvider,\n *   React Aria prevents the click's default behavior and delegates navigation\n *   through that provider. React Router sees the prevented event and does not\n *   navigate a second time.\n * - If the component uses a separate React Aria copy, it cannot see that\n *   provider. React Aria leaves the event unhandled, so the rendered React\n *   Router Link performs the navigation.\n *\n * Navigation options are provided to both paths so they behave consistently.\n * React Router Link does not support `flushSync`, so when that option is\n * enabled, BUI calls `navigate` directly if React Aria did not already handle\n * an ordinary click. Modified clicks and other browser-owned activation still\n * reach the rendered anchor unchanged.\n *\n * This dual click handling exists for compatibility with older BUI components\n * and older BUIProvider implementations. Once supported applications and\n * plugins are required to use both a routing-capable BUIProvider and BUI\n * components that render React Router links, the React Aria RouterProvider and\n * its delegated-navigation path can be removed. The rendered React Router Link\n * can then become the only client-side navigation path for anchors.\n *\n * After selecting the routing integration, this hook determines who should\n * handle the destination. React Router handles ordinary internal links. The\n * browser handles external URLs, custom URL schemes, downloads, and links with\n * a non-self target. Route matching is tracked separately: an internal tab can\n * still match the current route even when its activation is browser-owned. A\n * missing href does not navigate.\n *\n * @internal\n */\nexport function useAnchorNavigation(props: NavigationProps): AnchorNavigation {\n  const { href, routerOptions: navigateOptions } = props;\n  const routingIntegration = useRoutingIntegration();\n  const routing = routingIntegration ?? fallbackRoutingIntegration;\n  const navigate = routing.useNavigate();\n  // React hooks must be called in the same order on every render. Missing hrefs,\n  // external URLs, and custom URL schemes do not need route resolution, so \".\"\n  // is used as a harmless placeholder when calling the router hooks.\n  const routerHref =\n    href !== undefined && !isBrowserOwnedHref(href) ? href : '.';\n  const relativeOptions = { relative: navigateOptions?.relative };\n  const resolvedPath = routing.useResolvedPath(routerHref, relativeOptions);\n  const resolvedHref = routing.useHref(routerHref, relativeOptions);\n  const navigateWithOptions = useCallback(() => {\n    if (href !== undefined) {\n      navigate(href, navigateOptions);\n    }\n  }, [navigate, href, navigateOptions]);\n  const delegatedRouterOptions = useMemo(() => {\n    if (!routingIntegration || href === undefined) {\n      return undefined;\n    }\n    return routingIntegration.createRouterOptions(\n      navigateWithOptions,\n      navigateOptions,\n    );\n  }, [routingIntegration, navigateWithOptions, href, navigateOptions]);\n  let routerLinkOptions: Omit<NavigateOptions, 'flushSync'> | undefined;\n  if (navigateOptions) {\n    // React Aria accepts all NavigateOptions when it delegates through its\n    // RouterProvider. React Router Link accepts the same options except\n    // flushSync, so omit that option from the props passed to the rendered Link.\n    const { flushSync: _flushSync, ...supportedOptions } = navigateOptions;\n    routerLinkOptions = supportedOptions;\n  }\n  const navigateWithFullOptions =\n    navigateOptions?.flushSync === true ? navigateWithOptions : undefined;\n\n  if (href === undefined) {\n    return { type: 'none', canMatchRoute: false };\n  }\n  const canMatchRoute = !isBrowserOwnedHref(href);\n  if (isNativeNavigation(props)) {\n    return {\n      type: 'native',\n      canMatchRoute,\n      ariaHref: href,\n      browserHref: isBrowserOwnedHref(href) ? href : resolvedHref,\n    };\n  }\n  if (routingIntegration) {\n    return {\n      type: 'router',\n      canMatchRoute,\n      ariaHref: href,\n      to: href,\n      Link: routingIntegration.Link,\n      routerOptions: delegatedRouterOptions,\n      routerLinkOptions,\n      navigateWithFullOptions,\n    };\n  }\n  return {\n    type: 'router',\n    canMatchRoute,\n    ariaHref: createPath(resolvedPath),\n    to: href,\n    Link: fallbackRoutingIntegration.Link,\n    routerOptions: navigateOptions,\n    routerLinkOptions,\n    navigateWithFullOptions,\n  };\n}\n\n/**\n * Completes an eligible click with the one navigation option that React Router\n * Link cannot represent. Callers invoke this after React Aria's click handler.\n *\n * @internal\n */\nexport function handleRouterLinkClick(\n  event: MouseEvent<HTMLAnchorElement>,\n  navigation: AnchorNavigation,\n) {\n  const navigateWithFullOptions =\n    navigation.type === 'router'\n      ? navigation.navigateWithFullOptions\n      : undefined;\n  if (\n    !navigateWithFullOptions ||\n    event.defaultPrevented ||\n    event.button !== 0 ||\n    (event.currentTarget.target && event.currentTarget.target !== '_self') ||\n    event.metaKey ||\n    event.altKey ||\n    event.ctrlKey ||\n    event.shiftKey\n  ) {\n    return;\n  }\n\n  event.preventDefault();\n  navigateWithFullOptions();\n}\n\n/**\n * Converts the selected navigation behavior into props understood by React\n * Aria.\n *\n * Internal destinations are rendered as the selected React Router Link.\n * `routerOptions` are used when React Aria delegates the click through its\n * RouterProvider. The equivalent Link props are also applied to the rendered\n * React Router Link for components that cannot see that provider.\n *\n * Destinations handled by the browser are rendered as plain anchors. Their\n * final href includes any React Router basename exactly once.\n *\n * @internal\n */\nexport function getReactAriaAnchorProps(\n  navigation: AnchorNavigation,\n  props: {\n    href?: string;\n    routerOptions?: NavigateOptions;\n  },\n): {\n  href?: string;\n  routerOptions?: NavigateOptions;\n  render?: PolymorphicRenderFunction;\n} {\n  switch (navigation.type) {\n    case 'none':\n      return {\n        href: props.href,\n        routerOptions: props.routerOptions,\n        render: undefined,\n      };\n    case 'router':\n      return {\n        href: navigation.ariaHref,\n        routerOptions: navigation.routerOptions,\n        render: (domProps: JSX.IntrinsicElements['a']) => {\n          const {\n            href: _href,\n            onClick: reactAriaOnClick,\n            ...routerLinkProps\n          } = domProps;\n          const onClick = navigation.navigateWithFullOptions\n            ? (event: MouseEvent<HTMLAnchorElement>) => {\n                reactAriaOnClick?.(event);\n                handleRouterLinkClick(event, navigation);\n              }\n            : reactAriaOnClick;\n          return (\n            <navigation.Link\n              {...routerLinkProps}\n              {...navigation.routerLinkOptions}\n              {...(onClick ? { onClick } : {})}\n              to={navigation.to}\n            />\n          );\n        },\n      };\n    case 'native':\n      return {\n        href: navigation.ariaHref,\n        routerOptions: props.routerOptions,\n        // React Aria classifies the raw href, while the final DOM anchor needs\n        // the router-resolved href so a basename is applied exactly once.\n        render: (domProps: JSX.IntrinsicElements['a']) => (\n          <a {...domProps} href={navigation.browserHref} />\n        ),\n      };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/navigation/useRouting.esm.js

@@ -0,0 +1,27 @@
+import { useVersionedContext } from '@backstage/version-bridge';
+import { useResolvedPath, useNavigate, useLocation, useInRouterContext, useHref, Link } from 'react-router-dom';
+
+function useRoutingIntegration(options) {
+  const routing = useVersionedContext("bui")?.atVersion(2)?.routing;
+  if (routing) {
+    return routing;
+  }
+  if (options?.fallback) {
+    return fallbackRoutingIntegration;
+  }
+  return void 0;
+}
+const fallbackRoutingIntegration = {
+  Link,
+  useHref,
+  useInRouterContext,
+  useLocation,
+  useNavigate,
+  useResolvedPath,
+  createRouterOptions(_action, options) {
+    return { ...options };
+  }
+};
+
+export { fallbackRoutingIntegration, useRoutingIntegration };
+//# sourceMappingURL=useRouting.esm.js.map

package/dist/navigation/useRouting.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouting.esm.js","sources":["../../src/navigation/useRouting.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useVersionedContext } from '@backstage/version-bridge';\nimport {\n  Link,\n  useHref,\n  useInRouterContext,\n  useLocation,\n  useNavigate,\n  useResolvedPath,\n} from 'react-router-dom';\nimport type { BUIContextVersions } from '../provider/BUIContext';\nimport type { BUIRoutingIntegration } from './types';\n\n/** @internal */\nexport function useRoutingIntegration(): BUIRoutingIntegration | undefined;\n/** @internal */\nexport function useRoutingIntegration(options: {\n  fallback: true;\n}): BUIRoutingIntegration;\n/** @internal */\nexport function useRoutingIntegration(options?: {\n  fallback?: true;\n}): BUIRoutingIntegration | undefined {\n  const routing =\n    useVersionedContext<BUIContextVersions>('bui')?.atVersion(2)?.routing;\n  if (routing) {\n    return routing;\n  }\n  if (options?.fallback) {\n    return fallbackRoutingIntegration;\n  }\n  return undefined;\n}\n\n/** @internal */\nexport const fallbackRoutingIntegration: BUIRoutingIntegration = {\n  Link,\n  useHref,\n  useInRouterContext,\n  useLocation,\n  useNavigate,\n  useResolvedPath,\n  createRouterOptions(_action, options) {\n    return { ...options };\n  },\n};\n"],"names":[],"mappings":";;;AAmCO,SAAS,sBAAsB,OAAA,EAEA;AACpC,EAAA,MAAM,UACJ,mBAAA,CAAwC,KAAK,CAAA,EAAG,SAAA,CAAU,CAAC,CAAA,EAAG,OAAA;AAChE,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,IAAI,SAAS,QAAA,EAAU;AACrB,IAAA,OAAO,0BAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA;AACT;AAGO,MAAM,0BAAA,GAAoD;AAAA,EAC/D,IAAA;AAAA,EACA,OAAA;AAAA,EACA,kBAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,mBAAA,CAAoB,SAAS,OAAA,EAAS;AACpC,IAAA,OAAO,EAAE,GAAG,OAAA,EAAQ;AAAA,EACtB;AACF;;;;"}

package/dist/provider/BUIContext.esm.js

@@ -0,0 +1,6 @@
+import { createVersionedContext } from '@backstage/version-bridge';
+
+const BUIContext = createVersionedContext("bui");
+
+export { BUIContext };
+//# sourceMappingURL=BUIContext.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BUIContext.esm.js","sources":["../../src/provider/BUIContext.ts"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createVersionedContext } from '@backstage/version-bridge';\nimport type { UseAnalyticsFn } from '../analytics/types';\nimport type { BUIRoutingIntegration } from '../navigation/types';\n\n/** @internal */\nexport type BUIContextValueV1 = {\n  useAnalytics?: UseAnalyticsFn;\n};\n\n/** @internal */\nexport type BUIContextValueV2 = {\n  useAnalytics?: UseAnalyticsFn;\n  routing: BUIRoutingIntegration;\n};\n\n/** @internal */\nexport type BUIContextVersions = {\n  1: BUIContextValueV1;\n  2: BUIContextValueV2;\n};\n\n/** @internal */\nexport const BUIContext = createVersionedContext<BUIContextVersions>('bui');\n"],"names":[],"mappings":";;AAsCO,MAAM,UAAA,GAAa,uBAA2C,KAAK;;;;"}

package/dist/provider/BUIProvider.esm.js

@@ -1,28 +1,20 @@
 import { jsx } from 'react/jsx-runtime';
 import { useMemo } from 'react';
-import { RouterProvider } from 'react-aria-components';
-import { useInRouterContext, useNavigate } from 'react-router-dom';
 import { createVersionedValueMap } from '@backstage/version-bridge';
-import { BUIContext } from '../analytics/useAnalytics.esm.js';
-import { useResolvedHref } from '../hooks/useResolvedHref.esm.js';
+import { BUIContext } from './BUIContext.esm.js';
+import { buiRoutingIntegration, BUIRoutingProvider } from '../navigation/BUIRoutingProvider.esm.js';
 
 function BUIProvider(props) {
   const { useAnalytics, children } = props;
   const value = useMemo(
     () => createVersionedValueMap({
-      1: { useAnalytics }
+      1: { useAnalytics },
+      2: { useAnalytics, routing: buiRoutingIntegration }
     }),
     [useAnalytics]
   );
   const content = /* @__PURE__ */ jsx(BUIContext.Provider, { value, children });
-  if (useInRouterContext()) {
-    return /* @__PURE__ */ jsx(RoutedContent, { children: content });
-  }
-  return content;
-}
-function RoutedContent({ children }) {
-  const navigate = useNavigate();
-  return /* @__PURE__ */ jsx(RouterProvider, { navigate, useHref: useResolvedHref, children });
+  return /* @__PURE__ */ jsx(BUIRoutingProvider, { children: content });
 }
 
 export { BUIProvider };

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

@@ -1 +1 @@
-{"version":3,"file":"BUIProvider.esm.js","sources":["../../src/provider/BUIProvider.tsx"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useMemo, type ReactNode } from 'react';\nimport { RouterProvider } from 'react-aria-components';\nimport { useInRouterContext, useNavigate } from 'react-router-dom';\nimport { createVersionedValueMap } from '@backstage/version-bridge';\nimport { BUIContext } from '../analytics/useAnalytics';\nimport { useResolvedHref } from '../hooks/useResolvedHref';\nimport type { UseAnalyticsFn } from '../analytics/types';\n\n/** @public */\nexport type BUIProviderProps = {\n  useAnalytics?: UseAnalyticsFn;\n  children: ReactNode;\n};\n\n/**\n * Provides integration capabilities to all descendant BUI components.\n *\n * @example\n * ```tsx\n * import { BUIProvider } from '@backstage/ui';\n * import { useAnalytics as useBackstageAnalytics } from '@backstage/core-plugin-api';\n *\n * function App() {\n *   return (\n *     <BUIProvider useAnalytics={useBackstageAnalytics}>\n *       <AppContent />\n *     </BUIProvider>\n *   );\n * }\n * ```\n *\n * @public\n */\nexport function BUIProvider(props: BUIProviderProps) {\n  const { useAnalytics, children } = props;\n  const value = useMemo(\n    () =>\n      createVersionedValueMap({\n        1: { useAnalytics },\n      }),\n    [useAnalytics],\n  );\n\n  const content = (\n    <BUIContext.Provider value={value}>{children}</BUIContext.Provider>\n  );\n\n  if (useInRouterContext()) {\n    return <RoutedContent>{content}</RoutedContent>;\n  }\n\n  return content;\n}\n\nfunction RoutedContent({ children }: { children: ReactNode }) {\n  const navigate = useNavigate();\n  return (\n    <RouterProvider navigate={navigate} useHref={useResolvedHref}>\n      {children}\n    </RouterProvider>\n  );\n}\n"],"names":[],"mappings":";;;;;;;;AAiDO,SAAS,YAAY,KAAA,EAAyB;AACnD,EAAA,MAAM,EAAE,YAAA,EAAc,QAAA,EAAS,GAAI,KAAA;AACnC,EAAA,MAAM,KAAA,GAAQ,OAAA;AAAA,IACZ,MACE,uBAAA,CAAwB;AAAA,MACtB,CAAA,EAAG,EAAE,YAAA;AAAa,KACnB,CAAA;AAAA,IACH,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,0BACJ,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAoB,OAAe,QAAA,EAAS,CAAA;AAG/C,EAAA,IAAI,oBAAmB,EAAG;AACxB,IAAA,uBAAO,GAAA,CAAC,iBAAe,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,EACjC;AAEA,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,aAAA,CAAc,EAAE,QAAA,EAAS,EAA4B;AAC5D,EAAA,MAAM,WAAW,WAAA,EAAY;AAC7B,EAAA,uBACE,GAAA,CAAC,cAAA,EAAA,EAAe,QAAA,EAAoB,OAAA,EAAS,iBAC1C,QAAA,EACH,CAAA;AAEJ;;;;"}
+{"version":3,"file":"BUIProvider.esm.js","sources":["../../src/provider/BUIProvider.tsx"],"sourcesContent":["/*\n * Copyright 2026 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useMemo, type ReactNode } from 'react';\nimport { createVersionedValueMap } from '@backstage/version-bridge';\nimport { BUIContext } from './BUIContext';\nimport type { UseAnalyticsFn } from '../analytics/types';\nimport {\n  BUIRoutingProvider,\n  buiRoutingIntegration,\n} from '../navigation/BUIRoutingProvider';\n\n/** @public */\nexport type BUIProviderProps = {\n  useAnalytics?: UseAnalyticsFn;\n  children: ReactNode;\n};\n\n/**\n * Provides integration capabilities to all descendant BUI components.\n *\n * When rendered inside the Backstage app router, BUI components use\n * client-side navigation for internal links. Relative destinations resolve\n * from the route of the component that renders the link, and the router\n * basename applies once.\n *\n * External and scheme links, downloads, and links with non-self targets use the\n * browser's native navigation. BUI components rendered outside React Router use\n * native links without throwing.\n *\n * @example\n * ```tsx\n * import { BUIProvider } from '@backstage/ui';\n * import { useAnalytics as useBackstageAnalytics } from '@backstage/core-plugin-api';\n *\n * function App() {\n *   return (\n *     <BUIProvider useAnalytics={useBackstageAnalytics}>\n *       <AppContent />\n *     </BUIProvider>\n *   );\n * }\n * ```\n *\n * @public\n */\nexport function BUIProvider(props: BUIProviderProps) {\n  const { useAnalytics, children } = props;\n  const value = useMemo(\n    () =>\n      createVersionedValueMap({\n        1: { useAnalytics },\n        2: { useAnalytics, routing: buiRoutingIntegration },\n      }),\n    [useAnalytics],\n  );\n\n  const content = (\n    <BUIContext.Provider value={value}>{children}</BUIContext.Provider>\n  );\n  return <BUIRoutingProvider>{content}</BUIRoutingProvider>;\n}\n"],"names":[],"mappings":";;;;;;AA2DO,SAAS,YAAY,KAAA,EAAyB;AACnD,EAAA,MAAM,EAAE,YAAA,EAAc,QAAA,EAAS,GAAI,KAAA;AACnC,EAAA,MAAM,KAAA,GAAQ,OAAA;AAAA,IACZ,MACE,uBAAA,CAAwB;AAAA,MACtB,CAAA,EAAG,EAAE,YAAA,EAAa;AAAA,MAClB,CAAA,EAAG,EAAE,YAAA,EAAc,OAAA,EAAS,qBAAA;AAAsB,KACnD,CAAA;AAAA,IACH,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,0BACJ,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAoB,OAAe,QAAA,EAAS,CAAA;AAE/C,EAAA,uBAAO,GAAA,CAAC,sBAAoB,QAAA,EAAA,OAAA,EAAQ,CAAA;AACtC;;;;"}

package/dist/utils/linkUtils.esm.js

@@ -1,19 +1,13 @@
+const ABSOLUTE_DESTINATION = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i;
+function isBrowserOwnedHref(href) {
+  return ABSOLUTE_DESTINATION.test(href);
+}
 function isExternalLink(href) {
-  if (!href) return false;
-  if (href.startsWith("http://") || href.startsWith("https://")) {
-    return true;
-  }
-  if (href.startsWith("//")) {
-    return true;
-  }
-  if (href.startsWith("mailto:") || href.startsWith("tel:")) {
-    return true;
-  }
-  return false;
+  return href ? isBrowserOwnedHref(href) : false;
 }
 function isInternalLink(href) {
   return !!href && !isExternalLink(href);
 }
 
-export { isExternalLink, isInternalLink };
+export { isBrowserOwnedHref, isExternalLink, isInternalLink };
 //# sourceMappingURL=linkUtils.esm.js.map

package/dist/utils/linkUtils.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"linkUtils.esm.js","sources":["../../src/utils/linkUtils.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Determines if a link is external.\n * @param href - The href of the link.\n * @returns True if the link is external, false otherwise.\n * @internal\n */\nexport function isExternalLink(href?: string): boolean {\n  if (!href) return false;\n\n  // Check if it's an absolute URL with protocol\n  if (href.startsWith('http://') || href.startsWith('https://')) {\n    return true;\n  }\n\n  // Check if it's a protocol-relative URL\n  if (href.startsWith('//')) {\n    return true;\n  }\n\n  // Check if it's a mailto: or tel: link\n  if (href.startsWith('mailto:') || href.startsWith('tel:')) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Checks if an href is an internal link (not external and not empty).\n *\n * @internal\n */\nexport function isInternalLink(href: string | undefined): href is string {\n  return !!href && !isExternalLink(href);\n}\n"],"names":[],"mappings":"AAsBO,SAAS,eAAe,IAAA,EAAwB;AACrD,EAAA,IAAI,CAAC,MAAM,OAAO,KAAA;AAGlB,EAAA,IAAI,KAAK,UAAA,CAAW,SAAS,KAAK,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,EAAG;AAC7D,IAAA,OAAO,IAAA;AAAA,EACT;AAGA,EAAA,IAAI,IAAA,CAAK,UAAA,CAAW,IAAI,CAAA,EAAG;AACzB,IAAA,OAAO,IAAA;AAAA,EACT;AAGA,EAAA,IAAI,KAAK,UAAA,CAAW,SAAS,KAAK,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,EAAG;AACzD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO,KAAA;AACT;AAOO,SAAS,eAAe,IAAA,EAA0C;AACvE,EAAA,OAAO,CAAC,CAAC,IAAA,IAAQ,CAAC,eAAe,IAAI,CAAA;AACvC;;;;"}
+{"version":3,"file":"linkUtils.esm.js","sources":["../../src/utils/linkUtils.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nconst ABSOLUTE_DESTINATION = /^(?:[a-z][a-z0-9+.-]*:|\\/\\/)/i;\n\n/** @internal */\nexport function isBrowserOwnedHref(href: string): boolean {\n  return ABSOLUTE_DESTINATION.test(href);\n}\n\n/**\n * Determines if a link is external.\n * @param href - The href of the link.\n * @returns True if the link is external, false otherwise.\n * @internal\n */\nexport function isExternalLink(href?: string): boolean {\n  return href ? isBrowserOwnedHref(href) : false;\n}\n\n/**\n * Checks if an href is an internal link (not external and not empty).\n *\n * @internal\n */\nexport function isInternalLink(href: string | undefined): href is string {\n  return !!href && !isExternalLink(href);\n}\n"],"names":[],"mappings":"AAgBA,MAAM,oBAAA,GAAuB,+BAAA;AAGtB,SAAS,mBAAmB,IAAA,EAAuB;AACxD,EAAA,OAAO,oBAAA,CAAqB,KAAK,IAAI,CAAA;AACvC;AAQO,SAAS,eAAe,IAAA,EAAwB;AACrD,EAAA,OAAO,IAAA,GAAO,kBAAA,CAAmB,IAAI,CAAA,GAAI,KAAA;AAC3C;AAOO,SAAS,eAAe,IAAA,EAA0C;AACvE,EAAA,OAAO,CAAC,CAAC,IAAA,IAAQ,CAAC,eAAe,IAAI,CAAA;AACvC;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/ui",
-  "version": "0.17.2-next.0",
+  "version": "0.18.0-next.1",
   "backstage": {
     "role": "web-library"
   },
@@ -64,8 +64,9 @@
   },
   "devDependencies": {
     "@backstage/cli": "0.36.6-next.0",
-    "@backstage/core-components": "0.18.14-next.0",
+    "@backstage/core-components": "0.18.14-next.1",
     "@storybook/react-vite": "^10.4.0",
+    "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",
     "@types/react": "^18.0.0",