@mantaq/sugar 0.2.0 → 0.3.0

package/README.md

@@ -307,6 +307,29 @@ broadcast(map, { type: "ping" });
 
 Works with `ActorMap` or any object implementing `{ keys(): string[]; send(key, event): void }`.
 
+### `onOutput(actor, handler)`
+
+Route an actor's emitted outputs to a handler. `regions` auto-wire child
+outputs into the parent; ActorMap children do not — this is the public
+wrapper for that wiring seam, no internal import needed:
+
+```ts
+import { ActorMap, onOutput } from "@mantaq/sugar";
+
+const requests = new ActorMap(
+  (id) => {
+    const child = createHandler(id);
+    onOutput(child, (e) => {
+      if (result.is(e)) parent.send(e);
+    });
+    return child;
+  },
+  { autoReap: true },
+);
+```
+
+The `is()` guard narrows the output to the receiver's declared input.
+
 ### `tag(...stateRefs)`
 
 Group multiple `StateRef`s and test if a snapshot matches any of them. Useful for UI state grouping.

package/dist/index.d.mts

@@ -60,6 +60,16 @@ declare function states<const T extends StatesArg[]>(...entries: T): StatesRecor
 //#region src/event.d.ts
 declare function events<T extends string>(...names: T[]): { [K in T]: EventRef<K>; };
 //#endregion
+//#region src/output.d.ts
+/**
+ * Route an actor's emitted outputs to a handler.
+ *
+ * `regions` auto-wire child outputs into the parent. ActorMap children do
+ * not — this is the public wrapper for that wiring seam. One call in the
+ * factory connects a child's declared outputs to a receiver.
+ */
+declare function onOutput(actor: AnyActor, handler: (event: InternalEvent) => void): void;
+//#endregion
 //#region src/effects/promise.d.ts
 type EmitFn = (event: {
   type: string;
@@ -89,4 +99,4 @@ declare function tag(...stateNames: StateRef<string, unknown>[]): Tag;
 declare function isIn(snapshot: Snapshot, stateRefName: string): boolean;
 declare function activeLeaves(snapshot: Snapshot): string[];
 //#endregion
-export { ActorMap, type EventLike, type SendableEvent, type SendableMap, activeLeaves, broadcast, events, isIn, matches, states, tag, withPromise, withTimeout };
+export { ActorMap, type EventLike, type SendableEvent, type SendableMap, activeLeaves, broadcast, events, isIn, matches, onOutput, states, tag, withPromise, withTimeout };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { abortEffects } from "@mantaq/core/internal";
+import { abortEffects, setOutputHandler } from "@mantaq/core/internal";
 import { Either } from "@mantaq/utils";
 import { event, state } from "@mantaq/core";
 //#region src/actors/matches.ts
@@ -45,6 +45,7 @@ var ActorMap = class {
 			}
 			const off = child.on("done", () => {
 				if (this.#actors.get(key) === child) this.#actors.delete(key);
+				this.#reapers.delete(key);
 			});
 			this.#reapers.set(key, off);
 		}
@@ -96,6 +97,18 @@ function events(...names) {
 	return result;
 }
 //#endregion
+//#region src/output.ts
+/**
+* Route an actor's emitted outputs to a handler.
+*
+* `regions` auto-wire child outputs into the parent. ActorMap children do
+* not — this is the public wrapper for that wiring seam. One call in the
+* factory connects a child's declared outputs to a receiver.
+*/
+function onOutput(actor, handler) {
+	setOutputHandler(actor, handler);
+}
+//#endregion
 //#region src/effects/promise.ts
 function withPromise(promise, signal, emit, events) {
 	promise.then((data) => {
@@ -137,4 +150,4 @@ function tag(...stateNames) {
 	return { has: (snapshot) => names.some((name) => isIn(snapshot, name)) };
 }
 //#endregion
-export { ActorMap, activeLeaves, broadcast, events, isIn, matches, states, tag, withPromise, withTimeout };
+export { ActorMap, activeLeaves, broadcast, events, isIn, matches, onOutput, states, tag, withPromise, withTimeout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mantaq/sugar",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Userland sugar for mantaq actors — matches, effect helpers, transition utilities.",
   "license": "MIT",
   "repository": {
@@ -20,8 +20,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@mantaq/core": "0.2.0",
-    "@mantaq/utils": "0.0.2"
+    "@mantaq/utils": "0.0.2",
+    "@mantaq/core": "0.2.0"
   },
   "devDependencies": {
     "@stryker-mutator/core": "^9",