@inglorious/engine 0.2.0 → 0.4.0

package/src/{engine/behaviors → behaviors}/input/mouse.js

@@ -1,91 +1,91 @@
-import { findCollision } from "@inglorious/engine/collision/detection.js"
-import { clampToBounds } from "@inglorious/engine/physics/bounds.js"
-import { zero } from "@inglorious/utils/math/linear-algebra/vector.js"
-
-const DEFAULT_PARAMS = {
-  name: "mouse",
-}
-
-const NO_Y = 0
-
-export function mouse() {
-  return {
-    start(entity) {
-      entity.collisions ??= {}
-      entity.collisions.bounds ??= { shape: "point" }
-    },
-
-    mouseMove(entity, position, api) {
-      const game = api.getEntity("game")
-
-      entity.position = position
-
-      clampToBounds(entity, game.bounds)
-    },
-
-    mouseClick(entity, position, api) {
-      const entities = api.getEntities()
-      const clickedEntity = findCollision(entity, entities)
-      if (clickedEntity) {
-        api.notify("entityClick", clickedEntity.id)
-      } else {
-        api.notify("sceneClick", position)
-      }
-    },
-  }
-}
-
-export function track(parent, options) {
-  const handleMouseMove = createHandler("mouseMove", parent, options)
-  const handleClick = createHandler("mouseClick", parent, options)
-  const handleWheel = createHandler("mouseWheel", parent, options)
-
-  return {
-    onMouseMove: handleMouseMove,
-    onClick: handleClick,
-    onWheel: handleWheel,
-  }
-}
-
-export function createMouse(name = DEFAULT_PARAMS.name, overrides = {}) {
-  return {
-    id: name,
-    type: "mouse",
-    layer: 999, // A high layer value to ensure it's always rendered on top
-    position: zero(),
-    ...overrides,
-  }
-}
-
-function createHandler(type, parent, api) {
-  return (event) => {
-    event.stopPropagation()
-
-    if (parent == null) {
-      return
-    }
-
-    // For wheel events, the payload is different from other mouse events.
-    if (type === "mouseWheel") {
-      api.notify(type, { deltaY: event.deltaY })
-      return
-    }
-
-    // For move and click events, the payload is the calculated position.
-    const payload = calculatePosition({
-      clientX: event.clientX,
-      clientY: event.clientY,
-      parent,
-    })
-    api.notify(type, payload)
-  }
-}
-
-function calculatePosition({ clientX, clientY, parent }) {
-  const bounds = parent.getBoundingClientRect()
-
-  const x = clientX - bounds.left
-  const z = bounds.bottom - clientY
-
-  return [x, NO_Y, z]
-}
+import { findCollision } from "@inglorious/engine/collision/detection.js"
+import { clampToBounds } from "@inglorious/engine/physics/bounds.js"
+import { zero } from "@inglorious/utils/math/linear-algebra/vector.js"
+
+const DEFAULT_PARAMS = {
+  name: "mouse",
+}
+
+const NO_Y = 0
+
+export function mouse() {
+  return {
+    start(entity) {
+      entity.collisions ??= {}
+      entity.collisions.bounds ??= { shape: "point" }
+    },
+
+    mouseMove(entity, position, api) {
+      const game = api.getEntity("game")
+
+      entity.position = position
+
+      clampToBounds(entity, game.bounds)
+    },
+
+    mouseClick(entity, position, api) {
+      const entities = api.getEntities()
+      const clickedEntity = findCollision(entity, entities)
+      if (clickedEntity) {
+        api.notify("entityClick", clickedEntity.id)
+      } else {
+        api.notify("sceneClick", position)
+      }
+    },
+  }
+}
+
+export function track(parent, options) {
+  const handleMouseMove = createHandler("mouseMove", parent, options)
+  const handleClick = createHandler("mouseClick", parent, options)
+  const handleWheel = createHandler("mouseWheel", parent, options)
+
+  return {
+    onMouseMove: handleMouseMove,
+    onClick: handleClick,
+    onWheel: handleWheel,
+  }
+}
+
+export function createMouse(name = DEFAULT_PARAMS.name, overrides = {}) {
+  return {
+    id: name,
+    type: "mouse",
+    layer: 999, // A high layer value to ensure it's always rendered on top
+    position: zero(),
+    ...overrides,
+  }
+}
+
+function createHandler(type, parent, api) {
+  return (event) => {
+    event.stopPropagation()
+
+    if (parent == null) {
+      return
+    }
+
+    // For wheel events, the payload is different from other mouse events.
+    if (type === "mouseWheel") {
+      api.notify(type, { deltaY: event.deltaY })
+      return
+    }
+
+    // For move and click events, the payload is the calculated position.
+    const payload = calculatePosition({
+      clientX: event.clientX,
+      clientY: event.clientY,
+      parent,
+    })
+    api.notify(type, payload)
+  }
+}
+
+function calculatePosition({ clientX, clientY, parent }) {
+  const bounds = parent.getBoundingClientRect()
+
+  const x = clientX - bounds.left
+  const z = bounds.bottom - clientY
+
+  return [x, NO_Y, z]
+}

package/src/{engine/behaviors → behaviors}/physics/bouncy.js

@@ -1,25 +1,25 @@
-import { defaults, extend } from "@inglorious/utils/data-structures/objects.js"
-import { jump } from "@inglorious/utils/physics/jump.js"
-
-const DEFAULT_PARAMS = {
-  bounciness: 1,
-}
-
-export function bouncy(params) {
-  params = extend(DEFAULT_PARAMS, params)
-
-  return (type) =>
-    extend(type, {
-      start(entity) {
-        type.start?.(entity)
-        defaults(entity, params)
-      },
-
-      landed(entity, { entityId }) {
-        if (entity.id === entityId) {
-          entity.vy = jump(entity) * entity.bounciness
-          entity.groundObject = undefined
-        }
-      },
-    })
-}
+import { defaults, extend } from "@inglorious/utils/data-structures/objects.js"
+import { jump } from "@inglorious/utils/physics/jump.js"
+
+const DEFAULT_PARAMS = {
+  bounciness: 1,
+}
+
+export function bouncy(params) {
+  params = extend(DEFAULT_PARAMS, params)
+
+  return (type) =>
+    extend(type, {
+      start(entity) {
+        type.start?.(entity)
+        defaults(entity, params)
+      },
+
+      landed(entity, { entityId }) {
+        if (entity.id === entityId) {
+          entity.vy = jump(entity) * entity.bounciness
+          entity.groundObject = undefined
+        }
+      },
+    })
+}

package/src/{engine/behaviors → behaviors}/physics/clamped.js

@@ -1,36 +1,36 @@
-import { clampToBounds } from "@inglorious/engine/physics/bounds.js"
-import { extend, merge } from "@inglorious/utils/data-structures/objects.js"
-
-const DEFAULT_PARAMS = {
-  collisionGroup: "bounds",
-  depthAxis: "y",
-}
-
-export function clamped(params) {
-  params = extend(DEFAULT_PARAMS, params)
-
-  return (type) =>
-    extend(type, {
-      start(entity, api) {
-        type.start?.(entity, api)
-
-        entity.collisions ??= {}
-        entity.collisions[params.collisionGroup] ??= {}
-        entity.collisions[params.collisionGroup].shape ??= "rectangle"
-      },
-
-      update(entity, dt, api) {
-        type.update?.(entity, dt, api)
-
-        const game = api.getEntity("game")
-        merge(entity, {
-          position: clampToBounds(
-            entity,
-            game.bounds,
-            params.collisionGroup,
-            params.depthAxis,
-          ),
-        })
-      },
-    })
-}
+import { clampToBounds } from "@inglorious/engine/physics/bounds.js"
+import { extend, merge } from "@inglorious/utils/data-structures/objects.js"
+
+const DEFAULT_PARAMS = {
+  collisionGroup: "bounds",
+  depthAxis: "y",
+}
+
+export function clamped(params) {
+  params = extend(DEFAULT_PARAMS, params)
+
+  return (type) =>
+    extend(type, {
+      start(entity, api) {
+        type.start?.(entity, api)
+
+        entity.collisions ??= {}
+        entity.collisions[params.collisionGroup] ??= {}
+        entity.collisions[params.collisionGroup].shape ??= "rectangle"
+      },
+
+      update(entity, dt, api) {
+        type.update?.(entity, dt, api)
+
+        const game = api.getEntity("game")
+        merge(entity, {
+          position: clampToBounds(
+            entity,
+            game.bounds,
+            params.collisionGroup,
+            params.depthAxis,
+          ),
+        })
+      },
+    })
+}

package/src/{engine/behaviors → behaviors}/physics/collidable.js

@@ -1,20 +1,20 @@
-import { extend } from "@inglorious/utils/data-structures/objects.js"
-
-const DEFAULT_PARAMS = {
-  onState: "default",
-}
-
-export function collidable(params) {
-  params = extend(DEFAULT_PARAMS, params)
-
-  return (type) =>
-    extend(type, {
-      states: {
-        [params.onState]: {
-          update(entity, dt, api) {
-            type.states?.[params.onState].update?.(entity, dt, api)
-          },
-        },
-      },
-    })
-}
+import { extend } from "@inglorious/utils/data-structures/objects.js"
+
+const DEFAULT_PARAMS = {
+  onState: "default",
+}
+
+export function collidable(params) {
+  params = extend(DEFAULT_PARAMS, params)
+
+  return (type) =>
+    extend(type, {
+      states: {
+        [params.onState]: {
+          update(entity, dt, api) {
+            type.states?.[params.onState].update?.(entity, dt, api)
+          },
+        },
+      },
+    })
+}

package/src/{engine/behaviors → behaviors}/physics/jumpable.js

@@ -1,145 +1,145 @@
-import { findCollision } from "@inglorious/engine/collision/detection.js"
-import { defaults, extend } from "@inglorious/utils/data-structures/objects.js"
-import {
-  angle,
-  magnitude,
-  zero,
-} from "@inglorious/utils/math/linear-algebra/vector.js"
-import { applyGravity } from "@inglorious/utils/physics/gravity.js"
-import { jump } from "@inglorious/utils/physics/jump.js"
-
-const DEFAULT_PARAMS = {
-  maxSpeed: 250,
-  maxJump: 100,
-  maxLeap: 100,
-  maxJumps: 1,
-}
-
-const DOUBLE = 2
-const HALF = 2
-const X = 0
-const Y = 1
-const NO_VELOCITY = 0
-const NO_PENETRAION = 0
-
-export function jumpable(params) {
-  params = extend(DEFAULT_PARAMS, params)
-
-  return (type) =>
-    extend(type, {
-      start(entity, api) {
-        type.start?.(entity, api)
-        defaults(entity, params)
-        entity.jumpsLeft ??= entity.maxJumps
-
-        entity.velocity ??= zero()
-        entity.vy ??= 0
-      },
-
-      jump(entity, { entityId }) {
-        if (entityId === entity.id && entity.jumpsLeft) {
-          entity.vy = jump(entity)
-          entity.groundObject = undefined
-          entity.jumpsLeft--
-        }
-      },
-
-      update(entity, dt, api) {
-        type.update?.(entity, dt, api)
-
-        const entities = api.getEntities()
-
-        entity.collisions ??= {}
-        entity.collisions.platform ??= {}
-        entity.collisions.platform.shape ??= "rectangle"
-
-        let width, height
-        if (entity.collisions.platform.shape === "circle") {
-          width = entity.collisions.platform.radius * DOUBLE
-          height = entity.collisions.platform.radius * DOUBLE
-        } else {
-          ;[width, height] = entity.size
-        }
-        const [prevX, prevY] = [...entity.position]
-
-        // 1. HORIZONTAL MOVEMENT & RESOLUTION
-        entity.position[X] += entity.velocity[X] * dt
-        const entityLeft = entity.position[X] - width / HALF
-        const entityRight = entity.position[X] + width / HALF
-
-        const collisionX = findCollision(entity, entities, "platform")
-        if (collisionX) {
-          const vx = entity.velocity[X]
-
-          // Check if moving right and crossing the platform's left edge
-          const prevRight = prevX + width / HALF
-          const platformLeft =
-            collisionX.position[X] - collisionX.size[X] / HALF
-          if (vx > NO_VELOCITY && prevRight <= platformLeft) {
-            const penetration = entityRight - platformLeft
-            if (penetration > NO_PENETRAION) entity.position[X] -= penetration
-            entity.velocity[X] = 0
-          }
-
-          // Check if moving left and crossing the platform's right edge
-          const prevLeft = prevX - width / HALF
-          const platformRight =
-            collisionX.position[X] + collisionX.size[X] / HALF
-          if (vx < NO_VELOCITY && prevLeft >= platformRight) {
-            const penetration = platformRight - entityLeft
-            if (penetration > NO_PENETRAION) entity.position[X] += penetration
-            entity.velocity[X] = 0
-          }
-        }
-
-        // 2. VERTICAL MOVEMENT & RESOLUTION
-        const wasOnGround = entity.groundObject
-        entity.groundObject = undefined
-
-        const { vy, position: nextGravityPosition } = applyGravity(entity, dt)
-        entity.vy = vy
-        entity.position[Y] = nextGravityPosition[Y]
-
-        const collisionY = findCollision(entity, entities, "platform")
-        if (collisionY) {
-          const prevBottom = prevY - height / HALF
-          const platformTop = collisionY.position[Y] + collisionY.size[Y] / HALF
-
-          // Landing on top of a platform (one-way platform logic)
-          if (entity.vy <= NO_VELOCITY && prevBottom >= platformTop) {
-            const entityBottom = entity.position[Y] - height / HALF
-            const penetration = platformTop - entityBottom
-            if (penetration > NO_PENETRAION) entity.position[Y] += penetration
-            entity.vy = 0
-            entity.groundObject = collisionY
-            entity.jumpsLeft = entity.maxJumps
-
-            // Only notify on the frame we actually land, not every frame we're on the ground.
-            if (!wasOnGround) {
-              api.notify("landed", {
-                entityId: entity.id,
-                targetId: collisionY.id,
-              })
-            }
-          }
-
-          // Hitting head on bottom of a platform
-          // else if (entity.vy > 0) {
-          //   const prevTop = prevY + height / HALF
-          //   const platformBottom =
-          //     collisionY.position[Y] - collisionY.size[Y] / HALF
-          //   if (prevTop <= platformBottom) {
-          //     const entityTop = entity.position[Y] + height / HALF
-          //     const penetration = entityTop - platformBottom
-          //     if (penetration > 0) entity.position[Y] -= penetration
-          //     entity.vy = 0
-          //   }
-          // }
-        }
-
-        entity.orientation = magnitude(entity.velocity)
-          ? angle(entity.velocity)
-          : entity.orientation
-      },
-    })
-}
+import { findCollision } from "@inglorious/engine/collision/detection.js"
+import { defaults, extend } from "@inglorious/utils/data-structures/objects.js"
+import {
+  angle,
+  magnitude,
+  zero,
+} from "@inglorious/utils/math/linear-algebra/vector.js"
+import { applyGravity } from "@inglorious/utils/physics/gravity.js"
+import { jump } from "@inglorious/utils/physics/jump.js"
+
+const DEFAULT_PARAMS = {
+  maxSpeed: 250,
+  maxJump: 100,
+  maxLeap: 100,
+  maxJumps: 1,
+}
+
+const DOUBLE = 2
+const HALF = 2
+const X = 0
+const Y = 1
+const NO_VELOCITY = 0
+const NO_PENETRAION = 0
+
+export function jumpable(params) {
+  params = extend(DEFAULT_PARAMS, params)
+
+  return (type) =>
+    extend(type, {
+      start(entity, api) {
+        type.start?.(entity, api)
+        defaults(entity, params)
+        entity.jumpsLeft ??= entity.maxJumps
+
+        entity.velocity ??= zero()
+        entity.vy ??= 0
+      },
+
+      jump(entity, { entityId }) {
+        if (entityId === entity.id && entity.jumpsLeft) {
+          entity.vy = jump(entity)
+          entity.groundObject = undefined
+          entity.jumpsLeft--
+        }
+      },
+
+      update(entity, dt, api) {
+        type.update?.(entity, dt, api)
+
+        const entities = api.getEntities()
+
+        entity.collisions ??= {}
+        entity.collisions.platform ??= {}
+        entity.collisions.platform.shape ??= "rectangle"
+
+        let width, height
+        if (entity.collisions.platform.shape === "circle") {
+          width = entity.collisions.platform.radius * DOUBLE
+          height = entity.collisions.platform.radius * DOUBLE
+        } else {
+          ;[width, height] = entity.size
+        }
+        const [prevX, prevY] = [...entity.position]
+
+        // 1. HORIZONTAL MOVEMENT & RESOLUTION
+        entity.position[X] += entity.velocity[X] * dt
+        const entityLeft = entity.position[X] - width / HALF
+        const entityRight = entity.position[X] + width / HALF
+
+        const collisionX = findCollision(entity, entities, "platform")
+        if (collisionX) {
+          const vx = entity.velocity[X]
+
+          // Check if moving right and crossing the platform's left edge
+          const prevRight = prevX + width / HALF
+          const platformLeft =
+            collisionX.position[X] - collisionX.size[X] / HALF
+          if (vx > NO_VELOCITY && prevRight <= platformLeft) {
+            const penetration = entityRight - platformLeft
+            if (penetration > NO_PENETRAION) entity.position[X] -= penetration
+            entity.velocity[X] = 0
+          }
+
+          // Check if moving left and crossing the platform's right edge
+          const prevLeft = prevX - width / HALF
+          const platformRight =
+            collisionX.position[X] + collisionX.size[X] / HALF
+          if (vx < NO_VELOCITY && prevLeft >= platformRight) {
+            const penetration = platformRight - entityLeft
+            if (penetration > NO_PENETRAION) entity.position[X] += penetration
+            entity.velocity[X] = 0
+          }
+        }
+
+        // 2. VERTICAL MOVEMENT & RESOLUTION
+        const wasOnGround = entity.groundObject
+        entity.groundObject = undefined
+
+        const { vy, position: nextGravityPosition } = applyGravity(entity, dt)
+        entity.vy = vy
+        entity.position[Y] = nextGravityPosition[Y]
+
+        const collisionY = findCollision(entity, entities, "platform")
+        if (collisionY) {
+          const prevBottom = prevY - height / HALF
+          const platformTop = collisionY.position[Y] + collisionY.size[Y] / HALF
+
+          // Landing on top of a platform (one-way platform logic)
+          if (entity.vy <= NO_VELOCITY && prevBottom >= platformTop) {
+            const entityBottom = entity.position[Y] - height / HALF
+            const penetration = platformTop - entityBottom
+            if (penetration > NO_PENETRAION) entity.position[Y] += penetration
+            entity.vy = 0
+            entity.groundObject = collisionY
+            entity.jumpsLeft = entity.maxJumps
+
+            // Only notify on the frame we actually land, not every frame we're on the ground.
+            if (!wasOnGround) {
+              api.notify("landed", {
+                entityId: entity.id,
+                targetId: collisionY.id,
+              })
+            }
+          }
+
+          // Hitting head on bottom of a platform
+          // else if (entity.vy > 0) {
+          //   const prevTop = prevY + height / HALF
+          //   const platformBottom =
+          //     collisionY.position[Y] - collisionY.size[Y] / HALF
+          //   if (prevTop <= platformBottom) {
+          //     const entityTop = entity.position[Y] + height / HALF
+          //     const penetration = entityTop - platformBottom
+          //     if (penetration > 0) entity.position[Y] -= penetration
+          //     entity.vy = 0
+          //   }
+          // }
+        }
+
+        entity.orientation = magnitude(entity.velocity)
+          ? angle(entity.velocity)
+          : entity.orientation
+      },
+    })
+}

package/src/{engine/behaviors → behaviors}/ui/button.js

@@ -1,17 +1,17 @@
-export function button() {
-  return {
-    states: {
-      default: {
-        entityClick(entity) {
-          entity.state = "pressed"
-        },
-      },
-
-      pressed: {
-        entityRelease(entity) {
-          entity.state = "default"
-        },
-      },
-    },
-  }
-}
+export function button() {
+  return {
+    states: {
+      default: {
+        entityClick(entity) {
+          entity.state = "pressed"
+        },
+      },
+
+      pressed: {
+        entityRelease(entity) {
+          entity.state = "default"
+        },
+      },
+    },
+  }
+}