@aurora-ds/components 0.17.11 → 0.17.12

package/dist/esm/components/layout/grid/Grid.d.ts

@@ -8,7 +8,8 @@ import { GridProps } from '@components/layout/grid/Grid.props.ts';
  * **Usage:**
  * - Use `columns` to define the number of columns or a custom grid-template-columns value
  * - Use `rows` to define the number of rows or a custom grid-template-rows value
- * - Children with min-width will cause the grid to overflow if space is insufficient
+ * - Use `minChildWidth` for responsive auto-fill grids
+ * - Combine `columns` + `minChildWidth` for responsive grid with max columns limit
  */
 declare const Grid: FC<GridProps>;
 export default Grid;

package/dist/esm/components/layout/grid/Grid.props.d.ts

@@ -3,7 +3,7 @@ import { CSSProperties, ReactNode } from 'react';
 export type GridProps = {
     /** Grid children elements */
     children: ReactNode;
-    /** Number of columns (number or CSS grid-template-columns value). */
+    /** Number of columns (number or CSS grid-template-columns value). Acts as max columns when minChildWidth is set. */
     columns?: number | string;
     /** Number of rows (number or CSS grid-template-rows value). */
     rows?: number | string;
@@ -29,6 +29,8 @@ export type GridProps = {
     justifyContent?: CSSProperties['justifyContent'];
     /** Padding inside the grid */
     padding?: keyof Theme['spacing'];
+    /** Minimum width for each grid child. Enables responsive auto-fill behavior. */
+    minChildWidth?: CSSProperties['width'];
     /** Accessibility label for screen readers */
     ariaLabel?: string;
     /** ID of element that labels this grid */
@@ -54,4 +56,5 @@ export type GridStyleParams = {
     alignContent?: CSSProperties['alignContent'];
     justifyContent?: CSSProperties['justifyContent'];
     padding?: keyof Theme['spacing'];
+    minChildWidth?: CSSProperties['width'];
 };

package/dist/esm/index.js

@@ -1889,15 +1889,30 @@ const Card = ({ children, direction = 'column', padding = 'md', width, height, g
 Card.displayName = 'Card';
 
 /**
- * Generates the grid-template-columns value based on columns prop
- * - If columns is a number: creates that exact number of columns with equal width
- * - If columns is a string: uses it directly as grid-template-columns value
+ * Generates the grid-template-columns value based on columns and minChildWidth props
+ * - If only columns is defined: creates a fixed number of columns
+ * - If only minChildWidth is defined: creates responsive auto-fill columns (items stretch)
+ * - If both are defined: creates responsive columns with a maximum limit (items don't stretch beyond column width)
  *
- * Children with min-width will cause overflow rather than wrapping.
- * For responsive behavior, the parent container should handle breakpoints
- * or use CSS container queries.
+ * Key difference between auto-fill and auto-fit:
+ * - auto-fill: keeps empty column tracks, items don't stretch to fill container
+ * - auto-fit: collapses empty tracks, items stretch to fill available space
  */
-const getGridTemplateColumns = (columns) => {
+const getGridTemplateColumns = (columns, minChildWidth) => {
+    const minWidthValue = typeof minChildWidth === 'number' ? `${minChildWidth}px` : minChildWidth;
+    if (minChildWidth && typeof columns === 'number') {
+        // Responsive grid with max columns limit
+        // Uses auto-fill to preserve empty column tracks (items don't stretch beyond their column)
+        // The min value ensures items are at least minChildWidth
+        // The max value is 1fr to distribute space evenly within the max columns constraint
+        // The calc ensures we never exceed the specified number of columns
+        const minColumnWidth = `calc((100% - ${columns - 1} * var(--grid-gap, 0px)) / ${columns})`;
+        return `repeat(auto-fill, minmax(max(${minWidthValue}, ${minColumnWidth}), 1fr))`;
+    }
+    if (minChildWidth) {
+        // Responsive grid without column limit - items will fill available space
+        return `repeat(auto-fill, minmax(${minWidthValue}, 1fr))`;
+    }
     if (typeof columns === 'number') {
         // Fixed number of columns - each column takes equal space
         return `repeat(${columns}, 1fr)`;
@@ -1917,11 +1932,12 @@ const getGridTemplateRows = (rows) => {
  * Grid styles using createStyles from @aurora-ds/theme
  */
 const GRID_STYLES = createStyles((theme) => ({
-    root: ({ columns, rows, gap, columnGap, rowGap, width, height, minHeight, alignItems, justifyItems, alignContent, justifyContent, padding, }) => {
+    root: ({ columns, rows, gap, columnGap, rowGap, width, height, minHeight, alignItems, justifyItems, alignContent, justifyContent, padding, minChildWidth, }) => {
         const gapValue = gap ? theme.spacing[gap] : undefined;
+        const columnGapValue = columnGap ? theme.spacing[columnGap] : gapValue;
         return {
             display: 'grid',
-            gridTemplateColumns: getGridTemplateColumns(columns),
+            gridTemplateColumns: getGridTemplateColumns(columns, minChildWidth),
             gridTemplateRows: getGridTemplateRows(rows),
             gap: gapValue,
             columnGap: columnGap ? theme.spacing[columnGap] : undefined,
@@ -1934,6 +1950,7 @@ const GRID_STYLES = createStyles((theme) => ({
             alignContent,
             justifyContent,
             padding: padding ? theme.spacing[padding] : undefined,
+            '--grid-gap': columnGapValue || gapValue || '0px',
         };
     },
 }));
@@ -1946,9 +1963,10 @@ const GRID_STYLES = createStyles((theme) => ({
  * **Usage:**
  * - Use `columns` to define the number of columns or a custom grid-template-columns value
  * - Use `rows` to define the number of rows or a custom grid-template-rows value
- * - Children with min-width will cause the grid to overflow if space is insufficient
+ * - Use `minChildWidth` for responsive auto-fill grids
+ * - Combine `columns` + `minChildWidth` for responsive grid with max columns limit
  */
-const Grid = ({ children, columns = 1, rows, gap = 'sm', columnGap, rowGap, width, height, minHeight, alignItems, justifyItems, alignContent, justifyContent, padding, ariaLabel, ariaLabelledBy, ariaDescribedBy, role, tabIndex, }) => {
+const Grid = ({ children, columns = 1, rows, gap = 'sm', columnGap, rowGap, width, height, minHeight, alignItems, justifyItems, alignContent, justifyContent, padding, minChildWidth, ariaLabel, ariaLabelledBy, ariaDescribedBy, role, tabIndex, }) => {
     return (jsx("div", { className: GRID_STYLES.root({
             columns,
             rows,
@@ -1963,6 +1981,7 @@ const Grid = ({ children, columns = 1, rows, gap = 'sm', columnGap, rowGap, widt
             alignContent,
             justifyContent,
             padding,
+            minChildWidth,
         }), "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, role: role, tabIndex: tabIndex, children: children }));
 };
 Grid.displayName = 'Grid';