/**
 * Seam for game code to reach the motion the shell's FrameDriver
 * otherwise owns privately (#162.4). Game code calls `impulse`,
 * `pushHorizontal`, `setVerticalVelocity`, and/or `setY` from `onTick` or
 * commands; the shell calls `takePending()` once per frame, before
 * integrating gravity, to drain what accumulated. `setY` wins over physics
 * for that frame; impulses add to the velocity the driver is about to
 * integrate; a later `setVerticalVelocity` replaces that velocity outright.
 * Horizontal pushes compose with the walk controller (#282.4): they add to
 * its horizontal velocity and decay naturally as it re-blends toward input —
 * knockback, dashes, explosion shoves without raw `setPose` offsets.
 *
 * Intentionally not `ctx.version()`/`ctx.subscribe` wired: these fire at
 * most once per frame and would otherwise storm subscribers with per-frame
 * churn (same rationale as `InputSnapshot.publish`).
 */
export interface MotionIntents {
    impulse(velocityY: number): void;
    /** Adds a horizontal velocity kick (world units/s) that the walk controller integrates and decays. */
    pushHorizontal(velocityX: number, velocityZ: number): void;
    setVerticalVelocity(velocityY: number): void;
    setY(y: number): void;
    takePending(): MotionIntentBatch | null;
    /** Non-draining copy of the pending intents for a whole-world save; unlike `takePending` it leaves the queue intact. */
    snapshot(): MotionIntentBatch;
    /** Replace the pending intents from a {@link snapshot} payload on save load. */
    hydrate(batch: MotionIntentBatch): void;
}
export interface MotionIntentBatch {
    impulses: readonly number[];
    horizontalImpulses: readonly (readonly [number, number])[];
    verticalVelocity: number | null;
    y: number | null;
}
/** @internal */
export declare function createMotionIntents(): MotionIntents;
/** Fold a batch's vertical impulses into a controller's velocity, then apply an outright `setVerticalVelocity` override — the vertical counterpart of {@link applyHorizontalImpulses}.
 * @internal
 */
export declare function applyMotionImpulses(currentVelocity: number, batch: MotionIntentBatch | null): number;
/** Fold a batch's horizontal pushes into a controller's velocity pair — shared by the walk and voxel drivers.
 * @internal
 */
export declare function applyHorizontalImpulses(velocityX: number, velocityZ: number, batch: MotionIntentBatch | null): readonly [number, number];