@backstage/plugin-app-react 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @backstage/plugin-app-react
 
+## 0.2.0
+
+### Minor Changes
+
+- a2133be: Added new `NavContentNavItem`, `NavContentNavItems`, and `navItems` prop to `NavContentComponentProps` for auto-discovering navigation items from page extensions. The new `navItems` collection supports `take(id)` and `rest()` methods for placing specific items in custom sidebar positions, as well as `withComponent(Component)` which returns a `NavContentNavItemsWithComponent` for rendering items directly as elements. The existing `items` prop is now deprecated in favor of `navItems`.
+
+### Patch Changes
+
+- ef6916e: Added `IconElement` type as a replacement for the deprecated `IconComponent`. The `IconsApi` now has a new `icon()` method that returns `IconElement`, while the existing `getIcon()` method is deprecated. The `IconBundleBlueprint` now accepts both `IconComponent` and `IconElement` values.
+- 409af72: Internal refactor to move implementation of blueprints from `@backstage/frontend-plugin-api` to this package.
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.14.0
+  - @backstage/core-plugin-api@1.12.3
+
+## 0.1.1-next.0
+
+### Patch Changes
+
+- 409af72: Internal refactor to move implementation of blueprints from `@backstage/frontend-plugin-api` to this package.
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.14.0-next.0
+  - @backstage/core-plugin-api@1.12.2-next.0
+
 ## 0.1.0
 
 ### Minor Changes

package/dist/blueprints/AppRootWrapperBlueprint.esm.js

@@ -0,0 +1,17 @@
+import { createExtensionDataRef, createExtensionBlueprint } from '@backstage/frontend-plugin-api';
+
+const componentDataRef = createExtensionDataRef().with({ id: "app.root.wrapper" });
+const AppRootWrapperBlueprint = createExtensionBlueprint({
+  kind: "app-root-wrapper",
+  attachTo: { id: "app/root", input: "wrappers" },
+  output: [componentDataRef],
+  dataRefs: {
+    component: componentDataRef
+  },
+  *factory(params) {
+    yield componentDataRef(params.component);
+  }
+});
+
+export { AppRootWrapperBlueprint };
+//# sourceMappingURL=AppRootWrapperBlueprint.esm.js.map

package/dist/blueprints/AppRootWrapperBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRootWrapperBlueprint.esm.js","sources":["../../src/blueprints/AppRootWrapperBlueprint.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 { ReactNode } from 'react';\nimport {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\n\nconst componentDataRef = createExtensionDataRef<\n  (props: { children: ReactNode }) => JSX.Element | null\n>().with({ id: 'app.root.wrapper' });\n\n/**\n * Creates a extensions that render a React wrapper at the app root, enclosing\n * the app layout. This is useful for example for adding global React contexts\n * and similar. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const AppRootWrapperBlueprint = createExtensionBlueprint({\n  kind: 'app-root-wrapper',\n  attachTo: { id: 'app/root', input: 'wrappers' },\n  output: [componentDataRef],\n  dataRefs: {\n    component: componentDataRef,\n  },\n  *factory(params: {\n    /** @deprecated use the `component` parameter instead */\n    Component?: [error: 'Use the `component` parameter instead'];\n    component: (props: { children: ReactNode }) => JSX.Element | null;\n  }) {\n    yield componentDataRef(params.component);\n  },\n});\n"],"names":[],"mappings":";;AAsBA,MAAM,mBAAmB,sBAAA,EAEvB,CAAE,KAAK,EAAE,EAAA,EAAI,oBAAoB,CAAA;AAS5B,MAAM,0BAA0B,wBAAA,CAAyB;AAAA,EAC9D,IAAA,EAAM,kBAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,UAAA,EAAY,OAAO,UAAA,EAAW;AAAA,EAC9C,MAAA,EAAQ,CAAC,gBAAgB,CAAA;AAAA,EACzB,QAAA,EAAU;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AAAA,EACA,CAAC,QAAQ,MAAA,EAIN;AACD,IAAA,MAAM,gBAAA,CAAiB,OAAO,SAAS,CAAA;AAAA,EACzC;AACF,CAAC;;;;"}

package/dist/blueprints/IconBundleBlueprint.esm.js

@@ -0,0 +1,15 @@
+import { createExtensionDataRef, createExtensionBlueprint } from '@backstage/frontend-plugin-api';
+
+const iconsDataRef = createExtensionDataRef().with({ id: "core.icons" });
+const IconBundleBlueprint = createExtensionBlueprint({
+  kind: "icon-bundle",
+  attachTo: { id: "api:app/icons", input: "icons" },
+  output: [iconsDataRef],
+  factory: (params) => [iconsDataRef(params.icons)],
+  dataRefs: {
+    icons: iconsDataRef
+  }
+});
+
+export { IconBundleBlueprint };
+//# sourceMappingURL=IconBundleBlueprint.esm.js.map

package/dist/blueprints/IconBundleBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconBundleBlueprint.esm.js","sources":["../../src/blueprints/IconBundleBlueprint.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 { IconComponent, IconElement } from '@backstage/frontend-plugin-api';\nimport {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\n\nconst iconsDataRef = createExtensionDataRef<{\n  [key in string]: IconComponent | IconElement;\n}>().with({ id: 'core.icons' });\n\n/**\n * Creates an extension that adds icon bundles to your app. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const IconBundleBlueprint = createExtensionBlueprint({\n  kind: 'icon-bundle',\n  attachTo: { id: 'api:app/icons', input: 'icons' },\n  output: [iconsDataRef],\n  factory: (params: {\n    icons: { [key in string]: IconComponent | IconElement };\n  }) => [iconsDataRef(params.icons)],\n  dataRefs: {\n    icons: iconsDataRef,\n  },\n});\n"],"names":[],"mappings":";;AAsBA,MAAM,eAAe,sBAAA,EAElB,CAAE,KAAK,EAAE,EAAA,EAAI,cAAc,CAAA;AAOvB,MAAM,sBAAsB,wBAAA,CAAyB;AAAA,EAC1D,IAAA,EAAM,aAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,eAAA,EAAiB,OAAO,OAAA,EAAQ;AAAA,EAChD,MAAA,EAAQ,CAAC,YAAY,CAAA;AAAA,EACrB,SAAS,CAAC,MAAA,KAEJ,CAAC,YAAA,CAAa,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACjC,QAAA,EAAU;AAAA,IACR,KAAA,EAAO;AAAA;AAEX,CAAC;;;;"}

package/dist/blueprints/NavContentBlueprint.esm.js

@@ -0,0 +1,19 @@
+import { createExtensionDataRef, createExtensionBlueprint } from '@backstage/frontend-plugin-api';
+
+const componentDataRef = createExtensionDataRef().with({
+  id: "core.nav-content.component"
+});
+const NavContentBlueprint = createExtensionBlueprint({
+  kind: "nav-content",
+  attachTo: { id: "app/nav", input: "content" },
+  output: [componentDataRef],
+  dataRefs: {
+    component: componentDataRef
+  },
+  *factory(params) {
+    yield componentDataRef(params.component);
+  }
+});
+
+export { NavContentBlueprint };
+//# sourceMappingURL=NavContentBlueprint.esm.js.map

package/dist/blueprints/NavContentBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavContentBlueprint.esm.js","sources":["../../src/blueprints/NavContentBlueprint.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 { ComponentType } from 'react';\nimport {\n  AppNode,\n  IconComponent,\n  IconElement,\n  RouteRef,\n} from '@backstage/frontend-plugin-api';\nimport {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\n\n/**\n * A navigation item auto-discovered from a page extension in the app.\n *\n * @public\n */\nexport interface NavContentNavItem {\n  /** The app node of the page extension that this nav item points to */\n  node: AppNode;\n  /** The resolved route path */\n  href: string;\n  /** The display title */\n  title: string;\n  /** The display icon */\n  icon: IconElement;\n  /** The route ref of the source page */\n  routeRef: RouteRef;\n}\n\n/**\n * A pre-bound renderer that wraps {@link NavContentNavItems} with a component,\n * so that `take` and `rest` return rendered elements directly.\n *\n * @public\n */\nexport interface NavContentNavItemsWithComponent {\n  /** Render and take a specific item by extension ID. Returns null if not found. */\n  take(id: string): JSX.Element | null;\n  /** Render all remaining items not yet taken, optionally sorted. */\n  rest(options?: { sortBy?: 'title' }): JSX.Element[];\n}\n\n/**\n * A collection of nav items that supports picking specific items by ID\n * and retrieving whatever remains. Created fresh for each render.\n *\n * @public\n */\nexport interface NavContentNavItems {\n  /** Take an item by extension ID, removing it from the collection. */\n  take(id: string): NavContentNavItem | undefined;\n  /** All items not yet taken. */\n  rest(): NavContentNavItem[];\n  /** Create a copy of the collection preserving the current taken state. */\n  clone(): NavContentNavItems;\n  /** Create a renderer that wraps take/rest to return pre-rendered elements. */\n  withComponent(\n    Component: ComponentType<NavContentNavItem>,\n  ): NavContentNavItemsWithComponent;\n}\n\n/**\n * The props for the {@link NavContentComponent}.\n *\n * @public\n */\nexport interface NavContentComponentProps {\n  /**\n   * Nav items auto-discovered from page extensions, with take/rest semantics\n   * for placing specific items in specific positions.\n   */\n  navItems: NavContentNavItems;\n\n  /**\n   * Flat list of nav items for simple rendering. Use `navItems` for more\n   * control over item placement.\n   *\n   * @deprecated Use `navItems` instead.\n   */\n  items: Array<{\n    icon: IconComponent;\n    title: string;\n    routeRef: RouteRef<undefined>;\n    to: string;\n    text: string;\n  }>;\n}\n\n/**\n * A component that renders the nav bar content, to be passed to the {@link NavContentBlueprint}.\n *\n * @public\n */\nexport type NavContentComponent = (\n  props: NavContentComponentProps,\n) => JSX.Element | null;\n\nconst componentDataRef = createExtensionDataRef<NavContentComponent>().with({\n  id: 'core.nav-content.component',\n});\n\n/**\n * Creates an extension that replaces the entire nav bar with your own component. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const NavContentBlueprint = createExtensionBlueprint({\n  kind: 'nav-content',\n  attachTo: { id: 'app/nav', input: 'content' },\n  output: [componentDataRef],\n  dataRefs: {\n    component: componentDataRef,\n  },\n  *factory(params: { component: NavContentComponent }) {\n    yield componentDataRef(params.component);\n  },\n});\n"],"names":[],"mappings":";;AAkHA,MAAM,gBAAA,GAAmB,sBAAA,EAA4C,CAAE,IAAA,CAAK;AAAA,EAC1E,EAAA,EAAI;AACN,CAAC,CAAA;AAOM,MAAM,sBAAsB,wBAAA,CAAyB;AAAA,EAC1D,IAAA,EAAM,aAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,SAAA,EAAW,OAAO,SAAA,EAAU;AAAA,EAC5C,MAAA,EAAQ,CAAC,gBAAgB,CAAA;AAAA,EACzB,QAAA,EAAU;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AAAA,EACA,CAAC,QAAQ,MAAA,EAA4C;AACnD,IAAA,MAAM,gBAAA,CAAiB,OAAO,SAAS,CAAA;AAAA,EACzC;AACF,CAAC;;;;"}

package/dist/blueprints/RouterBlueprint.esm.js

@@ -0,0 +1,17 @@
+import { createExtensionDataRef, createExtensionBlueprint } from '@backstage/frontend-plugin-api';
+
+const componentDataRef = createExtensionDataRef().with({ id: "app.router.wrapper" });
+const RouterBlueprint = createExtensionBlueprint({
+  kind: "app-router-component",
+  attachTo: { id: "app/root", input: "router" },
+  output: [componentDataRef],
+  dataRefs: {
+    component: componentDataRef
+  },
+  *factory(params) {
+    yield componentDataRef(params.component);
+  }
+});
+
+export { RouterBlueprint };
+//# sourceMappingURL=RouterBlueprint.esm.js.map

package/dist/blueprints/RouterBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterBlueprint.esm.js","sources":["../../src/blueprints/RouterBlueprint.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 { ReactNode } from 'react';\nimport {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\n\nconst componentDataRef = createExtensionDataRef<\n  (props: { children: ReactNode }) => JSX.Element | null\n>().with({ id: 'app.router.wrapper' });\n\n/**\n * Creates an extension that replaces the router component. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const RouterBlueprint = createExtensionBlueprint({\n  kind: 'app-router-component',\n  attachTo: { id: 'app/root', input: 'router' },\n  output: [componentDataRef],\n  dataRefs: {\n    component: componentDataRef,\n  },\n  *factory(params: {\n    /** @deprecated use the `component` parameter instead */\n    Component?: [error: 'Use the `component` parameter instead'];\n    component: (props: { children: ReactNode }) => JSX.Element | null;\n  }) {\n    yield componentDataRef(params.component);\n  },\n});\n"],"names":[],"mappings":";;AAsBA,MAAM,mBAAmB,sBAAA,EAEvB,CAAE,KAAK,EAAE,EAAA,EAAI,sBAAsB,CAAA;AAO9B,MAAM,kBAAkB,wBAAA,CAAyB;AAAA,EACtD,IAAA,EAAM,sBAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,UAAA,EAAY,OAAO,QAAA,EAAS;AAAA,EAC5C,MAAA,EAAQ,CAAC,gBAAgB,CAAA;AAAA,EACzB,QAAA,EAAU;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AAAA,EACA,CAAC,QAAQ,MAAA,EAIN;AACD,IAAA,MAAM,gBAAA,CAAiB,OAAO,SAAS,CAAA;AAAA,EACzC;AACF,CAAC;;;;"}

package/dist/blueprints/SignInPageBlueprint.esm.js

@@ -0,0 +1,24 @@
+import { jsx } from 'react/jsx-runtime';
+import { lazy } from 'react';
+import { createExtensionDataRef, createExtensionBlueprint, ExtensionBoundary } from '@backstage/frontend-plugin-api';
+
+const componentDataRef = createExtensionDataRef().with({ id: "core.sign-in-page.component" });
+const SignInPageBlueprint = createExtensionBlueprint({
+  kind: "sign-in-page",
+  attachTo: { id: "app/root", input: "signInPage" },
+  output: [componentDataRef],
+  dataRefs: {
+    component: componentDataRef
+  },
+  *factory({
+    loader
+  }, { node }) {
+    const ExtensionComponent = lazy(
+      () => loader().then((component) => ({ default: component }))
+    );
+    yield componentDataRef((props) => /* @__PURE__ */ jsx(ExtensionBoundary, { node, children: /* @__PURE__ */ jsx(ExtensionComponent, { ...props }) }));
+  }
+});
+
+export { SignInPageBlueprint };
+//# sourceMappingURL=SignInPageBlueprint.esm.js.map

package/dist/blueprints/SignInPageBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignInPageBlueprint.esm.js","sources":["../../src/blueprints/SignInPageBlueprint.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 { ComponentType, lazy, ReactNode } from 'react';\nimport {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n  ExtensionBoundary,\n  IdentityApi,\n} from '@backstage/frontend-plugin-api';\n\n/**\n * Props for the `SignInPage` component.\n *\n * @public\n */\nexport type SignInPageProps = {\n  /**\n   * Set the IdentityApi on successful sign-in. This should only be called once.\n   */\n  onSignInSuccess(identityApi: IdentityApi): void;\n\n  /**\n   * The children to render.\n   */\n  children?: ReactNode;\n};\n\nconst componentDataRef = createExtensionDataRef<\n  ComponentType<SignInPageProps>\n>().with({ id: 'core.sign-in-page.component' });\n\n/**\n * Creates an extension that replaces the sign in page. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const SignInPageBlueprint = createExtensionBlueprint({\n  kind: 'sign-in-page',\n  attachTo: { id: 'app/root', input: 'signInPage' },\n  output: [componentDataRef],\n  dataRefs: {\n    component: componentDataRef,\n  },\n  *factory(\n    {\n      loader,\n    }: {\n      loader: () => Promise<ComponentType<SignInPageProps>>;\n    },\n    { node },\n  ) {\n    const ExtensionComponent = lazy(() =>\n      loader().then(component => ({ default: component })),\n    );\n\n    yield componentDataRef(props => (\n      <ExtensionBoundary node={node}>\n        <ExtensionComponent {...props} />\n      </ExtensionBoundary>\n    ));\n  },\n});\n"],"names":[],"mappings":";;;;AAyCA,MAAM,mBAAmB,sBAAA,EAEvB,CAAE,KAAK,EAAE,EAAA,EAAI,+BAA+B,CAAA;AAOvC,MAAM,sBAAsB,wBAAA,CAAyB;AAAA,EAC1D,IAAA,EAAM,cAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,UAAA,EAAY,OAAO,YAAA,EAAa;AAAA,EAChD,MAAA,EAAQ,CAAC,gBAAgB,CAAA;AAAA,EACzB,QAAA,EAAU;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AAAA,EACA,CAAC,OAAA,CACC;AAAA,IACE;AAAA,GACF,EAGA,EAAE,IAAA,EAAK,EACP;AACA,IAAA,MAAM,kBAAA,GAAqB,IAAA;AAAA,MAAK,MAC9B,QAAO,CAAE,IAAA,CAAK,gBAAc,EAAE,OAAA,EAAS,WAAU,CAAE;AAAA,KACrD;AAEA,IAAA,MAAM,gBAAA,CAAiB,CAAA,KAAA,qBACrB,GAAA,CAAC,iBAAA,EAAA,EAAkB,IAAA,EACjB,8BAAC,kBAAA,EAAA,EAAoB,GAAG,KAAA,EAAO,CAAA,EACjC,CACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}

package/dist/blueprints/SwappableComponentBlueprint.esm.js

@@ -0,0 +1,23 @@
+import { createExtensionDataRef, createExtensionBlueprint, createExtensionBlueprintParams } from '@backstage/frontend-plugin-api';
+
+const componentDataRef = createExtensionDataRef().with({ id: "core.swappableComponent" });
+const SwappableComponentBlueprint = createExtensionBlueprint({
+  kind: "component",
+  attachTo: { id: "api:app/swappable-components", input: "components" },
+  output: [componentDataRef],
+  dataRefs: {
+    component: componentDataRef
+  },
+  defineParams(params) {
+    return createExtensionBlueprintParams(params);
+  },
+  factory: (params) => [
+    componentDataRef({
+      ref: params.component.ref,
+      loader: params.loader
+    })
+  ]
+});
+
+export { SwappableComponentBlueprint, componentDataRef };
+//# sourceMappingURL=SwappableComponentBlueprint.esm.js.map

package/dist/blueprints/SwappableComponentBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwappableComponentBlueprint.esm.js","sources":["../../src/blueprints/SwappableComponentBlueprint.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 { SwappableComponentRef } from '@backstage/frontend-plugin-api';\nimport {\n  createExtensionBlueprint,\n  createExtensionBlueprintParams,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\n\nexport const componentDataRef = createExtensionDataRef<{\n  ref: SwappableComponentRef;\n  loader:\n    | (() => (props: {}) => JSX.Element | null)\n    | (() => Promise<(props: {}) => JSX.Element | null>);\n}>().with({ id: 'core.swappableComponent' });\n\n/**\n * Blueprint for creating swappable components from a SwappableComponentRef and a loader. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const SwappableComponentBlueprint = createExtensionBlueprint({\n  kind: 'component',\n  attachTo: { id: 'api:app/swappable-components', input: 'components' },\n  output: [componentDataRef],\n  dataRefs: {\n    component: componentDataRef,\n  },\n  defineParams<Ref extends SwappableComponentRef<any>>(params: {\n    component: Ref extends SwappableComponentRef<\n      any,\n      infer IExternalComponentProps\n    >\n      ? { ref: Ref } & ((props: IExternalComponentProps) => JSX.Element | null)\n      : never;\n    loader: Ref extends SwappableComponentRef<infer IInnerComponentProps, any>\n      ?\n          | (() => (props: IInnerComponentProps) => JSX.Element | null)\n          | (() => Promise<(props: IInnerComponentProps) => JSX.Element | null>)\n      : never;\n  }) {\n    return createExtensionBlueprintParams(params);\n  },\n  factory: params => [\n    componentDataRef({\n      ref: params.component.ref,\n      loader: params.loader,\n    }),\n  ],\n});\n"],"names":[],"mappings":";;AAuBO,MAAM,mBAAmB,sBAAA,EAK7B,CAAE,KAAK,EAAE,EAAA,EAAI,2BAA2B;AAOpC,MAAM,8BAA8B,wBAAA,CAAyB;AAAA,EAClE,IAAA,EAAM,WAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,8BAAA,EAAgC,OAAO,YAAA,EAAa;AAAA,EACpE,MAAA,EAAQ,CAAC,gBAAgB,CAAA;AAAA,EACzB,QAAA,EAAU;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AAAA,EACA,aAAqD,MAAA,EAYlD;AACD,IAAA,OAAO,+BAA+B,MAAM,CAAA;AAAA,EAC9C,CAAA;AAAA,EACA,SAAS,CAAA,MAAA,KAAU;AAAA,IACjB,gBAAA,CAAiB;AAAA,MACf,GAAA,EAAK,OAAO,SAAA,CAAU,GAAA;AAAA,MACtB,QAAQ,MAAA,CAAO;AAAA,KAChB;AAAA;AAEL,CAAC;;;;"}

package/dist/blueprints/ThemeBlueprint.esm.js

@@ -0,0 +1,17 @@
+import { createExtensionDataRef, createExtensionBlueprint } from '@backstage/frontend-plugin-api';
+
+const themeDataRef = createExtensionDataRef().with({
+  id: "core.theme.theme"
+});
+const ThemeBlueprint = createExtensionBlueprint({
+  kind: "theme",
+  attachTo: { id: "api:app/app-theme", input: "themes" },
+  output: [themeDataRef],
+  dataRefs: {
+    theme: themeDataRef
+  },
+  factory: ({ theme }) => [themeDataRef(theme)]
+});
+
+export { ThemeBlueprint };
+//# sourceMappingURL=ThemeBlueprint.esm.js.map

package/dist/blueprints/ThemeBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeBlueprint.esm.js","sources":["../../src/blueprints/ThemeBlueprint.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 { AppTheme } from '@backstage/frontend-plugin-api';\nimport {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\n\nconst themeDataRef = createExtensionDataRef<AppTheme>().with({\n  id: 'core.theme.theme',\n});\n\n/**\n * Creates an extension that adds/replaces an app theme. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const ThemeBlueprint = createExtensionBlueprint({\n  kind: 'theme',\n  attachTo: { id: 'api:app/app-theme', input: 'themes' },\n  output: [themeDataRef],\n  dataRefs: {\n    theme: themeDataRef,\n  },\n  factory: ({ theme }: { theme: AppTheme }) => [themeDataRef(theme)],\n});\n"],"names":[],"mappings":";;AAsBA,MAAM,YAAA,GAAe,sBAAA,EAAiC,CAAE,IAAA,CAAK;AAAA,EAC3D,EAAA,EAAI;AACN,CAAC,CAAA;AAOM,MAAM,iBAAiB,wBAAA,CAAyB;AAAA,EACrD,IAAA,EAAM,OAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,mBAAA,EAAqB,OAAO,QAAA,EAAS;AAAA,EACrD,MAAA,EAAQ,CAAC,YAAY,CAAA;AAAA,EACrB,QAAA,EAAU;AAAA,IACR,KAAA,EAAO;AAAA,GACT;AAAA,EACA,OAAA,EAAS,CAAC,EAAE,KAAA,OAAiC,CAAC,YAAA,CAAa,KAAK,CAAC;AACnE,CAAC;;;;"}

package/dist/blueprints/TranslationBlueprint.esm.js

@@ -0,0 +1,17 @@
+import { createExtensionDataRef, createExtensionBlueprint } from '@backstage/frontend-plugin-api';
+
+const translationDataRef = createExtensionDataRef().with({ id: "core.translation.translation" });
+const TranslationBlueprint = createExtensionBlueprint({
+  kind: "translation",
+  attachTo: { id: "api:app/translations", input: "translations" },
+  output: [translationDataRef],
+  dataRefs: {
+    translation: translationDataRef
+  },
+  factory: ({
+    resource
+  }) => [translationDataRef(resource)]
+});
+
+export { TranslationBlueprint };
+//# sourceMappingURL=TranslationBlueprint.esm.js.map

package/dist/blueprints/TranslationBlueprint.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationBlueprint.esm.js","sources":["../../src/blueprints/TranslationBlueprint.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 {\n  createExtensionBlueprint,\n  createExtensionDataRef,\n  TranslationMessages,\n  TranslationResource,\n} from '@backstage/frontend-plugin-api';\n\nconst translationDataRef = createExtensionDataRef<\n  TranslationResource | TranslationMessages\n>().with({ id: 'core.translation.translation' });\n\n/**\n * Creates an extension that adds translations to your app. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const TranslationBlueprint = createExtensionBlueprint({\n  kind: 'translation',\n  attachTo: { id: 'api:app/translations', input: 'translations' },\n  output: [translationDataRef],\n  dataRefs: {\n    translation: translationDataRef,\n  },\n  factory: ({\n    resource,\n  }: {\n    resource: TranslationResource | TranslationMessages;\n  }) => [translationDataRef(resource)],\n});\n"],"names":[],"mappings":";;AAuBA,MAAM,qBAAqB,sBAAA,EAEzB,CAAE,KAAK,EAAE,EAAA,EAAI,gCAAgC,CAAA;AAOxC,MAAM,uBAAuB,wBAAA,CAAyB;AAAA,EAC3D,IAAA,EAAM,aAAA;AAAA,EACN,QAAA,EAAU,EAAE,EAAA,EAAI,sBAAA,EAAwB,OAAO,cAAA,EAAe;AAAA,EAC9D,MAAA,EAAQ,CAAC,kBAAkB,CAAA;AAAA,EAC3B,QAAA,EAAU;AAAA,IACR,WAAA,EAAa;AAAA,GACf;AAAA,EACA,SAAS,CAAC;AAAA,IACR;AAAA,GACF,KAEM,CAAC,kBAAA,CAAmB,QAAQ,CAAC;AACrC,CAAC;;;;"}

package/dist/index.d.ts

@@ -1,110 +1,156 @@
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
-import { SignInPageProps, NavContentComponent } from '@backstage/frontend-plugin-api';
-export { NavContentComponent, NavContentComponentProps, SignInPageProps } from '@backstage/frontend-plugin-api';
-import * as react from 'react';
+import { IconComponent, IconElement, AppNode, RouteRef, IdentityApi, SwappableComponentRef, AppTheme, TranslationResource, TranslationMessages } from '@backstage/frontend-plugin-api';
+import { ReactNode, ComponentType } from 'react';
 
 /**
- * Creates an extension that renders a React wrapper at the app root, enclosing
- * the app layout. This blueprint is limited to use by the app plugin.
+ * Creates a extensions that render a React wrapper at the app root, enclosing
+ * the app layout. This is useful for example for adding global React contexts
+ * and similar. This blueprint is limited to use by the app plugin.
  *
  * @public
  */
 declare const AppRootWrapperBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
     kind: "app-root-wrapper";
     params: {
+        /** @deprecated use the `component` parameter instead */
         Component?: [error: "Use the `component` parameter instead"];
         component: (props: {
-            children: react.ReactNode;
+            children: ReactNode;
         }) => JSX.Element | null;
     };
     output: _backstage_frontend_plugin_api.ExtensionDataRef<(props: {
-        children: react.ReactNode;
+        children: ReactNode;
     }) => JSX.Element | null, "app.root.wrapper", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
         component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<(props: {
-            children: react.ReactNode;
+            children: ReactNode;
         }) => JSX.Element | null, "app.root.wrapper", {}>;
     };
 }>;
+
 /**
- * Creates an extension that adds/replaces an app theme. This blueprint is limited to use by the app plugin.
+ * Creates an extension that adds icon bundles to your app. This blueprint is limited to use by the app plugin.
  *
  * @public
  */
-declare const ThemeBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
-    kind: "theme";
+declare const IconBundleBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
+    kind: "icon-bundle";
     params: {
-        theme: _backstage_frontend_plugin_api.AppTheme;
+        icons: { [key in string]: IconComponent | IconElement; };
     };
-    output: _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.AppTheme, "core.theme.theme", {}>;
+    output: _backstage_frontend_plugin_api.ExtensionDataRef<{
+        [x: string]: IconComponent | IconElement;
+    }, "core.icons", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
-        theme: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<_backstage_frontend_plugin_api.AppTheme, "core.theme.theme", {}>;
+        icons: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<{
+            [x: string]: IconComponent | IconElement;
+        }, "core.icons", {}>;
     };
 }>;
+
 /**
- * Blueprint for creating swappable components from a SwappableComponentRef and a loader. This blueprint is limited to use by the app plugin.
+ * A navigation item auto-discovered from a page extension in the app.
  *
  * @public
  */
-declare const SwappableComponentBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
-    kind: "component";
-    params: <Ref extends _backstage_frontend_plugin_api.SwappableComponentRef<any>>(params: {
-        component: Ref extends _backstage_frontend_plugin_api.SwappableComponentRef<any, infer IExternalComponentProps> ? {
-            ref: Ref;
-        } & ((props: IExternalComponentProps) => JSX.Element | null) : never;
-        loader: Ref extends _backstage_frontend_plugin_api.SwappableComponentRef<infer IInnerComponentProps, any> ? (() => (props: IInnerComponentProps) => JSX.Element | null) | (() => Promise<(props: IInnerComponentProps) => JSX.Element /**
-         * Creates an extension that replaces the router component. This blueprint is limited to use by the app plugin.
-         *
-         * @public
-         */ | null>) : never;
-    }) => _backstage_frontend_plugin_api.ExtensionBlueprintParams<{
-        component: Ref extends _backstage_frontend_plugin_api.SwappableComponentRef<any, infer IExternalComponentProps> ? {
-            ref: Ref;
-        } & ((props: IExternalComponentProps) => JSX.Element | null) : never;
-        loader: Ref extends _backstage_frontend_plugin_api.SwappableComponentRef<infer IInnerComponentProps, any> ? (() => (props: IInnerComponentProps) => JSX.Element | null) | (() => Promise<(props: IInnerComponentProps) => JSX.Element /**
-         * Creates an extension that replaces the router component. This blueprint is limited to use by the app plugin.
-         *
-         * @public
-         */ | null>) : never;
+interface NavContentNavItem {
+    /** The app node of the page extension that this nav item points to */
+    node: AppNode;
+    /** The resolved route path */
+    href: string;
+    /** The display title */
+    title: string;
+    /** The display icon */
+    icon: IconElement;
+    /** The route ref of the source page */
+    routeRef: RouteRef;
+}
+/**
+ * A pre-bound renderer that wraps {@link NavContentNavItems} with a component,
+ * so that `take` and `rest` return rendered elements directly.
+ *
+ * @public
+ */
+interface NavContentNavItemsWithComponent {
+    /** Render and take a specific item by extension ID. Returns null if not found. */
+    take(id: string): JSX.Element | null;
+    /** Render all remaining items not yet taken, optionally sorted. */
+    rest(options?: {
+        sortBy?: 'title';
+    }): JSX.Element[];
+}
+/**
+ * A collection of nav items that supports picking specific items by ID
+ * and retrieving whatever remains. Created fresh for each render.
+ *
+ * @public
+ */
+interface NavContentNavItems {
+    /** Take an item by extension ID, removing it from the collection. */
+    take(id: string): NavContentNavItem | undefined;
+    /** All items not yet taken. */
+    rest(): NavContentNavItem[];
+    /** Create a copy of the collection preserving the current taken state. */
+    clone(): NavContentNavItems;
+    /** Create a renderer that wraps take/rest to return pre-rendered elements. */
+    withComponent(Component: ComponentType<NavContentNavItem>): NavContentNavItemsWithComponent;
+}
+/**
+ * The props for the {@link NavContentComponent}.
+ *
+ * @public
+ */
+interface NavContentComponentProps {
+    /**
+     * Nav items auto-discovered from page extensions, with take/rest semantics
+     * for placing specific items in specific positions.
+     */
+    navItems: NavContentNavItems;
+    /**
+     * Flat list of nav items for simple rendering. Use `navItems` for more
+     * control over item placement.
+     *
+     * @deprecated Use `navItems` instead.
+     */
+    items: Array<{
+        icon: IconComponent;
+        title: string;
+        routeRef: RouteRef<undefined>;
+        to: string;
+        text: string;
     }>;
-    output: _backstage_frontend_plugin_api.ExtensionDataRef<{
-        ref: _backstage_frontend_plugin_api.SwappableComponentRef;
-        loader: (() => (props: {}) => JSX.Element | null) | (() => Promise<(props: {}) => JSX.Element | null>);
-    }, "core.swappableComponent", {}>;
-    inputs: {};
-    config: {};
-    configInput: {};
-    dataRefs: {
-        component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<{
-            ref: _backstage_frontend_plugin_api.SwappableComponentRef;
-            loader: (() => (props: {}) => JSX.Element | null) | (() => Promise<(props: {}) => JSX.Element | null>);
-        }, "core.swappableComponent", {}>;
-    };
-}>;
+}
 /**
- * Creates an extension that replaces the sign in page. This blueprint is limited to use by the app plugin.
+ * A component that renders the nav bar content, to be passed to the {@link NavContentBlueprint}.
  *
  * @public
  */
-declare const SignInPageBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
-    kind: "sign-in-page";
+type NavContentComponent = (props: NavContentComponentProps) => JSX.Element | null;
+/**
+ * Creates an extension that replaces the entire nav bar with your own component. This blueprint is limited to use by the app plugin.
+ *
+ * @public
+ */
+declare const NavContentBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
+    kind: "nav-content";
     params: {
-        loader: () => Promise<react.ComponentType<SignInPageProps>>;
+        component: NavContentComponent;
     };
-    output: _backstage_frontend_plugin_api.ExtensionDataRef<react.ComponentType<SignInPageProps>, "core.sign-in-page.component", {}>;
+    output: _backstage_frontend_plugin_api.ExtensionDataRef<NavContentComponent, "core.nav-content.component", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
-        component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<react.ComponentType<SignInPageProps>, "core.sign-in-page.component", {}>;
+        component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<NavContentComponent, "core.nav-content.component", {}>;
     };
 }>;
+
 /**
  * Creates an extension that replaces the router component. This blueprint is limited to use by the app plugin.
  *
@@ -113,61 +159,108 @@ declare const SignInPageBlueprint: _backstage_frontend_plugin_api.ExtensionBluep
 declare const RouterBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
     kind: "app-router-component";
     params: {
+        /** @deprecated use the `component` parameter instead */
         Component?: [error: "Use the `component` parameter instead"];
         component: (props: {
-            children: react.ReactNode;
+            children: ReactNode;
         }) => JSX.Element | null;
     };
     output: _backstage_frontend_plugin_api.ExtensionDataRef<(props: {
-        children: react.ReactNode;
+        children: ReactNode;
     }) => JSX.Element | null, "app.router.wrapper", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
         component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<(props: {
-            children: react.ReactNode;
+            children: ReactNode;
         }) => JSX.Element | null, "app.router.wrapper", {}>;
     };
 }>;
+
 /**
- * Creates an extension that replaces the entire nav bar with your own component. This blueprint is limited to use by the app plugin.
+ * Props for the `SignInPage` component.
  *
  * @public
  */
-declare const NavContentBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
-    kind: "nav-content";
+type SignInPageProps = {
+    /**
+     * Set the IdentityApi on successful sign-in. This should only be called once.
+     */
+    onSignInSuccess(identityApi: IdentityApi): void;
+    /**
+     * The children to render.
+     */
+    children?: ReactNode;
+};
+/**
+ * Creates an extension that replaces the sign in page. This blueprint is limited to use by the app plugin.
+ *
+ * @public
+ */
+declare const SignInPageBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
+    kind: "sign-in-page";
     params: {
-        component: NavContentComponent;
+        loader: () => Promise<ComponentType<SignInPageProps>>;
     };
-    output: _backstage_frontend_plugin_api.ExtensionDataRef<NavContentComponent, "core.nav-content.component", {}>;
+    output: _backstage_frontend_plugin_api.ExtensionDataRef<ComponentType<SignInPageProps>, "core.sign-in-page.component", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
-        component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<NavContentComponent, "core.nav-content.component", {}>;
+        component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<ComponentType<SignInPageProps>, "core.sign-in-page.component", {}>;
     };
 }>;
+
 /**
- * Creates an extension that adds icon bundles to your app. This blueprint is limited to use by the app plugin.
+ * Blueprint for creating swappable components from a SwappableComponentRef and a loader. This blueprint is limited to use by the app plugin.
  *
  * @public
  */
-declare const IconBundleBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
-    kind: "icon-bundle";
+declare const SwappableComponentBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
+    kind: "component";
+    params: <Ref extends SwappableComponentRef<any>>(params: {
+        component: Ref extends SwappableComponentRef<any, infer IExternalComponentProps> ? {
+            ref: Ref;
+        } & ((props: IExternalComponentProps) => JSX.Element | null) : never;
+        loader: Ref extends SwappableComponentRef<infer IInnerComponentProps, any> ? (() => (props: IInnerComponentProps) => JSX.Element | null) | (() => Promise<(props: IInnerComponentProps) => JSX.Element | null>) : never;
+    }) => _backstage_frontend_plugin_api.ExtensionBlueprintParams<{
+        component: Ref extends SwappableComponentRef<any, infer IExternalComponentProps> ? {
+            ref: Ref;
+        } & ((props: IExternalComponentProps) => JSX.Element | null) : never;
+        loader: Ref extends SwappableComponentRef<infer IInnerComponentProps, any> ? (() => (props: IInnerComponentProps) => JSX.Element | null) | (() => Promise<(props: IInnerComponentProps) => JSX.Element | null>) : never;
+    }>;
+    output: _backstage_frontend_plugin_api.ExtensionDataRef<{
+        ref: SwappableComponentRef;
+        loader: (() => (props: {}) => JSX.Element | null) | (() => Promise<(props: {}) => JSX.Element | null>);
+    }, "core.swappableComponent", {}>;
+    inputs: {};
+    config: {};
+    configInput: {};
+    dataRefs: {
+        component: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<{
+            ref: SwappableComponentRef;
+            loader: (() => (props: {}) => JSX.Element | null) | (() => Promise<(props: {}) => JSX.Element | null>);
+        }, "core.swappableComponent", {}>;
+    };
+}>;
+
+/**
+ * Creates an extension that adds/replaces an app theme. This blueprint is limited to use by the app plugin.
+ *
+ * @public
+ */
+declare const ThemeBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
+    kind: "theme";
     params: {
-        icons: { [key in string]: _backstage_frontend_plugin_api.IconComponent; };
+        theme: AppTheme;
     };
-    output: _backstage_frontend_plugin_api.ExtensionDataRef<{
-        [x: string]: _backstage_frontend_plugin_api.IconComponent;
-    }, "core.icons", {}>;
+    output: _backstage_frontend_plugin_api.ExtensionDataRef<AppTheme, "core.theme.theme", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
-        icons: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<{
-            [x: string]: _backstage_frontend_plugin_api.IconComponent;
-        }, "core.icons", {}>;
+        theme: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<AppTheme, "core.theme.theme", {}>;
     };
 }>;
 
@@ -179,19 +272,20 @@ declare const IconBundleBlueprint: _backstage_frontend_plugin_api.ExtensionBluep
 declare const TranslationBlueprint: _backstage_frontend_plugin_api.ExtensionBlueprint<{
     kind: "translation";
     params: {
-        resource: _backstage_frontend_plugin_api.TranslationResource | _backstage_frontend_plugin_api.TranslationMessages;
+        resource: TranslationResource | TranslationMessages;
     };
-    output: _backstage_frontend_plugin_api.ExtensionDataRef<_backstage_frontend_plugin_api.TranslationResource<string> | _backstage_frontend_plugin_api.TranslationMessages<string, {
+    output: _backstage_frontend_plugin_api.ExtensionDataRef<TranslationResource<string> | TranslationMessages<string, {
         [x: string]: string;
     }, boolean>, "core.translation.translation", {}>;
     inputs: {};
     config: {};
     configInput: {};
     dataRefs: {
-        translation: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<_backstage_frontend_plugin_api.TranslationResource<string> | _backstage_frontend_plugin_api.TranslationMessages<string, {
+        translation: _backstage_frontend_plugin_api.ConfigurableExtensionDataRef<TranslationResource<string> | TranslationMessages<string, {
             [x: string]: string;
         }, boolean>, "core.translation.translation", {}>;
     };
 }>;
 
 export { AppRootWrapperBlueprint, IconBundleBlueprint, NavContentBlueprint, RouterBlueprint, SignInPageBlueprint, SwappableComponentBlueprint, ThemeBlueprint, TranslationBlueprint };
+export type { NavContentComponent, NavContentComponentProps, NavContentNavItem, NavContentNavItems, NavContentNavItemsWithComponent, SignInPageProps };

package/dist/index.esm.js

@@ -1,2 +1,9 @@
-export { AppRootWrapperBlueprint, IconBundleBlueprint, NavContentBlueprint, RouterBlueprint, SignInPageBlueprint, SwappableComponentBlueprint, ThemeBlueprint, TranslationBlueprint } from './blueprints/index.esm.js';
+export { AppRootWrapperBlueprint } from './blueprints/AppRootWrapperBlueprint.esm.js';
+export { IconBundleBlueprint } from './blueprints/IconBundleBlueprint.esm.js';
+export { NavContentBlueprint } from './blueprints/NavContentBlueprint.esm.js';
+export { RouterBlueprint } from './blueprints/RouterBlueprint.esm.js';
+export { SignInPageBlueprint } from './blueprints/SignInPageBlueprint.esm.js';
+export { SwappableComponentBlueprint } from './blueprints/SwappableComponentBlueprint.esm.js';
+export { ThemeBlueprint } from './blueprints/ThemeBlueprint.esm.js';
+export { TranslationBlueprint } from './blueprints/TranslationBlueprint.esm.js';
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-app-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Web library for the app plugin",
   "backstage": {
     "role": "web-library",
@@ -39,26 +39,26 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/core-plugin-api": "^1.12.1",
-    "@backstage/frontend-plugin-api": "^0.13.3",
+    "@backstage/core-plugin-api": "^1.12.3",
+    "@backstage/frontend-plugin-api": "^0.14.0",
     "@material-ui/core": "^4.9.13"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.35.2",
-    "@backstage/frontend-test-utils": "^0.4.3",
-    "@backstage/test-utils": "^1.7.14",
+    "@backstage/cli": "^0.35.4",
+    "@backstage/frontend-test-utils": "^0.5.0",
+    "@backstage/test-utils": "^1.7.15",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",
     "@types/react": "^18.0.0",
     "react": "^18.0.2",
     "react-dom": "^18.0.2",
-    "react-router-dom": "^6.3.0"
+    "react-router-dom": "^6.30.2"
   },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0",
     "react": "^17.0.0 || ^18.0.0",
     "react-dom": "^17.0.0 || ^18.0.0",
-    "react-router-dom": "^6.3.0"
+    "react-router-dom": "^6.30.2"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/dist/blueprints/index.esm.js

@@ -1,13 +0,0 @@
-import { AppRootWrapperBlueprint as AppRootWrapperBlueprint$1, ThemeBlueprint as ThemeBlueprint$1, SwappableComponentBlueprint as SwappableComponentBlueprint$1, SignInPageBlueprint as SignInPageBlueprint$1, RouterBlueprint as RouterBlueprint$1, NavContentBlueprint as NavContentBlueprint$1, IconBundleBlueprint as IconBundleBlueprint$1, TranslationBlueprint as TranslationBlueprint$1 } from '@backstage/frontend-plugin-api';
-
-const AppRootWrapperBlueprint = AppRootWrapperBlueprint$1;
-const ThemeBlueprint = ThemeBlueprint$1;
-const SwappableComponentBlueprint = SwappableComponentBlueprint$1;
-const SignInPageBlueprint = SignInPageBlueprint$1;
-const RouterBlueprint = RouterBlueprint$1;
-const NavContentBlueprint = NavContentBlueprint$1;
-const IconBundleBlueprint = IconBundleBlueprint$1;
-const TranslationBlueprint = TranslationBlueprint$1;
-
-export { AppRootWrapperBlueprint, IconBundleBlueprint, NavContentBlueprint, RouterBlueprint, SignInPageBlueprint, SwappableComponentBlueprint, ThemeBlueprint, TranslationBlueprint };
-//# sourceMappingURL=index.esm.js.map

package/dist/blueprints/index.esm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.esm.js","sources":["../../src/blueprints/index.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 {\n  AppRootWrapperBlueprint as _AppRootWrapperBlueprint,\n  IconBundleBlueprint as _IconBundleBlueprint,\n  NavContentBlueprint as _NavContentBlueprint,\n  type NavContentComponent,\n  type NavContentComponentProps,\n  RouterBlueprint as _RouterBlueprint,\n  SignInPageBlueprint as _SignInPageBlueprint,\n  type SignInPageProps,\n  SwappableComponentBlueprint as _SwappableComponentBlueprint,\n  ThemeBlueprint as _ThemeBlueprint,\n  TranslationBlueprint as _TranslationBlueprint,\n} from '@backstage/frontend-plugin-api';\n\n/**\n * Creates an extension that renders a React wrapper at the app root, enclosing\n * the app layout. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const AppRootWrapperBlueprint = _AppRootWrapperBlueprint;\n\n/**\n * Creates an extension that adds/replaces an app theme. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const ThemeBlueprint = _ThemeBlueprint;\n\n/**\n * Blueprint for creating swappable components from a SwappableComponentRef and a loader. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const SwappableComponentBlueprint = _SwappableComponentBlueprint;\n\n/**\n * Creates an extension that replaces the sign in page. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const SignInPageBlueprint = _SignInPageBlueprint;\n\n/**\n * Creates an extension that replaces the router component. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const RouterBlueprint = _RouterBlueprint;\n\n/**\n * Creates an extension that replaces the entire nav bar with your own component. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const NavContentBlueprint = _NavContentBlueprint;\n\n/**\n * Creates an extension that adds icon bundles to your app. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const IconBundleBlueprint = _IconBundleBlueprint;\n\n/**\n * Props for the `SignInPage` component.\n *\n * @public\n */\nexport type { SignInPageProps };\n\n/**\n * The props for the {@link NavContentComponent}.\n *\n * @public\n */\nexport type { NavContentComponentProps };\n\n/**\n * A component that renders the nav bar content, to be passed to the {@link NavContentBlueprint}.\n *\n * @public\n */\nexport type { NavContentComponent };\n\n/**\n * Creates an extension that adds translations to your app. This blueprint is limited to use by the app plugin.\n *\n * @public\n */\nexport const TranslationBlueprint = _TranslationBlueprint;\n"],"names":["_AppRootWrapperBlueprint","_ThemeBlueprint","_SwappableComponentBlueprint","_SignInPageBlueprint","_RouterBlueprint","_NavContentBlueprint","_IconBundleBlueprint","_TranslationBlueprint"],"mappings":";;AAoCO,MAAM,uBAAA,GAA0BA;AAOhC,MAAM,cAAA,GAAiBC;AAOvB,MAAM,2BAAA,GAA8BC;AAOpC,MAAM,mBAAA,GAAsBC;AAO5B,MAAM,eAAA,GAAkBC;AAOxB,MAAM,mBAAA,GAAsBC;AAO5B,MAAM,mBAAA,GAAsBC;AA4B5B,MAAM,oBAAA,GAAuBC;;;;"}