raf-effect-atom 0.0.0 → 0.2.0

package/dist/internal/seeds.mjs

@@ -0,0 +1,56 @@
+import * as Predicate from "effect/Predicate";
+// src/internal/seeds.ts
+const seedings = /* @__PURE__ */ new WeakMap();
+const waiting = (registry) => {
+	const seeding = seedings.get(registry);
+	return seeding === void 0 || seeding.resolved ? void 0 : seeding;
+};
+/**
+* Runs `seed` on `registry`. Until a seed's promise settles, the verbs wait
+* for it.
+*/
+const run = (registry, seed) => {
+	const result = seed(registry);
+	if (!Predicate.isPromiseLike(result)) return;
+	const seeded = Promise.resolve(result);
+	const seeding = {
+		deferred: [],
+		resolved: false,
+		seeded
+	};
+	seeded.then(() => {
+		seeding.resolved = true;
+	}, () => void 0);
+	seedings.set(registry, seeding);
+};
+/**
+* The seed the verbs wait for: `undefined` once it has resolved, and the
+* rejected promise once it has failed.
+*/
+const pending = (registry) => waiting(registry)?.seeded;
+/**
+* Runs `start` once the registry's seed has resolved: at once, unless it's
+* still running. A seed that fails never runs it.
+*/
+const afterSeed = (registry, start) => {
+	const seeding = waiting(registry);
+	if (seeding === void 0) {
+		start();
+		return;
+	}
+	const started = seeding.seeded.then(start);
+	started.catch(() => void 0);
+	seeding.deferred.push(started);
+};
+/**
+* Waits for the registry's seed and the starts that waited for it, so
+* `Hydration.dehydrate` sees every atom the verbs started. Rejects with the
+* seed's error, or with a start's defect.
+*/
+const settled = async (registry) => {
+	const seeding = seedings.get(registry);
+	if (seeding === void 0) return;
+	await seeding.seeded;
+	await Promise.all(seeding.deferred);
+};
+export { afterSeed, pending, run, settled };

package/dist/internal/waterfalls.mjs

@@ -38,7 +38,7 @@ const nameOf = (atom) => {
 	const key = keyOf(atom);
 	return atom.label?.[0] ?? (Predicate.isString(key) ? key : "an atom");
 };
-const message = (read, started) => `raf-effect-atom: rendering ${read === started ? `read ${read}` : `read ${read}, which started ${started}`} before anything else had started it, so its request waits for this render: a request waterfall. Start it before render, in the route's loader or the server component (atoms.prefetch or atoms.ensure). If the state that picks it, such as a page, a filter or an open dialog, isn't in the URL, put it there so the loader can. As escape hatches for state that can't be in the URL: start it in the event handler that changes the state (Loader.make(registry).prefetch), or, if its input only exists in render, read it with useAtomResult(useWaterfall(atom)). ${docs}`;
+const message = (read, started) => `raf-effect-atom: rendering ${read === started ? `read ${read}` : `read ${read}, which started ${started}`} before anything else had started it, so its request waits for this render: a request waterfall. Start it before render and pass its handle down, from the route's loader or the server component (atoms.prefetch(source, ...args) or atoms.ensure). If the state that picks it, such as a page, a filter or an open dialog, isn't in the URL, put it there so the loader can. As escape hatches for state that can't be in the URL: start it in the event handler that changes the state (Loader.make(registry).prefetch), or, if its input only exists in render, read it with useAtomResult(source, useWaterfall(source, ...args)). ${docs}`;
 const warned = /* @__PURE__ */ new WeakMap();
 /**
 * The nodes a read started in throw mode, with the error. React renders a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raf-effect-atom",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "description": "Render-as-you-fetch for Effect Atom: start atoms from route loaders and stream them into the browser, typed failures intact",
   "keywords": [
     "effect",
@@ -58,7 +58,7 @@
     "@types/react-dom": "19.3.0",
     "@vitest/coverage-v8": "5.0.5",
     "effect": "4.0.6",
-    "effect-atom-boundary": "0.0.0",
+    "effect-atom-boundary": "0.1.0",
     "happy-dom": "21.0.4",
     "react": "19.3.1",
     "react-dom": "19.3.1",