fix(deps): update backstage monorepo (major) #39
No reviewers
Labels
No labels
automerge
bug
dependencies
duplicate
help wanted
invalid
lang
rust
migrations
opencode
question
security
type
documentation
type
enhancement
type
maintenance
type
refactor
vulnerability
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
Personal/backstage!39
Loading…
Reference in a new issue
No description provided.
Delete branch "renovate/major-backstage-monorepo"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
This PR contains the following updates:
^0.18.2→^1.0.0^0.6.5→^1.0.0^2.2.6→^3.0.0Release Notes
backstage/backstage (@backstage/frontend-plugin-api)
v1.0.0Compare Source
Major Changes
b3befd0: Released version 1.0 of this frontend framework package. Its public APIs are now stable under the package versioning policy. Alpha and beta APIs retain their existing stability levels.Minor Changes
5a539ca: BREAKING: ThepluginIdproperty of plugins passed as aFrontendFeatureis now required. Plugins built against framework versions that predatepluginIdmust be rebuilt against a current version.6540a44: BREAKING:useApinow unwraps promise-valued APIs, suspending while pendingand throwing rejection reasons to an error boundary. Its return type is
Awaited<T>. Existing consumers that intentionally used the promise returned byuseApimust use a direct holder lookup instead.Declare lazy implementations with
ApiRef<Promise<MyApi>>. API holders,factories, and dependencies keep their existing contracts and pass the declared
value through unchanged.
See the Utility API documentation
for lazy implementations, Suspense boundaries, and migration requirements.
d514e4d: BREAKING: Removed the deprecatedExtensionFactoryMiddlewaretype export. Import it from@backstage/frontend-app-apiinstead:Add
@backstage/frontend-app-apias a dependency of your app package if it is not already declared. Middleware behavior is unchanged.0a552cf: BREAKING: Removed theExtensionAttachTotype export. UseExtension<unknown>['attachTo']if you need to reference the attachment type.62268a9: BREAKING: Removed theAnalyticsImplementationtype and the deprecatedAnalyticsImplementationBlueprintandAnalyticsImplementationFactoryexports. Import them from@backstage/plugin-app-reactinstead. No changes to their usage are needed beyond updating the imports.86ff5a3: Removed the deprecatedPageTabandPluginOptionstypes. UsePageLayoutTabandCreateFrontendPluginOptionsinstead.8ae0b8e: BREAKING: Removed the deprecatedIconComponentexport. UseIconElementand pass<MyIcon />rather thanMyIconwhen working with icons in the new frontend system. Legacy integrations that still need a component type can importIconComponentfrom@backstage/core-plugin-api. Auth provider icons continue to accept components with the same optionalfontSizeprop.806a9cf: BREAKING: Removed the/alphaentry point. All of its exports are already available from@backstage/frontend-plugin-api; update imports to use the main entry point instead:The exported APIs retain the same behavior and identity. For the deprecated
pluginWrapperApiRef, prefercoreApis.internal.pluginWrapperfrom the main entry point.dafdab8: BREAKING: Removed the deprecatedwithApisexport. Wrap class components in a function component that usesuseApiinstead:0f2ffc9: BREAKING: Removed theProgressPropstype. Replace imports and usages of this type with its existing shape,{}. TheProgresscomponent and its props contract are unchanged.a5b3445: Added router-independent navigation and routing APIs:RouterLink,AppHistoryApi(also available ascoreApis.appHistory),useAppNavigate,useAppHref,useAppLocation,useAppSearchParams, andRouteResolutionApi.resolvePathfor matched routing ancestry. BREAKING:useRouteRefParamsreturns only parameters declared by the supplied route ref, withundefinedfor unmatched parameters, and no longer includes the splat*. See the 1.57 migration notes for detailed migration steps.The stable public
/routingentry point exposesRoutingProvider,RoutingIntegration, anduseRoutingIntegrationfor router and component-library integrations. It has the same stability and compatibility guarantees as the main entry point; app history APIs, plugin navigation hooks, and route refs remain in the main entry point.AppNavigatedescribes the navigation function returned byuseAppNavigate.e55a4a8: BREAKING: Removed the deprecatedFrontendPlugin.idproperty from the public interface. UsepluginIdinstead. The runtime alias is retained for compatibility with older apps.7285912: BREAKING PRODUCERS:TranslationSnapshotnow requiresteven whenreadyis false. CustomTranslationApiimplementations must provide a translator using available messages and language fallbacks.d84cf73: Removed the deprecatedDialogApi.show,DialogApi.showModal, andIconsApi.getIconmethods. UseDialogApi.openwith your own dialog presentation, andIconsApi.iconto retrieve icon elements.The API references now use
core.dialog.v2andcore.icons.v2. Upgrade@backstage/plugin-appalongside this package, and update custom API implementations to use the new references.Patch Changes
ca02018: API reference IDs now use plugin ID validation for each dot-separated component.This accepts numeric dash groups and mixed case, including IDs such as
plugin.example-2.todos.ac2de0f: Fixed a "Type instantiation is excessively deep and possibly infinite" error fromcreateFrontendPluginin plugins with many extensions, in particular with TypeScript 5.9 and later. In rare cases, the extensions in the type of a plugin may be in a different order or include extensions that were missing before.d5e1d51: DeprecatedAnyApiRefandAnyApiFactory. UseApiRefandApiFactorywithout type arguments instead; their new defaults match the existing aliases. The deprecated aliases remain available for compatibility.d47986a: Improved type inference for deeply nested and cyclic translation messages. Required replacement values and plural counts are inferred at any depth, and count interpolation requires a numeric value.8ca78a2: AddedcoreApis, an object of core Utility API refs, with framework infrastructure APIs grouped undercoreApis.internal: app lifecycle, OAuth requests, plugin header actions, plugin wrappers, and swappable components. The nested object is public. The deprecated Alert API is excluded in favor of Toast. The individual refs with object equivalents are deprecated in favor of their matching object members, while remaining compatible. Provider-specific authentication refs remain separate and are not deprecated.4bbc7a9: Removed explicit support for React 17: the peer dependency range forreact,react-domand@types/reactis now^18.0.0. React 17 is no longer tested or guaranteed to work, although it may continue to work in some cases. See the migration guide.9d0a31b: Removed an unuseduse-sync-external-storedependency, which is no longer needed now that React 18 is the minimum supported version.6928d62: Fixed swappable components losing their mounted state when their props change. The resolved component remains stable while its props update.641ac02: AddedcoreExtensionData.titleTranslationto provide a translation message selection alongside a static title. Consumers can opt in to translated titles. The selection must not require formatting values.7594fd4: Page and sub-page blueprints now accept typed translation message selections in theirtitleparameter, using existing translation resources. Select a message by calling a translation ref, for examplemyTranslationRef('page.title'). TypeScript checks the key and rejects messages that require formatting values.Resolved translations take precedence over configured titles in every language, including the default language. Titles wait for the selected language on first load and retain resolved values during later loads or failures, preserving page state.
TranslationRefvalues are now callable functions. Treat refs as opaque values rather than checking for plain objects or cloning them.Updated dependencies
backstage/backstage (@backstage/frontend-test-utils)
v1.0.0Compare Source
Major Changes
b3befd0: Released version 1.0 of this frontend framework package. Its public APIs are now stable under the package versioning policy. Alpha and beta APIs retain their existing stability levels.Minor Changes
76b1c3d: Removed the deprecated standalone mock API type exports and the non-deprecatedMockFetchApiOptionsexport. Use the correspondingmockApishelpers to create instances and derive types as follows:MockAlertApiReturnType<typeof mockApis.alert>MockAnalyticsApiReturnType<typeof mockApis.analytics>MockConfigApiReturnType<typeof mockApis.config>MockErrorApiReturnType<typeof mockApis.error>MockFeatureFlagsApiReturnType<typeof mockApis.featureFlags>MockFetchApiReturnType<typeof mockApis.fetch>MockPermissionApiReturnType<typeof mockApis.permission>MockStorageApiReturnType<typeof mockApis.storage>MockTranslationApiReturnType<typeof mockApis.translation>MockErrorApiOptionsNonNullable<Parameters<typeof mockApis.error>[0]>MockFetchApiOptionsNonNullable<Parameters<typeof mockApis.fetch>[0]>MockFeatureFlagsApiOptionsNonNullable<Parameters<typeof mockApis.featureFlags>[0]>ErrorWithContextReturnType<ReturnType<typeof mockApis.error>['getErrors']>[number]Import
mockApisfrom@backstage/frontend-test-utils. For example, usemockApis.analytics()to create an analytics mock andReturnType<typeof mockApis.analytics>when you need an explicit instance type. Existing calls to the helpers require no changes. Inspection methods such asgetEvents,getErrors, andgetAlerts, along with legacy alert support, remain available.2aa14e3: Added therenderAs: 'chrome'option torenderInTestAppand mock utilities for navigation tests:mockApis.appHistory()andmockApis.routeResolution(). Page matching uses framework routing; wrap test elements in their page adapter when they need routing-library context. See the 1.57 migration notes for detailed migration steps and the routing test guide for examples.53ab1aa: BREAKING:renderInTestApp,renderTestAppandcreateExtensionTesternow throw for every error reported while creating the test app or extension tree, including the ones a real app only logs as warnings, such asEXTENSION_IGNORED. PreviouslyrenderInTestAppandrenderTestAppignored these errors, so a test could pass for an app that is broken. All three helpers accept a newisExpectedErroroption to allow specific errors.Migration: fix the reported error in the test setup. The error message names the code to allow if the error is expected:
A common one is
API_FACTORY_CONFLICTfrom providing an API that another plugin owns, such as acore.*API passed inextensions. That override was always rejected, so remove it, or use theapisoption to replace an API in a test.8ca78a2: BREAKING UpdatedrenderInTestAppandrenderTestAppto provide default API implementations that are more suitable for testing. This may break existing tests that rely on the previous defaults:localStorage. Tests that seed or inspectlocalStorage, or rely on storage persisting between test apps, need to supply an explicit storage implementation.Explicit API overrides continue to take precedence over the defaults.
Added
mockApishelpers for all APIs incoreApis, including those grouped undercoreApis.internal. These cover app state, dialogs, icons, OAuth requests, plugin wrappers and header actions, route resolution, swappable components, and toast notifications. Each.mock()helper provides typed Jest stubs without default behavior that can be registered directly with frontend test utilities.Added functional in-memory fakes for language, lifecycle, themes, icons, OAuth requests, plugin header actions, and toast notifications. Except for lifecycle, these can be supplied explicitly through the test app's
apisoption to configure behavior and inspect state. UseTestApiProviderfor the lifecycle fake, since test apps manage their own lifecycle.Fixed storage fake isolation for nested buckets with the same name under different parents.
e3d50c4: Removed the deprecatedshowandshowModalmethods from dialog test helpers, andgetIconfrom icons test helpers. Update tests to useopenfor dialogs andiconfor icon elements.Patch Changes
6540a44:renderInTestAppnow handles suspended content with an empty fallback, sopromise-valued APIs do not require a Suspense wrapper in each test. Use asynchronous
queries such as
findByTextto await suspended content. Elements that do notsuspend still render immediately. When a descendant suspends, the entire element
waits unless an inner Suspense boundary
isolates it. An inner boundary also controls its own fallback. Tests that relied
on an ancestor boundary's loading UI may need updated assertions.
Test API tuples for promise-valued refs accept both synchronous partial
implementations and promises of partial implementations. Synchronous mocks render
immediately and pass through unchanged. Use promise mocks to test loading,
failures, or code that calls promise methods.
Fixed test rendering helpers losing their test extensions when a plugin named
testis included infeatures.4bbc7a9: Removed explicit support for React 17: the peer dependency range forreact,react-domand@types/reactis now^18.0.0. React 17 is no longer tested or guaranteed to work, although it may continue to work in some cases. See the migration guide.9d0a31b: Removed an unuseduse-sync-external-storedependency, which is no longer needed now that React 18 is the minimum supported version.ec245df: Addedapisto the results ofrenderInTestAppandrenderTestApp, providing access to the app's Utility APIs using API refs. The holder exposes the same instances used by components, including registered APIs and test overrides.Updated dependencies
backstage/backstage (@backstage/plugin-catalog-node)
v3.0.0Compare Source
Patch Changes
Configuration
📅 Schedule: (UTC)
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
This PR has been generated by Mend Renovate CLI.
16e67bee5bd26a292580fix(deps): update backstage monorepo to v1to fix(deps): update backstage monorepo (major)⚠️ Artifact update problem
Renovate failed to update artifacts related to this branch. You probably do not want to merge this PR as-is.
♻ Renovate will retry this branch, including artifacts, only when one of the following happens:
The artifact failure details are included below:
File name: bun.lock
File name: bun.lock
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.Merge
Merge the changes and update on Forgejo.Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.