@cimplify/sdk 0.108.0 → 0.110.2

package/dist/chunk-ZCY6YKKP.mjs

@@ -0,0 +1,475 @@
+import { KitVehicle, vehiclePreset } from './chunk-CYBMFMJD.mjs';
+import { FootContact, ClipEventReader, CHAR_CROUCH, CHAR_SPEED_NORMALIZED, CHAR_HEADING, CHAR_VX, CHAR_VZ, ROOT_IO_DX, ROOT_IO_DZ, ROOT_IO_YAW, DEFAULT_LOOK_SENSITIVITY, DEFAULT_GAMEPAD_LOOK_SPEED, MOVE_IN_X, MOVE_IN_Y, MOVE_OUT_X, MOVE_OUT_Z, CHAR_LANDING_SPEED, CharacterMotor, FollowCamera, TouchControls, MOVE_IO_X, MOVE_IO_Z, MOVE_IO_MAGNITUDE, MOVE_IO_WORDS } from './chunk-ECDK6QBF.mjs';
+import { CameraBoom, LensDriver, wrapAt, yawInto, interpolatedPosition, BOOM_OX, BOOM_OY, BOOM_OZ, BOOM_DX, BOOM_DY, BOOM_DZ, BOOM_DISTANCE, BOOM_FREE, placeCamera, TWO_PI, BOOM_IO_WORDS } from './chunk-Y2EMGN4T.mjs';
+import { ROOT_MOTION_WORDS } from './chunk-7ARSJPV3.mjs';
+import { GEAR_AUTO, INPUT_GEAR, INPUT_STRIDE, INPUT_THROTTLE, INPUT_BRAKE, INPUT_STEER, INPUT_HANDBRAKE } from './chunk-RUVGVNOF.mjs';
+import { RayQuery, RayHit } from './chunk-HF5HPS4T.mjs';
+import { NO_ENTITY } from './chunk-T3AFF3L7.mjs';
+import { FRAME_SECONDS_SLOT } from './chunk-IDLW4NWA.mjs';
+import { GameError } from './chunk-XJIHN3BY.mjs';
+
+// src/game/kit/character/animator.ts
+var ANIM_AIR = 0, ANIM_CROUCH = 1, ANIM_SPEED = 2, ANIM_PELVIS_OFFSET = 3, SENT_X = 4, SENT_Y = 5, SENT_WEIGHT = 6, SENT_CROUCH_X = 7, SENT_CROUCH_WEIGHT = 8, SENT_AIR = 9, BLEND_X = 10, BLEND_Y = 11, BLEND_WEIGHT = 12, CROUCH_WEIGHT = 13, FOOT_X = 14, FOOT_Y = 15, FOOT_Z = 16, FOOT_WEIGHT = 17, FOOT_DROP = 18, ROOT = 19, CROUCH_X = 22, CROUCH_Y = 23, CROUCH_SEND_WEIGHT = 24, AIR_WEIGHT = 25, AIR_SECONDS = 26, FRAME_DT = 27, FEET = 2, LEFT_POSE = 0, RIGHT_POSE = 7, POSE_Z = 2, STATE_WORDS = 28, DEFAULT_BLEND_SHARPNESS = 12, DEFAULT_FOOT_SPACING = 0.12, DEFAULT_ANKLE_HEIGHT = 0.08, DEFAULT_FOOT_REACH = 0.5, SEND_EPSILON = 1e-3, INSTANT = 0, LEFT = -1, RIGHT = 1, ROOT_X = 0, ROOT_Z = 2, ROOT_TURN = 3, CharacterAnimator = class {
+  constructor(port, motor, transforms, options) {
+    this.state = new Float64Array((28));
+    this.root = new Float32Array(ROOT_MOTION_WORDS);
+    this.ray = new RayQuery();
+    this.hit = new RayHit();
+    this.footPoses = new Float64Array((2) * 7);
+    this.port = port, this.motor = motor, this.transforms = transforms, this.locomotion = options.locomotion, this.directional = options.directional ?? false, this.crouch = options.crouch ?? null, this.air = options.air ?? null, this.sharpness = options.blendSharpness ?? (12), this.foot = options.footIk ?? null, this.spacing = this.foot?.spacing ?? (0.12), this.ankle = this.foot?.ankleHeight ?? (0.08), this.reach = this.foot?.reach ?? (0.5), this.motion = options.rootMotion ?? null, this.headingOffset = options.modelForward === -1 ? Math.PI : 0, this.ray.direction.set(0, -1, 0);
+    let foot = this.foot, leftOptions = foot?.leftContact ?? null, rightOptions = foot?.rightContact ?? null, contactPort = leftOptions !== null || rightOptions !== null ? contactPortOf(port) : null;
+    this.leftContact = contactPort !== null && leftOptions !== null && foot !== null ? new FootContact(contactPort, leftOptions, foot) : null, this.rightContact = contactPort !== null && rightOptions !== null && foot !== null ? new FootContact(contactPort, rightOptions, foot) : null;
+    let needsEvents = (leftOptions?.footDown ?? null) !== null || (rightOptions?.footDown ?? null) !== null;
+    if (this.ownsEvents = needsEvents && !foot?.events, this.events = needsEvents ? foot?.events ?? new ClipEventReader() : null, this.feet = foot?.feet ?? null, this.feet !== null && port.readBonePoses === void 0)
+      throw new GameError("invalid_argument", "foot bones need a port with readBonePoses");
+    let s = this.state;
+    for (let i = (4); i <= (9); i++) s[i] = Number.NaN;
+    motor.useRootMotion = this.motion !== null;
+  }
+  update(clock) {
+    let s = this.state, motor = this.motor, m = motor.state, k = 1 - Math.exp(-this.sharpness * clock[FRAME_SECONDS_SLOT]);
+    s[(0)] += ((motor.grounded ? 0 : 1) - s[(0)]) * k, s[(1)] = m[CHAR_CROUCH], s[(2)] += (m[CHAR_SPEED_NORMALIZED] - s[(2)]) * k;
+    let ground = 1 - s[(0)], crouch = this.crouch === null ? 0 : s[(1)], heading = m[CHAR_HEADING];
+    if (this.directional) {
+      let c = Math.cos(heading), n = Math.sin(heading), scale = motor.runSpeed > 0 ? 1 / motor.runSpeed : 0;
+      s[(10)] = (m[CHAR_VX] * c - m[CHAR_VZ] * n) * scale, s[(11)] = (m[CHAR_VX] * n + m[CHAR_VZ] * c) * scale;
+    } else
+      s[(10)] = s[(2)], s[(11)] = 0;
+    s[(12)] = ground * (1 - crouch), s[(13)] = ground * crouch, this.sendLocomotion(), this.crouch !== null && this.sendCrouch(), this.air !== null && this.sendAir(), this.motion !== null && this.readRoot(), this.foot !== null && (s[(27)] = clock[FRAME_SECONDS_SLOT], this.alignFeet());
+  }
+  get leftFoot() {
+    return this.leftContact;
+  }
+  get rightFoot() {
+    return this.rightContact;
+  }
+  sendLocomotion() {
+    let s = this.state;
+    near(s, (4), (10)) && near(s, (5), (11)) && near(s, (6), (12)) || (s[(4)] = s[(10)], s[(5)] = s[(11)], s[(6)] = s[(12)], this.port.setBlendParameterFrom(this.locomotion, s, (10)));
+  }
+  sendCrouch() {
+    let s = this.state;
+    near(s, (7), (2)) && near(s, (8), (13)) || (s[(7)] = s[(2)], s[(8)] = s[(13)], s[(22)] = s[(2)], s[(23)] = 0, s[(24)] = s[(13)], this.port.setBlendParameterFrom(this.crouch, s, (22)));
+  }
+  sendAir() {
+    let s = this.state;
+    near(s, (9), (0)) || (s[(9)] = s[(0)], s[(25)] = s[(0)], s[(26)] = (0), this.port.fadeClipFrom(this.air, s, (25)));
+  }
+  readRoot() {
+    let r = this.root, s = this.state;
+    this.port.readRootMotion(this.motion, r, 0);
+    let angle = this.motor.state[CHAR_HEADING] + this.headingOffset, c = Math.cos(angle), n = Math.sin(angle);
+    s[(19) + ROOT_IO_DX] = r[(0)] * c + r[(2)] * n, s[(19) + ROOT_IO_DZ] = -r[(0)] * n + r[(2)] * c, s[(19) + ROOT_IO_YAW] = r[(3)], this.motor.addRootMotionFrom(s, (19));
+  }
+  alignFeet() {
+    let foot = this.foot, s = this.state, events = this.events;
+    events !== null && (this.ownsEvents && events.read(this.port), this.leftContact?.consume(events.events, events.count), this.rightContact?.consume(events.events, events.count)), this.leftContact !== null && this.leftContact.sample(s[(27)]), this.rightContact !== null && this.rightContact.sample(s[(27)]), this.feet !== null && this.port.readBonePoses(this.feet, this.footPoses, 0), this.footTarget(foot, foot.left, (-1), this.leftContact, (0));
+    let left = s[(18)];
+    this.footTarget(foot, foot.right, (1), this.rightContact, (7));
+    let right = s[(18)], low = left < right ? left : right;
+    s[(3)] = low < 0 ? low * s[(12)] : 0;
+  }
+  footTarget(foot, chain, side, contact, pose) {
+    let s = this.state, motor = this.motor, heading = motor.state[CHAR_HEADING], positions = this.transforms.store.fields.position, o = this.transforms.row(motor.entity) * 3, y = positions[o + 1];
+    this.feet !== null ? (s[(14)] = this.footPoses[pose], s[(16)] = this.footPoses[pose + (2)]) : (s[(14)] = positions[o] + Math.cos(heading) * this.spacing * side, s[(16)] = positions[o + 2] - Math.sin(heading) * this.spacing * side);
+    let ray = this.ray, origin = ray.origin;
+    origin.x = s[(14)], origin.y = y + this.reach, origin.z = s[(16)], ray.maxDistance = this.reach * 2, ray.excludeCollider = motor.collider;
+    let weight = 1 - s[(0)], hit = this.hit, grounded = weight > 0 && foot.physics.raycast(ray, hit);
+    grounded ? (s[(15)] = hit.pointY + this.ankle, s[(17)] = weight, s[(18)] = hit.pointY - y) : (s[(15)] = y + this.ankle, s[(17)] = 0, s[(18)] = 0), contact !== null && contact.resolve(s, (14), grounded, hit.normalX, hit.normalY, hit.normalZ, s[(27)]), this.port.setIkTargetFrom(chain, s, (14));
+  }
+};
+function contactPortOf(port) {
+  if (port.readClipState === void 0 || port.readClipEvents === void 0)
+    throw new GameError("invalid_argument", "foot contacts need a port with readClipState and readClipEvents");
+  return port;
+}
+function near(values, sent, next) {
+  return Math.abs(values[sent] - values[next]) < (1e-3);
+}
+
+// src/game/kit/camera/chase.ts
+var CHASE_X = 0, CHASE_Y = 1, CHASE_Z = 2, CHASE_YAW = 3, CHASE_PITCH = 4, CHASE_DISTANCE = 5, CHASE_FOV = 6, CHASE_SPEED = 7, BASE_YAW = 8, LOOK_YAW = 9, LOOK_PITCH = 10, IDLE = 11, LOOK_X = 12, LOOK_Y = 13, RATE_X = 14, RATE_Y = 15, PIVOT = 16, TARGET = 19, LAST = 22, HEADING = 25, BOOM = 26, STATE_WORDS2 = (26) + BOOM_IO_WORDS, DEFAULT_DISTANCE = 6, DEFAULT_LOOK_HEIGHT = 1.6, DEFAULT_PITCH = -0.22, DEFAULT_SPEED_FOR_EFFECTS = 22, DEFAULT_DISTANCE_GAIN = 0.18, DEFAULT_FOV = 62, DEFAULT_SPEED_KICK = 10, DEFAULT_FOLLOW_SHARPNESS = 14, DEFAULT_YAW_SHARPNESS = 3.5, DEFAULT_RETURN_DELAY = 1.2, DEFAULT_RETURN_SHARPNESS = 3, DEFAULT_RECOVER_SHARPNESS = 3.5, SPEED_YAW_BOOST = 1.5, MAX_LOOK_PITCH = 0.6, MIN_LOOK_PITCH = -0.9, CHASE_PRESETS = {
+  danfo: { distance: 9, lookHeight: 2.4, pitch: -0.2, fov: 60, speedForEffects: 18 },
+  keke: { distance: 5.6, lookHeight: 1.7, pitch: -0.24, fov: 64, speedForEffects: 14 },
+  okada: { distance: 4.4, lookHeight: 1.5, pitch: -0.2, fov: 66, speedForEffects: 20 },
+  car: { distance: 6, lookHeight: 1.5, pitch: -0.2, fov: 62, speedForEffects: 26 }
+};
+function chasePreset(name, overrides = {}) {
+  return { ...CHASE_PRESETS[name], ...overrides };
+}
+var ChaseCamera = class {
+  constructor(physics, transforms, camera, subject, options = {}) {
+    this.state = new Float64Array(STATE_WORDS2);
+    this.initialised = false;
+    this.transforms = transforms, this.camera = camera, this.subject = subject, this.boom = new CameraBoom(physics, options), this.distance = options.distance ?? (6), this.lookHeight = options.lookHeight ?? (1.6), this.pitch = options.pitch ?? (-0.22), this.speedForEffects = options.speedForEffects ?? (22), this.distanceGain = options.distanceGain ?? (0.18), this.fov = options.fov ?? (62), this.speedFovKick = options.speedFovKick ?? (10), this.followSharpness = options.followSharpness ?? (14), this.yawSharpness = options.yawSharpness ?? (3.5), this.lookReturnDelay = options.lookReturnDelay ?? (1.2), this.lookReturnSharpness = options.lookReturnSharpness ?? (3), this.recoverSharpness = options.recoverSharpness ?? (3.5), this.lookSensitivity = options.lookSensitivity ?? DEFAULT_LOOK_SENSITIVITY, this.gamepadLookSpeed = options.gamepadLookSpeed ?? DEFAULT_GAMEPAD_LOOK_SPEED, this.invertY = options.invertY ?? false, this.lens = new LensDriver(options.lens ?? null), this.state[(5)] = this.distance, this.state[(6)] = this.fov;
+  }
+  look(delta) {
+    this.state[(12)] += delta.x, this.state[(13)] += delta.y;
+  }
+  lookRateFrom(input, x, y) {
+    input.valueInto(x, this.state, (14)), input.valueInto(y, this.state, (15));
+  }
+  snap() {
+    this.initialised = false;
+  }
+  update(clock) {
+    let s = this.state, dt = clock[FRAME_SECONDS_SLOT], invert = this.invertY ? -1 : 1, yawInput = -s[(12)] * this.lookSensitivity - s[(14)] * this.gamepadLookSpeed * dt, pitchInput = (-s[(13)] * this.lookSensitivity - s[(15)] * this.gamepadLookSpeed * dt) * invert;
+    if (s[(12)] = 0, s[(13)] = 0, yawInput !== 0 || pitchInput !== 0) {
+      s[(11)] = 0, s[(9)] += yawInput, wrapAt(s, (9));
+      let pitch2 = s[(10)] + pitchInput;
+      s[(10)] = pitch2 < (-0.9) ? (-0.9) : pitch2 > (0.6) ? (0.6) : pitch2;
+    } else if (s[(11)] += dt, s[(11)] > this.lookReturnDelay) {
+      let k = 1 - Math.exp(-this.lookReturnSharpness * dt);
+      s[(9)] -= s[(9)] * k, s[(10)] -= s[(10)] * k;
+    }
+    let entity = this.subject.entity;
+    if (yawInto(this.transforms.store.fields.rotation, this.transforms.row(entity) * 4, s, (25)), interpolatedPosition(this.transforms, entity, clock, s, (19)), !this.initialised)
+      s[(8)] = s[(25)] + Math.PI, wrapAt(s, (8)), s[(16)] = s[(19)], s[(16) + 1] = s[(19) + 1] + this.lookHeight, s[(16) + 2] = s[(19) + 2], s[(7)] = 0;
+    else {
+      if (dt > 0) {
+        let dx = s[(19)] - s[(22)], dy = s[(19) + 1] - s[(22) + 1], dz = s[(19) + 2] - s[(22) + 2], measured = (dx * dx + dy * dy + dz * dz) ** 0.5 / dt;
+        s[(7)] += (measured - s[(7)]) * (1 - Math.exp(-8 * dt));
+      }
+      let k = 1 - Math.exp(-this.followSharpness * dt);
+      s[(16)] += (s[(19)] - s[(16)]) * k, s[(16) + 1] += (s[(19) + 1] + this.lookHeight - s[(16) + 1]) * k, s[(16) + 2] += (s[(19) + 2] - s[(16) + 2]) * k;
+    }
+    s[(22)] = s[(19)], s[(22) + 1] = s[(19) + 1], s[(22) + 2] = s[(19) + 2];
+    let ratio = s[(7)] / this.speedForEffects, effect = ratio > 1 ? 1 : ratio;
+    this.initialised && (s[(25)] += Math.PI - s[(8)], wrapAt(s, (25)), s[(8)] += s[(25)] * (1 - Math.exp(-this.yawSharpness * (1 + (1.5) * effect) * dt)), wrapAt(s, (8))), s[(3)] = s[(8)] + s[(9)], wrapAt(s, (3));
+    let pitch = this.pitch + s[(10)];
+    s[(4)] = pitch < (-0.9) ? (-0.9) : pitch > (0.6) ? (0.6) : pitch, s[(6)] = this.fov + this.speedFovKick * effect, this.lens.apply(s, (6));
+    let yaw = s[(3)], sy = Math.sin(yaw), cy = Math.cos(yaw), sp = Math.sin(s[(4)]), cp = Math.cos(s[(4)]), fx = -sy * cp, fy = sp, fz = -cy * cp;
+    s[(26) + BOOM_OX] = s[(16)], s[(26) + BOOM_OY] = s[(16) + 1], s[(26) + BOOM_OZ] = s[(16) + 2], s[(26) + BOOM_DX] = -fx, s[(26) + BOOM_DY] = -fy, s[(26) + BOOM_DZ] = -fz, s[(26) + BOOM_DISTANCE] = this.distance * (1 + this.distanceGain * effect), this.boom.cast(s, (26), this.subject.bodyId);
+    let allowed = s[(26) + BOOM_FREE], distance = s[(5)];
+    !this.initialised || allowed < distance ? distance = allowed : distance += (allowed - distance) * (1 - Math.exp(-this.recoverSharpness * dt)), distance > allowed && (distance = allowed), s[(5)] = distance, s[(0)] = s[(16)] - fx * distance, s[(1)] = s[(16) + 1] - fy * distance, s[(2)] = s[(16) + 2] - fz * distance, placeCamera(this.transforms, this.camera, s, (0)), this.initialised = true;
+  }
+};
+
+// src/game/kit/camera/first-person-view.ts
+var VIEW_X = 0, VIEW_Y = 1, VIEW_Z = 2, VIEW_YAW = 3, VIEW_PITCH = 4, VIEW_BOB_PHASE = 5, VIEW_BOB_WEIGHT = 6, VIEW_DIP = 7, VIEW_FOV = 8, DIP_VELOCITY = 9, SPRINT = 10, LOOK_X2 = 11, LOOK_Y2 = 12, RATE_X2 = 13, RATE_Y2 = 14, EYE = 15, STATE_WORDS3 = 18, DEFAULT_EYE_HEIGHT = 1.62, DEFAULT_CROUCH_EYE_HEIGHT = 1.02, DEFAULT_BOB_AMPLITUDE = 0.04, DEFAULT_BOB_STRIDE = 2.1, DEFAULT_LAND_DIP = 0.12, DEFAULT_MIN_PITCH = -1.45, DEFAULT_MAX_PITCH = 1.45, DEFAULT_FOV2 = 74, DEFAULT_SPRINT_KICK = 6, DEFAULT_FOV_SHARPNESS = 6, BOB_SIDE_SHARE = 0.5, DIP_DAMPING = 24, MAX_DIP = 0.25, FirstPersonView = class {
+  constructor(transforms, camera, subject, options = {}) {
+    this.state = new Float64Array((18));
+    this.landings = 0;
+    this.transforms = transforms, this.camera = camera, this.subject = subject, this.eyeHeight = options.eyeHeight ?? (1.62), this.crouchEyeHeight = options.crouchEyeHeight ?? (1.02), this.headBob = options.headBob ?? true, this.bobAmplitude = options.bobAmplitude ?? (0.04), this.bobStride = options.bobStride ?? (2.1), this.landDip = options.landDip ?? (0.12), this.minPitch = options.minPitch ?? (-1.45), this.maxPitch = options.maxPitch ?? (1.45), this.lookSensitivity = options.lookSensitivity ?? DEFAULT_LOOK_SENSITIVITY, this.gamepadLookSpeed = options.gamepadLookSpeed ?? DEFAULT_GAMEPAD_LOOK_SPEED, this.invertY = options.invertY ?? false, this.fov = options.fov ?? (74), this.sprintFovKick = options.sprintFovKick ?? (6), this.fovSharpness = options.fovSharpness ?? (6), this.lens = new LensDriver(options.lens ?? null), this.landings = subject.landings, this.state[(3)] = subject.state[CHAR_HEADING] + Math.PI, wrapAt(this.state, (3)), this.state[(8)] = this.fov;
+  }
+  get yaw() {
+    return this.state[(3)];
+  }
+  get pitch() {
+    return this.state[(4)];
+  }
+  look(delta) {
+    this.state[(11)] += delta.x, this.state[(12)] += delta.y;
+  }
+  lookRateFrom(input, x, y) {
+    input.valueInto(x, this.state, (13)), input.valueInto(y, this.state, (14));
+  }
+  moveRelative(io, at) {
+    let yaw = this.state[(3)], sy = Math.sin(yaw), cy = Math.cos(yaw), x = io[at + MOVE_IN_X], y = io[at + MOVE_IN_Y];
+    io[at + MOVE_OUT_X] = cy * x - sy * y, io[at + MOVE_OUT_Z] = -sy * x - cy * y;
+  }
+  update(clock) {
+    let s = this.state, subject = this.subject, dt = clock[FRAME_SECONDS_SLOT], invert = this.invertY ? -1 : 1;
+    s[(3)] -= s[(11)] * this.lookSensitivity + s[(13)] * this.gamepadLookSpeed * dt, wrapAt(s, (3));
+    let pitch = s[(4)] - (s[(12)] * this.lookSensitivity + s[(14)] * this.gamepadLookSpeed * dt) * invert;
+    s[(4)] = pitch < this.minPitch ? this.minPitch : pitch > this.maxPitch ? this.maxPitch : pitch, s[(11)] = 0, s[(12)] = 0, subject.faceView(s, (3));
+    let body = subject.state;
+    subject.landings !== this.landings && (this.landings = subject.landings, s[(9)] -= body[CHAR_LANDING_SPEED] * this.landDip), s[(9)] += (-180 * s[(7)] - (24) * s[(9)]) * dt;
+    let dip = s[(7)] + s[(9)] * dt;
+    s[(7)] = dip < -(0.25) ? -(0.25) : dip > (0.25) ? (0.25) : dip;
+    let speed = body[CHAR_SPEED_NORMALIZED], moving = this.headBob && subject.grounded ? speed < 1 ? speed : 1 : 0;
+    s[(6)] += (moving - s[(6)]) * (1 - Math.exp(-10 * dt)), s[(5)] = (s[(5)] + speed * this.bobStride * TWO_PI * dt) % TWO_PI, s[(10)] += ((subject.sprinting ? 1 : 0) - s[(10)]) * (1 - Math.exp(-this.fovSharpness * dt)), s[(8)] = this.fov + this.sprintFovKick * s[(10)], this.lens.apply(s, (8)), interpolatedPosition(this.transforms, subject.entity, clock, s, (15));
+    let weight = s[(6)] * this.bobAmplitude, phase = s[(5)], lift = Math.abs(Math.sin(phase)) * weight, sway = Math.cos(phase) * weight * (0.5), yaw = s[(3)], eye = this.eyeHeight + (this.crouchEyeHeight - this.eyeHeight) * body[CHAR_CROUCH];
+    s[(0)] = s[(15)] + Math.cos(yaw) * sway, s[(1)] = s[(15) + 1] + eye + lift + s[(7)], s[(2)] = s[(15) + 2] - Math.sin(yaw) * sway, placeCamera(this.transforms, this.camera, s, (0));
+  }
+};
+
+// src/game/kit/touch/viewport.ts
+function engineSurfaceOf(game) {
+  return game.backend.graphics.native ?? null;
+}
+
+// src/game/kit/presets/play.ts
+var TOUCH_CONTROLS = {
+  moveX: "touch.move.x",
+  moveY: "touch.move.y",
+  aimX: "touch.aim.x",
+  aimY: "touch.aim.y",
+  jump: "touch.jump",
+  sprint: "touch.sprint",
+  crouch: "touch.crouch",
+  interact: "touch.interact",
+  fire: "touch.fire",
+  lockOn: "touch.lock",
+  gas: "touch.gas",
+  brake: "touch.brake",
+  handbrake: "touch.handbrake",
+  horn: "touch.horn"
+}, PAD_LEFT_X = 0, PAD_LEFT_Y = 1, PAD_RIGHT_X = 2, PAD_RIGHT_Y = 3, PAD_SOUTH = 0, PAD_EAST = 1, PAD_WEST = 2, PAD_NORTH = 3, PAD_LEFT_BUMPER = 4, PAD_RIGHT_BUMPER = 5, PAD_LEFT_TRIGGER = 6, PAD_RIGHT_TRIGGER = 7, PAD_LEFT_STICK = 10, PAD_RIGHT_STICK = 11, DEFAULT_FOV3 = 62, FIRST_PERSON_FOV = 74, VEHICLE_FOV = 62, LOCK_FRONT_DOT = 0, STICK_FULL = 1;
+function definePlayActions(input, prefix = "play") {
+  return {
+    moveX: input.defineAxis(`${prefix}.moveX`, [
+      { device: "keys", negative: "KeyA", positive: "KeyD" },
+      { device: "keys", negative: "ArrowLeft", positive: "ArrowRight" },
+      { device: "gamepad", axis: (0) },
+      { device: "virtual", control: TOUCH_CONTROLS.moveX }
+    ]),
+    moveY: input.defineAxis(`${prefix}.moveY`, [
+      { device: "keys", negative: "KeyS", positive: "KeyW" },
+      { device: "keys", negative: "ArrowDown", positive: "ArrowUp" },
+      { device: "gamepad", axis: (1), invert: true },
+      { device: "virtual", control: TOUCH_CONTROLS.moveY }
+    ]),
+    lookX: input.defineAxis(`${prefix}.lookX`, [
+      { device: "gamepad", axis: (2) },
+      { device: "virtual", control: TOUCH_CONTROLS.aimX }
+    ]),
+    lookY: input.defineAxis(`${prefix}.lookY`, [
+      { device: "gamepad", axis: (3) },
+      { device: "virtual", control: TOUCH_CONTROLS.aimY, invert: true }
+    ]),
+    jump: input.defineButton(`${prefix}.jump`, [
+      { device: "key", code: "Space" },
+      { device: "gamepad", button: (0) },
+      { device: "virtual", control: TOUCH_CONTROLS.jump }
+    ]),
+    sprint: input.defineButton(`${prefix}.sprint`, [
+      { device: "key", code: "ShiftLeft" },
+      { device: "gamepad", button: (10) },
+      { device: "virtual", control: TOUCH_CONTROLS.sprint }
+    ]),
+    crouch: input.defineButton(`${prefix}.crouch`, [
+      { device: "key", code: "KeyC" },
+      { device: "key", code: "ControlLeft" },
+      { device: "gamepad", button: (1) },
+      { device: "virtual", control: TOUCH_CONTROLS.crouch }
+    ]),
+    interact: input.defineButton(`${prefix}.interact`, [
+      { device: "key", code: "KeyE" },
+      { device: "gamepad", button: (2) },
+      { device: "virtual", control: TOUCH_CONTROLS.interact }
+    ]),
+    fire: input.defineButton(`${prefix}.fire`, [
+      { device: "key", code: "KeyF" },
+      { device: "gamepad", button: (7) },
+      { device: "virtual", control: TOUCH_CONTROLS.fire }
+    ]),
+    lockOn: input.defineButton(`${prefix}.lockOn`, [
+      { device: "key", code: "KeyQ" },
+      { device: "gamepad", button: (11) },
+      { device: "virtual", control: TOUCH_CONTROLS.lockOn }
+    ]),
+    swapShoulder: input.defineButton(`${prefix}.swapShoulder`, [
+      { device: "key", code: "KeyV" },
+      { device: "gamepad", button: (4) }
+    ]),
+    recenter: input.defineButton(`${prefix}.recenter`, [
+      { device: "key", code: "KeyR" },
+      { device: "gamepad", button: (6) }
+    ])
+  };
+}
+function defineDriveActions(input, prefix = "drive") {
+  return {
+    steer: input.defineAxis(`${prefix}.steer`, [
+      { device: "keys", negative: "KeyA", positive: "KeyD" },
+      { device: "keys", negative: "ArrowLeft", positive: "ArrowRight" },
+      { device: "gamepad", axis: (0) },
+      { device: "virtual", control: TOUCH_CONTROLS.moveX }
+    ]),
+    gas: input.defineButton(`${prefix}.gas`, [
+      { device: "key", code: "KeyW" },
+      { device: "key", code: "ArrowUp" },
+      { device: "gamepad", button: (7) },
+      { device: "virtual", control: TOUCH_CONTROLS.gas }
+    ]),
+    brake: input.defineButton(`${prefix}.brake`, [
+      { device: "key", code: "KeyS" },
+      { device: "key", code: "ArrowDown" },
+      { device: "gamepad", button: (6) },
+      { device: "virtual", control: TOUCH_CONTROLS.brake }
+    ]),
+    handbrake: input.defineButton(`${prefix}.handbrake`, [
+      { device: "key", code: "Space" },
+      { device: "gamepad", button: (5) },
+      { device: "virtual", control: TOUCH_CONTROLS.handbrake }
+    ]),
+    horn: input.defineButton(`${prefix}.horn`, [
+      { device: "key", code: "KeyH" },
+      { device: "gamepad", button: (3) },
+      { device: "virtual", control: TOUCH_CONTROLS.horn }
+    ]),
+    lookX: input.defineAxis(`${prefix}.lookX`, [{ device: "gamepad", axis: (2) }]),
+    lookY: input.defineAxis(`${prefix}.lookY`, [{ device: "gamepad", axis: (3) }])
+  };
+}
+function spawnAt(game, position) {
+  let entity = game.world.spawn();
+  return game.transforms.add(entity, position?.[0] ?? 0, position?.[1] ?? 0, position?.[2] ?? 0), entity;
+}
+function cameraLens(game, existing, fov) {
+  let entity = existing ?? game.world.spawn();
+  existing === void 0 && game.transforms.add(entity);
+  let node = game.graphics.camera(entity, fov, 0.1, 1e3);
+  return { entity, lens: { graphics: game.graphics, node, near: 0.1, far: 1e3 } };
+}
+function characterButtons() {
+  return [
+    { control: TOUCH_CONTROLS.jump, label: "Jump" },
+    { control: TOUCH_CONTROLS.sprint, label: "Run", mode: "toggle" },
+    { control: TOUCH_CONTROLS.interact, label: "Use" },
+    { control: TOUCH_CONTROLS.crouch, label: "Crouch", mode: "toggle" },
+    { control: TOUCH_CONTROLS.lockOn, label: "Lock" }
+  ];
+}
+function touchFor(game, options, layout, buttons) {
+  let controls = new TouchControls(game.input, {
+    ui: options.ui ?? null,
+    theme: options.theme,
+    viewport: options.viewport,
+    layout: options.layout ?? layout,
+    move: options.move,
+    look: options.look,
+    buttons: options.buttons ?? buttons
+  }).attach(), source = options.surface ?? (options.viewport === void 0 ? engineSurfaceOf(game) : null);
+  return source !== null && controls.followViewport(source), controls;
+}
+var MOTOR_IO = MOVE_IO_WORDS, DRIVER_WORDS = MOTOR_IO + 3, CharacterDriver = class {
+  constructor(input, actions, motor) {
+    this.input = input;
+    this.actions = actions;
+    this.motor = motor;
+    this.io = new Float64Array(DRIVER_WORDS);
+  }
+  step(frame, clock) {
+    let input = this.input, a = this.actions, io = this.io;
+    input.valueInto(a.moveX, io, MOVE_IN_X), input.valueInto(a.moveY, io, MOVE_IN_Y);
+    let x = io[MOVE_IN_X], y = io[MOVE_IN_Y], length = (x * x + y * y) ** 0.5;
+    frame.moveRelative(io, 0), io[MOTOR_IO + MOVE_IO_X] = io[MOVE_OUT_X], io[MOTOR_IO + MOVE_IO_Z] = io[MOVE_OUT_Z], io[MOTOR_IO + MOVE_IO_MAGNITUDE] = length > (1) ? (1) : length;
+    let motor = this.motor;
+    motor.setMoveFrom(io, MOTOR_IO), motor.setButtons(input.justPressed(a.jump), input.pressed(a.jump), input.pressed(a.sprint), input.pressed(a.crouch)), motor.step(clock);
+  }
+};
+function thirdPersonCharacter(game, options = {}) {
+  let input = game.input, actions = definePlayActions(input, options.prefix), entity = options.entity ?? spawnAt(game, options.position), motor = new CharacterMotor(game.physics, game.transforms, entity, options.character);
+  options.heading !== void 0 && (motor.heading = options.heading);
+  let view = cameraLens(game, options.camera, options.follow?.fov ?? (62)), camera = new FollowCamera(game.physics, game.transforms, view.entity, motor, { lens: view.lens, ...options.follow }), controls = touchFor(game, options, "leftStickRightButtons", characterButtons()), animator = options.animation ? new CharacterAnimator(options.animation.port, motor, game.transforms, options.animation.options) : null, driver = new CharacterDriver(input, actions, motor), lockTargets = [], active = true, pickTarget = (g) => {
+    let positions = g.transforms.store.fields.position, me = g.transforms.row(entity) * 3, yaw = camera.yaw, fx = -Math.sin(yaw), fz = -Math.cos(yaw), best = NO_ENTITY, bestDistance = 1 / 0;
+    for (let i = 0; i < lockTargets.length; i++) {
+      let target = lockTargets[i], o = g.transforms.row(target) * 3, dx = positions[o] - positions[me], dz = positions[o + 2] - positions[me + 2], distance = dx * dx + dz * dz;
+      dx * fx + dz * fz < (0) || distance >= bestDistance || (bestDistance = distance, best = target);
+    }
+    return best;
+  }, rig = {
+    game,
+    actions,
+    motor,
+    camera,
+    controls,
+    animator,
+    entity,
+    cameraEntity: view.entity,
+    lockTargets,
+    get active() {
+      return active;
+    },
+    setActive(next) {
+      active = next, controls.setEnabled(next), next ? controls.attach() : controls.detach();
+    },
+    fixedUpdate(g) {
+      if (!active) return;
+      let a = actions;
+      input.justPressed(a.swapShoulder) && camera.swapShoulder(), input.justPressed(a.recenter) && camera.recenter();
+      let candidate = lockTargets.length > 0 ? pickTarget(g) : NO_ENTITY;
+      input.justPressed(a.lockOn) && camera.lockOn(camera.hasLock ? NO_ENTITY : candidate), driver.step(camera, g.clock);
+    },
+    update(g) {
+      active && (camera.look(input.look), camera.lookRateFrom(input, actions.lookX, actions.lookY), camera.update(g.clock), controls.update(g.clock), animator?.update(g.clock));
+    },
+    system: { fixedUpdate: (g) => rig.fixedUpdate(g), update: (g) => rig.update(g) },
+    dispose() {
+      active = false, controls.dispose();
+    }
+  };
+  return options.register !== false && game.addSystem(rig.system), rig;
+}
+function firstPerson(game, options = {}) {
+  let input = game.input, actions = definePlayActions(input, options.prefix), entity = options.entity ?? spawnAt(game, options.position), motor = new CharacterMotor(game.physics, game.transforms, entity, options.character);
+  motor.faceMovement = false, options.heading !== void 0 && (motor.heading = options.heading);
+  let lens = cameraLens(game, options.camera, options.view?.fov ?? (74)), view = new FirstPersonView(game.transforms, lens.entity, motor, { lens: lens.lens, ...options.view }), buttons = [
+    { control: TOUCH_CONTROLS.fire, label: "Fire", lookThrough: true },
+    { control: TOUCH_CONTROLS.jump, label: "Jump" },
+    { control: TOUCH_CONTROLS.interact, label: "Use" },
+    { control: TOUCH_CONTROLS.crouch, label: "Crouch", mode: "toggle" },
+    { control: TOUCH_CONTROLS.sprint, label: "Run", mode: "toggle" }
+  ], controls = touchFor(game, options, "leftStickRightButtons", buttons), animator = options.animation ? new CharacterAnimator(options.animation.port, motor, game.transforms, options.animation.options) : null, driver = new CharacterDriver(input, actions, motor), active = true, rig = {
+    game,
+    actions,
+    motor,
+    view,
+    controls,
+    animator,
+    entity,
+    cameraEntity: lens.entity,
+    get active() {
+      return active;
+    },
+    setActive(next) {
+      active = next, controls.setEnabled(next), next ? controls.attach() : controls.detach();
+    },
+    fixedUpdate(g) {
+      active && driver.step(view, g.clock);
+    },
+    update(g) {
+      active && (view.look(input.look), view.lookRateFrom(input, actions.lookX, actions.lookY), view.update(g.clock), controls.update(g.clock), animator?.update(g.clock));
+    },
+    system: { fixedUpdate: (g) => rig.fixedUpdate(g), update: (g) => rig.update(g) },
+    dispose() {
+      active = false, controls.dispose();
+    }
+  };
+  return options.register !== false && game.addSystem(rig.system), rig;
+}
+function vehicleDriver(game, options = {}) {
+  let input = game.input, actions = defineDriveActions(input, options.prefix), vehicle = options.vehicle;
+  if (vehicle === void 0) {
+    let spawned = spawnAt(game, options.position);
+    vehicle = KitVehicle.spawn(game.physics, spawned, vehiclePreset(options.preset ?? "danfo", options.model));
+  }
+  let kit = vehicle, entity = kit.vehicle.entity, bodyId = game.physics.bodyId(entity), chaseOptions = chasePreset(kit.spec.name, options.chase), lens = cameraLens(game, options.camera, chaseOptions.fov ?? (62)), camera = new ChaseCamera(game.physics, game.transforms, lens.entity, { entity, bodyId }, { lens: lens.lens, ...chaseOptions }), steer = new Float64Array(1), buttons = [
+    { control: TOUCH_CONTROLS.gas, label: "Gas" },
+    { control: TOUCH_CONTROLS.brake, label: "Brake" },
+    { control: TOUCH_CONTROLS.handbrake, label: "Drift" },
+    { control: TOUCH_CONTROLS.horn, label: "Horn" }
+  ], controls = touchFor(game, { ...options, move: { axes: "x", ...options.move } }, "driving", buttons), drive = { throttle: 0, brake: 0, steer: 0, handbrake: 0 }, staged = new Float64Array(INPUT_STRIDE);
+  staged[INPUT_GEAR] = GEAR_AUTO;
+  let active = true, rig = {
+    game,
+    actions,
+    vehicle: kit,
+    camera,
+    controls,
+    drive,
+    entity,
+    cameraEntity: lens.entity,
+    get active() {
+      return active;
+    },
+    setActive(next) {
+      active = next, controls.setEnabled(next), next ? controls.attach() : controls.detach();
+    },
+    fixedUpdate(g) {
+      active && (input.valueInto(actions.steer, steer, 0), drive.steer = steer[0], drive.throttle = input.pressed(actions.gas) ? 1 : 0, drive.brake = input.pressed(actions.brake) ? 1 : 0, drive.handbrake = input.pressed(actions.handbrake) ? 1 : 0, staged[INPUT_THROTTLE] = drive.throttle, staged[INPUT_BRAKE] = drive.brake, staged[INPUT_STEER] = steer[0], staged[INPUT_HANDBRAKE] = drive.handbrake, kit.vehicle.driveFrom(staged, 0));
+    },
+    update(g) {
+      active && (camera.look(input.look), camera.lookRateFrom(input, actions.lookX, actions.lookY), camera.update(g.clock), controls.update(g.clock));
+    },
+    system: { fixedUpdate: (g) => rig.fixedUpdate(g), update: (g) => rig.update(g) },
+    dispose() {
+      active = false, controls.dispose();
+    }
+  };
+  return options.register !== false && game.addSystem(rig.system), rig;
+}
+
+export { ANIM_AIR, ANIM_CROUCH, ANIM_PELVIS_OFFSET, ANIM_SPEED, CHASE_DISTANCE, CHASE_FOV, CHASE_PITCH, CHASE_SPEED, CHASE_X, CHASE_Y, CHASE_YAW, CHASE_Z, CharacterAnimator, ChaseCamera, FirstPersonView, TOUCH_CONTROLS, VIEW_BOB_PHASE, VIEW_BOB_WEIGHT, VIEW_DIP, VIEW_FOV, VIEW_PITCH, VIEW_X, VIEW_Y, VIEW_YAW, VIEW_Z, chasePreset, defineDriveActions, definePlayActions, engineSurfaceOf, firstPerson, thirdPersonCharacter, vehicleDriver };