v1.4.0

Author: bochkarnikov-victor

CHANGELOG.md

@@ -11,6 +11,40 @@
 - Продвинутые UI компоненты
 - Мобильная поддержка
 
+## [1.4.0] - 2025-02-12
+
+### Added
+- **Fluent Tween API (Do-твины)**: удобный цепочечный API в стиле DOTween.
+  - Методы на **Sprite**: `DoMove`, `DoMoveBy`, `DoScale`, `DoScaleBy`, `DoRotate`, `DoRotateBy`, `DoColor`, `DoAlpha`, `DoFadeIn`, `DoFadeOut`, `DoSize`, `DoPunchScale`, `DoShakePosition`, `DoShakeRotation`, `DoBezier` — по умолчанию `Ease.OutQuad`, автоудаление по завершении.
+  - **TweenHandle**: цепочка `SetEase`, `SetDelay`, `OnComplete`, `SetLoops`, `SetYoyo`, `Kill(complete=False|True)`.
+  - **Ease**: enum с именами In/Out/InOut по кривым (OutQuad, InCubic, InOutSine и др.), альтернатива `EasingType`.
+  - Зацикливание: режим reset по умолчанию, `SetYoyo(True)` для движения туда-обратно; при завершении (если не loop) твин сам снимается с обновления.
+- **Tween**: параметр `auto_remove_on_complete`; `stop(apply_end, call_on_complete)` для `Kill(complete=True)`; `set_easing()`; в пресетах — параметр `auto_remove_on_complete`.
+- **Демо**: `spritePro/demoGames/fluent_tween_demo.py` — примеры Do*, цепочки, циклы 8/9/0, Kill.
+- **Документация**: раздел «Fluent API (Do-твины)» в [docs/tween.md](docs/tween.md), таблицы методов Do* и TweenHandle, обновлены README и docs/README.md.
+- **Крестики-нолики (мультиплеер)**: анимации на Fluent Tween — появление символа в ячейке (DoPunchScale), пульс по выигрышной линии, отдача кнопки «Новая игра».
+
+### Changed
+- Версия библиотеки 1.4.0 (минор).
+
+## [1.3.4]
+
+### Added
+- **Модуль layout** (`spritePro.layout`): автолейаут для дочерних спрайтов.
+  - **Layout** наследует **Sprite**: лейаут можно перемещать; при `container=None` лейаут сам является контейнером (параметры size, pos, scene), дети при add/remove привязываются через set_parent.
+  - **LayoutDirection**: FLEX_ROW, FLEX_COLUMN, HORIZONTAL, VERTICAL, GRID, CIRCLE, LINE.
+  - **LayoutAlignMain** / **LayoutAlignCross**: выравнивание (START, CENTER, END, SPACE_BETWEEN, SPACE_AROUND, SPACE_EVENLY).
+  - **GridFlow**: ROW, COLUMN для сетки.
+  - Контейнер: Sprite, (x, y, w, h) или None (лейаут-спрайт как контейнер). Список расставляемых детей — **arranged_children**.
+  - Удобные функции: layout_flex_row, layout_flex_column, layout_horizontal, layout_vertical, layout_grid, layout_circle, layout_line.
+  - Авто-обновление при add/remove детей; ручной refresh/apply при смене параметров или типа.
+  - Для CIRCLE: rotate_children и offset_angle. gap и padding как число или кортеж.
+- **docs/layout.md**: описание API, Layout как Sprite, container=None, arranged_children, use_local, пример «лейаут как перемещаемый блок».
+- **spritePro/demoGames/layout_demo.py**: демо всех типов лейаута (FLEX_ROW, FLEX_COLUMN, GRID, HORIZONTAL, VERTICAL, CIRCLE, LINE).
+
+### Changed
+- Версия библиотеки 1.3.4 (минор).
+
 ## [1.3.3]
 
 ### Added

DOCUMENTATION_INDEX.md

@@ -11,6 +11,12 @@
 - Примеры использования
 - Ссылки на всю документацию
 
+### [docs/OVERVIEW.md](docs/OVERVIEW.md) 📋
+**Краткий обзор SpritePro**
+- Layout, мультиплеер, основные подсистемы
+- Таблицы типов лейаутов, API
+- Полезные пути и команды запуска демо
+
 ### [ROADMAP.md](ROADMAP.md) 🗺️
 **План развития проекта**
 - Краткосрочные цели (v1.1 - v1.3)
@@ -100,6 +106,11 @@
 - Страницы и менеджер страниц
 - Автовключение/выключение спрайтов
 
+#### [docs/layout.md](docs/layout.md)
+**Layout**
+- Автолейаут: flex, сетка, окружность, линия
+- Контейнер — спрайт, rect или сам лейаут
+
 ### Игровые системы
 
 #### [docs/animation.md](docs/animation.md)
@@ -110,14 +121,14 @@
 
 #### [docs/tween.md](docs/tween.md)
 **Плавные переходы**
-- Easing функции
+- Easing функции (EasingType, Ease)
 - Анимация свойств
 - Цепочки анимаций
 
 #### [docs/tween_presets.md](docs/tween_presets.md)
-**Готовые твины**
+**Готовые твины и Fluent API**
 - Позиция, масштаб, поворот, цвет, прозрачность
-- Быстрые пресеты для спрайтов
+- **Fluent API** на Sprite: DoMove, DoScale, DoRotateBy, DoColor, DoFadeOut/In, SetEase, SetDelay, OnComplete, SetLoops, SetYoyo, Kill
 
 #### [docs/networking.md](docs/networking.md)
 **Networking**
@@ -153,6 +164,12 @@
 - Слои отрисовки (sorting_order)
 - Частицы на основе изображений, поворот и масштаб
 
+#### [docs/camera_and_particles.md](docs/camera_and_particles.md)
+**Камера и частицы**
+- Управление камерой и режим слежения
+- Система частиц и их конфигурация
+- Примеры использования
+
 #### [docs/bar.md](docs/bar.md)
 **Прогресс-бары**
 - Unity-style fillAmount функциональность
@@ -208,24 +225,16 @@
 - Настройка внешнего вида
 - Мониторинг производительности
 
-#### [docs/bar.md](docs/bar.md)
-**Прогресс-бары**
-- Unity-style fillAmount функциональность
-- 4 направления заполнения
-- Плавная анимация
-- Готовые к использованию компоненты
-
-#### [docs/bar_background.md](docs/bar_background.md)
-**Прогресс-бары с фоном**
-- Отдельные изображения для фона и заполнения
-- Фоновое изображение всегда видимо
-- Заполнение обрезается по направлению
-- Готовые к использованию компоненты
-
 ## 🎮 Демонстрационные игры
 
-
+- [Layout Demo](spritePro/demoGames/layout_demo.py) - Все типы лейаутов (flex, grid, circle, line)
+- [Menu/Shop Demo](spritePro/demoGames/menu_shop_demo.py) - Меню и инвентарь на Layout
+- [Fluent Tween Demo](spritePro/demoGames/fluent_tween_demo.py) - Fluent API: DoMove, DoScale, SetEase, SetLoops, OnComplete, Kill
+- [Tween Demo](spritePro/demoGames/tweenDemo.py) - Базовые твины
+- [Tween Presets Demo](spritePro/demoGames/tween_presets_demo.py) - Готовые пресеты твинов
 - [FPS Camera Demo](spritePro/demoGames/fps_camera_demo/fps_camera_demo.py) - Камера и FPS
+- [Local Multiplayer Demo](spritePro/demoGames/local_multiplayer_demo.py) - Сетевой мультиплеер
+- [TicTacToe Multiplayer](multiplayer_course/tictactoe_example/example_tictactoe_multiplayer.py) - Крестики-нолики по сети
 - [Save/Load Demo](spritePro/demoGames/save_load_demo.py) - Система сохранений
 - [Sorting Order Demo](spritePro/demoGames/sorting_order_demo.py) - Порядок отрисовки (слои)
 - [Particles Images Demo](spritePro/demoGames/particles_images_demo.py) - Частицы из изображений (c.png, platforma.png)
@@ -257,19 +266,21 @@
 - [docs/surface.md](docs/surface.md)
 - [docs/color_effects.md](docs/color_effects.md)
 - [docs/animation.md](docs/animation.md)
+- [docs/tween.md](docs/tween.md) — плавные переходы, Fluent API (DoMove, DoScale, ...)
 
 
 
 #### 🖱️ Пользовательский интерфейс
 - [docs/button.md](docs/button.md)
 - [docs/toggle_button.md](docs/toggle_button.md)
 - [docs/text.md](docs/text.md)
+- [docs/layout.md](docs/layout.md)
 - [docs/mouse_interactor.md](docs/mouse_interactor.md)
 - [docs/draggable_sprite.md](docs/draggable_sprite.md)
 
 #### 🔧 Утилиты и инструменты
 - [docs/save_load.md](docs/save_load.md)
-- [docs/tween.md](docs/tween.md)
+- [docs/tween.md](docs/tween.md) — Tween, TweenManager, Fluent API
 - [docs/text_fps.md](docs/text_fps.md)
 - [docs/game_loop.md](docs/game_loop.md)
 - [docs/input.md](docs/input.md)
@@ -292,14 +303,15 @@
 5. [Простые демо](spritePro/demoGames/) - Практические примеры
 
 ### Для разработки игр
-1. [docs/gameSprite.md](docs/gameSprite.md) - Игровые объекты
+1. [docs/sprite.md](docs/sprite.md) - Спрайты и игровые объекты
 2. [docs/animation.md](docs/animation.md) - Анимации
-3. [docs/timer.md](docs/timer.md) - Игровое время
-4. [docs/health.md](docs/health.md) - Игровые системы
-5. [docs/save_load.md](docs/save_load.md) - Сохранения
+3. [docs/tween.md](docs/tween.md) - Плавные переходы (в т.ч. Fluent API)
+4. [docs/timer.md](docs/timer.md) - Игровое время
+5. [docs/health.md](docs/health.md) - Игровые системы
+6. [docs/save_load.md](docs/save_load.md) - Сохранения
 
 ### Для продвинутых разработчиков
-1. [docs/physicSprite.md](docs/physicSprite.md) - Физика
+1. [docs/layout.md](docs/layout.md) - Автолейауты
 2. [TECHNICAL_SPECS.md](TECHNICAL_SPECS.md) - Архитектура
 3. [PERFORMANCE.md](PERFORMANCE.md) - Оптимизация
 4. [CONTRIBUTING.md](CONTRIBUTING.md) - Участие в разработке
@@ -312,9 +324,10 @@
 ## 🔄 Обновления документации
 
 ### Последние обновления
-- **2024-06-01**: Добавлена система сохранения/загрузки
-- **2024-06-01**: Создан roadmap и технические спецификации
-- **2024-06-01**: Добавлено руководство по участию в проекте
+- **2026-02**: Fluent Tween API (DoMove, DoScale, SetEase, SetLoops, OnComplete, Kill) — демо fluent_tween_demo.py
+- **2026-02**: Layout, мультиплеер, крестики-нолики — обзор в docs/OVERVIEW.md
+- **2025-06**: Добавлена система сохранения/загрузки
+- **2025-06**: Создан roadmap и технические спецификации
 
 ### Планируемые обновления
 - Документация по системе инвентаря
@@ -333,9 +346,4 @@
 ---
 
 **Совет**: Используйте поиск по файлам (Ctrl+F) для быстрого поиска нужной информации в документации! 🔍
-### [docs/camera_and_particles.md](docs/camera_and_particles.md)
-**Камера и частицы**
-- Управление камерой и режим слежения
-- Система частиц и их конфигурация
-- Примеры использования
 

README.md

@@ -98,6 +98,7 @@ while True:
 - ✅ **Аудио менеджер** - управление звуком и музыкой централизованно
 - ✅ **Система сохранений** - PlayerPrefs как в Unity!
 - ✅ **Якоря позиционирования** - размещайте объекты точно где нужно
+- ✅ **Автолейаут (Layout)** - flex, сетка, круг, линия для автоматического размещения дочерних спрайтов ([документация](docs/layout.md))
 - ✅ **Мультиплеер** - можно делать сетевые игры: встроенный TCP relay, контекст (send/poll/send_every), EventBus для событий; быстрый старт через `s.networking.run()`. В репозитории есть **мини-курс по мультиплеерным играм** (папка `multiplayer_course/`) — 10 уроков от обмена сообщениями до готовой мини-игры с меню и результатами.
 
 ---
@@ -459,7 +460,7 @@ python spritePro/demoGames/ping_pong.py
 
 ### 🎨 Игровые системы
 - **Animation** - Система анимаций
-- **Tween** - Плавные переходы (easing функции)
+- **Tween** - Плавные переходы (easing); **Fluent API**: `sprite.DoMove(...).SetEase(Ease.OutQuad)` — см. [Tween](docs/tween.md#fluent-api-do-твины) и [Fluent Tween Demo](spritePro/demoGames/fluent_tween_demo.py)
 - **Timer** - Таймеры для событий
 - **Health** - Система здоровья
 - **ParticleEmitter** - Генератор частиц
@@ -488,7 +489,7 @@ python spritePro/demoGames/ping_pong.py
 ### 🧩 Полный список документации
 - Основы: [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)
+- 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) • [Layout](docs/layout.md)
 - Компоненты: [Animation](docs/animation.md) • [Tween](docs/tween.md) • [Tween Presets](docs/tween_presets.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)

clicker.py

@@ -8,6 +8,7 @@ def on_click():
     text.set_text(f"score: {score}")
     text.set_active(True)
     emitter.emit(button.rect.center)
+    s.PlayerPrefs.set_int("score", score)
 
 
 # Initialize the library
@@ -16,7 +17,7 @@ def on_click():
 # Create a window
 s.get_screen((1280, 960), "My Game")
 
-score = 0
+score = s.PlayerPrefs.get_int("score", 0)
 
 bg = s.Sprite("", s.WH, s.WH_C)
 bg.set_color((0, 0, 180))