@quake2ts/shared 0.0.1

package/dist/types/pmove/constants.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Mirrors the Quake II rerelease `water_level_t` enumeration from `game.h`
+ * (lines 443-449). These numeric values are relied upon throughout the
+ * movement code when checking how submerged a player is, so we keep the same
+ * ordering to make future porting work straightforward.
+ */
+export declare enum WaterLevel {
+    None = 0,
+    Feet = 1,
+    Waist = 2,
+    Under = 3
+}
+/**
+ * Utility that matches the common rerelease checks that treat any level at or
+ * above the `WATER_WAIST` constant as "significantly submerged" for friction
+ * and current calculations.
+ */
+export declare function isAtLeastWaistDeep(level: WaterLevel): boolean;
+/**
+ * Returns true when the player is considered underwater (the `WATER_UNDER`
+ * case in the rerelease). This mirrors the places in `p_move.cpp` that gate
+ * effects such as breath timers and screen warping.
+ */
+export declare function isUnderwater(level: WaterLevel): boolean;
+/**
+ * Matches the Quake II rerelease `pmflags_t` bit layout from `game.h` so the
+ * shared helpers can manipulate the same flag words as the authoritative game
+ * and the client prediction layer.
+ */
+export declare const enum PmFlag {
+    Ducked = 1,
+    JumpHeld = 2,
+    OnGround = 4,
+    TimeWaterJump = 8,
+    TimeLand = 16,
+    TimeTeleport = 32,
+    NoPositionalPrediction = 64,
+    OnLadder = 128,
+    NoAngularPrediction = 256,
+    IgnorePlayerCollision = 512,
+    TimeTrick = 1024
+}
+export type PmFlags = number;
+export declare function hasPmFlag(flags: PmFlags, flag: PmFlag): boolean;
+export declare function addPmFlag(flags: PmFlags, flag: PmFlag): PmFlags;
+export declare function removePmFlag(flags: PmFlags, flag: PmFlag): PmFlags;
+/**
+ * Player movement types mirrored from the rerelease `pmtype_t` enumeration.
+ * The exact numeric values matter when syncing pmove state across the network
+ * so we keep the same order as the C++ definition.
+ */
+export declare enum PmType {
+    Normal = 0,
+    Grapple = 1,
+    NoClip = 2,
+    Spectator = 3,
+    Dead = 4,
+    Gib = 5,
+    Freeze = 6
+}
+/**
+ * Bitmask constants for the `buttons` field on the Quake II player command
+ * structure. These mirror the rerelease `BUTTON_*` definitions so logic such as
+ * jump/crouch checks can be shared between the server and client.
+ */
+export declare const enum PlayerButton {
+    None = 0,
+    Attack = 1,
+    Use = 2,
+    Holster = 4,
+    Jump = 8,
+    Crouch = 16,
+    Attack2 = 32,
+    Any = 128
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/pmove/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/pmove/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,UAAU;IACpB,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,0BAAkB,MAAM;IACtB,MAAM,IAAS;IACf,QAAQ,IAAS;IACjB,QAAQ,IAAS;IACjB,aAAa,IAAS;IACtB,QAAQ,KAAS;IACjB,YAAY,KAAS;IACrB,sBAAsB,KAAS;IAC/B,QAAQ,MAAS;IACjB,mBAAmB,MAAS;IAC5B,qBAAqB,MAAS;IAC9B,SAAS,OAAU;CACpB;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,oBAAY,MAAM;IAChB,MAAM,IAAI;IACV,OAAO,IAAI;IACX,MAAM,IAAI;IACV,SAAS,IAAI;IACb,IAAI,IAAI;IACR,GAAG,IAAI;IACP,MAAM,IAAI;CACX;AAED;;;;GAIG;AACH,0BAAkB,YAAY;IAC5B,IAAI,IAAI;IACR,MAAM,IAAS;IACf,GAAG,IAAS;IACZ,OAAO,IAAS;IAChB,IAAI,IAAS;IACb,MAAM,KAAS;IACf,OAAO,KAAS;IAChB,GAAG,MAAS;CACb"}

package/dist/types/pmove/currents.d.ts

@@ -0,0 +1,58 @@
+import type { ContentsFlag } from '../bsp/contents.js';
+import { type Vec3 } from '../math/vec3.js';
+import { WaterLevel } from './constants.js';
+import type { PmoveCmd, PmoveTraceFn } from './types.js';
+export interface WaterCurrentParams {
+    readonly watertype: ContentsFlag;
+    readonly waterlevel: WaterLevel;
+    readonly onGround: boolean;
+    readonly waterSpeed: number;
+}
+export interface GroundCurrentParams {
+    readonly groundContents: ContentsFlag;
+    readonly scale?: number;
+}
+export interface AddCurrentsParams {
+    readonly wishVelocity: Vec3;
+    readonly onLadder: boolean;
+    readonly onGround: boolean;
+    readonly waterlevel: WaterLevel;
+    readonly watertype: ContentsFlag;
+    readonly groundContents: ContentsFlag;
+    readonly cmd: PmoveCmd;
+    readonly viewPitch: number;
+    readonly maxSpeed: number;
+    readonly ladderMod: number;
+    readonly waterSpeed: number;
+    readonly forward: Vec3;
+    readonly origin: Vec3;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly trace?: PmoveTraceFn;
+}
+/**
+ * Mirrors the rerelease pattern in `p_move.cpp` (lines 730-765) that turns the
+ * directional CONTENTS_CURRENT_* flags into a unit-ish direction vector.
+ */
+export declare function currentVectorFromContents(contents: ContentsFlag): Vec3;
+/**
+ * Computes the velocity contribution from water currents using the same rules
+ * as `PM_WaterMove`: the CONTENTS_CURRENT_* bits are turned into a direction
+ * vector, scaled by `pm_waterspeed`, and halved when the player only has their
+ * feet submerged while standing on solid ground.
+ */
+export declare function waterCurrentVelocity(params: WaterCurrentParams): Vec3;
+/**
+ * Computes the conveyor-style velocity that should be applied while touching a
+ * ground plane that carries CONTENTS_CURRENT_* bits. The rerelease multiplies
+ * the direction vector by 100 units per second, so we expose the same default
+ * while allowing callers to override the scalar for tests.
+ */
+export declare function groundCurrentVelocity(params: GroundCurrentParams): Vec3;
+/**
+ * Pure mirror of PM_AddCurrents from rerelease `p_move.cpp`: handles ladder
+ * specific motion tweaks, water currents, and conveyor-style ground currents
+ * before pmove acceleration is applied.
+ */
+export declare function applyPmoveAddCurrents(params: AddCurrentsParams): Vec3;
+//# sourceMappingURL=currents.d.ts.map

package/dist/types/pmove/currents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currents.d.ts","sourceRoot":"","sources":["../../../src/pmove/currents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWvD,OAAO,EAA2D,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAgB,UAAU,EAAsB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAiBD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA6BtE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAkBrE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CASvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAoDrE"}

package/dist/types/pmove/dimensions.d.ts

@@ -0,0 +1,14 @@
+import type { Vec3 } from '../math/vec3.js';
+import { type PmFlags, PmType } from './constants.js';
+export interface PlayerDimensions {
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly viewheight: number;
+}
+/**
+ * Pure mirror of PM_SetDimensions from rerelease `p_move.cpp`.
+ * Computes the mins/maxs/viewheight triplet for a player based on
+ * their movement type and ducked flag without mutating inputs.
+ */
+export declare function computePlayerDimensions(pmType: PmType, pmFlags: PmFlags): PlayerDimensions;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/types/pmove/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../../src/pmove/dimensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAqB1F"}

package/dist/types/pmove/duck.d.ts

@@ -0,0 +1,39 @@
+import { type ContentsFlag } from '../bsp/contents.js';
+import type { Vec3 } from '../math/vec3.js';
+import { type PmFlags, PmType, WaterLevel } from './constants.js';
+import type { PmoveTraceResult } from './types.js';
+import { type PlayerDimensions } from './dimensions.js';
+export interface DuckTraceParams {
+    readonly start: Vec3;
+    readonly end: Vec3;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly mask: ContentsFlag;
+}
+export type DuckTraceFn = (params: DuckTraceParams) => PmoveTraceResult;
+export interface CheckDuckParams {
+    readonly pmType: PmType;
+    readonly pmFlags: PmFlags;
+    readonly buttons: number;
+    readonly waterlevel: WaterLevel;
+    readonly hasGroundEntity: boolean;
+    readonly onLadder: boolean;
+    readonly n64Physics: boolean;
+    readonly origin: Vec3;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly trace: DuckTraceFn;
+}
+export interface CheckDuckResult extends PlayerDimensions {
+    readonly pmFlags: PmFlags;
+    readonly ducked: boolean;
+    readonly changed: boolean;
+}
+/**
+ * Pure port of PM_CheckDuck from rerelease `p_move.cpp`. Updates the PMF_DUCKED flag
+ * based on crouch input, obstruction traces, and special cases (dead bodies) without
+ * mutating the provided mins/maxs. Returns the updated flag word plus the dimensions
+ * computed from PM_SetDimensions so callers can update collision bounds atomically.
+ */
+export declare function checkDuckState(params: CheckDuckParams): CheckDuckResult;
+//# sourceMappingURL=duck.d.ts.map

package/dist/types/pmove/duck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duck.d.ts","sourceRoot":"","sources":["../../../src/pmove/duck.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAGL,KAAK,OAAO,EACZ,MAAM,EACN,UAAU,EAIX,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMjF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,gBAAgB,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA8BvE"}

package/dist/types/pmove/fly.d.ts

@@ -0,0 +1,34 @@
+import { type Vec3 } from '../math/vec3.js';
+import { type StepSlideMoveOutcome } from './slide.js';
+import type { PmoveCmd, PmoveTraceFn } from './types.js';
+export interface FlyMoveParams {
+    readonly origin: Vec3;
+    readonly velocity: Vec3;
+    readonly cmd: PmoveCmd;
+    readonly forward: Vec3;
+    readonly right: Vec3;
+    readonly frametime: number;
+    readonly pmFriction: number;
+    readonly pmStopSpeed: number;
+    readonly pmMaxSpeed: number;
+    readonly pmAccelerate: number;
+    readonly pmWaterSpeed: number;
+    readonly doclip: boolean;
+    readonly mins?: Vec3;
+    readonly maxs?: Vec3;
+    readonly trace?: PmoveTraceFn;
+    readonly overbounce?: number;
+    readonly stepSize?: number;
+    readonly maxBumps?: number;
+    readonly maxClipPlanes?: number;
+}
+export type FlyMoveResult = StepSlideMoveOutcome;
+/**
+ * Pure translation of PM_FlyMove from rerelease `p_move.cpp`: applies the
+ * spectator/noclip friction and acceleration rules, then either advances the
+ * origin freely or resolves movement through `stepSlideMove` when clipping is
+ * requested. This keeps the spectator and noclip physics deterministic between
+ * the client and server.
+ */
+export declare function applyPmoveFlyMove(params: FlyMoveParams): FlyMoveResult;
+//# sourceMappingURL=fly.d.ts.map

package/dist/types/pmove/fly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fly.d.ts","sourceRoot":"","sources":["../../../src/pmove/fly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAG3F,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAwEtE"}

package/dist/types/pmove/index.d.ts

@@ -0,0 +1,18 @@
+export * from './apply.js';
+export * from './categorize.js';
+export * from './constants.js';
+export * from './currents.js';
+export * from './dimensions.js';
+export * from './duck.js';
+export * from './fly.js';
+export * from './jump.js';
+export * from './move.js';
+export * from './pmove.js';
+export * from './slide.js';
+export * from './snap.js';
+export * from './special.js';
+export * from './stuck.js';
+export * from './types.js';
+export * from './view.js';
+export * from './water.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/pmove/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pmove/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/types/pmove/jump.d.ts

@@ -0,0 +1,28 @@
+import type { Vec3 } from '../math/vec3.js';
+import { WaterLevel, type PmFlags, PmType } from './constants.js';
+export interface CheckJumpParams {
+    readonly pmFlags: PmFlags;
+    readonly pmType: PmType;
+    readonly buttons: number;
+    readonly waterlevel: WaterLevel;
+    readonly onGround: boolean;
+    readonly velocity: Vec3;
+    readonly origin: Vec3;
+    readonly jumpHeight?: number;
+}
+export interface CheckJumpResult {
+    readonly pmFlags: PmFlags;
+    readonly onGround: boolean;
+    readonly velocity: Vec3;
+    readonly origin: Vec3;
+    readonly jumpSound: boolean;
+    readonly jumped: boolean;
+}
+/**
+ * Pure translation of the rerelease `PM_CheckJump` helper from `p_move.cpp`.
+ * The function takes in the minimal pmove state that the original C++ logic
+ * touches and returns the updated flag/origin/velocity tuple so callers can
+ * apply the same semantics on both the server and client.
+ */
+export declare function checkJump(params: CheckJumpParams): CheckJumpResult;
+//# sourceMappingURL=jump.d.ts.map

package/dist/types/pmove/jump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jump.d.ts","sourceRoot":"","sources":["../../../src/pmove/jump.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,OAAO,EAAU,MAAM,EAAyC,MAAM,gBAAgB,CAAC;AAIjH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAoDlE"}

package/dist/types/pmove/move.d.ts

@@ -0,0 +1,78 @@
+import type { Vec3 } from '../math/vec3.js';
+import { type StepSlideMoveOutcome } from './slide.js';
+import type { PmoveCmd, PmoveTraceFn } from './types.js';
+import { type PmFlags, PmType, WaterLevel } from './constants.js';
+interface BaseMoveParams {
+    readonly origin: Vec3;
+    readonly velocity: Vec3;
+    readonly frametime: number;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly trace: PmoveTraceFn;
+    readonly overbounce?: number;
+    readonly stepSize?: number;
+    readonly maxBumps?: number;
+    readonly maxClipPlanes?: number;
+    readonly hasTime?: boolean;
+}
+export interface AirMoveParams extends BaseMoveParams {
+    readonly cmd: PmoveCmd;
+    readonly forward: Vec3;
+    readonly right: Vec3;
+    readonly pmFlags: PmFlags;
+    readonly onGround: boolean;
+    readonly gravity: number;
+    readonly pmType: PmType;
+    readonly pmAccelerate: number;
+    readonly pmAirAccelerate?: number;
+    readonly pmMaxSpeed: number;
+    readonly pmDuckSpeed: number;
+    readonly onLadder: boolean;
+    readonly waterlevel: WaterLevel;
+    readonly watertype: number;
+    readonly groundContents: number;
+    readonly viewPitch: number;
+    readonly ladderMod: number;
+    readonly pmWaterSpeed: number;
+}
+export interface WaterMoveParams extends BaseMoveParams {
+    readonly cmd: PmoveCmd;
+    readonly forward: Vec3;
+    readonly right: Vec3;
+    readonly pmFlags: PmFlags;
+    readonly onGround: boolean;
+    readonly pmMaxSpeed: number;
+    readonly pmDuckSpeed: number;
+    readonly pmWaterAccelerate: number;
+    readonly pmWaterSpeed: number;
+    readonly onLadder: boolean;
+    readonly watertype: number;
+    readonly groundContents: number;
+    readonly waterlevel: WaterLevel;
+    readonly viewPitch: number;
+    readonly ladderMod: number;
+}
+export interface WalkMoveParams extends BaseMoveParams {
+    readonly cmd: PmoveCmd;
+    readonly forward: Vec3;
+    readonly right: Vec3;
+    readonly pmFlags: PmFlags;
+    readonly onGround: boolean;
+    readonly gravity: number;
+    readonly pmType: PmType;
+    readonly pmAccelerate: number;
+    readonly pmMaxSpeed: number;
+    readonly pmDuckSpeed: number;
+    readonly onLadder: boolean;
+    readonly waterlevel: WaterLevel;
+    readonly watertype: number;
+    readonly groundContents: number;
+    readonly viewPitch: number;
+    readonly ladderMod: number;
+    readonly pmWaterSpeed: number;
+}
+export declare function applyPmoveAirMove(params: AirMoveParams): StepSlideMoveOutcome;
+export declare function applyPmoveWaterMove(params: WaterMoveParams): StepSlideMoveOutcome;
+export declare function applyPmoveWalkMove(params: WalkMoveParams): StepSlideMoveOutcome;
+export {};
+//# sourceMappingURL=move.d.ts.map

package/dist/types/pmove/move.d.ts.map

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

package/dist/types/pmove/pmove.d.ts

@@ -0,0 +1,40 @@
+import type { Vec3 } from '../math/vec3.js';
+import type { PmoveAccelerateParams, PmoveCmd, PmoveFrictionParams, PmoveWishParams, PmoveWishResult, PmoveState, PmoveImports } from './types.js';
+/**
+ * Pure version of PM_Friction from rerelease p_move.cpp.
+ * Handles ground and water friction and returns a new velocity.
+ */
+export declare function applyPmoveFriction(params: PmoveFrictionParams): Vec3;
+/**
+ * Pure version of PM_Accelerate from rerelease p_move.cpp.
+ * Returns a new velocity with wishdir/wishspeed acceleration applied.
+ */
+export declare function applyPmoveAccelerate(params: PmoveAccelerateParams): Vec3;
+/**
+ * Mirrors PM_AirAccelerate in rerelease `p_move.cpp` (lines ~612-636): wishspeed is clamped
+ * to 30 for the addspeed calculation but the acceleration magnitude still uses the full wishspeed.
+ */
+export declare function applyPmoveAirAccelerate(params: PmoveAccelerateParams): Vec3;
+/**
+ * Pure mirror of PM_CmdScale from rerelease `p_move.cpp`. Computes the scalar applied to
+ * the command directional inputs so that the resulting wish velocity caps at `maxSpeed`
+ * regardless of the directional mix.
+ */
+export declare function pmoveCmdScale(cmd: PmoveCmd, maxSpeed: number): number;
+/**
+ * Computes wishdir/wishspeed for ground/air movement as done in PM_AirMove and
+ * PM_GroundMove. Z is forced to zero and wishspeed is clamped to maxSpeed, matching
+ * the rerelease p_move.cpp helpers before they call PM_Accelerate/PM_AirAccelerate.
+ */
+export declare function buildAirGroundWish(params: PmoveWishParams): PmoveWishResult;
+/**
+ * Computes the wishdir/wishspeed mix for water movement, matching PM_WaterMove in
+ * rerelease p_move.cpp: includes the upward bias when no strong upmove is requested,
+ * clamps wishspeed to maxSpeed, and halves the returned wishspeed before acceleration.
+ */
+export declare function buildWaterWish(params: PmoveWishParams): PmoveWishResult;
+/**
+ * Runs the full player movement simulation for a single frame.
+ */
+export declare function runPmove(state: PmoveState, imports: PmoveImports): PmoveState;
+//# sourceMappingURL=pmove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pmove.d.ts","sourceRoot":"","sources":["../../../src/pmove/pmove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EACV,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAUpB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA6CpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAoBxE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAqB3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYrE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAoB3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAqCvE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,CAkO7E"}

package/dist/types/pmove/slide.d.ts

@@ -0,0 +1,63 @@
+import { type Vec3 } from '../math/vec3.js';
+import type { PmoveTraceFn } from './types.js';
+export declare const SLIDEMOVE_BLOCKED_FLOOR = 1;
+export declare const SLIDEMOVE_BLOCKED_WALL = 2;
+export interface SlideMoveResult {
+    readonly velocity: Vec3;
+    readonly planes: readonly Vec3[];
+    readonly stopped: boolean;
+}
+export interface SlideMoveParams {
+    readonly origin: Vec3;
+    readonly velocity: Vec3;
+    readonly frametime: number;
+    readonly overbounce: number;
+    readonly trace: PmoveTraceFn;
+    readonly maxBumps?: number;
+    readonly maxClipPlanes?: number;
+    readonly mins?: Vec3;
+    readonly maxs?: Vec3;
+    /**
+     * Mirrors the pm->s.pm_time check in PM_StepSlideMove_Generic: if true, the
+     * returned velocity is reset to the primal velocity after collision
+     * resolution so time-based effects (like knockbacks) don't dampen.
+     */
+    readonly hasTime?: boolean;
+}
+export interface SlideMoveOutcome extends SlideMoveResult {
+    readonly origin: Vec3;
+    readonly blocked: number;
+}
+export interface StepSlideMoveParams extends SlideMoveParams {
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly stepSize?: number;
+}
+export interface StepSlideMoveOutcome extends SlideMoveOutcome {
+    readonly stepped: boolean;
+    readonly stepHeight: number;
+    readonly stepNormal?: Vec3;
+}
+/**
+ * Resolves a sequence of collision planes against a primal velocity using the same
+ * plane iteration logic seen in PM_StepSlideMove_Generic (rerelease p_move.cpp).
+ * The incoming planes should be ordered as they were encountered during traces;
+ * the function will accumulate them, clip the velocity to be parallel to all planes,
+ * and return zero velocity when three planes form an unresolvable corner or when
+ * the adjusted velocity would oppose the primal direction.
+ */
+export declare function resolveSlideMove(initialVelocity: Vec3, planesEncountered: readonly Vec3[], overbounce: number, maxClipPlanes?: number, primalVelocity?: Vec3): SlideMoveResult;
+/**
+ * Pure mirror of PM_SlideMoveGeneric from rerelease `p_move.cpp` (minus gravity/step handling).
+ * Uses a caller-provided trace to collect collision planes, accumulates them through
+ * `resolveSlideMove`, and returns the resulting origin/velocity/blocking state.
+ */
+export declare function slideMove(params: SlideMoveParams): SlideMoveOutcome;
+/**
+ * Mirrors PM_StepSlideMove (rerelease p_move.cpp) in a pure form: attempts a
+ * regular slide move, then retries from a stepped-up position when the first
+ * attempt was blocked. The function compares planar distance traveled and the
+ * steepness of the landing plane to decide whether to keep the step.
+ */
+export declare function stepSlideMove(params: StepSlideMoveParams): StepSlideMoveOutcome;
+//# sourceMappingURL=slide.d.ts.map

package/dist/types/pmove/slide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slide.d.ts","sourceRoot":"","sources":["../../../src/pmove/slide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,IAAI,EACrB,iBAAiB,EAAE,SAAS,IAAI,EAAE,EAClC,UAAU,EAAE,MAAM,EAClB,aAAa,SAA0B,EACvC,cAAc,GAAE,IAAsB,GACrC,eAAe,CA0DjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CA8EnE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,CAiD/E"}

package/dist/types/pmove/snap.d.ts

@@ -0,0 +1,40 @@
+import type { Vec3 } from '../math/vec3.js';
+import type { PmoveTraceFn } from './types.js';
+export interface GoodPositionParams {
+    readonly origin: Vec3;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly trace: PmoveTraceFn;
+}
+export declare function goodPosition(params: GoodPositionParams): boolean;
+export type SnapResolution = 'unchanged' | 'fixed' | 'reverted';
+export interface SnapPositionParams extends GoodPositionParams {
+    readonly velocity: Vec3;
+    readonly previousOrigin: Vec3;
+}
+export interface SnapPositionResult {
+    readonly origin: Vec3;
+    readonly velocity: Vec3;
+    readonly resolution: SnapResolution;
+}
+/**
+ * Pure translation of PM_SnapPosition from rerelease `p_move.cpp`.
+ * Attempts to keep the caller's origin in a valid location by first
+ * checking the current origin against collision traces, then falling
+ * back to the shared `fixStuckObjectGeneric` helper before finally
+ * reverting to the provided previous origin when no fix is possible.
+ */
+export declare function snapPosition(params: SnapPositionParams): SnapPositionResult;
+export interface InitialSnapPositionParams extends GoodPositionParams {
+}
+export interface InitialSnapPositionResult {
+    readonly origin: Vec3;
+    readonly snapped: boolean;
+}
+/**
+ * Pure translation of PM_InitialSnapPosition from rerelease `p_move.cpp`.
+ * Tries a 3x3x3 grid of +/-1 unit offsets around the base origin to find
+ * a valid collision-free spot, mirroring the search order of the C++ code.
+ */
+export declare function initialSnapPosition(params: InitialSnapPositionParams): InitialSnapPositionResult;
+//# sourceMappingURL=snap.d.ts.map

package/dist/types/pmove/snap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap.d.ts","sourceRoot":"","sources":["../../../src/pmove/snap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAIhE;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAmB3E;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;CAAG;AAExE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CAgBhG"}

package/dist/types/pmove/special.d.ts

@@ -0,0 +1,39 @@
+import { type Vec3 } from '../math/vec3.js';
+import { type PmFlags, WaterLevel } from './constants.js';
+import type { PmoveCmd, PmovePointContentsFn, PmoveTraceFn } from './types.js';
+export interface SpecialMovementParams {
+    readonly pmFlags: PmFlags;
+    readonly pmTime: number;
+    readonly waterlevel: WaterLevel;
+    readonly watertype: number;
+    readonly gravity: number;
+    readonly cmd: PmoveCmd;
+    readonly forward: Vec3;
+    readonly origin: Vec3;
+    readonly velocity: Vec3;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly viewheight: number;
+    readonly trace: PmoveTraceFn;
+    readonly pointContents: PmovePointContentsFn;
+    readonly onGround: boolean;
+    readonly overbounce?: number;
+    readonly stepSize?: number;
+    readonly maxBumps?: number;
+    readonly maxClipPlanes?: number;
+}
+export interface SpecialMovementResult {
+    readonly pmFlags: PmFlags;
+    readonly pmTime: number;
+    readonly velocity: Vec3;
+    readonly performedWaterJump: boolean;
+}
+/**
+ * Mirrors the ladder detection and water-jump probing logic from
+ * `PM_CheckSpecialMovement` in `rerelease/p_move.cpp`. The helper clears and
+ * re-adds the ladder flag based on nearby CONTENTS_LADDER brushes, then
+ * simulates a potential water jump by firing the same 40-unit probe and
+ * step-slide loop the C++ uses before committing to the upward velocity.
+ */
+export declare function checkSpecialMovement(params: SpecialMovementParams): SpecialMovementResult;
+//# sourceMappingURL=special.d.ts.map

package/dist/types/pmove/special.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special.d.ts","sourceRoot":"","sources":["../../../src/pmove/special.ts"],"names":[],"mappings":"AACA,OAAO,EAAwD,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAwB,KAAK,OAAO,EAA2B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzG,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgB/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CA0IzF"}

package/dist/types/pmove/stuck.d.ts

@@ -0,0 +1,21 @@
+import { type Vec3 } from '../math/vec3.js';
+import type { PmoveTraceResult } from './types.js';
+export interface FixStuckParams {
+    readonly origin: Vec3;
+    readonly mins: Vec3;
+    readonly maxs: Vec3;
+    readonly trace: FixStuckTraceFn;
+}
+export type FixStuckResult = 'good-position' | 'fixed' | 'no-good-position';
+export interface FixStuckOutcome {
+    readonly result: FixStuckResult;
+    readonly origin: Vec3;
+}
+export type FixStuckTraceFn = (start: Vec3, mins: Vec3, maxs: Vec3, end: Vec3) => PmoveTraceResult;
+/**
+ * TypeScript port of G_FixStuckObject_Generic from rerelease p_move.cpp. Attempts to
+ * nudge a stuck bounding box out of solid space by probing the faces of the box and
+ * moving towards the opposite side, keeping the smallest successful displacement.
+ */
+export declare function fixStuckObjectGeneric(params: FixStuckParams): FixStuckOutcome;
+//# sourceMappingURL=stuck.d.ts.map

package/dist/types/pmove/stuck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck.d.ts","sourceRoot":"","sources":["../../../src/pmove/stuck.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,IAAI,EACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuBnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,OAAO,GAAG,kBAAkB,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,IAAI,KACN,gBAAgB,CAAC;AA2HtB;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAgF7E"}