From 733b2fb798ac00fd27b7be8f61bfe4940a85bb55 Mon Sep 17 00:00:00 2001 From: gem Date: Sun, 7 Jun 2026 22:53:58 +0800 Subject: [PATCH] Initial flame_lua_runtime package --- .gitignore | 17 + .pubignore | 4 + CHANGELOG.md | 9 + LICENSE | 29 + README.md | 103 ++ analysis_options.yaml | 28 + assets/runtime/lua/layout.lua | 292 ++++ assets/runtime/lua/runtime_commands.lua | 261 ++++ assets/runtime/lua/runtime_ui.lua | 427 ++++++ assets/runtime/lua/runtime_widgets.lua | 773 ++++++++++ example/.gitignore | 45 + example/.luarc.json | 17 + example/.metadata | 45 + example/README.md | 16 + example/analysis_options.yaml | 28 + example/android/.gitignore | 14 + example/android/app/build.gradle.kts | 44 + .../android/app/src/debug/AndroidManifest.xml | 7 + .../android/app/src/main/AndroidManifest.xml | 45 + .../runtime_showcase/MainActivity.kt | 5 + .../res/drawable-v21/launch_background.xml | 12 + .../main/res/drawable/launch_background.xml | 12 + .../src/main/res/mipmap-hdpi/ic_launcher.png | Bin 0 -> 544 bytes .../src/main/res/mipmap-mdpi/ic_launcher.png | Bin 0 -> 442 bytes .../src/main/res/mipmap-xhdpi/ic_launcher.png | Bin 0 -> 721 bytes .../main/res/mipmap-xxhdpi/ic_launcher.png | Bin 0 -> 1031 bytes .../main/res/mipmap-xxxhdpi/ic_launcher.png | Bin 0 -> 1443 bytes .../app/src/main/res/values-night/styles.xml | 18 + .../app/src/main/res/values/styles.xml | 18 + .../app/src/profile/AndroidManifest.xml | 7 + example/android/build.gradle.kts | 24 + example/android/gradle.properties | 3 + .../gradle/wrapper/gradle-wrapper.properties | 5 + example/android/settings.gradle.kts | 26 + example/assets/games/flight/manifest.json | 22 + .../assets/games/flight/scripts/animation.lua | 17 + example/assets/games/flight/scripts/board.lua | 91 ++ example/assets/games/flight/scripts/main.lua | 154 ++ example/assets/games/flight/scripts/rules.lua | 153 ++ .../games/flight/scripts/runtime_defs.lua | 589 ++++++++ example/assets/games/flight/scripts/state.lua | 22 + .../assets/games/flight/scripts/styles.lua | 81 + example/assets/games/flight/scripts/theme.lua | 22 + example/assets/games/flight/scripts/ui.lua | 130 ++ example/assets/games/ludo/assets/board.png | Bin 0 -> 68 bytes example/assets/games/ludo/assets/dice.wav | Bin 0 -> 5336 bytes .../assets/games/ludo/assets/piece_blue.png | Bin 0 -> 68 bytes .../assets/games/ludo/assets/piece_red.png | Bin 0 -> 68 bytes example/assets/games/ludo/manifest.json | 55 + .../assets/games/ludo/scripts/animation.lua | 37 + example/assets/games/ludo/scripts/board.lua | 20 + example/assets/games/ludo/scripts/i18n.lua | 103 ++ example/assets/games/ludo/scripts/main.lua | 117 ++ example/assets/games/ludo/scripts/rules.lua | 88 ++ .../games/ludo/scripts/runtime_defs.lua | 587 ++++++++ example/assets/games/ludo/scripts/state.lua | 15 + example/assets/games/ludo/scripts/styles.lua | 80 + example/assets/games/ludo/scripts/theme.lua | 18 + example/assets/games/ludo/scripts/ui.lua | 74 + .../games/showcase/assets/button_disabled.png | Bin 0 -> 138 bytes .../games/showcase/assets/button_normal.png | Bin 0 -> 136 bytes .../games/showcase/assets/button_pressed.png | Bin 0 -> 136 bytes .../assets/games/showcase/assets/click.wav | Bin 0 -> 5336 bytes .../assets/games/showcase/assets/sample.png | Bin 0 -> 70 bytes example/assets/games/showcase/manifest.json | 62 + .../games/showcase/scripts/examples.lua | 819 +++++++++++ .../assets/games/showcase/scripts/i18n.lua | 151 ++ .../assets/games/showcase/scripts/main.lua | 698 +++++++++ .../games/showcase/scripts/runtime_defs.lua | 606 ++++++++ .../assets/games/showcase/scripts/state.lua | 32 + .../assets/games/showcase/scripts/styles.lua | 44 + .../assets/games/showcase/scripts/theme.lua | 18 + example/assets/games/showcase/scripts/ui.lua | 1300 +++++++++++++++++ example/assets/games/template/manifest.json | 27 + .../assets/games/template/scripts/main.lua | 35 + .../games/template/scripts/runtime_defs.lua | 557 +++++++ .../assets/games/template/scripts/state.lua | 8 + example/assets/games/template/scripts/ui.lua | 100 ++ example/ios/.gitignore | 34 + example/ios/Flutter/AppFrameworkInfo.plist | 26 + example/ios/Flutter/Debug.xcconfig | 1 + example/ios/Flutter/Release.xcconfig | 1 + example/ios/Runner.xcodeproj/project.pbxproj | 616 ++++++++ .../contents.xcworkspacedata | 7 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../xcshareddata/WorkspaceSettings.xcsettings | 8 + .../xcshareddata/xcschemes/Runner.xcscheme | 101 ++ .../contents.xcworkspacedata | 7 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../xcshareddata/WorkspaceSettings.xcsettings | 8 + example/ios/Runner/AppDelegate.swift | 13 + .../AppIcon.appiconset/Contents.json | 122 ++ .../Icon-App-1024x1024@1x.png | Bin 0 -> 10932 bytes .../AppIcon.appiconset/Icon-App-20x20@1x.png | Bin 0 -> 295 bytes .../AppIcon.appiconset/Icon-App-20x20@2x.png | Bin 0 -> 406 bytes .../AppIcon.appiconset/Icon-App-20x20@3x.png | Bin 0 -> 450 bytes .../AppIcon.appiconset/Icon-App-29x29@1x.png | Bin 0 -> 282 bytes .../AppIcon.appiconset/Icon-App-29x29@2x.png | Bin 0 -> 462 bytes .../AppIcon.appiconset/Icon-App-29x29@3x.png | Bin 0 -> 704 bytes .../AppIcon.appiconset/Icon-App-40x40@1x.png | Bin 0 -> 406 bytes .../AppIcon.appiconset/Icon-App-40x40@2x.png | Bin 0 -> 586 bytes .../AppIcon.appiconset/Icon-App-40x40@3x.png | Bin 0 -> 862 bytes .../AppIcon.appiconset/Icon-App-60x60@2x.png | Bin 0 -> 862 bytes .../AppIcon.appiconset/Icon-App-60x60@3x.png | Bin 0 -> 1674 bytes .../AppIcon.appiconset/Icon-App-76x76@1x.png | Bin 0 -> 762 bytes .../AppIcon.appiconset/Icon-App-76x76@2x.png | Bin 0 -> 1226 bytes .../Icon-App-83.5x83.5@2x.png | Bin 0 -> 1418 bytes .../LaunchImage.imageset/Contents.json | 23 + .../LaunchImage.imageset/LaunchImage.png | Bin 0 -> 68 bytes .../LaunchImage.imageset/LaunchImage@2x.png | Bin 0 -> 68 bytes .../LaunchImage.imageset/LaunchImage@3x.png | Bin 0 -> 68 bytes .../LaunchImage.imageset/README.md | 5 + .../Runner/Base.lproj/LaunchScreen.storyboard | 37 + example/ios/Runner/Base.lproj/Main.storyboard | 26 + example/ios/Runner/Info.plist | 49 + example/ios/Runner/Runner-Bridging-Header.h | 1 + example/ios/RunnerTests/RunnerTests.swift | 12 + example/lib/main.dart | 41 + example/linux/.gitignore | 1 + example/linux/CMakeLists.txt | 128 ++ example/linux/flutter/CMakeLists.txt | 88 ++ .../flutter/generated_plugin_registrant.cc | 15 + .../flutter/generated_plugin_registrant.h | 15 + example/linux/flutter/generated_plugins.cmake | 26 + example/linux/runner/CMakeLists.txt | 26 + example/linux/runner/main.cc | 6 + example/linux/runner/my_application.cc | 144 ++ example/linux/runner/my_application.h | 18 + example/macos/.gitignore | 7 + example/macos/Flutter/Flutter-Debug.xcconfig | 1 + .../macos/Flutter/Flutter-Release.xcconfig | 1 + .../Flutter/GeneratedPluginRegistrant.swift | 14 + .../macos/Runner.xcodeproj/project.pbxproj | 705 +++++++++ .../xcshareddata/IDEWorkspaceChecks.plist | 8 + .../xcshareddata/xcschemes/Runner.xcscheme | 99 ++ .../contents.xcworkspacedata | 7 + .../xcshareddata/IDEWorkspaceChecks.plist | 8 + example/macos/Runner/AppDelegate.swift | 13 + .../AppIcon.appiconset/Contents.json | 68 + .../AppIcon.appiconset/app_icon_1024.png | Bin 0 -> 102994 bytes .../AppIcon.appiconset/app_icon_128.png | Bin 0 -> 5680 bytes .../AppIcon.appiconset/app_icon_16.png | Bin 0 -> 520 bytes .../AppIcon.appiconset/app_icon_256.png | Bin 0 -> 14142 bytes .../AppIcon.appiconset/app_icon_32.png | Bin 0 -> 1066 bytes .../AppIcon.appiconset/app_icon_512.png | Bin 0 -> 36406 bytes .../AppIcon.appiconset/app_icon_64.png | Bin 0 -> 2218 bytes example/macos/Runner/Base.lproj/MainMenu.xib | 343 +++++ example/macos/Runner/Configs/AppInfo.xcconfig | 14 + example/macos/Runner/Configs/Debug.xcconfig | 2 + example/macos/Runner/Configs/Release.xcconfig | 2 + .../macos/Runner/Configs/Warnings.xcconfig | 13 + .../macos/Runner/DebugProfile.entitlements | 12 + example/macos/Runner/Info.plist | 32 + example/macos/Runner/MainFlutterWindow.swift | 15 + example/macos/Runner/Release.entitlements | 8 + example/macos/RunnerTests/RunnerTests.swift | 12 + example/pubspec.yaml | 34 + example/pyrightconfig.json | 11 + example/test/widget_test.dart | 10 + example/web/favicon.png | Bin 0 -> 917 bytes example/web/icons/Icon-192.png | Bin 0 -> 5292 bytes example/web/icons/Icon-512.png | Bin 0 -> 8252 bytes example/web/icons/Icon-maskable-192.png | Bin 0 -> 5594 bytes example/web/icons/Icon-maskable-512.png | Bin 0 -> 20998 bytes example/web/index.html | 38 + example/web/manifest.json | 35 + example/windows/.gitignore | 17 + example/windows/CMakeLists.txt | 108 ++ example/windows/flutter/CMakeLists.txt | 109 ++ .../flutter/generated_plugin_registrant.cc | 14 + .../flutter/generated_plugin_registrant.h | 15 + .../windows/flutter/generated_plugins.cmake | 26 + example/windows/runner/CMakeLists.txt | 40 + example/windows/runner/Runner.rc | 121 ++ example/windows/runner/flutter_window.cpp | 71 + example/windows/runner/flutter_window.h | 33 + example/windows/runner/main.cpp | 43 + example/windows/runner/resource.h | 16 + example/windows/runner/resources/app_icon.ico | Bin 0 -> 33772 bytes example/windows/runner/runner.exe.manifest | 14 + example/windows/runner/utils.cpp | 65 + example/windows/runner/utils.h | 19 + example/windows/runner/win32_window.cpp | 288 ++++ example/windows/runner/win32_window.h | 102 ++ lib/flame_lua_runtime.dart | 14 + lib/runtime/audio/runtime_audio_cache.dart | 90 ++ lib/runtime/audio/runtime_audio_debug.dart | 27 + lib/runtime/audio/runtime_audio_loading.dart | 124 ++ lib/runtime/audio/runtime_audio_manager.dart | 352 +++++ lib/runtime/audio/runtime_audio_player.dart | 99 ++ lib/runtime/commands/command_audio.dart | 125 ++ lib/runtime/commands/command_composite.dart | 52 + lib/runtime/commands/command_executor.dart | 230 +++ .../commands/command_lifecycle_context.dart | 154 ++ lib/runtime/commands/command_resources.dart | 83 ++ lib/runtime/commands/command_support.dart | 248 ++++ .../commands/command_target_effects.dart | 143 ++ lib/runtime/commands/command_toast.dart | 96 ++ lib/runtime/commands/command_validation.dart | 154 ++ .../commands/runtime_command_registry.dart | 146 ++ .../diagnostics/runtime_diagnostics.dart | 138 ++ lib/runtime/display/runtime_viewport.dart | 160 ++ .../events/runtime_event_dispatcher.dart | 80 + lib/runtime/events/runtime_event_gate.dart | 47 + lib/runtime/game/flame_lua_game.dart | 377 +++++ lib/runtime/game/lua_game_widget.dart | 45 + lib/runtime/game/runtime_locale.dart | 162 ++ lib/runtime/game/runtime_options.dart | 7 + lib/runtime/lifecycle/runtime_async_gate.dart | 50 + .../lifecycle/runtime_serial_queue.dart | 77 + lib/runtime/lifecycle/runtime_session.dart | 71 + .../lifecycle/runtime_task_registry.dart | 129 ++ lib/runtime/models/game_diff.dart | 173 +++ lib/runtime/models/runtime_command.dart | 43 + lib/runtime/models/runtime_event.dart | 64 + lib/runtime/models/runtime_node.dart | 572 ++++++++ lib/runtime/packages/game_package.dart | 96 ++ .../game_package_activation_controller.dart | 231 +++ .../packages/game_package_manifest.dart | 265 ++++ .../packages/game_package_repository.dart | 226 +++ lib/runtime/packages/package_verifier.dart | 117 ++ .../packages/stable_package_store.dart | 86 ++ lib/runtime/protocol/runtime_protocol.dart | 490 +++++++ .../rendering/render_tree_controller.dart | 489 +++++++ lib/runtime/rendering/runtime_component.dart | 1075 ++++++++++++++ .../resources/game_resource_cache.dart | 66 + .../resources/game_resource_debug.dart | 28 + .../resources/game_resource_loading.dart | 186 +++ .../resources/game_resource_manager.dart | 279 ++++ .../resources/resource_load_limiter.dart | 91 ++ .../scripting/lua_dardo_script_engine.dart | 296 ++++ lib/runtime/scripting/script_engine.dart | 13 + pubspec.yaml | 29 + test/public_api_test.dart | 20 + .../audio/runtime_audio_manager_test.dart | 484 ++++++ .../commands/command_executor_test.dart | 940 ++++++++++++ .../runtime_command_registry_test.dart | 65 + .../diagnostics/runtime_diagnostics_test.dart | 120 ++ .../events/runtime_event_dispatcher_test.dart | 170 +++ .../events/runtime_event_gate_test.dart | 84 ++ test/runtime/game/flame_lua_game_test.dart | 72 + test/runtime/game/runtime_locale_test.dart | 63 + .../lifecycle/runtime_async_gate_test.dart | 36 + .../lifecycle/runtime_serial_queue_test.dart | 59 + .../lifecycle/runtime_session_test.dart | 38 + .../lifecycle/runtime_task_registry_test.dart | 61 + test/runtime/models/game_diff_test.dart | 121 ++ .../models/runtime_event_command_test.dart | 77 + test/runtime/models/runtime_node_test.dart | 324 ++++ ...me_package_activation_controller_test.dart | 395 +++++ .../packages/game_package_manifest_test.dart | 236 +++ test/runtime/packages/game_package_test.dart | 84 ++ .../packages/package_verifier_test.dart | 144 ++ test/runtime/public_api_test.dart | 20 + .../render_tree_controller_test.dart | 593 ++++++++ .../rendering/runtime_component_test.dart | 165 +++ .../rendering/runtime_viewport_test.dart | 98 ++ .../resources/game_resource_manager_test.dart | 401 +++++ .../resources/resource_load_limiter_test.dart | 62 + .../lua_dardo_script_engine_test.dart | 962 ++++++++++++ tool/generate_lua_runtime_defs.dart | 93 ++ tool/lua_runtime_defs_common.lua | 557 +++++++ 262 files changed, 28439 insertions(+) create mode 100644 .gitignore create mode 100644 .pubignore create mode 100644 CHANGELOG.md create mode 100644 LICENSE create mode 100644 README.md create mode 100644 analysis_options.yaml create mode 100644 assets/runtime/lua/layout.lua create mode 100644 assets/runtime/lua/runtime_commands.lua create mode 100644 assets/runtime/lua/runtime_ui.lua create mode 100644 assets/runtime/lua/runtime_widgets.lua create mode 100644 example/.gitignore create mode 100644 example/.luarc.json create mode 100644 example/.metadata create mode 100644 example/README.md create mode 100644 example/analysis_options.yaml create mode 100644 example/android/.gitignore create mode 100644 example/android/app/build.gradle.kts create mode 100644 example/android/app/src/debug/AndroidManifest.xml create mode 100644 example/android/app/src/main/AndroidManifest.xml create mode 100644 example/android/app/src/main/kotlin/dev/flame_lua/runtime_showcase/MainActivity.kt create mode 100644 example/android/app/src/main/res/drawable-v21/launch_background.xml create mode 100644 example/android/app/src/main/res/drawable/launch_background.xml create mode 100644 example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png create mode 100644 example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png create mode 100644 example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png create mode 100644 example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png create mode 100644 example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png create mode 100644 example/android/app/src/main/res/values-night/styles.xml create mode 100644 example/android/app/src/main/res/values/styles.xml create mode 100644 example/android/app/src/profile/AndroidManifest.xml create mode 100644 example/android/build.gradle.kts create mode 100644 example/android/gradle.properties create mode 100644 example/android/gradle/wrapper/gradle-wrapper.properties create mode 100644 example/android/settings.gradle.kts create mode 100644 example/assets/games/flight/manifest.json create mode 100644 example/assets/games/flight/scripts/animation.lua create mode 100644 example/assets/games/flight/scripts/board.lua create mode 100644 example/assets/games/flight/scripts/main.lua create mode 100644 example/assets/games/flight/scripts/rules.lua create mode 100644 example/assets/games/flight/scripts/runtime_defs.lua create mode 100644 example/assets/games/flight/scripts/state.lua create mode 100644 example/assets/games/flight/scripts/styles.lua create mode 100644 example/assets/games/flight/scripts/theme.lua create mode 100644 example/assets/games/flight/scripts/ui.lua create mode 100644 example/assets/games/ludo/assets/board.png create mode 100644 example/assets/games/ludo/assets/dice.wav create mode 100644 example/assets/games/ludo/assets/piece_blue.png create mode 100644 example/assets/games/ludo/assets/piece_red.png create mode 100644 example/assets/games/ludo/manifest.json create mode 100644 example/assets/games/ludo/scripts/animation.lua create mode 100644 example/assets/games/ludo/scripts/board.lua create mode 100644 example/assets/games/ludo/scripts/i18n.lua create mode 100644 example/assets/games/ludo/scripts/main.lua create mode 100644 example/assets/games/ludo/scripts/rules.lua create mode 100644 example/assets/games/ludo/scripts/runtime_defs.lua create mode 100644 example/assets/games/ludo/scripts/state.lua create mode 100644 example/assets/games/ludo/scripts/styles.lua create mode 100644 example/assets/games/ludo/scripts/theme.lua create mode 100644 example/assets/games/ludo/scripts/ui.lua create mode 100644 example/assets/games/showcase/assets/button_disabled.png create mode 100644 example/assets/games/showcase/assets/button_normal.png create mode 100644 example/assets/games/showcase/assets/button_pressed.png create mode 100644 example/assets/games/showcase/assets/click.wav create mode 100644 example/assets/games/showcase/assets/sample.png create mode 100644 example/assets/games/showcase/manifest.json create mode 100644 example/assets/games/showcase/scripts/examples.lua create mode 100644 example/assets/games/showcase/scripts/i18n.lua create mode 100644 example/assets/games/showcase/scripts/main.lua create mode 100644 example/assets/games/showcase/scripts/runtime_defs.lua create mode 100644 example/assets/games/showcase/scripts/state.lua create mode 100644 example/assets/games/showcase/scripts/styles.lua create mode 100644 example/assets/games/showcase/scripts/theme.lua create mode 100644 example/assets/games/showcase/scripts/ui.lua create mode 100644 example/assets/games/template/manifest.json create mode 100644 example/assets/games/template/scripts/main.lua create mode 100644 example/assets/games/template/scripts/runtime_defs.lua create mode 100644 example/assets/games/template/scripts/state.lua create mode 100644 example/assets/games/template/scripts/ui.lua create mode 100644 example/ios/.gitignore create mode 100644 example/ios/Flutter/AppFrameworkInfo.plist create mode 100644 example/ios/Flutter/Debug.xcconfig create mode 100644 example/ios/Flutter/Release.xcconfig create mode 100644 example/ios/Runner.xcodeproj/project.pbxproj create mode 100644 example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata create mode 100644 example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings create mode 100644 example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme create mode 100644 example/ios/Runner.xcworkspace/contents.xcworkspacedata create mode 100644 example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings create mode 100644 example/ios/Runner/AppDelegate.swift create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json create mode 100644 example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png create mode 100644 example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png create mode 100644 example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png create mode 100644 example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md create mode 100644 example/ios/Runner/Base.lproj/LaunchScreen.storyboard create mode 100644 example/ios/Runner/Base.lproj/Main.storyboard create mode 100644 example/ios/Runner/Info.plist create mode 100644 example/ios/Runner/Runner-Bridging-Header.h create mode 100644 example/ios/RunnerTests/RunnerTests.swift create mode 100644 example/lib/main.dart create mode 100644 example/linux/.gitignore create mode 100644 example/linux/CMakeLists.txt create mode 100644 example/linux/flutter/CMakeLists.txt create mode 100644 example/linux/flutter/generated_plugin_registrant.cc create mode 100644 example/linux/flutter/generated_plugin_registrant.h create mode 100644 example/linux/flutter/generated_plugins.cmake create mode 100644 example/linux/runner/CMakeLists.txt create mode 100644 example/linux/runner/main.cc create mode 100644 example/linux/runner/my_application.cc create mode 100644 example/linux/runner/my_application.h create mode 100644 example/macos/.gitignore create mode 100644 example/macos/Flutter/Flutter-Debug.xcconfig create mode 100644 example/macos/Flutter/Flutter-Release.xcconfig create mode 100644 example/macos/Flutter/GeneratedPluginRegistrant.swift create mode 100644 example/macos/Runner.xcodeproj/project.pbxproj create mode 100644 example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme create mode 100644 example/macos/Runner.xcworkspace/contents.xcworkspacedata create mode 100644 example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist create mode 100644 example/macos/Runner/AppDelegate.swift create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png create mode 100644 example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png create mode 100644 example/macos/Runner/Base.lproj/MainMenu.xib create mode 100644 example/macos/Runner/Configs/AppInfo.xcconfig create mode 100644 example/macos/Runner/Configs/Debug.xcconfig create mode 100644 example/macos/Runner/Configs/Release.xcconfig create mode 100644 example/macos/Runner/Configs/Warnings.xcconfig create mode 100644 example/macos/Runner/DebugProfile.entitlements create mode 100644 example/macos/Runner/Info.plist create mode 100644 example/macos/Runner/MainFlutterWindow.swift create mode 100644 example/macos/Runner/Release.entitlements create mode 100644 example/macos/RunnerTests/RunnerTests.swift create mode 100644 example/pubspec.yaml create mode 100644 example/pyrightconfig.json create mode 100644 example/test/widget_test.dart create mode 100644 example/web/favicon.png create mode 100644 example/web/icons/Icon-192.png create mode 100644 example/web/icons/Icon-512.png create mode 100644 example/web/icons/Icon-maskable-192.png create mode 100644 example/web/icons/Icon-maskable-512.png create mode 100644 example/web/index.html create mode 100644 example/web/manifest.json create mode 100644 example/windows/.gitignore create mode 100644 example/windows/CMakeLists.txt create mode 100644 example/windows/flutter/CMakeLists.txt create mode 100644 example/windows/flutter/generated_plugin_registrant.cc create mode 100644 example/windows/flutter/generated_plugin_registrant.h create mode 100644 example/windows/flutter/generated_plugins.cmake create mode 100644 example/windows/runner/CMakeLists.txt create mode 100644 example/windows/runner/Runner.rc create mode 100644 example/windows/runner/flutter_window.cpp create mode 100644 example/windows/runner/flutter_window.h create mode 100644 example/windows/runner/main.cpp create mode 100644 example/windows/runner/resource.h create mode 100644 example/windows/runner/resources/app_icon.ico create mode 100644 example/windows/runner/runner.exe.manifest create mode 100644 example/windows/runner/utils.cpp create mode 100644 example/windows/runner/utils.h create mode 100644 example/windows/runner/win32_window.cpp create mode 100644 example/windows/runner/win32_window.h create mode 100644 lib/flame_lua_runtime.dart create mode 100644 lib/runtime/audio/runtime_audio_cache.dart create mode 100644 lib/runtime/audio/runtime_audio_debug.dart create mode 100644 lib/runtime/audio/runtime_audio_loading.dart create mode 100644 lib/runtime/audio/runtime_audio_manager.dart create mode 100644 lib/runtime/audio/runtime_audio_player.dart create mode 100644 lib/runtime/commands/command_audio.dart create mode 100644 lib/runtime/commands/command_composite.dart create mode 100644 lib/runtime/commands/command_executor.dart create mode 100644 lib/runtime/commands/command_lifecycle_context.dart create mode 100644 lib/runtime/commands/command_resources.dart create mode 100644 lib/runtime/commands/command_support.dart create mode 100644 lib/runtime/commands/command_target_effects.dart create mode 100644 lib/runtime/commands/command_toast.dart create mode 100644 lib/runtime/commands/command_validation.dart create mode 100644 lib/runtime/commands/runtime_command_registry.dart create mode 100644 lib/runtime/diagnostics/runtime_diagnostics.dart create mode 100644 lib/runtime/display/runtime_viewport.dart create mode 100644 lib/runtime/events/runtime_event_dispatcher.dart create mode 100644 lib/runtime/events/runtime_event_gate.dart create mode 100644 lib/runtime/game/flame_lua_game.dart create mode 100644 lib/runtime/game/lua_game_widget.dart create mode 100644 lib/runtime/game/runtime_locale.dart create mode 100644 lib/runtime/game/runtime_options.dart create mode 100644 lib/runtime/lifecycle/runtime_async_gate.dart create mode 100644 lib/runtime/lifecycle/runtime_serial_queue.dart create mode 100644 lib/runtime/lifecycle/runtime_session.dart create mode 100644 lib/runtime/lifecycle/runtime_task_registry.dart create mode 100644 lib/runtime/models/game_diff.dart create mode 100644 lib/runtime/models/runtime_command.dart create mode 100644 lib/runtime/models/runtime_event.dart create mode 100644 lib/runtime/models/runtime_node.dart create mode 100644 lib/runtime/packages/game_package.dart create mode 100644 lib/runtime/packages/game_package_activation_controller.dart create mode 100644 lib/runtime/packages/game_package_manifest.dart create mode 100644 lib/runtime/packages/game_package_repository.dart create mode 100644 lib/runtime/packages/package_verifier.dart create mode 100644 lib/runtime/packages/stable_package_store.dart create mode 100644 lib/runtime/protocol/runtime_protocol.dart create mode 100644 lib/runtime/rendering/render_tree_controller.dart create mode 100644 lib/runtime/rendering/runtime_component.dart create mode 100644 lib/runtime/resources/game_resource_cache.dart create mode 100644 lib/runtime/resources/game_resource_debug.dart create mode 100644 lib/runtime/resources/game_resource_loading.dart create mode 100644 lib/runtime/resources/game_resource_manager.dart create mode 100644 lib/runtime/resources/resource_load_limiter.dart create mode 100644 lib/runtime/scripting/lua_dardo_script_engine.dart create mode 100644 lib/runtime/scripting/script_engine.dart create mode 100644 pubspec.yaml create mode 100644 test/public_api_test.dart create mode 100644 test/runtime/audio/runtime_audio_manager_test.dart create mode 100644 test/runtime/commands/command_executor_test.dart create mode 100644 test/runtime/commands/runtime_command_registry_test.dart create mode 100644 test/runtime/diagnostics/runtime_diagnostics_test.dart create mode 100644 test/runtime/events/runtime_event_dispatcher_test.dart create mode 100644 test/runtime/events/runtime_event_gate_test.dart create mode 100644 test/runtime/game/flame_lua_game_test.dart create mode 100644 test/runtime/game/runtime_locale_test.dart create mode 100644 test/runtime/lifecycle/runtime_async_gate_test.dart create mode 100644 test/runtime/lifecycle/runtime_serial_queue_test.dart create mode 100644 test/runtime/lifecycle/runtime_session_test.dart create mode 100644 test/runtime/lifecycle/runtime_task_registry_test.dart create mode 100644 test/runtime/models/game_diff_test.dart create mode 100644 test/runtime/models/runtime_event_command_test.dart create mode 100644 test/runtime/models/runtime_node_test.dart create mode 100644 test/runtime/packages/game_package_activation_controller_test.dart create mode 100644 test/runtime/packages/game_package_manifest_test.dart create mode 100644 test/runtime/packages/game_package_test.dart create mode 100644 test/runtime/packages/package_verifier_test.dart create mode 100644 test/runtime/public_api_test.dart create mode 100644 test/runtime/rendering/render_tree_controller_test.dart create mode 100644 test/runtime/rendering/runtime_component_test.dart create mode 100644 test/runtime/rendering/runtime_viewport_test.dart create mode 100644 test/runtime/resources/game_resource_manager_test.dart create mode 100644 test/runtime/resources/resource_load_limiter_test.dart create mode 100644 test/runtime/scripting/lua_dardo_script_engine_test.dart create mode 100644 tool/generate_lua_runtime_defs.dart create mode 100644 tool/lua_runtime_defs_common.lua diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2f5f6c0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,17 @@ +# Dart / Flutter generated files +.dart_tool/ +.packages +.flutter-plugins +.flutter-plugins-dependencies +pubspec.lock +build/ +coverage/ + +# IDE / OS +*.iml +.idea/ +.vscode/ +.DS_Store + +# Logs +*.log diff --git a/.pubignore b/.pubignore new file mode 100644 index 0000000..a4395cd --- /dev/null +++ b/.pubignore @@ -0,0 +1,4 @@ +build/ +.dart_tool/ +.packages +pubspec.lock diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..220f564 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +## 0.1.0 + +- Initial extracted package skeleton for `flame_lua_runtime`. +- Added public API barrel with `LuaGameWidget`, `FlameLuaGame`, `RuntimeOptions`, package repositories, and script engine interfaces. +- Added shared Runtime Lua helper assets. +- Added manifest-driven package/resource/module loading support. +- Added Runtime commands, rendering nodes, package activation, and Lua bridge infrastructure. diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..d757df8 --- /dev/null +++ b/LICENSE @@ -0,0 +1,29 @@ +BSD 3-Clause License + +Copyright (c) 2026, Flame Lua Runtime contributors +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +3. Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..1eee729 --- /dev/null +++ b/README.md @@ -0,0 +1,103 @@ +# flame_lua_runtime + +A Flutter + Flame + Lua runtime kit for manifest-driven 2D game packages. + +The package provides a reusable runtime boundary: + +```text +RuntimeEvent -> Lua -> GameDiff / RuntimeCommand -> Flame +``` + +It is designed for Flutter apps that want to host Lua-authored 2D games or interactive showcases while keeping the Flutter/Flame side generic. + +## Features + +- `LuaGameWidget` for embedding a Lua game package in a Flutter app. +- Manifest-driven Lua module, resource, audio, and package loading. +- Controlled Lua modularization through `runtime.import(moduleName)`. +- Generic Runtime nodes for panels, text, sprites, buttons, particles, Spine, and list views. +- Runtime commands for movement, fading, scaling, rotation, sequencing, audio, resources, toast, clipboard, and Spine animation. +- Shared Lua helper modules under `assets/runtime/lua/`. +- Configurable Runtime Lua asset root via `RuntimeOptions.runtimeLuaRoot`. + +## Example + +This package includes a runnable Flutter showcase app under `example/`: + +```bash +cd example +flutter run --dart-define=LUA_GAME_ID=showcase +``` + +Other bundled example packages can be selected with: + +```bash +flutter run --dart-define=LUA_GAME_ID=template +flutter run --dart-define=LUA_GAME_ID=ludo +flutter run --dart-define=LUA_GAME_ID=flight +``` + +## Quick start + +Add the package to your app: + +```yaml +dependencies: + flame_lua_runtime: ^0.1.0 +``` + +Embed a game package: + +```dart +import 'package:flame_lua_runtime/flame_lua_runtime.dart'; + +LuaGameWidget( + gameId: 'template', + runtimeOptions: const RuntimeOptions( + runtimeLuaRoot: 'packages/flame_lua_runtime/assets/runtime/lua', + ), +) +``` + +Your app should provide game package assets such as: + +```text +assets/games/template/manifest.json +assets/games/template/scripts/main.lua +assets/games/template/scripts/state.lua +assets/games/template/scripts/ui.lua +``` + +The game manifest declares package-local scripts and shared Runtime Lua modules: + +```json +{ + "modules": { + "main": "scripts/main.lua", + "runtime_ui": "runtime:runtime_ui.lua", + "runtime_widgets": "runtime:runtime_widgets.lua", + "runtime_commands": "runtime:runtime_commands.lua", + "layout": "runtime:layout.lua" + } +} +``` + +## Runtime asset path + +When used as a published package, configure: + +```dart +const RuntimeOptions( + runtimeLuaRoot: 'packages/flame_lua_runtime/assets/runtime/lua', +) +``` + +For source-tree development, the default remains: + +```dart +RuntimeOptions.defaultRuntimeLuaRoot // assets/runtime/lua +``` + +## Status + +This package is in early extraction stage. Public API is intentionally small and centered on `LuaGameWidget`, `FlameLuaGame`, `RuntimeOptions`, package repositories, and script engine interfaces. diff --git a/analysis_options.yaml b/analysis_options.yaml new file mode 100644 index 0000000..0d29021 --- /dev/null +++ b/analysis_options.yaml @@ -0,0 +1,28 @@ +# This file configures the analyzer, which statically analyzes Dart code to +# check for errors, warnings, and lints. +# +# The issues identified by the analyzer are surfaced in the UI of Dart-enabled +# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be +# invoked from the command line by running `flutter analyze`. + +# The following line activates a set of recommended lints for Flutter apps, +# packages, and plugins designed to encourage good coding practices. +include: package:flutter_lints/flutter.yaml + +linter: + # The lint rules applied to this project can be customized in the + # section below to disable rules from the `package:flutter_lints/flutter.yaml` + # included above or to enable additional rules. A list of all available lints + # and their documentation is published at https://dart.dev/lints. + # + # Instead of disabling a lint rule for the entire project in the + # section below, it can also be suppressed for a single line of code + # or a specific dart file by using the `// ignore: name_of_lint` and + # `// ignore_for_file: name_of_lint` syntax on the line or in the file + # producing the lint. + rules: + # avoid_print: false # Uncomment to disable the `avoid_print` rule + # prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule + +# Additional information about this file can be found at +# https://dart.dev/guides/language/analysis-options diff --git a/assets/runtime/lua/layout.lua b/assets/runtime/lua/layout.lua new file mode 100644 index 0000000..f3f9900 --- /dev/null +++ b/assets/runtime/lua/layout.lua @@ -0,0 +1,292 @@ +---@alias RuntimeLayoutAlign 'start'|'center'|'end' + +---@class (exact) RuntimeLayoutItem +---@field node RuntimeNode +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLayoutItemOpts +---@field margin? number +---@field mx? number +---@field my? number +---@field ml? number +---@field mr? number +---@field mt? number +---@field mb? number +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLinearLayoutOpts +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field gap? number +---@field align? RuntimeLayoutAlign +---@field padding? number +---@field paddingX? number +---@field paddingY? number +---@field px? number +---@field py? number +---@field paddingLeft? number +---@field paddingTop? number + +---@class RuntimeBoxLayoutOpts: RuntimeLinearLayoutOpts +---@field rows? integer +---@field columns? integer +---@field cols? integer +---@field cellWidth? number +---@field cellHeight? number +---@field cellW? number +---@field cellH? number +---@field gapX? number +---@field gapY? number +---@field valign? RuntimeLayoutAlign + +---@class RuntimeLayout +local layout = {} + +---@param value any +---@param fallback number +---@return number +local function read_number(value, fallback) + if type(value) == "number" then + return value + end + return fallback +end + +---@param opts? table +---@param key string +---@return number +local function spacing(opts, key) + opts = opts or {} + if key == "left" then + return read_number(opts.paddingLeft, read_number(opts.paddingX, read_number(opts.px, read_number(opts.padding, 0)))) + end + if key == "top" then + return read_number(opts.paddingTop, read_number(opts.paddingY, read_number(opts.py, read_number(opts.padding, 0)))) + end + return 0 +end + +---@param node RuntimeNode +---@param parent? string +local function apply_parent(node, parent) + if parent ~= nil and parent ~= "" then + node.parent = parent + elseif parent == "" then + node.parent = nil + end +end + +---@param axis_size number +---@param item_size number +---@param align RuntimeLayoutAlign +---@return number +local function align_cross(axis_size, item_size, align) + if align == "center" then + return (axis_size - item_size) / 2 + end + if align == "end" then + return axis_size - item_size + end + return 0 +end + +---@param value any +---@return RuntimeNode +local function node_of(value) + return value.node or value +end + +---@param value any +---@param key string +---@return number +local function margin_of(value, key) + local all = read_number(value.margin, 0) + if key == "marginLeft" then + return read_number(value.marginLeft, read_number(value.ml, read_number(value.mx, all))) + end + if key == "marginRight" then + return read_number(value.marginRight, read_number(value.mr, read_number(value.mx, all))) + end + if key == "marginTop" then + return read_number(value.marginTop, read_number(value.mt, read_number(value.my, all))) + end + if key == "marginBottom" then + return read_number(value.marginBottom, read_number(value.mb, read_number(value.my, all))) + end + return 0 +end + +---@param node RuntimeNode +---@param opts? RuntimeLayoutItemOpts +---@return RuntimeLayoutItem +function layout.item(node, opts) + opts = opts or {} + return { + node = node, + marginLeft = margin_of(opts, "marginLeft"), + marginRight = margin_of(opts, "marginRight"), + marginTop = margin_of(opts, "marginTop"), + marginBottom = margin_of(opts, "marginBottom") + } +end + +---@param origin RuntimePoint +---@param position RuntimePoint +---@return RuntimePoint +function layout.local_position(origin, position) + return { + x = position.x - origin.x, + y = position.y - origin.y + } +end + +---@param parent? string +---@param items (RuntimeNode|RuntimeLayoutItem)[] +---@param opts? RuntimeLinearLayoutOpts +---@return RuntimeNode[] +function layout.row(parent, items, opts) + opts = opts or {} + local cursor = read_number(opts.x, 0) + spacing(opts, "left") + local base_y = read_number(opts.y, 0) + spacing(opts, "top") + local gap = read_number(opts.gap, 0) + local height = read_number(opts.height, 0) + local align = opts.align or "start" + local nodes = {} + + for index, item in ipairs(items) do + local node = node_of(item) + cursor = cursor + margin_of(item, "marginLeft") + node.x = cursor + + local item_height = read_number(node.height, 0) + node.y = base_y + align_cross(height, item_height, align) + apply_parent(node, parent) + + cursor = cursor + read_number(node.width, 0) + margin_of(item, "marginRight") + gap + nodes[index] = node + end + + return nodes +end + +---@param parent? string +---@param items (RuntimeNode|RuntimeLayoutItem)[] +---@param opts? RuntimeLinearLayoutOpts +---@return RuntimeNode[] +function layout.column(parent, items, opts) + opts = opts or {} + local cursor = read_number(opts.y, 0) + spacing(opts, "top") + local base_x = read_number(opts.x, 0) + spacing(opts, "left") + local gap = read_number(opts.gap, 0) + local width = read_number(opts.width, 0) + local align = opts.align or "start" + local nodes = {} + + for index, item in ipairs(items) do + local node = node_of(item) + cursor = cursor + margin_of(item, "marginTop") + node.y = cursor + + local item_width = read_number(node.width, 0) + node.x = base_x + align_cross(width, item_width, align) + apply_parent(node, parent) + + cursor = cursor + read_number(node.height, 0) + margin_of(item, "marginBottom") + gap + nodes[index] = node + end + + return nodes +end + +---@param parent? string +---@param items (RuntimeNode|RuntimeLayoutItem)[] +---@param opts? RuntimeLinearLayoutOpts +---@return RuntimeNode[] +function layout.stack(parent, items, opts) + opts = opts or {} + local offset_x = read_number(opts.x, 0) + spacing(opts, "left") + local offset_y = read_number(opts.y, 0) + spacing(opts, "top") + local nodes = {} + + for index, item in ipairs(items) do + local node = node_of(item) + node.x = read_number(node.x, 0) + offset_x + node.y = read_number(node.y, 0) + offset_y + apply_parent(node, parent) + nodes[index] = node + end + + return nodes +end + +---@param parent? string +---@param items (RuntimeNode|RuntimeLayoutItem)[] +---@param opts? RuntimeBoxLayoutOpts +---@return RuntimeNode[] +function layout.box(parent, items, opts) + opts = opts or {} + local count = #items + local rows = math.floor(read_number(opts.rows, 0)) + local columns = math.floor(read_number(opts.columns, read_number(opts.cols, 0))) + if columns <= 0 and rows > 0 then + columns = math.ceil(count / rows) + end + if columns <= 0 then + columns = count > 0 and count or 1 + end + if rows <= 0 then + rows = math.ceil(count / columns) + end + + local gap_x = read_number(opts.gapX, read_number(opts.gap, 0)) + local gap_y = read_number(opts.gapY, read_number(opts.gap, 0)) + local origin_x = read_number(opts.x, 0) + spacing(opts, "left") + local origin_y = read_number(opts.y, 0) + spacing(opts, "top") + local cell_w = read_number(opts.cellWidth, read_number(opts.cellW, 0)) + local cell_h = read_number(opts.cellHeight, read_number(opts.cellH, 0)) + local width = read_number(opts.width, 0) + local height = read_number(opts.height, 0) + if cell_w <= 0 and width > 0 then + cell_w = (width - gap_x * (columns - 1)) / columns + end + if cell_h <= 0 and height > 0 then + cell_h = (height - gap_y * (rows - 1)) / rows + end + + local align = opts.align or "start" + local valign = opts.valign or "start" + local nodes = {} + + for index, item in ipairs(items) do + local node = node_of(item) + local item_width = read_number(node.width, cell_w) + local item_height = read_number(node.height, cell_h) + local effective_cell_w = cell_w > 0 and cell_w or item_width + local effective_cell_h = cell_h > 0 and cell_h or item_height + local col = (index - 1) % columns + local row = math.floor((index - 1) / columns) + local margin_left = margin_of(item, "marginLeft") + local margin_right = margin_of(item, "marginRight") + local margin_top = margin_of(item, "marginTop") + local margin_bottom = margin_of(item, "marginBottom") + local inner_w = effective_cell_w - margin_left - margin_right + local inner_h = effective_cell_h - margin_top - margin_bottom + + node.x = origin_x + col * (effective_cell_w + gap_x) + margin_left + align_cross(inner_w, item_width, align) + node.y = origin_y + row * (effective_cell_h + gap_y) + margin_top + align_cross(inner_h, item_height, valign) + apply_parent(node, parent) + nodes[index] = node + end + + return nodes +end + +return layout diff --git a/assets/runtime/lua/runtime_commands.lua b/assets/runtime/lua/runtime_commands.lua new file mode 100644 index 0000000..5c49de4 --- /dev/null +++ b/assets/runtime/lua/runtime_commands.lua @@ -0,0 +1,261 @@ +---@class (exact) RuntimeCommandOpts +---@field id? string +---@field group? string +---@field commandGroup? string +---@field scope? string +---@field onComplete? string +---@field duration? number + +---@class (exact) RuntimeAudioCommandOpts: RuntimeCommandOpts +---@field volume? number + +---@class (exact) RuntimeBgmCommandOpts: RuntimeAudioCommandOpts +---@field channel? string +---@field loop? boolean + +---@class (exact) RuntimeSpineCommandOpts: RuntimeCommandOpts +---@field track? integer +---@field loop? boolean +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeResourceCommandOpts: RuntimeCommandOpts +---@field failOnError? boolean + +---@class RuntimeCommands +local commands = {} + +---@param opts? table +---@return table +local function copy_opts(opts) + local result = {} + if opts ~= nil then + for key, value in pairs(opts) do + result[key] = value + end + end + return result +end + +---@param command_type RuntimeCommandType +---@param opts? table +---@return RuntimeCommand +local function with_type(command_type, opts) + local command = copy_opts(opts) + command.type = command_type + return command +end + +---@param text string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.toast(text, opts) + local command = with_type("toast", opts) + command.text = text + return command +end + +---@param text string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.copy_text(text, opts) + local command = with_type("copy_text", opts) + command.text = text + return command +end + +---@param duration number +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.delay(duration, opts) + local command = with_type("delay", opts) + command.duration = duration + return command +end + +---@param items RuntimeCommand[] +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.sequence(items, opts) + local command = with_type("sequence", opts) + command.commands = items or {} + return command +end + +---@param items RuntimeCommand[] +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.parallel(items, opts) + local command = with_type("parallel", opts) + command.commands = items or {} + return command +end + +---@param target string +---@param path RuntimePoint[] +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.move_path(target, path, opts) + local command = with_type("move_path", opts) + command.target = target + command.path = path or {} + return command +end + +---@param target string +---@param x number +---@param y number +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.move_to(target, x, y, opts) + local command = with_type("move_to", opts) + command.target = target + command.x = x + command.y = y + return command +end + +---@param target string +---@param alpha number +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.fade_to(target, alpha, opts) + local command = with_type("fade_to", opts) + command.target = target + command.alpha = alpha + return command +end + +---@param target string +---@param scale number +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.scale_to(target, scale, opts) + local command = with_type("scale_to", opts) + command.target = target + command.scale = scale + return command +end + +---@param target string +---@param angle number +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.rotate_to(target, angle, opts) + local command = with_type("rotate_to", opts) + command.target = target + command.angle = angle + return command +end + +---@param target string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.remove_node(target, opts) + local command = with_type("remove_node", opts) + command.target = target + return command +end + +---@param target string +---@param animation string +---@param opts? RuntimeSpineCommandOpts +---@return RuntimeCommand +function commands.play_spine_animation(target, animation, opts) + local command = with_type("play_spine_animation", opts) + command.target = target + command.animation = animation + if command.loop == nil then + command.loop = true + end + return command +end + +---@param asset string +---@param opts? RuntimeAudioCommandOpts +---@return RuntimeCommand +function commands.play_sound(asset, opts) + local command = with_type("play_sound", opts) + command.asset = asset + return command +end + +---@param asset string +---@param opts? RuntimeBgmCommandOpts +---@return RuntimeCommand +function commands.play_bgm(asset, opts) + local command = with_type("play_bgm", opts) + command.asset = asset + if command.channel == nil then + command.channel = "bgm" + end + if command.loop == nil then + command.loop = true + end + return command +end + +---@param channel? string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.pause_bgm(channel, opts) + local command = with_type("pause_bgm", opts) + command.channel = channel or "bgm" + return command +end + +---@param channel? string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.resume_bgm(channel, opts) + local command = with_type("resume_bgm", opts) + command.channel = channel or "bgm" + return command +end + +---@param channel? string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.stop_bgm(channel, opts) + local command = with_type("stop_bgm", opts) + command.channel = channel or "bgm" + return command +end + +---@param group string +---@param opts? RuntimeResourceCommandOpts +---@return RuntimeCommand +function commands.preload_group(group, opts) + local command = with_type("preload_resources", opts) + command.group = group + return command +end + +---@param group string +---@param opts? RuntimeCommandOpts +---@return RuntimeCommand +function commands.evict_group(group, opts) + local command = with_type("evict_resources", opts) + command.group = group + return command +end + +---@param id string +---@return RuntimeCommand +function commands.cancel_id(id) + return { type = "cancel_commands", id = id } +end + +---@param group string +---@return RuntimeCommand +function commands.cancel_group(group) + return { type = "cancel_commands", group = group } +end + +---@param scope string +---@return RuntimeCommand +function commands.cancel_scope(scope) + return { type = "cancel_commands", scope = scope } +end + +return commands diff --git a/assets/runtime/lua/runtime_ui.lua b/assets/runtime/lua/runtime_ui.lua new file mode 100644 index 0000000..6c02dd1 --- /dev/null +++ b/assets/runtime/lua/runtime_ui.lua @@ -0,0 +1,427 @@ +---@class RuntimeUi +local runtime_ui = {} + +---@generic T: table +---@param base? T +---@param opts? table +---@return T +local function merge(base, opts) + local result = {} + for key, value in pairs(base or {}) do + result[key] = value + end + + if opts ~= nil then + for key, value in pairs(opts) do + result[key] = value + end + end + + return result +end + +---@param value any +---@return boolean +local function is_table(value) + return type(value) == "table" +end + +---@param opts? table +---@return table +local function normalize_opts(opts) + local source = opts or {} + local result = {} + for key, value in pairs(source) do + if key ~= "w" and key ~= "h" and key ~= "size" and key ~= "handler" and key ~= "onClick" then + result[key] = value + end + end + if result.width == nil then + result.width = source.w or source.size + end + if result.height == nil then + result.height = source.h or source.size + end + if result.onTap == nil then + result.onTap = source.handler or source.onClick + end + return result +end + +---@param base table +---@param opts? table +---@return table +local function node_opts(base, opts) + return merge(base, normalize_opts(opts)) +end + +---@param base? RuntimeNodeProps +---@param opts? RuntimeNodeProps +---@return RuntimeNodeProps +function runtime_ui.style(base, opts) + return merge(base or {}, opts) +end + +---@param parent string +---@param opts? RuntimeNodeProps +---@return RuntimeNodeProps +function runtime_ui.with_parent(parent, opts) + return merge(opts or {}, { parent = parent }) +end + +---@param node_type RuntimeNodeType +---@param id string +---@param opts? RuntimeNodeProps +---@return RuntimeNode +function runtime_ui.node(node_type, id, opts) + return node_opts({ id = id, type = node_type }, opts) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.panel(id, x, y, width, height, opts) + if is_table(x) then + return runtime_ui.node("panel", id, node_opts({ x = 0, y = 0, width = 0, height = 0 }, x)) + end + return runtime_ui.node("panel", id, node_opts({ + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.rect(id, x, y, width, height, opts) + if is_table(x) then + return runtime_ui.node("rect", id, node_opts({ x = 0, y = 0, width = 0, height = 0 }, x)) + end + return runtime_ui.node("rect", id, node_opts({ + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param size? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.circle(id, x, y, size, opts) + if is_table(x) then + return runtime_ui.node("circle", id, node_opts({ x = 0, y = 0, width = 0, height = 0 }, x)) + end + return runtime_ui.node("circle", id, node_opts({ + x = x, + y = y, + width = size, + height = size + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.line(id, x, y, width, height, opts) + if is_table(x) then + return runtime_ui.node("line", id, node_opts({ x = 0, y = 0, width = 0, height = 0 }, x)) + end + return runtime_ui.node("line", id, node_opts({ + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param value? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.progress(id, x, y, width, height, value, opts) + if is_table(x) then + return runtime_ui.node("progress", id, node_opts({ x = 0, y = 0, width = 0, height = 0, value = 0 }, x)) + end + return runtime_ui.node("progress", id, node_opts({ + x = x, + y = y, + width = width, + height = height, + value = value + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.particle(id, x, y, width, height, opts) + if is_table(x) then + return runtime_ui.node("particle", id, node_opts({ x = 0, y = 0, width = 0, height = 0 }, x)) + end + return runtime_ui.node("particle", id, node_opts({ + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param text string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.text(id, text, x, y, width, height, opts) + if is_table(text) then + return runtime_ui.node("text", id, node_opts({ text = "", x = 0, y = 0, width = 0, height = 0 }, text)) + end + return runtime_ui.node("text", id, node_opts({ + text = text, + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param text string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param handler? string +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.button(id, text, x, y, width, height, handler, opts) + if is_table(text) then + return runtime_ui.node("button", id, node_opts({ + text = "", + x = 0, + y = 0, + width = 0, + height = 0, + interactive = true + }, text)) + end + return runtime_ui.node("button", id, node_opts({ + text = text, + x = x, + y = y, + width = width, + height = height, + interactive = true, + onTap = handler + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.list_view(id, x, y, width, height, opts) + if is_table(x) then + return runtime_ui.node("listView", id, node_opts({ x = 0, y = 0, width = 0, height = 0 }, x)) + end + return runtime_ui.node("listView", id, node_opts({ + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param asset string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.image(id, asset, x, y, width, height, opts) + if is_table(asset) then + return runtime_ui.node("image", id, node_opts({ asset = "", x = 0, y = 0, width = 0, height = 0 }, asset)) + end + return runtime_ui.node("image", id, node_opts({ + asset = asset, + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param asset string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.sprite(id, asset, x, y, width, height, opts) + if is_table(asset) then + return runtime_ui.node("sprite", id, node_opts({ asset = "", x = 0, y = 0, width = 0, height = 0 }, asset)) + end + return runtime_ui.node("sprite", id, node_opts({ + asset = asset, + x = x, + y = y, + width = width, + height = height + }, opts)) +end + +---@param id string +---@param asset string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param animation? string +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function runtime_ui.spine(id, asset, x, y, width, height, animation, opts) + if is_table(asset) then + return runtime_ui.node("spine", id, node_opts({ asset = "", x = 0, y = 0, width = 0, height = 0, loop = true }, asset)) + end + return runtime_ui.node("spine", id, node_opts({ + asset = asset, + x = x, + y = y, + width = width, + height = height, + animation = animation, + loop = true + }, opts)) +end + +---@param id string +---@param props RuntimeNodeInit +---@return RuntimeNodeUpdate +function runtime_ui.update(id, props) + return { id = id, props = normalize_opts(props or {}) } +end + +---@param id string +---@param text string +---@return RuntimeNodeUpdate +function runtime_ui.text_update(id, text) + return runtime_ui.update(id, { text = text }) +end + +---@param id string +---@param visible boolean +---@return RuntimeNodeUpdate +function runtime_ui.visible_update(id, visible) + return runtime_ui.update(id, { visible = visible }) +end + +---@param id string +---@param alpha number +---@return RuntimeNodeUpdate +function runtime_ui.alpha_update(id, alpha) + return runtime_ui.update(id, { alpha = alpha }) +end + +---@param id string +---@param scale number +---@return RuntimeNodeUpdate +function runtime_ui.scale_update(id, scale) + return runtime_ui.update(id, { scale = scale }) +end + +---@param id string +---@param x number +---@param y number +---@return RuntimeNodeUpdate +function runtime_ui.position_update(id, x, y) + return runtime_ui.update(id, { x = x, y = y }) +end + +---@param id string +---@param width number +---@param height number +---@return RuntimeNodeUpdate +function runtime_ui.size_update(id, width, height) + return runtime_ui.update(id, { width = width, height = height }) +end + +---@param id string +---@param x number +---@param y number +---@param scale number +---@param rotation number +---@return RuntimeNodeUpdate +function runtime_ui.transform_update(id, x, y, scale, rotation) + return runtime_ui.update(id, { + x = x, + y = y, + scale = scale, + rotation = rotation + }) +end + +---@param ids string[] +---@param props RuntimeNodeInit +---@return RuntimeNodeUpdate[] +function runtime_ui.batch_update(ids, props) + local updates = {} + for _, id in ipairs(ids) do + table.insert(updates, runtime_ui.update(id, props)) + end + return updates +end + +---@param nodes RuntimeNode[] +---@param node RuntimeNode +---@return RuntimeNode[] +function runtime_ui.append(nodes, node) + table.insert(nodes, node) + return nodes +end + +---@param nodes RuntimeNode[] +---@param extra_nodes RuntimeNode[] +---@return RuntimeNode[] +function runtime_ui.append_all(nodes, extra_nodes) + for _, node in ipairs(extra_nodes) do + table.insert(nodes, node) + end + return nodes +end + +return runtime_ui diff --git a/assets/runtime/lua/runtime_widgets.lua b/assets/runtime/lua/runtime_widgets.lua new file mode 100644 index 0000000..e937ebd --- /dev/null +++ b/assets/runtime/lua/runtime_widgets.lua @@ -0,0 +1,773 @@ +local runtime_ui = runtime.import("runtime_ui") + +---@class (exact) RuntimeDialogButton +---@field id? string +---@field text string +---@field handler string +---@field color? string + +---@class (exact) RuntimeDialogOpts +---@field screenWidth? number +---@field screenHeight? number +---@field overlay? boolean +---@field overlayColor? string +---@field blockInput? boolean +---@field layer? integer +---@field color? string +---@field radius? number +---@field panelStyle? RuntimeNodeProps +---@field titleColor? string +---@field titleSize? number +---@field titleStyle? RuntimeNodeProps +---@field messageColor? string +---@field messageSize? number +---@field messageStyle? RuntimeNodeProps +---@field buttons? RuntimeDialogButton[] +---@field buttonGap? number +---@field buttonStyle? RuntimeNodeProps + +---@class (exact) RuntimeLabeledProgressOpts: RuntimeNodeProps +---@field labelHeight? number +---@field labelStyle? RuntimeNodeProps + +---@class RuntimePillOpts: RuntimeNodeInit +---@field panelStyle? RuntimeNodeProps +---@field textStyle? RuntimeNodeProps + +---@class RuntimeTextButtonOpts: RuntimeNodeInit +---@field variant? 'primary'|'secondary'|'ghost' + +---@class RuntimeListItemOpts: RuntimeTextButtonOpts +---@field selected? boolean +---@field activeColor? string +---@field inactiveColor? string + +---@class RuntimeTabItem +---@field id? string +---@field key? string +---@field text string +---@field handler? string +---@field selected? boolean + +---@class RuntimeTabsOpts: RuntimeNodeInit +---@field tabs RuntimeTabItem[] +---@field selected? string +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field activeColor? string +---@field inactiveColor? string +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeActionItem +---@field id? string +---@field text string +---@field handler? string +---@field visible? boolean +---@field color? string +---@field style? RuntimeNodeProps + +---@class RuntimeActionRowOpts: RuntimeNodeInit +---@field actions RuntimeActionItem[] +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimePanelHeaderOpts: RuntimeNodeInit +---@field eyebrow? string +---@field title string +---@field summary? string +---@field gap? number +---@field eyebrowId? string +---@field titleId? string +---@field summaryId? string +---@field eyebrowHeight? number +---@field titleHeight? number +---@field summaryHeight? number +---@field eyebrowStyle? RuntimeNodeProps +---@field titleStyle? RuntimeNodeProps +---@field summaryStyle? RuntimeNodeProps + +---@class RuntimeWidgetTheme +---@field primary? string +---@field secondary? string +---@field success? string +---@field overlay? string +---@field surface? string +---@field surfaceAlt? string +---@field card? string +---@field text? string +---@field muted? string +---@field progress? string +---@field transparent? string + +---@class RuntimeWidgets +local widgets = {} + +-- ----------------------------------------------------------------------------- +-- Theme/config +-- ----------------------------------------------------------------------------- + +---@type RuntimeWidgetTheme +local widget_theme = { + primary = "#ff2563eb", + secondary = "#ff475569", + success = "#ff22c55e", + overlay = "#99000000", + surface = "#ff1e293b", + surfaceAlt = "#ff334155", + card = "#ee111827", + text = "#ffffffff", + muted = "#ffe5e7eb", + progress = "#ff22c55e", + transparent = "#00000000" +} + +-- ----------------------------------------------------------------------------- +-- Internal helpers +-- ----------------------------------------------------------------------------- + +---@generic T: table +---@param base? T +---@param opts? table +---@return T +local function merge(base, opts) + local result = {} + for key, value in pairs(base or {}) do + result[key] = value + end + for key, value in pairs(opts or {}) do + result[key] = value + end + return result +end + +---@param value any +---@return boolean +local function is_table(value) + return type(value) == "table" +end + +---@param source? table +---@param keys string[] +---@return table +local function without_keys(source, keys) + local result = merge(source or {}, nil) + for _, key in ipairs(keys) do + result[key] = nil + end + return result +end + +---@param opts? RuntimeNodeInit +---@return RuntimeNodeInit +local function normalize_box(opts) + local result = merge(opts or {}, nil) + if result.width == nil then + result.width = result.w or result.size + end + if result.height == nil then + result.height = result.h or result.size + end + result.w = nil + result.h = nil + result.size = nil + return result +end + +---@param opts? RuntimeNodeInit +---@param fallback? table +---@return RuntimeNodeInit +local function with_box(opts, fallback) + return merge(fallback or {}, normalize_box(opts)) +end + +---@param target RuntimeNode[] +---@param source? RuntimeNode[] +---@return RuntimeNode[] +local function append_all(target, source) + for _, node in ipairs(source or {}) do + table.insert(target, node) + end + return target +end + +---@param parent string +---@param opts? RuntimeNodeProps +---@return RuntimeNodeProps +local function child_opts(parent, opts) + return merge(opts or {}, { parent = parent }) +end + +---@param value table +---@param opts? table +---@param key string +---@return table, table +local function collection_args(value, opts, key) + local options = opts or {} + local items = value + if is_table(value) and value[key] ~= nil then + options = value + items = value[key] + end + return items or {}, options +end + +---@param tokens? RuntimeWidgetTheme +---@return RuntimeWidgets +function widgets.configure(tokens) + widget_theme = merge(widget_theme, tokens or {}) + return widgets +end + +---@param name string +---@return string +local function theme_color(name) + return widget_theme[name] or "#ffffffff" +end + +-- ----------------------------------------------------------------------------- +-- Text helpers +-- ----------------------------------------------------------------------------- + +---@param id string +---@param text string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function widgets.label(id, text, x, y, width, height, opts) + local fallback = { text = "", x = 0, y = 0, width = 0, height = 0 } + local options + if is_table(text) then + options = with_box(text, fallback) + else + options = with_box(merge({ text = text, x = x, y = y, width = width, height = height }, opts), fallback) + end + return runtime_ui.text(id, merge({ + color = theme_color("muted"), + fontSize = 14, + textAlign = "left" + }, options)) +end + +---@param id string +---@param text string|RuntimeNodeInit +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function widgets.section_title(id, text, x, y, width, height, opts) + local options + if is_table(text) then + options = text + else + options = merge({ text = text, x = x, y = y, width = width, height = height }, opts) + end + return widgets.label(id, merge({ + color = theme_color("text"), + fontSize = 18, + textAlign = "left" + }, options)) +end + +-- ----------------------------------------------------------------------------- +-- Badges and buttons +-- ----------------------------------------------------------------------------- + +---@param id string +---@param text string|RuntimePillOpts +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimePillOpts +---@return RuntimeNode[] +function widgets.pill(id, text, x, y, width, height, opts) + local options + if is_table(text) then + options = with_box(text, { text = "", x = 0, y = 0, width = 0, height = 0 }) + else + options = with_box(merge({ text = text, x = x, y = y, width = width, height = height }, opts), { + text = "", + x = 0, + y = 0, + width = 0, + height = 0 + }) + end + local panel_opts = merge({ + color = theme_color("surfaceAlt"), + radius = options.height / 2 + }, options.panelStyle) + panel_opts = merge(panel_opts, without_keys(options, { "text", "panelStyle", "textStyle" })) + local text_opts = child_opts(id, merge({ + color = theme_color("text"), + fontSize = 12, + textAlign = "center" + }, options.textStyle)) + return { + runtime_ui.panel(id, panel_opts), + runtime_ui.text(id .. "_text", merge({ + text = options.text or "", + x = 0, + y = 0, + width = options.width, + height = options.height + }, text_opts)) + } +end + +---@param id string +---@param text string|RuntimeTextButtonOpts +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param handler? string +---@param opts? RuntimeTextButtonOpts +---@return RuntimeNode +function widgets.text_button(id, text, x, y, width, height, handler, opts) + local options + if is_table(text) then + options = with_box(text, { text = "", x = 0, y = 0, width = 0, height = 0 }) + else + options = with_box(merge({ text = text, x = x, y = y, width = width, height = height, handler = handler }, opts), { + text = "", + x = 0, + y = 0, + width = 0, + height = 0 + }) + end + local variant = options.variant or "primary" + local color = theme_color("primary") + if variant == "secondary" then + color = theme_color("secondary") + elseif variant == "ghost" then + color = theme_color("transparent") + end + return runtime_ui.button(id, merge({ + color = color, + radius = 10, + fontSize = 13, + textAlign = "center" + }, without_keys(options, { "variant" }))) +end + +---@param id string +---@param text string|RuntimeListItemOpts +---@param x? number +---@param y? number +---@param width? number +---@param height? number +---@param handler? string +---@param opts? RuntimeListItemOpts +---@return RuntimeNode +function widgets.list_item(id, text, x, y, width, height, handler, opts) + local options + if is_table(text) then + options = with_box(text, { text = "", x = 0, y = 0, width = 0, height = 0 }) + else + options = with_box(merge({ text = text, x = x, y = y, width = width, height = height, handler = handler }, opts), { + text = "", + x = 0, + y = 0, + width = 0, + height = 0 + }) + end + local selected = options.selected == true + local color = selected and (options.activeColor or theme_color("primary")) or (options.inactiveColor or theme_color("surface")) + return widgets.text_button(id, merge({ + color = color, + radius = 10, + fontSize = 12 + }, without_keys(options, { "selected", "activeColor", "inactiveColor" }))) +end + +---@param id string +---@param tabs RuntimeTabItem[]|RuntimeTabsOpts +---@param opts? RuntimeTabsOpts +---@return RuntimeNode[] +function widgets.tabs(id, tabs, opts) + local items, options = collection_args(tabs, opts, "tabs") + + local origin_x = options.x or 0 + local origin_y = options.y or 0 + local gap = options.gap or 6 + local item_w = options.itemWidth or options.width or options.w or 72 + local item_h = options.itemHeight or options.height or options.h or 24 + local nodes = {} + + for index, tab in ipairs(items) do + local key = tab.key or tostring(index) + local selected = tab.selected == true or key == options.selected + local node_id = tab.id or (id .. "_" .. key) + local style = merge({ + x = origin_x + (index - 1) * (item_w + gap), + y = origin_y, + w = item_w, + h = item_h, + text = tab.text or key, + handler = tab.handler or key, + selected = selected, + activeColor = options.activeColor, + inactiveColor = options.inactiveColor + }, options.buttonStyle) + style = merge(style, without_keys(options, { + "tabs", + "selected", + "gap", + "itemWidth", + "itemHeight", + "activeColor", + "inactiveColor", + "buttonStyle", + "x", + "y", + "width", + "height", + "w", + "h" + })) + nodes[index] = widgets.list_item(node_id, style) + end + + return nodes +end + +---@param id string +---@param actions RuntimeActionItem[]|RuntimeActionRowOpts +---@param opts? RuntimeActionRowOpts +---@return RuntimeNode[] +function widgets.action_row(id, actions, opts) + local items, options = collection_args(actions, opts, "actions") + + local count = #items + local gap = options.gap or 8 + local origin_x = options.x or 0 + local origin_y = options.y or 0 + local item_h = options.itemHeight or options.height or options.h or 32 + local item_w = options.itemWidth + if item_w == nil and (options.width ~= nil or options.w ~= nil) and count > 0 then + item_w = ((options.width or options.w) - gap * (count - 1)) / count + end + item_w = item_w or 88 + + local nodes = {} + for index, action in ipairs(items) do + local visible = action.visible ~= false + local style = merge({ + x = origin_x + (index - 1) * (item_w + gap), + y = origin_y, + w = item_w, + h = item_h, + text = visible and (action.text or "") or "", + handler = visible and (action.handler or "noop") or "noop", + color = action.color or (index == 1 and theme_color("primary") or theme_color("surfaceAlt")), + visible = visible + }, options.buttonStyle) + style = merge(style, action.style) + style = merge(style, without_keys(options, { + "actions", + "gap", + "itemWidth", + "itemHeight", + "buttonStyle", + "x", + "y", + "width", + "height", + "w", + "h" + })) + nodes[index] = widgets.text_button(action.id or (id .. "_" .. tostring(index)), style) + end + + return nodes +end + +-- ----------------------------------------------------------------------------- +-- Panels and headers +-- ----------------------------------------------------------------------------- + +---@param id string +---@param opts RuntimePanelHeaderOpts +---@return RuntimeNode[] +function widgets.panel_header(id, opts) + local options = with_box(opts or {}, { x = 0, y = 0, width = 0, height = 0, title = "" }) + local nodes = {} + local cursor = options.y + local gap = options.gap or 4 + local layer = options.layer + local parent = options.parent + + if options.eyebrow ~= nil and options.eyebrow ~= "" then + local h = options.eyebrowHeight or 20 + table.insert(nodes, widgets.label(options.eyebrowId or (id .. "_eyebrow"), merge({ + text = options.eyebrow, + x = options.x, + y = cursor, + width = options.width, + height = h, + parent = parent, + layer = layer, + color = theme_color("primary"), + fontSize = 13 + }, options.eyebrowStyle))) + cursor = cursor + h + gap + end + + local title_h = options.titleHeight or 28 + table.insert(nodes, widgets.section_title(options.titleId or (id .. "_title"), merge({ + text = options.title or "", + x = options.x, + y = cursor, + width = options.width, + height = title_h, + parent = parent, + layer = layer, + fontSize = 20 + }, options.titleStyle))) + cursor = cursor + title_h + gap + + if options.summary ~= nil and options.summary ~= "" then + local h = options.summaryHeight or 22 + table.insert(nodes, widgets.label(options.summaryId or (id .. "_summary"), merge({ + text = options.summary, + x = options.x, + y = cursor, + width = options.width, + height = h, + parent = parent, + layer = layer, + color = theme_color("muted"), + fontSize = 12 + }, options.summaryStyle))) + end + + return nodes +end + +---@param id string +---@param width number|RuntimeNodeInit +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function widgets.overlay(id, width, height, opts) + if is_table(width) then + return runtime_ui.rect(id, merge({ + x = 0, + y = 0, + color = theme_color("overlay"), + layer = 900 + }, width)) + end + return runtime_ui.rect(id, 0, 0, width, height, merge({ + color = theme_color("overlay"), + layer = 900 + }, opts)) +end + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function widgets.card(id, x, y, width, height, opts) + if is_table(x) then + return runtime_ui.panel(id, merge({ + x = 0, + y = 0, + width = 0, + height = 0, + color = theme_color("card"), + radius = 14, + layer = 910 + }, x)) + end + return runtime_ui.panel(id, x, y, width, height, merge({ + color = theme_color("card"), + radius = 14, + layer = 910 + }, opts)) +end + +-- ----------------------------------------------------------------------------- +-- Progress +-- ----------------------------------------------------------------------------- + +---@param id string +---@param x number|RuntimeNodeInit +---@param y? number +---@param width? number +---@param height? number +---@param value? number +---@param opts? RuntimeNodeInit +---@return RuntimeNode +function widgets.progress_bar(id, x, y, width, height, value, opts) + if is_table(x) then + return runtime_ui.progress(id, merge({ + x = 0, + y = 0, + width = 0, + height = 0, + value = 0, + color = theme_color("progress"), + radius = 6 + }, x)) + end + return runtime_ui.progress(id, x, y, width, height, value, merge({ + color = theme_color("progress"), + radius = 6 + }, opts)) +end + +---@param id string +---@param label string +---@param x number +---@param y number +---@param width number +---@param height number +---@param value number +---@param opts? RuntimeLabeledProgressOpts +---@return RuntimeNode[] +function widgets.labeled_progress(id, label, x, y, width, height, value, opts) + local label_height = opts ~= nil and opts.labelHeight or 24 + local progress_opts = merge(opts or {}, nil) + progress_opts.labelHeight = nil + progress_opts.labelStyle = nil + return { + runtime_ui.text(id .. "_label", label, x, y, width, label_height, merge({ + color = theme_color("text"), + fontSize = 16 + }, opts ~= nil and opts.labelStyle or nil)), + widgets.progress_bar(id, x, y + label_height + 6, width, height, value, progress_opts) + } +end + +-- ----------------------------------------------------------------------------- +-- Dialogs +-- ----------------------------------------------------------------------------- + +---@param parent string +---@param id string +---@param buttons RuntimeDialogButton[] +---@param x number +---@param y number +---@param width number +---@param height number +---@param gap? number +---@param opts? RuntimeNodeProps +---@return RuntimeNode[] +function widgets.button_row(parent, id, buttons, x, y, width, height, gap, opts) + local nodes = {} + local count = #buttons + if count == 0 then + return nodes + end + + local actual_gap = gap or 8 + local button_width = (width - actual_gap * (count - 1)) / count + for index, button in ipairs(buttons) do + local button_id = button.id or (id .. "_button_" .. index) + table.insert(nodes, runtime_ui.button( + button_id, + button.text or "OK", + x + (index - 1) * (button_width + actual_gap), + y, + button_width, + height, + button.handler, + child_opts(parent, merge({ + layer = 920, + color = button.color or theme_color("primary"), + radius = 10 + }, opts)) + )) + end + return nodes +end + +---@param id string +---@param title string +---@param message string +---@param x number +---@param y number +---@param width number +---@param height number +---@param opts? RuntimeDialogOpts +---@return RuntimeNode[] +function widgets.dialog(id, title, message, x, y, width, height, opts) + local options = opts or {} + local nodes = {} + local layer = options.layer or 900 + local screen_width = options.screenWidth or 720 + local screen_height = options.screenHeight or 720 + + if options.overlay ~= false then + table.insert(nodes, widgets.overlay(id .. "_overlay", screen_width, screen_height, { + layer = layer, + color = options.overlayColor or theme_color("overlay"), + interactive = options.blockInput == true + })) + end + + table.insert(nodes, widgets.card(id, x, y, width, height, merge({ + layer = layer + 1, + color = options.color or theme_color("card"), + radius = options.radius or 16 + }, options.panelStyle))) + + table.insert(nodes, runtime_ui.text( + id .. "_title", + title or "", + 20, + 18, + width - 40, + 32, + child_opts(id, merge({ + layer = layer + 2, + color = options.titleColor or theme_color("text"), + fontSize = options.titleSize or 22 + }, options.titleStyle)) + )) + + table.insert(nodes, runtime_ui.text( + id .. "_message", + message or "", + 20, + 60, + width - 40, + height - 116, + child_opts(id, merge({ + layer = layer + 2, + color = options.messageColor or theme_color("muted"), + fontSize = options.messageSize or 16 + }, options.messageStyle)) + )) + + append_all(nodes, widgets.button_row( + id, + id, + options.buttons or {}, + 20, + height - 48, + width - 40, + 34, + options.buttonGap or 8, + options.buttonStyle + )) + + return nodes +end + +return widgets diff --git a/example/.gitignore b/example/.gitignore new file mode 100644 index 0000000..3820a95 --- /dev/null +++ b/example/.gitignore @@ -0,0 +1,45 @@ +# Miscellaneous +*.class +*.log +*.pyc +*.swp +.DS_Store +.atom/ +.build/ +.buildlog/ +.history +.svn/ +.swiftpm/ +migrate_working_dir/ + +# IntelliJ related +*.iml +*.ipr +*.iws +.idea/ + +# The .vscode folder contains launch configuration and tasks you configure in +# VS Code which you may wish to be included in version control, so this line +# is commented out by default. +#.vscode/ + +# Flutter/Dart/Pub related +**/doc/api/ +**/ios/Flutter/.last_build_id +.dart_tool/ +.flutter-plugins-dependencies +.pub-cache/ +.pub/ +/build/ +/coverage/ + +# Symbolication related +app.*.symbols + +# Obfuscation related +app.*.map.json + +# Android Studio will place build artifacts here +/android/app/debug +/android/app/profile +/android/app/release diff --git a/example/.luarc.json b/example/.luarc.json new file mode 100644 index 0000000..f2f5726 --- /dev/null +++ b/example/.luarc.json @@ -0,0 +1,17 @@ +{ + "$schema": "https://raw.githubusercontent.com/LuaLS/vscode-lua/master/setting/schema.json", + "runtime.version": "Lua 5.4", + "workspace.checkThirdParty": false, + "diagnostics.globals": ["runtime"], + "diagnostics.neededFileStatus": { + "undefined-field": "Any", + "inject-field": "Any", + "assign-type-mismatch": "Any", + "param-type-mismatch": "Any", + "return-type-mismatch": "Any", + "missing-fields": "Any", + "undefined-global": "Any" + }, + "type.weakUnionCheck": true, + "type.weakNilCheck": true +} diff --git a/example/.metadata b/example/.metadata new file mode 100644 index 0000000..5f4336f --- /dev/null +++ b/example/.metadata @@ -0,0 +1,45 @@ +# This file tracks properties of this Flutter project. +# Used by Flutter tool to assess capabilities and perform upgrades etc. +# +# This file should be version controlled and should not be manually edited. + +version: + revision: "adc901062556672b4138e18a4dc62a4be8f4b3c2" + channel: "stable" + +project_type: app + +# Tracks metadata for the flutter migrate command +migration: + platforms: + - platform: root + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + - platform: android + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + - platform: ios + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + - platform: linux + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + - platform: macos + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + - platform: web + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + - platform: windows + create_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + base_revision: adc901062556672b4138e18a4dc62a4be8f4b3c2 + + # User provided section + + # List of Local paths (relative to this file) that should be + # ignored by the migrate tool. + # + # Files that are not part of the templates will be ignored by default. + unmanaged_files: + - 'lib/main.dart' + - 'ios/Runner.xcodeproj/project.pbxproj' diff --git a/example/README.md b/example/README.md new file mode 100644 index 0000000..62a1d0e --- /dev/null +++ b/example/README.md @@ -0,0 +1,16 @@ +# flame_lua_ludo + +A new Flutter project. + +## Getting Started + +This project is a starting point for a Flutter application. + +A few resources to get you started if this is your first Flutter project: + +- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) +- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) + +For help getting started with Flutter development, view the +[online documentation](https://docs.flutter.dev/), which offers tutorials, +samples, guidance on mobile development, and a full API reference. diff --git a/example/analysis_options.yaml b/example/analysis_options.yaml new file mode 100644 index 0000000..0d29021 --- /dev/null +++ b/example/analysis_options.yaml @@ -0,0 +1,28 @@ +# This file configures the analyzer, which statically analyzes Dart code to +# check for errors, warnings, and lints. +# +# The issues identified by the analyzer are surfaced in the UI of Dart-enabled +# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be +# invoked from the command line by running `flutter analyze`. + +# The following line activates a set of recommended lints for Flutter apps, +# packages, and plugins designed to encourage good coding practices. +include: package:flutter_lints/flutter.yaml + +linter: + # The lint rules applied to this project can be customized in the + # section below to disable rules from the `package:flutter_lints/flutter.yaml` + # included above or to enable additional rules. A list of all available lints + # and their documentation is published at https://dart.dev/lints. + # + # Instead of disabling a lint rule for the entire project in the + # section below, it can also be suppressed for a single line of code + # or a specific dart file by using the `// ignore: name_of_lint` and + # `// ignore_for_file: name_of_lint` syntax on the line or in the file + # producing the lint. + rules: + # avoid_print: false # Uncomment to disable the `avoid_print` rule + # prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule + +# Additional information about this file can be found at +# https://dart.dev/guides/language/analysis-options diff --git a/example/android/.gitignore b/example/android/.gitignore new file mode 100644 index 0000000..be3943c --- /dev/null +++ b/example/android/.gitignore @@ -0,0 +1,14 @@ +gradle-wrapper.jar +/.gradle +/captures/ +/gradlew +/gradlew.bat +/local.properties +GeneratedPluginRegistrant.java +.cxx/ + +# Remember to never publicly share your keystore. +# See https://flutter.dev/to/reference-keystore +key.properties +**/*.keystore +**/*.jks diff --git a/example/android/app/build.gradle.kts b/example/android/app/build.gradle.kts new file mode 100644 index 0000000..2b50fa5 --- /dev/null +++ b/example/android/app/build.gradle.kts @@ -0,0 +1,44 @@ +plugins { + id("com.android.application") + id("kotlin-android") + // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins. + id("dev.flutter.flutter-gradle-plugin") +} + +android { + namespace = "dev.flame_lua.runtime_showcase" + compileSdk = flutter.compileSdkVersion + ndkVersion = flutter.ndkVersion + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_11 + targetCompatibility = JavaVersion.VERSION_11 + } + + kotlinOptions { + jvmTarget = JavaVersion.VERSION_11.toString() + } + + defaultConfig { + // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html). + applicationId = "dev.flame_lua.runtime_showcase" + // You can update the following values to match your application needs. + // For more information, see: https://flutter.dev/to/review-gradle-config. + minSdk = flutter.minSdkVersion + targetSdk = flutter.targetSdkVersion + versionCode = flutter.versionCode + versionName = flutter.versionName + } + + buildTypes { + release { + // TODO: Add your own signing config for the release build. + // Signing with the debug keys for now, so `flutter run --release` works. + signingConfig = signingConfigs.getByName("debug") + } + } +} + +flutter { + source = "../.." +} diff --git a/example/android/app/src/debug/AndroidManifest.xml b/example/android/app/src/debug/AndroidManifest.xml new file mode 100644 index 0000000..399f698 --- /dev/null +++ b/example/android/app/src/debug/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/example/android/app/src/main/AndroidManifest.xml b/example/android/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..ffb7d68 --- /dev/null +++ b/example/android/app/src/main/AndroidManifest.xml @@ -0,0 +1,45 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/example/android/app/src/main/kotlin/dev/flame_lua/runtime_showcase/MainActivity.kt b/example/android/app/src/main/kotlin/dev/flame_lua/runtime_showcase/MainActivity.kt new file mode 100644 index 0000000..2da27cd --- /dev/null +++ b/example/android/app/src/main/kotlin/dev/flame_lua/runtime_showcase/MainActivity.kt @@ -0,0 +1,5 @@ +package dev.flame_lua.runtime_showcase + +import io.flutter.embedding.android.FlutterActivity + +class MainActivity : FlutterActivity() diff --git a/example/android/app/src/main/res/drawable-v21/launch_background.xml b/example/android/app/src/main/res/drawable-v21/launch_background.xml new file mode 100644 index 0000000..f74085f --- /dev/null +++ b/example/android/app/src/main/res/drawable-v21/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/example/android/app/src/main/res/drawable/launch_background.xml b/example/android/app/src/main/res/drawable/launch_background.xml new file mode 100644 index 0000000..304732f --- /dev/null +++ b/example/android/app/src/main/res/drawable/launch_background.xml @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png b/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..db77bb4b7b0906d62b1847e87f15cdcacf6a4f29 GIT binary patch literal 544 zcmeAS@N?(olHy`uVBq!ia0vp^9w5xY3?!3`olAj~WQl7;NpOBzNqJ&XDuZK6ep0G} zXKrG8YEWuoN@d~6R2!h8bpbvhu0Wd6uZuB!w&u2PAxD2eNXD>P5D~Wn-+_Wa#27Xc zC?Zj|6r#X(-D3u$NCt}(Ms06KgJ4FxJVv{GM)!I~&n8Bnc94O7-Hd)cjDZswgC;Qs zO=b+9!WcT8F?0rF7!Uys2bs@gozCP?z~o%U|N3vA*22NaGQG zlg@K`O_XuxvZ&Ks^m&R!`&1=spLvfx7oGDKDwpwW`#iqdw@AL`7MR}m`rwr|mZgU`8P7SBkL78fFf!WnuYWm$5Z0 zNXhDbCv&49sM544K|?c)WrFfiZvCi9h0O)B3Pgg&ebxsLQ05GG~ AQ2+n{ literal 0 HcmV?d00001 diff --git a/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png b/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..17987b79bb8a35cc66c3c1fd44f5a5526c1b78be GIT binary patch literal 442 zcmeAS@N?(olHy`uVBq!ia0vp^1|ZDA3?vioaBc-sk|nMYCBgY=CFO}lsSJ)O`AMk? zp1FzXsX?iUDV2pMQ*D5Xx&nMcT!A!W`0S9QKQy;}1Cl^CgaH=;G9cpY;r$Q>i*pfB zP2drbID<_#qf;rPZx^FqH)F_D#*k@@q03KywUtLX8Ua?`H+NMzkczFPK3lFz@i_kW%1NOn0|D2I9n9wzH8m|-tHjsw|9>@K=iMBhxvkv6m8Y-l zytQ?X=U+MF$@3 zt`~i=@j|6y)RWMK--}M|=T`o&^Ni>IoWKHEbBXz7?A@mgWoL>!*SXo`SZH-*HSdS+ yn*9;$7;m`l>wYBC5bq;=U}IMqLzqbYCidGC!)_gkIk_C@Uy!y&wkt5C($~2D>~)O*cj@FGjOCM)M>_ixfudOh)?xMu#Fs z#}Y=@YDTwOM)x{K_j*Q;dPdJ?Mz0n|pLRx{4n|)f>SXlmV)XB04CrSJn#dS5nK2lM zrZ9#~WelCp7&e13Y$jvaEXHskn$2V!!DN-nWS__6T*l;H&Fopn?A6HZ-6WRLFP=R` zqG+CE#d4|IbyAI+rJJ`&x9*T`+a=p|0O(+s{UBcyZdkhj=yS1>AirP+0R;mf2uMgM zC}@~JfByORAh4SyRgi&!(cja>F(l*O+nd+@4m$|6K6KDn_&uvCpV23&>G9HJp{xgg zoq1^2_p9@|WEo z*X_Uko@K)qYYv~>43eQGMdbiGbo>E~Q& zrYBH{QP^@Sti!`2)uG{irBBq@y*$B zi#&(U-*=fp74j)RyIw49+0MRPMRU)+a2r*PJ$L5roHt2$UjExCTZSbq%V!HeS7J$N zdG@vOZB4v_lF7Plrx+hxo7(fCV&}fHq)$ literal 0 HcmV?d00001 diff --git a/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png b/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..d5f1c8d34e7a88e3f88bea192c3a370d44689c3c GIT binary patch literal 1031 zcmeAS@N?(olHy`uVBq!ia0vp^6F``Q8Ax83A=Cw=BuiW)N`mv#O3D+9QW+dm@{>{( zJaZG%Q-e|yQz{EjrrIztFa`(sgt!6~Yi|1%a`XoT0ojZ}lNrNjb9xjc(B0U1_% zz5^97Xt*%oq$rQy4?0GKNfJ44uvxI)gC`h-NZ|&0-7(qS@?b!5r36oQ}zyZrNO3 zMO=Or+<~>+A&uN&E!^Sl+>xE!QC-|oJv`ApDhqC^EWD|@=#J`=d#Xzxs4ah}w&Jnc z$|q_opQ^2TrnVZ0o~wh<3t%W&flvYGe#$xqda2bR_R zvPYgMcHgjZ5nSA^lJr%;<&0do;O^tDDh~=pIxA#coaCY>&N%M2^tq^U%3DB@ynvKo}b?yu-bFc-u0JHzced$sg7S3zqI(2 z#Km{dPr7I=pQ5>FuK#)QwK?Y`E`B?nP+}U)I#c1+FM*1kNvWG|a(TpksZQ3B@sD~b zpQ2)*V*TdwjFOtHvV|;OsiDqHi=6%)o4b!)x$)%9pGTsE z-JL={-Ffv+T87W(Xpooq<`r*VzWQcgBN$$`u}f>-ZQI1BB8ykN*=e4rIsJx9>z}*o zo~|9I;xof literal 0 HcmV?d00001 diff --git a/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png b/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..4d6372eebdb28e45604e46eeda8dd24651419bc0 GIT binary patch literal 1443 zcmb`G{WsKk6vsdJTdFg%tJav9_E4vzrOaqkWF|A724Nly!y+?N9`YV6wZ}5(X(D_N(?!*n3`|_r0Hc?=PQw&*vnU?QTFY zB_MsH|!j$PP;I}?dppoE_gA(4uc!jV&0!l7_;&p2^pxNo>PEcNJv za5_RT$o2Mf!<+r?&EbHH6nMoTsDOa;mN(wv8RNsHpG)`^ymG-S5By8=l9iVXzN_eG%Xg2@Xeq76tTZ*dGh~Lo9vl;Zfs+W#BydUw zCkZ$o1LqWQO$FC9aKlLl*7x9^0q%0}$OMlp@Kk_jHXOjofdePND+j!A{q!8~Jn+s3 z?~~w@4?egS02}8NuulUA=L~QQfm;MzCGd)XhiftT;+zFO&JVyp2mBww?;QByS_1w! zrQlx%{^cMj0|Bo1FjwY@Q8?Hx0cIPF*@-ZRFpPc#bBw{5@tD(5%sClzIfl8WU~V#u zm5Q;_F!wa$BSpqhN>W@2De?TKWR*!ujY;Yylk_X5#~V!L*Gw~;$%4Q8~Mad z@`-kG?yb$a9cHIApZDVZ^U6Xkp<*4rU82O7%}0jjHlK{id@?-wpN*fCHXyXh(bLt* zPc}H-x0e4E&nQ>y%B-(EL=9}RyC%MyX=upHuFhAk&MLbsF0LP-q`XnH78@fT+pKPW zu72MW`|?8ht^tz$iC}ZwLp4tB;Q49K!QCF3@!iB1qOI=?w z7In!}F~ij(18UYUjnbmC!qKhPo%24?8U1x{7o(+?^Zu0Hx81|FuS?bJ0jgBhEMzf< zCgUq7r2OCB(`XkKcN-TL>u5y#dD6D!)5W?`O5)V^>jb)P)GBdy%t$uUMpf$SNV31$ zb||OojAbvMP?T@$h_ZiFLFVHDmbyMhJF|-_)HX3%m=CDI+ID$0^C>kzxprBW)hw(v zr!Gmda);ICoQyhV_oP5+C%?jcG8v+D@9f?Dk*!BxY}dazmrT@64UrP3hlslANK)bq z$67n83eh}OeW&SV@HG95P|bjfqJ7gw$e+`Hxo!4cx`jdK1bJ>YDSpGKLPZ^1cv$ek zIB?0S<#tX?SJCLWdMd{-ME?$hc7A$zBOdIJ)4!KcAwb=VMov)nK;9z>x~rfT1>dS+ zZ6#`2v@`jgbqq)P22H)Tx2CpmM^o1$B+xT6`(v%5xJ(?j#>Q$+rx_R|7TzDZe{J6q zG1*EcU%tE?!kO%^M;3aM6JN*LAKUVb^xz8-Pxo#jR5(-KBeLJvA@-gxNHx0M-ZJLl z;#JwQoh~9V?`UVo#}{6ka@II>++D@%KqGpMdlQ}?9E*wFcf5(#XQnP$Dk5~%iX^>f z%$y;?M0BLp{O3a(-4A?ewryHrrD%cx#Q^%KY1H zNre$ve+vceSLZcNY4U(RBX&)oZn*Py()h)XkE?PL$!bNb{N5FVI2Y%LKEm%yvpyTP z(1P?z~7YxD~Rf<(a@_y` literal 0 HcmV?d00001 diff --git a/example/android/app/src/main/res/values-night/styles.xml b/example/android/app/src/main/res/values-night/styles.xml new file mode 100644 index 0000000..06952be --- /dev/null +++ b/example/android/app/src/main/res/values-night/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/example/android/app/src/main/res/values/styles.xml b/example/android/app/src/main/res/values/styles.xml new file mode 100644 index 0000000..cb1ef88 --- /dev/null +++ b/example/android/app/src/main/res/values/styles.xml @@ -0,0 +1,18 @@ + + + + + + + diff --git a/example/android/app/src/profile/AndroidManifest.xml b/example/android/app/src/profile/AndroidManifest.xml new file mode 100644 index 0000000..399f698 --- /dev/null +++ b/example/android/app/src/profile/AndroidManifest.xml @@ -0,0 +1,7 @@ + + + + diff --git a/example/android/build.gradle.kts b/example/android/build.gradle.kts new file mode 100644 index 0000000..dbee657 --- /dev/null +++ b/example/android/build.gradle.kts @@ -0,0 +1,24 @@ +allprojects { + repositories { + google() + mavenCentral() + } +} + +val newBuildDir: Directory = + rootProject.layout.buildDirectory + .dir("../../build") + .get() +rootProject.layout.buildDirectory.value(newBuildDir) + +subprojects { + val newSubprojectBuildDir: Directory = newBuildDir.dir(project.name) + project.layout.buildDirectory.value(newSubprojectBuildDir) +} +subprojects { + project.evaluationDependsOn(":app") +} + +tasks.register("clean") { + delete(rootProject.layout.buildDirectory) +} diff --git a/example/android/gradle.properties b/example/android/gradle.properties new file mode 100644 index 0000000..f018a61 --- /dev/null +++ b/example/android/gradle.properties @@ -0,0 +1,3 @@ +org.gradle.jvmargs=-Xmx8G -XX:MaxMetaspaceSize=4G -XX:ReservedCodeCacheSize=512m -XX:+HeapDumpOnOutOfMemoryError +android.useAndroidX=true +android.enableJetifier=true diff --git a/example/android/gradle/wrapper/gradle-wrapper.properties b/example/android/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..ac3b479 --- /dev/null +++ b/example/android/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.12-all.zip diff --git a/example/android/settings.gradle.kts b/example/android/settings.gradle.kts new file mode 100644 index 0000000..fb605bc --- /dev/null +++ b/example/android/settings.gradle.kts @@ -0,0 +1,26 @@ +pluginManagement { + val flutterSdkPath = + run { + val properties = java.util.Properties() + file("local.properties").inputStream().use { properties.load(it) } + val flutterSdkPath = properties.getProperty("flutter.sdk") + require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" } + flutterSdkPath + } + + includeBuild("$flutterSdkPath/packages/flutter_tools/gradle") + + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} + +plugins { + id("dev.flutter.flutter-plugin-loader") version "1.0.0" + id("com.android.application") version "8.9.1" apply false + id("org.jetbrains.kotlin.android") version "2.1.0" apply false +} + +include(":app") diff --git a/example/assets/games/flight/manifest.json b/example/assets/games/flight/manifest.json new file mode 100644 index 0000000..0cd4c0a --- /dev/null +++ b/example/assets/games/flight/manifest.json @@ -0,0 +1,22 @@ +{ + "gameId": "flight", + "name": "Lua 飞行棋基础版", + "version": "0.1.0", + "runtimeApiVersion": 1, + "entry": "scripts/main.lua", + "assetsBase": "assets", + "modules": { + "runtime_ui": "runtime:runtime_ui.lua", + "runtime_widgets": "runtime:runtime_widgets.lua", + "runtime_commands": "runtime:runtime_commands.lua", + "layout": "runtime:layout.lua", + "theme": "scripts/theme.lua", + "styles": "scripts/styles.lua", + "state": "scripts/state.lua", + "board": "scripts/board.lua", + "rules": "scripts/rules.lua", + "ui": "scripts/ui.lua", + "animation": "scripts/animation.lua" + }, + "resources": {} +} diff --git a/example/assets/games/flight/scripts/animation.lua b/example/assets/games/flight/scripts/animation.lua new file mode 100644 index 0000000..02a6509 --- /dev/null +++ b/example/assets/games/flight/scripts/animation.lua @@ -0,0 +1,17 @@ +---@type RuntimeCommands +local commands = runtime.import("runtime_commands") + +local animation = {} + +function animation.move_piece(piece_id, path) + return commands.move_path(piece_id, path, { + duration = 0.55, + onComplete = "piece_move_done" + }) +end + +function animation.toast(text) + return commands.toast(text) +end + +return animation diff --git a/example/assets/games/flight/scripts/board.lua b/example/assets/games/flight/scripts/board.lua new file mode 100644 index 0000000..7a94b9e --- /dev/null +++ b/example/assets/games/flight/scripts/board.lua @@ -0,0 +1,91 @@ +local board = { + route_length = 40, + finish_progress = 40, + start = { + red = 1, + yellow = 11, + blue = 21, + green = 31 + }, + homes = { + red = { + { x = 92, y = 132 }, + { x = 142, y = 132 } + }, + yellow = { + { x = 518, y = 132 }, + { x = 568, y = 132 } + }, + blue = { + { x = 518, y = 548 }, + { x = 568, y = 548 } + }, + green = { + { x = 92, y = 548 }, + { x = 142, y = 548 } + } + }, + finish = { + red = { + { x = 290, y = 330 }, + { x = 250, y = 330 } + }, + yellow = { + { x = 350, y = 330 }, + { x = 390, y = 330 } + }, + blue = { + { x = 350, y = 390 }, + { x = 390, y = 390 } + }, + green = { + { x = 290, y = 390 }, + { x = 250, y = 390 } + } + }, + route = {} +} + +local function add(x, y) + table.insert(board.route, { x = x, y = y }) +end + +for i = 0, 9 do add(200 + i * 32, 104) end +for i = 0, 9 do add(520, 136 + i * 32) end +for i = 0, 9 do add(488 - i * 32, 456) end +for i = 0, 9 do add(168, 424 - i * 32) end + +function board.home_position(piece) + local index = piece.id:sub(-1) == "2" and 2 or 1 + return board.homes[piece.owner][index] +end + +function board.finish_position(piece) + local index = piece.id:sub(-1) == "2" and 2 or 1 + return board.finish[piece.owner][index] +end + +function board.route_index(owner, progress) + local start = board.start[owner] + local index = start + progress - 1 + while index > board.route_length do + index = index - board.route_length + end + return index +end + +function board.route_position(owner, progress) + return board.route[board.route_index(owner, progress)] +end + +function board.position(piece) + if piece.status == "home" then + return board.home_position(piece) + end + if piece.status == "finished" then + return board.finish_position(piece) + end + return board.route_position(piece.owner, piece.progress) +end + +return board diff --git a/example/assets/games/flight/scripts/main.lua b/example/assets/games/flight/scripts/main.lua new file mode 100644 index 0000000..bef1ba1 --- /dev/null +++ b/example/assets/games/flight/scripts/main.lua @@ -0,0 +1,154 @@ +local state = runtime.import("state") +local rules = runtime.import("rules") +local ui = runtime.import("ui") +local animation = runtime.import("animation") +---@type RuntimeWidgets +local widgets = runtime.import("runtime_widgets") +local theme = runtime.import("theme") + +widgets.configure({ + primary = theme.colors.dice_button, + secondary = theme.colors.board_inner, + success = theme.colors.green, + overlay = "#99000000", + surface = theme.colors.top_bar, + surfaceAlt = theme.colors.board_inner, + card = theme.colors.top_bar, + text = theme.colors.text, + muted = theme.colors.muted_text, + progress = theme.colors.green, + transparent = "#00000000" +}) + +function smoke_test(ctx) + return ctx ~= nil + and ctx.runtimeApiVersion ~= nil + and state.current_player ~= nil + and rules.plan_move ~= nil + and ui.create_board_nodes ~= nil + and animation.move_piece ~= nil + and widgets.dialog ~= nil +end + +function init(ctx) + return { + render = { creates = ui.create_board_nodes() }, + ui = { creates = ui.create_ui_nodes() }, + commands = {} + } +end + +local function handle_roll_dice() + if state.phase == "game_over" then + return { commands = { animation.toast("游戏已结束") } } + end + + if state.phase ~= "waiting_roll" then + return { commands = { animation.toast("请先完成当前移动") } } + end + + state.dice = rules.next_dice() + local movable = rules.movable_pieces() + + if #movable == 0 then + local message = state.current_player .. " 无可移动飞机" + if state.dice ~= 6 then + state.current_player = rules.next_player() + end + state.phase = "waiting_roll" + return { + ui = { updates = ui.dice_and_status_updates() }, + render = { updates = ui.highlight_updates(rules.all_piece_ids(), false) }, + commands = { animation.toast(message) } + } + end + + state.phase = "waiting_piece" + return { + ui = { updates = ui.dice_and_status_updates() }, + render = { updates = ui.highlight_updates(movable, true) } + } +end + +local function handle_piece_tap(piece_id) + if state.phase ~= "waiting_piece" then + return {} + end + + local piece = state.pieces[piece_id] + if piece == nil or piece.owner ~= state.current_player or not rules.can_move(piece, state.dice) then + return { commands = { animation.toast("该飞机不能移动") } } + end + + local plan = rules.plan_move(piece, state.dice) + state.phase = "animating" + state.selected_piece = piece_id + state.pending_move = plan + + return { + ui = { updates = ui.dice_and_status_updates() }, + render = { updates = ui.highlight_updates(rules.all_piece_ids(), false) }, + commands = { animation.move_piece(piece_id, plan.path) } + } +end + +local function handle_move_done() + local plan = state.pending_move + if plan == nil then + state.phase = "waiting_roll" + return { ui = { updates = ui.dice_and_status_updates() } } + end + + rules.commit_move(plan) + local moved_piece = state.pieces[plan.piece_id] + local updates = ui.piece_position_updates(plan.captures) + table.insert(updates, ui.piece_position_update(plan.piece_id)) + + local messages = {} + if #plan.captures > 0 then + table.insert(messages, "撞回 " .. tostring(#plan.captures) .. " 架飞机") + end + + if rules.player_finished(moved_piece.owner) then + state.winner = moved_piece.owner + state.phase = "game_over" + table.insert(messages, moved_piece.owner .. " 获胜") + else + if state.dice ~= 6 then + state.current_player = rules.next_player() + else + table.insert(messages, "掷出 6，额外回合") + end + state.phase = "waiting_roll" + end + + state.selected_piece = nil + state.pending_move = nil + + local commands = {} + if #messages > 0 then + commands = { animation.toast(table.concat(messages, "；")) } + end + + return { + ui = { updates = ui.dice_and_status_updates() }, + render = { updates = updates }, + commands = commands + } +end + +function on_event(event) + if event.handler == "roll_dice" then + return handle_roll_dice() + end + + if event.handler == "piece_tap" then + return handle_piece_tap(event.target) + end + + if event.handler == "piece_move_done" then + return handle_move_done() + end + + return {} +end diff --git a/example/assets/games/flight/scripts/rules.lua b/example/assets/games/flight/scripts/rules.lua new file mode 100644 index 0000000..7bad0e0 --- /dev/null +++ b/example/assets/games/flight/scripts/rules.lua @@ -0,0 +1,153 @@ +local state = runtime.import("state") +local board = runtime.import("board") + +local rules = {} + +local function piece_index(piece_id) + return piece_id:sub(-1) == "2" and 2 or 1 +end + +function rules.next_player() + for index, player in ipairs(state.players) do + if player == state.current_player then + local next_index = index + 1 + if next_index > #state.players then + next_index = 1 + end + return state.players[next_index] + end + end + return state.players[1] +end + +function rules.next_dice() + state.dice_index = state.dice_index + 1 + if state.dice_index > #state.dice_values then + state.dice_index = 1 + end + return state.dice_values[state.dice_index] +end + +function rules.can_move(piece, dice) + if piece == nil or piece.status == "finished" then + return false + end + if piece.status == "home" then + return dice == 6 + end + return true +end + +function rules.movable_pieces() + local result = {} + for id, piece in pairs(state.pieces) do + if piece.owner == state.current_player and rules.can_move(piece, state.dice) then + table.insert(result, id) + end + end + return result +end + +function rules.all_piece_ids() + local result = {} + for id, _ in pairs(state.pieces) do + table.insert(result, id) + end + return result +end + +function rules.piece_position(piece) + return board.position(piece) +end + +function rules.plan_move(piece, dice) + local path = {} + local final_status = "route" + local final_progress = piece.progress + + if piece.status == "home" then + final_progress = 1 + table.insert(path, board.route_position(piece.owner, final_progress)) + else + for step = 1, dice do + local progress = piece.progress + step + if progress >= board.finish_progress then + final_status = "finished" + final_progress = board.finish_progress + table.insert(path, board.finish_position(piece)) + break + end + table.insert(path, board.route_position(piece.owner, progress)) + final_progress = progress + end + end + + local captures = {} + if final_status == "route" then + local landing_index = board.route_index(piece.owner, final_progress) + for id, other in pairs(state.pieces) do + if id ~= piece.id and other.owner ~= piece.owner and other.status == "route" then + if board.route_index(other.owner, other.progress) == landing_index then + table.insert(captures, id) + end + end + end + end + + return { + piece_id = piece.id, + final_status = final_status, + final_progress = final_progress, + path = path, + captures = captures + } +end + +function rules.commit_move(plan) + local piece = state.pieces[plan.piece_id] + piece.status = plan.final_status + piece.progress = plan.final_progress + + for _, captured_id in ipairs(plan.captures) do + local captured = state.pieces[captured_id] + captured.status = "home" + captured.progress = 0 + end +end + +function rules.player_finished(owner) + for _, piece in pairs(state.pieces) do + if piece.owner == owner and piece.status ~= "finished" then + return false + end + end + return true +end + +function rules.status_text() + if state.winner ~= nil then + return "胜利者: " .. state.winner + end + if state.phase == "waiting_roll" then + return "请 " .. state.current_player .. " 掷骰子" + end + if state.phase == "waiting_piece" then + return "请选择 " .. state.current_player .. " 的飞机" + end + if state.phase == "animating" then + return "飞机移动中..." + end + return "准备中" +end + +function rules.piece_label(piece) + if piece.status == "home" then + return "待飞" + end + if piece.status == "finished" then + return "到达" + end + return tostring(piece.progress) +end + +return rules diff --git a/example/assets/games/flight/scripts/runtime_defs.lua b/example/assets/games/flight/scripts/runtime_defs.lua new file mode 100644 index 0000000..1bfce9f --- /dev/null +++ b/example/assets/games/flight/scripts/runtime_defs.lua @@ -0,0 +1,589 @@ +---@meta +--- COMMON RUNTIME TYPES SECTION. +--- Source of truth: tool/lua_runtime_defs_common.lua +--- After editing this common section, run: +--- dart run tool/generate_lua_runtime_defs.dart + + +---@alias RuntimeNodeType +---| 'panel' +---| 'button' +---| 'text' +---| 'circle' +---| 'rect' +---| 'line' +---| 'progress' +---| 'listView' +---| 'sprite' +---| 'image' +---| 'spine' +---| 'particle' + +---@alias RuntimeAnchor +---| 'center' +---| 'topLeft' +---| 'topRight' +---| 'bottomLeft' +---| 'bottomRight' + +---@alias RuntimeTextAlign +---| 'left' +---| 'center' +---| 'right' + +---@alias RuntimeParticlePreset +---| 'burst' +---| 'trail' +---| 'snow' +---| 'confetti' + +---@alias RuntimeCommandType +---| 'move_path' +---| 'move_to' +---| 'fade_to' +---| 'scale_to' +---| 'rotate_to' +---| 'remove_node' +---| 'sequence' +---| 'parallel' +---| 'delay' +---| 'toast' +---| 'play_sound' +---| 'play_bgm' +---| 'pause_bgm' +---| 'resume_bgm' +---| 'stop_bgm' +---| 'preload_resources' +---| 'evict_resources' +---| 'cancel_commands' +---| 'play_spine_animation' +---| 'copy_text' + +---@alias RuntimeEventType +---| 'tap' +---| 'animation_done' +---| 'resize' +---| 'scroll' + +---@alias RuntimeScaleMode +---| 'fit' +---| 'fill' +---| 'stretch' +---| 'none' + +---@alias RuntimeLayoutAlign +---| 'start' +---| 'center' +---| 'end' + +---@alias RuntimeButtonVariant +---| 'primary' +---| 'secondary' +---| 'ghost' + +---@class (exact) RuntimeNode +---@field id string +---@field type RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---@class (exact) RuntimeNodeProps +---@field type? RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---Helper-only fields accepted by runtime_ui/runtime_widgets. They are normalized +---before the node/update crosses the Dart Runtime protocol boundary. +---@class RuntimeNodeInit: RuntimeNodeProps +---@field w? number Alias for width. +---@field h? number Alias for height. +---@field size? number Alias for both width and height. +---@field handler? string Alias for onTap. +---@field onClick? string Alias for onTap. + +---@class (exact) RuntimeNodeUpdate +---@field id string +---@field props RuntimeNodeProps + +---@class (exact) RuntimeNodeRemove +---@field id string + +---@class (exact) RuntimeDiffSection +---@field creates? RuntimeNode[] +---@field updates? RuntimeNodeUpdate[] +---@field removes? (string|RuntimeNodeRemove)[] + +---@class (exact) RuntimeDiff +---@field render? RuntimeDiffSection +---@field ui? RuntimeDiffSection +---@field commands? RuntimeCommand[] + +---@class (exact) RuntimeEvent +---@field type RuntimeEventType|string +---@field target? string +---@field handler? string +---@field x? number +---@field y? number +---@field data? table + +---@class (exact) RuntimeCommand +---@field type RuntimeCommandType +---@field target? string +---@field scope? string +---@field id? string +---@field group? string +---@field commandGroup? string +---@field onComplete? string +---@field duration? number +---@field commands? RuntimeCommand[] +---@field path? RuntimePoint[] +---@field x? number +---@field y? number +---@field alpha? number +---@field scale? number +---@field angle? number +---@field text? string +---@field message? string +---@field asset? string +---@field name? string +---@field volume? number +---@field channel? string +---@field loop? boolean +---@field failOnError? boolean +---@field animation? string +---@field track? integer +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeCommandOpts +---@field id? string +---@field group? string +---@field commandGroup? string +---@field scope? string +---@field onComplete? string +---@field duration? number + +---@class (exact) RuntimeAudioCommandOpts: RuntimeCommandOpts +---@field volume? number +---@field name? string + +---@class (exact) RuntimeBgmCommandOpts: RuntimeAudioCommandOpts +---@field channel? string +---@field loop? boolean + +---@class (exact) RuntimeSpineCommandOpts: RuntimeCommandOpts +---@field track? integer +---@field loop? boolean +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeResourceCommandOpts: RuntimeCommandOpts +---@field failOnError? boolean + +---@class (exact) RuntimePoint +---@field x number +---@field y number + +---@class (exact) RuntimeLocaleContext +---@field requested string +---@field resolved string +---@field default string +---@field supported string[] +---@field languageCode string +---@field scriptCode? string +---@field countryCode? string + +---@class (exact) RuntimeScreenContext +---@field width number +---@field height number + +---@class (exact) RuntimeDesignContext +---@field width number +---@field height number + +---@class (exact) RuntimeViewportContext +---@field x number +---@field y number +---@field width number +---@field height number +---@field scaleX number +---@field scaleY number +---@field scaleMode RuntimeScaleMode|string + +---@class (exact) RuntimeContext +---@field screen RuntimeScreenContext +---@field design RuntimeDesignContext +---@field viewport RuntimeViewportContext +---@field seed integer +---@field runtimeApiVersion integer +---@field gameId string +---@field gameVersion string +---@field locale? RuntimeLocaleContext + +---@class RuntimeUi +---@field style fun(base?: RuntimeNodeProps, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field with_parent fun(parent: string, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field node fun(node_type: RuntimeNodeType, id: string, opts?: RuntimeNodeInit): RuntimeNode +---@field panel fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field rect fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field circle fun(id: string, x: number|RuntimeNodeInit, y?: number, size?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field line fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field particle fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field text fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field button fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field list_view fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field image fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field sprite fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field spine fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, animation?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field update fun(id: string, props: RuntimeNodeInit): RuntimeNodeUpdate +---@field text_update fun(id: string, text: string): RuntimeNodeUpdate +---@field visible_update fun(id: string, visible: boolean): RuntimeNodeUpdate +---@field alpha_update fun(id: string, alpha: number): RuntimeNodeUpdate +---@field scale_update fun(id: string, scale: number): RuntimeNodeUpdate +---@field position_update fun(id: string, x: number, y: number): RuntimeNodeUpdate +---@field size_update fun(id: string, width: number, height: number): RuntimeNodeUpdate +---@field transform_update fun(id: string, x: number, y: number, scale: number, rotation: number): RuntimeNodeUpdate +---@field batch_update fun(ids: string[], props: RuntimeNodeInit): RuntimeNodeUpdate[] +---@field append fun(nodes: RuntimeNode[], node: RuntimeNode): RuntimeNode[] +---@field append_all fun(nodes: RuntimeNode[], extra_nodes: RuntimeNode[]): RuntimeNode[] + +---@class (exact) RuntimeDialogButton +---@field id? string +---@field text string +---@field handler string +---@field color? string + +---@class (exact) RuntimeDialogOpts +---@field screenWidth? number +---@field screenHeight? number +---@field overlay? boolean +---@field overlayColor? string +---@field blockInput? boolean +---@field layer? integer +---@field color? string +---@field radius? number +---@field panelStyle? RuntimeNodeProps +---@field titleColor? string +---@field titleSize? number +---@field titleStyle? RuntimeNodeProps +---@field messageColor? string +---@field messageSize? number +---@field messageStyle? RuntimeNodeProps +---@field buttons? RuntimeDialogButton[] +---@field buttonGap? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeLabeledProgressOpts: RuntimeNodeInit +---@field labelHeight? number +---@field labelStyle? RuntimeNodeProps + +---@class RuntimePillOpts: RuntimeNodeInit +---@field panelStyle? RuntimeNodeProps +---@field textStyle? RuntimeNodeProps + +---@class RuntimeTextButtonOpts: RuntimeNodeInit +---@field variant? RuntimeButtonVariant + +---@class RuntimeListItemOpts: RuntimeTextButtonOpts +---@field selected? boolean +---@field activeColor? string +---@field inactiveColor? string + +---@class RuntimeTabItem +---@field id? string +---@field key? string +---@field text string +---@field handler? string +---@field selected? boolean + +---@class RuntimeTabsOpts: RuntimeNodeInit +---@field tabs? RuntimeTabItem[] +---@field selected? string +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field activeColor? string +---@field inactiveColor? string +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeActionItem +---@field id? string +---@field text string +---@field handler? string +---@field visible? boolean +---@field color? string +---@field style? RuntimeNodeProps + +---@class RuntimeActionRowOpts: RuntimeNodeInit +---@field actions? RuntimeActionItem[] +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimePanelHeaderOpts: RuntimeNodeInit +---@field eyebrow? string +---@field title string +---@field summary? string +---@field gap? number +---@field eyebrowId? string +---@field titleId? string +---@field summaryId? string +---@field eyebrowHeight? number +---@field titleHeight? number +---@field summaryHeight? number +---@field eyebrowStyle? RuntimeNodeProps +---@field titleStyle? RuntimeNodeProps +---@field summaryStyle? RuntimeNodeProps + +---@class RuntimeWidgetTheme +---@field primary? string +---@field secondary? string +---@field success? string +---@field overlay? string +---@field surface? string +---@field surfaceAlt? string +---@field card? string +---@field text? string +---@field muted? string +---@field progress? string +---@field transparent? string + +---@class RuntimeWidgets +---@field configure fun(tokens?: RuntimeWidgetTheme): RuntimeWidgets +---@field label fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field section_title fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field pill fun(id: string, text: string|RuntimePillOpts, x?: number, y?: number, width?: number, height?: number, opts?: RuntimePillOpts): RuntimeNode[] +---@field text_button fun(id: string, text: string|RuntimeTextButtonOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeTextButtonOpts): RuntimeNode +---@field list_item fun(id: string, text: string|RuntimeListItemOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeListItemOpts): RuntimeNode +---@field tabs fun(id: string, tabs: RuntimeTabItem[]|RuntimeTabsOpts, opts?: RuntimeTabsOpts): RuntimeNode[] +---@field action_row fun(id: string, actions: RuntimeActionItem[]|RuntimeActionRowOpts, opts?: RuntimeActionRowOpts): RuntimeNode[] +---@field panel_header fun(id: string, opts: RuntimePanelHeaderOpts): RuntimeNode[] +---@field overlay fun(id: string, width: number|RuntimeNodeInit, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field card fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress_bar fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field labeled_progress fun(id: string, label: string, x: number, y: number, width: number, height: number, value: number, opts?: RuntimeLabeledProgressOpts): RuntimeNode[] +---@field button_row fun(parent: string, id: string, buttons: RuntimeDialogButton[], x: number, y: number, width: number, height: number, gap?: number, opts?: RuntimeNodeProps): RuntimeNode[] +---@field dialog fun(id: string, title: string, message: string, x: number, y: number, width: number, height: number, opts?: RuntimeDialogOpts): RuntimeNode[] + +---@class (exact) RuntimeLayoutItem +---@field node RuntimeNode +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLayoutItemOpts +---@field margin? number +---@field mx? number +---@field my? number +---@field ml? number +---@field mr? number +---@field mt? number +---@field mb? number +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLinearLayoutOpts +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field gap? number +---@field align? RuntimeLayoutAlign +---@field padding? number +---@field paddingX? number +---@field paddingY? number +---@field px? number +---@field py? number +---@field paddingLeft? number +---@field paddingTop? number + +---@class RuntimeBoxLayoutOpts: RuntimeLinearLayoutOpts +---@field rows? integer +---@field columns? integer +---@field cols? integer +---@field cellWidth? number +---@field cellHeight? number +---@field cellW? number +---@field cellH? number +---@field gapX? number +---@field gapY? number +---@field valign? RuntimeLayoutAlign + +---@class RuntimeLayout +---@field item fun(node: RuntimeNode, opts?: RuntimeLayoutItemOpts): RuntimeLayoutItem +---@field local_position fun(origin: RuntimePoint, position: RuntimePoint): RuntimePoint +---@field row fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field column fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field stack fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field box fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeBoxLayoutOpts): RuntimeNode[] + +---@class RuntimeCommands +---@field toast fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field copy_text fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field delay fun(duration: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field sequence fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field parallel fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_path fun(target: string, path: RuntimePoint[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_to fun(target: string, x: number, y: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field fade_to fun(target: string, alpha: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field scale_to fun(target: string, scale: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field rotate_to fun(target: string, angle: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field remove_node fun(target: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field play_spine_animation fun(target: string, animation: string, opts?: RuntimeSpineCommandOpts): RuntimeCommand +---@field play_sound fun(asset: string, opts?: RuntimeAudioCommandOpts): RuntimeCommand +---@field play_bgm fun(asset: string, opts?: RuntimeBgmCommandOpts): RuntimeCommand +---@field pause_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field resume_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field stop_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field preload_group fun(group: string, opts?: RuntimeResourceCommandOpts): RuntimeCommand +---@field evict_group fun(group: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field cancel_id fun(id: string): RuntimeCommand +---@field cancel_group fun(group: string): RuntimeCommand +---@field cancel_scope fun(scope: string): RuntimeCommand + +---@class RuntimeImportApi +---@field import fun(moduleName: string): table + +---@type RuntimeImportApi +runtime = runtime + +---@alias PlayerColor 'red'|'yellow'|'blue'|'green' +---@alias GamePhase 'waiting_roll'|'waiting_piece'|'animating'|'game_over' +---@alias PieceStatus 'home'|'route'|'finished' + +---@class (exact) PieceState +---@field id string +---@field owner PlayerColor +---@field progress integer +---@field status PieceStatus + +---@class (exact) LudoState +---@field current_player PlayerColor +---@field phase GamePhase +---@field dice_index integer +---@field dice_values integer[] +---@field dice? integer +---@field selected_piece? string +---@field pending_move? table +---@field winner? PlayerColor +---@field players PlayerColor[] +---@field pieces table + +---@class (exact) BoardPoint +---@field x number +---@field y number + +---@class (exact) BoardData +---@field red_home BoardPoint[] +---@field blue_home BoardPoint[] +---@field path BoardPoint[] +---@field start table diff --git a/example/assets/games/flight/scripts/state.lua b/example/assets/games/flight/scripts/state.lua new file mode 100644 index 0000000..c5cc323 --- /dev/null +++ b/example/assets/games/flight/scripts/state.lua @@ -0,0 +1,22 @@ +---@type table +return { + players = { "red", "yellow", "blue", "green" }, + current_player = "red", + phase = "waiting_roll", + dice_index = 0, + dice_values = { 6, 3, 4, 6, 2, 5, 1, 6, 4, 2, 6, 5 }, + dice = nil, + selected_piece = nil, + pending_move = nil, + winner = nil, + pieces = { + red_1 = { id = "red_1", owner = "red", status = "home", progress = 0 }, + red_2 = { id = "red_2", owner = "red", status = "home", progress = 0 }, + yellow_1 = { id = "yellow_1", owner = "yellow", status = "home", progress = 0 }, + yellow_2 = { id = "yellow_2", owner = "yellow", status = "home", progress = 0 }, + blue_1 = { id = "blue_1", owner = "blue", status = "home", progress = 0 }, + blue_2 = { id = "blue_2", owner = "blue", status = "home", progress = 0 }, + green_1 = { id = "green_1", owner = "green", status = "home", progress = 0 }, + green_2 = { id = "green_2", owner = "green", status = "home", progress = 0 } + } +} diff --git a/example/assets/games/flight/scripts/styles.lua b/example/assets/games/flight/scripts/styles.lua new file mode 100644 index 0000000..017a608 --- /dev/null +++ b/example/assets/games/flight/scripts/styles.lua @@ -0,0 +1,81 @@ +local theme = runtime.import("theme") +local colors = theme.colors +local styles = {} + +styles.layers = { + board = 1, + cell = 2, + home = 3, + plane = 10, + hud = 100, + hud_content = 101 +} + +styles.board = { + color = colors.board, + layer = styles.layers.board +} + +styles.center = { + color = colors.board_inner, + layer = styles.layers.board +} + +styles.route_cell = { + anchor = "center", + color = colors.route_cell, + layer = styles.layers.cell +} + +styles.home_panel = function(owner) + return { + color = colors[owner .. "_home"], + layer = styles.layers.home + } +end + +styles.hud = { + color = colors.top_bar, + layer = styles.layers.hud +} + +styles.hud_text = { + fontSize = 20, + color = colors.text, + layer = styles.layers.hud_content +} + +styles.small_text = { + fontSize = 14, + color = colors.muted_text, + layer = styles.layers.hud_content +} + +styles.dice_button = { + color = colors.dice_button, + fontSize = 20, + layer = styles.layers.hud_content +} + +styles.plane = function(owner) + return { + anchor = "center", + color = colors[owner], + layer = styles.layers.plane, + interactive = true, + onTap = "piece_tap", + alpha = 0.95 + } +end + +styles.plane_highlight = { + scale = 1.25, + alpha = 1 +} + +styles.plane_normal = { + scale = 1, + alpha = 0.95 +} + +return styles diff --git a/example/assets/games/flight/scripts/theme.lua b/example/assets/games/flight/scripts/theme.lua new file mode 100644 index 0000000..b2190fb --- /dev/null +++ b/example/assets/games/flight/scripts/theme.lua @@ -0,0 +1,22 @@ +return { + title = "Lua 飞行棋", + colors = { + background = "#0f172a", + board = "#1e293b", + board_inner = "#334155", + route_cell = "#f8fafc", + route_text = "#0f172a", + top_bar = "#020617", + dice_button = "#2563eb", + text = "#ffffff", + muted_text = "#cbd5e1", + red = "#ef4444", + yellow = "#eab308", + blue = "#3b82f6", + green = "#22c55e", + red_home = "#7f1d1d", + yellow_home = "#713f12", + blue_home = "#1e3a8a", + green_home = "#14532d" + } +} diff --git a/example/assets/games/flight/scripts/ui.lua b/example/assets/games/flight/scripts/ui.lua new file mode 100644 index 0000000..543f024 --- /dev/null +++ b/example/assets/games/flight/scripts/ui.lua @@ -0,0 +1,130 @@ +---@type RuntimeUi +local runtime_ui = runtime.import("runtime_ui") +---@type RuntimeLayout +local layout = runtime.import("layout") +local theme = runtime.import("theme") +local styles = runtime.import("styles") +local state = runtime.import("state") +local board = runtime.import("board") +local rules = runtime.import("rules") + +local ui = {} + +local function color_name(owner) + if owner == "red" then return "红" end + if owner == "yellow" then return "黄" end + if owner == "blue" then return "蓝" end + if owner == "green" then return "绿" end + return owner +end + +local function piece_size(piece) + if piece.status == "finished" then + return 30 + end + return 34 +end + +function ui.highlight_updates(ids, enabled) + return runtime_ui.batch_update(ids, enabled and styles.plane_highlight or styles.plane_normal) +end + +function ui.piece_position_update(piece_id) + local piece = state.pieces[piece_id] + local pos = rules.piece_position(piece) + return runtime_ui.update(piece_id, { + x = pos.x, + y = pos.y, + width = piece_size(piece), + height = piece_size(piece), + scale = 1, + alpha = 0.95 + }) +end + +function ui.piece_position_updates(ids) + local updates = {} + for _, id in ipairs(ids) do + table.insert(updates, ui.piece_position_update(id)) + end + return updates +end + +function ui.all_piece_position_updates() + return ui.piece_position_updates(rules.all_piece_ids()) +end + +function ui.create_board_nodes() + local nodes = { + runtime_ui.panel("board_panel", 28, 82, 664, 610, styles.board), + runtime_ui.panel("center_airport", 252, 292, 168, 136, styles.center), + runtime_ui.text("board_title", theme.title, 268, 318, 140, 32, styles.hud_text), + runtime_ui.text("board_tip", "掷 6 起飞 · 撞子回家 · 全部到达获胜", 206, 360, 320, 28, styles.small_text), + runtime_ui.panel("home_red", 62, 98, 128, 92, styles.home_panel("red")), + runtime_ui.panel("home_yellow", 498, 98, 128, 92, styles.home_panel("yellow")), + runtime_ui.panel("home_blue", 498, 516, 128, 92, styles.home_panel("blue")), + runtime_ui.panel("home_green", 62, 516, 128, 92, styles.home_panel("green")), + runtime_ui.text("label_red", "红方", 96, 102, 60, 24, styles.small_text), + runtime_ui.text("label_yellow", "黄方", 532, 102, 60, 24, styles.small_text), + runtime_ui.text("label_blue", "蓝方", 532, 520, 60, 24, styles.small_text), + runtime_ui.text("label_green", "绿方", 96, 520, 60, 24, styles.small_text) + } + + for index, cell in ipairs(board.route) do + runtime_ui.append(nodes, runtime_ui.circle("route_" .. tostring(index), cell.x, cell.y, 24, styles.route_cell)) + end + + for _, owner in ipairs(state.players) do + local start = board.route[board.start[owner]] + runtime_ui.append(nodes, runtime_ui.text("start_" .. owner, color_name(owner), start.x - 14, start.y - 14, 36, 24, { + fontSize = 14, + color = theme.colors[owner], + layer = styles.layers.cell + 1 + })) + end + + for id, piece in pairs(state.pieces) do + local pos = rules.piece_position(piece) + runtime_ui.append(nodes, runtime_ui.circle(id, pos.x, pos.y, piece_size(piece), styles.plane(piece.owner))) + end + + return nodes +end + +function ui.create_ui_nodes() + local hud_items = layout.row("top_bar", { + runtime_ui.text("turn_text", "当前: 红方", 0, 0, 120, 32, styles.hud_text), + runtime_ui.text("dice_text", "骰子: -", 0, 0, 100, 32, styles.hud_text), + runtime_ui.text("status_text", rules.status_text(), 0, 0, 260, 32, styles.hud_text), + layout.item( + runtime_ui.button("dice_button", "掷骰子", 0, 0, 120, 48, "roll_dice", styles.dice_button), + { marginLeft = 18 } + ) + }, { + x = 24, + height = 76, + gap = 16, + align = "center" + }) + + local nodes = { runtime_ui.panel("top_bar", 0, 0, 720, 76, styles.hud) } + return runtime_ui.append_all(nodes, hud_items) +end + +function ui.turn_name(owner) + return "当前: " .. color_name(owner) .. "方" +end + +function ui.dice_and_status_updates() + return { + runtime_ui.text_update("dice_text", "骰子: " .. tostring(state.dice or "-")), + runtime_ui.text_update("turn_text", ui.turn_name(state.current_player)), + runtime_ui.text_update("status_text", rules.status_text()) + } +end + +function ui.status_update() + return { runtime_ui.text_update("status_text", rules.status_text()) } +end + +return ui diff --git a/example/assets/games/ludo/assets/board.png b/example/assets/games/ludo/assets/board.png new file mode 100644 index 0000000000000000000000000000000000000000..e0ccec79f1b36f25d0ea94a047499d8b63045bba GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcwN$fBwreFf%hTyx+h4 QHc*(s)78&qol`;+0FQDG@c;k- literal 0 HcmV?d00001 diff --git a/example/assets/games/ludo/assets/dice.wav b/example/assets/games/ludo/assets/dice.wav new file mode 100644 index 0000000000000000000000000000000000000000..4230c9d6c6936ce03e218e80fb72b82e8b61e0e6 GIT binary patch literal 5336 zcmWMqWpq>r)4sZU@48E}8{Ie|P^6_e6eti11e#E!K;gp*1Zc404#iRkF9c`_Qd%Im zyE~;og!smGvsw4OyVt(VoH=KHJkQLWnP2nd3?Dl5g8~5Z2IdZ#wV)tQ0ssKm;R(3_ z@J%TIK!608IlW+dX$J-XO8A>qOzhH>f=*{U2QsInCmGH}7f91N>myk%XX~^&QRS3R z+ddYTEv|ZERJB+7^4Lb+ZDse^JIS9iGCQBl?4SOn!4YkiKH>BrgRa{qL;ZtF=O_2a z^0HM`#m0M<9N%Rof#*{E9K$4a$vB_+U1oIpP(!9}oGh1XChxd6n=SSEpEs0E`6Msj zR`rWh86V*8se)|Dr7)YPMmbe!pT1?<1QKNVF9+m(+fo5CxmT`5LKJTy4R}QVNX;^2z>xzUAAZF1pO?+H1 z>F2a>(>J7cH5}7-S1#wH;MQP?-P^*g|E@|}`AcPfby>r3^AD~iVGo=o+OD1zo1Ijb zT9?*8HO6pPzgB7E9|60ECOa;*-mSM+6;{5hJW~CkL2ag-PGU6ttMHAgH0HQrWa`2+ zGKFg>*FRTI5@bS+A(eB1DZgP?wd`}s=Qq_K8`@3BoePP}&`W_x<2D)S5q8` z?Ru{2rQja4op|p|H76P~YYu$g@|mu#Xn1HE>GXt@kV-IK`L%vTVp7V^)VV1i5+nMd zsx09!xN~@utHoStd|wk)W&Yf)roQ2jDePDgS_97EA5m=79ZM)oR;TJxE+%3z8&pNY z5AetEm+qr&I~o_&9vdPEmDO!EJYye|){zi=#V*8G$)-jfj(cl3pKM6(l^7Khtu7UfL(h;yypP&T znt!P8TeGe@tv1eRFjd-b1^TdWu-DSFT4(GRhOWu~Ch-%sF~iiL_&qv+a(fG`IW2Vk z>l$nIg4$k2sp)_Av4Lw$8WtrDX$Hq0O1zr1B&jAr5tFYTCmzD7po)FTHmLP@LtgEK zn(MW>M$k0L?(k~=5pDDV1whnxm(l0`oubCUAxiLy3e-R*N4hP z-w3xW?a_PUQWAG1-im*%XVljvKViGr2f=O5d2Llq=?zEf2Gy$?+gj(^y7^v_e;_Hs zdc~kV5Sq8iTEgwxeEaWGmdx|4r`E-i#@X zADz%1SD;VROqQ<3Ip9WOg?n!M^A@v_*YI7#g+|DP+H$??BP=wE-y$2X)y8n*o8teB z8>{c4*)1)@*MRbHlt*Hn)4Hm0dqZhMTcgZmvnsq%kyX$&UO(AM%_{w>xFzvp<1+N! zGni;Y}J_qSXUH3OTx>=ys{Y`?V zg68X{Vr!Y337uwhxLZXZ74NiZ`YSP`V=x_{`BnBWe-?6=8X8#V{A4-Ys%>7;^su?s zbjW(veJRw7eamqPzfg417VEx@@#_DLwySr`xPqrh54s`{?ON2{)l|}KY7({}=EK%4 z?pdMt%rMRm!XkN*2G`xw@6#7XSE&Dx^%LmOQu?RhHJ8Zx%9PUbee;x-F6Lv_8SdE7 zZ00%oLO{sE>J`!b^daQe|6Gs1`zA7sbJVOhaf>5)2h%I3Ls`aZDwDouMHEX*2Xz&F67CFs- zCVi&LjT)qzqk9##T76sgRv_ol3=vx9G1_*uJ#H;+ncVuq{M0IUPYVvA$01StOlgMd zx%Npks9PU3L48-|7fj{MW>*oIcZEH{GSU>^dcBn~S6TsgYS2d2!-c$qlKsl=+JVuB zqI*VlRo{_mgnx71vk~HuSM0cHsWcsIm6*P2vs+y*U*G`sGmP+N$NM zugiJ~ZJe&a@^G^6v}08JG_%;Wz_hdtwY9h&2L@3jv_-J?QzXu)kfJ7VJ-IZHjFV*9fdf9W~KCBuFP=iCU-de|9tH*N4a-+SMJ?OgTH$+_Q zZ8VwRAU-HpsIt_bRWcSGqy*LU~cy zSFufcM<~bZ;rWa*+{KT(TkT$Jj#Xe&IlgnR^Un_7VAMzt{JwCGl$2*HhbukuiPDS0 zbXQ$XtpIs&$ywx_lOj$Q7RetkHT$%98?HwC#8rz}sgLNQJrmJ|v{by%&iMCU{X7 zVUMwIuR1^Mp50R3n)wdnIF}N=YZ-Vmuz*0MwDILZ^HO+-sfd9cLX8=S0s*e+eO_ zFMwH`5xj@OTuGaBg6x#EQq1pQ3_>3PJt=D_-mmen&X7au9PZlXx$gg+Xr_Jw-=gJs ze_@$;uGAv^R$3&s2o~Z~Q5x7yV?q_sc|o_u+2pjjLY`*-8e$Js4)9SIHc0TFXrTm^?vn7t zhXg<3h3L;Tt zPoaN+8|d9(I2i4NJhiSHuK&5`d!qx(h;OMJAQzEi+5GpyCE{4gYw!8u|`= zN4vtyf`@z?J>%U8Zm0X4w@+XNkxr=r0QrYo#v3gRh|Y@tPn;$a2(s`;C;=*%(Gg2f z;Rn6%-G%Pq9=ms1U^OA8jO=-M0CzI)qhPtHhZqpo2tV_+_!~4Hn!uDs@%7A~ zjQf})=q~^f*k9<&AE_@|y6lCz9buhL<3ib+lkO%|O|N5uD?#!Cs-ap$+UfYI?XXX!V!+y7{*GPWpcd))Lpq|Ck7fqW8E#ypW$S*ea;x z&*6QKJwV?>SJ`9K)9|R!j6jnAw9oGI`OgJ|#3k}Pa}T_TjOT8^Rs0ZND_F@-;H6`i zQ6tpMTBwA`-B4}dm|yG9@ed7{f{O4Zaxb$HoP;53_P6QhkuV(h`;0RK?$fku$Zoj>?d9Z z3j<&vA>av23rz^$A}2E{@IIWv>4crff9Jj9P2zon7ju`REc63#na(09qE845E(`1m zj0m0xtqngRhcT_d68I&0pW73U;!WlecmSKpor1#fD!@r^CTD~%gw_Xbfl%O7&>Z?F z{GRN=+yK(ydFUAKBkUw@!;A1!SO#|>ionG{DpN_m3da$l;MCxZARFvNl!qJ06lN!2 zg2bqalZ|EKzv5YV4(8^>qY!)zn93wk8Iirjf>3$zzu=Tm0Rczcq>h;ZoP=&5t2x!& z8yJSa#%S(UPRF^ScffvTF|{+o5Y3_Cp}wJep@&3|2!~QK{ehX#bVSLS%^iRpz@}q= zbARDfBYvm}c*fkN+9UJAdBlUzxsaX^gy%+LDG3t;q(VaE5*p;Zxat(L>0J@Ef8V5k;&cCWVhjdQ)Ns09+mW9ffY?@@_i+6j8@dIlhCncy9ZLU6 z_K)-p|3mB`nu*eIO=Kb^Wz6g?Fdw!f8cs8(FW105#5slLAul05IGEi=2guWr3t?S2 zObiRNVKupmQZet@Enp(N8!1KeId3?(IK4TO&}8H?BnM}+&*>4AfQ*S0hUbOPhrf^H zk|k6ubBFyNtcAKD15pai<&5Oip<>hr7ei`rI}0*LsYT?T2ok9cDgXPd)@Yl$1$UbBY@&?9XErf$M z_5<^lwo!el_vDEVd=zz^+DxxxHnT-QF}MjD1iyndNCIMo3*c9f2c!Xtr5OqH4SkyG zM=7XO>Q@S;@6bieCU!Y69qbM@K~v$=@D+Fytb?~eFF_}O1IcU-bA%Sq7pSe&0jieD zp?&mKW-B`d$OJ7NUHnjYcpw}FKY{u~#b6yE2eR3HjGJCU>uI8+en0vY-I*z8cCteO z68IBLhIT+tp%2g{XciO%=YlVRC?KExj~UEV&^zh5^kVu1P0$ONFjK^S0lWk9z_%T* z*Enb@G!(+1Qm`j@0f+(ivN*e+`H~^%TDpnGm{H7mCXOv(6Mzyx4lV(2gDs#FtO3t} zQ#%B|{Xi^G$_`+gn1jqrCYu?<t5^w@2$nU6b1|9&rfN_8dsAK^k-gTgf6o7LW@p1$F`lfx{i#jlewMJD@Wl1YB$xd!H?3Pq2S>#5wjB i`Zci7-kcwN$fBwreFf%hTyx+h4 QHc*(s)78&qol`;+0FQDG@c;k- literal 0 HcmV?d00001 diff --git a/example/assets/games/ludo/assets/piece_red.png b/example/assets/games/ludo/assets/piece_red.png new file mode 100644 index 0000000000000000000000000000000000000000..e0ccec79f1b36f25d0ea94a047499d8b63045bba GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcwN$fBwreFf%hTyx+h4 QHc*(s)78&qol`;+0FQDG@c;k- literal 0 HcmV?d00001 diff --git a/example/assets/games/ludo/manifest.json b/example/assets/games/ludo/manifest.json new file mode 100644 index 0000000..62e3e64 --- /dev/null +++ b/example/assets/games/ludo/manifest.json @@ -0,0 +1,55 @@ +{ + "gameId": "ludo", + "name": "Lua Ludo 示例", + "version": "0.1.0", + "runtimeApiVersion": 1, + "entry": "scripts/main.lua", + "assetsBase": "assets", + "defaultLocale": "zh-Hans", + "supportedLocales": [ + "zh-Hans", + "en" + ], + "display": { + "designWidth": 720, + "designHeight": 720, + "scaleMode": "fit" + }, + "modules": { + "runtime_ui": "runtime:runtime_ui.lua", + "runtime_widgets": "runtime:runtime_widgets.lua", + "runtime_commands": "runtime:runtime_commands.lua", + "layout": "runtime:layout.lua", + "i18n": "scripts/i18n.lua", + "theme": "scripts/theme.lua", + "styles": "scripts/styles.lua", + "state": "scripts/state.lua", + "board": "scripts/board.lua", + "rules": "scripts/rules.lua", + "ui": "scripts/ui.lua", + "animation": "scripts/animation.lua" + }, + "resources": { + "board": { + "type": "image", + "path": "assets/board.png", + "group": "board" + }, + "piece_red": { + "type": "image", + "path": "assets/piece_red.png", + "group": "pieces" + }, + "piece_blue": { + "type": "image", + "path": "assets/piece_blue.png", + "group": "pieces" + }, + "dice": { + "type": "audio", + "path": "assets/dice.wav", + "preload": "lazy", + "group": "sfx" + } + } +} diff --git a/example/assets/games/ludo/scripts/animation.lua b/example/assets/games/ludo/scripts/animation.lua new file mode 100644 index 0000000..a8d0d9e --- /dev/null +++ b/example/assets/games/ludo/scripts/animation.lua @@ -0,0 +1,37 @@ +---@type RuntimeCommands +local commands = runtime.import("runtime_commands") + +local animation = {} + +function animation.move_piece(piece_id, path) + return commands.move_path(piece_id, path, { + duration = 0.7, + onComplete = "piece_move_done" + }) +end + +function animation.toast(text) + return commands.toast(text) +end + +function animation.play_sound(name) + return commands.play_sound(name) +end + +function animation.play_bgm(name, channel) + return commands.play_bgm(name, { channel = channel or "bgm" }) +end + +function animation.pause_bgm(channel) + return commands.pause_bgm(channel) +end + +function animation.resume_bgm(channel) + return commands.resume_bgm(channel) +end + +function animation.stop_bgm(channel) + return commands.stop_bgm(channel) +end + +return animation diff --git a/example/assets/games/ludo/scripts/board.lua b/example/assets/games/ludo/scripts/board.lua new file mode 100644 index 0000000..c5de59f --- /dev/null +++ b/example/assets/games/ludo/scripts/board.lua @@ -0,0 +1,20 @@ +---@type BoardData +return { + red_home = { + {x = 80, y = 520}, + {x = 140, y = 520} + }, + blue_home = { + {x = 520, y = 120}, + {x = 580, y = 120} + }, + path = { + {x = 120, y = 420}, {x = 180, y = 420}, {x = 240, y = 420}, + {x = 300, y = 420}, {x = 360, y = 420}, {x = 420, y = 420}, + {x = 480, y = 420}, {x = 480, y = 360}, {x = 480, y = 300}, + {x = 480, y = 240}, {x = 420, y = 240}, {x = 360, y = 240}, + {x = 300, y = 240}, {x = 240, y = 240}, {x = 180, y = 240}, + {x = 120, y = 240}, {x = 120, y = 300}, {x = 120, y = 360} + }, + start = { red = 1, blue = 10 } +} diff --git a/example/assets/games/ludo/scripts/i18n.lua b/example/assets/games/ludo/scripts/i18n.lua new file mode 100644 index 0000000..c0a2b50 --- /dev/null +++ b/example/assets/games/ludo/scripts/i18n.lua @@ -0,0 +1,103 @@ +---@class RuntimeI18n +local i18n = {} + +local default_locale = "zh-Hans" +local current_locale = default_locale + +local messages = { + ["zh-Hans"] = { + title = "Lua 飞行棋", + roll_button = "掷骰子", + dice_empty = "骰子: -", + dice_value = "骰子: {value}", + current_player = "当前玩家: {player}", + ["player.red"] = "红方", + ["player.blue"] = "蓝方", + ["toast.move_first"] = "请先移动棋子", + ["toast.no_movable_piece"] = "无可移动棋子", + ["toast.invalid_piece"] = "该棋子不能移动" + }, + en = { + title = "Lua Ludo", + roll_button = "Roll", + dice_empty = "Dice: -", + dice_value = "Dice: {value}", + current_player = "Current player: {player}", + ["player.red"] = "Red", + ["player.blue"] = "Blue", + ["toast.move_first"] = "Move a piece first", + ["toast.no_movable_piece"] = "No movable pieces", + ["toast.invalid_piece"] = "This piece cannot move" + } +} + +---@param locale? string +---@return string +local function normalize_locale(locale) + if type(locale) ~= "string" or locale == "" then + return default_locale + end + locale = string.gsub(locale, "_", "-") + if messages[locale] ~= nil then + return locale + end + + local language = string.match(locale, "^([A-Za-z]+)") + if language ~= nil and messages[language] ~= nil then + return language + end + return default_locale +end + +---@param value string +---@return string +local function escape_pattern(value) + return string.gsub(value, "([%(%)%.%%%+%-%*%?%[%]%^%$])", "%%%1") +end + +---@param template string +---@param vars? table +---@return string +local function interpolate(template, vars) + if vars == nil then + return template + end + + local result = template + for key, value in pairs(vars) do + result = string.gsub(result, "{" .. escape_pattern(key) .. "}", tostring(value)) + end + return result +end + +---@param ctx? RuntimeContext +function i18n.configure(ctx) + local locale = nil + if ctx ~= nil and ctx.locale ~= nil then + locale = ctx.locale.resolved or ctx.locale.requested or ctx.locale.default + end + current_locale = normalize_locale(locale) +end + +---@return string +function i18n.locale() + return current_locale +end + +---@param key string +---@param vars? table +---@return string +function i18n.t(key, vars) + local bundle = messages[current_locale] or messages[default_locale] + local fallback = messages[default_locale] + local value = bundle[key] or fallback[key] or key + return interpolate(value, vars) +end + +---@param color PlayerColor +---@return string +function i18n.player(color) + return i18n.t("player." .. color) +end + +return i18n diff --git a/example/assets/games/ludo/scripts/main.lua b/example/assets/games/ludo/scripts/main.lua new file mode 100644 index 0000000..44908c0 --- /dev/null +++ b/example/assets/games/ludo/scripts/main.lua @@ -0,0 +1,117 @@ +local state = runtime.import("state") +local rules = runtime.import("rules") +local ui = runtime.import("ui") +local animation = runtime.import("animation") +local i18n = runtime.import("i18n") +---@type RuntimeWidgets +local widgets = runtime.import("runtime_widgets") +local theme = runtime.import("theme") + +widgets.configure({ + primary = theme.colors.dice_button, + secondary = theme.colors.board, + success = theme.colors.blue, + overlay = "#99000000", + surface = theme.colors.top_bar, + surfaceAlt = theme.colors.board, + card = theme.colors.top_bar, + text = theme.colors.text, + muted = "#ffcbd5e1", + progress = theme.colors.blue, + transparent = "#00000000" +}) + +function smoke_test(ctx) + i18n.configure(ctx) + return ctx ~= nil + and ctx.runtimeApiVersion ~= nil + and state.current_player ~= nil + and rules.next_player ~= nil + and ui.create_board_nodes ~= nil + and animation.move_piece ~= nil + and widgets.dialog ~= nil +end + +function init(ctx) + i18n.configure(ctx) + return { + render = { creates = ui.create_board_nodes() }, + ui = { creates = ui.create_ui_nodes() }, + commands = {} + } +end + +local function handle_roll_dice() + if state.phase ~= "waiting_roll" then + return { commands = { animation.toast(i18n.t("toast.move_first")) } } + end + + state.dice = rules.next_dice() + local movable = rules.movable_pieces() + + if #movable == 0 then + state.current_player = rules.next_player() + state.phase = "waiting_roll" + return { + ui = { updates = ui.dice_and_turn_updates(state.dice, state.current_player) }, + render = { updates = ui.highlight_updates(rules.all_piece_ids(), false) }, + commands = { animation.toast(i18n.t("toast.no_movable_piece")) } + } + end + + state.phase = "waiting_piece" + return { + ui = { updates = ui.dice_update(state.dice) }, + render = { updates = ui.highlight_updates(movable, true) }, + commands = { animation.play_sound("dice") } + } +end + +local function handle_piece_tap(piece_id) + if state.phase ~= "waiting_piece" then + return {} + end + + local piece = state.pieces[piece_id] + if piece == nil or piece.owner ~= state.current_player or not rules.can_move(piece, state.dice) then + return { commands = { animation.toast(i18n.t("toast.invalid_piece")) } } + end + + local path = rules.calculate_path(piece, state.dice) + rules.apply_move(piece, state.dice) + state.phase = "animating" + state.selected_piece = piece_id + + return { + render = { updates = ui.highlight_updates(rules.all_piece_ids(), false) }, + commands = { animation.move_piece(piece_id, path) } + } +end + +local function handle_move_done() + if state.dice ~= 6 then + state.current_player = rules.next_player() + end + state.phase = "waiting_roll" + state.selected_piece = nil + + return { + ui = { updates = ui.turn_update(state.current_player) } + } +end + +function on_event(event) + if event.handler == "roll_dice" then + return handle_roll_dice() + end + + if event.handler == "piece_tap" then + return handle_piece_tap(event.target) + end + + if event.handler == "piece_move_done" then + return handle_move_done() + end + + return {} +end diff --git a/example/assets/games/ludo/scripts/rules.lua b/example/assets/games/ludo/scripts/rules.lua new file mode 100644 index 0000000..813722f --- /dev/null +++ b/example/assets/games/ludo/scripts/rules.lua @@ -0,0 +1,88 @@ +local state = runtime.import("state") +local board = runtime.import("board") + +local rules = {} + +function rules.next_player() + if state.current_player == "red" then + return "blue" + end + return "red" +end + +function rules.next_dice() + state.dice_index = state.dice_index + 1 + if state.dice_index > #state.dice_values then + state.dice_index = 1 + end + return state.dice_values[state.dice_index] +end + +function rules.piece_home_position(piece) + if piece.owner == "red" then + if piece.id == "red_1" then return board.red_home[1] end + return board.red_home[2] + end + if piece.id == "blue_1" then return board.blue_home[1] end + return board.blue_home[2] +end + +function rules.can_move(piece, dice) + if piece.status == "home" then + return dice == 6 + end + return true +end + +function rules.movable_pieces() + local result = {} + for id, piece in pairs(state.pieces) do + if piece.owner == state.current_player and rules.can_move(piece, state.dice) then + table.insert(result, id) + end + end + return result +end + +function rules.all_piece_ids() + local result = {} + for id, _ in pairs(state.pieces) do + table.insert(result, id) + end + return result +end + +function rules.calculate_path(piece, dice) + local path = {} + if piece.status == "home" then + local start_index = board.start[piece.owner] + local pos = board.path[start_index] + table.insert(path, {x = pos.x, y = pos.y}) + return path + end + + for i = 1, dice do + local index = piece.path_index + i + while index > #board.path do + index = index - #board.path + end + local pos = board.path[index] + table.insert(path, {x = pos.x, y = pos.y}) + end + return path +end + +function rules.apply_move(piece, dice) + if piece.status == "home" then + piece.status = "path" + piece.path_index = board.start[piece.owner] + return + end + + piece.path_index = piece.path_index + dice + while piece.path_index > #board.path do + piece.path_index = piece.path_index - #board.path + end +end + +return rules diff --git a/example/assets/games/ludo/scripts/runtime_defs.lua b/example/assets/games/ludo/scripts/runtime_defs.lua new file mode 100644 index 0000000..f489a9c --- /dev/null +++ b/example/assets/games/ludo/scripts/runtime_defs.lua @@ -0,0 +1,587 @@ +---@meta +--- COMMON RUNTIME TYPES SECTION. +--- Source of truth: tool/lua_runtime_defs_common.lua +--- After editing this common section, run: +--- dart run tool/generate_lua_runtime_defs.dart + + +---@alias RuntimeNodeType +---| 'panel' +---| 'button' +---| 'text' +---| 'circle' +---| 'rect' +---| 'line' +---| 'progress' +---| 'listView' +---| 'sprite' +---| 'image' +---| 'spine' +---| 'particle' + +---@alias RuntimeAnchor +---| 'center' +---| 'topLeft' +---| 'topRight' +---| 'bottomLeft' +---| 'bottomRight' + +---@alias RuntimeTextAlign +---| 'left' +---| 'center' +---| 'right' + +---@alias RuntimeParticlePreset +---| 'burst' +---| 'trail' +---| 'snow' +---| 'confetti' + +---@alias RuntimeCommandType +---| 'move_path' +---| 'move_to' +---| 'fade_to' +---| 'scale_to' +---| 'rotate_to' +---| 'remove_node' +---| 'sequence' +---| 'parallel' +---| 'delay' +---| 'toast' +---| 'play_sound' +---| 'play_bgm' +---| 'pause_bgm' +---| 'resume_bgm' +---| 'stop_bgm' +---| 'preload_resources' +---| 'evict_resources' +---| 'cancel_commands' +---| 'play_spine_animation' +---| 'copy_text' + +---@alias RuntimeEventType +---| 'tap' +---| 'animation_done' +---| 'resize' +---| 'scroll' + +---@alias RuntimeScaleMode +---| 'fit' +---| 'fill' +---| 'stretch' +---| 'none' + +---@alias RuntimeLayoutAlign +---| 'start' +---| 'center' +---| 'end' + +---@alias RuntimeButtonVariant +---| 'primary' +---| 'secondary' +---| 'ghost' + +---@class (exact) RuntimeNode +---@field id string +---@field type RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---@class (exact) RuntimeNodeProps +---@field type? RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---Helper-only fields accepted by runtime_ui/runtime_widgets. They are normalized +---before the node/update crosses the Dart Runtime protocol boundary. +---@class RuntimeNodeInit: RuntimeNodeProps +---@field w? number Alias for width. +---@field h? number Alias for height. +---@field size? number Alias for both width and height. +---@field handler? string Alias for onTap. +---@field onClick? string Alias for onTap. + +---@class (exact) RuntimeNodeUpdate +---@field id string +---@field props RuntimeNodeProps + +---@class (exact) RuntimeNodeRemove +---@field id string + +---@class (exact) RuntimeDiffSection +---@field creates? RuntimeNode[] +---@field updates? RuntimeNodeUpdate[] +---@field removes? (string|RuntimeNodeRemove)[] + +---@class (exact) RuntimeDiff +---@field render? RuntimeDiffSection +---@field ui? RuntimeDiffSection +---@field commands? RuntimeCommand[] + +---@class (exact) RuntimeEvent +---@field type RuntimeEventType|string +---@field target? string +---@field handler? string +---@field x? number +---@field y? number +---@field data? table + +---@class (exact) RuntimeCommand +---@field type RuntimeCommandType +---@field target? string +---@field scope? string +---@field id? string +---@field group? string +---@field commandGroup? string +---@field onComplete? string +---@field duration? number +---@field commands? RuntimeCommand[] +---@field path? RuntimePoint[] +---@field x? number +---@field y? number +---@field alpha? number +---@field scale? number +---@field angle? number +---@field text? string +---@field message? string +---@field asset? string +---@field name? string +---@field volume? number +---@field channel? string +---@field loop? boolean +---@field failOnError? boolean +---@field animation? string +---@field track? integer +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeCommandOpts +---@field id? string +---@field group? string +---@field commandGroup? string +---@field scope? string +---@field onComplete? string +---@field duration? number + +---@class (exact) RuntimeAudioCommandOpts: RuntimeCommandOpts +---@field volume? number +---@field name? string + +---@class (exact) RuntimeBgmCommandOpts: RuntimeAudioCommandOpts +---@field channel? string +---@field loop? boolean + +---@class (exact) RuntimeSpineCommandOpts: RuntimeCommandOpts +---@field track? integer +---@field loop? boolean +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeResourceCommandOpts: RuntimeCommandOpts +---@field failOnError? boolean + +---@class (exact) RuntimePoint +---@field x number +---@field y number + +---@class (exact) RuntimeLocaleContext +---@field requested string +---@field resolved string +---@field default string +---@field supported string[] +---@field languageCode string +---@field scriptCode? string +---@field countryCode? string + +---@class (exact) RuntimeScreenContext +---@field width number +---@field height number + +---@class (exact) RuntimeDesignContext +---@field width number +---@field height number + +---@class (exact) RuntimeViewportContext +---@field x number +---@field y number +---@field width number +---@field height number +---@field scaleX number +---@field scaleY number +---@field scaleMode RuntimeScaleMode|string + +---@class (exact) RuntimeContext +---@field screen RuntimeScreenContext +---@field design RuntimeDesignContext +---@field viewport RuntimeViewportContext +---@field seed integer +---@field runtimeApiVersion integer +---@field gameId string +---@field gameVersion string +---@field locale? RuntimeLocaleContext + +---@class RuntimeUi +---@field style fun(base?: RuntimeNodeProps, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field with_parent fun(parent: string, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field node fun(node_type: RuntimeNodeType, id: string, opts?: RuntimeNodeInit): RuntimeNode +---@field panel fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field rect fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field circle fun(id: string, x: number|RuntimeNodeInit, y?: number, size?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field line fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field particle fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field text fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field button fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field list_view fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field image fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field sprite fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field spine fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, animation?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field update fun(id: string, props: RuntimeNodeInit): RuntimeNodeUpdate +---@field text_update fun(id: string, text: string): RuntimeNodeUpdate +---@field visible_update fun(id: string, visible: boolean): RuntimeNodeUpdate +---@field alpha_update fun(id: string, alpha: number): RuntimeNodeUpdate +---@field scale_update fun(id: string, scale: number): RuntimeNodeUpdate +---@field position_update fun(id: string, x: number, y: number): RuntimeNodeUpdate +---@field size_update fun(id: string, width: number, height: number): RuntimeNodeUpdate +---@field transform_update fun(id: string, x: number, y: number, scale: number, rotation: number): RuntimeNodeUpdate +---@field batch_update fun(ids: string[], props: RuntimeNodeInit): RuntimeNodeUpdate[] +---@field append fun(nodes: RuntimeNode[], node: RuntimeNode): RuntimeNode[] +---@field append_all fun(nodes: RuntimeNode[], extra_nodes: RuntimeNode[]): RuntimeNode[] + +---@class (exact) RuntimeDialogButton +---@field id? string +---@field text string +---@field handler string +---@field color? string + +---@class (exact) RuntimeDialogOpts +---@field screenWidth? number +---@field screenHeight? number +---@field overlay? boolean +---@field overlayColor? string +---@field blockInput? boolean +---@field layer? integer +---@field color? string +---@field radius? number +---@field panelStyle? RuntimeNodeProps +---@field titleColor? string +---@field titleSize? number +---@field titleStyle? RuntimeNodeProps +---@field messageColor? string +---@field messageSize? number +---@field messageStyle? RuntimeNodeProps +---@field buttons? RuntimeDialogButton[] +---@field buttonGap? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeLabeledProgressOpts: RuntimeNodeInit +---@field labelHeight? number +---@field labelStyle? RuntimeNodeProps + +---@class RuntimePillOpts: RuntimeNodeInit +---@field panelStyle? RuntimeNodeProps +---@field textStyle? RuntimeNodeProps + +---@class RuntimeTextButtonOpts: RuntimeNodeInit +---@field variant? RuntimeButtonVariant + +---@class RuntimeListItemOpts: RuntimeTextButtonOpts +---@field selected? boolean +---@field activeColor? string +---@field inactiveColor? string + +---@class RuntimeTabItem +---@field id? string +---@field key? string +---@field text string +---@field handler? string +---@field selected? boolean + +---@class RuntimeTabsOpts: RuntimeNodeInit +---@field tabs? RuntimeTabItem[] +---@field selected? string +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field activeColor? string +---@field inactiveColor? string +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeActionItem +---@field id? string +---@field text string +---@field handler? string +---@field visible? boolean +---@field color? string +---@field style? RuntimeNodeProps + +---@class RuntimeActionRowOpts: RuntimeNodeInit +---@field actions? RuntimeActionItem[] +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimePanelHeaderOpts: RuntimeNodeInit +---@field eyebrow? string +---@field title string +---@field summary? string +---@field gap? number +---@field eyebrowId? string +---@field titleId? string +---@field summaryId? string +---@field eyebrowHeight? number +---@field titleHeight? number +---@field summaryHeight? number +---@field eyebrowStyle? RuntimeNodeProps +---@field titleStyle? RuntimeNodeProps +---@field summaryStyle? RuntimeNodeProps + +---@class RuntimeWidgetTheme +---@field primary? string +---@field secondary? string +---@field success? string +---@field overlay? string +---@field surface? string +---@field surfaceAlt? string +---@field card? string +---@field text? string +---@field muted? string +---@field progress? string +---@field transparent? string + +---@class RuntimeWidgets +---@field configure fun(tokens?: RuntimeWidgetTheme): RuntimeWidgets +---@field label fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field section_title fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field pill fun(id: string, text: string|RuntimePillOpts, x?: number, y?: number, width?: number, height?: number, opts?: RuntimePillOpts): RuntimeNode[] +---@field text_button fun(id: string, text: string|RuntimeTextButtonOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeTextButtonOpts): RuntimeNode +---@field list_item fun(id: string, text: string|RuntimeListItemOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeListItemOpts): RuntimeNode +---@field tabs fun(id: string, tabs: RuntimeTabItem[]|RuntimeTabsOpts, opts?: RuntimeTabsOpts): RuntimeNode[] +---@field action_row fun(id: string, actions: RuntimeActionItem[]|RuntimeActionRowOpts, opts?: RuntimeActionRowOpts): RuntimeNode[] +---@field panel_header fun(id: string, opts: RuntimePanelHeaderOpts): RuntimeNode[] +---@field overlay fun(id: string, width: number|RuntimeNodeInit, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field card fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress_bar fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field labeled_progress fun(id: string, label: string, x: number, y: number, width: number, height: number, value: number, opts?: RuntimeLabeledProgressOpts): RuntimeNode[] +---@field button_row fun(parent: string, id: string, buttons: RuntimeDialogButton[], x: number, y: number, width: number, height: number, gap?: number, opts?: RuntimeNodeProps): RuntimeNode[] +---@field dialog fun(id: string, title: string, message: string, x: number, y: number, width: number, height: number, opts?: RuntimeDialogOpts): RuntimeNode[] + +---@class (exact) RuntimeLayoutItem +---@field node RuntimeNode +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLayoutItemOpts +---@field margin? number +---@field mx? number +---@field my? number +---@field ml? number +---@field mr? number +---@field mt? number +---@field mb? number +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLinearLayoutOpts +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field gap? number +---@field align? RuntimeLayoutAlign +---@field padding? number +---@field paddingX? number +---@field paddingY? number +---@field px? number +---@field py? number +---@field paddingLeft? number +---@field paddingTop? number + +---@class RuntimeBoxLayoutOpts: RuntimeLinearLayoutOpts +---@field rows? integer +---@field columns? integer +---@field cols? integer +---@field cellWidth? number +---@field cellHeight? number +---@field cellW? number +---@field cellH? number +---@field gapX? number +---@field gapY? number +---@field valign? RuntimeLayoutAlign + +---@class RuntimeLayout +---@field item fun(node: RuntimeNode, opts?: RuntimeLayoutItemOpts): RuntimeLayoutItem +---@field local_position fun(origin: RuntimePoint, position: RuntimePoint): RuntimePoint +---@field row fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field column fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field stack fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field box fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeBoxLayoutOpts): RuntimeNode[] + +---@class RuntimeCommands +---@field toast fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field copy_text fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field delay fun(duration: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field sequence fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field parallel fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_path fun(target: string, path: RuntimePoint[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_to fun(target: string, x: number, y: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field fade_to fun(target: string, alpha: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field scale_to fun(target: string, scale: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field rotate_to fun(target: string, angle: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field remove_node fun(target: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field play_spine_animation fun(target: string, animation: string, opts?: RuntimeSpineCommandOpts): RuntimeCommand +---@field play_sound fun(asset: string, opts?: RuntimeAudioCommandOpts): RuntimeCommand +---@field play_bgm fun(asset: string, opts?: RuntimeBgmCommandOpts): RuntimeCommand +---@field pause_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field resume_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field stop_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field preload_group fun(group: string, opts?: RuntimeResourceCommandOpts): RuntimeCommand +---@field evict_group fun(group: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field cancel_id fun(id: string): RuntimeCommand +---@field cancel_group fun(group: string): RuntimeCommand +---@field cancel_scope fun(scope: string): RuntimeCommand + +---@class RuntimeImportApi +---@field import fun(moduleName: string): table + +---@type RuntimeImportApi +runtime = runtime + +---@alias PlayerColor 'red'|'blue' +---@alias GamePhase 'waiting_roll'|'waiting_piece'|'animating' +---@alias PieceStatus 'home'|'path'|'finished' + +---@class (exact) PieceState +---@field id string +---@field owner PlayerColor +---@field path_index integer +---@field status PieceStatus + +---@class (exact) LudoState +---@field current_player PlayerColor +---@field phase GamePhase +---@field dice_index integer +---@field dice_values integer[] +---@field dice? integer +---@field selected_piece? string +---@field players PlayerColor[] +---@field pieces table + +---@class (exact) BoardPoint +---@field x number +---@field y number + +---@class (exact) BoardData +---@field red_home BoardPoint[] +---@field blue_home BoardPoint[] +---@field path BoardPoint[] +---@field start table diff --git a/example/assets/games/ludo/scripts/state.lua b/example/assets/games/ludo/scripts/state.lua new file mode 100644 index 0000000..e564e19 --- /dev/null +++ b/example/assets/games/ludo/scripts/state.lua @@ -0,0 +1,15 @@ +---@type LudoState +return { + current_player = "red", + phase = "waiting_roll", + dice_index = 0, + dice_values = {6, 3, 5, 2, 6, 4}, + selected_piece = nil, + players = {"red", "blue"}, + pieces = { + red_1 = { id = "red_1", owner = "red", path_index = 0, status = "home" }, + red_2 = { id = "red_2", owner = "red", path_index = 0, status = "home" }, + blue_1 = { id = "blue_1", owner = "blue", path_index = 0, status = "home" }, + blue_2 = { id = "blue_2", owner = "blue", path_index = 0, status = "home" } + } +} diff --git a/example/assets/games/ludo/scripts/styles.lua b/example/assets/games/ludo/scripts/styles.lua new file mode 100644 index 0000000..0298be7 --- /dev/null +++ b/example/assets/games/ludo/scripts/styles.lua @@ -0,0 +1,80 @@ +local theme = runtime.import("theme") + +local colors = theme.colors +local styles = {} + +styles.layers = { + background = 0, + board = 1, + board_content = 2, + piece = 10, + hud = 100, + hud_content = 101 +} + +styles.board_panel = { + color = colors.board, + layer = styles.layers.background +} + +styles.board_title = { + fontSize = 24, + color = colors.text, + layer = styles.layers.board_content +} + +styles.red_home = { + color = colors.red_home, + layer = styles.layers.board +} + +styles.blue_home = { + color = colors.blue_home, + layer = styles.layers.board +} + +styles.path_cell = { + anchor = "center", + color = colors.path_cell, + layer = styles.layers.board_content +} + +styles.top_bar = { + color = colors.top_bar, + layer = styles.layers.hud +} + +styles.hud_text = { + fontSize = 22, + color = colors.text, + layer = styles.layers.hud_content +} + +styles.dice_button = { + color = colors.dice_button, + fontSize = 20, + layer = styles.layers.hud_content +} + +styles.piece_highlight = { + scale = 1.25, + alpha = 1 +} + +styles.piece_normal = { + scale = 1, + alpha = 0.95 +} + +function styles.piece(owner) + return { + anchor = "center", + asset = "piece_" .. owner, + color = colors[owner], + layer = styles.layers.piece, + interactive = true, + onTap = "piece_tap" + } +end + +return styles diff --git a/example/assets/games/ludo/scripts/theme.lua b/example/assets/games/ludo/scripts/theme.lua new file mode 100644 index 0000000..c0fcdc7 --- /dev/null +++ b/example/assets/games/ludo/scripts/theme.lua @@ -0,0 +1,18 @@ +local i18n = runtime.import("i18n") + +return { + title = function() + return i18n.t("title") + end, + colors = { + red = "#ef4444", + blue = "#3b82f6", + top_bar = "#020617", + dice_button = "#2563eb", + board = "#1e293b", + red_home = "#7f1d1d", + blue_home = "#1e3a8a", + path_cell = "#f8fafc", + text = "#ffffff" + } +} diff --git a/example/assets/games/ludo/scripts/ui.lua b/example/assets/games/ludo/scripts/ui.lua new file mode 100644 index 0000000..f2d5d68 --- /dev/null +++ b/example/assets/games/ludo/scripts/ui.lua @@ -0,0 +1,74 @@ +---@type RuntimeUi +local runtime_ui = runtime.import("runtime_ui") +---@type RuntimeLayout +local layout = runtime.import("layout") +local theme = runtime.import("theme") +local i18n = runtime.import("i18n") +local styles = runtime.import("styles") +local state = runtime.import("state") +local board = runtime.import("board") +local rules = runtime.import("rules") + +local ui = {} +local board_origin = { x = 40, y = 90 } + +function ui.highlight_updates(ids, enabled) + return runtime_ui.batch_update(ids, enabled and styles.piece_highlight or styles.piece_normal) +end + +function ui.create_board_nodes() + local nodes = { + runtime_ui.sprite("board_panel", "board", 40, 90, 640, 520, styles.board_panel), + runtime_ui.text("board_title", theme.title(), 240, 15, 180, 40, runtime_ui.with_parent("board_panel", styles.board_title)), + runtime_ui.panel("red_home", 20, 390, 130, 90, runtime_ui.with_parent("board_panel", styles.red_home)), + runtime_ui.panel("blue_home", 460, -10, 130, 90, runtime_ui.with_parent("board_panel", styles.blue_home)) + } + + for index, cell in ipairs(board.path) do + local pos = layout.local_position(board_origin, cell) + runtime_ui.append(nodes, runtime_ui.circle("cell_" .. tostring(index), pos.x, pos.y, 28, runtime_ui.with_parent("board_panel", styles.path_cell))) + end + + for id, piece in pairs(state.pieces) do + local pos = rules.piece_home_position(piece) + runtime_ui.append(nodes, runtime_ui.circle(id, pos.x, pos.y, 44, styles.piece(piece.owner))) + end + + return nodes +end + +function ui.create_ui_nodes() + local hud_items = layout.row("top_bar", { + runtime_ui.text("turn_text", i18n.t("current_player", { player = i18n.player(state.current_player) }), 0, 0, 230, 32, styles.hud_text), + runtime_ui.text("dice_text", i18n.t("dice_empty"), 0, 0, 120, 32, styles.hud_text), + layout.item( + runtime_ui.button("dice_button", i18n.t("roll_button"), 0, 0, 130, 48, "roll_dice", styles.dice_button), + { marginLeft = 134 } + ) + }, { + x = 24, + height = 76, + gap = 16, + align = "center" + }) + + local nodes = { runtime_ui.panel("top_bar", 0, 0, 720, 76, styles.top_bar) } + return runtime_ui.append_all(nodes, hud_items) +end + +function ui.dice_and_turn_updates(dice, current_player) + return { + runtime_ui.text_update("dice_text", i18n.t("dice_value", { value = dice })), + runtime_ui.text_update("turn_text", i18n.t("current_player", { player = i18n.player(current_player) })) + } +end + +function ui.dice_update(dice) + return { runtime_ui.text_update("dice_text", i18n.t("dice_value", { value = dice })) } +end + +function ui.turn_update(current_player) + return { runtime_ui.text_update("turn_text", i18n.t("current_player", { player = i18n.player(current_player) })) } +end + +return ui diff --git a/example/assets/games/showcase/assets/button_disabled.png b/example/assets/games/showcase/assets/button_disabled.png new file mode 100644 index 0000000000000000000000000000000000000000..496be650b624202180f2489fa3b80e59a195f127 GIT binary patch literal 138 zcmeAS@N?(olHy`uVBq!ia0vp^2|%pE!3HGD0_~lERG_DeV@SoVw-*f=85md?9N(%4 zIQ?fR*$|QUgQCw7#KJh7#JB8a0r&LIKcl N22WQ%mvv4FO#rZW9R>gZ literal 0 HcmV?d00001 diff --git a/example/assets/games/showcase/assets/button_normal.png b/example/assets/games/showcase/assets/button_normal.png new file mode 100644 index 0000000000000000000000000000000000000000..298a37c296d9c6ddf9154270f571ec51816f4c02 GIT binary patch literal 136 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 i` 1 then + state.progress = 0.05 + end + local updates = ui.progress_updates() + local status_updates = ui.status_updates("通过 NodeDiff.update 更新 progress.value = " .. tostring(state.progress)) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { render = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_visibility() + state.visible = not state.visible + local updates = ui.visibility_updates() + local status_updates = ui.status_updates("通过 visible / alpha 更新节点显示状态。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { render = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_dialog() + if state.dialog_open then + return status_only("Dialog 已经打开；点击关闭按钮移除它。") + end + state.dialog_open = true + return { + ui = { + creates = ui.dialog_nodes(), + updates = ui.status_updates("创建 widgets.dialog：Lua 组合普通 RuntimeNode。") + } + } +end + +---@return RuntimeDiff +local function handle_close_dialog() + state.dialog_open = false + return { + ui = { + removes = ui.dialog_removes(), + updates = ui.status_updates("通过 GameDiff.removes 移除 Dialog 节点。") + } + } +end + +---@return RuntimeDiff +local function handle_temp() + if state.temp_node_visible then + state.temp_node_visible = false + return { + render = { removes = { { id = "temp_node" }, { id = "temp_node_text" } } }, + ui = { updates = ui.status_updates("通过 GameDiff.removes 移除临时节点。") } + } + end + + state.temp_node_visible = true + return { + render = { creates = ui.temp_nodes() }, + ui = { updates = ui.status_updates("创建临时节点，并用 delay + remove_node 自动删除。") }, + commands = { + commands.sequence({ + commands.delay(1.2, { id = "temp_delay", group = "temp" }), + commands.remove_node("temp_node", { group = "temp" }), + commands.remove_node("temp_node_text", { group = "temp", onComplete = "temp_removed" }) + }, { group = "temp" }) + } + } +end + +---@return RuntimeDiff +local function handle_sound() + return { + ui = { updates = ui.status_updates("播放 manifest 资源 click：commands.play_sound('click')。") }, + commands = { commands.play_sound("click", { volume = 0.8, onComplete = "sound_done" }) } + } +end + +---@return RuntimeDiff +local function handle_bgm() + if state.bgm_state == "stopped" then + state.bgm_state = "playing" + return { + ui = { updates = ui.status_updates("启动 BGM channel=demo：play_bgm，可继续点击切换暂停/恢复/停止。") }, + commands = { commands.play_bgm("click", { channel = "demo", loop = true, volume = 0.25 }) } + } + end + + if state.bgm_state == "playing" then + state.bgm_state = "paused" + return { + ui = { updates = ui.status_updates("暂停 BGM：pause_bgm('demo')。") }, + commands = { commands.pause_bgm("demo") } + } + end + + if state.bgm_state == "paused" then + state.bgm_state = "resumed" + return { + ui = { updates = ui.status_updates("恢复 BGM：resume_bgm('demo')。") }, + commands = { commands.resume_bgm("demo") } + } + end + + state.bgm_state = "stopped" + return { + ui = { updates = ui.status_updates("停止 BGM：stop_bgm('demo')。") }, + commands = { commands.stop_bgm("demo") } + } +end + +---@return RuntimeDiff +local function handle_text_change() + state.text_variant = state.text_variant == "plain" and "styled" or "plain" + local updates = ui.text_updates() + local status_updates = ui.status_updates("Text 当前是纯文本协议；富文本 richText/spans 尚未支持。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_text_style() + state.text_variant = state.text_variant == "plain" and "styled" or "plain" + local updates = ui.text_updates() + local status_updates = ui.status_updates("已切换 text 的 color/fontSize；不是富文本。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_button_primary() + return { + ui = { updates = ui.status_updates("按钮点击：RuntimeEvent.tap -> Lua handler。") }, + commands = { commands.play_sound("click", { volume = 0.55 }) } + } +end + +---@return RuntimeDiff +local function handle_button_toggle() + state.button_active = not state.button_active + local updates = ui.button_updates() + local status_updates = ui.status_updates(state.button_active and "按钮恢复可点击状态。" or "按钮切换为置灰状态。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_button_image_tap() + return { + ui = { updates = ui.status_updates("图片按钮点击：按下时显示 pressedAsset，松开回到 asset。") }, + commands = { commands.play_sound("click", { volume = 0.45 }) } + } +end + +---@return RuntimeDiff +local function handle_button_image_toggle() + state.button_image_enabled = not state.button_image_enabled + local updates = ui.button_image_updates() + local status_updates = ui.status_updates(state.button_image_enabled and "图片按钮恢复 interactive=true。" or "图片按钮设为 interactive=false，显示 disabledAsset。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_sprite_anim() + return { + ui = { updates = ui.status_updates("精灵节点执行 move_to + rotate_to。") }, + commands = { + commands.parallel({ + commands.move_to("sprite_sprite_demo", 154, 54, { duration = 0.35, group = "sprite_demo" }), + commands.rotate_to("sprite_sprite_demo", 6.28, { duration = 0.35, group = "sprite_demo" }) + }, { group = "sprite_demo", onComplete = "sprite_anim_done" }) + } + } +end + +---@return RuntimeDiff +local function handle_sprite_style() + state.sprite_variant = state.sprite_variant == "image" and "sprite" or "image" + local updates = ui.sprite_updates() + local status_updates = ui.status_updates("切换 sprite 示例样式：" .. state.sprite_variant) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@param value string +---@return RuntimeDiff +local function handle_radio(value) + state.radio_selected = value + local updates = ui.radio_updates() + local status_updates = ui.status_updates("RadioGroup 选择：" .. value) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@param index integer +---@return RuntimeDiff +local function handle_list_pick(index) + local items = { "Lua", "Runtime", "Flame", "Diff", "Command" } + if index < 1 then + index = #items + elseif index > #items then + index = 1 + end + state.list_selected = items[index] + if state.list_axis == "horizontal" then + state.list_scroll_x = math.min(math.max((index - 2) * 126, 0), 330) + state.list_scroll_y = 0 + else + state.list_scroll_x = 0 + state.list_scroll_y = math.min(math.max((index - 2) * 28, 0), 78) + end + local updates = ui.list_updates() + local status_updates = ui.status_updates("ListView 选中：" .. state.list_selected .. "，双轴滚动已更新。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_list_horizontal() + state.list_axis = state.list_axis == "horizontal" and "vertical" or "horizontal" + state.list_scroll_x = 0 + state.list_scroll_y = 0 + local updates = ui.list_updates() + local status_updates = ui.status_updates("ListView 排列方向：" .. state.list_axis) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_list_reset() + state.list_scroll_x = 0 + state.list_scroll_y = 0 + local updates = ui.list_updates() + local status_updates = ui.status_updates("ListView 滚动已重置；滚轮/拖拽会触发 onScroll。") + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@param event RuntimeEvent +---@return RuntimeDiff +local function handle_list_scrolled(event) + if event.data ~= nil then + state.list_scroll_x = event.data.scrollX or state.list_scroll_x + state.list_scroll_y = event.data.scrollY or state.list_scroll_y + end + return { + ui = { updates = ui.status_updates("onScroll 回调：" .. tostring(state.list_scroll_x) .. ", " .. tostring(state.list_scroll_y)) } + } +end + +---@param step integer +---@return RuntimeDiff +---@param preset string +---@return RuntimeDiff +local function handle_particle(preset) + state.particle_seed = (state.particle_seed or 0) + 1 + local count = 42 + (state.particle_seed % 5) + local updates = { + runtime_ui.update("particle_burst", { + preset = preset == "confetti" and "confetti" or "burst", + count = count, + duration = preset == "confetti" and 1.2 or 0.85, + color = preset == "confetti" and "#ffff4d6d" or "#ffffcc33", + colorTo = preset == "confetti" and "#fffacc15" or "#00ffcc33", + gravityY = preset == "confetti" and 240 or 90, + spread = preset == "confetti" and 90 or 360, + visible = preset ~= "snow" + }), + runtime_ui.update("particle_trail", { + visible = preset == "burst" + }), + runtime_ui.update("particle_snow", { + count = 56 + (state.particle_seed % 7), + visible = preset == "snow" + }) + } + local status_updates = ui.status_updates("Particle 预设：" .. preset) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +local function handle_list(step) + local items = { "Lua", "Runtime", "Flame", "Diff", "Command" } + local index = 1 + for i, value in ipairs(items) do + if value == state.list_selected then + index = i + break + end + end + return handle_list_pick(index + step) +end + +---@param mode string +---@return RuntimeDiff +local function handle_layout(mode) + state.layout_mode = mode + local updates = ui.layout_updates(mode) + local status_updates = ui.status_updates("布局示例：" .. mode) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@return RuntimeDiff +local function handle_resource() + if state.resource_state == "ready" then + state.resource_state = "evicted" + return { + ui = { updates = ui.status_updates("释放资源组 media：evict_resources。再次点击会 preload。") }, + commands = { commands.evict_group("media") } + } + end + + state.resource_state = "ready" + return { + ui = { updates = ui.status_updates("预载资源组 media：preload_resources。") }, + commands = { commands.preload_group("media", { failOnError = true }) } + } +end + +---@return RuntimeDiff +---@return RuntimeDiff +local function handle_i18n_toggle() + local locale = i18n.toggle_locale() + return { + ui = { updates = ui.locale_updates() }, + commands = { commands.toast(i18n.t("i18n_switched") .. locale) } + } +end + +---@return RuntimeDiff +local function handle_i18n_refresh() + return { + ui = { updates = ui.locale_updates() } + } +end + +---@param mode string +---@return RuntimeDiff +local function handle_responsive(mode) + state.responsive_mode = mode + local label = i18n.t("responsive_desktop") + if mode == "phone" then + label = i18n.t("responsive_phone") + elseif mode == "tablet" then + label = i18n.t("responsive_tablet") + end + local updates = ui.responsive_updates() + local status_updates = ui.status_updates(label) + for _, update in ipairs(status_updates) do + table.insert(updates, update) + end + return { ui = { updates = updates } } +end + +---@param event RuntimeEvent +---@return RuntimeDiff +local function handle_resize(event) + if event.data ~= nil then + apply_context(event.data) + end + return { ui = { updates = ui.responsive_updates() } } +end + +---@return RuntimeDiff +local function handle_toast() + return { + ui = { updates = ui.status_updates("发送 toast 命令：Runtime 会显示临时 overlay 并自动移除。") }, + commands = { commands.toast("Hello from Lua showcase") } + } +end + +---@param target? string +---@return RuntimeDiff +local function handle_select_example(target) + local id = string.sub(target or "example_nodes", 9) + local selected = examples.find(id) + state.selected_example = selected.id + state.detail_tab = "code" + return { + ui = { updates = ui.example_updates(selected) } + } +end + +---@param tab string +---@return RuntimeDiff +local function handle_detail_tab(tab) + state.detail_tab = tab + return { ui = { updates = ui.example_updates(examples.find(state.selected_example)) } } +end + +---@return RuntimeDiff +local function handle_copy_detail() + local selected = examples.find(state.selected_example) + local text = selected.code + local label = "代码" + if state.detail_tab == "params" then + text = i18n.example_params(selected) + label = "参数说明" + end + return { + ui = { updates = ui.status_updates("已复制" .. label .. "到剪贴板。") }, + commands = { commands.copy_text(text) } + } +end + +function on_event(event) + if event.handler == "select_example" then + return handle_select_example(event.target) + end + if event.handler == "detail_tab_code" then + return handle_detail_tab("code") + end + if event.handler == "detail_tab_params" then + return handle_detail_tab("params") + end + if event.handler == "copy_detail" then + return handle_copy_detail() + end + if event.handler == "demo_anim" then + return handle_anim() + end + if event.handler == "demo_cancel" then + return handle_cancel() + end + if event.handler == "demo_progress" then + return handle_progress() + end + if event.handler == "demo_visibility" then + return handle_visibility() + end + if event.handler == "demo_dialog" then + return handle_dialog() + end + if event.handler == "close_dialog" then + return handle_close_dialog() + end + if event.handler == "demo_temp" then + return handle_temp() + end + if event.handler == "demo_text_change" then + return handle_text_change() + end + if event.handler == "demo_text_style" then + return handle_text_style() + end + if event.handler == "demo_button_primary" then + return handle_button_primary() + end + if event.handler == "demo_button_toggle" then + return handle_button_toggle() + end + if event.handler == "demo_button_image_tap" then + return handle_button_image_tap() + end + if event.handler == "demo_button_image_toggle" then + return handle_button_image_toggle() + end + if event.handler == "demo_sprite_anim" then + return handle_sprite_anim() + end + if event.handler == "demo_sprite_style" then + return handle_sprite_style() + end + if event.handler == "demo_radio_audio" then + return handle_radio("audio") + end + if event.handler == "demo_radio_spine" then + return handle_radio("spine") + end + if event.handler == "demo_radio_lua" then + return handle_radio("Lua") + end + if event.handler == "demo_list_prev" then + return handle_list(-1) + end + if event.handler == "demo_list_next" then + return handle_list(1) + end + if event.handler == "demo_list_horizontal" then + return handle_list_horizontal() + end + if event.handler == "demo_list_reset" then + return handle_list_reset() + end + if event.handler == "demo_list_scrolled" then + return handle_list_scrolled(event) + end + if event.handler == "demo_list_pick_1" then + return handle_list_pick(1) + end + if event.handler == "demo_list_pick_2" then + return handle_list_pick(2) + end + if event.handler == "demo_list_pick_3" then + return handle_list_pick(3) + end + if event.handler == "demo_list_pick_4" then + return handle_list_pick(4) + end + if event.handler == "demo_list_pick_5" then + return handle_list_pick(5) + end + if event.handler == "demo_particle_burst" then + return handle_particle("burst") + end + if event.handler == "demo_particle_confetti" then + return handle_particle("confetti") + end + if event.handler == "demo_particle_snow" then + return handle_particle("snow") + end + if event.handler == "demo_layout_row" then + return handle_layout("row") + end + if event.handler == "demo_layout_column" then + return handle_layout("column") + end + if event.handler == "demo_layout_box" then + return handle_layout("box") + end + if event.handler == "demo_sound" then + return handle_sound() + end + if event.handler == "demo_bgm" then + return handle_bgm() + end + if event.handler == "demo_resource" then + return handle_resource() + end + if event.handler == "demo_i18n_toggle" then + return handle_i18n_toggle() + end + if event.handler == "demo_i18n_refresh" then + return handle_i18n_refresh() + end + if event.handler == "demo_responsive_phone" then + return handle_responsive("phone") + end + if event.handler == "demo_responsive_tablet" then + return handle_responsive("tablet") + end + if event.handler == "demo_responsive_desktop" then + return handle_responsive("desktop") + end + if event.handler == "demo_toast" then + return handle_toast() + end + if event.type == "resize" then + return handle_resize(event) + end + if event.handler == "demo_anim_done" then + return status_only("动画完成事件：RuntimeCommand.onComplete -> RuntimeEvent -> Lua。") + end + if event.handler == "temp_removed" then + state.temp_node_visible = false + return status_only("临时节点已由 remove_node 命令删除。") + end + if event.handler == "sound_done" then + return status_only("音效播放完成事件已回到 Lua。") + end + if event.handler == "sprite_anim_done" then + return status_only("精灵动画完成。") + end + + return {} +end diff --git a/example/assets/games/showcase/scripts/runtime_defs.lua b/example/assets/games/showcase/scripts/runtime_defs.lua new file mode 100644 index 0000000..ee07392 --- /dev/null +++ b/example/assets/games/showcase/scripts/runtime_defs.lua @@ -0,0 +1,606 @@ +---@meta +--- COMMON RUNTIME TYPES SECTION. +--- Source of truth: tool/lua_runtime_defs_common.lua +--- After editing this common section, run: +--- dart run tool/generate_lua_runtime_defs.dart + + +---@alias RuntimeNodeType +---| 'panel' +---| 'button' +---| 'text' +---| 'circle' +---| 'rect' +---| 'line' +---| 'progress' +---| 'listView' +---| 'sprite' +---| 'image' +---| 'spine' +---| 'particle' + +---@alias RuntimeAnchor +---| 'center' +---| 'topLeft' +---| 'topRight' +---| 'bottomLeft' +---| 'bottomRight' + +---@alias RuntimeTextAlign +---| 'left' +---| 'center' +---| 'right' + +---@alias RuntimeParticlePreset +---| 'burst' +---| 'trail' +---| 'snow' +---| 'confetti' + +---@alias RuntimeCommandType +---| 'move_path' +---| 'move_to' +---| 'fade_to' +---| 'scale_to' +---| 'rotate_to' +---| 'remove_node' +---| 'sequence' +---| 'parallel' +---| 'delay' +---| 'toast' +---| 'play_sound' +---| 'play_bgm' +---| 'pause_bgm' +---| 'resume_bgm' +---| 'stop_bgm' +---| 'preload_resources' +---| 'evict_resources' +---| 'cancel_commands' +---| 'play_spine_animation' +---| 'copy_text' + +---@alias RuntimeEventType +---| 'tap' +---| 'animation_done' +---| 'resize' +---| 'scroll' + +---@alias RuntimeScaleMode +---| 'fit' +---| 'fill' +---| 'stretch' +---| 'none' + +---@alias RuntimeLayoutAlign +---| 'start' +---| 'center' +---| 'end' + +---@alias RuntimeButtonVariant +---| 'primary' +---| 'secondary' +---| 'ghost' + +---@class (exact) RuntimeNode +---@field id string +---@field type RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---@class (exact) RuntimeNodeProps +---@field type? RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---Helper-only fields accepted by runtime_ui/runtime_widgets. They are normalized +---before the node/update crosses the Dart Runtime protocol boundary. +---@class RuntimeNodeInit: RuntimeNodeProps +---@field w? number Alias for width. +---@field h? number Alias for height. +---@field size? number Alias for both width and height. +---@field handler? string Alias for onTap. +---@field onClick? string Alias for onTap. + +---@class (exact) RuntimeNodeUpdate +---@field id string +---@field props RuntimeNodeProps + +---@class (exact) RuntimeNodeRemove +---@field id string + +---@class (exact) RuntimeDiffSection +---@field creates? RuntimeNode[] +---@field updates? RuntimeNodeUpdate[] +---@field removes? (string|RuntimeNodeRemove)[] + +---@class (exact) RuntimeDiff +---@field render? RuntimeDiffSection +---@field ui? RuntimeDiffSection +---@field commands? RuntimeCommand[] + +---@class (exact) RuntimeEvent +---@field type RuntimeEventType|string +---@field target? string +---@field handler? string +---@field x? number +---@field y? number +---@field data? table + +---@class (exact) RuntimeCommand +---@field type RuntimeCommandType +---@field target? string +---@field scope? string +---@field id? string +---@field group? string +---@field commandGroup? string +---@field onComplete? string +---@field duration? number +---@field commands? RuntimeCommand[] +---@field path? RuntimePoint[] +---@field x? number +---@field y? number +---@field alpha? number +---@field scale? number +---@field angle? number +---@field text? string +---@field message? string +---@field asset? string +---@field name? string +---@field volume? number +---@field channel? string +---@field loop? boolean +---@field failOnError? boolean +---@field animation? string +---@field track? integer +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeCommandOpts +---@field id? string +---@field group? string +---@field commandGroup? string +---@field scope? string +---@field onComplete? string +---@field duration? number + +---@class (exact) RuntimeAudioCommandOpts: RuntimeCommandOpts +---@field volume? number +---@field name? string + +---@class (exact) RuntimeBgmCommandOpts: RuntimeAudioCommandOpts +---@field channel? string +---@field loop? boolean + +---@class (exact) RuntimeSpineCommandOpts: RuntimeCommandOpts +---@field track? integer +---@field loop? boolean +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeResourceCommandOpts: RuntimeCommandOpts +---@field failOnError? boolean + +---@class (exact) RuntimePoint +---@field x number +---@field y number + +---@class (exact) RuntimeLocaleContext +---@field requested string +---@field resolved string +---@field default string +---@field supported string[] +---@field languageCode string +---@field scriptCode? string +---@field countryCode? string + +---@class (exact) RuntimeScreenContext +---@field width number +---@field height number + +---@class (exact) RuntimeDesignContext +---@field width number +---@field height number + +---@class (exact) RuntimeViewportContext +---@field x number +---@field y number +---@field width number +---@field height number +---@field scaleX number +---@field scaleY number +---@field scaleMode RuntimeScaleMode|string + +---@class (exact) RuntimeContext +---@field screen RuntimeScreenContext +---@field design RuntimeDesignContext +---@field viewport RuntimeViewportContext +---@field seed integer +---@field runtimeApiVersion integer +---@field gameId string +---@field gameVersion string +---@field locale? RuntimeLocaleContext + +---@class RuntimeUi +---@field style fun(base?: RuntimeNodeProps, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field with_parent fun(parent: string, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field node fun(node_type: RuntimeNodeType, id: string, opts?: RuntimeNodeInit): RuntimeNode +---@field panel fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field rect fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field circle fun(id: string, x: number|RuntimeNodeInit, y?: number, size?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field line fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field particle fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field text fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field button fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field list_view fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field image fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field sprite fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field spine fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, animation?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field update fun(id: string, props: RuntimeNodeInit): RuntimeNodeUpdate +---@field text_update fun(id: string, text: string): RuntimeNodeUpdate +---@field visible_update fun(id: string, visible: boolean): RuntimeNodeUpdate +---@field alpha_update fun(id: string, alpha: number): RuntimeNodeUpdate +---@field scale_update fun(id: string, scale: number): RuntimeNodeUpdate +---@field position_update fun(id: string, x: number, y: number): RuntimeNodeUpdate +---@field size_update fun(id: string, width: number, height: number): RuntimeNodeUpdate +---@field transform_update fun(id: string, x: number, y: number, scale: number, rotation: number): RuntimeNodeUpdate +---@field batch_update fun(ids: string[], props: RuntimeNodeInit): RuntimeNodeUpdate[] +---@field append fun(nodes: RuntimeNode[], node: RuntimeNode): RuntimeNode[] +---@field append_all fun(nodes: RuntimeNode[], extra_nodes: RuntimeNode[]): RuntimeNode[] + +---@class (exact) RuntimeDialogButton +---@field id? string +---@field text string +---@field handler string +---@field color? string + +---@class (exact) RuntimeDialogOpts +---@field screenWidth? number +---@field screenHeight? number +---@field overlay? boolean +---@field overlayColor? string +---@field blockInput? boolean +---@field layer? integer +---@field color? string +---@field radius? number +---@field panelStyle? RuntimeNodeProps +---@field titleColor? string +---@field titleSize? number +---@field titleStyle? RuntimeNodeProps +---@field messageColor? string +---@field messageSize? number +---@field messageStyle? RuntimeNodeProps +---@field buttons? RuntimeDialogButton[] +---@field buttonGap? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeLabeledProgressOpts: RuntimeNodeInit +---@field labelHeight? number +---@field labelStyle? RuntimeNodeProps + +---@class RuntimePillOpts: RuntimeNodeInit +---@field panelStyle? RuntimeNodeProps +---@field textStyle? RuntimeNodeProps + +---@class RuntimeTextButtonOpts: RuntimeNodeInit +---@field variant? RuntimeButtonVariant + +---@class RuntimeListItemOpts: RuntimeTextButtonOpts +---@field selected? boolean +---@field activeColor? string +---@field inactiveColor? string + +---@class RuntimeTabItem +---@field id? string +---@field key? string +---@field text string +---@field handler? string +---@field selected? boolean + +---@class RuntimeTabsOpts: RuntimeNodeInit +---@field tabs? RuntimeTabItem[] +---@field selected? string +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field activeColor? string +---@field inactiveColor? string +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeActionItem +---@field id? string +---@field text string +---@field handler? string +---@field visible? boolean +---@field color? string +---@field style? RuntimeNodeProps + +---@class RuntimeActionRowOpts: RuntimeNodeInit +---@field actions? RuntimeActionItem[] +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimePanelHeaderOpts: RuntimeNodeInit +---@field eyebrow? string +---@field title string +---@field summary? string +---@field gap? number +---@field eyebrowId? string +---@field titleId? string +---@field summaryId? string +---@field eyebrowHeight? number +---@field titleHeight? number +---@field summaryHeight? number +---@field eyebrowStyle? RuntimeNodeProps +---@field titleStyle? RuntimeNodeProps +---@field summaryStyle? RuntimeNodeProps + +---@class RuntimeWidgetTheme +---@field primary? string +---@field secondary? string +---@field success? string +---@field overlay? string +---@field surface? string +---@field surfaceAlt? string +---@field card? string +---@field text? string +---@field muted? string +---@field progress? string +---@field transparent? string + +---@class RuntimeWidgets +---@field configure fun(tokens?: RuntimeWidgetTheme): RuntimeWidgets +---@field label fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field section_title fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field pill fun(id: string, text: string|RuntimePillOpts, x?: number, y?: number, width?: number, height?: number, opts?: RuntimePillOpts): RuntimeNode[] +---@field text_button fun(id: string, text: string|RuntimeTextButtonOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeTextButtonOpts): RuntimeNode +---@field list_item fun(id: string, text: string|RuntimeListItemOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeListItemOpts): RuntimeNode +---@field tabs fun(id: string, tabs: RuntimeTabItem[]|RuntimeTabsOpts, opts?: RuntimeTabsOpts): RuntimeNode[] +---@field action_row fun(id: string, actions: RuntimeActionItem[]|RuntimeActionRowOpts, opts?: RuntimeActionRowOpts): RuntimeNode[] +---@field panel_header fun(id: string, opts: RuntimePanelHeaderOpts): RuntimeNode[] +---@field overlay fun(id: string, width: number|RuntimeNodeInit, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field card fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress_bar fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field labeled_progress fun(id: string, label: string, x: number, y: number, width: number, height: number, value: number, opts?: RuntimeLabeledProgressOpts): RuntimeNode[] +---@field button_row fun(parent: string, id: string, buttons: RuntimeDialogButton[], x: number, y: number, width: number, height: number, gap?: number, opts?: RuntimeNodeProps): RuntimeNode[] +---@field dialog fun(id: string, title: string, message: string, x: number, y: number, width: number, height: number, opts?: RuntimeDialogOpts): RuntimeNode[] + +---@class (exact) RuntimeLayoutItem +---@field node RuntimeNode +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLayoutItemOpts +---@field margin? number +---@field mx? number +---@field my? number +---@field ml? number +---@field mr? number +---@field mt? number +---@field mb? number +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLinearLayoutOpts +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field gap? number +---@field align? RuntimeLayoutAlign +---@field padding? number +---@field paddingX? number +---@field paddingY? number +---@field px? number +---@field py? number +---@field paddingLeft? number +---@field paddingTop? number + +---@class RuntimeBoxLayoutOpts: RuntimeLinearLayoutOpts +---@field rows? integer +---@field columns? integer +---@field cols? integer +---@field cellWidth? number +---@field cellHeight? number +---@field cellW? number +---@field cellH? number +---@field gapX? number +---@field gapY? number +---@field valign? RuntimeLayoutAlign + +---@class RuntimeLayout +---@field item fun(node: RuntimeNode, opts?: RuntimeLayoutItemOpts): RuntimeLayoutItem +---@field local_position fun(origin: RuntimePoint, position: RuntimePoint): RuntimePoint +---@field row fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field column fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field stack fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field box fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeBoxLayoutOpts): RuntimeNode[] + +---@class RuntimeCommands +---@field toast fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field copy_text fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field delay fun(duration: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field sequence fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field parallel fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_path fun(target: string, path: RuntimePoint[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_to fun(target: string, x: number, y: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field fade_to fun(target: string, alpha: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field scale_to fun(target: string, scale: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field rotate_to fun(target: string, angle: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field remove_node fun(target: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field play_spine_animation fun(target: string, animation: string, opts?: RuntimeSpineCommandOpts): RuntimeCommand +---@field play_sound fun(asset: string, opts?: RuntimeAudioCommandOpts): RuntimeCommand +---@field play_bgm fun(asset: string, opts?: RuntimeBgmCommandOpts): RuntimeCommand +---@field pause_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field resume_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field stop_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field preload_group fun(group: string, opts?: RuntimeResourceCommandOpts): RuntimeCommand +---@field evict_group fun(group: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field cancel_id fun(id: string): RuntimeCommand +---@field cancel_group fun(group: string): RuntimeCommand +---@field cancel_scope fun(scope: string): RuntimeCommand + +---@class RuntimeImportApi +---@field import fun(moduleName: string): table + +---@type RuntimeImportApi +runtime = runtime + +---@class (exact) ShowcaseAction +---@field text string +---@field text_en? string +---@field handler string + +---@class (exact) ShowcaseExample +---@field id string +---@field group string +---@field group_en? string +---@field category string +---@field category_en? string +---@field menu string +---@field menu_en? string +---@field title string +---@field title_en? string +---@field summary string +---@field summary_en? string +---@field code string +---@field params string +---@field params_en? string +---@field actions ShowcaseAction[] + +---@class (exact) ShowcaseState +---@field selected_example string +---@field detail_tab string +---@field progress number +---@field visible boolean +---@field dialog_open boolean +---@field temp_node_visible boolean +---@field bgm_state string +---@field resource_state string +---@field text_variant string +---@field button_active boolean +---@field sprite_variant string +---@field layout_mode string +---@field radio_selected string +---@field list_selected string +---@field list_axis string +---@field list_scroll_x number +---@field list_scroll_y number +---@field locale string +---@field screen_width number +---@field screen_height number +---@field viewport_width number +---@field viewport_height number +---@field viewport_scale number +---@field responsive_mode string +---@field status string diff --git a/example/assets/games/showcase/scripts/state.lua b/example/assets/games/showcase/scripts/state.lua new file mode 100644 index 0000000..6916fff --- /dev/null +++ b/example/assets/games/showcase/scripts/state.lua @@ -0,0 +1,32 @@ +---@class ShowcaseState +local state = { + selected_example = "nodes", + detail_tab = "code", + progress = 0.35, + visible = true, + dialog_open = false, + temp_node_visible = false, + bgm_state = "stopped", + resource_state = "ready", + text_variant = "plain", + button_active = true, + button_image_enabled = true, + sprite_variant = "image", + layout_mode = "row", + radio_selected = "audio", + list_selected = "Lua", + list_axis = "vertical", + list_scroll_x = 0, + list_scroll_y = 0, + locale = "zh-Hans", + screen_width = 720, + screen_height = 720, + viewport_width = 720, + viewport_height = 720, + viewport_scale = 1, + responsive_mode = "desktop", + particle_seed = 0, + status = "点击按钮查看 RuntimeEvent -> Lua -> Diff / Command 示例" +} + +return state diff --git a/example/assets/games/showcase/scripts/styles.lua b/example/assets/games/showcase/scripts/styles.lua new file mode 100644 index 0000000..504a267 --- /dev/null +++ b/example/assets/games/showcase/scripts/styles.lua @@ -0,0 +1,44 @@ +local theme = runtime.import("theme") + +---@class ShowcaseStyles +local styles = {} + +styles.title = { + color = theme.text, + fontSize = 24, + layer = 20 +} + +styles.label = { + color = theme.muted, + fontSize = 14, + layer = 20 +} + +styles.value = { + color = theme.text, + fontSize = 16, + layer = 20 +} + +styles.button = { + color = "#ff2563eb", + radius = 10, + fontSize = 14, + layer = 30 +} + +styles.small_button = { + color = "#ff334155", + radius = 8, + fontSize = 12, + layer = 30 +} + +styles.card = { + color = theme.card, + radius = 14, + layer = 10 +} + +return styles diff --git a/example/assets/games/showcase/scripts/theme.lua b/example/assets/games/showcase/scripts/theme.lua new file mode 100644 index 0000000..149d835 --- /dev/null +++ b/example/assets/games/showcase/scripts/theme.lua @@ -0,0 +1,18 @@ +---@class ShowcaseTheme +local theme = { + screen_width = 720, + screen_height = 720, + background = "#ff0f172a", + panel = "#ff111827", + card = "#ff1f2937", + border = "#ff334155", + text = "#fff8fafc", + muted = "#ff94a3b8", + primary = "#ff38bdf8", + success = "#ff22c55e", + warning = "#fff59e0b", + danger = "#ffef4444", + purple = "#ffa855f7" +} + +return theme diff --git a/example/assets/games/showcase/scripts/ui.lua b/example/assets/games/showcase/scripts/ui.lua new file mode 100644 index 0000000..6996edc --- /dev/null +++ b/example/assets/games/showcase/scripts/ui.lua @@ -0,0 +1,1300 @@ +---@type RuntimeUi +local runtime_ui = runtime.import("runtime_ui") +---@type RuntimeWidgets +local widgets = runtime.import("runtime_widgets") +local theme = runtime.import("theme") +local styles = runtime.import("styles") +local state = runtime.import("state") +local examples = runtime.import("examples") +local i18n = runtime.import("i18n") + +---@class ShowcaseUi +local ui = {} + +local base_preview_ids = { + "sample_rect", + "sample_circle", + "sample_line", + "sample_image_node", + "sample_sprite_node", + "sample_progress", + "widget_progress_label", + "widget_progress" +} + +local text_preview_ids = { + "text_plain_title", + "text_plain_body", + "text_style_badge", + "text_rich_note" +} + +local button_preview_ids = { + "button_hint", + "button_primary", + "button_secondary", + "button_disabled", + "button_state_text" +} + +local button_image_preview_ids = { + "image_button_hint", + "image_button_normal", + "image_button_toggle", + "image_button_disabled", + "image_button_state_text" +} + +local sprite_preview_ids = { + "sprite_image_demo", + "sprite_sprite_demo", + "sprite_frame_demo", + "sprite_label_demo" +} + +local layout_preview_ids = { + "layout_canvas", + "layout_chip_1", + "layout_chip_2", + "layout_chip_3", + "layout_chip_4", + "layout_label" +} + +local radio_preview_ids = { + "radio_title", + "radio_audio_dot", + "radio_audio_label", + "radio_spine_dot", + "radio_spine_label", + "radio_lua_dot", + "radio_lua_label", + "radio_value_text" +} + +local list_preview_ids = { + "list_panel", + "list_row_1", + "list_row_2", + "list_row_3", + "list_row_4", + "list_row_5", + "list_row_1_text", + "list_row_2_text", + "list_row_3_text", + "list_row_4_text", + "list_row_5_text", + "list_value_text" +} + +local particle_preview_ids = { + "particle_burst", + "particle_trail", + "particle_snow", + "particle_label" +} + +local responsive_preview_ids = { + "responsive_info", + "responsive_device", + "responsive_sidebar", + "responsive_content" +} + +---@return table +local function metrics() + local screen_w = theme.screen_width + local screen_h = theme.screen_height + local margin = 20 + local gap = 16 + local header_h = 82 + local status_h = 30 + local content_h = screen_h - header_h - status_h - margin + local compact = screen_w < 640 + local menu_w = compact and 188 or 220 + local detail_w = screen_w - margin * 2 - gap - menu_w + local content_y = header_h + local preview_h = 148 + local action_y = content_y + content_h - preview_h - 54 + local preview_y = content_y + content_h - preview_h - 10 + local code_h = action_y - content_y - 150 + if code_h < 128 then + code_h = 128 + end + + return { + screen_w = screen_w, + screen_h = screen_h, + margin = margin, + gap = gap, + compact = compact, + menu_x = margin, + menu_y = content_y, + menu_w = menu_w, + detail_x = margin + menu_w + gap, + detail_y = content_y, + detail_w = detail_w, + content_h = content_h, + action_y = action_y, + preview_y = preview_y, + preview_h = preview_h, + code_h = code_h, + status_y = screen_h - status_h - 8 + } +end + +---@param example ShowcaseExample +---@return boolean +local function preview_mode(example) + if example.id == "text_demo" then + return "text" + end + if example.id == "buttons" then + return "buttons" + end + if example.id == "button_images" then + return "button_images" + end + if example.id == "sprites" then + return "sprites" + end + if example.id == "layout_demo" then + return "layout" + end + if example.id == "radio_group" then + return "radio" + end + if example.id == "list_view" then + return "list" + end + if example.id == "particles" then + return "particle" + end + if example.id == "responsive" then + return "responsive" + end + return "base" +end + +---@param nodes RuntimeNode[] +---@param text string +---@param y number +---@param m table +local function append_menu_group(nodes, text, y, m) + table.insert(nodes, widgets.label("group_" .. tostring(y), { + text = text, + x = 16, + y = y, + w = m.menu_w - 32, + h = 18, + parent = "example_list_panel", + color = theme.muted, + fontSize = 11, + layer = 30 + })) +end + +---@param nodes RuntimeNode[] +---@param example ShowcaseExample +---@param y number +---@param m table +local function append_menu_item(nodes, example, y, m) + local selected = example.id == state.selected_example + table.insert(nodes, widgets.list_item("example_" .. example.id, { + text = i18n.example_label(example), + x = 14, + y = y, + w = m.menu_w - 28, + h = 27, + handler = "select_example", + parent = "example_list_panel", + selected = selected, + activeColor = theme.primary, + inactiveColor = "#ff1e293b", + radius = 10, + fontSize = 11, + layer = 31 + })) +end + +---@param selected ShowcaseExample +---@param m table +---@return RuntimeNode[] +local function detail_action_nodes(selected, m) + local actions = {} + for index = 1, 3 do + local action = selected.actions[index] + actions[index] = { + id = "detail_action_" .. index, + text = action ~= nil and i18n.action_text(action) or "", + handler = action ~= nil and action.handler or "noop", + visible = action ~= nil, + color = index == 1 and "#ff2563eb" or "#ff334155" + } + end + return widgets.action_row("detail_action", actions, { + x = m.detail_x + 20, + y = m.action_y, + width = m.detail_w - 40, + itemHeight = 34, + gap = 12, + radius = 10, + fontSize = 12, + layer = 35 + }) +end + +---@param example ShowcaseExample +---@return string +local function detail_body(example) + if state.detail_tab == "params" then + return i18n.example_params(example) + end + return example.code +end + +---@return string +local function detail_copy_text() + if state.detail_tab == "params" then + return i18n.t("copy_params") + end + return i18n.t("copy_code") +end + +---@param text string +---@return integer +local function line_count(text) + local value = text or "" + local count = 1 + local start = 1 + while true do + local index = string.find(value, "\n", start, true) + if index == nil then + return count + end + count = count + 1 + start = index + 1 + end +end + +local detail_text_y + +local detail_padding_left = 14 +local detail_padding_top = 12 +local detail_padding_right = 14 +local detail_padding_bottom = 12 + +---@param m table +---@return number +local function detail_viewport_width(m) + return m.detail_w - 40 - detail_padding_left - detail_padding_right +end + +---@param m table +---@return number +local function detail_viewport_height(m) + return m.code_h + 18 - detail_padding_top - detail_padding_bottom +end + +---@param example ShowcaseExample +---@return number +local function detail_text_height(example) + return line_count(detail_body(example)) * 16 + 8 +end + +---@param example ShowcaseExample +---@param m table +---@return number +local function detail_content_height(example, m) + local estimated = detail_text_y(example, m) + detail_text_height(example) + 18 + local viewport_h = detail_viewport_height(m) + if estimated < viewport_h then + return viewport_h + end + return estimated +end + +---@param m table +---@return number +local function detail_content_width(m) + local viewport_w = detail_viewport_width(m) + if state.detail_tab == "params" then + return viewport_w + end + if line_count(detail_body(examples.find(state.selected_example))) <= 7 then + return viewport_w + end + return viewport_w * 1.45 +end + +---@param example ShowcaseExample +---@param m table +---@return number +local function detail_text_width(example, m) + local viewport_w = detail_viewport_width(m) + if state.detail_tab == "params" then + return viewport_w * 0.78 + end + local content_w = detail_content_width(m) - 28 + local centered_w = viewport_w * 0.78 + if line_count(detail_body(example)) <= 7 then + return centered_w + end + return content_w +end + +---@param example ShowcaseExample +---@param m table +---@return number +local function detail_text_x(example, m) + local viewport_w = detail_viewport_width(m) + local width = detail_text_width(example, m) + if state.detail_tab == "code" and width > viewport_w then + return 14 + end + local x = (viewport_w - width) / 2 + if x < 0 then + return 0 + end + return x +end + +---@param example ShowcaseExample +---@param m table +---@return number +detail_text_y = function(example, m) + return 0 +end + +---@return string +local function responsive_text() + local scale = state.viewport_scale or 1 + local width = state.screen_width or theme.screen_width + local height = state.screen_height or theme.screen_height + local viewport_w = state.viewport_width or theme.screen_width + local viewport_h = state.viewport_height or theme.screen_height + return i18n.t("responsive_design") .. ": " .. tostring(theme.screen_width) .. "x" .. tostring(theme.screen_height) + .. " | " .. i18n.t("responsive_screen") .. ": " .. tostring(math.floor(width)) .. "x" .. tostring(math.floor(height)) + .. " | " .. i18n.t("responsive_viewport") .. ": " .. tostring(math.floor(viewport_w)) .. "x" .. tostring(math.floor(viewport_h)) + .. " @" .. string.format("%.2f", scale) +end + +---@return number +local function responsive_device_width() + if state.responsive_mode == "phone" then + return 92 + end + if state.responsive_mode == "tablet" then + return 124 + end + return 148 +end + +---@param nodes RuntimeNode[] +---@param selected ShowcaseExample +local function append_preview_nodes(nodes, selected) + local mode = preview_mode(selected) + local base_visible = mode == "base" + local text_visible = mode == "text" + local button_visible = mode == "buttons" + local button_image_visible = mode == "button_images" + local sprite_visible = mode == "sprites" + local layout_visible = mode == "layout" + local radio_visible = mode == "radio" + local list_visible = mode == "list" + local particle_visible = mode == "particle" + local responsive_visible = mode == "responsive" + + table.insert(nodes, runtime_ui.rect("sample_rect", 16, 48, 70, 44, { + parent = "preview_panel", + color = theme.primary, + radius = 8, + layer = 25, + visible = base_visible + })) + table.insert(nodes, runtime_ui.circle("sample_circle", 104, 42, 54, { + parent = "preview_panel", + color = theme.success, + interactive = true, + onTap = "demo_anim", + layer = 25, + visible = base_visible + })) + table.insert(nodes, runtime_ui.line("sample_line", 176, 70, 82, 0, { + parent = "preview_panel", + color = theme.warning, + strokeWidth = 4, + layer = 25, + visible = base_visible + })) + table.insert(nodes, runtime_ui.image("sample_image_node", "sample_image", 278, 42, 48, 48, { + parent = "preview_panel", + layer = 25, + visible = base_visible + })) + table.insert(nodes, runtime_ui.sprite("sample_sprite_node", "sample_image", 340, 42, 48, 48, { + parent = "preview_panel", + layer = 25, + visible = base_visible + })) + table.insert(nodes, runtime_ui.progress("sample_progress", 16, 112, 180, 16, state.progress, { + parent = "preview_panel", + color = theme.success, + radius = 8, + layer = 25, + visible = base_visible + })) + local progress_nodes = widgets.labeled_progress("widget_progress", "Widget Progress", 220, 98, 170, 12, state.progress, { + parent = "preview_panel", + labelStyle = { parent = "preview_panel", color = theme.muted, fontSize = 12, layer = 25, visible = base_visible }, + color = theme.primary, + layer = 25, + visible = base_visible + }) + runtime_ui.append_all(nodes, progress_nodes) + + table.insert(nodes, runtime_ui.text("text_plain_title", state.text_variant == "plain" and "Text: 纯文本组件" or "Text: 样式已切换", 16, 46, 260, 24, { + parent = "preview_panel", + color = state.text_variant == "plain" and theme.text or theme.warning, + fontSize = state.text_variant == "plain" and 18 or 20, + layer = 25, + visible = text_visible + })) + table.insert(nodes, runtime_ui.text("text_plain_body", "字段：text / color / fontSize / alpha", 16, 78, 310, 20, { + parent = "preview_panel", + color = theme.muted, + fontSize = 12, + layer = 25, + visible = text_visible + })) + table.insert(nodes, runtime_ui.rect("text_style_badge", 16, 108, 92, 24, { + parent = "preview_panel", + color = state.text_variant == "plain" and theme.primary or theme.purple, + radius = 8, + layer = 25, + visible = text_visible + })) + table.insert(nodes, runtime_ui.text("text_rich_note", "富文本：当前未支持 richText/spans", 124, 111, 240, 18, { + parent = "preview_panel", + color = theme.warning, + fontSize = 12, + layer = 26, + visible = text_visible + })) + + table.insert(nodes, runtime_ui.text("button_hint", "button: text + background + onTap", 16, 44, 240, 20, { + parent = "preview_panel", + color = theme.muted, + fontSize = 12, + layer = 25, + visible = button_visible + })) + table.insert(nodes, runtime_ui.button("button_primary", "主按钮", 16, 76, 108, 34, "demo_button_primary", { + parent = "preview_panel", + color = state.button_active and theme.primary or "#ff475569", + radius = 10, + fontSize = 13, + layer = 26, + visible = button_visible + })) + table.insert(nodes, runtime_ui.button("button_secondary", "次按钮", 138, 76, 108, 34, "demo_button_primary", { + parent = "preview_panel", + color = "#ff334155", + radius = 10, + fontSize = 13, + layer = 26, + visible = button_visible + })) + table.insert(nodes, runtime_ui.button("button_disabled", "禁用态", 260, 76, 108, 34, "noop", { + parent = "preview_panel", + color = "#ff1f2937", + radius = 10, + fontSize = 13, + alpha = 0.55, + interactive = false, + layer = 26, + visible = button_visible + })) + table.insert(nodes, runtime_ui.text("button_state_text", state.button_active and "状态：可点击" or "状态：已置灰", 16, 118, 220, 18, { + parent = "preview_panel", + color = theme.warning, + fontSize = 12, + layer = 26, + visible = button_visible + })) + + table.insert(nodes, runtime_ui.text("image_button_hint", "button image: normal / pressed / disabled", 16, 44, 300, 20, { + parent = "preview_panel", + color = theme.muted, + fontSize = 12, + layer = 25, + visible = button_image_visible + })) + table.insert(nodes, runtime_ui.button("image_button_normal", { + text = "按住 Pressed", + x = 16, + y = 76, + w = 116, + h = 40, + handler = "demo_button_image_tap", + parent = "preview_panel", + asset = "button_normal", + pressedAsset = "button_pressed", + disabledAsset = "button_disabled", + radius = 10, + fontSize = 12, + layer = 26, + visible = button_image_visible + })) + table.insert(nodes, runtime_ui.button("image_button_toggle", { + text = state.button_image_enabled and "可切换" or "已禁用", + x = 144, + y = 76, + w = 116, + h = 40, + handler = "demo_button_image_tap", + parent = "preview_panel", + asset = "button_normal", + pressedAsset = "button_pressed", + disabledAsset = "button_disabled", + radius = 10, + fontSize = 12, + interactive = state.button_image_enabled, + layer = 26, + visible = button_image_visible + })) + table.insert(nodes, runtime_ui.button("image_button_disabled", { + text = "Disabled", + x = 272, + y = 76, + w = 116, + h = 40, + handler = "noop", + parent = "preview_panel", + asset = "button_normal", + pressedAsset = "button_pressed", + disabledAsset = "button_disabled", + radius = 10, + fontSize = 12, + interactive = false, + layer = 26, + visible = button_image_visible + })) + table.insert(nodes, runtime_ui.text("image_button_state_text", state.button_image_enabled and "中间按钮：interactive=true" or "中间按钮：interactive=false，显示 disabledAsset", 16, 122, 360, 18, { + parent = "preview_panel", + color = theme.warning, + fontSize = 12, + layer = 26, + visible = button_image_visible + })) + + table.insert(nodes, runtime_ui.image("sprite_image_demo", "sample_image", 24, 54, 64, 64, { + parent = "preview_panel", + layer = 25, + visible = sprite_visible + })) + table.insert(nodes, runtime_ui.sprite("sprite_sprite_demo", "sample_image", 118, 54, 64, 64, { + parent = "preview_panel", + layer = 26, + visible = sprite_visible + })) + table.insert(nodes, runtime_ui.rect("sprite_frame_demo", 212, 54, 64, 64, { + parent = "preview_panel", + color = state.sprite_variant == "image" and theme.primary or theme.purple, + radius = 8, + layer = 25, + visible = sprite_visible + })) + table.insert(nodes, runtime_ui.text("sprite_label_demo", "image / sprite 都通过 manifest key 加载", 20, 120, 300, 18, { + parent = "preview_panel", + color = theme.muted, + fontSize = 12, + layer = 26, + visible = sprite_visible + })) + + table.insert(nodes, runtime_ui.panel("layout_canvas", 16, 42, 360, 86, { + parent = "preview_panel", + color = "#ff111827", + radius = 10, + layer = 24, + visible = layout_visible + })) + table.insert(nodes, runtime_ui.rect("layout_chip_1", 34, 70, 58, 28, { + parent = "preview_panel", + color = theme.primary, + radius = 8, + layer = 26, + visible = layout_visible + })) + table.insert(nodes, runtime_ui.rect("layout_chip_2", 108, 70, 58, 28, { + parent = "preview_panel", + color = theme.success, + radius = 8, + layer = 26, + visible = layout_visible + })) + table.insert(nodes, runtime_ui.rect("layout_chip_3", 182, 70, 58, 28, { + parent = "preview_panel", + color = theme.warning, + radius = 8, + layer = 26, + visible = layout_visible + })) + table.insert(nodes, runtime_ui.rect("layout_chip_4", 256, 70, 58, 28, { + parent = "preview_panel", + color = theme.purple, + radius = 8, + layer = 26, + visible = layout_visible + })) + table.insert(nodes, runtime_ui.text("layout_label", "layout.row：gap + align + margin", 28, 112, 280, 18, { + parent = "preview_panel", + color = theme.muted, + fontSize = 12, + layer = 26, + visible = layout_visible + })) + + table.insert(nodes, runtime_ui.text("radio_title", "RadioGroup: Lua 组合单选项", 16, 44, 260, 20, { + parent = "preview_panel", + color = theme.muted, + fontSize = 12, + layer = 25, + visible = radio_visible + })) + local radio_options = { + { key = "audio", label = "Audio", y = 72 }, + { key = "spine", label = "Spine", y = 96 }, + { key = "Lua", label = "Lua", y = 120 } + } + for _, option in ipairs(radio_options) do + local selected_radio = state.radio_selected == option.key + table.insert(nodes, runtime_ui.circle("radio_" .. string.lower(option.key) .. "_dot", 18, option.y, 14, { + parent = "preview_panel", + color = selected_radio and theme.primary or "#ff475569", + layer = 25, + visible = radio_visible + })) + table.insert(nodes, runtime_ui.text("radio_" .. string.lower(option.key) .. "_label", option.label, 42, option.y - 2, 120, 18, { + parent = "preview_panel", + color = selected_radio and theme.text or theme.muted, + fontSize = 12, + layer = 25, + visible = radio_visible + })) + end + table.insert(nodes, runtime_ui.text("radio_value_text", "当前选择：" .. state.radio_selected, 190, 96, 160, 18, { + parent = "preview_panel", + color = theme.warning, + fontSize = 12, + layer = 25, + visible = radio_visible + })) + + local list_horizontal = state.list_axis == "horizontal" + table.insert(nodes, runtime_ui.list_view("list_panel", 16, 42, 320, 72, { + parent = "preview_panel", + color = "#ff111827", + radius = 10, + contentWidth = list_horizontal and 650 or 430, + contentHeight = list_horizontal and 90 or 150, + scrollX = state.list_scroll_x, + scrollY = state.list_scroll_y, + virtualized = true, + cacheExtent = 24, + inertia = true, + onScroll = "demo_list_scrolled", + scrollbarThumbColor = theme.warning, + scrollbarTrackColor = "#33475569", + scrollbarThickness = 6, + layer = 24, + visible = list_visible + })) + local list_items = { + { key = "Lua", label = "Lua 脚本层" }, + { key = "Runtime", label = "Runtime 协议层" }, + { key = "Flame", label = "Flame 渲染层" }, + { key = "Diff", label = "Diff 更新流" }, + { key = "Command", label = "Command 动作流" } + } + for index, item in ipairs(list_items) do + local selected_item = state.list_selected == item.key + local row_x = list_horizontal and (8 + (index - 1) * 126) or 8 + local row_y = list_horizontal and 18 or (8 + (index - 1) * 28) + local row_w = list_horizontal and 116 or 292 + table.insert(nodes, runtime_ui.button("list_row_" .. index, "", row_x, row_y, row_w, 24, "demo_list_pick_" .. index, { + parent = "list_panel", + color = selected_item and theme.primary or "#ff1e293b", + radius = 7, + layer = 25, + visible = list_visible + })) + table.insert(nodes, runtime_ui.text("list_row_" .. index .. "_text", item.label, 12, 4, 180, 16, { + parent = "list_row_" .. index, + color = theme.text, + fontSize = 11, + textAlign = "left", + layer = 26, + visible = list_visible + })) + end + table.insert(nodes, runtime_ui.text("list_value_text", state.list_axis .. " scrollX=" .. tostring(state.list_scroll_x) .. " scrollY=" .. tostring(state.list_scroll_y), 16, 120, 300, 16, { + parent = "preview_panel", + color = theme.warning, + fontSize = 11, + layer = 26, + visible = list_visible + })) + + table.insert(nodes, runtime_ui.particle("particle_burst", 32, 42, 120, 92, { + parent = "preview_panel", + preset = "burst", + count = 42, + duration = 0.85, + color = "#ffffcc33", + colorTo = "#00ffcc33", + radius = 2.8, + speedMin = 60, + speedMax = 180, + gravityY = 90, + spread = 360, + autoRemove = false, + layer = 26, + visible = particle_visible + })) + table.insert(nodes, runtime_ui.particle("particle_trail", 168, 46, 120, 86, { + parent = "preview_panel", + preset = "trail", + count = 24, + duration = 0.7, + color = "#ff38bdf8", + radius = 2.2, + speedMin = 20, + speedMax = 80, + autoRemove = false, + layer = 26, + visible = particle_visible + })) + table.insert(nodes, runtime_ui.particle("particle_snow", 304, 34, 120, 104, { + parent = "preview_panel", + preset = "snow", + count = 56, + duration = 8, + color = "#ccffffff", + radius = 1.5, + autoRemove = false, + fadeOut = false, + layer = 26, + visible = particle_visible + })) + table.insert(nodes, runtime_ui.text("particle_label", "particle: burst / trail / snow", 16, 120, 280, 18, { + parent = "preview_panel", + color = theme.warning, + fontSize = 11, + layer = 27, + visible = particle_visible + })) + + local width = responsive_device_width() + table.insert(nodes, runtime_ui.text("responsive_info", responsive_text(), 16, 112, 390, 18, { + parent = "preview_panel", + color = theme.muted, + fontSize = 10, + layer = 26, + visible = responsive_visible + })) + table.insert(nodes, runtime_ui.rect("responsive_device", 172, 44, width, 62, { + parent = "preview_panel", + color = "#ff1d4ed8", + radius = 10, + layer = 26, + visible = responsive_visible + })) + table.insert(nodes, runtime_ui.rect("responsive_sidebar", 184, 56, width * 0.26, 38, { + parent = "preview_panel", + color = theme.primary, + radius = 6, + layer = 27, + visible = responsive_visible + })) + table.insert(nodes, runtime_ui.rect("responsive_content", 192 + width * 0.26, 56, width * 0.56, 38, { + parent = "preview_panel", + color = theme.success, + radius = 6, + layer = 27, + visible = responsive_visible + })) +end + +---@return RuntimeNode[] +function ui.create_nodes() + local nodes = {} + local selected = examples.find(state.selected_example) + local m = metrics() + + table.insert(nodes, runtime_ui.rect("app_bg", 0, 0, theme.screen_width, theme.screen_height, { + color = theme.background, + layer = 0 + })) + table.insert(nodes, runtime_ui.text("app_title", i18n.t("app_title"), 24, 18, 360, 34, styles.title)) + table.insert(nodes, runtime_ui.text("app_subtitle", i18n.t("app_subtitle"), 24, 52, 660, 24, styles.label)) + + table.insert(nodes, runtime_ui.panel("example_list_panel", m.menu_x, m.menu_y, m.menu_w, m.content_h, styles.card)) + table.insert(nodes, widgets.section_title("example_list_title", { + text = i18n.t("examples_title"), + x = 16, + y = 14, + w = m.menu_w - 32, + h = 24, + parent = "example_list_panel", + color = theme.text, + fontSize = 20, + layer = 25 + })) + local menu_y = 44 + local last_group = nil + for _, example in ipairs(examples.all()) do + local group = i18n.example_group(example) + if group ~= last_group then + append_menu_group(nodes, group, menu_y, m) + menu_y = menu_y + 15 + last_group = group + end + append_menu_item(nodes, example, menu_y, m) + menu_y = menu_y + 32 + end + + table.insert(nodes, runtime_ui.panel("detail_panel", m.detail_x, m.detail_y, m.detail_w, m.content_h, styles.card)) + runtime_ui.append_all(nodes, widgets.panel_header("detail", { + eyebrow = i18n.example_group(selected) .. " / " .. i18n.example_field(selected, "category"), + title = i18n.example_field(selected, "title"), + summary = i18n.example_field(selected, "summary"), + x = 20, + y = 16, + w = m.detail_w - 40, + parent = "detail_panel", + layer = 25, + gap = 4, + eyebrowHeight = 20, + titleHeight = 30, + summaryHeight = 24, + eyebrowId = "detail_category", + titleId = "detail_title", + summaryId = "detail_summary", + eyebrowStyle = { color = theme.primary, fontSize = 13 }, + titleStyle = { color = theme.text, fontSize = 21 }, + summaryStyle = { color = theme.muted, fontSize = 12 } + })) + + runtime_ui.append_all(nodes, widgets.tabs("detail_tab", { + { id = "detail_tab_code", key = "code", text = i18n.t("tab_code"), handler = "detail_tab_code" }, + { id = "detail_tab_params", key = "params", text = i18n.t("tab_params"), handler = "detail_tab_params" } + }, { + x = m.detail_x + 20, + y = m.detail_y + 104, + itemWidth = 72, + itemHeight = 24, + gap = 6, + selected = state.detail_tab, + activeColor = theme.primary, + inactiveColor = "#ff334155", + radius = 8, + fontSize = 11, + interactive = true, + layer = 90 + })) + table.insert(nodes, widgets.text_button("detail_copy", { + text = detail_copy_text(), + x = m.detail_x + m.detail_w - 116, + y = m.detail_y + 104, + w = 96, + h = 24, + handler = "copy_detail", + color = "#ff475569", + radius = 8, + fontSize = 11, + interactive = true, + layer = 90 + })) + + table.insert(nodes, runtime_ui.list_view("code_panel", m.detail_x + 20, m.detail_y + 132, m.detail_w - 40, m.code_h + 18, { + color = "#ff020617", + radius = 12, + contentWidth = detail_content_width(m), + contentHeight = detail_content_height(selected, m), + scrollX = 0, + scrollY = 0, + paddingLeft = detail_padding_left, + paddingTop = detail_padding_top, + paddingRight = detail_padding_right, + paddingBottom = detail_padding_bottom, + virtualized = false, + inertia = true, + scrollbarThumbColor = theme.primary, + scrollbarTrackColor = "#33475569", + scrollbarThickness = 5, + layer = 20 + })) + table.insert(nodes, runtime_ui.text("detail_code", detail_body(selected), detail_text_x(selected, m), detail_text_y(selected, m), detail_text_width(selected, m), detail_text_height(selected), { + parent = "code_panel", + color = "#ffe2e8f0", + fontSize = 11, + textAlign = "left", + layer = 25 + })) + + runtime_ui.append_all(nodes, detail_action_nodes(selected, m)) + + table.insert(nodes, runtime_ui.panel("preview_panel", m.detail_x + 20, m.preview_y, m.detail_w - 40, m.preview_h, { + color = "#ff0b1120", + radius = 12, + layer = 20 + })) + table.insert(nodes, widgets.section_title("preview_title", { + text = i18n.t("preview_title"), + x = 14, + y = 10, + w = 220, + h = 22, + parent = "preview_panel", + color = theme.text, + fontSize = 15, + layer = 25 + })) + append_preview_nodes(nodes, selected) + + table.insert(nodes, runtime_ui.text("status_text", state.status, 24, m.status_y, theme.screen_width - 48, 26, { + color = theme.warning, + fontSize = 14, + layer = 50 + })) + + return nodes +end + +---@param text string +---@return RuntimeNodeUpdate[] +function ui.status_updates(text) + state.status = text + return { runtime_ui.text_update("status_text", text) } +end + +---@param selected ShowcaseExample +---@return RuntimeNodeUpdate[] +local function preview_visibility_updates(selected) + local updates = {} + local mode = preview_mode(selected) + local groups = { + { ids = base_preview_ids, visible = mode == "base" }, + { ids = text_preview_ids, visible = mode == "text" }, + { ids = button_preview_ids, visible = mode == "buttons" }, + { ids = button_image_preview_ids, visible = mode == "button_images" }, + { ids = sprite_preview_ids, visible = mode == "sprites" }, + { ids = layout_preview_ids, visible = mode == "layout" }, + { ids = radio_preview_ids, visible = mode == "radio" }, + { ids = list_preview_ids, visible = mode == "list" }, + { ids = particle_preview_ids, visible = mode == "particle" }, + { ids = responsive_preview_ids, visible = mode == "responsive" } + } + for _, group in ipairs(groups) do + for _, id in ipairs(group.ids) do + table.insert(updates, runtime_ui.visible_update(id, group.visible)) + end + end + return updates +end + +---@param selected ShowcaseExample +---@return RuntimeNodeUpdate[] +function ui.example_updates(selected) + local m = metrics() + local updates = { + runtime_ui.text_update("detail_category", i18n.example_group(selected) .. " / " .. i18n.example_field(selected, "category")), + runtime_ui.text_update("detail_title", i18n.example_field(selected, "title")), + runtime_ui.text_update("detail_summary", i18n.example_field(selected, "summary")), + runtime_ui.text_update("detail_code", detail_body(selected)), + runtime_ui.update("detail_code", { + x = detail_text_x(selected, m), + y = detail_text_y(selected, m), + width = detail_text_width(selected, m), + height = detail_text_height(selected), + textAlign = "left" + }), + runtime_ui.update("code_panel", { + contentWidth = detail_content_width(m), + contentHeight = detail_content_height(selected, m), + scrollX = 0, + scrollY = 0 + }), + runtime_ui.update("detail_tab_code", { + text = i18n.t("tab_code"), + onTap = "detail_tab_code", + interactive = true, + layer = 90, + color = state.detail_tab == "code" and theme.primary or "#ff334155" + }), + runtime_ui.update("detail_tab_params", { + text = i18n.t("tab_params"), + onTap = "detail_tab_params", + interactive = true, + layer = 90, + color = state.detail_tab == "params" and theme.primary or "#ff334155" + }), + runtime_ui.update("detail_copy", { + text = detail_copy_text(), + onTap = "copy_detail", + interactive = true, + layer = 90 + }), + runtime_ui.text_update("status_text", i18n.t("selected_prefix") .. i18n.example_field(selected, "title")) + } + + for _, example in ipairs(examples.all()) do + table.insert(updates, runtime_ui.update("example_" .. example.id, { + text = i18n.example_label(example), + color = example.id == selected.id and theme.primary or "#ff1e293b" + })) + end + + for index = 1, 3 do + local action = selected.actions[index] + if action ~= nil then + table.insert(updates, runtime_ui.update("detail_action_" .. index, { + text = i18n.action_text(action), + onTap = action.handler, + visible = true, + color = index == 1 and "#ff2563eb" or "#ff334155" + })) + else + table.insert(updates, runtime_ui.update("detail_action_" .. index, { + text = "", + onTap = "noop", + visible = false + })) + end + end + + local preview_updates = preview_visibility_updates(selected) + for _, update in ipairs(preview_updates) do + table.insert(updates, update) + end + table.insert(updates, runtime_ui.update("status_text", { width = m.screen_w - 48 })) + return updates +end + +---@return RuntimeNodeUpdate[] +function ui.locale_updates() + local selected = examples.find(state.selected_example) + local updates = { + runtime_ui.text_update("app_title", i18n.t("app_title")), + runtime_ui.text_update("app_subtitle", i18n.t("app_subtitle")), + runtime_ui.text_update("example_list_title", i18n.t("examples_title")), + runtime_ui.text_update("preview_title", i18n.t("preview_title")), + runtime_ui.text_update("responsive_info", responsive_text()) + } + local detail_updates = ui.example_updates(selected) + for _, update in ipairs(detail_updates) do + table.insert(updates, update) + end + return updates +end + +---@return RuntimeNodeUpdate[] +function ui.responsive_updates() + local width = responsive_device_width() + return { + runtime_ui.text_update("responsive_info", responsive_text()), + runtime_ui.update("responsive_device", { width = width }), + runtime_ui.update("responsive_sidebar", { width = width * 0.26 }), + runtime_ui.update("responsive_content", { + x = 192 + width * 0.26, + width = width * 0.56 + }) + } +end + +---@return RuntimeNodeUpdate[] +function ui.text_updates() + return { + runtime_ui.update("text_plain_title", { + text = state.text_variant == "plain" and "Text: 纯文本组件" or "Text: 样式已切换", + color = state.text_variant == "plain" and theme.text or theme.warning, + fontSize = state.text_variant == "plain" and 18 or 20 + }), + runtime_ui.update("text_style_badge", { + color = state.text_variant == "plain" and theme.primary or theme.purple + }) + } +end + +---@return RuntimeNodeUpdate[] +function ui.radio_updates() + local updates = { + runtime_ui.text_update("radio_value_text", "当前选择：" .. state.radio_selected) + } + local options = { "audio", "spine", "lua" } + for _, key in ipairs(options) do + local value = key == "lua" and "Lua" or key + local selected = state.radio_selected == value + table.insert(updates, runtime_ui.update("radio_" .. key .. "_dot", { + color = selected and theme.primary or "#ff475569" + })) + table.insert(updates, runtime_ui.update("radio_" .. key .. "_label", { + color = selected and theme.text or theme.muted + })) + end + return updates +end + +---@return RuntimeNodeUpdate[] +function ui.list_updates() + local horizontal = state.list_axis == "horizontal" + local updates = { + runtime_ui.update("list_panel", { + contentWidth = horizontal and 650 or 430, + contentHeight = horizontal and 90 or 150, + scrollX = state.list_scroll_x, + scrollY = state.list_scroll_y + }), + runtime_ui.text_update("list_value_text", state.list_axis .. " scrollX=" .. tostring(state.list_scroll_x) .. " scrollY=" .. tostring(state.list_scroll_y)) + } + local items = { "Lua", "Runtime", "Flame", "Diff", "Command" } + for index, key in ipairs(items) do + local row_x = horizontal and (8 + (index - 1) * 126) or 8 + local row_y = horizontal and 18 or (8 + (index - 1) * 28) + local row_w = horizontal and 116 or 292 + table.insert(updates, runtime_ui.update("list_row_" .. index, { + x = row_x, + y = row_y, + width = row_w, + color = state.list_selected == key and theme.primary or "#ff1e293b" + })) + table.insert(updates, runtime_ui.update("list_row_" .. index .. "_text", { + textAlign = "left" + })) + end + return updates +end + +---@return RuntimeNodeUpdate[] +function ui.button_updates() + return { + runtime_ui.update("button_primary", { + color = state.button_active and theme.primary or "#ff475569", + alpha = state.button_active and 1 or 0.65 + }), + runtime_ui.text_update("button_state_text", state.button_active and "状态：可点击" or "状态：已置灰") + } +end + +---@return RuntimeNodeUpdate[] +function ui.button_image_updates() + return { + runtime_ui.update("image_button_toggle", { + text = state.button_image_enabled and "可切换" or "已禁用", + interactive = state.button_image_enabled + }), + runtime_ui.text_update("image_button_state_text", state.button_image_enabled and "中间按钮：interactive=true" or "中间按钮：interactive=false，显示 disabledAsset") + } +end + +---@return RuntimeNodeUpdate[] +function ui.sprite_updates() + return { + runtime_ui.update("sprite_frame_demo", { + color = state.sprite_variant == "image" and theme.primary or theme.purple, + rotation = state.sprite_variant == "image" and 0 or 0.12 + }), + runtime_ui.text_update("sprite_label_demo", state.sprite_variant == "image" and "当前：image 原图节点" or "当前：sprite 可动画节点") + } +end + +---@param mode string +---@return RuntimeNodeUpdate[] +function ui.layout_updates(mode) + if mode == "column" then + return { + runtime_ui.update("layout_chip_1", { x = 44, y = 46 }), + runtime_ui.update("layout_chip_2", { x = 44, y = 74 }), + runtime_ui.update("layout_chip_3", { x = 44, y = 102 }), + runtime_ui.update("layout_chip_4", { x = 44, y = 130 }), + runtime_ui.text_update("layout_label", "layout.column：纵向排列 + gap") + } + end + if mode == "box" then + return { + runtime_ui.update("layout_chip_1", { x = 44, y = 54 }), + runtime_ui.update("layout_chip_2", { x = 116, y = 54 }), + runtime_ui.update("layout_chip_3", { x = 44, y = 90 }), + runtime_ui.update("layout_chip_4", { x = 116, y = 90 }), + runtime_ui.text_update("layout_label", "layout.box：2 行 × 2 列网格") + } + end + return { + runtime_ui.update("layout_chip_1", { x = 34, y = 70 }), + runtime_ui.update("layout_chip_2", { x = 108, y = 70 }), + runtime_ui.update("layout_chip_3", { x = 182, y = 70 }), + runtime_ui.update("layout_chip_4", { x = 256, y = 70 }), + runtime_ui.text_update("layout_label", "layout.row：横向排列 + gap") + } +end + +---@return RuntimeNodeUpdate[] +function ui.progress_updates() + return { + runtime_ui.update("sample_progress", { value = state.progress }), + runtime_ui.update("widget_progress", { value = state.progress }) + } +end + +---@return RuntimeNodeUpdate[] +function ui.visibility_updates() + return { + runtime_ui.visible_update("sample_rect", state.visible), + runtime_ui.alpha_update("sample_circle", state.visible and 1 or 0.35) + } +end + +---@return RuntimeNode[] +function ui.dialog_nodes() + return widgets.dialog("sample_dialog", "Widget Dialog", "这是 Lua 侧组合组件：overlay + card + text + button。输出仍然只是普通 RuntimeNode。", 150, 190, 420, 230, { + screenWidth = theme.screen_width, + screenHeight = theme.screen_height, + buttons = { + { text = "播放音效", handler = "demo_sound" }, + { text = "关闭", handler = "close_dialog", color = theme.danger } + } + }) +end + +---@return { id: string }[] +function ui.dialog_removes() + return { + { id = "sample_dialog_overlay" }, + { id = "sample_dialog" }, + { id = "sample_dialog_title" }, + { id = "sample_dialog_message" }, + { id = "sample_dialog_button_1" }, + { id = "sample_dialog_button_2" } + } +end + +---@return RuntimeNode[] +function ui.temp_nodes() + local m = metrics() + return { + runtime_ui.rect("temp_node", m.detail_x + 270, m.preview_y + 98, 90, 28, { + color = theme.warning, + radius = 8, + layer = 45 + }), + runtime_ui.text("temp_node_text", "临时节点", m.detail_x + 284, m.preview_y + 103, 72, 18, { + color = "#ff111827", + fontSize = 13, + layer = 46 + }) + } +end + +return ui diff --git a/example/assets/games/template/manifest.json b/example/assets/games/template/manifest.json new file mode 100644 index 0000000..bfbde94 --- /dev/null +++ b/example/assets/games/template/manifest.json @@ -0,0 +1,27 @@ +{ + "gameId": "template", + "name": "Lua Runtime Template", + "version": "0.1.0", + "runtimeApiVersion": 1, + "entry": "scripts/main.lua", + "assetsBase": "assets", + "defaultLocale": "zh-Hans", + "supportedLocales": [ + "zh-Hans", + "en" + ], + "display": { + "designWidth": 720, + "designHeight": 720, + "scaleMode": "fit" + }, + "modules": { + "runtime_ui": "runtime:runtime_ui.lua", + "runtime_commands": "runtime:runtime_commands.lua", + "runtime_widgets": "runtime:runtime_widgets.lua", + "layout": "runtime:layout.lua", + "state": "scripts/state.lua", + "ui": "scripts/ui.lua" + }, + "resources": {} +} diff --git a/example/assets/games/template/scripts/main.lua b/example/assets/games/template/scripts/main.lua new file mode 100644 index 0000000..d94e00a --- /dev/null +++ b/example/assets/games/template/scripts/main.lua @@ -0,0 +1,35 @@ +local state = runtime.import("state") +local ui = runtime.import("ui") +---@type RuntimeCommands +local commands = runtime.import("runtime_commands") + +function smoke_test(ctx) + return ctx ~= nil + and ctx.runtimeApiVersion ~= nil + and ui.create_nodes ~= nil + and commands.toast ~= nil +end + +function init(ctx) + state.status = "Template ready: " .. tostring(ctx.gameId or "template") + return { + render = { creates = ui.create_nodes() }, + ui = {}, + commands = {} + } +end + +function on_event(event) + if event.handler == "template_start" then + state.started = true + state.clicks = state.clicks + 1 + state.status = "收到 tap 事件，Lua 已返回 Diff 和 toast command。" + return { + ui = { updates = ui.state_updates() }, + commands = { + commands.toast("Template event handled in Lua", { duration = 1.2 }) + } + } + end + return {} +end diff --git a/example/assets/games/template/scripts/runtime_defs.lua b/example/assets/games/template/scripts/runtime_defs.lua new file mode 100644 index 0000000..c5038c9 --- /dev/null +++ b/example/assets/games/template/scripts/runtime_defs.lua @@ -0,0 +1,557 @@ +---@meta +--- COMMON RUNTIME TYPES SECTION. +--- Source of truth: tool/lua_runtime_defs_common.lua +--- After editing this common section, run: +--- dart run tool/generate_lua_runtime_defs.dart + + +---@alias RuntimeNodeType +---| 'panel' +---| 'button' +---| 'text' +---| 'circle' +---| 'rect' +---| 'line' +---| 'progress' +---| 'listView' +---| 'sprite' +---| 'image' +---| 'spine' +---| 'particle' + +---@alias RuntimeAnchor +---| 'center' +---| 'topLeft' +---| 'topRight' +---| 'bottomLeft' +---| 'bottomRight' + +---@alias RuntimeTextAlign +---| 'left' +---| 'center' +---| 'right' + +---@alias RuntimeParticlePreset +---| 'burst' +---| 'trail' +---| 'snow' +---| 'confetti' + +---@alias RuntimeCommandType +---| 'move_path' +---| 'move_to' +---| 'fade_to' +---| 'scale_to' +---| 'rotate_to' +---| 'remove_node' +---| 'sequence' +---| 'parallel' +---| 'delay' +---| 'toast' +---| 'play_sound' +---| 'play_bgm' +---| 'pause_bgm' +---| 'resume_bgm' +---| 'stop_bgm' +---| 'preload_resources' +---| 'evict_resources' +---| 'cancel_commands' +---| 'play_spine_animation' +---| 'copy_text' + +---@alias RuntimeEventType +---| 'tap' +---| 'animation_done' +---| 'resize' +---| 'scroll' + +---@alias RuntimeScaleMode +---| 'fit' +---| 'fill' +---| 'stretch' +---| 'none' + +---@alias RuntimeLayoutAlign +---| 'start' +---| 'center' +---| 'end' + +---@alias RuntimeButtonVariant +---| 'primary' +---| 'secondary' +---| 'ghost' + +---@class (exact) RuntimeNode +---@field id string +---@field type RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---@class (exact) RuntimeNodeProps +---@field type? RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---Helper-only fields accepted by runtime_ui/runtime_widgets. They are normalized +---before the node/update crosses the Dart Runtime protocol boundary. +---@class RuntimeNodeInit: RuntimeNodeProps +---@field w? number Alias for width. +---@field h? number Alias for height. +---@field size? number Alias for both width and height. +---@field handler? string Alias for onTap. +---@field onClick? string Alias for onTap. + +---@class (exact) RuntimeNodeUpdate +---@field id string +---@field props RuntimeNodeProps + +---@class (exact) RuntimeNodeRemove +---@field id string + +---@class (exact) RuntimeDiffSection +---@field creates? RuntimeNode[] +---@field updates? RuntimeNodeUpdate[] +---@field removes? (string|RuntimeNodeRemove)[] + +---@class (exact) RuntimeDiff +---@field render? RuntimeDiffSection +---@field ui? RuntimeDiffSection +---@field commands? RuntimeCommand[] + +---@class (exact) RuntimeEvent +---@field type RuntimeEventType|string +---@field target? string +---@field handler? string +---@field x? number +---@field y? number +---@field data? table + +---@class (exact) RuntimeCommand +---@field type RuntimeCommandType +---@field target? string +---@field scope? string +---@field id? string +---@field group? string +---@field commandGroup? string +---@field onComplete? string +---@field duration? number +---@field commands? RuntimeCommand[] +---@field path? RuntimePoint[] +---@field x? number +---@field y? number +---@field alpha? number +---@field scale? number +---@field angle? number +---@field text? string +---@field message? string +---@field asset? string +---@field name? string +---@field volume? number +---@field channel? string +---@field loop? boolean +---@field failOnError? boolean +---@field animation? string +---@field track? integer +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeCommandOpts +---@field id? string +---@field group? string +---@field commandGroup? string +---@field scope? string +---@field onComplete? string +---@field duration? number + +---@class (exact) RuntimeAudioCommandOpts: RuntimeCommandOpts +---@field volume? number +---@field name? string + +---@class (exact) RuntimeBgmCommandOpts: RuntimeAudioCommandOpts +---@field channel? string +---@field loop? boolean + +---@class (exact) RuntimeSpineCommandOpts: RuntimeCommandOpts +---@field track? integer +---@field loop? boolean +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeResourceCommandOpts: RuntimeCommandOpts +---@field failOnError? boolean + +---@class (exact) RuntimePoint +---@field x number +---@field y number + +---@class (exact) RuntimeLocaleContext +---@field requested string +---@field resolved string +---@field default string +---@field supported string[] +---@field languageCode string +---@field scriptCode? string +---@field countryCode? string + +---@class (exact) RuntimeScreenContext +---@field width number +---@field height number + +---@class (exact) RuntimeDesignContext +---@field width number +---@field height number + +---@class (exact) RuntimeViewportContext +---@field x number +---@field y number +---@field width number +---@field height number +---@field scaleX number +---@field scaleY number +---@field scaleMode RuntimeScaleMode|string + +---@class (exact) RuntimeContext +---@field screen RuntimeScreenContext +---@field design RuntimeDesignContext +---@field viewport RuntimeViewportContext +---@field seed integer +---@field runtimeApiVersion integer +---@field gameId string +---@field gameVersion string +---@field locale? RuntimeLocaleContext + +---@class RuntimeUi +---@field style fun(base?: RuntimeNodeProps, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field with_parent fun(parent: string, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field node fun(node_type: RuntimeNodeType, id: string, opts?: RuntimeNodeInit): RuntimeNode +---@field panel fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field rect fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field circle fun(id: string, x: number|RuntimeNodeInit, y?: number, size?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field line fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field particle fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field text fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field button fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field list_view fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field image fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field sprite fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field spine fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, animation?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field update fun(id: string, props: RuntimeNodeInit): RuntimeNodeUpdate +---@field text_update fun(id: string, text: string): RuntimeNodeUpdate +---@field visible_update fun(id: string, visible: boolean): RuntimeNodeUpdate +---@field alpha_update fun(id: string, alpha: number): RuntimeNodeUpdate +---@field scale_update fun(id: string, scale: number): RuntimeNodeUpdate +---@field position_update fun(id: string, x: number, y: number): RuntimeNodeUpdate +---@field size_update fun(id: string, width: number, height: number): RuntimeNodeUpdate +---@field transform_update fun(id: string, x: number, y: number, scale: number, rotation: number): RuntimeNodeUpdate +---@field batch_update fun(ids: string[], props: RuntimeNodeInit): RuntimeNodeUpdate[] +---@field append fun(nodes: RuntimeNode[], node: RuntimeNode): RuntimeNode[] +---@field append_all fun(nodes: RuntimeNode[], extra_nodes: RuntimeNode[]): RuntimeNode[] + +---@class (exact) RuntimeDialogButton +---@field id? string +---@field text string +---@field handler string +---@field color? string + +---@class (exact) RuntimeDialogOpts +---@field screenWidth? number +---@field screenHeight? number +---@field overlay? boolean +---@field overlayColor? string +---@field blockInput? boolean +---@field layer? integer +---@field color? string +---@field radius? number +---@field panelStyle? RuntimeNodeProps +---@field titleColor? string +---@field titleSize? number +---@field titleStyle? RuntimeNodeProps +---@field messageColor? string +---@field messageSize? number +---@field messageStyle? RuntimeNodeProps +---@field buttons? RuntimeDialogButton[] +---@field buttonGap? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeLabeledProgressOpts: RuntimeNodeInit +---@field labelHeight? number +---@field labelStyle? RuntimeNodeProps + +---@class RuntimePillOpts: RuntimeNodeInit +---@field panelStyle? RuntimeNodeProps +---@field textStyle? RuntimeNodeProps + +---@class RuntimeTextButtonOpts: RuntimeNodeInit +---@field variant? RuntimeButtonVariant + +---@class RuntimeListItemOpts: RuntimeTextButtonOpts +---@field selected? boolean +---@field activeColor? string +---@field inactiveColor? string + +---@class RuntimeTabItem +---@field id? string +---@field key? string +---@field text string +---@field handler? string +---@field selected? boolean + +---@class RuntimeTabsOpts: RuntimeNodeInit +---@field tabs? RuntimeTabItem[] +---@field selected? string +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field activeColor? string +---@field inactiveColor? string +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeActionItem +---@field id? string +---@field text string +---@field handler? string +---@field visible? boolean +---@field color? string +---@field style? RuntimeNodeProps + +---@class RuntimeActionRowOpts: RuntimeNodeInit +---@field actions? RuntimeActionItem[] +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimePanelHeaderOpts: RuntimeNodeInit +---@field eyebrow? string +---@field title string +---@field summary? string +---@field gap? number +---@field eyebrowId? string +---@field titleId? string +---@field summaryId? string +---@field eyebrowHeight? number +---@field titleHeight? number +---@field summaryHeight? number +---@field eyebrowStyle? RuntimeNodeProps +---@field titleStyle? RuntimeNodeProps +---@field summaryStyle? RuntimeNodeProps + +---@class RuntimeWidgetTheme +---@field primary? string +---@field secondary? string +---@field success? string +---@field overlay? string +---@field surface? string +---@field surfaceAlt? string +---@field card? string +---@field text? string +---@field muted? string +---@field progress? string +---@field transparent? string + +---@class RuntimeWidgets +---@field configure fun(tokens?: RuntimeWidgetTheme): RuntimeWidgets +---@field label fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field section_title fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field pill fun(id: string, text: string|RuntimePillOpts, x?: number, y?: number, width?: number, height?: number, opts?: RuntimePillOpts): RuntimeNode[] +---@field text_button fun(id: string, text: string|RuntimeTextButtonOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeTextButtonOpts): RuntimeNode +---@field list_item fun(id: string, text: string|RuntimeListItemOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeListItemOpts): RuntimeNode +---@field tabs fun(id: string, tabs: RuntimeTabItem[]|RuntimeTabsOpts, opts?: RuntimeTabsOpts): RuntimeNode[] +---@field action_row fun(id: string, actions: RuntimeActionItem[]|RuntimeActionRowOpts, opts?: RuntimeActionRowOpts): RuntimeNode[] +---@field panel_header fun(id: string, opts: RuntimePanelHeaderOpts): RuntimeNode[] +---@field overlay fun(id: string, width: number|RuntimeNodeInit, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field card fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress_bar fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field labeled_progress fun(id: string, label: string, x: number, y: number, width: number, height: number, value: number, opts?: RuntimeLabeledProgressOpts): RuntimeNode[] +---@field button_row fun(parent: string, id: string, buttons: RuntimeDialogButton[], x: number, y: number, width: number, height: number, gap?: number, opts?: RuntimeNodeProps): RuntimeNode[] +---@field dialog fun(id: string, title: string, message: string, x: number, y: number, width: number, height: number, opts?: RuntimeDialogOpts): RuntimeNode[] + +---@class (exact) RuntimeLayoutItem +---@field node RuntimeNode +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLayoutItemOpts +---@field margin? number +---@field mx? number +---@field my? number +---@field ml? number +---@field mr? number +---@field mt? number +---@field mb? number +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLinearLayoutOpts +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field gap? number +---@field align? RuntimeLayoutAlign +---@field padding? number +---@field paddingX? number +---@field paddingY? number +---@field px? number +---@field py? number +---@field paddingLeft? number +---@field paddingTop? number + +---@class RuntimeBoxLayoutOpts: RuntimeLinearLayoutOpts +---@field rows? integer +---@field columns? integer +---@field cols? integer +---@field cellWidth? number +---@field cellHeight? number +---@field cellW? number +---@field cellH? number +---@field gapX? number +---@field gapY? number +---@field valign? RuntimeLayoutAlign + +---@class RuntimeLayout +---@field item fun(node: RuntimeNode, opts?: RuntimeLayoutItemOpts): RuntimeLayoutItem +---@field local_position fun(origin: RuntimePoint, position: RuntimePoint): RuntimePoint +---@field row fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field column fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field stack fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field box fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeBoxLayoutOpts): RuntimeNode[] + +---@class RuntimeCommands +---@field toast fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field copy_text fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field delay fun(duration: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field sequence fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field parallel fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_path fun(target: string, path: RuntimePoint[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_to fun(target: string, x: number, y: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field fade_to fun(target: string, alpha: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field scale_to fun(target: string, scale: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field rotate_to fun(target: string, angle: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field remove_node fun(target: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field play_spine_animation fun(target: string, animation: string, opts?: RuntimeSpineCommandOpts): RuntimeCommand +---@field play_sound fun(asset: string, opts?: RuntimeAudioCommandOpts): RuntimeCommand +---@field play_bgm fun(asset: string, opts?: RuntimeBgmCommandOpts): RuntimeCommand +---@field pause_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field resume_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field stop_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field preload_group fun(group: string, opts?: RuntimeResourceCommandOpts): RuntimeCommand +---@field evict_group fun(group: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field cancel_id fun(id: string): RuntimeCommand +---@field cancel_group fun(group: string): RuntimeCommand +---@field cancel_scope fun(scope: string): RuntimeCommand + +---@class RuntimeImportApi +---@field import fun(moduleName: string): table + +---@type RuntimeImportApi +runtime = runtime diff --git a/example/assets/games/template/scripts/state.lua b/example/assets/games/template/scripts/state.lua new file mode 100644 index 0000000..e1f8498 --- /dev/null +++ b/example/assets/games/template/scripts/state.lua @@ -0,0 +1,8 @@ +---@class TemplateState +local state = { + started = false, + clicks = 0, + status = "点击 Start 验证 RuntimeEvent -> Lua -> Diff / Command" +} + +return state diff --git a/example/assets/games/template/scripts/ui.lua b/example/assets/games/template/scripts/ui.lua new file mode 100644 index 0000000..ca0751a --- /dev/null +++ b/example/assets/games/template/scripts/ui.lua @@ -0,0 +1,100 @@ +---@type RuntimeUi +local runtime_ui = runtime.import("runtime_ui") +---@type RuntimeWidgets +local widgets = runtime.import("runtime_widgets") +local state = runtime.import("state") + +widgets.configure({ + primary = "#ff2563eb", + secondary = "#ff475569", + success = "#ff22c55e", + overlay = "#99000000", + surface = "#ff1e293b", + surfaceAlt = "#ff334155", + card = "#ee111827", + text = "#ffe2e8f0", + muted = "#ff94a3b8", + progress = "#ff22c55e", + transparent = "#00000000" +}) + +---@class TemplateUi +local ui = {} + +---@return RuntimeNode[] +function ui.create_nodes() + return { + runtime_ui.rect("template_bg", { + x = 0, + y = 0, + w = 720, + h = 720, + color = "#ff0f172a" + }), + runtime_ui.panel("template_card", { + x = 72, + y = 96, + w = 576, + h = 360, + color = "#ee111827", + radius = 18, + layer = 5 + }), + widgets.section_title("template_title", { + text = "Lua Runtime Template", + x = 104, + y = 132, + w = 420, + h = 34, + color = "#ffe2e8f0", + fontSize = 24, + layer = 10 + }), + widgets.label("template_desc", { + text = "最小接入示例：一个 manifest、一个 main.lua、一组 RuntimeNode。", + x = 104, + y = 178, + w = 500, + h = 24, + color = "#ff94a3b8", + fontSize = 14, + layer = 10 + }), + runtime_ui.button("template_start", { + text = state.started and "Started" or "Start", + x = 104, + y = 236, + w = 144, + h = 44, + handler = "template_start", + color = state.started and "#ff16a34a" or "#ff2563eb", + radius = 12, + fontSize = 15, + layer = 10 + }), + runtime_ui.text("template_counter", "Clicks: " .. tostring(state.clicks), 272, 246, 180, 24, { + color = "#ffe2e8f0", + fontSize = 15, + layer = 10 + }), + runtime_ui.text("template_status", state.status, 104, 320, 500, 24, { + color = "#fffacc15", + fontSize = 13, + layer = 10 + }) + } +end + +---@return RuntimeNodeUpdate[] +function ui.state_updates() + return { + runtime_ui.update("template_start", { + text = state.started and "Started" or "Start", + color = state.started and "#ff16a34a" or "#ff2563eb" + }), + runtime_ui.text_update("template_counter", "Clicks: " .. tostring(state.clicks)), + runtime_ui.text_update("template_status", state.status) + } +end + +return ui diff --git a/example/ios/.gitignore b/example/ios/.gitignore new file mode 100644 index 0000000..7a7f987 --- /dev/null +++ b/example/ios/.gitignore @@ -0,0 +1,34 @@ +**/dgph +*.mode1v3 +*.mode2v3 +*.moved-aside +*.pbxuser +*.perspectivev3 +**/*sync/ +.sconsign.dblite +.tags* +**/.vagrant/ +**/DerivedData/ +Icon? +**/Pods/ +**/.symlinks/ +profile +xcuserdata +**/.generated/ +Flutter/App.framework +Flutter/Flutter.framework +Flutter/Flutter.podspec +Flutter/Generated.xcconfig +Flutter/ephemeral/ +Flutter/app.flx +Flutter/app.zip +Flutter/flutter_assets/ +Flutter/flutter_export_environment.sh +ServiceDefinitions.json +Runner/GeneratedPluginRegistrant.* + +# Exceptions to above rules. +!default.mode1v3 +!default.mode2v3 +!default.pbxuser +!default.perspectivev3 diff --git a/example/ios/Flutter/AppFrameworkInfo.plist b/example/ios/Flutter/AppFrameworkInfo.plist new file mode 100644 index 0000000..1dc6cf7 --- /dev/null +++ b/example/ios/Flutter/AppFrameworkInfo.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + en + CFBundleExecutable + App + CFBundleIdentifier + io.flutter.flutter.app + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + App + CFBundlePackageType + FMWK + CFBundleShortVersionString + 1.0 + CFBundleSignature + ???? + CFBundleVersion + 1.0 + MinimumOSVersion + 13.0 + + diff --git a/example/ios/Flutter/Debug.xcconfig b/example/ios/Flutter/Debug.xcconfig new file mode 100644 index 0000000..592ceee --- /dev/null +++ b/example/ios/Flutter/Debug.xcconfig @@ -0,0 +1 @@ +#include "Generated.xcconfig" diff --git a/example/ios/Flutter/Release.xcconfig b/example/ios/Flutter/Release.xcconfig new file mode 100644 index 0000000..592ceee --- /dev/null +++ b/example/ios/Flutter/Release.xcconfig @@ -0,0 +1 @@ +#include "Generated.xcconfig" diff --git a/example/ios/Runner.xcodeproj/project.pbxproj b/example/ios/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..e241ed9 --- /dev/null +++ b/example/ios/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,616 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXBuildFile section */ + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */ = {isa = PBXBuildFile; fileRef = 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */; }; + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C807B294A618700263BE5 /* RunnerTests.swift */; }; + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; }; + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; }; + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FA1CF9000F007C117D /* Main.storyboard */; }; + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FD1CF9000F007C117D /* Assets.xcassets */; }; + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C8085294A63A400263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 97C146E61CF9000F007C117D /* Project object */; + proxyType = 1; + remoteGlobalIDString = 97C146ED1CF9000F007C117D; + remoteInfo = Runner; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 9705A1C41CF9048500538489 /* Embed Frameworks */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Embed Frameworks"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = GeneratedPluginRegistrant.h; sourceTree = ""; }; + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = GeneratedPluginRegistrant.m; sourceTree = ""; }; + 331C807B294A618700263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 331C8081294A63A400263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; name = AppFrameworkInfo.plist; path = Flutter/AppFrameworkInfo.plist; sourceTree = ""; }; + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = ""; }; + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Debug.xcconfig; path = Flutter/Debug.xcconfig; sourceTree = ""; }; + 9740EEB31CF90195004384FC /* Generated.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; name = Generated.xcconfig; path = Flutter/Generated.xcconfig; sourceTree = ""; }; + 97C146EE1CF9000F007C117D /* Runner.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Runner.app; sourceTree = BUILT_PRODUCTS_DIR; }; + 97C146FB1CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = ""; }; + 97C146FD1CF9000F007C117D /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; + 97C147001CF9000F007C117D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; + 97C147021CF9000F007C117D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 97C146EB1CF9000F007C117D /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 331C8082294A63A400263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C807B294A618700263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 9740EEB11CF90186004384FC /* Flutter */ = { + isa = PBXGroup; + children = ( + 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 9740EEB31CF90195004384FC /* Generated.xcconfig */, + ); + name = Flutter; + sourceTree = ""; + }; + 97C146E51CF9000F007C117D = { + isa = PBXGroup; + children = ( + 9740EEB11CF90186004384FC /* Flutter */, + 97C146F01CF9000F007C117D /* Runner */, + 97C146EF1CF9000F007C117D /* Products */, + 331C8082294A63A400263BE5 /* RunnerTests */, + ); + sourceTree = ""; + }; + 97C146EF1CF9000F007C117D /* Products */ = { + isa = PBXGroup; + children = ( + 97C146EE1CF9000F007C117D /* Runner.app */, + 331C8081294A63A400263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 97C146F01CF9000F007C117D /* Runner */ = { + isa = PBXGroup; + children = ( + 97C146FA1CF9000F007C117D /* Main.storyboard */, + 97C146FD1CF9000F007C117D /* Assets.xcassets */, + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */, + 97C147021CF9000F007C117D /* Info.plist */, + 1498D2321E8E86230040F4C2 /* GeneratedPluginRegistrant.h */, + 1498D2331E8E89220040F4C2 /* GeneratedPluginRegistrant.m */, + 74858FAE1ED2DC5600515810 /* AppDelegate.swift */, + 74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */, + ); + path = Runner; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C8080294A63A400263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C807D294A63A400263BE5 /* Sources */, + 331C807F294A63A400263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C8086294A63A400263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C8081294A63A400263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 97C146ED1CF9000F007C117D /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 9740EEB61CF901F6004384FC /* Run Script */, + 97C146EA1CF9000F007C117D /* Sources */, + 97C146EB1CF9000F007C117D /* Frameworks */, + 97C146EC1CF9000F007C117D /* Resources */, + 9705A1C41CF9048500538489 /* Embed Frameworks */, + 3B06AD1E1E4923F5004D2608 /* Thin Binary */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Runner; + productName = Runner; + productReference = 97C146EE1CF9000F007C117D /* Runner.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 97C146E61CF9000F007C117D /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = YES; + LastUpgradeCheck = 1510; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C8080294A63A400263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 97C146ED1CF9000F007C117D; + }; + 97C146ED1CF9000F007C117D = { + CreatedOnToolsVersion = 7.3.1; + LastSwiftMigration = 1100; + }; + }; + }; + buildConfigurationList = 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 97C146E51CF9000F007C117D; + productRefGroup = 97C146EF1CF9000F007C117D /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 97C146ED1CF9000F007C117D /* Runner */, + 331C8080294A63A400263BE5 /* RunnerTests */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C807F294A63A400263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EC1CF9000F007C117D /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 97C147011CF9000F007C117D /* LaunchScreen.storyboard in Resources */, + 3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */, + 97C146FE1CF9000F007C117D /* Assets.xcassets in Resources */, + 97C146FC1CF9000F007C117D /* Main.storyboard in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3B06AD1E1E4923F5004D2608 /* Thin Binary */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + "${TARGET_BUILD_DIR}/${INFOPLIST_PATH}", + ); + name = "Thin Binary"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" embed_and_thin"; + }; + 9740EEB61CF901F6004384FC /* Run Script */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputPaths = ( + ); + name = "Run Script"; + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C807D294A63A400263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C808B294A63AB00263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 97C146EA1CF9000F007C117D /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */, + 1498D2341E8E89220040F4C2 /* GeneratedPluginRegistrant.m in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C8086294A63A400263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 97C146ED1CF9000F007C117D /* Runner */; + targetProxy = 331C8085294A63A400263BE5 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 97C146FA1CF9000F007C117D /* Main.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C146FB1CF9000F007C117D /* Base */, + ); + name = Main.storyboard; + sourceTree = ""; + }; + 97C146FF1CF9000F007C117D /* LaunchScreen.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 97C147001CF9000F007C117D /* Base */, + ); + name = LaunchScreen.storyboard; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 249021D3217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Profile; + }; + 249021D4217E4FDB00AE95B9 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Profile; + }; + 331C8088294A63A400263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Debug; + }; + 331C8089294A63A400263BE5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Release; + }; + 331C808A294A63A400263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Runner.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/Runner"; + }; + name = Profile; + }; + 97C147031CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = iphoneos; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Debug; + }; + 97C147041CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu99; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = iphoneos; + SUPPORTED_PLATFORMS = iphoneos; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + }; + name = Release; + }; + 97C147061CF9000F007C117D /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Debug; + }; + 97C147071CF9000F007C117D /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)"; + ENABLE_BITCODE = NO; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h"; + SWIFT_VERSION = 5.0; + VERSIONING_SYSTEM = "apple-generic"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C8087294A63A400263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C8088294A63A400263BE5 /* Debug */, + 331C8089294A63A400263BE5 /* Release */, + 331C808A294A63A400263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C146E91CF9000F007C117D /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147031CF9000F007C117D /* Debug */, + 97C147041CF9000F007C117D /* Release */, + 249021D3217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 97C147051CF9000F007C117D /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 97C147061CF9000F007C117D /* Debug */, + 97C147071CF9000F007C117D /* Release */, + 249021D4217E4FDB00AE95B9 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 97C146E61CF9000F007C117D /* Project object */; +} diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..919434a --- /dev/null +++ b/example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..f9b0d7c --- /dev/null +++ b/example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..e3773d4 --- /dev/null +++ b/example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,101 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/example/ios/Runner.xcworkspace/contents.xcworkspacedata b/example/ios/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..1d526a1 --- /dev/null +++ b/example/ios/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings b/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings new file mode 100644 index 0000000..f9b0d7c --- /dev/null +++ b/example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings @@ -0,0 +1,8 @@ + + + + + PreviewsEnabled + + + diff --git a/example/ios/Runner/AppDelegate.swift b/example/ios/Runner/AppDelegate.swift new file mode 100644 index 0000000..6266644 --- /dev/null +++ b/example/ios/Runner/AppDelegate.swift @@ -0,0 +1,13 @@ +import Flutter +import UIKit + +@main +@objc class AppDelegate: FlutterAppDelegate { + override func application( + _ application: UIApplication, + didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? + ) -> Bool { + GeneratedPluginRegistrant.register(with: self) + return super.application(application, didFinishLaunchingWithOptions: launchOptions) + } +} diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..d36b1fa --- /dev/null +++ b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,122 @@ +{ + "images" : [ + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "20x20", + "idiom" : "iphone", + "filename" : "Icon-App-20x20@3x.png", + "scale" : "3x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "iphone", + "filename" : "Icon-App-29x29@3x.png", + "scale" : "3x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "iphone", + "filename" : "Icon-App-40x40@3x.png", + "scale" : "3x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@2x.png", + "scale" : "2x" + }, + { + "size" : "60x60", + "idiom" : "iphone", + "filename" : "Icon-App-60x60@3x.png", + "scale" : "3x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@1x.png", + "scale" : "1x" + }, + { + "size" : "20x20", + "idiom" : "ipad", + "filename" : "Icon-App-20x20@2x.png", + "scale" : "2x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@1x.png", + "scale" : "1x" + }, + { + "size" : "29x29", + "idiom" : "ipad", + "filename" : "Icon-App-29x29@2x.png", + "scale" : "2x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@1x.png", + "scale" : "1x" + }, + { + "size" : "40x40", + "idiom" : "ipad", + "filename" : "Icon-App-40x40@2x.png", + "scale" : "2x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@1x.png", + "scale" : "1x" + }, + { + "size" : "76x76", + "idiom" : "ipad", + "filename" : "Icon-App-76x76@2x.png", + "scale" : "2x" + }, + { + "size" : "83.5x83.5", + "idiom" : "ipad", + "filename" : "Icon-App-83.5x83.5@2x.png", + "scale" : "2x" + }, + { + "size" : "1024x1024", + "idiom" : "ios-marketing", + "filename" : "Icon-App-1024x1024@1x.png", + "scale" : "1x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..dc9ada4725e9b0ddb1deab583e5b5102493aa332 GIT binary patch literal 10932 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 literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..797d452e458972bab9d994556c8305db4c827017 GIT binary patch literal 406 zcmV;H0crk;P))>cdjpWt&rLJgVp-t?DREyuq1A%0Z4)6_WsQ7{nzjN zo!X zGXV)2i3kcZIL~_j>uIKPK_zib+3T+Nt3Mb&Br)s)UIaA}@p{wDda>7=Q|mGRp7pqY zkJ!7E{MNz$9nOwoVqpFb)}$IP24Wn2JJ=Cw(!`OXJBr45rP>>AQr$6c7slJWvbpNW z@KTwna6d?PP>hvXCcp=4F;=GR@R4E7{4VU^0p4F>v^#A|>07*qoM6N<$f*5nx ACIA2c literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..6ed2d933e1120817fe9182483a228007b18ab6ae GIT binary patch literal 450 zcmV;z0X_bSP)iGWQ_5NJQ_~rNh*z)}eT%KUb z`7gNk0#AwF^#0T0?hIa^`~Ck;!}#m+_uT050aTR(J!bU#|IzRL%^UsMS#KsYnTF*!YeDOytlP4VhV?b} z%rz_<=#CPc)tU1MZTq~*2=8~iZ!lSa<{9b@2Jl;?IEV8)=fG217*|@)CCYgFze-x? zIFODUIA>nWKpE+bn~n7;-89sa>#DR>TSlqWk*!2hSN6D~Qb#VqbP~4Fk&m`@1$JGr zXPIdeRE&b2Thd#{MtDK$px*d3-Wx``>!oimf%|A-&-q*6KAH)e$3|6JV%HX{Hig)k suLT-RhftRq8b9;(V=235Wa|I=027H2wCDra;{X5v07*qoM6N<$f;9x^2LJ#7 literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..4cd7b0099ca80c806f8fe495613e8d6c69460d76 GIT binary patch literal 282 zcmV+#0p(^bcu7P-R4C8Q z&e;xxFbF_Vrezo%_kH*OKhshZ6BFpG-Y1e10`QXJKbND7AMQ&cMj60B5TNObaZxYybcN07*qoM6N<$g3m;S%K!iX literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..fe730945a01f64a61e2235dbe3f45b08f7729182 GIT binary patch literal 462 zcmV;<0WtoGP)-}iV`2<;=$?g5M=KQbZ{F&YRNy7Nn@%_*5{gvDM0aKI4?ESmw z{NnZg)A0R`+4?NF_RZexyVB&^^ZvN!{I28tr{Vje;QNTz`dG&Jz0~Ek&f2;*Z7>B|cg}xYpxEFY+0YrKLF;^Q+-HreN0P{&i zK~zY`?b7ECf-n?@;d<&orQ*Q7KoR%4|C>{W^h6@&01>0SKS`dn{Q}GT%Qj_{PLZ_& zs`MFI#j-(>?bvdZ!8^xTwlY{qA)T4QLbY@j(!YJ7aXJervHy6HaG_2SB`6CC{He}f zHVw(fJWApwPq!6VY7r1w-Fs)@ox~N+q|w~e;JI~C4Vf^@d>Wvj=fl`^u9x9wd9 zR%3*Q+)t%S!MU_`id^@&Y{y7-r98lZX0?YrHlfmwb?#}^1b{8g&KzmkE(L>Z&)179 zp<)v6Y}pRl100G2FL_t(o!|l{-Q-VMg#&MKg7c{O0 z2wJImOS3Gy*Z2Qifdv~JYOp;v+U)a|nLoc7hNH;I$;lzDt$}rkaFw1mYK5_0Q(Sut zvbEloxON7$+HSOgC9Z8ltuC&0OSF!-mXv5caV>#bc3@hBPX@I$58-z}(ZZE!t-aOG zpjNkbau@>yEzH(5Yj4kZiMH32XI!4~gVXNnjAvRx;Sdg^`>2DpUEwoMhTs_st8pKG z(%SHyHdU&v%f36~uERh!bd`!T2dw;z6PrOTQ7Vt*#9F2uHlUVnb#ev_o^fh}Dzmq} zWtlk35}k=?xj28uO|5>>$yXadTUE@@IPpgH`gJ~Ro4>jd1IF|(+IX>8M4Ps{PNvmI zNj4D+XgN83gPt_Gm}`Ybv{;+&yu-C(Grdiahmo~BjG-l&mWM+{e5M1sm&=xduwgM9 z`8OEh`=F3r`^E{n_;%9weN{cf2%7=VzC@cYj+lg>+3|D|_1C@{hcU(DyQG_BvBWe? zvTv``=%b1zrol#=R`JB)>cdjpWt&rLJgVp-t?DREyuq1A%0Z4)6_WsQ7{nzjN zo!X zGXV)2i3kcZIL~_j>uIKPK_zib+3T+Nt3Mb&Br)s)UIaA}@p{wDda>7=Q|mGRp7pqY zkJ!7E{MNz$9nOwoVqpFb)}$IP24Wn2JJ=Cw(!`OXJBr45rP>>AQr$6c7slJWvbpNW z@KTwna6d?PP>hvXCcp=4F;=GR@R4E7{4VU^0p4F>v^#A|>07*qoM6N<$f*5nx ACIA2c literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..502f463a9bc882b461c96aadf492d1729e49e725 GIT binary patch literal 586 zcmV-Q0=4~#P)+}#`wDE{8-2Mebf5<{{PqV{TgVcv*r8?UZ3{-|G?_}T*&y;@cqf{ z{Q*~+qr%%p!1pS*_Uicl#q9lc(D`!D`LN62sNwq{oYw(Wmhk)k<@f$!$@ng~_5)Ru z0Z)trIA5^j{DIW^c+vT2%lW+2<(RtE2wR;4O@)Tm`Xr*?A(qYoM}7i5Yxw>D(&6ou zxz!_Xr~yNF+waPe00049Nkl*;a!v6h%{rlvIH#gW3s8p;bFr=l}mRqpW2h zw=OA%hdyL~z+UHOzl0eKhEr$YYOL-c-%Y<)=j?(bzDweB7{b+%_ypvm_cG{SvM=DK zhv{K@m>#Bw>2W$eUI#iU)Wdgs8Y3U+A$Gd&{+j)d)BmGKx+43U_!tik_YlN)>$7G! zhkE!s;%oku3;IwG3U^2kw?z+HM)jB{@zFhK8P#KMSytSthr+4!c(5c%+^UBn`0X*2 zy3(k600_CSZj?O$Qu%&$;|TGUJrptR(HzyIx>5E(2r{eA(<6t3e3I0B)7d6s7?Z5J zZ!rtKvA{MiEBm&KFtoifx>5P^Z=vl)95XJn()aS5%ad(s?4-=Tkis9IGu{`Fy8r+H07*qoM6N<$f20Z)wqMt%V?S?~D#06};F zA3KcL`Wb+>5ObvgQIG&ig8(;V04hz?@cqy3{mSh8o!|U|)cI!1_+!fWH@o*8vh^CU z^ws0;(c$gI+2~q^tO#GDHf@=;DncUw00J^eL_t(&-tE|HQ`%4vfZ;WsBqu-$0nu1R zq^Vj;p$clf^?twn|KHO+IGt^q#a3X?w9dXC@*yxhv&l}F322(8Y1&=P&I}~G@#h6; z1CV9ecD9ZEe87{{NtI*)_aJ<`kJa z?5=RBtFF50s;jQLFil-`)m2wrb=6h(&brpj%nG_U&ut~$?8Rokzxi8zJoWr#2dto5 zOX_URcc<1`Iky+jc;A%Vzx}1QU{2$|cKPom2Vf1{8m`vja4{F>HS?^Nc^rp}xo+Nh zxd}eOm`fm3@MQC1< zIk&aCjb~Yh%5+Yq0`)D;q{#-Uqlv*o+Oor zE!I71Z@ASH3grl8&P^L0WpavHoP|UX4e?!igT`4?AZk$hu*@%6WJ;zDOGlw7kj@ zY5!B-0ft0f?Lgb>C;$Ke07*qoM6N<$f~t1N9smFU literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..0ec303439225b78712f49115768196d8d76f6790 GIT binary patch literal 862 zcmV-k1EKthP)20Z)wqMt%V?S?~D#06};F zA3KcL`Wb+>5ObvgQIG&ig8(;V04hz?@cqy3{mSh8o!|U|)cI!1_+!fWH@o*8vh^CU z^ws0;(c$gI+2~q^tO#GDHf@=;DncUw00J^eL_t(&-tE|HQ`%4vfZ;WsBqu-$0nu1R zq^Vj;p$clf^?twn|KHO+IGt^q#a3X?w9dXC@*yxhv&l}F322(8Y1&=P&I}~G@#h6; z1CV9ecD9ZEe87{{NtI*)_aJ<`kJa z?5=RBtFF50s;jQLFil-`)m2wrb=6h(&brpj%nG_U&ut~$?8Rokzxi8zJoWr#2dto5 zOX_URcc<1`Iky+jc;A%Vzx}1QU{2$|cKPom2Vf1{8m`vja4{F>HS?^Nc^rp}xo+Nh zxd}eOm`fm3@MQC1< zIk&aCjb~Yh%5+Yq0`)D;q{#-Uqlv*o+Oor zE!I71Z@ASH3grl8&P^L0WpavHoP|UX4e?!igT`4?AZk$hu*@%6WJ;zDOGlw7kj@ zY5!B-0ft0f?Lgb>C;$Ke07*qoM6N<$f~t1N9smFU literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..e9f5fea27c705180eb716271f41b582e76dcbd90 GIT binary patch literal 1674 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 literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png b/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..0467bf12aa4d28f374bb26596605a46dcbb3e7c8 GIT binary patch literal 1418 zcmV;51$Fv~P)q zKfU)WzW*n(@|xWGCA9ScMt*e9`2kdxPQ&&>|-UCa7_51w+ zLUsW@ZzZSW0y$)Hp~e9%PvP|a03ks1`~K?q{u;6NC8*{AOqIUq{CL&;p56Lf$oQGq z^={4hPQv)y=I|4n+?>7Fim=dxt1 z2H+Dm+1+fh+IF>G0SjJMkQQre1x4|G*Z==(Ot&kCnUrL4I(rf(ucITwmuHf^hXiJT zkdTm&kdTm&kdTm&kdP`esgWG0BcWCVkVZ&2dUwN`cgM8QJb`Z7Z~e<&Yj2(}>Tmf` zm1{eLgw!b{bXkjWbF%dTkTZEJWyWOb##Lfw4EK2}<0d6%>AGS{po>WCOy&f$Tay_> z?NBlkpo@s-O;0V%Y_Xa-G#_O08q5LR*~F%&)}{}r&L%Sbs8AS4t7Y0NEx*{soY=0MZExqA5XHQkqi#4gW3 zqODM^iyZl;dvf)-bOXtOru(s)Uc7~BFx{w-FK;2{`VA?(g&@3z&bfLFyctOH!cVsF z7IL=fo-qBndRUm;kAdXR4e6>k-z|21AaN%ubeVrHl*<|s&Ax@W-t?LR(P-24A5=>a z*R9#QvjzF8n%@1Nw@?CG@6(%>+-0ASK~jEmCV|&a*7-GKT72W<(TbSjf)&Eme6nGE z>Gkj4Sq&2e+-G%|+NM8OOm5zVl9{Z8Dd8A5z3y8mZ=4Bv4%>as_{9cN#bm~;h>62( zdqY93Zy}v&c4n($Vv!UybR8ocs7#zbfX1IY-*w~)p}XyZ-SFC~4w>BvMVr`dFbelV{lLL0bx7@*ZZdebr3`sP;? zVImji)kG)(6Juv0lz@q`F!k1FE;CQ(D0iG$wchPbKZQELlsZ#~rt8#90Y_Xh&3U-< z{s<&cCV_1`^TD^ia9!*mQDq& zn2{r`j};V|uV%_wsP!zB?m%;FeaRe+X47K0e+KE!8C{gAWF8)lCd1u1%~|M!XNRvw zvtqy3iz0WSpWdhn6$hP8PaRBmp)q`#PCA`Vd#Tc$@f1tAcM>f_I@bC)hkI9|o(Iqv zo}Piadq!j76}004RBio<`)70k^`K1NK)q>w?p^C6J2ZC!+UppiK6&y3Kmbv&O!oYF z34$0Z;QO!JOY#!`qyGH<3Pd}Pt@q*A0V=3SVtWKRR8d8Z&@)3qLPA19LPA19LPEUC YUoZo%k(ykuW&i*H07*qoM6N<$f+CH{y8r+H literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json new file mode 100644 index 0000000..0bedcf2 --- /dev/null +++ b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "idiom" : "universal", + "filename" : "LaunchImage.png", + "scale" : "1x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@2x.png", + "scale" : "2x" + }, + { + "idiom" : "universal", + "filename" : "LaunchImage@3x.png", + "scale" : "3x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png new file mode 100644 index 0000000000000000000000000000000000000000..9da19eacad3b03bb08bbddbbf4ac48dd78b3d838 GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcv6Uzs@r-FtIZ-&5|)J Q1PU{Fy85}Sb4q9e0B4a5jsO4v literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..9da19eacad3b03bb08bbddbbf4ac48dd78b3d838 GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcv6Uzs@r-FtIZ-&5|)J Q1PU{Fy85}Sb4q9e0B4a5jsO4v literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..9da19eacad3b03bb08bbddbbf4ac48dd78b3d838 GIT binary patch literal 68 zcmeAS@N?(olHy`uVBq!ia0vp^j3CUx0wlM}@Gt=>Zci7-kcv6Uzs@r-FtIZ-&5|)J Q1PU{Fy85}Sb4q9e0B4a5jsO4v literal 0 HcmV?d00001 diff --git a/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md new file mode 100644 index 0000000..89c2725 --- /dev/null +++ b/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md @@ -0,0 +1,5 @@ +# Launch Screen Assets + +You can customize the launch screen with your own desired assets by replacing the image files in this directory. + +You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images. \ No newline at end of file diff --git a/example/ios/Runner/Base.lproj/LaunchScreen.storyboard b/example/ios/Runner/Base.lproj/LaunchScreen.storyboard new file mode 100644 index 0000000..f2e259c --- /dev/null +++ b/example/ios/Runner/Base.lproj/LaunchScreen.storyboard @@ -0,0 +1,37 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/example/ios/Runner/Base.lproj/Main.storyboard b/example/ios/Runner/Base.lproj/Main.storyboard new file mode 100644 index 0000000..f3c2851 --- /dev/null +++ b/example/ios/Runner/Base.lproj/Main.storyboard @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/example/ios/Runner/Info.plist b/example/ios/Runner/Info.plist new file mode 100644 index 0000000..938d353 --- /dev/null +++ b/example/ios/Runner/Info.plist @@ -0,0 +1,49 @@ + + + + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleDisplayName + Flame Lua Runtime Showcase + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + flame_lua_runtime_showcase + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleSignature + ???? + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UIMainStoryboardFile + Main + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + UISupportedInterfaceOrientations~ipad + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + CADisableMinimumFrameDurationOnPhone + + UIApplicationSupportsIndirectInputEvents + + + diff --git a/example/ios/Runner/Runner-Bridging-Header.h b/example/ios/Runner/Runner-Bridging-Header.h new file mode 100644 index 0000000..308a2a5 --- /dev/null +++ b/example/ios/Runner/Runner-Bridging-Header.h @@ -0,0 +1 @@ +#import "GeneratedPluginRegistrant.h" diff --git a/example/ios/RunnerTests/RunnerTests.swift b/example/ios/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..86a7c3b --- /dev/null +++ b/example/ios/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import Flutter +import UIKit +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/example/lib/main.dart b/example/lib/main.dart new file mode 100644 index 0000000..833c481 --- /dev/null +++ b/example/lib/main.dart @@ -0,0 +1,41 @@ +import 'package:flame_spine/flame_spine.dart' as spine; +import 'package:flutter/material.dart'; + +import 'package:flame_lua_runtime/flame_lua_runtime.dart'; + +const _serverUrl = String.fromEnvironment('LUA_GAME_SERVER'); +const _gameId = String.fromEnvironment('LUA_GAME_ID', defaultValue: 'showcase'); +const _locale = String.fromEnvironment('LUA_GAME_LOCALE'); + +Future main() async { + WidgetsFlutterBinding.ensureInitialized(); + await spine.initSpineFlutter(); + runApp(const FlameLuaRuntimeShowcaseApp()); +} + +class FlameLuaRuntimeShowcaseApp extends StatelessWidget { + const FlameLuaRuntimeShowcaseApp({super.key}); + + @override + Widget build(BuildContext context) { + return MaterialApp( + debugShowCheckedModeBanner: false, + title: 'Flame Lua Runtime Showcase', + theme: ThemeData.dark(useMaterial3: true), + home: Scaffold( + body: SafeArea( + child: LuaGameWidget( + gameId: _gameId, + serverUrl: _serverUrl.isEmpty ? null : Uri.parse(_serverUrl), + runtimeOptions: const RuntimeOptions( + runtimeLuaRoot: 'packages/flame_lua_runtime/assets/runtime/lua', + ), + localeOverride: _locale.isEmpty + ? null + : RuntimeLocaleResolver.localeFromTag(_locale), + ), + ), + ), + ); + } +} diff --git a/example/linux/.gitignore b/example/linux/.gitignore new file mode 100644 index 0000000..d3896c9 --- /dev/null +++ b/example/linux/.gitignore @@ -0,0 +1 @@ +flutter/ephemeral diff --git a/example/linux/CMakeLists.txt b/example/linux/CMakeLists.txt new file mode 100644 index 0000000..88305da --- /dev/null +++ b/example/linux/CMakeLists.txt @@ -0,0 +1,128 @@ +# Project-level configuration. +cmake_minimum_required(VERSION 3.13) +project(runner LANGUAGES CXX) + +# The name of the executable created for the application. Change this to change +# the on-disk name of your application. +set(BINARY_NAME "flame_lua_runtime_showcase") +# The unique GTK application identifier for this application. See: +# https://wiki.gnome.org/HowDoI/ChooseApplicationID +set(APPLICATION_ID "dev.flame_lua.runtime_showcase") + +# Explicitly opt in to modern CMake behaviors to avoid warnings with recent +# versions of CMake. +cmake_policy(SET CMP0063 NEW) + +# Load bundled libraries from the lib/ directory relative to the binary. +set(CMAKE_INSTALL_RPATH "$ORIGIN/lib") + +# Root filesystem for cross-building. +if(FLUTTER_TARGET_PLATFORM_SYSROOT) + set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT}) + set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) + set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) + set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) +endif() + +# Define build configuration options. +if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) + set(CMAKE_BUILD_TYPE "Debug" CACHE + STRING "Flutter build mode" FORCE) + set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS + "Debug" "Profile" "Release") +endif() + +# Compilation settings that should be applied to most targets. +# +# Be cautious about adding new options here, as plugins use this function by +# default. In most cases, you should add new options to specific targets instead +# of modifying this function. +function(APPLY_STANDARD_SETTINGS TARGET) + target_compile_features(${TARGET} PUBLIC cxx_std_14) + target_compile_options(${TARGET} PRIVATE -Wall -Werror) + target_compile_options(${TARGET} PRIVATE "$<$>:-O3>") + target_compile_definitions(${TARGET} PRIVATE "$<$>:NDEBUG>") +endfunction() + +# Flutter library and tool build rules. +set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") +add_subdirectory(${FLUTTER_MANAGED_DIR}) + +# System-level dependencies. +find_package(PkgConfig REQUIRED) +pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) + +# Application build; see runner/CMakeLists.txt. +add_subdirectory("runner") + +# Run the Flutter tool portions of the build. This must not be removed. +add_dependencies(${BINARY_NAME} flutter_assemble) + +# Only the install-generated bundle's copy of the executable will launch +# correctly, since the resources must in the right relative locations. To avoid +# people trying to run the unbundled copy, put it in a subdirectory instead of +# the default top-level location. +set_target_properties(${BINARY_NAME} + PROPERTIES + RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run" +) + + +# Generated plugin build rules, which manage building the plugins and adding +# them to the application. +include(flutter/generated_plugins.cmake) + + +# === Installation === +# By default, "installing" just makes a relocatable bundle in the build +# directory. +set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle") +if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) + set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) +endif() + +# Start with a clean build bundle directory every time. +install(CODE " + file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\") + " COMPONENT Runtime) + +set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") +set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib") + +install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES}) + install(FILES "${bundled_library}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endforeach(bundled_library) + +# Copy the native assets provided by the build.dart from all packages. +set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/") +install(DIRECTORY "${NATIVE_ASSETS_DIR}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +# Fully re-copy the assets directory on each build to avoid having stale files +# from a previous install. +set(FLUTTER_ASSET_DIR_NAME "flutter_assets") +install(CODE " + file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") + " COMPONENT Runtime) +install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" + DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) + +# Install the AOT library on non-Debug builds only. +if(NOT CMAKE_BUILD_TYPE MATCHES "Debug") + install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endif() diff --git a/example/linux/flutter/CMakeLists.txt b/example/linux/flutter/CMakeLists.txt new file mode 100644 index 0000000..d5bd016 --- /dev/null +++ b/example/linux/flutter/CMakeLists.txt @@ -0,0 +1,88 @@ +# This file controls Flutter-level build steps. It should not be edited. +cmake_minimum_required(VERSION 3.10) + +set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") + +# Configuration provided via flutter tool. +include(${EPHEMERAL_DIR}/generated_config.cmake) + +# TODO: Move the rest of this into files in ephemeral. See +# https://github.com/flutter/flutter/issues/57146. + +# Serves the same purpose as list(TRANSFORM ... PREPEND ...), +# which isn't available in 3.10. +function(list_prepend LIST_NAME PREFIX) + set(NEW_LIST "") + foreach(element ${${LIST_NAME}}) + list(APPEND NEW_LIST "${PREFIX}${element}") + endforeach(element) + set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE) +endfunction() + +# === Flutter Library === +# System-level dependencies. +find_package(PkgConfig REQUIRED) +pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) +pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0) +pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0) + +set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so") + +# Published to parent scope for install step. +set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) +set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) +set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) +set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE) + +list(APPEND FLUTTER_LIBRARY_HEADERS + "fl_basic_message_channel.h" + "fl_binary_codec.h" + "fl_binary_messenger.h" + "fl_dart_project.h" + "fl_engine.h" + "fl_json_message_codec.h" + "fl_json_method_codec.h" + "fl_message_codec.h" + "fl_method_call.h" + "fl_method_channel.h" + "fl_method_codec.h" + "fl_method_response.h" + "fl_plugin_registrar.h" + "fl_plugin_registry.h" + "fl_standard_message_codec.h" + "fl_standard_method_codec.h" + "fl_string_codec.h" + "fl_value.h" + "fl_view.h" + "flutter_linux.h" +) +list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/") +add_library(flutter INTERFACE) +target_include_directories(flutter INTERFACE + "${EPHEMERAL_DIR}" +) +target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}") +target_link_libraries(flutter INTERFACE + PkgConfig::GTK + PkgConfig::GLIB + PkgConfig::GIO +) +add_dependencies(flutter flutter_assemble) + +# === Flutter tool backend === +# _phony_ is a non-existent file to force this command to run every time, +# since currently there's no way to get a full input/output list from the +# flutter tool. +add_custom_command( + OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} + ${CMAKE_CURRENT_BINARY_DIR}/_phony_ + COMMAND ${CMAKE_COMMAND} -E env + ${FLUTTER_TOOL_ENVIRONMENT} + "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh" + ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE} + VERBATIM +) +add_custom_target(flutter_assemble DEPENDS + "${FLUTTER_LIBRARY}" + ${FLUTTER_LIBRARY_HEADERS} +) diff --git a/example/linux/flutter/generated_plugin_registrant.cc b/example/linux/flutter/generated_plugin_registrant.cc new file mode 100644 index 0000000..1830e5c --- /dev/null +++ b/example/linux/flutter/generated_plugin_registrant.cc @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#include "generated_plugin_registrant.h" + +#include + +void fl_register_plugins(FlPluginRegistry* registry) { + g_autoptr(FlPluginRegistrar) audioplayers_linux_registrar = + fl_plugin_registry_get_registrar_for_plugin(registry, "AudioplayersLinuxPlugin"); + audioplayers_linux_plugin_register_with_registrar(audioplayers_linux_registrar); +} diff --git a/example/linux/flutter/generated_plugin_registrant.h b/example/linux/flutter/generated_plugin_registrant.h new file mode 100644 index 0000000..e0f0a47 --- /dev/null +++ b/example/linux/flutter/generated_plugin_registrant.h @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#ifndef GENERATED_PLUGIN_REGISTRANT_ +#define GENERATED_PLUGIN_REGISTRANT_ + +#include + +// Registers Flutter plugins. +void fl_register_plugins(FlPluginRegistry* registry); + +#endif // GENERATED_PLUGIN_REGISTRANT_ diff --git a/example/linux/flutter/generated_plugins.cmake b/example/linux/flutter/generated_plugins.cmake new file mode 100644 index 0000000..894343b --- /dev/null +++ b/example/linux/flutter/generated_plugins.cmake @@ -0,0 +1,26 @@ +# +# Generated file, do not edit. +# + +list(APPEND FLUTTER_PLUGIN_LIST + audioplayers_linux +) + +list(APPEND FLUTTER_FFI_PLUGIN_LIST + jni + spine_flutter +) + +set(PLUGIN_BUNDLED_LIBRARIES) + +foreach(plugin ${FLUTTER_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/linux plugins/${plugin}) + target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) + list(APPEND PLUGIN_BUNDLED_LIBRARIES $) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) +endforeach(plugin) + +foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/linux plugins/${ffi_plugin}) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) +endforeach(ffi_plugin) diff --git a/example/linux/runner/CMakeLists.txt b/example/linux/runner/CMakeLists.txt new file mode 100644 index 0000000..e97dabc --- /dev/null +++ b/example/linux/runner/CMakeLists.txt @@ -0,0 +1,26 @@ +cmake_minimum_required(VERSION 3.13) +project(runner LANGUAGES CXX) + +# Define the application target. To change its name, change BINARY_NAME in the +# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer +# work. +# +# Any new source files that you add to the application should be added here. +add_executable(${BINARY_NAME} + "main.cc" + "my_application.cc" + "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" +) + +# Apply the standard set of build settings. This can be removed for applications +# that need different build settings. +apply_standard_settings(${BINARY_NAME}) + +# Add preprocessor definitions for the application ID. +add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}") + +# Add dependency libraries. Add any application-specific dependencies here. +target_link_libraries(${BINARY_NAME} PRIVATE flutter) +target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK) + +target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") diff --git a/example/linux/runner/main.cc b/example/linux/runner/main.cc new file mode 100644 index 0000000..e7c5c54 --- /dev/null +++ b/example/linux/runner/main.cc @@ -0,0 +1,6 @@ +#include "my_application.h" + +int main(int argc, char** argv) { + g_autoptr(MyApplication) app = my_application_new(); + return g_application_run(G_APPLICATION(app), argc, argv); +} diff --git a/example/linux/runner/my_application.cc b/example/linux/runner/my_application.cc new file mode 100644 index 0000000..987e345 --- /dev/null +++ b/example/linux/runner/my_application.cc @@ -0,0 +1,144 @@ +#include "my_application.h" + +#include +#ifdef GDK_WINDOWING_X11 +#include +#endif + +#include "flutter/generated_plugin_registrant.h" + +struct _MyApplication { + GtkApplication parent_instance; + char** dart_entrypoint_arguments; +}; + +G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION) + +// Called when first Flutter frame received. +static void first_frame_cb(MyApplication* self, FlView *view) +{ + gtk_widget_show(gtk_widget_get_toplevel(GTK_WIDGET(view))); +} + +// Implements GApplication::activate. +static void my_application_activate(GApplication* application) { + MyApplication* self = MY_APPLICATION(application); + GtkWindow* window = + GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(application))); + + // Use a header bar when running in GNOME as this is the common style used + // by applications and is the setup most users will be using (e.g. Ubuntu + // desktop). + // If running on X and not using GNOME then just use a traditional title bar + // in case the window manager does more exotic layout, e.g. tiling. + // If running on Wayland assume the header bar will work (may need changing + // if future cases occur). + gboolean use_header_bar = TRUE; +#ifdef GDK_WINDOWING_X11 + GdkScreen* screen = gtk_window_get_screen(window); + if (GDK_IS_X11_SCREEN(screen)) { + const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen); + if (g_strcmp0(wm_name, "GNOME Shell") != 0) { + use_header_bar = FALSE; + } + } +#endif + if (use_header_bar) { + GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new()); + gtk_widget_show(GTK_WIDGET(header_bar)); + gtk_header_bar_set_title(header_bar, "flame_lua_runtime_showcase"); + gtk_header_bar_set_show_close_button(header_bar, TRUE); + gtk_window_set_titlebar(window, GTK_WIDGET(header_bar)); + } else { + gtk_window_set_title(window, "flame_lua_runtime_showcase"); + } + + gtk_window_set_default_size(window, 1280, 720); + + g_autoptr(FlDartProject) project = fl_dart_project_new(); + fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments); + + FlView* view = fl_view_new(project); + GdkRGBA background_color; + // Background defaults to black, override it here if necessary, e.g. #00000000 for transparent. + gdk_rgba_parse(&background_color, "#000000"); + fl_view_set_background_color(view, &background_color); + gtk_widget_show(GTK_WIDGET(view)); + gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view)); + + // Show the window when Flutter renders. + // Requires the view to be realized so we can start rendering. + g_signal_connect_swapped(view, "first-frame", G_CALLBACK(first_frame_cb), self); + gtk_widget_realize(GTK_WIDGET(view)); + + fl_register_plugins(FL_PLUGIN_REGISTRY(view)); + + gtk_widget_grab_focus(GTK_WIDGET(view)); +} + +// Implements GApplication::local_command_line. +static gboolean my_application_local_command_line(GApplication* application, gchar*** arguments, int* exit_status) { + MyApplication* self = MY_APPLICATION(application); + // Strip out the first argument as it is the binary name. + self->dart_entrypoint_arguments = g_strdupv(*arguments + 1); + + g_autoptr(GError) error = nullptr; + if (!g_application_register(application, nullptr, &error)) { + g_warning("Failed to register: %s", error->message); + *exit_status = 1; + return TRUE; + } + + g_application_activate(application); + *exit_status = 0; + + return TRUE; +} + +// Implements GApplication::startup. +static void my_application_startup(GApplication* application) { + //MyApplication* self = MY_APPLICATION(object); + + // Perform any actions required at application startup. + + G_APPLICATION_CLASS(my_application_parent_class)->startup(application); +} + +// Implements GApplication::shutdown. +static void my_application_shutdown(GApplication* application) { + //MyApplication* self = MY_APPLICATION(object); + + // Perform any actions required at application shutdown. + + G_APPLICATION_CLASS(my_application_parent_class)->shutdown(application); +} + +// Implements GObject::dispose. +static void my_application_dispose(GObject* object) { + MyApplication* self = MY_APPLICATION(object); + g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev); + G_OBJECT_CLASS(my_application_parent_class)->dispose(object); +} + +static void my_application_class_init(MyApplicationClass* klass) { + G_APPLICATION_CLASS(klass)->activate = my_application_activate; + G_APPLICATION_CLASS(klass)->local_command_line = my_application_local_command_line; + G_APPLICATION_CLASS(klass)->startup = my_application_startup; + G_APPLICATION_CLASS(klass)->shutdown = my_application_shutdown; + G_OBJECT_CLASS(klass)->dispose = my_application_dispose; +} + +static void my_application_init(MyApplication* self) {} + +MyApplication* my_application_new() { + // Set the program name to the application ID, which helps various systems + // like GTK and desktop environments map this running application to its + // corresponding .desktop file. This ensures better integration by allowing + // the application to be recognized beyond its binary name. + g_set_prgname(APPLICATION_ID); + + return MY_APPLICATION(g_object_new(my_application_get_type(), + "application-id", APPLICATION_ID, + "flags", G_APPLICATION_NON_UNIQUE, + nullptr)); +} diff --git a/example/linux/runner/my_application.h b/example/linux/runner/my_application.h new file mode 100644 index 0000000..72271d5 --- /dev/null +++ b/example/linux/runner/my_application.h @@ -0,0 +1,18 @@ +#ifndef FLUTTER_MY_APPLICATION_H_ +#define FLUTTER_MY_APPLICATION_H_ + +#include + +G_DECLARE_FINAL_TYPE(MyApplication, my_application, MY, APPLICATION, + GtkApplication) + +/** + * my_application_new: + * + * Creates a new Flutter-based application. + * + * Returns: a new #MyApplication. + */ +MyApplication* my_application_new(); + +#endif // FLUTTER_MY_APPLICATION_H_ diff --git a/example/macos/.gitignore b/example/macos/.gitignore new file mode 100644 index 0000000..746adbb --- /dev/null +++ b/example/macos/.gitignore @@ -0,0 +1,7 @@ +# Flutter-related +**/Flutter/ephemeral/ +**/Pods/ + +# Xcode-related +**/dgph +**/xcuserdata/ diff --git a/example/macos/Flutter/Flutter-Debug.xcconfig b/example/macos/Flutter/Flutter-Debug.xcconfig new file mode 100644 index 0000000..c2efd0b --- /dev/null +++ b/example/macos/Flutter/Flutter-Debug.xcconfig @@ -0,0 +1 @@ +#include "ephemeral/Flutter-Generated.xcconfig" diff --git a/example/macos/Flutter/Flutter-Release.xcconfig b/example/macos/Flutter/Flutter-Release.xcconfig new file mode 100644 index 0000000..c2efd0b --- /dev/null +++ b/example/macos/Flutter/Flutter-Release.xcconfig @@ -0,0 +1 @@ +#include "ephemeral/Flutter-Generated.xcconfig" diff --git a/example/macos/Flutter/GeneratedPluginRegistrant.swift b/example/macos/Flutter/GeneratedPluginRegistrant.swift new file mode 100644 index 0000000..a9f2f23 --- /dev/null +++ b/example/macos/Flutter/GeneratedPluginRegistrant.swift @@ -0,0 +1,14 @@ +// +// Generated file. Do not edit. +// + +import FlutterMacOS +import Foundation + +import audioplayers_darwin +import path_provider_foundation + +func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) { + AudioplayersDarwinPlugin.register(with: registry.registrar(forPlugin: "AudioplayersDarwinPlugin")) + PathProviderPlugin.register(with: registry.registrar(forPlugin: "PathProviderPlugin")) +} diff --git a/example/macos/Runner.xcodeproj/project.pbxproj b/example/macos/Runner.xcodeproj/project.pbxproj new file mode 100644 index 0000000..eb02791 --- /dev/null +++ b/example/macos/Runner.xcodeproj/project.pbxproj @@ -0,0 +1,705 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 54; + objects = { + +/* Begin PBXAggregateTarget section */ + 33CC111A2044C6BA0003C045 /* Flutter Assemble */ = { + isa = PBXAggregateTarget; + buildConfigurationList = 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */; + buildPhases = ( + 33CC111E2044C6BF0003C045 /* ShellScript */, + ); + dependencies = ( + ); + name = "Flutter Assemble"; + productName = FLX; + }; +/* End PBXAggregateTarget section */ + +/* Begin PBXBuildFile section */ + 331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 331C80D7294CF71000263BE5 /* RunnerTests.swift */; }; + 335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */ = {isa = PBXBuildFile; fileRef = 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */; }; + 33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC10F02044A3C60003C045 /* AppDelegate.swift */; }; + 33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F22044A3C60003C045 /* Assets.xcassets */; }; + 33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */ = {isa = PBXBuildFile; fileRef = 33CC10F42044A3C60003C045 /* MainMenu.xib */; }; + 33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */ = {isa = PBXBuildFile; fileRef = 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 33CC10E52044A3C60003C045 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 33CC10EC2044A3C60003C045; + remoteInfo = Runner; + }; + 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = 33CC10E52044A3C60003C045 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 33CC111A2044C6BA0003C045; + remoteInfo = FLX; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXCopyFilesBuildPhase section */ + 33CC110E2044A8840003C045 /* Bundle Framework */ = { + isa = PBXCopyFilesBuildPhase; + buildActionMask = 2147483647; + dstPath = ""; + dstSubfolderSpec = 10; + files = ( + ); + name = "Bundle Framework"; + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXCopyFilesBuildPhase section */ + +/* Begin PBXFileReference section */ + 331C80D5294CF71000263BE5 /* RunnerTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RunnerTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; + 331C80D7294CF71000263BE5 /* RunnerTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RunnerTests.swift; sourceTree = ""; }; + 333000ED22D3DE5D00554162 /* Warnings.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Warnings.xcconfig; sourceTree = ""; }; + 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = GeneratedPluginRegistrant.swift; sourceTree = ""; }; + 33CC10ED2044A3C60003C045 /* flame_lua_ludo.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "flame_lua_ludo.app"; sourceTree = BUILT_PRODUCTS_DIR; }; + 33CC10F02044A3C60003C045 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 33CC10F22044A3C60003C045 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; name = Assets.xcassets; path = Runner/Assets.xcassets; sourceTree = ""; }; + 33CC10F52044A3C60003C045 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/MainMenu.xib; sourceTree = ""; }; + 33CC10F72044A3C60003C045 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = Info.plist; path = Runner/Info.plist; sourceTree = ""; }; + 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainFlutterWindow.swift; sourceTree = ""; }; + 33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Debug.xcconfig"; sourceTree = ""; }; + 33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = "Flutter-Release.xcconfig"; sourceTree = ""; }; + 33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = "Flutter-Generated.xcconfig"; path = "ephemeral/Flutter-Generated.xcconfig"; sourceTree = ""; }; + 33E51913231747F40026EE4D /* DebugProfile.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DebugProfile.entitlements; sourceTree = ""; }; + 33E51914231749380026EE4D /* Release.entitlements */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.entitlements; path = Release.entitlements; sourceTree = ""; }; + 33E5194F232828860026EE4D /* AppInfo.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = AppInfo.xcconfig; sourceTree = ""; }; + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; path = Release.xcconfig; sourceTree = ""; }; + 9740EEB21CF90195004384FC /* Debug.xcconfig */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.xcconfig; path = Debug.xcconfig; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 331C80D2294CF70F00263BE5 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10EA2044A3C60003C045 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 331C80D6294CF71000263BE5 /* RunnerTests */ = { + isa = PBXGroup; + children = ( + 331C80D7294CF71000263BE5 /* RunnerTests.swift */, + ); + path = RunnerTests; + sourceTree = ""; + }; + 33BA886A226E78AF003329D5 /* Configs */ = { + isa = PBXGroup; + children = ( + 33E5194F232828860026EE4D /* AppInfo.xcconfig */, + 9740EEB21CF90195004384FC /* Debug.xcconfig */, + 7AFA3C8E1D35360C0083082E /* Release.xcconfig */, + 333000ED22D3DE5D00554162 /* Warnings.xcconfig */, + ); + path = Configs; + sourceTree = ""; + }; + 33CC10E42044A3C60003C045 = { + isa = PBXGroup; + children = ( + 33FAB671232836740065AC1E /* Runner */, + 33CEB47122A05771004F2AC0 /* Flutter */, + 331C80D6294CF71000263BE5 /* RunnerTests */, + 33CC10EE2044A3C60003C045 /* Products */, + D73912EC22F37F3D000D13A0 /* Frameworks */, + ); + sourceTree = ""; + }; + 33CC10EE2044A3C60003C045 /* Products */ = { + isa = PBXGroup; + children = ( + 33CC10ED2044A3C60003C045 /* flame_lua_ludo.app */, + 331C80D5294CF71000263BE5 /* RunnerTests.xctest */, + ); + name = Products; + sourceTree = ""; + }; + 33CC11242044D66E0003C045 /* Resources */ = { + isa = PBXGroup; + children = ( + 33CC10F22044A3C60003C045 /* Assets.xcassets */, + 33CC10F42044A3C60003C045 /* MainMenu.xib */, + 33CC10F72044A3C60003C045 /* Info.plist */, + ); + name = Resources; + path = ..; + sourceTree = ""; + }; + 33CEB47122A05771004F2AC0 /* Flutter */ = { + isa = PBXGroup; + children = ( + 335BBD1A22A9A15E00E9071D /* GeneratedPluginRegistrant.swift */, + 33CEB47222A05771004F2AC0 /* Flutter-Debug.xcconfig */, + 33CEB47422A05771004F2AC0 /* Flutter-Release.xcconfig */, + 33CEB47722A0578A004F2AC0 /* Flutter-Generated.xcconfig */, + ); + path = Flutter; + sourceTree = ""; + }; + 33FAB671232836740065AC1E /* Runner */ = { + isa = PBXGroup; + children = ( + 33CC10F02044A3C60003C045 /* AppDelegate.swift */, + 33CC11122044BFA00003C045 /* MainFlutterWindow.swift */, + 33E51913231747F40026EE4D /* DebugProfile.entitlements */, + 33E51914231749380026EE4D /* Release.entitlements */, + 33CC11242044D66E0003C045 /* Resources */, + 33BA886A226E78AF003329D5 /* Configs */, + ); + path = Runner; + sourceTree = ""; + }; + D73912EC22F37F3D000D13A0 /* Frameworks */ = { + isa = PBXGroup; + children = ( + ); + name = Frameworks; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 331C80D4294CF70F00263BE5 /* RunnerTests */ = { + isa = PBXNativeTarget; + buildConfigurationList = 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */; + buildPhases = ( + 331C80D1294CF70F00263BE5 /* Sources */, + 331C80D2294CF70F00263BE5 /* Frameworks */, + 331C80D3294CF70F00263BE5 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 331C80DA294CF71000263BE5 /* PBXTargetDependency */, + ); + name = RunnerTests; + productName = RunnerTests; + productReference = 331C80D5294CF71000263BE5 /* RunnerTests.xctest */; + productType = "com.apple.product-type.bundle.unit-test"; + }; + 33CC10EC2044A3C60003C045 /* Runner */ = { + isa = PBXNativeTarget; + buildConfigurationList = 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */; + buildPhases = ( + 33CC10E92044A3C60003C045 /* Sources */, + 33CC10EA2044A3C60003C045 /* Frameworks */, + 33CC10EB2044A3C60003C045 /* Resources */, + 33CC110E2044A8840003C045 /* Bundle Framework */, + 3399D490228B24CF009A79C7 /* ShellScript */, + ); + buildRules = ( + ); + dependencies = ( + 33CC11202044C79F0003C045 /* PBXTargetDependency */, + ); + name = Runner; + productName = Runner; + productReference = 33CC10ED2044A3C60003C045 /* flame_lua_ludo.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 33CC10E52044A3C60003C045 /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = YES; + LastSwiftUpdateCheck = 0920; + LastUpgradeCheck = 1510; + ORGANIZATIONNAME = ""; + TargetAttributes = { + 331C80D4294CF70F00263BE5 = { + CreatedOnToolsVersion = 14.0; + TestTargetID = 33CC10EC2044A3C60003C045; + }; + 33CC10EC2044A3C60003C045 = { + CreatedOnToolsVersion = 9.2; + LastSwiftMigration = 1100; + ProvisioningStyle = Automatic; + SystemCapabilities = { + com.apple.Sandbox = { + enabled = 1; + }; + }; + }; + 33CC111A2044C6BA0003C045 = { + CreatedOnToolsVersion = 9.2; + ProvisioningStyle = Manual; + }; + }; + }; + buildConfigurationList = 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */; + compatibilityVersion = "Xcode 9.3"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 33CC10E42044A3C60003C045; + productRefGroup = 33CC10EE2044A3C60003C045 /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 33CC10EC2044A3C60003C045 /* Runner */, + 331C80D4294CF70F00263BE5 /* RunnerTests */, + 33CC111A2044C6BA0003C045 /* Flutter Assemble */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 331C80D3294CF70F00263BE5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10EB2044A3C60003C045 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 33CC10F32044A3C60003C045 /* Assets.xcassets in Resources */, + 33CC10F62044A3C60003C045 /* MainMenu.xib in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 3399D490228B24CF009A79C7 /* ShellScript */ = { + isa = PBXShellScriptBuildPhase; + alwaysOutOfDate = 1; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + ); + inputPaths = ( + ); + outputFileListPaths = ( + ); + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "echo \"$PRODUCT_NAME.app\" > \"$PROJECT_DIR\"/Flutter/ephemeral/.app_filename && \"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh embed\n"; + }; + 33CC111E2044C6BF0003C045 /* ShellScript */ = { + isa = PBXShellScriptBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + Flutter/ephemeral/FlutterInputs.xcfilelist, + ); + inputPaths = ( + Flutter/ephemeral/tripwire, + ); + outputFileListPaths = ( + Flutter/ephemeral/FlutterOutputs.xcfilelist, + ); + outputPaths = ( + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "\"$FLUTTER_ROOT\"/packages/flutter_tools/bin/macos_assemble.sh && touch Flutter/ephemeral/tripwire"; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 331C80D1294CF70F00263BE5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 331C80D8294CF71000263BE5 /* RunnerTests.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 33CC10E92044A3C60003C045 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 33CC11132044BFA00003C045 /* MainFlutterWindow.swift in Sources */, + 33CC10F12044A3C60003C045 /* AppDelegate.swift in Sources */, + 335BBD1B22A9A15E00E9071D /* GeneratedPluginRegistrant.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 331C80DA294CF71000263BE5 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 33CC10EC2044A3C60003C045 /* Runner */; + targetProxy = 331C80D9294CF71000263BE5 /* PBXContainerItemProxy */; + }; + 33CC11202044C79F0003C045 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + target = 33CC111A2044C6BA0003C045 /* Flutter Assemble */; + targetProxy = 33CC111F2044C79F0003C045 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin PBXVariantGroup section */ + 33CC10F42044A3C60003C045 /* MainMenu.xib */ = { + isa = PBXVariantGroup; + children = ( + 33CC10F52044A3C60003C045 /* Base */, + ); + name = MainMenu.xib; + path = Runner; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 331C80DB294CF71000263BE5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/flame_lua_ludo.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/flame_lua_ludo"; + }; + name = Debug; + }; + 331C80DC294CF71000263BE5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/flame_lua_ludo.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/flame_lua_ludo"; + }; + name = Release; + }; + 331C80DD294CF71000263BE5 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + BUNDLE_LOADER = "$(TEST_HOST)"; + CURRENT_PROJECT_VERSION = 1; + GENERATE_INFOPLIST_FILE = YES; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo.RunnerTests; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_VERSION = 5.0; + TEST_HOST = "$(BUILT_PRODUCTS_DIR)/flame_lua_ludo.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/flame_lua_ludo"; + }; + name = Profile; + }; + 338D0CE9231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEAD_CODE_STRIPPING = YES; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.15; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = macosx; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + }; + name = Profile; + }; + 338D0CEA231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_VERSION = 5.0; + }; + name = Profile; + }; + 338D0CEB231458BD00FA5F75 /* Profile */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Manual; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Profile; + }; + 33CC10F92044A3C60003C045 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9740EEB21CF90195004384FC /* Debug.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEAD_CODE_STRIPPING = YES; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.15; + MTL_ENABLE_DEBUG_INFO = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = macosx; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + }; + name = Debug; + }; + 33CC10FA2044A3C60003C045 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7AFA3C8E1D35360C0083082E /* Release.xcconfig */; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CODE_SIGN_IDENTITY = "-"; + COPY_PHASE_STRIP = NO; + DEAD_CODE_STRIPPING = YES; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = NO; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + MACOSX_DEPLOYMENT_TARGET = 10.15; + MTL_ENABLE_DEBUG_INFO = NO; + SDKROOT = macosx; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + }; + name = Release; + }; + 33CC10FC2044A3C60003C045 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/DebugProfile.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + }; + name = Debug; + }; + 33CC10FD2044A3C60003C045 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 33E5194F232828860026EE4D /* AppInfo.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + CLANG_ENABLE_MODULES = YES; + CODE_SIGN_ENTITLEMENTS = Runner/Release.entitlements; + CODE_SIGN_STYLE = Automatic; + COMBINE_HIDPI_IMAGES = YES; + INFOPLIST_FILE = Runner/Info.plist; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/../Frameworks", + ); + PROVISIONING_PROFILE_SPECIFIER = ""; + SWIFT_VERSION = 5.0; + }; + name = Release; + }; + 33CC111C2044C6BA0003C045 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Manual; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Debug; + }; + 33CC111D2044C6BA0003C045 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + CODE_SIGN_STYLE = Automatic; + PRODUCT_NAME = "$(TARGET_NAME)"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 331C80DE294CF71000263BE5 /* Build configuration list for PBXNativeTarget "RunnerTests" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 331C80DB294CF71000263BE5 /* Debug */, + 331C80DC294CF71000263BE5 /* Release */, + 331C80DD294CF71000263BE5 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC10E82044A3C60003C045 /* Build configuration list for PBXProject "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC10F92044A3C60003C045 /* Debug */, + 33CC10FA2044A3C60003C045 /* Release */, + 338D0CE9231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC10FB2044A3C60003C045 /* Build configuration list for PBXNativeTarget "Runner" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC10FC2044A3C60003C045 /* Debug */, + 33CC10FD2044A3C60003C045 /* Release */, + 338D0CEA231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 33CC111B2044C6BA0003C045 /* Build configuration list for PBXAggregateTarget "Flutter Assemble" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 33CC111C2044C6BA0003C045 /* Debug */, + 33CC111D2044C6BA0003C045 /* Release */, + 338D0CEB231458BD00FA5F75 /* Profile */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 33CC10E52044A3C60003C045 /* Project object */; +} diff --git a/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme b/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme new file mode 100644 index 0000000..b49244f --- /dev/null +++ b/example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme @@ -0,0 +1,99 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/example/macos/Runner.xcworkspace/contents.xcworkspacedata b/example/macos/Runner.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..1d526a1 --- /dev/null +++ b/example/macos/Runner.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/example/macos/Runner/AppDelegate.swift b/example/macos/Runner/AppDelegate.swift new file mode 100644 index 0000000..b3c1761 --- /dev/null +++ b/example/macos/Runner/AppDelegate.swift @@ -0,0 +1,13 @@ +import Cocoa +import FlutterMacOS + +@main +class AppDelegate: FlutterAppDelegate { + override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { + return true + } + + override func applicationSupportsSecureRestorableState(_ app: NSApplication) -> Bool { + return true + } +} diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json b/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..a2ec33f --- /dev/null +++ b/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,68 @@ +{ + "images" : [ + { + "size" : "16x16", + "idiom" : "mac", + "filename" : "app_icon_16.png", + "scale" : "1x" + }, + { + "size" : "16x16", + "idiom" : "mac", + "filename" : "app_icon_32.png", + "scale" : "2x" + }, + { + "size" : "32x32", + "idiom" : "mac", + "filename" : "app_icon_32.png", + "scale" : "1x" + }, + { + "size" : "32x32", + "idiom" : "mac", + "filename" : "app_icon_64.png", + "scale" : "2x" + }, + { + "size" : "128x128", + "idiom" : "mac", + "filename" : "app_icon_128.png", + "scale" : "1x" + }, + { + "size" : "128x128", + "idiom" : "mac", + "filename" : "app_icon_256.png", + "scale" : "2x" + }, + { + "size" : "256x256", + "idiom" : "mac", + "filename" : "app_icon_256.png", + "scale" : "1x" + }, + { + "size" : "256x256", + "idiom" : "mac", + "filename" : "app_icon_512.png", + "scale" : "2x" + }, + { + "size" : "512x512", + "idiom" : "mac", + "filename" : "app_icon_512.png", + "scale" : "1x" + }, + { + "size" : "512x512", + "idiom" : "mac", + "filename" : "app_icon_1024.png", + "scale" : "2x" + } + ], + "info" : { + "version" : 1, + "author" : "xcode" + } +} diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png b/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png new file mode 100644 index 0000000000000000000000000000000000000000..82b6f9d9a33e198f5747104729e1fcef999772a5 GIT binary patch literal 102994 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ⅅ8MglG&ER{i5lN315cO?EdHNLrg? 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 z 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 Pe7HEdAEg|=c=LY&YVNkY literal 0 HcmV?d00001 diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png b/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png new file mode 100644 index 0000000000000000000000000000000000000000..13b35eba55c6dabc3aac36f33d859266c18fa0d0 GIT binary patch literal 5680 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 literal 0 HcmV?d00001 diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png b/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png new file mode 100644 index 0000000000000000000000000000000000000000..0a3f5fa40fb3d1e0710331a48de5d256da3f275d GIT binary patch literal 520 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 literal 0 HcmV?d00001 diff --git a/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png b/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png new file mode 100644 index 0000000000000000000000000000000000000000..2f1632cfddf3d9dade342351e627a0a75609fb46 GIT binary patch literal 2218 zcmV;b2vzrqP)Px#L}ge>W=%~1DgXcg2mk?xX#fNO00031000^Q000001E2u_0{{R30RRC20H6W@ z1ONa40RR91K%fHv1ONa40RR91KmY&$07g+lumAuE6iGxuRCodHTWf3-RTMruyW6Fu zQYeUM04eX6D5c0FCjKKPrco1(K`<0SL=crI{PC3-^hZU0kQie$gh-5!7z6SH6Q0J% zqot*`H1q{R5fHFYS}dje@;kG=v$L0(yY0?wY2%*c?A&{2?!D*x?m71{of2gv!$5|C z3>qG_BW}7K_yUcT3A5C6QD<+{aq?x;MAUyAiJn#Jv8_zZtQ{P zTRzbL3U9!qVuZzS$xKU10KiW~Bgdcv1-!uAhQxf3a7q+dU6lj?yoO4Lq4TUN4}h{N z*fIM=SS8|C2$(T>w$`t@3Tka!(r!7W`x z-isCVgQD^mG-MJ;XtJuK3V{Vy72GQ83KRWsHU?e*wrhKk=ApIYeDqLi;JI1e zuvv}5^Dc=k7F7?nm3nIw$NVmU-+R>> zyqOR$-2SDpJ}Pt;^RkJytDVXNTsu|mI1`~G7yw`EJR?VkGfNdqK9^^8P`JdtTV&tX4CNcV4 z&N06nZa??Fw1AgQOUSE2AmPE@WO(Fvo`%m`cDgiv(fAeRA%3AGXUbsGw{7Q`cY;1BI#ac3iN$$Hw z0LT0;xc%=q)me?Y*$xI@GRAw?+}>=9D+KTk??-HJ4=A>`V&vKFS75@MKdSF1JTq{S zc1!^8?YA|t+uKigaq!sT;Z!&0F2=k7F0PIU;F$leJLaw2UI6FL^w}OG&!;+b%ya1c z1n+6-inU<0VM-Y_s5iTElq)ThyF?StVcebpGI znw#+zLx2@ah{$_2jn+@}(zJZ{+}_N9BM;z)0yr|gF-4=Iyu@hI*Lk=-A8f#bAzc9f z`Kd6K--x@t04swJVC3JK1cHY-Hq+=|PN-VO;?^_C#;coU6TDP7Bt`;{JTG;!+jj(` zw5cLQ-(Cz-Tlb`A^w7|R56Ce;Wmr0)$KWOUZ6ai0PhzPeHwdl0H(etP zUV`va_i0s-4#DkNM8lUlqI7>YQLf)(lz9Q3Uw`)nc(z3{m5ZE77Ul$V%m)E}3&8L0 z-XaU|eB~Is08eORPk;=<>!1w)Kf}FOVS2l&9~A+@R#koFJ$Czd%Y(ENTV&A~U(IPI z;UY+gf+&6ioZ=roly<0Yst8ck>(M=S?B-ys3mLdM&)ex!hbt+ol|T6CTS+Sc0jv(& z7ijdvFwBq;0a{%3GGwkDKTeG`b+lyj0jjS1OMkYnepCdoosNY`*zmBIo*981BU%%U z@~$z0V`OVtIbEx5pa|Tct|Lg#ZQf5OYMUMRD>Wdxm5SAqV2}3!ceE-M2 z@O~lQ0OiKQp}o9I;?uxCgYVV?FH|?Riri*U$Zi_`V2eiA>l zdSm6;SEm6#T+SpcE8Ro_f2AwxzI z44hfe^WE3!h@W3RDyA_H440cpmYkv*)6m1XazTqw%=E5Xv7^@^^T7Q2wxr+Z2kVYr + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/example/macos/Runner/Configs/AppInfo.xcconfig b/example/macos/Runner/Configs/AppInfo.xcconfig new file mode 100644 index 0000000..77521e7 --- /dev/null +++ b/example/macos/Runner/Configs/AppInfo.xcconfig @@ -0,0 +1,14 @@ +// Application-level settings for the Runner target. +// +// This may be replaced with something auto-generated from metadata (e.g., pubspec.yaml) in the +// future. If not, the values below would default to using the project name when this becomes a +// 'flutter create' template. + +// The application's name. By default this is also the title of the Flutter window. +PRODUCT_NAME = flame_lua_ludo + +// The application's bundle identifier +PRODUCT_BUNDLE_IDENTIFIER = com.example.flameLuaLudo + +// The copyright displayed in application information +PRODUCT_COPYRIGHT = Copyright © 2026 com.example. All rights reserved. diff --git a/example/macos/Runner/Configs/Debug.xcconfig b/example/macos/Runner/Configs/Debug.xcconfig new file mode 100644 index 0000000..36b0fd9 --- /dev/null +++ b/example/macos/Runner/Configs/Debug.xcconfig @@ -0,0 +1,2 @@ +#include "../../Flutter/Flutter-Debug.xcconfig" +#include "Warnings.xcconfig" diff --git a/example/macos/Runner/Configs/Release.xcconfig b/example/macos/Runner/Configs/Release.xcconfig new file mode 100644 index 0000000..dff4f49 --- /dev/null +++ b/example/macos/Runner/Configs/Release.xcconfig @@ -0,0 +1,2 @@ +#include "../../Flutter/Flutter-Release.xcconfig" +#include "Warnings.xcconfig" diff --git a/example/macos/Runner/Configs/Warnings.xcconfig b/example/macos/Runner/Configs/Warnings.xcconfig new file mode 100644 index 0000000..42bcbf4 --- /dev/null +++ b/example/macos/Runner/Configs/Warnings.xcconfig @@ -0,0 +1,13 @@ +WARNING_CFLAGS = -Wall -Wconditional-uninitialized -Wnullable-to-nonnull-conversion -Wmissing-method-return-type -Woverlength-strings +GCC_WARN_UNDECLARED_SELECTOR = YES +CLANG_UNDEFINED_BEHAVIOR_SANITIZER_NULLABILITY = YES +CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE +CLANG_WARN__DUPLICATE_METHOD_MATCH = YES +CLANG_WARN_PRAGMA_PACK = YES +CLANG_WARN_STRICT_PROTOTYPES = YES +CLANG_WARN_COMMA = YES +GCC_WARN_STRICT_SELECTOR_MATCH = YES +CLANG_WARN_OBJC_REPEATED_USE_OF_WEAK = YES +CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES +GCC_WARN_SHADOW = YES +CLANG_WARN_UNREACHABLE_CODE = YES diff --git a/example/macos/Runner/DebugProfile.entitlements b/example/macos/Runner/DebugProfile.entitlements new file mode 100644 index 0000000..dddb8a3 --- /dev/null +++ b/example/macos/Runner/DebugProfile.entitlements @@ -0,0 +1,12 @@ + + + + + com.apple.security.app-sandbox + + com.apple.security.cs.allow-jit + + com.apple.security.network.server + + + diff --git a/example/macos/Runner/Info.plist b/example/macos/Runner/Info.plist new file mode 100644 index 0000000..4789daa --- /dev/null +++ b/example/macos/Runner/Info.plist @@ -0,0 +1,32 @@ + + + + + CFBundleDevelopmentRegion + $(DEVELOPMENT_LANGUAGE) + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleIconFile + + CFBundleIdentifier + $(PRODUCT_BUNDLE_IDENTIFIER) + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + $(PRODUCT_NAME) + CFBundlePackageType + APPL + CFBundleShortVersionString + $(FLUTTER_BUILD_NAME) + CFBundleVersion + $(FLUTTER_BUILD_NUMBER) + LSMinimumSystemVersion + $(MACOSX_DEPLOYMENT_TARGET) + NSHumanReadableCopyright + $(PRODUCT_COPYRIGHT) + NSMainNibFile + MainMenu + NSPrincipalClass + NSApplication + + diff --git a/example/macos/Runner/MainFlutterWindow.swift b/example/macos/Runner/MainFlutterWindow.swift new file mode 100644 index 0000000..3cc05eb --- /dev/null +++ b/example/macos/Runner/MainFlutterWindow.swift @@ -0,0 +1,15 @@ +import Cocoa +import FlutterMacOS + +class MainFlutterWindow: NSWindow { + override func awakeFromNib() { + let flutterViewController = FlutterViewController() + let windowFrame = self.frame + self.contentViewController = flutterViewController + self.setFrame(windowFrame, display: true) + + RegisterGeneratedPlugins(registry: flutterViewController) + + super.awakeFromNib() + } +} diff --git a/example/macos/Runner/Release.entitlements b/example/macos/Runner/Release.entitlements new file mode 100644 index 0000000..852fa1a --- /dev/null +++ b/example/macos/Runner/Release.entitlements @@ -0,0 +1,8 @@ + + + + + com.apple.security.app-sandbox + + + diff --git a/example/macos/RunnerTests/RunnerTests.swift b/example/macos/RunnerTests/RunnerTests.swift new file mode 100644 index 0000000..61f3bd1 --- /dev/null +++ b/example/macos/RunnerTests/RunnerTests.swift @@ -0,0 +1,12 @@ +import Cocoa +import FlutterMacOS +import XCTest + +class RunnerTests: XCTestCase { + + func testExample() { + // If you add code to the Runner application, consider adding tests here. + // See https://developer.apple.com/documentation/xctest for more information about using XCTest. + } + +} diff --git a/example/pubspec.yaml b/example/pubspec.yaml new file mode 100644 index 0000000..1e334af --- /dev/null +++ b/example/pubspec.yaml @@ -0,0 +1,34 @@ +name: flame_lua_runtime_example +description: Showcase app for the Flame Lua Runtime package. +publish_to: "none" +version: 1.0.0+1 + +environment: + sdk: ^3.9.2 + +dependencies: + flutter: + sdk: flutter + flame_spine: ^0.3.0+3 + flame_lua_runtime: + path: .. + +dev_dependencies: + flutter_test: + sdk: flutter + flutter_lints: ^5.0.0 + +flutter: + assets: + - assets/games/ludo/manifest.json + - assets/games/ludo/scripts/ + - assets/games/ludo/assets/ + - assets/games/flight/manifest.json + - assets/games/flight/scripts/ + - assets/games/showcase/manifest.json + - assets/games/showcase/scripts/ + - assets/games/showcase/assets/ + - assets/games/template/manifest.json + - assets/games/template/scripts/ + + uses-material-design: true diff --git a/example/pyrightconfig.json b/example/pyrightconfig.json new file mode 100644 index 0000000..0b6f292 --- /dev/null +++ b/example/pyrightconfig.json @@ -0,0 +1,11 @@ +{ + "reportMissingImports": "none", + "exclude": [ + "**/.dart_tool", + "**/build", + "ios/Flutter/ephemeral", + "macos/Flutter/ephemeral", + "windows/flutter/ephemeral", + "linux/flutter/ephemeral" + ] +} diff --git a/example/test/widget_test.dart b/example/test/widget_test.dart new file mode 100644 index 0000000..9e9f1fc --- /dev/null +++ b/example/test/widget_test.dart @@ -0,0 +1,10 @@ +import 'package:flutter_test/flutter_test.dart'; + +import 'package:flame_lua_runtime_example/main.dart'; + +void main() { + testWidgets('Flame Lua app builds', (tester) async { + await tester.pumpWidget(const FlameLuaRuntimeShowcaseApp()); + expect(find.byType(FlameLuaRuntimeShowcaseApp), findsOneWidget); + }); +} diff --git a/example/web/favicon.png b/example/web/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..8aaa46ac1ae21512746f852a42ba87e4165dfdd1 GIT binary patch literal 917 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|I14-?iy0X7 zltGxWVyS%@P(fs7NJL45ua8x7ey(0(N`6wRUPW#JP&EUCO@$SZnVVXYs8ErclUHn2 zVXFjIVFhG^g!Ppaz)DK8ZIvQ?0~DO|i&7O#^-S~(l1AfjnEK zjFOT9D}DX)@^Za$W4-*MbbUihOG|wNBYh(yU7!lx;>x^|#0uTKVr7USFmqf|i<65o z3raHc^AtelCMM;Vme?vOfh>Xph&xL%(-1c06+^uR^q@XSM&D4+Kp$>4P^%3{)XKjo zGZknv$b36P8?Z_gF{nK@`XI}Z90TzwSQO}0J1!f2c(B=V`5aP@1P1a|PZ!4!3&Gl8 zTYqUsf!gYFyJnXpu0!n&N*SYAX-%d(5gVjrHJWqXQshj@!Zm{!01WsQrH~9=kTxW#6SvuapgMqt>$=j#%eyGrQzr zP{L-3gsMA^$I1&gsBAEL+vxi1*Igl=8#8`5?A-T5=z-sk46WA1IUT)AIZHx1rdUrf zVJrJn<74DDw`j)Ki#gt}mIT-Q`XRa2-jQXQoI%w`nb|XblvzK${ZzlV)m-XcwC(od z71_OEC5Bt9GEXosOXaPTYOia#R4ID2TiU~`zVMl08TV_C%DnU4^+HE>9(CE4D6?Fz oujB08i7adh9xk7*FX66dWH6F5TM;?E2b5PlUHx3vIVCg!0Dx9vYXATM literal 0 HcmV?d00001 diff --git a/example/web/icons/Icon-192.png b/example/web/icons/Icon-192.png new file mode 100644 index 0000000000000000000000000000000000000000..b749bfef07473333cf1dd31e9eed89862a5d52aa GIT binary patch literal 5292 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 literal 0 HcmV?d00001 diff --git a/example/web/icons/Icon-512.png b/example/web/icons/Icon-512.png new file mode 100644 index 0000000000000000000000000000000000000000..88cfd48dff1169879ba46840804b412fe02fefd6 GIT binary patch literal 8252 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 literal 0 HcmV?d00001 diff --git a/example/web/icons/Icon-maskable-192.png b/example/web/icons/Icon-maskable-192.png new file mode 100644 index 0000000000000000000000000000000000000000..eb9b4d76e525556d5d89141648c724331630325d GIT binary patch literal 5594 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 X>c!)3PgKfL&lX^$Z>Cpu&6)6jvi^Z! literal 0 HcmV?d00001 diff --git a/example/web/icons/Icon-maskable-512.png b/example/web/icons/Icon-maskable-512.png new file mode 100644 index 0000000000000000000000000000000000000000..d69c56691fbdb0b7efa65097c7cc1edac12a6d3e GIT binary patch literal 20998 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 MPgg&ebxsLQ025IeI{*Lx literal 0 HcmV?d00001 diff --git a/example/web/index.html b/example/web/index.html new file mode 100644 index 0000000..f12e537 --- /dev/null +++ b/example/web/index.html @@ -0,0 +1,38 @@ + + + + + + + + + + + + + + + + + + + + flame_lua_runtime_showcase + + + + + + diff --git a/example/web/manifest.json b/example/web/manifest.json new file mode 100644 index 0000000..addb2fc --- /dev/null +++ b/example/web/manifest.json @@ -0,0 +1,35 @@ +{ + "name": "flame_lua_runtime_showcase", + "short_name": "flame_lua_runtime_showcase", + "start_url": ".", + "display": "standalone", + "background_color": "#0175C2", + "theme_color": "#0175C2", + "description": "Showcase app for the Flame Lua Runtime package.", + "orientation": "portrait-primary", + "prefer_related_applications": false, + "icons": [ + { + "src": "icons/Icon-192.png", + "sizes": "192x192", + "type": "image/png" + }, + { + "src": "icons/Icon-512.png", + "sizes": "512x512", + "type": "image/png" + }, + { + "src": "icons/Icon-maskable-192.png", + "sizes": "192x192", + "type": "image/png", + "purpose": "maskable" + }, + { + "src": "icons/Icon-maskable-512.png", + "sizes": "512x512", + "type": "image/png", + "purpose": "maskable" + } + ] +} diff --git a/example/windows/.gitignore b/example/windows/.gitignore new file mode 100644 index 0000000..d492d0d --- /dev/null +++ b/example/windows/.gitignore @@ -0,0 +1,17 @@ +flutter/ephemeral/ + +# Visual Studio user-specific files. +*.suo +*.user +*.userosscache +*.sln.docstates + +# Visual Studio build-related files. +x64/ +x86/ + +# Visual Studio cache files +# files ending in .cache can be ignored +*.[Cc]ache +# but keep track of directories ending in .cache +!*.[Cc]ache/ diff --git a/example/windows/CMakeLists.txt b/example/windows/CMakeLists.txt new file mode 100644 index 0000000..bb86186 --- /dev/null +++ b/example/windows/CMakeLists.txt @@ -0,0 +1,108 @@ +# Project-level configuration. +cmake_minimum_required(VERSION 3.14) +project(flame_lua_runtime_showcase LANGUAGES CXX) + +# The name of the executable created for the application. Change this to change +# the on-disk name of your application. +set(BINARY_NAME "flame_lua_runtime_showcase") + +# Explicitly opt in to modern CMake behaviors to avoid warnings with recent +# versions of CMake. +cmake_policy(VERSION 3.14...3.25) + +# Define build configuration option. +get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG) +if(IS_MULTICONFIG) + set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release" + CACHE STRING "" FORCE) +else() + if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) + set(CMAKE_BUILD_TYPE "Debug" CACHE + STRING "Flutter build mode" FORCE) + set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS + "Debug" "Profile" "Release") + endif() +endif() +# Define settings for the Profile build mode. +set(CMAKE_EXE_LINKER_FLAGS_PROFILE "${CMAKE_EXE_LINKER_FLAGS_RELEASE}") +set(CMAKE_SHARED_LINKER_FLAGS_PROFILE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE}") +set(CMAKE_C_FLAGS_PROFILE "${CMAKE_C_FLAGS_RELEASE}") +set(CMAKE_CXX_FLAGS_PROFILE "${CMAKE_CXX_FLAGS_RELEASE}") + +# Use Unicode for all projects. +add_definitions(-DUNICODE -D_UNICODE) + +# Compilation settings that should be applied to most targets. +# +# Be cautious about adding new options here, as plugins use this function by +# default. In most cases, you should add new options to specific targets instead +# of modifying this function. +function(APPLY_STANDARD_SETTINGS TARGET) + target_compile_features(${TARGET} PUBLIC cxx_std_17) + target_compile_options(${TARGET} PRIVATE /W4 /WX /wd"4100") + target_compile_options(${TARGET} PRIVATE /EHsc) + target_compile_definitions(${TARGET} PRIVATE "_HAS_EXCEPTIONS=0") + target_compile_definitions(${TARGET} PRIVATE "$<$:_DEBUG>") +endfunction() + +# Flutter library and tool build rules. +set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") +add_subdirectory(${FLUTTER_MANAGED_DIR}) + +# Application build; see runner/CMakeLists.txt. +add_subdirectory("runner") + + +# Generated plugin build rules, which manage building the plugins and adding +# them to the application. +include(flutter/generated_plugins.cmake) + + +# === Installation === +# Support files are copied into place next to the executable, so that it can +# run in place. This is done instead of making a separate bundle (as on Linux) +# so that building and running from within Visual Studio will work. +set(BUILD_BUNDLE_DIR "$") +# Make the "install" step default, as it's required to run. +set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1) +if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) + set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) +endif() + +set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") +set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}") + +install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + COMPONENT Runtime) + +install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +if(PLUGIN_BUNDLED_LIBRARIES) + install(FILES "${PLUGIN_BUNDLED_LIBRARIES}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) +endif() + +# Copy the native assets provided by the build.dart from all packages. +set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/") +install(DIRECTORY "${NATIVE_ASSETS_DIR}" + DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" + COMPONENT Runtime) + +# Fully re-copy the assets directory on each build to avoid having stale files +# from a previous install. +set(FLUTTER_ASSET_DIR_NAME "flutter_assets") +install(CODE " + file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") + " COMPONENT Runtime) +install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" + DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) + +# Install the AOT library on non-Debug builds only. +install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" + CONFIGURATIONS Profile;Release + COMPONENT Runtime) diff --git a/example/windows/flutter/CMakeLists.txt b/example/windows/flutter/CMakeLists.txt new file mode 100644 index 0000000..903f489 --- /dev/null +++ b/example/windows/flutter/CMakeLists.txt @@ -0,0 +1,109 @@ +# This file controls Flutter-level build steps. It should not be edited. +cmake_minimum_required(VERSION 3.14) + +set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") + +# Configuration provided via flutter tool. +include(${EPHEMERAL_DIR}/generated_config.cmake) + +# TODO: Move the rest of this into files in ephemeral. See +# https://github.com/flutter/flutter/issues/57146. +set(WRAPPER_ROOT "${EPHEMERAL_DIR}/cpp_client_wrapper") + +# Set fallback configurations for older versions of the flutter tool. +if (NOT DEFINED FLUTTER_TARGET_PLATFORM) + set(FLUTTER_TARGET_PLATFORM "windows-x64") +endif() + +# === Flutter Library === +set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll") + +# Published to parent scope for install step. +set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) +set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) +set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) +set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE) + +list(APPEND FLUTTER_LIBRARY_HEADERS + "flutter_export.h" + "flutter_windows.h" + "flutter_messenger.h" + "flutter_plugin_registrar.h" + "flutter_texture_registrar.h" +) +list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/") +add_library(flutter INTERFACE) +target_include_directories(flutter INTERFACE + "${EPHEMERAL_DIR}" +) +target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib") +add_dependencies(flutter flutter_assemble) + +# === Wrapper === +list(APPEND CPP_WRAPPER_SOURCES_CORE + "core_implementations.cc" + "standard_codec.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/") +list(APPEND CPP_WRAPPER_SOURCES_PLUGIN + "plugin_registrar.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/") +list(APPEND CPP_WRAPPER_SOURCES_APP + "flutter_engine.cc" + "flutter_view_controller.cc" +) +list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/") + +# Wrapper sources needed for a plugin. +add_library(flutter_wrapper_plugin STATIC + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_PLUGIN} +) +apply_standard_settings(flutter_wrapper_plugin) +set_target_properties(flutter_wrapper_plugin PROPERTIES + POSITION_INDEPENDENT_CODE ON) +set_target_properties(flutter_wrapper_plugin PROPERTIES + CXX_VISIBILITY_PRESET hidden) +target_link_libraries(flutter_wrapper_plugin PUBLIC flutter) +target_include_directories(flutter_wrapper_plugin PUBLIC + "${WRAPPER_ROOT}/include" +) +add_dependencies(flutter_wrapper_plugin flutter_assemble) + +# Wrapper sources needed for the runner. +add_library(flutter_wrapper_app STATIC + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_APP} +) +apply_standard_settings(flutter_wrapper_app) +target_link_libraries(flutter_wrapper_app PUBLIC flutter) +target_include_directories(flutter_wrapper_app PUBLIC + "${WRAPPER_ROOT}/include" +) +add_dependencies(flutter_wrapper_app flutter_assemble) + +# === Flutter tool backend === +# _phony_ is a non-existent file to force this command to run every time, +# since currently there's no way to get a full input/output list from the +# flutter tool. +set(PHONY_OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/_phony_") +set_source_files_properties("${PHONY_OUTPUT}" PROPERTIES SYMBOLIC TRUE) +add_custom_command( + OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} + ${CPP_WRAPPER_SOURCES_CORE} ${CPP_WRAPPER_SOURCES_PLUGIN} + ${CPP_WRAPPER_SOURCES_APP} + ${PHONY_OUTPUT} + COMMAND ${CMAKE_COMMAND} -E env + ${FLUTTER_TOOL_ENVIRONMENT} + "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.bat" + ${FLUTTER_TARGET_PLATFORM} $ + VERBATIM +) +add_custom_target(flutter_assemble DEPENDS + "${FLUTTER_LIBRARY}" + ${FLUTTER_LIBRARY_HEADERS} + ${CPP_WRAPPER_SOURCES_CORE} + ${CPP_WRAPPER_SOURCES_PLUGIN} + ${CPP_WRAPPER_SOURCES_APP} +) diff --git a/example/windows/flutter/generated_plugin_registrant.cc b/example/windows/flutter/generated_plugin_registrant.cc new file mode 100644 index 0000000..09e8e2c --- /dev/null +++ b/example/windows/flutter/generated_plugin_registrant.cc @@ -0,0 +1,14 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#include "generated_plugin_registrant.h" + +#include + +void RegisterPlugins(flutter::PluginRegistry* registry) { + AudioplayersWindowsPluginRegisterWithRegistrar( + registry->GetRegistrarForPlugin("AudioplayersWindowsPlugin")); +} diff --git a/example/windows/flutter/generated_plugin_registrant.h b/example/windows/flutter/generated_plugin_registrant.h new file mode 100644 index 0000000..dc139d8 --- /dev/null +++ b/example/windows/flutter/generated_plugin_registrant.h @@ -0,0 +1,15 @@ +// +// Generated file. Do not edit. +// + +// clang-format off + +#ifndef GENERATED_PLUGIN_REGISTRANT_ +#define GENERATED_PLUGIN_REGISTRANT_ + +#include + +// Registers Flutter plugins. +void RegisterPlugins(flutter::PluginRegistry* registry); + +#endif // GENERATED_PLUGIN_REGISTRANT_ diff --git a/example/windows/flutter/generated_plugins.cmake b/example/windows/flutter/generated_plugins.cmake new file mode 100644 index 0000000..1ada336 --- /dev/null +++ b/example/windows/flutter/generated_plugins.cmake @@ -0,0 +1,26 @@ +# +# Generated file, do not edit. +# + +list(APPEND FLUTTER_PLUGIN_LIST + audioplayers_windows +) + +list(APPEND FLUTTER_FFI_PLUGIN_LIST + jni + spine_flutter +) + +set(PLUGIN_BUNDLED_LIBRARIES) + +foreach(plugin ${FLUTTER_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/windows plugins/${plugin}) + target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) + list(APPEND PLUGIN_BUNDLED_LIBRARIES $) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) +endforeach(plugin) + +foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) + add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/windows plugins/${ffi_plugin}) + list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) +endforeach(ffi_plugin) diff --git a/example/windows/runner/CMakeLists.txt b/example/windows/runner/CMakeLists.txt new file mode 100644 index 0000000..394917c --- /dev/null +++ b/example/windows/runner/CMakeLists.txt @@ -0,0 +1,40 @@ +cmake_minimum_required(VERSION 3.14) +project(runner LANGUAGES CXX) + +# Define the application target. To change its name, change BINARY_NAME in the +# top-level CMakeLists.txt, not the value here, or `flutter run` will no longer +# work. +# +# Any new source files that you add to the application should be added here. +add_executable(${BINARY_NAME} WIN32 + "flutter_window.cpp" + "main.cpp" + "utils.cpp" + "win32_window.cpp" + "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" + "Runner.rc" + "runner.exe.manifest" +) + +# Apply the standard set of build settings. This can be removed for applications +# that need different build settings. +apply_standard_settings(${BINARY_NAME}) + +# Add preprocessor definitions for the build version. +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}") +target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}") + +# Disable Windows macros that collide with C++ standard library functions. +target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX") + +# Add dependency libraries and include directories. Add any application-specific +# dependencies here. +target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app) +target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib") +target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") + +# Run the Flutter tool portions of the build. This must not be removed. +add_dependencies(${BINARY_NAME} flutter_assemble) diff --git a/example/windows/runner/Runner.rc b/example/windows/runner/Runner.rc new file mode 100644 index 0000000..28c1728 --- /dev/null +++ b/example/windows/runner/Runner.rc @@ -0,0 +1,121 @@ +// Microsoft Visual C++ generated resource script. +// +#pragma code_page(65001) +#include "resource.h" + +#define APSTUDIO_READONLY_SYMBOLS +///////////////////////////////////////////////////////////////////////////// +// +// Generated from the TEXTINCLUDE 2 resource. +// +#include "winres.h" + +///////////////////////////////////////////////////////////////////////////// +#undef APSTUDIO_READONLY_SYMBOLS + +///////////////////////////////////////////////////////////////////////////// +// English (United States) resources + +#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU) +LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US + +#ifdef APSTUDIO_INVOKED +///////////////////////////////////////////////////////////////////////////// +// +// TEXTINCLUDE +// + +1 TEXTINCLUDE +BEGIN + "resource.h\0" +END + +2 TEXTINCLUDE +BEGIN + "#include ""winres.h""\r\n" + "\0" +END + +3 TEXTINCLUDE +BEGIN + "\r\n" + "\0" +END + +#endif // APSTUDIO_INVOKED + + +///////////////////////////////////////////////////////////////////////////// +// +// Icon +// + +// Icon with lowest ID value placed first to ensure application icon +// remains consistent on all systems. +IDI_APP_ICON ICON "resources\\app_icon.ico" + + +///////////////////////////////////////////////////////////////////////////// +// +// Version +// + +#if defined(FLUTTER_VERSION_MAJOR) && defined(FLUTTER_VERSION_MINOR) && defined(FLUTTER_VERSION_PATCH) && defined(FLUTTER_VERSION_BUILD) +#define VERSION_AS_NUMBER FLUTTER_VERSION_MAJOR,FLUTTER_VERSION_MINOR,FLUTTER_VERSION_PATCH,FLUTTER_VERSION_BUILD +#else +#define VERSION_AS_NUMBER 1,0,0,0 +#endif + +#if defined(FLUTTER_VERSION) +#define VERSION_AS_STRING FLUTTER_VERSION +#else +#define VERSION_AS_STRING "1.0.0" +#endif + +VS_VERSION_INFO VERSIONINFO + FILEVERSION VERSION_AS_NUMBER + PRODUCTVERSION VERSION_AS_NUMBER + FILEFLAGSMASK VS_FFI_FILEFLAGSMASK +#ifdef _DEBUG + FILEFLAGS VS_FF_DEBUG +#else + FILEFLAGS 0x0L +#endif + FILEOS VOS__WINDOWS32 + FILETYPE VFT_APP + FILESUBTYPE 0x0L +BEGIN + BLOCK "StringFileInfo" + BEGIN + BLOCK "040904e4" + BEGIN + VALUE "CompanyName", "com.example" "\0" + VALUE "FileDescription", "flame_lua_runtime_showcase" "\0" + VALUE "FileVersion", VERSION_AS_STRING "\0" + VALUE "InternalName", "flame_lua_runtime_showcase" "\0" + VALUE "LegalCopyright", "Copyright (C) 2026 com.example. All rights reserved." "\0" + VALUE "OriginalFilename", "flame_lua_runtime_showcase.exe" "\0" + VALUE "ProductName", "flame_lua_runtime_showcase" "\0" + VALUE "ProductVersion", VERSION_AS_STRING "\0" + END + END + BLOCK "VarFileInfo" + BEGIN + VALUE "Translation", 0x409, 1252 + END +END + +#endif // English (United States) resources +///////////////////////////////////////////////////////////////////////////// + + + +#ifndef APSTUDIO_INVOKED +///////////////////////////////////////////////////////////////////////////// +// +// Generated from the TEXTINCLUDE 3 resource. +// + + +///////////////////////////////////////////////////////////////////////////// +#endif // not APSTUDIO_INVOKED diff --git a/example/windows/runner/flutter_window.cpp b/example/windows/runner/flutter_window.cpp new file mode 100644 index 0000000..955ee30 --- /dev/null +++ b/example/windows/runner/flutter_window.cpp @@ -0,0 +1,71 @@ +#include "flutter_window.h" + +#include + +#include "flutter/generated_plugin_registrant.h" + +FlutterWindow::FlutterWindow(const flutter::DartProject& project) + : project_(project) {} + +FlutterWindow::~FlutterWindow() {} + +bool FlutterWindow::OnCreate() { + if (!Win32Window::OnCreate()) { + return false; + } + + RECT frame = GetClientArea(); + + // The size here must match the window dimensions to avoid unnecessary surface + // creation / destruction in the startup path. + flutter_controller_ = std::make_unique( + frame.right - frame.left, frame.bottom - frame.top, project_); + // Ensure that basic setup of the controller was successful. + if (!flutter_controller_->engine() || !flutter_controller_->view()) { + return false; + } + RegisterPlugins(flutter_controller_->engine()); + SetChildContent(flutter_controller_->view()->GetNativeWindow()); + + flutter_controller_->engine()->SetNextFrameCallback([&]() { + this->Show(); + }); + + // Flutter can complete the first frame before the "show window" callback is + // registered. The following call ensures a frame is pending to ensure the + // window is shown. It is a no-op if the first frame hasn't completed yet. + flutter_controller_->ForceRedraw(); + + return true; +} + +void FlutterWindow::OnDestroy() { + if (flutter_controller_) { + flutter_controller_ = nullptr; + } + + Win32Window::OnDestroy(); +} + +LRESULT +FlutterWindow::MessageHandler(HWND hwnd, UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + // Give Flutter, including plugins, an opportunity to handle window messages. + if (flutter_controller_) { + std::optional result = + flutter_controller_->HandleTopLevelWindowProc(hwnd, message, wparam, + lparam); + if (result) { + return *result; + } + } + + switch (message) { + case WM_FONTCHANGE: + flutter_controller_->engine()->ReloadSystemFonts(); + break; + } + + return Win32Window::MessageHandler(hwnd, message, wparam, lparam); +} diff --git a/example/windows/runner/flutter_window.h b/example/windows/runner/flutter_window.h new file mode 100644 index 0000000..6da0652 --- /dev/null +++ b/example/windows/runner/flutter_window.h @@ -0,0 +1,33 @@ +#ifndef RUNNER_FLUTTER_WINDOW_H_ +#define RUNNER_FLUTTER_WINDOW_H_ + +#include +#include + +#include + +#include "win32_window.h" + +// A window that does nothing but host a Flutter view. +class FlutterWindow : public Win32Window { + public: + // Creates a new FlutterWindow hosting a Flutter view running |project|. + explicit FlutterWindow(const flutter::DartProject& project); + virtual ~FlutterWindow(); + + protected: + // Win32Window: + bool OnCreate() override; + void OnDestroy() override; + LRESULT MessageHandler(HWND window, UINT const message, WPARAM const wparam, + LPARAM const lparam) noexcept override; + + private: + // The project to run. + flutter::DartProject project_; + + // The Flutter instance hosted by this window. + std::unique_ptr flutter_controller_; +}; + +#endif // RUNNER_FLUTTER_WINDOW_H_ diff --git a/example/windows/runner/main.cpp b/example/windows/runner/main.cpp new file mode 100644 index 0000000..2d4ad87 --- /dev/null +++ b/example/windows/runner/main.cpp @@ -0,0 +1,43 @@ +#include +#include +#include + +#include "flutter_window.h" +#include "utils.h" + +int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev, + _In_ wchar_t *command_line, _In_ int show_command) { + // Attach to console when present (e.g., 'flutter run') or create a + // new console when running with a debugger. + if (!::AttachConsole(ATTACH_PARENT_PROCESS) && ::IsDebuggerPresent()) { + CreateAndAttachConsole(); + } + + // Initialize COM, so that it is available for use in the library and/or + // plugins. + ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED); + + flutter::DartProject project(L"data"); + + std::vector command_line_arguments = + GetCommandLineArguments(); + + project.set_dart_entrypoint_arguments(std::move(command_line_arguments)); + + FlutterWindow window(project); + Win32Window::Point origin(10, 10); + Win32Window::Size size(1280, 720); + if (!window.Create(L"flame_lua_runtime_showcase", origin, size)) { + return EXIT_FAILURE; + } + window.SetQuitOnClose(true); + + ::MSG msg; + while (::GetMessage(&msg, nullptr, 0, 0)) { + ::TranslateMessage(&msg); + ::DispatchMessage(&msg); + } + + ::CoUninitialize(); + return EXIT_SUCCESS; +} diff --git a/example/windows/runner/resource.h b/example/windows/runner/resource.h new file mode 100644 index 0000000..66a65d1 --- /dev/null +++ b/example/windows/runner/resource.h @@ -0,0 +1,16 @@ +//{{NO_DEPENDENCIES}} +// Microsoft Visual C++ generated include file. +// Used by Runner.rc +// +#define IDI_APP_ICON 101 + +// Next default values for new objects +// +#ifdef APSTUDIO_INVOKED +#ifndef APSTUDIO_READONLY_SYMBOLS +#define _APS_NEXT_RESOURCE_VALUE 102 +#define _APS_NEXT_COMMAND_VALUE 40001 +#define _APS_NEXT_CONTROL_VALUE 1001 +#define _APS_NEXT_SYMED_VALUE 101 +#endif +#endif diff --git a/example/windows/runner/resources/app_icon.ico b/example/windows/runner/resources/app_icon.ico new file mode 100644 index 0000000000000000000000000000000000000000..c04e20caf6370ebb9253ad831cc31de4a9c965f6 GIT binary patch literal 33772 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 literal 0 HcmV?d00001 diff --git a/example/windows/runner/runner.exe.manifest b/example/windows/runner/runner.exe.manifest new file mode 100644 index 0000000..153653e --- /dev/null +++ b/example/windows/runner/runner.exe.manifest @@ -0,0 +1,14 @@ + + + + + PerMonitorV2 + + + + + + + + + diff --git a/example/windows/runner/utils.cpp b/example/windows/runner/utils.cpp new file mode 100644 index 0000000..3a0b465 --- /dev/null +++ b/example/windows/runner/utils.cpp @@ -0,0 +1,65 @@ +#include "utils.h" + +#include +#include +#include +#include + +#include + +void CreateAndAttachConsole() { + if (::AllocConsole()) { + FILE *unused; + if (freopen_s(&unused, "CONOUT$", "w", stdout)) { + _dup2(_fileno(stdout), 1); + } + if (freopen_s(&unused, "CONOUT$", "w", stderr)) { + _dup2(_fileno(stdout), 2); + } + std::ios::sync_with_stdio(); + FlutterDesktopResyncOutputStreams(); + } +} + +std::vector GetCommandLineArguments() { + // Convert the UTF-16 command line arguments to UTF-8 for the Engine to use. + int argc; + wchar_t** argv = ::CommandLineToArgvW(::GetCommandLineW(), &argc); + if (argv == nullptr) { + return std::vector(); + } + + std::vector command_line_arguments; + + // Skip the first argument as it's the binary name. + for (int i = 1; i < argc; i++) { + command_line_arguments.push_back(Utf8FromUtf16(argv[i])); + } + + ::LocalFree(argv); + + return command_line_arguments; +} + +std::string Utf8FromUtf16(const wchar_t* utf16_string) { + if (utf16_string == nullptr) { + return std::string(); + } + unsigned int target_length = ::WideCharToMultiByte( + CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, + -1, nullptr, 0, nullptr, nullptr) + -1; // remove the trailing null character + int input_length = (int)wcslen(utf16_string); + std::string utf8_string; + if (target_length == 0 || target_length > utf8_string.max_size()) { + return utf8_string; + } + utf8_string.resize(target_length); + int converted_length = ::WideCharToMultiByte( + CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, + input_length, utf8_string.data(), target_length, nullptr, nullptr); + if (converted_length == 0) { + return std::string(); + } + return utf8_string; +} diff --git a/example/windows/runner/utils.h b/example/windows/runner/utils.h new file mode 100644 index 0000000..3879d54 --- /dev/null +++ b/example/windows/runner/utils.h @@ -0,0 +1,19 @@ +#ifndef RUNNER_UTILS_H_ +#define RUNNER_UTILS_H_ + +#include +#include + +// Creates a console for the process, and redirects stdout and stderr to +// it for both the runner and the Flutter library. +void CreateAndAttachConsole(); + +// Takes a null-terminated wchar_t* encoded in UTF-16 and returns a std::string +// encoded in UTF-8. Returns an empty std::string on failure. +std::string Utf8FromUtf16(const wchar_t* utf16_string); + +// Gets the command line arguments passed in as a std::vector, +// encoded in UTF-8. Returns an empty std::vector on failure. +std::vector GetCommandLineArguments(); + +#endif // RUNNER_UTILS_H_ diff --git a/example/windows/runner/win32_window.cpp b/example/windows/runner/win32_window.cpp new file mode 100644 index 0000000..60608d0 --- /dev/null +++ b/example/windows/runner/win32_window.cpp @@ -0,0 +1,288 @@ +#include "win32_window.h" + +#include +#include + +#include "resource.h" + +namespace { + +/// Window attribute that enables dark mode window decorations. +/// +/// Redefined in case the developer's machine has a Windows SDK older than +/// version 10.0.22000.0. +/// See: https://docs.microsoft.com/windows/win32/api/dwmapi/ne-dwmapi-dwmwindowattribute +#ifndef DWMWA_USE_IMMERSIVE_DARK_MODE +#define DWMWA_USE_IMMERSIVE_DARK_MODE 20 +#endif + +constexpr const wchar_t kWindowClassName[] = L"FLUTTER_RUNNER_WIN32_WINDOW"; + +/// Registry key for app theme preference. +/// +/// A value of 0 indicates apps should use dark mode. A non-zero or missing +/// value indicates apps should use light mode. +constexpr const wchar_t kGetPreferredBrightnessRegKey[] = + L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize"; +constexpr const wchar_t kGetPreferredBrightnessRegValue[] = L"AppsUseLightTheme"; + +// The number of Win32Window objects that currently exist. +static int g_active_window_count = 0; + +using EnableNonClientDpiScaling = BOOL __stdcall(HWND hwnd); + +// Scale helper to convert logical scaler values to physical using passed in +// scale factor +int Scale(int source, double scale_factor) { + return static_cast(source * scale_factor); +} + +// Dynamically loads the |EnableNonClientDpiScaling| from the User32 module. +// This API is only needed for PerMonitor V1 awareness mode. +void EnableFullDpiSupportIfAvailable(HWND hwnd) { + HMODULE user32_module = LoadLibraryA("User32.dll"); + if (!user32_module) { + return; + } + auto enable_non_client_dpi_scaling = + reinterpret_cast( + GetProcAddress(user32_module, "EnableNonClientDpiScaling")); + if (enable_non_client_dpi_scaling != nullptr) { + enable_non_client_dpi_scaling(hwnd); + } + FreeLibrary(user32_module); +} + +} // namespace + +// Manages the Win32Window's window class registration. +class WindowClassRegistrar { + public: + ~WindowClassRegistrar() = default; + + // Returns the singleton registrar instance. + static WindowClassRegistrar* GetInstance() { + if (!instance_) { + instance_ = new WindowClassRegistrar(); + } + return instance_; + } + + // Returns the name of the window class, registering the class if it hasn't + // previously been registered. + const wchar_t* GetWindowClass(); + + // Unregisters the window class. Should only be called if there are no + // instances of the window. + void UnregisterWindowClass(); + + private: + WindowClassRegistrar() = default; + + static WindowClassRegistrar* instance_; + + bool class_registered_ = false; +}; + +WindowClassRegistrar* WindowClassRegistrar::instance_ = nullptr; + +const wchar_t* WindowClassRegistrar::GetWindowClass() { + if (!class_registered_) { + WNDCLASS window_class{}; + window_class.hCursor = LoadCursor(nullptr, IDC_ARROW); + window_class.lpszClassName = kWindowClassName; + window_class.style = CS_HREDRAW | CS_VREDRAW; + window_class.cbClsExtra = 0; + window_class.cbWndExtra = 0; + window_class.hInstance = GetModuleHandle(nullptr); + window_class.hIcon = + LoadIcon(window_class.hInstance, MAKEINTRESOURCE(IDI_APP_ICON)); + window_class.hbrBackground = 0; + window_class.lpszMenuName = nullptr; + window_class.lpfnWndProc = Win32Window::WndProc; + RegisterClass(&window_class); + class_registered_ = true; + } + return kWindowClassName; +} + +void WindowClassRegistrar::UnregisterWindowClass() { + UnregisterClass(kWindowClassName, nullptr); + class_registered_ = false; +} + +Win32Window::Win32Window() { + ++g_active_window_count; +} + +Win32Window::~Win32Window() { + --g_active_window_count; + Destroy(); +} + +bool Win32Window::Create(const std::wstring& title, + const Point& origin, + const Size& size) { + Destroy(); + + const wchar_t* window_class = + WindowClassRegistrar::GetInstance()->GetWindowClass(); + + const POINT target_point = {static_cast(origin.x), + static_cast(origin.y)}; + HMONITOR monitor = MonitorFromPoint(target_point, MONITOR_DEFAULTTONEAREST); + UINT dpi = FlutterDesktopGetDpiForMonitor(monitor); + double scale_factor = dpi / 96.0; + + HWND window = CreateWindow( + window_class, title.c_str(), WS_OVERLAPPEDWINDOW, + Scale(origin.x, scale_factor), Scale(origin.y, scale_factor), + Scale(size.width, scale_factor), Scale(size.height, scale_factor), + nullptr, nullptr, GetModuleHandle(nullptr), this); + + if (!window) { + return false; + } + + UpdateTheme(window); + + return OnCreate(); +} + +bool Win32Window::Show() { + return ShowWindow(window_handle_, SW_SHOWNORMAL); +} + +// static +LRESULT CALLBACK Win32Window::WndProc(HWND const window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + if (message == WM_NCCREATE) { + auto window_struct = reinterpret_cast(lparam); + SetWindowLongPtr(window, GWLP_USERDATA, + reinterpret_cast(window_struct->lpCreateParams)); + + auto that = static_cast(window_struct->lpCreateParams); + EnableFullDpiSupportIfAvailable(window); + that->window_handle_ = window; + } else if (Win32Window* that = GetThisFromHandle(window)) { + return that->MessageHandler(window, message, wparam, lparam); + } + + return DefWindowProc(window, message, wparam, lparam); +} + +LRESULT +Win32Window::MessageHandler(HWND hwnd, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept { + switch (message) { + case WM_DESTROY: + window_handle_ = nullptr; + Destroy(); + if (quit_on_close_) { + PostQuitMessage(0); + } + return 0; + + case WM_DPICHANGED: { + auto newRectSize = reinterpret_cast(lparam); + LONG newWidth = newRectSize->right - newRectSize->left; + LONG newHeight = newRectSize->bottom - newRectSize->top; + + SetWindowPos(hwnd, nullptr, newRectSize->left, newRectSize->top, newWidth, + newHeight, SWP_NOZORDER | SWP_NOACTIVATE); + + return 0; + } + case WM_SIZE: { + RECT rect = GetClientArea(); + if (child_content_ != nullptr) { + // Size and position the child window. + MoveWindow(child_content_, rect.left, rect.top, rect.right - rect.left, + rect.bottom - rect.top, TRUE); + } + return 0; + } + + case WM_ACTIVATE: + if (child_content_ != nullptr) { + SetFocus(child_content_); + } + return 0; + + case WM_DWMCOLORIZATIONCOLORCHANGED: + UpdateTheme(hwnd); + return 0; + } + + return DefWindowProc(window_handle_, message, wparam, lparam); +} + +void Win32Window::Destroy() { + OnDestroy(); + + if (window_handle_) { + DestroyWindow(window_handle_); + window_handle_ = nullptr; + } + if (g_active_window_count == 0) { + WindowClassRegistrar::GetInstance()->UnregisterWindowClass(); + } +} + +Win32Window* Win32Window::GetThisFromHandle(HWND const window) noexcept { + return reinterpret_cast( + GetWindowLongPtr(window, GWLP_USERDATA)); +} + +void Win32Window::SetChildContent(HWND content) { + child_content_ = content; + SetParent(content, window_handle_); + RECT frame = GetClientArea(); + + MoveWindow(content, frame.left, frame.top, frame.right - frame.left, + frame.bottom - frame.top, true); + + SetFocus(child_content_); +} + +RECT Win32Window::GetClientArea() { + RECT frame; + GetClientRect(window_handle_, &frame); + return frame; +} + +HWND Win32Window::GetHandle() { + return window_handle_; +} + +void Win32Window::SetQuitOnClose(bool quit_on_close) { + quit_on_close_ = quit_on_close; +} + +bool Win32Window::OnCreate() { + // No-op; provided for subclasses. + return true; +} + +void Win32Window::OnDestroy() { + // No-op; provided for subclasses. +} + +void Win32Window::UpdateTheme(HWND const window) { + DWORD light_mode; + DWORD light_mode_size = sizeof(light_mode); + LSTATUS result = RegGetValue(HKEY_CURRENT_USER, kGetPreferredBrightnessRegKey, + kGetPreferredBrightnessRegValue, + RRF_RT_REG_DWORD, nullptr, &light_mode, + &light_mode_size); + + if (result == ERROR_SUCCESS) { + BOOL enable_dark_mode = light_mode == 0; + DwmSetWindowAttribute(window, DWMWA_USE_IMMERSIVE_DARK_MODE, + &enable_dark_mode, sizeof(enable_dark_mode)); + } +} diff --git a/example/windows/runner/win32_window.h b/example/windows/runner/win32_window.h new file mode 100644 index 0000000..e901dde --- /dev/null +++ b/example/windows/runner/win32_window.h @@ -0,0 +1,102 @@ +#ifndef RUNNER_WIN32_WINDOW_H_ +#define RUNNER_WIN32_WINDOW_H_ + +#include + +#include +#include +#include + +// A class abstraction for a high DPI-aware Win32 Window. Intended to be +// inherited from by classes that wish to specialize with custom +// rendering and input handling +class Win32Window { + public: + struct Point { + unsigned int x; + unsigned int y; + Point(unsigned int x, unsigned int y) : x(x), y(y) {} + }; + + struct Size { + unsigned int width; + unsigned int height; + Size(unsigned int width, unsigned int height) + : width(width), height(height) {} + }; + + Win32Window(); + virtual ~Win32Window(); + + // Creates a win32 window with |title| that is positioned and sized using + // |origin| and |size|. New windows are created on the default monitor. Window + // sizes are specified to the OS in physical pixels, hence to ensure a + // consistent size this function will scale the inputted width and height as + // as appropriate for the default monitor. The window is invisible until + // |Show| is called. Returns true if the window was created successfully. + bool Create(const std::wstring& title, const Point& origin, const Size& size); + + // Show the current window. Returns true if the window was successfully shown. + bool Show(); + + // Release OS resources associated with window. + void Destroy(); + + // Inserts |content| into the window tree. + void SetChildContent(HWND content); + + // Returns the backing Window handle to enable clients to set icon and other + // window properties. Returns nullptr if the window has been destroyed. + HWND GetHandle(); + + // If true, closing this window will quit the application. + void SetQuitOnClose(bool quit_on_close); + + // Return a RECT representing the bounds of the current client area. + RECT GetClientArea(); + + protected: + // Processes and route salient window messages for mouse handling, + // size change and DPI. Delegates handling of these to member overloads that + // inheriting classes can handle. + virtual LRESULT MessageHandler(HWND window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept; + + // Called when CreateAndShow is called, allowing subclass window-related + // setup. Subclasses should return false if setup fails. + virtual bool OnCreate(); + + // Called when Destroy is called. + virtual void OnDestroy(); + + private: + friend class WindowClassRegistrar; + + // OS callback called by message pump. Handles the WM_NCCREATE message which + // is passed when the non-client area is being created and enables automatic + // non-client DPI scaling so that the non-client area automatically + // responds to changes in DPI. All other messages are handled by + // MessageHandler. + static LRESULT CALLBACK WndProc(HWND const window, + UINT const message, + WPARAM const wparam, + LPARAM const lparam) noexcept; + + // Retrieves a class instance pointer for |window| + static Win32Window* GetThisFromHandle(HWND const window) noexcept; + + // Update the window frame's theme to match the system theme. + static void UpdateTheme(HWND const window); + + bool quit_on_close_ = false; + + // window handle for top level window. + HWND window_handle_ = nullptr; + + // window handle for hosted content. + HWND child_content_ = nullptr; +}; + +#endif // RUNNER_WIN32_WINDOW_H_ diff --git a/lib/flame_lua_runtime.dart b/lib/flame_lua_runtime.dart new file mode 100644 index 0000000..65e20df --- /dev/null +++ b/lib/flame_lua_runtime.dart @@ -0,0 +1,14 @@ +library; + +export 'runtime/game/flame_lua_game.dart' show FlameLuaGame; +export 'runtime/game/lua_game_widget.dart' show LuaGameWidget; +export 'runtime/game/runtime_locale.dart' show RuntimeLocaleResolver; +export 'runtime/game/runtime_options.dart' show RuntimeOptions; +export 'runtime/packages/game_package_repository.dart' + show + AssetGamePackageRepository, + GamePackageRepository, + RemoteGamePackageRepository; +export 'runtime/scripting/lua_dardo_script_engine.dart' + show LuaDardoScriptEngine; +export 'runtime/scripting/script_engine.dart' show ScriptEngine; diff --git a/lib/runtime/audio/runtime_audio_cache.dart b/lib/runtime/audio/runtime_audio_cache.dart new file mode 100644 index 0000000..219c737 --- /dev/null +++ b/lib/runtime/audio/runtime_audio_cache.dart @@ -0,0 +1,90 @@ +part of 'runtime_audio_manager.dart'; + +extension _RuntimeAudioManagerCache on RuntimeAudioManager { + void _releaseCachedAudio() { + _loadLimiter.clearPending(); + for (final path in _audios.keys.toList(growable: false)) { + _removeAudioRecord(path); + } + + _channels.clear(); + final players = _players.toList(growable: false); + _players.clear(); + final pooledPlayers = _sfxPool.toList(growable: false); + _sfxPool.clear(); + for (final player in [...players, ...pooledPlayers]) { + player.dispose(); + } + } + + RuntimeAudioPlayer _takeSfxPlayer() { + if (_sfxPool.isNotEmpty) { + return _sfxPool.removeLast(); + } + return _playerFactory(); + } + + Future _releaseSfxPlayer(RuntimeAudioPlayer player) async { + if (_disposed || _sfxPool.length >= _maxSfxPoolSize) { + await player.dispose(); + return; + } + _sfxPool.add(player); + } + + void _touch(_AudioResourceRecord record) { + record.lastUsed = ++_accessCounter; + } + + void _enforceAudioBudget() { + while (_isOverBudget()) { + final victim = _leastRecentlyUsedAudio(); + if (victim == null || !_removeAudioRecord(victim)) { + return; + } + } + } + + bool _isOverBudget() { + final maxBytes = _maxCacheBytes; + final maxEntries = _maxCacheEntries; + return (maxBytes != null && _cacheBytes > maxBytes) || + (maxEntries != null && _readyAudioCount > maxEntries); + } + + int get _readyAudioCount => _audios.values + .where((record) => record.state == GameResourceState.ready) + .length; + + String? _leastRecentlyUsedAudio() { + String? victimPath; + _AudioResourceRecord? victim; + for (final entry in _audios.entries) { + final record = entry.value; + if (record.state != GameResourceState.ready) { + continue; + } + if (victim == null || record.lastUsed < victim.lastUsed) { + victim = record; + victimPath = entry.key; + } + } + return victimPath; + } + + bool _removeAudioRecord(String path) { + final record = _audios.remove(path); + if (record == null) { + return false; + } + _cacheBytes -= record.bytes?.length ?? 0; + if (_cacheBytes < 0) { + _cacheBytes = 0; + } + record + ..state = GameResourceState.disposed + ..bytes = null + ..inflight = null; + return true; + } +} diff --git a/lib/runtime/audio/runtime_audio_debug.dart b/lib/runtime/audio/runtime_audio_debug.dart new file mode 100644 index 0000000..c9c7e80 --- /dev/null +++ b/lib/runtime/audio/runtime_audio_debug.dart @@ -0,0 +1,27 @@ +part of 'runtime_audio_manager.dart'; + +extension _RuntimeAudioManagerDebug on RuntimeAudioManager { + Map _audioRecordDebugJson({ + required String? key, + required String path, + required String? preload, + required bool declared, + }) { + final record = _audios[path]; + return { + if (key != null) 'key': key, + 'path': path, + 'type': GameResourceType.audio, + 'declared': declared, + if (preload != null) 'preload': preload, + if (key != null && _package?.manifest.resources[key]?.group != null) + 'group': _package?.manifest.resources[key]?.group, + 'state': (record?.state ?? GameResourceState.idle).name, + if (record != null) 'generation': record.generation, + 'loading': record?.inflight != null, + 'ready': record?.bytes != null, + if (record?.bytes != null) 'bytes': record!.bytes!.length, + if (record?.lastError != null) 'error': record!.lastError.toString(), + }; + } +} diff --git a/lib/runtime/audio/runtime_audio_loading.dart b/lib/runtime/audio/runtime_audio_loading.dart new file mode 100644 index 0000000..5088535 --- /dev/null +++ b/lib/runtime/audio/runtime_audio_loading.dart @@ -0,0 +1,124 @@ +part of 'runtime_audio_manager.dart'; + +extension _RuntimeAudioManagerLoading on RuntimeAudioManager { + Future _loadAudio( + String? keyOrPath, { + required bool failOnError, + }) { + if (keyOrPath == null || keyOrPath.isEmpty) { + return Future.value(null); + } + + final requestToken = _asyncGate.token; + final requestGeneration = requestToken.generation; + final path = _tryResolve(keyOrPath); + if (path == null) { + return Future.value(null); + } + + final existing = _audios[path]; + if (existing != null) { + final bytes = existing.bytes; + if (existing.generation == requestGeneration && + existing.state == GameResourceState.ready && + bytes != null) { + _touch(existing); + return Future.value(bytes); + } + final inflight = existing.inflight; + if (existing.generation == requestGeneration && inflight != null) { + return failOnError + ? _throwIfNull(inflight, keyOrPath) + : inflight.catchError((_) => null); + } + } + + final record = _AudioResourceRecord(generation: requestGeneration) + ..state = GameResourceState.loading; + _audios[path] = record; + + final future = _readAudio(path, record, requestToken); + record.inflight = future; + return failOnError ? _throwIfNull(future, keyOrPath) : future; + } + + Future _throwIfNull( + Future future, + String keyOrPath, + ) async { + final bytes = await future; + if (bytes == null) { + throw ResourceLoadException('Required audio resource failed: $keyOrPath'); + } + return bytes; + } + + Future _readAudio( + String path, + _AudioResourceRecord record, + RuntimeAsyncToken requestToken, + ) async { + try { + final activePackage = _package; + if (activePackage == null) { + throw StateError('RuntimeAudioManager has no active package'); + } + + final ownedBytes = await _loadLimiter.run(() async { + final data = await activePackage.readBytes(path); + final bytes = data.buffer.asUint8List( + data.offsetInBytes, + data.lengthInBytes, + ); + return Uint8List.fromList(bytes); + }); + record.inflight = null; + + if (_disposed || + !_asyncGate.accepts(requestToken) || + _audios[path] != record) { + record.state = GameResourceState.disposed; + return null; + } + + record + ..bytes = ownedBytes + ..state = GameResourceState.ready + ..lastError = null; + _cacheBytes += ownedBytes.length; + _touch(record); + _enforceAudioBudget(); + return ownedBytes; + } catch (error) { + record.inflight = null; + if (_disposed || + !_asyncGate.accepts(requestToken) || + _audios[path] != record) { + record.state = GameResourceState.disposed; + return null; + } + record + ..state = GameResourceState.failed + ..lastError = error; + _diagnostics?.record( + type: RuntimeDiagnosticType.resourceLoadError, + message: 'Audio resource failed to load', + error: error, + context: {'path': path, 'generation': requestToken.generation}, + ); + return null; + } + } + + String? _tryResolve(String keyOrPath) { + try { + final activePackage = _package; + if (activePackage == null) { + return null; + } + return activePackage.resolveResourcePath(keyOrPath); + } catch (_) { + return null; + } + } +} diff --git a/lib/runtime/audio/runtime_audio_manager.dart b/lib/runtime/audio/runtime_audio_manager.dart new file mode 100644 index 0000000..1a86091 --- /dev/null +++ b/lib/runtime/audio/runtime_audio_manager.dart @@ -0,0 +1,352 @@ +import 'dart:typed_data'; + +import '../diagnostics/runtime_diagnostics.dart'; +import '../lifecycle/runtime_async_gate.dart'; +import '../packages/game_package.dart'; +import '../packages/game_package_manifest.dart'; +import '../resources/game_resource_manager.dart'; +import '../resources/resource_load_limiter.dart'; +import 'runtime_audio_player.dart'; + +// These part files only group RuntimeAudioManager private helpers. The public +// facade stays in RuntimeAudioManager so callers do not depend on extensions. +part 'runtime_audio_loading.dart'; +part 'runtime_audio_debug.dart'; +part 'runtime_audio_cache.dart'; + +class RuntimeAudioManager { + RuntimeAudioManager({ + RuntimeDiagnostics? diagnostics, + RuntimeAudioPlayer Function()? playerFactory, + int maxSfxPoolSize = 8, + int? maxCacheBytes, + int? maxCacheEntries, + int maxConcurrentLoads = 4, + }) : _diagnostics = diagnostics, + _playerFactory = playerFactory ?? AudioplayersRuntimeAudioPlayer.new, + _maxSfxPoolSize = maxSfxPoolSize, + _maxCacheBytes = maxCacheBytes, + _maxCacheEntries = maxCacheEntries, + _loadLimiter = ResourceLoadLimiter(maxConcurrentLoads); + + final RuntimeDiagnostics? _diagnostics; + final RuntimeAudioPlayer Function() _playerFactory; + final int _maxSfxPoolSize; + final int? _maxCacheBytes; + final int? _maxCacheEntries; + final ResourceLoadLimiter _loadLimiter; + final RuntimeAsyncGate _asyncGate = RuntimeAsyncGate(initiallyClosed: true); + final Map _audios = {}; + final Set _players = {}; + final Map _channels = {}; + final List _sfxPool = []; + GamePackage? _package; + int _cacheBytes = 0; + int _accessCounter = 0; + bool _disposed = false; + + int get generation => _asyncGate.generation; + + bool get hasPackage => _package != null; + + Future mount(GamePackage package) async { + _releaseCachedAudio(); + _asyncGate.activate(); + _disposed = false; + _package = package; + await preloadDeclaredAudio(package.manifest); + } + + void dispose() { + _disposed = true; + _asyncGate.close(); + _releaseCachedAudio(); + _package = null; + } + + GameResourceState audioState(String keyOrPath) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return GameResourceState.failed; + } + return _audios[path]?.state ?? GameResourceState.idle; + } + + Object? audioError(String keyOrPath) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return StateError('RuntimeAudioManager has no active package'); + } + return _audios[path]?.lastError; + } + + Map audioDebugJson() { + final activePackage = _package; + final declaredPaths = {}; + final resources = >[]; + + if (activePackage != null) { + for (final entry in activePackage.manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.audio) { + continue; + } + final path = activePackage.resolveResourcePath(entry.key); + declaredPaths.add(path); + resources.add( + _audioRecordDebugJson( + key: entry.key, + path: path, + preload: resource.preload, + declared: true, + ), + ); + } + } + + for (final path in _audios.keys) { + if (declaredPaths.contains(path)) { + continue; + } + resources.add( + _audioRecordDebugJson( + key: null, + path: path, + preload: null, + declared: false, + ), + ); + } + + return { + 'generation': generation, + 'hasPackage': activePackage != null, + 'count': resources.length, + 'activeLoads': _loadLimiter.activeCount, + 'pendingLoads': _loadLimiter.pendingCount, + 'activePlayers': _players.length, + 'pooledPlayers': _sfxPool.length, + 'channels': _channels.keys.toList(growable: false)..sort(), + 'resources': resources, + }; + } + + bool evictAudio(String keyOrPath) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return false; + } + return _removeAudioRecord(path); + } + + Future retryAudio(String keyOrPath) async { + evictAudio(keyOrPath); + final bytes = await _loadAudio(keyOrPath, failOnError: false); + return bytes != null; + } + + Future preloadDeclaredAudio(GamePackageManifest manifest) async { + final futures = >[]; + for (final entry in manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.audio || + resource.preload == GameResourcePreload.lazy) { + continue; + } + + final failOnError = resource.preload == GameResourcePreload.required; + futures.add(_loadAudio(entry.key, failOnError: failOnError).then((_) {})); + } + await Future.wait(futures); + } + + Future play( + String? keyOrPath, { + double volume = 1, + }) async { + if (_disposed) { + return null; + } + final bytes = await _loadAudio(keyOrPath, failOnError: false); + if (_disposed || bytes == null) { + return null; + } + + final player = _takeSfxPlayer(); + _players.add(player); + try { + await player.start(bytes, volume: volume); + } catch (error) { + _players.remove(player); + await player.dispose(); + _diagnostics?.record( + type: RuntimeDiagnosticType.resourceLoadError, + message: 'Audio resource failed to play', + error: error, + context: {'resource': keyOrPath, 'generation': generation}, + ); + return null; + } + + final playback = RuntimeAudioPlayback._(player, player.done); + playback.done.whenComplete(() async { + _players.remove(player); + if (playback.isCancelled) { + await player.dispose(); + return; + } + await _releaseSfxPlayer(player); + }); + return playback; + } + + Future playBgm( + String? keyOrPath, { + String channel = RuntimeAudioChannel.defaultBgm, + double volume = 1, + bool loop = true, + }) async { + if (_disposed) { + return null; + } + final bytes = await _loadAudio(keyOrPath, failOnError: false); + if (_disposed || bytes == null) { + return null; + } + + await stopBgm(channel: channel); + if (_disposed) { + return null; + } + + final player = _playerFactory(); + _players.add(player); + try { + await player.start(bytes, volume: volume, loop: loop); + } catch (error) { + _players.remove(player); + await player.dispose(); + _diagnostics?.record( + type: RuntimeDiagnosticType.resourceLoadError, + message: 'BGM resource failed to play', + error: error, + context: { + 'resource': keyOrPath, + 'channel': channel, + 'generation': generation, + }, + ); + return null; + } + + final playback = RuntimeAudioPlayback._(player, player.done); + _channels[channel] = playback; + playback.done.whenComplete(() async { + if (_channels[channel] == playback) { + _channels.remove(channel); + } + _players.remove(player); + await player.dispose(); + }); + return playback; + } + + Future pauseBgm({String channel = RuntimeAudioChannel.defaultBgm}) { + return _channels[channel]?.pause() ?? Future.value(); + } + + Future resumeBgm({String channel = RuntimeAudioChannel.defaultBgm}) { + return _channels[channel]?.resume() ?? Future.value(); + } + + Future stopBgm({ + String channel = RuntimeAudioChannel.defaultBgm, + }) async { + final playback = _channels.remove(channel); + await playback?.stop(); + } + + bool hasBgm({String channel = RuntimeAudioChannel.defaultBgm}) { + return _channels.containsKey(channel); + } + + Future preloadGroup(String group, {bool failOnError = false}) async { + final activePackage = _package; + if (activePackage == null) { + throw StateError('RuntimeAudioManager has no active package'); + } + final futures = >[]; + for (final entry in activePackage.manifest.resources.entries) { + final resource = entry.value; + if (resource.type == GameResourceType.audio && resource.group == group) { + futures.add( + _loadAudio(entry.key, failOnError: failOnError).then((_) {}), + ); + } + } + await Future.wait(futures); + } + + int evictGroup(String group) { + final activePackage = _package; + if (activePackage == null) { + return 0; + } + var count = 0; + for (final entry in activePackage.manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.audio || resource.group != group) { + continue; + } + final path = activePackage.resolveResourcePath(entry.key); + if (_removeAudioRecord(path)) { + count++; + } + } + return count; + } +} + +abstract final class RuntimeAudioChannel { + static const defaultBgm = 'bgm'; +} + +class RuntimeAudioPlayback { + RuntimeAudioPlayback._(this._player, this.done); + + final RuntimeAudioPlayer _player; + bool _cancelled = false; + + final Future done; + + bool get isCancelled => _cancelled; + + Future pause() { + return _player.pause(); + } + + Future resume() { + return _player.resume(); + } + + Future stop() async { + _cancelled = true; + await _player.stop(); + } + + Future cancel() async { + _cancelled = true; + await _player.dispose(); + } +} + +class _AudioResourceRecord { + _AudioResourceRecord({required this.generation}); + + final int generation; + GameResourceState state = GameResourceState.idle; + Future? inflight; + Uint8List? bytes; + Object? lastError; + int lastUsed = 0; +} diff --git a/lib/runtime/audio/runtime_audio_player.dart b/lib/runtime/audio/runtime_audio_player.dart new file mode 100644 index 0000000..eea1201 --- /dev/null +++ b/lib/runtime/audio/runtime_audio_player.dart @@ -0,0 +1,99 @@ +import 'dart:async' as async; +import 'dart:typed_data'; + +import 'package:audioplayers/audioplayers.dart'; + +abstract class RuntimeAudioPlayer { + Future start( + Uint8List bytes, { + required double volume, + bool loop = false, + }); + + Future pause(); + + Future resume(); + + Future stop(); + + Future get done; + + Future dispose(); +} + +class AudioplayersRuntimeAudioPlayer implements RuntimeAudioPlayer { + AudioplayersRuntimeAudioPlayer({AudioPlayer? player}) + : _player = player ?? AudioPlayer(); + + final AudioPlayer _player; + async.Completer _done = async.Completer(); + async.StreamSubscription? _completionSubscription; + bool _disposed = false; + + @override + Future get done => _done.future; + + @override + Future start( + Uint8List bytes, { + required double volume, + bool loop = false, + }) async { + if (_disposed) { + return; + } + await _completionSubscription?.cancel(); + _completionSubscription = null; + if (_done.isCompleted) { + _done = async.Completer(); + } + _completionSubscription = _player.onPlayerComplete.listen((_) { + _completeDone(); + }); + await _player.setReleaseMode(loop ? ReleaseMode.loop : ReleaseMode.release); + await _player.play(BytesSource(bytes), volume: volume); + } + + @override + Future pause() async { + if (_disposed) { + return; + } + await _player.pause(); + } + + @override + Future resume() async { + if (_disposed) { + return; + } + await _player.resume(); + } + + @override + Future stop() async { + if (_disposed) { + return; + } + await _player.stop(); + _completeDone(); + } + + @override + Future dispose() async { + if (_disposed) { + return; + } + _disposed = true; + await _completionSubscription?.cancel(); + _completionSubscription = null; + await _player.dispose(); + _completeDone(); + } + + void _completeDone() { + if (!_done.isCompleted) { + _done.complete(); + } + } +} diff --git a/lib/runtime/commands/command_audio.dart b/lib/runtime/commands/command_audio.dart new file mode 100644 index 0000000..a8200b9 --- /dev/null +++ b/lib/runtime/commands/command_audio.dart @@ -0,0 +1,125 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorAudio on CommandExecutor { + Future<_CommandResult> _playSound( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + final audio = _audio; + if (audio == null) { + _emitCommandCompletion(command, context); + return _CommandResult.completed; + } + + final scope = _scopeFor(command, context, defaultTarget: false); + final scopeEpoch = _scopeEpochFor(scope, context); + if (!_scopeIsAlive(scope)) { + return _CommandResult.cancelled; + } + + final task = _registerTask(scope, handle); + final playback = await audio.play( + _requiredAudioResource(command), + volume: _optionalVolume(command), + ); + if (_disposed || + task.isCancelled || + (handle?.isCancelled ?? false) || + !_scopeIsAlive(scope)) { + await playback?.cancel(); + task.complete(_CommandResult.cancelled); + return task.future; + } + if (playback == null) { + task.complete(_CommandResult.cancelled); + return task.future; + } + + task.addCancelCallback(() { + async.unawaited(playback.cancel()); + }); + await playback.done; + + if (_disposed || + task.isCancelled || + (handle?.isCancelled ?? false) || + !_scopeIsAlive(scope)) { + task.complete(_CommandResult.cancelled); + return task.future; + } + + _emitCommandCompletion( + command, + context.copyWith(scope: scope, scopeEpoch: scopeEpoch), + ); + task.complete(_CommandResult.completed); + return task.future; + } + + Future<_CommandResult> _playBgm( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + final audio = _audio; + if (audio == null) { + _emitCommandCompletion(command, context); + return _CommandResult.completed; + } + + final scope = _scopeFor(command, context, defaultTarget: false); + final scopeEpoch = _scopeEpochFor(scope, context); + if (!_scopeIsAlive(scope)) { + return _CommandResult.cancelled; + } + + final channel = _audioChannel(command); + final playback = await audio.playBgm( + _requiredAudioResource(command), + channel: channel, + volume: _optionalVolume(command), + loop: _optionalBool(command.payload['loop'], 'play_bgm.loop') ?? true, + ); + if (_disposed || (handle?.isCancelled ?? false) || !_scopeIsAlive(scope)) { + await audio.stopBgm(channel: channel); + return _CommandResult.cancelled; + } + if (playback == null) { + return _CommandResult.cancelled; + } + + _registerBgmChannel(channel: channel, scope: scope); + handle?.addCancelCallback(() { + _unregisterBgmChannel(channel); + async.unawaited(audio.stopBgm(channel: channel)); + }); + _emitCommandCompletion( + command, + context.copyWith(scope: scope, scopeEpoch: scopeEpoch), + ); + return _CommandResult.completed; + } + + Future<_CommandResult> _controlBgm( + RuntimeCommand command, + _CommandContext context, + _BgmControl control, + ) async { + final audio = _audio; + final channel = _audioChannel(command); + if (audio != null) { + switch (control) { + case _BgmControl.pause: + await audio.pauseBgm(channel: channel); + case _BgmControl.resume: + await audio.resumeBgm(channel: channel); + case _BgmControl.stop: + await audio.stopBgm(channel: channel); + _unregisterBgmChannel(channel); + } + } + _emitCommandCompletion(command, context); + return _CommandResult.completed; + } +} diff --git a/lib/runtime/commands/command_composite.dart b/lib/runtime/commands/command_composite.dart new file mode 100644 index 0000000..442b2be --- /dev/null +++ b/lib/runtime/commands/command_composite.dart @@ -0,0 +1,52 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorComposite on CommandExecutor { + Future<_CommandResult> _sequence( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + final commands = _commandsFromPayload(command); + final childContext = _childContextFor(command, context); + for (final child in commands) { + if (_disposed || + (handle?.isCancelled ?? false) || + !_scopeIsAlive(childContext.scope)) { + return _CommandResult.cancelled; + } + final result = await _execute(child, childContext); + if (result == _CommandResult.cancelled) { + return _CommandResult.cancelled; + } + } + + if (_disposed || + (handle?.isCancelled ?? false) || + !_scopeIsAlive(childContext.scope)) { + return _CommandResult.cancelled; + } + _emitCommandCompletion(command, childContext); + return _CommandResult.completed; + } + + Future<_CommandResult> _parallel( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + final commands = _commandsFromPayload(command); + final childContext = _childContextFor(command, context); + final results = await Future.wait( + commands.map((child) => _execute(child, childContext)), + ); + if (_disposed || + (handle?.isCancelled ?? false) || + !_scopeIsAlive(childContext.scope) || + results.contains(_CommandResult.cancelled)) { + return _CommandResult.cancelled; + } + + _emitCommandCompletion(command, childContext); + return _CommandResult.completed; + } +} diff --git a/lib/runtime/commands/command_executor.dart b/lib/runtime/commands/command_executor.dart new file mode 100644 index 0000000..bdc4711 --- /dev/null +++ b/lib/runtime/commands/command_executor.dart @@ -0,0 +1,230 @@ +import 'dart:async' as async; + +import 'package:flame/components.dart'; +import 'package:flame/effects.dart'; +import 'package:flutter/services.dart'; + +import '../audio/runtime_audio_manager.dart'; +import '../lifecycle/runtime_task_registry.dart'; +import '../models/game_diff.dart'; +import '../models/runtime_command.dart'; +import '../models/runtime_event.dart'; +import '../models/runtime_node.dart'; +import '../protocol/runtime_protocol.dart'; +import '../rendering/render_tree_controller.dart'; +import '../resources/game_resource_manager.dart'; +import '../rendering/runtime_component.dart'; +import 'runtime_command_registry.dart'; + +// These part files keep CommandExecutor as a single private implementation +// unit while grouping command handlers by responsibility. They are not a +// plugin system and should not expose additional public API. +part 'command_target_effects.dart'; +part 'command_composite.dart'; +part 'command_audio.dart'; +part 'command_resources.dart'; +part 'command_lifecycle_context.dart'; +part 'command_toast.dart'; +part 'command_validation.dart'; +part 'command_support.dart'; + +class CommandExecutor { + CommandExecutor({ + required RenderTreeController renderTree, + required void Function(RuntimeEvent event) eventSink, + RuntimeAudioManager? audio, + GameResourceManager? resources, + Vector2? overlaySize, + }) : _renderTree = renderTree, + _eventSink = eventSink, + _audio = audio, + _resources = resources, + _overlaySize = overlaySize ?? Vector2(720, 720); + + final RenderTreeController _renderTree; + final void Function(RuntimeEvent event) _eventSink; + final RuntimeAudioManager? _audio; + final GameResourceManager? _resources; + final Vector2 _overlaySize; + late final RuntimeTaskRegistry<_CommandResult> _tasks = + RuntimeTaskRegistry<_CommandResult>( + cancelledValue: _CommandResult.cancelled, + ); + final RuntimeCommandRegistry _commandRegistry = RuntimeCommandRegistry(); + final Set _ownedBgmChannels = {}; + final Map> _bgmChannelsByScope = {}; + final Map _bgmScopeByChannel = {}; + int _toastSerial = 0; + bool _disposed = false; + + void dispose() { + _disposed = true; + _commandRegistry.dispose(); + _tasks.dispose(); + final channels = _ownedBgmChannels.toList(growable: false); + _ownedBgmChannels.clear(); + _bgmChannelsByScope.clear(); + _bgmScopeByChannel.clear(); + for (final channel in channels) { + async.unawaited(_audio?.stopBgm(channel: channel)); + } + } + + void cancelScope(String scope) { + _commandRegistry.cancelScope(scope); + _tasks.cancelScope(scope); + final channels = _bgmChannelsByScope.remove(scope) ?? const {}; + for (final channel in channels) { + _bgmScopeByChannel.remove(channel); + _ownedBgmChannels.remove(channel); + async.unawaited(_audio?.stopBgm(channel: channel)); + } + } + + void executeAll(List commands) { + for (final command in commands) { + execute(command); + } + } + + void execute(RuntimeCommand command) { + if (_disposed) { + return; + } + _validate(command); + async.unawaited(_execute(command, const _CommandContext())); + } + + Future<_CommandResult> _execute( + RuntimeCommand command, + _CommandContext context, + ) async { + if (_disposed) { + return _CommandResult.cancelled; + } + + final commandContext = _commandContextFor(command, context); + final handle = _createCommandHandle(command, commandContext); + try { + if (handle?.isCancelled ?? false) { + return _CommandResult.cancelled; + } + final result = await _executeCore(command, commandContext, handle); + if (handle?.isCancelled ?? false) { + return _CommandResult.cancelled; + } + return result; + } finally { + handle?.complete(); + } + } + + Future<_CommandResult> _executeCore( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + if (_disposed || (handle?.isCancelled ?? false)) { + return _CommandResult.cancelled; + } + + switch (command.type) { + case RuntimeCommandType.movePath: + return _movePath(command, context, handle); + case RuntimeCommandType.moveTo: + return _targetEffect(command, context, handle, (component, duration) { + return MoveToEffect( + _requiredVector(command), + EffectController(duration: duration), + ); + }); + case RuntimeCommandType.fadeTo: + return _targetEffect(command, context, handle, (component, duration) { + final alpha = _requiredNormalizedDouble( + command.payload['alpha'], + 'fade_to.alpha', + ); + final start = component.renderAlpha; + return FunctionEffect((progress, _) { + final t = _readDouble(progress) ?? 1; + component.setRuntimeAlpha(start + (alpha - start) * t); + }, EffectController(duration: duration)); + }); + case RuntimeCommandType.scaleTo: + return _targetEffect(command, context, handle, (component, duration) { + final scale = _requiredDouble( + command.payload['scale'], + 'scale_to.scale', + ); + return ScaleEffect.to( + Vector2.all(scale), + EffectController(duration: duration), + ); + }); + case RuntimeCommandType.rotateTo: + return _targetEffect(command, context, handle, (component, duration) { + final angle = _requiredDouble( + command.payload['angle'], + 'rotate_to.angle', + ); + return RotateEffect.to(angle, EffectController(duration: duration)); + }); + case RuntimeCommandType.removeNode: + return _removeNode(command, context); + case RuntimeCommandType.sequence: + return _sequence(command, context, handle); + case RuntimeCommandType.parallel: + return _parallel(command, context, handle); + case RuntimeCommandType.delay: + return _delay(command, context, handle); + case RuntimeCommandType.toast: + return _toast(command, context, handle); + case RuntimeCommandType.playSound: + return _playSound(command, context, handle); + case RuntimeCommandType.playBgm: + return _playBgm(command, context, handle); + case RuntimeCommandType.pauseBgm: + return _controlBgm(command, context, _BgmControl.pause); + case RuntimeCommandType.resumeBgm: + return _controlBgm(command, context, _BgmControl.resume); + case RuntimeCommandType.stopBgm: + return _controlBgm(command, context, _BgmControl.stop); + case RuntimeCommandType.preloadResources: + return _preloadResources(command, context, handle); + case RuntimeCommandType.evictResources: + return _evictResources(command, context, handle); + case RuntimeCommandType.cancelCommands: + return _cancelCommands(command, context); + case RuntimeCommandType.playSpineAnimation: + return _playSpineAnimation(command, context); + case RuntimeCommandType.copyText: + await Clipboard.setData( + ClipboardData(text: _requiredText(command, 'copy_text.text')), + ); + _emitCommandCompletion(command, context); + return _CommandResult.completed; + default: + throw UnsupportedError('Unsupported runtime command: ${command.type}'); + } + } +} + +class _CommandContext { + const _CommandContext({this.scope, this.scopeEpoch, this.group}); + + final String? scope; + final int? scopeEpoch; + final String? group; + + _CommandContext copyWith({String? scope, int? scopeEpoch, String? group}) { + return _CommandContext( + scope: scope ?? this.scope, + scopeEpoch: scopeEpoch ?? this.scopeEpoch, + group: group ?? this.group, + ); + } +} + +enum _CommandResult { completed, cancelled } + +enum _BgmControl { pause, resume, stop } diff --git a/lib/runtime/commands/command_lifecycle_context.dart b/lib/runtime/commands/command_lifecycle_context.dart new file mode 100644 index 0000000..002ed21 --- /dev/null +++ b/lib/runtime/commands/command_lifecycle_context.dart @@ -0,0 +1,154 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorLifecycle on CommandExecutor { + Future<_CommandResult> _delay( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) { + final scope = _scopeFor(command, context, defaultTarget: false); + final scopeEpoch = _scopeEpochFor(scope, context); + final task = _registerTask(scope, handle); + _schedule(_duration(command, defaultValue: 0), task, () { + if ((handle?.isCancelled ?? false) || !_scopeIsAlive(scope)) { + task.cancel(); + return; + } + _emitCommandCompletion( + command, + context.copyWith(scope: scope, scopeEpoch: scopeEpoch), + ); + task.complete(_CommandResult.completed); + }); + return task.future; + } + + void _schedule( + double seconds, + RuntimeTask<_CommandResult> task, + void Function() callback, + ) { + void guardedCallback() { + if (_disposed || task.isCancelled) { + return; + } + callback(); + } + + if (seconds <= 0) { + async.scheduleMicrotask(guardedCallback); + return; + } + + late final async.Timer timer; + timer = async.Timer(Duration(milliseconds: (seconds * 1000).round()), () { + task.removeTimer(timer); + guardedCallback(); + }); + task.addTimer(timer); + } + + RuntimeTask<_CommandResult> _registerTask( + String? scope, + RuntimeCommandHandle? handle, + ) { + final task = _tasks.create(scope: scope); + handle?.addCancelCallback(task.cancel); + return task; + } + + _CommandContext _commandContextFor( + RuntimeCommand command, + _CommandContext context, + ) { + return context.copyWith(group: _commandGroupFor(command, context)); + } + + RuntimeCommandHandle? _createCommandHandle( + RuntimeCommand command, + _CommandContext context, + ) { + if (command.type == RuntimeCommandType.cancelCommands) { + return null; + } + final id = _optionalString(command.payload['id'], 'id'); + final group = context.group; + final scope = _completionScopeFor(command, context); + if (id == null && group == null && scope == null) { + return null; + } + return _commandRegistry.create(id: id, group: group, scope: scope); + } + + _CommandContext _childContextFor( + RuntimeCommand command, + _CommandContext context, + ) { + final scope = _scopeFor(command, context, defaultTarget: false); + return context.copyWith( + scope: scope, + scopeEpoch: _scopeEpochFor(scope, context), + group: _commandGroupFor(command, context), + ); + } + + String? _commandGroupFor(RuntimeCommand command, _CommandContext context) { + final commandGroup = _optionalString( + command.payload['commandGroup'], + 'commandGroup', + ); + if (commandGroup != null) { + return commandGroup; + } + if (_usesGroupAsCommandGroup(command.type)) { + final legacyGroup = _optionalString(command.payload['group'], 'group'); + if (legacyGroup != null) { + return legacyGroup; + } + } + return context.group; + } + + bool _usesGroupAsCommandGroup(String commandType) { + return commandType != RuntimeCommandType.preloadResources && + commandType != RuntimeCommandType.evictResources && + commandType != RuntimeCommandType.cancelCommands; + } + + String? _scopeFor( + RuntimeCommand command, + _CommandContext context, { + required bool defaultTarget, + }) { + final explicit = _optionalString(command.payload['scope'], 'scope'); + if (explicit != null) { + return explicit; + } + if (context.scope != null) { + return context.scope; + } + if (defaultTarget) { + return command.target; + } + return null; + } + + String? _completionScopeFor(RuntimeCommand command, _CommandContext context) { + final explicit = _optionalString(command.payload['scope'], 'scope'); + return explicit ?? context.scope; + } + + int? _scopeEpochFor(String? scope, _CommandContext context) { + if (scope == null) { + return null; + } + if (scope == context.scope && context.scopeEpoch != null) { + return context.scopeEpoch; + } + return _renderTree.epochOf(scope); + } + + bool _scopeIsAlive(String? scope) { + return scope == null || _renderTree.contains(scope); + } +} diff --git a/lib/runtime/commands/command_resources.dart b/lib/runtime/commands/command_resources.dart new file mode 100644 index 0000000..045efa1 --- /dev/null +++ b/lib/runtime/commands/command_resources.dart @@ -0,0 +1,83 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorResources on CommandExecutor { + Future<_CommandResult> _preloadResources( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + final group = _requiredResourceGroup(command); + final failOnError = + _optionalBool( + command.payload['failOnError'], + 'preload_resources.failOnError', + ) ?? + false; + final resources = _resources; + final audio = _audio; + if (resources != null && resources.hasPackage) { + await resources.preloadGroup(group, failOnError: failOnError); + } + if (audio != null && audio.hasPackage) { + await audio.preloadGroup(group, failOnError: failOnError); + } + if (handle?.isCancelled ?? false) { + return _CommandResult.cancelled; + } + _emitCommandCompletion(command, context); + return _CommandResult.completed; + } + + Future<_CommandResult> _evictResources( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) async { + final group = _requiredResourceGroup(command); + final resources = _resources; + final audio = _audio; + if (resources != null && resources.hasPackage) { + resources.evictGroup(group); + } + if (audio != null && audio.hasPackage) { + audio.evictGroup(group); + } + if (handle?.isCancelled ?? false) { + return _CommandResult.cancelled; + } + _emitCommandCompletion(command, context); + return _CommandResult.completed; + } + + Future<_CommandResult> _cancelCommands( + RuntimeCommand command, + _CommandContext context, + ) async { + final id = _optionalString(command.payload['id'], 'cancel_commands.id'); + final group = _optionalString( + command.payload['group'], + 'cancel_commands.group', + ); + final scope = _optionalString( + command.payload['scope'], + 'cancel_commands.scope', + ); + if (id == null && group == null && scope == null) { + throw const FormatException( + 'cancel_commands requires id, group or scope', + ); + } + if (id != null) { + _commandRegistry.cancelId(id); + } + if (group != null) { + _commandRegistry.cancelGroup(group); + } + if (scope != null) { + _commandRegistry.cancelScope(scope); + _tasks.cancelScope(scope); + } + _emitCommandCompletion(command, context); + return _CommandResult.completed; + } +} diff --git a/lib/runtime/commands/command_support.dart b/lib/runtime/commands/command_support.dart new file mode 100644 index 0000000..67c9609 --- /dev/null +++ b/lib/runtime/commands/command_support.dart @@ -0,0 +1,248 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorSupport on CommandExecutor { + void _appendCompletionEffect( + List effects, + RuntimeCommand command, + String target, + int targetEpoch, + RuntimeTask<_CommandResult> task, + String? scope, + int? scopeEpoch, + ) { + effects.add( + FunctionEffect((_, __) { + if (!_scopeIsAlive(scope) || + !_renderTree.isNodeEpochAlive(target, targetEpoch)) { + task.cancel(); + return; + } + _emitCompletion(command, target, scope, targetEpoch, scopeEpoch); + task.complete(_CommandResult.completed); + }, EffectController(duration: 0.01)), + ); + } + + void _emitCompletion( + RuntimeCommand command, + String target, + String? scope, [ + int? targetEpoch, + int? scopeEpoch, + ]) { + final onComplete = _optionalString( + command.payload['onComplete'], + 'onComplete', + ); + if (onComplete == null) { + return; + } + _emitEventIfScopeAlive( + RuntimeEvent( + type: RuntimeEventType.animationDone, + target: target, + handler: onComplete, + ), + scope, + targetEpoch: targetEpoch, + scopeEpoch: scopeEpoch, + ); + } + + void _emitCommandCompletion(RuntimeCommand command, _CommandContext context) { + final onComplete = _optionalString( + command.payload['onComplete'], + 'onComplete', + ); + if (onComplete == null) { + return; + } + _emitEventIfScopeAlive( + RuntimeEvent( + type: RuntimeEventType.animationDone, + target: command.target, + handler: onComplete, + ), + _completionScopeFor(command, context), + scopeEpoch: context.scopeEpoch, + ); + } + + void _emitEventIfScopeAlive( + RuntimeEvent event, + String? scope, { + int? targetEpoch, + int? scopeEpoch, + }) { + if (!_scopeIsAlive(scope) || _disposed) { + return; + } + _eventSink( + event.withLifecycle( + scope: scope, + targetEpoch: targetEpoch, + scopeEpoch: scopeEpoch, + ), + ); + } + + Vector2 _requiredVector(RuntimeCommand command) { + final x = _readDouble(command.payload['x']); + final y = _readDouble(command.payload['y']); + if (x == null || y == null) { + throw FormatException('${command.type}.x/y are required numbers'); + } + return Vector2(x, y); + } + + String _requiredTarget(RuntimeCommand command) { + final target = command.target; + if (target == null || target.isEmpty) { + throw FormatException('${command.type}.target is required'); + } + return target; + } + + String _requiredText(RuntimeCommand command, String field) { + return _optionalString(command.payload['text'], field)!; + } + + double _duration(RuntimeCommand command, {required double defaultValue}) { + final duration = _readDouble(command.payload['duration']) ?? defaultValue; + if (duration < 0) { + throw FormatException('${command.type}.duration must be >= 0'); + } + return duration; + } + + double _requiredDouble(Object? value, String field) { + final result = _readDouble(value); + if (result == null) { + throw FormatException('$field must be a number'); + } + return result; + } + + void _registerBgmChannel({required String channel, required String? scope}) { + _unregisterBgmChannel(channel); + _ownedBgmChannels.add(channel); + if (scope == null) { + return; + } + _bgmScopeByChannel[channel] = scope; + _bgmChannelsByScope.putIfAbsent(scope, () => {}).add(channel); + } + + void _unregisterBgmChannel(String channel) { + _ownedBgmChannels.remove(channel); + final oldScope = _bgmScopeByChannel.remove(channel); + if (oldScope == null) { + return; + } + final channels = _bgmChannelsByScope[oldScope]; + channels?.remove(channel); + if (channels != null && channels.isEmpty) { + _bgmChannelsByScope.remove(oldScope); + } + } + + String _audioChannel(RuntimeCommand command) { + return _optionalString(command.payload['channel'], 'channel') ?? + RuntimeAudioChannel.defaultBgm; + } + + String _requiredResourceGroup(RuntimeCommand command) { + return _optionalString(command.payload['group'], '${command.type}.group')!; + } + + void _validateCancelCommands(RuntimeCommand command) { + final id = _optionalString(command.payload['id'], 'cancel_commands.id'); + final group = _optionalString( + command.payload['group'], + 'cancel_commands.group', + ); + final scope = _optionalString( + command.payload['scope'], + 'cancel_commands.scope', + ); + if (id == null && group == null && scope == null) { + throw const FormatException( + 'cancel_commands requires id, group or scope', + ); + } + } + + String _requiredAudioResource(RuntimeCommand command) { + final asset = command.payload['asset'] ?? command.payload['name']; + return _optionalString(asset, 'play_sound.asset/name')!; + } + + String _requiredSpineAnimation(RuntimeCommand command) { + final value = _optionalString( + command.payload['animation'], + 'play_spine_animation.animation', + ); + if (value == null) { + throw const FormatException( + 'play_spine_animation.animation must be a non-empty string', + ); + } + return value; + } + + bool? _optionalBool(Object? value, String field) { + if (value == null) { + return null; + } + if (value is bool) { + return value; + } + throw FormatException('$field must be a boolean'); + } + + double _optionalVolume(RuntimeCommand command) { + final value = command.payload['volume']; + if (value == null) { + return 1; + } + return _requiredNormalizedDouble(value, 'play_sound.volume'); + } + + double _requiredNormalizedDouble(Object? value, String field) { + final result = _requiredDouble(value, field); + if (result < 0 || result > 1) { + throw FormatException('$field must be between 0 and 1'); + } + return result; + } + + String? _optionalString(Object? value, String field) { + if (value == null) { + return null; + } + if (value is String && value.isNotEmpty) { + return value; + } + throw FormatException('$field must be a non-empty string'); + } + + int? _optionalInt(Object? value, String field) { + if (value == null) { + return null; + } + if (value is num) { + return value.toInt(); + } + throw FormatException('$field must be an integer'); + } + + double? _readDouble(Object? value) { + if (value == null) { + return null; + } + if (value is num) { + return value.toDouble(); + } + return null; + } +} diff --git a/lib/runtime/commands/command_target_effects.dart b/lib/runtime/commands/command_target_effects.dart new file mode 100644 index 0000000..e6842d4 --- /dev/null +++ b/lib/runtime/commands/command_target_effects.dart @@ -0,0 +1,143 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorTargetEffects on CommandExecutor { + Future<_CommandResult> _movePath( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) { + final target = _requiredTarget(command); + final component = _renderTree.componentById(target); + if (component == null) { + return Future.value(_CommandResult.cancelled); + } + + final scope = _scopeFor(command, context, defaultTarget: true); + final scopeEpoch = _scopeEpochFor(scope, context); + final targetEpoch = _renderTree.epochOf(target); + final task = _registerTask(scope, handle); + final pathValue = command.payload['path'] as List; + final duration = _duration(command, defaultValue: 0.4); + final perStepDuration = duration / pathValue.length; + final effects = []; + + for (final point in pathValue) { + final map = point as Map; + final x = _readDouble(map['x'])!; + final y = _readDouble(map['y'])!; + effects.add( + MoveToEffect( + Vector2(x, y), + EffectController(duration: perStepDuration), + ), + ); + } + + _appendCompletionEffect( + effects, + command, + target, + targetEpoch, + task, + scope, + scopeEpoch, + ); + final effect = SequenceEffect(effects); + handle?.addCancelCallback(effect.removeFromParent); + component.add(effect); + return task.future; + } + + Future<_CommandResult> _targetEffect( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + Effect Function(RuntimeComponent component, double duration) factory, + ) { + final target = _requiredTarget(command); + final component = _renderTree.componentById(target); + if (component == null) { + return Future.value(_CommandResult.cancelled); + } + + final scope = _scopeFor(command, context, defaultTarget: true); + final scopeEpoch = _scopeEpochFor(scope, context); + final targetEpoch = _renderTree.epochOf(target); + final task = _registerTask(scope, handle); + final effects = [ + factory(component, _duration(command, defaultValue: 0.2)), + ]; + _appendCompletionEffect( + effects, + command, + target, + targetEpoch, + task, + scope, + scopeEpoch, + ); + final effect = SequenceEffect(effects); + handle?.addCancelCallback(effect.removeFromParent); + component.add(effect); + return task.future; + } + + Future<_CommandResult> _playSpineAnimation( + RuntimeCommand command, + _CommandContext context, + ) { + final target = _requiredTarget(command); + final component = _renderTree.componentById(target); + if (component == null) { + return Future.value(_CommandResult.cancelled); + } + + final animation = _requiredSpineAnimation(command); + final track = + _optionalInt(command.payload['track'], 'play_spine_animation.track') ?? + 0; + final loop = + _optionalBool(command.payload['loop'], 'play_spine_animation.loop') ?? + true; + final queue = + _optionalBool(command.payload['queue'], 'play_spine_animation.queue') ?? + false; + final delay = _readDouble(command.payload['delay']) ?? 0; + if (track < 0) { + throw const FormatException('play_spine_animation.track must be >= 0'); + } + if (delay < 0) { + throw const FormatException('play_spine_animation.delay must be >= 0'); + } + + final played = component.playSpineAnimation( + animation, + track: track, + loop: loop, + queue: queue, + delay: delay, + ); + if (!played) { + return Future.value(_CommandResult.cancelled); + } + final scope = _completionScopeFor(command, context); + _emitCompletion( + command, + target, + scope, + _renderTree.epochOf(target), + context.scopeEpoch, + ); + return Future.value(_CommandResult.completed); + } + + Future<_CommandResult> _removeNode( + RuntimeCommand command, + _CommandContext context, + ) { + final target = _requiredTarget(command); + _renderTree.removeById(target); + _emitCompletion(command, target, _completionScopeFor(command, context)); + return Future.value(_CommandResult.completed); + } +} diff --git a/lib/runtime/commands/command_toast.dart b/lib/runtime/commands/command_toast.dart new file mode 100644 index 0000000..5388608 --- /dev/null +++ b/lib/runtime/commands/command_toast.dart @@ -0,0 +1,96 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorToast on CommandExecutor { + Future<_CommandResult> _toast( + RuntimeCommand command, + _CommandContext context, + RuntimeCommandHandle? handle, + ) { + final text = _toastText(command); + final duration = _duration(command, defaultValue: 1.8); + final scope = _scopeFor(command, context, defaultTarget: false); + final scopeEpoch = _scopeEpochFor(scope, context); + final task = _registerTask(scope, handle); + final toastId = 'runtime_toast_${++_toastSerial}'; + final toastTextId = '${toastId}_text'; + + _renderTree.apply( + NodeDiff( + creates: _toastNodes(id: toastId, textId: toastTextId, text: text), + ), + ); + task.addCancelCallback(() => _renderTree.removeById(toastId)); + + _schedule(duration, task, () { + if ((handle?.isCancelled ?? false) || !_scopeIsAlive(scope)) { + _renderTree.removeById(toastId); + task.cancel(); + return; + } + _renderTree.removeById(toastId); + _emitCommandCompletion( + command, + context.copyWith(scope: scope, scopeEpoch: scopeEpoch), + ); + task.complete(_CommandResult.completed); + }); + + return task.future; + } + + List _toastNodes({ + required String id, + required String textId, + required String text, + }) { + const width = 360.0; + const minHeight = 38.0; + final lineCount = text.split('\n').length; + final height = (minHeight + (lineCount - 1) * 16).clamp(38.0, 92.0); + final x = ((_overlaySize.x - width) / 2).clamp(12.0, _overlaySize.x); + final y = (_overlaySize.y - height - 58).clamp(12.0, _overlaySize.y); + + return [ + RuntimeNode( + id: id, + type: RuntimeNodeType.panel, + x: x, + y: y, + width: width, + height: height, + color: const Color(0xee020617), + radius: 12, + layer: 10000, + ), + RuntimeNode( + id: textId, + type: RuntimeNodeType.text, + parent: id, + text: text, + x: 14, + y: 0, + width: width - 28, + height: height, + color: const Color(0xfff8fafc), + fontSize: 13, + textAlign: RuntimeTextAlignValue.center, + layer: 10001, + ), + ]; + } + + String _toastText(RuntimeCommand command) { + final text = _optionalString(command.payload['text'], 'toast.text'); + final message = _optionalString( + command.payload['message'], + 'toast.message', + ); + if (text != null) { + return text; + } + if (message != null) { + return message; + } + throw const FormatException('toast.text or toast.message is required'); + } +} diff --git a/lib/runtime/commands/command_validation.dart b/lib/runtime/commands/command_validation.dart new file mode 100644 index 0000000..773e580 --- /dev/null +++ b/lib/runtime/commands/command_validation.dart @@ -0,0 +1,154 @@ +part of 'command_executor.dart'; + +extension _CommandExecutorValidation on CommandExecutor { + void _validate(RuntimeCommand command) { + if (!RuntimeCommandType.isSupported(command.type)) { + throw UnsupportedError('Unsupported runtime command: ${command.type}'); + } + RuntimeProtocolSchema.ensureKnownKeys( + command.payload, + allowed: RuntimeProtocolSchema.allowedCommandPayloadFields(command.type), + context: 'RuntimeCommand.${command.type}.payload', + ); + _optionalString(command.payload['id'], 'id'); + _optionalString(command.payload['group'], 'group'); + _optionalString(command.payload['commandGroup'], 'commandGroup'); + _optionalString(command.payload['scope'], 'scope'); + _estimatedDuration(command); + } + + double _estimatedDuration(RuntimeCommand command) { + _optionalString(command.payload['onComplete'], 'onComplete'); + + switch (command.type) { + case RuntimeCommandType.movePath: + _requiredTarget(command); + _validatePath(command.payload['path']); + return _duration(command, defaultValue: 0.4); + case RuntimeCommandType.moveTo: + _requiredTarget(command); + _requiredVector(command); + return _duration(command, defaultValue: 0.2); + case RuntimeCommandType.fadeTo: + _requiredTarget(command); + _requiredNormalizedDouble(command.payload['alpha'], 'fade_to.alpha'); + return _duration(command, defaultValue: 0.2); + case RuntimeCommandType.scaleTo: + _requiredTarget(command); + _requiredDouble(command.payload['scale'], 'scale_to.scale'); + return _duration(command, defaultValue: 0.2); + case RuntimeCommandType.rotateTo: + _requiredTarget(command); + _requiredDouble(command.payload['angle'], 'rotate_to.angle'); + return _duration(command, defaultValue: 0.2); + case RuntimeCommandType.removeNode: + _requiredTarget(command); + return 0; + case RuntimeCommandType.delay: + return _duration(command, defaultValue: 0); + case RuntimeCommandType.sequence: + return _commandsFromPayload( + command, + ).fold(0, (sum, child) => sum + _estimatedDuration(child)); + case RuntimeCommandType.parallel: + var maxDuration = 0.0; + for (final child in _commandsFromPayload(command)) { + final duration = _estimatedDuration(child); + if (duration > maxDuration) { + maxDuration = duration; + } + } + return maxDuration; + case RuntimeCommandType.toast: + _toastText(command); + return _duration(command, defaultValue: 1.8); + case RuntimeCommandType.playSound: + _requiredAudioResource(command); + _optionalVolume(command); + return 0; + case RuntimeCommandType.playBgm: + _requiredAudioResource(command); + _optionalVolume(command); + _audioChannel(command); + _optionalBool(command.payload['loop'], 'play_bgm.loop'); + return 0; + case RuntimeCommandType.pauseBgm: + case RuntimeCommandType.resumeBgm: + case RuntimeCommandType.stopBgm: + _audioChannel(command); + return 0; + case RuntimeCommandType.preloadResources: + _requiredResourceGroup(command); + _optionalBool( + command.payload['failOnError'], + 'preload_resources.failOnError', + ); + return 0; + case RuntimeCommandType.evictResources: + _requiredResourceGroup(command); + return 0; + case RuntimeCommandType.cancelCommands: + _validateCancelCommands(command); + return 0; + case RuntimeCommandType.playSpineAnimation: + _requiredTarget(command); + _requiredSpineAnimation(command); + final track = _optionalInt( + command.payload['track'], + 'play_spine_animation.track', + ); + if (track != null && track < 0) { + throw const FormatException( + 'play_spine_animation.track must be >= 0', + ); + } + _optionalBool(command.payload['loop'], 'play_spine_animation.loop'); + _optionalBool(command.payload['queue'], 'play_spine_animation.queue'); + final delay = _readDouble(command.payload['delay']); + if (delay != null && delay < 0) { + throw const FormatException( + 'play_spine_animation.delay must be >= 0', + ); + } + return 0; + case RuntimeCommandType.copyText: + _requiredText(command, 'copy_text.text'); + return 0; + default: + throw UnsupportedError('Unsupported runtime command: ${command.type}'); + } + } + + void _validatePath(Object? pathValue) { + if (pathValue is! List || pathValue.isEmpty) { + throw const FormatException('move_path.path must be a non-empty list'); + } + for (final point in pathValue) { + if (point is! Map) { + throw const FormatException('move_path.path item must be a map'); + } + final x = _readDouble(point['x']); + final y = _readDouble(point['y']); + if (x == null || y == null) { + throw const FormatException('move_path point requires x/y'); + } + } + } + + List _commandsFromPayload(RuntimeCommand command) { + final value = command.payload['commands']; + if (value is! List) { + throw FormatException('${command.type}.commands must be a list'); + } + return value + .map((item) { + if (item is! Map) { + throw FormatException( + '${command.type}.commands item must be a map', + ); + } + return RuntimeCommand.fromMap(Map.from(item)); + }) + .toList(growable: false); + } +} diff --git a/lib/runtime/commands/runtime_command_registry.dart b/lib/runtime/commands/runtime_command_registry.dart new file mode 100644 index 0000000..4e1626e --- /dev/null +++ b/lib/runtime/commands/runtime_command_registry.dart @@ -0,0 +1,146 @@ +class RuntimeCommandRegistry { + final Set _handles = {}; + final Map> _handlesById = {}; + final Map> _handlesByGroup = {}; + final Map> _handlesByScope = {}; + bool _disposed = false; + + int get activeHandleCount => _handles.length; + + RuntimeCommandHandle create({String? id, String? group, String? scope}) { + if (_disposed) { + throw StateError('RuntimeCommandRegistry has been disposed'); + } + + late final RuntimeCommandHandle handle; + handle = RuntimeCommandHandle._( + id: id, + group: group, + scope: scope, + onComplete: _unregister, + ); + _handles.add(handle); + _index(_handlesById, id, handle); + _index(_handlesByGroup, group, handle); + _index(_handlesByScope, scope, handle); + return handle; + } + + void cancelId(String id) { + _cancelAll(_handlesById[id]); + } + + void cancelGroup(String group) { + _cancelAll(_handlesByGroup[group]); + } + + void cancelScope(String scope) { + _cancelAll(_handlesByScope[scope]); + } + + void dispose() { + if (_disposed) { + return; + } + _disposed = true; + _cancelAll(_handles); + _handles.clear(); + _handlesById.clear(); + _handlesByGroup.clear(); + _handlesByScope.clear(); + } + + void _index( + Map> index, + String? key, + RuntimeCommandHandle handle, + ) { + if (key == null) { + return; + } + index.putIfAbsent(key, () => {}).add(handle); + } + + void _cancelAll(Set? handles) { + final snapshot = handles?.toList(growable: false) ?? const []; + for (final handle in snapshot) { + handle.cancel(); + } + } + + void _unregister(RuntimeCommandHandle handle) { + _handles.remove(handle); + _unindex(_handlesById, handle.id, handle); + _unindex(_handlesByGroup, handle.group, handle); + _unindex(_handlesByScope, handle.scope, handle); + } + + void _unindex( + Map> index, + String? key, + RuntimeCommandHandle handle, + ) { + if (key == null) { + return; + } + final handles = index[key]; + handles?.remove(handle); + if (handles != null && handles.isEmpty) { + index.remove(key); + } + } +} + +class RuntimeCommandHandle { + RuntimeCommandHandle._({ + required this.id, + required this.group, + required this.scope, + required void Function(RuntimeCommandHandle handle) onComplete, + }) : _onComplete = onComplete; + + final String? id; + final String? group; + final String? scope; + final void Function(RuntimeCommandHandle handle) _onComplete; + final List _cancelCallbacks = []; + bool _cancelled = false; + bool _completed = false; + + bool get isCancelled => _cancelled; + + bool get isCompleted => _completed; + + void addCancelCallback(void Function() callback) { + if (_cancelled) { + callback(); + return; + } + if (_completed) { + return; + } + _cancelCallbacks.add(callback); + } + + void complete() { + if (_completed) { + return; + } + _completed = true; + _cancelCallbacks.clear(); + _onComplete(this); + } + + void cancel() { + if (_cancelled || _completed) { + return; + } + _cancelled = true; + final callbacks = _cancelCallbacks.toList(growable: false); + _cancelCallbacks.clear(); + for (final callback in callbacks) { + callback(); + } + complete(); + } +} diff --git a/lib/runtime/diagnostics/runtime_diagnostics.dart b/lib/runtime/diagnostics/runtime_diagnostics.dart new file mode 100644 index 0000000..29d2f58 --- /dev/null +++ b/lib/runtime/diagnostics/runtime_diagnostics.dart @@ -0,0 +1,138 @@ +import 'dart:convert'; + +class RuntimeDiagnostics { + RuntimeDiagnostics({this.maxEntries = 100}); + + final int maxEntries; + final List _entries = []; + + List get entries => List.unmodifiable(_entries); + + Map toDebugJson() { + return { + 'maxEntries': maxEntries, + 'count': _entries.length, + 'entries': _entries.map((entry) => entry.toDebugJson()).toList(), + }; + } + + String dumpText() { + if (_entries.isEmpty) { + return 'RuntimeDiagnostics: no entries'; + } + + final buffer = StringBuffer( + 'RuntimeDiagnostics (${_entries.length}/$maxEntries)', + ); + for (final entry in _entries) { + buffer + ..writeln() + ..write(entry.dumpText()); + } + return buffer.toString(); + } + + void record({ + required RuntimeDiagnosticType type, + required String message, + Object? error, + Map context = const {}, + }) { + if (_entries.length >= maxEntries) { + _entries.removeAt(0); + } + _entries.add( + RuntimeDiagnosticEntry( + type: type, + message: message, + error: error, + context: context, + timestamp: DateTime.now(), + ), + ); + } + + void clear() { + _entries.clear(); + } +} + +class RuntimeDiagnosticEntry { + const RuntimeDiagnosticEntry({ + required this.type, + required this.message, + required this.timestamp, + this.error, + this.context = const {}, + }); + + final RuntimeDiagnosticType type; + final String message; + final DateTime timestamp; + final Object? error; + final Map context; + + Map toDebugJson() { + return { + 'timestamp': timestamp.toIso8601String(), + 'type': type.name, + 'message': message, + if (error != null) 'error': error.toString(), + if (context.isNotEmpty) 'context': _toDebugValue(context), + }; + } + + String dumpText() { + final buffer = StringBuffer( + '[${timestamp.toIso8601String()}] ${type.name}: $message', + ); + if (error != null) { + buffer + ..writeln() + ..write(' error: $error'); + } + if (context.isNotEmpty) { + buffer + ..writeln() + ..write(' context: ${_formatDebugValue(context)}'); + } + return buffer.toString(); + } +} + +Object? _toDebugValue(Object? value) { + if (value == null || value is String || value is num || value is bool) { + return value; + } + if (value is DateTime) { + return value.toIso8601String(); + } + if (value is Map) { + final entries = value.entries.toList() + ..sort((a, b) => a.key.toString().compareTo(b.key.toString())); + return { + for (final entry in entries) + entry.key.toString(): _toDebugValue(entry.value), + }; + } + if (value is Iterable) { + return value.map(_toDebugValue).toList(); + } + return value.toString(); +} + +String _formatDebugValue(Object? value) { + try { + return jsonEncode(_toDebugValue(value)); + } catch (_) { + return value.toString(); + } +} + +enum RuntimeDiagnosticType { + luaEventError, + diffApplyError, + packageActivationError, + resourceLoadError, + commandError, +} diff --git a/lib/runtime/display/runtime_viewport.dart b/lib/runtime/display/runtime_viewport.dart new file mode 100644 index 0000000..afbcf26 --- /dev/null +++ b/lib/runtime/display/runtime_viewport.dart @@ -0,0 +1,160 @@ +import 'package:flame/components.dart'; + +class RuntimeScaleMode { + const RuntimeScaleMode._(); + + static const fit = 'fit'; + static const fill = 'fill'; + static const stretch = 'stretch'; + static const none = 'none'; + + static const all = {fit, fill, stretch, none}; + + static bool isSupported(String value) => all.contains(value); +} + +class RuntimeViewportConfig { + const RuntimeViewportConfig({ + required this.designWidth, + required this.designHeight, + this.scaleMode = RuntimeScaleMode.fit, + }); + + final double designWidth; + final double designHeight; + final String scaleMode; + + Vector2 get designSize => Vector2(designWidth, designHeight); +} + +class RuntimeViewportTransform { + const RuntimeViewportTransform({ + required this.x, + required this.y, + required this.width, + required this.height, + required this.scaleX, + required this.scaleY, + required this.scaleMode, + }); + + final double x; + final double y; + final double width; + final double height; + final double scaleX; + final double scaleY; + final String scaleMode; + + Map toMap() { + return { + 'x': x, + 'y': y, + 'width': width, + 'height': height, + 'scaleX': scaleX, + 'scaleY': scaleY, + 'scaleMode': scaleMode, + }; + } +} + +class RuntimeViewport { + const RuntimeViewport._(); + + static RuntimeViewportTransform compute({ + required Vector2 screenSize, + required RuntimeViewportConfig config, + }) { + final designWidth = config.designWidth; + final designHeight = config.designHeight; + final screenWidth = screenSize.x; + final screenHeight = screenSize.y; + + if (designWidth <= 0 || designHeight <= 0) { + throw const FormatException('Runtime viewport design size must be > 0'); + } + if (!RuntimeScaleMode.isSupported(config.scaleMode)) { + throw FormatException( + 'Runtime viewport scaleMode is unsupported: ${config.scaleMode}', + ); + } + + final safeScreenWidth = screenWidth <= 0 ? designWidth : screenWidth; + final safeScreenHeight = screenHeight <= 0 ? designHeight : screenHeight; + + final scaleX = safeScreenWidth / designWidth; + final scaleY = safeScreenHeight / designHeight; + + return switch (config.scaleMode) { + RuntimeScaleMode.fit => _uniform( + designWidth: designWidth, + designHeight: designHeight, + screenWidth: safeScreenWidth, + screenHeight: safeScreenHeight, + scale: scaleX < scaleY ? scaleX : scaleY, + scaleMode: config.scaleMode, + ), + RuntimeScaleMode.fill => _uniform( + designWidth: designWidth, + designHeight: designHeight, + screenWidth: safeScreenWidth, + screenHeight: safeScreenHeight, + scale: scaleX > scaleY ? scaleX : scaleY, + scaleMode: config.scaleMode, + ), + RuntimeScaleMode.stretch => RuntimeViewportTransform( + x: 0, + y: 0, + width: safeScreenWidth, + height: safeScreenHeight, + scaleX: scaleX, + scaleY: scaleY, + scaleMode: config.scaleMode, + ), + RuntimeScaleMode.none => RuntimeViewportTransform( + x: (safeScreenWidth - designWidth) / 2, + y: (safeScreenHeight - designHeight) / 2, + width: designWidth, + height: designHeight, + scaleX: 1, + scaleY: 1, + scaleMode: config.scaleMode, + ), + _ => throw FormatException( + 'Runtime viewport scaleMode is unsupported: ${config.scaleMode}', + ), + }; + } + + static void apply( + PositionComponent root, + RuntimeViewportTransform transform, + ) { + root + ..position = Vector2(transform.x, transform.y) + ..scale = Vector2(transform.scaleX, transform.scaleY) + ..size = Vector2(transform.width, transform.height); + } + + static RuntimeViewportTransform _uniform({ + required double designWidth, + required double designHeight, + required double screenWidth, + required double screenHeight, + required double scale, + required String scaleMode, + }) { + final width = designWidth * scale; + final height = designHeight * scale; + return RuntimeViewportTransform( + x: (screenWidth - width) / 2, + y: (screenHeight - height) / 2, + width: width, + height: height, + scaleX: scale, + scaleY: scale, + scaleMode: scaleMode, + ); + } +} diff --git a/lib/runtime/events/runtime_event_dispatcher.dart b/lib/runtime/events/runtime_event_dispatcher.dart new file mode 100644 index 0000000..2d2491d --- /dev/null +++ b/lib/runtime/events/runtime_event_dispatcher.dart @@ -0,0 +1,80 @@ +import '../diagnostics/runtime_diagnostics.dart'; +import '../lifecycle/runtime_serial_queue.dart'; +import '../lifecycle/runtime_session.dart'; +import '../models/game_diff.dart'; +import '../models/runtime_event.dart'; +import '../scripting/script_engine.dart'; +import 'runtime_event_gate.dart'; + +class RuntimeEventDispatcher { + RuntimeEventDispatcher({ + required RuntimeSession session, + required ScriptEngine scriptEngine, + required bool Function(String id) isScopeAlive, + bool Function(String id, int epoch)? isNodeEpochAlive, + required void Function(GameDiff diff) applyDiff, + RuntimeDiagnostics? diagnostics, + void Function(Object error)? onError, + }) : _scriptEngine = scriptEngine, + _applyDiff = applyDiff, + _diagnostics = diagnostics, + _onError = onError, + _gate = RuntimeEventGate( + session: session, + isScopeAlive: isScopeAlive, + isNodeEpochAlive: isNodeEpochAlive, + ) { + _queue = RuntimeSerialQueue( + shouldContinue: () => !_disposed && session.isActive, + onItem: _dispatch, + ); + } + + final ScriptEngine _scriptEngine; + final void Function(GameDiff diff) _applyDiff; + final RuntimeDiagnostics? _diagnostics; + final void Function(Object error)? _onError; + final RuntimeEventGate _gate; + late final RuntimeSerialQueue _queue; + bool _disposed = false; + + int get pendingEventCount => _queue.pendingCount; + + void enqueue(RuntimeEvent event) { + if (_disposed || !_gate.session.isActive) { + return; + } + _queue.enqueue(_gate.attachSession(event)); + } + + void dispose() { + _disposed = true; + _queue.dispose(); + } + + void _dispatch(RuntimeEvent event) { + if (!_gate.accepts(event)) { + return; + } + + try { + final diff = _scriptEngine.dispatchEvent(event); + if (_disposed || !_gate.session.isActive || !_gate.accepts(event)) { + return; + } + _applyDiff(diff); + } catch (error) { + _diagnostics?.record( + type: RuntimeDiagnosticType.luaEventError, + message: 'Lua event dispatch failed', + error: error, + context: { + 'eventType': event.type, + if (event.target != null) 'target': event.target, + if (event.handler != null) 'handler': event.handler, + }, + ); + _onError?.call(error); + } + } +} diff --git a/lib/runtime/events/runtime_event_gate.dart b/lib/runtime/events/runtime_event_gate.dart new file mode 100644 index 0000000..b74af07 --- /dev/null +++ b/lib/runtime/events/runtime_event_gate.dart @@ -0,0 +1,47 @@ +import '../lifecycle/runtime_session.dart'; +import '../models/runtime_event.dart'; + +class RuntimeEventGate { + const RuntimeEventGate({ + required this.session, + required bool Function(String id) isScopeAlive, + bool Function(String id, int epoch)? isNodeEpochAlive, + }) : _isScopeAlive = isScopeAlive, + _isNodeEpochAlive = isNodeEpochAlive; + + final RuntimeSession session; + final bool Function(String id) _isScopeAlive; + final bool Function(String id, int epoch)? _isNodeEpochAlive; + + RuntimeEvent attachSession(RuntimeEvent event) { + return event.withLifecycle(sessionId: event.sessionId ?? session.id); + } + + bool accepts(RuntimeEvent event) { + final eventSessionId = event.sessionId; + if (eventSessionId != null && !session.accepts(eventSessionId)) { + return false; + } + + final target = event.target; + final targetEpoch = event.targetEpoch; + final epochChecker = _isNodeEpochAlive; + if (target != null && targetEpoch != null && epochChecker != null) { + if (!epochChecker(target, targetEpoch)) { + return false; + } + } + + final scope = event.scope; + if (scope != null && !_isScopeAlive(scope)) { + return false; + } + final scopeEpoch = event.scopeEpoch; + if (scope != null && scopeEpoch != null && epochChecker != null) { + if (!epochChecker(scope, scopeEpoch)) { + return false; + } + } + return true; + } +} diff --git a/lib/runtime/game/flame_lua_game.dart b/lib/runtime/game/flame_lua_game.dart new file mode 100644 index 0000000..13f227d --- /dev/null +++ b/lib/runtime/game/flame_lua_game.dart @@ -0,0 +1,377 @@ +import 'dart:ui' show PlatformDispatcher; + +import 'package:flame/components.dart'; +import 'package:flame/events.dart'; +import 'package:flame/game.dart'; +import 'package:flutter/material.dart'; + +import '../audio/runtime_audio_manager.dart'; +import '../commands/command_executor.dart'; +import '../diagnostics/runtime_diagnostics.dart'; +import '../events/runtime_event_dispatcher.dart'; +import '../lifecycle/runtime_session.dart'; +import '../models/game_diff.dart'; +import '../models/runtime_event.dart'; +import '../packages/game_package.dart'; +import '../packages/game_package_activation_controller.dart'; +import '../packages/game_package_repository.dart'; +import '../packages/stable_package_store.dart'; +import '../protocol/runtime_protocol.dart'; +import '../rendering/render_tree_controller.dart'; +import '../display/runtime_viewport.dart'; +import '../resources/game_resource_manager.dart'; +import '../scripting/script_engine.dart'; +import 'runtime_locale.dart'; +import 'runtime_options.dart'; + +class FlameLuaGame extends FlameGame with PanDetector, ScrollDetector { + FlameLuaGame({ + required ScriptEngine scriptEngine, + ScriptEngine Function()? scriptEngineFactory, + required GamePackageRepository packageRepository, + required this.gameId, + RuntimeDiagnostics? diagnostics, + this.imageCacheMaxBytes, + this.imageCacheMaxEntries, + this.imageMaxConcurrentLoads = 4, + this.audioCacheMaxBytes, + this.audioCacheMaxEntries, + this.audioMaxConcurrentLoads = 4, + this.audioSfxPoolSize = 8, + this.runtimeOptions = const RuntimeOptions(), + Locale? localeOverride, + }) : _bootstrapScriptEngine = scriptEngine, + _localeOverride = localeOverride, + _scriptEngineFactory = scriptEngineFactory, + _packageRepository = packageRepository, + diagnostics = diagnostics ?? RuntimeDiagnostics(); + + final ScriptEngine _bootstrapScriptEngine; + final ScriptEngine Function()? _scriptEngineFactory; + late ScriptEngine _scriptEngine; + final GamePackageRepository _packageRepository; + final String gameId; + final RuntimeDiagnostics diagnostics; + final int? imageCacheMaxBytes; + final int? imageCacheMaxEntries; + final int imageMaxConcurrentLoads; + final int? audioCacheMaxBytes; + final int? audioCacheMaxEntries; + final int audioMaxConcurrentLoads; + final int audioSfxPoolSize; + final RuntimeOptions runtimeOptions; + final Locale? _localeOverride; + + late final GameResourceManager _resources; + late final RuntimeAudioManager _audio; + late final RenderTreeController _renderTree; + late final PositionComponent _viewportRoot; + RuntimeViewportConfig? _viewportConfig; + late final CommandExecutor _commands; + RuntimeSession? _session; + RuntimeEventDispatcher? _events; + String? _draggingListViewId; + bool _runtimeInitialized = false; + String? loadError; + + List get diagnosticEntries => diagnostics.entries; + + Map diagnosticsDebugJson() => diagnostics.toDebugJson(); + + String diagnosticsDumpText() => diagnostics.dumpText(); + + Map resourcesDebugJson() { + if (!_runtimeInitialized) { + return {'initialized': false}; + } + return { + 'initialized': true, + 'images': _resources.imagesDebugJson(), + 'audio': _audio.audioDebugJson(), + }; + } + + @override + Color backgroundColor() => const Color(0xff0f172a); + + @override + Future onLoad() async { + await super.onLoad(); + + final session = RuntimeSession(gameId: gameId)..beginLoading(); + _session = session; + + try { + final activation = + await PackageActivationController( + repository: _packageRepository, + resources: _createResourceManager(), + scriptEngine: _bootstrapScriptEngine, + audio: _createAudioManager(), + resourceManagerFactory: _createResourceManager, + audioManagerFactory: _createAudioManager, + scriptEngineFactory: _scriptEngineFactory, + store: StablePackageStore(runtimeOptions: runtimeOptions), + assetFallback: AssetGamePackageRepository( + runtimeOptions: runtimeOptions, + ), + ).activate( + gameId: gameId, + contextBuilder: _buildContext, + shouldContinue: () => session.acceptsWork, + ); + if (!session.acceptsWork) { + activation.resources.dispose(); + activation.audio?.dispose(); + return; + } + session.activate(); + + _resources = activation.resources; + _audio = activation.audio ?? _createAudioManager(); + _scriptEngine = activation.scriptEngine; + _viewportConfig = activation.package.manifest.display.toViewportConfig(); + _viewportRoot = PositionComponent(); + add(_viewportRoot); + _applyViewportTransform(); + _renderTree = RenderTreeController( + root: _viewportRoot, + resources: _resources, + eventSink: _emitEvent, + ); + _commands = CommandExecutor( + renderTree: _renderTree, + eventSink: _emitEvent, + audio: _audio, + resources: _resources, + overlaySize: _viewportConfig?.designSize, + ); + _renderTree.onScopeRemoved = _commands.cancelScope; + _events = RuntimeEventDispatcher( + session: session, + scriptEngine: _scriptEngine, + isScopeAlive: _renderTree.contains, + isNodeEpochAlive: _renderTree.isNodeEpochAlive, + applyDiff: _applyDiff, + diagnostics: diagnostics, + onError: (error) => debugPrint('Lua event failed: $error'), + ); + _runtimeInitialized = true; + _applyDiff(activation.initialDiff); + } catch (error) { + session.dispose(); + loadError = error.toString(); + diagnostics.record( + type: RuntimeDiagnosticType.packageActivationError, + message: 'Lua game package activation failed', + error: error, + context: {'gameId': gameId}, + ); + debugPrint('Lua game load failed: $error'); + } + } + + GameResourceManager _createResourceManager() { + return GameResourceManager( + diagnostics: diagnostics, + maxCacheBytes: imageCacheMaxBytes, + maxCacheEntries: imageCacheMaxEntries, + maxConcurrentLoads: imageMaxConcurrentLoads, + ); + } + + RuntimeAudioManager _createAudioManager() { + return RuntimeAudioManager( + diagnostics: diagnostics, + maxSfxPoolSize: audioSfxPoolSize, + maxCacheBytes: audioCacheMaxBytes, + maxCacheEntries: audioCacheMaxEntries, + maxConcurrentLoads: audioMaxConcurrentLoads, + ); + } + + Map _buildContext(GamePackage package) { + final display = package.manifest.display; + final viewport = RuntimeViewport.compute( + screenSize: size, + config: display.toViewportConfig(), + ); + final locale = RuntimeLocaleResolver.resolve( + requested: _localeOverride ?? PlatformDispatcher.instance.locale, + defaultLocale: package.manifest.defaultLocale, + supportedLocales: package.manifest.supportedLocales, + ); + + return { + 'screen': {'width': size.x, 'height': size.y}, + 'design': {'width': display.designWidth, 'height': display.designHeight}, + 'viewport': viewport.toMap(), + 'seed': DateTime.now().millisecondsSinceEpoch, + 'runtimeApiVersion': 1, + 'gameId': package.manifest.gameId, + 'gameVersion': package.manifest.version, + 'locale': locale.toMap(), + }; + } + + void _emitEvent(RuntimeEvent event) { + final session = _session; + if (session == null || !session.isActive) { + return; + } + _events?.enqueue(event.withLifecycle(sessionId: session.id)); + } + + @override + void onScroll(PointerScrollInfo info) { + if (!_runtimeInitialized) { + return; + } + _renderTree.scrollListViewAt( + info.eventPosition.widget, + deltaX: info.scrollDelta.global.x, + deltaY: info.scrollDelta.global.y, + source: 'wheel', + ); + } + + @override + void onPanStart(DragStartInfo info) { + if (!_runtimeInitialized) { + _draggingListViewId = null; + return; + } + _draggingListViewId = _renderTree.listViewAt(info.eventPosition.widget); + final id = _draggingListViewId; + if (id != null) { + _renderTree.stopListViewVelocity(id); + info.handled = true; + } + } + + @override + void onPanUpdate(DragUpdateInfo info) { + final id = _draggingListViewId; + if (!_runtimeInitialized || id == null) { + return; + } + final consumed = _renderTree.scrollListView( + id, + deltaX: -info.delta.global.x, + deltaY: -info.delta.global.y, + source: 'drag', + ); + if (consumed) { + info.handled = true; + } + } + + @override + void onPanEnd(DragEndInfo info) { + final id = _draggingListViewId; + if (id != null) { + _renderTree.setListViewVelocity( + id, + Vector2(-info.velocity.x, -info.velocity.y), + ); + info.handled = true; + } + _draggingListViewId = null; + } + + @override + void onPanCancel() { + _draggingListViewId = null; + } + + @override + void update(double dt) { + super.update(dt); + if (_runtimeInitialized) { + _renderTree.updateListViewInertia(dt); + } + } + + @override + void onGameResize(Vector2 size) { + super.onGameResize(size); + if (_runtimeInitialized) { + _applyViewportTransform(); + _emitResizeEvent(); + } + } + + void _emitResizeEvent() { + final config = _viewportConfig; + if (config == null) { + return; + } + final viewport = RuntimeViewport.compute(screenSize: size, config: config); + _emitEvent( + RuntimeEvent( + type: RuntimeEventType.resize, + data: { + 'screen': {'width': size.x, 'height': size.y}, + 'viewport': viewport.toMap(), + }, + ), + ); + } + + void _applyViewportTransform() { + final config = _viewportConfig; + if (config == null) { + return; + } + RuntimeViewport.apply( + _viewportRoot, + RuntimeViewport.compute(screenSize: size, config: config), + ); + } + + @override + void onRemove() { + _draggingListViewId = null; + _session?.beginDisposing(); + _events?.dispose(); + if (_runtimeInitialized) { + _commands.dispose(); + _renderTree.clear(); + _audio.dispose(); + _resources.dispose(); + } + _session?.dispose(); + super.onRemove(); + } + + void _applyDiff(GameDiff diff) { + final session = _session; + if (session == null || !session.isActive) { + return; + } + try { + _renderTree + ..apply(diff.render) + ..apply(diff.ui); + } catch (error) { + diagnostics.record( + type: RuntimeDiagnosticType.diffApplyError, + message: 'Runtime diff apply failed', + error: error, + ); + debugPrint('Runtime diff apply failed: $error'); + return; + } + + try { + _commands.executeAll(diff.commands); + } catch (error) { + diagnostics.record( + type: RuntimeDiagnosticType.commandError, + message: 'Runtime command execution failed', + error: error, + ); + debugPrint('Runtime command execution failed: $error'); + } + } +} diff --git a/lib/runtime/game/lua_game_widget.dart b/lib/runtime/game/lua_game_widget.dart new file mode 100644 index 0000000..5bff845 --- /dev/null +++ b/lib/runtime/game/lua_game_widget.dart @@ -0,0 +1,45 @@ +import 'package:flame/game.dart'; +import 'package:flutter/widgets.dart'; + +import '../packages/game_package_repository.dart'; +import '../scripting/lua_dardo_script_engine.dart'; +import 'flame_lua_game.dart'; +import 'runtime_options.dart'; + +class LuaGameWidget extends StatelessWidget { + const LuaGameWidget({ + required this.gameId, + this.packageRepository, + this.serverUrl, + this.localeOverride, + this.runtimeOptions = const RuntimeOptions(), + super.key, + }); + + final String gameId; + final GamePackageRepository? packageRepository; + final Uri? serverUrl; + final Locale? localeOverride; + final RuntimeOptions runtimeOptions; + + @override + Widget build(BuildContext context) { + return GameWidget( + game: FlameLuaGame( + scriptEngine: LuaDardoScriptEngine(), + scriptEngineFactory: LuaDardoScriptEngine.new, + packageRepository: + packageRepository ?? + (serverUrl == null + ? AssetGamePackageRepository(runtimeOptions: runtimeOptions) + : RemoteGamePackageRepository( + baseUri: serverUrl!, + runtimeOptions: runtimeOptions, + )), + gameId: gameId, + runtimeOptions: runtimeOptions, + localeOverride: localeOverride, + ), + ); + } +} diff --git a/lib/runtime/game/runtime_locale.dart b/lib/runtime/game/runtime_locale.dart new file mode 100644 index 0000000..501fb9c --- /dev/null +++ b/lib/runtime/game/runtime_locale.dart @@ -0,0 +1,162 @@ +import 'dart:ui' show Locale; + +class RuntimeLocaleInfo { + const RuntimeLocaleInfo({ + required this.requested, + required this.resolved, + required this.defaultLocale, + required this.supportedLocales, + required this.languageCode, + this.scriptCode, + this.countryCode, + }); + + final String requested; + final String resolved; + final String defaultLocale; + final List supportedLocales; + final String languageCode; + final String? scriptCode; + final String? countryCode; + + Map toMap() { + return { + 'requested': requested, + 'resolved': resolved, + 'default': defaultLocale, + 'supported': supportedLocales, + 'languageCode': languageCode, + if (scriptCode != null) 'scriptCode': scriptCode, + if (countryCode != null) 'countryCode': countryCode, + }; + } +} + +class RuntimeLocaleResolver { + const RuntimeLocaleResolver._(); + + static RuntimeLocaleInfo resolve({ + required Locale requested, + required String defaultLocale, + required List supportedLocales, + }) { + final requestedTag = normalizeTag(tagOf(requested)); + final fallback = normalizeTag(defaultLocale); + final supported = supportedLocales.isEmpty + ? [fallback] + : supportedLocales.map(normalizeTag).toList(growable: false); + final resolved = _resolveTag( + requestedTag: requestedTag, + fallback: fallback, + supported: supported, + ); + + return RuntimeLocaleInfo( + requested: requestedTag, + resolved: resolved, + defaultLocale: fallback, + supportedLocales: supported, + languageCode: requested.languageCode, + scriptCode: requested.scriptCode, + countryCode: requested.countryCode, + ); + } + + static Locale localeFromTag(String tag) { + final parts = normalizeTag(tag).split('-'); + if (parts.isEmpty || parts.first.isEmpty) { + throw const FormatException('Locale tag must not be empty'); + } + + String? scriptCode; + String? countryCode; + for (final part in parts.skip(1)) { + if (part.length == 4 && scriptCode == null) { + scriptCode = part; + } else { + countryCode ??= part; + } + } + + return Locale.fromSubtags( + languageCode: parts.first, + scriptCode: scriptCode, + countryCode: countryCode, + ); + } + + static String tagOf(Locale locale) { + final parts = [locale.languageCode]; + final scriptCode = locale.scriptCode; + final countryCode = locale.countryCode; + if (scriptCode != null && scriptCode.isNotEmpty) { + parts.add(scriptCode); + } + if (countryCode != null && countryCode.isNotEmpty) { + parts.add(countryCode); + } + return normalizeTag(parts.join('-')); + } + + static String normalizeTag(String tag) { + final normalized = tag.trim().replaceAll('_', '-'); + if (normalized.isEmpty) { + throw const FormatException('Locale tag must not be empty'); + } + + final parts = normalized + .split('-') + .where((part) => part.isNotEmpty) + .toList(growable: false); + if (parts.isEmpty) { + throw const FormatException('Locale tag must not be empty'); + } + if (!_isLocalePart(parts.first)) { + throw FormatException('Locale language code is invalid: ${parts.first}'); + } + + final result = [parts.first.toLowerCase()]; + for (final part in parts.skip(1)) { + if (!_isLocalePart(part)) { + throw FormatException('Locale tag part is invalid: $part'); + } + if (part.length == 4) { + result.add( + '${part[0].toUpperCase()}${part.substring(1).toLowerCase()}', + ); + } else if (part.length == 2 || part.length == 3) { + result.add(part.toUpperCase()); + } else { + result.add(part.toLowerCase()); + } + } + return result.join('-'); + } + + static String _resolveTag({ + required String requestedTag, + required String fallback, + required List supported, + }) { + final supportedSet = supported.toSet(); + if (supportedSet.contains(requestedTag)) { + return requestedTag; + } + + final requestedLanguage = requestedTag.split('-').first; + for (final candidate in supported) { + if (candidate.split('-').first == requestedLanguage) { + return candidate; + } + } + + if (supportedSet.contains(fallback)) { + return fallback; + } + return supported.first; + } + + static bool _isLocalePart(String value) { + return RegExp(r'^[A-Za-z0-9]{2,8}$').hasMatch(value); + } +} diff --git a/lib/runtime/game/runtime_options.dart b/lib/runtime/game/runtime_options.dart new file mode 100644 index 0000000..746e8e9 --- /dev/null +++ b/lib/runtime/game/runtime_options.dart @@ -0,0 +1,7 @@ +class RuntimeOptions { + const RuntimeOptions({this.runtimeLuaRoot = defaultRuntimeLuaRoot}); + + static const defaultRuntimeLuaRoot = 'assets/runtime/lua'; + + final String runtimeLuaRoot; +} diff --git a/lib/runtime/lifecycle/runtime_async_gate.dart b/lib/runtime/lifecycle/runtime_async_gate.dart new file mode 100644 index 0000000..138a60c --- /dev/null +++ b/lib/runtime/lifecycle/runtime_async_gate.dart @@ -0,0 +1,50 @@ +class RuntimeAsyncGate { + RuntimeAsyncGate({bool initiallyClosed = false}) : _closed = initiallyClosed; + + int _generation = 0; + bool _closed; + + int get generation => _generation; + + bool get isOpen => !_closed; + + bool get isClosed => _closed; + + RuntimeAsyncToken get token => RuntimeAsyncToken._(this, _generation); + + RuntimeAsyncToken activate() { + _closed = false; + _generation++; + return token; + } + + RuntimeAsyncToken advance() { + _generation++; + return token; + } + + RuntimeAsyncToken close() { + _closed = true; + _generation++; + return token; + } + + bool accepts(RuntimeAsyncToken token) { + return !_closed && + identical(token._gate, this) && + token.generation == _generation; + } + + bool acceptsGeneration(int generation) { + return !_closed && generation == _generation; + } +} + +class RuntimeAsyncToken { + const RuntimeAsyncToken._(this._gate, this.generation); + + final RuntimeAsyncGate _gate; + final int generation; + + bool get isAccepted => _gate.accepts(this); +} diff --git a/lib/runtime/lifecycle/runtime_serial_queue.dart b/lib/runtime/lifecycle/runtime_serial_queue.dart new file mode 100644 index 0000000..ff440e5 --- /dev/null +++ b/lib/runtime/lifecycle/runtime_serial_queue.dart @@ -0,0 +1,77 @@ +import 'dart:async' as async; + +class RuntimeSerialQueue { + RuntimeSerialQueue({required this.onItem, bool Function()? shouldContinue}) + : _shouldContinue = shouldContinue; + + final void Function(T item) onItem; + final bool Function()? _shouldContinue; + final List _queue = []; + int _head = 0; + bool _disposed = false; + bool _draining = false; + + int get pendingCount => _queue.length - _head; + + bool get isDraining => _draining; + + bool get isDisposed => _disposed; + + void enqueue(T item) { + if (_disposed || !_canContinue()) { + return; + } + _queue.add(item); + _scheduleDrain(); + } + + void clear() { + _queue.clear(); + _head = 0; + } + + void dispose() { + _disposed = true; + clear(); + } + + void _scheduleDrain() { + if (_draining) { + return; + } + _draining = true; + async.scheduleMicrotask(_drain); + } + + void _drain() { + try { + while (pendingCount > 0 && !_disposed && _canContinue()) { + onItem(_queue[_head++]); + _compactIfNeeded(); + } + } finally { + _draining = false; + } + + if (pendingCount > 0 && !_disposed && _canContinue()) { + _scheduleDrain(); + } + } + + void _compactIfNeeded() { + if (_head == 0) { + return; + } + if (_head == _queue.length) { + clear(); + return; + } + if (_head < 32 || _head * 2 < _queue.length) { + return; + } + _queue.removeRange(0, _head); + _head = 0; + } + + bool _canContinue() => _shouldContinue?.call() ?? true; +} diff --git a/lib/runtime/lifecycle/runtime_session.dart b/lib/runtime/lifecycle/runtime_session.dart new file mode 100644 index 0000000..19f1a3f --- /dev/null +++ b/lib/runtime/lifecycle/runtime_session.dart @@ -0,0 +1,71 @@ +enum RuntimeSessionState { created, loading, active, disposing, disposed } + +class RuntimeSession { + RuntimeSession({required this.gameId}) : id = _nextId++; + + static int _nextId = 1; + + final int id; + final String gameId; + RuntimeSessionState _state = RuntimeSessionState.created; + + RuntimeSessionState get state => _state; + + bool get isLoading => _state == RuntimeSessionState.loading; + + bool get isActive => _state == RuntimeSessionState.active; + + bool get isDisposing => _state == RuntimeSessionState.disposing; + + bool get isDisposed => _state == RuntimeSessionState.disposed; + + bool get acceptsWork => + _state != RuntimeSessionState.disposing && + _state != RuntimeSessionState.disposed; + + void beginLoading() { + _transition( + RuntimeSessionState.loading, + allowedFrom: const {RuntimeSessionState.created}, + ); + } + + void activate() { + _transition( + RuntimeSessionState.active, + allowedFrom: const { + RuntimeSessionState.created, + RuntimeSessionState.loading, + }, + ); + } + + void beginDisposing() { + if (_state == RuntimeSessionState.disposed || + _state == RuntimeSessionState.disposing) { + return; + } + _state = RuntimeSessionState.disposing; + } + + void dispose() { + _state = RuntimeSessionState.disposed; + } + + bool accepts(int sessionId) => isActive && id == sessionId; + + bool acceptsWorkFor(int sessionId) => acceptsWork && id == sessionId; + + void _transition( + RuntimeSessionState next, { + required Set allowedFrom, + }) { + if (_state == next) { + return; + } + if (!allowedFrom.contains(_state)) { + throw StateError('Invalid runtime session transition: $_state -> $next'); + } + _state = next; + } +} diff --git a/lib/runtime/lifecycle/runtime_task_registry.dart b/lib/runtime/lifecycle/runtime_task_registry.dart new file mode 100644 index 0000000..2b9d4a6 --- /dev/null +++ b/lib/runtime/lifecycle/runtime_task_registry.dart @@ -0,0 +1,129 @@ +import 'dart:async' as async; + +class RuntimeTaskRegistry { + RuntimeTaskRegistry({required this.cancelledValue}); + + final T cancelledValue; + final Set> _tasks = {}; + final Map>> _tasksByScope = {}; + bool _disposed = false; + + int get activeTaskCount => _tasks.length; + + int scopedTaskCount(String scope) => _tasksByScope[scope]?.length ?? 0; + + RuntimeTask create({String? scope}) { + if (_disposed) { + throw StateError('RuntimeTaskRegistry has been disposed'); + } + + late final RuntimeTask task; + task = RuntimeTask._( + scope: scope, + cancelledValue: cancelledValue, + onComplete: _unregister, + ); + _tasks.add(task); + if (scope != null) { + _tasksByScope.putIfAbsent(scope, () => {}).add(task); + } + return task; + } + + void cancelScope(String scope) { + final tasks = _tasksByScope[scope]?.toList(growable: false) ?? const []; + for (final task in tasks) { + task.cancel(); + } + } + + void dispose() { + if (_disposed) { + return; + } + _disposed = true; + final tasks = _tasks.toList(growable: false); + for (final task in tasks) { + task.cancel(); + } + _tasks.clear(); + _tasksByScope.clear(); + } + + void _unregister(RuntimeTask task) { + _tasks.remove(task); + final scope = task.scope; + if (scope == null) { + return; + } + final scopedTasks = _tasksByScope[scope]; + scopedTasks?.remove(task); + if (scopedTasks != null && scopedTasks.isEmpty) { + _tasksByScope.remove(scope); + } + } +} + +class RuntimeTask { + RuntimeTask._({ + required this.scope, + required this.cancelledValue, + required void Function(RuntimeTask task) onComplete, + }) : _onComplete = onComplete; + + final String? scope; + final T cancelledValue; + final void Function(RuntimeTask task) _onComplete; + final async.Completer _completer = async.Completer(); + final Set _timers = {}; + final List _cancelCallbacks = []; + bool _cancelled = false; + + Future get future => _completer.future; + + bool get isCancelled => _cancelled; + + void addTimer(async.Timer timer) { + if (_cancelled) { + timer.cancel(); + return; + } + _timers.add(timer); + } + + void removeTimer(async.Timer timer) { + _timers.remove(timer); + } + + void addCancelCallback(void Function() callback) { + if (_cancelled) { + callback(); + return; + } + _cancelCallbacks.add(callback); + } + + void complete(T result) { + if (_completer.isCompleted) { + return; + } + _completer.complete(result); + _onComplete(this); + } + + void cancel() { + if (_cancelled) { + return; + } + _cancelled = true; + for (final timer in _timers) { + timer.cancel(); + } + _timers.clear(); + for (final callback in _cancelCallbacks) { + callback(); + } + _cancelCallbacks.clear(); + complete(cancelledValue); + } +} diff --git a/lib/runtime/models/game_diff.dart b/lib/runtime/models/game_diff.dart new file mode 100644 index 0000000..5e3fdbe --- /dev/null +++ b/lib/runtime/models/game_diff.dart @@ -0,0 +1,173 @@ +import 'runtime_command.dart'; +import 'runtime_node.dart'; + +import '../protocol/runtime_protocol.dart'; + +class NodeUpdate { + const NodeUpdate({required this.id, required this.props}); + + final String id; + final Map props; + + static NodeUpdate fromMap(Map map) { + RuntimeProtocolSchema.ensureKnownKeys( + map, + allowed: RuntimeProtocolSchema.nodeUpdateFields, + context: 'NodeUpdate', + ); + final id = map[RuntimeProtocolField.id]; + if (id is! String || id.isEmpty) { + throw const FormatException('NodeUpdate.id must be a string'); + } + + final props = map[RuntimeProtocolField.props]; + if (props is! Map) { + throw const FormatException('NodeUpdate.props must be a map'); + } + + final typedProps = Map.from(props); + RuntimeProtocolSchema.ensureKnownKeys( + typedProps, + allowed: RuntimeProtocolSchema.nodePropsFields, + context: 'RuntimeNode.props', + ); + + return NodeUpdate(id: id, props: typedProps); + } +} + +class NodeRemove { + const NodeRemove({required this.id}); + + final String id; + + static NodeRemove fromValue(Object? value) { + if (value is String && value.isNotEmpty) { + return NodeRemove(id: value); + } + if (value is Map) { + RuntimeProtocolSchema.ensureKnownKeys( + value, + allowed: RuntimeProtocolSchema.nodeRemoveFields, + context: 'NodeRemove', + ); + final id = value[RuntimeProtocolField.id]; + if (id is String && id.isNotEmpty) { + return NodeRemove(id: id); + } + } + throw const FormatException('NodeRemove must be an id string or {id}'); + } +} + +class NodeDiff { + const NodeDiff({ + this.creates = const [], + this.updates = const [], + this.removes = const [], + }); + + final List creates; + final List updates; + final List removes; + + static NodeDiff empty = const NodeDiff(); + + static NodeDiff fromMap(Object? value) { + if (value == null) { + return NodeDiff.empty; + } + if (value is! Map) { + throw const FormatException('NodeDiff must be a map'); + } + RuntimeProtocolSchema.ensureKnownKeys( + value, + allowed: RuntimeProtocolSchema.nodeDiffFields, + context: 'NodeDiff', + ); + + return NodeDiff( + creates: _readList( + value[RuntimeProtocolField.creates], + (item) => RuntimeNode.fromMap(Map.from(item as Map)), + ), + updates: _readList( + value[RuntimeProtocolField.updates], + (item) => NodeUpdate.fromMap(Map.from(item as Map)), + ), + removes: _readList( + value[RuntimeProtocolField.removes], + NodeRemove.fromValue, + ), + ); + } + + static List _readList(Object? value, T Function(Object? value) mapper) { + if (value == null) { + return const []; + } + if (value is List) { + return value.map(mapper).toList(growable: false); + } + if (value is Map && value.isEmpty) { + return const []; + } + if (value is Map && value.keys.every(_isPositiveIntegerKey)) { + final entries = value.entries.toList() + ..sort( + (a, b) => int.parse( + a.key.toString(), + ).compareTo(int.parse(b.key.toString())), + ); + return entries + .map((entry) => mapper(entry.value)) + .toList(growable: false); + } + throw const FormatException('Diff field must be a list'); + } + + static bool _isPositiveIntegerKey(Object? key) { + final value = int.tryParse(key.toString()); + return value != null && value > 0; + } +} + +class GameDiff { + const GameDiff({ + required this.render, + required this.ui, + required this.commands, + }); + + final NodeDiff render; + final NodeDiff ui; + final List commands; + + static const empty = GameDiff( + render: NodeDiff(), + ui: NodeDiff(), + commands: [], + ); + + static GameDiff fromMap(Map map) { + RuntimeProtocolSchema.ensureKnownKeys( + map, + allowed: RuntimeProtocolSchema.gameDiffFields, + context: 'GameDiff', + ); + final commandsValue = map[RuntimeProtocolField.commands]; + final commands = commandsValue == null + ? const [] + : NodeDiff._readList( + commandsValue, + (item) => + RuntimeCommand.fromMap(Map.from(item as Map)), + ); + + return GameDiff( + render: NodeDiff.fromMap(map[RuntimeProtocolField.render]), + ui: NodeDiff.fromMap(map[RuntimeProtocolField.ui]), + commands: commands, + ); + } +} diff --git a/lib/runtime/models/runtime_command.dart b/lib/runtime/models/runtime_command.dart new file mode 100644 index 0000000..78f30f2 --- /dev/null +++ b/lib/runtime/models/runtime_command.dart @@ -0,0 +1,43 @@ +import '../protocol/runtime_protocol.dart'; + +class RuntimeCommand { + const RuntimeCommand({ + required this.type, + this.target, + this.payload = const {}, + }); + + final String type; + final String? target; + final Map payload; + + static RuntimeCommand fromMap(Map map) { + final type = map[RuntimeProtocolField.type]; + if (type is! String || type.isEmpty) { + throw const FormatException('RuntimeCommand.type must be a string'); + } + + if (!RuntimeCommandType.isSupported(type)) { + throw FormatException('RuntimeCommand.type is unsupported: $type'); + } + RuntimeProtocolSchema.ensureKnownKeys( + map, + allowed: RuntimeProtocolSchema.allowedCommandFields(type), + context: 'RuntimeCommand.$type', + ); + + final targetValue = map[RuntimeProtocolField.target]; + if (targetValue != null && targetValue is! String) { + throw const FormatException('RuntimeCommand.target must be a string'); + } + + final payload = Map.from(map) + ..remove(RuntimeProtocolField.type) + ..remove(RuntimeProtocolField.target); + return RuntimeCommand( + type: type, + target: targetValue as String?, + payload: payload, + ); + } +} diff --git a/lib/runtime/models/runtime_event.dart b/lib/runtime/models/runtime_event.dart new file mode 100644 index 0000000..c591ef3 --- /dev/null +++ b/lib/runtime/models/runtime_event.dart @@ -0,0 +1,64 @@ +class RuntimeEvent { + const RuntimeEvent({ + required this.type, + this.target, + this.handler, + this.x, + this.y, + this.data = const {}, + this.sessionId, + this.scope, + this.targetEpoch, + this.scopeEpoch, + }); + + final String type; + final String? target; + final String? handler; + final double? x; + final double? y; + final Map data; + + /// Runtime-internal lifecycle session. Not exposed to Lua. + final int? sessionId; + + /// Runtime-internal lifecycle scope. Not exposed to Lua. + final String? scope; + + /// Runtime-internal target node epoch. Not exposed to Lua. + final int? targetEpoch; + + /// Runtime-internal scope node epoch. Not exposed to Lua. + final int? scopeEpoch; + + RuntimeEvent withLifecycle({ + int? sessionId, + String? scope, + int? targetEpoch, + int? scopeEpoch, + }) { + return RuntimeEvent( + type: type, + target: target, + handler: handler, + x: x, + y: y, + data: data, + sessionId: sessionId ?? this.sessionId, + scope: scope ?? this.scope, + targetEpoch: targetEpoch ?? this.targetEpoch, + scopeEpoch: scopeEpoch ?? this.scopeEpoch, + ); + } + + Map toMap() { + return { + 'type': type, + if (target != null) 'target': target, + if (handler != null) 'handler': handler, + if (x != null) 'x': x, + if (y != null) 'y': y, + if (data.isNotEmpty) 'data': data, + }; + } +} diff --git a/lib/runtime/models/runtime_node.dart b/lib/runtime/models/runtime_node.dart new file mode 100644 index 0000000..e7c82b4 --- /dev/null +++ b/lib/runtime/models/runtime_node.dart @@ -0,0 +1,572 @@ +import 'package:flutter/material.dart'; + +import '../protocol/runtime_protocol.dart'; + +class RuntimeNode { + const RuntimeNode({ + required this.id, + required this.type, + this.parent, + this.asset, + this.pressedAsset, + this.disabledAsset, + this.animation, + this.skin, + this.loop = true, + this.text, + this.x = 0, + this.y = 0, + this.width, + this.height, + this.paddingLeft = 0, + this.paddingTop = 0, + this.paddingRight = 0, + this.paddingBottom = 0, + this.anchor = RuntimeAnchorValue.topLeft, + this.layer = 0, + this.visible = true, + this.alpha = 1, + this.scale = 1, + this.rotation = 0, + this.color, + this.fontSize, + this.textAlign = RuntimeTextAlignValue.center, + this.radius, + this.strokeWidth, + this.value, + this.scrollX = 0, + this.scrollY = 0, + this.contentWidth, + this.contentHeight, + this.virtualized = false, + this.cacheExtent = 0, + this.inertia = true, + this.scrollbarThumbColor, + this.scrollbarTrackColor, + this.scrollbarThickness, + this.scrollbarVisible = true, + this.interactive = false, + this.onTap, + this.onScroll, + this.preset, + this.count, + this.duration, + this.speedMin, + this.speedMax, + this.gravityX, + this.gravityY, + this.spread, + this.colorTo, + this.radiusTo, + this.autoRemove = true, + this.fadeOut = true, + }); + + final String id; + final String type; + final String? parent; + final String? asset; + final String? pressedAsset; + final String? disabledAsset; + final String? animation; + final String? skin; + final bool loop; + final String? text; + final double x; + final double y; + final double? width; + final double? height; + final double paddingLeft; + final double paddingTop; + final double paddingRight; + final double paddingBottom; + final String anchor; + final int layer; + final bool visible; + final double alpha; + final double scale; + final double rotation; + final Color? color; + final double? fontSize; + final String textAlign; + final double? radius; + final double? strokeWidth; + final double? value; + final double scrollX; + final double scrollY; + final double? contentWidth; + final double? contentHeight; + final bool virtualized; + final double cacheExtent; + final bool inertia; + final Color? scrollbarThumbColor; + final Color? scrollbarTrackColor; + final double? scrollbarThickness; + final bool scrollbarVisible; + final bool interactive; + final String? onTap; + final String? onScroll; + final String? preset; + final int? count; + final double? duration; + final double? speedMin; + final double? speedMax; + final double? gravityX; + final double? gravityY; + final double? spread; + final Color? colorTo; + final double? radiusTo; + final bool autoRemove; + final bool fadeOut; + + RuntimeNode copyWithProps(Map props) { + RuntimeProtocolSchema.ensureKnownKeys( + props, + allowed: RuntimeProtocolSchema.nodePropsFields, + context: 'RuntimeNode.props', + ); + final nextType = _stringProp(props, RuntimeProtocolField.type) ?? type; + if (!RuntimeNodeType.isSupported(nextType)) { + throw FormatException('RuntimeNode.type is unsupported: $nextType'); + } + final nextAnchor = + _stringProp(props, RuntimeProtocolField.anchor) ?? anchor; + if (!RuntimeAnchorValue.isSupported(nextAnchor)) { + throw FormatException('RuntimeNode.anchor is unsupported: $nextAnchor'); + } + final nextTextAlign = + _stringProp(props, RuntimeProtocolField.textAlign) ?? textAlign; + if (!RuntimeTextAlignValue.isSupported(nextTextAlign)) { + throw FormatException( + 'RuntimeNode.textAlign is unsupported: $nextTextAlign', + ); + } + + final nextPreset = + _stringProp(props, RuntimeProtocolField.preset) ?? preset; + _validateParticlePreset(nextPreset); + + final nextWidth = _doubleProp(props, RuntimeProtocolField.width) ?? width; + final nextHeight = + _doubleProp(props, RuntimeProtocolField.height) ?? height; + final nextContentWidth = + _doubleProp(props, RuntimeProtocolField.contentWidth) ?? contentWidth; + final nextContentHeight = + _doubleProp(props, RuntimeProtocolField.contentHeight) ?? contentHeight; + final nextPaddingLeft = + _nonNegativeDoubleProp(props, RuntimeProtocolField.paddingLeft) ?? + paddingLeft; + final nextPaddingTop = + _nonNegativeDoubleProp(props, RuntimeProtocolField.paddingTop) ?? + paddingTop; + final nextPaddingRight = + _nonNegativeDoubleProp(props, RuntimeProtocolField.paddingRight) ?? + paddingRight; + final nextPaddingBottom = + _nonNegativeDoubleProp(props, RuntimeProtocolField.paddingBottom) ?? + paddingBottom; + final nextViewportWidth = nextWidth == null + ? null + : (nextWidth - nextPaddingLeft - nextPaddingRight) + .clamp(0.0, nextWidth) + .toDouble(); + final nextViewportHeight = nextHeight == null + ? null + : (nextHeight - nextPaddingTop - nextPaddingBottom) + .clamp(0.0, nextHeight) + .toDouble(); + final nextScrollX = props.containsKey(RuntimeProtocolField.scrollX) + ? _scrollProp( + props, + RuntimeProtocolField.scrollX, + contentExtent: nextContentWidth, + viewportExtent: nextViewportWidth, + )! + : _clampScroll( + scrollX, + contentExtent: nextContentWidth, + viewportExtent: nextViewportWidth, + ); + final nextScrollY = props.containsKey(RuntimeProtocolField.scrollY) + ? _scrollProp( + props, + RuntimeProtocolField.scrollY, + contentExtent: nextContentHeight, + viewportExtent: nextViewportHeight, + )! + : _clampScroll( + scrollY, + contentExtent: nextContentHeight, + viewportExtent: nextViewportHeight, + ); + + return RuntimeNode( + id: id, + type: nextType, + parent: _parentProp(props, currentParent: parent, nodeId: id), + asset: _stringProp(props, RuntimeProtocolField.asset) ?? asset, + pressedAsset: + _stringProp(props, RuntimeProtocolField.pressedAsset) ?? pressedAsset, + disabledAsset: + _stringProp(props, RuntimeProtocolField.disabledAsset) ?? + disabledAsset, + animation: + _stringProp(props, RuntimeProtocolField.animation) ?? animation, + skin: _stringProp(props, RuntimeProtocolField.skin) ?? skin, + loop: _boolProp(props, RuntimeProtocolField.loop) ?? loop, + text: _stringProp(props, RuntimeProtocolField.text) ?? text, + x: _doubleProp(props, RuntimeProtocolField.x) ?? x, + y: _doubleProp(props, RuntimeProtocolField.y) ?? y, + width: nextWidth, + height: nextHeight, + paddingLeft: nextPaddingLeft, + paddingTop: nextPaddingTop, + paddingRight: nextPaddingRight, + paddingBottom: nextPaddingBottom, + anchor: nextAnchor, + layer: _intProp(props, RuntimeProtocolField.layer) ?? layer, + visible: _boolProp(props, RuntimeProtocolField.visible) ?? visible, + alpha: _doubleProp(props, RuntimeProtocolField.alpha) ?? alpha, + scale: _doubleProp(props, RuntimeProtocolField.scale) ?? scale, + rotation: _doubleProp(props, RuntimeProtocolField.rotation) ?? rotation, + color: _colorProp(props, RuntimeProtocolField.color) ?? color, + fontSize: _doubleProp(props, RuntimeProtocolField.fontSize) ?? fontSize, + textAlign: nextTextAlign, + radius: _doubleProp(props, RuntimeProtocolField.radius) ?? radius, + strokeWidth: + _doubleProp(props, RuntimeProtocolField.strokeWidth) ?? strokeWidth, + value: _normalizedValueProp(props, RuntimeProtocolField.value) ?? value, + scrollX: nextScrollX, + scrollY: nextScrollY, + contentWidth: nextContentWidth, + contentHeight: nextContentHeight, + virtualized: + _boolProp(props, RuntimeProtocolField.virtualized) ?? virtualized, + cacheExtent: + _nonNegativeDoubleProp(props, RuntimeProtocolField.cacheExtent) ?? + cacheExtent, + inertia: _boolProp(props, RuntimeProtocolField.inertia) ?? inertia, + scrollbarThumbColor: + _colorProp(props, RuntimeProtocolField.scrollbarThumbColor) ?? + scrollbarThumbColor, + scrollbarTrackColor: + _colorProp(props, RuntimeProtocolField.scrollbarTrackColor) ?? + scrollbarTrackColor, + scrollbarThickness: + _nonNegativeDoubleProp( + props, + RuntimeProtocolField.scrollbarThickness, + ) ?? + scrollbarThickness, + scrollbarVisible: + _boolProp(props, RuntimeProtocolField.scrollbarVisible) ?? + scrollbarVisible, + interactive: + _boolProp(props, RuntimeProtocolField.interactive) ?? interactive, + onTap: _stringProp(props, RuntimeProtocolField.onTap) ?? onTap, + onScroll: _stringProp(props, RuntimeProtocolField.onScroll) ?? onScroll, + preset: nextPreset, + count: _positiveIntProp(props, RuntimeProtocolField.count) ?? count, + duration: + _nonNegativeDoubleProp(props, RuntimeProtocolField.duration) ?? + duration, + speedMin: + _nonNegativeDoubleProp(props, RuntimeProtocolField.speedMin) ?? + speedMin, + speedMax: + _nonNegativeDoubleProp(props, RuntimeProtocolField.speedMax) ?? + speedMax, + gravityX: _doubleProp(props, RuntimeProtocolField.gravityX) ?? gravityX, + gravityY: _doubleProp(props, RuntimeProtocolField.gravityY) ?? gravityY, + spread: + _nonNegativeDoubleProp(props, RuntimeProtocolField.spread) ?? spread, + colorTo: _colorProp(props, RuntimeProtocolField.colorTo) ?? colorTo, + radiusTo: + _nonNegativeDoubleProp(props, RuntimeProtocolField.radiusTo) ?? + radiusTo, + autoRemove: + _boolProp(props, RuntimeProtocolField.autoRemove) ?? autoRemove, + fadeOut: _boolProp(props, RuntimeProtocolField.fadeOut) ?? fadeOut, + ); + } + + static RuntimeNode fromMap(Map map) { + RuntimeProtocolSchema.ensureKnownKeys( + map, + allowed: RuntimeProtocolSchema.nodeFields, + context: 'RuntimeNode', + ); + final type = _requiredString(map, RuntimeProtocolField.type); + if (!RuntimeNodeType.isSupported(type)) { + throw FormatException('RuntimeNode.type is unsupported: $type'); + } + final anchor = + _stringProp(map, RuntimeProtocolField.anchor) ?? + RuntimeAnchorValue.topLeft; + if (!RuntimeAnchorValue.isSupported(anchor)) { + throw FormatException('RuntimeNode.anchor is unsupported: $anchor'); + } + final textAlign = + _stringProp(map, RuntimeProtocolField.textAlign) ?? + RuntimeTextAlignValue.center; + if (!RuntimeTextAlignValue.isSupported(textAlign)) { + throw FormatException('RuntimeNode.textAlign is unsupported: $textAlign'); + } + + final preset = _stringProp(map, RuntimeProtocolField.preset); + _validateParticlePreset(preset); + + return RuntimeNode( + id: _requiredString(map, RuntimeProtocolField.id), + type: type, + parent: _parentProp( + map, + currentParent: null, + nodeId: _requiredString(map, RuntimeProtocolField.id), + ), + asset: _stringProp(map, RuntimeProtocolField.asset), + pressedAsset: _stringProp(map, RuntimeProtocolField.pressedAsset), + disabledAsset: _stringProp(map, RuntimeProtocolField.disabledAsset), + animation: _stringProp(map, RuntimeProtocolField.animation), + skin: _stringProp(map, RuntimeProtocolField.skin), + loop: _boolProp(map, RuntimeProtocolField.loop) ?? true, + text: _stringProp(map, RuntimeProtocolField.text), + x: _doubleProp(map, RuntimeProtocolField.x) ?? 0, + y: _doubleProp(map, RuntimeProtocolField.y) ?? 0, + width: _doubleProp(map, RuntimeProtocolField.width), + height: _doubleProp(map, RuntimeProtocolField.height), + paddingLeft: + _nonNegativeDoubleProp(map, RuntimeProtocolField.paddingLeft) ?? 0, + paddingTop: + _nonNegativeDoubleProp(map, RuntimeProtocolField.paddingTop) ?? 0, + paddingRight: + _nonNegativeDoubleProp(map, RuntimeProtocolField.paddingRight) ?? 0, + paddingBottom: + _nonNegativeDoubleProp(map, RuntimeProtocolField.paddingBottom) ?? 0, + anchor: anchor, + layer: _intProp(map, RuntimeProtocolField.layer) ?? 0, + visible: _boolProp(map, RuntimeProtocolField.visible) ?? true, + alpha: _doubleProp(map, RuntimeProtocolField.alpha) ?? 1, + scale: _doubleProp(map, RuntimeProtocolField.scale) ?? 1, + rotation: _doubleProp(map, RuntimeProtocolField.rotation) ?? 0, + color: _colorProp(map, RuntimeProtocolField.color), + fontSize: _doubleProp(map, RuntimeProtocolField.fontSize), + textAlign: textAlign, + radius: _doubleProp(map, RuntimeProtocolField.radius), + strokeWidth: _doubleProp(map, RuntimeProtocolField.strokeWidth), + value: _normalizedValueProp(map, RuntimeProtocolField.value), + scrollX: + _scrollProp( + map, + RuntimeProtocolField.scrollX, + contentExtent: _doubleProp(map, RuntimeProtocolField.contentWidth), + viewportExtent: _doubleProp(map, RuntimeProtocolField.width), + ) ?? + 0, + scrollY: + _scrollProp( + map, + RuntimeProtocolField.scrollY, + contentExtent: _doubleProp(map, RuntimeProtocolField.contentHeight), + viewportExtent: _doubleProp(map, RuntimeProtocolField.height), + ) ?? + 0, + contentWidth: _doubleProp(map, RuntimeProtocolField.contentWidth), + contentHeight: _doubleProp(map, RuntimeProtocolField.contentHeight), + virtualized: _boolProp(map, RuntimeProtocolField.virtualized) ?? false, + cacheExtent: + _nonNegativeDoubleProp(map, RuntimeProtocolField.cacheExtent) ?? 0, + inertia: _boolProp(map, RuntimeProtocolField.inertia) ?? true, + scrollbarThumbColor: _colorProp( + map, + RuntimeProtocolField.scrollbarThumbColor, + ), + scrollbarTrackColor: _colorProp( + map, + RuntimeProtocolField.scrollbarTrackColor, + ), + scrollbarThickness: _nonNegativeDoubleProp( + map, + RuntimeProtocolField.scrollbarThickness, + ), + scrollbarVisible: + _boolProp(map, RuntimeProtocolField.scrollbarVisible) ?? true, + interactive: _boolProp(map, RuntimeProtocolField.interactive) ?? false, + onTap: _stringProp(map, RuntimeProtocolField.onTap), + onScroll: _stringProp(map, RuntimeProtocolField.onScroll), + preset: preset, + count: _positiveIntProp(map, RuntimeProtocolField.count), + duration: _nonNegativeDoubleProp(map, RuntimeProtocolField.duration), + speedMin: _nonNegativeDoubleProp(map, RuntimeProtocolField.speedMin), + speedMax: _nonNegativeDoubleProp(map, RuntimeProtocolField.speedMax), + gravityX: _doubleProp(map, RuntimeProtocolField.gravityX), + gravityY: _doubleProp(map, RuntimeProtocolField.gravityY), + spread: _nonNegativeDoubleProp(map, RuntimeProtocolField.spread), + colorTo: _colorProp(map, RuntimeProtocolField.colorTo), + radiusTo: _nonNegativeDoubleProp(map, RuntimeProtocolField.radiusTo), + autoRemove: _boolProp(map, RuntimeProtocolField.autoRemove) ?? true, + fadeOut: _boolProp(map, RuntimeProtocolField.fadeOut) ?? true, + ); + } + + static String _requiredString(Map map, String key) { + final value = map[key]; + if (value is String && value.isNotEmpty) { + return value; + } + throw FormatException('RuntimeNode.$key must be a non-empty string'); + } + + static void _validateParticlePreset(String? preset) { + if (preset != null && !RuntimeParticlePresetValue.isSupported(preset)) { + throw FormatException('RuntimeNode.preset is unsupported: $preset'); + } + } + + static String? _stringProp(Map map, String key) { + final value = map[key]; + if (value == null) { + return null; + } + if (value is String) { + return value; + } + throw FormatException('RuntimeNode.$key must be a string'); + } + + static String? _parentProp( + Map map, { + required String? currentParent, + required String nodeId, + }) { + if (!map.containsKey(RuntimeProtocolField.parent)) { + return currentParent; + } + + final value = _stringProp(map, RuntimeProtocolField.parent); + if (value == null || value.isEmpty) { + return null; + } + if (value == nodeId) { + throw const FormatException('RuntimeNode.parent cannot reference itself'); + } + return value; + } + + static bool? _boolProp(Map map, String key) { + final value = map[key]; + if (value == null) { + return null; + } + if (value is bool) { + return value; + } + throw FormatException('RuntimeNode.$key must be a boolean'); + } + + static double? _doubleProp(Map map, String key) { + final value = map[key]; + if (value == null) { + return null; + } + if (value is num) { + return value.toDouble(); + } + throw FormatException('RuntimeNode.$key must be a number'); + } + + static double? _normalizedValueProp(Map map, String key) { + final value = _doubleProp(map, key); + if (value == null) { + return null; + } + if (value < 0 || value > 1) { + throw FormatException('RuntimeNode.$key must be between 0 and 1'); + } + return value; + } + + static double? _nonNegativeDoubleProp(Map map, String key) { + final value = _doubleProp(map, key); + if (value == null) { + return null; + } + if (value < 0) { + throw FormatException('RuntimeNode.$key must be >= 0'); + } + return value; + } + + static double? _scrollProp( + Map map, + String key, { + required double? contentExtent, + required double? viewportExtent, + }) { + final value = _doubleProp(map, key); + if (value == null) { + return null; + } + if (value < 0) { + throw FormatException('RuntimeNode.$key must be >= 0'); + } + return _clampScroll( + value, + contentExtent: contentExtent, + viewportExtent: viewportExtent, + ); + } + + static double _clampScroll( + double value, { + required double? contentExtent, + required double? viewportExtent, + }) { + final maxScroll = (contentExtent ?? 0) - (viewportExtent ?? 0); + if (maxScroll <= 0) { + return 0; + } + return value.clamp(0, maxScroll).toDouble(); + } + + static int? _positiveIntProp(Map map, String key) { + final value = _intProp(map, key); + if (value == null) { + return null; + } + if (value <= 0) { + throw FormatException('RuntimeNode.$key must be > 0'); + } + return value; + } + + static int? _intProp(Map map, String key) { + final value = map[key]; + if (value == null) { + return null; + } + if (value is num) { + return value.toInt(); + } + throw FormatException('RuntimeNode.$key must be an integer'); + } + + static Color? _colorProp(Map map, String key) { + final value = map[key]; + if (value == null) { + return null; + } + if (value is! String || !value.startsWith('#')) { + throw FormatException('RuntimeNode.$key must be a hex color'); + } + + final hex = value.substring(1); + if (hex.length == 6) { + return Color(int.parse('ff$hex', radix: 16)); + } + if (hex.length == 8) { + return Color(int.parse(hex, radix: 16)); + } + throw FormatException('RuntimeNode.$key must be #RRGGBB or #AARRGGBB'); + } +} diff --git a/lib/runtime/packages/game_package.dart b/lib/runtime/packages/game_package.dart new file mode 100644 index 0000000..2ebe129 --- /dev/null +++ b/lib/runtime/packages/game_package.dart @@ -0,0 +1,96 @@ +import 'dart:io'; + +import 'package:flutter/services.dart'; + +import '../game/runtime_options.dart'; +import 'game_package_manifest.dart'; + +class GamePackage { + const GamePackage.asset({ + required this.rootPath, + required this.manifest, + this.runtimeLuaRoot = RuntimeOptions.defaultRuntimeLuaRoot, + }) : source = GamePackageSource.asset; + + static const runtimeLuaPrefix = 'runtime:'; + + const GamePackage.file({ + required this.rootPath, + required this.manifest, + this.runtimeLuaRoot = RuntimeOptions.defaultRuntimeLuaRoot, + }) : source = GamePackageSource.file; + + final String rootPath; + final GamePackageSource source; + final GamePackageManifest manifest; + final String runtimeLuaRoot; + + String get entryPath => _join(rootPath, manifest.entry); + + bool get isAsset => source == GamePackageSource.asset; + + Future readText(String relativeOrAbsolutePath) async { + final runtimePath = _resolveRuntimeLuaPath(relativeOrAbsolutePath); + if (runtimePath != null) { + return rootBundle.loadString(runtimePath); + } + + final path = _resolvePackagePath(relativeOrAbsolutePath); + if (isAsset) { + return rootBundle.loadString(path); + } + return File(path).readAsString(); + } + + Future readBytes(String relativeOrAbsolutePath) async { + final path = _resolvePackagePath(relativeOrAbsolutePath); + if (isAsset) { + return rootBundle.load(path); + } + final bytes = await File(path).readAsBytes(); + return ByteData.sublistView(bytes); + } + + String resolveResourcePath(String keyOrPath) { + final resource = manifest.resources[keyOrPath]; + if (resource != null) { + return _join(rootPath, resource.path); + } + + if (keyOrPath.startsWith(rootPath)) { + return keyOrPath; + } + if (keyOrPath.contains('/')) { + return _join(rootPath, keyOrPath); + } + return _join(_join(rootPath, manifest.assetsBase), keyOrPath); + } + + String _resolvePackagePath(String relativeOrAbsolutePath) { + if (relativeOrAbsolutePath.startsWith(rootPath)) { + return relativeOrAbsolutePath; + } + return _join(rootPath, relativeOrAbsolutePath); + } + + String? _resolveRuntimeLuaPath(String path) { + if (!path.startsWith(runtimeLuaPrefix)) { + return null; + } + final name = path.substring(runtimeLuaPrefix.length); + if (name.isEmpty || name.contains('/') || name.contains('..')) { + throw FormatException('Invalid runtime Lua module path: $path'); + } + return _join(runtimeLuaRoot, name); + } + + String _join(String left, String right) { + final normalizedLeft = left.endsWith('/') + ? left.substring(0, left.length - 1) + : left; + final normalizedRight = right.startsWith('/') ? right.substring(1) : right; + return '$normalizedLeft/$normalizedRight'; + } +} + +enum GamePackageSource { asset, file } diff --git a/lib/runtime/packages/game_package_activation_controller.dart b/lib/runtime/packages/game_package_activation_controller.dart new file mode 100644 index 0000000..2f6e32e --- /dev/null +++ b/lib/runtime/packages/game_package_activation_controller.dart @@ -0,0 +1,231 @@ +import '../audio/runtime_audio_manager.dart'; +import '../models/game_diff.dart'; +import '../resources/game_resource_manager.dart'; +import '../scripting/script_engine.dart'; +import 'game_package.dart'; +import 'game_package_repository.dart'; +import 'package_verifier.dart'; +import 'stable_package_store.dart'; + +class PackageActivationController { + const PackageActivationController({ + required this.repository, + required this.resources, + required this.scriptEngine, + this.audio, + this.runtimeApiVersion = 1, + this.store = const StablePackageStore(), + this.assetFallback = const AssetGamePackageRepository(), + this.resourceManagerFactory, + this.audioManagerFactory, + this.scriptEngineFactory, + }); + + final GamePackageRepository repository; + final GameResourceManager resources; + final ScriptEngine scriptEngine; + final RuntimeAudioManager? audio; + final int runtimeApiVersion; + final StablePackageStore store; + final GamePackageRepository assetFallback; + final GameResourceManager Function()? resourceManagerFactory; + final RuntimeAudioManager Function()? audioManagerFactory; + final ScriptEngine Function()? scriptEngineFactory; + + Future activate({ + required String gameId, + required Map Function(GamePackage package) contextBuilder, + bool Function()? shouldContinue, + }) async { + final plan = await prepare( + gameId: gameId, + contextBuilder: contextBuilder, + shouldContinue: shouldContinue, + ); + await commit(plan, shouldContinue: shouldContinue); + return PackageActivationResult.fromPlan(plan); + } + + Future prepare({ + required String gameId, + required Map Function(GamePackage package) contextBuilder, + bool Function()? shouldContinue, + }) async { + final verifier = PackageVerifier(runtimeApiVersion: runtimeApiVersion); + final candidates = await _candidatePackages(gameId, shouldContinue); + + Object? lastError; + for (final candidate in candidates) { + try { + _ensureContinue(shouldContinue); + final plan = await _prepareCandidate( + candidate: candidate, + verifier: verifier, + contextBuilder: contextBuilder, + shouldContinue: shouldContinue, + ); + return plan; + } catch (error) { + if (shouldContinue != null && !shouldContinue()) { + rethrow; + } + lastError = error; + } + } + + throw StateError( + 'No activatable package for $gameId. Last error: $lastError', + ); + } + + Future commit( + PackageActivationPlan plan, { + bool Function()? shouldContinue, + }) async { + _ensureContinue(shouldContinue); + await store.markStable(plan.package); + _ensureContinue(shouldContinue); + } + + Future> _candidatePackages( + String gameId, + bool Function()? shouldContinue, + ) async { + final candidates = []; + + try { + final package = await repository.load(gameId); + _ensureContinue(shouldContinue); + candidates.add(package); + } catch (_) { + // Continue with stable/fallback candidates. + } + _ensureContinue(shouldContinue); + + final stable = await store.stablePackage(gameId); + if (stable != null && !_containsPackage(candidates, stable)) { + candidates.add(stable); + } + + _ensureContinue(shouldContinue); + + final previous = await store.previousStablePackage(gameId); + if (previous != null && !_containsPackage(candidates, previous)) { + candidates.add(previous); + } + + _ensureContinue(shouldContinue); + + final fallback = await assetFallback.load(gameId); + if (!_containsPackage(candidates, fallback)) { + candidates.add(fallback); + } + _ensureContinue(shouldContinue); + + return candidates; + } + + Future _prepareCandidate({ + required GamePackage candidate, + required PackageVerifier verifier, + required Map Function(GamePackage package) contextBuilder, + required bool Function()? shouldContinue, + }) async { + final preparedResources = resourceManagerFactory?.call() ?? resources; + final preparedAudio = audioManagerFactory?.call() ?? audio; + final preparedScriptEngine = scriptEngineFactory?.call() ?? scriptEngine; + final ownsPreparedResources = preparedResources != resources; + final ownsPreparedAudio = preparedAudio != null && preparedAudio != audio; + + try { + await verifier.verify(candidate); + _ensureContinue(shouldContinue); + await preparedResources.mount(candidate); + _ensureContinue(shouldContinue); + await preparedAudio?.mount(candidate); + _ensureContinue(shouldContinue); + await preparedScriptEngine.loadPackage(candidate); + _ensureContinue(shouldContinue); + + final context = contextBuilder(candidate); + _ensureContinue(shouldContinue); + if (!preparedScriptEngine.smokeTest(context)) { + throw StateError('Lua package smoke_test returned false'); + } + + _ensureContinue(shouldContinue); + final diff = preparedScriptEngine.init(context); + _ensureContinue(shouldContinue); + return PackageActivationPlan( + package: candidate, + initialDiff: diff, + resources: preparedResources, + scriptEngine: preparedScriptEngine, + audio: preparedAudio, + ); + } catch (_) { + if (ownsPreparedResources) { + preparedResources.dispose(); + } + if (ownsPreparedAudio) { + preparedAudio.dispose(); + } + rethrow; + } + } + + void _ensureContinue(bool Function()? shouldContinue) { + if (shouldContinue != null && !shouldContinue()) { + throw StateError('Package activation cancelled'); + } + } + + bool _containsPackage(List packages, GamePackage package) { + return packages.any( + (item) => + item.source == package.source && item.rootPath == package.rootPath, + ); + } +} + +class PackageActivationPlan { + const PackageActivationPlan({ + required this.package, + required this.initialDiff, + required this.resources, + required this.scriptEngine, + this.audio, + }); + + final GamePackage package; + final GameDiff initialDiff; + final GameResourceManager resources; + final ScriptEngine scriptEngine; + final RuntimeAudioManager? audio; +} + +class PackageActivationResult { + const PackageActivationResult({ + required this.package, + required this.initialDiff, + required this.resources, + required this.scriptEngine, + this.audio, + }); + + factory PackageActivationResult.fromPlan(PackageActivationPlan plan) { + return PackageActivationResult( + package: plan.package, + initialDiff: plan.initialDiff, + resources: plan.resources, + scriptEngine: plan.scriptEngine, + audio: plan.audio, + ); + } + + final GamePackage package; + final GameDiff initialDiff; + final GameResourceManager resources; + final ScriptEngine scriptEngine; + final RuntimeAudioManager? audio; +} diff --git a/lib/runtime/packages/game_package_manifest.dart b/lib/runtime/packages/game_package_manifest.dart new file mode 100644 index 0000000..e3ad011 --- /dev/null +++ b/lib/runtime/packages/game_package_manifest.dart @@ -0,0 +1,265 @@ +import 'dart:convert'; + +import '../display/runtime_viewport.dart'; + +class GamePackageManifest { + const GamePackageManifest({ + required this.gameId, + required this.name, + required this.version, + required this.runtimeApiVersion, + required this.entry, + required this.assetsBase, + this.defaultLocale = 'en', + this.supportedLocales = const ['en'], + this.display = const GameDisplayConfig(), + this.resources = const {}, + this.modules = const {}, + }); + + final String gameId; + final String name; + final String version; + final int runtimeApiVersion; + final String entry; + final String assetsBase; + final String defaultLocale; + final List supportedLocales; + final GameDisplayConfig display; + final Map resources; + final Map modules; + + static GamePackageManifest fromJsonString(String source) { + return fromMap(jsonDecode(source) as Map); + } + + static GamePackageManifest fromMap(Map map) { + final resourcesValue = map['resources']; + final resources = {}; + if (resourcesValue is Map) { + for (final entry in resourcesValue.entries) { + if (entry.key is! String || entry.value is! Map) { + throw const FormatException('manifest.resources must be a map'); + } + resources[entry.key as String] = GameResource.fromMap( + Map.from(entry.value as Map), + ); + } + } + + final modulesValue = map['modules']; + final modules = {}; + if (modulesValue is Map) { + for (final entry in modulesValue.entries) { + if (entry.key is! String || entry.value is! String) { + throw const FormatException('manifest.modules must be a string map'); + } + modules[entry.key as String] = entry.value as String; + } + } + + final defaultLocale = (map['defaultLocale'] as String?) ?? 'en'; + final supportedLocales = _stringList( + map, + 'supportedLocales', + fallback: [defaultLocale], + ); + if (!supportedLocales.contains(defaultLocale)) { + throw const FormatException( + 'manifest.supportedLocales must include defaultLocale', + ); + } + + final displayValue = map['display']; + final display = displayValue == null + ? const GameDisplayConfig() + : GameDisplayConfig.fromMap( + Map.from(displayValue as Map), + ); + + return GamePackageManifest( + gameId: _string(map, 'gameId'), + name: _string(map, 'name'), + version: _string(map, 'version'), + runtimeApiVersion: _int(map, 'runtimeApiVersion'), + entry: _string(map, 'entry'), + assetsBase: (map['assetsBase'] as String?) ?? 'assets', + defaultLocale: defaultLocale, + supportedLocales: supportedLocales, + display: display, + resources: resources, + modules: modules, + ); + } + + static String _string(Map map, String key) { + final value = map[key]; + if (value is String && value.isNotEmpty) { + return value; + } + throw FormatException('manifest.$key must be a non-empty string'); + } + + static List _stringList( + Map map, + String key, { + required List fallback, + }) { + final value = map[key]; + if (value == null) { + return fallback; + } + if (value is! List || value.isEmpty) { + throw FormatException('manifest.$key must be a non-empty string list'); + } + final result = []; + for (final item in value) { + if (item is! String || item.isEmpty) { + throw FormatException('manifest.$key must be a non-empty string list'); + } + result.add(item); + } + return result; + } + + static int _int(Map map, String key) { + final value = map[key]; + if (value is num) { + return value.toInt(); + } + throw FormatException('manifest.$key must be an integer'); + } +} + +class GameDisplayConfig { + const GameDisplayConfig({ + this.designWidth = 720, + this.designHeight = 720, + this.scaleMode = RuntimeScaleMode.fit, + }); + + final double designWidth; + final double designHeight; + final String scaleMode; + + RuntimeViewportConfig toViewportConfig() { + return RuntimeViewportConfig( + designWidth: designWidth, + designHeight: designHeight, + scaleMode: scaleMode, + ); + } + + static GameDisplayConfig fromMap(Map map) { + final designWidth = _number(map, 'designWidth', fallback: 720); + final designHeight = _number(map, 'designHeight', fallback: 720); + final scaleMode = (map['scaleMode'] as String?) ?? RuntimeScaleMode.fit; + if (designWidth <= 0 || designHeight <= 0) { + throw const FormatException('manifest.display design size must be > 0'); + } + if (!RuntimeScaleMode.isSupported(scaleMode)) { + throw const FormatException('manifest.display.scaleMode is unsupported'); + } + return GameDisplayConfig( + designWidth: designWidth, + designHeight: designHeight, + scaleMode: scaleMode, + ); + } + + static double _number( + Map map, + String key, { + required double fallback, + }) { + final value = map[key]; + if (value == null) { + return fallback; + } + if (value is num) { + return value.toDouble(); + } + throw FormatException('manifest.display.$key must be a number'); + } +} + +class GameResource { + const GameResource({ + required this.type, + required this.path, + this.preload = GameResourcePreload.required, + this.group, + this.atlas, + this.skeleton, + }); + + final String type; + final String path; + final String preload; + final String? group; + final String? atlas; + final String? skeleton; + + static GameResource fromMap(Map map) { + final type = map['type']; + final path = map['path']; + final atlas = map['atlas']; + final skeleton = map['skeleton']; + if (type is! String || type.isEmpty) { + throw const FormatException('resource.type must be a non-empty string'); + } + if (!GameResourceType.isSupported(type)) { + throw const FormatException('resource.type is unsupported'); + } + if (type == GameResourceType.spine) { + if (atlas is! String || atlas.isEmpty) { + throw const FormatException( + 'spine resource.atlas must be a non-empty string', + ); + } + if (skeleton is! String || skeleton.isEmpty) { + throw const FormatException( + 'spine resource.skeleton must be a non-empty string', + ); + } + } else if (path is! String || path.isEmpty) { + throw const FormatException('resource.path must be a non-empty string'); + } + final preload = map['preload'] as String? ?? GameResourcePreload.required; + if (!GameResourcePreload.isSupported(preload)) { + throw const FormatException('resource.preload is unsupported'); + } + final group = map['group']; + if (group != null && (group is! String || group.isEmpty)) { + throw const FormatException('resource.group must be a non-empty string'); + } + return GameResource( + type: type, + path: path as String? ?? '', + preload: preload, + group: group as String?, + atlas: atlas as String?, + skeleton: skeleton as String?, + ); + } +} + +abstract final class GameResourceType { + static const image = 'image'; + static const audio = 'audio'; + static const spine = 'spine'; + + static bool isSupported(String value) { + return value == image || value == audio || value == spine; + } +} + +abstract final class GameResourcePreload { + static const required = 'required'; + static const lazy = 'lazy'; + static const optional = 'optional'; + + static bool isSupported(String value) { + return value == required || value == lazy || value == optional; + } +} diff --git a/lib/runtime/packages/game_package_repository.dart b/lib/runtime/packages/game_package_repository.dart new file mode 100644 index 0000000..cc6b5c6 --- /dev/null +++ b/lib/runtime/packages/game_package_repository.dart @@ -0,0 +1,226 @@ +import 'dart:convert'; +import 'dart:io'; + +import 'package:archive/archive.dart'; +import 'package:crypto/crypto.dart'; +import 'package:flutter/services.dart'; +import 'package:http/http.dart' as http; +import 'package:path/path.dart' as p; + +import '../game/runtime_options.dart'; +import 'game_package.dart'; +import 'game_package_manifest.dart'; +import 'package_verifier.dart'; +import 'stable_package_store.dart'; + +abstract interface class GamePackageRepository { + Future load(String gameId); +} + +class AssetGamePackageRepository implements GamePackageRepository { + const AssetGamePackageRepository({ + this.basePath = 'assets/games', + this.runtimeOptions = const RuntimeOptions(), + }); + + final String basePath; + final RuntimeOptions runtimeOptions; + + @override + Future load(String gameId) async { + final root = '$basePath/$gameId'; + final source = await rootBundle.loadString('$root/manifest.json'); + return GamePackage.asset( + rootPath: root, + manifest: GamePackageManifest.fromJsonString(source), + runtimeLuaRoot: runtimeOptions.runtimeLuaRoot, + ); + } +} + +class RemoteGamePackageRepository implements GamePackageRepository { + RemoteGamePackageRepository({ + required this.baseUri, + this.runtimeApiVersion = 1, + this.runtimeOptions = const RuntimeOptions(), + GamePackageRepository? fallback, + StablePackageStore? store, + http.Client? client, + }) : fallback = + fallback ?? + AssetGamePackageRepository(runtimeOptions: runtimeOptions), + store = store ?? StablePackageStore(runtimeOptions: runtimeOptions), + _client = client; + + final Uri baseUri; + final int runtimeApiVersion; + final RuntimeOptions runtimeOptions; + final GamePackageRepository fallback; + final StablePackageStore store; + final http.Client? _client; + + @override + Future load(String gameId) async { + final verifier = PackageVerifier(runtimeApiVersion: runtimeApiVersion); + final client = _client ?? http.Client(); + final shouldCloseClient = _client == null; + + try { + final package = await _loadRemoteCandidate(client, gameId); + await verifier.verify(package); + return package; + } catch (_) { + final stable = await store.stablePackage(gameId); + if (stable != null) { + try { + await verifier.verify(stable); + return stable; + } catch (_) { + final previous = await store.previousStablePackage(gameId); + if (previous != null) { + try { + await verifier.verify(previous); + return previous; + } catch (_) { + // Fall through to bundled fallback. + } + } + } + } + return fallback.load(gameId); + } finally { + if (shouldCloseClient) { + client.close(); + } + } + } + + Future _loadRemoteCandidate( + http.Client client, + String gameId, + ) async { + final remoteManifest = await _fetchRemoteManifest(client, gameId); + if (remoteManifest.gameId != gameId) { + throw const FormatException('Remote manifest gameId mismatch'); + } + + final packageRoot = await _downloadAndExtract( + client, + gameId, + remoteManifest, + ); + final manifestFile = File(p.join(packageRoot.path, 'manifest.json')); + final packageManifest = GamePackageManifest.fromJsonString( + await manifestFile.readAsString(), + ); + if (packageManifest.gameId != gameId) { + throw const FormatException('Package manifest gameId mismatch'); + } + if (packageManifest.version != remoteManifest.version) { + throw const FormatException('Package manifest version mismatch'); + } + return GamePackage.file( + rootPath: packageRoot.path, + manifest: packageManifest, + runtimeLuaRoot: runtimeOptions.runtimeLuaRoot, + ); + } + + Future _fetchRemoteManifest( + http.Client client, + String gameId, + ) async { + final uri = baseUri.resolve('$gameId/remote_manifest.json'); + final response = await client.get(uri); + if (response.statusCode != 200) { + throw HttpException( + 'Remote manifest failed: ${response.statusCode}', + uri: uri, + ); + } + return RemotePackageManifest.fromMap( + jsonDecode(response.body) as Map, + ); + } + + Future _downloadAndExtract( + http.Client client, + String gameId, + RemotePackageManifest manifest, + ) async { + final packageBytes = await _downloadPackage(client, manifest.packageUrl); + _verifySha256(packageBytes, manifest.sha256); + + final packageRoot = await store.versionDirectory(gameId, manifest.version); + if (packageRoot.existsSync()) { + packageRoot.deleteSync(recursive: true); + } + packageRoot.createSync(recursive: true); + + final archive = ZipDecoder().decodeBytes(packageBytes); + for (final file in archive.files) { + final targetPath = p.normalize(p.join(packageRoot.path, file.name)); + if (!p.isWithin(packageRoot.path, targetPath) && + targetPath != packageRoot.path) { + throw const FormatException('Unsafe zip entry path'); + } + if (file.isFile) { + File(targetPath) + ..createSync(recursive: true) + ..writeAsBytesSync(file.content as List); + } else { + Directory(targetPath).createSync(recursive: true); + } + } + return packageRoot; + } + + Future> _downloadPackage(http.Client client, Uri uri) async { + final response = await client.get(uri); + if (response.statusCode != 200) { + throw HttpException( + 'Package download failed: ${response.statusCode}', + uri: uri, + ); + } + return response.bodyBytes; + } + + void _verifySha256(List bytes, String expected) { + final actual = sha256.convert(bytes).toString(); + if (actual != expected) { + throw const FormatException('Package sha256 mismatch'); + } + } +} + +class RemotePackageManifest { + const RemotePackageManifest({ + required this.gameId, + required this.version, + required this.packageUrl, + required this.sha256, + }); + + final String gameId; + final String version; + final Uri packageUrl; + final String sha256; + + static RemotePackageManifest fromMap(Map map) { + return RemotePackageManifest( + gameId: _string(map, 'gameId'), + version: _string(map, 'version'), + packageUrl: Uri.parse(_string(map, 'packageUrl')), + sha256: _string(map, 'sha256'), + ); + } + + static String _string(Map map, String key) { + final value = map[key]; + if (value is String && value.isNotEmpty) { + return value; + } + throw FormatException('remote_manifest.$key must be a non-empty string'); + } +} diff --git a/lib/runtime/packages/package_verifier.dart b/lib/runtime/packages/package_verifier.dart new file mode 100644 index 0000000..51b8848 --- /dev/null +++ b/lib/runtime/packages/package_verifier.dart @@ -0,0 +1,117 @@ +import 'dart:io'; + +import 'package:path/path.dart' as p; + +import 'game_package.dart'; +import 'game_package_manifest.dart'; + +class PackageVerifier { + const PackageVerifier({required this.runtimeApiVersion}); + + final int runtimeApiVersion; + + Future verify(GamePackage package) async { + _verifyManifest(package); + await _verifyEntry(package); + await _verifyDeclaredModules(package); + await _verifyDeclaredResources(package); + } + + void _verifyManifest(GamePackage package) { + final manifest = package.manifest; + if (manifest.runtimeApiVersion > runtimeApiVersion) { + throw FormatException( + 'Package runtimeApiVersion ${manifest.runtimeApiVersion} is newer than runtime $runtimeApiVersion', + ); + } + if (manifest.gameId.isEmpty || + manifest.version.isEmpty || + manifest.entry.isEmpty) { + throw const FormatException('Package manifest is incomplete'); + } + } + + Future _verifyEntry(GamePackage package) async { + final script = await package.readText(package.manifest.entry); + if (!script.contains('function init')) { + throw const FormatException('Lua package must define function init(ctx)'); + } + if (!script.contains('function on_event')) { + throw const FormatException( + 'Lua package must define function on_event(event)', + ); + } + if (!script.contains('function smoke_test')) { + throw const FormatException( + 'Lua package must define function smoke_test(ctx)', + ); + } + } + + Future _verifyDeclaredModules(GamePackage package) async { + for (final entry in package.manifest.modules.entries) { + final name = entry.key; + final path = entry.value; + if (!_isSafeModuleName(name)) { + throw FormatException('Unsafe Lua module name: $name'); + } + if (!_isSafeModulePath(path)) { + throw FormatException( + 'Lua module path must be scripts/*.lua or runtime:*.lua: $path', + ); + } + await package.readText(path); + } + } + + bool _isSafeModuleName(String value) { + return RegExp(r'^[A-Za-z0-9_.-]+$').hasMatch(value) && + !value.contains('..') && + !value.startsWith('.') && + !value.endsWith('.'); + } + + bool _isSafeModulePath(String path) { + if (path.startsWith(GamePackage.runtimeLuaPrefix)) { + final name = path.substring(GamePackage.runtimeLuaPrefix.length); + return name.isNotEmpty && + name.endsWith('.lua') && + !name.contains('/') && + !name.contains('..'); + } + return path.startsWith('scripts/') && + path.endsWith('.lua') && + !path.contains('..'); + } + + Future _verifyDeclaredResources(GamePackage package) async { + for (final resource in package.manifest.resources.values) { + final paths = _resourcePaths(resource); + for (final path in paths) { + if (path.contains('..')) { + throw const FormatException('Resource path must not contain ..'); + } + if (package.isAsset) { + await package.readBytes(path); + continue; + } + + final root = p.normalize(package.rootPath); + final target = p.normalize(p.join(root, path)); + if (!p.isWithin(root, target) && target != root) { + throw const FormatException('Resource path escapes package root'); + } + if (!File(target).existsSync()) { + throw FormatException('Missing declared resource: $path'); + } + } + } + } + + Iterable _resourcePaths(GameResource resource) { + if (resource.type == GameResourceType.spine) { + return [resource.atlas!, resource.skeleton!]; + } + return [resource.path]; + } +} diff --git a/lib/runtime/packages/stable_package_store.dart b/lib/runtime/packages/stable_package_store.dart new file mode 100644 index 0000000..cd578ea --- /dev/null +++ b/lib/runtime/packages/stable_package_store.dart @@ -0,0 +1,86 @@ +import 'dart:convert'; +import 'dart:io'; + +import 'package:path/path.dart' as p; +import 'package:path_provider/path_provider.dart'; + +import '../game/runtime_options.dart'; +import 'game_package.dart'; +import 'game_package_manifest.dart'; + +class StablePackageStore { + const StablePackageStore({ + RuntimeOptions runtimeOptions = const RuntimeOptions(), + }) : _runtimeOptions = runtimeOptions; + + final RuntimeOptions _runtimeOptions; + + Future cacheRoot() async { + final support = await getApplicationSupportDirectory(); + final root = Directory(p.join(support.path, 'flame_lua_packages')); + root.createSync(recursive: true); + return root; + } + + Future versionDirectory(String gameId, String version) async { + final root = await cacheRoot(); + return Directory(p.join(root.path, gameId, version)); + } + + Future markStable(GamePackage package) async { + if (package.source != GamePackageSource.file) { + return; + } + final marker = await _markerFile(package.manifest.gameId); + marker.createSync(recursive: true); + final previous = await stablePackage(package.manifest.gameId); + final data = { + 'current': package.rootPath, + if (previous != null && previous.rootPath != package.rootPath) + 'previous': previous.rootPath, + }; + marker.writeAsStringSync(const JsonEncoder.withIndent(' ').convert(data)); + } + + Future stablePackage(String gameId) async { + final marker = await _markerFile(gameId); + if (!marker.existsSync()) { + return null; + } + final data = + jsonDecode(await marker.readAsString()) as Map; + return _packageFromPath(data['current']); + } + + Future previousStablePackage(String gameId) async { + final marker = await _markerFile(gameId); + if (!marker.existsSync()) { + return null; + } + final data = + jsonDecode(await marker.readAsString()) as Map; + return _packageFromPath(data['previous']); + } + + Future _markerFile(String gameId) async { + final root = await cacheRoot(); + return File(p.join(root.path, gameId, 'stable.json')); + } + + GamePackage? _packageFromPath(Object? pathValue) { + if (pathValue is! String || pathValue.isEmpty) { + return null; + } + final manifestFile = File(p.join(pathValue, 'manifest.json')); + if (!manifestFile.existsSync()) { + return null; + } + return GamePackage.file( + rootPath: pathValue, + manifest: GamePackageManifest.fromJsonString( + manifestFile.readAsStringSync(), + ), + runtimeLuaRoot: _runtimeOptions.runtimeLuaRoot, + ); + } +} diff --git a/lib/runtime/protocol/runtime_protocol.dart b/lib/runtime/protocol/runtime_protocol.dart new file mode 100644 index 0000000..fba464f --- /dev/null +++ b/lib/runtime/protocol/runtime_protocol.dart @@ -0,0 +1,490 @@ +class RuntimeNodeType { + const RuntimeNodeType._(); + + static const panel = 'panel'; + static const button = 'button'; + static const text = 'text'; + static const circle = 'circle'; + static const rect = 'rect'; + static const line = 'line'; + static const progress = 'progress'; + static const listView = 'listView'; + static const sprite = 'sprite'; + static const image = 'image'; + static const spine = 'spine'; + static const particle = 'particle'; + + static const all = { + panel, + button, + text, + circle, + rect, + line, + progress, + listView, + sprite, + image, + spine, + particle, + }; + + static bool isSupported(String value) => all.contains(value); +} + +class RuntimeAnchorValue { + const RuntimeAnchorValue._(); + + static const center = 'center'; + static const topLeft = 'topLeft'; + static const topRight = 'topRight'; + static const bottomLeft = 'bottomLeft'; + static const bottomRight = 'bottomRight'; + + static const all = {center, topLeft, topRight, bottomLeft, bottomRight}; + + static bool isSupported(String value) => all.contains(value); +} + +class RuntimeTextAlignValue { + const RuntimeTextAlignValue._(); + + static const left = 'left'; + static const center = 'center'; + static const right = 'right'; + + static const all = {left, center, right}; + + static bool isSupported(String value) => all.contains(value); +} + +class RuntimeParticlePresetValue { + const RuntimeParticlePresetValue._(); + + static const burst = 'burst'; + static const trail = 'trail'; + static const snow = 'snow'; + static const confetti = 'confetti'; + + static const all = {burst, trail, snow, confetti}; + + static bool isSupported(String value) => all.contains(value); +} + +class RuntimeEventType { + const RuntimeEventType._(); + + static const tap = 'tap'; + static const animationDone = 'animation_done'; + static const resize = 'resize'; + static const scroll = 'scroll'; +} + +class RuntimeCommandType { + const RuntimeCommandType._(); + + static const movePath = 'move_path'; + static const moveTo = 'move_to'; + static const fadeTo = 'fade_to'; + static const scaleTo = 'scale_to'; + static const rotateTo = 'rotate_to'; + static const removeNode = 'remove_node'; + static const sequence = 'sequence'; + static const parallel = 'parallel'; + static const delay = 'delay'; + static const toast = 'toast'; + static const playSound = 'play_sound'; + static const playBgm = 'play_bgm'; + static const pauseBgm = 'pause_bgm'; + static const resumeBgm = 'resume_bgm'; + static const stopBgm = 'stop_bgm'; + static const preloadResources = 'preload_resources'; + static const evictResources = 'evict_resources'; + static const cancelCommands = 'cancel_commands'; + static const playSpineAnimation = 'play_spine_animation'; + static const copyText = 'copy_text'; + + static const all = { + movePath, + moveTo, + fadeTo, + scaleTo, + rotateTo, + removeNode, + sequence, + parallel, + delay, + toast, + playSound, + playBgm, + pauseBgm, + resumeBgm, + stopBgm, + preloadResources, + evictResources, + cancelCommands, + playSpineAnimation, + copyText, + }; + + static bool isSupported(String value) => all.contains(value); +} + +class RuntimeProtocolField { + const RuntimeProtocolField._(); + + static const id = 'id'; + static const type = 'type'; + static const target = 'target'; + static const parent = 'parent'; + static const asset = 'asset'; + static const pressedAsset = 'pressedAsset'; + static const disabledAsset = 'disabledAsset'; + static const animation = 'animation'; + static const skin = 'skin'; + static const loop = 'loop'; + static const text = 'text'; + static const x = 'x'; + static const y = 'y'; + static const width = 'width'; + static const height = 'height'; + static const paddingLeft = 'paddingLeft'; + static const paddingTop = 'paddingTop'; + static const paddingRight = 'paddingRight'; + static const paddingBottom = 'paddingBottom'; + static const anchor = 'anchor'; + static const layer = 'layer'; + static const visible = 'visible'; + static const alpha = 'alpha'; + static const scale = 'scale'; + static const rotation = 'rotation'; + static const color = 'color'; + static const fontSize = 'fontSize'; + static const textAlign = 'textAlign'; + static const radius = 'radius'; + static const strokeWidth = 'strokeWidth'; + static const value = 'value'; + static const scrollX = 'scrollX'; + static const scrollY = 'scrollY'; + static const contentWidth = 'contentWidth'; + static const contentHeight = 'contentHeight'; + static const virtualized = 'virtualized'; + static const cacheExtent = 'cacheExtent'; + static const inertia = 'inertia'; + static const scrollbarThumbColor = 'scrollbarThumbColor'; + static const scrollbarTrackColor = 'scrollbarTrackColor'; + static const scrollbarThickness = 'scrollbarThickness'; + static const scrollbarVisible = 'scrollbarVisible'; + static const interactive = 'interactive'; + static const onTap = 'onTap'; + static const onScroll = 'onScroll'; + static const props = 'props'; + static const creates = 'creates'; + static const updates = 'updates'; + static const removes = 'removes'; + static const render = 'render'; + static const ui = 'ui'; + static const commands = 'commands'; + static const path = 'path'; + static const duration = 'duration'; + static const angle = 'angle'; + static const message = 'message'; + static const name = 'name'; + static const volume = 'volume'; + static const channel = 'channel'; + static const group = 'group'; + static const commandGroup = 'commandGroup'; + static const scope = 'scope'; + static const onComplete = 'onComplete'; + static const failOnError = 'failOnError'; + static const track = 'track'; + static const queue = 'queue'; + static const delay = 'delay'; + static const preset = 'preset'; + static const count = 'count'; + static const speedMin = 'speedMin'; + static const speedMax = 'speedMax'; + static const gravityX = 'gravityX'; + static const gravityY = 'gravityY'; + static const spread = 'spread'; + static const colorTo = 'colorTo'; + static const radiusTo = 'radiusTo'; + static const autoRemove = 'autoRemove'; + static const fadeOut = 'fadeOut'; +} + +class RuntimeProtocolSchema { + const RuntimeProtocolSchema._(); + + static const nodeFields = { + RuntimeProtocolField.id, + RuntimeProtocolField.type, + RuntimeProtocolField.parent, + RuntimeProtocolField.asset, + RuntimeProtocolField.pressedAsset, + RuntimeProtocolField.disabledAsset, + RuntimeProtocolField.animation, + RuntimeProtocolField.skin, + RuntimeProtocolField.loop, + RuntimeProtocolField.text, + RuntimeProtocolField.x, + RuntimeProtocolField.y, + RuntimeProtocolField.width, + RuntimeProtocolField.height, + RuntimeProtocolField.paddingLeft, + RuntimeProtocolField.paddingTop, + RuntimeProtocolField.paddingRight, + RuntimeProtocolField.paddingBottom, + RuntimeProtocolField.anchor, + RuntimeProtocolField.layer, + RuntimeProtocolField.visible, + RuntimeProtocolField.alpha, + RuntimeProtocolField.scale, + RuntimeProtocolField.rotation, + RuntimeProtocolField.color, + RuntimeProtocolField.fontSize, + RuntimeProtocolField.textAlign, + RuntimeProtocolField.radius, + RuntimeProtocolField.strokeWidth, + RuntimeProtocolField.value, + RuntimeProtocolField.scrollX, + RuntimeProtocolField.scrollY, + RuntimeProtocolField.contentWidth, + RuntimeProtocolField.contentHeight, + RuntimeProtocolField.virtualized, + RuntimeProtocolField.cacheExtent, + RuntimeProtocolField.inertia, + RuntimeProtocolField.scrollbarThumbColor, + RuntimeProtocolField.scrollbarTrackColor, + RuntimeProtocolField.scrollbarThickness, + RuntimeProtocolField.scrollbarVisible, + RuntimeProtocolField.interactive, + RuntimeProtocolField.onTap, + RuntimeProtocolField.onScroll, + RuntimeProtocolField.preset, + RuntimeProtocolField.count, + RuntimeProtocolField.duration, + RuntimeProtocolField.speedMin, + RuntimeProtocolField.speedMax, + RuntimeProtocolField.gravityX, + RuntimeProtocolField.gravityY, + RuntimeProtocolField.spread, + RuntimeProtocolField.colorTo, + RuntimeProtocolField.radiusTo, + RuntimeProtocolField.autoRemove, + RuntimeProtocolField.fadeOut, + }; + + static const nodeUpdateFields = { + RuntimeProtocolField.id, + RuntimeProtocolField.props, + }; + + static const nodeRemoveFields = {RuntimeProtocolField.id}; + + static const nodePropsFields = { + RuntimeProtocolField.type, + RuntimeProtocolField.parent, + RuntimeProtocolField.asset, + RuntimeProtocolField.pressedAsset, + RuntimeProtocolField.disabledAsset, + RuntimeProtocolField.animation, + RuntimeProtocolField.skin, + RuntimeProtocolField.loop, + RuntimeProtocolField.text, + RuntimeProtocolField.x, + RuntimeProtocolField.y, + RuntimeProtocolField.width, + RuntimeProtocolField.height, + RuntimeProtocolField.paddingLeft, + RuntimeProtocolField.paddingTop, + RuntimeProtocolField.paddingRight, + RuntimeProtocolField.paddingBottom, + RuntimeProtocolField.anchor, + RuntimeProtocolField.layer, + RuntimeProtocolField.visible, + RuntimeProtocolField.alpha, + RuntimeProtocolField.scale, + RuntimeProtocolField.rotation, + RuntimeProtocolField.color, + RuntimeProtocolField.fontSize, + RuntimeProtocolField.textAlign, + RuntimeProtocolField.radius, + RuntimeProtocolField.strokeWidth, + RuntimeProtocolField.value, + RuntimeProtocolField.scrollX, + RuntimeProtocolField.scrollY, + RuntimeProtocolField.contentWidth, + RuntimeProtocolField.contentHeight, + RuntimeProtocolField.virtualized, + RuntimeProtocolField.cacheExtent, + RuntimeProtocolField.inertia, + RuntimeProtocolField.scrollbarThumbColor, + RuntimeProtocolField.scrollbarTrackColor, + RuntimeProtocolField.scrollbarThickness, + RuntimeProtocolField.scrollbarVisible, + RuntimeProtocolField.interactive, + RuntimeProtocolField.onTap, + RuntimeProtocolField.onScroll, + RuntimeProtocolField.preset, + RuntimeProtocolField.count, + RuntimeProtocolField.duration, + RuntimeProtocolField.speedMin, + RuntimeProtocolField.speedMax, + RuntimeProtocolField.gravityX, + RuntimeProtocolField.gravityY, + RuntimeProtocolField.spread, + RuntimeProtocolField.colorTo, + RuntimeProtocolField.radiusTo, + RuntimeProtocolField.autoRemove, + RuntimeProtocolField.fadeOut, + }; + + static const nodeDiffFields = { + RuntimeProtocolField.creates, + RuntimeProtocolField.updates, + RuntimeProtocolField.removes, + }; + + static const gameDiffFields = { + RuntimeProtocolField.render, + RuntimeProtocolField.ui, + RuntimeProtocolField.commands, + }; + + static const commandEnvelopeFields = { + RuntimeProtocolField.type, + RuntimeProtocolField.target, + }; + + static const commandCommonPayloadFields = { + RuntimeProtocolField.id, + RuntimeProtocolField.group, + RuntimeProtocolField.commandGroup, + RuntimeProtocolField.scope, + RuntimeProtocolField.onComplete, + }; + + static const commandPayloadFieldsByType = { + RuntimeCommandType.movePath: { + ...commandCommonPayloadFields, + RuntimeProtocolField.path, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.moveTo: { + ...commandCommonPayloadFields, + RuntimeProtocolField.x, + RuntimeProtocolField.y, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.fadeTo: { + ...commandCommonPayloadFields, + RuntimeProtocolField.alpha, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.scaleTo: { + ...commandCommonPayloadFields, + RuntimeProtocolField.scale, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.rotateTo: { + ...commandCommonPayloadFields, + RuntimeProtocolField.angle, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.removeNode: commandCommonPayloadFields, + RuntimeCommandType.sequence: { + ...commandCommonPayloadFields, + RuntimeProtocolField.commands, + }, + RuntimeCommandType.parallel: { + ...commandCommonPayloadFields, + RuntimeProtocolField.commands, + }, + RuntimeCommandType.delay: { + ...commandCommonPayloadFields, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.toast: { + ...commandCommonPayloadFields, + RuntimeProtocolField.text, + RuntimeProtocolField.message, + RuntimeProtocolField.duration, + }, + RuntimeCommandType.playSound: { + ...commandCommonPayloadFields, + RuntimeProtocolField.asset, + RuntimeProtocolField.name, + RuntimeProtocolField.volume, + }, + RuntimeCommandType.playBgm: { + ...commandCommonPayloadFields, + RuntimeProtocolField.asset, + RuntimeProtocolField.name, + RuntimeProtocolField.volume, + RuntimeProtocolField.channel, + RuntimeProtocolField.loop, + }, + RuntimeCommandType.pauseBgm: { + ...commandCommonPayloadFields, + RuntimeProtocolField.channel, + }, + RuntimeCommandType.resumeBgm: { + ...commandCommonPayloadFields, + RuntimeProtocolField.channel, + }, + RuntimeCommandType.stopBgm: { + ...commandCommonPayloadFields, + RuntimeProtocolField.channel, + }, + RuntimeCommandType.preloadResources: { + ...commandCommonPayloadFields, + RuntimeProtocolField.failOnError, + }, + RuntimeCommandType.evictResources: commandCommonPayloadFields, + RuntimeCommandType.cancelCommands: commandCommonPayloadFields, + RuntimeCommandType.playSpineAnimation: { + ...commandCommonPayloadFields, + RuntimeProtocolField.animation, + RuntimeProtocolField.track, + RuntimeProtocolField.loop, + RuntimeProtocolField.queue, + RuntimeProtocolField.delay, + }, + RuntimeCommandType.copyText: { + ...commandCommonPayloadFields, + RuntimeProtocolField.text, + }, + }; + + static void ensureKnownKeys( + Map map, { + required Set allowed, + required String context, + }) { + for (final key in map.keys) { + if (key is! String) { + throw FormatException('$context field key must be a string: $key'); + } + if (!allowed.contains(key)) { + throw FormatException('$context has unsupported field: $key'); + } + } + } + + static Set allowedCommandFields(String commandType) { + final payloadFields = commandPayloadFieldsByType[commandType]; + if (payloadFields == null) { + throw UnsupportedError('Unsupported runtime command: $commandType'); + } + return {...commandEnvelopeFields, ...payloadFields}; + } + + static Set allowedCommandPayloadFields(String commandType) { + final payloadFields = commandPayloadFieldsByType[commandType]; + if (payloadFields == null) { + throw UnsupportedError('Unsupported runtime command: $commandType'); + } + return payloadFields; + } +} diff --git a/lib/runtime/rendering/render_tree_controller.dart b/lib/runtime/rendering/render_tree_controller.dart new file mode 100644 index 0000000..31f3cb8 --- /dev/null +++ b/lib/runtime/rendering/render_tree_controller.dart @@ -0,0 +1,489 @@ +import 'package:flame/components.dart'; + +import '../models/game_diff.dart'; +import '../models/runtime_event.dart'; +import '../models/runtime_node.dart'; +import '../protocol/runtime_protocol.dart'; +import '../resources/game_resource_manager.dart'; +import 'runtime_component.dart'; + +class RenderTreeController { + RenderTreeController({ + required Component root, + required GameResourceManager resources, + required void Function(RuntimeEvent event) eventSink, + this.onScopeRemoved, + }) : _root = root, + _resources = resources, + _eventSink = eventSink; + + final Component _root; + final GameResourceManager _resources; + final void Function(RuntimeEvent event) _eventSink; + final Map _components = {}; + final Map _epochs = {}; + final Map _scrollVelocities = {}; + void Function(String id)? onScopeRemoved; + + RuntimeComponent? componentById(String id) => _components[id]; + + bool contains(String id) => _components.containsKey(id); + + String? listViewAt(Vector2 canvasPosition) { + final hits = + _components.values + .where( + (component) => + component.node.type == RuntimeNodeType.listView && + component.containsVisualPoint(canvasPosition), + ) + .toList(growable: false) + ..sort((a, b) => b.priority.compareTo(a.priority)); + return hits.isEmpty ? null : hits.first.node.id; + } + + bool scrollListViewAt( + Vector2 canvasPosition, { + double deltaX = 0, + double deltaY = 0, + String source = 'wheel', + }) { + final id = listViewAt(canvasPosition); + if (id == null) { + return false; + } + return scrollListView(id, deltaX: deltaX, deltaY: deltaY, source: source); + } + + bool scrollListView( + String id, { + double deltaX = 0, + double deltaY = 0, + String source = 'program', + }) { + final component = _components[id]; + if (component == null || component.node.type != RuntimeNodeType.listView) { + return false; + } + final node = component.node; + final viewport = _listViewContentViewport(node); + final nextScrollX = _clampScroll( + node.scrollX + deltaX, + viewportExtent: viewport.x, + contentExtent: node.contentWidth, + ); + final nextScrollY = _clampScroll( + node.scrollY + deltaY, + viewportExtent: viewport.y, + contentExtent: node.contentHeight, + ); + if (nextScrollX == node.scrollX && nextScrollY == node.scrollY) { + return false; + } + component.updateNode( + node.copyWithProps({'scrollX': nextScrollX, 'scrollY': nextScrollY}), + ); + _reattachChildrenOf(id); + _emitScrollEvent(component, source: source); + return true; + } + + void setListViewVelocity(String id, Vector2 velocity) { + final component = _components[id]; + if (component == null || component.node.type != RuntimeNodeType.listView) { + return; + } + if (!component.node.inertia) { + _scrollVelocities.remove(id); + return; + } + if (velocity.length2 < 1) { + _scrollVelocities.remove(id); + return; + } + _scrollVelocities[id] = velocity; + } + + void stopListViewVelocity(String id) { + _scrollVelocities.remove(id); + } + + void updateListViewInertia(double dt) { + if (_scrollVelocities.isEmpty || dt <= 0) { + return; + } + for (final entry in _scrollVelocities.entries.toList(growable: false)) { + final id = entry.key; + final velocity = entry.value; + final consumed = scrollListView( + id, + deltaX: velocity.x * dt, + deltaY: velocity.y * dt, + source: 'inertia', + ); + final next = velocity * 0.88; + if (!consumed || next.length2 < 25) { + _scrollVelocities.remove(id); + } else { + _scrollVelocities[id] = next; + } + } + } + + int epochOf(String id) => _epochs[id] ?? 0; + + bool isNodeEpochAlive(String id, int epoch) { + return _components.containsKey(id) && epochOf(id) == epoch; + } + + void clear() { + final ids = _components.keys.toList(growable: false); + for (final component in _components.values) { + component.removeFromParent(); + } + _components.clear(); + for (final id in ids) { + _bumpEpoch(id); + onScopeRemoved?.call(id); + } + } + + void removeById(String id) { + final removedIds = []; + for (final childId in _descendantIdsOf(id)) { + final child = _components.remove(childId); + if (child != null) { + removedIds.add(childId); + _bumpEpoch(childId); + child.removeFromParent(); + } + } + + final component = _components.remove(id); + if (component != null) { + removedIds.add(id); + _bumpEpoch(id); + component.removeFromParent(); + } + + for (final removedId in removedIds) { + onScopeRemoved?.call(removedId); + } + } + + void apply(NodeDiff diff) { + _validateDiff(diff); + + for (final remove in diff.removes) { + removeById(remove.id); + } + + for (final create in diff.creates) { + _createOrReplace(create); + } + + for (final update in diff.updates) { + final component = _components[update.id]; + if (component == null) { + continue; + } + final nextNode = component.node.copyWithProps(update.props); + component.updateNode(nextNode); + _attachToParent(component); + _reattachChildrenOf(component.node.id); + } + } + + void _validateDiff(NodeDiff diff) { + final nodes = { + for (final entry in _components.entries) entry.key: entry.value.node, + }; + + for (final remove in diff.removes) { + _removeNodeSnapshot(nodes, remove.id); + } + + for (final create in diff.creates) { + nodes[create.id] = create; + } + + for (final update in diff.updates) { + final current = nodes[update.id]; + if (current == null) { + continue; + } + nodes[update.id] = current.copyWithProps(update.props); + } + + _validateParentGraph(nodes); + } + + void _removeNodeSnapshot(Map nodes, String id) { + final descendants = _descendantIdsOfSnapshot(nodes, id); + for (final childId in descendants) { + nodes.remove(childId); + } + nodes.remove(id); + } + + List _descendantIdsOfSnapshot( + Map nodes, + String parentId, + ) { + final descendants = []; + for (final node in nodes.values) { + if (node.parent == parentId) { + descendants.add(node.id); + descendants.addAll(_descendantIdsOfSnapshot(nodes, node.id)); + } + } + return descendants; + } + + void _validateParentGraph(Map nodes) { + for (final node in nodes.values) { + final parentId = node.parent; + if (parentId == null) { + continue; + } + if (parentId == node.id) { + throw const FormatException( + 'RuntimeNode.parent cannot reference itself', + ); + } + + final seen = {node.id}; + var currentId = parentId; + while (true) { + if (!seen.add(currentId)) { + throw FormatException( + 'RuntimeNode.parent would create a cycle: ${node.id} -> $parentId', + ); + } + final parent = nodes[currentId]; + final nextId = parent?.parent; + if (nextId == null) { + break; + } + currentId = nextId; + } + } + } + + void _createOrReplace(RuntimeNode node) { + _validateParent(node); + + final existing = _components.remove(node.id); + existing?.removeFromParent(); + final epoch = _bumpEpoch(node.id); + + late final RuntimeComponent component; + component = RuntimeComponent( + node: node, + resources: _resources, + onNodeTap: (tappedNode, localPosition) { + if (_components[tappedNode.id] != component) { + return; + } + _eventSink( + RuntimeEvent( + type: RuntimeEventType.tap, + target: tappedNode.id, + handler: tappedNode.onTap, + x: localPosition.x, + y: localPosition.y, + scope: tappedNode.id, + targetEpoch: epoch, + scopeEpoch: epoch, + ), + ); + }, + ); + _components[node.id] = component; + _attachToParent(component); + _reattachChildrenOf(node.id); + } + + int _bumpEpoch(String id) { + final next = (_epochs[id] ?? 0) + 1; + _epochs[id] = next; + return next; + } + + void _attachToParent(RuntimeComponent component) { + final parentId = component.node.parent; + final parent = parentId == null ? null : _components[parentId]; + final target = parent ?? _root; + final parentIsListView = parent?.node.type == RuntimeNodeType.listView; + final parentScrollX = parentIsListView ? parent!.node.scrollX : 0.0; + final parentScrollY = parentIsListView ? parent!.node.scrollY : 0.0; + final parentContentOffset = parentIsListView + ? parent!.listViewContentOffset() + : Vector2.zero(); + component.setParentScroll( + x: parentScrollX, + y: parentScrollY, + contentOffsetX: parentContentOffset.x, + contentOffsetY: parentContentOffset.y, + ); + component.setViewportCulled(_isCulledByParentListView(component, parent)); + if (component.parent == target) { + return; + } + + component.removeFromParent(); + target.add(component); + } + + void _validateParent(RuntimeNode node) { + final parentId = node.parent; + if (parentId != null && _wouldCreateCycle(node.id, parentId)) { + throw FormatException( + 'RuntimeNode.parent would create a cycle: ${node.id} -> $parentId', + ); + } + } + + void _reattachChildrenOf(String parentId) { + for (final component in _components.values.toList(growable: false)) { + if (component.node.parent == parentId) { + _attachToParent(component); + } + } + } + + List _descendantIdsOf(String parentId) { + final descendants = []; + for (final component in _components.values) { + if (component.node.parent == parentId) { + descendants.add(component.node.id); + descendants.addAll(_descendantIdsOf(component.node.id)); + } + } + return descendants; + } + + bool _isCulledByParentListView( + RuntimeComponent component, + RuntimeComponent? parent, + ) { + final parentNode = parent?.node; + if (parentNode == null || + parentNode.type != RuntimeNodeType.listView || + !parentNode.virtualized) { + return false; + } + final cache = parentNode.cacheExtent; + final viewportLeft = parentNode.scrollX - cache; + final viewportTop = parentNode.scrollY - cache; + final viewport = parent?.listViewContentViewport() ?? Vector2.zero(); + final viewportRight = parentNode.scrollX + viewport.x + cache; + final viewportBottom = parentNode.scrollY + viewport.y + cache; + final node = component.node; + final childLeft = node.x; + final childTop = node.y; + final childRight = node.x + (node.width ?? 0); + final childBottom = node.y + (node.height ?? 0); + return childRight < viewportLeft || + childLeft > viewportRight || + childBottom < viewportTop || + childTop > viewportBottom; + } + + Vector2 _listViewContentViewport(RuntimeNode node) { + final width = node.width ?? 0; + final height = node.height ?? 0; + final left = node.paddingLeft.clamp(0.0, width).toDouble(); + final top = node.paddingTop.clamp(0.0, height).toDouble(); + if (!node.scrollbarVisible) { + return Vector2( + (width - left - node.paddingRight).clamp(0.0, width).toDouble(), + (height - top - node.paddingBottom).clamp(0.0, height).toDouble(), + ); + } + final thickness = (node.scrollbarThickness ?? 5).clamp(1.0, 16.0); + final gutter = thickness + 8; + var vertical = (node.contentHeight ?? 0) > height && height > 0; + var horizontal = (node.contentWidth ?? 0) > width && width > 0; + for (var i = 0; i < 2; i += 1) { + final viewportWidth = + width - left - node.paddingRight - (vertical ? gutter : 0); + final viewportHeight = + height - top - node.paddingBottom - (horizontal ? gutter : 0); + vertical = + (node.contentHeight ?? 0) > viewportHeight && viewportHeight > 0; + horizontal = + (node.contentWidth ?? 0) > viewportWidth && viewportWidth > 0; + } + return Vector2( + (width - left - node.paddingRight - (vertical ? gutter : 0)) + .clamp(0.0, width) + .toDouble(), + (height - top - node.paddingBottom - (horizontal ? gutter : 0)) + .clamp(0.0, height) + .toDouble(), + ); + } + + double _clampScroll( + double value, { + required double? viewportExtent, + required double? contentExtent, + }) { + final maxScroll = (contentExtent ?? 0) - (viewportExtent ?? 0); + if (maxScroll <= 0) { + return 0; + } + return value.clamp(0, maxScroll).toDouble(); + } + + void _emitScrollEvent(RuntimeComponent component, {required String source}) { + final node = component.node; + final handler = node.onScroll; + if (handler == null || handler.isEmpty) { + return; + } + final id = node.id; + _eventSink( + RuntimeEvent( + type: RuntimeEventType.scroll, + target: id, + handler: handler, + scope: id, + targetEpoch: epochOf(id), + scopeEpoch: epochOf(id), + data: { + 'scrollX': node.scrollX, + 'scrollY': node.scrollY, + 'maxScrollX': _clampScroll( + double.infinity, + viewportExtent: node.width, + contentExtent: node.contentWidth, + ), + 'maxScrollY': _clampScroll( + double.infinity, + viewportExtent: node.height, + contentExtent: node.contentHeight, + ), + 'source': source, + }, + ), + ); + } + + bool _wouldCreateCycle(String nodeId, String parentId) { + var currentId = parentId; + while (true) { + if (currentId == nodeId) { + return true; + } + + final parent = _components[currentId]; + final nextId = parent?.node.parent; + if (nextId == null) { + return false; + } + currentId = nextId; + } + } +} diff --git a/lib/runtime/rendering/runtime_component.dart b/lib/runtime/rendering/runtime_component.dart new file mode 100644 index 0000000..6404075 --- /dev/null +++ b/lib/runtime/rendering/runtime_component.dart @@ -0,0 +1,1075 @@ +import 'dart:math' as math; +import 'dart:typed_data'; +import 'dart:ui' as ui; + +import 'package:flame/components.dart'; +import 'package:flame/events.dart'; +import 'package:flame/particles.dart'; +import 'package:flame_spine/flame_spine.dart' as spine; +import 'package:flutter/material.dart'; + +import '../models/runtime_node.dart'; +import '../protocol/runtime_protocol.dart'; +import '../resources/game_resource_manager.dart'; + +class RuntimeComponent extends PositionComponent + with HasVisibility, TapCallbacks { + RuntimeComponent({ + required RuntimeNode node, + required GameResourceManager resources, + required this.onNodeTap, + }) : _node = node, + _resources = resources { + priority = node.layer; + _applyBase(node); + _syncImage(node); + _syncSpine(node); + _syncParticle(node); + } + + RuntimeNode get node => _node; + + final GameResourceManager _resources; + final void Function(RuntimeNode node, Vector2 localPosition) onNodeTap; + RuntimeNode _node; + TextComponent? _textComponent; + ui.Image? _image; + String? _loadedAsset; + int? _loadedGeneration; + int _imageLoadToken = 0; + spine.SpineComponent? _spineComponent; + ParticleSystemComponent? _particleComponent; + String? _particleSignature; + String? _loadedSpineAsset; + int? _loadedSpineGeneration; + int _spineLoadToken = 0; + String? _appliedSpineAnimation; + bool? _appliedSpineLoop; + String? _pendingSpineAnimation; + int _pendingSpineTrack = 0; + bool _pendingSpineLoop = true; + bool _pendingSpineQueue = false; + double _pendingSpineDelay = 0; + String? _appliedSpineSkin; + double? _runtimeAlpha; + double _parentScrollX = 0; + double _parentScrollY = 0; + double _parentContentOffsetX = 0; + double _parentContentOffsetY = 0; + bool _viewportCulled = false; + bool _pressed = false; + + double get renderAlpha => _runtimeAlpha ?? _node.alpha; + + void setRuntimeAlpha(double value) { + _runtimeAlpha = value.clamp(0, 1).toDouble(); + } + + void setParentScroll({ + double x = 0, + double y = 0, + double contentOffsetX = 0, + double contentOffsetY = 0, + }) { + _parentScrollX = x < 0 ? 0 : x; + _parentScrollY = y < 0 ? 0 : y; + _parentContentOffsetX = contentOffsetX < 0 ? 0 : contentOffsetX; + _parentContentOffsetY = contentOffsetY < 0 ? 0 : contentOffsetY; + _syncPosition(); + } + + void setViewportCulled(bool value) { + _viewportCulled = value; + _syncVisibility(); + } + + void updateNode(RuntimeNode node) { + _node = node; + priority = node.layer; + _applyBase(node); + _syncImage(node); + _syncSpine(node); + _syncParticle(node); + } + + bool containsVisualPoint(Vector2 point) { + if (!_node.visible) { + return false; + } + final local = absoluteToLocal(point); + return local.x >= 0 && + local.y >= 0 && + local.x <= size.x && + local.y <= size.y; + } + + @override + bool containsLocalPoint(Vector2 point) { + if (!_node.visible || !_node.interactive) { + return false; + } + return point.x >= 0 && + point.y >= 0 && + point.x <= size.x && + point.y <= size.y; + } + + @override + void onTapDown(TapDownEvent event) { + if (!_node.visible || !_node.interactive) { + return; + } + if (_node.type == RuntimeNodeType.button) { + _pressed = true; + _syncImage(_node); + } + onNodeTap(_node, event.localPosition); + } + + @override + void onTapUp(TapUpEvent event) { + _releasePressedState(); + } + + @override + void onTapCancel(TapCancelEvent event) { + _releasePressedState(); + } + + void _releasePressedState() { + if (!_pressed) { + return; + } + _pressed = false; + _syncImage(_node); + } + + @override + void renderTree(Canvas canvas) { + if (_node.type != RuntimeNodeType.listView) { + super.renderTree(canvas); + return; + } + + if (!isVisible) { + return; + } + + final paint = Paint() + ..color = (_node.color ?? _defaultColor()).withValues(alpha: renderAlpha); + + canvas.save(); + canvas.transform(Float64List.fromList(transform.transformMatrix.storage)); + _renderBoxOrImage(canvas, paint); + canvas.save(); + canvas.clipRRect(_listViewClipRRect()); + for (final child in children) { + child.renderTree(canvas); + } + canvas.restore(); + _renderListViewScrollbar(canvas); + if (debugMode) { + renderDebugMode(canvas); + } + canvas.restore(); + } + + @override + void render(Canvas canvas) { + final paint = Paint() + ..color = (_node.color ?? _defaultColor()).withValues(alpha: renderAlpha); + + switch (_node.type) { + case RuntimeNodeType.circle: + canvas.drawCircle(Offset(size.x / 2, size.y / 2), size.x / 2, paint); + break; + case RuntimeNodeType.line: + _renderLine(canvas, paint); + break; + case RuntimeNodeType.progress: + _renderProgress(canvas, paint); + break; + case RuntimeNodeType.listView: + _renderListView(canvas, paint); + break; + case RuntimeNodeType.panel: + case RuntimeNodeType.button: + case RuntimeNodeType.rect: + case RuntimeNodeType.sprite: + case RuntimeNodeType.image: + _renderBoxOrImage(canvas, paint); + break; + case RuntimeNodeType.spine: + _renderSpinePlaceholder(canvas, paint); + break; + case RuntimeNodeType.particle: + break; + default: + break; + } + } + + void _renderLine(Canvas canvas, Paint paint) { + final stroke = _node.strokeWidth ?? 2; + canvas.drawLine( + Offset.zero, + Offset(size.x, size.y), + paint + ..style = PaintingStyle.stroke + ..strokeWidth = stroke, + ); + } + + void _renderProgress(Canvas canvas, Paint paint) { + final rect = Rect.fromLTWH(0, 0, size.x, size.y); + final radius = Radius.circular(_node.radius ?? 4); + final backgroundPaint = Paint() + ..color = const Color(0x33475569).withValues(alpha: renderAlpha); + canvas.drawRRect(RRect.fromRectAndRadius(rect, radius), backgroundPaint); + + final value = _node.value ?? 0; + if (value <= 0) { + return; + } + final fillRect = Rect.fromLTWH(0, 0, size.x * value, size.y); + canvas.drawRRect(RRect.fromRectAndRadius(fillRect, radius), paint); + } + + void _renderSpinePlaceholder(Canvas canvas, Paint paint) { + if (_spineComponent != null) { + return; + } + final rect = Rect.fromLTWH(0, 0, size.x, size.y); + canvas.drawRRect( + RRect.fromRectAndRadius(rect, const Radius.circular(4)), + paint, + ); + } + + void _renderListView(Canvas canvas, Paint paint) { + _renderBoxOrImage(canvas, paint); + } + + double get _scrollbarThickness => + (_node.scrollbarThickness ?? 5).clamp(1.0, 16.0).toDouble(); + + double get _scrollbarGutter => _scrollbarThickness + 8; + + ({bool horizontal, bool vertical}) _listViewScrollbarVisibility() { + if (!_node.scrollbarVisible) { + return (horizontal: false, vertical: false); + } + final left = _node.paddingLeft.clamp(0.0, size.x).toDouble(); + final top = _node.paddingTop.clamp(0.0, size.y).toDouble(); + final right = _node.paddingRight.clamp(0.0, size.x).toDouble(); + final bottom = _node.paddingBottom.clamp(0.0, size.y).toDouble(); + var viewportWidth = size.x - left - right; + var viewportHeight = size.y - top - bottom; + var vertical = + (_node.contentHeight ?? 0) > viewportHeight && viewportHeight > 0; + var horizontal = + (_node.contentWidth ?? 0) > viewportWidth && viewportWidth > 0; + for (var i = 0; i < 2; i += 1) { + viewportWidth = size.x - left - right - (vertical ? _scrollbarGutter : 0); + viewportHeight = + size.y - top - bottom - (horizontal ? _scrollbarGutter : 0); + vertical = + (_node.contentHeight ?? 0) > viewportHeight && viewportHeight > 0; + horizontal = + (_node.contentWidth ?? 0) > viewportWidth && viewportWidth > 0; + } + return (horizontal: horizontal, vertical: vertical); + } + + Rect _listViewContentRect() { + final scrollbars = _listViewScrollbarVisibility(); + final left = _node.paddingLeft.clamp(0.0, size.x).toDouble(); + final top = _node.paddingTop.clamp(0.0, size.y).toDouble(); + final rightInset = + (_node.paddingRight + (scrollbars.vertical ? _scrollbarGutter : 0)) + .clamp(0.0, size.x) + .toDouble(); + final bottomInset = + (_node.paddingBottom + (scrollbars.horizontal ? _scrollbarGutter : 0)) + .clamp(0.0, size.y) + .toDouble(); + final width = (size.x - left - rightInset).clamp(0.0, size.x).toDouble(); + final height = (size.y - top - bottomInset).clamp(0.0, size.y).toDouble(); + return Rect.fromLTWH(left, top, width, height); + } + + RRect _listViewClipRRect() { + final radius = Radius.circular((_node.radius ?? 0).clamp(0.0, 10000.0)); + return RRect.fromRectAndRadius(_listViewContentRect(), radius); + } + + Vector2 listViewContentOffset() { + if (_node.type != RuntimeNodeType.listView) { + return Vector2.zero(); + } + final rect = _listViewContentRect(); + return Vector2(rect.left, rect.top); + } + + Vector2 listViewContentViewport() { + if (_node.type != RuntimeNodeType.listView) { + return Vector2.zero(); + } + final rect = _listViewContentRect(); + return Vector2(rect.width, rect.height); + } + + void _renderListViewScrollbar(Canvas canvas) { + if (!_node.scrollbarVisible) { + return; + } + final thickness = _scrollbarThickness; + final contentRect = _listViewContentRect(); + final scrollbars = _listViewScrollbarVisibility(); + final trackPaint = Paint() + ..color = (_node.scrollbarTrackColor ?? const Color(0x33475569)) + .withValues(alpha: renderAlpha); + final thumbPaint = Paint() + ..color = (_node.scrollbarThumbColor ?? const Color(0xaa94a3b8)) + .withValues(alpha: renderAlpha); + + final contentHeight = _node.contentHeight; + if (scrollbars.vertical && + contentHeight != null && + contentRect.height > 0) { + final trackHeight = (contentRect.height - 12).clamp( + 4.0, + contentRect.height, + ); + final maxScroll = contentHeight - contentRect.height; + final thumbHeight = + (contentRect.height * contentRect.height / contentHeight).clamp( + 18.0, + contentRect.height, + ); + final thumbY = maxScroll <= 0 + ? 0.0 + : (_node.scrollY / maxScroll) * (contentRect.height - thumbHeight); + canvas.drawRRect( + RRect.fromRectAndRadius( + Rect.fromLTWH(size.x - thickness - 2, 6, thickness, trackHeight), + Radius.circular(thickness / 2), + ), + trackPaint, + ); + canvas.drawRRect( + RRect.fromRectAndRadius( + Rect.fromLTWH( + size.x - thickness - 2, + thumbY + 6, + thickness, + (thumbHeight - 12).clamp(4.0, contentRect.height), + ), + Radius.circular(thickness / 2), + ), + thumbPaint, + ); + } + + final contentWidth = _node.contentWidth; + if (scrollbars.horizontal && + contentWidth != null && + contentRect.width > 0) { + final trackWidth = (contentRect.width - 12).clamp(4.0, contentRect.width); + final maxScroll = contentWidth - contentRect.width; + final thumbWidth = (contentRect.width * contentRect.width / contentWidth) + .clamp(18.0, contentRect.width); + final thumbX = maxScroll <= 0 + ? 0.0 + : (_node.scrollX / maxScroll) * (contentRect.width - thumbWidth); + canvas.drawRRect( + RRect.fromRectAndRadius( + Rect.fromLTWH(6, size.y - thickness - 2, trackWidth, thickness), + Radius.circular(thickness / 2), + ), + trackPaint, + ); + canvas.drawRRect( + RRect.fromRectAndRadius( + Rect.fromLTWH( + thumbX + 6, + size.y - thickness - 2, + (thumbWidth - 12).clamp(4.0, contentRect.width), + thickness, + ), + Radius.circular(thickness / 2), + ), + thumbPaint, + ); + } + } + + void _renderBoxOrImage(Canvas canvas, Paint paint) { + final image = _image; + final rect = Rect.fromLTWH(0, 0, size.x, size.y); + if (image != null && + (_node.type == RuntimeNodeType.sprite || + _node.type == RuntimeNodeType.image || + _node.type == RuntimeNodeType.button)) { + canvas.drawImageRect( + image, + Rect.fromLTWH(0, 0, image.width.toDouble(), image.height.toDouble()), + rect, + Paint()..color = Colors.white.withValues(alpha: renderAlpha), + ); + return; + } + + final radius = + _node.radius ?? (_node.type == RuntimeNodeType.button ? 12.0 : 4.0); + canvas.drawRRect( + RRect.fromRectAndRadius(rect, Radius.circular(radius)), + paint, + ); + } + + void _applyBase(RuntimeNode node) { + _syncVisibility(); + size = Vector2(node.width ?? 40, node.height ?? 40); + _syncPosition(); + scale = Vector2.all(node.scale); + angle = node.rotation; + anchor = _anchorFromString(node.anchor); + _syncText(node); + _syncSpineLayout(); + } + + void _syncVisibility() { + isVisible = _node.visible && !_viewportCulled; + } + + void _syncPosition() { + position = Vector2( + _parentContentOffsetX + _node.x - _parentScrollX, + _parentContentOffsetY + _node.y - _parentScrollY, + ); + } + + void _syncImage(RuntimeNode node) { + if (node.type != RuntimeNodeType.sprite && + node.type != RuntimeNodeType.image && + node.type != RuntimeNodeType.button) { + _imageLoadToken++; + _releaseLoadedImage(); + return; + } + final asset = _currentImageAsset(node); + if (asset == null || asset.isEmpty) { + _imageLoadToken++; + _releaseLoadedImage(); + return; + } + + final requestedGeneration = _resources.generation; + if (asset == _loadedAsset && requestedGeneration == _loadedGeneration) { + return; + } + + final requestToken = ++_imageLoadToken; + _releaseLoadedImage(); + _loadedAsset = asset; + _loadedGeneration = requestedGeneration; + _resources.loadImage(asset, retain: true).then((image) { + if (_imageLoadToken != requestToken) { + _releaseRetainedImage(asset, requestedGeneration, image); + return; + } + if (_loadedAsset != asset || _loadedGeneration != requestedGeneration) { + _releaseRetainedImage(asset, requestedGeneration, image); + return; + } + if (_resources.generation != requestedGeneration) { + _releaseRetainedImage(asset, requestedGeneration, image); + return; + } + _image = image; + }); + } + + String? _currentImageAsset(RuntimeNode node) { + if (node.type != RuntimeNodeType.button) { + return node.asset; + } + if (!node.interactive && node.disabledAsset != null) { + return node.disabledAsset; + } + if (_pressed && node.pressedAsset != null) { + return node.pressedAsset; + } + return node.asset; + } + + void _releaseRetainedImage(String asset, int generation, ui.Image? image) { + if (image == null) { + return; + } + _resources.releaseImage(asset, generation: generation); + } + + void _syncParticle(RuntimeNode node) { + if (node.type != RuntimeNodeType.particle) { + _releaseParticle(); + return; + } + + final signature = _particleNodeSignature(node); + if (signature == _particleSignature && _particleComponent != null) { + _syncParticleLayout(); + return; + } + + _releaseParticle(); + _particleSignature = signature; + final component = ParticleSystemComponent( + particle: _buildParticle(node), + position: Vector2.zero(), + size: size, + anchor: Anchor.topLeft, + priority: priority + 1, + ); + _particleComponent = component; + add(component); + } + + String _particleNodeSignature(RuntimeNode node) { + return [ + node.preset, + node.count, + node.duration, + node.color, + node.colorTo, + node.radius, + node.radiusTo, + node.speedMin, + node.speedMax, + node.gravityX, + node.gravityY, + node.spread, + node.autoRemove, + node.fadeOut, + node.width, + node.height, + ].join('|'); + } + + Particle _buildParticle(RuntimeNode node) { + final preset = node.preset ?? RuntimeParticlePresetValue.burst; + final count = (node.count ?? _defaultParticleCount(preset)).clamp(1, 300); + final duration = node.duration ?? _defaultParticleDuration(preset); + return Particle.generate( + count: count, + lifespan: node.autoRemove ? duration : 86400, + generator: (index) => ComputedParticle( + lifespan: node.autoRemove ? duration : 86400, + renderer: (canvas, particle) => _renderComputedParticle( + canvas, + particle, + node, + preset, + index, + count, + duration, + ), + ), + ); + } + + int _defaultParticleCount(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => 80, + RuntimeParticlePresetValue.confetti => 72, + RuntimeParticlePresetValue.trail => 16, + _ => 36, + }; + } + + double _defaultParticleDuration(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => 8, + RuntimeParticlePresetValue.confetti => 1.2, + RuntimeParticlePresetValue.trail => 0.35, + _ => 0.55, + }; + } + + void _renderComputedParticle( + Canvas canvas, + Particle particle, + RuntimeNode node, + String preset, + int index, + int count, + double duration, + ) { + final config = _particleConfig(node, preset, index, count); + final progress = node.autoRemove + ? particle.progress + : ((particle.progress * 86400 / duration) % 1.0); + final x = + config.start.x + + config.velocity.x * progress * duration + + 0.5 * config.gravity.x * progress * progress * duration * duration; + final y = + config.start.y + + config.velocity.y * progress * duration + + 0.5 * config.gravity.y * progress * progress * duration * duration; + final radius = config.radius + (config.radiusTo - config.radius) * progress; + if (radius <= 0) { + return; + } + final color = + Color.lerp(config.color, config.colorTo, progress) ?? config.color; + final alpha = node.fadeOut ? (1 - progress).clamp(0.0, 1.0) : 1.0; + final paint = Paint() + ..color = color.withValues(alpha: color.a * renderAlpha * alpha); + canvas.drawCircle(Offset(x, y), radius, paint); + } + + _ParticleConfig _particleConfig( + RuntimeNode node, + String preset, + int index, + int count, + ) { + final width = node.width ?? size.x; + final height = node.height ?? size.y; + final center = Vector2(width / 2, height / 2); + final baseColor = node.color ?? _defaultParticleColor(preset); + final colorTo = node.colorTo ?? baseColor.withValues(alpha: 0); + final radius = node.radius ?? _defaultParticleRadius(preset); + final radiusTo = node.radiusTo ?? 0; + final speedMin = node.speedMin ?? _defaultParticleSpeedMin(preset); + final speedMax = node.speedMax ?? _defaultParticleSpeedMax(preset); + final gravity = Vector2( + node.gravityX ?? 0, + node.gravityY ?? _defaultParticleGravityY(preset), + ); + + if (preset == RuntimeParticlePresetValue.snow) { + final x = width * _stableUnit(index, 3); + final y = height * _stableUnit(index, 7); + final drift = -12 + 24 * _stableUnit(index, 11); + final fall = speedMin + (speedMax - speedMin) * _stableUnit(index, 13); + return _ParticleConfig( + start: Vector2(x, y), + velocity: Vector2(drift, fall), + gravity: gravity, + color: baseColor, + colorTo: colorTo, + radius: radius * (0.6 + _stableUnit(index, 17)), + radiusTo: radiusTo, + ); + } + + if (preset == RuntimeParticlePresetValue.trail) { + final angle = -math.pi / 2 + (_stableUnit(index, 23) - 0.5) * math.pi; + final speed = speedMin + _stableUnit(index, 29) * (speedMax - speedMin); + return _ParticleConfig( + start: center, + velocity: Vector2(math.cos(angle), math.sin(angle)) * speed, + gravity: gravity, + color: baseColor, + colorTo: colorTo, + radius: radius, + radiusTo: radiusTo, + ); + } + + final spread = (node.spread ?? 360) * math.pi / 180; + final baseAngle = preset == RuntimeParticlePresetValue.confetti + ? -math.pi / 2 + : 0.0; + final angle = + baseAngle - + spread / 2 + + spread * (count <= 1 ? 0 : index / (count - 1)); + final speed = speedMin + _stableUnit(index, 31) * (speedMax - speedMin); + return _ParticleConfig( + start: center, + velocity: Vector2(math.cos(angle), math.sin(angle)) * speed, + gravity: gravity, + color: baseColor, + colorTo: node.colorTo ?? _defaultParticleColorTo(preset, baseColor), + radius: radius, + radiusTo: radiusTo, + ); + } + + double _stableUnit(int index, int salt) { + final value = math.sin((index + 1) * (salt + 17) * 12.9898) * 43758.5453; + return value - value.floorToDouble(); + } + + Color _defaultParticleColor(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => const Color(0xccffffff), + RuntimeParticlePresetValue.confetti => const Color(0xffff4d6d), + RuntimeParticlePresetValue.trail => const Color(0xff38bdf8), + _ => const Color(0xffffcc33), + }; + } + + Color _defaultParticleColorTo(String preset, Color base) { + return switch (preset) { + RuntimeParticlePresetValue.confetti => const Color(0xfffacc15), + _ => base.withValues(alpha: 0), + }; + } + + double _defaultParticleRadius(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => 1.6, + RuntimeParticlePresetValue.confetti => 2.6, + RuntimeParticlePresetValue.trail => 2.0, + _ => 2.4, + }; + } + + double _defaultParticleSpeedMin(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => 12, + RuntimeParticlePresetValue.confetti => 120, + RuntimeParticlePresetValue.trail => 20, + _ => 80, + }; + } + + double _defaultParticleSpeedMax(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => 28, + RuntimeParticlePresetValue.confetti => 260, + RuntimeParticlePresetValue.trail => 70, + _ => 220, + }; + } + + double _defaultParticleGravityY(String preset) { + return switch (preset) { + RuntimeParticlePresetValue.snow => 4, + RuntimeParticlePresetValue.confetti => 240, + RuntimeParticlePresetValue.trail => 0, + _ => 80, + }; + } + + void _syncParticleLayout() { + final particle = _particleComponent; + if (particle == null) { + return; + } + particle + ..position = Vector2.zero() + ..size = size + ..anchor = Anchor.topLeft + ..priority = priority + 1; + } + + void _releaseParticle() { + _particleComponent?.removeFromParent(); + _particleComponent = null; + _particleSignature = null; + } + + void _syncSpine(RuntimeNode node) { + if (node.type != RuntimeNodeType.spine) { + _spineLoadToken++; + _releaseLoadedSpine(); + return; + } + final asset = node.asset; + if (asset == null || asset.isEmpty) { + _spineLoadToken++; + _releaseLoadedSpine(); + return; + } + + final requestedGeneration = _resources.generation; + if (asset == _loadedSpineAsset && + requestedGeneration == _loadedSpineGeneration) { + _syncSpineLayout(); + _syncSpineSkin(node); + _syncSpineAnimation(node); + return; + } + + final requestToken = ++_spineLoadToken; + _releaseLoadedSpine(); + _loadedSpineAsset = asset; + _loadedSpineGeneration = requestedGeneration; + _resources.createSpineComponent(asset).then((spine) { + if (_spineLoadToken != requestToken) { + spine?.dispose(); + return; + } + if (_loadedSpineAsset != asset || + _loadedSpineGeneration != requestedGeneration) { + spine?.dispose(); + return; + } + if (_resources.generation != requestedGeneration) { + spine?.dispose(); + return; + } + if (spine == null) { + return; + } + _spineComponent = spine; + add(spine); + _syncSpineLayout(); + _syncSpineSkin(_node); + _syncSpineAnimation(_node); + }); + } + + bool playSpineAnimation( + String animation, { + int track = 0, + bool loop = true, + bool queue = false, + double delay = 0, + }) { + final spine = _spineComponent; + if (spine == null) { + if (_node.type != RuntimeNodeType.spine) { + return false; + } + _pendingSpineAnimation = animation; + _pendingSpineTrack = track; + _pendingSpineLoop = loop; + _pendingSpineQueue = queue; + _pendingSpineDelay = delay; + return true; + } + if (queue) { + spine.animationState.addAnimation(track, animation, loop, delay); + } else { + spine.animationState.setAnimation(track, animation, loop); + } + _appliedSpineAnimation = animation; + _appliedSpineLoop = loop; + _pendingSpineAnimation = null; + return true; + } + + void _syncSpineLayout() { + final spine = _spineComponent; + if (spine == null) { + return; + } + spine + ..position = Vector2.zero() + ..anchor = Anchor.topLeft + ..priority = priority; + final width = _node.width; + final height = _node.height; + if (width != null && + height != null && + spine.size.x > 0 && + spine.size.y > 0) { + spine.scale = Vector2(width / spine.size.x, height / spine.size.y); + } + } + + void _syncSpineSkin(RuntimeNode node) { + final skin = node.skin; + if (skin == null || skin == _appliedSpineSkin) { + return; + } + _spineComponent?.skeleton.setSkin(skin); + _appliedSpineSkin = skin; + } + + void _syncSpineAnimation(RuntimeNode node) { + final pendingAnimation = _pendingSpineAnimation; + if (pendingAnimation != null) { + playSpineAnimation( + pendingAnimation, + track: _pendingSpineTrack, + loop: _pendingSpineLoop, + queue: _pendingSpineQueue, + delay: _pendingSpineDelay, + ); + return; + } + + final animation = node.animation; + if (animation == null) { + return; + } + if (animation == _appliedSpineAnimation && node.loop == _appliedSpineLoop) { + return; + } + playSpineAnimation(animation, loop: node.loop); + } + + void _releaseLoadedSpine() { + final spine = _spineComponent; + if (spine != null) { + spine.removeFromParent(); + spine.dispose(); + } + _spineComponent = null; + _loadedSpineAsset = null; + _loadedSpineGeneration = null; + _appliedSpineAnimation = null; + _appliedSpineLoop = null; + _pendingSpineAnimation = null; + _pendingSpineTrack = 0; + _pendingSpineLoop = true; + _pendingSpineQueue = false; + _pendingSpineDelay = 0; + _appliedSpineSkin = null; + } + + void _releaseLoadedImage() { + final asset = _loadedAsset; + final generation = _loadedGeneration; + if (_image != null && asset != null && generation != null) { + _resources.releaseImage(asset, generation: generation); + } + _image = null; + _loadedAsset = null; + _loadedGeneration = null; + } + + void _syncText(RuntimeNode node) { + final label = node.text; + if (label == null && node.type != RuntimeNodeType.text) { + _textComponent?.removeFromParent(); + _textComponent = null; + return; + } + + final text = label ?? ''; + final color = _textColor(node); + final style = TextStyle( + color: color.withValues(alpha: renderAlpha), + fontSize: node.fontSize ?? 18, + fontWeight: node.type == RuntimeNodeType.button + ? FontWeight.w600 + : FontWeight.normal, + ); + + final component = _textComponent; + if (component == null) { + _textComponent = TextComponent( + text: text, + textRenderer: TextPaint(style: style), + anchor: _textAnchor(node), + position: _textPosition(node), + priority: priority + 1, + ); + add(_textComponent!); + return; + } + + component + ..text = text + ..textRenderer = TextPaint(style: style) + ..anchor = _textAnchor(node) + ..position = _textPosition(node) + ..priority = priority + 1; + } + + @override + void onRemove() { + _imageLoadToken++; + _spineLoadToken++; + _releaseLoadedImage(); + _releaseLoadedSpine(); + _releaseParticle(); + _runtimeAlpha = null; + _pressed = false; + _textComponent = null; + super.onRemove(); + } + + Anchor _textAnchor(RuntimeNode node) { + final topAligned = _usesTopAlignedText(node); + return switch (node.textAlign) { + RuntimeTextAlignValue.left => + topAligned ? Anchor.topLeft : Anchor.centerLeft, + RuntimeTextAlignValue.right => + topAligned ? Anchor.topRight : Anchor.centerRight, + _ => topAligned ? Anchor.topCenter : Anchor.center, + }; + } + + Vector2 _textPosition(RuntimeNode node) { + final topAligned = _usesTopAlignedText(node); + return switch (node.textAlign) { + RuntimeTextAlignValue.left => + topAligned ? Vector2.zero() : Vector2(0, size.y / 2), + RuntimeTextAlignValue.right => + topAligned ? Vector2(size.x, 0) : Vector2(size.x, size.y / 2), + _ => topAligned ? Vector2(size.x / 2, 0) : size / 2, + }; + } + + bool _usesTopAlignedText(RuntimeNode node) { + if (node.type == RuntimeNodeType.button) { + return false; + } + return (node.text ?? '').contains('\n'); + } + + Color _textColor(RuntimeNode node) { + if (node.type == RuntimeNodeType.button) { + return Colors.white; + } + return node.color ?? Colors.white; + } + + Color _defaultColor() { + return switch (_node.type) { + RuntimeNodeType.button => const Color(0xff3662d8), + RuntimeNodeType.panel => const Color(0xaa111827), + RuntimeNodeType.text => Colors.transparent, + RuntimeNodeType.circle => const Color(0xffef4444), + RuntimeNodeType.rect => const Color(0xff334155), + RuntimeNodeType.listView => const Color(0xff111827), + RuntimeNodeType.line => const Color(0xffffffff), + RuntimeNodeType.progress => const Color(0xff22c55e), + RuntimeNodeType.sprite || + RuntimeNodeType.image || + RuntimeNodeType.spine => const Color(0xff64748b), + _ => const Color(0xff94a3b8), + }; + } + + Anchor _anchorFromString(String value) { + return switch (value) { + RuntimeAnchorValue.center => Anchor.center, + RuntimeAnchorValue.topLeft => Anchor.topLeft, + RuntimeAnchorValue.topRight => Anchor.topRight, + RuntimeAnchorValue.bottomLeft => Anchor.bottomLeft, + RuntimeAnchorValue.bottomRight => Anchor.bottomRight, + _ => Anchor.topLeft, + }; + } +} + +class _ParticleConfig { + const _ParticleConfig({ + required this.start, + required this.velocity, + required this.gravity, + required this.color, + required this.colorTo, + required this.radius, + required this.radiusTo, + }); + + final Vector2 start; + final Vector2 velocity; + final Vector2 gravity; + final Color color; + final Color colorTo; + final double radius; + final double radiusTo; +} diff --git a/lib/runtime/resources/game_resource_cache.dart b/lib/runtime/resources/game_resource_cache.dart new file mode 100644 index 0000000..31db9e0 --- /dev/null +++ b/lib/runtime/resources/game_resource_cache.dart @@ -0,0 +1,66 @@ +part of 'game_resource_manager.dart'; + +extension _GameResourceManagerCache on GameResourceManager { + void _touch(_ImageResourceRecord record) { + record.lastUsed = ++_accessCounter; + } + + void _enforceImageBudget() { + while (_isOverBudget()) { + final victim = _leastRecentlyUsedEvictableImage(); + if (victim == null || !_removeImageRecord(victim)) { + return; + } + } + } + + bool _isOverBudget() { + final maxBytes = _maxCacheBytes; + final maxEntries = _maxCacheEntries; + return (maxBytes != null && _cacheBytes > maxBytes) || + (maxEntries != null && _readyImageCount > maxEntries); + } + + int get _readyImageCount => _images.values + .where((record) => record.state == GameResourceState.ready) + .length; + + String? _leastRecentlyUsedEvictableImage() { + String? victimPath; + _ImageResourceRecord? victim; + for (final entry in _images.entries) { + final record = entry.value; + if (record.state != GameResourceState.ready || record.refCount > 0) { + continue; + } + if (victim == null || record.lastUsed < victim.lastUsed) { + victim = record; + victimPath = entry.key; + } + } + return victimPath; + } + + void _releaseCachedImages() { + _loadLimiter.clearPending(); + for (final path in _images.keys.toList(growable: false)) { + _removeImageRecord(path); + } + } + + bool _removeImageRecord(String path) { + final record = _images.remove(path); + if (record == null) { + return false; + } + record.state = GameResourceState.disposed; + _cacheBytes -= record.estimatedBytes; + if (_cacheBytes < 0) { + _cacheBytes = 0; + } + record.image?.dispose(); + record.image = null; + record.inflight = null; + return true; + } +} diff --git a/lib/runtime/resources/game_resource_debug.dart b/lib/runtime/resources/game_resource_debug.dart new file mode 100644 index 0000000..fbf16c9 --- /dev/null +++ b/lib/runtime/resources/game_resource_debug.dart @@ -0,0 +1,28 @@ +part of 'game_resource_manager.dart'; + +extension _GameResourceManagerDebug on GameResourceManager { + Map _imageRecordDebugJson({ + required String? key, + required String path, + required String? preload, + required bool declared, + }) { + final record = _images[path]; + return { + if (key != null) 'key': key, + 'path': path, + 'type': GameResourceType.image, + 'declared': declared, + if (preload != null) 'preload': preload, + if (key != null && _package?.manifest.resources[key]?.group != null) + 'group': _package?.manifest.resources[key]?.group, + 'state': (record?.state ?? GameResourceState.idle).name, + if (record != null) 'generation': record.generation, + 'loading': record?.inflight != null, + 'ready': record?.image != null, + if (record != null) 'refCount': record.refCount, + if (record != null) 'bytes': record.estimatedBytes, + if (record?.lastError != null) 'error': record!.lastError.toString(), + }; + } +} diff --git a/lib/runtime/resources/game_resource_loading.dart b/lib/runtime/resources/game_resource_loading.dart new file mode 100644 index 0000000..9a616c9 --- /dev/null +++ b/lib/runtime/resources/game_resource_loading.dart @@ -0,0 +1,186 @@ +part of 'game_resource_manager.dart'; + +extension _GameResourceManagerLoading on GameResourceManager { + Future _loadImage( + String? keyOrPath, { + required bool failOnError, + bool retain = false, + }) { + if (keyOrPath == null || keyOrPath.isEmpty) { + return Future.value(null); + } + + final requestToken = _asyncGate.token; + final requestGeneration = requestToken.generation; + final path = _tryResolve(keyOrPath); + if (path == null) { + return Future.value(null); + } + + final existing = _images[path]; + if (existing != null) { + final image = existing.image; + if (existing.generation == requestGeneration && + existing.state == GameResourceState.ready && + image != null) { + if (retain) { + existing.refCount++; + } + _touch(existing); + return Future.value(image); + } + final inflight = existing.inflight; + if (existing.generation == requestGeneration && inflight != null) { + return failOnError + ? _throwIfNull(inflight, keyOrPath) + : inflight.catchError((_) => null); + } + } + + final record = _ImageResourceRecord(generation: requestGeneration) + ..state = GameResourceState.loading; + _images[path] = record; + + final future = _decodeImage(path, record, requestToken, retain: retain); + record.inflight = future; + return failOnError ? _throwIfNull(future, keyOrPath) : future; + } + + Future _throwIfNull( + Future future, + String keyOrPath, + ) async { + final image = await future; + if (image == null) { + throw ResourceLoadException('Required image resource failed: $keyOrPath'); + } + return image; + } + + Future _decodeImage( + String path, + _ImageResourceRecord record, + RuntimeAsyncToken requestToken, { + required bool retain, + }) async { + try { + final activePackage = _package; + if (activePackage == null) { + throw StateError('GameResourceManager has no active package'); + } + + final frame = await _loadLimiter.run(() async { + final bytes = await activePackage.readBytes(path); + final codec = await ui.instantiateImageCodec( + bytes.buffer.asUint8List(), + ); + return codec.getNextFrame(); + }); + record.inflight = null; + + if (!_asyncGate.accepts(requestToken) || _images[path] != record) { + frame.image.dispose(); + record.state = GameResourceState.disposed; + return null; + } + + record + ..image = frame.image + ..estimatedBytes = frame.image.width * frame.image.height * 4 + ..state = GameResourceState.ready + ..lastError = null; + if (retain) { + record.refCount++; + } + _cacheBytes += record.estimatedBytes; + _touch(record); + _enforceImageBudget(); + return frame.image; + } catch (error) { + record.inflight = null; + if (!_asyncGate.accepts(requestToken) || _images[path] != record) { + record.state = GameResourceState.disposed; + return null; + } + record + ..state = GameResourceState.failed + ..lastError = error; + _diagnostics?.record( + type: RuntimeDiagnosticType.resourceLoadError, + message: 'Image resource failed to load', + error: error, + context: {'path': path, 'generation': requestToken.generation}, + ); + return null; + } + } + + Future _preloadSpine( + String keyOrPath, { + required bool failOnError, + }) async { + final spine = await _createSpineComponent(keyOrPath); + spine?.dispose(); + if (failOnError && spine == null) { + throw ResourceLoadException('Required spine resource failed: $keyOrPath'); + } + } + + Future _createSpineComponent(String? keyOrPath) async { + if (keyOrPath == null || keyOrPath.isEmpty) { + return null; + } + final requestToken = _asyncGate.token; + final activePackage = _package; + if (activePackage == null) { + return null; + } + final resource = activePackage.manifest.resources[keyOrPath]; + if (resource == null || resource.type != GameResourceType.spine) { + return null; + } + + try { + await initSpineFlutter(); + final atlasPath = activePackage.resolveResourcePath(resource.atlas!); + final skeletonPath = activePackage.resolveResourcePath( + resource.skeleton!, + ); + final drawable = await _loadLimiter.run(() { + return SkeletonDrawableFlutter.fromMemory(atlasPath, skeletonPath, ( + name, + ) async { + final bytes = await activePackage.readBytes(name); + return bytes.buffer.asUint8List( + bytes.offsetInBytes, + bytes.lengthInBytes, + ); + }); + }); + if (!_asyncGate.accepts(requestToken)) { + drawable.dispose(); + return null; + } + return SpineComponent(drawable); + } catch (error) { + if (!_asyncGate.accepts(requestToken)) { + return null; + } + _diagnostics?.record( + type: RuntimeDiagnosticType.resourceLoadError, + message: 'Spine resource failed to load', + error: error, + context: {'key': keyOrPath, 'generation': requestToken.generation}, + ); + return null; + } + } + + String? _tryResolve(String keyOrPath) { + try { + return resolve(keyOrPath); + } catch (_) { + return null; + } + } +} diff --git a/lib/runtime/resources/game_resource_manager.dart b/lib/runtime/resources/game_resource_manager.dart new file mode 100644 index 0000000..2f6ce1b --- /dev/null +++ b/lib/runtime/resources/game_resource_manager.dart @@ -0,0 +1,279 @@ +import 'dart:ui' as ui; + +import 'package:flame_spine/flame_spine.dart'; + +import '../diagnostics/runtime_diagnostics.dart'; +import '../lifecycle/runtime_async_gate.dart'; +import '../packages/game_package.dart'; +import '../packages/game_package_manifest.dart'; +import 'resource_load_limiter.dart'; + +// These part files only group GameResourceManager private helpers. The public +// facade stays in GameResourceManager so callers do not depend on extensions. +part 'game_resource_loading.dart'; +part 'game_resource_debug.dart'; +part 'game_resource_cache.dart'; + +class GameResourceManager { + GameResourceManager({ + RuntimeDiagnostics? diagnostics, + int? maxCacheBytes, + int? maxCacheEntries, + int maxConcurrentLoads = 4, + }) : _diagnostics = diagnostics, + _maxCacheBytes = maxCacheBytes, + _maxCacheEntries = maxCacheEntries, + _loadLimiter = ResourceLoadLimiter(maxConcurrentLoads); + + final RuntimeDiagnostics? _diagnostics; + final int? _maxCacheBytes; + final int? _maxCacheEntries; + final ResourceLoadLimiter _loadLimiter; + final RuntimeAsyncGate _asyncGate = RuntimeAsyncGate(initiallyClosed: true); + GamePackage? _package; + final Map _images = {}; + int _cacheBytes = 0; + int _accessCounter = 0; + + int get generation => _asyncGate.generation; + + bool get hasPackage => _package != null; + + GamePackage get package { + final value = _package; + if (value == null) { + throw StateError('GameResourceManager has no active package'); + } + return value; + } + + Future mount(GamePackage package) async { + _releaseCachedImages(); + _asyncGate.activate(); + _package = package; + await preloadDeclaredImages(package.manifest); + await preloadDeclaredSpines(package.manifest); + } + + void dispose() { + _asyncGate.close(); + _releaseCachedImages(); + _package = null; + } + + String resolve(String keyOrPath) { + return package.resolveResourcePath(keyOrPath); + } + + GameResourceState imageState(String keyOrPath) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return GameResourceState.failed; + } + return _images[path]?.state ?? GameResourceState.idle; + } + + Object? imageError(String keyOrPath) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return StateError('GameResourceManager has no active package'); + } + return _images[path]?.lastError; + } + + Map imagesDebugJson() { + final activePackage = _package; + final declaredPaths = {}; + final resources = >[]; + + if (activePackage != null) { + for (final entry in activePackage.manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.image) { + continue; + } + final path = activePackage.resolveResourcePath(entry.key); + declaredPaths.add(path); + resources.add( + _imageRecordDebugJson( + key: entry.key, + path: path, + preload: resource.preload, + declared: true, + ), + ); + } + } + + for (final path in _images.keys) { + if (declaredPaths.contains(path)) { + continue; + } + resources.add( + _imageRecordDebugJson( + key: null, + path: path, + preload: null, + declared: false, + ), + ); + } + + return { + 'generation': generation, + 'hasPackage': activePackage != null, + 'count': resources.length, + 'activeLoads': _loadLimiter.activeCount, + 'pendingLoads': _loadLimiter.pendingCount, + 'resources': resources, + }; + } + + bool evictImage(String keyOrPath) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return false; + } + return _removeImageRecord(path); + } + + Future retryImage(String keyOrPath) { + evictImage(keyOrPath); + return loadImage(keyOrPath); + } + + Future loadImage(String? keyOrPath, {bool retain = false}) { + return _loadImage(keyOrPath, failOnError: false, retain: retain); + } + + Future createSpineComponent(String? keyOrPath) { + return _createSpineComponent(keyOrPath); + } + + bool retainImage(String keyOrPath, {int? generation}) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return false; + } + final record = _images[path]; + if (record == null || + record.state != GameResourceState.ready || + (generation != null && record.generation != generation)) { + return false; + } + record.refCount++; + _touch(record); + return true; + } + + bool releaseImage(String keyOrPath, {int? generation}) { + final path = _tryResolve(keyOrPath); + if (path == null) { + return false; + } + final record = _images[path]; + if (record == null || + (generation != null && record.generation != generation)) { + return false; + } + if (record.refCount > 0) { + record.refCount--; + } + _touch(record); + _enforceImageBudget(); + return true; + } + + Future preloadGroup(String group, {bool failOnError = false}) async { + final activePackage = _package; + if (activePackage == null) { + throw StateError('GameResourceManager has no active package'); + } + final futures = >[]; + for (final entry in activePackage.manifest.resources.entries) { + final resource = entry.value; + if (resource.type == GameResourceType.image && resource.group == group) { + futures.add( + _loadImage(entry.key, failOnError: failOnError).then((_) {}), + ); + } + if (resource.type == GameResourceType.spine && resource.group == group) { + futures.add(_preloadSpine(entry.key, failOnError: failOnError)); + } + } + await Future.wait(futures); + } + + int evictGroup(String group) { + final activePackage = _package; + if (activePackage == null) { + return 0; + } + var count = 0; + for (final entry in activePackage.manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.image || resource.group != group) { + continue; + } + final path = activePackage.resolveResourcePath(entry.key); + if (_removeImageRecord(path)) { + count++; + } + } + return count; + } + + Future preloadDeclaredImages(GamePackageManifest manifest) async { + final futures = >[]; + for (final entry in manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.image || + resource.preload == GameResourcePreload.lazy) { + continue; + } + + final failOnError = resource.preload == GameResourcePreload.required; + futures.add(_loadImage(entry.key, failOnError: failOnError).then((_) {})); + } + await Future.wait(futures); + } + + Future preloadDeclaredSpines(GamePackageManifest manifest) async { + final futures = >[]; + for (final entry in manifest.resources.entries) { + final resource = entry.value; + if (resource.type != GameResourceType.spine || + resource.preload == GameResourcePreload.lazy) { + continue; + } + + final failOnError = resource.preload == GameResourcePreload.required; + futures.add(_preloadSpine(entry.key, failOnError: failOnError)); + } + await Future.wait(futures); + } +} + +enum GameResourceState { idle, loading, ready, failed, disposed } + +class ResourceLoadException implements Exception { + const ResourceLoadException(this.message); + + final String message; + + @override + String toString() => 'ResourceLoadException: $message'; +} + +class _ImageResourceRecord { + _ImageResourceRecord({required this.generation}); + + final int generation; + GameResourceState state = GameResourceState.idle; + Future? inflight; + ui.Image? image; + Object? lastError; + int estimatedBytes = 0; + int refCount = 0; + int lastUsed = 0; +} diff --git a/lib/runtime/resources/resource_load_limiter.dart b/lib/runtime/resources/resource_load_limiter.dart new file mode 100644 index 0000000..0e3a572 --- /dev/null +++ b/lib/runtime/resources/resource_load_limiter.dart @@ -0,0 +1,91 @@ +import 'dart:async' as async; +import 'dart:collection'; + +class ResourceLoadLimiter { + ResourceLoadLimiter(int maxConcurrent) + : maxConcurrent = _validateMaxConcurrent(maxConcurrent); + + final int maxConcurrent; + final Queue<_QueuedLoadBase> _queue = Queue<_QueuedLoadBase>(); + var _active = 0; + + int get activeCount => _active; + + int get pendingCount => _queue.length; + + Future run(Future Function() task) { + final queued = _QueuedLoad(task); + _queue.add(queued); + _pump(); + return queued.completer.future; + } + + void clearPending() { + while (_queue.isNotEmpty) { + _queue.removeFirst().cancel(); + } + } + + void _pump() { + while (_active < maxConcurrent && _queue.isNotEmpty) { + final queued = _queue.removeFirst(); + _active++; + async.unawaited(_runQueued(queued)); + } + } + + Future _runQueued(_QueuedLoadBase queued) async { + try { + await queued.run(); + } finally { + _active--; + _pump(); + } + } + + static int _validateMaxConcurrent(int value) { + if (value < 1) { + throw ArgumentError.value(value, 'maxConcurrent', 'must be >= 1'); + } + return value; + } +} + +abstract class _QueuedLoadBase { + Future run(); + + void cancel(); +} + +class _QueuedLoad implements _QueuedLoadBase { + _QueuedLoad(this._task); + + final Future Function() _task; + final completer = async.Completer(); + + @override + Future run() async { + if (completer.isCompleted) { + return; + } + try { + completer.complete(await _task()); + } catch (error, stackTrace) { + completer.completeError(error, stackTrace); + } + } + + @override + void cancel() { + if (!completer.isCompleted) { + completer.completeError(const ResourceLoadCancelledException()); + } + } +} + +class ResourceLoadCancelledException implements Exception { + const ResourceLoadCancelledException(); + + @override + String toString() => 'ResourceLoadCancelledException'; +} diff --git a/lib/runtime/scripting/lua_dardo_script_engine.dart b/lib/runtime/scripting/lua_dardo_script_engine.dart new file mode 100644 index 0000000..a00ff64 --- /dev/null +++ b/lib/runtime/scripting/lua_dardo_script_engine.dart @@ -0,0 +1,296 @@ +import 'package:lua_dardo_plus/lua.dart'; + +import '../models/game_diff.dart'; +import '../models/runtime_event.dart'; +import '../packages/game_package.dart'; +import 'script_engine.dart'; + +class LuaDardoScriptEngine implements ScriptEngine { + late final LuaState _lua; + late final Map _moduleScripts; + final Set _loadingModules = {}; + + @override + Future loadPackage(GamePackage package) async { + final script = await package.readText(package.manifest.entry); + _moduleScripts = {}; + for (final entry in package.manifest.modules.entries) { + _moduleScripts[entry.key] = await package.readText(entry.value); + } + _loadingModules.clear(); + + _lua = LuaState.newState(); + _lua.openLibs(); + _disableUnsafeGlobals(); + _installRuntimeApi(); + + final ok = _lua.doString(script); + if (!ok) { + final error = _lua.toStr(-1) ?? 'unknown Lua load error'; + _lua.pop(1); + throw StateError(error); + } + } + + @override + bool smokeTest(Map context) { + _lua.getGlobal('smoke_test'); + if (!_lua.isFunction(-1)) { + _lua.pop(1); + return true; + } + + _pushValue(context); + final status = _lua.pCall(1, 1, 0); + if (status != ThreadStatus.luaOk) { + final error = _lua.toStr(-1) ?? 'unknown Lua smoke_test error'; + _lua.pop(1); + throw StateError(error); + } + final result = _lua.toBoolean(-1); + _lua.pop(1); + return result; + } + + @override + GameDiff init(Map context) { + return _callDiffFunction('init', context); + } + + @override + GameDiff dispatchEvent(RuntimeEvent event) { + return _callDiffFunction('on_event', event.toMap()); + } + + GameDiff _callDiffFunction(String name, Map argument) { + _lua.getGlobal(name); + if (!_lua.isFunction(-1)) { + _lua.pop(1); + return GameDiff.empty; + } + + _pushValue(argument); + final status = _lua.pCall(1, 1, 0); + if (status != ThreadStatus.luaOk) { + final error = _lua.toStr(-1) ?? 'unknown Lua runtime error'; + _lua.pop(1); + throw StateError(error); + } + + if (_lua.isNil(-1)) { + _lua.pop(1); + return GameDiff.empty; + } + if (!_lua.isTable(-1)) { + _lua.pop(1); + throw StateError('Lua function $name must return a table or nil'); + } + + final value = _readValue(-1); + _lua.pop(1); + + if (value is! Map) { + throw StateError('Lua function $name returned a non-map value'); + } + return GameDiff.fromMap(Map.from(value)); + } + + void _installRuntimeApi() { + _lua.newTable(); + + _lua.newTable(); + _lua.setField(-2, '__modules'); + + _lua.pushDartFunction(_importModule); + _lua.setField(-2, 'import'); + + _lua.setGlobal('runtime'); + } + + int _importModule(LuaState lua) { + final moduleName = lua.toStr(1); + if (moduleName == null || moduleName.isEmpty) { + throw const FormatException( + 'runtime.import(moduleName) requires a module name', + ); + } + if (!_isSafeModuleName(moduleName)) { + throw FormatException('Unsafe Lua module name: $moduleName'); + } + + final source = _moduleScripts[moduleName]; + if (source == null) { + throw FormatException( + 'Lua module is not declared in manifest.modules: $moduleName', + ); + } + + lua.getGlobal('runtime'); + lua.getField(-1, '__modules'); + final modulesIndex = lua.absIndex(-1); + + lua.getField(modulesIndex, moduleName); + if (!lua.isNil(-1)) { + lua.remove(-2); + lua.remove(-2); + return 1; + } + lua.pop(1); + + if (_loadingModules.contains(moduleName)) { + lua.pop(2); + throw FormatException('Circular Lua module import: $moduleName'); + } + + _loadingModules.add(moduleName); + try { + final loadStatus = lua.loadString(source); + if (loadStatus != ThreadStatus.luaOk) { + final error = lua.toStr(-1) ?? 'unknown Lua module load error'; + lua.pop(3); + throw StateError('Failed to load Lua module $moduleName: $error'); + } + + final callStatus = lua.pCall(0, 1, 0); + if (callStatus != ThreadStatus.luaOk) { + final error = lua.toStr(-1) ?? 'unknown Lua module runtime error'; + lua.pop(3); + throw StateError('Failed to run Lua module $moduleName: $error'); + } + + if (lua.isNil(-1)) { + lua.pop(1); + lua.pushBoolean(true); + } + if (!lua.isTable(-1) && !lua.isBoolean(-1)) { + lua.pop(3); + throw StateError( + 'Lua module $moduleName must return a table, true, or nil', + ); + } + + lua.pushValue(-1); + lua.setField(modulesIndex, moduleName); + lua.remove(-2); + lua.remove(-2); + return 1; + } finally { + _loadingModules.remove(moduleName); + } + } + + bool _isSafeModuleName(String value) { + return RegExp(r'^[A-Za-z0-9_.-]+$').hasMatch(value) && + !value.contains('..') && + !value.startsWith('.') && + !value.endsWith('.'); + } + + void _disableUnsafeGlobals() { + for (final name in const [ + 'os', + 'package', + 'dofile', + 'loadfile', + 'require', + ]) { + _lua.pushNil(); + _lua.setGlobal(name); + } + } + + void _pushValue(Object? value) { + switch (value) { + case null: + _lua.pushNil(); + case bool v: + _lua.pushBoolean(v); + case int v: + _lua.pushInteger(v); + case double v: + _lua.pushNumber(v); + case String v: + _lua.pushString(v); + case List v: + _pushList(v); + case Map v: + _pushMap(v); + default: + throw UnsupportedError('Unsupported value for Lua: $value'); + } + } + + void _pushList(List values) { + _lua.newTable(); + for (var i = 0; i < values.length; i++) { + _pushValue(values[i]); + _lua.setI(-2, i + 1); + } + } + + void _pushMap(Map values) { + _lua.newTable(); + for (final entry in values.entries) { + _pushValue(entry.value); + _lua.setField(-2, entry.key); + } + } + + Object? _readValue(int index) { + if (_lua.isNil(index) || _lua.isNone(index)) { + return null; + } + if (_lua.isBoolean(index)) { + return _lua.toBoolean(index); + } + if (_lua.isInteger(index)) { + return _lua.toInteger(index); + } + if (_lua.isNumber(index)) { + return _lua.toNumber(index); + } + if (_lua.isString(index)) { + return _lua.toStr(index); + } + if (_lua.isTable(index)) { + return _readTable(index); + } + throw UnsupportedError('Unsupported Lua type: ${_lua.typeName2(index)}'); + } + + Object _readTable(int index) { + final tableIndex = _lua.absIndex(index); + final length = _lua.rawLen(tableIndex); + final list = []; + var hasOnlyArrayKeys = length > 0; + final map = {}; + + _lua.pushNil(); + while (_lua.next(tableIndex)) { + final value = _readValue(-1); + final key = _readValue(-2); + _lua.pop(1); + + if (key is int && key >= 1 && key <= length) { + while (list.length < key) { + list.add(null); + } + list[key - 1] = value; + } else { + hasOnlyArrayKeys = false; + map[key.toString()] = value; + } + } + + if (hasOnlyArrayKeys && map.isEmpty) { + return list; + } + + for (var i = 0; i < list.length; i++) { + if (list[i] != null) { + map[(i + 1).toString()] = list[i]; + } + } + return map; + } +} diff --git a/lib/runtime/scripting/script_engine.dart b/lib/runtime/scripting/script_engine.dart new file mode 100644 index 0000000..2fba010 --- /dev/null +++ b/lib/runtime/scripting/script_engine.dart @@ -0,0 +1,13 @@ +import '../models/game_diff.dart'; +import '../models/runtime_event.dart'; +import '../packages/game_package.dart'; + +abstract interface class ScriptEngine { + Future loadPackage(GamePackage package); + + bool smokeTest(Map context); + + GameDiff init(Map context); + + GameDiff dispatchEvent(RuntimeEvent event); +} diff --git a/pubspec.yaml b/pubspec.yaml new file mode 100644 index 0000000..eb470c8 --- /dev/null +++ b/pubspec.yaml @@ -0,0 +1,29 @@ +name: flame_lua_runtime +description: Flutter + Flame + Lua runtime kit for manifest-driven 2D game packages. +version: 0.1.0 +publish_to: "none" + +environment: + sdk: ^3.9.2 + +dependencies: + flutter: + sdk: flutter + flame: ^1.35.1 + flame_spine: ^0.3.0+3 + lua_dardo_plus: ^0.3.0 + archive: ^4.0.9 + crypto: ^3.0.7 + http: ^1.6.0 + path_provider: ^2.1.5 + path: ^1.9.1 + audioplayers: ^6.7.1 + +dev_dependencies: + flutter_test: + sdk: flutter + flutter_lints: ^5.0.0 + +flutter: + assets: + - assets/runtime/lua/ diff --git a/test/public_api_test.dart b/test/public_api_test.dart new file mode 100644 index 0000000..7d94e54 --- /dev/null +++ b/test/public_api_test.dart @@ -0,0 +1,20 @@ +import 'package:flame_lua_runtime/flame_lua_runtime.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + test('public runtime API exposes minimal integration surface', () { + const repository = AssetGamePackageRepository(); + const options = RuntimeOptions(runtimeLuaRoot: 'custom/runtime/lua'); + const widget = LuaGameWidget( + gameId: 'template', + packageRepository: repository, + runtimeOptions: options, + ); + + expect(widget.gameId, 'template'); + expect(widget.packageRepository, same(repository)); + expect(widget.runtimeOptions.runtimeLuaRoot, 'custom/runtime/lua'); + expect(LuaDardoScriptEngine.new, isA()); + expect(RuntimeLocaleResolver.localeFromTag('zh-Hans').scriptCode, 'Hans'); + }); +} diff --git a/test/runtime/audio/runtime_audio_manager_test.dart b/test/runtime/audio/runtime_audio_manager_test.dart new file mode 100644 index 0000000..29e2ff0 --- /dev/null +++ b/test/runtime/audio/runtime_audio_manager_test.dart @@ -0,0 +1,484 @@ +import 'dart:async' as async; +import 'dart:io'; +import 'dart:typed_data'; + +import 'package:flame_lua_runtime/runtime/audio/runtime_audio_manager.dart'; +import 'package:flame_lua_runtime/runtime/audio/runtime_audio_player.dart'; +import 'package:flame_lua_runtime/runtime/diagnostics/runtime_diagnostics.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/resources/game_resource_manager.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeAudioManager', () { + test('preloads required audio and exposes ready state', () async { + final package = await _createPackage( + 'required_audio', + preload: GameResourcePreload.required, + ); + final audio = RuntimeAudioManager(); + + await audio.mount(package); + + expect(audio.audioState('dice'), GameResourceState.ready); + audio.dispose(); + }); + + test('lazy audio plays from package bytes', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final package = await _createPackage('lazy_audio'); + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(package); + + final playback = await audio.play('dice', volume: 0.5); + + expect(playback, isNotNull); + expect(audio.audioState('dice'), GameResourceState.ready); + expect(players.single.startedBytes, _audioBytes); + expect(players.single.volume, 0.5); + + players.single.complete(); + await playback!.done; + audio.dispose(); + }); + + test('lazy audio failure records state, error and diagnostics', () async { + final diagnostics = RuntimeDiagnostics(); + final package = await _createPackage('missing_audio', writeAudio: false); + final audio = RuntimeAudioManager(diagnostics: diagnostics); + + await audio.mount(package); + final playback = await audio.play('dice'); + + expect(playback, isNull); + expect(audio.audioState('dice'), GameResourceState.failed); + expect(audio.audioError('dice'), isNotNull); + expect( + diagnostics.entries.single.type, + RuntimeDiagnosticType.resourceLoadError, + ); + audio.dispose(); + }); + + test( + 'exports audio debug json, evicts and retries failed records', + () async { + final root = await Directory.systemTemp.createTemp('audio_retry_'); + Directory('${root.path}/assets').createSync(recursive: true); + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + final package = _createPackageAt( + root, + preload: GameResourcePreload.lazy, + ); + final audio = RuntimeAudioManager(); + + await audio.mount(package); + + expect(audio.audioDebugJson(), { + 'generation': 1, + 'hasPackage': true, + 'count': 1, + 'activeLoads': 0, + 'pendingLoads': 0, + 'activePlayers': 0, + 'pooledPlayers': 0, + 'channels': [], + 'resources': [ + { + 'key': 'dice', + 'path': endsWith('/assets/dice.wav'), + 'type': GameResourceType.audio, + 'declared': true, + 'preload': GameResourcePreload.lazy, + 'state': 'idle', + 'loading': false, + 'ready': false, + }, + ], + }); + + expect(await audio.retryAudio('dice'), isFalse); + expect(audio.audioState('dice'), GameResourceState.failed); + expect(audio.audioDebugJson().toString(), contains('error')); + + File('${root.path}/assets/dice.wav').writeAsBytesSync(_audioBytes); + expect(await audio.retryAudio('dice'), isTrue); + expect(audio.audioState('dice'), GameResourceState.ready); + + expect(audio.evictAudio('dice'), isTrue); + expect(audio.audioState('dice'), GameResourceState.idle); + expect(audio.evictAudio('dice'), isFalse); + audio.dispose(); + }, + ); + + test('preloads and evicts audio resource groups', () async { + final package = await _createMultiAudioPackage('audio_group'); + final audio = RuntimeAudioManager(); + + await audio.mount(package); + await audio.preloadGroup('scene'); + + expect(audio.audioState('dice'), GameResourceState.ready); + expect(audio.audioState('click'), GameResourceState.ready); + expect(audio.audioState('bgm'), GameResourceState.idle); + expect(audio.evictGroup('scene'), 2); + expect(audio.audioState('dice'), GameResourceState.idle); + expect(audio.audioState('click'), GameResourceState.idle); + audio.dispose(); + }); + + test('limits concurrent audio reads during group preload', () async { + final package = _CountingAudioPackage( + await _createMultiAudioPackage('audio_concurrency'), + ); + final audio = RuntimeAudioManager(maxConcurrentLoads: 1); + + await audio.mount(package); + await audio.preloadGroup('scene'); + + expect(package.maxActiveReads, 1); + expect(audio.audioState('dice'), GameResourceState.ready); + expect(audio.audioState('click'), GameResourceState.ready); + audio.dispose(); + }); + + test( + 'drops stale audio load result after dispose without diagnostics', + () async { + final diagnostics = RuntimeDiagnostics(); + final package = _BlockingAudioPackage( + await _createPackage('stale_audio'), + ); + final audio = RuntimeAudioManager(diagnostics: diagnostics); + + await audio.mount(package); + final playback = audio.play('dice'); + + audio.dispose(); + package.releaseReads(); + + expect(await playback, isNull); + expect(diagnostics.entries, isEmpty); + }, + ); + + test('audio LRU evicts least recently used bytes', () async { + final package = await _createMultiAudioPackage('audio_lru'); + final audio = RuntimeAudioManager(maxCacheEntries: 1); + + await audio.mount(package); + expect(await audio.retryAudio('dice'), isTrue); + expect(audio.audioState('dice'), GameResourceState.ready); + + expect(await audio.retryAudio('bgm'), isTrue); + + expect(audio.audioState('dice'), GameResourceState.idle); + expect(audio.audioState('bgm'), GameResourceState.ready); + audio.dispose(); + }); + + test('reuses pooled one-shot audio players', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final package = await _createPackage('sfx_pool'); + final audio = RuntimeAudioManager( + maxSfxPoolSize: 1, + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(package); + + final first = await audio.play('dice'); + players.single.complete(); + await first!.done; + expect(audio.audioDebugJson()['pooledPlayers'], 1); + + final second = await audio.play('dice'); + players.single.complete(); + await second!.done; + + expect(players, hasLength(1)); + expect(players.single.startCount, 2); + audio.dispose(); + }); + + test('plays, pauses, resumes and stops bgm channel', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final package = await _createPackage('bgm_audio'); + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(package); + + final playback = await audio.playBgm( + 'dice', + channel: 'music', + volume: 0.3, + loop: true, + ); + + expect(playback, isNotNull); + expect(audio.hasBgm(channel: 'music'), isTrue); + expect(players.single.startedBytes, _audioBytes); + expect(players.single.volume, 0.3); + expect(players.single.loop, isTrue); + + await audio.pauseBgm(channel: 'music'); + await audio.resumeBgm(channel: 'music'); + await audio.stopBgm(channel: 'music'); + + expect(players.single.paused, isTrue); + expect(players.single.resumed, isTrue); + expect(players.single.stopped, isTrue); + expect(audio.hasBgm(channel: 'music'), isFalse); + audio.dispose(); + }); + + test('starting same bgm channel replaces previous playback', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final package = await _createPackage('replace_bgm_audio'); + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(package); + + await audio.playBgm('dice', channel: 'music'); + await audio.playBgm('dice', channel: 'music'); + + expect(players, hasLength(2)); + expect(players.first.stopped, isTrue); + expect(audio.hasBgm(channel: 'music'), isTrue); + audio.dispose(); + }); + + test('required audio preload failure fails mount', () async { + final package = await _createPackage( + 'required_missing_audio', + preload: GameResourcePreload.required, + writeAudio: false, + ); + final audio = RuntimeAudioManager(); + + await expectLater( + audio.mount(package), + throwsA(isA()), + ); + expect(audio.audioState('dice'), GameResourceState.failed); + audio.dispose(); + }); + }); +} + +const _audioBytes = [1, 2, 3, 4, 5]; + +Future _createPackage( + String name, { + String preload = GameResourcePreload.lazy, + bool writeAudio = true, +}) async { + final root = await Directory.systemTemp.createTemp('audio_${name}_'); + Directory('${root.path}/assets').createSync(recursive: true); + if (writeAudio) { + File('${root.path}/assets/dice.wav').writeAsBytesSync(_audioBytes); + } + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return _createPackageAt(root, preload: preload); +} + +Future _createMultiAudioPackage(String name) async { + final root = await Directory.systemTemp.createTemp('audio_${name}_'); + Directory('${root.path}/assets').createSync(recursive: true); + File('${root.path}/assets/dice.wav').writeAsBytesSync(_audioBytes); + File('${root.path}/assets/click.wav').writeAsBytesSync([6, 7, 8]); + File('${root.path}/assets/bgm.wav').writeAsBytesSync([9, 10, 11, 12]); + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: const { + 'dice': GameResource( + type: GameResourceType.audio, + path: 'assets/dice.wav', + preload: GameResourcePreload.lazy, + group: 'scene', + ), + 'click': GameResource( + type: GameResourceType.audio, + path: 'assets/click.wav', + preload: GameResourcePreload.lazy, + group: 'scene', + ), + 'bgm': GameResource( + type: GameResourceType.audio, + path: 'assets/bgm.wav', + preload: GameResourcePreload.lazy, + group: 'music', + ), + }, + ), + ); +} + +GamePackage _createPackageAt( + Directory root, { + String preload = GameResourcePreload.lazy, +}) { + return GamePackage.file( + rootPath: root.path, + manifest: GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: { + 'dice': GameResource( + type: GameResourceType.audio, + path: 'assets/dice.wav', + preload: preload, + ), + }, + ), + ); +} + +class _CountingAudioPackage extends GamePackage { + _CountingAudioPackage(GamePackage package) + : super.file(rootPath: package.rootPath, manifest: package.manifest); + + var activeReads = 0; + var maxActiveReads = 0; + + @override + Future readBytes(String relativeOrAbsolutePath) async { + activeReads++; + if (activeReads > maxActiveReads) { + maxActiveReads = activeReads; + } + await Future.delayed(const Duration(milliseconds: 5)); + try { + return await super.readBytes(relativeOrAbsolutePath); + } finally { + activeReads--; + } + } +} + +class _BlockingAudioPackage extends GamePackage { + _BlockingAudioPackage(GamePackage package) + : _releaseReads = async.Completer(), + super.file(rootPath: package.rootPath, manifest: package.manifest); + + final async.Completer _releaseReads; + + void releaseReads() { + if (!_releaseReads.isCompleted) { + _releaseReads.complete(); + } + } + + @override + Future readBytes(String relativeOrAbsolutePath) async { + await _releaseReads.future; + return super.readBytes(relativeOrAbsolutePath); + } +} + +class _FakeRuntimeAudioPlayer implements RuntimeAudioPlayer { + async.Completer _done = async.Completer(); + List? startedBytes; + double? volume; + var loop = false; + var paused = false; + var resumed = false; + var stopped = false; + var disposed = false; + var startCount = 0; + + @override + Future get done => _done.future; + + @override + Future start( + Uint8List bytes, { + required double volume, + bool loop = false, + }) async { + if (_done.isCompleted) { + _done = async.Completer(); + } + startCount++; + startedBytes = bytes.toList(growable: false); + this.volume = volume; + this.loop = loop; + } + + void complete() { + if (!_done.isCompleted) { + _done.complete(); + } + } + + @override + Future pause() async { + paused = true; + } + + @override + Future resume() async { + resumed = true; + } + + @override + Future stop() async { + stopped = true; + complete(); + } + + @override + Future dispose() async { + disposed = true; + complete(); + } +} diff --git a/test/runtime/commands/command_executor_test.dart b/test/runtime/commands/command_executor_test.dart new file mode 100644 index 0000000..2b17029 --- /dev/null +++ b/test/runtime/commands/command_executor_test.dart @@ -0,0 +1,940 @@ +import 'dart:async' as async; +import 'dart:io'; + +import 'package:flame/components.dart'; +import 'package:flame/effects.dart'; +import 'package:flame_lua_runtime/runtime/audio/runtime_audio_manager.dart'; +import 'package:flame_lua_runtime/runtime/audio/runtime_audio_player.dart'; +import 'package:flame_lua_runtime/runtime/commands/command_executor.dart'; +import 'package:flame_lua_runtime/runtime/models/game_diff.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_command.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_node.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/protocol/runtime_protocol.dart'; +import 'package:flame_lua_runtime/runtime/rendering/render_tree_controller.dart'; +import 'package:flame_lua_runtime/runtime/resources/game_resource_manager.dart'; +import 'package:flutter/services.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + TestWidgetsFlutterBinding.ensureInitialized(); + + group('CommandExecutor', () { + test('adds move_path sequence effect to target component', () { + final harness = _CommandHarness(); + harness.createNode('piece'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.movePath, + target: 'piece', + payload: { + 'path': [ + {'x': 10, 'y': 20}, + {'x': 30, 'y': 40}, + ], + 'duration': 0.6, + 'onComplete': 'done', + }, + ), + ); + + final component = harness.controller.componentById('piece')!; + expect(component.children.whereType(), isNotEmpty); + }); + + test('adds generic transform effects to target component', () { + final harness = _CommandHarness(); + harness.createNode('node'); + + for (final command in const [ + RuntimeCommand( + type: RuntimeCommandType.moveTo, + target: 'node', + payload: {'x': 10, 'y': 20}, + ), + RuntimeCommand( + type: RuntimeCommandType.fadeTo, + target: 'node', + payload: {'alpha': 0.5}, + ), + RuntimeCommand( + type: RuntimeCommandType.scaleTo, + target: 'node', + payload: {'scale': 1.5}, + ), + RuntimeCommand( + type: RuntimeCommandType.rotateTo, + target: 'node', + payload: {'angle': 1.2}, + ), + ]) { + harness.executor.execute(command); + } + + final component = harness.controller.componentById('node')!; + expect(component.children.whereType(), hasLength(4)); + }); + + test( + 'remove_node removes target and emits completion event immediately', + () { + final harness = _CommandHarness(); + harness.createNode('node'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.removeNode, + target: 'node', + payload: {'onComplete': 'removed'}, + ), + ); + + expect(harness.controller.componentById('node'), isNull); + expect(harness.events.map((event) => event.toMap()), [ + { + 'type': RuntimeEventType.animationDone, + 'target': 'node', + 'handler': 'removed', + }, + ]); + }, + ); + + test('ignores transform commands for missing targets', () { + final harness = _CommandHarness(); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.moveTo, + target: 'missing', + payload: {'x': 1, 'y': 2}, + ), + ); + + expect(harness.events, isEmpty); + }); + + test('copy_text writes text to the platform clipboard', () async { + final harness = _CommandHarness(); + final calls = []; + TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger + .setMockMethodCallHandler(SystemChannels.platform, (call) async { + calls.add(call); + return null; + }); + addTearDown(() { + TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger + .setMockMethodCallHandler(SystemChannels.platform, null); + }); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.copyText, + payload: {'text': 'copy me'}, + ), + ); + await Future.delayed(Duration.zero); + + expect(calls.single.method, 'Clipboard.setData'); + expect(calls.single.arguments, {'text': 'copy me'}); + }); + + test('toast creates temporary overlay and emits completion', () async { + final harness = _CommandHarness(); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.toast, + payload: { + 'text': 'Hello toast', + 'duration': 0.01, + 'onComplete': 'toast_done', + }, + ), + ); + + expect(harness.controller.componentById('runtime_toast_1'), isNotNull); + final text = harness.controller.componentById('runtime_toast_1_text')!; + expect(text.node.text, 'Hello toast'); + expect(text.node.parent, 'runtime_toast_1'); + + await Future.delayed(const Duration(milliseconds: 30)); + + expect(harness.controller.componentById('runtime_toast_1'), isNull); + expect(harness.controller.componentById('runtime_toast_1_text'), isNull); + expect(harness.events.map((event) => event.toMap()), [ + {'type': RuntimeEventType.animationDone, 'handler': 'toast_done'}, + ]); + }); + + test('cancel_commands removes active toast overlay', () async { + final harness = _CommandHarness(); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.toast, + payload: {'text': 'Cancel me', 'duration': 10, 'id': 'toast_a'}, + ), + ); + expect(harness.controller.componentById('runtime_toast_1'), isNotNull); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.cancelCommands, + payload: {'id': 'toast_a'}, + ), + ); + await Future.delayed(Duration.zero); + + expect(harness.controller.componentById('runtime_toast_1'), isNull); + }); + + test('runs sequence commands in order', () async { + final harness = _CommandHarness(); + harness + ..createNode('first') + ..createNode('second'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.sequence, + payload: { + 'commands': [ + {'type': RuntimeCommandType.removeNode, 'target': 'first'}, + {'type': RuntimeCommandType.removeNode, 'target': 'second'}, + ], + 'onComplete': 'sequence_done', + }, + ), + ); + + expect(harness.controller.componentById('first'), isNull); + expect(harness.controller.componentById('second'), isNotNull); + + await Future.delayed(Duration.zero); + await Future.delayed(Duration.zero); + + expect(harness.controller.componentById('second'), isNull); + expect(harness.events.map((event) => event.toMap()), [ + {'type': RuntimeEventType.animationDone, 'handler': 'sequence_done'}, + ]); + }); + + test('runs parallel commands together', () async { + final harness = _CommandHarness(); + harness + ..createNode('first') + ..createNode('second'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.parallel, + payload: { + 'commands': [ + {'type': RuntimeCommandType.removeNode, 'target': 'first'}, + {'type': RuntimeCommandType.removeNode, 'target': 'second'}, + ], + 'onComplete': 'parallel_done', + }, + ), + ); + + expect(harness.controller.componentById('first'), isNull); + expect(harness.controller.componentById('second'), isNull); + + await Future.delayed(Duration.zero); + + expect(harness.events.map((event) => event.toMap()), [ + {'type': RuntimeEventType.animationDone, 'handler': 'parallel_done'}, + ]); + }); + + test('plays sound and emits completion after playback ends', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(await _createAudioPackage('play_sound')); + final harness = _CommandHarness(audio: audio); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playSound, + payload: {'asset': 'dice', 'volume': 0.4, 'onComplete': 'sound_done'}, + ), + ); + + await _waitFor(() => players.isNotEmpty); + expect(players.single.startedBytes, _audioBytes); + expect(players.single.volume, 0.4); + expect(harness.events, isEmpty); + + players.single.complete(); + await Future.delayed(Duration.zero); + + expect(harness.events.map((event) => event.toMap()), [ + {'type': RuntimeEventType.animationDone, 'handler': 'sound_done'}, + ]); + audio.dispose(); + }); + + test('cancels scoped sound when scope is removed', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(await _createAudioPackage('scoped_sound')); + final harness = _CommandHarness(audio: audio); + harness.createNode('panel'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playSound, + payload: { + 'asset': 'dice', + 'scope': 'panel', + 'onComplete': 'sound_done', + }, + ), + ); + await _waitFor(() => players.isNotEmpty); + + harness.controller.removeById('panel'); + await Future.delayed(Duration.zero); + + expect(players.single.disposed, isTrue); + expect(harness.events, isEmpty); + audio.dispose(); + }); + + test('starts bgm command and controls channel', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(await _createAudioPackage('bgm_command')); + final harness = _CommandHarness(audio: audio); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playBgm, + payload: { + 'asset': 'dice', + 'channel': 'music', + 'volume': 0.2, + 'loop': true, + 'onComplete': 'bgm_started', + }, + ), + ); + + await _waitFor(() => players.isNotEmpty); + await Future.delayed(Duration.zero); + + expect(players.single.startedBytes, _audioBytes); + expect(players.single.volume, 0.2); + expect(players.single.loop, isTrue); + expect(audio.hasBgm(channel: 'music'), isTrue); + expect(harness.events.map((event) => event.toMap()), [ + {'type': RuntimeEventType.animationDone, 'handler': 'bgm_started'}, + ]); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.pauseBgm, + payload: {'channel': 'music'}, + ), + ); + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.resumeBgm, + payload: {'channel': 'music'}, + ), + ); + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.stopBgm, + payload: {'channel': 'music'}, + ), + ); + await Future.delayed(Duration.zero); + + expect(players.single.paused, isTrue); + expect(players.single.resumed, isTrue); + expect(players.single.stopped, isTrue); + expect(audio.hasBgm(channel: 'music'), isFalse); + audio.dispose(); + }); + + test('stops scoped bgm when scope is removed after start', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(await _createAudioPackage('scoped_bgm_command')); + final harness = _CommandHarness(audio: audio); + harness.createNode('panel'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playBgm, + payload: {'asset': 'dice', 'channel': 'music', 'scope': 'panel'}, + ), + ); + await _waitFor(() => players.isNotEmpty); + + harness.controller.removeById('panel'); + await Future.delayed(Duration.zero); + + expect(players.single.stopped, isTrue); + expect(audio.hasBgm(channel: 'music'), isFalse); + audio.dispose(); + }); + + test('dispose stops owned bgm channels', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(await _createAudioPackage('dispose_bgm_command')); + final harness = _CommandHarness(audio: audio); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playBgm, + payload: {'asset': 'dice', 'channel': 'music'}, + ), + ); + await _waitFor(() => players.isNotEmpty); + + harness.executor.dispose(); + await Future.delayed(Duration.zero); + + expect(players.single.stopped, isTrue); + expect(audio.hasBgm(channel: 'music'), isFalse); + audio.dispose(); + }); + + test( + 'preloads and evicts resource groups with completion events', + () async { + final audio = RuntimeAudioManager(); + await audio.mount( + await _createGroupedAudioPackage('resource_commands'), + ); + final harness = _CommandHarness(audio: audio); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.preloadResources, + payload: {'group': 'scene', 'onComplete': 'resources_ready'}, + ), + ); + await _waitFor(() => harness.events.isNotEmpty); + + expect(audio.audioState('dice'), GameResourceState.ready); + expect(harness.events.single.handler, 'resources_ready'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.evictResources, + payload: {'group': 'scene', 'onComplete': 'resources_evicted'}, + ), + ); + await _waitFor(() => harness.events.length == 2); + + expect(audio.audioState('dice'), GameResourceState.idle); + expect(harness.events.last.handler, 'resources_evicted'); + audio.dispose(); + }, + ); + + test('runs delay completion asynchronously', () async { + final harness = _CommandHarness(); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.delay, + payload: {'duration': 0, 'onComplete': 'delay_done'}, + ), + ); + + expect(harness.events, isEmpty); + await Future.delayed(Duration.zero); + + expect(harness.events.map((event) => event.toMap()), [ + {'type': RuntimeEventType.animationDone, 'handler': 'delay_done'}, + ]); + }); + + test('drops delayed completion when scope node was removed', () async { + final harness = _CommandHarness(); + harness.createNode('panel'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.delay, + payload: {'duration': 0, 'onComplete': 'late_done', 'scope': 'panel'}, + ), + ); + harness.controller.removeById('panel'); + + await Future.delayed(Duration.zero); + + expect(harness.events, isEmpty); + }); + + test('scope removal cancels inherited pending sequence commands', () async { + final harness = _CommandHarness(); + harness + ..createNode('panel') + ..createNode('second'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.sequence, + payload: { + 'scope': 'panel', + 'commands': [ + {'type': RuntimeCommandType.delay, 'duration': 0.02}, + {'type': RuntimeCommandType.removeNode, 'target': 'second'}, + ], + 'onComplete': 'sequence_done', + }, + ), + ); + harness.controller.removeById('panel'); + + await Future.delayed(const Duration(milliseconds: 40)); + + expect(harness.controller.componentById('second'), isNotNull); + expect(harness.events, isEmpty); + }); + + test('dispose cancels pending delayed completion', () async { + final harness = _CommandHarness(); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.delay, + payload: {'duration': 0, 'onComplete': 'late_done'}, + ), + ); + harness.executor.dispose(); + + await Future.delayed(Duration.zero); + + expect(harness.events, isEmpty); + }); + + test('cancel_commands cancels pending command by id', () async { + final harness = _CommandHarness(); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.delay, + payload: { + 'id': 'intro_delay', + 'duration': 0.02, + 'onComplete': 'late_done', + }, + ), + ); + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.cancelCommands, + payload: {'id': 'intro_delay'}, + ), + ); + + await Future.delayed(const Duration(milliseconds: 40)); + + expect(harness.events, isEmpty); + }); + + test('cancel_commands cancels inherited command group', () async { + final harness = _CommandHarness(); + harness.createNode('node'); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.sequence, + payload: { + 'group': 'intro', + 'commands': [ + {'type': RuntimeCommandType.delay, 'duration': 0.02}, + {'type': RuntimeCommandType.removeNode, 'target': 'node'}, + ], + 'onComplete': 'sequence_done', + }, + ), + ); + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.cancelCommands, + payload: {'group': 'intro'}, + ), + ); + + await Future.delayed(const Duration(milliseconds: 40)); + + expect(harness.controller.componentById('node'), isNotNull); + expect(harness.events, isEmpty); + }); + + test('cancel_commands cancels scoped sound by command group', () async { + final players = <_FakeRuntimeAudioPlayer>[]; + final audio = RuntimeAudioManager( + playerFactory: () { + final player = _FakeRuntimeAudioPlayer(); + players.add(player); + return player; + }, + ); + await audio.mount(await _createAudioPackage('cancel_sound_group')); + final harness = _CommandHarness(audio: audio); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playSound, + payload: { + 'asset': 'dice', + 'group': 'sfx_intro', + 'onComplete': 'sound_done', + }, + ), + ); + await _waitFor(() => players.isNotEmpty); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.cancelCommands, + payload: {'group': 'sfx_intro'}, + ), + ); + await Future.delayed(Duration.zero); + + expect(players.single.disposed, isTrue); + expect(harness.events, isEmpty); + audio.dispose(); + }); + + test( + 'resource commands use commandGroup without confusing resource group', + () async { + final audio = RuntimeAudioManager(); + await audio.mount( + await _createGroupedAudioPackage('resource_group_safe'), + ); + final harness = _CommandHarness(audio: audio); + + harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.preloadResources, + payload: { + 'group': 'scene', + 'commandGroup': 'loading', + 'onComplete': 'resources_ready', + }, + ), + ); + await _waitFor(() => harness.events.isNotEmpty); + + expect(audio.audioState('dice'), GameResourceState.ready); + expect(harness.events.single.handler, 'resources_ready'); + audio.dispose(); + }, + ); + + test('validates composite commands before executing children', () { + final harness = _CommandHarness(); + harness + ..createNode('first') + ..createNode('second'); + + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.sequence, + payload: { + 'commands': [ + {'type': RuntimeCommandType.removeNode, 'target': 'first'}, + { + 'type': RuntimeCommandType.fadeTo, + 'target': 'second', + 'alpha': 2, + }, + ], + }, + ), + ), + throwsFormatException, + ); + + expect(harness.controller.componentById('first'), isNotNull); + expect(harness.controller.componentById('second'), isNotNull); + }); + + test('validates required command payloads', () { + final harness = _CommandHarness(); + harness.createNode('node'); + + expect( + () => harness.executor.execute( + const RuntimeCommand(type: RuntimeCommandType.moveTo, target: 'node'), + ), + throwsFormatException, + ); + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.fadeTo, + target: 'node', + payload: {'alpha': 2}, + ), + ), + throwsFormatException, + ); + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.scaleTo, + target: 'node', + payload: {'scale': 'big'}, + ), + ), + throwsFormatException, + ); + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.rotateTo, + target: 'node', + payload: {'angle': 0, 'duration': -1}, + ), + ), + throwsFormatException, + ); + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playSpineAnimation, + target: 'node', + ), + ), + throwsFormatException, + ); + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.playSpineAnimation, + target: 'node', + payload: {'animation': 'walk', 'track': -1}, + ), + ), + throwsFormatException, + ); + expect( + () => harness.executor.execute( + const RuntimeCommand( + type: RuntimeCommandType.moveTo, + target: 'node', + payload: {'x': 1, 'y': 2, 'duraton': 0.2}, + ), + ), + throwsFormatException, + ); + }); + }); +} + +Future _waitFor(bool Function() predicate) async { + for (var i = 0; i < 20; i++) { + if (predicate()) { + return; + } + await Future.delayed(Duration.zero); + } + throw StateError('Timed out waiting for test condition'); +} + +class _CommandHarness { + _CommandHarness({ + RuntimeAudioManager? audio, + GameResourceManager? resources, + }) { + final activeResources = resources ?? GameResourceManager(); + controller = RenderTreeController( + root: Component(), + resources: activeResources, + eventSink: events.add, + ); + executor = CommandExecutor( + renderTree: controller, + eventSink: events.add, + audio: audio, + resources: activeResources, + ); + controller.onScopeRemoved = executor.cancelScope; + } + + final events = []; + late final RenderTreeController controller; + late final CommandExecutor executor; + + void createNode(String id) { + controller.apply( + NodeDiff( + creates: [ + RuntimeNode( + id: id, + type: RuntimeNodeType.rect, + width: 100, + height: 100, + ), + ], + ), + ); + } +} + +const _audioBytes = [9, 8, 7, 6]; + +Future _createAudioPackage(String name) async { + final root = await Directory.systemTemp.createTemp('command_audio_${name}_'); + Directory('${root.path}/assets').createSync(recursive: true); + File('${root.path}/assets/dice.wav').writeAsBytesSync(_audioBytes); + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: const GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: { + 'dice': GameResource( + type: GameResourceType.audio, + path: 'assets/dice.wav', + preload: GameResourcePreload.lazy, + ), + }, + ), + ); +} + +Future _createGroupedAudioPackage(String name) async { + final root = await Directory.systemTemp.createTemp('command_audio_${name}_'); + Directory('${root.path}/assets').createSync(recursive: true); + File('${root.path}/assets/dice.wav').writeAsBytesSync(_audioBytes); + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: const GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: { + 'dice': GameResource( + type: GameResourceType.audio, + path: 'assets/dice.wav', + preload: GameResourcePreload.lazy, + group: 'scene', + ), + }, + ), + ); +} + +class _FakeRuntimeAudioPlayer implements RuntimeAudioPlayer { + final _done = async.Completer(); + List? startedBytes; + double? volume; + var loop = false; + var paused = false; + var resumed = false; + var stopped = false; + var disposed = false; + + @override + Future get done => _done.future; + + @override + Future start( + Uint8List bytes, { + required double volume, + bool loop = false, + }) async { + startedBytes = bytes.toList(growable: false); + this.volume = volume; + this.loop = loop; + } + + void complete() { + if (!_done.isCompleted) { + _done.complete(); + } + } + + @override + Future pause() async { + paused = true; + } + + @override + Future resume() async { + resumed = true; + } + + @override + Future stop() async { + stopped = true; + complete(); + } + + @override + Future dispose() async { + disposed = true; + complete(); + } +} diff --git a/test/runtime/commands/runtime_command_registry_test.dart b/test/runtime/commands/runtime_command_registry_test.dart new file mode 100644 index 0000000..50761be --- /dev/null +++ b/test/runtime/commands/runtime_command_registry_test.dart @@ -0,0 +1,65 @@ +import 'package:flame_lua_runtime/runtime/commands/runtime_command_registry.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeCommandRegistry', () { + test('cancels handles by id, group and scope', () { + final registry = RuntimeCommandRegistry(); + var idCancelled = false; + var groupCancelled = false; + var scopeCancelled = false; + + registry.create(id: 'intro').addCancelCallback(() { + idCancelled = true; + }); + registry.create(group: 'scene').addCancelCallback(() { + groupCancelled = true; + }); + registry.create(scope: 'panel').addCancelCallback(() { + scopeCancelled = true; + }); + + registry + ..cancelId('intro') + ..cancelGroup('scene') + ..cancelScope('panel'); + + expect(idCancelled, isTrue); + expect(groupCancelled, isTrue); + expect(scopeCancelled, isTrue); + expect(registry.activeHandleCount, 0); + }); + + test('completed handles ignore later cancellation', () { + final registry = RuntimeCommandRegistry(); + var cancelled = false; + final handle = registry.create(group: 'scene') + ..addCancelCallback(() { + cancelled = true; + }); + + handle.complete(); + registry.cancelGroup('scene'); + + expect(cancelled, isFalse); + expect(registry.activeHandleCount, 0); + }); + + test('dispose cancels all handles', () { + final registry = RuntimeCommandRegistry(); + var cancelCount = 0; + + registry.create(id: 'a').addCancelCallback(() { + cancelCount++; + }); + registry.create(group: 'b').addCancelCallback(() { + cancelCount++; + }); + + registry.dispose(); + + expect(cancelCount, 2); + expect(registry.activeHandleCount, 0); + }); + }); +} diff --git a/test/runtime/diagnostics/runtime_diagnostics_test.dart b/test/runtime/diagnostics/runtime_diagnostics_test.dart new file mode 100644 index 0000000..1baa620 --- /dev/null +++ b/test/runtime/diagnostics/runtime_diagnostics_test.dart @@ -0,0 +1,120 @@ +import 'package:flame_lua_runtime/runtime/diagnostics/runtime_diagnostics.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeDiagnostics', () { + test('keeps entries in insertion order', () { + final diagnostics = RuntimeDiagnostics(); + + diagnostics + ..record( + type: RuntimeDiagnosticType.packageActivationError, + message: 'activation failed', + ) + ..record( + type: RuntimeDiagnosticType.luaEventError, + message: 'event failed', + error: StateError('boom'), + context: {'eventType': 'tap'}, + ); + + expect(diagnostics.entries, hasLength(2)); + expect( + diagnostics.entries.first.type, + RuntimeDiagnosticType.packageActivationError, + ); + expect(diagnostics.entries.last.error, isA()); + expect(diagnostics.entries.last.context, {'eventType': 'tap'}); + }); + + test('exports debug json with sanitized context and errors', () { + final diagnostics = RuntimeDiagnostics(maxEntries: 3) + ..record( + type: RuntimeDiagnosticType.resourceLoadError, + message: 'audio failed', + error: StateError('missing'), + context: { + 'asset': 'bgm', + 'attempt': 2, + 'nested': {'z': 1, 'a': DateTime.utc(2026)}, + 'values': [StateError('bad'), true], + }, + ); + + final json = diagnostics.toDebugJson(); + + expect(json['maxEntries'], 3); + expect(json['count'], 1); + final entries = json['entries'] as List; + final entry = entries.single as Map; + expect(entry['type'], 'resourceLoadError'); + expect(entry['message'], 'audio failed'); + expect(entry['error'], contains('missing')); + expect(entry['timestamp'], isA()); + expect(entry['context'], { + 'asset': 'bgm', + 'attempt': 2, + 'nested': {'a': '2026-01-01T00:00:00.000Z', 'z': 1}, + 'values': ['Bad state: bad', true], + }); + }); + + test('dumps readable text for empty and populated diagnostics', () { + final diagnostics = RuntimeDiagnostics(maxEntries: 2); + + expect(diagnostics.dumpText(), 'RuntimeDiagnostics: no entries'); + + diagnostics.record( + type: RuntimeDiagnosticType.commandError, + message: 'command failed', + error: ArgumentError('bad command'), + context: {'command': 'play_bgm'}, + ); + + final dump = diagnostics.dumpText(); + + expect(dump, contains('RuntimeDiagnostics (1/2)')); + expect(dump, contains('commandError: command failed')); + expect(dump, contains('error: Invalid argument(s): bad command')); + expect(dump, contains('context: {"command":"play_bgm"}')); + }); + + test('entry debug helpers support direct use', () { + final entry = RuntimeDiagnosticEntry( + type: RuntimeDiagnosticType.luaEventError, + message: 'lua failed', + timestamp: DateTime.utc(2026, 6, 4, 12), + error: 'boom', + context: {'event': 'tap'}, + ); + + expect(entry.toDebugJson(), { + 'timestamp': '2026-06-04T12:00:00.000Z', + 'type': 'luaEventError', + 'message': 'lua failed', + 'error': 'boom', + 'context': {'event': 'tap'}, + }); + expect( + entry.dumpText(), + '[2026-06-04T12:00:00.000Z] luaEventError: lua failed\n' + ' error: boom\n' + ' context: {"event":"tap"}', + ); + }); + + test('evicts oldest entries when max size is reached', () { + final diagnostics = RuntimeDiagnostics(maxEntries: 2); + + diagnostics + ..record(type: RuntimeDiagnosticType.commandError, message: 'one') + ..record(type: RuntimeDiagnosticType.commandError, message: 'two') + ..record(type: RuntimeDiagnosticType.commandError, message: 'three'); + + expect(diagnostics.entries.map((entry) => entry.message), [ + 'two', + 'three', + ]); + }); + }); +} diff --git a/test/runtime/events/runtime_event_dispatcher_test.dart b/test/runtime/events/runtime_event_dispatcher_test.dart new file mode 100644 index 0000000..b523e02 --- /dev/null +++ b/test/runtime/events/runtime_event_dispatcher_test.dart @@ -0,0 +1,170 @@ +import 'package:flame_lua_runtime/runtime/diagnostics/runtime_diagnostics.dart'; +import 'package:flame_lua_runtime/runtime/events/runtime_event_dispatcher.dart'; +import 'package:flame_lua_runtime/runtime/lifecycle/runtime_session.dart'; +import 'package:flame_lua_runtime/runtime/models/game_diff.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/scripting/script_engine.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeEventDispatcher', () { + test('dispatches queued events serially', () async { + final session = _activeSession(); + final script = _FakeScriptEngine(); + final applied = []; + final dispatcher = RuntimeEventDispatcher( + session: session, + scriptEngine: script, + isScopeAlive: (_) => true, + applyDiff: applied.add, + ); + + dispatcher + ..enqueue(const RuntimeEvent(type: 'tap', target: 'a')) + ..enqueue(const RuntimeEvent(type: 'tap', target: 'b')); + + await Future.delayed(Duration.zero); + + expect(script.events.map((event) => event.target), ['a', 'b']); + expect(applied, hasLength(2)); + }); + + test('drops events for removed scope', () async { + final session = _activeSession(); + final script = _FakeScriptEngine(); + var alive = true; + final dispatcher = RuntimeEventDispatcher( + session: session, + scriptEngine: script, + isScopeAlive: (_) => alive, + applyDiff: (_) {}, + ); + + dispatcher.enqueue(const RuntimeEvent(type: 'tap', scope: 'dialog')); + alive = false; + + await Future.delayed(Duration.zero); + + expect(script.events, isEmpty); + }); + + test('drops events with stale target epoch', () async { + final session = _activeSession(); + final script = _FakeScriptEngine(); + var currentEpoch = 2; + final dispatcher = RuntimeEventDispatcher( + session: session, + scriptEngine: script, + isScopeAlive: (_) => true, + isNodeEpochAlive: (_, epoch) => epoch == currentEpoch, + applyDiff: (_) {}, + ); + + dispatcher.enqueue( + const RuntimeEvent(type: 'tap', target: 'button', targetEpoch: 1), + ); + currentEpoch = 3; + + await Future.delayed(Duration.zero); + + expect(script.events, isEmpty); + }); + + test('drops queued events after dispose', () async { + final session = _activeSession(); + final script = _FakeScriptEngine(); + final dispatcher = RuntimeEventDispatcher( + session: session, + scriptEngine: script, + isScopeAlive: (_) => true, + applyDiff: (_) {}, + ); + + dispatcher.enqueue(const RuntimeEvent(type: 'tap')); + dispatcher.dispose(); + + await Future.delayed(Duration.zero); + + expect(script.events, isEmpty); + }); + + test('drops queued events after session dispose', () async { + final session = _activeSession(); + final script = _FakeScriptEngine(); + final dispatcher = RuntimeEventDispatcher( + session: session, + scriptEngine: script, + isScopeAlive: (_) => true, + applyDiff: (_) {}, + ); + + dispatcher.enqueue(const RuntimeEvent(type: 'tap')); + session.dispose(); + + await Future.delayed(Duration.zero); + + expect(script.events, isEmpty); + }); + + test('continues draining after a script error', () async { + final session = _activeSession(); + final script = _FakeScriptEngine()..failNext = true; + final errors = []; + final diagnostics = RuntimeDiagnostics(); + final dispatcher = RuntimeEventDispatcher( + session: session, + scriptEngine: script, + isScopeAlive: (_) => true, + applyDiff: (_) {}, + diagnostics: diagnostics, + onError: errors.add, + ); + + dispatcher + ..enqueue(const RuntimeEvent(type: 'tap', target: 'bad')) + ..enqueue(const RuntimeEvent(type: 'tap', target: 'good')); + + await Future.delayed(Duration.zero); + + expect(errors, hasLength(1)); + expect(diagnostics.entries, hasLength(1)); + expect( + diagnostics.entries.single.type, + RuntimeDiagnosticType.luaEventError, + ); + expect(diagnostics.entries.single.context['target'], 'bad'); + expect(script.events.map((event) => event.target), ['bad', 'good']); + }); + }); +} + +RuntimeSession _activeSession() { + final session = RuntimeSession(gameId: 'test')..beginLoading(); + session.activate(); + return session; +} + +class _FakeScriptEngine implements ScriptEngine { + final events = []; + bool failNext = false; + + @override + Future loadPackage(GamePackage package) async {} + + @override + bool smokeTest(Map context) => true; + + @override + GameDiff init(Map context) => GameDiff.empty; + + @override + GameDiff dispatchEvent(RuntimeEvent event) { + events.add(event); + if (failNext) { + failNext = false; + throw StateError('boom'); + } + return GameDiff.empty; + } +} diff --git a/test/runtime/events/runtime_event_gate_test.dart b/test/runtime/events/runtime_event_gate_test.dart new file mode 100644 index 0000000..7f2f7f5 --- /dev/null +++ b/test/runtime/events/runtime_event_gate_test.dart @@ -0,0 +1,84 @@ +import 'package:flame_lua_runtime/runtime/events/runtime_event_gate.dart'; +import 'package:flame_lua_runtime/runtime/lifecycle/runtime_session.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeEventGate', () { + test('attaches session id without exposing lifecycle fields to Lua', () { + final session = RuntimeSession(gameId: 'game')..activate(); + final gate = RuntimeEventGate( + session: session, + isScopeAlive: (_) => true, + ); + + final event = gate.attachSession(const RuntimeEvent(type: 'tap')); + + expect(event.sessionId, session.id); + expect(event.toMap(), {'type': 'tap'}); + }); + + test('accepts only active matching sessions', () { + final session = RuntimeSession(gameId: 'game')..activate(); + final gate = RuntimeEventGate( + session: session, + isScopeAlive: (_) => true, + ); + + expect( + gate.accepts(RuntimeEvent(type: 'tap', sessionId: session.id)), + isTrue, + ); + expect( + gate.accepts(RuntimeEvent(type: 'tap', sessionId: session.id + 1)), + isFalse, + ); + + session.beginDisposing(); + expect( + gate.accepts(RuntimeEvent(type: 'tap', sessionId: session.id)), + isFalse, + ); + }); + + test('drops dead scopes and stale epochs', () { + final session = RuntimeSession(gameId: 'game')..activate(); + final gate = RuntimeEventGate( + session: session, + isScopeAlive: (scope) => scope == 'alive', + isNodeEpochAlive: (id, epoch) => epoch == 2, + ); + + expect( + gate.accepts( + RuntimeEvent( + type: 'tap', + sessionId: session.id, + scope: 'alive', + scopeEpoch: 2, + target: 'button', + targetEpoch: 2, + ), + ), + isTrue, + ); + expect( + gate.accepts( + RuntimeEvent(type: 'tap', sessionId: session.id, scope: 'dead'), + ), + isFalse, + ); + expect( + gate.accepts( + RuntimeEvent( + type: 'tap', + sessionId: session.id, + target: 'button', + targetEpoch: 1, + ), + ), + isFalse, + ); + }); + }); +} diff --git a/test/runtime/game/flame_lua_game_test.dart b/test/runtime/game/flame_lua_game_test.dart new file mode 100644 index 0000000..3370eee --- /dev/null +++ b/test/runtime/game/flame_lua_game_test.dart @@ -0,0 +1,72 @@ +import 'package:flame_lua_runtime/runtime/diagnostics/runtime_diagnostics.dart'; +import 'package:flame_lua_runtime/runtime/game/flame_lua_game.dart'; +import 'package:flame_lua_runtime/runtime/models/game_diff.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_repository.dart'; +import 'package:flame_lua_runtime/runtime/scripting/script_engine.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('FlameLuaGame diagnostics debug access', () { + test('exposes diagnostics entries, dump text and debug json', () { + final diagnostics = RuntimeDiagnostics() + ..record( + type: RuntimeDiagnosticType.commandError, + message: 'command failed', + context: {'command': 'play_bgm'}, + ); + final game = FlameLuaGame( + scriptEngine: _FakeScriptEngine(), + packageRepository: _FakePackageRepository(), + gameId: 'ludo', + diagnostics: diagnostics, + ); + + expect(game.diagnosticEntries, hasLength(1)); + expect(game.diagnosticsDumpText(), contains('command failed')); + expect(game.diagnosticsDebugJson()['count'], 1); + expect(game.resourcesDebugJson(), {'initialized': false}); + }); + }); +} + +class _FakeScriptEngine implements ScriptEngine { + @override + Future loadPackage(GamePackage package) { + throw UnimplementedError(); + } + + @override + GameDiff dispatchEvent(RuntimeEvent event) { + throw UnimplementedError(); + } + + @override + GameDiff init(Map context) { + throw UnimplementedError(); + } + + @override + bool smokeTest(Map context) { + throw UnimplementedError(); + } +} + +class _FakePackageRepository implements GamePackageRepository { + @override + Future load(String gameId) async { + return GamePackage.asset( + rootPath: 'example/assets/games/$gameId', + manifest: GamePackageManifest( + gameId: gameId, + name: gameId, + version: 'test', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + ), + ); + } +} diff --git a/test/runtime/game/runtime_locale_test.dart b/test/runtime/game/runtime_locale_test.dart new file mode 100644 index 0000000..cecad16 --- /dev/null +++ b/test/runtime/game/runtime_locale_test.dart @@ -0,0 +1,63 @@ +import 'dart:ui' show Locale; + +import 'package:flame_lua_runtime/runtime/game/runtime_locale.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeLocaleResolver', () { + test('normalizes locale tags', () { + expect(RuntimeLocaleResolver.normalizeTag('zh_hans_cn'), 'zh-Hans-CN'); + expect(RuntimeLocaleResolver.normalizeTag('EN-us'), 'en-US'); + expect(RuntimeLocaleResolver.tagOf(const Locale('zh', 'CN')), 'zh-CN'); + }); + + test('resolves exact, language and fallback locales', () { + expect( + RuntimeLocaleResolver.resolve( + requested: const Locale.fromSubtags( + languageCode: 'zh', + scriptCode: 'Hans', + ), + defaultLocale: 'en', + supportedLocales: const ['zh-Hans', 'en'], + ).resolved, + 'zh-Hans', + ); + + expect( + RuntimeLocaleResolver.resolve( + requested: const Locale('en', 'US'), + defaultLocale: 'zh-Hans', + supportedLocales: const ['zh-Hans', 'en'], + ).resolved, + 'en', + ); + + expect( + RuntimeLocaleResolver.resolve( + requested: const Locale('fr', 'FR'), + defaultLocale: 'zh-Hans', + supportedLocales: const ['zh-Hans', 'en'], + ).resolved, + 'zh-Hans', + ); + }); + + test('exports locale context for Lua', () { + final info = RuntimeLocaleResolver.resolve( + requested: const Locale('en', 'US'), + defaultLocale: 'zh-Hans', + supportedLocales: const ['zh-Hans', 'en'], + ); + + expect(info.toMap(), { + 'requested': 'en-US', + 'resolved': 'en', + 'default': 'zh-Hans', + 'supported': ['zh-Hans', 'en'], + 'languageCode': 'en', + 'countryCode': 'US', + }); + }); + }); +} diff --git a/test/runtime/lifecycle/runtime_async_gate_test.dart b/test/runtime/lifecycle/runtime_async_gate_test.dart new file mode 100644 index 0000000..4911b48 --- /dev/null +++ b/test/runtime/lifecycle/runtime_async_gate_test.dart @@ -0,0 +1,36 @@ +import 'package:flame_lua_runtime/runtime/lifecycle/runtime_async_gate.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeAsyncGate', () { + test('accepts only current open generation tokens', () { + final gate = RuntimeAsyncGate(); + final first = gate.activate(); + + expect(gate.accepts(first), isTrue); + expect(first.isAccepted, isTrue); + + final second = gate.advance(); + + expect(gate.accepts(first), isFalse); + expect(gate.accepts(second), isTrue); + }); + + test('close rejects existing and future checks until activated again', () { + final gate = RuntimeAsyncGate(); + final first = gate.activate(); + + gate.close(); + + expect(gate.isClosed, isTrue); + expect(gate.accepts(first), isFalse); + expect(gate.acceptsGeneration(gate.generation), isFalse); + + final second = gate.activate(); + + expect(gate.isOpen, isTrue); + expect(gate.accepts(second), isTrue); + expect(gate.accepts(first), isFalse); + }); + }); +} diff --git a/test/runtime/lifecycle/runtime_serial_queue_test.dart b/test/runtime/lifecycle/runtime_serial_queue_test.dart new file mode 100644 index 0000000..b3a6a6f --- /dev/null +++ b/test/runtime/lifecycle/runtime_serial_queue_test.dart @@ -0,0 +1,59 @@ +import 'package:flame_lua_runtime/runtime/lifecycle/runtime_serial_queue.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeSerialQueue', () { + test('drains queued items in order on a microtask', () async { + final handled = []; + final queue = RuntimeSerialQueue(onItem: handled.add); + + queue + ..enqueue(1) + ..enqueue(2) + ..enqueue(3); + + expect(handled, isEmpty); + expect(queue.pendingCount, 3); + + await Future.delayed(Duration.zero); + + expect(handled, [1, 2, 3]); + expect(queue.pendingCount, 0); + }); + + test('stops draining when shouldContinue turns false', () async { + final handled = []; + var active = true; + late final RuntimeSerialQueue queue; + queue = RuntimeSerialQueue( + shouldContinue: () => active, + onItem: (item) { + handled.add(item); + active = false; + }, + ); + + queue + ..enqueue(1) + ..enqueue(2); + + await Future.delayed(Duration.zero); + + expect(handled, [1]); + expect(queue.pendingCount, 1); + }); + + test('dispose drops pending items', () async { + final handled = []; + final queue = RuntimeSerialQueue(onItem: handled.add); + + queue.enqueue(1); + queue.dispose(); + + await Future.delayed(Duration.zero); + + expect(handled, isEmpty); + expect(queue.pendingCount, 0); + }); + }); +} diff --git a/test/runtime/lifecycle/runtime_session_test.dart b/test/runtime/lifecycle/runtime_session_test.dart new file mode 100644 index 0000000..0db5a27 --- /dev/null +++ b/test/runtime/lifecycle/runtime_session_test.dart @@ -0,0 +1,38 @@ +import 'package:flame_lua_runtime/runtime/lifecycle/runtime_session.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeSession', () { + test('moves through loading, active, disposing and disposed states', () { + final session = RuntimeSession(gameId: 'game'); + + expect(session.state, RuntimeSessionState.created); + expect(session.acceptsWork, isTrue); + expect(session.isActive, isFalse); + + session.beginLoading(); + expect(session.state, RuntimeSessionState.loading); + expect(session.acceptsWorkFor(session.id), isTrue); + expect(session.accepts(session.id), isFalse); + + session.activate(); + expect(session.state, RuntimeSessionState.active); + expect(session.accepts(session.id), isTrue); + + session.beginDisposing(); + expect(session.state, RuntimeSessionState.disposing); + expect(session.acceptsWork, isFalse); + expect(session.accepts(session.id), isFalse); + + session.dispose(); + expect(session.state, RuntimeSessionState.disposed); + expect(session.acceptsWork, isFalse); + }); + + test('rejects invalid transitions', () { + final session = RuntimeSession(gameId: 'game')..activate(); + + expect(session.beginLoading, throwsA(isA())); + }); + }); +} diff --git a/test/runtime/lifecycle/runtime_task_registry_test.dart b/test/runtime/lifecycle/runtime_task_registry_test.dart new file mode 100644 index 0000000..bb0cdb3 --- /dev/null +++ b/test/runtime/lifecycle/runtime_task_registry_test.dart @@ -0,0 +1,61 @@ +import 'dart:async' as async; + +import 'package:flame_lua_runtime/runtime/lifecycle/runtime_task_registry.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeTaskRegistry', () { + test('cancels tasks by scope', () async { + final registry = RuntimeTaskRegistry(cancelledValue: 'cancelled'); + final scoped = registry.create(scope: 'panel'); + final other = registry.create(scope: 'other'); + + registry.cancelScope('panel'); + + expect(await scoped.future, 'cancelled'); + expect(scoped.isCancelled, isTrue); + expect(other.isCancelled, isFalse); + expect(registry.scopedTaskCount('panel'), 0); + expect(registry.scopedTaskCount('other'), 1); + + other.complete('done'); + expect(await other.future, 'done'); + expect(registry.activeTaskCount, 0); + }); + + test('cancel runs callbacks and cancels timers', () async { + final registry = RuntimeTaskRegistry(cancelledValue: 'cancelled'); + final task = registry.create(scope: 'panel'); + var callbackCalled = false; + var timerFired = false; + final timer = async.Timer(const Duration(milliseconds: 30), () { + timerFired = true; + }); + + task + ..addTimer(timer) + ..addCancelCallback(() { + callbackCalled = true; + }) + ..cancel(); + + await Future.delayed(const Duration(milliseconds: 40)); + + expect(await task.future, 'cancelled'); + expect(callbackCalled, isTrue); + expect(timerFired, isFalse); + }); + + test('dispose cancels all active tasks', () async { + final registry = RuntimeTaskRegistry(cancelledValue: 'cancelled'); + final first = registry.create(); + final second = registry.create(scope: 'panel'); + + registry.dispose(); + + expect(await first.future, 'cancelled'); + expect(await second.future, 'cancelled'); + expect(registry.activeTaskCount, 0); + }); + }); +} diff --git a/test/runtime/models/game_diff_test.dart b/test/runtime/models/game_diff_test.dart new file mode 100644 index 0000000..9571a58 --- /dev/null +++ b/test/runtime/models/game_diff_test.dart @@ -0,0 +1,121 @@ +import 'package:flame_lua_runtime/runtime/models/game_diff.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('GameDiff', () { + test('parses render, ui and commands', () { + final diff = GameDiff.fromMap({ + 'render': { + 'creates': [ + {'id': 'board', 'type': 'image', 'asset': 'board'}, + ], + 'updates': [ + { + 'id': 'piece_red_1', + 'props': {'x': 100, 'y': 120}, + }, + ], + 'removes': ['old_piece'], + }, + 'ui': { + 'creates': [ + {'id': 'dice_button', 'type': 'button', 'text': 'Roll'}, + ], + }, + 'commands': [ + {'type': 'move_path', 'target': 'piece_red_1', 'duration': 0.5}, + ], + }); + + expect(diff.render.creates.single.id, 'board'); + expect(diff.render.updates.single.id, 'piece_red_1'); + expect(diff.render.updates.single.props['x'], 100); + expect(diff.render.removes.single.id, 'old_piece'); + expect(diff.ui.creates.single.id, 'dice_button'); + expect(diff.commands.single.type, 'move_path'); + expect(diff.commands.single.target, 'piece_red_1'); + expect(diff.commands.single.payload['duration'], 0.5); + }); + + test('treats missing sections as empty diffs', () { + final diff = GameDiff.fromMap({}); + + expect(diff.render.creates, isEmpty); + expect(diff.render.updates, isEmpty); + expect(diff.render.removes, isEmpty); + expect(diff.ui.creates, isEmpty); + expect(diff.commands, isEmpty); + }); + + test('accepts Lua numeric-key tables as lists', () { + final diff = GameDiff.fromMap({ + 'render': { + 'creates': { + 2: {'id': 'b', 'type': 'text'}, + 1: {'id': 'a', 'type': 'text'}, + }, + 'updates': {}, + 'removes': { + 1: {'id': 'old_a'}, + 2: 'old_b', + }, + }, + 'commands': { + 1: {'type': 'toast', 'message': 'hi'}, + }, + }); + + expect(diff.render.creates.map((node) => node.id), ['a', 'b']); + expect(diff.render.removes.map((node) => node.id), ['old_a', 'old_b']); + expect(diff.commands.single.type, 'toast'); + expect(diff.commands.single.payload['message'], 'hi'); + }); + + test('rejects malformed diff fields', () { + expect( + () => GameDiff.fromMap({ + 'render': {'creates': 'bad'}, + }), + throwsFormatException, + ); + expect( + () => GameDiff.fromMap({ + 'render': { + 'updates': [ + {'id': 'node', 'props': 'bad'}, + ], + }, + }), + throwsFormatException, + ); + expect( + () => GameDiff.fromMap({ + 'commands': [ + {'type': ''}, + ], + }), + throwsFormatException, + ); + expect(() => GameDiff.fromMap({'unknown': {}}), throwsFormatException); + expect( + () => GameDiff.fromMap({ + 'render': {'createz': []}, + }), + throwsFormatException, + ); + expect( + () => GameDiff.fromMap({ + 'render': { + 'updates': [ + { + 'id': 'node', + 'props': {'interative': true}, + }, + ], + }, + }), + throwsFormatException, + ); + }); + }); +} diff --git a/test/runtime/models/runtime_event_command_test.dart b/test/runtime/models/runtime_event_command_test.dart new file mode 100644 index 0000000..98392a4 --- /dev/null +++ b/test/runtime/models/runtime_event_command_test.dart @@ -0,0 +1,77 @@ +import 'package:flame_lua_runtime/runtime/models/runtime_command.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeEvent', () { + test('serializes only present fields', () { + final event = RuntimeEvent( + type: 'tap', + target: 'dice_button', + handler: 'roll_dice', + x: 10, + y: 20, + data: {'pointer': 1}, + ); + + expect(event.toMap(), { + 'type': 'tap', + 'target': 'dice_button', + 'handler': 'roll_dice', + 'x': 10, + 'y': 20, + 'data': {'pointer': 1}, + }); + }); + + test('omits null and empty optional fields', () { + expect(const RuntimeEvent(type: 'animation_done').toMap(), { + 'type': 'animation_done', + }); + }); + }); + + group('RuntimeCommand', () { + test('parses command payload without type and target', () { + final command = RuntimeCommand.fromMap({ + 'type': 'move_path', + 'target': 'piece_red_1', + 'duration': 0.5, + 'onComplete': 'done', + }); + + expect(command.type, 'move_path'); + expect(command.target, 'piece_red_1'); + expect(command.payload, {'duration': 0.5, 'onComplete': 'done'}); + }); + + test('rejects invalid command shape', () { + expect(() => RuntimeCommand.fromMap({'type': ''}), throwsFormatException); + expect( + () => RuntimeCommand.fromMap({'type': 'toast', 'target': 1}), + throwsFormatException, + ); + expect( + () => RuntimeCommand.fromMap({'type': 'unknown'}), + throwsFormatException, + ); + expect( + () => RuntimeCommand.fromMap({ + 'type': 'move_to', + 'target': 'piece', + 'x': 1, + 'y': 2, + 'duraton': 0.5, + }), + throwsFormatException, + ); + expect( + () => RuntimeCommand.fromMap({ + 'type': 'preload_resources', + 'groups': 'pieces', + }), + throwsFormatException, + ); + }); + }); +} diff --git a/test/runtime/models/runtime_node_test.dart b/test/runtime/models/runtime_node_test.dart new file mode 100644 index 0000000..ee1492f --- /dev/null +++ b/test/runtime/models/runtime_node_test.dart @@ -0,0 +1,324 @@ +import 'package:flame_lua_runtime/runtime/models/runtime_node.dart'; +import 'package:flutter/material.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeNode', () { + test('parses required and optional fields', () { + final node = RuntimeNode.fromMap({ + 'id': 'dice_button', + 'type': 'button', + 'parent': 'top_bar', + 'asset': 'dice_normal', + 'pressedAsset': 'dice_pressed', + 'disabledAsset': 'dice_disabled', + 'animation': 'idle', + 'skin': 'red', + 'loop': false, + 'text': 'Roll', + 'x': 10, + 'y': 20.5, + 'width': 120, + 'height': 48, + 'paddingLeft': 4, + 'paddingTop': 5, + 'paddingRight': 6, + 'paddingBottom': 7, + 'anchor': 'center', + 'layer': 3, + 'visible': false, + 'alpha': 0.7, + 'scale': 1.2, + 'rotation': 0.4, + 'color': '#112233', + 'fontSize': 18, + 'textAlign': 'left', + 'radius': 10, + 'strokeWidth': 3, + 'value': 0.6, + 'scrollX': 15, + 'scrollY': 20, + 'contentWidth': 220, + 'contentHeight': 180, + 'virtualized': true, + 'cacheExtent': 12, + 'inertia': false, + 'scrollbarThumbColor': '#abcdef', + 'scrollbarTrackColor': '#123456', + 'scrollbarThickness': 6, + 'scrollbarVisible': false, + 'interactive': true, + 'onTap': 'roll_dice', + 'onScroll': 'list_scrolled', + 'preset': 'burst', + 'count': 32, + 'duration': 0.6, + 'speedMin': 60, + 'speedMax': 180, + 'gravityX': 0, + 'gravityY': 120, + 'spread': 360, + 'colorTo': '#00ffcc33', + 'radiusTo': 0, + 'autoRemove': false, + 'fadeOut': false, + }); + + expect(node.id, 'dice_button'); + expect(node.type, 'button'); + expect(node.parent, 'top_bar'); + expect(node.asset, 'dice_normal'); + expect(node.pressedAsset, 'dice_pressed'); + expect(node.disabledAsset, 'dice_disabled'); + expect(node.animation, 'idle'); + expect(node.skin, 'red'); + expect(node.loop, isFalse); + expect(node.text, 'Roll'); + expect(node.x, 10); + expect(node.y, 20.5); + expect(node.width, 120); + expect(node.height, 48); + expect(node.paddingLeft, 4); + expect(node.paddingTop, 5); + expect(node.paddingRight, 6); + expect(node.paddingBottom, 7); + expect(node.anchor, 'center'); + expect(node.layer, 3); + expect(node.visible, isFalse); + expect(node.alpha, 0.7); + expect(node.scale, 1.2); + expect(node.rotation, 0.4); + expect(node.color, const Color(0xff112233)); + expect(node.fontSize, 18); + expect(node.textAlign, 'left'); + expect(node.radius, 10); + expect(node.strokeWidth, 3); + expect(node.value, 0.6); + expect(node.scrollX, 15); + expect(node.scrollY, 20); + expect(node.contentWidth, 220); + expect(node.contentHeight, 180); + expect(node.virtualized, isTrue); + expect(node.cacheExtent, 12); + expect(node.inertia, isFalse); + expect(node.scrollbarThumbColor, const Color(0xffabcdef)); + expect(node.scrollbarTrackColor, const Color(0xff123456)); + expect(node.scrollbarThickness, 6); + expect(node.scrollbarVisible, isFalse); + expect(node.interactive, isTrue); + expect(node.onTap, 'roll_dice'); + expect(node.onScroll, 'list_scrolled'); + expect(node.preset, 'burst'); + expect(node.count, 32); + expect(node.duration, 0.6); + expect(node.speedMin, 60); + expect(node.speedMax, 180); + expect(node.gravityX, 0); + expect(node.gravityY, 120); + expect(node.spread, 360); + expect(node.colorTo, const Color(0x00ffcc33)); + expect(node.radiusTo, 0); + expect(node.autoRemove, isFalse); + expect(node.fadeOut, isFalse); + }); + + test('applies default values', () { + final node = RuntimeNode.fromMap({'id': 'label', 'type': 'text'}); + + expect(node.x, 0); + expect(node.y, 0); + expect(node.anchor, 'topLeft'); + expect(node.layer, 0); + expect(node.visible, isTrue); + expect(node.alpha, 1); + expect(node.scale, 1); + expect(node.rotation, 0); + expect(node.loop, isTrue); + expect(node.textAlign, 'center'); + expect(node.scrollbarVisible, isTrue); + expect(node.paddingLeft, 0); + expect(node.paddingTop, 0); + expect(node.paddingRight, 0); + expect(node.paddingBottom, 0); + expect(node.autoRemove, isTrue); + expect(node.fadeOut, isTrue); + expect(node.interactive, isFalse); + }); + + test('copies only provided props', () { + final node = RuntimeNode.fromMap({ + 'id': 'piece', + 'type': 'circle', + 'x': 1, + 'y': 2, + 'color': '#ff0000', + }); + + final updated = node.copyWithProps({ + 'x': 20, + 'parent': 'board', + 'visible': false, + 'color': '#8000ff00', + 'radius': 8, + 'strokeWidth': 2, + 'value': 0.75, + 'width': 70, + 'height': 60, + 'paddingLeft': 8, + 'paddingTop': 9, + 'paddingRight': 10, + 'paddingBottom': 11, + 'contentWidth': 120, + 'contentHeight': 100, + 'pressedAsset': 'button_pressed', + 'disabledAsset': 'button_disabled', + 'scrollX': 90, + 'scrollY': 80, + 'textAlign': 'right', + 'preset': 'trail', + 'count': 12, + }); + + expect(updated.id, 'piece'); + expect(updated.type, 'circle'); + expect(updated.parent, 'board'); + expect(updated.x, 20); + expect(updated.y, 2); + expect(updated.visible, isFalse); + expect(updated.color, const Color(0x8000ff00)); + expect(updated.radius, 8); + expect(updated.strokeWidth, 2); + expect(updated.value, 0.75); + expect(updated.width, 70); + expect(updated.height, 60); + expect(updated.paddingLeft, 8); + expect(updated.paddingTop, 9); + expect(updated.paddingRight, 10); + expect(updated.paddingBottom, 11); + expect(updated.contentWidth, 120); + expect(updated.contentHeight, 100); + expect(updated.pressedAsset, 'button_pressed'); + expect(updated.disabledAsset, 'button_disabled'); + expect(updated.scrollX, 68); + expect(updated.scrollY, 60); + expect(updated.textAlign, 'right'); + expect(updated.preset, 'trail'); + expect(updated.count, 12); + }); + + test('rejects invalid values', () { + expect( + () => RuntimeNode.fromMap({'id': '', 'type': 'text'}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'text', 'x': 'bad'}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'text', 'color': 'red'}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'unknown'}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'text', + 'anchor': 'middle', + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'progress', 'value': 2}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'text', + 'textAlign': 'justify', + }), + throwsFormatException, + ); + expect( + () => + RuntimeNode.fromMap({'id': 'a', 'type': 'listView', 'scrollY': -1}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'particle', + 'preset': 'unknown', + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'particle', 'count': 0}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'listView', + 'paddingTop': -1, + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'listView', + 'cacheExtent': -1, + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'rect', + 'interactive': 'yes', + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'button', + 'pressedAsset': 1, + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'rect', 'parent': 1}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'spine', 'loop': 'yes'}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({'id': 'a', 'type': 'rect', 'parent': 'a'}), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'rect', + 'interative': true, + }), + throwsFormatException, + ); + expect( + () => RuntimeNode.fromMap({ + 'id': 'a', + 'type': 'rect', + }).copyWithProps({'screenWitdh': 720}), + throwsFormatException, + ); + }); + }); +} diff --git a/test/runtime/packages/game_package_activation_controller_test.dart b/test/runtime/packages/game_package_activation_controller_test.dart new file mode 100644 index 0000000..d9524a7 --- /dev/null +++ b/test/runtime/packages/game_package_activation_controller_test.dart @@ -0,0 +1,395 @@ +import 'dart:io'; + +import 'package:flame_lua_runtime/runtime/audio/runtime_audio_manager.dart'; +import 'package:flame_lua_runtime/runtime/models/game_diff.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_activation_controller.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_repository.dart'; +import 'package:flame_lua_runtime/runtime/packages/stable_package_store.dart'; +import 'package:flame_lua_runtime/runtime/resources/game_resource_manager.dart'; +import 'package:flame_lua_runtime/runtime/scripting/script_engine.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('PackageActivationController', () { + test( + 'activates repository candidate and marks stable after init', + () async { + final candidate = await _createPackage('candidate'); + final store = _FakeStablePackageStore(); + final scriptEngine = _FakeScriptEngine(); + + final result = await PackageActivationController( + repository: _FakeRepository(candidate), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + store: store, + assetFallback: _FakeRepository(await _createPackage('asset')), + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(result.package.rootPath, candidate.rootPath); + expect(scriptEngine.loadedPackages, [candidate.rootPath]); + expect(scriptEngine.initPackages, [candidate.rootPath]); + expect(store.markedPackages, [candidate.rootPath]); + }, + ); + + test('falls back to stable when repository candidate is invalid', () async { + final invalidCandidate = await _createPackage('invalid', script: 'bad'); + final stable = await _createPackage('stable'); + final store = _FakeStablePackageStore(stable: stable); + final scriptEngine = _FakeScriptEngine(); + + final result = await PackageActivationController( + repository: _FakeRepository(invalidCandidate), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + store: store, + assetFallback: _FakeRepository(await _createPackage('asset')), + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(result.package.rootPath, stable.rootPath); + expect(scriptEngine.loadedPackages, [stable.rootPath]); + expect(store.markedPackages, [stable.rootPath]); + }); + + test( + 'falls back to previous stable when current stable is invalid', + () async { + final invalidCandidate = await _createPackage( + 'invalid_candidate', + script: 'bad', + ); + final invalidStable = await _createPackage( + 'invalid_stable', + script: 'bad', + ); + final previous = await _createPackage('previous'); + final store = _FakeStablePackageStore( + stable: invalidStable, + previous: previous, + ); + final scriptEngine = _FakeScriptEngine(); + + final result = await PackageActivationController( + repository: _FakeRepository(invalidCandidate), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + store: store, + assetFallback: _FakeRepository(await _createPackage('asset')), + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(result.package.rootPath, previous.rootPath); + expect(scriptEngine.loadedPackages, [previous.rootPath]); + expect(store.markedPackages, [previous.rootPath]); + }, + ); + + test('falls back to asset when repository load fails', () async { + final failedCandidate = await _createPackage('failed_candidate'); + final fallback = await _createPackage('asset'); + final store = _FakeStablePackageStore(); + final scriptEngine = _FakeScriptEngine(); + + final result = await PackageActivationController( + repository: _FakeRepository( + failedCandidate, + error: StateError('network failed'), + ), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + store: store, + assetFallback: _FakeRepository(fallback), + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(result.package.rootPath, fallback.rootPath); + expect(scriptEngine.loadedPackages, [fallback.rootPath]); + expect(store.markedPackages, [fallback.rootPath]); + }); + + test('stops activation when cancellation guard turns false', () async { + final candidate = await _createPackage('candidate'); + final fallback = await _createPackage('asset'); + final store = _FakeStablePackageStore(); + final scriptEngine = _FakeScriptEngine(); + var active = false; + + await expectLater( + PackageActivationController( + repository: _FakeRepository(candidate), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + store: store, + assetFallback: _FakeRepository(fallback), + ).activate( + gameId: 'ludo', + contextBuilder: _context, + shouldContinue: () => active, + ), + throwsStateError, + ); + + expect(scriptEngine.loadedPackages, isEmpty); + expect(store.markedPackages, isEmpty); + }); + + test('uses staging resources and script engine before commit', () async { + final candidate = await _createPackage('candidate'); + final activeResources = _RecordingResourceManager(); + final activeScriptEngine = _FakeScriptEngine(); + final stagingResources = <_RecordingResourceManager>[]; + final stagingEngines = <_FakeScriptEngine>[]; + + final result = await PackageActivationController( + repository: _FakeRepository(candidate), + resources: activeResources, + scriptEngine: activeScriptEngine, + store: _FakeStablePackageStore(), + assetFallback: _FakeRepository(await _createPackage('asset')), + resourceManagerFactory: () { + final resources = _RecordingResourceManager(); + stagingResources.add(resources); + return resources; + }, + scriptEngineFactory: () { + final engine = _FakeScriptEngine(); + stagingEngines.add(engine); + return engine; + }, + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(activeResources.mountedPackages, isEmpty); + expect(activeScriptEngine.loadedPackages, isEmpty); + expect(result.resources, same(stagingResources.single)); + expect(result.scriptEngine, same(stagingEngines.single)); + expect(stagingResources.single.mountedPackages, [candidate.rootPath]); + expect(stagingEngines.single.loadedPackages, [candidate.rootPath]); + }); + + test('falls back when required audio preload fails', () async { + final candidate = await _createAudioPackage( + 'candidate_bad_audio', + writeAudio: false, + ); + final fallback = await _createAudioPackage('asset_audio'); + final store = _FakeStablePackageStore(); + final scriptEngine = _FakeScriptEngine(); + + final result = await PackageActivationController( + repository: _FakeRepository(candidate), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + audio: RuntimeAudioManager(), + store: store, + assetFallback: _FakeRepository(fallback), + audioManagerFactory: RuntimeAudioManager.new, + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(result.package.rootPath, fallback.rootPath); + expect(result.audio, isNotNull); + expect(store.markedPackages, [fallback.rootPath]); + }); + + test('does not mark a package when smoke_test fails', () async { + final candidate = await _createPackage('candidate'); + final fallback = await _createPackage('asset'); + final store = _FakeStablePackageStore(); + final scriptEngine = _FakeScriptEngine( + smokeFailures: {candidate.rootPath}, + ); + + final result = await PackageActivationController( + repository: _FakeRepository(candidate), + resources: GameResourceManager(), + scriptEngine: scriptEngine, + store: store, + assetFallback: _FakeRepository(fallback), + ).activate(gameId: 'ludo', contextBuilder: _context); + + expect(result.package.rootPath, fallback.rootPath); + expect(scriptEngine.loadedPackages, [ + candidate.rootPath, + fallback.rootPath, + ]); + expect(store.markedPackages, [fallback.rootPath]); + }); + }); +} + +Map _context(GamePackage package) { + return { + 'runtimeApiVersion': 1, + 'gameId': package.manifest.gameId, + 'gameVersion': package.manifest.version, + }; +} + +Future _createPackage( + String name, { + String script = _validScript, +}) async { + final root = await Directory.systemTemp.createTemp('activation_${name}_'); + Directory('${root.path}/scripts').createSync(recursive: true); + File('${root.path}/scripts/main.lua').writeAsStringSync(script); + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: const GamePackageManifest( + gameId: 'ludo', + name: 'Ludo', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + ), + ); +} + +Future _createAudioPackage( + String name, { + bool writeAudio = true, +}) async { + final root = await Directory.systemTemp.createTemp('activation_${name}_'); + Directory('${root.path}/scripts').createSync(recursive: true); + Directory('${root.path}/assets').createSync(recursive: true); + File('${root.path}/scripts/main.lua').writeAsStringSync(_validScript); + if (writeAudio) { + File('${root.path}/assets/dice.wav').writeAsBytesSync(const [1, 2, 3]); + } + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: const GamePackageManifest( + gameId: 'ludo', + name: 'Ludo', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: { + 'dice': GameResource( + type: GameResourceType.audio, + path: 'assets/dice.wav', + preload: GameResourcePreload.required, + ), + }, + ), + ); +} + +class _FakeRepository implements GamePackageRepository { + const _FakeRepository(this.package, {this.error}); + + final GamePackage package; + final Object? error; + + @override + Future load(String gameId) async { + final value = error; + if (value != null) { + throw value; + } + return package; + } +} + +class _FakeStablePackageStore implements StablePackageStore { + _FakeStablePackageStore({this.stable, this.previous}); + + final GamePackage? stable; + final GamePackage? previous; + final markedPackages = []; + + @override + Future cacheRoot() => throw UnimplementedError(); + + @override + Future markStable(GamePackage package) async { + markedPackages.add(package.rootPath); + } + + @override + Future previousStablePackage(String gameId) async => previous; + + @override + Future stablePackage(String gameId) async => stable; + + @override + Future versionDirectory(String gameId, String version) => + throw UnimplementedError(); +} + +class _RecordingResourceManager extends GameResourceManager { + final mountedPackages = []; + var disposed = false; + + @override + Future mount(GamePackage package) async { + mountedPackages.add(package.rootPath); + await super.mount(package); + } + + @override + void dispose() { + disposed = true; + super.dispose(); + } +} + +class _FakeScriptEngine implements ScriptEngine { + _FakeScriptEngine({this.smokeFailures = const {}}); + + final Set smokeFailures; + final loadedPackages = []; + final initPackages = []; + GamePackage? _package; + + @override + Future loadPackage(GamePackage package) async { + _package = package; + loadedPackages.add(package.rootPath); + } + + @override + bool smokeTest(Map context) { + return !smokeFailures.contains(_package?.rootPath); + } + + @override + GameDiff init(Map context) { + final package = _package; + if (package != null) { + initPackages.add(package.rootPath); + } + return GameDiff.empty; + } + + @override + GameDiff dispatchEvent(RuntimeEvent event) => GameDiff.empty; +} + +const _validScript = ''' +function smoke_test(ctx) + return true +end + +function init(ctx) + return {} +end + +function on_event(event) + return {} +end +'''; diff --git a/test/runtime/packages/game_package_manifest_test.dart b/test/runtime/packages/game_package_manifest_test.dart new file mode 100644 index 0000000..d9bfbac --- /dev/null +++ b/test/runtime/packages/game_package_manifest_test.dart @@ -0,0 +1,236 @@ +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('GamePackageManifest', () { + test('parses manifest with resources', () { + final manifest = GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'assetsBase': 'assets', + 'defaultLocale': 'zh-Hans', + 'supportedLocales': ['zh-Hans', 'en'], + 'display': { + 'designWidth': 720, + 'designHeight': 1280, + 'scaleMode': 'fit', + }, + 'modules': { + 'runtime_ui': 'runtime:runtime_ui.lua', + 'theme': 'scripts/theme.lua', + }, + 'resources': { + 'board': { + 'type': 'image', + 'path': 'assets/board.png', + 'preload': 'lazy', + 'group': 'board', + }, + 'roll': {'type': 'audio', 'path': 'assets/roll.mp3'}, + 'hero': { + 'type': 'spine', + 'atlas': 'assets/hero.atlas', + 'skeleton': 'assets/hero.skel', + 'preload': 'lazy', + 'group': 'actors', + }, + }, + }); + + expect(manifest.gameId, 'ludo'); + expect(manifest.name, 'Ludo'); + expect(manifest.version, '0.1.0'); + expect(manifest.runtimeApiVersion, 1); + expect(manifest.entry, 'scripts/main.lua'); + expect(manifest.assetsBase, 'assets'); + expect(manifest.defaultLocale, 'zh-Hans'); + expect(manifest.supportedLocales, ['zh-Hans', 'en']); + expect(manifest.display.designWidth, 720); + expect(manifest.display.designHeight, 1280); + expect(manifest.display.scaleMode, 'fit'); + expect(manifest.resources['board']?.type, 'image'); + expect(manifest.resources['board']?.path, 'assets/board.png'); + expect(manifest.resources['board']?.preload, GameResourcePreload.lazy); + expect(manifest.resources['board']?.group, 'board'); + expect(manifest.resources['roll']?.type, GameResourceType.audio); + expect(manifest.resources['roll']?.preload, GameResourcePreload.required); + expect(manifest.resources['hero']?.type, GameResourceType.spine); + expect(manifest.resources['hero']?.atlas, 'assets/hero.atlas'); + expect(manifest.resources['hero']?.skeleton, 'assets/hero.skel'); + expect(manifest.resources['hero']?.path, isEmpty); + expect(manifest.modules, { + 'runtime_ui': 'runtime:runtime_ui.lua', + 'theme': 'scripts/theme.lua', + }); + }); + + test('defaults assetsBase to assets', () { + final manifest = GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + }); + + expect(manifest.assetsBase, 'assets'); + expect(manifest.defaultLocale, 'en'); + expect(manifest.supportedLocales, ['en']); + expect(manifest.display.designWidth, 720); + expect(manifest.display.designHeight, 720); + expect(manifest.display.scaleMode, 'fit'); + expect(manifest.resources, isEmpty); + expect(manifest.modules, isEmpty); + }); + + test('rejects invalid required fields and resources', () { + expect( + () => GamePackageManifest.fromMap({ + 'gameId': '', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': '1', + 'entry': 'scripts/main.lua', + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'resources': { + 'board': {'type': '', 'path': 'assets/board.png'}, + }, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'resources': { + 'roll': {'type': 'sound', 'path': 'assets/roll.mp3'}, + }, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'modules': {'theme': 1}, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'resources': { + 'board': { + 'type': 'image', + 'path': 'assets/board.png', + 'preload': 'eager', + }, + }, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'resources': { + 'board': {'type': 'image', 'path': 'assets/board.png', 'group': ''}, + }, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'resources': { + 'hero': {'type': 'spine', 'atlas': 'assets/hero.atlas'}, + }, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'defaultLocale': 'zh-Hans', + 'supportedLocales': ['en'], + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'display': {'designWidth': 0}, + }), + throwsFormatException, + ); + + expect( + () => GamePackageManifest.fromMap({ + 'gameId': 'ludo', + 'name': 'Ludo', + 'version': '0.1.0', + 'runtimeApiVersion': 1, + 'entry': 'scripts/main.lua', + 'display': {'scaleMode': 'zoom'}, + }), + throwsFormatException, + ); + }); + }); +} diff --git a/test/runtime/packages/game_package_test.dart b/test/runtime/packages/game_package_test.dart new file mode 100644 index 0000000..6cb8aa0 --- /dev/null +++ b/test/runtime/packages/game_package_test.dart @@ -0,0 +1,84 @@ +import 'dart:io'; + +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('GamePackage', () { + test('resolves manifest resource keys', () { + final package = _package(); + + expect( + package.resolveResourcePath('board'), + 'example/assets/games/ludo/assets/board.png', + ); + }); + + test('resolves package-relative paths and assetsBase fallback', () { + final package = _package(); + + expect( + package.resolveResourcePath('scripts/main.lua'), + 'example/assets/games/ludo/scripts/main.lua', + ); + expect( + package.resolveResourcePath('unknown.png'), + 'example/assets/games/ludo/assets/unknown.png', + ); + expect( + package.resolveResourcePath( + 'example/assets/games/ludo/assets/board.png', + ), + 'example/assets/games/ludo/assets/board.png', + ); + }); + + test('keeps runtime Lua root configurable per package', () { + final package = GamePackage.asset( + rootPath: 'example/assets/games/ludo', + manifest: _manifest(), + runtimeLuaRoot: 'packages/flame_lua_runtime/assets/runtime/lua', + ); + + expect( + package.runtimeLuaRoot, + 'packages/flame_lua_runtime/assets/runtime/lua', + ); + }); + + test('reads file package text and bytes', () async { + final root = await Directory.systemTemp.createTemp('game_package_test_'); + addTearDown(() => root.deleteSync(recursive: true)); + Directory('${root.path}/scripts').createSync(recursive: true); + File('${root.path}/scripts/main.lua').writeAsStringSync('return true'); + + final package = GamePackage.file( + rootPath: root.path, + manifest: _manifest(), + ); + + expect(await package.readText('scripts/main.lua'), 'return true'); + expect((await package.readBytes('scripts/main.lua')).lengthInBytes, 11); + }); + }); +} + +GamePackage _package() { + return GamePackage.asset( + rootPath: 'example/assets/games/ludo', + manifest: _manifest(), + ); +} + +GamePackageManifest _manifest() { + return const GamePackageManifest( + gameId: 'ludo', + name: 'Ludo', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: {'board': GameResource(type: 'image', path: 'assets/board.png')}, + ); +} diff --git a/test/runtime/packages/package_verifier_test.dart b/test/runtime/packages/package_verifier_test.dart new file mode 100644 index 0000000..7cfa444 --- /dev/null +++ b/test/runtime/packages/package_verifier_test.dart @@ -0,0 +1,144 @@ +import 'dart:io'; + +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/packages/package_verifier.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + TestWidgetsFlutterBinding.ensureInitialized(); + + group('PackageVerifier', () { + test('accepts a valid file package', () async { + final package = await _createPackage(); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + completes, + ); + }); + + test('accepts runtime framework module paths', () async { + final package = await _createPackage( + modules: {'runtime_ui': 'runtime:runtime_ui.lua'}, + ); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + completes, + ); + }); + + test('rejects unsupported runtimeApiVersion', () async { + final package = await _createPackage(runtimeApiVersion: 2); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + throwsFormatException, + ); + }); + + test('rejects missing Lua entry functions', () async { + final package = await _createPackage(script: 'function init(ctx) end'); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + throwsFormatException, + ); + }); + + test('rejects unsafe declared modules', () async { + final package = await _createPackage( + modules: {'../theme': 'scripts/theme.lua'}, + ); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + throwsFormatException, + ); + }); + + test('rejects module paths outside scripts directory', () async { + final package = await _createPackage( + modules: {'theme': 'assets/theme.lua'}, + ); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + throwsFormatException, + ); + }); + + test('rejects missing declared resources', () async { + final package = await _createPackage(writeResource: false); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + throwsFormatException, + ); + }); + + test('rejects resource paths that escape package root', () async { + final package = await _createPackage(resourcePath: '../outside.png'); + + await expectLater( + const PackageVerifier(runtimeApiVersion: 1).verify(package), + throwsFormatException, + ); + }); + }); +} + +Future _createPackage({ + int runtimeApiVersion = 1, + String script = _validScript, + String resourcePath = 'assets/board.png', + bool writeResource = true, + Map modules = const {'theme': 'scripts/theme.lua'}, +}) async { + final root = await Directory.systemTemp.createTemp('package_verifier_test_'); + Directory('${root.path}/scripts').createSync(recursive: true); + Directory('${root.path}/assets').createSync(recursive: true); + File('${root.path}/scripts/main.lua').writeAsStringSync(script); + File('${root.path}/scripts/theme.lua').writeAsStringSync('return {}'); + if (writeResource && !resourcePath.contains('..')) { + File('${root.path}/$resourcePath') + ..createSync(recursive: true) + ..writeAsBytesSync([1, 2, 3]); + } + + final package = GamePackage.file( + rootPath: root.path, + manifest: GamePackageManifest( + gameId: 'ludo', + name: 'Ludo', + version: '0.1.0', + runtimeApiVersion: runtimeApiVersion, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: {'board': GameResource(type: 'image', path: resourcePath)}, + modules: modules, + ), + ); + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + return package; +} + +const _validScript = ''' +function smoke_test(ctx) + return true +end + +function init(ctx) + return {} +end + +function on_event(event) + return {} +end +'''; diff --git a/test/runtime/public_api_test.dart b/test/runtime/public_api_test.dart new file mode 100644 index 0000000..7d94e54 --- /dev/null +++ b/test/runtime/public_api_test.dart @@ -0,0 +1,20 @@ +import 'package:flame_lua_runtime/flame_lua_runtime.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + test('public runtime API exposes minimal integration surface', () { + const repository = AssetGamePackageRepository(); + const options = RuntimeOptions(runtimeLuaRoot: 'custom/runtime/lua'); + const widget = LuaGameWidget( + gameId: 'template', + packageRepository: repository, + runtimeOptions: options, + ); + + expect(widget.gameId, 'template'); + expect(widget.packageRepository, same(repository)); + expect(widget.runtimeOptions.runtimeLuaRoot, 'custom/runtime/lua'); + expect(LuaDardoScriptEngine.new, isA()); + expect(RuntimeLocaleResolver.localeFromTag('zh-Hans').scriptCode, 'Hans'); + }); +} diff --git a/test/runtime/rendering/render_tree_controller_test.dart b/test/runtime/rendering/render_tree_controller_test.dart new file mode 100644 index 0000000..b77d491 --- /dev/null +++ b/test/runtime/rendering/render_tree_controller_test.dart @@ -0,0 +1,593 @@ +import 'package:flame/components.dart'; +import 'package:flame_lua_runtime/runtime/models/game_diff.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_node.dart'; +import 'package:flame_lua_runtime/runtime/protocol/runtime_protocol.dart'; +import 'package:flame_lua_runtime/runtime/rendering/render_tree_controller.dart'; +import 'package:flame_lua_runtime/runtime/resources/game_resource_manager.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RenderTreeController', () { + test('creates, updates and removes components by id', () { + final events = []; + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: events.add, + ); + + controller.apply( + NodeDiff( + creates: [ + RuntimeNode( + id: 'panel', + type: RuntimeNodeType.rect, + x: 10, + y: 20, + width: 100, + height: 80, + layer: 4, + ), + ], + ), + ); + + final created = controller.componentById('panel'); + expect(created, isNotNull); + expect(created!.node.x, 10); + expect(created.node.y, 20); + expect(created.node.width, 100); + expect(created.node.height, 80); + expect(created.priority, 4); + + controller.apply( + NodeDiff( + updates: [ + NodeUpdate( + id: 'panel', + props: {'x': 30, 'visible': false, 'layer': 8}, + ), + ], + ), + ); + + final updated = controller.componentById('panel'); + expect(updated, same(created)); + expect(updated!.node.x, 30); + expect(updated.node.y, 20); + expect(updated.node.visible, isFalse); + expect(updated.priority, 8); + + controller.apply(const NodeDiff(removes: [NodeRemove(id: 'panel')])); + + expect(controller.componentById('panel'), isNull); + }); + + test('replaces an existing component when create uses same id', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [RuntimeNode(id: 'node', type: RuntimeNodeType.rect)], + ), + ); + final first = controller.componentById('node'); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode(id: 'node', type: RuntimeNodeType.circle, layer: 2), + ], + ), + ); + final second = controller.componentById('node'); + + expect(first, isNotNull); + expect(second, isNotNull); + expect(second, isNot(same(first))); + expect(second!.node.type, RuntimeNodeType.circle); + expect(second.priority, 2); + }); + + test('mounts nodes under declared parent and supports reparenting', () { + final root = Component(); + final controller = RenderTreeController( + root: root, + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode(id: 'panel', type: RuntimeNodeType.panel), + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + parent: 'panel', + ), + ], + ), + ); + + final panel = controller.componentById('panel')!; + final button = controller.componentById('button')!; + expect(panel.parent, root); + expect(button.parent, panel); + + controller.apply( + NodeDiff( + updates: [ + NodeUpdate(id: 'button', props: {'parent': ''}), + ], + ), + ); + + expect(button.parent, root); + expect(button.node.parent, isNull); + }); + + test('reattaches child when parent is created later', () { + final root = Component(); + final controller = RenderTreeController( + root: root, + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + parent: 'panel', + ), + ], + ), + ); + + final button = controller.componentById('button')!; + expect(button.parent, root); + + controller.apply( + const NodeDiff( + creates: [RuntimeNode(id: 'panel', type: RuntimeNodeType.panel)], + ), + ); + + expect(button.parent, controller.componentById('panel')); + }); + + test('scrolls listView by id or point and offsets direct children', () { + final root = PositionComponent(); + final events = []; + final controller = RenderTreeController( + root: root, + resources: GameResourceManager(), + eventSink: events.add, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'list', + type: RuntimeNodeType.listView, + width: 160, + height: 60, + contentWidth: 220, + contentHeight: 140, + scrollX: 10, + scrollY: 20, + onScroll: 'list_scrolled', + ), + RuntimeNode( + id: 'row', + type: RuntimeNodeType.button, + parent: 'list', + x: 40, + y: 50, + width: 140, + height: 24, + ), + ], + ), + ); + + final list = controller.componentById('list')!; + final row = controller.componentById('row')!; + expect(row.parent, list); + expect(row.position, Vector2(30, 30)); + expect(controller.listViewAt(Vector2(10, 10)), 'list'); + + expect(controller.scrollListView('list', deltaX: 30, deltaY: 50), isTrue); + expect(controller.componentById('list')!.node.scrollX, 40); + expect(controller.componentById('list')!.node.scrollY, 70); + expect(row.position, Vector2(0, -20)); + expect(events.last.type, RuntimeEventType.scroll); + expect(events.last.handler, 'list_scrolled'); + expect(events.last.data['scrollX'], 40); + expect(events.last.data['scrollY'], 70); + + expect( + controller.scrollListViewAt(Vector2(10, 10), deltaY: 1000), + isTrue, + ); + expect(controller.componentById('list')!.node.scrollY, 80); + expect(row.position, Vector2(0, -30)); + expect( + controller.scrollListViewAt(Vector2(500, 500), deltaY: 20), + isFalse, + ); + }); + + test('listView padding offsets children and reduces scroll viewport', () { + final root = PositionComponent(); + final controller = RenderTreeController( + root: root, + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'list', + type: RuntimeNodeType.listView, + width: 120, + height: 80, + contentWidth: 200, + contentHeight: 168, + paddingLeft: 10, + paddingTop: 12, + paddingRight: 8, + paddingBottom: 6, + scrollbarVisible: false, + ), + RuntimeNode( + id: 'row', + type: RuntimeNodeType.button, + parent: 'list', + x: 4, + y: 5, + width: 40, + height: 20, + ), + ], + ), + ); + + final row = controller.componentById('row')!; + expect(row.position, Vector2(14, 17)); + expect( + controller.scrollListView('list', deltaX: 200, deltaY: 200), + isTrue, + ); + expect(controller.componentById('list')!.node.scrollX, 98); + expect(controller.componentById('list')!.node.scrollY, 106); + expect(row.position, Vector2(-84, -89)); + }); + + test('virtualized listView culls direct children outside cache window', () { + final root = PositionComponent(); + final controller = RenderTreeController( + root: root, + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'list', + type: RuntimeNodeType.listView, + width: 120, + height: 60, + contentHeight: 400, + virtualized: true, + cacheExtent: 0, + ), + RuntimeNode( + id: 'visible_row', + type: RuntimeNodeType.button, + parent: 'list', + y: 20, + width: 100, + height: 20, + ), + RuntimeNode( + id: 'culled_row', + type: RuntimeNodeType.button, + parent: 'list', + y: 180, + width: 100, + height: 20, + ), + ], + ), + ); + + expect(controller.componentById('visible_row')!.isVisible, isTrue); + expect(controller.componentById('culled_row')!.isVisible, isFalse); + + controller.scrollListView('list', deltaY: 150); + + expect(controller.componentById('visible_row')!.isVisible, isFalse); + expect(controller.componentById('culled_row')!.isVisible, isTrue); + }); + + test('removes descendants when removing parent', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode(id: 'panel', type: RuntimeNodeType.panel), + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + parent: 'panel', + ), + RuntimeNode( + id: 'label', + type: RuntimeNodeType.text, + parent: 'button', + ), + ], + ), + ); + + controller.apply(const NodeDiff(removes: [NodeRemove(id: 'panel')])); + + expect(controller.componentById('panel'), isNull); + expect(controller.componentById('button'), isNull); + expect(controller.componentById('label'), isNull); + }); + + test('rejects parent cycles', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode(id: 'panel', type: RuntimeNodeType.panel), + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + parent: 'panel', + ), + ], + ), + ); + + expect( + () => controller.apply( + NodeDiff( + updates: [ + NodeUpdate(id: 'panel', props: {'parent': 'button'}), + ], + ), + ), + throwsFormatException, + ); + expect(controller.componentById('panel')!.node.parent, isNull); + }); + + test('rejects invalid diff before applying any partial mutation', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode(id: 'toast', type: RuntimeNodeType.panel), + RuntimeNode(id: 'panel', type: RuntimeNodeType.panel), + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + parent: 'panel', + ), + ], + ), + ); + + expect( + () => controller.apply( + NodeDiff( + removes: const [NodeRemove(id: 'toast')], + updates: [ + NodeUpdate(id: 'panel', props: {'parent': 'button'}), + ], + ), + ), + throwsFormatException, + ); + + expect(controller.componentById('toast'), isNotNull); + expect(controller.componentById('panel')!.node.parent, isNull); + expect(controller.componentById('button')!.node.parent, 'panel'); + }); + + test('clear removes all tracked components', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode(id: 'panel', type: RuntimeNodeType.panel), + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + parent: 'panel', + ), + ], + ), + ); + + controller.clear(); + + expect(controller.componentById('panel'), isNull); + expect(controller.componentById('button'), isNull); + }); + + test('ignores tap callback from stale replaced component', () { + final events = []; + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: events.add, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + interactive: true, + onTap: 'old_tap', + ), + ], + ), + ); + final stale = controller.componentById('button')!; + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + interactive: true, + onTap: 'new_tap', + ), + ], + ), + ); + + stale.onNodeTap(stale.node, Vector2(1, 2)); + controller + .componentById('button')! + .onNodeTap(controller.componentById('button')!.node, Vector2(3, 4)); + + expect(events.map((event) => event.toMap()), [ + { + 'type': RuntimeEventType.tap, + 'target': 'button', + 'handler': 'new_tap', + 'x': 3.0, + 'y': 4.0, + }, + ]); + }); + + test('emits tap event from interactive node callback', () { + final events = []; + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: events.add, + ); + + controller.apply( + const NodeDiff( + creates: [ + RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + interactive: true, + onTap: 'roll_dice', + ), + ], + ), + ); + + final component = controller.componentById('button')!; + component.onNodeTap(component.node, Vector2(3, 4)); + + expect(events, hasLength(1)); + expect(events.single.toMap(), { + 'type': RuntimeEventType.tap, + 'target': 'button', + 'handler': 'roll_dice', + 'x': 3.0, + 'y': 4.0, + }); + expect(events.single.targetEpoch, controller.epochOf('button')); + expect(events.single.scopeEpoch, controller.epochOf('button')); + }); + + test('increments epoch when node is recreated', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + const NodeDiff( + creates: [RuntimeNode(id: 'node', type: RuntimeNodeType.rect)], + ), + ); + final firstEpoch = controller.epochOf('node'); + + controller.apply(const NodeDiff(removes: [NodeRemove(id: 'node')])); + final removedEpoch = controller.epochOf('node'); + + controller.apply( + const NodeDiff( + creates: [RuntimeNode(id: 'node', type: RuntimeNodeType.rect)], + ), + ); + final recreatedEpoch = controller.epochOf('node'); + + expect(firstEpoch, 1); + expect(removedEpoch, greaterThan(firstEpoch)); + expect(recreatedEpoch, greaterThan(removedEpoch)); + expect(controller.isNodeEpochAlive('node', firstEpoch), isFalse); + expect(controller.isNodeEpochAlive('node', recreatedEpoch), isTrue); + }); + + test('ignores updates and removes for unknown ids', () { + final controller = RenderTreeController( + root: Component(), + resources: GameResourceManager(), + eventSink: (_) {}, + ); + + controller.apply( + NodeDiff( + updates: [ + NodeUpdate(id: 'missing', props: {'x': 1}), + ], + removes: const [NodeRemove(id: 'missing')], + ), + ); + + expect(controller.componentById('missing'), isNull); + }); + }); +} diff --git a/test/runtime/rendering/runtime_component_test.dart b/test/runtime/rendering/runtime_component_test.dart new file mode 100644 index 0000000..6fea432 --- /dev/null +++ b/test/runtime/rendering/runtime_component_test.dart @@ -0,0 +1,165 @@ +import 'package:flame/components.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_node.dart'; +import 'package:flame_lua_runtime/runtime/protocol/runtime_protocol.dart'; +import 'package:flame_lua_runtime/runtime/rendering/runtime_component.dart'; +import 'package:flame_lua_runtime/runtime/resources/game_resource_manager.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeComponent', () { + test('applies base transform and priority from node', () { + final component = RuntimeComponent( + node: const RuntimeNode( + id: 'rect', + type: RuntimeNodeType.rect, + x: 10, + y: 20, + width: 120, + height: 48, + scale: 1.5, + rotation: 0.25, + anchor: RuntimeAnchorValue.center, + layer: 7, + ), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + + expect(component.position, Vector2(10, 20)); + expect(component.size, Vector2(120, 48)); + expect(component.scale, Vector2.all(1.5)); + expect(component.angle, 0.25); + expect(component.anchor, Anchor.center); + expect(component.priority, 7); + expect(component.isVisible, isTrue); + }); + + test('updates node and transform', () { + final component = RuntimeComponent( + node: const RuntimeNode(id: 'node', type: RuntimeNodeType.rect), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + + component.updateNode( + const RuntimeNode( + id: 'node', + type: RuntimeNodeType.progress, + x: 30, + y: 40, + width: 200, + height: 16, + value: 0.5, + layer: 3, + ), + ); + + expect(component.node.type, RuntimeNodeType.progress); + expect(component.node.value, 0.5); + expect(component.position, Vector2(30, 40)); + expect(component.size, Vector2(200, 16)); + expect(component.priority, 3); + expect(component.isVisible, isTrue); + }); + + test('visibility hides component subtree and disables hit testing', () { + final component = RuntimeComponent( + node: const RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + text: 'Hidden', + width: 100, + height: 40, + visible: false, + interactive: true, + ), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + + expect(component.isVisible, isFalse); + expect(component.containsLocalPoint(Vector2(10, 10)), isFalse); + + component.updateNode( + const RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + text: 'Shown', + width: 100, + height: 40, + visible: true, + interactive: true, + ), + ); + + expect(component.isVisible, isTrue); + expect(component.containsLocalPoint(Vector2(10, 10)), isTrue); + }); + + test('supports runtime alpha override for fade commands', () { + final component = RuntimeComponent( + node: const RuntimeNode( + id: 'panel', + type: RuntimeNodeType.rect, + alpha: 0.8, + ), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + + expect(component.renderAlpha, 0.8); + component.setRuntimeAlpha(0.25); + expect(component.renderAlpha, 0.25); + component.setRuntimeAlpha(2); + expect(component.renderAlpha, 1); + }); + + test('multi-line non-button text is top aligned', () { + final component = RuntimeComponent( + node: const RuntimeNode( + id: 'text', + type: RuntimeNodeType.text, + text: 'line1\nline2', + width: 120, + height: 80, + textAlign: RuntimeTextAlignValue.left, + ), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + + final text = component.children.whereType().single; + expect(text.anchor, Anchor.topLeft); + expect(text.position, Vector2.zero()); + }); + + test('only interactive nodes contain local points', () { + final passive = RuntimeComponent( + node: const RuntimeNode( + id: 'passive', + type: RuntimeNodeType.rect, + width: 100, + height: 40, + ), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + final interactive = RuntimeComponent( + node: const RuntimeNode( + id: 'button', + type: RuntimeNodeType.button, + width: 100, + height: 40, + interactive: true, + ), + resources: GameResourceManager(), + onNodeTap: (_, __) {}, + ); + + expect(passive.containsLocalPoint(Vector2(10, 10)), isFalse); + expect(interactive.containsLocalPoint(Vector2(10, 10)), isTrue); + expect(interactive.containsLocalPoint(Vector2(101, 10)), isFalse); + expect(interactive.containsLocalPoint(Vector2(10, 41)), isFalse); + }); + }); +} diff --git a/test/runtime/rendering/runtime_viewport_test.dart b/test/runtime/rendering/runtime_viewport_test.dart new file mode 100644 index 0000000..3537663 --- /dev/null +++ b/test/runtime/rendering/runtime_viewport_test.dart @@ -0,0 +1,98 @@ +import 'package:flame/components.dart'; +import 'package:flame_lua_runtime/runtime/display/runtime_viewport.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('RuntimeViewport', () { + test('fits design size inside screen with letterboxing', () { + final transform = RuntimeViewport.compute( + screenSize: Vector2(1280, 720), + config: const RuntimeViewportConfig( + designWidth: 720, + designHeight: 720, + ), + ); + + expect(transform.x, 280); + expect(transform.y, 0); + expect(transform.width, 720); + expect(transform.height, 720); + expect(transform.scaleX, 1); + expect(transform.scaleY, 1); + }); + + test('fills screen by preserving aspect ratio and cropping', () { + final transform = RuntimeViewport.compute( + screenSize: Vector2(1280, 720), + config: const RuntimeViewportConfig( + designWidth: 720, + designHeight: 720, + scaleMode: RuntimeScaleMode.fill, + ), + ); + + expect(transform.x, 0); + expect(transform.y, -280); + expect(transform.width, 1280); + expect(transform.height, 1280); + expect(transform.scaleX, closeTo(1.777777, 0.00001)); + expect(transform.scaleY, closeTo(1.777777, 0.00001)); + }); + + test('stretches design independently on both axes', () { + final transform = RuntimeViewport.compute( + screenSize: Vector2(1440, 720), + config: const RuntimeViewportConfig( + designWidth: 720, + designHeight: 720, + scaleMode: RuntimeScaleMode.stretch, + ), + ); + + expect(transform.x, 0); + expect(transform.y, 0); + expect(transform.width, 1440); + expect(transform.height, 720); + expect(transform.scaleX, 2); + expect(transform.scaleY, 1); + }); + + test('centers design without scaling', () { + final transform = RuntimeViewport.compute( + screenSize: Vector2(1000, 800), + config: const RuntimeViewportConfig( + designWidth: 720, + designHeight: 720, + scaleMode: RuntimeScaleMode.none, + ), + ); + + expect(transform.x, 140); + expect(transform.y, 40); + expect(transform.width, 720); + expect(transform.height, 720); + expect(transform.scaleX, 1); + expect(transform.scaleY, 1); + }); + + test('applies transform to root component', () { + final root = PositionComponent(); + RuntimeViewport.apply( + root, + const RuntimeViewportTransform( + x: 10, + y: 20, + width: 300, + height: 400, + scaleX: 2, + scaleY: 3, + scaleMode: RuntimeScaleMode.stretch, + ), + ); + + expect(root.position, Vector2(10, 20)); + expect(root.size, Vector2(300, 400)); + expect(root.scale, Vector2(2, 3)); + }); + }); +} diff --git a/test/runtime/resources/game_resource_manager_test.dart b/test/runtime/resources/game_resource_manager_test.dart new file mode 100644 index 0000000..5d1cadc --- /dev/null +++ b/test/runtime/resources/game_resource_manager_test.dart @@ -0,0 +1,401 @@ +import 'dart:async' as async; +import 'dart:io'; +import 'dart:typed_data'; + +import 'package:flame_lua_runtime/runtime/diagnostics/runtime_diagnostics.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/resources/game_resource_manager.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + TestWidgetsFlutterBinding.ensureInitialized(); + + group('GameResourceManager', () { + test( + 'advances generation and clears cache when mounting package', + () async { + final resources = GameResourceManager(); + final first = await _createPackage('first'); + final second = await _createPackage('second'); + + expect(resources.generation, 0); + + await resources.mount(first); + expect(resources.generation, 1); + + await resources.mount(second); + expect(resources.generation, 2); + }, + ); + + test('resolves resource keys from active package', () async { + final resources = GameResourceManager(); + final package = await _createPackage('resources'); + + await resources.mount(package); + + expect(resources.resolve('tile'), endsWith('/assets/tile.png')); + }); + + test( + 'lazy image load records failed state, error and diagnostics', + () async { + final diagnostics = RuntimeDiagnostics(); + final resources = GameResourceManager(diagnostics: diagnostics); + final package = await _createPackage('lazy_failed'); + + await resources.mount(package); + expect(resources.imageState('tile'), GameResourceState.idle); + + final image = await resources.loadImage('tile'); + + expect(image, isNull); + expect(resources.imageState('tile'), GameResourceState.failed); + expect(resources.imageError('tile'), isNotNull); + expect(diagnostics.entries, hasLength(1)); + expect( + diagnostics.entries.single.type, + RuntimeDiagnosticType.resourceLoadError, + ); + }, + ); + + test('exports image debug json and evicts failed records', () async { + final resources = GameResourceManager(); + final package = await _createPackage('debug_json'); + + await resources.mount(package); + + expect(resources.imagesDebugJson(), { + 'generation': 1, + 'hasPackage': true, + 'count': 1, + 'activeLoads': 0, + 'pendingLoads': 0, + 'resources': [ + { + 'key': 'tile', + 'path': endsWith('/assets/tile.png'), + 'type': GameResourceType.image, + 'declared': true, + 'preload': GameResourcePreload.lazy, + 'state': 'idle', + 'loading': false, + 'ready': false, + }, + ], + }); + + await resources.loadImage('tile'); + final failedJson = resources.imagesDebugJson(); + final failedResources = failedJson['resources'] as List; + final failedTile = failedResources.single as Map; + + expect(failedTile['state'], 'failed'); + expect(failedTile['error'], isA()); + + expect(resources.evictImage('tile'), isTrue); + expect(resources.imageState('tile'), GameResourceState.idle); + expect(resources.evictImage('tile'), isFalse); + }); + + test('preloads and evicts image resource groups', () async { + final resources = GameResourceManager(); + final package = await _createMultiImagePackage('image_group'); + + await resources.mount(package); + await resources.preloadGroup('board'); + + expect(resources.imageState('board'), GameResourceState.ready); + expect(resources.imageState('piece'), GameResourceState.ready); + expect(resources.imageState('avatar'), GameResourceState.idle); + expect(resources.evictGroup('board'), 2); + expect(resources.imageState('board'), GameResourceState.idle); + expect(resources.imageState('piece'), GameResourceState.idle); + }); + + test('image LRU evicts least recently used unretained images', () async { + final resources = GameResourceManager(maxCacheEntries: 1); + final package = await _createMultiImagePackage('image_lru'); + + await resources.mount(package); + await resources.loadImage('board'); + expect(resources.imageState('board'), GameResourceState.ready); + + await resources.loadImage('avatar'); + + expect(resources.imageState('board'), GameResourceState.idle); + expect(resources.imageState('avatar'), GameResourceState.ready); + }); + + test('image LRU keeps retained images until released', () async { + final resources = GameResourceManager(maxCacheEntries: 1); + final package = await _createMultiImagePackage('image_lru_retained'); + + await resources.mount(package); + await resources.loadImage('board', retain: true); + await resources.loadImage('avatar'); + + expect(resources.imageState('board'), GameResourceState.ready); + expect(resources.imageState('avatar'), GameResourceState.idle); + + resources.releaseImage('board'); + await resources.loadImage('avatar'); + + expect(resources.imageState('board'), GameResourceState.idle); + expect(resources.imageState('avatar'), GameResourceState.ready); + }); + + test('deduplicates concurrent image load requests', () async { + final resources = GameResourceManager(); + final package = await _createPackage('dedupe'); + final countingPackage = _CountingPackage(package); + + await resources.mount(countingPackage); + + final first = resources.loadImage('tile'); + final second = resources.loadImage('tile'); + + expect(countingPackage.readCount, 1); + countingPackage.releaseReads(); + + await Future.wait([first, second]); + + expect(countingPackage.readCount, 1); + expect(resources.imageState('tile'), GameResourceState.failed); + }); + + test( + 'drops stale image load result after dispose without diagnostics', + () async { + final diagnostics = RuntimeDiagnostics(); + final resources = GameResourceManager(diagnostics: diagnostics); + final package = await _createPackage('stale_image'); + final countingPackage = _CountingPackage(package); + + await resources.mount(countingPackage); + final image = resources.loadImage('tile'); + + resources.dispose(); + countingPackage.releaseReads(); + + expect(await image, isNull); + expect(diagnostics.entries, isEmpty); + }, + ); + + test('optional preload failure does not fail mount', () async { + final resources = GameResourceManager(); + final package = await _createPackage( + 'optional_failed', + preload: GameResourcePreload.optional, + ); + + await resources.mount(package); + + expect(resources.imageState('tile'), GameResourceState.failed); + expect(resources.imageError('tile'), isNotNull); + }); + + test('required preload failure fails mount', () async { + final resources = GameResourceManager(); + final package = await _createPackage( + 'required_failed', + preload: GameResourcePreload.required, + ); + + await expectLater( + resources.mount(package), + throwsA(isA()), + ); + expect(resources.imageState('tile'), GameResourceState.failed); + expect(resources.imageError('tile'), isNotNull); + }); + + test('dispose clears active package and advances generation', () async { + final resources = GameResourceManager(); + final package = await _createPackage('dispose'); + + await resources.mount(package); + expect(resources.generation, 1); + + resources.dispose(); + + expect(resources.generation, 2); + expect(() => resources.package, throwsStateError); + }); + }); +} + +const _pngBytes = [ + 0x89, + 0x50, + 0x4e, + 0x47, + 0x0d, + 0x0a, + 0x1a, + 0x0a, + 0x00, + 0x00, + 0x00, + 0x0d, + 0x49, + 0x48, + 0x44, + 0x52, + 0x00, + 0x00, + 0x00, + 0x01, + 0x00, + 0x00, + 0x00, + 0x01, + 0x08, + 0x06, + 0x00, + 0x00, + 0x00, + 0x1f, + 0x15, + 0xc4, + 0x89, + 0x00, + 0x00, + 0x00, + 0x0a, + 0x49, + 0x44, + 0x41, + 0x54, + 0x78, + 0x9c, + 0x63, + 0x00, + 0x01, + 0x00, + 0x00, + 0x05, + 0x00, + 0x01, + 0x0d, + 0x0a, + 0x2d, + 0xb4, + 0x00, + 0x00, + 0x00, + 0x00, + 0x49, + 0x45, + 0x4e, + 0x44, + 0xae, + 0x42, + 0x60, + 0x82, +]; + +Future _createPackage( + String name, { + String preload = GameResourcePreload.lazy, +}) async { + final root = await Directory.systemTemp.createTemp('resource_${name}_'); + Directory('${root.path}/assets').createSync(recursive: true); + File('${root.path}/assets/tile.png').writeAsBytesSync(const []); + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: { + 'tile': GameResource( + type: 'image', + path: 'assets/tile.png', + preload: preload, + ), + }, + ), + ); +} + +Future _createMultiImagePackage(String name) async { + final root = await Directory.systemTemp.createTemp('resource_${name}_'); + Directory('${root.path}/assets').createSync(recursive: true); + for (final file in ['board.png', 'piece.png', 'avatar.png']) { + File('${root.path}/assets/$file').writeAsBytesSync(_pngBytes); + } + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + resources: const { + 'board': GameResource( + type: GameResourceType.image, + path: 'assets/board.png', + preload: GameResourcePreload.lazy, + group: 'board', + ), + 'piece': GameResource( + type: GameResourceType.image, + path: 'assets/piece.png', + preload: GameResourcePreload.lazy, + group: 'board', + ), + 'avatar': GameResource( + type: GameResourceType.image, + path: 'assets/avatar.png', + preload: GameResourcePreload.lazy, + group: 'hud', + ), + }, + ), + ); +} + +class _CountingPackage extends GamePackage { + _CountingPackage(GamePackage package) + : _releaseReads = async.Completer(), + super.file(rootPath: package.rootPath, manifest: package.manifest); + + final async.Completer _releaseReads; + int readCount = 0; + + void releaseReads() { + if (!_releaseReads.isCompleted) { + _releaseReads.complete(); + } + } + + @override + Future readBytes(String relativeOrAbsolutePath) async { + readCount++; + await _releaseReads.future; + return ByteData.sublistView(Uint8List(0)); + } +} diff --git a/test/runtime/resources/resource_load_limiter_test.dart b/test/runtime/resources/resource_load_limiter_test.dart new file mode 100644 index 0000000..4e1fbe0 --- /dev/null +++ b/test/runtime/resources/resource_load_limiter_test.dart @@ -0,0 +1,62 @@ +import 'dart:async' as async; + +import 'package:flame_lua_runtime/runtime/resources/resource_load_limiter.dart'; +import 'package:flutter_test/flutter_test.dart'; + +void main() { + group('ResourceLoadLimiter', () { + test('limits concurrent tasks', () async { + final limiter = ResourceLoadLimiter(2); + var active = 0; + var maxActive = 0; + + Future task(int value) async { + active++; + if (active > maxActive) { + maxActive = active; + } + await Future.delayed(const Duration(milliseconds: 5)); + active--; + return value; + } + + final results = await Future.wait([ + limiter.run(() => task(1)), + limiter.run(() => task(2)), + limiter.run(() => task(3)), + limiter.run(() => task(4)), + ]); + + expect(results, [1, 2, 3, 4]); + expect(maxActive, 2); + expect(limiter.activeCount, 0); + expect(limiter.pendingCount, 0); + }); + + test('clearPending cancels queued tasks', () async { + final limiter = ResourceLoadLimiter(1); + final hold = async.Completer(); + + final first = limiter.run(() => hold.future); + final second = limiter.run(() async => 2); + + expect(limiter.activeCount, 1); + expect(limiter.pendingCount, 1); + + final secondExpectation = expectLater( + second, + throwsA(isA()), + ); + + limiter.clearPending(); + hold.complete(); + + await first; + await secondExpectation; + }); + + test('rejects invalid concurrency', () { + expect(() => ResourceLoadLimiter(0), throwsArgumentError); + }); + }); +} diff --git a/test/runtime/scripting/lua_dardo_script_engine_test.dart b/test/runtime/scripting/lua_dardo_script_engine_test.dart new file mode 100644 index 0000000..94837ae --- /dev/null +++ b/test/runtime/scripting/lua_dardo_script_engine_test.dart @@ -0,0 +1,962 @@ +import 'dart:io'; + +import 'package:flame_lua_runtime/runtime/packages/game_package.dart'; +import 'package:flame_lua_runtime/runtime/packages/game_package_manifest.dart'; +import 'package:flame_lua_runtime/runtime/models/runtime_event.dart'; +import 'package:flame_lua_runtime/runtime/protocol/runtime_protocol.dart'; +import 'package:flame_lua_runtime/runtime/scripting/lua_dardo_script_engine.dart'; +import 'package:flutter_test/flutter_test.dart'; + +Future _loadExamplePackage(String gameId) async { + final root = 'example/assets/games/$gameId'; + final manifest = await File('$root/manifest.json').readAsString(); + return GamePackage.file( + rootPath: root, + manifest: GamePackageManifest.fromJsonString(manifest), + ); +} + +void main() { + TestWidgetsFlutterBinding.ensureInitialized(); + + group('LuaDardoScriptEngine runtime.import', () { + test('loads bundled Ludo module graph', () async { + final package = await _loadExamplePackage('ludo'); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({'runtimeApiVersion': 1}); + expect(diff.render.creates, isNotEmpty); + expect(diff.ui.creates, isNotEmpty); + expect( + diff.render.creates.map((node) => node.id), + contains('board_panel'), + ); + expect(diff.ui.creates.map((node) => node.id), contains('dice_button')); + final diceButton = diff.ui.creates.singleWhere( + (node) => node.id == 'dice_button', + ); + expect(diceButton.parent, 'top_bar'); + expect(diceButton.x, 540); + expect(diceButton.y, 14); + expect(diceButton.onTap, 'roll_dice'); + + final eventDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'dice_button', + handler: 'roll_dice', + ), + ); + final sound = eventDiff.commands.single; + expect(sound.type, RuntimeCommandType.playSound); + expect(sound.payload['asset'], 'dice'); + }); + + test('loads bundled Ludo with English localization context', () async { + final package = await _loadExamplePackage('ludo'); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + final context = { + 'runtimeApiVersion': 1, + 'locale': { + 'requested': 'en-US', + 'resolved': 'en', + 'default': 'zh-Hans', + 'supported': ['zh-Hans', 'en'], + 'languageCode': 'en', + 'countryCode': 'US', + }, + }; + expect(engine.smokeTest(context), isTrue); + final diff = engine.init(context); + + expect( + diff.render.creates + .singleWhere((node) => node.id == 'board_title') + .text, + 'Lua Ludo', + ); + expect( + diff.ui.creates.singleWhere((node) => node.id == 'dice_button').text, + 'Roll', + ); + expect( + diff.ui.creates.singleWhere((node) => node.id == 'turn_text').text, + 'Current player: Red', + ); + }); + + test('loads bundled Flight module graph and basic dice flow', () async { + final package = await _loadExamplePackage('flight'); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({'runtimeApiVersion': 1}); + expect( + diff.render.creates.map((node) => node.id), + contains('board_panel'), + ); + expect(diff.render.creates.map((node) => node.id), contains('red_1')); + expect(diff.ui.creates.map((node) => node.id), contains('dice_button')); + + final rollDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'dice_button', + handler: 'roll_dice', + ), + ); + expect( + rollDiff.render.updates.map((update) => update.id), + contains('red_1'), + ); + + final moveDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'red_1', + handler: 'piece_tap', + ), + ); + expect(moveDiff.commands.single.type, RuntimeCommandType.movePath); + expect(moveDiff.commands.single.target, 'red_1'); + }); + + test( + 'loads bundled Template package as minimal integration starter', + () async { + final package = await _loadExamplePackage('template'); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({ + 'runtimeApiVersion': 1, + 'gameId': 'template', + }); + expect( + diff.render.creates.map((node) => node.id), + contains('template_bg'), + ); + expect( + diff.render.creates.map((node) => node.id), + contains('template_start'), + ); + + final tapDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'template_start', + handler: 'template_start', + ), + ); + expect( + tapDiff.ui.updates.map((update) => update.id), + containsAll([ + 'template_start', + 'template_counter', + 'template_status', + ]), + ); + expect(tapDiff.commands.single.type, RuntimeCommandType.toast); + }, + ); + + test('loads bundled Showcase module graph and command examples', () async { + final package = await _loadExamplePackage('showcase'); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({'runtimeApiVersion': 1}); + final nodeIds = diff.render.creates.map((node) => node.id); + expect(nodeIds, contains('example_list_panel')); + expect(nodeIds, contains('example_nodes')); + expect(nodeIds, contains('example_text_demo')); + expect(nodeIds, contains('example_buttons')); + expect(nodeIds, contains('example_button_images')); + expect(nodeIds, contains('example_sprites')); + expect(nodeIds, contains('example_radio_group')); + expect(nodeIds, contains('example_list_view')); + expect(nodeIds, contains('example_layout_demo')); + expect(nodeIds, contains('example_commands')); + expect(nodeIds, contains('example_i18n')); + expect(nodeIds, contains('example_responsive')); + expect(nodeIds, contains('detail_panel')); + expect(nodeIds, contains('detail_action_1')); + expect(nodeIds, contains('sample_rect')); + expect(nodeIds, contains('sample_circle')); + expect(nodeIds, contains('sample_image_node')); + expect(nodeIds, contains('sample_sprite_node')); + expect(nodeIds, contains('sample_progress')); + expect(nodeIds, contains('text_plain_title')); + expect(nodeIds, contains('button_primary')); + expect(nodeIds, contains('image_button_normal')); + expect(nodeIds, contains('image_button_toggle')); + expect(nodeIds, contains('image_button_disabled')); + expect(nodeIds, contains('sprite_sprite_demo')); + expect(nodeIds, contains('radio_value_text')); + expect(nodeIds, contains('list_row_1')); + expect(nodeIds, contains('particle_burst')); + expect(nodeIds, contains('particle_trail')); + expect(nodeIds, contains('particle_snow')); + expect(nodeIds, contains('layout_chip_1')); + expect(nodeIds, contains('layout_chip_4')); + final imageButton = diff.render.creates.singleWhere( + (node) => node.id == 'image_button_normal', + ); + expect(imageButton.asset, 'button_normal'); + expect(imageButton.pressedAsset, 'button_pressed'); + expect(imageButton.disabledAsset, 'button_disabled'); + final disabledImageButton = diff.render.creates.singleWhere( + (node) => node.id == 'image_button_disabled', + ); + expect(disabledImageButton.interactive, isFalse); + expect(diff.commands, isEmpty); + + final imageButtonSelectDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_button_images', + handler: 'select_example', + ), + ); + expect( + imageButtonSelectDiff.ui.updates.map((update) => update.id), + containsAll(['detail_title', 'detail_code', 'image_button_normal']), + ); + final imageButtonToggleDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_2', + handler: 'demo_button_image_toggle', + ), + ); + final toggleUpdate = imageButtonToggleDiff.ui.updates.singleWhere( + (update) => update.id == 'image_button_toggle', + ); + expect(toggleUpdate.props, containsPair('interactive', false)); + + final selectDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_commands', + handler: 'select_example', + ), + ); + expect( + selectDiff.ui.updates.map((update) => update.id), + containsAll(['detail_title', 'detail_code', 'detail_action_1']), + ); + + final paramsDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_tab_params', + handler: 'detail_tab_params', + ), + ); + final detailCodeUpdate = paramsDiff.ui.updates.firstWhere( + (update) => update.id == 'detail_code', + ); + final paramsText = detailCodeUpdate.props['text']; + expect(paramsText, contains('参数说明')); + expect( + paramsDiff.ui.updates + .firstWhere( + (update) => + update.id == 'detail_code' && + update.props['textAlign'] != null, + ) + .props['textAlign'], + 'left', + ); + expect( + paramsDiff.ui.updates + .firstWhere((update) => update.id == 'detail_tab_params') + .props['onTap'], + 'detail_tab_params', + ); + + final listPickDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'list_row_3', + handler: 'demo_list_pick_3', + ), + ); + expect( + listPickDiff.ui.updates + .firstWhere((update) => update.id == 'list_panel') + .props['scrollX'], + 0, + ); + expect( + listPickDiff.ui.updates + .firstWhere((update) => update.id == 'list_row_3') + .props['x'], + 8, + ); + expect( + listPickDiff.ui.updates + .firstWhere((update) => update.id == 'list_row_3_text') + .props['textAlign'], + 'left', + ); + + final selectLayoutDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_layout_demo', + handler: 'select_example', + ), + ); + expect( + selectLayoutDiff.ui.updates + .firstWhere((update) => update.id == 'detail_action_3') + .props['onTap'], + 'demo_layout_box', + ); + final boxLayoutDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_3', + handler: 'demo_layout_box', + ), + ); + expect( + boxLayoutDiff.ui.updates + .firstWhere((update) => update.id == 'layout_chip_3') + .props, + containsPair('y', 90), + ); + expect( + boxLayoutDiff.ui.updates + .firstWhere((update) => update.id == 'layout_label') + .props['text'], + contains('2 行 × 2 列'), + ); + + engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_particles', + handler: 'select_example', + ), + ); + final particleParamsDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_tab_params', + handler: 'detail_tab_params', + ), + ); + expect( + particleParamsDiff.ui.updates + .firstWhere( + (update) => + update.id == 'detail_code' && update.props['height'] != null, + ) + .props['height'], + greaterThan(400), + ); + expect( + particleParamsDiff.ui.updates + .firstWhere((update) => update.id == 'code_panel') + .props['contentHeight'], + greaterThan(450), + ); + + final animDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_1', + handler: 'demo_anim', + ), + ); + expect(animDiff.commands.single.type, RuntimeCommandType.sequence); + expect(animDiff.commands.single.payload['commands'], isNotEmpty); + + final dialogDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_1', + handler: 'demo_dialog', + ), + ); + expect( + dialogDiff.ui.creates.map((node) => node.id), + contains('sample_dialog'), + ); + + final soundDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_1', + handler: 'demo_sound', + ), + ); + expect(soundDiff.commands.single.type, RuntimeCommandType.playSound); + expect(soundDiff.commands.single.payload['asset'], 'click'); + + final textSelectDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_text_demo', + handler: 'select_example', + ), + ); + expect( + textSelectDiff.ui.updates.map((update) => update.id), + containsAll(['text_plain_title', 'text_rich_note']), + ); + + final textStyleDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_2', + handler: 'demo_text_style', + ), + ); + expect( + textStyleDiff.ui.updates.map((update) => update.id), + containsAll(['text_plain_title', 'text_style_badge']), + ); + + final buttonSelectDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_buttons', + handler: 'select_example', + ), + ); + expect( + buttonSelectDiff.ui.updates.map((update) => update.id), + containsAll(['button_primary', 'button_state_text']), + ); + + final buttonToggleDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_2', + handler: 'demo_button_toggle', + ), + ); + expect( + buttonToggleDiff.ui.updates.map((update) => update.id), + containsAll(['button_primary', 'button_state_text']), + ); + + final spriteDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_1', + handler: 'demo_sprite_anim', + ), + ); + expect(spriteDiff.commands.single.type, RuntimeCommandType.parallel); + + final radioSelectDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_radio_group', + handler: 'select_example', + ), + ); + expect( + radioSelectDiff.ui.updates.map((update) => update.id), + containsAll(['radio_audio_dot', 'radio_value_text']), + ); + + final radioDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_2', + handler: 'demo_radio_spine', + ), + ); + expect( + radioDiff.ui.updates.map((update) => update.id), + containsAll(['radio_spine_dot', 'radio_value_text']), + ); + + final listSelectDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_list_view', + handler: 'select_example', + ), + ); + expect( + listSelectDiff.ui.updates.map((update) => update.id), + containsAll(['list_row_1', 'list_value_text']), + ); + + final listDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_2', + handler: 'demo_list_next', + ), + ); + expect( + listDiff.ui.updates.map((update) => update.id), + containsAll(['list_row_1', 'list_row_2', 'list_value_text']), + ); + + final layoutDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_2', + handler: 'demo_layout_column', + ), + ); + expect( + layoutDiff.ui.updates.map((update) => update.id), + containsAll(['layout_chip_1', 'layout_chip_2', 'layout_label']), + ); + + final i18nDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'example_i18n', + handler: 'select_example', + ), + ); + expect( + i18nDiff.ui.updates + .singleWhere((update) => update.id == 'detail_title') + .props['text'], + 'Lua 多语言 Showcase', + ); + + final localeDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_1', + handler: 'demo_i18n_toggle', + ), + ); + expect( + localeDiff.ui.updates + .singleWhere((update) => update.id == 'detail_title') + .props['text'], + 'Lua-owned localization', + ); + expect(localeDiff.commands.single.type, RuntimeCommandType.toast); + + final responsiveDiff = engine.dispatchEvent( + const RuntimeEvent( + type: RuntimeEventType.tap, + target: 'detail_action_1', + handler: 'demo_responsive_phone', + ), + ); + expect( + responsiveDiff.ui.updates.map((update) => update.id), + containsAll(['responsive_info', 'responsive_device']), + ); + }); + + test( + 'loads manifest-declared modules and caches returned values', + () async { + final package = await _createPackage( + mainScript: ''' +local theme_a = runtime.import("theme") +local theme_b = runtime.import("theme") + +function smoke_test(ctx) + return theme_a == theme_b and load_count == 1 +end + +function init(ctx) + return { + ui = { + creates = { + { id = "title", type = "text", text = theme_a.title } + } + } + } +end + +function on_event(event) + return {} +end +''', + modules: { + 'theme': ''' +load_count = (load_count or 0) + 1 +return { title = "Imported Theme" } +''', + }, + ); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({'runtimeApiVersion': 1}); + expect(diff.ui.creates.single.text, 'Imported Theme'); + }, + ); + + test('runtime_ui supports table-style component options', () async { + final runtimeUi = File( + 'assets/runtime/lua/runtime_ui.lua', + ).readAsStringSync(); + final package = await _createPackage( + mainScript: ''' +local ui = runtime.import("runtime_ui") + +function smoke_test(ctx) + return ui.rect ~= nil and ui.button ~= nil +end + +function init(ctx) + return { + ui = { + creates = { + ui.rect("card", { x = 10, y = 20, w = 120, h = 44, radius = 8 }), + ui.circle("dot", { x = 5, y = 6, size = 18, color = "#ffffffff" }), + ui.button("ok", { text = "OK", x = 1, y = 2, w = 60, h = 24, handler = "submit", asset = "button_normal", pressedAsset = "button_pressed", disabledAsset = "button_disabled" }) + }, + updates = { + ui.update("card", { w = 140, h = 48, onClick = "tap_card" }) + } + } + } +end + +function on_event(event) + return {} +end +''', + modules: {'runtime_ui': runtimeUi}, + ); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({'runtimeApiVersion': 1}); + final card = diff.ui.creates.singleWhere((node) => node.id == 'card'); + expect(card.width, 120); + expect(card.height, 44); + final dot = diff.ui.creates.singleWhere((node) => node.id == 'dot'); + expect(dot.width, 18); + expect(dot.height, 18); + final button = diff.ui.creates.singleWhere((node) => node.id == 'ok'); + expect(button.onTap, 'submit'); + expect(button.width, 60); + expect(button.asset, 'button_normal'); + expect(button.pressedAsset, 'button_pressed'); + expect(button.disabledAsset, 'button_disabled'); + final update = diff.ui.updates.single; + expect(update.props, containsPair('width', 140)); + expect(update.props, containsPair('height', 48)); + expect(update.props, containsPair('onTap', 'tap_card')); + expect(update.props.containsKey('w'), isFalse); + expect(update.props.containsKey('h'), isFalse); + expect(update.props.containsKey('onClick'), isFalse); + }); + + test('runtime_widgets exposes common lightweight components', () async { + final runtimeUi = File( + 'assets/runtime/lua/runtime_ui.lua', + ).readAsStringSync(); + final runtimeWidgets = File( + 'assets/runtime/lua/runtime_widgets.lua', + ).readAsStringSync(); + final package = await _createPackage( + mainScript: ''' +local widgets = runtime.import("runtime_widgets") + +widgets.configure({ + primary = "#ff010203", + secondary = "#ff040506", + surface = "#ff070809", + surfaceAlt = "#ff0a0b0c", + text = "#ff0d0e0f", + muted = "#ff101112", + transparent = "#00000000" +}) + +function smoke_test(ctx) + return widgets.label ~= nil and widgets.pill ~= nil and widgets.text_button ~= nil and widgets.tabs ~= nil and widgets.list_item ~= nil and widgets.action_row ~= nil and widgets.panel_header ~= nil +end + +function init(ctx) + local pill = widgets.pill("status", { + text = "Ready", + x = 10, + y = 20, + w = 72, + h = 24, + color = "#ff000000", + textStyle = { color = "#ffffffff" } + }) + local tabs = widgets.tabs("tabs", { + { key = "code", text = "Code", handler = "show_code" }, + { key = "params", text = "Params", handler = "show_params" } + }, { + x = 8, + y = 86, + itemWidth = 70, + itemHeight = 22, + selected = "params", + parent = "toolbar", + layer = 9 + }) + local actions = widgets.action_row("actions", { + { text = "Run", handler = "run" }, + { text = "Stop", handler = "stop", visible = false } + }, { + x = 10, + y = 142, + width = 170, + itemHeight = 24, + gap = 10, + layer = 7 + }) + local header = widgets.panel_header("header", { + eyebrow = "Runtime", + title = "Panel", + summary = "Composable header", + x = 6, + y = 172, + w = 180, + parent = "card", + layer = 6 + }) + return { + ui = { + creates = { + widgets.section_title("title", { text = "Overview", x = 4, y = 6, w = 160, h = 28 }), + pill[1], + pill[2], + widgets.text_button("more", { text = "More", x = 10, y = 52, w = 80, h = 28, handler = "open", variant = "ghost" }), + widgets.list_item("row", { text = "Row", x = 10, y = 112, w = 100, h = 24, handler = "select_row", selected = true }), + tabs[1], + tabs[2], + actions[1], + actions[2], + header[1], + header[2], + header[3] + } + } + } +end + +function on_event(event) + return {} +end +''', + modules: {'runtime_ui': runtimeUi, 'runtime_widgets': runtimeWidgets}, + ); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + expect(engine.smokeTest({'runtimeApiVersion': 1}), isTrue); + final diff = engine.init({'runtimeApiVersion': 1}); + expect( + diff.ui.creates.map((node) => node.id), + containsAll([ + 'title', + 'status', + 'status_text', + 'more', + 'row', + 'tabs_code', + 'tabs_params', + 'actions_1', + 'actions_2', + 'header_eyebrow', + 'header_title', + 'header_summary', + ]), + ); + final title = diff.ui.creates.singleWhere((node) => node.id == 'title'); + expect(title.fontSize, 18); + final pillText = diff.ui.creates.singleWhere( + (node) => node.id == 'status_text', + ); + expect(pillText.parent, 'status'); + final more = diff.ui.creates.singleWhere((node) => node.id == 'more'); + expect(more.onTap, 'open'); + expect(more.color?.toARGB32(), 0x00000000); + final row = diff.ui.creates.singleWhere((node) => node.id == 'row'); + expect(row.onTap, 'select_row'); + expect(row.color?.toARGB32(), 0xff010203); + final codeTab = diff.ui.creates.singleWhere( + (node) => node.id == 'tabs_code', + ); + expect(codeTab.parent, 'toolbar'); + expect(codeTab.x, 8); + expect(codeTab.y, 86); + expect(codeTab.onTap, 'show_code'); + expect(codeTab.color?.toARGB32(), 0xff070809); + final paramsTab = diff.ui.creates.singleWhere( + (node) => node.id == 'tabs_params', + ); + expect(paramsTab.x, 84); + expect(paramsTab.onTap, 'show_params'); + expect(paramsTab.color?.toARGB32(), 0xff010203); + final action1 = diff.ui.creates.singleWhere( + (node) => node.id == 'actions_1', + ); + final action2 = diff.ui.creates.singleWhere( + (node) => node.id == 'actions_2', + ); + expect(action1.width, 80); + expect(action1.onTap, 'run'); + expect(action1.layer, 7); + expect(action2.visible, isFalse); + expect(action2.onTap, 'noop'); + final eyebrow = diff.ui.creates.singleWhere( + (node) => node.id == 'header_eyebrow', + ); + final headerTitle = diff.ui.creates.singleWhere( + (node) => node.id == 'header_title', + ); + final summary = diff.ui.creates.singleWhere( + (node) => node.id == 'header_summary', + ); + expect(eyebrow.parent, 'card'); + expect(eyebrow.y, 172); + expect(headerTitle.y, 196); + expect(summary.y, 228); + }); + + test('layout supports spacing and grid aliases', () async { + final runtimeUi = File( + 'assets/runtime/lua/runtime_ui.lua', + ).readAsStringSync(); + final layout = File('assets/runtime/lua/layout.lua').readAsStringSync(); + final package = await _createPackage( + mainScript: ''' +local ui = runtime.import("runtime_ui") +local layout = runtime.import("layout") + +function smoke_test(ctx) + return layout.box ~= nil and layout.item ~= nil +end + +function init(ctx) + local nodes = layout.box("panel", { + layout.item(ui.rect("a", { w = 20, h = 10 }), { mx = 2, my = 1 }), + ui.rect("b", { w = 20, h = 10 }), + ui.rect("c", { w = 20, h = 10 }) + }, { + x = 10, + y = 20, + cols = 2, + cellW = 30, + cellH = 20, + gap = 5, + padding = 3, + align = "center", + valign = "center" + }) + return { ui = { creates = nodes } } +end + +function on_event(event) + return {} +end +''', + modules: {'runtime_ui': runtimeUi, 'layout': layout}, + ); + final engine = LuaDardoScriptEngine(); + + await engine.loadPackage(package); + + final diff = engine.init({'runtimeApiVersion': 1}); + final a = diff.ui.creates.singleWhere((node) => node.id == 'a'); + final b = diff.ui.creates.singleWhere((node) => node.id == 'b'); + final c = diff.ui.creates.singleWhere((node) => node.id == 'c'); + expect(a.parent, 'panel'); + expect(a.x, 18); + expect(a.y, 28); + expect(b.x, 53); + expect(b.y, 28); + expect(c.x, 18); + expect(c.y, 53); + }); + + test('rejects undeclared module imports', () async { + final package = await _createPackage( + mainScript: ''' +runtime.import("missing") +function smoke_test(ctx) return true end +function init(ctx) return {} end +function on_event(event) return {} end +''', + ); + final engine = LuaDardoScriptEngine(); + + await expectLater(engine.loadPackage(package), throwsStateError); + }); + + test('rejects unsafe module names', () async { + final package = await _createPackage( + mainScript: ''' +runtime.import("../theme") +function smoke_test(ctx) return true end +function init(ctx) return {} end +function on_event(event) return {} end +''', + modules: {'theme': 'return {}'}, + ); + final engine = LuaDardoScriptEngine(); + + await expectLater(engine.loadPackage(package), throwsStateError); + }); + }); +} + +Future _createPackage({ + required String mainScript, + Map modules = const {}, +}) async { + final root = await Directory.systemTemp.createTemp('lua_engine_test_'); + Directory('${root.path}/scripts').createSync(recursive: true); + File('${root.path}/scripts/main.lua').writeAsStringSync(mainScript); + + final manifestModules = {}; + for (final entry in modules.entries) { + final path = 'scripts/${entry.key}.lua'; + File('${root.path}/$path').writeAsStringSync(entry.value); + manifestModules[entry.key] = path; + } + + addTearDown(() { + if (root.existsSync()) { + root.deleteSync(recursive: true); + } + }); + + return GamePackage.file( + rootPath: root.path, + manifest: GamePackageManifest( + gameId: 'test', + name: 'Test', + version: '0.1.0', + runtimeApiVersion: 1, + entry: 'scripts/main.lua', + assetsBase: 'assets', + modules: manifestModules, + ), + ); +} diff --git a/tool/generate_lua_runtime_defs.dart b/tool/generate_lua_runtime_defs.dart new file mode 100644 index 0000000..1f49913 --- /dev/null +++ b/tool/generate_lua_runtime_defs.dart @@ -0,0 +1,93 @@ +import 'dart:io'; + +const _commonPath = 'tool/lua_runtime_defs_common.lua'; +const _runtimeMarker = 'runtime = runtime'; +const _gamesRoot = 'assets/games'; + +void main(List args) { + final checkOnly = args.contains('--check'); + final commonFile = File(_commonPath); + if (!commonFile.existsSync()) { + stderr.writeln('Missing common Lua runtime defs template: $_commonPath'); + exitCode = 1; + return; + } + + final common = _normalizeCommon(commonFile.readAsStringSync()); + var changed = false; + final targets = _runtimeDefTargets(); + if (targets.isEmpty) { + stderr.writeln('No Lua runtime defs targets found under $_gamesRoot'); + exitCode = 1; + return; + } + + for (final target in targets) { + final targetPath = target.path; + final current = target.existsSync() ? target.readAsStringSync() : ''; + final suffix = current.isEmpty + ? '' + : _gameSpecificSuffix(current, targetPath); + final generated = suffix.isEmpty ? common : '$common\n$suffix'; + + if (current == generated) { + stdout.writeln('up to date: $targetPath'); + continue; + } + + changed = true; + if (checkOnly) { + stderr.writeln('out of date: $targetPath'); + } else { + target.writeAsStringSync(generated); + stdout.writeln('generated: $targetPath'); + } + } + + if (checkOnly && changed) { + stderr.writeln( + 'Lua runtime defs are out of date. Run: dart run tool/generate_lua_runtime_defs.dart', + ); + exitCode = 1; + } +} + +List _runtimeDefTargets() { + final root = Directory(_gamesRoot); + if (!root.existsSync()) { + return const []; + } + final targets = []; + for (final entity in root.listSync()) { + if (entity is! Directory) { + continue; + } + final scripts = Directory('${entity.path}/scripts'); + if (!scripts.existsSync()) { + continue; + } + targets.add(File('${scripts.path}/runtime_defs.lua')); + } + targets.sort((a, b) => a.path.compareTo(b.path)); + return targets; +} + +String _normalizeCommon(String source) { + final text = source.replaceAll('\r\n', '\n').trimRight(); + if (!text.contains(_runtimeMarker)) { + throw const FormatException( + 'Common template must contain runtime = runtime', + ); + } + return '$text\n'; +} + +String _gameSpecificSuffix(String source, String targetPath) { + final text = source.replaceAll('\r\n', '\n'); + final index = text.indexOf(_runtimeMarker); + if (index < 0) { + throw FormatException('$targetPath must contain $_runtimeMarker'); + } + final suffixStart = index + _runtimeMarker.length; + return text.substring(suffixStart).trimLeft(); +} diff --git a/tool/lua_runtime_defs_common.lua b/tool/lua_runtime_defs_common.lua new file mode 100644 index 0000000..c5038c9 --- /dev/null +++ b/tool/lua_runtime_defs_common.lua @@ -0,0 +1,557 @@ +---@meta +--- COMMON RUNTIME TYPES SECTION. +--- Source of truth: tool/lua_runtime_defs_common.lua +--- After editing this common section, run: +--- dart run tool/generate_lua_runtime_defs.dart + + +---@alias RuntimeNodeType +---| 'panel' +---| 'button' +---| 'text' +---| 'circle' +---| 'rect' +---| 'line' +---| 'progress' +---| 'listView' +---| 'sprite' +---| 'image' +---| 'spine' +---| 'particle' + +---@alias RuntimeAnchor +---| 'center' +---| 'topLeft' +---| 'topRight' +---| 'bottomLeft' +---| 'bottomRight' + +---@alias RuntimeTextAlign +---| 'left' +---| 'center' +---| 'right' + +---@alias RuntimeParticlePreset +---| 'burst' +---| 'trail' +---| 'snow' +---| 'confetti' + +---@alias RuntimeCommandType +---| 'move_path' +---| 'move_to' +---| 'fade_to' +---| 'scale_to' +---| 'rotate_to' +---| 'remove_node' +---| 'sequence' +---| 'parallel' +---| 'delay' +---| 'toast' +---| 'play_sound' +---| 'play_bgm' +---| 'pause_bgm' +---| 'resume_bgm' +---| 'stop_bgm' +---| 'preload_resources' +---| 'evict_resources' +---| 'cancel_commands' +---| 'play_spine_animation' +---| 'copy_text' + +---@alias RuntimeEventType +---| 'tap' +---| 'animation_done' +---| 'resize' +---| 'scroll' + +---@alias RuntimeScaleMode +---| 'fit' +---| 'fill' +---| 'stretch' +---| 'none' + +---@alias RuntimeLayoutAlign +---| 'start' +---| 'center' +---| 'end' + +---@alias RuntimeButtonVariant +---| 'primary' +---| 'secondary' +---| 'ghost' + +---@class (exact) RuntimeNode +---@field id string +---@field type RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---@class (exact) RuntimeNodeProps +---@field type? RuntimeNodeType +---@field parent? string +---@field asset? string Normal image/sprite/spine asset key. For button nodes this is the normal-state image. +---@field pressedAsset? string Button pressed-state image asset key. +---@field disabledAsset? string Button disabled-state image asset key. +---@field animation? string +---@field skin? string +---@field loop? boolean +---@field text? string +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field paddingLeft? number +---@field paddingTop? number +---@field paddingRight? number +---@field paddingBottom? number +---@field anchor? RuntimeAnchor +---@field layer? integer +---@field visible? boolean +---@field alpha? number +---@field scale? number +---@field rotation? number +---@field color? string +---@field fontSize? number +---@field textAlign? RuntimeTextAlign +---@field radius? number +---@field strokeWidth? number +---@field value? number +---@field scrollX? number +---@field scrollY? number +---@field contentWidth? number +---@field contentHeight? number +---@field virtualized? boolean +---@field cacheExtent? number +---@field inertia? boolean +---@field scrollbarThumbColor? string +---@field scrollbarTrackColor? string +---@field scrollbarThickness? number +---@field scrollbarVisible? boolean +---@field interactive? boolean +---@field onTap? string +---@field onScroll? string +---@field preset? RuntimeParticlePreset +---@field count? integer +---@field duration? number +---@field speedMin? number +---@field speedMax? number +---@field gravityX? number +---@field gravityY? number +---@field spread? number +---@field colorTo? string +---@field radiusTo? number +---@field autoRemove? boolean +---@field fadeOut? boolean + +---Helper-only fields accepted by runtime_ui/runtime_widgets. They are normalized +---before the node/update crosses the Dart Runtime protocol boundary. +---@class RuntimeNodeInit: RuntimeNodeProps +---@field w? number Alias for width. +---@field h? number Alias for height. +---@field size? number Alias for both width and height. +---@field handler? string Alias for onTap. +---@field onClick? string Alias for onTap. + +---@class (exact) RuntimeNodeUpdate +---@field id string +---@field props RuntimeNodeProps + +---@class (exact) RuntimeNodeRemove +---@field id string + +---@class (exact) RuntimeDiffSection +---@field creates? RuntimeNode[] +---@field updates? RuntimeNodeUpdate[] +---@field removes? (string|RuntimeNodeRemove)[] + +---@class (exact) RuntimeDiff +---@field render? RuntimeDiffSection +---@field ui? RuntimeDiffSection +---@field commands? RuntimeCommand[] + +---@class (exact) RuntimeEvent +---@field type RuntimeEventType|string +---@field target? string +---@field handler? string +---@field x? number +---@field y? number +---@field data? table + +---@class (exact) RuntimeCommand +---@field type RuntimeCommandType +---@field target? string +---@field scope? string +---@field id? string +---@field group? string +---@field commandGroup? string +---@field onComplete? string +---@field duration? number +---@field commands? RuntimeCommand[] +---@field path? RuntimePoint[] +---@field x? number +---@field y? number +---@field alpha? number +---@field scale? number +---@field angle? number +---@field text? string +---@field message? string +---@field asset? string +---@field name? string +---@field volume? number +---@field channel? string +---@field loop? boolean +---@field failOnError? boolean +---@field animation? string +---@field track? integer +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeCommandOpts +---@field id? string +---@field group? string +---@field commandGroup? string +---@field scope? string +---@field onComplete? string +---@field duration? number + +---@class (exact) RuntimeAudioCommandOpts: RuntimeCommandOpts +---@field volume? number +---@field name? string + +---@class (exact) RuntimeBgmCommandOpts: RuntimeAudioCommandOpts +---@field channel? string +---@field loop? boolean + +---@class (exact) RuntimeSpineCommandOpts: RuntimeCommandOpts +---@field track? integer +---@field loop? boolean +---@field queue? boolean +---@field delay? number + +---@class (exact) RuntimeResourceCommandOpts: RuntimeCommandOpts +---@field failOnError? boolean + +---@class (exact) RuntimePoint +---@field x number +---@field y number + +---@class (exact) RuntimeLocaleContext +---@field requested string +---@field resolved string +---@field default string +---@field supported string[] +---@field languageCode string +---@field scriptCode? string +---@field countryCode? string + +---@class (exact) RuntimeScreenContext +---@field width number +---@field height number + +---@class (exact) RuntimeDesignContext +---@field width number +---@field height number + +---@class (exact) RuntimeViewportContext +---@field x number +---@field y number +---@field width number +---@field height number +---@field scaleX number +---@field scaleY number +---@field scaleMode RuntimeScaleMode|string + +---@class (exact) RuntimeContext +---@field screen RuntimeScreenContext +---@field design RuntimeDesignContext +---@field viewport RuntimeViewportContext +---@field seed integer +---@field runtimeApiVersion integer +---@field gameId string +---@field gameVersion string +---@field locale? RuntimeLocaleContext + +---@class RuntimeUi +---@field style fun(base?: RuntimeNodeProps, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field with_parent fun(parent: string, opts?: RuntimeNodeProps): RuntimeNodeProps +---@field node fun(node_type: RuntimeNodeType, id: string, opts?: RuntimeNodeInit): RuntimeNode +---@field panel fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field rect fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field circle fun(id: string, x: number|RuntimeNodeInit, y?: number, size?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field line fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field particle fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field text fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field button fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field list_view fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field image fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field sprite fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field spine fun(id: string, asset: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, animation?: string, opts?: RuntimeNodeInit): RuntimeNode +---@field update fun(id: string, props: RuntimeNodeInit): RuntimeNodeUpdate +---@field text_update fun(id: string, text: string): RuntimeNodeUpdate +---@field visible_update fun(id: string, visible: boolean): RuntimeNodeUpdate +---@field alpha_update fun(id: string, alpha: number): RuntimeNodeUpdate +---@field scale_update fun(id: string, scale: number): RuntimeNodeUpdate +---@field position_update fun(id: string, x: number, y: number): RuntimeNodeUpdate +---@field size_update fun(id: string, width: number, height: number): RuntimeNodeUpdate +---@field transform_update fun(id: string, x: number, y: number, scale: number, rotation: number): RuntimeNodeUpdate +---@field batch_update fun(ids: string[], props: RuntimeNodeInit): RuntimeNodeUpdate[] +---@field append fun(nodes: RuntimeNode[], node: RuntimeNode): RuntimeNode[] +---@field append_all fun(nodes: RuntimeNode[], extra_nodes: RuntimeNode[]): RuntimeNode[] + +---@class (exact) RuntimeDialogButton +---@field id? string +---@field text string +---@field handler string +---@field color? string + +---@class (exact) RuntimeDialogOpts +---@field screenWidth? number +---@field screenHeight? number +---@field overlay? boolean +---@field overlayColor? string +---@field blockInput? boolean +---@field layer? integer +---@field color? string +---@field radius? number +---@field panelStyle? RuntimeNodeProps +---@field titleColor? string +---@field titleSize? number +---@field titleStyle? RuntimeNodeProps +---@field messageColor? string +---@field messageSize? number +---@field messageStyle? RuntimeNodeProps +---@field buttons? RuntimeDialogButton[] +---@field buttonGap? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeLabeledProgressOpts: RuntimeNodeInit +---@field labelHeight? number +---@field labelStyle? RuntimeNodeProps + +---@class RuntimePillOpts: RuntimeNodeInit +---@field panelStyle? RuntimeNodeProps +---@field textStyle? RuntimeNodeProps + +---@class RuntimeTextButtonOpts: RuntimeNodeInit +---@field variant? RuntimeButtonVariant + +---@class RuntimeListItemOpts: RuntimeTextButtonOpts +---@field selected? boolean +---@field activeColor? string +---@field inactiveColor? string + +---@class RuntimeTabItem +---@field id? string +---@field key? string +---@field text string +---@field handler? string +---@field selected? boolean + +---@class RuntimeTabsOpts: RuntimeNodeInit +---@field tabs? RuntimeTabItem[] +---@field selected? string +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field activeColor? string +---@field inactiveColor? string +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimeActionItem +---@field id? string +---@field text string +---@field handler? string +---@field visible? boolean +---@field color? string +---@field style? RuntimeNodeProps + +---@class RuntimeActionRowOpts: RuntimeNodeInit +---@field actions? RuntimeActionItem[] +---@field gap? number +---@field itemWidth? number +---@field itemHeight? number +---@field buttonStyle? RuntimeNodeProps + +---@class RuntimePanelHeaderOpts: RuntimeNodeInit +---@field eyebrow? string +---@field title string +---@field summary? string +---@field gap? number +---@field eyebrowId? string +---@field titleId? string +---@field summaryId? string +---@field eyebrowHeight? number +---@field titleHeight? number +---@field summaryHeight? number +---@field eyebrowStyle? RuntimeNodeProps +---@field titleStyle? RuntimeNodeProps +---@field summaryStyle? RuntimeNodeProps + +---@class RuntimeWidgetTheme +---@field primary? string +---@field secondary? string +---@field success? string +---@field overlay? string +---@field surface? string +---@field surfaceAlt? string +---@field card? string +---@field text? string +---@field muted? string +---@field progress? string +---@field transparent? string + +---@class RuntimeWidgets +---@field configure fun(tokens?: RuntimeWidgetTheme): RuntimeWidgets +---@field label fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field section_title fun(id: string, text: string|RuntimeNodeInit, x?: number, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field pill fun(id: string, text: string|RuntimePillOpts, x?: number, y?: number, width?: number, height?: number, opts?: RuntimePillOpts): RuntimeNode[] +---@field text_button fun(id: string, text: string|RuntimeTextButtonOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeTextButtonOpts): RuntimeNode +---@field list_item fun(id: string, text: string|RuntimeListItemOpts, x?: number, y?: number, width?: number, height?: number, handler?: string, opts?: RuntimeListItemOpts): RuntimeNode +---@field tabs fun(id: string, tabs: RuntimeTabItem[]|RuntimeTabsOpts, opts?: RuntimeTabsOpts): RuntimeNode[] +---@field action_row fun(id: string, actions: RuntimeActionItem[]|RuntimeActionRowOpts, opts?: RuntimeActionRowOpts): RuntimeNode[] +---@field panel_header fun(id: string, opts: RuntimePanelHeaderOpts): RuntimeNode[] +---@field overlay fun(id: string, width: number|RuntimeNodeInit, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field card fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field progress_bar fun(id: string, x: number|RuntimeNodeInit, y?: number, width?: number, height?: number, value?: number, opts?: RuntimeNodeInit): RuntimeNode +---@field labeled_progress fun(id: string, label: string, x: number, y: number, width: number, height: number, value: number, opts?: RuntimeLabeledProgressOpts): RuntimeNode[] +---@field button_row fun(parent: string, id: string, buttons: RuntimeDialogButton[], x: number, y: number, width: number, height: number, gap?: number, opts?: RuntimeNodeProps): RuntimeNode[] +---@field dialog fun(id: string, title: string, message: string, x: number, y: number, width: number, height: number, opts?: RuntimeDialogOpts): RuntimeNode[] + +---@class (exact) RuntimeLayoutItem +---@field node RuntimeNode +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLayoutItemOpts +---@field margin? number +---@field mx? number +---@field my? number +---@field ml? number +---@field mr? number +---@field mt? number +---@field mb? number +---@field marginLeft? number +---@field marginRight? number +---@field marginTop? number +---@field marginBottom? number + +---@class RuntimeLinearLayoutOpts +---@field x? number +---@field y? number +---@field width? number +---@field height? number +---@field gap? number +---@field align? RuntimeLayoutAlign +---@field padding? number +---@field paddingX? number +---@field paddingY? number +---@field px? number +---@field py? number +---@field paddingLeft? number +---@field paddingTop? number + +---@class RuntimeBoxLayoutOpts: RuntimeLinearLayoutOpts +---@field rows? integer +---@field columns? integer +---@field cols? integer +---@field cellWidth? number +---@field cellHeight? number +---@field cellW? number +---@field cellH? number +---@field gapX? number +---@field gapY? number +---@field valign? RuntimeLayoutAlign + +---@class RuntimeLayout +---@field item fun(node: RuntimeNode, opts?: RuntimeLayoutItemOpts): RuntimeLayoutItem +---@field local_position fun(origin: RuntimePoint, position: RuntimePoint): RuntimePoint +---@field row fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field column fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field stack fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeLinearLayoutOpts): RuntimeNode[] +---@field box fun(parent?: string, items: (RuntimeNode|RuntimeLayoutItem)[], opts?: RuntimeBoxLayoutOpts): RuntimeNode[] + +---@class RuntimeCommands +---@field toast fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field copy_text fun(text: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field delay fun(duration: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field sequence fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field parallel fun(items: RuntimeCommand[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_path fun(target: string, path: RuntimePoint[], opts?: RuntimeCommandOpts): RuntimeCommand +---@field move_to fun(target: string, x: number, y: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field fade_to fun(target: string, alpha: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field scale_to fun(target: string, scale: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field rotate_to fun(target: string, angle: number, opts?: RuntimeCommandOpts): RuntimeCommand +---@field remove_node fun(target: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field play_spine_animation fun(target: string, animation: string, opts?: RuntimeSpineCommandOpts): RuntimeCommand +---@field play_sound fun(asset: string, opts?: RuntimeAudioCommandOpts): RuntimeCommand +---@field play_bgm fun(asset: string, opts?: RuntimeBgmCommandOpts): RuntimeCommand +---@field pause_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field resume_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field stop_bgm fun(channel?: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field preload_group fun(group: string, opts?: RuntimeResourceCommandOpts): RuntimeCommand +---@field evict_group fun(group: string, opts?: RuntimeCommandOpts): RuntimeCommand +---@field cancel_id fun(id: string): RuntimeCommand +---@field cancel_group fun(group: string): RuntimeCommand +---@field cancel_scope fun(scope: string): RuntimeCommand + +---@class RuntimeImportApi +---@field import fun(moduleName: string): table + +---@type RuntimeImportApi +runtime = runtime