[PageActions] [FullscreenBar] Deprecate (#13965)

<!--
  ☝️How to write a good PR title:
- Prefix it with [ComponentName] (if applicable), for example: [Button]
  - Start with a verb, for example: Add, Delete, Improve, Fix…
  - Give as much context as necessary and as little as possible
  - Open it as a draft if it’s a work in progress
-->

### WHY are these changes introduced?

1.
[PageActions](https://polaris-react.shopify.com/components/actions/page-actions)
are a legacy UX solution. Page actions should instead be presented via
the [contextual save
bar](https://shopify.dev/docs/api/app-bridge-library/apis/save-bar) (in
the case of Save) OR via the [Polaris
Page](https://polaris-react.shopify.com/components/layout-and-structure/page)
action props (i.e. `primaryAction`, `secondaryActions`, `actionGroups`).
2.
[FullscreenBar](https://polaris-react.shopify.com/components/navigation/fullscreen-bar)
is a legacy UX solution. Instead [max variant
modals](https://shopify.dev/docs/api/app-bridge-library/web-components/ui-modal)
should be used in combination with the
[SaveBar](https://shopify.dev/docs/api/app-bridge-library/apis/save-bar)
and
[TitleBar](https://shopify.dev/docs/api/app-bridge-library/web-components/ui-title-bar).

The [App Design
Guidelines](https://shopify.dev/docs/apps/design/app-structure)
explicitly state not to use FullscreenBar.

<img width="840" height="324" alt="01-40-tyci1-sxt9y"
src="https://github.com/user-attachments/assets/66ad93f8-9c08-44bc-8eba-03888ff834f6"
/>

Built for Shopify requirement
[4.1.6](https://shopify.dev/docs/apps/launch/built-for-shopify/requirements#use-modals-appropriately),
lists using FullscreenBar as a failure example.
 
<img width="910" height="824" alt="01-43-t7px5-mzkqr"
src="https://github.com/user-attachments/assets/503c87b1-910b-4003-a821-4b67b20a597d"
/>

<!--
  Context about the problem that’s being addressed.
-->

### WHAT is this pull request doing?

This PR moves both the `PageActions` and `FullscreenBar` components to
the Deprecated section in the nav. It also displays a "Deprecated"
banner on both of the component pages.

<img width="1305" height="875" alt="01-59-c5awl-pclmj"
src="https://github.com/user-attachments/assets/c5edc48b-aa77-4e33-ba95-a30c286308d0"
/>

<img width="1307" height="823" alt="01-58-qmsur-50290"
src="https://github.com/user-attachments/assets/539050a1-89f3-4269-bd87-b8292e480bca"
/>

### How to 🎩

🖥 [Local development
instructions](https://github.com/Shopify/polaris/blob/main/README.md#install-dependencies-and-build-workspaces)
🗒 [General tophatting
guidelines](https://github.com/Shopify/polaris/blob/main/documentation/Tophatting.md)
📄 [Changelog
guidelines](https://github.com/Shopify/polaris/blob/main/.github/CONTRIBUTING.md#changelog)

### 🎩 checklist

- [x] Tested a
[snapshot](https://github.com/Shopify/polaris/blob/main/documentation/Releasing.md#-snapshot-releases)
- [x] Tested on
[mobile](https://github.com/Shopify/polaris/blob/main/documentation/Tophatting.md#cross-browser-testing)
- [x] Tested on [multiple
browsers](https://help.shopify.com/en/manual/shopify-admin/supported-browsers)
- [x] Tested for
[accessibility](https://github.com/Shopify/polaris/blob/main/documentation/Accessibility%20testing.md)
- [x] Updated the component's `README.md` with documentation changes
- [x] [Tophatted
documentation](https://github.com/Shopify/polaris/blob/main/documentation/Tophatting%20documentation.md)
changes in the style guide

polaris.shopify.com/content/components/navigation/fullscreen-bar.mdx → polaris.shopify.com/content/components/deprecated/fullscreen-bar.mdx

@@ -1,6 +1,6 @@
 ---
 title: Fullscreen bar
-category: Navigation
+category: Deprecated
 keywords:
   - topbar
   - top bar
@@ -14,7 +14,8 @@ examples:
   - fileName: fullscreen-bar-no-children.tsx
     title: No children
     description: Use this default to show ONLY the Back button.
-previewImg: /images/components/navigation/fullscreen-bar.png
+status: Deprecated
+previewImg: /images/components/deprecated/fullscreen-bar.png
 ---
 
 # {frontmatter.title}
@@ -25,6 +26,14 @@ The Fullscreen bar is a header component that should be presented at the top of
 
 </Lede>
 
+<StatusBanner status={frontmatter.status}>
+  This component is no longer supported. Please use the [App Bridge Modal
+  API](https://shopify.dev/docs/api/app-bridge-library/web-components/ui-modal?example=modals-with-different-options-opening-a-max-size-modal)
+  in combination with the [App Bridge Title Bar
+  API](https://shopify.dev/docs/api/app-bridge-library/web-components/ui-title-bar)
+  instead.
+</StatusBanner>
+
 <Examples />
 
 <Props componentName={frontmatter.title} />

polaris.shopify.com/content/components/actions/page-actions.mdx → polaris.shopify.com/content/components/deprecated/page-actions.mdx

@@ -1,7 +1,7 @@
 ---
 title: Page actions
 shortDescription: Allows merchants to take key actions at the bottom of specific pages in the interface.
-category: Actions
+category: Deprecated
 keywords:
   - PageActions
   - bottom of page actions
@@ -25,7 +25,8 @@ examples:
   - fileName: page-actions-with-custom-secondary-action.tsx
     title: With custom secondary action
     description: Use to create a custom secondary action.
-previewImg: /images/components/actions/page-actions.png
+status: Deprecated
+previewImg: /images/components/deprecated/page-actions.png
 ---
 
 # {frontmatter.title}
@@ -36,6 +37,11 @@ Page actions let merchants take key actions at the bottom of specific pages in t
 
 </Lede>
 
+<StatusBanner status={frontmatter.status}>
+  This component is no longer supported. Please use the [App Bridge Save Bar
+  API](https://shopify.dev/docs/api/app-bridge-library/apis/save-bar) instead.
+</StatusBanner>
+
 <Examples />
 
 <Props componentName={frontmatter.title} />

polaris.shopify.com/next-env.d.ts

@@ -2,4 +2,4 @@
 /// <reference types="next/image-types/global" />
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.
+// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.

polaris.shopify.com/next.config.js

@@ -237,11 +237,6 @@ const actions = [
     destination: '/components/actions/button',
     permanent: true,
   },
-  {
-    source: '/components/page-actions',
-    destination: '/components/actions/page-actions',
-    permanent: true,
-  },
 ];
 
 const deprecated = [
@@ -260,6 +255,11 @@ const deprecated = [
     destination: '/components/deprecated/display-text',
     permanent: true,
   },
+  {
+    source: '/components/fullscreen-bar',
+    destination: '/components/deprecated/fullscreen-bar',
+    permanent: true,
+  },
   {
     source: '/components/heading',
     destination: '/components/deprecated/heading',
@@ -285,6 +285,11 @@ const deprecated = [
     destination: '/components/deprecated/legacy-tabs',
     permanent: true,
   },
+  {
+    source: '/components/page-actions',
+    destination: '/components/deprecated/page-actions',
+    permanent: true,
+  },
   {
     source: '/components/selection-and-input/setting-toggle',
     destination: '/components/deprecated/setting-toggle',
@@ -585,11 +590,6 @@ const navigation = [
     destination: '/components/navigation/footer-help',
     permanent: true,
   },
-  {
-    source: '/components/fullscreen-bar',
-    destination: '/components/navigation/fullscreen-bar',
-    permanent: true,
-  },
   {
     source: '/components/link',
     destination: '/components/navigation/link',