@inglorious/engine 0.1.0 → 0.2.0

package/src/engine/ai/movement/dynamic/match-velocity.js

@@ -1,50 +1,51 @@
-import {
-  angle,
-  clamp,
-  divide,
-  magnitude,
-  multiply,
-  zero,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-export const DEFAULT_TIME_TO_TARGET = 0.1
-
-const DEFAULT_MAX_ACCELERATION = 0
-const DEFAULT_MAX_SPEED = 0
-const DEFAULT_ORIENTATION = 0
-
-const MIN_ACCELERATION = 0
-const MIN_SPEED = 0
-
-const HALF_ACCELERATION = 0.5
-
-export default function matchVelocity(
-  instance,
-  target,
-  { dt, timeToTarget = DEFAULT_TIME_TO_TARGET },
-) {
-  const maxAcceleration = instance.maxAcceleration ?? DEFAULT_MAX_ACCELERATION
-  const maxSpeed = instance.maxSpeed ?? DEFAULT_MAX_SPEED
-
-  let orientation = instance.orientation ?? DEFAULT_ORIENTATION
-
-  let velocity = instance.velocity ?? zero()
-  const velocityDelta = subtract(target.velocity, velocity)
-
-  let acceleration = divide(velocityDelta, timeToTarget)
-  acceleration = clamp(acceleration, MIN_ACCELERATION, maxAcceleration)
-
-  velocity = sum(velocity, multiply(acceleration, dt))
-  velocity = clamp(velocity, MIN_SPEED, maxSpeed)
-
-  const position = sum(
-    instance.position,
-    multiply(velocity, dt),
-    multiply(acceleration, HALF_ACCELERATION * dt * dt),
-  )
-
-  orientation = magnitude(velocity) ? angle(velocity) : orientation
-
-  return { acceleration, velocity, position, orientation }
-}
+import {
+  angle,
+  clamp,
+  divide,
+  magnitude,
+  multiply,
+  zero,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+export const DEFAULT_TIME_TO_TARGET = 0.1
+
+const DEFAULT_MAX_ACCELERATION = 0
+const DEFAULT_MAX_SPEED = 0
+const DEFAULT_ORIENTATION = 0
+
+const MIN_ACCELERATION = 0
+const MIN_SPEED = 0
+
+const HALF_ACCELERATION = 0.5
+
+export function matchVelocity(
+  entity,
+  target,
+  dt,
+  { timeToTarget = DEFAULT_TIME_TO_TARGET } = {},
+) {
+  const maxAcceleration = entity.maxAcceleration ?? DEFAULT_MAX_ACCELERATION
+  const maxSpeed = entity.maxSpeed ?? DEFAULT_MAX_SPEED
+
+  let orientation = entity.orientation ?? DEFAULT_ORIENTATION
+
+  let velocity = entity.velocity ?? zero()
+  const velocityDelta = subtract(target.velocity, velocity)
+
+  let acceleration = divide(velocityDelta, timeToTarget)
+  acceleration = clamp(acceleration, MIN_ACCELERATION, maxAcceleration)
+
+  velocity = sum(velocity, multiply(acceleration, dt))
+  velocity = clamp(velocity, MIN_SPEED, maxSpeed)
+
+  const position = sum(
+    entity.position,
+    multiply(velocity, dt),
+    multiply(acceleration, HALF_ACCELERATION * dt * dt),
+  )
+
+  orientation = magnitude(velocity) ? angle(velocity) : orientation
+
+  return { acceleration, velocity, position, orientation }
+}

package/src/engine/ai/movement/dynamic/pursue.js

@@ -1,38 +1,38 @@
-import {
-  magnitude,
-  multiply,
-  zero,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-import seek from "./seek.js"
-
-export const DEFAULT_MAX_PREDICTION = 10
-
-export default function pursue(
-  instance,
-  target,
-  { dt, maxPrediction = DEFAULT_MAX_PREDICTION },
-) {
-  const velocity = instance.velocity ?? zero()
-
-  const direction = subtract(target.position, instance.position)
-  const distance = magnitude(direction)
-
-  if (!distance) {
-    return instance
-  }
-
-  const speed = magnitude(velocity)
-
-  let prediction
-  if (speed <= distance / maxPrediction) {
-    prediction = maxPrediction
-  } else {
-    prediction = distance / speed
-  }
-
-  const position = sum(target.position, multiply(target.velocity, prediction))
-
-  return seek(instance, { ...target, position }, { dt })
-}
+import { seek } from "@inglorious/engine/ai/movement/dynamic/seek.js"
+import {
+  magnitude,
+  multiply,
+  zero,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+export const DEFAULT_MAX_PREDICTION = 10
+
+export function pursue(
+  entity,
+  target,
+  dt,
+  { maxPrediction = DEFAULT_MAX_PREDICTION } = {},
+) {
+  const velocity = entity.velocity ?? zero()
+
+  const direction = subtract(target.position, entity.position)
+  const distance = magnitude(direction)
+
+  if (!distance) {
+    return entity
+  }
+
+  const speed = magnitude(velocity)
+
+  let prediction
+  if (speed <= distance / maxPrediction) {
+    prediction = maxPrediction
+  } else {
+    prediction = distance / speed
+  }
+
+  const position = sum(target.position, multiply(target.velocity, prediction))
+
+  return seek(entity, { ...target, position }, dt)
+}

package/src/engine/ai/movement/dynamic/seek.js

@@ -1,44 +1,44 @@
-import {
-  angle,
-  clamp,
-  magnitude,
-  multiply,
-  setMagnitude,
-  zero,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-const DEFAULT_MAX_ACCELERATION = 0
-const DEFAULT_MAX_SPEED = 0
-
-const MIN_SPEED = 0
-
-const HALF_ACCELERATION = 0.5
-
-export default function seek(instance, target, { dt }) {
-  const maxAcceleration = instance.maxAcceleration ?? DEFAULT_MAX_ACCELERATION
-  const maxSpeed = instance.maxSpeed ?? DEFAULT_MAX_SPEED
-
-  const direction = subtract(target.position, instance.position)
-  const distance = magnitude(direction)
-
-  if (!distance) {
-    return instance
-  }
-
-  const acceleration = setMagnitude(direction, maxAcceleration)
-
-  let velocity = instance.velocity ?? zero()
-  velocity = sum(velocity, multiply(acceleration, dt))
-  velocity = clamp(velocity, MIN_SPEED, maxSpeed)
-
-  const position = sum(
-    instance.position,
-    multiply(velocity, dt),
-    multiply(acceleration, HALF_ACCELERATION * dt * dt),
-  )
-
-  const orientation = angle(velocity)
-
-  return { velocity, position, orientation }
-}
+import {
+  angle,
+  clamp,
+  magnitude,
+  multiply,
+  setMagnitude,
+  zero,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+const DEFAULT_MAX_ACCELERATION = 0
+const DEFAULT_MAX_SPEED = 0
+
+const MIN_SPEED = 0
+
+const HALF_ACCELERATION = 0.5
+
+export function seek(entity, target, dt) {
+  const maxAcceleration = entity.maxAcceleration ?? DEFAULT_MAX_ACCELERATION
+  const maxSpeed = entity.maxSpeed ?? DEFAULT_MAX_SPEED
+
+  const direction = subtract(target.position, entity.position)
+  const distance = magnitude(direction)
+
+  if (!distance) {
+    return entity
+  }
+
+  const acceleration = setMagnitude(direction, maxAcceleration)
+
+  let velocity = entity.velocity ?? zero()
+  velocity = sum(velocity, multiply(acceleration, dt))
+  velocity = clamp(velocity, MIN_SPEED, maxSpeed)
+
+  const position = sum(
+    entity.position,
+    multiply(velocity, dt),
+    multiply(acceleration, HALF_ACCELERATION * dt * dt),
+  )
+
+  const orientation = angle(velocity)
+
+  return { velocity, position, orientation }
+}

package/src/engine/ai/movement/dynamic/wander.js

@@ -1,32 +1,31 @@
-import { createVector } from "@inglorious/utils/math/linear-algebra/vector.js"
-import { sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-import { randomBinomial } from "@inglorious/utils/math/rng.js"
-
-import seek from "./seek.js"
-
-export const DEFAULT_WANDER_OFFSET = 100
-export const DEFAULT_WANDER_RADIUS = 100
-
-const DEFAULT_MAX_ANGULAR_SPEED = 0
-
-const DEFAULT_ORIENTATION = 0
-
-export default function wander(
-  instance,
-  {
-    wanderOffset = DEFAULT_WANDER_OFFSET,
-    wanderRadius = DEFAULT_WANDER_RADIUS,
-    ...options
-  },
-) {
-  const maxAngularSpeed = instance.maxAngularSpeed ?? DEFAULT_MAX_ANGULAR_SPEED
-
-  let orientation = instance.orientation ?? DEFAULT_ORIENTATION
-
-  let position = sum(instance.position, createVector(wanderOffset, orientation))
-
-  orientation += randomBinomial() * maxAngularSpeed
-  position = sum(position, createVector(wanderRadius, orientation))
-
-  return seek(instance, { position }, options)
-}
+import { seek } from "@inglorious/engine/ai/movement/dynamic/seek.js"
+import { createVector } from "@inglorious/utils/math/linear-algebra/vector.js"
+import { sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+import { randomBinomial } from "@inglorious/utils/math/rng.js"
+
+export const DEFAULT_WANDER_OFFSET = 100
+export const DEFAULT_WANDER_RADIUS = 100
+
+const DEFAULT_MAX_ANGULAR_SPEED = 0
+
+const DEFAULT_ORIENTATION = 0
+
+export function wander(
+  entity,
+  dt,
+  {
+    wanderOffset = DEFAULT_WANDER_OFFSET,
+    wanderRadius = DEFAULT_WANDER_RADIUS,
+  } = {},
+) {
+  const maxAngularSpeed = entity.maxAngularSpeed ?? DEFAULT_MAX_ANGULAR_SPEED
+
+  let orientation = entity.orientation ?? DEFAULT_ORIENTATION
+
+  let position = sum(entity.position, createVector(wanderOffset, orientation))
+
+  orientation += randomBinomial() * maxAngularSpeed
+  position = sum(position, createVector(wanderRadius, orientation))
+
+  return seek(entity, { position }, dt)
+}

package/src/engine/ai/movement/kinematic/align.js

@@ -1,37 +1,37 @@
-import { abs, clamp } from "@inglorious/utils/math/numbers.js"
-import { toRange } from "@inglorious/utils/math/trigonometry.js"
-
-export const DEFAULT_TARGET_RADIUS = 0.1
-export const DEFAULT_TIME_TO_TARGET = 0.1
-
-const DEFAULT_MAX_ANGULAR_SPEED = 0
-
-const DEFAULT_ORIENTATION = 0
-
-export default function align(
-  instance,
-  target,
-  {
-    dt,
-    targetRadius = DEFAULT_TARGET_RADIUS,
-    timeToTarget = DEFAULT_TIME_TO_TARGET,
-  },
-) {
-  const maxAngularSpeed = instance.maxAngularSpeed ?? DEFAULT_MAX_ANGULAR_SPEED
-
-  let orientation = instance.orientation ?? DEFAULT_ORIENTATION
-
-  const direction = toRange(target.orientation - orientation)
-  const distance = abs(direction)
-
-  if (distance < targetRadius) {
-    return instance
-  }
-
-  let angularVelocity = direction / timeToTarget
-  angularVelocity = clamp(angularVelocity, -maxAngularSpeed, maxAngularSpeed)
-
-  orientation += angularVelocity * dt
-
-  return { orientation }
-}
+import { abs, clamp } from "@inglorious/utils/math/numbers.js"
+import { toRange } from "@inglorious/utils/math/trigonometry.js"
+
+export const DEFAULT_TARGET_RADIUS = 0.1
+export const DEFAULT_TIME_TO_TARGET = 0.1
+
+const DEFAULT_MAX_ANGULAR_SPEED = 0
+
+const DEFAULT_ORIENTATION = 0
+
+export function align(
+  entity,
+  target,
+  dt,
+  {
+    targetRadius = DEFAULT_TARGET_RADIUS,
+    timeToTarget = DEFAULT_TIME_TO_TARGET,
+  } = {},
+) {
+  const maxAngularSpeed = entity.maxAngularSpeed ?? DEFAULT_MAX_ANGULAR_SPEED
+
+  let orientation = entity.orientation ?? DEFAULT_ORIENTATION
+
+  const direction = toRange(target.orientation - orientation)
+  const distance = abs(direction)
+
+  if (distance < targetRadius) {
+    return entity
+  }
+
+  let angularVelocity = direction / timeToTarget
+  angularVelocity = clamp(angularVelocity, -maxAngularSpeed, maxAngularSpeed)
+
+  orientation += angularVelocity * dt
+
+  return { orientation }
+}

package/src/engine/ai/movement/kinematic/arrive.js

@@ -1,42 +1,42 @@
-import {
-  angle,
-  clamp,
-  divide,
-  magnitude,
-  multiply,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-export const DEFAULT_TARGET_RADIUS = 1
-export const DEFAULT_TIME_TO_TARGET = 0.1
-
-const DEFAULT_MAX_SPEED = 0
-
-const MIN_SPEED = 0
-
-export default function arrive(
-  instance,
-  target,
-  {
-    dt,
-    targetRadius = DEFAULT_TARGET_RADIUS,
-    timeToTarget = DEFAULT_TIME_TO_TARGET,
-  },
-) {
-  const maxSpeed = instance.maxSpeed ?? DEFAULT_MAX_SPEED
-
-  const direction = subtract(target.position, instance.position)
-  const distance = magnitude(direction)
-
-  if (distance < targetRadius) {
-    return instance
-  }
-
-  let velocity = divide(direction, timeToTarget)
-  velocity = clamp(velocity, MIN_SPEED, maxSpeed)
-
-  const position = sum(instance.position, multiply(velocity, dt))
-  const orientation = angle(velocity)
-
-  return { velocity, position, orientation }
-}
+import {
+  angle,
+  clamp,
+  divide,
+  magnitude,
+  multiply,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+export const DEFAULT_TARGET_RADIUS = 1
+export const DEFAULT_TIME_TO_TARGET = 0.1
+
+const DEFAULT_MAX_SPEED = 0
+
+const MIN_SPEED = 0
+
+export function arrive(
+  entity,
+  target,
+  dt,
+  {
+    targetRadius = DEFAULT_TARGET_RADIUS,
+    timeToTarget = DEFAULT_TIME_TO_TARGET,
+  } = {},
+) {
+  const maxSpeed = entity.maxSpeed ?? DEFAULT_MAX_SPEED
+
+  const direction = subtract(target.position, entity.position)
+  const distance = magnitude(direction)
+
+  if (distance < targetRadius) {
+    return entity
+  }
+
+  let velocity = divide(direction, timeToTarget)
+  velocity = clamp(velocity, MIN_SPEED, maxSpeed)
+
+  const position = sum(entity.position, multiply(velocity, dt))
+  const orientation = angle(velocity)
+
+  return { velocity, position, orientation }
+}

package/src/engine/ai/movement/kinematic/face.js

@@ -1,20 +1,19 @@
-import {
-  angle,
-  magnitude,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-import align from "./align.js"
-
-export default function face(instance, target, options) {
-  const direction = subtract(target.position, instance.position)
-  const distance = magnitude(direction)
-
-  if (!distance) {
-    return instance
-  }
-
-  const orientation = angle(direction)
-
-  return align(instance, { ...target, orientation }, options)
-}
+import { align } from "@inglorious/engine/ai/movement/kinematic/align.js"
+import {
+  angle,
+  magnitude,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+export function face(entity, target, dt, options) {
+  const direction = subtract(target.position, entity.position)
+  const distance = magnitude(direction)
+
+  if (!distance) {
+    return entity
+  }
+
+  const orientation = angle(direction)
+
+  return align(entity, { ...target, orientation }, dt, options)
+}

package/src/engine/ai/movement/kinematic/flee.js

@@ -1,26 +1,26 @@
-import {
-  angle,
-  magnitude,
-  multiply,
-  setMagnitude,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-const DEFAULT_MAX_SPEED = 0
-
-export default function flee(instance, target, { dt }) {
-  const maxSpeed = instance.maxSpeed ?? DEFAULT_MAX_SPEED
-
-  const direction = subtract(instance.position, target.position)
-  const distance = magnitude(direction)
-
-  if (!distance) {
-    return instance
-  }
-
-  const velocity = setMagnitude(direction, maxSpeed)
-  const position = sum(instance.position, multiply(velocity, dt))
-  const orientation = angle(velocity)
-
-  return { velocity, position, orientation }
-}
+import {
+  angle,
+  magnitude,
+  multiply,
+  setMagnitude,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+const DEFAULT_MAX_SPEED = 0
+
+export function flee(entity, target, dt) {
+  const maxSpeed = entity.maxSpeed ?? DEFAULT_MAX_SPEED
+
+  const direction = subtract(entity.position, target.position)
+  const distance = magnitude(direction)
+
+  if (!distance) {
+    return entity
+  }
+
+  const velocity = setMagnitude(direction, maxSpeed)
+  const position = sum(entity.position, multiply(velocity, dt))
+  const orientation = angle(velocity)
+
+  return { velocity, position, orientation }
+}

package/src/engine/ai/movement/kinematic/seek.js

@@ -1,26 +1,26 @@
-import {
-  angle,
-  magnitude,
-  multiply,
-  setMagnitude,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-const DEFAULT_MAX_SPEED = 0
-
-export default function seek(instance, target, { dt }) {
-  const maxSpeed = instance.maxSpeed ?? DEFAULT_MAX_SPEED
-
-  const direction = subtract(target.position, instance.position)
-  const distance = magnitude(direction)
-
-  if (!distance) {
-    return instance
-  }
-
-  const velocity = setMagnitude(direction, maxSpeed)
-  const position = sum(instance.position, multiply(velocity, dt))
-  const orientation = angle(velocity)
-
-  return { velocity, position, orientation }
-}
+import {
+  angle,
+  magnitude,
+  multiply,
+  setMagnitude,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { subtract, sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+const DEFAULT_MAX_SPEED = 0
+
+export function seek(entity, target, dt) {
+  const maxSpeed = entity.maxSpeed ?? DEFAULT_MAX_SPEED
+
+  const direction = subtract(target.position, entity.position)
+  const distance = magnitude(direction)
+
+  if (!distance) {
+    return entity
+  }
+
+  const velocity = setMagnitude(direction, maxSpeed)
+  const position = sum(entity.position, multiply(velocity, dt))
+  const orientation = angle(velocity)
+
+  return { velocity, position, orientation }
+}