@adobe/ecs 0.1.0 → 0.2.1

package/src/perftest/tails.ts

@@ -1,6 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 /// <reference types="node" />
-import { Component } from "../interface/component/component.js";
-import { Resource } from "../interface/resource/resource.js";
 import { always } from "../interface/resources/always.js";
 import { eachTick, ticksAfter } from "./observer.js";
 import { workers } from "../interface/resources/workers.js";
@@ -9,7 +8,9 @@ import type { World } from "../interface/world/world.js";
 import { backToBack, createWorld, type CreatedWorld } from "../implementation/index.js";
 import { tailWriters } from "../implementation/world/tails.js";
 import type { Benchmark } from "./benchmark.js";
-import { reportOf, runReported } from "../implementation/world/reports.test-helper.js";
+import { runReported } from "../implementation/world/outcomes.test-helper.js";
+import type { Mat4x4, U32, Vec3 } from "../interface/math/index.js";
+import type { Schema } from "../interface/schema/schema.js";
 
 // Tails: terminal systems on a joined worker, which claims "tailsBenchmark", running after their tick's sync point
 // while the world goes on. The joined thread is `joined.ts`.
@@ -25,24 +26,21 @@ declare module "@adobe/ecs" {
         tailsBenchmark: true;
     }
     export interface Components {
-        [place]: { type: readonly [number, number, number] };
-        [pose]: { type: readonly [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number] };
+        [place]: { type: Vec3 };
+        [pose]: { type: Mat4x4 };
     }
     export interface Resources {
-        [surface]: { type: { readonly name: string }; thread: "tailsBenchmark" };
-        [poked]: { type: number };
-        [rowWork]: { type: number };
+        [surface]: { type: Surface; thread: "tailsBenchmark" };
+        [poked]: { type: Schema.Type<{ type: "integer" }>; default: 0 };
+        [rowWork]: { type: U32 };
         [worldWork]: { type: number };
     }
 }
-Component.register(place, { type: { type: "array", items: { type: "number", precision: 1 }, minItems: 3, maxItems: 3 } });
-Component.register(pose, { type: { type: "array", items: { type: "number", precision: 1 }, minItems: 16, maxItems: 16 } });
 /** An object of the joined thread, as a canvas or the DOM is, which places the systems reading it there. */
-const surfaceStart = { name: "surface" };
-Resource.register(surface, { type: { type: "object", properties: { name: { type: "string" } }, default: surfaceStart }, thread: "tailsBenchmark" });
-Resource.register(poked, { type: { type: "integer", default: 0 } });
-Resource.register(rowWork, { type: { type: "integer", minimum: 0, maximum: 1_000_000, default: 0 } });
-Resource.register(worldWork, { type: { type: "number", default: 0 } });
+const surfaceStart = { name: "surface" } as const;
+/** The surface tails draw to, which starts as `surfaceStart`, so they can tell it apart by identity. */
+type Surface = { readonly name: string };
+const Surface = { default: surfaceStart };
 
 /** What the tails read, so their reads aren't dead. */
 export const drawn = { sum: 0 };
@@ -53,36 +51,36 @@ export const lateRows = 10_000;
 /** Ticks in each timed stretch of the prompt tail. */
 export const tailTicks = 1_000;
 
-const spawnPlaces = System.create({ name: "tails/spawnPlaces" }, ({ commands }) => {
+const spawnPlaces = System.create({}, ({ commands }) => {
     for (let k = 0; k < promptRows; k++) commands.spawn([place])({ [place]: [k, 0, 0] });
 });
-const spawnPoses = System.create({ name: "tails/spawnPoses" }, ({ commands }) => {
+const spawnPoses = System.create({}, ({ commands }) => {
     for (let k = 0; k < lateRows; k++) commands.spawn([place, pose])({ [place]: [k, 0, 0], [pose]: [k, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1] });
 });
 
-const here = System.create({ name: "tails/here" }, () => {});
+const here = System.create({}, () => {});
 /** On the joined thread, terminal: reads every row's place, as a DOM-writing system reads positions. */
-const draw = System.create({ name: "tails/draw", components: { read: [place] }, resources: { read: [surface] } }, (row, { resources }) => {
+const draw = System.create({ components: { with: [place] } }, (row, { resources }) => {
     if (resources[surface] === surfaceStart) drawn.sum += row[place][0];
 });
 /** A tick of a world system and a 1,000-row tail that finishes before the next tick needs it. */
-export const promptTick = System.create({ name: "tails/promptTick", systems: [here, draw] });
+export const promptTick = System.create({ systems: [here, draw] });
 
 /** On the joined thread, ahead of the late tail: busy for a while, as a main thread is with layout. */
-const busy = System.create({ name: "tails/busy", resources: { read: [surface] } }, ({ resources }) => {
+const busy = System.create({}, ({ resources }) => {
     const until = performance.now() + 4;
     while (performance.now() < until && resources[surface] === surfaceStart);
 });
 /** On the joined thread, terminal, after `busy`: reads every row's place and pose, and the resource `poke` writes. */
-const copied = System.create({ name: "tails/copied", components: { read: [place, pose] }, resources: { read: [surface, poked] }, after: [busy] }, (row, { resources }) => {
+const copied = System.create({ components: { with: [place, pose] }, after: [busy] }, (row, { resources }) => {
     if (resources[surface] === surfaceStart) drawn.sum += row[place][0] + row[pose][15] + resources[poked];
 });
-export const lateTick = System.create({ name: "tails/lateTick", systems: [busy, copied] });
+export const lateTick = System.create({ systems: [busy, copied] });
 /** On the world's thread: writes what the late tail reads, so it copies the rest of the tail's reads first. */
-const poke = System.create({ name: "tails/poke", resources: { write: [poked] } }, ({ resources }) => {
+const poke = System.create({}, ({ resources }) => {
     resources[poked] += 1;
 });
-const nothing = System.create({ name: "tails/nothing" }, () => {});
+const nothing = System.create({}, () => {});
 
 /** Steps of work each row of the overlapping tail does, about 2.5 ms over 10,000 rows; the world's work after its writer. */
 export const overlapWork = 40;
@@ -91,23 +89,23 @@ export const overlapWorldMilliseconds = 2;
 export const overlapTicks = 100;
 
 /** On the world's thread: writes every row's place, which the last tick's tail still reads. */
-const overlapWrite = System.create({ name: "tails/overlapWrite", components: { write: [place] } }, row => {
+const overlapWrite = System.create({ kernel: false, components: { with: [place] } }, row => {
     row[place] = [row[place][0], 1, 0];
 });
 /** On the world's thread, after the writer: the rest of the tick's work, as systems reading what it wrote do. */
-const overlapSimulate = System.create({ name: "tails/overlapSimulate", resources: { read: [worldWork] }, after: [overlapWrite] }, ({ resources }) => {
+const overlapSimulate = System.create({ after: [overlapWrite] }, ({ resources }) => {
     const until = performance.now() + resources[worldWork];
     while (performance.now() < until);
 });
 /** On the joined thread, terminal: works on every row's place and pose, as a DOM-writing system on main does. */
-const overlapDraw = System.create({ name: "tails/overlapDraw", components: { read: [place, pose] }, resources: { read: [surface, rowWork] }, after: [overlapWrite] }, (row, { resources }) => {
+const overlapDraw = System.create({ components: { with: [place, pose] }, after: [overlapWrite] }, (row, { resources }) => {
     if (resources[surface] !== surfaceStart) return;
     let sum = row[place][0] + row[pose][15];
     for (let k = resources[rowWork]; k > 0; k--) sum = Math.sqrt(sum + k);
     drawn.sum += sum;
 });
-export const overlapTick = System.create({ name: "tails/overlapTick", systems: [overlapWrite, overlapSimulate, overlapDraw] });
-const setOverlap = System.create({ name: "tails/setOverlap", resources: { write: [rowWork, worldWork] } }, ({ resources }) => {
+export const overlapTick = System.create({ systems: [overlapWrite, overlapSimulate, overlapDraw] });
+const setOverlap = System.create({}, ({ resources }) => {
     resources[rowWork] = overlapWork;
     resources[worldWork] = overlapWorldMilliseconds;
 });
@@ -121,9 +119,10 @@ const joinedFile = "./joined.js";
 const startClaiming = async (world: CreatedWorld): Promise<{ readonly terminate: () => Promise<void> }> => {
     const message = (port: unknown) => ({ kind: "port", port, threads: ["tailsBenchmark"] });
     let terminate: () => Promise<void>;
+    let shared: Promise<void>;
     if (typeof globalThis.Worker === "function") {
         const { port1, port2 } = new MessageChannel();
-        world.share(port1);
+        shared = world.share(port1);
         const worker = new globalThis.Worker(new URL("./joined.js", import.meta.url), { type: "module" });
         await new Promise(resolve => {
             worker.onmessage = resolve;
@@ -134,7 +133,7 @@ const startClaiming = async (world: CreatedWorld): Promise<{ readonly terminate:
     else {
         const threads = globalThis.process.getBuiltinModule("node:worker_threads");
         const { port1, port2 } = new threads.MessageChannel();
-        world.share(port1);
+        shared = world.share(port1);
         const worker = new threads.Worker(new URL(joinedFile, import.meta.url));
         await new Promise(resolve => {
             worker.once("message", resolve);
@@ -142,15 +141,7 @@ const startClaiming = async (world: CreatedWorld): Promise<{ readonly terminate:
         });
         terminate = async () => { await worker.terminate(); };
     }
-    await new Promise<void>(resolve => {
-        let done = false;
-        const stop = world.threads(threads => {
-            if (done || threads.at(-1)?.status !== "joined") return;
-            done = true;
-            queueMicrotask(() => stop());
-            resolve();
-        });
-    });
+    await shared;
     return { terminate };
 };
 
@@ -181,8 +172,9 @@ const prompt = async (stretches = 5): Promise<number> => {
         });
     }
     finally {
-        await joined.terminate();
+        // Disposed first: ticks after the thread ended would fail its systems, reported out of band.
         await world.dispose();
+        await joined.terminate();
         driver.close();
     }
     return best;
@@ -206,19 +198,18 @@ const late = async (rounds = 30): Promise<number> => {
             await world.run(nothing);
             await ticked;
             const start = performance.now();
-            const run = await world.run(poke);
+            // A run whose tail failed rejects.
+            await world.run(poke);
             const time = performance.now() - start;
-            // Read by a run of its own, after the timed one.
-            const report = await reportOf(world, run);
-            if (report.failures.length > 0) throw new Error(`tail late snapshot: ${report.failures[0].message}`);
             if (round > 1) best = Math.min(best, time);
             // The tail and the tick the run made finish.
             await new Promise(resolve => setTimeout(resolve, 12));
         }
     }
     finally {
-        await joined.terminate();
+        // Disposed first: ticks after the thread ended would fail its systems, reported out of band.
         await world.dispose();
+        await joined.terminate();
         driver.close();
     }
     return best;
@@ -257,8 +248,9 @@ const overlap = async (waiting: boolean, stretches = 5): Promise<number> => {
     }
     finally {
         tailWriters.wait = false;
-        await joined.terminate();
+        // Disposed first: ticks after the thread ended would fail its systems, reported out of band.
         await world.dispose();
+        await joined.terminate();
         driver.close();
     }
     return best;

package/src/perftest/transfers.ts

@@ -1,4 +1,4 @@
-import { Resource } from "../interface/resource/resource.js";
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { workers } from "../interface/resources/workers.js";
 import { System } from "../interface/system/system.js";
 import { createWorld, type CreatedWorld } from "../implementation/index.js";
@@ -17,24 +17,15 @@ declare module "@adobe/ecs" {
     }
 }
 /** An object of the claimed thread, which places the system reading it there. */
-Resource.register(sink, { thread: "transfersBenchmark" });
 
 /** Bytes `take` took, on the claimed thread. */
 export const taken = { bytes: 0 };
 
-/**
- * On the claimed thread: takes a buffer and a bitmap, as an upload would, closing the bitmap. Its input's fields take
- * any value, `{ allOf: [] }`, typed `unknown`, which it narrows.
- */
-export const take = System.create({
-    name: "transfers/take", input: { type: "object", properties: { buffer: { allOf: [] }, bitmap: { allOf: [] } } }, resources: { read: [sink] },
-}, ({ input, resources }) => {
+/** On the claimed thread: takes a buffer and a bitmap, as an upload would, closing the bitmap. */
+export const take = System.create({}, ({ resources }, input: { readonly buffer: ArrayBuffer; readonly bitmap: ImageBitmap }) => {
     if (resources[sink] !== null) return;
-    if (input.buffer instanceof ArrayBuffer) taken.bytes += input.buffer.byteLength;
-    if (typeof ImageBitmap === "function" && input.bitmap instanceof ImageBitmap) {
-        taken.bytes += input.bitmap.width * input.bitmap.height * 4;
-        input.bitmap.close();
-    }
+    taken.bytes += input.buffer.byteLength + input.bitmap.width * input.bitmap.height * 4;
+    input.bitmap.close();
 });
 
 /** Every system the joined threads run, which they import so the world can place them there. */
@@ -52,31 +43,36 @@ type Joined = { readonly ask: (message: unknown) => Promise<unknown>; readonly t
 /** Starts `joined.ts` on a browser worker, joining `world` through a channel it's given and claiming `threads`. */
 const startJoined = async (world: CreatedWorld, threads: readonly string[]): Promise<Joined> => {
     const { port1, port2 } = new MessageChannel();
-    world.share(port1);
+    const shared = world.share(port1);
     const worker = new Worker(new URL("./joined.js", import.meta.url), { type: "module" });
     const ask = (message: unknown, transfer: Transferable[] = []): Promise<unknown> => new Promise(resolve => {
         worker.onmessage = event => resolve(event.data);
         worker.postMessage(message, transfer);
     });
     await ask({ kind: "port", port: port2, threads }, [port2]);
+    await shared;
     return { ask, terminate: () => worker.terminate() };
 };
 
-/** Milliseconds the loader took for `transferCount` transfers to the claimed thread, each run posted back to back in batches. */
-const transfers = async (): Promise<number> => {
+/**
+ * Milliseconds the loader took for `transferCount` transfers to the claimed thread of bitmaps `side` pixels square, each
+ * run posted back to back in batches: every batch's time, or with `fastestOf`, the fastest of that many batches'.
+ */
+const transfers = async (side: number, fastestOf: number): Promise<number> => {
     const world = createWorld({ [workers]: 0 });
     const filler = await startJoined(world, ["transfersBenchmark"]);
     const loader = await startJoined(world, []);
     try {
-        const reply = await loader.ask({ kind: "transfers" });
+        const reply = await loader.ask({ kind: "transfers", side, fastestOf });
         if (typeof reply !== "object" || reply === null || Reflect.get(reply, "kind") !== "transferred") throw new Error("transfer: the loader didn't transfer.");
         const milliseconds: unknown = Reflect.get(reply, "milliseconds");
         return typeof milliseconds === "number" ? milliseconds : NaN;
     }
     finally {
         loader.terminate();
-        filler.terminate();
+        // Disposed first: ticks after the thread ended would fail its systems, reported out of band.
         await world.dispose();
+        filler.terminate();
     }
 };
 
@@ -88,6 +84,15 @@ export const transferBenchmarks: readonly Benchmark[] = [
         n: transferCount,
         typical: [1, 100],
         best: { bytes: 256, basis: "A transfer moves its values' handles in one message, the bytes staying where they are, and the run's slot and completion lines between cores." },
-        run: () => transfers(),
+        run: () => transfers(transferSide, 0),
+    },
+    {
+        name: "transfer small bitmaps",
+        operation: "`transfer` with 1 by 1 bitmaps, the fastest of 40 batches of 10: the ECS's path for a transfer, without the browser's moving of large bitmaps, which varies twofold from batch to batch.",
+        per: "transfers",
+        n: transferCount,
+        typical: [1, 100],
+        best: { bytes: 256, basis: "As `transfer`." },
+        run: () => transfers(1, 40),
     },
 ];

package/src/perftest/uploads.ts

@@ -1,44 +1,42 @@
-import { Component } from "../interface/component/component.js";
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { Entity } from "../interface/entity/entity.js";
 import { gpuDevice } from "../interface/resources/gpu-device.js";
 import { workers } from "../interface/resources/workers.js";
 import { System } from "../interface/system/system.js";
 import { createWorld } from "../implementation/world/create.js";
 import type { Benchmark } from "./benchmark.js";
+import type { Vec3 } from "../interface/math/index.js";
 
 // A drag: the CPU writes one row of a column a render system holds on the GPU, which uploads what changed.
 
 const place = Symbol("uploads/place");
 declare module "@adobe/ecs" {
     export interface Components {
-        [place]: { type: readonly [number, number, number] };
+        [place]: { type: Vec3 };
     }
 }
-Component.register(place, { type: { type: "array", items: { type: "number", precision: 1 }, minItems: 3, maxItems: 3 } });
 
 const shapes = 100_000;
 let spawned: Entity[] = [];
-const spawn = System.create({ name: "uploads/spawn" }, ({ commands }) => {
+const spawn = System.create({}, ({ commands }) => {
     spawned = [];
     for (let i = 0; i < shapes; i++) spawned.push(commands.spawn([place])({ [place]: [i, 0, 0] }));
 });
 const drag = System.create({
-    name: "uploads/drag",
-    components: { write: [place] },
-    input: { type: "object", properties: { shape: Entity.schema, x: { type: "number" } } },
+    components: { with: [place] },
     target: "shape",
-}, (row, { input }) => {
+}, (row, _context, input: { readonly shape: Entity; readonly x: number }) => {
     row[place] = [input.x, 1, 0];
 });
 /** Draws nothing: its run uploads what it reads. */
-const draw = System.render({ name: "uploads/draw", shader: { accessors: { place } }, after: [drag] }, () => {});
-const frame = System.create({ name: "uploads/frame", systems: [drag, draw] });
-const slide = System.create({ name: "uploads/slide", kernel: "cpu", components: { write: [place] } }, row => {
+const draw = System.render({ shader: { accessors: { place } }, after: [drag] }, () => {});
+const frame = System.create({ systems: [drag, draw] });
+const slide = System.create({ kernel: true, components: { with: [place] } }, row => {
     const [x, y, z] = row[place];
     row[place] = [x + 1, y, z];
 });
-const drawAfterSlide = System.render({ name: "uploads/drawAfterSlide", shader: { accessors: { place } }, after: [slide] }, () => {});
-const slideFrame = System.create({ name: "uploads/slideFrame", systems: [slide, drawAfterSlide] });
+const drawAfterSlide = System.render({ shader: { accessors: { place } }, after: [slide] }, () => {});
+const slideFrame = System.create({ systems: [slide, drawAfterSlide] });
 
 /** Timed per run by `timed`, which waits for the GPU. */
 export const uploadBenchmarks = (device: GPUDevice, timed: (run: () => Promise<unknown>) => Promise<number>): readonly Benchmark[] => [{

package/src/perftest/values.ts

@@ -1,5 +1,4 @@
-import { Archetype } from "../interface/archetype/archetype.js";
-import { Component } from "../interface/component/component.js";
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { Finalizer } from "../interface/finalizer/finalizer.js";
 import { workers } from "../interface/resources/workers.js";
 import { System } from "../interface/system/system.js";
@@ -7,6 +6,7 @@ import type { World } from "../interface/world/world.js";
 import { createWorld } from "../implementation/index.js";
 import type { Benchmark, Best } from "./benchmark.js";
 import { fastest } from "./suite.js";
+import type { Vec2 } from "../interface/math/index.js";
 
 // Benchmarks of struct values, which a row reads into an object and writes back field by field: a 2D transform's five
 // numbers, as an editor's nodes hold, beside a vec2 size.
@@ -20,30 +20,26 @@ declare module "@adobe/ecs" {
     export interface Components {
         [pose]: { type: Pose };
         [shown]: { type: Pose };
-        [extent]: { type: readonly [number, number] };
+        [extent]: { type: Vec2 };
         [order]: { type: number };
     }
 }
 const number = { type: "number" } as const;
 const poseSchema = { type: "object", properties: { tx: number, ty: number, rotation: number, sx: number, sy: number }, required: ["tx", "ty", "rotation", "sx", "sy"] } as const;
-Component.register(pose, { type: poseSchema });
-Component.register(shown, { type: poseSchema });
-Component.register(extent, { type: { type: "array", items: { type: "number", precision: 1 }, minItems: 2, maxItems: 2 } });
-Component.register(order, { type: number });
 
-const Node = Archetype.create([pose, shown, extent, order]);
+const Node = [pose, shown, extent, order] as const;
 
 const rows = 100_000;
 
-const seed = System.create({ name: "values/seed", input: { type: "object", properties: { count: { type: "integer" } } } }, ({ input, commands }) => {
+const seed = System.create({}, ({ commands }, input: { readonly count: number }) => {
     for (let i = 0; i < input.count; i++) commands.spawn(Node)({ [pose]: { tx: i, ty: 0, rotation: 0, sx: 1, sy: 1 }, [shown]: { tx: 0, ty: 0, rotation: 0, sx: 1, sy: 1 }, [extent]: [1, 1], [order]: i });
 });
 
 /** Shows each row's pose: a struct read and written whole per row. */
-const showPose = System.create({ name: "values/showPose", components: { read: [pose], write: [shown] } }, row => { row[shown] = row[pose]; });
+const showPose = System.create({ kernel: false, components: { with: [pose, shown] } }, row => { row[shown] = row[pose]; });
 
 /** Commits a pose and an extent per row as commands, values every row already has. */
-const commitPose = System.create({ name: "values/commitPose", kernel: "cpu", components: { read: [order] } }, (row, { commands }) => {
+const commitPose = System.create({ kernel: true, components: { with: [order] } }, (row, { commands }) => {
     commands.add(row.entity, pose, { tx: row[order], ty: 1, rotation: 0, sx: 1, sy: 1 });
     commands.add(row.entity, extent, [2, 2]);
 });
@@ -81,7 +77,7 @@ export const valueBenchmarks: readonly Benchmark[] = [
         best: { bytes: 32, basis: "Each command writes its 40-byte struct or 8-byte vec2 and reads its entity's 8-byte location." },
         run: async () => {
             // Program-wide, so made here, in this benchmark's own process.
-            Finalizer.changes({ name: "values/history", watch: [pose, extent] }, ({ groups }) => {
+            Finalizer.changes({ watch: [pose, extent] }, ({ groups }) => {
                 replacedPoses = 0;
                 for (const group of groups) if (group.replaced.includes(pose)) replacedPoses += group.entities.length;
             });

package/src/perftest/wake.ts

@@ -1,3 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { createMemory } from "../implementation/world/memory.js";
 import { createPool, type FastTask } from "../implementation/world/pool.js";
 import { idleKernel } from "../implementation/world/protocol.js";

package/src/world.test.ts

@@ -1,5 +1,6 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 import { describe, expect, it } from "vitest";
-import { Component, Resource, System, World, workers } from "./index.js";
+import { System, World, workers } from "./index.js";
 
 const count = Symbol("worldTest/count");
 const total = Symbol("worldTest/total");
@@ -11,12 +12,10 @@ declare module "@adobe/ecs" {
         [total]: { type: number };
     }
 }
-Component.register(count, { type: { type: "number" } });
-Resource.register(total, { type: { type: "number", default: 0 } });
 
-const spawn = System.create({ name: "worldTest/spawn" }, ({ commands }) => { commands.spawn([count])({ [count]: 1 }); });
-const raise = System.create({ name: "worldTest/raise", resources: { write: [total] } }, ({ resources }) => { resources[total] = 7; });
-const add = System.create({ name: "worldTest/add", components: { write: [count] } }, row => { row[count] += 1; });
+const spawn = System.create({}, ({ commands }) => { commands.spawn([count])({ [count]: 1 }); });
+const raise = System.create({}, ({ resources }) => { resources[total] = 7; });
+const add = System.create({ components: { with: [count] } }, row => { row[count] += 1; });
 
 describe("World.create", () => {
     it("creates a world from the package root, the one import that names everything else", async () => {
@@ -24,7 +23,7 @@ describe("World.create", () => {
         await world.run(spawn);
         await world.run(add);
         let seen = 0;
-        await world.run(System.create({ observer: true, components: { read: [count] } }, row => { seen = row[count]; }));
+        await world.run(System.create({ observer: true, components: { with: [count] } }, row => { seen = row[count]; }));
         expect(seen).toBe(2);
     });
     it("rejects a key that isn't a resource, as worlds the implementation creates do", () => {
@@ -36,11 +35,12 @@ describe("World.join", () => {
     it("joins a world another thread shared, from the package root, and runs there", async () => {
         await using world = World.create({ [workers]: 0 });
         const channel = new MessageChannel();
-        world.share(channel.port1);
-        await using joined = World.join(channel.port2);
+        const shared = world.share(channel.port1);
+        await using joined = await World.join(channel.port2);
+        await shared;
         await joined.run(raise);
         let seen = 0;
-        await world.run(System.create({ observer: true, resources: { read: [total] } }, ({ resources }) => { seen = resources[total]; }));
+        await world.run(System.create({ observer: true }, ({ resources }) => { seen = resources[total]; }));
         expect(seen).toBe(7);
     });
 });

package/dist/implementation/compiler/exact.d.ts

@@ -1,24 +0,0 @@
-import type { ObjectExpression } from 'estree';
-import type { Lists } from './lists.js';
-import type { ModuleScope } from './module-scope.js';
-type Access = {
-    readonly read: ReadonlySet<string>;
-    readonly write: ReadonlySet<string>;
-};
-/** The keys a body reads, writes and contributes to, by module-scope binding name; null where the body doesn't show every use. */
-export type Used = {
-    readonly query: Access | null;
-    readonly resources: (Access & {
-        readonly reduce: ReadonlySet<string>;
-    }) | null;
-    /** The components read from each lookup's results, by lookup name: null for one whose results aren't followed. */
-    readonly lookups: ReadonlyMap<string, ReadonlySet<string> | null> | null;
-    /** The components read from `up`, when the body's uses are all known. */
-    readonly up?: ReadonlySet<string>;
-};
-/**
- * Requires a system's declared `read`, `write` and `reduce` to be exactly what its body uses: a key it never uses
- * would still narrow which entities match, and hold back systems that could otherwise run alongside it.
- */
-export declare const requireExact: (declaration: ObjectExpression, used: Used, module: ModuleScope, lists: Lists) => void;
-export {};

package/dist/implementation/compiler/exact.js

@@ -1,64 +0,0 @@
-import { fail } from './failure.js';
-/** An object literal's plain-named properties; none for anything else. */
-const fields = (node) => new Map(node?.type !== "ObjectExpression" ? [] :
-    node.properties.flatMap((property) => property.type === "Property" && !property.computed && property.key.type === "Identifier" ? [[property.key.name, property.value]] : []));
-/**
- * Requires a list to name only keys in `used`. A list `lists` can't read isn't checked, since its keys can't be matched
- * to the body's.
- */
-const requireUsed = (node, used, lists, message) => {
-    const names = node === undefined ? null : lists.names(node);
-    if (node === undefined || names === null || "error" in names)
-        return;
-    // A key of an array literal is reported where it's listed, and one of a list declared elsewhere where the system names the list.
-    names.forEach((name, k) => {
-        const element = node.type === "ArrayExpression" ? node.elements[k] : null;
-        if (!used.has(name))
-            fail(element ?? node, message(name));
-    });
-};
-/** Requires `reduce` to name only resources in `contributed`, when it names each by a computed module-scope key. */
-const requireContributed = (reduce, contributed, module) => {
-    if (reduce?.type !== "ObjectExpression")
-        return;
-    const keys = reduce.properties.map(property => property.type === "Property" && property.computed && property.key.type === "Identifier" && module.has(property.key.name) ? property.key : null);
-    for (const key of keys)
-        if (key === null)
-            return;
-    for (const key of keys)
-        if (key !== null && !contributed.has(key.name))
-            fail(key, `${key.name} is in reduce but never contributed to; remove it`);
-};
-/**
- * Requires a system's declared `read`, `write` and `reduce` to be exactly what its body uses: a key it never uses
- * would still narrow which entities match, and hold back systems that could otherwise run alongside it.
- */
-export const requireExact = (declaration, used, module, lists) => {
-    const declared = fields(declaration);
-    const components = fields(declared.get("components"));
-    const resources = fields(declared.get("resources"));
-    if (used.query !== null) {
-        requireUsed(components.get("read"), used.query.read, lists, name => `${name} is in components read but never read; remove it, or move it to components has to keep requiring it`);
-        requireUsed(components.get("write"), used.query.write, lists, name => `${name} is in components write but never written; remove it, or move it to components read if it's only read`);
-    }
-    if (used.resources !== null) {
-        requireUsed(resources.get("read"), used.resources.read, lists, name => `${name} is in resources read but never read; remove it`);
-        requireUsed(resources.get("write"), used.resources.write, lists, name => `${name} is in resources write but never written; remove it, or move it to resources read if it's only read`);
-        requireContributed(declared.get("reduce"), used.resources.reduce, module);
-    }
-    if (used.up !== undefined) {
-        requireUsed(fields(declared.get("up")).get("read"), used.up, lists, name => `${name} is in up.read but never read; remove it`);
-    }
-    if (used.lookups !== null) {
-        for (const [lookup, value] of fields(declared.get("lookup"))) {
-            const read = used.lookups.get(lookup);
-            if (read === null)
-                continue;
-            const index = fields(value).has("index");
-            requireUsed(fields(value).get("read"), read ?? new Set(), lists, name => index
-                ? `${name} is in lookup.${lookup} read but never read; remove it`
-                : `${name} is in lookup.${lookup} read but never read; remove it, or move it to lookup.${lookup} has to keep requiring it`);
-        }
-    }
-};
-//# sourceMappingURL=exact.js.map

package/dist/implementation/compiler/exact.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exact.js","sourceRoot":"","sources":["../../../src/implementation/compiler/exact.ts"],"names":[],"mappings":"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"}