[polaris.shopify.com] Add legacy documentation

.changeset/tender-moons-tease.md

@@ -0,0 +1,5 @@
+---
+'polaris.shopify.com': patch
+---
+
+Added `Legacy` status to component lifecycle page and banner/badge to `LegacyStack` and `LegacyCard`

polaris.shopify.com/content/components/layout-and-structure/legacy-card.md

@@ -21,6 +21,9 @@ keywords:
   - callout
   - call out
   - legacy card
+status:
+  value: Legacy
+  message: This is a legacy component and will be deprecated. The new [AlphaCard component](/components/layout-and-structure/alpha-card) can be used in combination with the new layout primitives to achieve similar results to LegacyCard. Learn more about our [component lifecycles](/getting-started/components-lifecycle).
 examples:
   - fileName: legacy-card-default.tsx
     title: Default

polaris.shopify.com/content/components/layout-and-structure/legacy-stack.md

@@ -18,6 +18,9 @@ keywords:
   - stack layout
   - layout
   - legacy stack
+status:
+  value: Legacy
+  message: This is a legacy component and will be deprecated. The new [AlphaStack component](/components/layout-and-structure/alpha-stack) can be used in combination with the new layout primitives to achieve similar results to LegacyStack. Learn more about our [component lifecycles](/getting-started/components-lifecycle).
 examples:
   - fileName: legacy-stack-default.tsx
     title: Default

polaris.shopify.com/content/getting-started/components-lifecycle.md

@@ -8,6 +8,7 @@ keywords:
   - alpha
   - beta
   - stable
+  - legacy
   - deprecated
 order: 1
 ---
@@ -72,6 +73,18 @@ The component is bug free and works in most, if not all, environments. It’s re
 
 ---
 
+## Legacy
+
+The component will be deprecated and should be avoided.
+
+### Requirements for legacy components
+
+- Documentation exists for the legacy component and includes any alternative components
+- The deprecation date has been announced and is at least one month away from the release date of the package that deprecated the component
+- Manual and automated migration paths are documented and have been available for at least one month
+
+---
+
 ## Deprecated
 
 The component will be removed and should be avoided.

polaris.shopify.com/src/components/StatusBadge/StatusBadge.module.scss

@@ -11,7 +11,8 @@
   }
 
   &[data-value='warning'],
-  &[data-value='deprecated'] {
+  &[data-value='deprecated'],
+  &[data-value='legacy'] {
     background: var(--surface-warning);
   }
 

polaris.shopify.com/src/components/StatusBanner/StatusBanner.module.scss

@@ -10,7 +10,8 @@
   }
 
   &[data-value='warning'],
-  &[data-value='deprecated'] {
+  &[data-value='deprecated'],
+  &[data-value='legacy'] {
     background: var(--surface-warning);
   }
 
@@ -19,7 +20,6 @@
     background: var(--surface-information);
   }
 
-  &[data-value='legacy'],
   &[data-value='information'] {
     background: var(--surface-information);
   }