@multitapio/multitap 0.0.1

package/dist/types/schema.d.ts.map

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

package/dist/types/session-config.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Compute the session start time for a rolling session.
+ * All clients with synchronized clocks will compute the same startTime
+ * for the current time window (session duration = maxTicks / tickRate seconds).
+ *
+ * The returned startTime should be passed to SessionConfig to ensure all players
+ * join the same session with proper timing coordination by the relay.
+ *
+ * @param timestamp - Unix timestamp in milliseconds (e.g., Date.now())
+ * @param tickRate - Ticks per second (Hz)
+ * @param maxTicks - Maximum ticks per session (determines session duration)
+ * @param cooldown - Optional seconds to add between sessions (default: 0)
+ * @returns Unix timestamp in seconds for the session start time
+ *
+ * @example
+ * ```ts
+ * // Basic usage
+ * const startTime = computeRollingSessionStart(Date.now(), 20, 2000);
+ *
+ * // With 30 second cooldown between sessions
+ * const startTime = computeRollingSessionStart(Date.now(), 20, 2000, 30);
+ *
+ * const sessionConfig = new SessionConfig({
+ *   authority: 'relay.example.com',
+ *   appID: 'mygame',
+ *   path: ['lobby'],
+ *   tickRate: 20,
+ *   maxParticipants: 8,
+ *   maxTicks: 2000,
+ *   startTime,
+ * });
+ * ```
+ */
+export declare function computeRollingSessionStart(timestamp: number, tickRate: number, maxTicks: number, cooldown?: number): number;
+export type ConnectionURL = `multitap://${string}`;
+/**
+ * SessionConfig holds all parameters that define a session's identity.
+ * Two clients must have matching configs to join the same session.
+ */
+export interface SessionConfigOptions {
+    /** Protocol version (must be "v1") */
+    version: string;
+    /** Relay server authority (host:port) - NOT included in genesis hash, only needed for toConnectionURL() */
+    authority?: string;
+    /** Application identifier (DNS-style, lowercase) */
+    appID: string;
+    /** Path segments for session routing (max 8 segments, 32 chars each) */
+    path: string[] | string;
+    /** Tick rate in Hz (1-60) */
+    tickRate: number;
+    /** Maximum participants (1-255) */
+    maxParticipants: number;
+    /** Maximum ticks before session ends (required, 1-864000) */
+    maxTicks: number;
+    /** Session start time in Unix seconds (required, must be > 0) */
+    startTime: number;
+    /** Join credentials - NOT included in hash or filepath */
+    credentials?: string;
+}
+/**
+ * SessionConfig manages session connection configuration.
+ * Provides methods to compute genesis hash, build connection URLs, and validate config.
+ */
+export declare class SessionConfig {
+    readonly version: string;
+    readonly authority: string;
+    readonly appID: string;
+    readonly path: string[];
+    readonly tickRate: number;
+    readonly maxParticipants: number;
+    readonly maxTicks: number;
+    readonly startTime: number;
+    credentials: string;
+    constructor(options: SessionConfigOptions);
+    /**
+     * Validate the session configuration identity fields.
+     * Authority is NOT validated here - it's only required for toConnectionURL().
+     * @throws Error if validation fails
+     */
+    validate(): void;
+    /**
+     * Compute the genesis hash - a deterministic 16-byte session identifier.
+     * Excludes Authority and Credentials from the hash.
+     *
+     * Format (must match Go protocol/session.go ToGenesisHash):
+     * SHA256("multitap:genesis:v1:" || AppID || \x00 || Path[0] || \x00 || ... || TickRate || MaxParticipants || MaxTicks || StartTime)[:16]
+     *
+     * @returns 16-byte genesis hash
+     */
+    toGenesisHash(): Uint8Array;
+    /**
+     * Build a multitap:// connection URL from this config.
+     * @returns multitap:// URL string
+     */
+    toConnectionURL(): ConnectionURL;
+    /**
+     * Build an HTTPS connection URL (for WebTransport).
+     * @returns HTTPS URL string
+     */
+    toHTTPSURL(): string;
+    /**
+     * Encode the connection URL as base64url for transport through URL-unsafe systems.
+     * @returns base64url-encoded connection URL string
+     */
+    toBase64EncodedConnectionURL(): string;
+    /**
+     * Create a SessionConfig from a base64url-encoded connection URL.
+     * @param encodedURL base64url-encoded connection URL
+     * @returns SessionConfig instance
+     */
+    static fromBase64EncodedConnectionURL(encodedURL: string): SessionConfig;
+    /**
+     * Create a SessionConfig from a multitap:// URL.
+     * @param url multitap:// URL string
+     * @returns SessionConfig instance
+     */
+    static fromConnectionURL(urlString: string): SessionConfig;
+}
+//# sourceMappingURL=session-config.d.ts.map

package/dist/types/session-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-config.d.ts","sourceRoot":"","sources":["../../src/session-config.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAgBR;AAGD,MAAM,MAAM,aAAa,GAAG,cAAc,MAAM,EAAE,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,oBAAoB;IAoBzC;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IA6EhB;;;;;;;;OAQG;IACH,aAAa,IAAI,UAAU;IAmE3B;;;OAGG;IACH,eAAe,IAAI,aAAa;IA+BhC;;;OAGG;IACH,UAAU,IAAI,MAAM;IAKpB;;;OAGG;IACH,4BAA4B,IAAI,MAAM;IAKtC;;;;OAIG;IACH,MAAM,CAAC,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAKxE;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;CAyD3D"}

package/dist/types/session.d.ts

@@ -0,0 +1,120 @@
+import { type InputCodec, type InputSchema } from './input-codec';
+import { type CompiledSchema, type StateBuffer, type StateSchema, type StoreApi } from './state';
+import { type Rollback as RollbackClass } from './rollback';
+import { type Channel as ChannelClass } from './channel';
+import { SessionConfig } from './session-config';
+import type { Participant } from './input-graph';
+export * from './input-graph';
+export interface SessionStats {
+    inputs: Partial<Awaited<ReturnType<(typeof ChannelClass.prototype)['getStats']>>>;
+    simulation: Partial<Awaited<ReturnType<(typeof RollbackClass.prototype)['getStats']>>>;
+    renderer: Partial<{
+        fps: number;
+    }>;
+}
+export interface Renderer {
+    init(session: SessionInterface): void;
+    close(session: SessionInterface): void;
+    getStats?: () => SessionStats['renderer'];
+}
+export interface MultitapPlugin {
+    name: string;
+    wasmBytes: Uint8Array;
+    /** Reserved bytes in shared WASM memory for this plugin's data section and stack */
+    reservedBytes: number;
+}
+export interface MultitapConfig {
+    appID: string;
+    tickRate: number;
+    maxTicks: number;
+    maxParticipants: number;
+    plugins: MultitapPlugin[];
+    schema: {
+        state: CompiledSchema;
+        input: InputSchema;
+    };
+}
+export interface SessionOptions {
+    playerKey: Uint8Array;
+    authority?: string;
+    appID: string;
+    path: string[] | string;
+    tickRate: number;
+    maxParticipants: number;
+    maxTicks: number;
+    startTime: number;
+    debug?: boolean;
+    serverCertHash?: string;
+    validatorKeys?: Uint8Array[];
+    autoConnect?: boolean;
+    maxTicksPerBatch?: number;
+    tickLag?: number;
+    connectionTimeoutMs?: number;
+    plugins: MultitapPlugin[];
+    schema: {
+        state: StateSchema | CompiledSchema;
+        input: InputSchema;
+    };
+    renderer: Renderer;
+    dangerouslyDisableSessionCompatibilityHashCheck?: boolean;
+    logSyncTicks?: boolean;
+    enableStatsCollection?: boolean;
+    enableP2P?: boolean;
+}
+declare class Session {
+    private channel;
+    private rollback;
+    private config;
+    private initializing;
+    private initialized;
+    private playerKey;
+    private compiledStateSchema;
+    private channelWorkerUrl;
+    private rollbackWorkerUrl;
+    private rollbackWorker;
+    private channelWorker;
+    private maxTicksPerBatch;
+    private serverCertHash;
+    private validatorKeys;
+    readonly debug: boolean | undefined;
+    private autoConnect;
+    private connectionTimeoutMs;
+    private tickLag;
+    private logSyncTicks;
+    private schema;
+    private closed;
+    private latestState;
+    private loopTimer;
+    private renderer;
+    private plugins;
+    private inputCodec;
+    private stateBindings;
+    private statsTimer;
+    private enableStatsCollection;
+    private stats;
+    private participantsById;
+    private participantsSorted;
+    private peerMesh;
+    private enableP2P;
+    constructor(options: SessionOptions);
+    init(): Promise<void>;
+    getCurrentPlayerId(): string;
+    getParticipants(): readonly Participant[];
+    private onParticipantJoined;
+    getConfig(): SessionConfig;
+    getStateBindings(): StoreApi;
+    getInputBindings(): InputCodec;
+    sendInput(input: Uint8Array): void;
+    getState(): StateBuffer;
+    private onInputSendError;
+    private onStateUpdate;
+    getStats(): SessionStats;
+    close(): Promise<void>;
+    private _collectStats;
+    private collectStats;
+    private createRollbackWorker;
+    private createChannelWorker;
+}
+export declare function createSession(options: SessionOptions): Promise<Session>;
+export type SessionInterface = Awaited<ReturnType<typeof createSession>>;
+//# sourceMappingURL=session.d.ts.map

package/dist/types/session.d.ts.map

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

package/dist/types/state.d.ts

@@ -0,0 +1,400 @@
+/**
+ * Binary state format with Entity-Component-like access patterns and semantics
+ *
+ * A fixed-buffer database optimized for use with ECS and rollback networking:
+ * - O(1) state copying (memcpy semantics)
+ * - Bit-for-bit determinism across languages
+ * - Zero serialization overhead
+ * - Schema-first, cross-language compatible
+ *
+ * See ADR-014: Entity-Component State Format for specification details.
+ *
+ * @module state
+ */
+import { MAGIC, NULL_ENTITY, STATE_ID_OFFSET, STATE_ID_SIZE, TICK_OFFSET, TICK_RATE_OFFSET, type PrimitiveType, type CompoundType, type ArrayType, type EnumType, type FieldType, type EntityRef, type StateBuffer, type FieldDef, type ComponentDef, type EventDef, type StateSchema, type CompiledField, type CompiledComponent, type CompiledEvent, type CompiledStateSchema, type Vec2, type Vec3, type Quat } from './schema';
+export { MAGIC, NULL_ENTITY, STATE_ID_OFFSET, STATE_ID_SIZE, TICK_OFFSET, TICK_RATE_OFFSET, type PrimitiveType, type CompoundType, type ArrayType, type EnumType, type FieldType, type EntityRef, type StateBuffer, type FieldDef, type ComponentDef, type EventDef, type StateSchema, type CompiledField, type CompiledComponent, type CompiledEvent, type Vec2, type Vec3, type Quat, };
+type CompiledSchema = CompiledStateSchema;
+export type { CompiledSchema };
+/**
+ * Pack an entity index and generation into an EntityRef.
+ *
+ * @param index - Entity slot index (0 to maxEntities-1)
+ * @param generation - Generation counter
+ * @returns Packed EntityRef value
+ */
+export declare function packRef(index: number, generation: number): EntityRef;
+/**
+ * Extract the entity index from an EntityRef.
+ *
+ * @param ref - Entity reference
+ * @returns Entity slot index
+ */
+export declare function unpackIndex(ref: EntityRef): number;
+/**
+ * Extract the generation from an EntityRef.
+ *
+ * @param ref - Entity reference
+ * @returns Generation counter
+ */
+export declare function unpackGeneration(ref: EntityRef): number;
+/**
+ * Check if a schema is already compiled.
+ * @deprecated Use isCompiledStateSchema from schema.ts instead
+ */
+export declare function isCompiledSchema(schema: StateSchema | CompiledStateSchema): schema is CompiledStateSchema;
+/**
+ * Compile a schema if needed, or return it if already compiled.
+ * @deprecated Use ensureCompiledStateSchema from schema.ts instead
+ */
+export declare function ensureCompiled(schema: StateSchema | CompiledStateSchema): CompiledStateSchema;
+/**
+ * Compile a schema definition into a CompiledSchema with all layout offsets.
+ * @deprecated Use compileStateSchema from schema.ts instead
+ */
+export declare function compileSchema(schema: StateSchema): CompiledStateSchema;
+/**
+ * Get the stateId from a state buffer.
+ * The stateId uniquely identifies a state based on its input history.
+ *
+ * @param state - State buffer
+ * @returns 32-byte stateId
+ */
+export declare function getStateId(state: Uint8Array): Uint8Array;
+/**
+ * Set the stateId in a state buffer.
+ *
+ * @param state - State buffer to modify
+ * @param stateId - 32-byte stateId to set
+ */
+export declare function setStateId(state: Uint8Array, stateId: Uint8Array): void;
+/**
+ * Get the current tick from a state buffer.
+ *
+ * @param state - State buffer to read from
+ * @returns Current tick number (uint32)
+ */
+export declare function getTick(state: Uint8Array): number;
+/**
+ * Set the current tick in a state buffer.
+ *
+ * @param state - State buffer to modify
+ * @param tick - Tick number to set (uint32)
+ */
+export declare function setTick(state: Uint8Array, tick: number): void;
+/**
+ * Get the tick rate from a state buffer.
+ *
+ * @param state - State buffer to read from
+ * @returns Tick rate (ticks per second, uint8)
+ */
+export declare function getTickRate(state: Uint8Array): number;
+/**
+ * Set the tick rate in a state buffer.
+ *
+ * @param state - State buffer to modify
+ * @param tickRate - Tick rate to set (ticks per second, uint8)
+ */
+export declare function setTickRate(state: Uint8Array, tickRate: number): void;
+/**
+ * Compute the stateId that would result from applying a state transition.
+ *
+ * Formula: SHA256(prevStateId || tick || orderedPayloadsHash)
+ *
+ * @param prevStateId - 32-byte stateId of the previous state
+ * @param tick - Tick number (will be encoded as little-endian uint32)
+ * @param orderedPayloadsHash - 32-byte hash of ordered payloads (one per participant at stable indices)
+ * @returns 32-byte stateId for the resulting state
+ */
+export declare function computeNextStateId(prevStateId: Uint8Array, tick: number, orderedPayloadsHash: Uint8Array): Uint8Array;
+/**
+ * Convenience helper: compute stateId directly from ordered payloads.
+ * Uses hashPayloads to derive the orderedPayloadsHash.
+ */
+export declare function computeNextStateIdFromPayloads(prevStateId: Uint8Array, tick: number, orderedPayloads: Uint8Array[]): Uint8Array;
+/**
+ * Compute the genesis stateId from a genesis hash.
+ * This seeds the stateId chain with global uniqueness.
+ *
+ * @param genesisHash - 16-byte genesis hash
+ * @returns 32-byte genesis stateId
+ */
+export declare function computeGenesisStateId(genesisHash: Uint8Array): Uint8Array;
+/**
+ * Create a new state buffer initialized with the given schema.
+ *
+ * Initial state:
+ * - Header: magic number, alive count = 0, stateId = SHA256(genesisHash) or zeros
+ * - Entity table: all generations = 0, all bitmasks = 0
+ * - Free stack: populated with all indices (0 to maxEntities-1) in reverse order
+ * - Component storage: all zeros
+ * - Singleton storage: all zeros
+ *
+ * @param schema - Compiled schema
+ * @param genesisHash - Optional 16-byte genesis hash to seed the genesis stateId.
+ *                      If not provided, stateId will be all zeros.
+ * @param tickRate - Optional tick rate (ticks per second). Required for physics.
+ * @returns New Uint8Array state buffer
+ */
+export declare function createState(schema: CompiledSchema, genesisHash?: Uint8Array, tickRate?: number): StateBuffer;
+/**
+ * Spawn a new entity.
+ *
+ * Allocation is deterministic - uses LIFO free stack, so spawn order
+ * depends only on previous despawn order.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @returns EntityRef for the new entity
+ * @throws Error if no free entity slots available
+ */
+export declare function spawn(schema: CompiledSchema, state: StateBuffer): EntityRef;
+/**
+ * Check if an entity reference is still valid (alive).
+ *
+ * An entity is alive if its generation matches the stored generation.
+ * After despawn, the generation increments, invalidating old references.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param entity - Entity reference to check
+ * @returns true if entity is alive, false otherwise
+ */
+export declare function isAlive(schema: CompiledSchema, state: StateBuffer, entity: EntityRef): boolean;
+/**
+ * Despawn an entity.
+ *
+ * This operation:
+ * 1. Increments the generation counter (invalidates old references)
+ * 2. Clears the component bitmask
+ * 3. Zeros all component memory for this entity
+ * 4. Pushes the index back onto the free stack
+ * 5. Decrements the alive count
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param entity - Entity reference to despawn
+ * @throws Error if entity is not alive
+ */
+export declare function despawn(schema: CompiledSchema, state: StateBuffer, entity: EntityRef): void;
+/**
+ * Check if an entity has a specific component.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param entity - Entity reference
+ * @param componentName - Component name
+ * @returns true if entity has the component
+ * @throws Error if component is unknown
+ */
+export declare function hasComponent(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string): boolean;
+/**
+ * Add a component to an entity.
+ *
+ * Component memory is already zero from state initialization or prior despawn.
+ * This operation only sets the component's presence bit in the entity bitmask.
+ * Calling this when the component already exists is a no-op (idempotent).
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param entity - Entity reference
+ * @param componentName - Component name to add
+ * @throws Error if entity is not alive or component is unknown
+ */
+export declare function addComponent(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string): void;
+/**
+ * Remove a component from an entity.
+ *
+ * For non-tag components, the component's memory is zeroed.
+ * Calling this when the component doesn't exist is a no-op (idempotent).
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param entity - Entity reference
+ * @param componentName - Component name to remove
+ * @throws Error if entity is not alive or component is unknown
+ */
+export declare function removeComponent(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string): void;
+/**
+ * Generic getter for a component field.
+ * Returns undefined if entity is dead or lacks the component.
+ */
+export declare function getField(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string, fieldName: string, arrayIndex?: number): number | boolean | undefined;
+/**
+ * Generic setter for a component field.
+ * Validates entity is alive and has the component.
+ */
+export declare function setField(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string, fieldName: string, value: number | boolean, arrayIndex?: number): void;
+export declare function getSingletonField(schema: CompiledSchema, state: StateBuffer, componentName: string, fieldName: string, arrayIndex?: number): number | boolean;
+export declare function setSingletonField(schema: CompiledSchema, state: StateBuffer, componentName: string, fieldName: string, value: number | boolean, arrayIndex?: number): void;
+/**
+ * Generic getter for a compound (vec2/vec3/quat) component field.
+ * Returns undefined if entity is dead or lacks the component.
+ */
+export declare function getCompoundField(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string, fieldName: string): [number, number] | [number, number, number] | [number, number, number, number] | undefined;
+/**
+ * Generic setter for a compound (vec2/vec3/quat) component field.
+ * Accepts a tuple of values.
+ */
+export declare function setCompoundField(schema: CompiledSchema, state: StateBuffer, entity: EntityRef, componentName: string, fieldName: string, value: [number, number] | [number, number, number] | [number, number, number, number]): void;
+export declare function getSingletonCompoundField(schema: CompiledSchema, state: StateBuffer, componentName: string, fieldName: string): [number, number] | [number, number, number] | [number, number, number, number];
+export declare function setSingletonCompoundField(schema: CompiledSchema, state: StateBuffer, componentName: string, fieldName: string, value: [number, number] | [number, number, number] | [number, number, number, number]): void;
+/**
+ * Query for entities with specific components.
+ *
+ * Iterates through all entity slots, yielding those that:
+ * - Are alive
+ * - Have all components in the `include` list
+ * - Have none of the components in the `exclude` list
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param include - Component names that must be present
+ * @param exclude - Component names that must NOT be present (optional)
+ * @yields EntityRef for each matching entity
+ */
+export declare function query(schema: CompiledSchema, state: StateBuffer, include: string[], exclude?: string[]): Generator<EntityRef>;
+/**
+ * Query entities by pre-computed bigint bitmasks.
+ *
+ * This is more efficient than `query()` when using generated bindings,
+ * as the masks are computed at module load time rather than per-query.
+ *
+ * @example
+ * // With generated bindings (type-safe):
+ * import { Position, Ship, RespawnTimer, queryMask } from '../generated/state';
+ * const SHIPS_MASK = queryMask([Position, Ship]);
+ * const RESPAWN_MASK = queryMask([RespawnTimer]);
+ * const ships = queryByMask(schema, state, SHIPS_MASK, RESPAWN_MASK);
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param includeMask - Bigint bitmask of components that must be present
+ * @param excludeMask - Bigint bitmask of components that must NOT be present (optional, default 0n)
+ * @yields EntityRef for each matching entity
+ */
+export declare function queryByMask(schema: CompiledSchema, state: StateBuffer, includeMask: bigint, excludeMask?: bigint): Generator<EntityRef>;
+/**
+ * Clear all events of a given type (call at tick start).
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param eventName - Event type name
+ */
+export declare function clearEvents(schema: CompiledSchema, state: StateBuffer, eventName: string): void;
+/**
+ * Get the count of events for a given type this tick.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param eventName - Event type name
+ * @returns Number of events
+ */
+export declare function getEventCount(schema: CompiledSchema, state: StateBuffer, eventName: string): number;
+/**
+ * Push an event to the event buffer.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param eventName - Event type name
+ * @param values - Field values as a record (e.g., { playerIndex: 0, targetX: 100.0, targetY: 200.0 })
+ * @returns true if event was pushed, false if buffer is full
+ */
+export declare function pushEvent(schema: CompiledSchema, state: StateBuffer, eventName: string, values: Record<string, number | boolean | Vec2 | Vec3 | Quat>): boolean;
+/**
+ * Get a field value from an event at a given index.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param eventName - Event type name
+ * @param index - Event index (0 to getEventCount - 1)
+ * @param fieldName - Field name
+ * @returns Field value
+ */
+export declare function getEventField(schema: CompiledSchema, state: StateBuffer, eventName: string, index: number, fieldName: string): number | boolean | Vec2 | Vec3 | Quat;
+/**
+ * Iterate over events of a given type.
+ *
+ * @param schema - Compiled schema
+ * @param state - State buffer
+ * @param eventName - Event type name
+ * @yields Record of field values for each event
+ */
+export declare function iterEvents(schema: CompiledSchema, state: StateBuffer, eventName: string): Generator<Record<string, number | boolean | Vec2 | Vec3 | Quat>>;
+/**
+ * The StoreApi interface with dynamically generated accessors.
+ * Accessors like getPositionX(), setHealth() are generated at runtime.
+ */
+export interface StoreApi {
+    /** The compiled schema */
+    readonly schema: CompiledSchema;
+    /** Create a new state buffer */
+    createState(): StateBuffer;
+    /** Spawn a new entity */
+    spawn(state: StateBuffer): EntityRef;
+    /** Despawn an entity */
+    despawn(state: StateBuffer, entity: EntityRef): void;
+    /** Check if entity is alive */
+    isAlive(state: StateBuffer, entity: EntityRef): boolean;
+    /** Add a component to an entity */
+    addComponent(state: StateBuffer, entity: EntityRef, component: string): void;
+    /** Remove a component from an entity */
+    removeComponent(state: StateBuffer, entity: EntityRef, component: string): void;
+    /** Check if entity has a component */
+    hasComponent(state: StateBuffer, entity: EntityRef, component: string): boolean;
+    /** Query for entities with specific components */
+    query(state: StateBuffer, include: string[], exclude?: string[]): Generator<EntityRef>;
+    /** Index signature for dynamically generated accessors (getX, setX methods) */
+    [key: string]: any;
+}
+/**
+ * Define a state memory layout with the given schema.
+ *
+ * Returns a StoreApi object with:
+ * - Type-safe accessor methods for all component fields
+ * - Type-safe component name parameters
+ * - Core entity/component lifecycle methods
+ *
+ * @param schemaDef - State schema definition (use `as const` for full type inference)
+ * @returns StoreApi object with type-safe API
+ *
+ * @example
+ * ```typescript
+ * const storeApi = createStoreApi({
+ *   maxEntities: 1000,
+ *   components: [
+ *     { name: 'Position', type: 'vec2' },
+ *     { name: 'Health', type: 'int16' },
+ *     { name: 'IsPlayer', type: 'tag' },
+ *   ],
+ * } as const);
+ *
+ * const state = storeApi.createState();
+ * const entity = storeApi.spawn(state);
+ * storeApi.addComponent(state, entity, 'Position');
+ * storeApi.setPositionX(state, entity, 100.5);  // native f32 float
+ * storeApi.addComponent(state, entity, 'Health');
+ * storeApi.setHealth(state, entity, 100);  // Scalar component accessor
+ * ```
+ */
+export declare function createStoreApi(schemaDef: StateSchema | CompiledSchema): StoreApi;
+/**
+ * Extract enum constants from a compiled schema.
+ *
+ * Returns a record mapping constant names to their numeric values.
+ * Naming convention matches the Rust codegen:
+ * - Standalone enum components: `COMPONENT_NAME_VARIANT`
+ * - Enum fields in compounds: `COMPONENT_NAME_FIELD_NAME_VARIANT`
+ *
+ * @param schema - Compiled schema (or raw schema that will be compiled)
+ * @returns Record of enum constant names to values
+ *
+ * @example
+ * ```typescript
+ * const enums = getEnumConstants(schema);
+ * // enums.RIGID_BODY_TYPE_DYNAMIC === 0
+ * // enums.RIGID_BODY_TYPE_FIXED === 1
+ * // enums.COLLIDER_SHAPE_TYPE_BALL === 0
+ * ```
+ */
+export declare function getEnumConstants(schema: StateSchema | CompiledSchema): Record<string, number>;
+//# sourceMappingURL=state.d.ts.map