@forgeax/engine-ecs 0.0.0-dev.8d955ade1c79

package/dist/world.d.ts

@@ -0,0 +1,620 @@
+import type { Handle, Result } from '@forgeax/engine-types';
+import { type Component, ComponentCatalog, type ComponentSchema, type InputShapeOf, type ShapeOf } from './component';
+import { type EntityHandle } from './entity-handle';
+import type { CommandFailedError, ComponentAlreadyPresentError, ComponentFieldInvalidValueError, ComponentNotDefinedError, ComponentNotPresentError, ComponentNumericValueInvalidError, FixedSizeMismatchError, ManagedArrayInvalidValueError, ManagedBufferOutOfBoundsError, ManagedBufferShrinkNotSupportedError, RelationshipDetachMismatchError, RelationshipMirrorComponentNotRegisteredError, RelationshipMirrorFieldTypeMismatchError, RelationshipSelfCycleError, RemoveEssentialComponentError, ScheduleMutationError, ScheduleScopeMismatchError, SharedKernelEligibilityError, SharedKernelFailureError, StaleEntityError, SystemFailedError, SystemSetNotRegisteredError, TimeConfigInvalidError, TimeDeltaInvalidError, UniqueRefDoubleReleaseError, UniqueRefReleasedError, WorldPoisonedError } from './errors';
+import { RelationshipTargetReadonlyError } from './errors';
+import { type WorldExecutionState } from './execution/shared-kernel';
+import type { QueryDescriptor } from './query/query';
+import { type Query, type QueryCreationError } from './query/query';
+import { type RelationshipTargetComponent } from './relationship-index';
+import { type SystemDescriptor, type SystemSet } from './schedule';
+import type { SharedRefStore } from './shared-ref-store';
+import { type ChangeTicks } from './storage/change-detection';
+import { type WorldOptions } from './time';
+import { type WorldInternal, worldInternal } from './world-internal';
+/**
+ * Union of all EcsError types that World methods can return via Result.
+ * AI users: switch on `.code` for programmatic branching.
+ */
+export type EcsError = CommandFailedError | StaleEntityError | ComponentNotPresentError | ComponentAlreadyPresentError | ComponentFieldInvalidValueError | ComponentNumericValueInvalidError | ManagedArrayInvalidValueError | UniqueRefReleasedError | UniqueRefDoubleReleaseError | ManagedBufferOutOfBoundsError | ManagedBufferShrinkNotSupportedError | FixedSizeMismatchError | RelationshipSelfCycleError | RelationshipMirrorComponentNotRegisteredError | RelationshipMirrorFieldTypeMismatchError | RelationshipDetachMismatchError | RelationshipTargetReadonlyError | ComponentNotDefinedError | RemoveEssentialComponentError | SystemSetNotRegisteredError | SystemFailedError | TimeDeltaInvalidError | TimeConfigInvalidError | ScheduleScopeMismatchError | SharedKernelEligibilityError | SharedKernelFailureError | WorldPoisonedError;
+/** Component data for spawn/addComponent: component token + initial values.
+ *
+ * `data` is `Partial<InputShapeOf<S>>` (feat-20260517 / M2; tweak-20260616
+ * input/output split): spawn / addComponent / SceneAsset.instantiate share the
+ * SAME shape contract via the layer-2 + layer-3 silent fallback applied inside
+ * `writeRow` (`fillComponentDefaults`). The input shape widens
+ * `array<scalar, N>` / `array<scalar>` to also accept `readonly number[]`
+ * because writeArrayField copies bytes from either shape — AI users can write
+ * `times: [0.5]` instead of `new Float32Array([0.5])` boilerplate. Wrong-VALUE
+ * fields (e.g. `{ fov: 'bad' }`) still fire field-level TS2322 — mapped-tuple
+ * primary inference does not degrade to the "No overload matches" wall
+ * (AC-03 / C-4). */
+export interface ComponentData<S extends ComponentSchema = ComponentSchema> {
+    component: Component<string, S>;
+    data: Partial<InputShapeOf<S>>;
+}
+type WritableComponent<C extends Component> = C extends RelationshipTargetComponent ? never : C;
+/**
+ * Per-archetype summary returned by `world.inspect()`. Sorted ComponentId key
+ * (always prefixed by the essential id=0 Entity column, e.g. "0+2+5+7"),
+ * human-readable component names, live entity count, allocated row capacity.
+ */
+export interface ArchetypeInfo {
+    /** Sorted ComponentId key, always prefixed by the id=0 Entity column (e.g. "0+2+5+7"). */
+    readonly key: string;
+    /** Human-readable component names in this archetype. */
+    readonly componentNames: string[];
+    /** Number of live entities in this archetype. */
+    readonly entityCount: number;
+    readonly tableId: number;
+}
+export interface TableInfo {
+    readonly id: number;
+    readonly key: string;
+    readonly componentNames: string[];
+    readonly entityCount: number;
+    readonly capacity: number;
+}
+/**
+ * Typed diagnostic snapshot of the World state.
+ * Returned by `world.inspect()` for programmatic introspection by AI users.
+ */
+export interface WorldInspection {
+    /** Total number of live entities. */
+    readonly entityCount: number;
+    /** Number of archetypes currently allocated. */
+    readonly archetypeCount: number;
+    /** Per-archetype details. */
+    readonly archetypes: ArchetypeInfo[];
+    readonly tableCount: number;
+    readonly tables: TableInfo[];
+    /**
+     * Names of components that are currently active in this World — i.e.
+     * every distinct component name appearing on at least one non-empty
+     * archetype. Collected by walking the archetype graph, so a component
+     * that was defined but never spawned into this World does not appear.
+     */
+    readonly activeComponents: string[];
+    /** Number of registered systems. Always equals `systems.length` (M2 derived invariant). */
+    readonly systemCount: number;
+    /**
+     * Per-system summary (M3 — plan-strategy D-8). One entry per
+     * registered system, in registration order. The `systemCount` field is
+     * preserved as a derived alias of `systems.length` so existing inspector
+     * P0 e2e cases that read `systemCount` keep working.
+     *
+     * `sets` is the list of set names this system belongs to (empty array for
+     * systems registered via plain `addSystem` without `addSystems`).
+     */
+    readonly systems: ReadonlyArray<{
+        readonly name: string;
+        readonly sets: readonly string[];
+    }>;
+    /** Keys of all inserted resources. */
+    readonly resourceKeys: string[];
+    /** Systems grouped by their schedule token. */
+    readonly schedules: ReadonlyArray<{
+        readonly schedule: import('./schedule-token').ScheduleToken;
+        readonly systems: ReadonlyArray<{
+            readonly name: string;
+            readonly sets: readonly string[];
+        }>;
+    }>;
+    /** Count systems in one explicit schedule. */
+    scheduleSystemCount(schedule: import('./schedule-token').ScheduleToken): number;
+}
+/** JSON-safe schedule graph and access metadata returned by `world.scheduleData()`. */
+export interface WorldScheduleQueryData {
+    readonly with: readonly string[];
+    readonly without: readonly string[];
+    readonly optional: readonly string[];
+    readonly changed: readonly string[];
+    readonly added: readonly string[];
+}
+/** JSON-safe system registration and access metadata. */
+export interface WorldScheduleSystemData {
+    readonly name: string;
+    readonly sets: readonly string[];
+    readonly before: readonly string[];
+    readonly after: readonly string[];
+    readonly queries: readonly WorldScheduleQueryData[];
+    readonly resources: readonly string[];
+}
+/** JSON-safe system-set membership and ordering metadata. */
+export interface WorldScheduleSetData {
+    readonly name: string;
+    readonly members: readonly string[];
+    readonly before: readonly string[];
+    readonly after: readonly string[];
+    readonly chained: boolean;
+}
+/** JSON-safe projection of one explicit World schedule. */
+export interface WorldScheduleData {
+    readonly name: string;
+    readonly systems: readonly WorldScheduleSystemData[];
+    readonly systemSets: readonly WorldScheduleSetData[];
+    readonly dependencies: readonly (readonly [string, string])[];
+}
+/**
+ * Internal record describing where an entity lives.
+ *
+ * Liveness (feat-20260602 / plan-strategy D-4): the former `alive` boolean was
+ * absorbed into `generation`. A despawn unconditionally bumps `generation` (so a
+ * stale handle's `gen` no longer matches), and `gen > 255` retires the slot
+ * permanently (it is never pushed back to `freeIndices`). The single liveness
+ * predicate is therefore "handle gen matches AND archetypeId !== -1" -- see
+ * `World.recordIsLive`. A deferred-spawn allocation is "pending" when
+ * archetypeId === -1 (not yet materialized into an archetype row); no separate
+ * boolean is needed.
+ */
+export interface EntityRecord {
+    generation: number;
+    archetypeId: number;
+    archetypeRow: number;
+}
+/**
+ * The World owns:
+ *   - the registry of known component schemas;
+ *   - all archetypes (via ArchetypeGraph);
+ *   - the entity index table (records by index slot);
+ *   - the free-list of recyclable entity slots.
+ */
+export declare class World {
+    /** Package-internal implementation seam; not exported from any entry point. */
+    readonly [worldInternal]: WorldInternal;
+    /** The single package-private owner of storage, epochs, and change evidence. */
+    private readonly core;
+    get identity(): string;
+    /** Plugin-owned component discovery scoped to this World and removed through leases. */
+    readonly components: ComponentCatalog;
+    private executionState;
+    /** Monotonic clock advanced exactly once per successful mutation. */
+    /** Monotonic revision for successful entity/component structure writes. */
+    /** Last mutation epoch for each component id, used by component-owned projections. */
+    /** Ordered, bounded evidence consumed by persistent engine-owned projections. */
+    private get mutationEpoch();
+    private set mutationEpoch(value);
+    private get structureEpoch();
+    private set structureEpoch(value);
+    private get componentMutationEpochs();
+    private get changeJournal();
+    /** Free index slots (LIFO stack). */
+    private get records();
+    private get freeIndices();
+    /**
+     * Relationship-sync reentry guard (feat-20260531 M2 / plan-strategy D-7).
+     /** The archetype graph: manages all archetypes + edge caching. */
+    private get graph();
+    /** DAG schedules for the two built-in execution scopes. */
+    private readonly schedules;
+    /** Resource store: typed key-value global singletons. */
+    private readonly resources;
+    private readonly clock;
+    /** Remainder carried between fixed-step runs. */
+    private fixedAccumulator;
+    /**
+     * ECS-managed handle store (M1). Owned by the World - constructed eagerly
+     * so every spawn / despawn / set path can dispatch managed-ref releases
+     * without caller-side wiring. AI users obtain `Handle<T,'unique'>` values
+     * by accessing the store through internal channels (the surface is
+     * private; managed-ref-bearing fields read through `world.get`).
+     */
+    private get uniqueRefs();
+    /**
+     * Per-World `SharedRefStore` (feat-20260614 M3). Backs every `shared<T>`
+     * schema field + the `world.allocSharedRef` facade. Public read-only so AI
+     * users can `retain` / `release` / `resolve` user-tier handles directly off
+     * the world (the surface is small enough that hiding it behind another
+     * facade would be a phantom indirection - charter F1 single-entry
+     * indexability).
+     *
+     * Final release publishes structured evidence; there is no callback surface.
+     * M6 D-15: the store manages only user-tier slots
+     * (`>= BUILTIN_BASE`); builtin handles are process-static in their
+     * authoring package and never reference-counted.
+     */
+    get sharedRefs(): SharedRefStore;
+    /**
+     * BufferPool backing every `buffer:<N>` schema-vocab field (M2). Eagerly
+     * constructed (per-World, D-2). `spawn` allocs slots for buffer fields and
+     * stores the slot id in the u32 column; `despawn` / `removeComponent`
+     * release the slots; `set(e, C, { field: Uint8Array })` copies bytes into
+     * the live view without re-allocating (schema-declared byteLength is
+     * fixed in v1; runtime grow is reserved for the M4 carry-over path).
+     */
+    private get bufferPool();
+    private readonly componentAccess;
+    constructor(options?: WorldOptions);
+    /** Immutable integrity state for execution coordinators and headless callers. */
+    get execution(): WorldExecutionState;
+    /** Resolve a schedule token owned by this World realm without package singleton identity. */
+    scheduleToken(name: import('./schedule-token').ScheduleName): import('./schedule-token').ScheduleToken;
+    /** SharedKernel is the only writer; application code recovers by constructing a new World. */
+    private internalpoisonExecution;
+    query<const R extends readonly Component[] = readonly [], const W extends readonly Component[] = readonly [], const O extends readonly Component[] = readonly []>(descriptor: QueryDescriptor<R, W, O>): Result<Query<R, W, O>, QueryCreationError>;
+    /** Expose archetype graph for query engine. Not part of public API. */
+    private internalgetGraph;
+    private componentIsInUse;
+    /** Current upper bound for mutation observation. */
+    private internalgetMutationEpoch;
+    /** Current cursor for a persistent projection subscriber. */
+    private internalgetChangeCursor;
+    /** Read complete mutation evidence or an explicit rebuild signal. */
+    private internalreadChangesSince;
+    /** Structure snapshot used to invalidate borrowed query facades. */
+    private internalgetStructureEpoch;
+    /** Resolve current logical identity for a packed entity handle. */
+    private internalgetEntityArchetype;
+    /** Component change state for query filters. */
+    private internalgetComponentChange;
+    /** Allocate one epoch after a mutation has succeeded. */
+    private internalnextMutationEpoch;
+    /** Record one successful structural mutation. */
+    private internalmarkStructureChanged;
+    /** Current structural revision for mounted World projections. */
+    getStructureEpoch(): number;
+    /** Mark a component as both added and changed at the current tick. */
+    private internalmarkComponentAdded;
+    /** Mark one mutation's component instances with a shared epoch. */
+    private internalmarkComponentsAdded;
+    /** Mark an existing component as changed at the current tick. */
+    private internalmarkComponentChanged;
+    /** Mark one contiguous component range with a single epoch. */
+    private internalmarkComponentRangeChanged;
+    /** Latest mutation token for one component-owned projection. */
+    private internalgetComponentMutationEpoch;
+    /** Read a materialized relationship target in O(1 + k). */
+    private internalgetRelationshipTargetEntities;
+    /** Monotonic epoch for the materialized relationship index. */
+    private internalgetRelationshipEpoch;
+    /** Publish changes to a value derived without an authored mutation epoch. */
+    private internalmarkDerivedComponentChanges;
+    /** Query facade write after the facade has already marked evidence. */
+    private internalsetQueryRow;
+    /** Query facade read that does not re-enter the public World API. */
+    private internalgetQueryRow;
+    /** Remove one component's change state after archetype removal. */
+    private internalremoveComponentChange;
+    /** Remove all change state before an entity handle is retired. */
+    private internalremoveEntityChanges;
+    /** Return resource change ticks for diagnostics and resource-driven systems. */
+    getResourceChange(name: string): ChangeTicks | undefined;
+    /**
+     * Route a structured error from
+     * an engine-internal subsystem (e.g. RenderSystem extract stage, w15).
+     *
+     * Mirrors the private `errorHandler(err, ctx)` call sites inside `World`
+     * itself; the dedicated accessor avoids exposing `errorHandler` directly
+     * and keeps the routing contract under the `_xxx` `@internal` umbrella so
+     * AI users do not discover it through IDE autocomplete on `World`.
+     *
+     * Not part of the public API.
+     */
+    private internalrouteError;
+    /** */ private internalgetRecords;
+    /** */ private internalgetFreeIndices;
+    /** */ private internalgetResources;
+    /** */ private internalgetFixedAccumulator;
+    /** */ private internalsetFixedAccumulator;
+    /** */ private internalgetUniqueRefs;
+    /** */ private internalgetBufferPool;
+    /** Scheduler-owned mutable clock capability. */
+    private internalgetClockWriter;
+    /** */ private internalgetSchedule;
+    /** */ private internalgetSchedules;
+    /** */ private internalgetSharedRefs;
+    /**
+     * Register a system with query descriptor and optional ordering constraints.
+     *
+     * `const Qs` mirrors the free `addSystem` signature so the call-site
+     * `queries` tuple is locked literal-form, letting `descriptor.fn`'s first
+     * parameter recover per-query row access shapes (S-5, KD-3 — class method
+     * generic, not free function double track).
+     *
+     * @example
+     * ```ts
+     * const Position = defineComponent('Position', { x: 'f32', y: 'f32' });
+     * const world = new World();
+     * world.addSystem(Update, {
+     *   name: 'read-pos',
+     *   queries: [{ with: [Position] }],
+     *   fn: (world, queries) => { void world; for (const row of queries[0]) { void row.entity; } },
+     * });
+     * ```
+     */
+    addSystem<const Qs extends ReadonlyArray<QueryDescriptor>>(schedule: import('./schedule-token').ScheduleToken, descriptor: SystemDescriptor<Qs>): Result<void, ScheduleScopeMismatchError>;
+    /**
+     * Remove a registered system by name (M2 — plan-strategy D-3).
+     *
+     * Returns `Result<void, ScheduleMutationError>`:
+     * - ok branch: the slot is dropped and the schedule will rebuild on the
+     *   next `update()`.
+     * - err branch with `.code === 'system-before-unknown'`: no system carries
+     *   this name; `.detail.candidates` lists the registered names.
+     *
+     * Designed to support `@forgeax/engine-remote`'s typed `injectSystem` /
+     * `removeSystem` channel and the WS-disconnect reverse-remove path.
+     *
+     * @example
+     * ```ts
+     * const r = world.removeSystem(Update, 'movement');
+     * if (!r.ok) console.error(r.error.code, r.error.detail.candidates);
+     * ```
+     */
+    removeSystem(schedule: import('./schedule-token').ScheduleToken, name: string): Result<void, ScheduleMutationError | ScheduleScopeMismatchError>;
+    /**
+     * Replace a registered system in-place (M2 — plan-strategy D-3 atomic semantics).
+     *
+     * Overwrites the descriptor stored under `name` while preserving the
+     * registration slot — `before / after` references that target this name
+     * remain bound.
+     *
+     * Returns `Result<void, ScheduleMutationError>`:
+     * - ok branch: descriptor swapped, schedule marked dirty.
+     * - err branch with `.code === 'system-before-unknown'`: no system carries
+     *   this name; use `addSystem(descriptor)` to register a new one instead.
+     *
+     * @example
+     * ```ts
+     * const r = world.replaceSystem(Update, 'movement', {
+     *   name: 'movement',
+     *   queries: [{ with: [Position] }],
+     *   fn: (world, queryResults) => { ... },
+     * });
+     * ```
+     */
+    replaceSystem<const Qs extends ReadonlyArray<QueryDescriptor>>(schedule: import('./schedule-token').ScheduleToken, name: string, descriptor: SystemDescriptor<Qs>): Result<void, ScheduleMutationError | ScheduleScopeMismatchError>;
+    /**
+     * Batch-register systems to a set. Validates the set token before writing.
+     *
+     * - First call for a system name: registers it via the existing `addSystem` path.
+     * - Subsequent calls: only adds the system name to the set's members (dedup).
+     *
+     * Returns `Result.err` with `SystemSetNotRegisteredError` if the set token
+     * fails identity validation.
+     *
+     * @example
+     * ```ts
+     * const GameplaySet = defineSystemSet({ name: 'gameplay' });
+     * const world = new World();
+     * const r = world.addSystems(Update, GameplaySet, [movement, collision]);
+     * if (!r.ok) console.error(r.error.code, r.error.hint);
+     * ```
+     */
+    addSystems<const Qs extends ReadonlyArray<QueryDescriptor>>(schedule: import('./schedule-token').ScheduleToken, set: SystemSet, systems: ReadonlyArray<SystemDescriptor<Qs>>): Result<void, SystemSetNotRegisteredError | ScheduleScopeMismatchError>;
+    /**
+     * Execute one frame: run all systems in DAG order, then flush deferred commands.
+     * Empty world (no systems) completes silently (E-09).
+     *
+     * @example
+     * ```ts
+     * const Position = defineComponent('Position', { x: 'f32', y: 'f32' });
+     * const world = new World();
+     * world.spawn({ component: Position, data: { x: 0, y: 0 } }).unwrap();
+     * world.update(); // run all systems + flush commands
+     * ```
+     */
+    update(deltaSeconds?: number): Result<void, TimeDeltaInvalidError | TimeConfigInvalidError | ScheduleScopeMismatchError | WorldPoisonedError | CommandFailedError | SystemFailedError | import('./errors').CyclicDependencyError | SharedKernelFailureError>;
+    /** Insert or overwrite a resource (idempotent, E-13). */
+    insertResource<T>(key: string | {
+        readonly name: string;
+    }, value: T): void;
+    /**
+     * Get a resource by key.
+     * @throws ResourceNotFoundError if key not found (E-14).
+     */
+    getResource(key: typeof import('./time').Time): import('./time').TimeResource;
+    getResource(key: typeof import('./time').FixedTime): import('./time').FixedTimeResource;
+    getResource<T>(key: string | {
+        readonly name: string;
+    }): T;
+    /** Check if a resource exists. */
+    hasResource(key: string | {
+        readonly name: string;
+    }): boolean;
+    /** Remove a resource by key. */
+    removeResource(key: string | {
+        readonly name: string;
+    }): void;
+    /**
+     * Return a typed diagnostic snapshot of the World state.
+     * All fields are non-undefined. Useful for AI users to programmatically
+     * introspect entity count, archetypes, registered components, systems,
+     * and resources without console.log or a debugger.
+     *
+     * @example
+     * ```ts
+     * const Position = defineComponent('Position', { x: 'f32', y: 'f32' });
+     * const world = new World();
+     * world.spawn({ component: Position, data: { x: 0, y: 0 } }).unwrap();
+     * const snap = world.inspect();
+     * console.log(snap.entityCount, snap.activeComponents);
+     * ```
+     */
+    inspect(): WorldInspection;
+    /** Return the registered schedule graphs and their declared access metadata. */
+    scheduleData(): ReadonlyArray<WorldScheduleData>;
+    /**
+     * Allocate a standalone managed reference handle with an optional release
+     * callback. Returns a branded {@link Handle}<Target, 'unique'> that can be
+     * stored in schema-vocab `ref<T>` fields or resolved through
+     * {@link UniqueRefStore.resolve} (via `world.get` on a component with
+     * `ref<T>` fields).
+     *
+     * When the handle is released (despawn / removeComponent / set-overwrite),
+     * the `onRelease` callback fires with the payload (captured on the stack);
+     * by then the slot's bookkeeping (callback table, payload map, freelist) is
+     * already cleared, so a *throwing* `onRelease` re-propagates from the first
+     * `release` call without leaving the store inconsistent — a second `release`
+     * of the same handle returns `UniqueRefDoubleReleaseError` as expected. RAII
+     * cleanup semantics preserved (plan-strategy D-5; throw-safety AC-01/02).
+     *
+     * Handles are *operational, not persistent*: caching them across release
+     * boundaries (despawn / removeComponent / set-overwrite) is undefined
+     * behavior — the same `u32` may silently resolve to a freshly allocated
+     * payload after slot reuse. See `packages/ecs/README.md` § "Managed handles
+     * are operational, not persistent" and `docs/specs/2026-06-14-ecs-managed-
+     * lifecycle-ssot-design.md` § 3.3.
+     *
+     * @typeParam Target - phantom string branding the handle (type-level only).
+     * @typeParam T - the payload type stored alongside the handle.
+     * @param target - phantom target string (type-level discriminant).
+     * @param payload - the value to store. Identity-stable until release.
+     * @param onRelease - optional cleanup hook called with the payload on release.
+     * @returns a branded `Handle<Target, 'unique'>` u32.
+     *
+     * @example
+     * ```ts
+     * const world = new World();
+     * const handle = world.allocUniqueRef<'PhysicsBody', RigidBodyHandle>(
+     *   'PhysicsBody',
+     *   rapierHandle,
+     *   (h) => rapierWorld.removeRigidBody(h),
+     * );
+     * const Holder = defineComponent('Holder', { body: 'unique<PhysicsBody>' });
+     * world.spawn(Holder, { body: handle });
+     * // Despawn triggers onRelease -> Rapier body is cleaned up.
+     * ```
+     */
+    allocUniqueRef<Target extends string, T>(target: Target, payload: T, onRelease?: (payload: T) => void): Handle<Target, 'unique'>;
+    /**
+     * Allocate a shared (refcount-tracked) handle through the per-World
+     * {@link SharedRefStore}. Returns a `Handle<Target, 'shared'>` u32 with
+     * rc=1 (the alloc-grant). Consumers retain/release via `world.sharedRefs`.
+     *
+     * Final release publishes structured evidence through the owning
+     * {@link SharedRefStore}; payload disposal remains with the
+     * renderer/assets/plugin owner and is not a user callback.
+     *
+     * Intended for asset-registry-style producers — anything whose lifecycle
+     * is shared across multiple holders (ECS components + external systems).
+     * The single-holder one-shot release pattern stays on
+     * {@link World.allocUniqueRef} (`Handle<T, 'unique'>`).
+     *
+     * @typeParam Target - phantom string branding the handle (type-level only).
+     * @typeParam T - the payload type stored alongside the handle.
+     * @param target - phantom target string (type-level discriminant).
+     * @param payload - the value to store. Identity-stable until final release.
+     * @returns a branded `Handle<Target, 'shared'>` u32 with rc=1.
+     *
+     * @example
+     * ```ts
+     * const world = new World();
+     * const handle = world.allocSharedRef<'MaterialAsset', MaterialPayload>(
+     *   'MaterialAsset',
+     *   payload,
+     * );
+     * const M = defineComponent('M', { asset: 'shared<MaterialAsset>' });
+     * world.spawn({ component: M, data: { asset: handle } });
+     * // The write-barrier dispatch retains/releases automatically on spawn / despawn.
+     * ```
+     */
+    allocSharedRef<Target extends string, T>(target: Target, payload: T): Handle<Target, 'shared'>;
+    /**
+     * Return one producer-owned shared handle per `(target, payload object)` in
+     * this World. Repeated discovery does not retain; ECS holders still retain
+     * and release through the normal write barrier. Asset catalogues use this
+     * when repeated scene instantiation resolves the same catalogued payload.
+     * Use {@link World.allocSharedRef} for independent resources or deleters.
+     */
+    internSharedRef<Target extends string, T extends object>(target: Target, payload: T): Handle<Target, 'shared'>;
+    private relationshipTargetWriteError;
+    private relationshipTargetPayloadWrites;
+    get<S extends ComponentSchema>(entity: EntityHandle, component: Component<string, S>): Result<ShapeOf<S>, EcsError>;
+    /**
+     * Test live component presence without constructing a Result error.
+     *
+     * Read projections commonly need to branch on optional components for many
+     * entities. Calling `get` for that branch allocates a structured
+     * ComponentNotPresentError on every ordinary miss (and StaleEntityError for
+     * a dangling handle). This predicate is deliberately non-throwing and
+     * returns false for both cases; callers that need the detailed error should
+     * continue to use `get`.
+     */
+    hasComponent(entity: EntityHandle, component: Component): boolean;
+    private internalgetArrayView;
+    set<S extends ComponentSchema, C extends Component<string, S>>(entity: EntityHandle, component: C & WritableComponent<C>, value: Partial<InputShapeOf<S>>): Result<void, EcsError>;
+    addComponent<S extends ComponentSchema, C extends Component<string, S>>(entity: EntityHandle, componentData: ComponentData<S> & {
+        component: C & WritableComponent<C>;
+    }): Result<void, EcsError>;
+    private internaladdComponentCore;
+    removeComponent<S extends ComponentSchema, C extends Component<string, S>>(entity: EntityHandle, component: C & WritableComponent<C>): Result<void, EcsError>;
+    private internalremoveComponentCore;
+    private internalallocatePendingEntity;
+    /** */ private internalcancelPendingEntity;
+    private internalmaterializePendingEntity;
+    /** Shared structural preflight for direct and deferred writes. */
+    private internalpreflightComponentData;
+    /** */ private internalallocateIndex;
+    /** */ private internalrecordIsLive;
+    /** */ private internallookupAlive;
+    /** */ private internalreadRow;
+    /** */ private internalwriteEntitySelf;
+    /** */ private internalwriteRow;
+    /** */ private internalreleaseManagedRefsOnRow;
+    /** */ private internalrelationshipOnInsert;
+    /** */ private internalrelationshipOnRemove;
+    /**
+     * Spawn an entity with one or more components.
+     * Multi-component spawn directly targets the correct archetype (AC-06).
+     *
+     * @returns `Result<Entity, EcsError>` — `ok(Entity)` on success.
+     *   EntityIndexOverflowError still throws (build-time / infrastructure failure).
+     *
+     * @example
+     * ```ts
+     * const Position = defineComponent('Position', { x: 'f32', y: 'f32' });
+     * const world = new World();
+     * const r = world.spawn({ component: Position, data: { x: 0, y: 0 } });
+     * if (!r.ok) { console.error(r.error.code); return; }
+     * const entity = r.value;
+     * ```
+     */
+    spawn<const SArr extends readonly ComponentSchema[]>(...componentDatas: {
+        [K in keyof SArr]: {
+            component: Component<string, SArr[K]>;
+            data: Partial<InputShapeOf<SArr[K]>>;
+        };
+    }): Result<EntityHandle, EcsError>;
+    /**
+     * Core implementation of `spawn` with reentry guard.
+     *
+     * @param internal — `true` when called from relationship maintenance
+     *   (lazy mirror create or exclusive reparent).
+     */
+    private internalspawnCore;
+    /**
+     * Despawn an entity. Stale handles are silently ignored (E-01, AC-17).
+     * Generation retirement: gen=255 → index permanently retired (D-08/E-08).
+     *
+     * @returns `Result<void, EcsError>` — `ok(void)` always (idempotent on stale handles).
+     *
+     * @example
+     * ```ts
+     * const Position = defineComponent('Position', { x: 'f32', y: 'f32' });
+     * const world = new World();
+     * const e = world.spawn({ component: Position, data: { x: 0, y: 0 } }).unwrap();
+     * const r = world.despawn(e);
+     * r.unwrap(); // idempotent: ok(void) even on stale handle
+     * ```
+     */
+    despawn(entity: EntityHandle): Result<void, EcsError>;
+    /** Despawn every live entity through the normal lifecycle and ref cleanup path. */
+    despawnAll(): Result<void, EcsError>;
+    /**
+     * Core implementation of `despawn` with reentry guard.
+     *
+     * @param internal — `true` when called from within linkedSpawn cascade.
+     *   Nested despawn skips relationship pruning after the parent is retired;
+     *   the linkedSpawn collection still walks the subtree so grandchildren
+     *   cascade correctly (tweak-20260714 M2, R-6).
+     */
+    private internaldespawnCore;
+    addChild<S extends ComponentSchema>(parent: EntityHandle, child: EntityHandle, component: Component<string, S>, data: Partial<InputShapeOf<S>>): Result<void, EcsError>;
+    removeChild<S extends ComponentSchema>(parent: EntityHandle, child: EntityHandle, component: Component<string, S>): Result<void, EcsError>;
+    reparent<S extends ComponentSchema>(child: EntityHandle, newParent: EntityHandle, component: Component<string, S>, data: Partial<InputShapeOf<S>>): Result<void, EcsError>;
+    iterAncestors(entity: EntityHandle): Iterable<EntityHandle>;
+    iterDescendants(entity: EntityHandle): Iterable<EntityHandle>;
+}
+export {};
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

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