pyforge3d 2.1.1__tar.gz → 2.2.1__tar.gz

{pyforge3d-2.1.1 → pyforge3d-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyforge3d
-Version: 2.1.1
+Version: 2.2.1
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Rust
 Classifier: Intended Audience :: Developers
@@ -16,35 +16,33 @@ Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Dist: numpy>=1.26
+Requires-Dist: numpy>=2.0
 Requires-Dist: scipy>=1.12
 Requires-Dist: sympy>=1.13
 Requires-Dist: jax[cpu]>=0.4.25
-Requires-Dist: pyforge3d[render,rl,dev] ; extra == 'all'
+Requires-Dist: moderngl>=5.10
+Requires-Dist: glfw>=2.5
+Requires-Dist: pillow>=10.0
+Requires-Dist: imageio>=2.34
+Requires-Dist: imageio-ffmpeg>=0.5
+Requires-Dist: soundfile>=0.12
+Requires-Dist: gymnasium>=0.29
+Requires-Dist: stable-baselines3>=2.2
+Requires-Dist: optax>=0.2
+Requires-Dist: matplotlib>=3.8
+Requires-Dist: pyforge3d[experimental,dev,docs] ; extra == 'all'
 Requires-Dist: pytest>=8.0 ; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0 ; extra == 'dev'
 Requires-Dist: ruff>=0.4 ; extra == 'dev'
 Requires-Dist: mypy>=1.9 ; extra == 'dev'
-Requires-Dist: moderngl>=5.10 ; extra == 'dev'
-Requires-Dist: glfw>=2.5 ; extra == 'dev'
-Requires-Dist: pillow>=10.0 ; extra == 'dev'
-Requires-Dist: imageio>=2.34 ; extra == 'dev'
-Requires-Dist: imageio-ffmpeg>=0.5 ; extra == 'dev'
 Requires-Dist: mkdocs-material>=9.5 ; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.25 ; extra == 'docs'
-Requires-Dist: moderngl>=5.10 ; extra == 'render'
-Requires-Dist: glfw>=2.5 ; extra == 'render'
-Requires-Dist: pillow>=10.0 ; extra == 'render'
-Requires-Dist: imageio>=2.34 ; extra == 'render'
-Requires-Dist: imageio-ffmpeg>=0.5 ; extra == 'render'
-Requires-Dist: gymnasium>=0.29 ; extra == 'rl'
-Requires-Dist: stable-baselines3>=2.2 ; extra == 'rl'
-Requires-Dist: optax>=0.2 ; extra == 'rl'
+Requires-Dist: wgpu>=0.19 ; extra == 'experimental'
+Requires-Dist: rendercanvas>=2.0 ; extra == 'experimental'
 Provides-Extra: all
 Provides-Extra: dev
 Provides-Extra: docs
-Provides-Extra: render
-Provides-Extra: rl
+Provides-Extra: experimental
 License-File: LICENSE
 Summary: Pure-Python 3D physics game engine — own dynamics, own rules, no compromises.
 Keywords: game-engine,physics,simulation,3d,rigid-body,collision,rendering,robotics,reinforcement-learning,numpy,jax
@@ -92,17 +90,26 @@ all solved by forge3d's own code, backed by NumPy and optional JAX acceleration.
 | Category | Details |
 |---|---|
 | **Game loop** | `App` class — `@on_start` / `@on_update` / `@on_render` decorators |
-| **Input** | `Input` snapshot — `key_held`, `key_pressed`, `mouse_pos`, `scroll_delta` |
-| **Camera** | `OrbitCamera`, `FollowCamera` — orbit, zoom, pan, smooth follow |
+| **Input** | `Input` snapshot — `key_held`, `key_pressed`, `axis()`, `mouse_pos`, `scroll_delta` |
+| **Camera** | `OrbitCamera` (with `handle_input()`), `FollowCamera` — orbit, zoom, pan, smooth follow |
+| **Character** | `CharacterController` — `move()`, `jump()`, `glide()`, `move_camera_relative()` |
 | **Physics** | Rigid-body dynamics (RNEA / CRBA / ABA), semi-implicit Euler integrator |
-| **Collision** | SAT OBB-OBB (15-axis), sphere, capsule, GJK/EPA convex-mesh; AABB broad-phase |
-| **Contact** | Impulse solver, Coulomb friction, Baumgarte correction, warm-starting |
-| **Grasping** | `weld` / `release` kinematic constraints; friction-based pinch grasp |
+| **Collision** | SAT OBB-OBB (15-axis), sphere, capsule, GJK/EPA convex-mesh; AABB broad-phase; BVH (Rust) |
+| **Contact** | Impulse-based PGS solver, Coulomb friction, Baumgarte stabilization |
+| **Joints** | Hinge, Ball, Prismatic, Fixed, Distance, Spring; `weld` / `release` |
+| **Terrain** | Heightfield collision + rendering (32×32 to 512×512) |
 | **Robots** | UR5 6-DOF FK/IK, DH parameters, Jacobian |
-| **Rendering** | Real-time PBR (Cook-Torrance, PCF shadows, albedo/normal textures); HQ software ray-tracer |
-| **RL** | Gymnasium-compatible `ReachEnv` / `PickPlaceEnv` |
-| **Performance** | JAX JIT+vmap: 2 000× throughput vs. NumPy; AABB broad-phase O(n log n) |
-| **Testing** | 215+ automated tests; PyBullet baseline comparison |
+| **Rendering** | `RealtimeRenderer` (OpenGL 3.3 PBR), `DeferredRenderer` (OpenGL 4.3 + SSAO + CSM + Bloom), `HQRenderer` (software ray-tracer) |
+| **ECS** | `EntityWorld`, `Transform`, `Rigidbody`, `MeshRenderer`, `Script`, `PhysicsSystem` |
+| **Animation** | `Skeleton`, `AnimationClip`, `AnimationPlayer`, `BlendTree`, `FABRIKSolver` |
+| **Audio** | `AudioSystem`, `AudioSource`, `AudioClip` — OpenAL, headless null fallback |
+| **Particles** | `ParticleEmitter`, `ParticleSystem` — `sparks`, `smoke`, `debris`, `rain` presets |
+| **Scene** | `SceneManager`, `SceneNode`, `Prefab` — additive scene transitions |
+| **UI** | `Canvas`, `DebugPanel`, `InspectorPanel`, `HierarchyPanel` |
+| **Editor** | `EditorApp` — Play/Pause/Step, transform gizmos |
+| **RL** | Gymnasium-compatible environments; JAX JIT+vmap batch rollouts |
+| **Performance** | JAX JIT+vmap: 2 000× throughput; Rust PyO3 core (PGS, GJK/EPA, BVH) |
+| **Testing** | 459+ automated tests; PyBullet baseline comparison |
 | **Typed** | Fully annotated with `py.typed` marker |
 
 ---
@@ -110,27 +117,21 @@ all solved by forge3d's own code, backed by NumPy and optional JAX acceleration.
 ## Installation
 
 ```bash
-# Core library (physics + rendering)
+# Full install — physics, rendering, and RL in one command
 pip install pyforge3d
 
-# With rendering dependencies
-pip install "pyforge3d[render]"
-
-# With RL dependencies
-pip install "pyforge3d[rl]"
-
-# Everything
-pip install "pyforge3d[all]"
-
 # Development install
 git clone https://github.com/iruki-dev/forge3d
 cd forge3d
 pip install -e ".[dev]"
+
+# WebGPU renderer (experimental, P34 — falls back to OpenGL if omitted)
+pip install "pyforge3d[experimental]"
 ```
 
 > **Install name vs import name:** `pip install pyforge3d` — then `import forge3d` in your code.
 
-**Requirements:** Python 3.12+, NumPy, SciPy, JAX (CPU wheel)
+**Requirements:** Python 3.12+, NumPy, SciPy, JAX (CPU wheel), moderngl, glfw, gymnasium
 
 ---
 
@@ -257,11 +258,21 @@ print(f"End-effector: {ee_pos.round(4)}")
 
 ## Reinforcement learning
 
+forge3d ships a Gymnasium-compatible physics world. Use it directly with any RL library:
+
 ```python
-from apps.robot_rl.envs.reach_env import ReachEnv
+import gymnasium as gym
+import forge3d as f3d
 from stable_baselines3 import PPO
 
-env  = ReachEnv(render_mode=None)          # headless, fast
+# Build a custom Gymnasium env backed by forge3d physics
+class ReachEnv(gym.Env):
+    def __init__(self):
+        super().__init__()
+        self.world = f3d.World(gravity=(0, 0, -9.81))
+        # ... define observation_space / action_space
+
+env   = ReachEnv()
 model = PPO("MlpPolicy", env, verbose=1)
 model.learn(total_timesteps=200_000)
 model.save("reach_policy")
@@ -436,43 +447,55 @@ Physics core        → SceneSnapshot →  RealtimeRenderer (OpenGL)
 
 ```
 forge3d/
-├── src/forge3d/
-│   ├── __init__.py          # Public API: World, App, Body, Shape, Material…
-│   ├── app.py               # App — game-loop abstraction
-│   ├── input.py             # Input, Key, _InputBuilder
-│   ├── camera.py            # OrbitCamera, FollowCamera
-│   ├── facade.py            # World, Body, Shape, Material facades
-│   ├── viewer.py            # Viewer (realtime render loop)
-│   ├── recorder.py          # Recorder (video capture)
-│   ├── backend.py           # NumPy ↔ JAX backend switch
-│   ├── math/                # SE3, quaternion, spatial algebra
-│   ├── dynamics/            # RNEA, CRBA, ABA
-│   ├── collision/
-│   │   ├── detection.py     # SAT + AABB broad-phase
-│   │   ├── gjk.py           # GJK distance / intersection
-│   │   └── epa.py           # EPA penetration depth
-│   ├── contact/
-│   │   └── solver.py        # Impulse solver (PGS + Coulomb friction)
-│   ├── model/               # RigidBodyModel, DH joints, kinematics
-│   ├── sim/
-│   │   ├── world.py         # PhysicsWorld (step, snapshot, CRUD)
-│   │   ├── jax_batch.py     # JAX JIT+vmap batch physics
-│   │   └── domain_rand.py   # Domain randomisation
-│   ├── robot/               # Robot, UR5 preset, FK/IK
-│   ├── render/
-│   │   ├── snapshot.py      # SceneSnapshot, Transform, Material…
-│   │   ├── base.py          # Renderer ABC
-│   │   ├── realtime/        # OpenGL rasteriser (PBR, PCF shadow)
-│   │   └── hq/              # Software ray-tracer (Blinn-Phong, AO, AA)
-│   ├── io/
-│   │   ├── obj_loader.py    # Pure-Python OBJ parser
-│   │   └── mesh_data.py     # MeshData, convex_hull_inertia
-│   └── py.typed             # PEP 561 type marker
-├── apps/robot_rl/            # RL application (Gymnasium envs, training)
-├── examples/                 # Self-contained examples (≤15 lines each)
-├── tests/                    # 215+ automated tests
-├── validation/               # PyBullet / MuJoCo baseline comparison
-├── assets/                   # 3D models, textures
+├── src/
+│   ├── forge3d/
+│   │   ├── __init__.py          # Public API: World, App, Body, Shape, Material…
+│   │   ├── app.py               # App — game-loop abstraction
+│   │   ├── input.py             # Input, Key, InputBuilder
+│   │   ├── camera.py            # OrbitCamera, FollowCamera
+│   │   ├── character.py         # CharacterController
+│   │   ├── facade.py            # World, Body, Shape, Material facades
+│   │   ├── viewer.py            # Viewer (realtime render loop)
+│   │   ├── recorder.py          # Recorder (video capture)
+│   │   ├── backend.py           # NumPy ↔ JAX backend switch
+│   │   ├── math/                # SE3, quaternion, spatial algebra
+│   │   ├── dynamics/            # RNEA, CRBA, ABA
+│   │   ├── collision/           # SAT, GJK/EPA, heightfield, layers, raycast
+│   │   ├── contact/             # Impulse solver (PGS + Coulomb friction)
+│   │   ├── constraints/         # Joints: Hinge, Ball, Prismatic, Fixed, Distance, Spring
+│   │   ├── model/               # RigidBodyModel, DH joints, kinematics
+│   │   ├── sim/
+│   │   │   ├── world.py         # PhysicsWorld (step, snapshot, CRUD)
+│   │   │   ├── jax_batch.py     # JAX JIT+vmap batch physics
+│   │   │   └── domain_rand.py   # Domain randomisation
+│   │   ├── robot/               # Robot, UR5 preset, FK/IK
+│   │   ├── ecs/                 # EntityWorld, Transform, Rigidbody, Systems…
+│   │   ├── animation/           # Skeleton, AnimationClip, FABRIKSolver…
+│   │   ├── audio/               # AudioSystem, AudioSource, AudioClip (OpenAL)
+│   │   ├── particle/            # ParticleEmitter, ParticleSystem, presets
+│   │   ├── scene/               # SceneManager, SceneNode, Prefab
+│   │   ├── ui/                  # Canvas, DebugPanel, InspectorPanel…
+│   │   ├── editor/              # EditorApp, gizmos, layout
+│   │   ├── render/
+│   │   │   ├── snapshot.py      # SceneSnapshot — pure-data physics↔render contract
+│   │   │   ├── base.py          # Renderer ABC
+│   │   │   ├── realtime/        # OpenGL 3.3 PBR rasteriser
+│   │   │   ├── deferred/        # OpenGL 4.3 deferred (SSAO, CSM, HDR, Bloom)
+│   │   │   ├── hq/              # Software ray-tracer (Blinn-Phong, AO, AA)
+│   │   │   ├── wgpu_backend/    # WebGPU renderer (experimental, P34)
+│   │   │   └── shaders/         # GLSL + WGSL shader sources
+│   │   ├── io/                  # OBJ loader, MeshData, world snapshot
+│   │   └── py.typed             # PEP 561 type marker
+│   └── forge3d_core/            # Rust crate (PyO3): PGS, GJK/EPA, BVH, SIMD math
+├── apps/
+│   ├── game/                    # FORGE RUNNER — 3D physics platformer
+│   ├── fps_battleroyal/         # FPS battle-royale demo
+│   └── showcase/                # Engine feature showcase
+├── examples/                    # Self-contained examples (≤15 lines each)
+├── tests/                       # 459+ automated tests
+├── validation/                  # PyBullet / MuJoCo baseline comparison
+├── assets/                      # 3D models, textures
+├── docs_src/                    # MkDocs documentation source
 ├── CHANGELOG.md
 ├── CONTRIBUTING.md
 ├── LICENSE

{pyforge3d-2.1.1 → pyforge3d-2.2.1}/README.md

@@ -33,17 +33,26 @@ all solved by forge3d's own code, backed by NumPy and optional JAX acceleration.
 | Category | Details |
 |---|---|
 | **Game loop** | `App` class — `@on_start` / `@on_update` / `@on_render` decorators |
-| **Input** | `Input` snapshot — `key_held`, `key_pressed`, `mouse_pos`, `scroll_delta` |
-| **Camera** | `OrbitCamera`, `FollowCamera` — orbit, zoom, pan, smooth follow |
+| **Input** | `Input` snapshot — `key_held`, `key_pressed`, `axis()`, `mouse_pos`, `scroll_delta` |
+| **Camera** | `OrbitCamera` (with `handle_input()`), `FollowCamera` — orbit, zoom, pan, smooth follow |
+| **Character** | `CharacterController` — `move()`, `jump()`, `glide()`, `move_camera_relative()` |
 | **Physics** | Rigid-body dynamics (RNEA / CRBA / ABA), semi-implicit Euler integrator |
-| **Collision** | SAT OBB-OBB (15-axis), sphere, capsule, GJK/EPA convex-mesh; AABB broad-phase |
-| **Contact** | Impulse solver, Coulomb friction, Baumgarte correction, warm-starting |
-| **Grasping** | `weld` / `release` kinematic constraints; friction-based pinch grasp |
+| **Collision** | SAT OBB-OBB (15-axis), sphere, capsule, GJK/EPA convex-mesh; AABB broad-phase; BVH (Rust) |
+| **Contact** | Impulse-based PGS solver, Coulomb friction, Baumgarte stabilization |
+| **Joints** | Hinge, Ball, Prismatic, Fixed, Distance, Spring; `weld` / `release` |
+| **Terrain** | Heightfield collision + rendering (32×32 to 512×512) |
 | **Robots** | UR5 6-DOF FK/IK, DH parameters, Jacobian |
-| **Rendering** | Real-time PBR (Cook-Torrance, PCF shadows, albedo/normal textures); HQ software ray-tracer |
-| **RL** | Gymnasium-compatible `ReachEnv` / `PickPlaceEnv` |
-| **Performance** | JAX JIT+vmap: 2 000× throughput vs. NumPy; AABB broad-phase O(n log n) |
-| **Testing** | 215+ automated tests; PyBullet baseline comparison |
+| **Rendering** | `RealtimeRenderer` (OpenGL 3.3 PBR), `DeferredRenderer` (OpenGL 4.3 + SSAO + CSM + Bloom), `HQRenderer` (software ray-tracer) |
+| **ECS** | `EntityWorld`, `Transform`, `Rigidbody`, `MeshRenderer`, `Script`, `PhysicsSystem` |
+| **Animation** | `Skeleton`, `AnimationClip`, `AnimationPlayer`, `BlendTree`, `FABRIKSolver` |
+| **Audio** | `AudioSystem`, `AudioSource`, `AudioClip` — OpenAL, headless null fallback |
+| **Particles** | `ParticleEmitter`, `ParticleSystem` — `sparks`, `smoke`, `debris`, `rain` presets |
+| **Scene** | `SceneManager`, `SceneNode`, `Prefab` — additive scene transitions |
+| **UI** | `Canvas`, `DebugPanel`, `InspectorPanel`, `HierarchyPanel` |
+| **Editor** | `EditorApp` — Play/Pause/Step, transform gizmos |
+| **RL** | Gymnasium-compatible environments; JAX JIT+vmap batch rollouts |
+| **Performance** | JAX JIT+vmap: 2 000× throughput; Rust PyO3 core (PGS, GJK/EPA, BVH) |
+| **Testing** | 459+ automated tests; PyBullet baseline comparison |
 | **Typed** | Fully annotated with `py.typed` marker |
 
 ---
@@ -51,27 +60,21 @@ all solved by forge3d's own code, backed by NumPy and optional JAX acceleration.
 ## Installation
 
 ```bash
-# Core library (physics + rendering)
+# Full install — physics, rendering, and RL in one command
 pip install pyforge3d
 
-# With rendering dependencies
-pip install "pyforge3d[render]"
-
-# With RL dependencies
-pip install "pyforge3d[rl]"
-
-# Everything
-pip install "pyforge3d[all]"
-
 # Development install
 git clone https://github.com/iruki-dev/forge3d
 cd forge3d
 pip install -e ".[dev]"
+
+# WebGPU renderer (experimental, P34 — falls back to OpenGL if omitted)
+pip install "pyforge3d[experimental]"
 ```
 
 > **Install name vs import name:** `pip install pyforge3d` — then `import forge3d` in your code.
 
-**Requirements:** Python 3.12+, NumPy, SciPy, JAX (CPU wheel)
+**Requirements:** Python 3.12+, NumPy, SciPy, JAX (CPU wheel), moderngl, glfw, gymnasium
 
 ---
 
@@ -198,11 +201,21 @@ print(f"End-effector: {ee_pos.round(4)}")
 
 ## Reinforcement learning
 
+forge3d ships a Gymnasium-compatible physics world. Use it directly with any RL library:
+
 ```python
-from apps.robot_rl.envs.reach_env import ReachEnv
+import gymnasium as gym
+import forge3d as f3d
 from stable_baselines3 import PPO
 
-env  = ReachEnv(render_mode=None)          # headless, fast
+# Build a custom Gymnasium env backed by forge3d physics
+class ReachEnv(gym.Env):
+    def __init__(self):
+        super().__init__()
+        self.world = f3d.World(gravity=(0, 0, -9.81))
+        # ... define observation_space / action_space
+
+env   = ReachEnv()
 model = PPO("MlpPolicy", env, verbose=1)
 model.learn(total_timesteps=200_000)
 model.save("reach_policy")
@@ -377,43 +390,55 @@ Physics core        → SceneSnapshot →  RealtimeRenderer (OpenGL)
 
 ```
 forge3d/
-├── src/forge3d/
-│   ├── __init__.py          # Public API: World, App, Body, Shape, Material…
-│   ├── app.py               # App — game-loop abstraction
-│   ├── input.py             # Input, Key, _InputBuilder
-│   ├── camera.py            # OrbitCamera, FollowCamera
-│   ├── facade.py            # World, Body, Shape, Material facades
-│   ├── viewer.py            # Viewer (realtime render loop)
-│   ├── recorder.py          # Recorder (video capture)
-│   ├── backend.py           # NumPy ↔ JAX backend switch
-│   ├── math/                # SE3, quaternion, spatial algebra
-│   ├── dynamics/            # RNEA, CRBA, ABA
-│   ├── collision/
-│   │   ├── detection.py     # SAT + AABB broad-phase
-│   │   ├── gjk.py           # GJK distance / intersection
-│   │   └── epa.py           # EPA penetration depth
-│   ├── contact/
-│   │   └── solver.py        # Impulse solver (PGS + Coulomb friction)
-│   ├── model/               # RigidBodyModel, DH joints, kinematics
-│   ├── sim/
-│   │   ├── world.py         # PhysicsWorld (step, snapshot, CRUD)
-│   │   ├── jax_batch.py     # JAX JIT+vmap batch physics
-│   │   └── domain_rand.py   # Domain randomisation
-│   ├── robot/               # Robot, UR5 preset, FK/IK
-│   ├── render/
-│   │   ├── snapshot.py      # SceneSnapshot, Transform, Material…
-│   │   ├── base.py          # Renderer ABC
-│   │   ├── realtime/        # OpenGL rasteriser (PBR, PCF shadow)
-│   │   └── hq/              # Software ray-tracer (Blinn-Phong, AO, AA)
-│   ├── io/
-│   │   ├── obj_loader.py    # Pure-Python OBJ parser
-│   │   └── mesh_data.py     # MeshData, convex_hull_inertia
-│   └── py.typed             # PEP 561 type marker
-├── apps/robot_rl/            # RL application (Gymnasium envs, training)
-├── examples/                 # Self-contained examples (≤15 lines each)
-├── tests/                    # 215+ automated tests
-├── validation/               # PyBullet / MuJoCo baseline comparison
-├── assets/                   # 3D models, textures
+├── src/
+│   ├── forge3d/
+│   │   ├── __init__.py          # Public API: World, App, Body, Shape, Material…
+│   │   ├── app.py               # App — game-loop abstraction
+│   │   ├── input.py             # Input, Key, InputBuilder
+│   │   ├── camera.py            # OrbitCamera, FollowCamera
+│   │   ├── character.py         # CharacterController
+│   │   ├── facade.py            # World, Body, Shape, Material facades
+│   │   ├── viewer.py            # Viewer (realtime render loop)
+│   │   ├── recorder.py          # Recorder (video capture)
+│   │   ├── backend.py           # NumPy ↔ JAX backend switch
+│   │   ├── math/                # SE3, quaternion, spatial algebra
+│   │   ├── dynamics/            # RNEA, CRBA, ABA
+│   │   ├── collision/           # SAT, GJK/EPA, heightfield, layers, raycast
+│   │   ├── contact/             # Impulse solver (PGS + Coulomb friction)
+│   │   ├── constraints/         # Joints: Hinge, Ball, Prismatic, Fixed, Distance, Spring
+│   │   ├── model/               # RigidBodyModel, DH joints, kinematics
+│   │   ├── sim/
+│   │   │   ├── world.py         # PhysicsWorld (step, snapshot, CRUD)
+│   │   │   ├── jax_batch.py     # JAX JIT+vmap batch physics
+│   │   │   └── domain_rand.py   # Domain randomisation
+│   │   ├── robot/               # Robot, UR5 preset, FK/IK
+│   │   ├── ecs/                 # EntityWorld, Transform, Rigidbody, Systems…
+│   │   ├── animation/           # Skeleton, AnimationClip, FABRIKSolver…
+│   │   ├── audio/               # AudioSystem, AudioSource, AudioClip (OpenAL)
+│   │   ├── particle/            # ParticleEmitter, ParticleSystem, presets
+│   │   ├── scene/               # SceneManager, SceneNode, Prefab
+│   │   ├── ui/                  # Canvas, DebugPanel, InspectorPanel…
+│   │   ├── editor/              # EditorApp, gizmos, layout
+│   │   ├── render/
+│   │   │   ├── snapshot.py      # SceneSnapshot — pure-data physics↔render contract
+│   │   │   ├── base.py          # Renderer ABC
+│   │   │   ├── realtime/        # OpenGL 3.3 PBR rasteriser
+│   │   │   ├── deferred/        # OpenGL 4.3 deferred (SSAO, CSM, HDR, Bloom)
+│   │   │   ├── hq/              # Software ray-tracer (Blinn-Phong, AO, AA)
+│   │   │   ├── wgpu_backend/    # WebGPU renderer (experimental, P34)
+│   │   │   └── shaders/         # GLSL + WGSL shader sources
+│   │   ├── io/                  # OBJ loader, MeshData, world snapshot
+│   │   └── py.typed             # PEP 561 type marker
+│   └── forge3d_core/            # Rust crate (PyO3): PGS, GJK/EPA, BVH, SIMD math
+├── apps/
+│   ├── game/                    # FORGE RUNNER — 3D physics platformer
+│   ├── fps_battleroyal/         # FPS battle-royale demo
+│   └── showcase/                # Engine feature showcase
+├── examples/                    # Self-contained examples (≤15 lines each)
+├── tests/                       # 459+ automated tests
+├── validation/                  # PyBullet / MuJoCo baseline comparison
+├── assets/                      # 3D models, textures
+├── docs_src/                    # MkDocs documentation source
 ├── CHANGELOG.md
 ├── CONTRIBUTING.md
 ├── LICENSE

{pyforge3d-2.1.1 → pyforge3d-2.2.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "maturin"
 
 [project]
 name = "pyforge3d"
-version = "2.1.1"
+version = "2.2.1"
 description = "Pure-Python 3D physics game engine — own dynamics, own rules, no compromises."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -35,10 +35,22 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "numpy>=1.26",
+    "numpy>=2.0",
     "scipy>=1.12",
     "sympy>=1.13",
     "jax[cpu]>=0.4.25",
+    # rendering
+    "moderngl>=5.10",
+    "glfw>=2.5",
+    "Pillow>=10.0",
+    "imageio>=2.34",
+    "imageio-ffmpeg>=0.5",
+    "soundfile>=0.12",
+    # RL / training
+    "gymnasium>=0.29",
+    "stable-baselines3>=2.2",
+    "optax>=0.2",
+    "matplotlib>=3.8",
 ]
 
 [project.urls]
@@ -51,36 +63,22 @@ Changelog     = "https://github.com/iruki-dev/forge3d/blob/main/CHANGELOG.md"
 # ── Optional dependency groups ────────────────────────────────────────────────
 
 [project.optional-dependencies]
-render = [
-    "moderngl>=5.10",
-    "glfw>=2.5",
-    "Pillow>=10.0",
-    "imageio>=2.34",
-    "imageio-ffmpeg>=0.5",
-]
-rl = [
-    "gymnasium>=0.29",
-    "stable-baselines3>=2.2",
-    "optax>=0.2",
+experimental = [
+    "wgpu>=0.19",            # P34 WebGPU 렌더러 (없으면 GL 폴백)
+    "rendercanvas>=2.0",     # wgpu 캔버스 백엔드
 ]
 dev = [
     "pytest>=8.0",
     "pytest-cov>=5.0",
     "ruff>=0.4",
     "mypy>=1.9",
-    # render deps for tests
-    "moderngl>=5.10",
-    "glfw>=2.5",
-    "Pillow>=10.0",
-    "imageio>=2.34",
-    "imageio-ffmpeg>=0.5",
 ]
 docs = [
     "mkdocs-material>=9.5",
     "mkdocstrings[python]>=0.25",
 ]
 all = [
-    "pyforge3d[render,rl,dev]",
+    "pyforge3d[experimental,dev,docs]",
 ]
 
 # ── Build (maturin — Python + Rust 혼합) ──────────────────────────────────────
@@ -103,13 +101,15 @@ addopts   = "-q --tb=short"
 line-length    = 100
 target-version = "py312"
 src            = ["src"]
+exclude        = ["archive", "demos"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B", "C4", "SIM"]
 ignore = ["B008", "SIM118"]
 
 [tool.ruff.lint.per-file-ignores]
-"tests/**" = ["E501"]
+"tests/**"          = ["E501"]
+"apps/**"           = ["E501", "E701", "E702", "B905", "E741", "SIM105", "SIM108"]
 
 # ── Type-check ────────────────────────────────────────────────────────────────
 

{pyforge3d-2.1.1 → pyforge3d-2.2.1}/src/forge3d/__init__.py

@@ -103,7 +103,7 @@ from forge3d.editor import EditorApp, PlayState
 from forge3d.errors import Forge3dError, PhysicsError, RenderError, ValidationError
 from forge3d.events import CollisionEvent, CollisionHandler
 from forge3d.facade import Body, Material, Shape, World
-from forge3d.input import Input, InputBuilder, Key
+from forge3d.input import Input, InputBuilder, Key, ScriptedInput
 from forge3d.io.world_snapshot import StateRecorder
 
 # Particle system (P31)
@@ -121,7 +121,7 @@ from forge3d.scene import Prefab, SceneManager, SceneNode
 from forge3d.ui import Canvas, DebugPanel, HierarchyPanel, InspectorPanel, UISystem
 from forge3d.viewer import Viewer
 
-__version__ = "2.1.1"
+__version__ = "2.2.1"
 
 # ── API 안정성 선언 ───────────────────────────────────────────────────────────
 # Stable (v3까지 Breaking change 없음):
@@ -158,6 +158,7 @@ __all__ = [
     "Input",
     "InputBuilder",
     "Key",
+    "ScriptedInput",
     # Camera
     "OrbitCamera",
     "FollowCamera",