@dragonspark/hikari-preact

Preact components and hooks for the @dragonspark/hikari WebGL framework.

🧩 Features

• Preact components for hikari effects, free of the compat layer
• Custom hooks for easy integration
• TypeScript support
• Responsive and performant animations

⚙️ Installation

npm install @dragonspark/hikari-preact @dragonspark/hikari-effects @dragonspark/hikari
# or
yarn add @dragonspark/hikari-preact @dragonspark/hikari-effects @dragonspark/hikari

Note: @dragonspark/hikari and @dragonspark/hikari-effects are peer dependencies and must be installed alongside this package.

✨ Available Components

MorphGradientCanvas

A Preact component wrapper for the MorphGradient effect from hikari-effects.

Basic Usage

import { MorphGradientCanvas } from '@dragonspark/hikari-preact';

function App() {
  return (
    <div className="app">
      <MorphGradientCanvas 
        class="gradient-background"
        baseColor="#ff0000"
        waveColors={['#00ff00', '#0000ff', '#ffff00']}
      />
      <div className="content">
        <h1>Hello, World!</h1>
      </div>
    </div>
  );
}

Using CSS Variables

You can define gradient colors using CSS variables:

:root {
  --gradient-color-1: #ff0000;
  --gradient-color-2: #00ff00;
  --gradient-color-3: #0000ff;
  --gradient-color-4: #ffff00;
}

// The gradient will automatically use the CSS variables
<MorphGradientCanvas class="gradient-background" />

You can also pass CSS variables directly:

<MorphGradientCanvas 
  class="gradient-background"
  baseColor="var(--gradient-color-1)"
  waveColors={[
    'var(--gradient-color-2)',
    'var(--gradient-color-3)',
    'var(--gradient-color-4)'
  ]}
/>

If CSS variables are not available or parsing fails, the component will fall back to these default values:

// Default base color
const defaultBaseColor = '#a960ee'; // Purple

// Default wave colors
const defaultWaveColors = [
  '#ff333d', // Red
  '#90e0ff', // Light blue
  '#ffcb57'  // Yellow
];

Props

• class: string (optional) - CSS class name for the canvas element
• style: CSSProperties (optional) - Inline styles for the canvas element
• baseColor: string (optional) - Base color for the gradient. Can be:
  • Hex color code (e.g., '#ff0000')
  • CSS variable name (e.g., '--gradient-color-1')
  • CSS variable reference (e.g., 'var(--gradient-color-1)')
  • If not provided, falls back to CSS variables or default base color ('#a960ee')
• waveColors: string[] (optional) - Array of wave colors for the gradient. Can be:
  • Hex color codes (e.g., '#ff0000')
  • CSS variable names (e.g., '--gradient-color-1')
  • CSS variable references (e.g., 'var(--gradient-color-1)')
  • At least one color is required
  • If not provided, falls back to CSS variables or default wave colors
• amplitude: number (optional) - Wave amplitude
• seed: number (optional) - Random seed
• freqX: number (optional) - X-axis frequency
• freqY: number (optional) - Y-axis frequency
• freqDelta: number (optional) - Frequency change rate
• darkenTop: boolean (optional) - Darken the top of the gradient
• onInit: (gradient: MorphGradient) => void (optional) - Callback when gradient is initialized

🪝 Custom Hooks

useMorphGradient

A custom hook for using the MorphGradient effect in Preact components.

import { useRef, useEffect } from 'preact/hooks';
import { useMorphGradient } from '@dragonspark/hikari-preact';

function GradientComponent() {
  // 1) Generate a stable canvas ID once
  const idRef = useRef(`gradient-canvas-${Math.random().toString(36).slice(2, 9)}`);

  // 2) Initialize the gradient on that ID
  const { gradient, isInitialized, pause } = useMorphGradient({
    canvasId: idRef.current,
    baseColor: '#3498db',
    waveColors: ['#9b59b6', '#e74c3c', '#f1c40f'],
    amplitude: 320
    // autoPlay defaults to true
  });

  // 3) Pause after 5s once it’s running
  useEffect(() => {
    if (!isInitialized) return;
    const timer = setTimeout(() => pause(), 5000);
    return () => clearTimeout(timer);
  }, [isInitialized, pause]);

  return (
    <div class="gradient-container">
      <canvas
        id={idRef.current}
        class="gradient-canvas"
        style={{ width: '100%', height: '100%' }}
      />
    </div>
  );
}

📝 License

MIT © DragonSpark