Sugar

What

@mantaq/sugar wraps core primitives with convenience helpers. Every helper compiles to the same behavior you could write yourself.

Helpers

Helper	Purpose
states(), events()	Batch create states/events
matches(), isIn(), activeLeaves(), tag()	State matching and grouping
ActorMap, broadcast()	Dynamic child management
withPromise(), withTimeout()	Effect helpers
actorSpec, definePart, withParts	Split setup across files

Install

npm install @mantaq/sugar

Requires @mantaq/core. Single entry point:

import { matches, states, events } from "@mantaq/sugar";

When to use

Use sugar when many states/events, frequent state checks, dynamic children, or promise effects. Skip when few states, minimal checks, no dynamic children, or custom effect patterns.

Core is sufficient for everything. Sugar saves typing.

Pages

• Batch Creation: states() and events()
• Matching: matches(), isIn(), activeLeaves(), tag()
• Composition: actorSpec, definePart, withParts
• Dynamic Children: ActorMap and broadcast()
• Effect Helpers: withPromise() and withTimeout()
• Request / Response: short-lived request handlers