gradient.ts

export type Falloff = 'gauss' | 'linear' | 'sharp';

export interface ColorPoint {
  id: string;
  color: string;
  x: number; // percentage
  y: number; // percentage
  weight?: number; // 0-1, radius/intensity of the point (default 1)
  falloff?: Falloff; // gaussian by default
}

export interface FilterState {
  brightness: number; // 0-200
  contrast: number; // 0-200
  saturation: number; // 0-200
  hue: number; // -180 to 180
  blur: number; // smoothing px @1000px render (0-40)
  grain: number; // 0-100
  grainType: 'noise' | 'svg' | 'perlin';
  grainBlendMode: 'normal' | 'multiply' | 'screen' | 'overlay' | 'soft-light' | 'hard-light' | 'color-dodge' | 'color-burn' | 'darken' | 'lighten' | 'difference' | 'exclusion';
}

export interface CanvasState {
  width: number;
  height: number;
  scale: number;
  ratio: string;
}

export type AnimationEasing = 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';

export interface AnimationState {
  isPlaying: boolean;
  speed: number; // multiplier
  duration: number; // seconds
  easing: AnimationEasing;
}

export interface GradientState {
  colors: ColorPoint[];
  filters: FilterState;
  canvas: CanvasState;
  animation: AnimationState;
  adjustColorPosition: boolean;
  baseTone: string; // 'auto' sentinel = OKLCH-derived dark base, else a hex
  bleed: boolean; // mirror near-edge points off-canvas
}

export interface Template {
  name: string;
  colors: ColorPoint[];
  width: number;
  height: number;
}

export interface ColorPreset {
  name: string;
  colors: string[];
}

// Engine v2 preset: stores points (position + weight + falloff), not a flat colour array.
export interface MeshPreset {
  name: string;
  points: Array<{ color: string; x: number; y: number; weight?: number; falloff?: Falloff }>;
}