Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -55,3 +55,5 @@ Thumbs.db

/build/browser-gestures/
/native/mac-browser-gestures/build/
# Isolated local app bundles, profiles and test reports never belong in source.
/work/
13 changes: 13 additions & 0 deletions assets/live-terminal-presets/README.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Living Forge

Единственный новый встроенный живой набор для CanvasTTY 2.0. Living Forge, preview.5: исходная графика Volcanic Forge с различимыми состояниями.

Пиксельные GIF: 48 кадров, 10 кадров/с, цикл 4,8 с. Девять рамок: minimal/detailed/master × idle/working/completed; отдельный фон. Камера и каменные детали неподвижны, анимируются локальные потоки лавы, огонь и искры. ZIP содержит измеренные проёмы и площадки штатных кнопок в layout.json. Профиль дополнительно включает живой фон Canvas, аватар и часы.

Idle: тлеющие каналы, знак паузы, IDLE. Working: яркая лава, покадровый молот, WORKING. Completed (Done): остывшие бирюзовые каналы, галочка, DONE. Символы и подписи остаются видимыми при паузе. Геометрия minimal/detailed/master сохраняется; состояния отличаются рисунком, цветом и движением, а не одной фазой огня.

У набора стабильный ID; перезапуск не создаёт копии. При изменении встроенного ZIP тема обновляется по SHA-256 с сохранением ID и выбора пользователя. Предыдущие файлы сохраняются в pixel-skins/.retired. Прежние экспериментальные Aurora, Ember и Sakura исключены из сборки. Их установленные копии с известными встроенными ID при обновлении сохраняются там же и исчезают из списка; пользовательские импортированные темы сохраняются.

Для повторной сборки состояний из утверждённых сцен используется tools/build_forge_states.py в design-engine: вход содержит scenes/, roles/, Volcanic-Forge/; выход — новая папка. Проверяются живые GIF, прозрачный проём и визуальные отличия первых кадров всех пар состояний.

Исходная графика создана для проекта с ImageGen, анимация собрана локальным покадровым движком. Настройка остановки анимации и системное уменьшение движения поддерживаются штатным Live Engine.
35 changes: 35 additions & 0 deletions assets/live-terminal-presets/catalog.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
{
"schemaVersion": 1,
"presets": [
{
"id": "pixel:92020000-0000-4000-8000-000000000004",
"name": "Living Forge",
"archive": "volcanic-forge.zip",
"apertures": {
"minimal": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
},
"detailed": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
},
"master": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
}
}
}
],
"retiredIds": [
"pixel:92020000-0000-4000-8000-000000000001",
"pixel:92020000-0000-4000-8000-000000000002",
"pixel:92020000-0000-4000-8000-000000000003"
]
}
Binary file added assets/live-terminal-presets/volcanic-forge.zip
Binary file not shown.
15 changes: 15 additions & 0 deletions assets/living-forge-profile/README.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Living Forge — полный профиль

Единственная новая тема этой сборки. Девять GIF-рамок: minimal/detailed/master × idle/working/completed. Камера неподвижна; огонь, лава, искры и молот движутся по пикселям. Idle — тление/пауза, Working — оранжевая лава/молот, Done — бирюзовые каналы/галочка.

Терминальная тема входит во встроенный каталог. Отдельные пакеты Canvas, аватара и часов можно импортировать через мастерскую обоев в настройках внешнего вида. Это три независимых файла .ctwallpaper.

Для проверки целого профиля на исходниках, из корня репозитория:

```sh
node design-engine/tools/prepare_lab_profile.mjs . assets/living-forge-profile/preset.json /absolute/path/to/NEW-profile
```

Нужен новый каталог профиля. Скрипт отказывается менять существующий. Затем запустите отдельную тестовую сборку с CANVASTTY_USER_DATA_DIR, указывающим на этот каталог. Запущенные рабочие профили не редактируйте.

Манифест содержит SHA-256 всех пакетов, параметры проёмов, оформления и таймеров. Это набор для ручного импорта и тестовой подготовки; единого пользовательского импортера полного профиля в приложении пока нет.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Binary file not shown.
20 changes: 20 additions & 0 deletions assets/living-forge-profile/apertures.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"minimal": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
},
"detailed": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
},
"master": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
}
}
20 changes: 20 additions & 0 deletions assets/living-forge-profile/controls.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"minimal": {
"left": 72,
"top": 10.5,
"width": 21.6,
"height": 6
},
"detailed": {
"left": 72,
"top": 10.5,
"width": 21.6,
"height": 6
},
"master": {
"left": 72,
"top": 10.5,
"width": 21.6,
"height": 6
}
}
95 changes: 95 additions & 0 deletions assets/living-forge-profile/preset.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
{
"schemaVersion": 1,
"kind": "canvastty-appearance-preset",
"id": "volcanic-forge-pixel-v4",
"name": "Living Forge",
"version": "1.0.0-preview.5",
"requires": "CanvasTTY 2.0 Live Engine",
"terminals": {
"file": "Volcanic-Forge-terminals.zip",
"sha256": "256e17a5437add23057041b69457beb881ad247d2380e2562400ac68f088d051",
"id": "pixel:92020000-0000-4000-8000-000000000004"
},
"apertures": {
"minimal": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
},
"detailed": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
},
"master": {
"left": 10,
"right": 10,
"top": 20,
"bottom": 15.5
}
},
"wallpapers": {
"canvas": {
"file": "Volcanic-Forge-canvas.ctwallpaper",
"sha256": "88b5325cc84fe0a89a04cb4559e030aab69cad41a93cf8bb63d9bd86cbb30859"
},
"avatar": {
"file": "Volcanic-Forge-avatar.ctwallpaper",
"sha256": "e78699de01973317b44afd6fe4d5568d3dd4efd7050ebe0d82c2d2403f062f1e"
},
"clock": {
"file": "Volcanic-Forge-clock.ctwallpaper",
"sha256": "66117c001331996b9d523cd6db7ec90ab6ce9b927a12ab00e86c8f5f87e4dc73"
}
},
"settings": {
"palette": "night",
"appSkin": "midnight",
"canvasColor": "night",
"pattern": "none",
"canvasBackgroundFit": "cover",
"canvasBackgroundPaused": false,
"terminalBackground": "none",
"terminalSkinDetail": "detailed",
"homeClockFont": "pixel",
"homeAccentPreset": "custom",
"homeAccentColors": {
"clock": "#e7a95e",
"launcher": "#d9905c",
"browser": "#a79abb",
"settings": "#c49baf",
"media": "#d9ae78"
},
"homeTime": {
"clocks": [
{
"id": "local",
"label": "Кузница",
"timeZone": "local"
}
],
"timers": [
{
"id": "forge-focus",
"label": "Работа у горна",
"durationMs": 1500000,
"remainingMs": 1500000,
"endsAt": null,
"status": "idle"
},
{
"id": "forge-break",
"label": "Перерыв",
"durationMs": 300000,
"remainingMs": 300000,
"endsAt": null,
"status": "idle"
}
],
"hour12": false,
"showSeconds": false
}
}
}
2 changes: 2 additions & 0 deletions design-engine/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
__pycache__/
*.pyc
22 changes: 22 additions & 0 deletions design-engine/AGENT_START.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Create CanvasTTY artwork with an agent

Start with [LIVE_ENGINE.md](LIVE_ENGINE.md) and choose the output before drawing:

- **Independent wallpaper, Home avatar or clock background:** one local media file or portable `.ctwallpaper`. Use `tools/pack_wallpaper.py --require-live` for live images (or `--verify` for stills) and the prompts in `templates/`. The built-in workshop imports, previews, frames, saves and assigns these assets. No plugin and no dummy terminal frames are required.
- **Terminal skin:** nine frame roles plus one Canvas background in an install ZIP. Read [SPEC.ru.md](SPEC.ru.md) for geometry/apertures. Frame roles are `{minimal,detailed,master}_{idle,working,completed}`. Every role occurs exactly once. New frames are 1536×1024 with a transparent central opening. PNG/APNG, GIF and WebP retain native animation; the separate background also accepts MP4/WebM.

The Live Engine contract requires a supporting CanvasTTY build; verify the target build instead of assuming upstream main or older installed releases support it. Static PNG packs remain compatible with earlier importers.

Use the supplied visual reference or art direction. Preserve source media. Do not embed terminal text, real clock digits, screenshots or app controls in artwork. Keep clock centers readable and avatar subjects inside a square safe area. Report actual source resolution, codec, loop length and file size. Respect reduced motion and avoid flashes.

For a full skin ZIP, validate using the matching CanvasTTY source checkout:

```sh
node scripts/validate-pixel-skin-zip.mjs /absolute/path/theme-install.zip
```

Inspect all nine frames overlaid, confirm stable geometry and transparent apertures, and report per-level insets. Deliver the ten final role files in the install ZIP, without sources, duplicate backgrounds or reports. Matching Live Engine builds also accept optional `layout.json` generated by `pack_terminal_theme.py --controls controls.json`: it stores apertures and measured button plaques. Older ZIPs without it remain supported. Keep a separate copy of geometry for inspection. The offline source kit ZIP is not an install ZIP.

For animation use `tools/encode_animation.py` to assemble real authored frames or a sprite sheet; `tools/animate_artwork.py` provides only a masked brightness effect, not AI object motion. The live packer checks every decoded image frame; video inspection uses ffprobe metadata, while manual app import checks Chromium decoding. Package terminal roles with `tools/pack_terminal_theme.py --apertures apertures.json --require-live --receipt theme-check.json`. Keep reports outside the install ZIP. For high detail/soft alpha prefer APNG/WebP over GIF. Check the actual reference quality before treating a technically valid pack as release-ready. Validate the package with the matching `WallpaperRegistry`, then check the rendered result when possible. Do not claim installation, quality or a successful live-app check from structural validation alone. Keep access credentials local and preserve the owner's other themes and wallpapers.

For calm pixel-art motion, use `tools/compose_pixel_scene.py` with an authored pose atlas. Keep the camera, scenery and global brightness fixed; animate only local objects in integer pixel steps with held poses. Preserve transparent outer space and let ornaments protrude beyond the main rails. Measure control plaques from the final art; check button containment and spacing at several card sizes. Watch multiple loops in the actual app before reporting visual acceptance.
Loading
Loading