@playcraft/skills 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (479) hide show
  1. package/README.md +333 -0
  2. package/dist/src/index.d.ts +3 -0
  3. package/dist/src/index.d.ts.map +1 -0
  4. package/dist/src/index.js +2 -0
  5. package/dist/src/index.js.map +1 -0
  6. package/dist/src/skills.loader.d.ts +31 -0
  7. package/dist/src/skills.loader.d.ts.map +1 -0
  8. package/dist/src/skills.loader.js +200 -0
  9. package/dist/src/skills.loader.js.map +1 -0
  10. package/dist/src/skills.types.d.ts +44 -0
  11. package/dist/src/skills.types.d.ts.map +1 -0
  12. package/dist/src/skills.types.js +9 -0
  13. package/dist/src/skills.types.js.map +1 -0
  14. package/package.json +35 -0
  15. package/skills/2048_core.aigameplay/SKILL.md +123 -0
  16. package/skills/2048_core.aigameplay/manifest.json +159 -0
  17. package/skills/2048_core.aigameplay/ref/pgs-schema.json +194 -0
  18. package/skills/2048_core.aigameplay/ref/reducer.template.ts +189 -0
  19. package/skills/SKILL.md +46 -0
  20. package/skills/ad_compliance_rules.aiconfig/SKILL.md +85 -0
  21. package/skills/ad_compliance_rules.aiconfig/manifest.json +60 -0
  22. package/skills/agent_remix_orchestrator.aicomponent/SKILL.md +257 -0
  23. package/skills/agent_remix_orchestrator.aicomponent/manifest.json +12 -0
  24. package/skills/app_metadata.aiconfig/SKILL.md +53 -0
  25. package/skills/app_metadata.aiconfig/manifest.json +32 -0
  26. package/skills/appear_sfx.aiaudio/SKILL.md +59 -0
  27. package/skills/appear_sfx.aiaudio/manifest.json +45 -0
  28. package/skills/appear_sfx.aiaudio/ref/appear.mp3 +0 -0
  29. package/skills/arrow_move_error_sfx.aiaudio/SKILL.md +59 -0
  30. package/skills/arrow_move_error_sfx.aiaudio/manifest.json +45 -0
  31. package/skills/arrow_move_error_sfx.aiaudio/ref/arrow_move_error.mp3 +0 -0
  32. package/skills/arrow_path_data_format.aicomponent/SKILL.md +152 -0
  33. package/skills/arrow_path_data_format.aicomponent/manifest.json +57 -0
  34. package/skills/arrow_path_data_format.aicomponent/ref/LevelParser.ts +188 -0
  35. package/skills/arrow_path_data_format.aicomponent/ref/LevelTypes.ts +131 -0
  36. package/skills/arrow_pick_match_rules.aigameplay/SKILL.md +117 -0
  37. package/skills/arrow_pick_match_rules.aigameplay/manifest.json +105 -0
  38. package/skills/arrow_pick_match_rules.aigameplay/ref/pgs-schema.json +180 -0
  39. package/skills/asset_pipeline_scripts.aicomponent/SKILL.md +117 -0
  40. package/skills/asset_pipeline_scripts.aicomponent/manifest.json +17 -0
  41. package/skills/asset_pipeline_scripts.aicomponent/ref/gen-sprite.sh +105 -0
  42. package/skills/ball_sort.aigameplay/SKILL.md +109 -0
  43. package/skills/ball_sort.aigameplay/manifest.json +155 -0
  44. package/skills/ball_sort.aigameplay/ref/pgs-schema.json +192 -0
  45. package/skills/ball_sort.aigameplay/ref/reducer.template.ts +156 -0
  46. package/skills/basketball_shot.aigameplay/SKILL.md +94 -0
  47. package/skills/basketball_shot.aigameplay/manifest.json +150 -0
  48. package/skills/basketball_shot.aigameplay/ref/pgs-schema.json +229 -0
  49. package/skills/basketball_shot.aigameplay/ref/reducer.template.ts +189 -0
  50. package/skills/bg_music.aiaudio/SKILL.md +61 -0
  51. package/skills/bg_music.aiaudio/manifest.json +48 -0
  52. package/skills/bg_music.aiaudio/ref/bg.mp3 +0 -0
  53. package/skills/big_watermelon.aigameplay/SKILL.md +94 -0
  54. package/skills/big_watermelon.aigameplay/manifest.json +155 -0
  55. package/skills/big_watermelon.aigameplay/ref/pgs-schema.json +191 -0
  56. package/skills/big_watermelon.aigameplay/ref/reducer.template.ts +202 -0
  57. package/skills/block_puzzle.aigameplay/SKILL.md +121 -0
  58. package/skills/block_puzzle.aigameplay/manifest.json +154 -0
  59. package/skills/block_puzzle.aigameplay/ref/pgs-schema.json +170 -0
  60. package/skills/block_puzzle.aigameplay/ref/reducer.template.ts +182 -0
  61. package/skills/board_entity_sprite.aiimage/SKILL.md +255 -0
  62. package/skills/board_entity_sprite.aiimage/manifest.json +153 -0
  63. package/skills/board_entity_sprite.aiimage/ref/ProceduralCar.ts +357 -0
  64. package/skills/board_entity_sprite.aiimage/ref/car.png +0 -0
  65. package/skills/board_entity_sprite.aiimage/ref/car.webp +0 -0
  66. package/skills/bottom_ui_bar.aicomponent/SKILL.md +50 -0
  67. package/skills/bottom_ui_bar.aicomponent/manifest.json +31 -0
  68. package/skills/bottom_ui_bar.aicomponent/ref/GameBottomUI.ts +27 -0
  69. package/skills/bubble_shooter.aigameplay/SKILL.md +129 -0
  70. package/skills/bubble_shooter.aigameplay/manifest.json +181 -0
  71. package/skills/bubble_shooter.aigameplay/ref/pgs-schema.json +226 -0
  72. package/skills/bubble_shooter.aigameplay/ref/reducer.template.ts +228 -0
  73. package/skills/button_click_sfx.aiaudio/SKILL.md +59 -0
  74. package/skills/button_click_sfx.aiaudio/manifest.json +45 -0
  75. package/skills/button_click_sfx.aiaudio/ref/button_click.mp3 +0 -0
  76. package/skills/calm_piano.aiaudio/SKILL.md +68 -0
  77. package/skills/calm_piano.aiaudio/manifest.json +50 -0
  78. package/skills/camera_controller_3d.aicomponent/SKILL.md +100 -0
  79. package/skills/camera_controller_3d.aicomponent/manifest.json +52 -0
  80. package/skills/camera_controller_3d.aicomponent/ref/CameraController.ts +199 -0
  81. package/skills/camera_controller_3d.aicomponent/ref/OrbitControlsAdapter.ts +152 -0
  82. package/skills/candy_tile.aiimage/SKILL.md +62 -0
  83. package/skills/candy_tile.aiimage/manifest.json +49 -0
  84. package/skills/car_parking.aigameplay/SKILL.md +105 -0
  85. package/skills/car_parking.aigameplay/manifest.json +164 -0
  86. package/skills/car_parking.aigameplay/ref/pgs-schema.json +163 -0
  87. package/skills/car_parking.aigameplay/ref/reducer.template.ts +166 -0
  88. package/skills/castle.aiimage/SKILL.md +64 -0
  89. package/skills/castle.aiimage/manifest.json +48 -0
  90. package/skills/cheerful_ukulele.aiaudio/SKILL.md +72 -0
  91. package/skills/cheerful_ukulele.aiaudio/manifest.json +50 -0
  92. package/skills/click_sfx.aiaudio/SKILL.md +59 -0
  93. package/skills/click_sfx.aiaudio/manifest.json +45 -0
  94. package/skills/click_sfx.aiaudio/ref/click.mp3 +0 -0
  95. package/skills/combo_display.aicomponent/SKILL.md +45 -0
  96. package/skills/combo_display.aicomponent/manifest.json +31 -0
  97. package/skills/combo_display.aicomponent/ref/ComboManager.ts +362 -0
  98. package/skills/combo_display.aicomponent/ref/ComboSmallUI.ts +232 -0
  99. package/skills/combo_praise_text.aicomponent/SKILL.md +56 -0
  100. package/skills/combo_praise_text.aicomponent/manifest.json +34 -0
  101. package/skills/combo_praise_text.aicomponent/ref/ComboManager.ts +362 -0
  102. package/skills/countdown_timer.aicomponent/SKILL.md +44 -0
  103. package/skills/countdown_timer.aicomponent/manifest.json +35 -0
  104. package/skills/countdown_timer.aicomponent/ref/CountdownDisplay.ts +213 -0
  105. package/skills/cta_platform_config.aiconfig/SKILL.md +72 -0
  106. package/skills/cta_platform_config.aiconfig/manifest.json +56 -0
  107. package/skills/debug_overlay.aicomponent/SKILL.md +75 -0
  108. package/skills/debug_overlay.aicomponent/manifest.json +17 -0
  109. package/skills/debug_overlay.aicomponent/ref/DebugOverlay.ts +144 -0
  110. package/skills/desert.aiimage/SKILL.md +63 -0
  111. package/skills/desert.aiimage/manifest.json +49 -0
  112. package/skills/difficulty_curve_designer.aiconfig/SKILL.md +68 -0
  113. package/skills/difficulty_curve_designer.aiconfig/manifest.json +36 -0
  114. package/skills/digit_renderer.aicomponent/SKILL.md +43 -0
  115. package/skills/digit_renderer.aicomponent/manifest.json +25 -0
  116. package/skills/digit_renderer.aicomponent/ref/DigitRenderer.ts +237 -0
  117. package/skills/download_button.aicomponent/SKILL.md +44 -0
  118. package/skills/download_button.aicomponent/manifest.json +25 -0
  119. package/skills/download_button.aicomponent/ref/DownloadButton.ts +137 -0
  120. package/skills/draw_line_puzzle.aigameplay/SKILL.md +84 -0
  121. package/skills/draw_line_puzzle.aigameplay/manifest.json +152 -0
  122. package/skills/draw_line_puzzle.aigameplay/ref/pgs-schema.json +189 -0
  123. package/skills/draw_line_puzzle.aigameplay/ref/reducer.template.ts +194 -0
  124. package/skills/easy_to_hard.aiconfig/SKILL.md +52 -0
  125. package/skills/easy_to_hard.aiconfig/manifest.json +33 -0
  126. package/skills/eight_ball_pool.aigameplay/SKILL.md +104 -0
  127. package/skills/eight_ball_pool.aigameplay/manifest.json +152 -0
  128. package/skills/eight_ball_pool.aigameplay/ref/pgs-schema.json +205 -0
  129. package/skills/eight_ball_pool.aigameplay/ref/reducer.template.ts +198 -0
  130. package/skills/energetic_electronic.aiaudio/SKILL.md +69 -0
  131. package/skills/energetic_electronic.aiaudio/manifest.json +51 -0
  132. package/skills/fail_sfx.aiaudio/SKILL.md +59 -0
  133. package/skills/fail_sfx.aiaudio/manifest.json +44 -0
  134. package/skills/fail_sfx.aiaudio/ref/fail.mp3 +0 -0
  135. package/skills/figer_icon.aiimage/SKILL.md +58 -0
  136. package/skills/figer_icon.aiimage/manifest.json +48 -0
  137. package/skills/figer_icon.aiimage/ref/figer.png +0 -0
  138. package/skills/figer_icon.aiimage/ref/figer.webp +0 -0
  139. package/skills/forest.aiimage/SKILL.md +74 -0
  140. package/skills/forest.aiimage/manifest.json +48 -0
  141. package/skills/fruit_tile.aiimage/SKILL.md +68 -0
  142. package/skills/fruit_tile.aiimage/manifest.json +48 -0
  143. package/skills/game_over_panel.aicomponent/SKILL.md +47 -0
  144. package/skills/game_over_panel.aicomponent/manifest.json +61 -0
  145. package/skills/game_over_panel.aicomponent/ref/GameOverPanel.ts +74 -0
  146. package/skills/game_scene.aicomponent/SKILL.md +57 -0
  147. package/skills/game_scene.aicomponent/manifest.json +36 -0
  148. package/skills/game_scene.aicomponent/ref/Game.ts +748 -0
  149. package/skills/gameplay_balance_check.aivalidator/SKILL.md +69 -0
  150. package/skills/gameplay_balance_check.aivalidator/manifest.json +21 -0
  151. package/skills/gameplay_unit_test.aivalidator/SKILL.md +89 -0
  152. package/skills/gameplay_unit_test.aivalidator/manifest.json +17 -0
  153. package/skills/gameplay_unit_test.aivalidator/ref/gameplay.test.ts +202 -0
  154. package/skills/gameplay_unit_test.aivalidator/ref/vitest.config.ts +13 -0
  155. package/skills/grid_board_layout.aicomponent/SKILL.md +85 -0
  156. package/skills/grid_board_layout.aicomponent/manifest.json +69 -0
  157. package/skills/grid_board_layout.aicomponent/ref/BoardLayout.ts +416 -0
  158. package/skills/grid_board_layout.aicomponent/ref/BoardLayout3D.ts +125 -0
  159. package/skills/grid_board_layout.aicomponent/ref/BoardLayoutMath.ts +85 -0
  160. package/skills/grid_board_layout.aicomponent/ref/BoardRenderer3D.ts +298 -0
  161. package/skills/heart_lives.aicomponent/SKILL.md +42 -0
  162. package/skills/heart_lives.aicomponent/manifest.json +25 -0
  163. package/skills/heart_lives.aicomponent/ref/HeartDisplay.ts +96 -0
  164. package/skills/idle-breathe.aicomponent/SKILL.md +27 -0
  165. package/skills/idle-breathe.aicomponent/manifest.json +20 -0
  166. package/skills/idle-breathe.aicomponent/ref/phaser.js +25 -0
  167. package/skills/idle-breathe.aicomponent/ref/playcanvas.js +29 -0
  168. package/skills/jewel_tile.aiimage/SKILL.md +63 -0
  169. package/skills/jewel_tile.aiimage/manifest.json +49 -0
  170. package/skills/knife_hit.aigameplay/SKILL.md +103 -0
  171. package/skills/knife_hit.aigameplay/manifest.json +151 -0
  172. package/skills/knife_hit.aigameplay/ref/pgs-schema.json +202 -0
  173. package/skills/knife_hit.aigameplay/ref/reducer.template.ts +196 -0
  174. package/skills/left_right_parkour.aigameplay/SKILL.md +120 -0
  175. package/skills/left_right_parkour.aigameplay/manifest.json +165 -0
  176. package/skills/left_right_parkour.aigameplay/ref/pgs-schema.json +200 -0
  177. package/skills/left_right_parkour.aigameplay/ref/reducer.template.ts +194 -0
  178. package/skills/level_data_pack.aiconfig/SKILL.md +64 -0
  179. package/skills/level_data_pack.aiconfig/manifest.json +37 -0
  180. package/skills/level_data_validator.aivalidator/SKILL.md +85 -0
  181. package/skills/level_data_validator.aivalidator/manifest.json +17 -0
  182. package/skills/level_data_validator.aivalidator/ref/LevelValidator.ts +113 -0
  183. package/skills/level_lifecycle.aicomponent/SKILL.md +81 -0
  184. package/skills/level_lifecycle.aicomponent/manifest.json +87 -0
  185. package/skills/level_lifecycle.aicomponent/ref/LevelLifecycle.ts +235 -0
  186. package/skills/level_solvability_validator.aivalidator/SKILL.md +74 -0
  187. package/skills/level_solvability_validator.aivalidator/manifest.json +23 -0
  188. package/skills/level_solvability_validator.aivalidator/ref/LevelValidator.ts +186 -0
  189. package/skills/level_state.aicomponent/SKILL.md +55 -0
  190. package/skills/level_state.aicomponent/manifest.json +34 -0
  191. package/skills/level_state.aicomponent/ref/LevelDataManager.ts +26 -0
  192. package/skills/level_state.aicomponent/ref/LevelManager.ts +26 -0
  193. package/skills/loading_screen.aicomponent/SKILL.md +57 -0
  194. package/skills/loading_screen.aicomponent/manifest.json +43 -0
  195. package/skills/loading_screen.aicomponent/ref/LoadingUI.ts +339 -0
  196. package/skills/lose_result_panel.aiimage/SKILL.md +58 -0
  197. package/skills/lose_result_panel.aiimage/manifest.json +47 -0
  198. package/skills/lose_result_panel.aiimage/ref/lose.png +0 -0
  199. package/skills/lose_result_panel.aiimage/ref/lose.webp +0 -0
  200. package/skills/lose_sfx.aiaudio/SKILL.md +59 -0
  201. package/skills/lose_sfx.aiaudio/manifest.json +45 -0
  202. package/skills/lose_sfx.aiaudio/ref/lose.mp3 +0 -0
  203. package/skills/match-pop.aicomponent/SKILL.md +29 -0
  204. package/skills/match-pop.aicomponent/manifest.json +19 -0
  205. package/skills/match-pop.aicomponent/ref/phaser.js +30 -0
  206. package/skills/match-pop.aicomponent/ref/playcanvas.js +22 -0
  207. package/skills/match3_core.aigameplay/SKILL.md +125 -0
  208. package/skills/match3_core.aigameplay/manifest.json +107 -0
  209. package/skills/match3_core.aigameplay/ref/pgs-schema.json +154 -0
  210. package/skills/match3_core.aigameplay/ref/reducer.template.ts +191 -0
  211. package/skills/match_engine.aicomponent/SKILL.md +84 -0
  212. package/skills/match_engine.aicomponent/manifest.json +23 -0
  213. package/skills/match_engine.aicomponent/ref/MatchEngine.ts +75 -0
  214. package/skills/memory_match.aigameplay/SKILL.md +111 -0
  215. package/skills/memory_match.aigameplay/manifest.json +164 -0
  216. package/skills/memory_match.aigameplay/ref/pgs-schema.json +190 -0
  217. package/skills/memory_match.aigameplay/ref/reducer.template.ts +162 -0
  218. package/skills/merge_core.aigameplay/SKILL.md +112 -0
  219. package/skills/merge_core.aigameplay/manifest.json +154 -0
  220. package/skills/merge_core.aigameplay/ref/pgs-schema.json +202 -0
  221. package/skills/merge_core.aigameplay/ref/reducer.template.ts +179 -0
  222. package/skills/mistake_sfx.aiaudio/SKILL.md +59 -0
  223. package/skills/mistake_sfx.aiaudio/manifest.json +45 -0
  224. package/skills/mistake_sfx.aiaudio/ref/mistake.mp3 +0 -0
  225. package/skills/nomove_hint_overlay.aiimage/SKILL.md +58 -0
  226. package/skills/nomove_hint_overlay.aiimage/manifest.json +48 -0
  227. package/skills/nomove_hint_overlay.aiimage/ref/nomove_hint.png +0 -0
  228. package/skills/nomove_hint_overlay.aiimage/ref/nomove_hint.webp +0 -0
  229. package/skills/normal_dot.aiimage/SKILL.md +58 -0
  230. package/skills/normal_dot.aiimage/manifest.json +46 -0
  231. package/skills/normal_dot.aiimage/ref/normal_dot.png +0 -0
  232. package/skills/normal_dot.aiimage/ref/normal_dot.webp +0 -0
  233. package/skills/ocean.aiimage/SKILL.md +71 -0
  234. package/skills/ocean.aiimage/manifest.json +49 -0
  235. package/skills/particle-confetti.aicomponent/SKILL.md +32 -0
  236. package/skills/particle-confetti.aicomponent/manifest.json +21 -0
  237. package/skills/particle-confetti.aicomponent/ref/html5-spritesheet.js +17 -0
  238. package/skills/particle-confetti.aicomponent/ref/phaser.js +38 -0
  239. package/skills/particle-explosion.aicomponent/SKILL.md +37 -0
  240. package/skills/particle-explosion.aicomponent/manifest.json +24 -0
  241. package/skills/particle-explosion.aicomponent/ref/html5-spritesheet.js +40 -0
  242. package/skills/particle-explosion.aicomponent/ref/phaser.js +46 -0
  243. package/skills/particle-explosion.aicomponent/ref/playcanvas.js +33 -0
  244. package/skills/particle-trail.aicomponent/SKILL.md +25 -0
  245. package/skills/particle-trail.aicomponent/manifest.json +22 -0
  246. package/skills/particle-trail.aicomponent/ref/phaser.js +31 -0
  247. package/skills/path_animation.aicomponent/SKILL.md +82 -0
  248. package/skills/path_animation.aicomponent/manifest.json +77 -0
  249. package/skills/path_animation.aicomponent/ref/AnimationManager.ts +694 -0
  250. package/skills/path_animation.aicomponent/ref/AnimationManager3D.ts +317 -0
  251. package/skills/path_elimination_rules.aigameplay/SKILL.md +88 -0
  252. package/skills/path_elimination_rules.aigameplay/manifest.json +119 -0
  253. package/skills/path_elimination_rules.aigameplay/ref/pgs-schema.json +227 -0
  254. package/skills/path_input_handler.aicomponent/SKILL.md +87 -0
  255. package/skills/path_input_handler.aicomponent/manifest.json +97 -0
  256. package/skills/path_input_handler.aicomponent/ref/InputHandler.ts +714 -0
  257. package/skills/path_input_handler.aicomponent/ref/InputHandler3D.ts +204 -0
  258. package/skills/path_renderer.aicomponent/SKILL.md +101 -0
  259. package/skills/path_renderer.aicomponent/manifest.json +69 -0
  260. package/skills/path_renderer.aicomponent/ref/PathRenderer.ts +509 -0
  261. package/skills/path_renderer.aicomponent/ref/PathRenderer3D.ts +176 -0
  262. package/skills/path_renderer.aicomponent/ref/PathRenderers.ts +640 -0
  263. package/skills/phaser.aicomponent/SKILL.md +315 -0
  264. package/skills/phaser.aicomponent/manifest.json +156 -0
  265. package/skills/phaser.aicomponent/ref/BootScene.ts +29 -0
  266. package/skills/phaser.aicomponent/ref/GameConfig.ts +29 -0
  267. package/skills/phaser.aicomponent/ref/GameScene.ts +88 -0
  268. package/skills/phaser.aicomponent/ref/PreloaderScene.ts +78 -0
  269. package/skills/phaser.aicomponent/ref/SceneKeys.ts +7 -0
  270. package/skills/phaser.aicomponent/ref/SoundUtils.ts +21 -0
  271. package/skills/phaser.aicomponent/ref/UiLayout.ts +74 -0
  272. package/skills/phaser.aicomponent/ref/globals.d.ts +52 -0
  273. package/skills/phaser.aicomponent/ref/index.css +40 -0
  274. package/skills/phaser.aicomponent/ref/index.html +14 -0
  275. package/skills/phaser.aicomponent/ref/index.ts +48 -0
  276. package/skills/phaser.aicomponent/ref/main.ts +16 -0
  277. package/skills/phaser.aicomponent/ref/package.json +22 -0
  278. package/skills/phaser.aicomponent/ref/tsconfig.json +25 -0
  279. package/skills/phaser.aicomponent/ref/webpack.config.js +57 -0
  280. package/skills/phaser_scene_lifecycle.aicomponent/SKILL.md +63 -0
  281. package/skills/phaser_scene_lifecycle.aicomponent/manifest.json +33 -0
  282. package/skills/pick_and_match_rules.aigameplay/SKILL.md +113 -0
  283. package/skills/pick_and_match_rules.aigameplay/manifest.json +121 -0
  284. package/skills/pick_and_match_rules.aigameplay/ref/pgs-schema.json +354 -0
  285. package/skills/pin_pull.aigameplay/SKILL.md +110 -0
  286. package/skills/pin_pull.aigameplay/manifest.json +164 -0
  287. package/skills/pin_pull.aigameplay/ref/pgs-schema.json +201 -0
  288. package/skills/pin_pull.aigameplay/ref/reducer.template.ts +216 -0
  289. package/skills/playable_app_logo.aiimage/SKILL.md +58 -0
  290. package/skills/playable_app_logo.aiimage/manifest.json +47 -0
  291. package/skills/playable_app_logo.aiimage/ref/logo.png +0 -0
  292. package/skills/playable_app_logo.aiimage/ref/logo.webp +0 -0
  293. package/skills/playable_end_screen_layout.aicomponent/SKILL.md +75 -0
  294. package/skills/playable_end_screen_layout.aicomponent/manifest.json +24 -0
  295. package/skills/playable_guidance_layer.aicomponent/SKILL.md +89 -0
  296. package/skills/playable_guidance_layer.aicomponent/manifest.json +24 -0
  297. package/skills/playable_hud_layout.aicomponent/SKILL.md +96 -0
  298. package/skills/playable_hud_layout.aicomponent/manifest.json +24 -0
  299. package/skills/playable_scripts_build.aicomponent/SKILL.md +69 -0
  300. package/skills/playable_scripts_build.aicomponent/manifest.json +53 -0
  301. package/skills/playable_scripts_build.aicomponent/ref/builds.config.js +257 -0
  302. package/skills/playcraft-3d-flip-sprite/SKILL.md +336 -0
  303. package/skills/playcraft-3d-flip-sprite/renderer/flatten_glb.mjs +62 -0
  304. package/skills/playcraft-3d-flip-sprite/renderer/render.mjs +325 -0
  305. package/skills/playcraft-3d-flip-sprite/renderer/render_single.mjs +138 -0
  306. package/skills/playcraft-asset-management/SKILL.md +73 -0
  307. package/skills/playcraft-audio-generation/SKILL.md +126 -0
  308. package/skills/playcraft-build/SKILL.md +44 -0
  309. package/skills/playcraft-code-editor/SKILL.md +71 -0
  310. package/skills/playcraft-create-remix/SKILL.md +62 -0
  311. package/skills/playcraft-deploy/SKILL.md +59 -0
  312. package/skills/playcraft-image-generation/SKILL.md +148 -0
  313. package/skills/playcraft-image-processing/SKILL.md +216 -0
  314. package/skills/playcraft-platform-intro/SKILL.md +41 -0
  315. package/skills/playcraft-prefab/SKILL.md +98 -0
  316. package/skills/playcraft-project-management/SKILL.md +57 -0
  317. package/skills/playcraft-remix-workflow/SKILL.md +119 -0
  318. package/skills/playcraft-remix-workflow/references/xplatform.schema.json5 +31 -0
  319. package/skills/playcraft-save/SKILL.md +46 -0
  320. package/skills/playcraft-skill-recommender/SKILL.md +152 -0
  321. package/skills/playcraft-sprite-generation/SKILL.md +534 -0
  322. package/skills/playcraft-sprite-remix/SKILL.md +155 -0
  323. package/skills/playcraft-sprite-sheet/SKILL.md +97 -0
  324. package/skills/playtest_report.aivalidator/SKILL.md +103 -0
  325. package/skills/playtest_report.aivalidator/manifest.json +21 -0
  326. package/skills/preloader_scene.aicomponent/SKILL.md +58 -0
  327. package/skills/preloader_scene.aicomponent/manifest.json +43 -0
  328. package/skills/preloader_scene.aicomponent/ref/Preloader.ts +339 -0
  329. package/skills/progress_bar.aicomponent/SKILL.md +38 -0
  330. package/skills/progress_bar.aicomponent/manifest.json +25 -0
  331. package/skills/progress_bar.aicomponent/ref/ProgressDisplay.ts +140 -0
  332. package/skills/references/xplatform.schema.json5 +31 -0
  333. package/skills/responsive_2d_layout.aicomponent/SKILL.md +161 -0
  334. package/skills/responsive_2d_layout.aicomponent/manifest.json +43 -0
  335. package/skills/responsive_2d_layout.aicomponent/ref/UiLayout.ts +56 -0
  336. package/skills/run_context_state.aicomponent/SKILL.md +54 -0
  337. package/skills/run_context_state.aicomponent/manifest.json +40 -0
  338. package/skills/run_context_state.aicomponent/ref/RunContextRuntime.ts +30 -0
  339. package/skills/score-fly.aicomponent/SKILL.md +31 -0
  340. package/skills/score-fly.aicomponent/manifest.json +21 -0
  341. package/skills/score-fly.aicomponent/ref/phaser.js +26 -0
  342. package/skills/score-fly.aicomponent/ref/playcanvas.js +28 -0
  343. package/skills/score_goal.aiconfig/SKILL.md +46 -0
  344. package/skills/score_goal.aiconfig/manifest.json +33 -0
  345. package/skills/screen-flash.aicomponent/SKILL.md +30 -0
  346. package/skills/screen-flash.aicomponent/manifest.json +20 -0
  347. package/skills/screen-flash.aicomponent/ref/phaser.js +48 -0
  348. package/skills/screen-shake.aicomponent/SKILL.md +30 -0
  349. package/skills/screen-shake.aicomponent/manifest.json +19 -0
  350. package/skills/screen-shake.aicomponent/ref/phaser.js +23 -0
  351. package/skills/screen-shake.aicomponent/ref/playcanvas.js +44 -0
  352. package/skills/screw_puzzle.aigameplay/SKILL.md +116 -0
  353. package/skills/screw_puzzle.aigameplay/manifest.json +164 -0
  354. package/skills/screw_puzzle.aigameplay/ref/pgs-schema.json +235 -0
  355. package/skills/screw_puzzle.aigameplay/ref/reducer.template.ts +213 -0
  356. package/skills/settings_state.aicomponent/SKILL.md +61 -0
  357. package/skills/settings_state.aicomponent/manifest.json +33 -0
  358. package/skills/settings_state.aicomponent/ref/SettingsManager.ts +130 -0
  359. package/skills/slide_out_to_tray_animation.aicomponent/SKILL.md +64 -0
  360. package/skills/slide_out_to_tray_animation.aicomponent/manifest.json +58 -0
  361. package/skills/slide_out_to_tray_animation.aicomponent/ref/AnimationManager.ts +164 -0
  362. package/skills/slide_out_to_tray_animation.aicomponent/ref/AnimationManager3D.ts +198 -0
  363. package/skills/slide_out_to_tray_animation.aicomponent/ref/BezierUtils.ts +59 -0
  364. package/skills/slot_machine.aigameplay/SKILL.md +119 -0
  365. package/skills/slot_machine.aigameplay/manifest.json +166 -0
  366. package/skills/slot_machine.aigameplay/ref/pgs-schema.json +212 -0
  367. package/skills/slot_machine.aigameplay/ref/reducer.template.ts +212 -0
  368. package/skills/sniper_shot.aigameplay/SKILL.md +84 -0
  369. package/skills/sniper_shot.aigameplay/manifest.json +153 -0
  370. package/skills/sniper_shot.aigameplay/ref/pgs-schema.json +211 -0
  371. package/skills/sniper_shot.aigameplay/ref/reducer.template.ts +211 -0
  372. package/skills/solitaire.aigameplay/SKILL.md +101 -0
  373. package/skills/solitaire.aigameplay/manifest.json +151 -0
  374. package/skills/solitaire.aigameplay/ref/pgs-schema.json +200 -0
  375. package/skills/solitaire.aigameplay/ref/reducer.template.ts +176 -0
  376. package/skills/sound-effects/SKILL.md +46 -0
  377. package/skills/sound_utils.aicomponent/SKILL.md +52 -0
  378. package/skills/sound_utils.aicomponent/manifest.json +30 -0
  379. package/skills/sound_utils.aicomponent/ref/SoundUtils.ts +29 -0
  380. package/skills/sprite-animation-2d.aicomponent/SKILL.md +45 -0
  381. package/skills/sprite-animation-2d.aicomponent/manifest.json +28 -0
  382. package/skills/sprite-animation-2d.aicomponent/ref/html5.js +83 -0
  383. package/skills/sprite-animation-2d.aicomponent/ref/phaser.js +38 -0
  384. package/skills/sprite-animation-2d.aicomponent/ref/playcanvas.js +67 -0
  385. package/skills/sprite_entity_renderer.aicomponent/SKILL.md +148 -0
  386. package/skills/sprite_entity_renderer.aicomponent/manifest.json +17 -0
  387. package/skills/sprite_entity_renderer.aicomponent/ref/SpriteEntityRenderer.ts +126 -0
  388. package/skills/success_sfx.aiaudio/SKILL.md +59 -0
  389. package/skills/success_sfx.aiaudio/manifest.json +45 -0
  390. package/skills/success_sfx.aiaudio/ref/success.mp3 +0 -0
  391. package/skills/tap_blast.aigameplay/SKILL.md +116 -0
  392. package/skills/tap_blast.aigameplay/manifest.json +153 -0
  393. package/skills/tap_blast.aigameplay/ref/pgs-schema.json +208 -0
  394. package/skills/tap_blast.aigameplay/ref/reducer.template.ts +202 -0
  395. package/skills/theme_state.aicomponent/SKILL.md +53 -0
  396. package/skills/theme_state.aicomponent/manifest.json +33 -0
  397. package/skills/theme_state.aicomponent/ref/ThemeManager.ts +174 -0
  398. package/skills/theme_switcher_build.aicomponent/SKILL.md +62 -0
  399. package/skills/theme_switcher_build.aicomponent/manifest.json +38 -0
  400. package/skills/theme_switcher_build.aicomponent/ref/theme-index.ts +8 -0
  401. package/skills/theme_variant.aiconfig/SKILL.md +78 -0
  402. package/skills/theme_variant.aiconfig/manifest.json +39 -0
  403. package/skills/theme_variant.aiconfig/ref/ExampleTheme/index.ts +16 -0
  404. package/skills/theme_variant.aiconfig/ref/ExampleTheme/levelEasy.json +141 -0
  405. package/skills/threejs.aicomponent/SKILL.md +422 -0
  406. package/skills/threejs.aicomponent/manifest.json +166 -0
  407. package/skills/threejs.aicomponent/ref/AssetLoader.ts +158 -0
  408. package/skills/threejs.aicomponent/ref/BaseScene.ts +88 -0
  409. package/skills/threejs.aicomponent/ref/GameConfig.ts +47 -0
  410. package/skills/threejs.aicomponent/ref/MainScene.ts +170 -0
  411. package/skills/threejs.aicomponent/ref/PreloaderScene.ts +93 -0
  412. package/skills/threejs.aicomponent/ref/SceneKeys.ts +6 -0
  413. package/skills/threejs.aicomponent/ref/SceneManager.ts +69 -0
  414. package/skills/threejs.aicomponent/ref/ViewportManager.ts +62 -0
  415. package/skills/threejs.aicomponent/ref/globals.d.ts +74 -0
  416. package/skills/threejs.aicomponent/ref/index.css +80 -0
  417. package/skills/threejs.aicomponent/ref/index.html +20 -0
  418. package/skills/threejs.aicomponent/ref/index.ts +117 -0
  419. package/skills/threejs.aicomponent/ref/main.ts +10 -0
  420. package/skills/threejs.aicomponent/ref/package.json +23 -0
  421. package/skills/threejs.aicomponent/ref/tsconfig.json +24 -0
  422. package/skills/threejs.aicomponent/ref/webpack.config.js +61 -0
  423. package/skills/time_clear_goal.aiconfig/SKILL.md +46 -0
  424. package/skills/time_clear_goal.aiconfig/manifest.json +32 -0
  425. package/skills/time_icon.aiimage/SKILL.md +58 -0
  426. package/skills/time_icon.aiimage/manifest.json +47 -0
  427. package/skills/time_icon.aiimage/ref/time.png +0 -0
  428. package/skills/time_icon.aiimage/ref/time.webp +0 -0
  429. package/skills/top_ui_bar.aicomponent/SKILL.md +45 -0
  430. package/skills/top_ui_bar.aicomponent/manifest.json +27 -0
  431. package/skills/top_ui_bar.aicomponent/ref/GameTopUI.ts +229 -0
  432. package/skills/tower_defence.aigameplay/SKILL.md +117 -0
  433. package/skills/tower_defence.aigameplay/manifest.json +175 -0
  434. package/skills/tower_defence.aigameplay/ref/pgs-schema.json +247 -0
  435. package/skills/tower_defence.aigameplay/ref/reducer.template.ts +239 -0
  436. package/skills/tray_container.aicomponent/SKILL.md +143 -0
  437. package/skills/tray_container.aicomponent/manifest.json +58 -0
  438. package/skills/tray_container.aicomponent/ref/TrayRenderer.ts +155 -0
  439. package/skills/tray_container.aicomponent/ref/TrayRenderer3D.ts +281 -0
  440. package/skills/tray_container.aicomponent/ref/TrayRendererHtmlOverlay.ts +228 -0
  441. package/skills/tutorial_overlay.aicomponent/SKILL.md +46 -0
  442. package/skills/tutorial_overlay.aicomponent/manifest.json +34 -0
  443. package/skills/tutorial_overlay.aicomponent/ref/TutorialManager.ts +367 -0
  444. package/skills/tween-animation-2d.aicomponent/SKILL.md +35 -0
  445. package/skills/tween-animation-2d.aicomponent/manifest.json +28 -0
  446. package/skills/tween-animation-2d.aicomponent/ref/phaser.js +49 -0
  447. package/skills/tween-animation-2d.aicomponent/ref/playcanvas.js +36 -0
  448. package/skills/typescript_module_patterns.aicomponent/SKILL.md +209 -0
  449. package/skills/typescript_module_patterns.aicomponent/manifest.json +28 -0
  450. package/skills/typescript_module_patterns.aicomponent/ref/globals.d.ts +31 -0
  451. package/skills/ui-transition.aicomponent/SKILL.md +33 -0
  452. package/skills/ui-transition.aicomponent/manifest.json +19 -0
  453. package/skills/ui-transition.aicomponent/ref/phaser.js +45 -0
  454. package/skills/ux_flow_spec.aiconfig/SKILL.md +82 -0
  455. package/skills/ux_flow_spec.aiconfig/manifest.json +39 -0
  456. package/skills/wave_difficulty.aiconfig/SKILL.md +46 -0
  457. package/skills/wave_difficulty.aiconfig/manifest.json +33 -0
  458. package/skills/webpack_build.aicomponent/SKILL.md +204 -0
  459. package/skills/webpack_build.aicomponent/manifest.json +29 -0
  460. package/skills/webpack_build.aicomponent/ref/package.json +16 -0
  461. package/skills/webpack_build.aicomponent/ref/webpack.config.js +53 -0
  462. package/skills/win_anim_sfx.aiaudio/SKILL.md +59 -0
  463. package/skills/win_anim_sfx.aiaudio/manifest.json +46 -0
  464. package/skills/win_anim_sfx.aiaudio/ref/win_anim.mp3 +0 -0
  465. package/skills/win_dot.aiimage/SKILL.md +58 -0
  466. package/skills/win_dot.aiimage/manifest.json +47 -0
  467. package/skills/win_dot.aiimage/ref/win_dot.png +0 -0
  468. package/skills/win_dot.aiimage/ref/win_dot.webp +0 -0
  469. package/skills/win_result_panel.aiimage/SKILL.md +58 -0
  470. package/skills/win_result_panel.aiimage/manifest.json +47 -0
  471. package/skills/win_result_panel.aiimage/ref/win.png +0 -0
  472. package/skills/win_result_panel.aiimage/ref/win.webp +0 -0
  473. package/skills/word_connect.aigameplay/SKILL.md +86 -0
  474. package/skills/word_connect.aigameplay/manifest.json +154 -0
  475. package/skills/word_connect.aigameplay/ref/pgs-schema.json +212 -0
  476. package/skills/word_connect.aigameplay/ref/reducer.template.ts +186 -0
  477. package/src/index.ts +10 -0
  478. package/src/skills.loader.ts +225 -0
  479. package/src/skills.types.ts +42 -0
@@ -0,0 +1,237 @@
1
+ import * as Phaser from "phaser";
2
+
3
+ /**
4
+ * 用于绘制 LED / 七段数码管风格数字、冒号和百分号的工具类。
5
+ */
6
+ export class DigitRenderer {
7
+ /**
8
+ * 在给定的 Graphics 对象上绘制单个七段数码管数字。
9
+ * 传入 digit = -1 绘制空白(所有段关闭)。
10
+ * @param graphics 图形对象
11
+ * @param digit 要绘制的数字(0-9,-1为空白)
12
+ * @param color 颜色值
13
+ * @param width 数字宽度
14
+ * @param height 数字高度
15
+ */
16
+ static drawDigit(
17
+ graphics: Phaser.GameObjects.Graphics,
18
+ digit: number,
19
+ color: number,
20
+ width: number,
21
+ height: number,
22
+ ): void {
23
+ graphics.clear();
24
+
25
+ // 七段定义:a(顶部), b(右上), c(右下), d(底部), e(左下), f(左上), g(中间)
26
+ const segments: { [key: number]: boolean[] } = {
27
+ [-1]: [false, false, false, false, false, false, false],
28
+ 0: [true, true, true, true, true, true, false],
29
+ 1: [false, true, true, false, false, false, false],
30
+ 2: [true, true, false, true, true, false, true],
31
+ 3: [true, true, true, true, false, false, true],
32
+ 4: [false, true, true, false, false, true, true],
33
+ 5: [true, false, true, true, false, true, true],
34
+ 6: [true, false, true, true, true, true, true],
35
+ 7: [true, true, true, false, false, false, false],
36
+ 8: [true, true, true, true, true, true, true],
37
+ 9: [true, true, true, true, false, true, true],
38
+ };
39
+
40
+ const segs = segments[digit] || segments[0];
41
+ const segW = width * 0.7; // 水平段宽度
42
+ const segH = height * 0.12; // 水平段高度
43
+ const segVW = segH; // 垂直段宽度
44
+ const segVH = (height - segH * 3) / 2; // 垂直段高度
45
+ const gap = 2; // 段之间的间隔
46
+ const glowAlpha = 0.1; // 发光效果透明度
47
+
48
+ /**
49
+ * 绘制单个梯形段。
50
+ * @param cx 中心X坐标
51
+ * @param cy 中心Y坐标
52
+ * @param w 宽度
53
+ * @param h 高度
54
+ * @param isHorizontal 是否为水平段
55
+ * @param isOn 是否点亮
56
+ */
57
+ const drawSegment = (
58
+ cx: number,
59
+ cy: number,
60
+ w: number,
61
+ h: number,
62
+ isHorizontal: boolean,
63
+ isOn: boolean,
64
+ ) => {
65
+ if (!isOn) {
66
+ return;
67
+ }
68
+
69
+ // 发光效果
70
+ graphics.fillStyle(color, glowAlpha);
71
+ if (isHorizontal) {
72
+ graphics.fillRect(cx - w / 2 - 2, cy - h / 2 - 2, w + 4, h + 4);
73
+ } else {
74
+ graphics.fillRect(cx - h / 2 - 2, cy - w / 2 - 2, h + 4, w + 4);
75
+ }
76
+
77
+ graphics.fillStyle(color, 1);
78
+
79
+ if (isHorizontal) {
80
+ // 水平梯形段
81
+ const points = [
82
+ { x: cx - w / 2 + h / 2, y: cy - h / 2 },
83
+ { x: cx + w / 2 - h / 2, y: cy - h / 2 },
84
+ { x: cx + w / 2, y: cy },
85
+ { x: cx + w / 2 - h / 2, y: cy + h / 2 },
86
+ { x: cx - w / 2 + h / 2, y: cy + h / 2 },
87
+ { x: cx - w / 2, y: cy },
88
+ ];
89
+ graphics.beginPath();
90
+ graphics.moveTo(points[0].x, points[0].y);
91
+ for (let i = 1; i < points.length; i++) {
92
+ graphics.lineTo(points[i].x, points[i].y);
93
+ }
94
+ graphics.closePath();
95
+ graphics.fillPath();
96
+ } else {
97
+ // 垂直梯形段
98
+ const points = [
99
+ { x: cx, y: cy - w / 2 },
100
+ { x: cx + h / 2, y: cy - w / 2 + h / 2 },
101
+ { x: cx + h / 2, y: cy + w / 2 - h / 2 },
102
+ { x: cx, y: cy + w / 2 },
103
+ { x: cx - h / 2, y: cy + w / 2 - h / 2 },
104
+ { x: cx - h / 2, y: cy - w / 2 + h / 2 },
105
+ ];
106
+ graphics.beginPath();
107
+ graphics.moveTo(points[0].x, points[0].y);
108
+ for (let i = 1; i < points.length; i++) {
109
+ graphics.lineTo(points[i].x, points[i].y);
110
+ }
111
+ graphics.closePath();
112
+ graphics.fillPath();
113
+ }
114
+ };
115
+
116
+ const halfW = width / 2;
117
+ const halfH = height / 2;
118
+
119
+ // a - 顶部水平段
120
+ drawSegment(0, -halfH + segH / 2 + gap, segW, segH, true, segs[0]);
121
+ // b - 右上垂直段
122
+ drawSegment(
123
+ halfW - segVW / 2 - gap,
124
+ -halfH / 2,
125
+ segVH,
126
+ segVW,
127
+ false,
128
+ segs[1],
129
+ );
130
+ // c - 右下垂直段
131
+ drawSegment(
132
+ halfW - segVW / 2 - gap,
133
+ halfH / 2,
134
+ segVH,
135
+ segVW,
136
+ false,
137
+ segs[2],
138
+ );
139
+ // d - 底部水平段
140
+ drawSegment(0, halfH - segH / 2 - gap, segW, segH, true, segs[3]);
141
+ // e - 左下垂直段
142
+ drawSegment(
143
+ -halfW + segVW / 2 + gap,
144
+ halfH / 2,
145
+ segVH,
146
+ segVW,
147
+ false,
148
+ segs[4],
149
+ );
150
+ // f - 左上垂直段
151
+ drawSegment(
152
+ -halfW + segVW / 2 + gap,
153
+ -halfH / 2,
154
+ segVH,
155
+ segVW,
156
+ false,
157
+ segs[5],
158
+ );
159
+ // g - 中间水平段
160
+ drawSegment(0, 0, segW, segH, true, segs[6]);
161
+ }
162
+
163
+ /**
164
+ * 绘制冒号(两个点),用于分钟和秒钟数字之间。
165
+ * @param graphics 图形对象
166
+ * @param color 颜色值
167
+ * @param digitWidth 数字宽度(用于计算缩放)
168
+ */
169
+ static drawColon(
170
+ graphics: Phaser.GameObjects.Graphics,
171
+ color: number,
172
+ digitWidth: number,
173
+ ): void {
174
+ graphics.clear();
175
+
176
+ const scale = digitWidth > 0 ? digitWidth / 20 : 1;
177
+ const dotSize = 3 * scale;
178
+ const spacing = 8 * scale;
179
+
180
+ // 发光效果
181
+ graphics.fillStyle(color, 0.1);
182
+ graphics.fillCircle(0, -spacing, dotSize + 2 * scale);
183
+ graphics.fillCircle(0, spacing, dotSize + 2 * scale);
184
+
185
+ // 主体
186
+ graphics.fillStyle(color, 1);
187
+ graphics.fillCircle(0, -spacing, dotSize);
188
+ graphics.fillCircle(0, spacing, dotSize);
189
+ }
190
+
191
+ /**
192
+ * 绘制百分号(%),用于进度显示。
193
+ * @param graphics 图形对象
194
+ * @param color 颜色值
195
+ * @param digitHeight 数字高度(用于计算缩放)
196
+ */
197
+ static drawPercentSign(
198
+ graphics: Phaser.GameObjects.Graphics,
199
+ color: number,
200
+ digitHeight: number,
201
+ ): void {
202
+ graphics.clear();
203
+
204
+ const scale = digitHeight > 0 ? digitHeight / 36 : 1;
205
+ const dotR = 3 * scale;
206
+
207
+ const x = 4;
208
+ const yTop = -10 * scale;
209
+ const yBottom = 10 * scale;
210
+
211
+ const dotOffsetX = 6 * scale;
212
+ // 点与斜线之间的间隔
213
+ const dotLineGap = 4 * scale;
214
+
215
+ // 发光效果
216
+ graphics.lineStyle(4.5 * scale, color, 0.25);
217
+ graphics.beginPath();
218
+ graphics.moveTo(x - dotOffsetX, yBottom + dotLineGap);
219
+ graphics.lineTo(x + dotOffsetX, yTop - dotLineGap);
220
+ graphics.strokePath();
221
+
222
+ graphics.fillStyle(color, 0.25);
223
+ graphics.fillCircle(x - dotOffsetX, yTop, dotR + 1.5 * scale);
224
+ graphics.fillCircle(x + dotOffsetX, yBottom, dotR + 1.5 * scale);
225
+
226
+ // 主体
227
+ graphics.lineStyle(3.2 * scale, color, 1);
228
+ graphics.beginPath();
229
+ graphics.moveTo(x - dotOffsetX, yBottom + dotLineGap);
230
+ graphics.lineTo(x + dotOffsetX, yTop - dotLineGap);
231
+ graphics.strokePath();
232
+
233
+ graphics.fillStyle(color, 1);
234
+ graphics.fillCircle(x - dotOffsetX, yTop, dotR);
235
+ graphics.fillCircle(x + dotOffsetX, yBottom, dotR);
236
+ }
237
+ }
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: download_button.aicomponent
3
+ description: 下载转化按钮(CTA)。胶囊形状按钮,带呼吸动画,点击时调用 sdk.install() 触发应用安装转化,是试玩广告的核心转化入口。
4
+ triggers: 需要在试玩广告中实现下载/安装按钮时触发。
5
+ ---
6
+
7
+ # 下载转化按钮(Download CTA Button)
8
+
9
+ ## Scaffold
10
+
11
+ `src/game/scenes/GameUI/DownloadButton.ts`
12
+
13
+ ## Recipe
14
+
15
+ | 决策 | 原因 |
16
+ |------|------|
17
+ | **呼吸动画持续吸引注意** | 静态按钮容易被玩家忽视;轻微的缩放呼吸动画(1.0 → 1.05 → 1.0 循环)在不打扰游戏体验的前提下保持 CTA 可见性 |
18
+ | **sdk.install() 集中在组件内** | 下载转化调用点集中在 DownloadButton,不分散在 LevelLifecycle/GameOverPanel 中;便于追踪转化路径和 A/B 测试 |
19
+ | **胶囊形状** | 胶囊(圆角矩形)按钮是 App Store CTA 的标准视觉语言,用户识别成本低 |
20
+
21
+ ## Adapter
22
+
23
+ - **Role**: `downloadCta` — 下载转化按钮(呼吸动画 + sdk.install() 触发)
24
+ - **Provides**: `DownloadButton` 类(`show(x, y)`、`hide()`,内置呼吸动画)
25
+ - **Requires**: `phaser.aicomponent`、`tencent_playable_sdk.aicomponent`(sdk.install())
26
+ - **Consumed by**: `game_over_panel.aicomponent`(胜利/失败面板内嵌 CTA)
27
+ - **Integration point**: `src/game/scenes/GameUI/DownloadButton.ts` → GameOverPanel 内部实例化
28
+
29
+ ## Imports
30
+
31
+ - `phaser.aicomponent`(硬依赖)
32
+ - `tencent_playable_sdk.aicomponent`(硬依赖:sdk.install())
33
+
34
+ ## Skill Definition
35
+
36
+ ```yaml
37
+ tools:
38
+ - read_file
39
+ - write_file
40
+ inputs:
41
+ - source: src/game/scenes/GameUI/DownloadButton.ts
42
+ outputs:
43
+ - downloadButton: DownloadButton class (with breathing animation + sdk.install call)
44
+ ```
@@ -0,0 +1,25 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "atomId": "download_button.aicomponent",
4
+ "bundleType": "aicomponent",
5
+ "category": "component",
6
+ "mode": "fixed",
7
+ "label": { "zh": "下载转化按钮", "en": "Download CTA button" },
8
+ "tags": ["ui", "download", "cta", "button", "install", "conversion", "playable-ads"],
9
+ "bindingRoles": ["downloadCta"],
10
+ "scaffold": {
11
+ "files": {
12
+ "src/game/scenes/GameUI/DownloadButton.ts": { "source": "ref/DownloadButton.ts", "mode": "full", "weight": 10 }
13
+ }
14
+ },
15
+ "imports": [
16
+ { "slot": "engine", "pinAtomId": "phaser.aicomponent", "edgeKind": "requires", "bindAs": "engine" }
17
+ ],
18
+ "exports": [
19
+ { "name": "DownloadButton", "kind": "class", "location": "src/game/scenes/GameUI/DownloadButton.ts" }
20
+ ],
21
+ "neutralDescriptor": {
22
+ "geometry": "animated pill-shaped download call-to-action button with breathing animation, triggers ad platform install callback on click"
23
+ },
24
+ "files": { "skill": "SKILL.md", "downloadButton": "ref/DownloadButton.ts" }
25
+ }
@@ -0,0 +1,137 @@
1
+ import * as Phaser from "phaser";
2
+ import { computeUiLayout } from "../../utils/UiLayout";
3
+ import { SettingsManager } from "./SettingsManager";
4
+ import {
5
+ ENABLE_DOWNLOAD_BUTTON,
6
+ DOWNLOAD_BUTTON_COLOR,
7
+ } from "../../DebugConfig";
8
+
9
+ /**
10
+ * Play button component
11
+ * Displayed at the bottom center of the page, capsule-shaped with a subtle 3D shadow effect
12
+ */
13
+ export class DownloadButton extends Phaser.GameObjects.Container {
14
+ private breathTween?: Phaser.Tweens.Tween;
15
+
16
+ constructor(scene: Phaser.Scene) {
17
+ super(scene);
18
+
19
+ if (!ENABLE_DOWNLOAD_BUTTON) {
20
+ return;
21
+ }
22
+
23
+ scene.add.existing(this);
24
+
25
+ const layout = computeUiLayout(scene);
26
+ const { width, height, uiScale } = layout;
27
+
28
+ // Button dimensions
29
+ const buttonWidth = 240 * uiScale;
30
+ const buttonHeight = 64 * uiScale;
31
+ const borderRadius = buttonHeight / 2; // Full capsule shape
32
+ const bottomMargin = 30 * uiScale;
33
+
34
+ const buttonX = width / 2;
35
+ const buttonY = height - bottomMargin - buttonHeight / 2;
36
+
37
+ // Main button color (use config value, default #5c71ff)
38
+ const mainColor = DOWNLOAD_BUTTON_COLOR;
39
+
40
+ // ---------- Main button background ----------
41
+ const button = scene.add.graphics();
42
+ button.fillStyle(mainColor, 1);
43
+ button.fillRoundedRect(
44
+ -buttonWidth / 2,
45
+ -buttonHeight / 2,
46
+ buttonWidth,
47
+ buttonHeight,
48
+ borderRadius,
49
+ );
50
+
51
+ // ---------- "Play" text ----------
52
+ const text = scene.add.text(0, 0, "Download", {
53
+ fontFamily: "Poppins, Arial, sans-serif",
54
+ fontSize: `${28 * uiScale}px`,
55
+ color: "#FFFFFF",
56
+ fontStyle: "bold",
57
+ });
58
+ text.setOrigin(0.5, 0.5);
59
+
60
+ // Add all elements to container
61
+ this.add([button, text]);
62
+ this.setPosition(buttonX, buttonY);
63
+
64
+ // Set interactive area
65
+ const hitArea = new Phaser.Geom.Rectangle(
66
+ -buttonWidth / 2,
67
+ -buttonHeight / 2,
68
+ buttonWidth,
69
+ buttonHeight,
70
+ );
71
+ this.setInteractive(hitArea, Phaser.Geom.Rectangle.Contains);
72
+ this.input!.cursor = "pointer";
73
+
74
+ // Add click event
75
+ this.setupInteractions(scene);
76
+
77
+ // Set depth
78
+ this.setDepth(1000);
79
+ }
80
+
81
+ /**
82
+ * Set up button interaction events (press, release, hover).
83
+ * @param scene Current scene
84
+ */
85
+ private setupInteractions(scene: Phaser.Scene): void {
86
+ const settingsMgr = SettingsManager.instance;
87
+
88
+ // Press effect
89
+ this.on("pointerdown", () => {
90
+ this.setScale(0.95);
91
+ if (this.breathTween) {
92
+ this.breathTween.pause();
93
+ }
94
+ });
95
+
96
+ // Release effect
97
+ const reset = () => {
98
+ this.setScale(1);
99
+ if (this.breathTween) {
100
+ this.breathTween.resume();
101
+ }
102
+ };
103
+
104
+ this.on("pointerup", () => {
105
+ reset();
106
+ settingsMgr.playButtonClick(scene);
107
+
108
+ // Trigger download (SDK removed)
109
+ });
110
+
111
+ // Hover: slight scale up
112
+ this.on("pointerover", () => {
113
+ this.setScale(1.02);
114
+ });
115
+
116
+ this.on("pointerout", () => {
117
+ reset();
118
+ });
119
+ }
120
+
121
+ /**
122
+ * Stop breath animation.
123
+ */
124
+ stopBreathAnimation(): void {
125
+ if (this.breathTween) {
126
+ this.breathTween.stop();
127
+ this.breathTween = undefined;
128
+ }
129
+ this.setScale(1);
130
+ }
131
+
132
+ /** Destroy button and all child elements. */
133
+ destroy(fromScene?: boolean): void {
134
+ this.stopBreathAnimation();
135
+ super.destroy(fromScene);
136
+ }
137
+ }
@@ -0,0 +1,84 @@
1
+ ---
2
+ name: draw_line_puzzle.aigameplay
3
+ description: 画线解谜玩法封包 - 玩家手绘路径引导角色到达目标,支持障碍碰撞检测与墨水限制的 PGS 实现
4
+ triggers: 画线,draw,line,puzzle,解谜,路径,path,引导,guide,绘画,sketch,连线,轨道,rail,导轨
5
+ ---
6
+
7
+ # draw_line_puzzle.aigameplay
8
+
9
+ 画线解谜玩法封包。实现画线引导玩法的 PGS (PlayCraft Gameplay Schema, 玩法定义规范) JSON 和 reducer,玩家在场景空白区域绘制路径线段,角色沿导轨移动到达目标位置。
10
+
11
+ ## Recipe
12
+
13
+ - **玩法类型**:draw_line_puzzle(画线解谜)
14
+ - **参考文件**:
15
+ - `ref/pgs-schema.json`:PGS (PlayCraft Gameplay Schema, 玩法定义规范) 规则骨架(entities、rules、algorithm、testCases)
16
+ - `ref/reducer.template.ts`:reducer 接口约束模板(`init` / `dispatch` / `getState` + 分步函数)
17
+ - **核心规则**:
18
+ - `maxInkLength`: 500(最大墨水总长度,超过则无法继续画)
19
+ - `characterSpeed`: 100(角色沿路径移动速度,px/s)
20
+ - `lineSegmentSnap`: 5(线段折点最小间距,小于此值合并为同一点)
21
+ - `timeLimitEnabled`: false(默认无时间限制,可配置开启)
22
+ - **PGS Agent 操作流程**:
23
+ 1. 读取 `ref/pgs-schema.json` 作为规则骨架起点
24
+ 2. 读取 `ref/reducer.template.ts` 了解接口约束
25
+ 3. 实现 `reducer.ts`,导出 `init(config)`、`dispatch(state, action)`、`getState(state)` 以及**全部分步函数**
26
+ 4. 运行 `ref/pgs-schema.json` 中的所有 `testCases`,全部通过后才算完成
27
+ 5. 更新 manifest 的 `generation.pgsVersion` 和 `result.outputFile`
28
+ - **可 fork 变体**:
29
+ - 时间限制:开启 `timeLimitEnabled`,在时限内画出路径并到达终点
30
+ - 物理弹球:角色改为弹球,线段变为弹性反弹面
31
+ - 切割障碍:线段具有切割能力,通过切割障碍物开路
32
+
33
+ ## Result
34
+
35
+ - **产物文件**:`reducer.ts`
36
+ - **格式**:TypeScript,导出 `init(config)`、`dispatch(state, action)`、`getState(state)` + 分步函数接口
37
+ - **验证**:所有 testCases 必须通过
38
+
39
+ ## 渲染集成(⚠️ 场景层必读)
40
+
41
+ ### 设计原则:逻辑与动画分离
42
+
43
+ reducer 提供两套接口:
44
+
45
+ | 接口 | 适用场景 | 特点 |
46
+ |------|---------|------|
47
+ | `dispatch()` | 无头测试、AI 模拟、跳过动画 | 一步到位,只返回最终状态 |
48
+ | 分步函数 | **渲染层/GameScene** | 逐步执行,返回中间过程数据用于实时绘制和动画 |
49
+
50
+ ### 分步函数返回值与动画映射
51
+
52
+ | 分步函数 | 返回值 | 场景层动画 |
53
+ |---------|--------|-----------|
54
+ | `startLine(point)` | `{ lineId, inkUsed }` | 创建新的 Graphics 对象,开始绘制 |
55
+ | `extendLine(point)` | `{ newSegment, inkUsed, inkExceeded }` | 实时追加线段到 Graphics,更新墨水 HUD |
56
+ | `finishLine()` | `{ lines, totalInkUsed }` | 封存路径,显示确认按钮或自动执行 |
57
+ | `validatePath()` | `{ valid, reason }` | 显示路径有效/无效提示,高亮障碍冲突段 |
58
+ | `executeCharacterMove(deltaMs)` | `{ position, progress, arrived }` | 逐帧更新角色精灵位置,播放行走动画 |
59
+ | `checkWin()` | `{ win }` | 触发胜利动画和面板 |
60
+
61
+ ## Binding
62
+
63
+ - **Binding Role**:`gameplayRule`
64
+ - **挂载目标**:`game/gameplay/draw_line_puzzle/reducer.ts`
65
+ - **引用类型**:`gameplay-module-reference`
66
+ - **接口契约**:`init(config)` / `dispatch(action)` / `getState()` / `startLine()` / `extendLine()` / `finishLine()` / `validatePath()` / `executeCharacterMove()` / `checkWin()`
67
+
68
+ ## Skill Definition
69
+
70
+ tools:
71
+ - bash
72
+ - write
73
+ - read
74
+ prompt_extension: |
75
+ You are implementing a draw-line puzzle gameplay module following the PGS specification.
76
+ Write the PGS JSON with entities (scene, drawn_lines, character, target, time_limit), rules, algorithm, and testCases.
77
+ Implement the reducer.ts with:
78
+ - init/dispatch/getState (一体化接口,用于测试)
79
+ - startLine/extendLine/finishLine/validatePath/executeCharacterMove/checkWin (分步函数,用于渲染层驱动)
80
+ Line-obstacle collision detection must check each new segment against all obstacle rectangles.
81
+ Ink tracking must accumulate Euclidean distance of all segments and reject when maxInkLength exceeded.
82
+ Character path-following must use linear interpolation along the polyline at characterSpeed px/s.
83
+ Run the testCases to verify the logic before finalizing.
84
+ Apply the Binding to wire the reducer into the game's gameplay module path.
@@ -0,0 +1,152 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "atomId": "draw_line_puzzle.aigameplay",
4
+ "bundleType": "aigameplay",
5
+ "category": "gameplay",
6
+ "mode": "fixed",
7
+ "label": {
8
+ "zh": "画线解谜玩法",
9
+ "en": "Draw Line Puzzle gameplay"
10
+ },
11
+ "tags": [
12
+ "gameplay",
13
+ "puzzle",
14
+ "draw",
15
+ "line",
16
+ "casual",
17
+ "physics"
18
+ ],
19
+ "bindingRoles": [
20
+ "gameplayRule"
21
+ ],
22
+ "imports": [
23
+ {
24
+ "slot": "engine",
25
+ "pinAtomId": "phaser.aicomponent",
26
+ "edgeKind": "requires",
27
+ "bindAs": "engine"
28
+ },
29
+ {
30
+ "slot": "bgMusic",
31
+ "description": "背景循环音乐",
32
+ "bindAs": "bgm",
33
+ "required": false,
34
+ "edgeKind": "compatibleWith",
35
+ "matchBindingRoles": [
36
+ "bgMusic"
37
+ ],
38
+ "allowedBundleTypes": [
39
+ "aiaudio"
40
+ ],
41
+ "constraints": {
42
+ "loop": true
43
+ }
44
+ },
45
+ {
46
+ "slot": "background",
47
+ "description": "游戏背景图",
48
+ "bindAs": "bg",
49
+ "required": false,
50
+ "edgeKind": "compatibleWith",
51
+ "matchBindingRoles": [
52
+ "backgroundTexture"
53
+ ],
54
+ "allowedBundleTypes": [
55
+ "aiimage"
56
+ ]
57
+ },
58
+ {
59
+ "slot": "tutorial",
60
+ "description": "新手引导浮层",
61
+ "bindAs": "tutorial",
62
+ "required": false,
63
+ "edgeKind": "compatibleWith",
64
+ "matchBindingRoles": [
65
+ "tutorialOverlay"
66
+ ],
67
+ "allowedBundleTypes": [
68
+ "aicomponent"
69
+ ]
70
+ },
71
+ {
72
+ "slot": "winPanel",
73
+ "description": "通关反馈面板视觉",
74
+ "bindAs": "winPanel",
75
+ "required": false,
76
+ "edgeKind": "compatibleWith",
77
+ "matchBindingRoles": [
78
+ "successFeedbackPanel"
79
+ ],
80
+ "allowedBundleTypes": [
81
+ "aiimage"
82
+ ]
83
+ },
84
+ {
85
+ "slot": "losePanel",
86
+ "description": "失败反馈面板视觉",
87
+ "bindAs": "losePanel",
88
+ "required": false,
89
+ "edgeKind": "compatibleWith",
90
+ "matchBindingRoles": [
91
+ "failFeedbackPanel"
92
+ ],
93
+ "allowedBundleTypes": [
94
+ "aiimage"
95
+ ]
96
+ },
97
+ {
98
+ "slot": "endScreen",
99
+ "description": "可玩广告结算屏(含 CTA 按钮)",
100
+ "bindAs": "endScreen",
101
+ "required": false,
102
+ "edgeKind": "compatibleWith",
103
+ "matchBindingRoles": [
104
+ "playableEndScreenLayout"
105
+ ],
106
+ "allowedBundleTypes": [
107
+ "aicomponent"
108
+ ]
109
+ }
110
+ ],
111
+ "generation": {
112
+ "kind": "pgs",
113
+ "pgsVersion": "1.0",
114
+ "gameplayType": "draw_line_puzzle",
115
+ "rules": {
116
+ "maxInkLength": 500,
117
+ "characterSpeed": 100,
118
+ "lineSegmentSnap": 5,
119
+ "timeLimitEnabled": false
120
+ }
121
+ },
122
+ "result": {
123
+ "outputFile": "reducer.ts",
124
+ "format": "typescript",
125
+ "constraints": {
126
+ "testCasesMustPass": true
127
+ }
128
+ },
129
+ "binding": {
130
+ "role": "gameplayRule",
131
+ "target": "game/gameplay/draw_line_puzzle/reducer.ts",
132
+ "type": "gameplay-module-reference",
133
+ "constraints": {
134
+ "interface": [
135
+ "init(config)",
136
+ "dispatch(action)",
137
+ "getState()",
138
+ "startLine(state, point)",
139
+ "extendLine(state, point)",
140
+ "finishLine(state)",
141
+ "validatePath(state)",
142
+ "executeCharacterMove(state, deltaMs)",
143
+ "checkWin(state)"
144
+ ]
145
+ }
146
+ },
147
+ "files": {
148
+ "skill": "SKILL.md",
149
+ "pgsSchema": "ref/pgs-schema.json",
150
+ "reducerTemplate": "ref/reducer.template.ts"
151
+ }
152
+ }