@vaneui/ui 0.3.1-alpha.20251201135827.a31cb1e → 0.3.1-alpha.20251213103636.79707b4

package/dist/components/ui/grid.d.ts

@@ -1,27 +1,134 @@
+import React from 'react';
 import type { BaseProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, WrapProps, GapProps, FlexDirectionProps, ReverseProps, AppearanceProps, TransparentProps, VariantProps } from './props';
 /** Grid component props */
 export type GridProps = BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Grid2: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+/**
+ * A 2-column CSS grid container.
+ *
+ * Creates a responsive grid with 2 equal-width columns. Grid items automatically
+ * fill available columns. Uses CSS Grid for precise layout control.
+ *
+ * @example
+ * ```tsx
+ * // Basic 2-column grid
+ * <Grid2 gap>
+ *   <Card>Item 1</Card>
+ *   <Card>Item 2</Card>
+ *   <Card>Item 3</Card>
+ *   <Card>Item 4</Card>
+ * </Grid2>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Grid with custom styling
+ * <Grid2 gap lg className="auto-rows-fr">
+ *   <div>Column 1</div>
+ *   <div>Column 2</div>
+ * </Grid2>
+ * ```
+ *
+ * @see {@link GridProps} for all available props
+ */
+export declare const Grid2: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
-export declare const Grid3: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+} & React.RefAttributes<HTMLDivElement>>;
+/**
+ * A 3-column CSS grid container.
+ *
+ * Creates a responsive grid with 3 equal-width columns. Ideal for card
+ * layouts and feature displays. Grid items automatically wrap to new rows.
+ *
+ * @example
+ * ```tsx
+ * // Basic 3-column grid
+ * <Grid3 gap>
+ *   <Card>Feature 1</Card>
+ *   <Card>Feature 2</Card>
+ *   <Card>Feature 3</Card>
+ * </Grid3>
+ * ```
+ *
+ * @see {@link GridProps} for all available props
+ */
+export declare const Grid3: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
-export declare const Grid4: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+} & React.RefAttributes<HTMLDivElement>>;
+/**
+ * A 4-column CSS grid container.
+ *
+ * Creates a responsive grid with 4 equal-width columns. Perfect for
+ * image galleries or product listings with multiple items per row.
+ *
+ * @example
+ * ```tsx
+ * // Basic 4-column grid
+ * <Grid4 gap>
+ *   <Img src="/img1.jpg" alt="1" />
+ *   <Img src="/img2.jpg" alt="2" />
+ *   <Img src="/img3.jpg" alt="3" />
+ *   <Img src="/img4.jpg" alt="4" />
+ * </Grid4>
+ * ```
+ *
+ * @see {@link GridProps} for all available props
+ */
+export declare const Grid4: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
-export declare const Grid5: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+} & React.RefAttributes<HTMLDivElement>>;
+/**
+ * A 5-column CSS grid container.
+ *
+ * Creates a responsive grid with 5 equal-width columns. Useful for
+ * dense layouts with many small items, like icon grids or tag clouds.
+ *
+ * @example
+ * ```tsx
+ * // Basic 5-column grid
+ * <Grid5 gap>
+ *   <Badge>Tag 1</Badge>
+ *   <Badge>Tag 2</Badge>
+ *   <Badge>Tag 3</Badge>
+ *   <Badge>Tag 4</Badge>
+ *   <Badge>Tag 5</Badge>
+ * </Grid5>
+ * ```
+ *
+ * @see {@link GridProps} for all available props
+ */
+export declare const Grid5: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
-export declare const Grid6: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+} & React.RefAttributes<HTMLDivElement>>;
+/**
+ * A 6-column CSS grid container.
+ *
+ * Creates a responsive grid with 6 equal-width columns. Ideal for very
+ * dense layouts or dashboard widgets with many small components.
+ *
+ * @example
+ * ```tsx
+ * // Basic 6-column grid
+ * <Grid6 gap>
+ *   <Chip>Item 1</Chip>
+ *   <Chip>Item 2</Chip>
+ *   <Chip>Item 3</Chip>
+ *   <Chip>Item 4</Chip>
+ *   <Chip>Item 5</Chip>
+ *   <Chip>Item 6</Chip>
+ * </Grid6>
+ * ```
+ *
+ * @see {@link GridProps} for all available props
+ */
+export declare const Grid6: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
+} & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=grid.d.ts.map

package/dist/components/ui/grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/components/ui/grid.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,SAAS,GAC/B,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,KAAK;IAJhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDAQxB,CAAC;AAEF,eAAO,MAAM,KAAK;IAXhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDAexB,CAAC;AAEF,eAAO,MAAM,KAAK;IAlBhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDAsBxB,CAAC;AAEF,eAAO,MAAM,KAAK;IAzBhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDA6BxB,CAAC;AAEF,eAAO,MAAM,KAAK;IAhChB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDAoCxB,CAAC"}
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/components/ui/grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,SAAS,GAC/B,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,KAAK;IAhChB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCAoCxB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,KAAK;IAzDhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCA6DxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;IAnFhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCAuFxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK;IA9GhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCAkHxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,KAAK;IA1IhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCA8IxB,CAAC"}

package/dist/components/ui/img.d.ts

@@ -1,11 +1,45 @@
+import React from 'react';
 import type { BaseProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, AppearanceProps, TransparentProps, BorderProps, ShadowProps, RingProps, ShapeProps, VariantProps } from './props';
 /** Img component props */
 export type ImgProps = BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Img: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<import("react").ImgHTMLAttributes<HTMLImageElement>, "className" | "children"> & {
+/**
+ * An image component with styling and layout support.
+ *
+ * Wraps the HTML img element with VaneUI's styling system. Supports all
+ * standard image attributes (src, alt, width, height, etc.) plus additional
+ * props for borders, shadows, shapes, and positioning.
+ *
+ * @example
+ * ```tsx
+ * // Basic image
+ * <Img src="/photo.jpg" alt="Description" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Rounded image with border
+ * <Img src="/avatar.jpg" alt="User" pill border primary />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Image with shadow and custom size
+ * <Img src="/product.jpg" alt="Product" shadow lg />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Full width responsive image
+ * <Img src="/banner.jpg" alt="Banner" className="w-full h-auto" />
+ * ```
+ *
+ * @see {@link ImgProps} for all available props
+ */
+export declare const Img: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<React.ImgHTMLAttributes<HTMLImageElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLImageElement>>;
+} & React.RefAttributes<HTMLImageElement>>;
 //# sourceMappingURL=img.d.ts.map

package/dist/components/ui/img.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"img.d.ts","sourceRoot":"","sources":["../../../src/components/ui/img.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,SAAS,GAC9B,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC5E,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,GAAG;IAJd,sDAAsD;UAChD,KAAK,CAAC,WAAW;oDAWxB,CAAC"}
+{"version":3,"file":"img.d.ts","sourceRoot":"","sources":["../../../src/components/ui/img.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,SAAS,GAC9B,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC5E,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,GAAG;IArCd,sDAAsD;UAChD,KAAK,CAAC,WAAW;0CA4CxB,CAAC"}

package/dist/components/ui/input.d.ts

@@ -1,11 +1,45 @@
+import React from 'react';
 import type { BaseProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, WrapProps, GapProps, FlexDirectionProps, ReverseProps, AppearanceProps, TransparentProps, BorderProps, ShadowProps, RingProps, FocusVisibleProps, ShapeProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, FontFamilyProps, TextAlignProps, PaddingProps, VariantProps } from './props';
 /** Input component props */
 export type InputProps = BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & FocusVisibleProps & ShapeProps & FontWeightProps & FontStyleProps & TextDecorationProps & TextTransformProps & FontFamilyProps & TextAlignProps & PaddingProps & VariantProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Input: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & FocusVisibleProps & ShapeProps & FontWeightProps & FontStyleProps & TextDecorationProps & TextTransformProps & FontFamilyProps & TextAlignProps & PaddingProps & VariantProps & Omit<import("react").InputHTMLAttributes<HTMLInputElement>, "className" | "children"> & {
+/**
+ * A text input field component for forms and user data entry.
+ *
+ * Provides a styled input element with support for all standard HTML input
+ * attributes and types. Can be customized with appearances, sizes, and variants
+ * to match your design system. Supports all native input types (text, email, password, etc.).
+ *
+ * @example
+ * ```tsx
+ * // Basic text input
+ * <Input placeholder="Enter your name" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Email input with primary styling
+ * <Input type="email" primary outline placeholder="Email address" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Large input with custom styling
+ * <Input lg className="w-full" placeholder="Search..." />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Controlled input with state
+ * <Input value={value} onChange={(e) => setValue(e.target.value)} />
+ * ```
+ *
+ * @see {@link InputProps} for all available props
+ */
+export declare const Input: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & FocusVisibleProps & ShapeProps & FontWeightProps & FontStyleProps & TextDecorationProps & TextTransformProps & FontFamilyProps & TextAlignProps & PaddingProps & VariantProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLInputElement>>;
+} & React.RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=input.d.ts.map

package/dist/components/ui/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/components/ui/input.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,UAAU,GACV,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC9E,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,KAAK;IAJhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;oDAQxB,CAAC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/components/ui/input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,UAAU,GACV,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC9E,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,KAAK;IArChB,sDAAsD;UAChD,KAAK,CAAC,WAAW;0CAyCxB,CAAC"}

package/dist/components/ui/label.d.ts

@@ -1,11 +1,51 @@
+import React from 'react';
 import type { BaseProps, FontWeightProps, FontStyleProps, TextDecorationProps, TextTransformProps, FontFamilyProps, TextAlignProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, WrapProps, GapProps, FlexDirectionProps, ReverseProps, AppearanceProps, TransparentProps, VariantProps } from './props';
 /** Label component props */
 export type LabelProps = BaseProps & FontWeightProps & FontStyleProps & TextDecorationProps & TextTransformProps & FontFamilyProps & TextAlignProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.LabelHTMLAttributes<HTMLLabelElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Label: import("react").ForwardRefExoticComponent<BaseProps & FontWeightProps & FontStyleProps & TextDecorationProps & TextTransformProps & FontFamilyProps & TextAlignProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<import("react").LabelHTMLAttributes<HTMLLabelElement>, "className" | "children"> & {
+/**
+ * A label component for form fields and inputs.
+ *
+ * Renders a semantic HTML label element with typography and styling support.
+ * Typically used with form inputs like Input or Checkbox to provide
+ * accessible labels. Clicking the label focuses the associated input.
+ *
+ * @example
+ * ```tsx
+ * // Basic label
+ * <Label htmlFor="email">Email Address</Label>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Label with checkbox
+ * <Label>
+ *   <Checkbox id="terms" />
+ *   I agree to the terms
+ * </Label>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Styled label with custom appearance
+ * <Label semibold primary>Username</Label>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Label with input
+ * <Label htmlFor="password" className="block mb-2">
+ *   Password
+ * </Label>
+ * <Input id="password" type="password" />
+ * ```
+ *
+ * @see {@link LabelProps} for all available props
+ */
+export declare const Label: React.ForwardRefExoticComponent<BaseProps & FontWeightProps & FontStyleProps & TextDecorationProps & TextTransformProps & FontFamilyProps & TextAlignProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & VariantProps & Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLLabelElement>>;
+} & React.RefAttributes<HTMLLabelElement>>;
 //# sourceMappingURL=label.d.ts.map

package/dist/components/ui/label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../src/components/ui/label.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC9E,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,KAAK;IAJhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;oDAQxB,CAAC"}
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../src/components/ui/label.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC9E,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,KAAK;IA3ChB,sDAAsD;UAChD,KAAK,CAAC,WAAW;0CA+CxB,CAAC"}

package/dist/components/ui/row.d.ts

@@ -1,11 +1,49 @@
+import React from 'react';
 import type { BaseProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, WrapProps, GapProps, FlexDirectionProps, ReverseProps, BreakpointProps, AppearanceProps, TransparentProps, BorderProps, ShadowProps, RingProps, ShapeProps, VariantProps } from './props';
 /** Row component props */
 export type RowProps = BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & BreakpointProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Row: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & BreakpointProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+/**
+ * A horizontal flex container for arranging elements side-by-side.
+ *
+ * Arranges children horizontally with consistent spacing. Supports responsive
+ * breakpoints to switch to vertical stacking on smaller screens. Uses layout
+ * spacing for structural organization.
+ *
+ * @example
+ * ```tsx
+ * // Basic horizontal row
+ * <Row gap>
+ *   <Button>Action 1</Button>
+ *   <Button>Action 2</Button>
+ * </Row>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Row with space-between
+ * <Row justifyBetween itemsCenter>
+ *   <Title>Page Header</Title>
+ *   <Button>CTA</Button>
+ * </Row>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Responsive row (stacks on tablets and below)
+ * <Row tabletCol gap>
+ *   <Card>Card 1</Card>
+ *   <Card>Card 2</Card>
+ *   <Card>Card 3</Card>
+ * </Row>
+ * ```
+ *
+ * @see {@link RowProps} for all available props
+ */
+export declare const Row: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & BreakpointProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
+} & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=row.d.ts.map

package/dist/components/ui/row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../../src/components/ui/row.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,SAAS,GAC9B,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,GAAG;IAJd,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDAQxB,CAAC"}
+{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../../src/components/ui/row.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,SAAS,GAC9B,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,GAAG;IAzCd,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCA6CxB,CAAC"}

package/dist/components/ui/section.d.ts

@@ -1,11 +1,48 @@
+import React from 'react';
 import type { BaseProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, WrapProps, GapProps, FlexDirectionProps, ReverseProps, AppearanceProps, TransparentProps, BorderProps, ShadowProps, RingProps, ShapeProps, PaddingProps, BreakpointProps, VariantProps } from './props';
 /** Section component props */
 export type SectionProps = BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & PaddingProps & BreakpointProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Section: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & PaddingProps & BreakpointProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+/**
+ * A semantic section container for grouping related content.
+ *
+ * Renders as a semantic HTML section element with generous layout spacing.
+ * Use to organize page content into logical sections. Supports responsive
+ * flex direction with breakpoint props (mobileCol, tabletCol, etc.).
+ *
+ * @example
+ * ```tsx
+ * // Basic section
+ * <Section>
+ *   <SectionTitle>About</SectionTitle>
+ *   <Text>Section content here.</Text>
+ * </Section>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Section with padding and gap
+ * <Section padding gap>
+ *   <Title>Features</Title>
+ *   <Text>Feature descriptions...</Text>
+ * </Section>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Responsive section that stacks on tablets
+ * <Section tabletCol gap>
+ *   <Card>Card 1</Card>
+ *   <Card>Card 2</Card>
+ * </Section>
+ * ```
+ *
+ * @see {@link SectionProps} for all available props
+ */
+export declare const Section: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & PaddingProps & BreakpointProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
+} & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=section.d.ts.map

package/dist/components/ui/section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../../src/components/ui/section.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GAAG,SAAS,GAClC,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,OAAO;IAJlB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDAQxB,CAAC"}
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../../src/components/ui/section.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GAAG,SAAS,GAClC,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,OAAO;IAxClB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCA4CxB,CAAC"}

package/dist/components/ui/stack.d.ts

@@ -1,11 +1,49 @@
+import React from 'react';
 import type { BaseProps, SizeProps, HideProps, ItemsProps, JustifyProps, PositionProps, DisplayProps, OverflowProps, WrapProps, GapProps, FlexDirectionProps, ReverseProps, BreakpointProps, PaddingProps, AppearanceProps, TransparentProps, BorderProps, ShadowProps, RingProps, ShapeProps, VariantProps } from './props';
 /** Stack component props */
 export type StackProps = BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & BreakpointProps & PaddingProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'children'> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
 };
-export declare const Stack: import("react").ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & BreakpointProps & PaddingProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
+/**
+ * A vertical flex container for stacking elements.
+ *
+ * Arranges children vertically with consistent spacing. Supports responsive
+ * breakpoints to switch to horizontal layout on larger screens. Uses layout
+ * spacing for structural organization.
+ *
+ * @example
+ * ```tsx
+ * // Basic vertical stack
+ * <Stack gap>
+ *   <Button>Button 1</Button>
+ *   <Button>Button 2</Button>
+ *   <Button>Button 3</Button>
+ * </Stack>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Stack with padding and alignment
+ * <Stack padding gap itemsCenter>
+ *   <Title>Centered Content</Title>
+ *   <Text>All items are centered</Text>
+ * </Stack>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Responsive stack (becomes horizontal on desktop)
+ * <Stack desktopCol gap>
+ *   <Card>Item 1</Card>
+ *   <Card>Item 2</Card>
+ * </Stack>
+ * ```
+ *
+ * @see {@link StackProps} for all available props
+ */
+export declare const Stack: React.ForwardRefExoticComponent<BaseProps & SizeProps & HideProps & ItemsProps & JustifyProps & PositionProps & DisplayProps & OverflowProps & WrapProps & GapProps & FlexDirectionProps & ReverseProps & BreakpointProps & PaddingProps & AppearanceProps & TransparentProps & BorderProps & ShadowProps & RingProps & ShapeProps & VariantProps & Omit<React.HTMLAttributes<HTMLDivElement>, "className" | "children"> & {
     /** Custom HTML tag or React component to render as */
     tag?: React.ElementType;
-} & import("react").RefAttributes<HTMLDivElement>>;
+} & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=stack.d.ts.map

package/dist/components/ui/stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/components/ui/stack.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,KAAK;IAJhB,sDAAsD;UAChD,KAAK,CAAC,WAAW;kDASxB,CAAC"}
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/components/ui/stack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,SAAS,GAChC,SAAS,GACT,SAAS,GACT,UAAU,GACV,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,SAAS,GACT,QAAQ,GACR,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,YAAY,GACZ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACvE,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,KAAK;IAzChB,sDAAsD;UAChD,KAAK,CAAC,WAAW;wCA8CxB,CAAC"}