proxy

@stateloom/proxy

Proxy-based mutable state with transparent tracking for StateLoom. Familiar to Valtio and MobX users.

Install

pnpm add @stateloom/core @stateloom/proxy

Quick Start

import { observable, snapshot, observe } from '@stateloom/proxy';

const state = observable({ count: 0, name: 'Alice' });

const dispose = observe(() => {
  console.log('Count:', state.count);
});
// "Count: 0"

state.count++; // "Count: 1"

const snap = snapshot(state); // deeply frozen with structural sharing

dispose();

Exports

Export	Description
observable(obj)	Create a deeply-proxied mutable state object
snapshot(proxy)	Create an immutable, structurally-shared snapshot
observe(fn)	Auto-tracking side effect
subscribe(proxy, cb)	Subscribe to any mutation (including nested)
ref(value)	Opt a value out of proxying

Types

Ref<T>, Snapshot<T>

Size

~1.2 KB gzipped (+ core)

Documentation

• API Reference
• Proxy Design (LLD)