Auto-Fit Responsive Card Grid

---
//    VELOCITY COMPONENT · theming
// 
//    Colours here are Tailwind `primary-*` / `accent-*`, which resolve through
//    the Velocity preset. Out of the box they are a neutral indigo — NOT the
//    Aidxn brand — so this drops into your project without dragging our look in.
// 
//    ⚡ NOT USING VELOCITY? Run this once, in your project root:
// 
//          velocityx theme
// 
//    It writes velocity-preset.cjs + velocity-theme.css. Add the preset to your
//    tailwind.config, import the css, then set your whole brand in ONE place:
// 
//          :root {
//            --vx-brand: custom;
//            --vx-primary-600: 220 38 38;   <- your action colour
//            --vx-primary-700: 185 28 28;
//          }
// 
//    ⚠️  Raw RGB channels, space separated — NOT hex. `#DC2626` here silently
//        breaks every /opacity variant in the library (bg-primary-600/20 etc).
// 
//    Prefer not to install anything? Find-and-replace `primary-` with your own
//    scale name. Nothing else in this file depends on Velocity.
/**
 * AutoFitGrid — Responsive card grid with NO breakpoints to maintain. Uses
 * `grid-template-columns: repeat(auto-fit, minmax(min(100%, Xpx), 1fr))` so
 * the column count is a pure function of container width ÷ `minItemWidth`
 * — add a 10th card and the grid just keeps working, no new `lg:grid-cols-*`
 * utility needed.
 *
 * `minItemWidth` is the single tuning knob (default 240px). The
 * `min(100%, …)` guard means a single item still fills a narrow mobile
 * viewport instead of overflowing it.
 */
export interface Props {
  as?: 'div' | 'section';
  minItemWidth?: string;
  gap?: 4 | 5 | 6 | 8;
  className?: string;
}

const {
  as: As = 'div',
  minItemWidth = '240px',
  gap = 6,
  className = '',
} = Astro.props;

const GAP: Record<number, string> = {
  4: 'gap-4',
  5: 'gap-5',
  6: 'gap-6',
  8: 'gap-8',
};
---

<As
  class:list={['grid', GAP[gap], className]}
  style={`grid-template-columns: repeat(auto-fit, minmax(min(100%, ${minItemWidth}), 1fr));`}
>
  <slot />
</As>