ui: document FlexItemProps

Signed-off-by: MT Lewis <mtlewis@users.noreply.github.com>

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>;
 }
 

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']>;
 }