@backstage/plugin-home 0.9.3-next.2 → 0.9.3

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @backstage/plugin-home
 
+## 0.9.3
+
+### Patch Changes
+
+- 538c985: Updated installation documentation to use feature discovery as the default.
+- 0be2541: Promoted the plugin's translation ref to the stable package entry point. It was previously only available through the alpha entry point.
+- a49a40d: Updated dependency `zod` to `^3.25.76 || ^4.0.0` & migrated to `/v3` or `/v4` imports.
+- Updated dependencies
+  - @backstage/plugin-catalog-react@2.1.0
+  - @backstage/core-compat-api@0.5.9
+  - @backstage/core-plugin-api@1.12.4
+  - @backstage/core-components@0.18.8
+  - @backstage/frontend-plugin-api@0.15.0
+  - @backstage/catalog-client@1.14.0
+  - @backstage/core-app-api@1.19.6
+  - @backstage/plugin-home-react@0.1.36
+  - @backstage/catalog-model@1.7.7
+
 ## 0.9.3-next.2
 
 ### Patch Changes

package/README.md

@@ -6,40 +6,19 @@ For App Integrators, the system is designed to be composable to give total freed
 
 ## Installation
 
-If you have a standalone app (you didn't clone this repo), then do
-
 ```bash
 # From your Backstage root directory
 yarn --cwd packages/app add @backstage/plugin-home
 ```
 
-## Getting started
-
-The home plugin supports both the new frontend system and the legacy system.
-
-### New Frontend System
-
-If you're using Backstage's new frontend system, add the plugin to your app:
-
-```ts
-// packages/app/src/App.tsx
-import homePlugin from '@backstage/plugin-home/alpha';
-
-const app = createApp({
-  features: [
-    // ... other plugins
-    homePlugin,
-    // ... other plugins
-  ],
-});
-```
+Once installed, the plugin is automatically available in your app through the default feature discovery. For more details and alternative installation methods, see [installing plugins](https://backstage.io/docs/frontend-system/building-apps/installing-plugins).
 
 The plugin will automatically provide:
 
 - A homepage at `/home` with customizable widget grid
 - A "Home" navigation item in the sidebar
 
-#### Creating Custom Homepage Layouts
+## Creating Custom Homepage Layouts
 
 Use the `HomePageLayoutBlueprint` from `@backstage/plugin-home-react/alpha` to
 create custom homepage layouts. A layout receives the installed widgets and is
@@ -86,7 +65,7 @@ const homeModule = createFrontendModule({
 });
 ```
 
-#### Visit Tracking (Optional)
+## Visit Tracking (Optional)
 
 Visit tracking is an **optional feature** that must be explicitly enabled. When enabled, it provides intelligent storage fallbacks:
 
@@ -112,12 +91,7 @@ app:
 
 ## Creating Homepage Widgets
 
-Homepage widgets are React components that can be added to customizable home pages. The **key difference** between the new frontend system and legacy system is how these widget components are **registered and exported**:
-
-- **New Frontend System**: Use `HomePageWidgetBlueprint` to register widgets as extensions
-- **Legacy System**: Use `createCardExtension` to export widgets as card components
-
-### New Frontend System
+Homepage widgets are React components that can be added to customizable home pages.
 
 Create widgets using the `HomePageWidgetBlueprint`:
 
@@ -156,26 +130,24 @@ const myWidget = HomePageWidgetBlueprint.make({
 });
 ```
 
-> **Example**: See [dev/index.tsx](dev/index.tsx) for a comprehensive example of creating multiple homepage widgets and layouts using the new frontend system.
+> **Example**: See [dev/index.tsx](dev/index.tsx) for a comprehensive example of creating multiple homepage widgets and layouts.
 
-### Legacy System - Widget Registration
+## Contributing
 
-In the legacy system, use the `createCardExtension` helper to create homepage widgets:
+### Homepage Components
 
-```tsx
-import { createCardExtension } from '@backstage/plugin-home-react';
+We believe that people have great ideas for what makes a useful Home Page, and we want to make it easy for everyone to benefit from the effort you put in to create something cool for the Home Page. Therefore, a great way of contributing is by simply creating more Home Page Components that can then be used by everyone when composing their own Home Page. If they are tightly coupled to an existing plugin, it is recommended to allow them to live within that plugin, for convenience and to limit complex dependencies. On the other hand, if there's no clear plugin that the component is based on, it's also fine to contribute them into the [home plugin](/plugins/home/src/homePageComponents)
 
-export const MyWidget = homePlugin.provide(
-  createCardExtension<{ defaultCategory?: 'programming' | 'any' }>({
-    title: 'My Custom Widget',
-    components: () => import('./homePageComponents/MyWidget'),
-  }),
-);
-```
+Additionally, the API is at a very early state, so contributing additional use cases may expose weaknesses in the current solution that we may iterate on to provide more flexibility and ease of use for those who wish to develop components for the Home Page.
 
-The `createCardExtension` provides error boundary and lazy loading, and accepts generics for custom props that App Integrators can configure.
+### Homepage Templates
+
+We are hoping that we together can build up a collection of Homepage templates. We therefore put together a place where we can collect all the templates for the Home Plugin in the [storybook](https://backstage.io/storybook/?path=/story/plugins-home-templates).
+If you would like to contribute with a template, start by taking a look at the [DefaultTemplate storybook example](/packages/app-legacy/src/components/home/templates/DefaultTemplate.stories.tsx) or [CustomizableTemplate storybook example](/packages/app-legacy/src/components/home/templates/CustomizableTemplate.stories.tsx) to create your own, and then open a PR with your suggestion.
+
+## Old Frontend System
 
-## Legacy System Setup
+This section covers the home plugin setup and usage for apps that still use the old frontend system.
 
 ### Setting up the Home Page
 
@@ -204,13 +176,26 @@ import { homePage } from './components/home/HomePage';
 // ...
 ```
 
-### Creating Components (Legacy)
+### Creating Widgets (Old Frontend System)
+
+In the old frontend system, use the `createCardExtension` helper to create homepage widgets:
+
+```tsx
+import { createCardExtension } from '@backstage/plugin-home-react';
+
+export const MyWidget = homePlugin.provide(
+  createCardExtension<{ defaultCategory?: 'programming' | 'any' }>({
+    title: 'My Custom Widget',
+    components: () => import('./homePageComponents/MyWidget'),
+  }),
+);
+```
 
-In the legacy system, homepage components can be regular React components or wrapped with `createCardExtension` for additional features like error boundaries and lazy loading. Components created with `createCardExtension` are exported as card components that can be composed into homepage layouts.
+The `createCardExtension` provides error boundary and lazy loading, and accepts generics for custom props that App Integrators can configure.
 
-### Composing a Home Page (Legacy)
+### Composing a Home Page (Old Frontend System)
 
-In the legacy system, composing a Home Page is done by creating regular React components. Components created with `createCardExtension` are rendered like so:
+Composing a Home Page is done by creating regular React components. Components created with `createCardExtension` are rendered like so:
 
 ```tsx
 import Grid from '@material-ui/core/Grid';
@@ -227,7 +212,7 @@ export const homePage = (
 
 Additionally, the App Integrator is provided an escape hatch in case the way the card is rendered does not fit their requirements. They may optionally pass the `Renderer`-prop, which will receive the `title`, `content` and optionally `actions`, `settings` and `contextProvider`, if they exist for the component. This allows the App Integrator to render the content in any way they want.
 
-## Customizable home page
+### Customizable Home Page (Old Frontend System)
 
 If you want to allow users to customize the components that are shown in the home page, you can use CustomHomePageGrid component.
 By adding the allowed components inside the grid, the user can add, configure, remove and move the components around in their
@@ -259,7 +244,7 @@ export const homePage = (
 > [!NOTE]
 > You can provide a title to the grid by passing it as a prop: `<CustomHomepageGrid title="Your Dashboard" />`. This will be displayed as a header above the grid layout.
 
-### Creating Customizable Components
+#### Creating Customizable Components (Old Frontend System)
 
 The custom home page can use the default components created by using the default `createCardExtension` method but if you
 want to add additional configuration like component size or settings, you can define those in the `layout`
@@ -317,7 +302,7 @@ Available home page properties that are used for homepage widgets are:
 | `layout.height.maxRows`       | integer | Maximum height of the widget (1-12)                          |
 | `settings.schema`             | object  | Customization settings of the widget, see below              |
 
-#### Widget Specific Settings
+#### Widget Specific Settings (Old Frontend System)
 
 To define settings that the users can change for your component, you should define the `layout` and `settings`
 properties. The `settings.schema` object should follow
@@ -369,7 +354,7 @@ Each widget has its own settings and the setting values are passed to the underl
 In case your `CardExtension` had `Settings` component defined, it will automatically disappear when you add the
 `settingsSchema` to the component data structure.
 
-### Adding Default Layout
+#### Adding Default Layout (Old Frontend System)
 
 You can set the default layout of the customizable home page by passing configuration to the `CustomHomepageGrid`
 component:
@@ -391,7 +376,7 @@ const defaultConfig = [
 <CustomHomepageGrid config={defaultConfig}>
 ```
 
-## Page visit homepage component (HomePageTopVisited / HomePageRecentlyVisited)
+### Page Visit Homepage Component (Old Frontend System)
 
 This component shows the homepage user a view for "Recently visited" or "Top visited".
 Being provided by the `<HomePageTopVisited/>` and `<HomePageRecentlyVisited/>` component, see it in use on a homepage example below:
@@ -505,11 +490,11 @@ home:
 
 In order to validate the config you can use `backstage/cli config:check`
 
-### Customizing the VisitList
+#### Customizing the VisitList (Old Frontend System)
 
 If you want more control over the recent and top visited lists, you can write your own functions to transform the path names and determine which visits to save. You can also enrich each visit with other fields and customize the chip colors/labels in the visit lists.
 
-#### Transform Pathname Function
+##### Transform Pathname Function
 
 Provide a `transformPathname` function to transform the pathname before it's processed for visit tracking. This can be used for transforming the pathname for the visit (before any other consideration). As an example, you can treat multiple sub-path visits to be counted as a singular path, e.g. `/entity-path/sub1` , `/entity-path/sub-2`, `/entity-path/sub-2/sub-sub-2` can all be mapped to `/entity-path` so visits to any of those routes are all counted as the same.
 
@@ -548,7 +533,7 @@ export const apis: AnyApiFactory[] = [
 ];
 ```
 
-#### Can Save Function
+##### Can Save Function
 
 Provide a `canSave` function to determine which visits should be tracked and saved. This allows you to conditionally save visits to the list:
 
@@ -586,7 +571,7 @@ export const apis: AnyApiFactory[] = [
 ];
 ```
 
-#### Enrich Visit Function
+##### Enrich Visit Function
 
 You can also add the `enrichVisit` function to put additional values on each `Visit`. The values could later be used to customize the chips in the `VisitList`. For example, you could add the entity `type` on the `Visit` so that `type` is used for labels instead of `kind`.
 
@@ -637,7 +622,7 @@ export const apis: AnyApiFactory[] = [
 ];
 ```
 
-#### Custom Chip Colors and Labels
+##### Custom Chip Colors and Labels
 
 To provide your own chip colors and/or labels for the recent and top visited lists, wrap the components in `VisitDisplayProvider` with `getChipColor` and `getChipLabel` functions. The colors provided will be used instead of the hard coded [`colorVariants`](https://github.com/backstage/backstage/blob/2da352043425bcab4c4422e4d2820c26c0a83382/packages/theme/src/base/pageTheme.ts#L46) provided via `@backstage/theme`.
 
@@ -680,16 +665,3 @@ export default function HomePage() {
   );
 }
 ```
-
-## Contributing
-
-### Homepage Components
-
-We believe that people have great ideas for what makes a useful Home Page, and we want to make it easy for everyone to benefit from the effort you put in to create something cool for the Home Page. Therefore, a great way of contributing is by simply creating more Home Page Components that can then be used by everyone when composing their own Home Page. If they are tightly coupled to an existing plugin, it is recommended to allow them to live within that plugin, for convenience and to limit complex dependencies. On the other hand, if there's no clear plugin that the component is based on, it's also fine to contribute them into the [home plugin](/plugins/home/src/homePageComponents)
-
-Additionally, the API is at a very early state, so contributing additional use cases may expose weaknesses in the current solution that we may iterate on to provide more flexibility and ease of use for those who wish to develop components for the Home Page.
-
-### Homepage Templates
-
-We are hoping that we together can build up a collection of Homepage templates. We therefore put together a place where we can collect all the templates for the Home Plugin in the [storybook](https://backstage.io/storybook/?path=/story/plugins-home-templates).
-If you would like to contribute with a template, start by taking a look at the [DefaultTemplate storybook example](/packages/app-legacy/src/components/home/templates/DefaultTemplate.stories.tsx) or [CustomizableTemplate storybook example](/packages/app-legacy/src/components/home/templates/CustomizableTemplate.stories.tsx) to create your own, and then open a PR with your suggestion.

package/dist/alpha.d.ts

@@ -3,41 +3,6 @@ import { HomePageLayoutProps } from '@backstage/plugin-home-react/alpha';
 import * as react from 'react';
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
 
-/**
- * Translation reference for the home plugin.
- * Contains localized text strings for home page components and widgets.
- *
- * @alpha
- */
-declare const homeTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"home", {
-    readonly "starredEntities.noStarredEntitiesMessage": "Click the star beside an entity name to add it to this list!";
-    readonly "addWidgetDialog.title": "Add new widget to dashboard";
-    readonly "customHomepageButtons.cancel": "Cancel";
-    readonly "customHomepageButtons.clearAll": "Clear all";
-    readonly "customHomepageButtons.edit": "Edit";
-    readonly "customHomepageButtons.restoreDefaults": "Restore defaults";
-    readonly "customHomepageButtons.addWidget": "Add widget";
-    readonly "customHomepageButtons.save": "Save";
-    readonly "customHomepage.noWidgets": "No widgets added. Start by clicking the 'Add widget' button.";
-    readonly "widgetSettingsOverlay.cancelButtonTitle": "Cancel";
-    readonly "widgetSettingsOverlay.editSettingsTooptip": "Edit settings";
-    readonly "widgetSettingsOverlay.deleteWidgetTooltip": "Delete widget";
-    readonly "widgetSettingsOverlay.submitButtonTitle": "Submit";
-    readonly "starredEntityListItem.removeFavoriteEntityTitle": "Remove entity from favorites";
-    readonly "visitList.empty.title": "There are no visits to show yet.";
-    readonly "visitList.empty.description": "Once you start using Backstage, your visits will appear here as a quick link to carry on where you left off.";
-    readonly "visitList.few.title": "The more pages you visit, the more pages will appear here.";
-    readonly "quickStart.title": "Onboarding";
-    readonly "quickStart.description": "Get started with Backstage";
-    readonly "quickStart.learnMoreLinkTitle": "Learn more";
-    readonly "visitedByType.action.viewMore": "View more";
-    readonly "visitedByType.action.viewLess": "View less";
-    readonly "featuredDocsCard.empty.title": "No documents to show";
-    readonly "featuredDocsCard.empty.description": "Create your own document. Check out our Getting Started Information";
-    readonly "featuredDocsCard.empty.learnMoreLinkTitle": "DOCS";
-    readonly "featuredDocsCard.learnMoreTitle": "LEARN MORE";
-}>;
-
 /**
  * Home plugin for the new frontend system.
  *
@@ -165,4 +130,37 @@ declare const _default: _backstage_frontend_plugin_api.OverridableFrontendPlugin
     }>;
 }>;
 
+/**
+ * @alpha
+ * @deprecated Import from `@backstage/plugin-home` instead.
+ */
+declare const homeTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"home", {
+    readonly "starredEntities.noStarredEntitiesMessage": "Click the star beside an entity name to add it to this list!";
+    readonly "addWidgetDialog.title": "Add new widget to dashboard";
+    readonly "customHomepageButtons.cancel": "Cancel";
+    readonly "customHomepageButtons.clearAll": "Clear all";
+    readonly "customHomepageButtons.edit": "Edit";
+    readonly "customHomepageButtons.restoreDefaults": "Restore defaults";
+    readonly "customHomepageButtons.addWidget": "Add widget";
+    readonly "customHomepageButtons.save": "Save";
+    readonly "customHomepage.noWidgets": "No widgets added. Start by clicking the 'Add widget' button.";
+    readonly "widgetSettingsOverlay.cancelButtonTitle": "Cancel";
+    readonly "widgetSettingsOverlay.editSettingsTooptip": "Edit settings";
+    readonly "widgetSettingsOverlay.deleteWidgetTooltip": "Delete widget";
+    readonly "widgetSettingsOverlay.submitButtonTitle": "Submit";
+    readonly "starredEntityListItem.removeFavoriteEntityTitle": "Remove entity from favorites";
+    readonly "visitList.empty.title": "There are no visits to show yet.";
+    readonly "visitList.empty.description": "Once you start using Backstage, your visits will appear here as a quick link to carry on where you left off.";
+    readonly "visitList.few.title": "The more pages you visit, the more pages will appear here.";
+    readonly "quickStart.title": "Onboarding";
+    readonly "quickStart.description": "Get started with Backstage";
+    readonly "quickStart.learnMoreLinkTitle": "Learn more";
+    readonly "visitedByType.action.viewMore": "View more";
+    readonly "visitedByType.action.viewLess": "View less";
+    readonly "featuredDocsCard.empty.title": "No documents to show";
+    readonly "featuredDocsCard.empty.description": "Create your own document. Check out our Getting Started Information";
+    readonly "featuredDocsCard.empty.learnMoreLinkTitle": "DOCS";
+    readonly "featuredDocsCard.learnMoreTitle": "LEARN MORE";
+}>;
+
 export { _default as default, homeTranslationRef };

package/dist/alpha.esm.js

@@ -10,7 +10,7 @@ import { VisitsWebStorageApi } from './api/VisitsWebStorageApi.esm.js';
 import { visitsApiRef } from './api/VisitsApi.esm.js';
 import HomeIcon from '@material-ui/icons/Home';
 import { homePageLayoutComponentDataRef, homePageWidgetDataRef, HomePageLayoutBlueprint, HomePageWidgetBlueprint } from '@backstage/plugin-home-react/alpha';
-export { homeTranslationRef } from './translation.esm.js';
+import { homeTranslationRef as homeTranslationRef$1 } from './translation.esm.js';
 
 const rootRouteRef = createRouteRef();
 const homePage = PageBlueprint.makeWithOverrides({
@@ -156,6 +156,7 @@ var alpha = createFrontendPlugin({
     root: rootRouteRef
   }
 });
+const homeTranslationRef = homeTranslationRef$1;
 
-export { alpha as default };
+export { alpha as default, homeTranslationRef };
 //# sourceMappingURL=alpha.esm.js.map

package/dist/alpha.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"alpha.esm.js","sources":["../src/alpha.tsx"],"sourcesContent":["/*\n * Copyright 2023 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 * The home plugin for Backstage's new frontend system.\n *\n * @remarks\n * This package provides the new frontend system implementation of the home plugin,\n * which offers customizable home pages with widget support and optional visit tracking.\n *\n * @packageDocumentation\n */\n\nimport { lazy as reactLazy } from 'react';\nimport {\n  createExtensionInput,\n  PageBlueprint,\n  NavItemBlueprint,\n  createFrontendPlugin,\n  createRouteRef,\n  AppRootElementBlueprint,\n  identityApiRef,\n  storageApiRef,\n  errorApiRef,\n  ApiBlueprint,\n  ExtensionBoundary,\n} from '@backstage/frontend-plugin-api';\nimport { VisitListener } from './components/';\nimport { visitsApiRef, VisitsStorageApi, VisitsWebStorageApi } from './api';\nimport HomeIcon from '@material-ui/icons/Home';\nimport {\n  homePageWidgetDataRef,\n  homePageLayoutComponentDataRef,\n  HomePageLayoutBlueprint,\n  HomePageWidgetBlueprint,\n  type HomePageLayoutProps,\n} from '@backstage/plugin-home-react/alpha';\n\nconst rootRouteRef = createRouteRef();\n\nconst homePage = PageBlueprint.makeWithOverrides({\n  inputs: {\n    widgets: createExtensionInput([homePageWidgetDataRef]),\n    layout: createExtensionInput([HomePageLayoutBlueprint.dataRefs.component], {\n      singleton: true,\n      optional: true,\n      internal: true,\n    }),\n  },\n  factory(originalFactory, { node, inputs }) {\n    return originalFactory({\n      path: '/home',\n      noHeader: true,\n      routeRef: rootRouteRef,\n      loader: async () => {\n        const LazyDefaultLayout = reactLazy(() =>\n          import('./alpha/DefaultHomePageLayout').then(m => ({\n            default: m.DefaultHomePageLayout,\n          })),\n        );\n\n        const DefaultLayoutComponent = (props: HomePageLayoutProps) => (\n          <ExtensionBoundary node={node}>\n            <LazyDefaultLayout {...props} />\n          </ExtensionBoundary>\n        );\n\n        const Layout =\n          inputs.layout?.get(homePageLayoutComponentDataRef) ??\n          DefaultLayoutComponent;\n\n        const widgets = inputs.widgets.map(widget => ({\n          ...widget.get(homePageWidgetDataRef),\n          node: widget.node,\n        }));\n\n        return <Layout widgets={widgets} />;\n      },\n    });\n  },\n});\n\nconst visitListenerAppRootElement = AppRootElementBlueprint.make({\n  name: 'visit-listener',\n  disabled: true,\n  params: {\n    element: <VisitListener />,\n  },\n});\n\nconst visitsApi = ApiBlueprint.make({\n  name: 'visits',\n  disabled: true,\n  params: defineParams =>\n    defineParams({\n      api: visitsApiRef,\n      deps: {\n        storageApi: storageApiRef,\n        identityApi: identityApiRef,\n        errorApi: errorApiRef,\n      },\n      factory: ({ storageApi, identityApi, errorApi }) => {\n        // Smart fallback: use custom storage API if available, otherwise localStorage\n        if (storageApi) {\n          return VisitsStorageApi.create({ storageApi, identityApi });\n        }\n        return VisitsWebStorageApi.create({ identityApi, errorApi });\n      },\n    }),\n});\n\nconst homeNavItem = NavItemBlueprint.make({\n  params: {\n    title: 'Home',\n    routeRef: rootRouteRef,\n    icon: HomeIcon,\n  },\n});\n\nconst homePageToolkitWidget = HomePageWidgetBlueprint.make({\n  name: 'toolkit',\n  params: {\n    name: 'HomePageToolkit',\n    title: 'Toolkit',\n    components: () =>\n      import('./homePageComponents/Toolkit').then(m => ({\n        Content: m.Content,\n        ContextProvider: m.ContextProvider,\n      })),\n    componentProps: {\n      tools: [\n        {\n          url: 'https://backstage.io',\n          label: 'Backstage Docs',\n          icon: <HomeIcon />,\n        },\n      ],\n    },\n  },\n});\n\nconst homePageStarredEntitiesWidget = HomePageWidgetBlueprint.make({\n  name: 'starred-entities',\n  params: {\n    name: 'HomePageStarredEntities',\n    title: 'Your Starred Entities',\n    components: () =>\n      import('./homePageComponents/StarredEntities').then(m => ({\n        Content: m.Content,\n      })),\n  },\n});\n\nconst homePageRandomJokeWidget = HomePageWidgetBlueprint.make({\n  name: 'random-joke',\n  params: {\n    name: 'HomePageRandomJoke',\n    title: 'Random Joke',\n    description: 'Shows a random programming joke',\n    components: () =>\n      import('./homePageComponents/RandomJoke').then(m => ({\n        Content: m.Content,\n        Settings: m.Settings,\n        Actions: m.Actions,\n        ContextProvider: m.ContextProvider,\n      })),\n    layout: {\n      height: { minRows: 4 },\n      width: { minColumns: 3 },\n    },\n    settings: {\n      schema: {\n        title: 'Random Joke settings',\n        type: 'object',\n        properties: {\n          defaultCategory: {\n            title: 'Category',\n            type: 'string',\n            enum: ['any', 'programming', 'dad'],\n            default: 'any',\n          },\n        },\n      },\n    },\n  },\n});\n\n/**\n * Home plugin for the new frontend system.\n *\n * Provides core homepage functionality with optional visit tracking extensions.\n * Visit tracking extensions are disabled by default and can be enabled via app-config.yaml.\n *\n * @alpha\n */\nexport default createFrontendPlugin({\n  pluginId: 'home',\n  title: 'Home',\n  icon: <HomeIcon />,\n  info: { packageJson: () => import('../package.json') },\n  extensions: [\n    homePage,\n    homeNavItem,\n    visitsApi,\n    visitListenerAppRootElement,\n    homePageToolkitWidget,\n    homePageStarredEntitiesWidget,\n    homePageRandomJokeWidget,\n  ],\n  routes: {\n    root: rootRouteRef,\n  },\n});\n\nexport { homeTranslationRef } from './translation';\n"],"names":["reactLazy"],"mappings":"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"}
+{"version":3,"file":"alpha.esm.js","sources":["../src/alpha.tsx"],"sourcesContent":["/*\n * Copyright 2023 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 * The home plugin for Backstage's new frontend system.\n *\n * @remarks\n * This package provides the new frontend system implementation of the home plugin,\n * which offers customizable home pages with widget support and optional visit tracking.\n *\n * @packageDocumentation\n */\n\nimport { lazy as reactLazy } from 'react';\nimport {\n  createExtensionInput,\n  PageBlueprint,\n  NavItemBlueprint,\n  createFrontendPlugin,\n  createRouteRef,\n  AppRootElementBlueprint,\n  identityApiRef,\n  storageApiRef,\n  errorApiRef,\n  ApiBlueprint,\n  ExtensionBoundary,\n} from '@backstage/frontend-plugin-api';\nimport { VisitListener } from './components/';\nimport { visitsApiRef, VisitsStorageApi, VisitsWebStorageApi } from './api';\nimport HomeIcon from '@material-ui/icons/Home';\nimport {\n  homePageWidgetDataRef,\n  homePageLayoutComponentDataRef,\n  HomePageLayoutBlueprint,\n  HomePageWidgetBlueprint,\n  type HomePageLayoutProps,\n} from '@backstage/plugin-home-react/alpha';\n\nconst rootRouteRef = createRouteRef();\n\nconst homePage = PageBlueprint.makeWithOverrides({\n  inputs: {\n    widgets: createExtensionInput([homePageWidgetDataRef]),\n    layout: createExtensionInput([HomePageLayoutBlueprint.dataRefs.component], {\n      singleton: true,\n      optional: true,\n      internal: true,\n    }),\n  },\n  factory(originalFactory, { node, inputs }) {\n    return originalFactory({\n      path: '/home',\n      noHeader: true,\n      routeRef: rootRouteRef,\n      loader: async () => {\n        const LazyDefaultLayout = reactLazy(() =>\n          import('./alpha/DefaultHomePageLayout').then(m => ({\n            default: m.DefaultHomePageLayout,\n          })),\n        );\n\n        const DefaultLayoutComponent = (props: HomePageLayoutProps) => (\n          <ExtensionBoundary node={node}>\n            <LazyDefaultLayout {...props} />\n          </ExtensionBoundary>\n        );\n\n        const Layout =\n          inputs.layout?.get(homePageLayoutComponentDataRef) ??\n          DefaultLayoutComponent;\n\n        const widgets = inputs.widgets.map(widget => ({\n          ...widget.get(homePageWidgetDataRef),\n          node: widget.node,\n        }));\n\n        return <Layout widgets={widgets} />;\n      },\n    });\n  },\n});\n\nconst visitListenerAppRootElement = AppRootElementBlueprint.make({\n  name: 'visit-listener',\n  disabled: true,\n  params: {\n    element: <VisitListener />,\n  },\n});\n\nconst visitsApi = ApiBlueprint.make({\n  name: 'visits',\n  disabled: true,\n  params: defineParams =>\n    defineParams({\n      api: visitsApiRef,\n      deps: {\n        storageApi: storageApiRef,\n        identityApi: identityApiRef,\n        errorApi: errorApiRef,\n      },\n      factory: ({ storageApi, identityApi, errorApi }) => {\n        // Smart fallback: use custom storage API if available, otherwise localStorage\n        if (storageApi) {\n          return VisitsStorageApi.create({ storageApi, identityApi });\n        }\n        return VisitsWebStorageApi.create({ identityApi, errorApi });\n      },\n    }),\n});\n\nconst homeNavItem = NavItemBlueprint.make({\n  params: {\n    title: 'Home',\n    routeRef: rootRouteRef,\n    icon: HomeIcon,\n  },\n});\n\nconst homePageToolkitWidget = HomePageWidgetBlueprint.make({\n  name: 'toolkit',\n  params: {\n    name: 'HomePageToolkit',\n    title: 'Toolkit',\n    components: () =>\n      import('./homePageComponents/Toolkit').then(m => ({\n        Content: m.Content,\n        ContextProvider: m.ContextProvider,\n      })),\n    componentProps: {\n      tools: [\n        {\n          url: 'https://backstage.io',\n          label: 'Backstage Docs',\n          icon: <HomeIcon />,\n        },\n      ],\n    },\n  },\n});\n\nconst homePageStarredEntitiesWidget = HomePageWidgetBlueprint.make({\n  name: 'starred-entities',\n  params: {\n    name: 'HomePageStarredEntities',\n    title: 'Your Starred Entities',\n    components: () =>\n      import('./homePageComponents/StarredEntities').then(m => ({\n        Content: m.Content,\n      })),\n  },\n});\n\nconst homePageRandomJokeWidget = HomePageWidgetBlueprint.make({\n  name: 'random-joke',\n  params: {\n    name: 'HomePageRandomJoke',\n    title: 'Random Joke',\n    description: 'Shows a random programming joke',\n    components: () =>\n      import('./homePageComponents/RandomJoke').then(m => ({\n        Content: m.Content,\n        Settings: m.Settings,\n        Actions: m.Actions,\n        ContextProvider: m.ContextProvider,\n      })),\n    layout: {\n      height: { minRows: 4 },\n      width: { minColumns: 3 },\n    },\n    settings: {\n      schema: {\n        title: 'Random Joke settings',\n        type: 'object',\n        properties: {\n          defaultCategory: {\n            title: 'Category',\n            type: 'string',\n            enum: ['any', 'programming', 'dad'],\n            default: 'any',\n          },\n        },\n      },\n    },\n  },\n});\n\n/**\n * Home plugin for the new frontend system.\n *\n * Provides core homepage functionality with optional visit tracking extensions.\n * Visit tracking extensions are disabled by default and can be enabled via app-config.yaml.\n *\n * @alpha\n */\nexport default createFrontendPlugin({\n  pluginId: 'home',\n  title: 'Home',\n  icon: <HomeIcon />,\n  info: { packageJson: () => import('../package.json') },\n  extensions: [\n    homePage,\n    homeNavItem,\n    visitsApi,\n    visitListenerAppRootElement,\n    homePageToolkitWidget,\n    homePageStarredEntitiesWidget,\n    homePageRandomJokeWidget,\n  ],\n  routes: {\n    root: rootRouteRef,\n  },\n});\n\nimport { homeTranslationRef as _homeTranslationRef } from './translation';\n\n/**\n * @alpha\n * @deprecated Import from `@backstage/plugin-home` instead.\n */\nexport const homeTranslationRef = _homeTranslationRef;\n"],"names":["reactLazy","_homeTranslationRef"],"mappings":"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"}

package/dist/components/CustomHomepage/types.esm.js

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 const RSJFTypeSchema = z.any();
 const RSJFTypeUiSchema = z.any();

package/dist/components/CustomHomepage/types.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.esm.js","sources":["../../../src/components/CustomHomepage/types.ts"],"sourcesContent":["/*\n * Copyright 2023 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 { CSSProperties, ReactElement, ReactNode } from 'react';\nimport { Layout } from 'react-grid-layout';\nimport { z } from 'zod';\nimport { RJSFSchema, UiSchema } from '@rjsf/utils';\n\nconst RSJFTypeSchema: z.ZodType<RJSFSchema> = z.any();\nconst RSJFTypeUiSchema: z.ZodType<UiSchema> = z.any();\nconst ReactElementSchema: z.ZodType<ReactElement> = z.any();\nconst LayoutSchema: z.ZodType<Layout> = z.any();\n\n/**\n * Breakpoint options for <CustomHomepageGridProps/>\n *\n * @public\n */\nexport type Breakpoint = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n\n/**\n * Props customizing the <CustomHomepageGrid/> component.\n *\n * @public\n */\nexport type CustomHomepageGridProps = {\n  /**\n   * Children contain all widgets user can configure on their own homepage.\n   */\n  children?: ReactNode;\n  /**\n   * Default layout for the homepage before users have modified it.\n   */\n  config?: LayoutConfiguration[];\n  /**\n   * Title displayed in the header of the grid. If not provided, no title will be shown.\n   */\n  title?: string;\n  /**\n   * Height of grid row in pixels.\n   * @defaultValue 60\n   */\n  rowHeight?: number;\n  /**\n   * Screen width in pixels for different breakpoints.\n   * @defaultValue theme breakpoints\n   */\n  breakpoints?: Record<Breakpoint, number>;\n  /**\n   * Number of grid columns for different breakpoints.\n   * @defaultValue \\{ lg: 12, md: 10, sm: 6, xs: 4, xxs: 2 \\}\n   */\n  cols?: Record<Breakpoint, number>;\n  /**\n   * Grid container padding (x, y) in pixels for all or specific breakpoints.\n   * @defaultValue [0, 0]\n   * @example [10, 10]\n   * @example \\{ lg: [10, 10] \\}\n   */\n  containerPadding?: [number, number] | Record<Breakpoint, [number, number]>;\n  /**\n   * Grid container margin (x, y) in pixels for all or specific breakpoints.\n   * @defaultValue [0, 0]\n   * @example [10, 10]\n   * @example \\{ lg: [10, 10] \\}\n   */\n  containerMargin?: [number, number] | Record<Breakpoint, [number, number]>;\n  /**\n   * Maximum number of rows user can have in the grid.\n   * @defaultValue unlimited\n   */\n  maxRows?: number;\n  /**\n   * Custom style for grid.\n   */\n  style?: CSSProperties;\n  /**\n   * Compaction type of widgets in the grid. This controls where widgets are moved in case\n   * they are overlapping in the grid.\n   */\n  compactType?: 'vertical' | 'horizontal' | null;\n  /**\n   * Controls if widgets can overlap in the grid. If true, grid can be placed one over the other.\n   * @defaultValue false\n   */\n  allowOverlap?: boolean;\n  /**\n   * Controls if widgets can collide with each other. If true, grid items won't change position when being dragged over.\n   * @defaultValue true\n   */\n  preventCollision?: boolean;\n};\n\nexport const LayoutConfigurationSchema = z.object({\n  component: ReactElementSchema,\n  x: z.number().nonnegative('x must be positive number'),\n  y: z.number().nonnegative('y must be positive number'),\n  width: z.number().positive('width must be positive number'),\n  height: z.number().positive('height must be positive number'),\n  movable: z.boolean().optional(),\n  deletable: z.boolean().optional(),\n  resizable: z.boolean().optional(),\n});\n\n/**\n * Layout configuration that can be passed to the custom home page.\n *\n * @public\n */\nexport type LayoutConfiguration = {\n  component: ReactElement | string;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  movable?: boolean;\n  deletable?: boolean;\n  resizable?: boolean;\n};\n\nexport const WidgetSchema = z.object({\n  name: z.string(),\n  title: z.string().optional(),\n  description: z.string().optional(),\n  component: ReactElementSchema,\n  width: z.number().positive('width must be positive number').optional(),\n  height: z.number().positive('height must be positive number').optional(),\n  minWidth: z.number().positive('minWidth must be positive number').optional(),\n  maxWidth: z.number().positive('maxWidth must be positive number').optional(),\n  minHeight: z\n    .number()\n    .positive('minHeight must be positive number')\n    .optional(),\n  maxHeight: z\n    .number()\n    .positive('maxHeight must be positive number')\n    .optional(),\n  settingsSchema: RSJFTypeSchema.optional(),\n  uiSchema: RSJFTypeUiSchema.optional(),\n  movable: z.boolean().optional(),\n  deletable: z.boolean().optional(),\n  resizable: z.boolean().optional(),\n});\n\nexport type Widget = z.infer<typeof WidgetSchema>;\n\nconst GridWidgetSchema = z.object({\n  id: z.string(),\n  layout: LayoutSchema,\n  settings: z.record(z.string(), z.any()),\n  movable: z.boolean().optional(),\n  deletable: z.boolean().optional(),\n  resizable: z.boolean().optional(),\n});\n\nexport type GridWidget = z.infer<typeof GridWidgetSchema>;\n\nexport const CustomHomepageGridStateV1Schema = z.object({\n  version: z.literal(1),\n  pages: z.record(z.string(), z.array(GridWidgetSchema)),\n});\n\nexport type CustomHomepageGridStateV1 = z.infer<\n  typeof CustomHomepageGridStateV1Schema\n>;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.esm.js","sources":["../../../src/components/CustomHomepage/types.ts"],"sourcesContent":["/*\n * Copyright 2023 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 { CSSProperties, ReactElement, ReactNode } from 'react';\nimport { Layout } from 'react-grid-layout';\nimport { z } from 'zod/v3';\nimport { RJSFSchema, UiSchema } from '@rjsf/utils';\n\nconst RSJFTypeSchema: z.ZodType<RJSFSchema> = z.any();\nconst RSJFTypeUiSchema: z.ZodType<UiSchema> = z.any();\nconst ReactElementSchema: z.ZodType<ReactElement> = z.any();\nconst LayoutSchema: z.ZodType<Layout> = z.any();\n\n/**\n * Breakpoint options for <CustomHomepageGridProps/>\n *\n * @public\n */\nexport type Breakpoint = 'xxs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';\n\n/**\n * Props customizing the <CustomHomepageGrid/> component.\n *\n * @public\n */\nexport type CustomHomepageGridProps = {\n  /**\n   * Children contain all widgets user can configure on their own homepage.\n   */\n  children?: ReactNode;\n  /**\n   * Default layout for the homepage before users have modified it.\n   */\n  config?: LayoutConfiguration[];\n  /**\n   * Title displayed in the header of the grid. If not provided, no title will be shown.\n   */\n  title?: string;\n  /**\n   * Height of grid row in pixels.\n   * @defaultValue 60\n   */\n  rowHeight?: number;\n  /**\n   * Screen width in pixels for different breakpoints.\n   * @defaultValue theme breakpoints\n   */\n  breakpoints?: Record<Breakpoint, number>;\n  /**\n   * Number of grid columns for different breakpoints.\n   * @defaultValue \\{ lg: 12, md: 10, sm: 6, xs: 4, xxs: 2 \\}\n   */\n  cols?: Record<Breakpoint, number>;\n  /**\n   * Grid container padding (x, y) in pixels for all or specific breakpoints.\n   * @defaultValue [0, 0]\n   * @example [10, 10]\n   * @example \\{ lg: [10, 10] \\}\n   */\n  containerPadding?: [number, number] | Record<Breakpoint, [number, number]>;\n  /**\n   * Grid container margin (x, y) in pixels for all or specific breakpoints.\n   * @defaultValue [0, 0]\n   * @example [10, 10]\n   * @example \\{ lg: [10, 10] \\}\n   */\n  containerMargin?: [number, number] | Record<Breakpoint, [number, number]>;\n  /**\n   * Maximum number of rows user can have in the grid.\n   * @defaultValue unlimited\n   */\n  maxRows?: number;\n  /**\n   * Custom style for grid.\n   */\n  style?: CSSProperties;\n  /**\n   * Compaction type of widgets in the grid. This controls where widgets are moved in case\n   * they are overlapping in the grid.\n   */\n  compactType?: 'vertical' | 'horizontal' | null;\n  /**\n   * Controls if widgets can overlap in the grid. If true, grid can be placed one over the other.\n   * @defaultValue false\n   */\n  allowOverlap?: boolean;\n  /**\n   * Controls if widgets can collide with each other. If true, grid items won't change position when being dragged over.\n   * @defaultValue true\n   */\n  preventCollision?: boolean;\n};\n\nexport const LayoutConfigurationSchema = z.object({\n  component: ReactElementSchema,\n  x: z.number().nonnegative('x must be positive number'),\n  y: z.number().nonnegative('y must be positive number'),\n  width: z.number().positive('width must be positive number'),\n  height: z.number().positive('height must be positive number'),\n  movable: z.boolean().optional(),\n  deletable: z.boolean().optional(),\n  resizable: z.boolean().optional(),\n});\n\n/**\n * Layout configuration that can be passed to the custom home page.\n *\n * @public\n */\nexport type LayoutConfiguration = {\n  component: ReactElement | string;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  movable?: boolean;\n  deletable?: boolean;\n  resizable?: boolean;\n};\n\nexport const WidgetSchema = z.object({\n  name: z.string(),\n  title: z.string().optional(),\n  description: z.string().optional(),\n  component: ReactElementSchema,\n  width: z.number().positive('width must be positive number').optional(),\n  height: z.number().positive('height must be positive number').optional(),\n  minWidth: z.number().positive('minWidth must be positive number').optional(),\n  maxWidth: z.number().positive('maxWidth must be positive number').optional(),\n  minHeight: z\n    .number()\n    .positive('minHeight must be positive number')\n    .optional(),\n  maxHeight: z\n    .number()\n    .positive('maxHeight must be positive number')\n    .optional(),\n  settingsSchema: RSJFTypeSchema.optional(),\n  uiSchema: RSJFTypeUiSchema.optional(),\n  movable: z.boolean().optional(),\n  deletable: z.boolean().optional(),\n  resizable: z.boolean().optional(),\n});\n\nexport type Widget = z.infer<typeof WidgetSchema>;\n\nconst GridWidgetSchema = z.object({\n  id: z.string(),\n  layout: LayoutSchema,\n  settings: z.record(z.string(), z.any()),\n  movable: z.boolean().optional(),\n  deletable: z.boolean().optional(),\n  resizable: z.boolean().optional(),\n});\n\nexport type GridWidget = z.infer<typeof GridWidgetSchema>;\n\nexport const CustomHomepageGridStateV1Schema = z.object({\n  version: z.literal(1),\n  pages: z.record(z.string(), z.array(GridWidgetSchema)),\n});\n\nexport type CustomHomepageGridStateV1 = z.infer<\n  typeof CustomHomepageGridStateV1Schema\n>;\n"],"names":[],"mappings":";;AAqBA,MAAM,cAAA,GAAwC,EAAE,GAAA,EAAI;AACpD,MAAM,gBAAA,GAAwC,EAAE,GAAA,EAAI;AACpD,MAAM,kBAAA,GAA8C,EAAE,GAAA,EAAI;AAC1D,MAAM,YAAA,GAAkC,EAAE,GAAA,EAAI;AAkFvC,MAAM,yBAAA,GAA4B,EAAE,MAAA,CAAO;AAAA,EAChD,SAAA,EAAW,kBAAA;AAAA,EACX,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,YAAY,2BAA2B,CAAA;AAAA,EACrD,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,YAAY,2BAA2B,CAAA;AAAA,EACrD,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,+BAA+B,CAAA;AAAA,EAC1D,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,gCAAgC,CAAA;AAAA,EAC5D,OAAA,EAAS,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAC9B,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAChC,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACzB,CAAC;AAkBM,MAAM,YAAA,GAAe,EAAE,MAAA,CAAO;AAAA,EACnC,IAAA,EAAM,EAAE,MAAA,EAAO;AAAA,EACf,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,SAAA,EAAW,kBAAA;AAAA,EACX,OAAO,CAAA,CAAE,MAAA,GAAS,QAAA,CAAS,+BAA+B,EAAE,QAAA,EAAS;AAAA,EACrE,QAAQ,CAAA,CAAE,MAAA,GAAS,QAAA,CAAS,gCAAgC,EAAE,QAAA,EAAS;AAAA,EACvE,UAAU,CAAA,CAAE,MAAA,GAAS,QAAA,CAAS,kCAAkC,EAAE,QAAA,EAAS;AAAA,EAC3E,UAAU,CAAA,CAAE,MAAA,GAAS,QAAA,CAAS,kCAAkC,EAAE,QAAA,EAAS;AAAA,EAC3E,WAAW,CAAA,CACR,MAAA,GACA,QAAA,CAAS,mCAAmC,EAC5C,QAAA,EAAS;AAAA,EACZ,WAAW,CAAA,CACR,MAAA,GACA,QAAA,CAAS,mCAAmC,EAC5C,QAAA,EAAS;AAAA,EACZ,cAAA,EAAgB,eAAe,QAAA,EAAS;AAAA,EACxC,QAAA,EAAU,iBAAiB,QAAA,EAAS;AAAA,EACpC,OAAA,EAAS,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAC9B,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAChC,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACzB,CAAC;AAID,MAAM,gBAAA,GAAmB,EAAE,MAAA,CAAO;AAAA,EAChC,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,EACb,MAAA,EAAQ,YAAA;AAAA,EACR,QAAA,EAAU,EAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,CAAA,CAAE,KAAK,CAAA;AAAA,EACtC,OAAA,EAAS,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAC9B,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAChC,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACzB,CAAC,CAAA;AAIM,MAAM,+BAAA,GAAkC,EAAE,MAAA,CAAO;AAAA,EACtD,OAAA,EAAS,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAA;AAAA,EACpB,KAAA,EAAO,EAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,CAAA,CAAE,KAAA,CAAM,gBAAgB,CAAC;AACvD,CAAC;;;;"}

package/dist/index.d.ts

@@ -618,5 +618,40 @@ declare const SettingsModal: (props: {
     children: JSX.Element;
 }) => react_jsx_runtime.JSX.Element;
 
-export { ComponentAccordion, ComponentTab, ComponentTabs, CustomHomepageGrid, FeaturedDocsCard, HeaderWorldClock, HomePageCompanyLogo, HomePageRandomJoke, HomePageRecentlyVisited, HomePageStarredEntities, HomePageToolkit, HomePageTopVisited, HomepageCompositionRoot, QuickStartCard, SettingsModal, TemplateBackstageLogo, TemplateBackstageLogoIcon, VisitDisplayProvider, VisitListener, VisitsStorageApi, VisitsWebStorageApi, WelcomeTitle, createCardExtension, homePlugin, isOperator, useVisitDisplay, visitsApiRef };
+/**
+ * Translation reference for the home plugin.
+ * Contains localized text strings for home page components and widgets.
+ *
+ * @public
+ */
+declare const homeTranslationRef: _backstage_frontend_plugin_api.TranslationRef<"home", {
+    readonly "starredEntities.noStarredEntitiesMessage": "Click the star beside an entity name to add it to this list!";
+    readonly "addWidgetDialog.title": "Add new widget to dashboard";
+    readonly "customHomepageButtons.cancel": "Cancel";
+    readonly "customHomepageButtons.clearAll": "Clear all";
+    readonly "customHomepageButtons.edit": "Edit";
+    readonly "customHomepageButtons.restoreDefaults": "Restore defaults";
+    readonly "customHomepageButtons.addWidget": "Add widget";
+    readonly "customHomepageButtons.save": "Save";
+    readonly "customHomepage.noWidgets": "No widgets added. Start by clicking the 'Add widget' button.";
+    readonly "widgetSettingsOverlay.cancelButtonTitle": "Cancel";
+    readonly "widgetSettingsOverlay.editSettingsTooptip": "Edit settings";
+    readonly "widgetSettingsOverlay.deleteWidgetTooltip": "Delete widget";
+    readonly "widgetSettingsOverlay.submitButtonTitle": "Submit";
+    readonly "starredEntityListItem.removeFavoriteEntityTitle": "Remove entity from favorites";
+    readonly "visitList.empty.title": "There are no visits to show yet.";
+    readonly "visitList.empty.description": "Once you start using Backstage, your visits will appear here as a quick link to carry on where you left off.";
+    readonly "visitList.few.title": "The more pages you visit, the more pages will appear here.";
+    readonly "quickStart.title": "Onboarding";
+    readonly "quickStart.description": "Get started with Backstage";
+    readonly "quickStart.learnMoreLinkTitle": "Learn more";
+    readonly "visitedByType.action.viewMore": "View more";
+    readonly "visitedByType.action.viewLess": "View less";
+    readonly "featuredDocsCard.empty.title": "No documents to show";
+    readonly "featuredDocsCard.empty.description": "Create your own document. Check out our Getting Started Information";
+    readonly "featuredDocsCard.empty.learnMoreLinkTitle": "DOCS";
+    readonly "featuredDocsCard.learnMoreTitle": "LEARN MORE";
+}>;
+
+export { ComponentAccordion, ComponentTab, ComponentTabs, CustomHomepageGrid, FeaturedDocsCard, HeaderWorldClock, HomePageCompanyLogo, HomePageRandomJoke, HomePageRecentlyVisited, HomePageStarredEntities, HomePageToolkit, HomePageTopVisited, HomepageCompositionRoot, QuickStartCard, SettingsModal, TemplateBackstageLogo, TemplateBackstageLogoIcon, VisitDisplayProvider, VisitListener, VisitsStorageApi, VisitsWebStorageApi, WelcomeTitle, createCardExtension, homePlugin, homeTranslationRef, isOperator, useVisitDisplay, visitsApiRef };
 export type { Breakpoint, CardConfig, CardExtensionProps, CardLayout, CardSettings, ClockConfig, ComponentParts, ComponentRenderer, CustomHomepageGridProps, FeaturedDocsCardProps, GetChipColorFunction, GetLabelFunction, LayoutConfiguration, Operators, QuickStartCardProps, RendererProps, StarredEntitiesProps, Tool, ToolkitContentProps, Visit, VisitDisplayContextValue, VisitDisplayProviderProps, VisitInput, VisitedByTypeKind, VisitedByTypeProps, VisitsApi, VisitsApiQueryParams, VisitsApiSaveParams, VisitsStorageApiOptions, VisitsWebStorageApiOptions, WelcomeTitleLanguageProps };

package/dist/index.esm.js

@@ -10,4 +10,5 @@ export { SettingsModal, createCardExtension } from './deprecated.esm.js';
 export { VisitsStorageApi } from './api/VisitsStorageApi.esm.js';
 export { VisitsWebStorageApi } from './api/VisitsWebStorageApi.esm.js';
 export { isOperator, visitsApiRef } from './api/VisitsApi.esm.js';
+export { homeTranslationRef } from './translation.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/dist/package.json.esm.js

@@ -1,5 +1,5 @@
 var name = "@backstage/plugin-home";
-var version = "0.9.3-next.2";
+var version = "0.9.3";
 var description = "A Backstage plugin that helps you build a home page";
 var backstage = {
 	role: "frontend-plugin",
@@ -78,7 +78,7 @@ var dependencies = {
 	"react-grid-layout": "1.3.4",
 	"react-resizable": "^3.0.4",
 	"react-use": "^17.2.4",
-	zod: "^3.25.76"
+	zod: "^3.25.76 || ^4.0.0"
 };
 var devDependencies = {
 	"@backstage/cli": "workspace:^",

package/dist/translation.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"translation.esm.js","sources":["../src/translation.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 */\nimport { createTranslationRef } from '@backstage/frontend-plugin-api';\n\n/**\n * Translation reference for the home plugin.\n * Contains localized text strings for home page components and widgets.\n *\n * @alpha\n */\nexport const homeTranslationRef = createTranslationRef({\n  id: 'home',\n  messages: {\n    addWidgetDialog: {\n      title: 'Add new widget to dashboard',\n    },\n    customHomepageButtons: {\n      edit: 'Edit',\n      restoreDefaults: 'Restore defaults',\n      clearAll: 'Clear all',\n      addWidget: 'Add widget',\n      save: 'Save',\n      cancel: 'Cancel',\n    },\n    customHomepage: {\n      noWidgets: \"No widgets added. Start by clicking the 'Add widget' button.\",\n    },\n    widgetSettingsOverlay: {\n      editSettingsTooptip: 'Edit settings',\n      deleteWidgetTooltip: 'Delete widget',\n      submitButtonTitle: 'Submit',\n      cancelButtonTitle: 'Cancel',\n    },\n    starredEntityListItem: {\n      removeFavoriteEntityTitle: 'Remove entity from favorites',\n    },\n    visitList: {\n      empty: {\n        title: 'There are no visits to show yet.',\n        description:\n          'Once you start using Backstage, your visits will appear here as a quick link to carry on where you left off.',\n      },\n      few: {\n        title: 'The more pages you visit, the more pages will appear here.',\n      },\n    },\n    quickStart: {\n      title: 'Onboarding',\n      description: 'Get started with Backstage',\n      learnMoreLinkTitle: 'Learn more',\n    },\n    starredEntities: {\n      noStarredEntitiesMessage:\n        'Click the star beside an entity name to add it to this list!',\n    },\n    visitedByType: {\n      action: {\n        viewMore: 'View more',\n        viewLess: 'View less',\n      },\n    },\n    featuredDocsCard: {\n      learnMoreTitle: 'LEARN MORE',\n      empty: {\n        title: 'No documents to show',\n        description:\n          'Create your own document. Check out our Getting Started Information',\n        learnMoreLinkTitle: 'DOCS',\n      },\n    },\n  },\n});\n"],"names":[],"mappings":";;AAuBO,MAAM,qBAAqB,oBAAA,CAAqB;AAAA,EACrD,EAAA,EAAI,MAAA;AAAA,EACJ,QAAA,EAAU;AAAA,IACR,eAAA,EAAiB;AAAA,MACf,KAAA,EAAO;AAAA,KACT;AAAA,IACA,qBAAA,EAAuB;AAAA,MACrB,IAAA,EAAM,MAAA;AAAA,MACN,eAAA,EAAiB,kBAAA;AAAA,MACjB,QAAA,EAAU,WAAA;AAAA,MACV,SAAA,EAAW,YAAA;AAAA,MACX,IAAA,EAAM,MAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,cAAA,EAAgB;AAAA,MACd,SAAA,EAAW;AAAA,KACb;AAAA,IACA,qBAAA,EAAuB;AAAA,MACrB,mBAAA,EAAqB,eAAA;AAAA,MACrB,mBAAA,EAAqB,eAAA;AAAA,MACrB,iBAAA,EAAmB,QAAA;AAAA,MACnB,iBAAA,EAAmB;AAAA,KACrB;AAAA,IACA,qBAAA,EAAuB;AAAA,MACrB,yBAAA,EAA2B;AAAA,KAC7B;AAAA,IACA,SAAA,EAAW;AAAA,MACT,KAAA,EAAO;AAAA,QACL,KAAA,EAAO,kCAAA;AAAA,QACP,WAAA,EACE;AAAA,OACJ;AAAA,MACA,GAAA,EAAK;AAAA,QACH,KAAA,EAAO;AAAA;AACT,KACF;AAAA,IACA,UAAA,EAAY;AAAA,MACV,KAAA,EAAO,YAAA;AAAA,MACP,WAAA,EAAa,4BAAA;AAAA,MACb,kBAAA,EAAoB;AAAA,KACtB;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,wBAAA,EACE;AAAA,KACJ;AAAA,IACA,aAAA,EAAe;AAAA,MACb,MAAA,EAAQ;AAAA,QACN,QAAA,EAAU,WAAA;AAAA,QACV,QAAA,EAAU;AAAA;AACZ,KACF;AAAA,IACA,gBAAA,EAAkB;AAAA,MAChB,cAAA,EAAgB,YAAA;AAAA,MAChB,KAAA,EAAO;AAAA,QACL,KAAA,EAAO,sBAAA;AAAA,QACP,WAAA,EACE,qEAAA;AAAA,QACF,kBAAA,EAAoB;AAAA;AACtB;AACF;AAEJ,CAAC;;;;"}
+{"version":3,"file":"translation.esm.js","sources":["../src/translation.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 */\nimport { createTranslationRef } from '@backstage/frontend-plugin-api';\n\n/**\n * Translation reference for the home plugin.\n * Contains localized text strings for home page components and widgets.\n *\n * @public\n */\nexport const homeTranslationRef = createTranslationRef({\n  id: 'home',\n  messages: {\n    addWidgetDialog: {\n      title: 'Add new widget to dashboard',\n    },\n    customHomepageButtons: {\n      edit: 'Edit',\n      restoreDefaults: 'Restore defaults',\n      clearAll: 'Clear all',\n      addWidget: 'Add widget',\n      save: 'Save',\n      cancel: 'Cancel',\n    },\n    customHomepage: {\n      noWidgets: \"No widgets added. Start by clicking the 'Add widget' button.\",\n    },\n    widgetSettingsOverlay: {\n      editSettingsTooptip: 'Edit settings',\n      deleteWidgetTooltip: 'Delete widget',\n      submitButtonTitle: 'Submit',\n      cancelButtonTitle: 'Cancel',\n    },\n    starredEntityListItem: {\n      removeFavoriteEntityTitle: 'Remove entity from favorites',\n    },\n    visitList: {\n      empty: {\n        title: 'There are no visits to show yet.',\n        description:\n          'Once you start using Backstage, your visits will appear here as a quick link to carry on where you left off.',\n      },\n      few: {\n        title: 'The more pages you visit, the more pages will appear here.',\n      },\n    },\n    quickStart: {\n      title: 'Onboarding',\n      description: 'Get started with Backstage',\n      learnMoreLinkTitle: 'Learn more',\n    },\n    starredEntities: {\n      noStarredEntitiesMessage:\n        'Click the star beside an entity name to add it to this list!',\n    },\n    visitedByType: {\n      action: {\n        viewMore: 'View more',\n        viewLess: 'View less',\n      },\n    },\n    featuredDocsCard: {\n      learnMoreTitle: 'LEARN MORE',\n      empty: {\n        title: 'No documents to show',\n        description:\n          'Create your own document. Check out our Getting Started Information',\n        learnMoreLinkTitle: 'DOCS',\n      },\n    },\n  },\n});\n"],"names":[],"mappings":";;AAuBO,MAAM,qBAAqB,oBAAA,CAAqB;AAAA,EACrD,EAAA,EAAI,MAAA;AAAA,EACJ,QAAA,EAAU;AAAA,IACR,eAAA,EAAiB;AAAA,MACf,KAAA,EAAO;AAAA,KACT;AAAA,IACA,qBAAA,EAAuB;AAAA,MACrB,IAAA,EAAM,MAAA;AAAA,MACN,eAAA,EAAiB,kBAAA;AAAA,MACjB,QAAA,EAAU,WAAA;AAAA,MACV,SAAA,EAAW,YAAA;AAAA,MACX,IAAA,EAAM,MAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,cAAA,EAAgB;AAAA,MACd,SAAA,EAAW;AAAA,KACb;AAAA,IACA,qBAAA,EAAuB;AAAA,MACrB,mBAAA,EAAqB,eAAA;AAAA,MACrB,mBAAA,EAAqB,eAAA;AAAA,MACrB,iBAAA,EAAmB,QAAA;AAAA,MACnB,iBAAA,EAAmB;AAAA,KACrB;AAAA,IACA,qBAAA,EAAuB;AAAA,MACrB,yBAAA,EAA2B;AAAA,KAC7B;AAAA,IACA,SAAA,EAAW;AAAA,MACT,KAAA,EAAO;AAAA,QACL,KAAA,EAAO,kCAAA;AAAA,QACP,WAAA,EACE;AAAA,OACJ;AAAA,MACA,GAAA,EAAK;AAAA,QACH,KAAA,EAAO;AAAA;AACT,KACF;AAAA,IACA,UAAA,EAAY;AAAA,MACV,KAAA,EAAO,YAAA;AAAA,MACP,WAAA,EAAa,4BAAA;AAAA,MACb,kBAAA,EAAoB;AAAA,KACtB;AAAA,IACA,eAAA,EAAiB;AAAA,MACf,wBAAA,EACE;AAAA,KACJ;AAAA,IACA,aAAA,EAAe;AAAA,MACb,MAAA,EAAQ;AAAA,QACN,QAAA,EAAU,WAAA;AAAA,QACV,QAAA,EAAU;AAAA;AACZ,KACF;AAAA,IACA,gBAAA,EAAkB;AAAA,MAChB,cAAA,EAAgB,YAAA;AAAA,MAChB,KAAA,EAAO;AAAA,QACL,KAAA,EAAO,sBAAA;AAAA,QACP,WAAA,EACE,qEAAA;AAAA,QACF,kBAAA,EAAoB;AAAA;AACtB;AACF;AAEJ,CAAC;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-home",
-  "version": "0.9.3-next.2",
+  "version": "0.9.3",
   "description": "A Backstage plugin that helps you build a home page",
   "backstage": {
     "role": "frontend-plugin",
@@ -68,17 +68,17 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/catalog-client": "1.14.0-next.2",
-    "@backstage/catalog-model": "1.7.6",
-    "@backstage/config": "1.3.6",
-    "@backstage/core-app-api": "1.19.6-next.1",
-    "@backstage/core-compat-api": "0.5.9-next.2",
-    "@backstage/core-components": "0.18.8-next.1",
-    "@backstage/core-plugin-api": "1.12.4-next.1",
-    "@backstage/frontend-plugin-api": "0.15.0-next.1",
-    "@backstage/plugin-catalog-react": "2.1.0-next.2",
-    "@backstage/plugin-home-react": "0.1.36-next.1",
-    "@backstage/theme": "0.7.2",
+    "@backstage/catalog-client": "^1.14.0",
+    "@backstage/catalog-model": "^1.7.7",
+    "@backstage/config": "^1.3.6",
+    "@backstage/core-app-api": "^1.19.6",
+    "@backstage/core-compat-api": "^0.5.9",
+    "@backstage/core-components": "^0.18.8",
+    "@backstage/core-plugin-api": "^1.12.4",
+    "@backstage/frontend-plugin-api": "^0.15.0",
+    "@backstage/plugin-catalog-react": "^2.1.0",
+    "@backstage/plugin-home-react": "^0.1.36",
+    "@backstage/theme": "^0.7.2",
     "@material-ui/core": "^4.12.2",
     "@material-ui/icons": "^4.9.1",
     "@material-ui/lab": "4.0.0-alpha.61",
@@ -91,14 +91,14 @@
     "react-grid-layout": "1.3.4",
     "react-resizable": "^3.0.4",
     "react-use": "^17.2.4",
-    "zod": "^3.25.76"
+    "zod": "^3.25.76 || ^4.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "0.36.0-next.2",
-    "@backstage/dev-utils": "1.1.21-next.1",
-    "@backstage/frontend-defaults": "0.5.0-next.1",
-    "@backstage/plugin-catalog": "2.0.0-next.2",
-    "@backstage/test-utils": "1.7.16-next.0",
+    "@backstage/cli": "^0.36.0",
+    "@backstage/dev-utils": "^1.1.21",
+    "@backstage/frontend-defaults": "^0.5.0",
+    "@backstage/plugin-catalog": "^2.0.0",
+    "@backstage/test-utils": "^1.7.16",
     "@testing-library/dom": "^10.0.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",