@vielzeug/ripple

Reactive runtime primitives: signals, derived values, effects, scopes, watchers, and async resources

Installation

pnpm add @vielzeug/ripple
npm install @vielzeug/ripple
yarn add @vielzeug/ripple

Quick Start

import { createRipple } from '@vielzeug/ripple';

const ripple = createRipple({
  onError: (error, context) => console.error(context.kind, error),
});

const count = ripple.signal(0);
const doubled = ripple.computed(() => count.value * 2);
const stop = ripple.effect(() => console.log(doubled.value));

ripple.batch(() => {
  count.value = 1;
  count.value = 2;
});

stop.dispose();
ripple.dispose();

onError handles runtime callback failures; async resource failures are state values. Effects flush synchronously, so use batch() to coalesce writes. Package errors use RippleError, RippleCycleError, and RippleDisposedError.

Documentation

• Overview
• Usage Guide
• API Reference
• Examples
• Migration Guide

License

MIT © Helmuth Saatkamp: part of the Vielzeug monorepo.