@ufoui/core 0.0.126 → 0.0.136

package/components/base/boxBase.d.ts

@@ -40,8 +40,6 @@ export interface BoxBaseProps extends Omit<HTMLAttributes<HTMLElement>, 'color'
     borderColor?: BorderColor;
     /** React children inside the box. */
     children?: ReactNode;
-    /** Layout direction shortcut. Same as `direction="col"`. */
-    col?: boolean;
     /** Surface background token. Default: `'surface'`. */
     color?: BaseColor;
     /** Grid template columns (`3` → `repeat(3, 1fr)`). */
@@ -71,11 +69,19 @@ export interface BoxBaseProps extends Omit<HTMLAttributes<HTMLElement>, 'color'
     /** Enables flex-grow (fills remaining space). */
     grow?: boolean;
     /** Height. */
-    h?: number | string;
+    height?: number | string;
     /** Renders as `inline-flex`, `inline-grid` or `inline-block`. */
     inline?: boolean;
     /** Maps to `justify-content` (main-axis alignment). */
     justifyContent?: CSSProperties['justifyContent'];
+    /** Maximum height. */
+    maxHeight?: number | string;
+    /** Maximum width. */
+    maxWidth?: number | string;
+    /** Minimum height. */
+    minHeight?: number | string;
+    /** Minimum width. */
+    minWidth?: number | string;
     /** Padding (all sides). */
     p?: number | string;
     /** Padding bottom. */
@@ -92,8 +98,6 @@ export interface BoxBaseProps extends Omit<HTMLAttributes<HTMLElement>, 'color'
     px?: number | string;
     /** Vertical padding (`padding-top` + `padding-bottom`). */
     py?: number | string;
-    /** Layout direction shortcut. Same as `direction="row"`. */
-    row?: boolean;
     /** Grid template rows (`2` → `repeat(2, 1fr)`). */
     rows?: number | string;
     /** Shape/border-radius token (round, rounded, smooth, square). */
@@ -101,7 +105,7 @@ export interface BoxBaseProps extends Omit<HTMLAttributes<HTMLElement>, 'color'
     /** Layout mode (`flex`, `grid`, `block`). Default: `flex`. */
     type?: BoxType;
     /** Width. */
-    w?: number | string;
+    width?: number | string;
     /** Enables wrapping (`flex-wrap: wrap`). */
     wrap?: boolean;
 }

package/components/base/textBase.d.ts

@@ -1,15 +1,15 @@
 import { default as React, HTMLAttributes, ReactNode } from 'react';
-import { BorderColor, ElementBorder, ElementElevation, ElementFont, ElementShape } from '../../utils';
+import { BorderColor, ElementBorder, ElementElevation, ElementFont, ElementShape, WrapperProps } from '../../utils';
 import { TextColor } from '../../types';
 /**
  * Props for {@link TextBase}.
  *
- * Defines typography and visual styling for text-level elements
- * without introducing layout behaviour.
+ * Defines typography and visual styling for text-level elements,
+ * plus outer placement (margin, positioning) via {@link WrapperProps}.
  *
  * @category Text
  */
-export interface TextBaseProps extends Omit<HTMLAttributes<HTMLElement>, 'color'> {
+export interface TextBaseProps extends Omit<HTMLAttributes<HTMLElement>, 'color'>, WrapperProps {
     /** Custom HTML element/component. Default: span. */
     as?: React.ElementType;
     /** Border width (0–5). */

package/components/layout/div.d.ts

@@ -7,7 +7,7 @@ import { BoxBaseProps } from '../base/boxBase';
  *
  * @category Div
  */
-export type DivProps = Omit<BoxBaseProps, 'type' | 'direction' | 'flow' | 'cols' | 'rows' | 'wrap'>;
+export type DivProps = Omit<BoxBaseProps, 'type' | 'direction' | 'flow' | 'cols' | 'rows' | 'wrap' | 'gap' | 'gapX' | 'gapY' | 'justifyContent' | 'alignItems' | 'placeItems' | 'alignContent'>;
 /**
  * Generic block-level container.
  *

package/components/layout/flex.d.ts

@@ -7,7 +7,7 @@ import { BoxBaseProps } from '../base/boxBase';
  *
  * @category Flex
  */
-export type FlexProps = Omit<BoxBaseProps, 'elementClass' | 'type' | 'cols' | 'rows' | 'flow'>;
+export type FlexProps = Omit<BoxBaseProps, 'elementClass' | 'type' | 'cols' | 'rows' | 'flow' | 'placeItems'>;
 /**
  * Flex layout container.
  *

package/components/layout/index.d.ts

@@ -9,3 +9,4 @@ export * from './header';
 export * from './main';
 export * from './nav';
 export * from './section';
+export * from './stack';

package/components/layout/stack.d.ts

@@ -0,0 +1,31 @@
+import { FlexProps } from './flex';
+/**
+ * Props for the {@link Stack} component.
+ *
+ * Extends {@link FlexProps} with the layout direction removed —
+ * a Stack is always a vertical column.
+ *
+ * @category Stack
+ */
+export type StackProps = Omit<FlexProps, 'direction'>;
+/**
+ * Vertical flex layout container.
+ *
+ * Renders a flexbox column — the equivalent of `<Flex direction="col">`,
+ * exposed as its own component because vertical stacking is the most common
+ * layout need. Use this component to stack children top-to-bottom; reach for
+ * {@link Flex} when you need a horizontal or configurable direction.
+ *
+ * Built on top of {@link BoxBase} with `type="flex"` and a locked column direction.
+ *
+ * @category Stack
+ * @function
+ * @param props - Vertical flex layout props inherited from {@link Flex}.
+ *
+ * @example
+ * <Stack gap={8}>
+ *   <Header />
+ *   <Content />
+ * </Stack>
+ */
+export declare const Stack: import('react').ForwardRefExoticComponent<StackProps & import('react').RefAttributes<HTMLDivElement>>;