diff --git a/packages/components/src/alignment-matrix-control/stories/index.story.tsx b/packages/components/src/alignment-matrix-control/stories/index.story.tsx
index 39e26f8f64fe11..2f2b8e2b6bd189 100644
--- a/packages/components/src/alignment-matrix-control/stories/index.story.tsx
+++ b/packages/components/src/alignment-matrix-control/stories/index.story.tsx
@@ -33,10 +33,6 @@ const meta: Meta< typeof AlignmentMatrixControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/angle-picker-control/stories/index.story.tsx b/packages/components/src/angle-picker-control/stories/index.story.tsx
index c268fd1c2ba462..8f64699213e844 100644
--- a/packages/components/src/angle-picker-control/stories/index.story.tsx
+++ b/packages/components/src/angle-picker-control/stories/index.story.tsx
@@ -29,10 +29,6 @@ const meta: Meta< typeof AnglePickerControl > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
diff --git a/packages/components/src/animate/stories/index.story.tsx b/packages/components/src/animate/stories/index.story.tsx
index 7e929ce380fdf6..97934c439fa6ae 100644
--- a/packages/components/src/animate/stories/index.story.tsx
+++ b/packages/components/src/animate/stories/index.story.tsx
@@ -16,11 +16,6 @@ const meta: Meta< typeof Animate > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/badge/stories/index.story.tsx b/packages/components/src/badge/stories/index.story.tsx
index 5115c5f96d4615..da8bf21f386fd6 100644
--- a/packages/components/src/badge/stories/index.story.tsx
+++ b/packages/components/src/badge/stories/index.story.tsx
@@ -13,13 +13,6 @@ const meta: Meta< typeof Badge > = {
title: 'Components/Containers/Badge',
id: 'components-badge',
tags: [ 'status-private' ],
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Will be superseded by `Badge` in `@wordpress/ui`, but continue using for now.',
- },
- },
};
export default meta;
diff --git a/packages/components/src/base-control/stories/index.story.tsx b/packages/components/src/base-control/stories/index.story.tsx
index 6f1f37e99386b1..b0ab2ab85a231f 100644
--- a/packages/components/src/base-control/stories/index.story.tsx
+++ b/packages/components/src/base-control/stories/index.story.tsx
@@ -25,11 +25,6 @@ const meta: Meta< typeof BaseControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `Field` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/border-box-control/stories/index.story.tsx b/packages/components/src/border-box-control/stories/index.story.tsx
index 473e9b2af3ec53..113c8b352603df 100644
--- a/packages/components/src/border-box-control/stories/index.story.tsx
+++ b/packages/components/src/border-box-control/stories/index.story.tsx
@@ -25,10 +25,6 @@ const meta: Meta< typeof BorderBoxControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/border-control/stories/index.story.tsx b/packages/components/src/border-control/stories/index.story.tsx
index 195089d710cc3a..28406cdc7623d8 100644
--- a/packages/components/src/border-control/stories/index.story.tsx
+++ b/packages/components/src/border-control/stories/index.story.tsx
@@ -28,10 +28,6 @@ const meta: Meta< typeof BorderControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/box-control/stories/index.story.tsx b/packages/components/src/box-control/stories/index.story.tsx
index 6ea7e63fd01d99..387e5604af7877 100644
--- a/packages/components/src/box-control/stories/index.story.tsx
+++ b/packages/components/src/box-control/stories/index.story.tsx
@@ -26,11 +26,6 @@ const meta: Meta< typeof BoxControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'editor',
- notes: 'This component is a fallback for themes that do not supply spacing presets. Most of the time `SpacingSizesControl` from `@wordpress/block-editor` is used instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/button/stories/index.story.tsx b/packages/components/src/button/stories/index.story.tsx
index 3f89d055784c5c..4495c40f6efede 100644
--- a/packages/components/src/button/stories/index.story.tsx
+++ b/packages/components/src/button/stories/index.story.tsx
@@ -52,11 +52,6 @@ const meta: Meta< typeof Button > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `Button` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/card/stories/index.story.tsx b/packages/components/src/card/stories/index.story.tsx
index 8e7de3fb3ff80b..b58e062cbac37c 100644
--- a/packages/components/src/card/stories/index.story.tsx
+++ b/packages/components/src/card/stories/index.story.tsx
@@ -29,11 +29,6 @@ const meta: Meta< typeof Card > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Card` or `CollapsibleCard` from `@wordpress/ui` instead.',
- },
},
};
diff --git a/packages/components/src/checkbox-control/stories/index.story.tsx b/packages/components/src/checkbox-control/stories/index.story.tsx
index 45d0b57b44d0f5..59f33d5115f00a 100644
--- a/packages/components/src/checkbox-control/stories/index.story.tsx
+++ b/packages/components/src/checkbox-control/stories/index.story.tsx
@@ -35,11 +35,6 @@ const meta: Meta< typeof CheckboxControl > = {
exclude: [ 'heading' ],
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `CheckboxControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/circular-option-picker/stories/index.story.tsx b/packages/components/src/circular-option-picker/stories/index.story.tsx
index 11ca9e22a8decb..28e0736615ffca 100644
--- a/packages/components/src/circular-option-picker/stories/index.story.tsx
+++ b/packages/components/src/circular-option-picker/stories/index.story.tsx
@@ -38,11 +38,6 @@ const meta: Meta< typeof CircularOptionPicker > = {
canvas: { sourceState: 'shown' },
source: { excludeDecorators: true },
},
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Mostly intended for internal use.',
- },
},
decorators: [
// Share current color state between main component, `actions` and `options`
diff --git a/packages/components/src/color-indicator/stories/index.story.tsx b/packages/components/src/color-indicator/stories/index.story.tsx
index 6e61ef6ba1277f..cf789af24f4799 100644
--- a/packages/components/src/color-indicator/stories/index.story.tsx
+++ b/packages/components/src/color-indicator/stories/index.story.tsx
@@ -23,10 +23,6 @@ const meta: Meta< typeof ColorIndicator > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/color-palette/stories/index.story.tsx b/packages/components/src/color-palette/stories/index.story.tsx
index df3085ea00d681..e10432ce81bacd 100644
--- a/packages/components/src/color-palette/stories/index.story.tsx
+++ b/packages/components/src/color-palette/stories/index.story.tsx
@@ -27,10 +27,6 @@ const meta: Meta< typeof ColorPalette > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/color-picker/stories/index.story.tsx b/packages/components/src/color-picker/stories/index.story.tsx
index 75b0e3c81bac9d..b04d7d817f5ea1 100644
--- a/packages/components/src/color-picker/stories/index.story.tsx
+++ b/packages/components/src/color-picker/stories/index.story.tsx
@@ -26,10 +26,6 @@ const meta: Meta< typeof ColorPicker > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/combobox-control/stories/index.story.tsx b/packages/components/src/combobox-control/stories/index.story.tsx
index 8356dbc15c2e79..2e1b76d432541c 100644
--- a/packages/components/src/combobox-control/stories/index.story.tsx
+++ b/packages/components/src/combobox-control/stories/index.story.tsx
@@ -49,11 +49,6 @@ const meta: Meta< typeof ComboboxControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SearchableSelectControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/composite/stories/index.story.tsx b/packages/components/src/composite/stories/index.story.tsx
index 45811bb6632614..6e5048b7e938c6 100644
--- a/packages/components/src/composite/stories/index.story.tsx
+++ b/packages/components/src/composite/stories/index.story.tsx
@@ -48,10 +48,6 @@ const meta: Meta< typeof Composite > = {
docs: {
canvas: { sourceState: 'shown' },
},
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
decorators: [
( Story ) => {
diff --git a/packages/components/src/confirm-dialog/stories/index.story.tsx b/packages/components/src/confirm-dialog/stories/index.story.tsx
index f8d302b14c42ca..3fb32b34a666f0 100644
--- a/packages/components/src/confirm-dialog/stories/index.story.tsx
+++ b/packages/components/src/confirm-dialog/stories/index.story.tsx
@@ -33,10 +33,6 @@ const meta: Meta< typeof ConfirmDialog > = {
controls: {
expanded: true,
},
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
docs: { canvas: { sourceState: 'shown' } },
},
};
diff --git a/packages/components/src/custom-gradient-picker/stories/index.story.tsx b/packages/components/src/custom-gradient-picker/stories/index.story.tsx
index 94b1be9a505c79..3ecc69866e8f85 100644
--- a/packages/components/src/custom-gradient-picker/stories/index.story.tsx
+++ b/packages/components/src/custom-gradient-picker/stories/index.story.tsx
@@ -23,11 +23,6 @@ const meta: Meta< typeof CustomGradientPicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Mostly an internal component. Use `GradientPicker` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/custom-select-control-v2/stories/index.story.tsx b/packages/components/src/custom-select-control-v2/stories/index.story.tsx
index 34ca986271cf2e..b29b2f0acf90db 100644
--- a/packages/components/src/custom-select-control-v2/stories/index.story.tsx
+++ b/packages/components/src/custom-select-control-v2/stories/index.story.tsx
@@ -31,11 +31,6 @@ const meta: Meta< typeof CustomSelectControlV2 > = {
docs: {
source: { excludeDecorators: true },
},
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`. Continue using `CustomSelectControl` (v1) for now.',
- },
},
decorators: [
( Story ) => (
diff --git a/packages/components/src/custom-select-control/stories/index.story.tsx b/packages/components/src/custom-select-control/stories/index.story.tsx
index 1121943bfa829a..0c32f22f42528a 100644
--- a/packages/components/src/custom-select-control/stories/index.story.tsx
+++ b/packages/components/src/custom-select-control/stories/index.story.tsx
@@ -31,11 +31,6 @@ const meta: Meta< typeof CustomSelectControl > = {
docs: {
source: { excludeDecorators: true },
},
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`, but continue using for now.',
- },
},
decorators: [
( Story ) => (
diff --git a/packages/components/src/date-time/stories/date-time.story.tsx b/packages/components/src/date-time/stories/date-time.story.tsx
index b636c5cbb02481..35f17bc98dd266 100644
--- a/packages/components/src/date-time/stories/date-time.story.tsx
+++ b/packages/components/src/date-time/stories/date-time.story.tsx
@@ -25,11 +25,6 @@ const meta: Meta< typeof DateTimePicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Consider using a `TextControl` with `type="date"` or `type="datetime-local"` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/date-time/stories/date.story.tsx b/packages/components/src/date-time/stories/date.story.tsx
index 047685fffe5a37..0ecc281375afd3 100644
--- a/packages/components/src/date-time/stories/date.story.tsx
+++ b/packages/components/src/date-time/stories/date.story.tsx
@@ -25,11 +25,6 @@ const meta: Meta< typeof DatePicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Consider using a `TextControl` with `type="date"` or `type="datetime-local"` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/date-time/stories/time.story.tsx b/packages/components/src/date-time/stories/time.story.tsx
index 9174758f86f2a9..1c88944425fdfb 100644
--- a/packages/components/src/date-time/stories/time.story.tsx
+++ b/packages/components/src/date-time/stories/time.story.tsx
@@ -25,11 +25,6 @@ const meta: Meta< typeof TimePicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Consider using a `TextControl` with `type="date"` or `type="datetime-local"` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/disabled/stories/index.story.tsx b/packages/components/src/disabled/stories/index.story.tsx
index a61fc9dc365e09..1acc2af118ab3c 100644
--- a/packages/components/src/disabled/stories/index.story.tsx
+++ b/packages/components/src/disabled/stories/index.story.tsx
@@ -31,10 +31,6 @@ const meta: Meta< typeof Disabled > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
diff --git a/packages/components/src/divider/stories/index.story.tsx b/packages/components/src/divider/stories/index.story.tsx
index 124387f9f74217..ff8bf127a11b4d 100644
--- a/packages/components/src/divider/stories/index.story.tsx
+++ b/packages/components/src/divider/stories/index.story.tsx
@@ -36,11 +36,6 @@ const meta: Meta< typeof Divider > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/draggable/stories/index.story.tsx b/packages/components/src/draggable/stories/index.story.tsx
index caee23d005658b..b548b15327df03 100644
--- a/packages/components/src/draggable/stories/index.story.tsx
+++ b/packages/components/src/draggable/stories/index.story.tsx
@@ -39,11 +39,6 @@ const meta: Meta< typeof Draggable > = {
// clone's `position: fixed` resolution.
story: { inline: false, height: '250px' },
},
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'May be deprecated.',
- },
},
};
export default meta;
diff --git a/packages/components/src/drop-zone/stories/index.story.tsx b/packages/components/src/drop-zone/stories/index.story.tsx
index 9fe64a543b8e61..bfd33960f09b64 100644
--- a/packages/components/src/drop-zone/stories/index.story.tsx
+++ b/packages/components/src/drop-zone/stories/index.story.tsx
@@ -36,10 +36,6 @@ const meta: Meta< typeof DropZone > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/dropdown-menu/stories/index.story.tsx b/packages/components/src/dropdown-menu/stories/index.story.tsx
index 59bf900e987710..160a6942e93f28 100644
--- a/packages/components/src/dropdown-menu/stories/index.story.tsx
+++ b/packages/components/src/dropdown-menu/stories/index.story.tsx
@@ -30,11 +30,6 @@ const meta: Meta< typeof DropdownMenu > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'When building for the Gutenberg repo, use `Menu` instead. Otherwise, continue using for now.',
- },
},
args: {
onToggle: fn(),
diff --git a/packages/components/src/dropdown/stories/index.story.tsx b/packages/components/src/dropdown/stories/index.story.tsx
index 2eb43ce29e827b..a6f8d1d55f3aa1 100644
--- a/packages/components/src/dropdown/stories/index.story.tsx
+++ b/packages/components/src/dropdown/stories/index.story.tsx
@@ -42,10 +42,6 @@ const meta: Meta< typeof Dropdown > = {
controls: {
expanded: true,
},
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/duotone-picker/stories/duotone-picker.story.tsx b/packages/components/src/duotone-picker/stories/duotone-picker.story.tsx
index 38f2f1e1b3f4fa..097d8538c94de8 100644
--- a/packages/components/src/duotone-picker/stories/duotone-picker.story.tsx
+++ b/packages/components/src/duotone-picker/stories/duotone-picker.story.tsx
@@ -24,10 +24,6 @@ const meta: Meta< typeof DuotonePicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/duotone-picker/stories/duotone-swatch.story.tsx b/packages/components/src/duotone-picker/stories/duotone-swatch.story.tsx
index 844a965a23788e..3444a36aaf132b 100644
--- a/packages/components/src/duotone-picker/stories/duotone-swatch.story.tsx
+++ b/packages/components/src/duotone-picker/stories/duotone-swatch.story.tsx
@@ -14,10 +14,6 @@ const meta: Meta< typeof DuotoneSwatch > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/elevation/stories/index.story.tsx b/packages/components/src/elevation/stories/index.story.tsx
index d07ad0875bd680..b306873dcf42f7 100644
--- a/packages/components/src/elevation/stories/index.story.tsx
+++ b/packages/components/src/elevation/stories/index.story.tsx
@@ -21,11 +21,6 @@ const meta: Meta< typeof Elevation > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation. Use [elevation tokens](?path=/docs/foundations-design-language-elevation--page) from `@wordpress/base-styles` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/external-link/stories/index.story.tsx b/packages/components/src/external-link/stories/index.story.tsx
index e75ad39067a329..38d0d402690be3 100644
--- a/packages/components/src/external-link/stories/index.story.tsx
+++ b/packages/components/src/external-link/stories/index.story.tsx
@@ -20,11 +20,6 @@ const meta: Meta< typeof ExternalLink > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Link` from `@wordpress/ui` instead, with the `openInNewTab` prop set.',
- },
},
};
export default meta;
diff --git a/packages/components/src/flex/stories/index.story.tsx b/packages/components/src/flex/stories/index.story.tsx
index aa8d9b9c1b99f0..c03db0053a7104 100644
--- a/packages/components/src/flex/stories/index.story.tsx
+++ b/packages/components/src/flex/stories/index.story.tsx
@@ -31,11 +31,6 @@ const meta: Meta< typeof Flex > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation. For use cases not covered by `Stack` from `@wordpress/ui`, write your own CSS.',
- },
},
};
export default meta;
diff --git a/packages/components/src/focal-point-picker/stories/index.story.tsx b/packages/components/src/focal-point-picker/stories/index.story.tsx
index d0bb867cd03db0..7ece7076b64464 100644
--- a/packages/components/src/focal-point-picker/stories/index.story.tsx
+++ b/packages/components/src/focal-point-picker/stories/index.story.tsx
@@ -29,10 +29,6 @@ const meta: Meta< typeof FocalPointPicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/font-size-picker/stories/index.story.tsx b/packages/components/src/font-size-picker/stories/index.story.tsx
index b4a4790fc532ad..d215b4d8b13e4f 100644
--- a/packages/components/src/font-size-picker/stories/index.story.tsx
+++ b/packages/components/src/font-size-picker/stories/index.story.tsx
@@ -30,10 +30,6 @@ const meta: Meta< typeof FontSizePicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/form-file-upload/stories/index.story.tsx b/packages/components/src/form-file-upload/stories/index.story.tsx
index 237e158cebbca5..3caaac99f12731 100644
--- a/packages/components/src/form-file-upload/stories/index.story.tsx
+++ b/packages/components/src/form-file-upload/stories/index.story.tsx
@@ -26,10 +26,6 @@ const meta: Meta< typeof FormFileUpload > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/form-toggle/stories/index.story.tsx b/packages/components/src/form-toggle/stories/index.story.tsx
index c73678603db7fc..d36051cf8c1891 100644
--- a/packages/components/src/form-toggle/stories/index.story.tsx
+++ b/packages/components/src/form-toggle/stories/index.story.tsx
@@ -27,11 +27,6 @@ const meta: Meta< typeof FormToggle > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'For standard toggles with labels, use `ToggleControl` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/form-token-field/stories/index.story.tsx b/packages/components/src/form-token-field/stories/index.story.tsx
index 3c8f8b4b863464..ecc61f6d7f918c 100644
--- a/packages/components/src/form-token-field/stories/index.story.tsx
+++ b/packages/components/src/form-token-field/stories/index.story.tsx
@@ -32,11 +32,6 @@ const meta: Meta< typeof FormTokenField > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SearchableChipSelect` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/gradient-picker/stories/index.story.tsx b/packages/components/src/gradient-picker/stories/index.story.tsx
index 2f4b2e84a24423..e15f363949453d 100644
--- a/packages/components/src/gradient-picker/stories/index.story.tsx
+++ b/packages/components/src/gradient-picker/stories/index.story.tsx
@@ -22,10 +22,6 @@ const meta: Meta< typeof GradientPicker > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
args: {
onChange: fn(),
diff --git a/packages/components/src/grid/stories/index.story.tsx b/packages/components/src/grid/stories/index.story.tsx
index de3b88c99f1d19..fb9477f96d7f7e 100644
--- a/packages/components/src/grid/stories/index.story.tsx
+++ b/packages/components/src/grid/stories/index.story.tsx
@@ -36,11 +36,6 @@ const meta: Meta< typeof Grid > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation. Write your own CSS instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/guide/stories/index.story.tsx b/packages/components/src/guide/stories/index.story.tsx
index 31e5cef82a515b..910a7a47988f29 100644
--- a/packages/components/src/guide/stories/index.story.tsx
+++ b/packages/components/src/guide/stories/index.story.tsx
@@ -24,12 +24,6 @@ const meta: Meta< typeof Guide > = {
previousButtonText: { control: 'text' },
onFinish: { action: 'onFinish' },
},
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
- },
};
export default meta;
diff --git a/packages/components/src/h-stack/stories/index.story.tsx b/packages/components/src/h-stack/stories/index.story.tsx
index ffd92927c4eee2..4655da94ac04fb 100644
--- a/packages/components/src/h-stack/stories/index.story.tsx
+++ b/packages/components/src/h-stack/stories/index.story.tsx
@@ -74,11 +74,6 @@ const meta: Meta< typeof HStack > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Stack` from `@wordpress/ui` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/heading/stories/index.story.tsx b/packages/components/src/heading/stories/index.story.tsx
index fc21947d8e0ceb..37562b4ab38d29 100644
--- a/packages/components/src/heading/stories/index.story.tsx
+++ b/packages/components/src/heading/stories/index.story.tsx
@@ -29,11 +29,6 @@ const meta: Meta< typeof Heading > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Text` from `@wordpress/ui` instead, with the `render` prop set to the heading level element and the variant set to the visual heading size (e.g. ` } variant="heading-2xl">`).',
- },
},
};
export default meta;
diff --git a/packages/components/src/icon/stories/index.story.tsx b/packages/components/src/icon/stories/index.story.tsx
index 519794e669a53c..26c5ee540e34ab 100644
--- a/packages/components/src/icon/stories/index.story.tsx
+++ b/packages/components/src/icon/stories/index.story.tsx
@@ -10,11 +10,6 @@ const meta: Meta< typeof Icon > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'When rendering SVGs, use `Icon` from `@wordpress/ui` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/input-control/stories/index.story.tsx b/packages/components/src/input-control/stories/index.story.tsx
index 5951b2adcfdf06..23d7190ef96cb7 100644
--- a/packages/components/src/input-control/stories/index.story.tsx
+++ b/packages/components/src/input-control/stories/index.story.tsx
@@ -40,11 +40,6 @@ const meta: Meta< typeof InputControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `InputControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/item-group/stories/index.story.tsx b/packages/components/src/item-group/stories/index.story.tsx
index 6df45f45ff27a2..fec254c6059846 100644
--- a/packages/components/src/item-group/stories/index.story.tsx
+++ b/packages/components/src/item-group/stories/index.story.tsx
@@ -23,10 +23,6 @@ const meta: Meta< typeof ItemGroup > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/keyboard-shortcuts/stories/index.story.tsx b/packages/components/src/keyboard-shortcuts/stories/index.story.tsx
index b5a0674259cf4c..246519ee298fc9 100644
--- a/packages/components/src/keyboard-shortcuts/stories/index.story.tsx
+++ b/packages/components/src/keyboard-shortcuts/stories/index.story.tsx
@@ -16,10 +16,6 @@ const meta: Meta< typeof KeyboardShortcuts > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/menu-group/stories/index.story.tsx b/packages/components/src/menu-group/stories/index.story.tsx
index 01cc4975f1fd71..fc8106cd7394c4 100644
--- a/packages/components/src/menu-group/stories/index.story.tsx
+++ b/packages/components/src/menu-group/stories/index.story.tsx
@@ -26,11 +26,6 @@ const meta: Meta< typeof MenuGroup > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Subcomponent of `DropdownMenu`.',
- },
},
};
export default meta;
diff --git a/packages/components/src/menu-item/stories/index.story.tsx b/packages/components/src/menu-item/stories/index.story.tsx
index 0fbee59b6a1415..06271bb82dc9e4 100644
--- a/packages/components/src/menu-item/stories/index.story.tsx
+++ b/packages/components/src/menu-item/stories/index.story.tsx
@@ -37,11 +37,6 @@ const meta: Meta< typeof MenuItem > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Subcomponent of `DropdownMenu`.',
- },
},
};
export default meta;
diff --git a/packages/components/src/menu-items-choice/stories/index.story.tsx b/packages/components/src/menu-items-choice/stories/index.story.tsx
index ae0bcbbe5aa8c4..60fef6efc4ca17 100644
--- a/packages/components/src/menu-items-choice/stories/index.story.tsx
+++ b/packages/components/src/menu-items-choice/stories/index.story.tsx
@@ -29,11 +29,6 @@ const meta: Meta< typeof MenuItemsChoice > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Subcomponent of `DropdownMenu`.',
- },
},
};
export default meta;
diff --git a/packages/components/src/menu/stories/index.story.tsx b/packages/components/src/menu/stories/index.story.tsx
index 756a7cf8721935..ea540135a0417a 100644
--- a/packages/components/src/menu/stories/index.story.tsx
+++ b/packages/components/src/menu/stories/index.story.tsx
@@ -55,11 +55,6 @@ const meta: Meta< typeof Menu > = {
canvas: { sourceState: 'shown' },
source: { excludeDecorators: true },
},
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'When building for the Gutenberg repo, use this component instead of `DropdownMenu`. Otherwise, continue using `DropdownMenu` for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/modal/stories/index.story.tsx b/packages/components/src/modal/stories/index.story.tsx
index a27d3aa5027b64..0f9859e97f9aae 100644
--- a/packages/components/src/modal/stories/index.story.tsx
+++ b/packages/components/src/modal/stories/index.story.tsx
@@ -45,11 +45,6 @@ const meta: Meta< typeof Modal > = {
},
parameters: {
controls: { expanded: true },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `Dialog` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/navigable-container/stories/navigable-menu.story.tsx b/packages/components/src/navigable-container/stories/navigable-menu.story.tsx
index fe0a3057b39f00..8badbb0bff12a1 100644
--- a/packages/components/src/navigable-container/stories/navigable-menu.story.tsx
+++ b/packages/components/src/navigable-container/stories/navigable-menu.story.tsx
@@ -25,10 +25,6 @@ const meta: Meta< typeof NavigableMenu > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'unaudited',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/navigable-container/stories/tabbable-container.story.tsx b/packages/components/src/navigable-container/stories/tabbable-container.story.tsx
index 3469c40647d53f..641033a8545ab7 100644
--- a/packages/components/src/navigable-container/stories/tabbable-container.story.tsx
+++ b/packages/components/src/navigable-container/stories/tabbable-container.story.tsx
@@ -25,11 +25,6 @@ const meta: Meta< typeof TabbableContainer > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/navigator/stories/index.story.tsx b/packages/components/src/navigator/stories/index.story.tsx
index 7ba89126c2daf0..509634b1003eb9 100644
--- a/packages/components/src/navigator/stories/index.story.tsx
+++ b/packages/components/src/navigator/stories/index.story.tsx
@@ -29,10 +29,6 @@ const meta: Meta< typeof Navigator > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
decorators: [
( Story ) => {
diff --git a/packages/components/src/notice/stories/index.story.tsx b/packages/components/src/notice/stories/index.story.tsx
index 1afea0ab65fb8f..abbf2e29de516a 100644
--- a/packages/components/src/notice/stories/index.story.tsx
+++ b/packages/components/src/notice/stories/index.story.tsx
@@ -30,11 +30,6 @@ const meta: Meta< typeof Notice > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `Notice` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/number-control/stories/index.story.tsx b/packages/components/src/number-control/stories/index.story.tsx
index c9751e545fb13b..69f7b12d1b12d6 100644
--- a/packages/components/src/number-control/stories/index.story.tsx
+++ b/packages/components/src/number-control/stories/index.story.tsx
@@ -29,11 +29,6 @@ const meta: Meta< typeof NumberControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `InputControl` with `type="number"` in `@wordpress/ui`, but continue using for now.',
- },
},
};
diff --git a/packages/components/src/palette-edit/stories/index.story.tsx b/packages/components/src/palette-edit/stories/index.story.tsx
index dab12164ddf166..0d19372c7502b5 100644
--- a/packages/components/src/palette-edit/stories/index.story.tsx
+++ b/packages/components/src/palette-edit/stories/index.story.tsx
@@ -24,10 +24,6 @@ const meta: Meta< typeof PaletteEdit > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/panel/stories/index.story.tsx b/packages/components/src/panel/stories/index.story.tsx
index 76c2528b7ddb2c..832a78f77a457e 100644
--- a/packages/components/src/panel/stories/index.story.tsx
+++ b/packages/components/src/panel/stories/index.story.tsx
@@ -28,10 +28,6 @@ const meta: Meta< typeof Panel > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/placeholder/stories/index.story.tsx b/packages/components/src/placeholder/stories/index.story.tsx
index 5d0cf0da7869ae..d61efc4a3c11f1 100644
--- a/packages/components/src/placeholder/stories/index.story.tsx
+++ b/packages/components/src/placeholder/stories/index.story.tsx
@@ -33,10 +33,6 @@ const meta: Meta< typeof Placeholder > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/popover/stories/index.story.tsx b/packages/components/src/popover/stories/index.story.tsx
index a08f46f9aacfd1..ac0aa577c87e4e 100644
--- a/packages/components/src/popover/stories/index.story.tsx
+++ b/packages/components/src/popover/stories/index.story.tsx
@@ -56,10 +56,6 @@ const meta: Meta< typeof Popover > = {
},
parameters: {
controls: { expanded: true },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
diff --git a/packages/components/src/progress-bar/stories/index.story.tsx b/packages/components/src/progress-bar/stories/index.story.tsx
index b4347ceb30b55a..0060eee3325fa9 100644
--- a/packages/components/src/progress-bar/stories/index.story.tsx
+++ b/packages/components/src/progress-bar/stories/index.story.tsx
@@ -21,10 +21,6 @@ const meta: Meta< typeof ProgressBar > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/query-controls/stories/index.story.tsx b/packages/components/src/query-controls/stories/index.story.tsx
index 8fc0fe1bb3fdc0..193290cd7a7800 100644
--- a/packages/components/src/query-controls/stories/index.story.tsx
+++ b/packages/components/src/query-controls/stories/index.story.tsx
@@ -40,10 +40,6 @@ const meta: Meta< typeof QueryControls > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/radio-control/stories/index.story.tsx b/packages/components/src/radio-control/stories/index.story.tsx
index 916a9ac26a21a6..3bb3915cb78988 100644
--- a/packages/components/src/radio-control/stories/index.story.tsx
+++ b/packages/components/src/radio-control/stories/index.story.tsx
@@ -37,11 +37,6 @@ const meta: Meta< typeof RadioControl > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `RadioGroupControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/range-control/stories/index.story.tsx b/packages/components/src/range-control/stories/index.story.tsx
index 5f07b4db4adbfb..f7fcaa7afd9b59 100644
--- a/packages/components/src/range-control/stories/index.story.tsx
+++ b/packages/components/src/range-control/stories/index.story.tsx
@@ -58,11 +58,6 @@ const meta: Meta< typeof RangeControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SliderControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/resizable-box/stories/index.story.tsx b/packages/components/src/resizable-box/stories/index.story.tsx
index 8f948572c14c94..045f4ddde48d81 100644
--- a/packages/components/src/resizable-box/stories/index.story.tsx
+++ b/packages/components/src/resizable-box/stories/index.story.tsx
@@ -26,10 +26,6 @@ const meta: Meta< typeof ResizableBox > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/responsive-wrapper/stories/index.story.tsx b/packages/components/src/responsive-wrapper/stories/index.story.tsx
index a3e4099ad23e7c..50ff53c3810cf3 100644
--- a/packages/components/src/responsive-wrapper/stories/index.story.tsx
+++ b/packages/components/src/responsive-wrapper/stories/index.story.tsx
@@ -18,11 +18,6 @@ const meta: Meta< typeof ResponsiveWrapper > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/sandbox/stories/index.story.tsx b/packages/components/src/sandbox/stories/index.story.tsx
index 77ff4cbfa83b21..7ed2184a4f839c 100644
--- a/packages/components/src/sandbox/stories/index.story.tsx
+++ b/packages/components/src/sandbox/stories/index.story.tsx
@@ -23,10 +23,6 @@ const meta: Meta< typeof SandBox > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/scroll-lock/stories/index.story.tsx b/packages/components/src/scroll-lock/stories/index.story.tsx
index 4ad85c1544a25f..ccb52680cd209a 100644
--- a/packages/components/src/scroll-lock/stories/index.story.tsx
+++ b/packages/components/src/scroll-lock/stories/index.story.tsx
@@ -23,10 +23,6 @@ const meta: Meta< typeof ScrollLock > = {
parameters: {
controls: { hideNoControlsWarning: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/scrollable/stories/index.story.tsx b/packages/components/src/scrollable/stories/index.story.tsx
index b3caeef6ad3f98..784bf5ad7f0b7d 100644
--- a/packages/components/src/scrollable/stories/index.story.tsx
+++ b/packages/components/src/scrollable/stories/index.story.tsx
@@ -31,11 +31,6 @@ const meta: Meta< typeof Scrollable > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/search-control/stories/index.story.tsx b/packages/components/src/search-control/stories/index.story.tsx
index d881a467353b76..d5425652723409 100644
--- a/packages/components/src/search-control/stories/index.story.tsx
+++ b/packages/components/src/search-control/stories/index.story.tsx
@@ -25,11 +25,6 @@ const meta: Meta< typeof SearchControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SearchControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/select-control/stories/index.story.tsx b/packages/components/src/select-control/stories/index.story.tsx
index f77054ec83a6da..ab0bb8ee6e0d4b 100644
--- a/packages/components/src/select-control/stories/index.story.tsx
+++ b/packages/components/src/select-control/stories/index.story.tsx
@@ -33,11 +33,6 @@ const meta: Meta< typeof SelectControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/shortcut/stories/index.story.tsx b/packages/components/src/shortcut/stories/index.story.tsx
index caf9189bbeddfb..69418634747c3e 100644
--- a/packages/components/src/shortcut/stories/index.story.tsx
+++ b/packages/components/src/shortcut/stories/index.story.tsx
@@ -18,10 +18,6 @@ const meta: Meta< typeof Shortcut > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/slot-fill/stories/index.story.tsx b/packages/components/src/slot-fill/stories/index.story.tsx
index 1d8779bf907a66..a082cbce53d18f 100644
--- a/packages/components/src/slot-fill/stories/index.story.tsx
+++ b/packages/components/src/slot-fill/stories/index.story.tsx
@@ -27,10 +27,6 @@ const meta: Meta< typeof Slot > = {
parameters: {
controls: { expanded: true },
docs: { source: { state: 'open' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
diff --git a/packages/components/src/snackbar/stories/index.story.tsx b/packages/components/src/snackbar/stories/index.story.tsx
index 115f4382abf4a7..c5bfe3967b6eb2 100644
--- a/packages/components/src/snackbar/stories/index.story.tsx
+++ b/packages/components/src/snackbar/stories/index.story.tsx
@@ -38,10 +38,6 @@ const meta: Meta< typeof Snackbar > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/spacer/stories/index.story.tsx b/packages/components/src/spacer/stories/index.story.tsx
index 267b2260d6f1a6..88b6b8ab05574c 100644
--- a/packages/components/src/spacer/stories/index.story.tsx
+++ b/packages/components/src/spacer/stories/index.story.tsx
@@ -45,11 +45,6 @@ const meta: Meta< typeof Spacer > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/spinner/stories/index.story.tsx b/packages/components/src/spinner/stories/index.story.tsx
index 1dc984286753bf..ea7b2f8dbbba6f 100644
--- a/packages/components/src/spinner/stories/index.story.tsx
+++ b/packages/components/src/spinner/stories/index.story.tsx
@@ -19,10 +19,6 @@ const meta: Meta< typeof Spinner > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/surface/stories/index.story.tsx b/packages/components/src/surface/stories/index.story.tsx
index 7cdbcdf5700c67..4dc8885ad86651 100644
--- a/packages/components/src/surface/stories/index.story.tsx
+++ b/packages/components/src/surface/stories/index.story.tsx
@@ -22,11 +22,6 @@ const meta: Meta< typeof Surface > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/tab-panel/stories/index.story.tsx b/packages/components/src/tab-panel/stories/index.story.tsx
index 00bf3d6cd034f8..8410da12b0a726 100644
--- a/packages/components/src/tab-panel/stories/index.story.tsx
+++ b/packages/components/src/tab-panel/stories/index.story.tsx
@@ -10,11 +10,6 @@ const meta: Meta< typeof TabPanel > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Tabs` from `@wordpress/ui` instead.',
- },
},
args: {
onSelect: fn(),
diff --git a/packages/components/src/tabs/stories/index.story.tsx b/packages/components/src/tabs/stories/index.story.tsx
index 1fbf8a08c45c99..e4fec8484c1c49 100644
--- a/packages/components/src/tabs/stories/index.story.tsx
+++ b/packages/components/src/tabs/stories/index.story.tsx
@@ -23,11 +23,6 @@ const meta: Meta< typeof Tabs > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Tabs` from `@wordpress/ui` instead.',
- },
},
args: {
onActiveTabIdChange: fn(),
diff --git a/packages/components/src/text-control/stories/index.story.tsx b/packages/components/src/text-control/stories/index.story.tsx
index b27aed98abdea0..aa16ad518039f0 100644
--- a/packages/components/src/text-control/stories/index.story.tsx
+++ b/packages/components/src/text-control/stories/index.story.tsx
@@ -29,11 +29,6 @@ const meta: Meta< typeof TextControl > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Prefer `InputControl` when placing buttons or icons in the prefix/suffix slots.',
- },
},
};
export default meta;
diff --git a/packages/components/src/text-highlight/stories/index.story.tsx b/packages/components/src/text-highlight/stories/index.story.tsx
index 78a7d758428eba..6563b1c12fc882 100644
--- a/packages/components/src/text-highlight/stories/index.story.tsx
+++ b/packages/components/src/text-highlight/stories/index.story.tsx
@@ -18,10 +18,6 @@ const meta: Meta< typeof TextHighlight > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/text/stories/index.story.tsx b/packages/components/src/text/stories/index.story.tsx
index 67241ea56d035c..f3578d32984286 100644
--- a/packages/components/src/text/stories/index.story.tsx
+++ b/packages/components/src/text/stories/index.story.tsx
@@ -30,11 +30,6 @@ const meta: Meta< typeof Text > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Text` from `@wordpress/ui` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/textarea-control/stories/index.story.tsx b/packages/components/src/textarea-control/stories/index.story.tsx
index b802fd875969f1..de5ffdb10744ce 100644
--- a/packages/components/src/textarea-control/stories/index.story.tsx
+++ b/packages/components/src/textarea-control/stories/index.story.tsx
@@ -32,11 +32,6 @@ const meta: Meta< typeof TextareaControl > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `TextareaControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/theme/stories/index.story.tsx b/packages/components/src/theme/stories/index.story.tsx
index 4c386f4987e36c..e835978d800e7d 100644
--- a/packages/components/src/theme/stories/index.story.tsx
+++ b/packages/components/src/theme/stories/index.story.tsx
@@ -23,11 +23,6 @@ const meta: Meta< typeof Theme > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'This is an internal experiment and not meant for external use. Will be superseded by `@wordpress/theme`.',
- },
},
};
export default meta;
diff --git a/packages/components/src/tip/stories/index.story.tsx b/packages/components/src/tip/stories/index.story.tsx
index 8149ec65866a7f..6ec101591b864d 100644
--- a/packages/components/src/tip/stories/index.story.tsx
+++ b/packages/components/src/tip/stories/index.story.tsx
@@ -20,10 +20,6 @@ const meta: Meta< typeof Tip > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'unaudited',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/toggle-control/stories/index.story.tsx b/packages/components/src/toggle-control/stories/index.story.tsx
index ca834aca78f3ef..f43747b6efabb3 100644
--- a/packages/components/src/toggle-control/stories/index.story.tsx
+++ b/packages/components/src/toggle-control/stories/index.story.tsx
@@ -27,11 +27,6 @@ const meta: Meta< typeof ToggleControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `ToggleControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/toggle-group-control/stories/index.story.tsx b/packages/components/src/toggle-group-control/stories/index.story.tsx
index 2856668ee19d1d..2f2d54d434a32f 100644
--- a/packages/components/src/toggle-group-control/stories/index.story.tsx
+++ b/packages/components/src/toggle-group-control/stories/index.story.tsx
@@ -37,11 +37,6 @@ const meta: Meta< typeof ToggleGroupControl > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Will be superseded by `ToggleGroupControl` in `@wordpress/ui`, but continue using for now.',
- },
},
};
export default meta;
diff --git a/packages/components/src/toolbar/stories/index.story.tsx b/packages/components/src/toolbar/stories/index.story.tsx
index 6506fb2aea9b88..32f4c750b59cc6 100644
--- a/packages/components/src/toolbar/stories/index.story.tsx
+++ b/packages/components/src/toolbar/stories/index.story.tsx
@@ -56,10 +56,6 @@ const meta: Meta< typeof Toolbar > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
diff --git a/packages/components/src/tools-panel/stories/index.story.tsx b/packages/components/src/tools-panel/stories/index.story.tsx
index a21c1730fb863e..78f03b75cac2de 100644
--- a/packages/components/src/tools-panel/stories/index.story.tsx
+++ b/packages/components/src/tools-panel/stories/index.story.tsx
@@ -45,10 +45,6 @@ const meta: Meta< typeof ToolsPanel > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'editor',
- },
},
};
export default meta;
diff --git a/packages/components/src/tooltip/stories/index.story.tsx b/packages/components/src/tooltip/stories/index.story.tsx
index 265af6492e81d4..6b556b00ceb610 100644
--- a/packages/components/src/tooltip/stories/index.story.tsx
+++ b/packages/components/src/tooltip/stories/index.story.tsx
@@ -37,10 +37,6 @@ const meta: Meta< typeof Tooltip > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/tree-grid/stories/index.story.tsx b/packages/components/src/tree-grid/stories/index.story.tsx
index 6b46a00ec88c22..61738d4423255b 100644
--- a/packages/components/src/tree-grid/stories/index.story.tsx
+++ b/packages/components/src/tree-grid/stories/index.story.tsx
@@ -32,10 +32,6 @@ const meta: Meta< typeof TreeGrid > = {
},
parameters: {
controls: { expanded: true },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/tree-select/stories/index.story.tsx b/packages/components/src/tree-select/stories/index.story.tsx
index c69b4a5d79aeff..f9e17733b2b86e 100644
--- a/packages/components/src/tree-select/stories/index.story.tsx
+++ b/packages/components/src/tree-select/stories/index.story.tsx
@@ -30,10 +30,6 @@ const meta: Meta< typeof TreeSelect > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
diff --git a/packages/components/src/truncate/stories/index.story.tsx b/packages/components/src/truncate/stories/index.story.tsx
index 3566f3c8f02a2f..7b222cf521f3df 100644
--- a/packages/components/src/truncate/stories/index.story.tsx
+++ b/packages/components/src/truncate/stories/index.story.tsx
@@ -22,10 +22,6 @@ const meta: Meta< typeof Truncate > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/unit-control/stories/index.story.tsx b/packages/components/src/unit-control/stories/index.story.tsx
index 35a80e314d68e7..4929bf4404be0a 100644
--- a/packages/components/src/unit-control/stories/index.story.tsx
+++ b/packages/components/src/unit-control/stories/index.story.tsx
@@ -39,10 +39,6 @@ const meta: Meta< typeof UnitControl > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
},
};
export default meta;
diff --git a/packages/components/src/v-stack/stories/index.story.tsx b/packages/components/src/v-stack/stories/index.story.tsx
index e39d17d4cd5468..9ecfc97459c8ea 100644
--- a/packages/components/src/v-stack/stories/index.story.tsx
+++ b/packages/components/src/v-stack/stories/index.story.tsx
@@ -42,11 +42,6 @@ const meta: Meta< typeof VStack > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `Stack` from `@wordpress/ui` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/view/stories/index.story.tsx b/packages/components/src/view/stories/index.story.tsx
index 7bc0bddcd37233..23173204988f5d 100644
--- a/packages/components/src/view/stories/index.story.tsx
+++ b/packages/components/src/view/stories/index.story.tsx
@@ -19,11 +19,6 @@ const meta: Meta< typeof View > = {
parameters: {
controls: { expanded: true },
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation.',
- },
},
};
export default meta;
diff --git a/packages/components/src/visually-hidden/stories/index.story.tsx b/packages/components/src/visually-hidden/stories/index.story.tsx
index 0439a598e4369c..b28ff1af390ad2 100644
--- a/packages/components/src/visually-hidden/stories/index.story.tsx
+++ b/packages/components/src/visually-hidden/stories/index.story.tsx
@@ -14,11 +14,6 @@ const meta: Meta< typeof VisuallyHidden > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Use `VisuallyHidden` from `@wordpress/ui` instead.',
- },
},
};
export default meta;
diff --git a/packages/components/src/z-stack/stories/index.story.tsx b/packages/components/src/z-stack/stories/index.story.tsx
index 4607c83aa92287..307c8eae67424d 100644
--- a/packages/components/src/z-stack/stories/index.story.tsx
+++ b/packages/components/src/z-stack/stories/index.story.tsx
@@ -24,11 +24,6 @@ const meta: Meta< typeof ZStack > = {
expanded: true,
},
docs: { canvas: { sourceState: 'shown' } },
- componentStatus: {
- status: 'not-recommended',
- whereUsed: 'global',
- notes: 'Planned for deprecation. Write your own CSS instead.',
- },
},
};
export default meta;
diff --git a/packages/grid/src/dashboard-grid/stories/index.story.tsx b/packages/grid/src/dashboard-grid/stories/index.story.tsx
index 0a208685bb1ffc..fd56f6f21d66d7 100644
--- a/packages/grid/src/dashboard-grid/stories/index.story.tsx
+++ b/packages/grid/src/dashboard-grid/stories/index.story.tsx
@@ -54,13 +54,6 @@ const meta: Meta< typeof DashboardGrid > = {
onChangeLayout: { action: 'onChangeLayout' },
onPreviewLayout: { action: 'onPreviewLayout' },
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'This package is under heavy development and likely to change.',
- },
- },
};
export default meta;
diff --git a/packages/grid/src/dashboard-lanes/stories/index.story.tsx b/packages/grid/src/dashboard-lanes/stories/index.story.tsx
index 1a644cc93c3f33..19e20e2a55bb17 100644
--- a/packages/grid/src/dashboard-lanes/stories/index.story.tsx
+++ b/packages/grid/src/dashboard-lanes/stories/index.story.tsx
@@ -53,13 +53,6 @@ const meta: Meta< typeof DashboardLanes > = {
onChangeLayout: { action: 'onChangeLayout' },
onPreviewLayout: { action: 'onPreviewLayout' },
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'This package is under heavy development and likely to change.',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/alert-dialog/stories/index.story.tsx b/packages/ui/src/alert-dialog/stories/index.story.tsx
index bd8261723e1f58..157f8734b51ac7 100644
--- a/packages/ui/src/alert-dialog/stories/index.story.tsx
+++ b/packages/ui/src/alert-dialog/stories/index.story.tsx
@@ -19,13 +19,6 @@ const meta: Meta< typeof AlertDialog.Root > = {
onConfirm: { action: fn() },
onOpenChange: { action: fn() },
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/badge/stories/index.story.tsx b/packages/ui/src/badge/stories/index.story.tsx
index 8167e2b2caacc4..30139480d481e8 100644
--- a/packages/ui/src/badge/stories/index.story.tsx
+++ b/packages/ui/src/badge/stories/index.story.tsx
@@ -6,12 +6,6 @@ const meta: Meta< typeof Badge > = {
tags: [ 'manifest' ],
title: 'Design System/Components/Badge',
component: Badge,
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/button/stories/index.story.tsx b/packages/ui/src/button/stories/index.story.tsx
index 1d7cd1e78cba9f..333b4f9a30e21c 100644
--- a/packages/ui/src/button/stories/index.story.tsx
+++ b/packages/ui/src/button/stories/index.story.tsx
@@ -14,13 +14,6 @@ const meta: Meta< typeof Button > = {
control: { type: 'boolean' },
},
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and text overflow behavior. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/card/stories/index.story.tsx b/packages/ui/src/card/stories/index.story.tsx
index 5041ef0cbb3b2f..f81517ee83eaa5 100644
--- a/packages/ui/src/card/stories/index.story.tsx
+++ b/packages/ui/src/card/stories/index.story.tsx
@@ -34,12 +34,6 @@ const meta: Meta< typeof Card.Root > = {
'Card.FullBleed': Card.FullBleed,
'Card.Title': Card.Title,
},
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/collapsible-card/stories/index.story.tsx b/packages/ui/src/collapsible-card/stories/index.story.tsx
index 4e919811612179..a4b19c9426ae04 100644
--- a/packages/ui/src/collapsible-card/stories/index.story.tsx
+++ b/packages/ui/src/collapsible-card/stories/index.story.tsx
@@ -35,12 +35,6 @@ const meta: Meta< typeof CollapsibleCard.Root > = {
'CollapsibleCard.Content': CollapsibleCard.Content,
'Card.FullBleed': Card.FullBleed,
},
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/collapsible/stories/index.story.tsx b/packages/ui/src/collapsible/stories/index.story.tsx
index 730c583553daa9..79737eab494fc1 100644
--- a/packages/ui/src/collapsible/stories/index.story.tsx
+++ b/packages/ui/src/collapsible/stories/index.story.tsx
@@ -10,12 +10,6 @@ const meta: Meta< typeof Collapsible.Root > = {
'Collapsible.Trigger': Collapsible.Trigger,
'Collapsible.Panel': Collapsible.Panel,
},
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/dialog/stories/index.story.tsx b/packages/ui/src/dialog/stories/index.story.tsx
index 551c21739bc7d1..2766e60ff46f11 100644
--- a/packages/ui/src/dialog/stories/index.story.tsx
+++ b/packages/ui/src/dialog/stories/index.story.tsx
@@ -26,13 +26,6 @@ const meta: Meta< typeof Dialog.Root > = {
options: [ true, false, 'trap-focus' ],
},
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/drawer/stories/index.story.tsx b/packages/ui/src/drawer/stories/index.story.tsx
index 657fb35f64e06a..df879bc75a828b 100644
--- a/packages/ui/src/drawer/stories/index.story.tsx
+++ b/packages/ui/src/drawer/stories/index.story.tsx
@@ -25,13 +25,6 @@ const meta: Meta< typeof Drawer.Root > = {
options: [ true, false, 'trap-focus' ],
},
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/empty-state/stories/index.story.tsx b/packages/ui/src/empty-state/stories/index.story.tsx
index cd6ff2d5914569..4ab8bcb9cdabaa 100644
--- a/packages/ui/src/empty-state/stories/index.story.tsx
+++ b/packages/ui/src/empty-state/stories/index.story.tsx
@@ -14,12 +14,6 @@ const meta: Meta< typeof EmptyState.Root > = {
'EmptyState.Description': EmptyState.Description,
'EmptyState.Actions': EmptyState.Actions,
},
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/input-control/stories/index.story.tsx b/packages/ui/src/form/input-control/stories/index.story.tsx
index cf43702dc020d6..afe1b49eddab7d 100644
--- a/packages/ui/src/form/input-control/stories/index.story.tsx
+++ b/packages/ui/src/form/input-control/stories/index.story.tsx
@@ -23,13 +23,6 @@ const meta: Meta< typeof InputControl > = {
value: { control: false },
type: { control: 'text' },
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/autocomplete/stories/index.story.tsx b/packages/ui/src/form/primitives/autocomplete/stories/index.story.tsx
index 4a3253a385f5df..d9cedd042f8a10 100644
--- a/packages/ui/src/form/primitives/autocomplete/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/autocomplete/stories/index.story.tsx
@@ -25,13 +25,6 @@ const meta: Meta< typeof Autocomplete.Root > = {
'Autocomplete.Empty': Autocomplete.Empty,
'Autocomplete.Clear': Autocomplete.Clear,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, overlays compatibility, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/field/stories/index.story.tsx b/packages/ui/src/form/primitives/field/stories/index.story.tsx
index 22d278501b12e9..00f51c918bbcae 100644
--- a/packages/ui/src/form/primitives/field/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/field/stories/index.story.tsx
@@ -13,13 +13,6 @@ const meta: Meta< typeof Field.Root > = {
'Field.Description': Field.Description,
'Field.Details': Field.Details,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/fieldset/stories/index.story.tsx b/packages/ui/src/form/primitives/fieldset/stories/index.story.tsx
index 3ca119c6e69fcb..fddc7daa082d94 100644
--- a/packages/ui/src/form/primitives/fieldset/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/fieldset/stories/index.story.tsx
@@ -10,13 +10,6 @@ const meta: Meta< typeof Fieldset.Root > = {
'Fieldset.Description': Fieldset.Description,
'Fieldset.Details': Fieldset.Details,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/input-layout/stories/index.story.tsx b/packages/ui/src/form/primitives/input-layout/stories/index.story.tsx
index b7dd1a964a9add..8c023b8ee6e421 100644
--- a/packages/ui/src/form/primitives/input-layout/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/input-layout/stories/index.story.tsx
@@ -9,13 +9,6 @@ const meta: Meta< typeof InputLayout > = {
subcomponents: {
'InputLayout.Slot': InputLayout.Slot,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/input/stories/index.story.tsx b/packages/ui/src/form/primitives/input/stories/index.story.tsx
index 0b8e61822d89af..cc2952596a15d8 100644
--- a/packages/ui/src/form/primitives/input/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/input/stories/index.story.tsx
@@ -12,13 +12,6 @@ const meta: Meta< typeof Input > = {
value: { control: false },
type: { control: 'text' },
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/select/stories/index.story.tsx b/packages/ui/src/form/primitives/select/stories/index.story.tsx
index 7f71dfd86766ff..e621a05bf37fc9 100644
--- a/packages/ui/src/form/primitives/select/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/select/stories/index.story.tsx
@@ -11,13 +11,6 @@ const meta: Meta< typeof Select.Root > = {
'Select.Popup': Select.Popup,
'Select.Item': Select.Item,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, overlays compatibility, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/form/primitives/textarea/stories/index.story.tsx b/packages/ui/src/form/primitives/textarea/stories/index.story.tsx
index 22f2deb991edc5..24479466b4e83c 100644
--- a/packages/ui/src/form/primitives/textarea/stories/index.story.tsx
+++ b/packages/ui/src/form/primitives/textarea/stories/index.story.tsx
@@ -4,13 +4,6 @@ import { Textarea } from '../index';
const meta: Meta< typeof Textarea > = {
title: 'Design System/Components/Form/Primitives/Textarea',
component: Textarea,
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/icon-button/stories/index.story.tsx b/packages/ui/src/icon-button/stories/index.story.tsx
index 3eae2476cfc1b8..992c6b141e5b9a 100644
--- a/packages/ui/src/icon-button/stories/index.story.tsx
+++ b/packages/ui/src/icon-button/stories/index.story.tsx
@@ -21,13 +21,6 @@ const meta: Meta< typeof IconButton > = {
control: { type: 'boolean' },
},
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, text overflow behavior, and overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/icon/stories/index.story.tsx b/packages/ui/src/icon/stories/index.story.tsx
index e91387b257f8f2..a0cfd7b68f211a 100644
--- a/packages/ui/src/icon/stories/index.story.tsx
+++ b/packages/ui/src/icon/stories/index.story.tsx
@@ -19,13 +19,6 @@ const meta: Meta< typeof Icon > = {
);
},
],
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- notes: 'Prefer this component over the `Icon` component from `@wordpress/components` or `@wordpress/icons`.',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/link/stories/index.story.tsx b/packages/ui/src/link/stories/index.story.tsx
index 73bef5e2015197..b48358e0033cfa 100644
--- a/packages/ui/src/link/stories/index.story.tsx
+++ b/packages/ui/src/link/stories/index.story.tsx
@@ -7,12 +7,6 @@ const meta: Meta< typeof Link > = {
title: 'Design System/Components/Link',
component: Link,
tags: [ 'manifest' ],
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/notice/stories/index.story.tsx b/packages/ui/src/notice/stories/index.story.tsx
index e047056accc67b..cf1b7ed36b92ed 100644
--- a/packages/ui/src/notice/stories/index.story.tsx
+++ b/packages/ui/src/notice/stories/index.story.tsx
@@ -12,13 +12,6 @@ const meta: Meta< typeof Notice.Root > = {
'Notice.ActionButton': Notice.ActionButton,
'Notice.ActionLink': Notice.ActionLink,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/popover/stories/index.story.tsx b/packages/ui/src/popover/stories/index.story.tsx
index d10c3d47ba04b9..ed621765a23143 100644
--- a/packages/ui/src/popover/stories/index.story.tsx
+++ b/packages/ui/src/popover/stories/index.story.tsx
@@ -23,13 +23,6 @@ const meta: Meta< typeof Popover.Root > = {
argTypes: {
children: { control: false },
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/stack/stories/index.story.tsx b/packages/ui/src/stack/stories/index.story.tsx
index 1624c9055ab083..46b0bbf50917d0 100644
--- a/packages/ui/src/stack/stories/index.story.tsx
+++ b/packages/ui/src/stack/stories/index.story.tsx
@@ -5,12 +5,6 @@ const meta: Meta< typeof Stack > = {
tags: [ 'manifest' ],
title: 'Design System/Components/Stack',
component: Stack,
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/tabs/stories/index.story.tsx b/packages/ui/src/tabs/stories/index.story.tsx
index 6af00adb79c2dc..db5b6572220478 100644
--- a/packages/ui/src/tabs/stories/index.story.tsx
+++ b/packages/ui/src/tabs/stories/index.story.tsx
@@ -13,12 +13,6 @@ const meta: Meta< typeof Tabs.Root > = {
'Tabs.Tab': Tabs.Tab,
'Tabs.Panel': Tabs.Panel,
},
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/text/stories/index.story.tsx b/packages/ui/src/text/stories/index.story.tsx
index 158ad85cbedbe6..3907c96c743c07 100644
--- a/packages/ui/src/text/stories/index.story.tsx
+++ b/packages/ui/src/text/stories/index.story.tsx
@@ -6,12 +6,6 @@ const meta: Meta< typeof Text > = {
tags: [ 'manifest' ],
title: 'Design System/Components/Text',
component: Text,
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/tooltip/stories/index.story.tsx b/packages/ui/src/tooltip/stories/index.story.tsx
index c73ffa4dd8f4b1..65ab09914488d0 100644
--- a/packages/ui/src/tooltip/stories/index.story.tsx
+++ b/packages/ui/src/tooltip/stories/index.story.tsx
@@ -13,13 +13,6 @@ const meta: Meta< typeof Tooltip.Root > = {
'Tooltip.Positioner': Tooltip.Positioner,
'Tooltip.Portal': Tooltip.Portal,
},
- parameters: {
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
- },
};
export default meta;
diff --git a/packages/ui/src/tooltip/stories/usage-guidelines.story.tsx b/packages/ui/src/tooltip/stories/usage-guidelines.story.tsx
index 26fe3d45d33a44..222e29734ff3ba 100644
--- a/packages/ui/src/tooltip/stories/usage-guidelines.story.tsx
+++ b/packages/ui/src/tooltip/stories/usage-guidelines.story.tsx
@@ -15,11 +15,6 @@ const meta: Meta = {
title: 'Design System/Components/Tooltip/Usage Guidelines',
parameters: {
controls: { disable: true },
- componentStatus: {
- status: 'use-with-caution',
- whereUsed: 'global',
- notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
- },
},
tags: [ '!dev' ],
};
diff --git a/packages/ui/src/visually-hidden/stories/index.story.tsx b/packages/ui/src/visually-hidden/stories/index.story.tsx
index f6ca16423a95e8..b630b6ecf2e0ff 100644
--- a/packages/ui/src/visually-hidden/stories/index.story.tsx
+++ b/packages/ui/src/visually-hidden/stories/index.story.tsx
@@ -6,12 +6,6 @@ const meta: Meta< typeof VisuallyHidden > = {
tags: [ 'manifest' ],
title: 'Design System/Components/VisuallyHidden',
component: VisuallyHidden,
- parameters: {
- componentStatus: {
- status: 'recommended',
- whereUsed: 'global',
- },
- },
};
export default meta;
diff --git a/storybook/component-status.ts b/storybook/component-status.ts
new file mode 100644
index 00000000000000..2ce6e95a6c506f
--- /dev/null
+++ b/storybook/component-status.ts
@@ -0,0 +1,695 @@
+import type { PreparedStory } from 'storybook/internal/types';
+
+export type ComponentStatusValue =
+ | 'recommended'
+ | 'use-with-caution'
+ | 'not-recommended'
+ | 'unaudited';
+
+export type ComponentStatus = {
+ status: ComponentStatusValue;
+ whereUsed: 'global' | 'editor';
+ notes?: string;
+};
+
+/**
+ * Central registry of stability metadata for design system components.
+ *
+ * These are used in the Storybook UI to indicate the stability of a component
+ * and any notes about its use.
+ *
+ * To update a component's status or include a new component as part of the
+ * design system, include or update an entry in the object.
+ */
+export const COMPONENT_STATUS = {
+ '@wordpress/components': {
+ AlignmentMatrixControl: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ AnglePickerControl: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ Animate: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ Badge: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `Badge` in `@wordpress/ui`, but continue using for now.',
+ },
+ BaseControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `Field` in `@wordpress/ui`, but continue using for now.',
+ },
+ BorderBoxControl: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ BorderControl: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ BoxControl: {
+ status: 'use-with-caution',
+ whereUsed: 'editor',
+ notes: 'This component is a fallback for themes that do not supply spacing presets. Most of the time `SpacingSizesControl` from `@wordpress/block-editor` is used instead.',
+ },
+ Button: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `Button` in `@wordpress/ui`, but continue using for now.',
+ },
+ Card: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Card` or `CollapsibleCard` from `@wordpress/ui` instead.',
+ },
+ CheckboxControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `CheckboxControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ CircularOptionPicker: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Mostly intended for internal use.',
+ },
+ ColorIndicator: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ColorPalette: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ColorPicker: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ComboboxControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SearchableSelectControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ Composite: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ConfirmDialog: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ CustomGradientPicker: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Mostly an internal component. Use `GradientPicker` instead.',
+ },
+ CustomSelectControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ CustomSelectControlV2: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`. Continue using `CustomSelectControl` (v1) for now.',
+ },
+ DatePicker: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Consider using a `TextControl` with `type="date"` or `type="datetime-local"` instead.',
+ },
+ DateTimePicker: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Consider using a `TextControl` with `type="date"` or `type="datetime-local"` instead.',
+ },
+ Disabled: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Divider: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ Draggable: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'May be deprecated.',
+ },
+ DropZone: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Dropdown: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ DropdownMenu: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'When building for the Gutenberg repo, use `Menu` instead. Otherwise, continue using for now.',
+ },
+ DuotonePicker: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ DuotoneSwatch: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ Elevation: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation. Use [elevation tokens](?path=/docs/foundations-design-language-elevation--page) from `@wordpress/base-styles` instead.',
+ },
+ ExternalLink: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Link` from `@wordpress/ui` instead, with the `openInNewTab` prop set.',
+ },
+ Flex: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation. For use cases not covered by `Stack` from `@wordpress/ui`, write your own CSS.',
+ },
+ FocalPointPicker: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ FontSizePicker: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ FormFileUpload: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ FormToggle: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'For standard toggles with labels, use `ToggleControl` instead.',
+ },
+ FormTokenField: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SearchableChipSelect` in `@wordpress/ui`, but continue using for now.',
+ },
+ GradientPicker: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Grid: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation. Write your own CSS instead.',
+ },
+ Guide: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ HStack: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Stack` from `@wordpress/ui` instead.',
+ },
+ Heading: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Text` from `@wordpress/ui` instead, with the `render` prop set to the heading level element and the variant set to the visual heading size (e.g. ` } variant="heading-2xl">`).',
+ },
+ Icon: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'When rendering SVGs, use `Icon` from `@wordpress/ui` instead.',
+ },
+ InputControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `InputControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ ItemGroup: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ KeyboardShortcuts: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Menu: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'When building for the Gutenberg repo, use this component instead of `DropdownMenu`. Otherwise, continue using `DropdownMenu` for now.',
+ },
+ MenuGroup: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Subcomponent of `DropdownMenu`.',
+ },
+ MenuItem: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Subcomponent of `DropdownMenu`.',
+ },
+ MenuItemsChoice: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Subcomponent of `DropdownMenu`.',
+ },
+ Modal: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `Dialog` in `@wordpress/ui`, but continue using for now.',
+ },
+ NavigableMenu: {
+ status: 'unaudited',
+ whereUsed: 'global',
+ },
+ Navigator: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Notice: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `Notice` in `@wordpress/ui`, but continue using for now.',
+ },
+ NumberControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `InputControl` with `type="number"` in `@wordpress/ui`, but continue using for now.',
+ },
+ PaletteEdit: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ Panel: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Placeholder: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ Popover: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ProgressBar: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ QueryControls: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ RadioControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `RadioGroupControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ RangeControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SliderControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ ResizableBox: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ResponsiveWrapper: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ SandBox: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ ScrollLock: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Scrollable: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ SearchControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SearchControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ SelectControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `SelectControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ Shortcut: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ SlotFill: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Snackbar: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Spacer: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ Spinner: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Surface: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ TabPanel: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Tabs` from `@wordpress/ui` instead.',
+ },
+ TabbableContainer: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ Tabs: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Tabs` from `@wordpress/ui` instead.',
+ },
+ Text: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Text` from `@wordpress/ui` instead.',
+ },
+ TextControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Prefer `InputControl` when placing buttons or icons in the prefix/suffix slots.',
+ },
+ TextHighlight: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ TextareaControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `TextareaControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ Theme: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'This is an internal experiment and not meant for external use. Will be superseded by `@wordpress/theme`.',
+ },
+ TimePicker: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Consider using a `TextControl` with `type="date"` or `type="datetime-local"` instead.',
+ },
+ Tip: {
+ status: 'unaudited',
+ whereUsed: 'global',
+ },
+ ToggleControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `ToggleControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ ToggleGroupControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Will be superseded by `ToggleGroupControl` in `@wordpress/ui`, but continue using for now.',
+ },
+ Toolbar: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ ToolsPanel: {
+ status: 'recommended',
+ whereUsed: 'editor',
+ },
+ Tooltip: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ TreeGrid: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ TreeSelect: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Truncate: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ UnitControl: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ VStack: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `Stack` from `@wordpress/ui` instead.',
+ },
+ View: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation.',
+ },
+ VisuallyHidden: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Use `VisuallyHidden` from `@wordpress/ui` instead.',
+ },
+ ZStack: {
+ status: 'not-recommended',
+ whereUsed: 'global',
+ notes: 'Planned for deprecation. Write your own CSS instead.',
+ },
+ },
+ '@wordpress/grid': {
+ DashboardGrid: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'This package is under heavy development and likely to change.',
+ },
+ DashboardLanes: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'This package is under heavy development and likely to change.',
+ },
+ },
+ '@wordpress/ui': {
+ AlertDialog: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Autocomplete: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, overlays compatibility, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Badge: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Button: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and text overflow behavior. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Card: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Collapsible: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ CollapsibleCard: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Dialog: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Drawer: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ EmptyState: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Field: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Fieldset: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Icon: {
+ status: 'recommended',
+ whereUsed: 'global',
+ notes: 'Prefer this component over the `Icon` component from `@wordpress/components` or `@wordpress/icons`.',
+ },
+ IconButton: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, text overflow behavior, and overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Input: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ InputControl: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ InputLayout: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Link: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Notice: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Popover: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Select: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components`, overlays compatibility, and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Stack: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Tabs: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Text: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ Textarea: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of style consistency with `@wordpress/components` and component set completeness. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ Tooltip: {
+ status: 'use-with-caution',
+ whereUsed: 'global',
+ notes: 'Not yet recommended for use alongside components from `@wordpress/components`, pending review of overlays compatibility. See [WordPress/gutenberg#76135](https://github.com/WordPress/gutenberg/issues/76135).',
+ },
+ VisuallyHidden: {
+ status: 'recommended',
+ whereUsed: 'global',
+ },
+ },
+} as const satisfies Record< string, Record< string, ComponentStatus > >;
+
+type Package = keyof typeof COMPONENT_STATUS;
+type ComponentName< P extends Package > =
+ keyof ( typeof COMPONENT_STATUS )[ P ];
+
+/**
+ * Look up the curated status for a component.
+ *
+ * @param packageName - The npm package the component is exported from.
+ * @param componentName - The canonical component name as imported.
+ * @return The component's status entry.
+ */
+export function getComponentStatus< P extends Package >(
+ packageName: P,
+ componentName: ComponentName< P >
+): ComponentStatus {
+ return COMPONENT_STATUS[ packageName ][ componentName ] as ComponentStatus;
+}
+
+/**
+ * Resolve a component's status from a Storybook story object.
+ *
+ * The package is derived from the story's `parameters.fileName` by assuming the
+ * `packages/` convention maps to `@wordpress/`. This holds for every
+ * package we currently track component status. Packages that don't follow the
+ * convention simply won't match the registry and fall through to `undefined`,
+ * which is the desired behavior.
+ *
+ * The component name is derived from the last segment of the story's `title`,
+ * which matches how the component appears in the sidebar and, by convention,
+ * the keys of `COMPONENT_STATUS`.
+ *
+ * Returns `undefined` for companion docs pages that don't reference a component
+ * (i.e. whose story meta doesn't include a component property), so statuses
+ * only appear on a component's primary docs page rather than on every sibling
+ * page nested under its title.
+ *
+ * @param story - The Storybook prepared story for the docs page being rendered.
+ * @return The matching status entry, or `undefined` when the story cannot be
+ * resolved to a known package component.
+ */
+export function getComponentStatusFromStory(
+ story: PreparedStory
+): ComponentStatus | undefined {
+ if ( ! story.component ) {
+ return undefined;
+ }
+
+ const packageName = packageFromPath( story.parameters.fileName );
+ if ( ! packageName || ! ( packageName in COMPONENT_STATUS ) ) {
+ return undefined;
+ }
+
+ const componentName = story.title.split( '/' ).pop();
+ if ( ! componentName ) {
+ return undefined;
+ }
+
+ const registry = COMPONENT_STATUS[ packageName as Package ] as Record<
+ string,
+ ComponentStatus
+ >;
+ return registry[ componentName ];
+}
+
+function packageFromPath( fileName: string | undefined ): string | undefined {
+ const match = fileName?.match( /(?:^|\/)packages\/([^/]+)\// );
+ return match ? `@wordpress/${ match[ 1 ] }` : undefined;
+}
diff --git a/storybook/components/component-status-indicator/index.tsx b/storybook/components/component-status-indicator/index.tsx
index f8f2dc93809f29..b86411099a260f 100644
--- a/storybook/components/component-status-indicator/index.tsx
+++ b/storybook/components/component-status-indicator/index.tsx
@@ -1,22 +1,21 @@
import { Markdown, useOf } from '@storybook/addon-docs/blocks';
+import { getComponentStatusFromStory } from '../../component-status';
import { statuses } from './statuses';
export function ComponentStatusIndicator() {
- const resolvedOf = useOf( 'meta' );
+ const resolvedOf = useOf( 'story' );
- if ( resolvedOf.type !== 'meta' ) {
+ if ( resolvedOf.type !== 'story' ) {
return null;
}
- const { parameters } = resolvedOf.preparedMeta;
- const componentStatus = parameters?.componentStatus;
+ const componentStatus = getComponentStatusFromStory( resolvedOf.story );
- if ( ! componentStatus?.status ) {
+ if ( ! componentStatus ) {
return null;
}
- const statusInfo =
- statuses[ componentStatus.status as keyof typeof statuses ];
+ const statusInfo = statuses[ componentStatus.status ];
if ( ! statusInfo ) {
return null;
diff --git a/storybook/package.json b/storybook/package.json
index f9530a5bfe8e99..abffd7752f3656 100644
--- a/storybook/package.json
+++ b/storybook/package.json
@@ -21,7 +21,8 @@
},
"exports": {
"./main": "./main.ts",
- "./preview": "./preview.jsx"
+ "./preview": "./preview.jsx",
+ "./component-status": "./component-status.ts"
},
"devDependencies": {
"@storybook/addon-a11y": "^10.2.8",
diff --git a/storybook/types.d.ts b/storybook/types.d.ts
deleted file mode 100644
index d38d23e54d0dc4..00000000000000
--- a/storybook/types.d.ts
+++ /dev/null
@@ -1,15 +0,0 @@
-export {};
-
-declare module 'storybook/internal/types' {
- interface Parameters {
- componentStatus?: {
- status:
- | 'recommended'
- | 'use-with-caution'
- | 'not-recommended'
- | 'unaudited';
- whereUsed: 'global' | 'editor';
- notes?: string;
- };
- }
-}