Stack Primitive

---
//    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.
/**
 * Stack — Vertical rhythm primitive. Every direct child gets equal spacing
 * via `gap` (flex column) — never margin-stacking, which breaks the moment
 * someone reorders children or the first/last child needs to sit flush.
 *
 * `space` is a Tailwind spacing step (number), `align` controls cross-axis
 * alignment (useful for a stack of differently-sized buttons/badges that
 * should hug one edge or centre).
 */
export interface Props {
  as?: 'div' | 'section' | 'ul' | 'ol';
  space?: 1 | 2 | 3 | 4 | 5 | 6 | 8 | 10 | 12 | 16;
  align?: 'start' | 'center' | 'end' | 'stretch';
  className?: string;
}

const { as: As = 'div', space = 4, align = 'stretch', className = '' } = Astro.props;

const SPACE: Record<number, string> = {
  1: 'gap-1', 2: 'gap-2', 3: 'gap-3', 4: 'gap-4', 5: 'gap-5',
  6: 'gap-6', 8: 'gap-8', 10: 'gap-10', 12: 'gap-12', 16: 'gap-16',
};

const ALIGN: Record<string, string> = {
  start: 'items-start',
  center: 'items-center',
  end: 'items-end',
  stretch: 'items-stretch',
};
---

<As class:list={['flex flex-col', SPACE[space], ALIGN[align], className]}>
  <slot />
</As>