[krisnye]

Combines #220, #221, the first-tick work and typed input into one PR, rebased on main. Sets @adobe/ecs to 0.1.1.

Contract change, for review

• order on System.render: order?: Index<{ sorted: true; key: Component.Key[] }>; with it tables is one table of all matching rows in index order. GPU kernels reject order.
• The plugin is Compiler.plugin(), the one export of @adobe/ecs/compiler; Compiler.plugin({ library: true }) builds a library's registrations and input schemas, leaving kernels as source.
• Declarations hold only what bodies can't show. components: { with, optional, not, added, changed } (with replaces read, write, has; optional keys never narrow matching and read undefined where absent); resources: { changed, is, not }; lookups { with, optional, not, changed } by entity or { index, changed }; up: { through }. The build infers reads, writes and reductions from bodies; a key used but not required fails the build. No name anywhere; labels are bindings, and failures carry id.
• A system's input is the type of its body's parameter after its context; the build reads its schema.
• Keys are declared once, in the augmentation beside their Symbol(); there is no public registration. Precision and ranges come from named types (Schema.Type<S>; F32, I32, U32, the vector types). Starts: a literal default, the type's readonly T.default, a reduction's identity, null, zero values, or a fresh ReadonlyMap/ReadonlySet; schemas hold no defaults. Invalid declarations error once at each World.create call.
• Archetypes are as const lists; Archetype.create is gone and the build indexes lists.
• kernel?: boolean | "gpu". Omitted compiles eligible row systems (f64x2 lanes, results matching the body as written); true asserts and keeps f32x4 lanes; false runs as written. Async and generator bodies fail the build.
• Ids are name@version/path#binding; a module outside a named package fails the build.
• Joined finalizers read every resource as of before their stops' sync point applied.

Fixes

• Joined finalizers read every resource as of before their stops' sync point applied. Object resources come from the thread's mirror; strings and linear values come from copies in the stop list. Before, an object resource could read as undefined after joining or a move, and a later write could leak into a finalizer's read.

• Two or more string resources in one joined finalizer no longer crash the thread on a misaligned view.

• Joined-thread races: a task's rebuild is retried only for its own reason, after a turn of the event loop; copyRest counts snapshots atomically; a pool worker checks for posts again before leaving a closed window; a lent worker's owner ending it is reported as terminated by its owner.

• Plugin tests install a copy of the package built from its sources, so they no longer depend on dist.

• Compiled code imports the runtime from the importer's copy of the package. The kernel plugin finds a module's @adobe/ecs copy from its nearest package.json named @adobe/ecs, so two installed copies no longer mix runtimes.

Performance

• up trees and orders are built in bulk after a load.

• A sorted index rebuild skips its sort when entries are already in key order.

• An ordered run binds a row in place when its archetype changes.

• First tick in the editor load tick 50K benchmark: 32 → 20 ms. In a 50K board app, generate to first frame went from about 355 to about 325 ms. Ordered render frames are unchanged: 0.030–0.036 ms when nothing changes, 0.27–0.29 ms with one key changed at 50K.

• Hash index buckets are left unsorted by a change and sorted before anything reads them by position: moving one entity between two 50K buckets 418 → 5.6 µs, reading in order after it 416 → 69 µs. Lookups still give rows in entity order.

• Block ticks, one per 64 rows, so change filters skip a changed chunk's unchanged rows: eight systems filtering on one changed row of 100K 34.9 → 5.0 µs, every row changed 8.5 → 4.7 ms; writes within noise.

• A world's first 256 runs spawn their reports through one reused buffer; benchmarks timing a run after another warm up past them.

• Joined index lookups check whether an index was replaced once per run instead of once per row: joined observer 10K 10–13% faster.

Docs

• The README opens with a summary and an outline of the features. The guide is complete through section 19.
• A generated API reference (typedoc) publishes to https://adobe.github.io/data/ecs/. The Pages workflow no longer names packages: each declares a pages field and scripts/collect-pages.mjs assembles the site; CI runs pnpm -r run docs.

Checks

packages/ecs: build and 1,405 tests pass, in node, threads, chromium and a project running the row-path suites with bodies as written.

🤖 Generated with Claude Code