v1.2.1

Author: bochkarnikov-victor

CHANGELOG.md

@@ -13,6 +13,30 @@
 - Система частиц
 - Мобильная поддержка
 
+## [1.2.1]
+
+### Added
+- 🧭 **Debug HUD**: FPS и координаты камеры
+- 🧾 **Логи**: уровни (info/warning/error/custom), источник вызова, запись в файл
+- 🖱️ **Debug camera input**: управление камерой кнопкой мыши (или None)
+- ⚓ **Sprite.anchor**: смена якоря без смещения позиции
+- 📄 **Pages API**: страницы умеют управлять спрайтами
+- 🎮 **EventBus Demo**: показ подписки на события и таймеры
+- 📣 **Стартовый лог**: приветственное сообщение с ссылкой на репозиторий
+
+### Changed
+- 🧩 **Debug overlay**: сетка и HUD могут рисоваться поверх или под сценой
+- 🧭 **Сетка**: шаг 100 по умолчанию, подписи во всех ячейках
+- 🛠️ **Шаблон проекта**: debug включён по умолчанию, стартовый лог
+- 🔧 **Anchor/FillDirection**: переведены на Enum без поломки старого API
+- 🧩 **Pages demo**: сцены и страницы с авто-спрайтами
+- 📚 **README**: полный список ссылок на всю документацию
+- 🧪 **Reactive example**: добавлен пример с Blinker
+
+### Fixed
+- 🏓 **Ping Pong**: очки начисляются корректной стороне
+- 🖼️ **Sprite.set_image**: пустая строка не вызывает предупреждение
+
 ## [1.2.0] - 2026-01-18
 
 ### Added

DOCUMENTATION_INDEX.md

@@ -95,6 +95,11 @@
 - Колбэки начала/конца
 - Возврат на место
 
+#### [docs/pages.md](docs/pages.md)
+**Pages**
+- Страницы и менеджер страниц
+- Автовключение/выключение спрайтов
+
 ### Игровые системы
 
 #### [docs/animation.md](docs/animation.md)
@@ -258,6 +263,7 @@
 - [docs/game_loop.md](docs/game_loop.md)
 - [docs/input.md](docs/input.md)
 - [docs/debug.md](docs/debug.md)
+- [docs/pages.md](docs/pages.md)
 
 #### 📋 Планирование и разработка
 - [ROADMAP.md](ROADMAP.md)

README.md

@@ -465,17 +465,20 @@ python spritePro/demoGames/ping_pong.py
 ### 🚀 Быстрый старт
 - [Установка и настройка](#-быстрый-старт-30-секунд)
 - [Базовый пример](#ваша-первая-игра-5-строк)
-
-### 📚 Полная документация
-- [📖 Индекс документации](DOCUMENTATION_INDEX.md) - Все модули и компоненты
-- [🎮 Sprite](docs/sprite.md) - Базовый класс спрайта
-- [🎨 UI компоненты](docs/button.md) - Кнопки, переключатели, текст
-- [🎬 Анимации](docs/animation.md) - Система анимаций
-- [✨ Tweening](docs/tween.md) - Плавные переходы
-- [💥 Частицы](docs/particles.md) - Система частиц
-- [🎵 Аудио](docs/audio.md) - AudioManager
-- [💾 Сохранения](docs/save_load.md) - PlayerPrefs
-- [📊 Полосы прогресса](docs/bar.md) - Bar компоненты
+- [Быстрый старт 2.0](#-быстрый-старт-20-шаблон-проекта)
+
+### 📚 Индексы
+- [📖 Индекс документации](DOCUMENTATION_INDEX.md) - Полный список модулей
+- [📘 Документация папки docs](docs/README.md) - Навигация по разделам
+
+### 🧩 Полный список документации
+- Основы: [Game Loop](docs/game_loop.md) • [Input](docs/input.md) • [Debug](docs/debug.md) • [Camera & Particles](docs/camera_and_particles.md)
+- Спрайты и графика: [Sprite](docs/sprite.md) • [Surface](docs/surface.md) • [Text](docs/text.md) • [Text FPS](docs/text_fps.md) • [Color Effects](docs/color_effects.md) • [ReadySprites](docs/readySprites.md)
+- UI: [Button](docs/button.md) • [Toggle Button](docs/toggle_button.md) • [Bar](docs/bar.md) • [Bar Background](docs/bar_background.md) • [Pages](docs/pages.md)
+- Компоненты: [Animation](docs/animation.md) • [Tween](docs/tween.md) • [Timer](docs/timer.md) • [Health](docs/health.md) • [Mouse Interactor](docs/mouse_interactor.md) • [Draggable Sprite](docs/draggable_sprite.md)
+- Эффекты и частицы: [Particles](docs/particles.md)
+- Аудио: [Audio](docs/audio.md)
+- Сохранения и утилиты: [Save/Load](docs/save_load.md)
 
 ---
 

create_project.py

@@ -16,7 +16,7 @@ def on_enter(self, context):
         def update(self, dt):
             self.player.handle_keyboard_input()
             if s.input.was_pressed(pygame.K_SPACE):
-                print("Space pressed")
+                s.debug_log_info("Space pressed")
 
 
     def main():
@@ -52,7 +52,9 @@ def main() -> None:
     args = parser.parse_args()
 
     create_project(Path(args.name))
-    print(f"Project created at: {Path(args.name).resolve()}")
+    import logging
+    logging.basicConfig(level=logging.INFO, format="%(message)s")
+    logging.info("Project created at: %s", Path(args.name).resolve())
 
 
 if __name__ == "__main__":

demo_game_new_api.py

@@ -9,7 +9,7 @@ def on_enter(self, context):
     def update(self, dt):
         self.player.handle_keyboard_input()
         if s.input.was_pressed(pygame.K_SPACE):
-            print("Space pressed")
+            s.debug_log_info("Space pressed")
 
 
 def main():

docs/README.md

@@ -28,6 +28,9 @@ SpritePro состоит из нескольких основных модуле
 #### [DraggableSprite](draggable_sprite.md)
 Drag-and-drop компонент на базе Sprite с колбэками и возвратом на место.
 
+#### [Pages](pages.md)
+Система страниц (Page/PageManager) для UI и экранов внутри сцены.
+
 ### Игровые системы
 
 #### [Animation](animation.md)
@@ -92,6 +95,7 @@ InputState в стиле Unity и EventBus для подписки на собы
 - [Timer](timer.md) - Управление временем
 - [Health](health.md) - Система здоровья
 - [Debug Overlay](debug.md) - Отладочная сетка и логи
+- [Pages](pages.md) - Страницы и менеджер страниц
 
 **Вспомогательные инструменты:**
 - [Surface](surface.md) - Операции с поверхностями

docs/debug.md

@@ -1,23 +1,24 @@
 # Debug Overlay
 
-Debug Overlay — встроенная визуализация для разработки: сетка мира, координаты камеры и отладочные логи.
+Debug Overlay — встроенная визуализация для разработки: сетка мира, координаты камеры/точки/мыши, HUD и отладочные логи.
 
 ## Быстрый старт
 
 ```python
 import spritePro as s
 
 s.enable_debug(True)
-s.set_debug_grid(size=80, label_every=2)
+s.set_debug_grid(size=100, label_every=1)
 s.set_debug_log_anchor("bottom_left")
 s.debug_log_info("Debug enabled")
 ```
 
 ## Возможности
 
-- Сетка мира (не привязана к камере)
-- Координаты камеры и точка в центре экрана
-- Логи в углу экрана с авто‑исчезновением
+- Сетка мира (можно поверх/под сценой)
+- HUD с координатами камеры и FPS
+- Координаты точки центра и позиции мыши в мире
+- Логи в углу экрана с авто‑исчезновением и записью в файл
 
 ## API (через spritePro)
 
@@ -35,7 +36,7 @@ s.debug_log_info("Debug enabled")
 - `s.set_debug_log_anchor("top_left" | "top_right" | "bottom_left" | "bottom_right")`
 
 ### Сетка
-- `s.set_debug_grid(size=None, color=None, alpha=None, label_every=None, label_color=None, labels_enabled=None)`
+- `s.set_debug_grid(size=None, color=None, alpha=None, label_every=None, label_color=None, labels_enabled=None, label_limit=None, label_font_size=None, on_top=None)`
 - `s.set_debug_grid_enabled(True/False)`
 
 ### Стиль и файл логов
@@ -45,20 +46,22 @@ s.debug_log_info("Debug enabled")
 - `s.set_debug_log_palette(info=None, warning=None, error=None)`
 - `s.set_debug_log_prefixes(info=None, warning=None, error=None)`
 - `s.set_debug_log_stack_enabled(True/False)`
-- `s.set_debug_hud_style(font_size=None, color=None, padding=None, anchor=None)`
+- `s.set_console_log_enabled(True/False)`
+- `s.set_debug_hud_style(font_size=None, color=None, padding=None, anchor=None, on_top=None)`
 - `s.set_debug_hud_enabled(show_fps=None, show_camera=None)`
 - `s.set_debug_camera_input(mouse_button)`
 
 ## Параметры сетки
 
 ```python
 s.set_debug_grid(
-    size=64,            # шаг сетки
+    size=100,           # шаг сетки
     color=(80, 80, 80), # цвет линий
     alpha=120,          # прозрачность (0..255)
-    label_every=2,      # подписи через N линий
+    label_every=1,      # подписи через N линий
     label_color=(140, 140, 140),
     labels_enabled=True,
+    on_top=False,       # рисовать поверх сцены
 )
 ```
 

docs/input.md

@@ -44,10 +44,16 @@ def on_quit(event):
 def on_key_down(key, event):
     print("Key down:", key)
 
-s.events.on("quit", on_quit)
-s.events.on("key_down", on_key_down)
+s.events.connect("quit", on_quit)
+s.events.connect("key_down", on_key_down)
 ```
 
+Полезные методы:
+- `connect(event_name, handler)`
+- `disconnect(event_name, handler=None)`
+- `send(event_name, **payload)`
+- `disconnect_all(event_name=None)`
+
 Доступные события:
 - `quit`
 - `key_down`, `key_up`

docs/pages.md

@@ -0,0 +1,54 @@
+# Pages
+
+`Page` и `PageManager` — лёгкая система экранов внутри сцены.  
+Страница хранит список спрайтов и сама включает/выключает их без лишнего кода.
+
+## Быстрый старт
+
+```python
+import spritePro as s
+
+class MenuPage(s.Page):
+    def __init__(self, scene=None):
+        super().__init__("menu", scene=scene)
+        self.add_sprite(s.TextSprite("Menu", 48, pos=(400, 40), scene=scene))
+        self.add_sprite(s.Button(text="Start", pos=(400, 300)))
+
+class GamePage(s.Page):
+    def __init__(self, scene=None):
+        super().__init__("game", scene=scene)
+        self.add_sprite(s.TextSprite("Game", 48, pos=(400, 40), scene=scene))
+
+class PagesScene(s.Scene):
+    def __init__(self):
+        super().__init__()
+        self.pages = s.PageManager(scene=self)
+        self.pages.add_page(MenuPage(scene=self))
+        self.pages.add_page(GamePage(scene=self))
+        self.pages.set_active_page("menu")
+
+    def update(self, dt):
+        self.pages.update()
+```
+
+## API
+
+### Page
+- `Page(name, scene=None)` — создаёт страницу.
+- `set_active(True/False)` — включает/выключает страницу (спрайты тоже).
+- `add_sprite(sprite, use_scene=True)` — добавляет спрайт на страницу.
+- `add_sprites(*sprites, use_scene=True)` — добавить несколько спрайтов.
+- `remove_sprite(sprite)` — удалить спрайт со страницы.
+- `is_active()` — активна ли страница.
+
+### PageManager
+- `PageManager(scene=None)` — менеджер страниц.
+- `add_page(page)` — добавить страницу.
+- `set_active_page(name)` — активировать страницу.
+- `get_active_page()` — активная страница.
+- `set_scene(scene)` — назначить сцену всем страницам.
+- `update()` — обновить активную страницу.
+
+## Примечания
+- Если `scene` задана, `add_sprite()` автоматически привяжет спрайт к этой сцене.
+- Страницы можно использовать и без сцен — тогда просто управляется активность спрайтов.

docs/particles.md

@@ -67,8 +67,44 @@ SpritePro включает легковесную систему частиц, 
 
 - `emit(position: Optional[Tuple[float, float] | Vector2] = None, overrides: Optional[ParticleConfig] = None) -> Sequence[Particle]`: Выпустить частицы. Если `position` не указан, используется позиция, установленная через `set_position()`
 - `set_position(position: Tuple[float, float] | Vector2, anchor: str | Anchor = Anchor.CENTER)`: Установить позицию эмиттера для последующих вызовов `emit()` без аргументов
+- `set_parent(parent, keep_world_position=True, follow_parent=True)`: Назначить родителя для создаваемых частиц
 - `get_position() -> Optional[Tuple[float, float] | Vector2]`: Получить текущую позицию эмиттера
 - `update_config(**kwargs)`: Обновить конфигурацию эмиттера с заданными значениями
+- `set_config(config: ParticleConfig)`: Полностью заменить конфигурацию эмиттера
+- `start_auto_emit()` / `stop_auto_emit()`: Включить/выключить авто-эмиссию
+- `update(dt: Optional[float] = None)`: Обновление авто-эмиссии (нужно для auto_emit)
+
+### Авто-эмиссия (loop/interval/step)
+
+`ParticleEmitter` умеет автоматически вызывать `emit()` по времени и/или по дистанции.
+
+Параметры конструктора:
+- `auto_emit` (bool): включить авто-эмиссию
+- `emit_interval` (float | tuple): интервал или диапазон (от, до)
+- `emit_step` (float): шаг по расстоянию (0 = отключено)
+- `use_dt` (bool): использовать `dt` из update (True) или глобальное время (False)
+- `auto_register` (bool): авто-регистрация в `spritePro.update()`
+
+Пример: случайный интервал
+```python
+emitter = s.ParticleEmitter(
+    s.template_trail(),
+    auto_emit=True,
+    emit_interval=(0.05, 0.15),
+    auto_register=True,
+)
+```
+
+Пример: эмиссия по шагам расстояния
+```python
+emitter = s.ParticleEmitter(
+    s.template_sparks(),
+    auto_emit=True,
+    emit_step=20,
+    auto_register=True,
+)
+emitter.set_position(player.rect.center)  # обновлять позицию каждый кадр
+```
 
 ## Particle