From ea220e9a9d11b1403d569ee6ecff5e9417f70366 Mon Sep 17 00:00:00 2001
From: MT Lewis <mtlewis@users.noreply.github.com>
Date: Fri, 17 Apr 2026 17:47:29 +0100
Subject: [PATCH] ui: document FlexItemProps

Signed-off-by: MT Lewis <mtlewis@users.noreply.github.com>
---
 packages/ui/report.api.md | 5 +----
 packages/ui/src/types.ts  | 9 ++++++++-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/packages/ui/report.api.md b/packages/ui/report.api.md
index e7ccca62df..b3cdc5ced4 100644
--- a/packages/ui/report.api.md
+++ b/packages/ui/report.api.md
@@ -1333,13 +1333,10 @@ export const FlexDefinition: {
 // @public (undocumented)
 export type FlexDirection = 'row' | 'column';
 
-// @public (undocumented)
+// @public
 export interface FlexItemProps {
-  // (undocumented)
   basis?: Responsive<CSSProperties['flexBasis']>;
-  // (undocumented)
   grow?: Responsive<number | boolean>;
-  // (undocumented)
   shrink?: Responsive<number | boolean>;
 }
 
diff --git a/packages/ui/src/types.ts b/packages/ui/src/types.ts
index 9f8d792731..3a6633bc37 100644
--- a/packages/ui/src/types.ts
+++ b/packages/ui/src/types.ts
@@ -122,10 +122,17 @@ export interface PaddingProps {
 /** @public */
 export interface SpaceProps extends MarginProps, PaddingProps {}
 
-/** @public */
+/**
+ * Flex item properties.
+ *
+ * @public
+ */
 export interface FlexItemProps {
+  /** Controls the flex-grow property. Values of `true` or `false` are converted to `1` or `0` respectively. */
   grow?: Responsive<number | boolean>;
+  /** Controls the flex-shrink property. Values of `true` or `false` are converted to `1` or `0` respectively. */
   shrink?: Responsive<number | boolean>;
+  /** Controls the flex-basis property. */
   basis?: Responsive<CSSProperties['flexBasis']>;
 }