@mantaq/core 0.2.0 → 0.4.0

package/dist/index.mjs

@@ -1,766 +1 @@
-import { registerActor, setOutputHandler } from "./internal.mjs";
-import { Either } from "@mantaq/utils";
-//#region src/state.ts
-function state(id) {
-	return () => new StateRef(id, false);
-}
-var StateRef = class StateRef {
-	name;
-	isFinal;
-	/** @internal */ _regions;
-	constructor(name, isFinal) {
-		this.name = name;
-		this.isFinal = isFinal;
-	}
-	regions(options) {
-		this._regions = options;
-		return this;
-	}
-	final() {
-		const next = new StateRef(this.name, true);
-		next._regions = this._regions;
-		return next;
-	}
-	create(payload) {
-		return {
-			state: this,
-			payload
-		};
-	}
-};
-//#endregion
-//#region src/real-clock.ts
-var RealClock = class {
-	#start = Date.now();
-	now() {
-		return Date.now() - this.#start;
-	}
-	setTimeout(ms, cb, options) {
-		if (options?.signal?.aborted) return -1;
-		let onAbort;
-		const id = Number(globalThis.setTimeout(() => {
-			if (onAbort && options?.signal) options.signal.removeEventListener("abort", onAbort);
-			cb();
-		}, ms));
-		if (options?.signal) {
-			onAbort = () => globalThis.clearTimeout(id);
-			options.signal.addEventListener("abort", onAbort, { once: true });
-		}
-		return id;
-	}
-	clearTimeout(id) {
-		globalThis.clearTimeout(id);
-	}
-	setInterval(ms, cb, options) {
-		const id = Number(globalThis.setInterval(cb, ms));
-		if (options?.signal) {
-			const onAbort = () => globalThis.clearInterval(id);
-			options.signal.addEventListener("abort", onAbort, { once: true });
-		}
-		return id;
-	}
-	clearInterval(id) {
-		globalThis.clearInterval(id);
-	}
-};
-//#endregion
-//#region src/abort-tracker.ts
-function trackAbort(signal, id, map) {
-	const onAbort = signal ? () => {
-		map.delete(id);
-	} : void 0;
-	if (signal && onAbort) signal.addEventListener("abort", onAbort, { once: true });
-	return onAbort;
-}
-function clearAbort(timer) {
-	if (timer.signal && timer.onAbort) timer.signal.removeEventListener("abort", timer.onAbort);
-}
-//#endregion
-//#region src/virtual-clock.ts
-var VirtualClock = class {
-	#now = 0;
-	#timers = /* @__PURE__ */ new Map();
-	#intervals = /* @__PURE__ */ new Map();
-	#nextId = 1;
-	#drain = null;
-	now() {
-		return this.#now;
-	}
-	/**
-	* Delay normalization: NaN and ±Infinity throw (programmer error); negative
-	* and 0 clamp to 0 for timeouts like the platform, to a 1ms floor for
-	* intervals (a 0ms interval would spin the synchronous advance loop
-	* forever). Finite positive values schedule at their real deadline.
-	*/
-	#delay(ms, method, interval) {
-		if (!Number.isFinite(ms)) throw new RangeError(`[VirtualClock] invalid ${method} ms value: ${ms}`);
-		return ms <= 0 ? interval ? 1 : 0 : ms;
-	}
-	setTimeout(ms, cb, options) {
-		const signal = options?.signal;
-		if (signal?.aborted) return -1;
-		const id = this.#nextId++;
-		const onAbort = trackAbort(signal, id, this.#timers);
-		this.#timers.set(id, {
-			deadline: this.#now + this.#delay(ms, "setTimeout", false),
-			cb,
-			signal,
-			onAbort,
-			eventName: options?.eventName
-		});
-		return id;
-	}
-	clearTimeout(id) {
-		const timer = this.#timers.get(id);
-		if (timer) {
-			clearAbort(timer);
-			this.#timers.delete(id);
-		}
-	}
-	setInterval(ms, cb, options) {
-		const signal = options?.signal;
-		if (signal?.aborted) return -1;
-		const id = this.#nextId++;
-		const onAbort = trackAbort(signal, id, this.#intervals);
-		const d = this.#delay(ms, "setInterval", true);
-		this.#intervals.set(id, {
-			ms: d,
-			next: this.#now + d,
-			cb,
-			signal,
-			onAbort
-		});
-		return id;
-	}
-	clearInterval(id) {
-		const interval = this.#intervals.get(id);
-		if (interval) {
-			clearAbort(interval);
-			this.#intervals.delete(id);
-		}
-	}
-	#findEarliestDeadline(target) {
-		let earliest = target;
-		let found = false;
-		for (const t of this.#timers.values()) if (t.deadline <= target && t.deadline <= earliest) {
-			earliest = t.deadline;
-			found = true;
-		}
-		for (const t of this.#intervals.values()) if (t.next <= target && t.next <= earliest) {
-			earliest = t.next;
-			found = true;
-		}
-		return found ? earliest : null;
-	}
-	#fireTimersAt(deadline) {
-		const ids = [];
-		for (const [id, t] of this.#timers) if (t.deadline === deadline) ids.push(id);
-		for (const id of ids) {
-			const timer = this.#timers.get(id);
-			if (timer) {
-				clearAbort(timer);
-				this.#timers.delete(id);
-				timer.cb();
-			}
-		}
-	}
-	#fireIntervalsAt(deadline) {
-		const ids = [];
-		for (const [id, t] of this.#intervals) if (t.next === deadline) ids.push(id);
-		for (const id of ids) {
-			const interval = this.#intervals.get(id);
-			if (interval) {
-				interval.cb();
-				if (this.#intervals.has(id)) interval.next = this.#now + interval.ms;
-			}
-		}
-	}
-	advance(ms) {
-		if (!Number.isFinite(ms)) throw new RangeError(`[VirtualClock] invalid advance ms value: ${ms}`);
-		const target = this.#now + Math.max(0, ms);
-		while (true) {
-			const deadline = this.#findEarliestDeadline(target);
-			if (deadline === null) break;
-			this.#now = deadline;
-			this.#fireTimersAt(deadline);
-			this.#fireIntervalsAt(deadline);
-		}
-		this.#now = target;
-		this.#drain?.();
-	}
-	hasPending() {
-		return this.#timers.size > 0 || this.#intervals.size > 0;
-	}
-	pendingTimers() {
-		const result = [];
-		for (const [id, t] of this.#timers) result.push({
-			id,
-			deadline: t.deadline,
-			ms: t.deadline - this.#now,
-			eventName: t.eventName
-		});
-		return result;
-	}
-	setDrain(fn) {
-		this.#drain = fn;
-	}
-};
-//#endregion
-//#region src/queue.ts
-var InternalQueue = class {
-	#queue = [];
-	#index = 0;
-	#processing = false;
-	#stopped = false;
-	#settledResolvers = [];
-	get length() {
-		return this.#queue.length - this.#index;
-	}
-	push(...events) {
-		if (this.#stopped) return;
-		this.#queue.push(...events);
-	}
-	settled() {
-		if (this.length === 0 && !this.#processing) return Promise.resolve();
-		return new Promise((resolve) => {
-			this.#settledResolvers.push(resolve);
-		});
-	}
-	processCancellable(processEvent) {
-		this.#process(processEvent);
-	}
-	#process(processEvent) {
-		if (this.#processing) return;
-		this.#processing = true;
-		try {
-			while (this.#index < this.#queue.length) {
-				if (this.#stopped) break;
-				const event = this.#queue[this.#index++];
-				if (!processEvent(event)) {
-					this.#stopped = true;
-					break;
-				}
-			}
-		} finally {
-			this.#queue.length = 0;
-			this.#index = 0;
-			this.#processing = false;
-			this.#stopped = false;
-			if (this.#settledResolvers.length > 0) {
-				const resolvers = this.#settledResolvers.splice(0);
-				for (const resolve of resolvers) resolve();
-			}
-		}
-	}
-};
-//#endregion
-//#region src/subscribers.ts
-var Subscribers = class {
-	change = /* @__PURE__ */ new Set();
-	done = /* @__PURE__ */ new Set();
-	transition = /* @__PURE__ */ new Set();
-	#last = null;
-	seed(snapshot) {
-		this.#last = snapshot;
-	}
-	addChange(fn) {
-		this.change.add(fn);
-		const last = this.#last;
-		if (last) this.#safe(() => fn(last, last));
-		return () => this.change.delete(fn);
-	}
-	addDone(fn) {
-		this.done.add(fn);
-		return () => this.done.delete(fn);
-	}
-	addTransition(fn) {
-		this.transition.add(fn);
-		return () => this.transition.delete(fn);
-	}
-	emitChange(snapshot) {
-		const prev = this.#last ?? snapshot;
-		this.#last = snapshot;
-		for (const fn of this.change) this.#safe(() => fn(snapshot, prev));
-	}
-	emitDone() {
-		for (const fn of this.done) this.#safe(fn);
-	}
-	emitTransition(info) {
-		for (const fn of this.transition) this.#safe(() => fn(info));
-	}
-	clear() {
-		this.change.clear();
-		this.done.clear();
-		this.transition.clear();
-	}
-	#safe(fn) {
-		Either.from(fn);
-	}
-};
-//#endregion
-//#region src/snapshot.ts
-function buildSnapshot(s, regions, context, opts = {}) {
-	const path = [s.name];
-	const regionSnapshots = {};
-	for (const [regionName, child] of Object.entries(regions)) regionSnapshots[regionName] = child.snapshot();
-	const snap = {
-		path,
-		context,
-		regions: regionSnapshots
-	};
-	if (opts.payload !== void 0) snap.payload = opts.payload;
-	if (s.isFinal) snap.done = true;
-	if (opts.error !== void 0) snap.error = opts.error;
-	return snap;
-}
-//#endregion
-//#region src/effects.ts
-function runEffects(options) {
-	const pending = [];
-	const list = options.effects[options.state.name];
-	if (!list) return { pending };
-	for (const effectFn of list) {
-		if (options.abort.signal.aborted) break;
-		const attempt = Either.from(() => effectFn({
-			signal: options.abort.signal,
-			state: {
-				name: options.state.name,
-				payload: options.statePayload
-			},
-			event: options.event,
-			context: options.context,
-			emit: options.emit,
-			clock: options.clock
-		}));
-		if (attempt[0] !== void 0) {
-			options.onError(attempt[0], options.lastGood);
-			break;
-		}
-		const out = attempt[1];
-		if (out instanceof Promise) pending.push(out.catch((error) => {
-			if (options.abort.signal.aborted) return;
-			options.onError(error, options.lastGood);
-		}));
-	}
-	return { pending };
-}
-//#endregion
-//#region src/dispatch.ts
-function parseTarget(step) {
-	if (!step.state) return void 0;
-	if (step.state instanceof StateRef) return {
-		state: step.state,
-		payload: step.payload
-	};
-	return {
-		state: step.state.state,
-		payload: step.state.payload
-	};
-}
-//#endregion
-//#region src/context.ts
-var Context = class {
-	#get;
-	#set;
-	constructor(get, set) {
-		this.#get = get;
-		this.#set = set;
-	}
-	get() {
-		return this.#get();
-	}
-	set(value) {
-		this.#set(value);
-	}
-};
-//#endregion
-//#region src/builder.ts
-var ActorBuilder = class {
-	#transitions = {};
-	#effects = {};
-	on(stateRef, eventRef, fn) {
-		const sName = stateRef.name;
-		const eType = eventRef.type;
-		(this.#transitions[sName] ??= {})[eType] = fn;
-		return this;
-	}
-	onAny(eventRef, fn) {
-		const eType = eventRef.type;
-		(this.#transitions["Any"] ??= {})[eType] = fn;
-		return this;
-	}
-	effect(stateRef, fn) {
-		(this.#effects[stateRef.name] ??= []).push(fn);
-		return this;
-	}
-	/** @internal */ build() {
-		return {
-			transitions: this.#transitions,
-			effects: this.#effects
-		};
-	}
-};
-//#endregion
-//#region src/actor.ts
-function resolveInitial(initial) {
-	return initial instanceof StateRef ? initial : initial.state;
-}
-var Actor = class {
-	state;
-	clock;
-	#context;
-	#contextHandle;
-	#contextWritten = false;
-	#lastState;
-	#options;
-	#regions = {};
-	#children = /* @__PURE__ */ new Map();
-	#queue = new InternalQueue();
-	#subs = new Subscribers();
-	#effectAbort = null;
-	#outputHandler = null;
-	#internalIds;
-	#inputIds;
-	#internalBudget;
-	#draining = false;
-	get context() {
-		return this.#context;
-	}
-	get regions() {
-		return this.#regions;
-	}
-	get options() {
-		return this.#options;
-	}
-	constructor(options) {
-		registerActor(this, {
-			children: this.#children,
-			getOutputHandler: () => this.#outputHandler,
-			setOutputHandler: (fn) => {
-				this.#outputHandler = fn;
-			},
-			pushInternal: (event) => this.#queue.push(event),
-			drainInternal: () => this.#drainInternal(),
-			abortEffects: () => this.#abortEffects()
-		});
-		const builder = new ActorBuilder();
-		options.setup(builder);
-		const built = builder.build();
-		this.#options = {
-			...options,
-			transitions: built.transitions,
-			effects: built.effects
-		};
-		this.#internalIds = new Set((options.internal ?? []).map((e) => e.type));
-		this.#inputIds = new Set(options.inputs.map((e) => e.type));
-		this.#internalBudget = options.internalBudget ?? 1e4;
-		this.clock = options.clock ?? new RealClock();
-		this.clock.setDrain?.(() => this.#drainInternal());
-		const initState = resolveInitial(options.initial);
-		const stateNames = new Set(options.states.map((s) => s.name));
-		if (!stateNames.has(initState.name)) throw new Error(`[Actor] initial state "${initState.name}" not found in declared states [${[...stateNames].join(", ")}]`);
-		this.state = initState;
-		this.#statePayload = options.initial instanceof StateRef ? void 0 : options.initial.payload;
-		this.#context = options.context ?? {};
-		this.#lastState = initState;
-		this.#contextHandle = new Context(() => this.#context, (value) => {
-			this.#context = value;
-			this.#contextWritten = true;
-		});
-		if (options.regions) for (const [key, child] of Object.entries(options.regions)) {
-			this.#regions[key] = child;
-			const result = setOutputHandler(child, (event) => {
-				this.#queue.push(event);
-				this.#drainInternal();
-			});
-			if (result[0] !== void 0) throw new Error(result[0].message);
-			this.#children.set(key, child);
-		}
-		this.#runEffects({ type: "__init" }, this.#statePayload);
-		this.#subs.seed(this.snapshot());
-	}
-	on(event, fn) {
-		if (event === "change") {
-			const cb = fn;
-			return this.#subs.addChange(cb);
-		}
-		if (event === "done") {
-			const cb = fn;
-			return this.#subs.addDone(cb);
-		}
-		const cb = fn;
-		return this.#subs.addTransition(cb);
-	}
-	settled() {
-		return Promise.all([this.#queue.settled(), ...this.#pendingEffects]).then(() => void 0);
-	}
-	send(event) {
-		this.#dispatch(event);
-		this.#emitChangeIfDirty();
-	}
-	/**
-	* Manually restore the actor to a live state after a fatal `__error`.
-	* DANGER: the caller supplies state and context, so the trajectory is no
-	* longer deterministic ("same inputs, same trace"). Effects are not re-run
-	* and timers are not re-armed — processing resumes on the next event.
-	*/
-	recover(target) {
-		if (this.#error === null) return;
-		this.#error = null;
-		this.#queue = new InternalQueue();
-		this.#effectAbort = null;
-		this.state = target.state;
-		this.#statePayload = void 0;
-		this.#context = target.context;
-		this.#lastState = target.state;
-		this.#contextWritten = false;
-		this.#entry = null;
-		this.#pendingEffects = [];
-		this.#subs.emitChange(this.snapshot());
-	}
-	#emitChangeIfDirty() {
-		if (this.state === this.#lastState && !this.#contextWritten) return;
-		this.#lastState = this.state;
-		this.#contextWritten = false;
-		this.#subs.emitChange(this.snapshot());
-	}
-	#dispatch(event) {
-		if (this.#error !== null || this.state.isFinal) return;
-		const normalized = {
-			...event,
-			payload: event.payload ?? {}
-		};
-		const from = this.state.name;
-		const prev = this.#entry;
-		this.#entry = {
-			state: this.state,
-			context: this.#context
-		};
-		try {
-			const transitions = this.#options.transitions;
-			const stateTransition = transitions[this.state.name]?.[event.type];
-			const anyTransition = transitions["Any"]?.[event.type];
-			const result = this.#step(normalized, stateTransition, anyTransition);
-			this.#maybeEmitTransition(normalized, from, Boolean(stateTransition || anyTransition), result);
-			if (result.emitted || this.#queue.length > 0) this.#drainInternal();
-			else if (!stateTransition && !anyTransition) {
-				if (this.#internalIds.has(event.type)) this.#enterError("unhandled", event, /* @__PURE__ */ new Error(`[Actor] internal event "${event.type}" emitted but no handler in state "${this.state.name}"`));
-			}
-		} finally {
-			this.#entry = prev;
-		}
-	}
-	#step(normalized, stateTransition, anyTransition) {
-		const stateOutcome = stateTransition ? this.#applyStateStep(normalized, stateTransition) : { applied: false };
-		if (this.#error === null) {
-			const anyOutcome = this.#applyAnyStep(normalized, anyTransition, !stateOutcome.applied);
-			return {
-				emitted: anyOutcome.emitted,
-				transitioned: stateOutcome.applied || anyOutcome.transitioned,
-				target: stateOutcome.target ?? anyOutcome.target
-			};
-		}
-		return {
-			emitted: false,
-			transitioned: false
-		};
-	}
-	#maybeEmitTransition(event, from, handled, outcome) {
-		if (this.#error !== null) return;
-		if (!handled) return;
-		this.#subs.emitTransition({
-			event,
-			from,
-			to: outcome.target ?? this.state.name,
-			transitioned: outcome.transitioned
-		});
-	}
-	#applyStateStep(event, transition) {
-		let applied = false;
-		let target;
-		this.#safe("transition", event, () => {
-			const step = transition(event, {
-				context: this.#contextHandle,
-				actor: this
-			});
-			if (step.emit) this.#queue.push(...step.emit);
-			if (step.state) {
-				target = this.#applyTransition(event, step);
-				applied = true;
-			}
-		});
-		return {
-			applied,
-			target
-		};
-	}
-	#applyAnyStep(event, transition, allowTransition) {
-		if (transition === void 0) return {
-			emitted: false,
-			transitioned: false
-		};
-		let emitted = false;
-		let transitioned = false;
-		let target;
-		this.#safe("transition", event, () => {
-			const step = transition(event, {
-				context: this.#contextHandle,
-				actor: this
-			});
-			if (step.state && allowTransition) {
-				target = this.#applyTransition(event, step);
-				transitioned = true;
-			}
-			if (step.emit) {
-				this.#queue.push(...step.emit);
-				emitted = true;
-			}
-		});
-		return {
-			emitted,
-			transitioned,
-			target
-		};
-	}
-	snapshot() {
-		return buildSnapshot(this.state, this.#regions, this.#context, {
-			error: this.#error ?? void 0,
-			payload: this.#statePayload
-		});
-	}
-	#abortEffects() {
-		this.#effectAbort?.abort();
-		this.#subs.clear();
-	}
-	#applyTransition(event, step) {
-		if (this.#error !== null || !step.state) return void 0;
-		const resolved = parseTarget(step);
-		if (!resolved) return void 0;
-		if (!(resolved.state instanceof StateRef)) {
-			this.#enterError("transition", event, /* @__PURE__ */ new Error("invalid transition target"));
-			return;
-		}
-		this.#effectAbort?.abort();
-		this.state = resolved.state;
-		const target = this.state.name;
-		this.#statePayload = resolved.payload;
-		this.#entry = {
-			state: this.state,
-			context: this.#context
-		};
-		this.#runEffects(event, resolved.payload);
-		if (resolved.state.isFinal && this.#error === null) this.#subs.emitDone();
-		return target;
-	}
-	#runEffects(event, statePayload) {
-		const list = this.#options.effects[this.state.name];
-		if (!list) {
-			this.#effectAbort = null;
-			return;
-		}
-		const abort = new AbortController();
-		this.#effectAbort = abort;
-		const lastGood = this.#entry ?? {
-			state: this.state,
-			context: this.#context
-		};
-		const result = runEffects({
-			effects: { [this.state.name]: list },
-			state: this.state,
-			statePayload,
-			event,
-			context: this.#contextHandle,
-			emit: (e) => {
-				if (this.#error !== null || abort.signal.aborted) return;
-				this.#queue.push(e);
-				this.#drainInternal();
-			},
-			clock: this.clock,
-			abort,
-			lastGood,
-			onError: (error) => this.#enterError("effect", event, error, lastGood)
-		});
-		this.#pendingEffects.push(...result.pending);
-	}
-	#drainInternal() {
-		if (this.#draining) return;
-		this.#draining = true;
-		try {
-			const budget = this.#internalBudget;
-			let count = 0;
-			this.#queue.processCancellable((event) => {
-				if (this.#error !== null) return false;
-				if (count >= budget) {
-					this.#enterError("budget", event, /* @__PURE__ */ new Error("internal event budget exceeded"));
-					return false;
-				}
-				count++;
-				if (this.#internalIds.has(event.type) || this.#inputIds.has(event.type)) this.#dispatch(event);
-				else {
-					const outputHandler = this.#outputHandler;
-					if (outputHandler) {
-						if (!this.#safe("output", event, () => outputHandler(event))) return false;
-					}
-				}
-				return true;
-			});
-		} finally {
-			this.#draining = false;
-			this.#emitChangeIfDirty();
-		}
-	}
-	#statePayload;
-	#pendingEffects = [];
-	#errorState = new StateRef("__error", true);
-	#error = null;
-	#entry = null;
-	#safe(reason, event, fn) {
-		const attempt = Either.from(fn);
-		if (attempt[0] === void 0) return true;
-		this.#enterError(reason, event, attempt[0]);
-		return false;
-	}
-	#enterError(reason, event, error, lastGood) {
-		if (this.#error !== null) return;
-		const entry = lastGood ?? this.#entry ?? {
-			state: this.state,
-			context: this.#context
-		};
-		this.#error = {
-			error,
-			state: entry.state,
-			context: entry.context,
-			event,
-			reason
-		};
-		this.#effectAbort?.abort();
-		this.state = this.#errorState;
-		this.#statePayload = void 0;
-		this.#lastState = this.#errorState;
-		this.#contextWritten = false;
-		this.#subs.emitChange(this.snapshot());
-		this.#subs.emitDone();
-	}
-};
-//#endregion
-//#region src/event.ts
-function event(type) {
-	return () => new EventRef(type);
-}
-var EventRef = class {
-	type;
-	constructor(type) {
-		this.type = type;
-	}
-	is(anyEvent) {
-		return !!anyEvent && typeof anyEvent === "object" && "type" in anyEvent && anyEvent.type === this.type;
-	}
-	create(payload) {
-		return payload === void 0 ? { type: this.type } : {
-			type: this.type,
-			payload
-		};
-	}
-};
-//#endregion
-export { Actor, Context, EventRef, RealClock, StateRef, VirtualClock, event, state };
+import{Either as e}from"@mantaq/utils";function t(e){let t=e;return typeof t==`function`?t:()=>({})}function n(e){return e}function r(){let e={},r={},i={on(n,{eventRef:r,handler:a}){let o=n.name,s=r.type;return(e[o]??={})[s]=t(a),i},onAny(n){let r=n.eventRef.type;return(e.Any??={})[r]=t(n.handler),i},effect(e,{name:t,fn:a}){return(r[e.name]??=[]).push({name:t,fn:n(a)}),i},build(){return{transitions:e,effects:r}}};return i}function i(e){return{get:e.get,set:e.set}}function a(e){return()=>c(e,{isFinal:!1})}const o=new WeakSet;function s(e){return typeof e==`object`&&!!e&&o.has(e)}function c(e,t){let n={name:e,isFinal:t.isFinal,regions(e){return n._regions=e,n},final(){let e=c(n.name,{isFinal:!0});return e._regions=n._regions,e},create(e){return{state:n,payload:e}}};return o.add(n),n}function l(e){let t=e.state;if(t)return`state`in t?{state:t.state,payload:t.payload}:{state:t,payload:e.payload}}function u(e){if(e instanceof Promise)return!0;let t=e;return typeof t==`object`&&!!t&&typeof t.then==`function`}function d(t){let n=[],r=[],i=t.effects[t.state.name];if(!i)return{pending:n,ran:r};for(let{name:a,fn:o}of i){if(t.abort.signal.aborted)break;let i,s=e.from(()=>(i=o({signal:t.abort.signal,state:{name:t.state.name,payload:t.statePayload},event:t.event,context:t.context,emit:t.emit,clock:t.clock}),!0));if(s[0]!==void 0){t.onError(s[0],t.lastGood);break}if(r.push(a),u(i)){let e=Promise.resolve(i).then(()=>void 0,e=>{t.abort.signal.aborted||t.onError(e,t.lastGood)});n.push(e)}}return{pending:n,ran:r}}function ee(e){return e??{}}function f(){let e=[],t=0,n=!1,r=!1,i=[];function a(){let e=i.splice(0);for(let t of e)t()}function o(i){if(!n){n=!0;try{for(;t<e.length&&!r;){let n=e[t];if(t++,!i(n)){r=!0;break}}}finally{e.length=0,t=0,n=!1,r=!1,a()}}}return{get length(){return e.length-t},push(...t){r||e.push(...t)},clear(){e.length=0,t=0,a()},settled(){return e.length-t===0&&!n?Promise.resolve():new Promise(e=>{i.push(e)})},processCancellable(e){o(e)}}}function p(){let e=Date.now(),t=new Map;function n(e){let n=t.get(e);n&&(n.signal.removeEventListener(`abort`,n.onAbort),t.delete(e))}return{now(){return Date.now()-e},setTimeout(e,{signal:r,cb:i}){if(r?.aborted)return-1;let a=Number(globalThis.setTimeout(()=>{n(a),i()},e));if(r){function e(){globalThis.clearTimeout(a),n(a)}t.set(a,{signal:r,onAbort:e}),r.addEventListener(`abort`,e,{once:!0})}return a},clearTimeout(e){globalThis.clearTimeout(e),n(e)},setInterval(e,{signal:r,cb:i}){if(r?.aborted)return-1;let a=Number(globalThis.setInterval(i,e));if(r){function e(){globalThis.clearInterval(a),n(a)}t.set(a,{signal:r,onAbort:e}),r.addEventListener(`abort`,e,{once:!0})}return a},clearInterval(e){globalThis.clearInterval(e),n(e)}}}function m(e){let{stateRef:t,regions:n,context:r}=e,i=[t.name],a={};for(let[e,t]of Object.entries(n))a[e]=t.snapshot();let o={path:i,context:r,regions:a};return e.payload!==void 0&&(o.payload=e.payload),t.isFinal&&(o.done=!0),e.error!==void 0&&(o.error={...e.error,context:h(e.error.context)}),o}function h(e){return typeof structuredClone==`function`?structuredClone(e):JSON.parse(JSON.stringify(e))}function g(){let t=new Set,n=new Set,r=new Set,i=new Set,a=new Set,o;function s(t){e.from(()=>(t(),!0))}return{change:t,done:n,transition:r,error:i,output:a,seed(e){o=e},addChange(e){t.add(e);let n=o;return n&&s(()=>e(n,n)),()=>t.delete(e)},addDone(e){return n.add(e),()=>n.delete(e)},addTransition(e){return r.add(e),()=>r.delete(e)},addError(e){i.add(e);let t=o?.error;return t&&s(()=>e(t)),()=>i.delete(e)},addOutput(e){return a.add(e),()=>a.delete(e)},emitChange(e){let n=o??e;o=e;for(let r of t)s(()=>r(e,n))},emitDone(){for(let e of n)s(e)},emitTransition(e){for(let t of r)s(()=>t(e))},emitError(e){for(let t of i)s(()=>t(e))},emitOutput(e){for(let t of a)t(e)},clear(){t.clear(),n.clear(),r.clear(),i.clear(),a.clear()}}}function _(e,t){let n=e?()=>{t.entries.delete(t.timerId)}:void 0;return e&&n&&e.addEventListener(`abort`,n,{once:!0}),n}function v(e){e.signal&&e.onAbort&&e.signal.removeEventListener(`abort`,e.onAbort)}function y(){let e=0,t=new Map,n=new Map,r=1,i=new Set;function a(e,t){if(!Number.isFinite(e))throw RangeError(`[VirtualClock] invalid ${t.method} ms value: ${e}`);return!0}function o(e,t){return a(e,{method:t.method}),e<=0?+!!t.interval:e}function s(e){let r=e,i=!1;for(let n of t.values())n.deadline<=e&&n.deadline<=r&&(r=n.deadline,i=!0);for(let t of n.values())t.next<=e&&t.next<=r&&(r=t.next,i=!0);return i?r:void 0}function c(e){let n=[];for(let[r,i]of t)i.deadline===e&&n.push(r);for(let e of n){let n=t.get(e);n&&(v(n),t.delete(e),n.cb())}}function l(t){let r=[];for(let[e,i]of n)i.next===t&&r.push(e);for(let t of r){let r=n.get(t);r&&(r.cb(),n.has(t)&&(r.next=e+r.ms))}}return{now(){return e},setTimeout(n,{signal:i,cb:a,eventName:s}){if(i?.aborted)return-1;let c=r++,l=_(i,{timerId:c,entries:t});return t.set(c,{deadline:e+o(n,{method:`setTimeout`,interval:!1}),cb:a,signal:i,onAbort:l,eventName:s}),c},clearTimeout(e){let n=t.get(e);n&&(v(n),t.delete(e))},setInterval(t,{signal:i,cb:a}){if(i?.aborted)return-1;let s=r++,c=_(i,{timerId:s,entries:n}),l=o(t,{method:`setInterval`,interval:!0});return n.set(s,{ms:l,next:e+l,cb:a,signal:i,onAbort:c}),s},clearInterval(e){let t=n.get(e);t&&(v(t),n.delete(e))},advance(t){a(t,{method:`advance`});let n=e+Math.max(0,t),r=-1,o=0;for(;;){let t=s(n);if(t===void 0)break;if(t===r){if(++o>=1e6)break}else o=0,r=t;e=t,c(t),l(t)}e=n;for(let e of i)e()},hasPending(){return t.size>0||n.size>0},pendingTimers(){let n=[];for(let[r,i]of t)n.push({id:r,deadline:i.deadline,ms:i.deadline-e,eventName:i.eventName});return n},setDrain(e){i.add(e)}}}function b(e){return`state`in e?e.state:e}function x(e,t){if(!e.has(t.candidate.name))throw Error(`[Actor] initial state "${t.candidate.name}" not found in declared states [${[...e].join(`, `)}]`);return!0}function S(t){let n=r();t.setup(n);let a=n.build(),o={...t,transitions:a.transitions,effects:a.effects},u=new Set((t.internal??[]).map(e=>e.type)),_=new Set(t.inputs.map(e=>e.type)),v=t.internalBudget??1e4,y=t.clock??p();y.setDrain?.(Y);let S,C,w=ee(t.context),T,E=!0,D,O={},k=f(),A=g(),j,M=!1,N=[],P,F,I=!1,L=!1,R=c(`__error`,{isFinal:!0}),z=i({get:()=>w,set:e=>{w=e,L=!0,E=!0}}),B=b(t.initial);x(new Set(t.states.map(e=>e.name)),{candidate:B}),S=B;let V=t.initial;if(C=!s(V)&&`payload`in V?V.payload:void 0,D=B,t.regions)for(let[e,n]of Object.entries(t.regions))O[e]=n,n.on(`output`,{fn:e=>{k.push(e),Y()}});let H={get state(){return S},clock:y,get regions(){return O},get context(){return w},get options(){return o},on(e,t){return{change:e=>A.addChange(e),done:e=>A.addDone(e),transition:e=>A.addTransition(e),error:e=>A.addError(e),output:e=>A.addOutput(e)}[e](t.fn)},settled(){return Q()},pendingEffectCount(){return N.length},send(e){I||(G(e),U())},recover:W,snapshot(){return K()},inject(e){ae(e)},dispose(){oe()}};J({type:`__init`},{payloadForState:C}),A.seed(K());function U(){S===D&&!L||(D=S,L=!1,A.emitChange(K()))}function W(e){P===void 0||I||(j?.abort(),j=void 0,k.clear(),k=f(),P=void 0,S=e.state,C=void 0,w=e.context,D=e.state,L=!1,E=!0,T=void 0,F=void 0,N=[],A.emitChange(K()))}function G(e){if(P!==void 0||S.isFinal)return;let t={...e,payload:e.payload??{}},n=S.name,r=F;F={state:S,context:w};try{let r=o.transitions,i=r[S.name]?.[e.type],a=r.Any?.[e.type],s=te(t,{stateTransition:i,anyTransition:a});ne(t,{from:n,handled:!!(i||a),outcome:s}),s.emitted||k.length>0?Y():!i&&!a&&u.has(e.type)&&Z(`unhandled`,{event:e,error:Error(`[Actor] internal event "${e.type}" emitted but no handler in state "${S.name}"`)})}finally{F=r}}function te(e,t){let n=t.stateTransition?re(e,{transition:t.stateTransition}):{applied:!1,target:void 0,effects:void 0};if(P===void 0){let r=ie(e,{transition:t.anyTransition,allowTransition:!n.applied});return{emitted:r.emitted,transitioned:n.applied||r.transitioned,target:n.target??r.target,effects:n.effects??r.effects}}return{emitted:!1,transitioned:!1}}function ne(e,t){P===void 0&&t.handled&&A.emitTransition({event:e,from:t.from,to:t.outcome.target??S.name,transitioned:t.outcome.transitioned,effects:t.outcome.effects??[]})}function re(e,t){let n=!1,r,i;return X(`transition`,{event:e,operation:()=>{let a=t.transition(e,{context:z,actor:$()});if(a.emit&&k.push(...a.emit),a.state){let t=q(e,{step:a});r=t.target,i=t.effects,n=!0}}}),{applied:n,target:r,effects:i}}function ie(e,t){if(t.transition===void 0)return{emitted:!1,transitioned:!1};let n=t.transition,r=!1,i=!1,a,o;return X(`transition`,{event:e,operation:()=>{let s=n(e,{context:z,actor:$()});if(s.state&&t.allowTransition){let t=q(e,{step:s});a=t.target,o=t.effects,i=!0}s.emit&&(k.push(...s.emit),r=!0)}}),{emitted:r,transitioned:i,target:a,effects:o}}function K(){return(T===void 0||E)&&(T=h(w),E=!1),m({stateRef:S,regions:O,context:T,error:P,payload:C})}function q(e,t){if(P!==void 0||!t.step.state)return{};let n=l(t.step);if(!n)return{};if(!s(n.state))return Z(`transition`,{event:e,error:Error(`invalid transition target`)}),{};j?.abort(),S=n.state;let r=S.name;C=n.payload,F={state:S,context:w};let i=J(e,{payloadForState:n.payload});return n.state.isFinal&&P===void 0&&A.emitDone(),{target:r,effects:i}}function J(e,t){if(I)return[];let n=o.effects[S.name];if(!n)return j=void 0,[];let r=new AbortController;j=r;let i=F??{state:S,context:w},a=d({effects:{[S.name]:n},state:S,statePayload:t.payloadForState,event:e,context:z,emit:e=>{P!==void 0||r.signal.aborted||(k.push(e),Y())},clock:y,abort:r,lastGood:i,onError:t=>Z(`effect`,{event:e,error:t})});for(let e of a.pending)N.push(e),e.finally(()=>{let t=N.indexOf(e);t!==-1&&N.splice(t,1)}).catch(()=>{});return a.ran}function Y(){if(!(M||I)){M=!0;try{let e=0;k.processCancellable(t=>{if(P!==void 0)return!1;if(e>=v)return Z(`budget`,{event:t,error:Error(`internal event budget exceeded`)}),!1;if(e++,u.has(t.type)||_.has(t.type))G(t);else if(!X(`output`,{event:t,operation:()=>A.emitOutput(t)}))return!1;return!0})}finally{M=!1,U()}}}function X(t,n){let r=e.from(()=>(n.operation(),!0));return r[0]===void 0||(Z(t,{event:n.event,error:r[0]}),!1)}function Z(e,t){if(P!==void 0)return;let n=t.lastGood??F??{state:S,context:w};P={error:t.error,state:n.state,context:n.context,event:t.event,reason:e},j?.abort(),S=R,C=void 0,D=R,L=!1,A.emitError(P),A.emitChange(K()),A.emitDone()}function ae(e){I||(k.push(e),Y())}function oe(){if(!I){I=!0,j?.abort(),j=void 0;for(let e of Object.values(O))e.dispose();O={},k.clear(),A.clear(),N=[]}}function Q(){return k.settled().then(()=>{if(N.length!==0)return Promise.all(N).then(()=>Q())})}function $(){return H}return H}const C=new Map;function w(e){let t=C.get(e);return t||(t=Symbol(`mantaq:event:${e}`),C.set(e,t)),t}const T=new WeakMap;function E(e){return()=>D(e)}function D(e){let t=w(e),n=function(e){return typeof e==`object`&&!!e&&T.get(e)?.has(t)===!0};function r(n){let r=n===void 0?{type:e}:{type:e,payload:n},i=T.get(r);return i||(i=new Set,T.set(r,i)),i.add(t),r}return{type:e,is:n,create:r}}export{S as Actor,i as Context,D as EventRef,p as RealClock,c as StateRef,y as VirtualClock,E as event,s as isStateRef,a as state};