aether-engine 1.7.0__tar.gz → 1.7.1__tar.gz

{aether_engine-1.7.0/aether_engine.egg-info → aether_engine-1.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aether-engine
-Version: 1.7.0
+Version: 1.7.1
 Summary: 3D/2D game engine by entiti937 — OpenGL, physics, FPS, mandatory branding splash
 Home-page: https://pypi.org/project/aether-engine/
 Author: entiti937
@@ -31,13 +31,13 @@ Requires-Dist: trimesh>=3.21; extra == "models"
 Provides-Extra: build
 Requires-Dist: pyinstaller>=6.0; extra == "build"
 Provides-Extra: full
-Requires-Dist: freetype-py>=2.4; extra == "full"
-Requires-Dist: imageio>=2.31; extra == "full"
+Requires-Dist: pyinstaller>=6.0; extra == "full"
 Requires-Dist: pygame-ce>=2.5; extra == "full"
-Requires-Dist: pyyaml>=6.0; extra == "full"
+Requires-Dist: imageio>=2.31; extra == "full"
 Requires-Dist: trimesh>=3.21; extra == "full"
 Requires-Dist: pymunk>=6.0; extra == "full"
-Requires-Dist: pyinstaller>=6.0; extra == "full"
+Requires-Dist: pyyaml>=6.0; extra == "full"
+Requires-Dist: freetype-py>=2.4; extra == "full"
 Dynamic: author
 Dynamic: classifier
 Dynamic: description
@@ -52,7 +52,7 @@ Dynamic: summary
 # Aether Engine
 
 **3D / 2D игровой движок на Python + OpenGL**  
-**Разработчик:** entiti937 · **Версия:** 1.7.0 · **Лицензия:** MIT  
+**Разработчик:** entiti937 · **Версия:** 1.7.1 · **Лицензия:** MIT  
 **PyPI:** https://pypi.org/project/aether-engine/
 
 > Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md)
@@ -65,6 +65,12 @@ Dynamic: summary
 pip install -U "aether-engine[full]"
 ```
 
+## Что нового в 1.7.1
+
+- Документация: 2D-физика (pymunk), статус 3D-солвера, GLFW vs pygame-ce
+- Единый импорт компонентов из `aether`
+- Расширен раздел Performance
+
 ## Что нового в 1.7.0
 
 - **AssetLoader** — загрузка любых моделей, спрайтов и текстур (OBJ/GLB/FBX/PNG/WebP/…)
@@ -95,8 +101,10 @@ aether website
 ## Минимальный код
 
 ```python
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 engine = Engine(1280, 720, "Game by you — engine by entiti937")
 scene = Scene("Main")
@@ -105,7 +113,8 @@ scene.set_main_camera(camera)
 
 cube = Entity("Cube")
 cube.add_component(Transform(position=(0, 1, 0)))
-mat = Material(); mat.albedo[:] = (0.2, 0.85, 1.0)
+mat = Material()
+mat.albedo[:] = (0.2, 0.85, 1.0)
 cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
 scene.spawn(cube)
 

{aether_engine-1.7.0 → aether_engine-1.7.1}/README.md

@@ -1,7 +1,7 @@
 # Aether Engine
 
 **3D / 2D игровой движок на Python + OpenGL**  
-**Разработчик:** entiti937 · **Версия:** 1.7.0 · **Лицензия:** MIT  
+**Разработчик:** entiti937 · **Версия:** 1.7.1 · **Лицензия:** MIT  
 **PyPI:** https://pypi.org/project/aether-engine/
 
 > Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md)
@@ -14,6 +14,12 @@
 pip install -U "aether-engine[full]"
 ```
 
+## Что нового в 1.7.1
+
+- Документация: 2D-физика (pymunk), статус 3D-солвера, GLFW vs pygame-ce
+- Единый импорт компонентов из `aether`
+- Расширен раздел Performance
+
 ## Что нового в 1.7.0
 
 - **AssetLoader** — загрузка любых моделей, спрайтов и текстур (OBJ/GLB/FBX/PNG/WebP/…)
@@ -44,8 +50,10 @@ aether website
 ## Минимальный код
 
 ```python
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 engine = Engine(1280, 720, "Game by you — engine by entiti937")
 scene = Scene("Main")
@@ -54,7 +62,8 @@ scene.set_main_camera(camera)
 
 cube = Entity("Cube")
 cube.add_component(Transform(position=(0, 1, 0)))
-mat = Material(); mat.albedo[:] = (0.2, 0.85, 1.0)
+mat = Material()
+mat.albedo[:] = (0.2, 0.85, 1.0)
 cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
 scene.spawn(cube)
 

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether/__init__.py

@@ -31,7 +31,7 @@ from aether.audio.sfx import SfxBank
 from aether.resources.save_load import save_json, load_json
 from aether.physics.raycast import Raycaster
 
-__version__ = "1.7.0"
+__version__ = "1.7.1"
 
 from aether.graphics.voxel_mesh import ChunkedVoxelMesher
 from aether.accelerators import is_native_available, backend_name

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether/cli.py

@@ -17,8 +17,7 @@ QUICK_REFERENCE = f"""
   pip install -U "aether-engine[full]"
 
 МИНИМАЛЬНЫЙ КОД (3D)
-  from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-  from aether.scene.component import Transform, MeshRenderer
+  from aether import Engine, Scene, Entity, Transform, MeshRenderer, MeshFactory, Material, Camera
 
   engine = Engine(1280, 720, "My Game")
   scene = Scene("Main")

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether/core/_identity.py

@@ -20,7 +20,7 @@ _B = {
     ]),
     "sig": bytes([
         230, 194, 211, 207, 194, 213, 135, 226, 201, 192, 206, 201, 194,
-        135, 150, 137, 144, 137, 151,
+        135, 150, 137, 144, 137, 150,
     ]),
 }
 

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether/web/content.py

@@ -20,18 +20,23 @@ _BODIES = {
   <div class="step"><span class="step-num">Step 1</span>
     <pre><code>pip install -U "aether-engine[full]"</code></pre></div>
   <div class="step"><span class="step-num">Step 2 — first game</span>
-  <pre><code>from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+  <pre><code>from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 engine = Engine(1280, 720, "Hello")
 scene = Scene("Main")
 cam = Camera(position=(0, 2, 8), yaw=-90)
 scene.set_main_camera(cam)
+
 cube = Entity("Cube")
 cube.add_component(Transform(position=(0, 1, 0)))
-m = Material(); m.albedo[:] = (0.3, 0.8, 0.4)
-cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=m))
+mat = Material()
+mat.albedo[:] = (0.3, 0.8, 0.4)
+cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
 scene.spawn(cube)
+
 engine.load_scene(scene)
 engine.run()</code></pre></div>
 
@@ -73,6 +78,13 @@ engine.run()</code></pre></div>
 
   <div class="tip">After install, run <code>python -c "from aether import Engine; print('OK')"</code>.
   If you see <code>OK</code>, the engine is ready.</div>
+
+  <h2>Window &amp; audio stack</h2>
+  <div class="callout">
+    <strong>GLFW</strong> owns the game window, input, and OpenGL 4.6 context.<br>
+    <strong>pygame-ce</strong> is used only as an audio mixer (<code>pygame.mixer</code>) — the display module is never initialized.
+    No context conflicts, lower overhead than running two window backends.
+  </div>
 </section>
 """,
     "concepts": """
@@ -116,6 +128,13 @@ scene.spawn(player)</code></pre>
 engine.on_update(update)
 engine.run()   # blocks until ESC</code></pre>
   <div class="tip"><code>dt</code> is delta time. Multiply movement by <code>dt</code> so speed stays the same on all FPS.</div>
+
+  <h2>Physics (2D ready out of the box)</h2>
+  <div class="callout">
+  <strong>2D physics is built in</strong> via <code>engine.physics2d</code> (pymunk backend).
+  See <a href="/physics">Physics</a> and run <code>examples/04_physics2d.py</code>.
+  </div>
+  <p>3D physics uses a lightweight in-engine solver today. PyBullet / Jolt integration is planned for a future major release.</p>
 </section>
 """,
     "quickstart": """
@@ -123,8 +142,10 @@ engine.run()   # blocks until ESC</code></pre>
   <h1>Quick Start — first 3D scene</h1>
   <p class="lead">Copy this into <code>my_game.py</code> and run <code>python my_game.py</code>.</p>
 
-  <pre><code>from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+  <pre><code>from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 # 1) Create engine and scene
 engine = Engine(1280, 720, "Hello Aether")
@@ -247,27 +268,44 @@ engine.on_update(update)</code></pre>
 <section>
   <h1>Physics</h1>
 
-  <h2>3D — bodies and raycasts</h2>
-  <pre><code>from aether.physics import BoxCollider
+  <div class="callout">
+  <strong>2D physics — available now.</strong>
+  Aether Engine ships with full <code>engine.physics2d</code> powered by <strong>pymunk</strong>.
+  Run the ready-made demo: <code>python examples/04_physics2d.py</code>
+  </div>
+
+  <h2>2D — pymunk (<code>engine.physics2d</code>)</h2>
+  <pre><code>engine.set_mode("2d")
+pw = engine.physics2d
+
+ground = pw.create_box(0, -200, 600, 40, static=True)
+ball = pw.create_circle(0, 0, 20, mass=1.0)
+pw.apply_impulse(ball, 300, 0)
+
+# Sync sprite position each frame
+sprite.x, sprite.y = ball.x, ball.y</code></pre>
+
+  <h3>Coordinate system</h3>
+  <p>Aether uses <strong>Y-up</strong> for both pymunk and <code>Renderer2D</code> — same origin convention, no flip needed.
+  Gravity defaults to <code>(0, -980)</code> (downward). Camera center follows world units; see <code>examples/04_physics2d.py</code>.</p>
+
+  <h2>3D — lightweight built-in solver</h2>
+  <div class="tip">
+  <strong>Status:</strong> 3D physics currently runs on Aether's own lightweight solver (gravity, boxes, spheres, raycasts).
+  <strong>PyBullet / Jolt</strong> integration is planned for upcoming major releases — not in 1.7.x yet.
+  </div>
+  <pre><code>from aether import BoxCollider
 
 body = engine.physics3d.create_body_for_entity(
     entity, mass=1.0, collider=BoxCollider(size=(1, 1, 1))
 )
 body.velocity[:] = (0, 4, 0)
 
-# Shoot a ray from camera
 origin = camera.position
 direction = camera.front
 hit = engine.physics3d.raycast(origin, direction, max_distance=100)
 if hit:
     print("Hit at distance", hit["distance"])</code></pre>
-
-  <h2>2D — pymunk</h2>
-  <pre><code>pw = engine.physics2d
-ground = pw.create_box(0, -200, 600, 40, static=True)
-ball = pw.create_circle(0, 0, 20, mass=1.0)
-pw.apply_impulse(ball, 300, 0)</code></pre>
-  <div class="tip">2D coordinates: X right, Y up. Gravity defaults to downward.</div>
 </section>
 """,
     "models": """
@@ -275,8 +313,7 @@ pw.apply_impulse(ball, 300, 0)</code></pre>
   <h1>Loading 3D Models</h1>
   <p class="lead">Install model support: <code>pip install aether-engine[models]</code></p>
 
-  <pre><code>from aether import ModelLoader, Entity, Material
-from aether.scene.component import Transform, MeshRenderer
+  <pre><code>from aether import ModelLoader, Entity, Material, Transform, MeshRenderer
 
 mesh = ModelLoader.load("assets/character.glb")
 
@@ -323,8 +360,7 @@ hero = Sprite.from_image("sprites/hero.png", x=0, y=0)
 engine.renderer2d.add_sprite(hero)</code></pre>
 
   <h2>3D models</h2>
-  <pre><code>from aether import Entity, Material
-from aether.scene.component import Transform, MeshRenderer
+  <pre><code>from aether import Entity, Material, AssetLoader, Transform, MeshRenderer
 
 mesh = AssetLoader.load_model("models/character.glb")
 ent = Entity("Hero")
@@ -401,27 +437,69 @@ aether build my_game.py --name MyGame --console</code></pre>
     "architecture": """
 <section>
   <h1>Engine Architecture</h1>
-  <pre><code>Engine -> Window, Input, Renderer3D, Renderer2D, Physics, Audio, Scene
-Scene -> Entity -> Components</code></pre>
-  <p>Boot splash runs once at startup. Optional Rust accelerators with Python fallback.</p>
+  <pre><code>Engine -> Window (GLFW), Input, Renderer3D, Renderer2D, Physics, Audio, Scene
+Scene -> Entity -> Components (Transform, MeshRenderer, …)</code></pre>
+
+  <h2>Window &amp; audio (no pygame display)</h2>
+  <div class="callout">
+  <strong>GLFW</strong> fully manages the window, input, and OpenGL 4.6 context.<br>
+  <strong>pygame-ce</strong> is used exclusively as an advanced audio mixer (<code>pygame.mixer</code>) — the display module is never initialized.
+  </div>
+
+  <h2>Physics</h2>
+  <ul class="checklist">
+    <li><strong>2D:</strong> <code>engine.physics2d</code> + pymunk — production-ready, see <code>examples/04_physics2d.py</code></li>
+    <li><strong>3D:</strong> lightweight built-in solver (prototypes / simple games)</li>
+    <li><strong>Roadmap:</strong> PyBullet or Jolt in a future major release</li>
+  </ul>
+
+  <p>Boot splash runs once at startup. Optional Rust accelerators with Python fallback (<code>backend_name()</code>).</p>
 </section>
 """,
     "performance": """
 <section>
   <h1>Performance</h1>
+  <p class="lead">Aether is a single-threaded Python game loop. Heavy work is pushed into native code where possible.</p>
+
+  <h2>Python GIL — what actually runs outside it</h2>
+  <table class="data">
+    <tr><th>Subsystem</th><th>How it helps</th></tr>
+    <tr><td>OpenGL (PyOpenGL)</td><td>GPU does rasterization; CPU uploads buffers once per mesh</td></tr>
+    <tr><td>NumPy</td><td>Vertex/index arrays stored as contiguous buffers; math runs in C</td></tr>
+    <tr><td>trimesh</td><td>Model import (GLB/OBJ/FBX…) triangulates in native code — pay once at load time</td></tr>
+    <tr><td>pymunk</td><td>2D physics simulation in C; good for platformers</td></tr>
+    <tr><td>Rust accelerators (optional)</td><td>Chunked voxel meshing, NPC helpers — <code>backend_name()</code> returns <code>rust</code> or <code>python</code></td></tr>
+  </table>
+  <p>The main loop (input → update → draw) stays on one thread — same model as most indie engines. Profile before adding threads.</p>
+
+  <h2>Mesh loading &amp; runtime cost</h2>
   <ul class="checklist">
-    <li>Use ChunkedVoxelMesher for editable block worlds</li>
-    <li>Reuse materials and meshes</li>
-    <li>Merge static geometry for many identical props</li>
-    <li>Keep draw_hud=False unless needed</li>
+    <li><strong>Load time:</strong> trimesh + NumPy convert files to GPU-ready buffers — complex GLB is fine if you load at startup</li>
+    <li><strong>Runtime:</strong> cost is draw calls, not Python per-vertex math</li>
+    <li><strong>Voxels:</strong> use <code>ChunkedVoxelMesher</code> — only dirty 16³ chunks rebuild</li>
+    <li><strong>Props:</strong> reuse <code>Material</code> and <code>Mesh</code> instances; merge static geometry</li>
+    <li><strong>HUD:</strong> keep <code>draw_hud=False</code> unless you need overlay</li>
   </ul>
+
+  <h2>Physics roadmap</h2>
+  <table class="data">
+    <tr><th>Mode</th><th>Status</th></tr>
+    <tr><td>2D (pymunk)</td><td><strong>Available now</strong> — <code>engine.physics2d</code>, see <a href="/physics">Physics</a> and <code>examples/04_physics2d.py</code></td></tr>
+    <tr><td>3D (built-in)</td><td>Lightweight custom solver — gravity, AABB/sphere, good for prototypes</td></tr>
+    <tr><td>3D (PyBullet / Jolt)</td><td>Planned integration — not in 1.7.x yet</td></tr>
+  </table>
+
+  <h2>Audio vs window</h2>
+  <p><strong>GLFW</strong> owns the game window, input, and OpenGL context.<br>
+  <strong>pygame-ce</strong> is used only for <code>pygame.mixer</code> (SFX + music) — no pygame display, no conflict with GLFW.</p>
+
+  <h2>Rough benchmarks (GTX 1050 class)</h2>
   <table class="data">
-    <tr><th>Scenario</th><th>GTX 1050 class</th></tr>
-    <tr><td>Simple 3D scene</td><td>60+ FPS</td></tr>
-    <tr><td>Chunked voxel edits</td><td>Stable FPS vs full rebuild</td></tr>
-    <tr><td>1000+ unique draw calls</td><td>Consider merging meshes</td></tr>
+    <tr><th>Scenario</th><th>Typical result</th></tr>
+    <tr><td>Simple 3D scene (few meshes)</td><td>60+ FPS</td></tr>
+    <tr><td>Chunked voxel edits</td><td>Stable vs full-world rebuild</td></tr>
+    <tr><td>1000+ separate draw calls</td><td>Merge meshes or batch</td></tr>
   </table>
-  <p>3D physics: built-in solver. 2D: pymunk. EXE build: Windows via PyInstaller (Linux/macOS: run from Python).</p>
 </section>
 """,
 }

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether/web/plain_content.py

@@ -22,8 +22,10 @@ pip install -U "aether-engine[full]"
 
 ## Minimal example
 ```python
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 engine = Engine(1280, 720, "My Game")
 scene = Scene("Main")
@@ -32,7 +34,8 @@ scene.set_main_camera(camera)
 
 cube = Entity("Cube")
 cube.add_component(Transform(position=(0, 1, 0)))
-mat = Material(); mat.albedo[:] = (0.2, 0.9, 0.4)
+mat = Material()
+mat.albedo[:] = (0.2, 0.9, 0.4)
 cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
 scene.spawn(cube)
 
@@ -65,6 +68,10 @@ pip install -U "aether-engine[full]"
 
 ## Verify
 python -c "from aether import Engine; print('OK')"
+
+## Window & audio
+GLFW: window, input, OpenGL 4.6 context.
+pygame-ce: mixer only (SFX/music) — display module is NEVER initialized. No conflict with GLFW.
 """,
     "concepts": """
 ## Engine
@@ -84,6 +91,10 @@ Game object. Attach components for behavior.
 ## Loop
 engine.on_update(lambda dt: ...)
 engine.run()
+
+## Physics
+2D physics built in: engine.physics2d (pymunk). Demo: examples/04_physics2d.py
+3D: lightweight built-in solver. PyBullet/Jolt planned for future major release.
 """,
     "quickstart": """
 See home page minimal example. Controls: WASD move camera, Tab mouse look, ESC quit.
@@ -101,9 +112,20 @@ engine.renderer2d.add_sprite(Sprite(x, y, w, h, color=(r,g,b,a)))
 Sprite.from_image("icon.png") — load PNG/JPG/WebP as textured sprite
 """,
     "physics": """
-3D: engine.physics3d.create_body_for_entity(entity, mass=1, collider=BoxCollider(...))
-2D: engine.physics2d.create_box(x, y, w, h, static=False)
-Raycast: engine.physics3d.raycast(origin, direction, max_distance)
+2D PHYSICS — AVAILABLE NOW (pymunk via engine.physics2d)
+Run: python examples/04_physics2d.py
+
+engine.set_mode("2d")
+pw = engine.physics2d
+ground = pw.create_box(0, -200, 600, 40, static=True)
+ball = pw.create_circle(0, 0, 20, mass=1.0)
+sprite.x, sprite.y = ball.x, ball.y  # same Y-up coords, no flip
+
+3D PHYSICS — lightweight built-in solver (gravity, boxes, spheres, raycasts)
+PyBullet / Jolt integration planned for future major releases (not in 1.7.x)
+
+engine.physics3d.create_body_for_entity(entity, mass=1, collider=BoxCollider(...))
+engine.physics3d.raycast(origin, direction, max_distance)
 """,
     "models": """
 pip install aether-engine[models]
@@ -145,22 +167,41 @@ examples/03_first_person.py — FPS
 examples/04_physics2d.py — 2D physics
 """,
     "architecture": """
-Engine -> Window, Input, Renderer3D, Renderer2D, Physics3D, Physics2D, Audio, Scene
+Engine -> GLFW (window/input/OpenGL), Renderer3D, Renderer2D, Physics3D, Physics2D, Audio, Scene
 Scene -> Entity -> Components
+
+Window/audio split:
+- GLFW: full window + OpenGL 4.6 + input
+- pygame-ce: pygame.mixer ONLY (no display init)
+
+Physics:
+- 2D: engine.physics2d + pymunk (ready, examples/04_physics2d.py)
+- 3D: lightweight built-in solver; PyBullet/Jolt planned
+
 Optional Rust accelerators with Python fallback (backend_name()).
 """,
     "performance": """
-## Tips
-- Use ChunkedVoxelMesher for editable block worlds (not full mesh rebuild per block).
-- Reuse Material and Mesh instances across entities.
-- Keep draw_hud=False unless HUD is needed.
-- physics3d fixed timestep via engine config.
-
-## Typical scale (GTX 1050 class)
-- Thousands of static cubes: OK with chunked meshing
-- Hundreds of separate draw calls without batching: may drop below 60 FPS
-- Instancing for identical meshes: planned; merge static geometry where possible
+## GIL and native backends
+- Main loop: single-threaded Python (input -> update -> draw)
+- OpenGL: GPU rasterization; CPU uploads vertex buffers
+- NumPy: mesh data in contiguous C arrays
+- trimesh: model import triangulation in native code (cost at load time, not every frame)
+- pymunk: 2D physics in C (available now via engine.physics2d)
+- Optional Rust accelerators: ChunkedVoxelMesher, NPC helpers (backend_name())
+
+## Physics roadmap
+- 2D: pymunk — available (examples/04_physics2d.py)
+- 3D: lightweight built-in solver (prototypes)
+- 3D PyBullet/Jolt: planned, not in 1.7.x
+
+## Audio vs window
+- GLFW: window, input, OpenGL
+- pygame-ce: mixer only (SFX/music), no pygame display
 
-Physics 3D: lightweight custom solver. Physics 2D: pymunk.
+## Tips
+- ChunkedVoxelMesher for block worlds
+- Reuse Material/Mesh instances
+- Merge static geometry to cut draw calls
+- draw_hud=False unless needed
 """,
 }

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether/web/templates.py

@@ -89,9 +89,9 @@ h3 { font-size: 1rem; margin: 1rem 0 0.4rem; color: #ddd; }
   padding: 1rem 1.15rem; margin: 0.85rem 0; }
 .step-num { color: var(--accent2); font-weight: 700; font-size: 0.75rem; text-transform: uppercase; }
 pre { background: rgba(0,0,0,0.42); border: 1px solid var(--border); border-radius: 10px;
-  padding: 0.9rem; overflow-x: auto; margin: 0.65rem 0; }
+  padding: 0.9rem; overflow-x: auto; margin: 0.65rem 0; white-space: pre; }
 code { font-family: Consolas, monospace; font-size: 0.86rem; }
-pre code { color: #c5e8ff; }
+pre code { color: #c5e8ff; white-space: pre; }
 .grid-2 { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 0.85rem; }
 .card { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 1rem; }
 .checklist { list-style: none; margin: 0.5rem 0; }
@@ -103,6 +103,9 @@ table.data th { background: var(--card); }
 .muted { color: var(--muted); font-size: 0.88rem; }
 .tip { border-left: 3px solid var(--accent2); padding: 0.6rem 0.9rem; margin: 0.75rem 0;
   background: rgba(0,212,170,0.06); border-radius: 0 8px 8px 0; }
+.callout { border: 1px solid var(--accent2); background: rgba(0,212,170,0.1); border-radius: 10px;
+  padding: 0.85rem 1rem; margin: 1rem 0; font-weight: 600; line-height: 1.5; }
+.callout strong { color: var(--accent2); }
 footer { margin-top: 2.5rem; padding-top: 1rem; border-top: 1px solid var(--border);
   font-size: 0.78rem; color: var(--muted); }
 @media (max-width: 768px) { .layout { flex-direction: column; } .sidebar { width: 100%; height: auto; position: relative; } }

{aether_engine-1.7.0 → aether_engine-1.7.1/aether_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aether-engine
-Version: 1.7.0
+Version: 1.7.1
 Summary: 3D/2D game engine by entiti937 — OpenGL, physics, FPS, mandatory branding splash
 Home-page: https://pypi.org/project/aether-engine/
 Author: entiti937
@@ -31,13 +31,13 @@ Requires-Dist: trimesh>=3.21; extra == "models"
 Provides-Extra: build
 Requires-Dist: pyinstaller>=6.0; extra == "build"
 Provides-Extra: full
-Requires-Dist: freetype-py>=2.4; extra == "full"
-Requires-Dist: imageio>=2.31; extra == "full"
+Requires-Dist: pyinstaller>=6.0; extra == "full"
 Requires-Dist: pygame-ce>=2.5; extra == "full"
-Requires-Dist: pyyaml>=6.0; extra == "full"
+Requires-Dist: imageio>=2.31; extra == "full"
 Requires-Dist: trimesh>=3.21; extra == "full"
 Requires-Dist: pymunk>=6.0; extra == "full"
-Requires-Dist: pyinstaller>=6.0; extra == "full"
+Requires-Dist: pyyaml>=6.0; extra == "full"
+Requires-Dist: freetype-py>=2.4; extra == "full"
 Dynamic: author
 Dynamic: classifier
 Dynamic: description
@@ -52,7 +52,7 @@ Dynamic: summary
 # Aether Engine
 
 **3D / 2D игровой движок на Python + OpenGL**  
-**Разработчик:** entiti937 · **Версия:** 1.7.0 · **Лицензия:** MIT  
+**Разработчик:** entiti937 · **Версия:** 1.7.1 · **Лицензия:** MIT  
 **PyPI:** https://pypi.org/project/aether-engine/
 
 > Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md)
@@ -65,6 +65,12 @@ Dynamic: summary
 pip install -U "aether-engine[full]"
 ```
 
+## Что нового в 1.7.1
+
+- Документация: 2D-физика (pymunk), статус 3D-солвера, GLFW vs pygame-ce
+- Единый импорт компонентов из `aether`
+- Расширен раздел Performance
+
 ## Что нового в 1.7.0
 
 - **AssetLoader** — загрузка любых моделей, спрайтов и текстур (OBJ/GLB/FBX/PNG/WebP/…)
@@ -95,8 +101,10 @@ aether website
 ## Минимальный код
 
 ```python
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 engine = Engine(1280, 720, "Game by you — engine by entiti937")
 scene = Scene("Main")
@@ -105,7 +113,8 @@ scene.set_main_camera(camera)
 
 cube = Entity("Cube")
 cube.add_component(Transform(position=(0, 1, 0)))
-mat = Material(); mat.albedo[:] = (0.2, 0.85, 1.0)
+mat = Material()
+mat.albedo[:] = (0.2, 0.85, 1.0)
 cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
 scene.spawn(cube)
 

{aether_engine-1.7.0 → aether_engine-1.7.1}/examples/01_hello_cube.py

@@ -5,8 +5,7 @@ ROOT = Path(__file__).resolve().parents[1]
 if str(ROOT) not in sys.path:
     sys.path.insert(0, str(ROOT))
 
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import Engine, Scene, Entity, Transform, MeshRenderer, MeshFactory, Material, Camera
 
 
 def make_mat(color):

{aether_engine-1.7.0 → aether_engine-1.7.1}/examples/02_sphere_scene.py

@@ -7,8 +7,7 @@ ROOT = Path(__file__).resolve().parents[1]
 if str(ROOT) not in sys.path:
     sys.path.insert(0, str(ROOT))
 
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import Engine, Scene, Entity, Transform, MeshRenderer, MeshFactory, Material, Camera
 
 
 def main():

{aether_engine-1.7.0 → aether_engine-1.7.1}/examples/03_first_person.py

@@ -14,13 +14,14 @@ from aether import (
     Engine,
     Scene,
     Entity,
+    Transform,
+    MeshRenderer,
     MeshFactory,
     Material,
     Camera,
     ModelLoader,
     BoxCollider,
 )
-from aether.scene.component import Transform, MeshRenderer
 
 
 def make_mat(color, metallic=0.1, roughness=0.5):

{aether_engine-1.7.0 → aether_engine-1.7.1}/setup.py

@@ -72,7 +72,7 @@ extras_require = {
 
 setup(
     name="aether-engine",
-    version="1.7.0",
+    version="1.7.1",
     author="entiti937",
     description="3D/2D game engine by entiti937 — OpenGL, physics, FPS, mandatory branding splash",
     long_description=long_description,

{aether_engine-1.7.0 → aether_engine-1.7.1}/aether_engine.egg-info/requires.txt

@@ -10,13 +10,13 @@ pygame-ce>=2.5
 pyinstaller>=6.0
 
 [full]
-freetype-py>=2.4
-imageio>=2.31
+pyinstaller>=6.0
 pygame-ce>=2.5
-pyyaml>=6.0
+imageio>=2.31
 trimesh>=3.21
 pymunk>=6.0
-pyinstaller>=6.0
+pyyaml>=6.0
+freetype-py>=2.4
 
 [models]
 trimesh>=3.21