@inglorious/engine 0.2.0 → 0.4.0

package/src/{engine/collision → collision}/detection.js

@@ -1,110 +1,110 @@
-import { filter } from "@inglorious/utils/data-structures/object.js"
-import * as circle from "@inglorious/utils/math/geometry/circle.js"
-import * as hitmask from "@inglorious/utils/math/geometry/hitmask.js"
-import * as line from "@inglorious/utils/math/geometry/line.js"
-import * as point from "@inglorious/utils/math/geometry/point.js"
-import * as rectangle from "@inglorious/utils/math/geometry/rectangle.js"
-import * as segment from "@inglorious/utils/math/geometry/segment.js"
-import { zero } from "@inglorious/utils/math/linear-algebra/vector.js"
-import { add } from "@inglorious/utils/math/linear-algebra/vectors.js"
-
-const Z = 2 // Z-axis index.
-
-const Shape = {
-  circle,
-  line,
-  point,
-  rectangle,
-  segment,
-  hitmask,
-}
-
-/**
- * Finds the first collision between a point and a list of entities.
- *
- * @param {Point} entity - The point to check for collisions.
- * @param {Options} options - Options for collision detection.
- * @returns {Entity | undefined} The first entity that collides with the point, or undefined if none are found.
- */
-export function findCollision(entity, entities, collisionGroup = "hitbox") {
-  const otherEntities = filter(
-    entities,
-    (id, { collisions }) => id !== entity.id && collisions?.[collisionGroup],
-  )
-
-  return Object.values(otherEntities)
-    .toSorted((a, b) => a.position[Z] - b.position[Z])
-    .find((target) => collidesWith(entity, target, collisionGroup))
-}
-
-export function collidesWith(entity, target, collisionGroup = "hitbox") {
-  const entityShape = getCollisionShape(entity, collisionGroup)
-  const targetShape = getCollisionShape(target, collisionGroup)
-
-  if (!entityShape || !targetShape) {
-    return false
-  }
-
-  return shapeCollidesWith(entityShape, targetShape)
-}
-
-function shapeCollidesWith(entity, target) {
-  const shapeFns = Shape[entity.shape]
-
-  switch (target.shape) {
-    case "circle":
-      return shapeFns.intersectsCircle(entity, target)
-
-    case "line":
-      return shapeFns.intersectsLine(entity, target)
-
-    case "point":
-      return shapeFns.intersectsPoint(entity, target)
-
-    case "rectangle":
-      return shapeFns.intersectsRectangle(entity, target)
-
-    case "segment":
-      return shapeFns.intersectsSegment(entity, target)
-  }
-}
-
-export function findCollisions(entity, target, collisionGroup = "hitbox") {
-  const entityShape = getCollisionShape(entity, collisionGroup)
-  const targetShape = getCollisionShape(target, collisionGroup)
-
-  if (!entityShape || !targetShape) {
-    return false
-  }
-
-  const shapeFns = Shape[entityShape.shape]
-  if (!shapeFns || !shapeFns.findCollisions) {
-    return false
-  }
-
-  return shapeFns.findCollisions(entityShape, targetShape)
-}
-
-/**
- * Correctly calculates the absolute position and size of an entity's
- * collision shape, including any offsets.
- */
-function getCollisionShape(entity, collisionGroup = "hitbox") {
-  const collision = entity.collisions[collisionGroup]
-  if (!collision) {
-    return null
-  }
-
-  const position = add(
-    entity.position,
-    collision.offset ?? zero(),
-    entity.offset ?? zero(),
-  )
-
-  return {
-    ...collision,
-    position,
-    size: collision.size ?? entity.size,
-    radius: collision.radius ?? entity.radius,
-  }
-}
+import { filter } from "@inglorious/utils/data-structures/object.js"
+import * as circle from "@inglorious/utils/math/geometry/circle.js"
+import * as hitmask from "@inglorious/utils/math/geometry/hitmask.js"
+import * as line from "@inglorious/utils/math/geometry/line.js"
+import * as point from "@inglorious/utils/math/geometry/point.js"
+import * as rectangle from "@inglorious/utils/math/geometry/rectangle.js"
+import * as segment from "@inglorious/utils/math/geometry/segment.js"
+import { zero } from "@inglorious/utils/math/linear-algebra/vector.js"
+import { add } from "@inglorious/utils/math/linear-algebra/vectors.js"
+
+const Z = 2 // Z-axis index.
+
+const Shape = {
+  circle,
+  line,
+  point,
+  rectangle,
+  segment,
+  hitmask,
+}
+
+/**
+ * Finds the first collision between a point and a list of entities.
+ *
+ * @param {Point} entity - The point to check for collisions.
+ * @param {Options} options - Options for collision detection.
+ * @returns {Entity | undefined} The first entity that collides with the point, or undefined if none are found.
+ */
+export function findCollision(entity, entities, collisionGroup = "hitbox") {
+  const otherEntities = filter(
+    entities,
+    (id, { collisions }) => id !== entity.id && collisions?.[collisionGroup],
+  )
+
+  return Object.values(otherEntities)
+    .toSorted((a, b) => a.position[Z] - b.position[Z])
+    .find((target) => collidesWith(entity, target, collisionGroup))
+}
+
+export function collidesWith(entity, target, collisionGroup = "hitbox") {
+  const entityShape = getCollisionShape(entity, collisionGroup)
+  const targetShape = getCollisionShape(target, collisionGroup)
+
+  if (!entityShape || !targetShape) {
+    return false
+  }
+
+  return shapeCollidesWith(entityShape, targetShape)
+}
+
+function shapeCollidesWith(entity, target) {
+  const shapeFns = Shape[entity.shape]
+
+  switch (target.shape) {
+    case "circle":
+      return shapeFns.intersectsCircle(entity, target)
+
+    case "line":
+      return shapeFns.intersectsLine(entity, target)
+
+    case "point":
+      return shapeFns.intersectsPoint(entity, target)
+
+    case "rectangle":
+      return shapeFns.intersectsRectangle(entity, target)
+
+    case "segment":
+      return shapeFns.intersectsSegment(entity, target)
+  }
+}
+
+export function findCollisions(entity, target, collisionGroup = "hitbox") {
+  const entityShape = getCollisionShape(entity, collisionGroup)
+  const targetShape = getCollisionShape(target, collisionGroup)
+
+  if (!entityShape || !targetShape) {
+    return false
+  }
+
+  const shapeFns = Shape[entityShape.shape]
+  if (!shapeFns || !shapeFns.findCollisions) {
+    return false
+  }
+
+  return shapeFns.findCollisions(entityShape, targetShape)
+}
+
+/**
+ * Correctly calculates the absolute position and size of an entity's
+ * collision shape, including any offsets.
+ */
+function getCollisionShape(entity, collisionGroup = "hitbox") {
+  const collision = entity.collisions[collisionGroup]
+  if (!collision) {
+    return null
+  }
+
+  const position = add(
+    entity.position,
+    collision.offset ?? zero(),
+    entity.offset ?? zero(),
+  )
+
+  return {
+    ...collision,
+    position,
+    size: collision.size ?? entity.size,
+    radius: collision.radius ?? entity.radius,
+  }
+}

package/src/{engine/core → core}/dev-tools.js

@@ -1,135 +1,135 @@
-export const ACTION_BLACKLIST = [
-  "update",
-  "gamepadAxis",
-  "gamepadPress",
-  "gamepadRelease",
-  "keyboardKeyDown",
-  "keyboardKeyUp",
-  "inputAxis",
-  "inputPress",
-  "inputRelease",
-  "mouseMove",
-  "mouseClick",
-  "spriteAnimationEnd",
-]
-
-const LAST_STATE = 1
-
-let devToolsInstance = null
-let unsubscribe = null
-
-export function initDevTools(store) {
-  // Prevent multiple connections
-  if (devToolsInstance) {
-    return
-  }
-
-  if (typeof window === "undefined" || !window.__REDUX_DEVTOOLS_EXTENSION__) {
-    return
-  }
-
-  devToolsInstance = window.__REDUX_DEVTOOLS_EXTENSION__.connect({
-    name: "Inglorious Engine",
-    predicate: (state, action) => !ACTION_BLACKLIST.includes(action.type),
-    actionCreators: {
-      jump: () => ({ type: "jump", payload: { inputId: "input0" } }),
-    },
-    // @see https://github.com/reduxjs/redux-devtools/blob/main/extension/docs/API/Arguments.md#features
-    features: {
-      pause: true, // start/pause recording of dispatched actions
-      lock: true, // lock/unlock dispatching actions and side effects
-      persist: true, // persist states on page reloading
-      export: true, // export history of actions in a file
-      import: "custom", // import history of actions from a file
-      jump: false, // jump back and forth (time travelling)
-      skip: false, // skip (cancel) actions
-      reorder: false, // drag and drop actions in the history list
-      dispatch: true, // dispatch custom actions or action creators
-      test: false, // generate tests for the selected actions
-    },
-  })
-
-  unsubscribe = devToolsInstance.subscribe((message) => {
-    switch (message.type) {
-      case "DISPATCH":
-        handleDispatch(message, store)
-        break
-
-      case "ACTION":
-        handleAction(message, store)
-        break
-    }
-  })
-
-  devToolsInstance.init(store.getState())
-}
-
-export function disconnectDevTools() {
-  // The `disconnect` method on the devToolsInstance is not available in all
-  // environments or versions of the extension.
-  // The safest way to "disconnect" is to unsubscribe from any listeners
-  // and release our reference to the instance, which prevents any further
-  // actions from being sent.
-  if (unsubscribe) {
-    unsubscribe()
-    unsubscribe = null
-    devToolsInstance = null
-  }
-}
-
-export function sendAction(action, state) {
-  if (devToolsInstance) {
-    devToolsInstance.send(action, state)
-  }
-}
-
-function handleDispatch(message, store) {
-  switch (message.payload.type) {
-    // reset button
-    case "RESET": {
-      store.reset()
-      devToolsInstance.init(store.getState())
-      break
-    }
-
-    // revert button
-    case "ROLLBACK": {
-      const newState = JSON.parse(message.state)
-      store.setState(newState)
-      break
-    }
-
-    // commit button
-    case "COMMIT": {
-      devToolsInstance.init(store.getState())
-      break
-    }
-
-    // import from file button
-    case "IMPORT_STATE": {
-      const { computedStates, actionsById } = message.payload.nextLiftedState
-
-      const [firstComputedState] = computedStates
-      const lastComputedState =
-        computedStates[computedStates.length - LAST_STATE]
-      if (lastComputedState) {
-        store.setState(lastComputedState.state)
-      }
-
-      const flattenedActions = Object.values(actionsById)
-        .flatMap(({ action }) => action.payload ?? action)
-        .map((action, index) => [index, action])
-
-      devToolsInstance.init(
-        firstComputedState.state,
-        Object.fromEntries(flattenedActions),
-      )
-      break
-    }
-  }
-}
-
-function handleAction(message, store) {
-  const action = JSON.parse(message.payload)
-  store.dispatch(action)
-}
+export const ACTION_BLACKLIST = [
+  "update",
+  "gamepadAxis",
+  "gamepadPress",
+  "gamepadRelease",
+  "keyboardKeyDown",
+  "keyboardKeyUp",
+  "inputAxis",
+  "inputPress",
+  "inputRelease",
+  "mouseMove",
+  "mouseClick",
+  "spriteAnimationEnd",
+]
+
+const LAST_STATE = 1
+
+let devToolsInstance = null
+let unsubscribe = null
+
+export function initDevTools(store) {
+  // Prevent multiple connections
+  if (devToolsInstance) {
+    return
+  }
+
+  if (typeof window === "undefined" || !window.__REDUX_DEVTOOLS_EXTENSION__) {
+    return
+  }
+
+  devToolsInstance = window.__REDUX_DEVTOOLS_EXTENSION__.connect({
+    name: "Inglorious Engine",
+    predicate: (state, action) => !ACTION_BLACKLIST.includes(action.type),
+    actionCreators: {
+      jump: () => ({ type: "jump", payload: { inputId: "input0" } }),
+    },
+    // @see https://github.com/reduxjs/redux-devtools/blob/main/extension/docs/API/Arguments.md#features
+    features: {
+      pause: true, // start/pause recording of dispatched actions
+      lock: true, // lock/unlock dispatching actions and side effects
+      persist: true, // persist states on page reloading
+      export: true, // export history of actions in a file
+      import: "custom", // import history of actions from a file
+      jump: false, // jump back and forth (time travelling)
+      skip: false, // skip (cancel) actions
+      reorder: false, // drag and drop actions in the history list
+      dispatch: true, // dispatch custom actions or action creators
+      test: false, // generate tests for the selected actions
+    },
+  })
+
+  unsubscribe = devToolsInstance.subscribe((message) => {
+    switch (message.type) {
+      case "DISPATCH":
+        handleDispatch(message, store)
+        break
+
+      case "ACTION":
+        handleAction(message, store)
+        break
+    }
+  })
+
+  devToolsInstance.init(store.getState())
+}
+
+export function disconnectDevTools() {
+  // The `disconnect` method on the devToolsInstance is not available in all
+  // environments or versions of the extension.
+  // The safest way to "disconnect" is to unsubscribe from any listeners
+  // and release our reference to the instance, which prevents any further
+  // actions from being sent.
+  if (unsubscribe) {
+    unsubscribe()
+    unsubscribe = null
+    devToolsInstance = null
+  }
+}
+
+export function sendAction(action, state) {
+  if (devToolsInstance) {
+    devToolsInstance.send(action, state)
+  }
+}
+
+function handleDispatch(message, store) {
+  switch (message.payload.type) {
+    // reset button
+    case "RESET": {
+      store.reset()
+      devToolsInstance.init(store.getState())
+      break
+    }
+
+    // revert button
+    case "ROLLBACK": {
+      const newState = JSON.parse(message.state)
+      store.setState(newState)
+      break
+    }
+
+    // commit button
+    case "COMMIT": {
+      devToolsInstance.init(store.getState())
+      break
+    }
+
+    // import from file button
+    case "IMPORT_STATE": {
+      const { computedStates, actionsById } = message.payload.nextLiftedState
+
+      const [firstComputedState] = computedStates
+      const lastComputedState =
+        computedStates[computedStates.length - LAST_STATE]
+      if (lastComputedState) {
+        store.setState(lastComputedState.state)
+      }
+
+      const flattenedActions = Object.values(actionsById)
+        .flatMap(({ action }) => action.payload ?? action)
+        .map((action, index) => [index, action])
+
+      devToolsInstance.init(
+        firstComputedState.state,
+        Object.fromEntries(flattenedActions),
+      )
+      break
+    }
+  }
+}
+
+function handleAction(message, store) {
+  const action = JSON.parse(message.payload)
+  store.dispatch(action)
+}