@inglorious/engine 0.1.0 → 0.2.0

package/src/docs/player/dynamic/shooter-controls.js

@@ -1,51 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds.js"
-import { enableShooterControls } from "@inglorious/game/decorators/controls/dynamic/shooter.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
-import { pi } from "@inglorious/utils/math/trigonometry.js"
-
-export default {
-  types: {
-    mouse: [enableMouse()],
-
-    ...enableControls(),
-
-    character: [
-      enableCharacter(),
-      enableShooterControls(),
-      enableClampToBounds(),
-    ],
-  },
-
-  instances: {
-    mouse: {
-      type: "mouse",
-      position: [400, 0, 300],
-    },
-
-    ...createControls("input0", {
-      ArrowUp: "up",
-      ArrowDown: "down",
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      KeyW: "up",
-      KeyS: "down",
-      KeyA: "left",
-      KeyD: "right",
-    }),
-
-    character: {
-      type: "character",
-      maxAngularAcceleration: 1000,
-      maxAngularSpeed: 2 * pi(),
-      maxAcceleration: 500,
-      maxSpeed: 250,
-      friction: 250,
-      position: [400, 0, 300],
-    },
-  },
-}

package/src/docs/player/dynamic/tank-controls.js

@@ -1,44 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds.js"
-import { enableTankControls } from "@inglorious/game/decorators/controls/dynamic/tank.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-
-export default {
-  types: {
-    ...enableControls(),
-
-    character: [enableCharacter(), enableTankControls(), enableClampToBounds()],
-  },
-
-  instances: {
-    ...createControls("input0", {
-      ArrowUp: "up",
-      ArrowDown: "down",
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      KeyW: "up",
-      KeyS: "down",
-      KeyA: "left",
-      KeyD: "right",
-      Btn12: "up",
-      Btn13: "down",
-      Btn14: "left",
-      Btn15: "right",
-      Axis0: "strafe",
-      Axis1: "upDown",
-      Axis2: "leftRight",
-    }),
-
-    character: {
-      type: "character",
-      maxAngularSpeed: 10,
-      maxAcceleration: 500,
-      maxSpeed: 250,
-      friction: 250,
-      position: [400, 0, 300],
-    },
-  },
-}

package/src/docs/player/kinematic/double-jump.js

@@ -1,90 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds.js"
-import { enableModernControls } from "@inglorious/game/decorators/controls/kinematic/modern.js"
-import { enableDoubleJump } from "@inglorious/game/decorators/double-jump.js"
-import { enableFsm } from "@inglorious/game/decorators/fsm.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-import { enableJump } from "@inglorious/game/decorators/jump.js"
-
-const Y = 1
-
-export default {
-  types: {
-    ...enableControls(),
-
-    stats: {},
-
-    character: [
-      enableCharacter(),
-      enableModernControls(),
-      enableClampToBounds(),
-      enableDoubleJump(),
-      enableJump(),
-      enableFsm({
-        default: {
-          "game:update"(instance) {
-            stopFreeFalling(instance)
-          },
-        },
-
-        jumping: {
-          "game:update"(instance) {
-            stopFreeFalling(instance)
-          },
-        },
-
-        doubleJumping: {
-          "game:update"(instance) {
-            stopFreeFalling(instance)
-          },
-        },
-      }),
-    ],
-  },
-
-  instances: {
-    ...createControls("input0", {
-      ArrowUp: "up",
-      ArrowDown: "down",
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      Space: "jump",
-      KeyW: "up",
-      KeyS: "down",
-      KeyA: "left",
-      KeyD: "right",
-      Btn12: "up",
-      Btn13: "down",
-      Btn14: "left",
-      Btn15: "right",
-      Btn0: "jump",
-      Axis0: "leftRight",
-      Axis1: "upDown",
-    }),
-
-    stats: {
-      type: "stats",
-      position: [600, 0, 600],
-      target: "character",
-    },
-
-    character: {
-      type: "character",
-      maxSpeed: 250,
-      position: [400, 0, 300],
-      maxJump: 100,
-      maxLeap: 100,
-    },
-  },
-}
-
-function stopFreeFalling(instance) {
-  if (instance.position[Y] <= 0) {
-    instance.vy = 0
-    instance.position[Y] = 0
-    instance.state = "default"
-  }
-}

package/src/docs/player/kinematic/jump.js

@@ -1,82 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds.js"
-import { enableModernControls } from "@inglorious/game/decorators/controls/kinematic/modern.js"
-import { enableFsm } from "@inglorious/game/decorators/fsm.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-import { enableJump } from "@inglorious/game/decorators/jump.js"
-
-const Y = 1
-
-export default {
-  types: {
-    ...enableControls(),
-
-    stats: {},
-
-    character: [
-      enableCharacter(),
-      enableModernControls(),
-      enableClampToBounds(),
-      enableJump(),
-      enableFsm({
-        default: {
-          "game:update"(instance) {
-            stopFreeFalling(instance)
-          },
-        },
-
-        jumping: {
-          "game:update"(instance) {
-            stopFreeFalling(instance)
-          },
-        },
-      }),
-    ],
-  },
-
-  instances: {
-    ...createControls("input0", {
-      ArrowUp: "up",
-      ArrowDown: "down",
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      Space: "jump",
-      KeyW: "up",
-      KeyS: "down",
-      KeyA: "left",
-      KeyD: "right",
-      Btn12: "up",
-      Btn13: "down",
-      Btn14: "left",
-      Btn15: "right",
-      Btn0: "jump",
-      Axis0: "leftRight",
-      Axis1: "upDown",
-    }),
-
-    stats: {
-      type: "stats",
-      position: [600, 0, 600],
-      target: "character",
-    },
-
-    character: {
-      type: "character",
-      maxSpeed: 250,
-      position: [400, 0, 300],
-      maxJump: 100,
-      maxLeap: 100,
-    },
-  },
-}
-
-function stopFreeFalling(instance) {
-  if (instance.position[Y] <= 0) {
-    instance.vy = 0
-    instance.position[Y] = 0
-    instance.state = "default"
-  }
-}

package/src/docs/player/kinematic/kinematic.stories.js

@@ -1,32 +0,0 @@
-import UiChooser from "@inglorious/docs/ui-chooser.jsx"
-
-import doubleJump from "./double-jump.js"
-import jump from "./jump.js"
-import modernControls from "./modern-controls.js"
-import shooterControls from "./shooter-controls.js"
-import tankControls from "./tank-controls.js"
-
-export default {
-  title: "Engine/Player/Kinematic",
-  component: UiChooser,
-}
-
-export const ModernControls = {
-  args: { config: modernControls },
-}
-
-export const TankControls = {
-  args: { config: tankControls },
-}
-
-export const ShooterControls = {
-  args: { config: shooterControls },
-}
-
-export const Jump = {
-  args: { config: jump },
-}
-
-export const DoubleJump = {
-  args: { config: doubleJump },
-}

package/src/docs/player/kinematic/modern-controls.js

@@ -1,56 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds.js"
-import { enableModernControls } from "@inglorious/game/decorators/controls/kinematic/modern.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-
-export default {
-  types: {
-    ...enableControls(),
-
-    stats: {},
-
-    character: [
-      enableCharacter(),
-      enableModernControls(),
-      enableClampToBounds(),
-    ],
-  },
-
-  instances: {
-    ...createControls("input0", {
-      ArrowUp: "up",
-      ArrowDown: "down",
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      Space: "jump",
-      KeyW: "up",
-      KeyS: "down",
-      KeyA: "left",
-      KeyD: "right",
-      Btn12: "up",
-      Btn13: "down",
-      Btn14: "left",
-      Btn15: "right",
-      Btn0: "jump",
-      Axis0: "leftRight",
-      Axis1: "upDown",
-    }),
-
-    stats: {
-      type: "stats",
-      position: [600, 0, 600],
-      target: "character",
-    },
-
-    character: {
-      type: "character",
-      maxSpeed: 250,
-      position: [400, 0, 300],
-      maxJump: 100,
-      maxLeap: 100,
-    },
-  },
-}

package/src/docs/player/kinematic/shooter-controls.js

@@ -1,48 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds.js"
-import { enableShooterControls } from "@inglorious/game/decorators/controls/kinematic/shooter.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
-import { pi } from "@inglorious/utils/math/trigonometry.js"
-
-export default {
-  types: {
-    mouse: [enableMouse()],
-
-    ...enableControls(),
-
-    character: [
-      enableCharacter(),
-      enableShooterControls(),
-      enableClampToBounds(),
-    ],
-  },
-
-  instances: {
-    mouse: {
-      type: "mouse",
-      position: [400, 0, 300],
-    },
-
-    ...createControls("input0", {
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      ArrowDown: "down",
-      ArrowUp: "up",
-      KeyA: "left",
-      KeyD: "right",
-      KeyS: "down",
-      KeyW: "up",
-    }),
-
-    character: {
-      type: "character",
-      maxAngularSpeed: 2 * pi(),
-      maxSpeed: 250,
-      position: [400, 0, 300],
-    },
-  },
-}

package/src/docs/player/kinematic/tank-controls.js

@@ -1,42 +0,0 @@
-import { enableCharacter } from "@inglorious/game/decorators/character.js"
-import { enableClampToBounds } from "@inglorious/game/decorators/clamp-to-bounds"
-import { enableTankControls } from "@inglorious/game/decorators/controls/kinematic/tank.js"
-import {
-  createControls,
-  enableControls,
-} from "@inglorious/game/decorators/input/controls.js"
-
-export default {
-  types: {
-    ...enableControls(),
-
-    character: [enableCharacter(), enableTankControls(), enableClampToBounds()],
-  },
-
-  instances: {
-    ...createControls("input0", {
-      ArrowUp: "up",
-      ArrowDown: "down",
-      ArrowLeft: "left",
-      ArrowRight: "right",
-      KeyW: "up",
-      KeyS: "down",
-      KeyA: "left",
-      KeyD: "right",
-      Btn12: "up",
-      Btn13: "down",
-      Btn14: "left",
-      Btn15: "right",
-      Axis0: "strafe",
-      Axis1: "upDown",
-      Axis2: "leftRight",
-    }),
-
-    character: {
-      type: "character",
-      maxAngularSpeed: 10,
-      maxSpeed: 250,
-      position: [400, 0, 300],
-    },
-  },
-}

package/src/docs/quick-start/first-game.js

@@ -1,49 +0,0 @@
-export default {
-  types: {
-    character: {
-      draw(ctx, instance) {
-        const {
-          size = 24,
-          orientation = 0,
-          stroke = "black",
-          fill = "transparent",
-        } = instance
-
-        const radius = size * 0.5
-
-        ctx.save()
-        ctx.rotate(-orientation)
-        ctx.translate(radius - 1, 0)
-
-        ctx.fillStyle = "black"
-
-        ctx.beginPath()
-        ctx.moveTo(0, 6)
-        ctx.lineTo(0, -6)
-        ctx.lineTo(6, 0)
-        ctx.fill()
-        ctx.closePath()
-        ctx.restore()
-
-        ctx.save()
-        ctx.lineWidth = 1
-        ctx.strokeStyle = stroke
-        ctx.fillStyle = fill
-
-        ctx.beginPath()
-        ctx.arc(0, 0, radius, 0, 2 * 3.14)
-        ctx.fill()
-        ctx.stroke()
-        ctx.closePath()
-        ctx.restore()
-      },
-    },
-  },
-
-  instances: {
-    character: {
-      type: "character",
-      position: [400, 0, 300],
-    },
-  },
-}

package/src/docs/quick-start/hello-world.js

@@ -1 +0,0 @@
-export default {}

package/src/docs/quick-start.mdx

@@ -1,127 +0,0 @@
-import { Canvas, Meta, Source } from '@storybook/blocks'
-import * as QuickStart from './quick-start.stories'
-
-import helloWorld from './quick-start/hello-world?raw'
-import firstGame from './quick-start/first-game?raw'
-
-<Meta of={QuickStart} />
-
-# Quick Start Guide
-
-Welcome to Inglorious Engine! This guide will get you up and running in minutes.
-
-## What is Inglorious Engine?
-
-Inglorious Engine is a **functional programming** game engine for JavaScript. Instead of object-oriented programming, it uses:
-- **Global state** - One source of truth for your entire game
-- **Immutability** - State changes create new state, never modify existing
-- **Pure functions** - Predictable, testable, and reusable functions
-- **Function composition** - Combine behaviors like building blocks
-
-## Your First Game
-
-### Step 1: Basic Setup
-
-Create an HTML file with this structure:
-
-```html
-<!doctype html>
-<html lang="en">
-  <body>
-    <canvas id="canvas"></canvas>
-    
-    <script type="importmap">
-      {
-        "imports": {
-          "immer": "https://unpkg.com/immer@10.1.1/dist/immer.mjs",
-          "@inglorious/": "/src/",
-          "game": "./my-game.js"
-        }
-      }
-    </script>
-    
-    <script type="module" src="/src/main.js"></script>
-  </body>
-</html>
-```
-
-### Step 2: Hello World
-
-Create `my-game.js` with the simplest possible game:
-
-<Source dark code={helloWorld} />
-
-<Canvas of={QuickStart.HelloWorld} />
-
-This creates an 800x600 canvas with a light grey background. Not exciting yet, but it's working!
-
-### Step 3: Add a Character
-
-Let's add something to the scene:
-
-<Source dark code={firstGame} />
-
-<Canvas of={QuickStart.FirstGame} />
-
-## Key Concepts
-
-### 1. Game Configuration Structure
-
-Every game has this structure:
-```javascript
-export default {
-  // Static definitions - never change
-  types: {
-    // Define what kinds of objects exist
-  },
-  
-  // Dynamic state - changes during gameplay
-  instances: {
-    // Actual objects in the scene
-  }
-}
-```
-
-### 2. Types vs Instances
-
-- **Types**: Define what something *is* (like a blueprint)
-- **Instances**: Define specific *examples* of that type (like actual objects)
-
-### 3. Event Handlers
-
-To make things move and interact, use event handlers:
-
-```javascript
-types: {
-  character: {
-    // Drawing logic here
-    draw(ctx, instance) { /* ... */ },
-    
-    // Event handlers here
-    events: {
-      'game:update': (instance, event, { dt, config, instances }) => {
-        // This runs every frame
-        // Update position, velocity, etc.
-      }
-    }
-  }
-}
-```
-
-## Next Steps
-
-Now that you have a basic understanding of the engine, you're ready to dive deeper.
-
-Continue to the **[Core Concepts](/docs/engine--docs)** page to learn about event handlers, code reuse, and other essential features.
-
-## Why Functional Programming?
-
-Traditional game engines use objects with methods that modify internal state. Inglorious Engine is different:
-
-✅ **Predictable**: Same input always produces same output  
-✅ **Testable**: Pure functions are easy to test  
-✅ **Composable**: Combine behaviors like LEGO blocks  
-✅ **Debuggable**: State changes are explicit and traceable  
-✅ **Performant**: Immutability enables efficient rendering  
-
-Ready to build your first game? Let's go!

package/src/docs/quick-start.stories.js

@@ -1,17 +0,0 @@
-import UiChooser from "@inglorious/docs/ui-chooser.jsx"
-
-import firstGame from "./quick-start/first-game.js"
-import helloWorld from "./quick-start/hello-world.js"
-
-export default {
-  title: "Quick Start",
-  component: UiChooser,
-}
-
-export const HelloWorld = {
-  args: { config: helloWorld },
-}
-
-export const FirstGame = {
-  args: { config: firstGame },
-}