@adobe/ecs 0.0.0-stage → 0.1.0

package/dist/implementation/world/remote.js

@@ -0,0 +1,137 @@
+import { declarationOf, labelOf, threadOfDeclaration } from '../../interface/registry/index.js';
+import { makeLocal, makeRemote } from './archetype.js';
+import { flushBetween } from './layout-directory.js';
+import { nullTag, tagOf } from './move-log.js';
+import { startTicking } from './state.js';
+// Objects a joined thread fills: the world's storages for them hold each row's tag in place of its value, and the
+// archetypes holding them append their moves to the thread's log (`move-log.ts`).
+/** The logical thread a component's or resource's objects live on, or null for a struct. */
+const threadOfComponent = (state, id) => {
+    const declaration = declarationOf(state.keys[id]);
+    return declaration === undefined ? null : threadOfDeclaration(declaration);
+};
+/** Gives a component a joined thread fills to its log, in every archetype and batch holding it. */
+const give = (state, id, log) => {
+    state.remote[id] = log;
+    startTicking(state, [id]);
+    for (const archetype of state.archetypes) {
+        const storage = archetype.storageById[id];
+        if (storage !== undefined)
+            makeRemote(state.memory, archetype, storage, log);
+    }
+    for (const batch of state.batches)
+        for (const column of batch.columns)
+            if (column.id === id)
+                column.remote = remoteError(state, id).message;
+    log.announce(id);
+};
+/**
+ * A component the world just met, whose logical thread a joined thread claims: its objects are that thread's. No
+ * archetype holds it yet, so nothing allocates.
+ */
+export const claimComponent = (state, id) => {
+    const thread = threadOfComponent(state, id);
+    const log = thread === null ? undefined : state.claims.get(thread);
+    if (log === undefined)
+        return;
+    state.remote[id] = log;
+    state.ticked.add(id);
+    log.announce(id);
+};
+/**
+ * Between runs: a joined thread claims logical threads, so their components' objects are its own. Rows holding them
+ * start there at their starts; the world's values are released. Their ticks are kept, so the thread rebuilds them.
+ */
+export const claimThreads = (state, log, threads) => {
+    for (const thread of threads)
+        state.claims.set(thread, log);
+    state.logs.push(log);
+    state.claimed = true;
+    state.counting = true;
+    for (let id = 0; id < state.keys.length; id++) {
+        const thread = threadOfComponent(state, id);
+        if (thread !== null && state.claims.get(thread) === log)
+            give(state, id, log);
+    }
+    if (state.directory !== null)
+        state.directory.guarded = true;
+    flushBetween(state.directory, state.bumped, state.archetypes, state.entities, state.resourceEntity, state.counted);
+};
+/**
+ * Between runs: a joined thread that's gone gives back the logical threads it claimed. Rows hold the value each tag
+ * names, `null` or the start: a staged value was the thread's own.
+ */
+export const releaseThreads = (state, log) => {
+    const index = state.logs.indexOf(log);
+    if (index < 0)
+        return;
+    state.logs.splice(index, 1);
+    for (const [thread, owner] of [...state.claims])
+        if (owner === log)
+            state.claims.delete(thread);
+    for (let id = 0; id < state.remote.length; id++) {
+        if (state.remote[id] !== log)
+            continue;
+        state.remote[id] = undefined;
+        for (const archetype of [...log.archetypes]) {
+            const storage = archetype.storageById[id];
+            if (storage !== undefined)
+                makeLocal(state.memory, archetype, storage, state.starts[id]);
+        }
+        for (const batch of state.batches)
+            for (const column of batch.columns)
+                if (column.id === id)
+                    column.remote = null;
+    }
+    state.claimed = state.logs.length > 0;
+    state.counting = state.claimed || state.observer.count > 0;
+    if (state.directory !== null)
+        state.directory.guarded = state.claimed;
+    // Finalizers on the threads it gave back activate again.
+    state.unplacedSeen.clear();
+    state.activation.met = true;
+    flushBetween(state.directory, state.bumped, state.archetypes, state.entities, state.resourceEntity, state.counted);
+};
+export const remoteError = (state, id) => new Error(`"${labelOf(state.keys[id])}" lives on thread "${threadOfComponent(state, id) ?? "world"}", which a joined thread fills, so a command here gives it only its start or null.`);
+/**
+ * For a system's commands, once a joined thread fills objects: the first error of a value another thread's object can't
+ * take, with each such command dropped, by naming no entity, and each such staged spawn's value its start. Commands of
+ * the joined thread whose log is `own` give its own objects slots it staged.
+ */
+export const checkCommands = (state, buffer, own = null) => {
+    let error;
+    const { ids, values, starts, entities } = buffer;
+    for (let command = 0; command < buffer.count; command++) {
+        const end = command + 1 < buffer.count ? starts[command + 1] : buffer.named;
+        for (let k = starts[command]; k < end; k++) {
+            const id = ids[k];
+            const log = state.remote[id];
+            if (log === undefined)
+                continue;
+            const tag = tagOf(values[k], state.starts[id]);
+            if (tag >= 0 && (tag <= nullTag || log === own))
+                continue;
+            error ??= remoteError(state, id);
+            entities[command] = 0;
+            break;
+        }
+    }
+    for (let s = 0; s < buffer.stagedCount; s++) {
+        const { batch, start, end } = buffer.staged[s];
+        for (const column of batch.columns) {
+            const log = state.remote[column.id];
+            if (log === undefined)
+                continue;
+            const begin = state.starts[column.id];
+            for (let row = start; row < end; row++) {
+                const tag = tagOf(column.values[row], begin);
+                if (tag >= 0 && (tag <= nullTag || log === own))
+                    continue;
+                error ??= remoteError(state, column.id);
+                column.values[row] = begin;
+            }
+        }
+    }
+    return error;
+};
+//# sourceMappingURL=remote.js.map

package/dist/implementation/world/remote.js.map

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

package/dist/implementation/world/reports.d.ts

@@ -0,0 +1,63 @@
+import type { Failure, Warning } from '../../interface/report/failure.js';
+import { type CommandBuffer } from './buffer.js';
+import type { RunReport } from './failures.js';
+import { type State } from './state.js';
+/** How many runs keep their reports: past that, each run's report reuses the oldest one's entity. */
+export declare const retainedRuns = 256;
+/** What a run reports in `Report.run`. */
+export type RunValues = {
+    number: number;
+    elapsed: number;
+    systems: number;
+    workers: number;
+    joined: number;
+    main: boolean;
+    gpu: boolean;
+    dropped: number;
+};
+type Errors = {
+    readonly failures: readonly Failure[];
+    readonly skipped: readonly string[];
+    readonly warnings: readonly Warning[];
+};
+/**
+ * A report entity, of the run that last took it. `errors` is what its `Report.errors` holds, or will once commands
+ * queued for it apply; null without. `own` tells whether those are its run's, not an earlier run's it reuses.
+ */
+export type Slot = {
+    entity: number;
+    run: number;
+    errors: Errors | null;
+    own: boolean;
+};
+/** Whether a run has nothing for `Report.errors`. */
+export declare const isClean: (report: RunReport) => boolean;
+/**
+ * The world's reports: an entity for each of the last `retainedRuns` runs and ticks. Each run takes one as it starts:
+ * a new one, spawned by its own sync point, until that many are, then the oldest. Once its sync point is done, its
+ * `Report.run` is written in place, stamped so `changed` filters see it. `Report.errors` is written in place too when
+ * the entity holds it already, so a reused entity changes archetype only when its run's errors come or go; adding or
+ * removing it joins the run's sync point when known before it, else applies with `applyAlone`.
+ */
+export declare const createReports: (state: State, applyAlone: (buffer: CommandBuffer) => Promise<void> | null) => {
+    /** The slot the last run took. */
+    lastSlot: () => Slot;
+    /** Takes the report of run `run`, which is about to run: what that takes joins the run's own sync point. */
+    begin: (run: number) => Slot;
+    /** Takes run `run`'s report between runs: what that takes applies as a sync point of its own. */
+    beginAlone: (run: number) => Slot | Promise<Slot>;
+    /**
+     * Puts, for the run that took the last slot, `Report.errors` for what went wrong before its sync point:
+     * failures, skipped systems and the first `warningCount` warnings, copied, since the run's lists grow.
+     */
+    beforeSync: (failures: readonly Failure[] | null, skipped: readonly string[] | null, warnings: readonly Warning[], warningCount: number) => void;
+    /**
+     * Writes run `run`'s report into its slot once its sync point is done: `Report.run`, then its errors unless
+     * they were put before it, or clears those an earlier run left. A report's errors are written once: failures
+     * found after go to `defer`, for the next report. While tails run on joined threads, a removal waits for the
+     * next sync point, the errors emptied meanwhile.
+     */
+    finish: (slot: Slot, values: RunValues, report: RunReport, tailsRun: boolean, defer: (failures: readonly Failure[]) => void) => Promise<void> | null;
+};
+export type Reports = ReturnType<typeof createReports>;
+export {};

package/dist/implementation/world/reports.js

@@ -0,0 +1,180 @@
+import { Report } from '../../interface/report/report.js';
+import { stampChanged } from './archetype.js';
+import { addCommand, createBuffer, pushCommand, pushComponent, removeCommand, spawnCommand } from './buffer.js';
+import { writeCell } from './cells.js';
+import { pushValues } from './commands.js';
+import { locate, reserve } from './entities.js';
+import { idOf } from './state.js';
+/** How many runs keep their reports: past that, each run's report reuses the oldest one's entity. */
+export const retainedRuns = 256;
+/** Whether a run has nothing for `Report.errors`. */
+export const isClean = (report) => report.failures.length === 0 && report.skipped.length === 0 && report.warnings.length === 0;
+const none = [];
+const noErrors = { failures: none, skipped: none, warnings: none };
+/** Fields of `Report.run`, in no particular order: what `createRunWriter` writes. */
+const runFields = ["number", "elapsed", "systems", "workers", "joined", "main", "gpu", "dropped"];
+/** A writer of `RunValues` into a storage of `Report.run`, by the leaf of each field in `layout`. */
+const createRunWriter = (layout) => {
+    if (layout.kind !== "linear")
+        throw new Error("Report.run isn't a struct.");
+    const leafOf = (field) => {
+        const leaf = layout.leaves.find(each => each.path[0] === field);
+        if (leaf === undefined)
+            throw new Error(`Report.run has no ${field}.`);
+        return leaf;
+    };
+    const [number, elapsed, systems, workers, joined, main, gpu, dropped] = runFields.map(leafOf);
+    return (views, row, values) => {
+        views[number.view][row * number.unitStride + number.unitOffset] = values.number;
+        views[elapsed.view][row * elapsed.unitStride + elapsed.unitOffset] = values.elapsed;
+        views[systems.view][row * systems.unitStride + systems.unitOffset] = values.systems;
+        views[workers.view][row * workers.unitStride + workers.unitOffset] = values.workers;
+        views[joined.view][row * joined.unitStride + joined.unitOffset] = values.joined;
+        views[main.view][row * main.unitStride + main.unitOffset] = values.main ? 1 : 0;
+        views[gpu.view][row * gpu.unitStride + gpu.unitOffset] = values.gpu ? 1 : 0;
+        views[dropped.view][row * dropped.unitStride + dropped.unitOffset] = values.dropped;
+    };
+};
+/**
+ * The world's reports: an entity for each of the last `retainedRuns` runs and ticks. Each run takes one as it starts:
+ * a new one, spawned by its own sync point, until that many are, then the oldest. Once its sync point is done, its
+ * `Report.run` is written in place, stamped so `changed` filters see it. `Report.errors` is written in place too when
+ * the entity holds it already, so a reused entity changes archetype only when its run's errors come or go; adding or
+ * removing it joins the run's sync point when known before it, else applies with `applyAlone`.
+ */
+export const createReports = (state, applyAlone) => {
+    const runId = idOf(state, Report.run);
+    const errorsId = idOf(state, Report.errors);
+    state.meta.add(runId).add(errorsId);
+    const slots = [];
+    /** The slot the next run takes once every one is spawned. */
+    let oldest = 0;
+    /** The slot the last run took. */
+    let last = null;
+    /** The storage and row of a slot's component `id`, while its entity holds it. */
+    const cellOf = (slot, id) => {
+        const index = locate(state.entities, slot.entity);
+        if (index < 0)
+            return null;
+        const storage = state.archetypes[state.entities.archetype[index]]?.storageById[id];
+        return storage === undefined ? null : { storage, row: state.entities.row[index] };
+    };
+    /** Writes `Report.run` field by field through its layout's leaves, without the general writer's walk. */
+    const writeRun = createRunWriter(state.layouts[runId]);
+    /** Writes `errors` into a slot: in place when its entity holds them, stamped; else by an add, queued or alone. */
+    const putErrors = (slot, errors, queue) => {
+        const pending = slot.errors !== null && cellOf(slot, errorsId) === null;
+        slot.errors = errors;
+        slot.own = true;
+        const cell = cellOf(slot, errorsId);
+        if (cell !== null) {
+            writeCell(cell.storage, cell.row, errors);
+            stampChanged(cell.storage, cell.row, ++state.tick);
+            return null;
+        }
+        const buffer = createBuffer();
+        pushValues(state, buffer, addCommand, slot.entity, { [Report.errors]: errors });
+        if (queue || pending) {
+            state.queued.push({ buffer, guarded: false });
+            return null;
+        }
+        return applyAlone(buffer);
+    };
+    /**
+     * Takes run `run`'s slot: a new entity, spawned by commands queued for the next sync point, until every one is,
+     * then the oldest, or a new one in its place when a system despawned it.
+     */
+    const take = (run) => {
+        let slot;
+        if (slots.length < retainedRuns) {
+            slot = { entity: -1, run, errors: null, own: false };
+            slots.push(slot);
+        }
+        else {
+            slot = slots[oldest];
+            oldest = (oldest + 1) % retainedRuns;
+            slot.run = run;
+            slot.own = false;
+            if (locate(state.entities, slot.entity) >= 0)
+                return last = slot;
+            slot.errors = null;
+        }
+        slot.entity = reserve(state.entities);
+        const buffer = createBuffer();
+        pushValues(state, buffer, spawnCommand, slot.entity, {
+            [Report.run]: { number: run, elapsed: 0, systems: 0, workers: 0, joined: 0, main: false, gpu: false, dropped: 0 },
+        });
+        state.queued.push({ buffer, guarded: false });
+        return last = slot;
+    };
+    return {
+        /** The slot the last run took. */
+        lastSlot: () => {
+            if (last === null)
+                throw new Error("No run took a report yet.");
+            return last;
+        },
+        /** Takes the report of run `run`, which is about to run: what that takes joins the run's own sync point. */
+        begin: take,
+        /** Takes run `run`'s report between runs: what that takes applies as a sync point of its own. */
+        beginAlone: (run) => {
+            const queued = state.queued.length;
+            const slot = take(run);
+            if (state.queued.length === queued)
+                return slot;
+            const applying = applyAlone(state.queued.splice(queued, 1)[0].buffer);
+            return applying === null ? slot : applying.then(() => slot);
+        },
+        /**
+         * Puts, for the run that took the last slot, `Report.errors` for what went wrong before its sync point:
+         * failures, skipped systems and the first `warningCount` warnings, copied, since the run's lists grow.
+         */
+        beforeSync: (failures, skipped, warnings, warningCount) => {
+            if (last === null || (failures === null && skipped === null && warningCount === 0))
+                return;
+            const errors = { failures: failures === null ? none : failures.slice(), skipped: skipped === null ? none : skipped.slice(), warnings: warningCount === 0 ? none : warnings.slice(0, warningCount) };
+            void putErrors(last, errors, true);
+        },
+        /**
+         * Writes run `run`'s report into its slot once its sync point is done: `Report.run`, then its errors unless
+         * they were put before it, or clears those an earlier run left. A report's errors are written once: failures
+         * found after go to `defer`, for the next report. While tails run on joined threads, a removal waits for the
+         * next sync point, the errors emptied meanwhile.
+         */
+        finish: (slot, values, report, tailsRun, defer) => {
+            if (slot.run !== values.number)
+                return null;
+            const cell = cellOf(slot, runId);
+            if (cell === null)
+                return null;
+            writeRun(cell.storage.views, cell.row, values);
+            stampChanged(cell.storage, cell.row, ++state.tick);
+            if (!isClean(report)) {
+                const given = slot.own ? slot.errors : null;
+                if (given === null)
+                    return putErrors(slot, { failures: report.failures, skipped: report.skipped, warnings: report.warnings }, tailsRun);
+                // Its errors are written once: failures found since go to the next report.
+                if (report.failures.length > given.failures.length)
+                    defer(report.failures.slice(given.failures.length));
+                return null;
+            }
+            if (slot.errors === null || slot.own)
+                return null;
+            const held = cellOf(slot, errorsId);
+            if (held !== null) {
+                writeCell(held.storage, held.row, noErrors);
+                stampChanged(held.storage, held.row, ++state.tick);
+            }
+            slot.errors = null;
+            const buffer = createBuffer();
+            pushCommand(buffer, removeCommand, slot.entity);
+            pushComponent(buffer, errorsId, undefined);
+            if (tailsRun) {
+                state.queued.push({ buffer, guarded: false });
+                return null;
+            }
+            return applyAlone(buffer);
+        },
+    };
+};
+//# sourceMappingURL=reports.js.map

package/dist/implementation/world/reports.js.map

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

package/dist/implementation/world/resources.d.ts

@@ -0,0 +1,20 @@
+import type { Storage } from './archetype.js';
+import { type Key, type State } from './state.js';
+/** Resources are components on one entity, so they share storage, ticks and sync with every other component. */
+export type ResourceCell = {
+    readonly storage: Storage;
+    readonly row: number;
+};
+/** A resource's value before anything writes it: the one given at the world's creation, or its default. */
+export declare const initialOf: (state: State, key: Key) => unknown;
+/**
+ * Adds any missing resources with their initial values, as their own sync point, between runs; commands that are
+ * pending stay for the next run.
+ */
+export declare const ensureResources: (state: State, keys: Iterable<Key>) => void;
+/** Sets a resource as its own sync point, between runs, so systems see the change as they see any write. */
+export declare const setResource: (state: State, key: Key, value: unknown) => void;
+/** Where a resource lives now, or `undefined` if no registered system uses it. Valid until the next sync point. */
+export declare const findResource: (state: State, key: Key) => ResourceCell | undefined;
+/** Where a resource lives now. Valid until the next sync point. */
+export declare const resourceCell: (state: State, key: Key) => ResourceCell;

package/dist/implementation/world/resources.js

@@ -0,0 +1,63 @@
+import { indexOf, reserve } from './entities.js';
+import { defaultOf, idOf } from './state.js';
+import { synchronizeAlone } from './synchronize.js';
+import { addCommand, createBuffer, spawnCommand } from './buffer.js';
+import { pushValues } from './commands.js';
+import { labelOf } from '../../interface/registry/index.js';
+/** A resource's value before anything writes it: the one given at the world's creation, or its default. */
+export const initialOf = (state, key) => state.initial.has(key) ? state.initial.get(key) : defaultOf(key);
+/**
+ * Adds any missing resources with their initial values, as their own sync point, between runs; commands that are
+ * pending stay for the next run.
+ */
+export const ensureResources = (state, keys) => {
+    const index = state.resourceEntity < 0 ? -1 : indexOf(state.resourceEntity);
+    const archetype = index < 0 ? undefined : state.archetypes[state.entities.archetype[index]];
+    const values = {};
+    for (const key of keys) {
+        const id = idOf(state, key);
+        // A joined thread's object starts there; the world holds none of its values.
+        if (archetype?.storageOf.has(id) !== true)
+            values[key] = state.remote[id] === undefined ? initialOf(state, key) : state.starts[id];
+    }
+    if (Reflect.ownKeys(values).length === 0)
+        return;
+    const buffer = createBuffer();
+    if (index < 0) {
+        state.resourceEntity = reserve(state.entities);
+        pushValues(state, buffer, spawnCommand, state.resourceEntity, values);
+    }
+    else {
+        pushValues(state, buffer, addCommand, state.resourceEntity, values);
+    }
+    synchronizeAlone(state, buffer);
+};
+/** Sets a resource as its own sync point, between runs, so systems see the change as they see any write. */
+export const setResource = (state, key, value) => {
+    if (findResource(state, key) === undefined) {
+        // No registered system uses it yet; it starts at this value when one does.
+        state.initial.set(key, value);
+        return;
+    }
+    const buffer = createBuffer();
+    pushValues(state, buffer, addCommand, state.resourceEntity, { [key]: value });
+    synchronizeAlone(state, buffer);
+};
+/** Where a resource lives now, or `undefined` if no registered system uses it. Valid until the next sync point. */
+export const findResource = (state, key) => {
+    if (state.resourceEntity < 0)
+        return undefined;
+    const index = indexOf(state.resourceEntity);
+    const storage = state.archetypes[state.entities.archetype[index]]?.storageOf.get(idOf(state, key));
+    return storage === undefined ? undefined : { storage, row: state.entities.row[index] };
+};
+/** Where a resource lives now. Valid until the next sync point. */
+export const resourceCell = (state, key) => {
+    const index = indexOf(state.resourceEntity);
+    const archetype = state.archetypes[state.entities.archetype[index]];
+    const storage = archetype?.storageOf.get(idOf(state, key));
+    if (storage === undefined)
+        throw new Error(`Resource "${labelOf(key)}" isn't in this world.`);
+    return { storage, row: state.entities.row[index] };
+};
+//# sourceMappingURL=resources.js.map

package/dist/implementation/world/resources.js.map

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

package/dist/implementation/world/rows.d.ts

@@ -0,0 +1,108 @@
+import type { Entity } from '../../interface/entity/entity.js';
+import type { Declaration } from '../../interface/system/declaration.js';
+import type { SystemLookup } from '../../interface/system/access.js';
+import type { Commands } from '../../interface/system/commands.js';
+import type { Layout } from '../../interface/registry/layout.js';
+import { type Archetype, type Storage } from './archetype.js';
+import { type Key, type State } from './state.js';
+import { type ReductionTarget } from './reductions.js';
+import { type Since } from './index-lookups.js';
+import type { WorldIndex } from './indexes.js';
+/**
+ * What an accessor row reads and writes: a storage, or a joined thread's view of one. A joined thread's own objects
+ * have `tags`, the world's tags of their rows, which a write marks as the thread's own value.
+ */
+export type RowStorage = Pick<Storage, "layout" | "views" | "strings" | "values" | "write" | "ticked" | "added" | "changed" | "chunkAdded" | "chunkChanged" | "tags">;
+/** What a row binds to: an archetype, or a joined thread's view of one. */
+export type RowArchetype = {
+    readonly id: number;
+    readonly entities: Float64Array;
+    readonly storageById: readonly (RowStorage | undefined)[];
+};
+/**
+ * What rows need of their world: layouts by component id, the rows made so far, the running system's tick, and on a
+ * joined thread, that its strings are read out of their records, since only the world's thread holds their values.
+ */
+export type RowHost = {
+    readonly layouts: readonly Layout[];
+    readonly rows: Map<string, Row>;
+    readonly tick: number;
+    readonly records?: true;
+};
+/**
+ * An accessor row for the declared components of a system. `bind` points it at an archetype's storages and `index`
+ * selects the row. Reads copy linear values out; writes replace the whole value and stamp `changed` with the running
+ * system's tick.
+ */
+export type Row = {
+    readonly value: object;
+    index: number;
+    entities: Float64Array;
+    /** Points the row at another archetype's storages. Views are replaced only at sync points, so a binding lasts a pass. */
+    readonly bind: (archetype: RowArchetype) => void;
+};
+export declare const createRow: (host: RowHost, archetype: RowArchetype, keys: readonly Key[], ids: readonly number[], writes: readonly Key[]) => Row;
+/**
+ * Makes read-only accessor rows for `keys` whose values share one hidden class: every value's own accessors are the
+ * same functions, finding the row through the value. A body reading many rows at once, as a list's, sees one map.
+ */
+export declare const sharedRows: (host: RowHost, keys: readonly Key[], ids: readonly number[]) => (archetype: RowArchetype) => Row;
+/**
+ * Binds a read-only accessor row of its own, for the parents an `up` system reads, to an archetype. It isn't shared,
+ * so binding it never moves the row a system runs over, even when both read the same components.
+ */
+export declare const parentBinder: (state: State, reads: readonly Key[]) => (archetype: Archetype) => Row;
+/**
+ * Binds the accessor row for `reads` and `writes` to an archetype. The row is shared by every system of its host that
+ * declares the same ones, so a body sees one row shape whichever system or archetype it runs over. A host's systems
+ * run one at a time, so a binding lasts for one system's pass over one archetype. `idOfKey` gives each key's component.
+ */
+export declare const rowBinderOf: <A extends RowArchetype>(host: RowHost, idOfKey: (key: Key) => number, reads: readonly Key[], writes: readonly Key[]) => (archetype: A) => Row;
+/** The accessor row binder for main-thread systems of a world. */
+export declare const rowBinder: (state: State, reads: readonly Key[], writes: readonly Key[]) => (archetype: Archetype) => Row;
+/** What a lookup by entity reading nothing gives every entity it finds. */
+export declare const emptyRow: object;
+/** A lookup by entity's row with `changed`: its `read` values by component, and `changed`. */
+export type ChangedRow = {
+    [key: Key]: unknown;
+    changed: boolean;
+};
+/** A row for a lookup's `read` and `changed`, every field present from the start, so its writes keep one hidden class. */
+export declare const changedRowOf: (keys: readonly Key[]) => ChangedRow;
+/**
+ * A lookup returning `read` values keyed by component, for main-thread systems: a new object each call, the shared
+ * empty one for a lookup reading nothing, and with `changed` one row reused, its `changed` as of `since`.
+ */
+export declare const createObjectLookup: (state: State, lookup: SystemLookup, since: Since) => (entity: Entity) => object | null;
+/**
+ * A lookup returning `read` values in declared order, for kernels: a new array each call, and with `changed` one array
+ * reused, whether a component it watches may have changed after `since` last.
+ */
+export declare const createArrayLookup: (state: State, lookup: SystemLookup, since: Since) => (entity: Entity) => readonly unknown[] | null;
+/**
+ * A body's context: its resources, lookups, reductions, input and commands, each under its own key and present only
+ * when declared. `bind` resolves the resources' cells for a run; `reduced[t]` holds the leaves of the fold into its
+ * `t`th reduction target so far this run.
+ */
+export type Context = {
+    readonly value: {
+        input?: unknown;
+        up?: unknown;
+    };
+    readonly bind: () => void;
+    readonly reduced: readonly Float64Array[];
+};
+/**
+ * What a context holds beyond the declaration's resources and lookups, and for lookups through indexes, the index of
+ * each by name and the `lastRun` their lists compare with.
+ */
+type Extras = {
+    readonly targets?: readonly ReductionTarget[];
+    readonly commands?: Commands;
+    readonly input?: boolean;
+    readonly indexes?: ReadonlyMap<string, WorldIndex>;
+    readonly since?: Since;
+};
+/** Resource cells are resolved once per run: they move only at sync points. An unresolved resource throws on access. */
+export declare const createContext: (state: State, declaration: Pick<Declaration, "lookup" | "resources">, { targets, commands, input, indexes, since }?: Extras) => Context;
+export {};