@xaui/native 0.2.6 → 0.2.8

package/dist/view/index.d.ts

@@ -68,54 +68,96 @@ type ContainerProps = {
 
 declare const Container: React.FC<ContainerProps>;
 
-type MainAxisAlignment = 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'space-evenly';
-type CrossAxisAlignment = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
-type RowProps = {
-    /**
-     * The content to render inside the row.
-     */
-    children: ReactNode;
-    /**
-     * Main axis alignment for row items.
-     * @default 'start'
-     */
+type MainAxisAlignment = 'start' | 'end' | 'center' | 'spaceBetween' | 'spaceAround' | 'spaceEvenly';
+type CrossAxisAlignment = 'start' | 'end' | 'center' | 'stretch';
+/** Controls how much space the flex widget occupies in its main axis. */
+type MainAxisSize = 'min' | 'max';
+type Direction = 'horizontal' | 'vertical';
+type FlexProps = {
+    /** Content to render inside the flex container. */
+    children?: ReactNode;
+    /** Axis direction — `'horizontal'` for row, `'vertical'` for column. */
+    direction: Direction;
+    /** How to place children along the main axis. @default 'start' */
     mainAxisAlignment?: MainAxisAlignment;
-    /**
-     * Cross axis alignment for row items.
-     * @default 'center'
-     */
+    /** How to place children along the cross axis. @default 'center' */
     crossAxisAlignment?: CrossAxisAlignment;
-    /**
-     * Spacing between children.
-     */
-    spacing?: number;
-    /**
-     * Reverse the row direction.
-     * @default false
-     */
-    reverse?: boolean;
-    /**
-     * Force the container to take the full width.
-     * @default false
-     */
-    fullWidth?: boolean;
-    /**
-     * Custom style for the row container.
-     */
+    /** Whether the flex takes max or min space in the main axis. @default 'max' */
+    mainAxisSize?: MainAxisSize;
+    /** Wrap children onto multiple lines when they overflow. @default false */
+    wrap?: boolean;
+    /** Gap in logical pixels between children. */
+    gap?: number;
+    /** Reverse the layout direction. @default false */
+    reversed?: boolean;
+    /** Flex factor applied to the container itself. */
+    flex?: number;
+    /** Raw style override applied to the underlying View. */
     style?: StyleProp<ViewStyle>;
+    /** Test identifier for e2e tests. */
+    testID?: string;
 };
-type ColumnProps = RowProps & {
+type RowProps = Omit<FlexProps, 'direction'>;
+type ColumnProps = Omit<FlexProps, 'direction'>;
+/** Controls how a `Flexible` child sizes itself within available space. */
+type FlexFit = 'tight' | 'loose';
+type FlexibleProps = {
+    /** Content to render inside the flexible container. */
+    children?: ReactNode;
+    /** Flex factor — how much space to claim relative to siblings. @default 1 */
+    flex?: number;
     /**
-     * If true, the container will grow to fill available space.
-     * @default false
+     * Sizing behaviour:
+     * - `'tight'` — force the child to fill all allotted space (like `Expanded`).
+     * - `'loose'` — allow the child to be at most the allotted size but no larger.
+     * @default 'loose'
      */
-    noGrowth?: boolean;
+    fit?: FlexFit;
+    /** Raw style override applied to the underlying View. */
+    style?: StyleProp<ViewStyle>;
+    /** Test identifier for e2e tests. */
+    testID?: string;
+};
+type WrapProps = {
+    /** Content to render inside the wrap container. */
+    children?: ReactNode;
+    /** Primary axis direction. @default 'horizontal' */
+    direction?: Direction;
+    /** Alignment of children along the main axis within each run. @default 'start' */
+    alignment?: MainAxisAlignment;
+    /** Alignment of runs along the cross axis. @default 'start' */
+    runAlignment?: MainAxisAlignment;
+    /** Space between children along the main axis. @default 0 */
+    spacing?: number;
+    /** Space between runs along the cross axis. @default 0 */
+    runSpacing?: number;
+    /** Raw style override applied to the underlying View. */
+    style?: StyleProp<ViewStyle>;
+    /** Test identifier for e2e tests. */
+    testID?: string;
 };
 
+declare const Flex: React.FC<FlexProps>;
+
 declare const Column: React.FC<ColumnProps>;
 
 declare const Row: React.FC<RowProps>;
 
+type ExpandedProps = {
+    /** Content to render inside the expanded container. */
+    children?: ReactNode;
+    /** Flex factor — how much of the available space to take relative to siblings. @default 1 */
+    flex?: number;
+    /** Raw style override applied to the underlying View. */
+    style?: StyleProp<ViewStyle>;
+    /** Test identifier for e2e tests. */
+    testID?: string;
+};
+
+declare const Expanded: React.FC<ExpandedProps>;
+
+declare const Flexible: React.FC<FlexibleProps>;
+
 type SpacerProps = {
     /**
      * Flex factor for the spacer.
@@ -130,6 +172,8 @@ type SpacerProps = {
 
 declare const Spacer: React.FC<SpacerProps>;
 
+declare const Wrap: React.FC<WrapProps>;
+
 type PaddingProps = {
     /** Content to render inside the padding container. */
     children?: ReactNode;
@@ -786,4 +830,4 @@ declare const MasonryGridBuilder: {
     displayName: string;
 };
 
-export { Align, type AlignProps, AspectRatio, type AspectRatioProps, BlurView, type BlurViewProps, type BoxConstraints, Center, type CenterProps, Column, type ColumnProps, ConditionalView, type ConditionalViewAnimation, type ConditionalViewProps, ConstrainedBox, type ConstrainedBoxProps, Container, type ContainerProps, type CrossAxisAlignment, FractionallySizedBox, type FractionallySizedBoxProps, Grid, GridBuilder, type GridBuilderProps, GridItem, type GridItemProps, type GridProps, type MainAxisAlignment, Margin, type MarginProps, MasonryGrid, MasonryGridBuilder, type MasonryGridBuilderProps, MasonryGridItem, type MasonryGridItemProps, type MasonryGridProps, Padding, type PaddingProps, PositionedView, type PositionedViewProps, RoundedView, type RoundedViewProps, Row, type RowProps, Screen, type ScreenProps, SizedBox, type SizedBoxProps, Spacer, type SpacerProps, Surface, type SurfaceProps, type SurfaceThemeColor };
+export { Align, type AlignProps, AspectRatio, type AspectRatioProps, BlurView, type BlurViewProps, type BoxConstraints, Center, type CenterProps, Column, type ColumnProps, ConditionalView, type ConditionalViewAnimation, type ConditionalViewProps, ConstrainedBox, type ConstrainedBoxProps, Container, type ContainerProps, type CrossAxisAlignment, type Direction, Expanded, type ExpandedProps, Flex, type FlexFit, type FlexProps, Flexible, type FlexibleProps, FractionallySizedBox, type FractionallySizedBoxProps, Grid, GridBuilder, type GridBuilderProps, GridItem, type GridItemProps, type GridProps, type MainAxisAlignment, type MainAxisSize, Margin, type MarginProps, MasonryGrid, MasonryGridBuilder, type MasonryGridBuilderProps, MasonryGridItem, type MasonryGridItemProps, type MasonryGridProps, Padding, type PaddingProps, PositionedView, type PositionedViewProps, RoundedView, type RoundedViewProps, Row, type RowProps, Screen, type ScreenProps, SizedBox, type SizedBoxProps, Spacer, type SpacerProps, Surface, type SurfaceProps, type SurfaceThemeColor, Wrap, type WrapProps };