cuju-render 0.1.0__py3-none-any.whl

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 (382) hide show
  1. cuju/render/__init__.py +759 -0
  2. cuju/render/__main__.py +1065 -0
  3. cuju/render/_export/__init__.py +3 -0
  4. cuju/render/_export/feed.py +542 -0
  5. cuju/render/_export/sizes.py +157 -0
  6. cuju/render/_export/video.py +1618 -0
  7. cuju/render/_export/video_jobs.py +408 -0
  8. cuju/render/_format/__init__.py +3 -0
  9. cuju/render/_format/annotations.py +235 -0
  10. cuju/render/_format/codec.py +307 -0
  11. cuju/render/_format/keep.py +121 -0
  12. cuju/render/_format/recording.py +860 -0
  13. cuju/render/_format/writer.py +54 -0
  14. cuju/render/_guide/__init__.py +3 -0
  15. cuju/render/_guide/doctor.py +523 -0
  16. cuju/render/_guide/help.py +62 -0
  17. cuju/render/_guide/tutorial.py +254 -0
  18. cuju/render/_http/__init__.py +3 -0
  19. cuju/render/_http/commands.py +57 -0
  20. cuju/render/_http/headers.py +103 -0
  21. cuju/render/_http/launch.py +500 -0
  22. cuju/render/_http/launchers.py +408 -0
  23. cuju/render/_http/pwa.py +128 -0
  24. cuju/render/_http/server.py +2105 -0
  25. cuju/render/_http/window.py +360 -0
  26. cuju/render/_moments/__init__.py +3 -0
  27. cuju/render/_moments/captions.py +284 -0
  28. cuju/render/_moments/events.py +1123 -0
  29. cuju/render/_moments/search.py +694 -0
  30. cuju/render/_packages/__init__.py +3 -0
  31. cuju/render/_packages/glsl.py +746 -0
  32. cuju/render/_packages/loudness.py +334 -0
  33. cuju/render/_packages/pack.py +1959 -0
  34. cuju/render/_packages/presentation.py +1376 -0
  35. cuju/render/_packages/vocabulary.py +609 -0
  36. cuju/render/_playing/__init__.py +3 -0
  37. cuju/render/_playing/achievements.py +463 -0
  38. cuju/render/_playing/bench.py +609 -0
  39. cuju/render/_playing/challenges.py +1813 -0
  40. cuju/render/_playing/demo.py +323 -0
  41. cuju/render/_playing/draw.py +211 -0
  42. cuju/render/_playing/errors.py +20 -0
  43. cuju/render/_playing/game.py +645 -0
  44. cuju/render/_playing/limits.py +339 -0
  45. cuju/render/_playing/play.py +926 -0
  46. cuju/render/_playing/policy_worker.py +250 -0
  47. cuju/render/_playing/strict.py +810 -0
  48. cuju/render/_registry/__init__.py +3 -0
  49. cuju/render/_registry/clips.py +394 -0
  50. cuju/render/_registry/joints.py +108 -0
  51. cuju/render/_registry/teams.py +2058 -0
  52. cuju/render/_store/__init__.py +3 -0
  53. cuju/render/_store/home.py +70 -0
  54. cuju/render/_store/library.py +604 -0
  55. cuju/render/_store/samples.py +163 -0
  56. cuju/render/_text/__init__.py +3 -0
  57. cuju/render/_text/languages.py +637 -0
  58. cuju/render/_text/messages.py +1396 -0
  59. cuju/render/_tournaments/__init__.py +3 -0
  60. cuju/render/_tournaments/results.py +547 -0
  61. cuju/render/_tournaments/tournament.py +2742 -0
  62. cuju/render/_tournaments/tournament_cli.py +587 -0
  63. cuju/render/_tournaments/tournament_runner.py +1975 -0
  64. cuju/render/_version.py +6 -0
  65. cuju/render/_watch/__init__.py +3 -0
  66. cuju/render/_watch/grid.py +265 -0
  67. cuju/render/_watch/live.py +664 -0
  68. cuju/render/_watch/notebook.py +79 -0
  69. cuju/render/_watch/show.py +171 -0
  70. cuju/render/samples/sample-11v11.cjr +0 -0
  71. cuju/render/samples/sample-5v5.cjr +0 -0
  72. cuju/render/samples/teams/starter/main.py +33 -0
  73. cuju/render/scenarios/benchmark_full_game_11_vs_11_easy.py +46 -0
  74. cuju/render/scenarios/benchmark_full_game_11_vs_11_hard.py +46 -0
  75. cuju/render/scenarios/benchmark_full_game_11_vs_11_medium.py +46 -0
  76. cuju/render/scenarios/benchmark_full_game_5_vs_5_easy.py +34 -0
  77. cuju/render/scenarios/benchmark_full_game_5_vs_5_hard.py +34 -0
  78. cuju/render/scenarios/benchmark_full_game_5_vs_5_medium.py +34 -0
  79. cuju/render/web/assets/adboard_polygon.webp +0 -0
  80. cuju/render/web/assets/adboard_your_ad_here.webp +0 -0
  81. cuju/render/web/assets/animations/kaykit-rig-medium-combatmelee.glb +0 -0
  82. cuju/render/web/assets/animations/kaykit-rig-medium-general.glb +0 -0
  83. cuju/render/web/assets/animations/kaykit-rig-medium-movementadvanced.glb +0 -0
  84. cuju/render/web/assets/animations/kaykit-rig-medium-movementbasic.glb +0 -0
  85. cuju/render/web/assets/animations/kaykit-rig-medium-simulation.glb +0 -0
  86. cuju/render/web/assets/animations/kaykit-rig-medium-special.glb +0 -0
  87. cuju/render/web/assets/ball.glb +0 -0
  88. cuju/render/web/assets/challenges/3_vs_1_with_keeper.mp4 +0 -0
  89. cuju/render/web/assets/challenges/3_vs_1_with_keeper.webp +0 -0
  90. cuju/render/web/assets/challenges/corner.mp4 +0 -0
  91. cuju/render/web/assets/challenges/corner.webp +0 -0
  92. cuju/render/web/assets/challenges/counterattack_easy.mp4 +0 -0
  93. cuju/render/web/assets/challenges/counterattack_easy.webp +0 -0
  94. cuju/render/web/assets/challenges/counterattack_hard.mp4 +0 -0
  95. cuju/render/web/assets/challenges/counterattack_hard.webp +0 -0
  96. cuju/render/web/assets/challenges/empty_goal.mp4 +0 -0
  97. cuju/render/web/assets/challenges/empty_goal.webp +0 -0
  98. cuju/render/web/assets/challenges/empty_goal_close.mp4 +0 -0
  99. cuju/render/web/assets/challenges/empty_goal_close.webp +0 -0
  100. cuju/render/web/assets/challenges/manifest.json +375 -0
  101. cuju/render/web/assets/challenges/one_on_one.mp4 +0 -0
  102. cuju/render/web/assets/challenges/one_on_one.webp +0 -0
  103. cuju/render/web/assets/challenges/one_on_one_hard.mp4 +0 -0
  104. cuju/render/web/assets/challenges/one_on_one_hard.webp +0 -0
  105. cuju/render/web/assets/challenges/pass_and_shoot_with_keeper.mp4 +0 -0
  106. cuju/render/web/assets/challenges/pass_and_shoot_with_keeper.webp +0 -0
  107. cuju/render/web/assets/challenges/run_pass_and_shoot_with_keeper.mp4 +0 -0
  108. cuju/render/web/assets/challenges/run_pass_and_shoot_with_keeper.webp +0 -0
  109. cuju/render/web/assets/challenges/run_to_score.mp4 +0 -0
  110. cuju/render/web/assets/challenges/run_to_score.webp +0 -0
  111. cuju/render/web/assets/challenges/run_to_score_with_keeper.mp4 +0 -0
  112. cuju/render/web/assets/challenges/run_to_score_with_keeper.webp +0 -0
  113. cuju/render/web/assets/challenges/single_goal_versus_lazy.mp4 +0 -0
  114. cuju/render/web/assets/challenges/single_goal_versus_lazy.webp +0 -0
  115. cuju/render/web/assets/crowd.webp +0 -0
  116. cuju/render/web/assets/crowd_normal.webp +0 -0
  117. cuju/render/web/assets/cuju-logo-384.png +0 -0
  118. cuju/render/web/assets/cuju-logo.png +0 -0
  119. cuju/render/web/assets/cuju-logo.svg +46 -0
  120. cuju/render/web/assets/cuju-mark-light.svg +33 -0
  121. cuju/render/web/assets/cuju-mark.svg +33 -0
  122. cuju/render/web/assets/goal.glb +0 -0
  123. cuju/render/web/assets/grass.webp +0 -0
  124. cuju/render/web/assets/hair_black.png +0 -0
  125. cuju/render/web/assets/hair_blonde.png +0 -0
  126. cuju/render/web/assets/hair_brown.png +0 -0
  127. cuju/render/web/assets/hair_darkblonde.png +0 -0
  128. cuju/render/web/assets/hair_long01.glb +0 -0
  129. cuju/render/web/assets/hair_long02.glb +0 -0
  130. cuju/render/web/assets/hair_medium01.glb +0 -0
  131. cuju/render/web/assets/hair_red.png +0 -0
  132. cuju/render/web/assets/hair_short01.glb +0 -0
  133. cuju/render/web/assets/hair_short02.glb +0 -0
  134. cuju/render/web/assets/icons/cuju-192.png +0 -0
  135. cuju/render/web/assets/icons/cuju-512.png +0 -0
  136. cuju/render/web/assets/icons/cuju-maskable-512.png +0 -0
  137. cuju/render/web/assets/kit_goalkeeper.webp +0 -0
  138. cuju/render/web/assets/kit_mask.png +0 -0
  139. cuju/render/web/assets/kit_normal.webp +0 -0
  140. cuju/render/web/assets/manifest.json +601 -0
  141. cuju/render/web/assets/models/kaykit-barbarian.glb +0 -0
  142. cuju/render/web/assets/models/kaykit-barbarian.json +23 -0
  143. cuju/render/web/assets/models/kaykit-knight.glb +0 -0
  144. cuju/render/web/assets/models/kaykit-knight.json +23 -0
  145. cuju/render/web/assets/models/kaykit-mage.glb +0 -0
  146. cuju/render/web/assets/models/kaykit-mage.json +23 -0
  147. cuju/render/web/assets/models/kaykit-mannequin-medium.glb +0 -0
  148. cuju/render/web/assets/models/kaykit-mannequin-medium.json +23 -0
  149. cuju/render/web/assets/models/kaykit-ranger.glb +0 -0
  150. cuju/render/web/assets/models/kaykit-ranger.json +23 -0
  151. cuju/render/web/assets/models/kaykit-rogue-hooded.glb +0 -0
  152. cuju/render/web/assets/models/kaykit-rogue-hooded.json +23 -0
  153. cuju/render/web/assets/models/kaykit-rogue.glb +0 -0
  154. cuju/render/web/assets/models/kaykit-rogue.json +23 -0
  155. cuju/render/web/assets/models/kaykit-skeleton-mage.glb +0 -0
  156. cuju/render/web/assets/models/kaykit-skeleton-mage.json +23 -0
  157. cuju/render/web/assets/models/kaykit-skeleton-minion.glb +0 -0
  158. cuju/render/web/assets/models/kaykit-skeleton-minion.json +23 -0
  159. cuju/render/web/assets/models/kaykit-skeleton-rogue.glb +0 -0
  160. cuju/render/web/assets/models/kaykit-skeleton-rogue.json +23 -0
  161. cuju/render/web/assets/models/kaykit-skeleton-warrior.glb +0 -0
  162. cuju/render/web/assets/models/kaykit-skeleton-warrior.json +23 -0
  163. cuju/render/web/assets/pitch.webp +0 -0
  164. cuju/render/web/assets/pitch_normal.webp +0 -0
  165. cuju/render/web/assets/player.glb +0 -0
  166. cuju/render/web/assets/shoe.webp +0 -0
  167. cuju/render/web/assets/shoe_sole.png +0 -0
  168. cuju/render/web/assets/skin_01.png +0 -0
  169. cuju/render/web/assets/skin_02.png +0 -0
  170. cuju/render/web/assets/skin_03.png +0 -0
  171. cuju/render/web/assets/skin_04.png +0 -0
  172. cuju/render/web/assets/sounds/applause.ogg +0 -0
  173. cuju/render/web/assets/sounds/beach-wave-1.ogg +0 -0
  174. cuju/render/web/assets/sounds/beach-wave-2.ogg +0 -0
  175. cuju/render/web/assets/sounds/beach-wave-3.ogg +0 -0
  176. cuju/render/web/assets/sounds/beach-wave-4.ogg +0 -0
  177. cuju/render/web/assets/sounds/city-horn.ogg +0 -0
  178. cuju/render/web/assets/sounds/city-loop.ogg +0 -0
  179. cuju/render/web/assets/sounds/city-siren.ogg +0 -0
  180. cuju/render/web/assets/sounds/crowd-cheer.ogg +0 -0
  181. cuju/render/web/assets/sounds/crowd-loop.ogg +0 -0
  182. cuju/render/web/assets/sounds/crowd-ooh.ogg +0 -0
  183. cuju/render/web/assets/sounds/gulls.ogg +0 -0
  184. cuju/render/web/assets/sounds/neon-sting.ogg +0 -0
  185. cuju/render/web/assets/sounds/rain-loop.ogg +0 -0
  186. cuju/render/web/assets/sounds/sounds.json +46 -0
  187. cuju/render/web/assets/sounds/space-beep.ogg +0 -0
  188. cuju/render/web/assets/sounds/space-hum.ogg +0 -0
  189. cuju/render/web/assets/sounds/space-radio.ogg +0 -0
  190. cuju/render/web/assets/sounds/whistle-long.ogg +0 -0
  191. cuju/render/web/assets/sounds/whistle-short.ogg +0 -0
  192. cuju/render/web/assets/sounds/wind-loop.ogg +0 -0
  193. cuju/render/web/easy.css +357 -0
  194. cuju/render/web/export.html +23 -0
  195. cuju/render/web/feed.css +262 -0
  196. cuju/render/web/feed.html +28 -0
  197. cuju/render/web/flat.css +120 -0
  198. cuju/render/web/home.css +837 -0
  199. cuju/render/web/index.html +373 -0
  200. cuju/render/web/js/boot.js +50 -0
  201. cuju/render/web/js/broadcast/audio.js +2141 -0
  202. cuju/render/web/js/broadcast/celebrate.js +1238 -0
  203. cuju/render/web/js/broadcast/decisions.js +609 -0
  204. cuju/render/web/js/broadcast/hud.js +352 -0
  205. cuju/render/web/js/broadcast/show.js +3614 -0
  206. cuju/render/web/js/broadcast/transition.js +2231 -0
  207. cuju/render/web/js/broadcast/voices.js +153 -0
  208. cuju/render/web/js/capture.js +101 -0
  209. cuju/render/web/js/core/accessibility.js +90 -0
  210. cuju/render/web/js/core/api.js +429 -0
  211. cuju/render/web/js/core/comfort.js +135 -0
  212. cuju/render/web/js/core/i18n.js +705 -0
  213. cuju/render/web/js/core/icons.js +167 -0
  214. cuju/render/web/js/core/input-settings.js +156 -0
  215. cuju/render/web/js/core/keys.js +277 -0
  216. cuju/render/web/js/core/language-ui.js +125 -0
  217. cuju/render/web/js/core/menu.js +853 -0
  218. cuju/render/web/js/core/names.js +113 -0
  219. cuju/render/web/js/core/page-structure.js +110 -0
  220. cuju/render/web/js/core/scenarios.js +109 -0
  221. cuju/render/web/js/core/spoilers.js +236 -0
  222. cuju/render/web/js/core/typeahead.js +38 -0
  223. cuju/render/web/js/export/dom-picture.js +330 -0
  224. cuju/render/web/js/export/export-host.js +97 -0
  225. cuju/render/web/js/export/feed-dialog.js +191 -0
  226. cuju/render/web/js/export/feed-params.js +266 -0
  227. cuju/render/web/js/export/feed.js +363 -0
  228. cuju/render/web/js/export/mp4-mux.js +295 -0
  229. cuju/render/web/js/export/photo-core.js +313 -0
  230. cuju/render/web/js/export/photo.js +1314 -0
  231. cuju/render/web/js/export/safe-frame.js +59 -0
  232. cuju/render/web/js/export/size-fields.js +103 -0
  233. cuju/render/web/js/export/sizes.js +178 -0
  234. cuju/render/web/js/export/video-boot.js +55 -0
  235. cuju/render/web/js/export/video-browser.js +325 -0
  236. cuju/render/web/js/export/video-export.js +417 -0
  237. cuju/render/web/js/export/video-plan.js +207 -0
  238. cuju/render/web/js/export/video-range.js +185 -0
  239. cuju/render/web/js/export/webm-mux.js +198 -0
  240. cuju/render/web/js/feed-boot.js +151 -0
  241. cuju/render/web/js/feed-frame.js +101 -0
  242. cuju/render/web/js/help/doctor.js +488 -0
  243. cuju/render/web/js/help/firstrun.js +379 -0
  244. cuju/render/web/js/help/help-center.js +438 -0
  245. cuju/render/web/js/help/install-offer.js +164 -0
  246. cuju/render/web/js/help/install-state.js +104 -0
  247. cuju/render/web/js/help/lessons-core.js +207 -0
  248. cuju/render/web/js/help/lessons.js +463 -0
  249. cuju/render/web/js/help/palette.js +584 -0
  250. cuju/render/web/js/help/pwa.js +257 -0
  251. cuju/render/web/js/help/tour-core.js +241 -0
  252. cuju/render/web/js/help/tour.js +461 -0
  253. cuju/render/web/js/main.js +2513 -0
  254. cuju/render/web/js/pages/draw.js +188 -0
  255. cuju/render/web/js/pages/fieldpage.js +530 -0
  256. cuju/render/web/js/pages/home.js +521 -0
  257. cuju/render/web/js/pages/matches.js +779 -0
  258. cuju/render/web/js/pages/moments-ui.js +359 -0
  259. cuju/render/web/js/pages/queue-filters.js +63 -0
  260. cuju/render/web/js/pages/recording-groups.js +80 -0
  261. cuju/render/web/js/pages/recordings.js +1069 -0
  262. cuju/render/web/js/play/bench.js +347 -0
  263. cuju/render/web/js/play/challenges.js +1302 -0
  264. cuju/render/web/js/play/medals.js +127 -0
  265. cuju/render/web/js/play/play.js +1953 -0
  266. cuju/render/web/js/play/teasers.js +196 -0
  267. cuju/render/web/js/play/touch.js +350 -0
  268. cuju/render/web/js/play/tournament-layout.js +487 -0
  269. cuju/render/web/js/play/tournament-results.js +441 -0
  270. cuju/render/web/js/play/tournament-strict.js +560 -0
  271. cuju/render/web/js/play/tournament.js +2585 -0
  272. cuju/render/web/js/players/animate.js +972 -0
  273. cuju/render/web/js/players/clips.js +224 -0
  274. cuju/render/web/js/players/kaykit.js +162 -0
  275. cuju/render/web/js/players/kits.js +676 -0
  276. cuju/render/web/js/players/number-patch.js +82 -0
  277. cuju/render/web/js/players/players.js +2694 -0
  278. cuju/render/web/js/players/recolor.js +893 -0
  279. cuju/render/web/js/players/retarget.js +325 -0
  280. cuju/render/web/js/players/rig-numbers.js +174 -0
  281. cuju/render/web/js/presentation/animator.js +231 -0
  282. cuju/render/web/js/presentation/assign.js +85 -0
  283. cuju/render/web/js/presentation/behaviors.js +440 -0
  284. cuju/render/web/js/presentation/budget.js +209 -0
  285. cuju/render/web/js/presentation/catalog.js +1674 -0
  286. cuju/render/web/js/presentation/clocks.js +72 -0
  287. cuju/render/web/js/presentation/commands.js +301 -0
  288. cuju/render/web/js/presentation/contract.js +240 -0
  289. cuju/render/web/js/presentation/effects.js +904 -0
  290. cuju/render/web/js/presentation/flash.js +605 -0
  291. cuju/render/web/js/presentation/freeze-worklet.js +22 -0
  292. cuju/render/web/js/presentation/glsl.js +464 -0
  293. cuju/render/web/js/presentation/host.js +323 -0
  294. cuju/render/web/js/presentation/index.js +2066 -0
  295. cuju/render/web/js/presentation/loudness-worklet.js +235 -0
  296. cuju/render/web/js/presentation/loudness.js +740 -0
  297. cuju/render/web/js/presentation/moments.js +536 -0
  298. cuju/render/web/js/presentation/post.js +327 -0
  299. cuju/render/web/js/presentation/preview.js +180 -0
  300. cuju/render/web/js/presentation/protocol.js +174 -0
  301. cuju/render/web/js/presentation/reach.js +158 -0
  302. cuju/render/web/js/presentation/rigging.js +130 -0
  303. cuju/render/web/js/presentation/sandbox.js +157 -0
  304. cuju/render/web/js/presentation/shaders.js +235 -0
  305. cuju/render/web/js/presentation/stage.js +402 -0
  306. cuju/render/web/js/presentation/teamaudio.js +722 -0
  307. cuju/render/web/js/presentation/tracks.js +197 -0
  308. cuju/render/web/js/presentation/values.js +81 -0
  309. cuju/render/web/js/recording/annotation-data.js +203 -0
  310. cuju/render/web/js/recording/captions.js +491 -0
  311. cuju/render/web/js/recording/codec.js +185 -0
  312. cuju/render/web/js/recording/decode-worker.js +70 -0
  313. cuju/render/web/js/recording/decode.js +94 -0
  314. cuju/render/web/js/recording/episodes.js +46 -0
  315. cuju/render/web/js/recording/format.js +461 -0
  316. cuju/render/web/js/recording/live.js +348 -0
  317. cuju/render/web/js/recording/moments-query.js +59 -0
  318. cuju/render/web/js/recording/moments.js +149 -0
  319. cuju/render/web/js/recording/pose.js +86 -0
  320. cuju/render/web/js/recording/timeline.js +275 -0
  321. cuju/render/web/js/teams/art.js +50 -0
  322. cuju/render/web/js/teams/clip-editor.js +293 -0
  323. cuju/render/web/js/teams/editor.js +1979 -0
  324. cuju/render/web/js/teams/library.js +344 -0
  325. cuju/render/web/js/teams/painter.js +633 -0
  326. cuju/render/web/js/teams/surprise-ui.js +195 -0
  327. cuju/render/web/js/teams/surprise.js +497 -0
  328. cuju/render/web/js/teams/team-check.js +127 -0
  329. cuju/render/web/js/watch/annotations.js +270 -0
  330. cuju/render/web/js/watch/flat.js +366 -0
  331. cuju/render/web/js/watch/grid.js +436 -0
  332. cuju/render/web/js/watch/pitch2d.js +289 -0
  333. cuju/render/web/js/watch/player-tools.js +192 -0
  334. cuju/render/web/js/watch/presets.js +201 -0
  335. cuju/render/web/js/world/arenas.js +997 -0
  336. cuju/render/web/js/world/ball.js +204 -0
  337. cuju/render/web/js/world/cameras.js +982 -0
  338. cuju/render/web/js/world/crowd.js +376 -0
  339. cuju/render/web/js/world/field.js +227 -0
  340. cuju/render/web/js/world/framing.js +145 -0
  341. cuju/render/web/js/world/occlusion.js +48 -0
  342. cuju/render/web/js/world/pitch.js +703 -0
  343. cuju/render/web/js/world/scene.js +395 -0
  344. cuju/render/web/js/world/sky.js +325 -0
  345. cuju/render/web/js/world/stadium.js +1262 -0
  346. cuju/render/web/js/world/vendor-sky.js +367 -0
  347. cuju/render/web/js/world/weather.js +264 -0
  348. cuju/render/web/languages/en.json +4750 -0
  349. cuju/render/web/lessons.json +137 -0
  350. cuju/render/web/manifest.webmanifest +23 -0
  351. cuju/render/web/style.css +8399 -0
  352. cuju/render/web/sw.js +235 -0
  353. cuju/render/web/vendor/fabric/LICENSE +16 -0
  354. cuju/render/web/vendor/fabric/fabric.min.mjs +1 -0
  355. cuju/render/web/vendor/lucide/LICENSE +43 -0
  356. cuju/render/web/vendor/lucide/icons.js +141 -0
  357. cuju/render/web/vendor/three/LICENSE +21 -0
  358. cuju/render/web/vendor/three/build/three.core.js +60586 -0
  359. cuju/render/web/vendor/three/build/three.module.js +19719 -0
  360. cuju/render/web/vendor/three/examples/jsm/loaders/GLTFLoader.js +4925 -0
  361. cuju/render/web/vendor/three/examples/jsm/postprocessing/EffectComposer.js +365 -0
  362. cuju/render/web/vendor/three/examples/jsm/postprocessing/MaskPass.js +195 -0
  363. cuju/render/web/vendor/three/examples/jsm/postprocessing/OutputPass.js +148 -0
  364. cuju/render/web/vendor/three/examples/jsm/postprocessing/Pass.js +191 -0
  365. cuju/render/web/vendor/three/examples/jsm/postprocessing/RenderPass.js +193 -0
  366. cuju/render/web/vendor/three/examples/jsm/postprocessing/ShaderPass.js +135 -0
  367. cuju/render/web/vendor/three/examples/jsm/postprocessing/UnrealBloomPass.js +541 -0
  368. cuju/render/web/vendor/three/examples/jsm/shaders/CopyShader.js +52 -0
  369. cuju/render/web/vendor/three/examples/jsm/shaders/LuminosityHighPassShader.js +68 -0
  370. cuju/render/web/vendor/three/examples/jsm/shaders/OutputShader.js +103 -0
  371. cuju/render/web/vendor/three/examples/jsm/utils/BufferGeometryUtils.js +1501 -0
  372. cuju/render/web/vendor/three/examples/jsm/utils/SkeletonUtils.js +496 -0
  373. cuju_render-0.1.0.dist-info/METADATA +116 -0
  374. cuju_render-0.1.0.dist-info/RECORD +382 -0
  375. cuju_render-0.1.0.dist-info/WHEEL +4 -0
  376. cuju_render-0.1.0.dist-info/licenses/LICENSE +202 -0
  377. cuju_render-0.1.0.dist-info/licenses/LICENSES/CC-BY-4.0.txt +396 -0
  378. cuju_render-0.1.0.dist-info/licenses/LICENSES/CC0-1.0.txt +127 -0
  379. cuju_render-0.1.0.dist-info/licenses/LICENSES/ISC.txt +16 -0
  380. cuju_render-0.1.0.dist-info/licenses/LICENSES/MIT.txt +24 -0
  381. cuju_render-0.1.0.dist-info/licenses/LICENSES/Unlicense.txt +13 -0
  382. cuju_render-0.1.0.dist-info/licenses/NOTICE +35 -0
@@ -0,0 +1,694 @@
1
+ # Copyright 2026 The cuju Authors
2
+ # SPDX-License-Identifier: Apache-2.0
3
+
4
+ """The index of the moments of every recording of the library, and the search over it.
5
+
6
+ The index keeps one small file per recording in the folder `index` of the renderer's home, with
7
+ the moments that `_events` finds in its frames. Each search first brings the index up to date, so
8
+ a recording that arrives is read once, a recording whose file changes is read again, and the file
9
+ of a recording deleted for good goes. A recording in the Trash keeps its file, so a restore finds
10
+ it at once, and a change of the version of the moments or of the index rebuilds every file.
11
+
12
+ A query is a line of words and filters, such as `goal team:Greens after:60`, as `QUERY_HELP`
13
+ describes and the guide documents under Searching moments.
14
+ """
15
+
16
+ from __future__ import annotations
17
+
18
+ import json
19
+ import re
20
+ import threading
21
+ import unicodedata
22
+ from pathlib import Path
23
+ from typing import Any
24
+
25
+ from .._format import recording as _recording
26
+ from .._store import home as _home
27
+ from .._store import library as _library
28
+ from .._text import messages as _messages
29
+ from .._text.messages import MessageError
30
+ from . import captions as _captions
31
+ from . import events as _events
32
+
33
+ # The version of the files of the index, beside the version of the moments.
34
+ INDEX_VERSION = 1
35
+ VERSION = f'{INDEX_VERSION}.{_events.VERSION}'
36
+ # The most results a search returns unless it asks for others, and the most it may ask for.
37
+ LIMIT = 50
38
+ MAXIMUM_LIMIT = 1000
39
+ # Seconds before a moment that its result opens Watch at.
40
+ LEAD_SECONDS = 4.0
41
+ _LOCK = threading.RLock()
42
+ # The entries of each renderer folder by recording, so a sync that started for one folder keeps
43
+ # to it while another one becomes the home.
44
+ _CACHES: dict[str, dict[str, tuple[list[int], dict[str, Any]]]] = {}
45
+
46
+ # The words that name kinds of moments, each with the kind and a test of its data.
47
+ _WORDS: dict[str, tuple[str, Any]] = {}
48
+
49
+
50
+ def _word(names: str, kind: str, test: Any = None) -> None:
51
+ for name in names.split():
52
+ _WORDS[name] = (kind, test)
53
+
54
+
55
+ _word('goal goals', 'goal')
56
+ _word('own-goal own-goals owngoal', 'goal', lambda d: bool(d.get('ownGoal')))
57
+ _word('shot shots', 'shot')
58
+ _word('header headers', 'shot', lambda d: bool(d.get('header')))
59
+ _word('save saves', 'save')
60
+ _word('block blocks', 'block')
61
+ _word('woodwork', 'woodwork')
62
+ _word('post posts', 'woodwork', lambda d: d.get('part') != 'bar')
63
+ _word('bar crossbar', 'woodwork', lambda d: d.get('part') == 'bar')
64
+ _word('near-miss near-misses nearmiss miss misses', 'nearMiss')
65
+ _word('pass passes', 'pass')
66
+ _word('tackle tackles slide slides', 'tackle')
67
+ _word('foul fouls', 'foul')
68
+ _word('card cards', 'card')
69
+ _word('yellow yellows yellow-card', 'card', lambda d: d.get('colour') == 'yellow')
70
+ _word('red reds red-card', 'card', lambda d: d.get('colour') == 'red')
71
+ _word('offside offsides', 'offside')
72
+ _word('restart restarts', 'restart')
73
+ _word('set-piece set-pieces setpiece', 'restart', lambda d: d.get('restart') != 'kickoff')
74
+ for _name, _restart in (
75
+ ('corner corners', 'corner'),
76
+ ('free-kick free-kicks freekick', 'free_kick'),
77
+ ('penalty penalties', 'penalty'),
78
+ ('throw-in throw-ins throwin', 'throw_in'),
79
+ ('goal-kick goal-kicks goalkick', 'goal_kick'),
80
+ ('kickoff kick-off kickoffs', 'kickoff'),
81
+ ):
82
+ _word(_name, 'restart', lambda d, restart=_restart: d.get('restart') == restart)
83
+ _word('possession turnover turnovers', 'possession')
84
+ _word('halftime half-time', 'halftime')
85
+ _word('fulltime full-time', 'fulltime')
86
+
87
+ _KEYS = (
88
+ 'kind',
89
+ 'team',
90
+ 'player',
91
+ 'scenario',
92
+ 'source',
93
+ 'tournament',
94
+ 'challenge',
95
+ 'match',
96
+ 'date',
97
+ 'since',
98
+ 'until',
99
+ 'after',
100
+ 'before',
101
+ 'score',
102
+ 'outcome',
103
+ 'limit',
104
+ )
105
+ _SOURCES = {
106
+ 'requested': 'requested_match',
107
+ 'requested_match': 'requested_match',
108
+ 'match': 'requested_match',
109
+ 'game': 'human_game',
110
+ 'played': 'human_game',
111
+ 'human_game': 'human_game',
112
+ 'challenge': 'challenge',
113
+ 'recorder': 'recorder',
114
+ 'live': 'live',
115
+ }
116
+ _STATES = {
117
+ 'leading': 1,
118
+ 'winning': 1,
119
+ 'ahead': 1,
120
+ 'level': 0,
121
+ 'drawing': 0,
122
+ 'tied': 0,
123
+ 'trailing': -1,
124
+ 'losing': -1,
125
+ 'behind': -1,
126
+ }
127
+ _TERM = re.compile(r'(-?)(?:([A-Za-z]+):)?(?:"([^"]*)"?|(\S+))')
128
+ _DATE = re.compile(r'\d{4}(-\d{2}(-\d{2})?)?')
129
+ _SCORE = re.compile(r'(\d+)-(\d+)')
130
+
131
+ QUERY_HELP = (
132
+ 'words name kinds, such as goal, shot, save, pass, tackle, card, yellow, red, foul, '
133
+ 'offside, corner, free-kick, penalty, throw-in, goal-kick, set-piece, possession, '
134
+ 'woodwork and near-miss, and other words match the title, scenario, teams and players. '
135
+ 'Filters are kind:, team:, player:, scenario:, source:, tournament:, challenge:, match:, '
136
+ 'date:, since:, until:, after:, before:, score:, outcome: and limit:, a minus sign before a '
137
+ 'term excludes what it matches, and quotes hold words together, as in team:"Harbour Rovers".'
138
+ )
139
+
140
+
141
+ def fold(text: Any) -> str:
142
+ """Returns text in lower case without accents, so a query matches whatever way it is typed."""
143
+ normal = unicodedata.normalize('NFD', str(text if text is not None else ''))
144
+ return ''.join(c for c in normal if not unicodedata.combining(c)).lower()
145
+
146
+
147
+ def _cache(home: Path) -> dict[str, tuple[list[int], dict[str, Any]]]:
148
+ return _CACHES.setdefault(str(home), {})
149
+
150
+
151
+ def _signature(path: Path) -> list[int]:
152
+ stat = path.stat()
153
+ return [stat.st_size, stat.st_mtime_ns]
154
+
155
+
156
+ def _header(document: dict[str, Any]) -> dict[str, Any]:
157
+ """Returns what the index keeps of a header, the teams with their rosters and the players."""
158
+ teams = []
159
+ for team in document.get('teams') or []:
160
+ team = team if isinstance(team, dict) else {}
161
+ style = team.get('style') if isinstance(team.get('style'), dict) else {}
162
+ kept = {'name': team.get('name'), 'style': {'players': style.get('players') or []}}
163
+ if team.get('id') is not None:
164
+ kept['id'] = team['id']
165
+ teams.append(kept)
166
+ players = [
167
+ {key: player.get(key) for key in ('team', 'index', 'goalkeeper')}
168
+ for player in document.get('players') or []
169
+ ]
170
+ return {
171
+ 'title': document.get('title'),
172
+ 'scenario': document.get('scenario'),
173
+ 'steps_per_second': document.get('steps_per_second') or 10,
174
+ 'teams': teams,
175
+ 'players': players,
176
+ }
177
+
178
+
179
+ def build(path: Path) -> dict[str, Any]:
180
+ """Returns the index entry of the recording file at `path`, its header and moments."""
181
+ document = _recording.read_header(path)
182
+ moments = _events.moments(document, _recording.frames(path), timing=True)
183
+ return {
184
+ 'version': VERSION,
185
+ 'id': path.stem,
186
+ 'signature': _signature(path),
187
+ 'header': _header(document),
188
+ 'moments': moments,
189
+ }
190
+
191
+
192
+ def _write(folder: Path, entry: dict[str, Any]) -> None:
193
+ target = folder / f'{entry["id"]}.json'
194
+ temporary = target.with_name(target.name + '.part')
195
+ temporary.write_text(json.dumps(entry, separators=(',', ':')), encoding='utf-8')
196
+ temporary.replace(target)
197
+
198
+
199
+ def _read(folder: Path, identifier: str) -> dict[str, Any] | None:
200
+ try:
201
+ entry = json.loads((folder / f'{identifier}.json').read_text(encoding='utf-8'))
202
+ except (OSError, ValueError):
203
+ return None
204
+ return entry if isinstance(entry, dict) else None
205
+
206
+
207
+ def sync() -> dict[str, int]:
208
+ """Brings the index up to date with the library and returns what it did.
209
+
210
+ Returns:
211
+ The number of `recordings` the index holds, those it `built` now, those it `removed` and
212
+ those it `failed` to read, which keep an empty entry until their file changes.
213
+ """
214
+ home = _home.home()
215
+ with _LOCK:
216
+ cache = _cache(home)
217
+ matches = home / 'matches'
218
+ matches.mkdir(parents=True, exist_ok=True)
219
+ recordings = {path.stem: path for path in matches.glob('*.cjr')}
220
+ index = home / 'index'
221
+ index.mkdir(parents=True, exist_ok=True)
222
+ removed = 0
223
+ for path in index.glob('*.json'):
224
+ if path.stem not in recordings:
225
+ path.unlink(missing_ok=True)
226
+ removed += 1
227
+ for path in index.glob('*.json.part'):
228
+ path.unlink(missing_ok=True)
229
+ for identifier in list(cache):
230
+ if identifier not in recordings:
231
+ del cache[identifier]
232
+ built = failed = 0
233
+ for identifier, path in recordings.items():
234
+ try:
235
+ signature = _signature(path)
236
+ except OSError:
237
+ continue
238
+ held = cache.get(identifier)
239
+ if held is not None and held[0] == signature and held[1].get('version') == VERSION:
240
+ continue
241
+ entry = _read(index, identifier)
242
+ if (
243
+ entry is None
244
+ or entry.get('version') != VERSION
245
+ or entry.get('signature') != signature
246
+ ):
247
+ try:
248
+ entry = build(path)
249
+ except Exception as error:
250
+ entry = {
251
+ 'version': VERSION,
252
+ 'id': identifier,
253
+ 'signature': signature,
254
+ 'header': {'teams': [], 'players': []},
255
+ 'moments': [],
256
+ 'error': f'{type(error).__name__}: {error}',
257
+ }
258
+ failed += 1
259
+ _write(index, entry)
260
+ built += 1
261
+ cache[identifier] = (signature, entry)
262
+ return {'recordings': len(cache), 'built': built, 'removed': removed, 'failed': failed}
263
+
264
+
265
+ def entry(identifier: str) -> dict[str, Any]:
266
+ """Returns the index entry of a recording of the library, bringing the index up to date.
267
+
268
+ Raises:
269
+ ArgumentError: If the library holds no such recording outside the Trash.
270
+ """
271
+ if _library.path_of(identifier) is None:
272
+ raise MessageError('server.library.unknown', identifier=repr(identifier))
273
+ sync()
274
+ with _LOCK:
275
+ return _cache(_home.home())[identifier][1]
276
+
277
+
278
+ def _terms(query: str) -> list[tuple[bool, str | None, str]]:
279
+ """Returns the terms of a query, each whether it is negated, its key or `None`, its value."""
280
+ terms = []
281
+ for match in _TERM.finditer(query or ''):
282
+ negated, key, quoted, plain = match.groups()
283
+ value = quoted if quoted is not None else plain
284
+ if key is None and not value:
285
+ continue
286
+ if key is not None:
287
+ key = key.lower()
288
+ if key not in _KEYS:
289
+ raise MessageError(
290
+ 'server.search.filter', filters=', '.join(k + ':' for k in _KEYS), key=key
291
+ )
292
+ terms.append((bool(negated), key, value))
293
+ return terms
294
+
295
+
296
+ def _minutes(value: str, key: str) -> float:
297
+ """Returns a time of the match clock, given as minutes, mm:ss, 90s or 60m, in milliseconds."""
298
+ text = value.strip().lower()
299
+ try:
300
+ if ':' in text:
301
+ minutes, seconds = text.split(':', 1)
302
+ return (float(minutes) * 60 + float(seconds)) * 1000
303
+ if text.endswith('s'):
304
+ return float(text[:-1]) * 1000
305
+ return float(text.removesuffix('m')) * 60000
306
+ except ValueError:
307
+ raise MessageError('server.search.minutes', key=key, value=repr(value)) from None
308
+
309
+
310
+ class _Moment:
311
+ """One moment of one recording with what the filters read of it."""
312
+
313
+ def __init__(self, moment: dict[str, Any], record: dict[str, Any]) -> None:
314
+ self.moment = moment
315
+ self.record = record
316
+
317
+ @property
318
+ def data(self) -> dict[str, Any]:
319
+ return self.moment.get('data') or {}
320
+
321
+ def player(self) -> dict[str, Any] | None:
322
+ k = self.moment.get('player')
323
+ players = self.record['context']['players']
324
+ return players[k] if k is not None and 0 <= k < len(players) else None
325
+
326
+ def before(self) -> list[int] | None:
327
+ """Returns the score of the left and the right team just before the moment."""
328
+ score = self.moment.get('score')
329
+ if not isinstance(score, list):
330
+ return None
331
+ if self.moment['kind'] == 'goal' and self.moment.get('team') in (0, 1):
332
+ score = list(score)
333
+ score[self.moment['team']] -= 1
334
+ return score
335
+
336
+
337
+ def _kind_test(value: str) -> Any:
338
+ names = [fold(name) for name in value.split(',') if name.strip()]
339
+ tests = []
340
+ for name in names:
341
+ if name not in _WORDS:
342
+ raise MessageError('server.search.kind', name=repr(name))
343
+ tests.append(_WORDS[name])
344
+
345
+ def test(item: _Moment) -> bool:
346
+ return any(
347
+ item.moment['kind'] == kind and (check is None or check(item.data))
348
+ for kind, check in tests
349
+ )
350
+
351
+ return test
352
+
353
+
354
+ def _filter(key: str, value: str) -> Any:
355
+ """Returns the test of one filter of a query."""
356
+ text = fold(value).strip()
357
+ if key == 'kind':
358
+ return _kind_test(value)
359
+ if key == 'team':
360
+ if text in ('left', 'home', '0'):
361
+ return lambda item: item.moment.get('team') == 0
362
+ if text in ('right', 'away', '1'):
363
+ return lambda item: item.moment.get('team') == 1
364
+
365
+ def team(item: _Moment) -> bool:
366
+ side = item.moment.get('team')
367
+ names = item.record['context']['teams']
368
+ return side in (0, 1) and text in fold(names[side] or '')
369
+
370
+ return team
371
+ if key == 'player':
372
+ if text.isdigit():
373
+ number = int(text)
374
+ return lambda item: (item.player() or {}).get('number') == number
375
+ return lambda item: bool(text) and text in fold((item.player() or {}).get('name'))
376
+ if key == 'scenario':
377
+
378
+ def scenario(item: _Moment) -> bool:
379
+ name = str(item.record['scenario'] or '')
380
+ return text in fold(name) or text.replace(' ', '_') in fold(name)
381
+
382
+ return scenario
383
+ if key == 'source':
384
+ if text == 'tournament':
385
+ return lambda item: isinstance(item.record['provenance'].get('tournament'), dict)
386
+ if text == 'unknown':
387
+ return lambda item: not item.record['provenance'].get('source')
388
+ if text not in _SOURCES:
389
+ raise MessageError('server.search.source', value=repr(value))
390
+ wanted = _SOURCES[text]
391
+ return lambda item: item.record['provenance'].get('source') == wanted
392
+ if key == 'tournament':
393
+
394
+ def tournament(item: _Moment) -> bool:
395
+ held = item.record['provenance'].get('tournament')
396
+ if not isinstance(held, dict):
397
+ return False
398
+ return any(text in fold(held.get(field)) for field in ('name', 'id', 'stage'))
399
+
400
+ return tournament
401
+ if key == 'challenge':
402
+
403
+ def challenge(item: _Moment) -> bool:
404
+ held = item.record['provenance'].get('challenge')
405
+ return held is not None and text in fold(held)
406
+
407
+ return challenge
408
+ if key == 'match':
409
+ return lambda item: text == fold(item.record['id']) or text in fold(item.record['title'])
410
+ if key in ('date', 'since', 'until'):
411
+ if not _DATE.fullmatch(text):
412
+ raise MessageError('server.search.date', key=key, value=repr(value))
413
+ if key == 'date':
414
+ return lambda item: str(item.record['created'] or '').startswith(text)
415
+ if key == 'since':
416
+ return lambda item: str(item.record['created'] or '')[: len(text)] >= text
417
+ return lambda item: str(item.record['created'] or '')[: len(text)] <= text
418
+ if key in ('after', 'before'):
419
+ bound = _minutes(value, key)
420
+ if key == 'after':
421
+ return lambda item: item.moment.get('clock', 0) >= bound
422
+ return lambda item: item.moment.get('clock', 0) < bound
423
+ if key == 'score':
424
+ exact = _SCORE.fullmatch(text)
425
+ if exact:
426
+ wanted = [int(exact.group(1)), int(exact.group(2))]
427
+ return lambda item: item.moment.get('score') == wanted
428
+ if text not in _STATES:
429
+ raise MessageError('server.search.score', value=repr(value))
430
+ state = _STATES[text]
431
+
432
+ def standing(item: _Moment) -> bool:
433
+ score, side = item.before(), item.moment.get('team')
434
+ if score is None or side not in (0, 1):
435
+ return False
436
+ margin = score[side] - score[1 - side]
437
+ return (margin > 0) - (margin < 0) == state
438
+
439
+ return standing
440
+ if key == 'outcome':
441
+
442
+ def outcome(item: _Moment) -> bool:
443
+ data = item.data
444
+ if fold(data.get('outcome')) == text:
445
+ return True
446
+ if 'won' in data and text in ('won', 'lost'):
447
+ return data['won'] is (text == 'won')
448
+ if 'saved' in data and text in ('saved', 'scored'):
449
+ return data['saved'] is (text == 'saved')
450
+ return False
451
+
452
+ return outcome
453
+ raise MessageError('server.search.unknown_filter', key=key)
454
+
455
+
456
+ def _text_of(*values: Any) -> str:
457
+ """Returns the first of values that is text and not empty, or the empty text."""
458
+ return next((value for value in values if isinstance(value, str) and value), '')
459
+
460
+
461
+ def _record(entry_: dict[str, Any], summary: dict[str, Any], registry: list[Any]) -> dict[str, Any]:
462
+ # An entry of the index or a summary of an older install may hold fields of another type.
463
+ header = entry_['header'] if isinstance(entry_.get('header'), dict) else {}
464
+ teams = header.get('teams') if isinstance(header.get('teams'), list) else []
465
+ # A title that cuju made, such as that of a sample, travels as a label too.
466
+ labels = [_recording.label_of(document, 'title') for document in (summary, header)]
467
+ return {
468
+ 'id': entry_['id'],
469
+ 'title': _text_of(summary.get('title'), header.get('title'), entry_['id']),
470
+ 'title_label': next((found for found in labels if isinstance(found, dict)), None),
471
+ 'scenario': _text_of(summary.get('scenario'), header.get('scenario')),
472
+ 'created': _text_of(summary.get('created')),
473
+ 'provenance': summary.get('provenance') or {},
474
+ 'teams': summary.get('teams')
475
+ or [team.get('name') if isinstance(team, dict) else None for team in teams],
476
+ 'tags': summary.get('tags') or [],
477
+ 'folder': summary.get('folder') or '',
478
+ 'context': _captions.context(header, registry),
479
+ 'steps_per_second': header.get('steps_per_second') or 10,
480
+ }
481
+
482
+
483
+ def describe(moment: dict[str, Any], context: dict[str, Any]) -> str:
484
+ """Returns a short plain line of a moment, its caption or, for a pass, a change of
485
+ possession and a kick off, a line of the same table."""
486
+ return describe_label(moment, context)['text']
487
+
488
+
489
+ def describe_label(moment: dict[str, Any], context: dict[str, Any]) -> dict[str, Any]:
490
+ """Returns the line of `describe` as a label, its message id of the language files, its
491
+ English text and its values, so the page shows it in its own language."""
492
+ table = _captions.messages()
493
+ made = _captions.caption(moment, context, table, labels=True)
494
+ if made is not None:
495
+ return _captions.label(table, *made)
496
+ data = moment.get('data') or {}
497
+ side = moment.get('team')
498
+ team = _captions._team(table, context, side, True) if side in (0, 1) else None
499
+ k = moment.get('player')
500
+ known = k is not None and 0 <= k < len(context['players'])
501
+ if moment['kind'] == 'pass' and known:
502
+ own = _captions._team(table, context, context['players'][k]['team'], True)
503
+ player = _captions._player(table, context, k, True)
504
+ identifier = {
505
+ 'complete': 'describe.pass.complete',
506
+ 'intercepted': 'describe.pass.intercepted',
507
+ }.get(data.get('outcome'), 'describe.pass')
508
+ return _captions.label(table, identifier, {'player': player, 'team': own})
509
+ if moment['kind'] == 'possession' and team:
510
+ return _captions.label(table, 'describe.possession', {'team': team})
511
+ if moment['kind'] == 'restart':
512
+ if data.get('restart') == 'kickoff' and team:
513
+ return _captions.label(table, 'describe.restart.kickoff', {'team': team})
514
+ return _captions.label(table, 'describe.restart', {})
515
+ return _captions.label(table, 'describe.moment', {'kind': moment['kind']})
516
+
517
+
518
+ def _result(item: _Moment) -> dict[str, Any]:
519
+ moment, record = item.moment, item.record
520
+ player = item.player()
521
+ seek = max(0.0, round(moment['t'] - LEAD_SECONDS, 1))
522
+ side = moment.get('team')
523
+ clock = int(moment.get('clock', 0))
524
+ result = {
525
+ 'match': record['id'],
526
+ **_messages.named('title', record['title_label'] or record['title']),
527
+ 'scenario': record['scenario'],
528
+ 'created': record['created'],
529
+ 'source': record['provenance'].get('source'),
530
+ 'id': moment['id'],
531
+ 'kind': moment['kind'],
532
+ 'step': moment['step'],
533
+ 't': moment['t'],
534
+ 'seek': seek,
535
+ 'clock': clock,
536
+ 'minute': f'{clock // 60000}:{clock // 1000 % 60:02d}',
537
+ 'team': side,
538
+ 'team_name': record['context']['teams'][side] if side in (0, 1) else None,
539
+ 'player': moment.get('player'),
540
+ 'number': player['number'] if player else None,
541
+ 'name': (player['name'] or None) if player else None,
542
+ 'score': moment.get('score'),
543
+ **_messages.named('text', describe_label(moment, record['context'])),
544
+ 'data': moment.get('data') or {},
545
+ 'url': f'#match={record["id"]}&t={seek:g}',
546
+ }
547
+ return result
548
+
549
+
550
+ def search(query: str = '', limit: int | None = None) -> dict[str, Any]:
551
+ """Finds the moments of the library that a query names, newest recording first.
552
+
553
+ Args:
554
+ query: Words and filters, as `QUERY_HELP` describes, such as `goal team:Greens after:60`.
555
+ limit: The most results to return, by default the query's `limit:` or 50.
556
+
557
+ Returns:
558
+ The `query`, the `results` with their recording, moment, time to open Watch at, team,
559
+ player, score and a plain line of `text` each, the `total` number of matches before the
560
+ limit, the number of `recordings` searched and what the index did in `index`.
561
+
562
+ Raises:
563
+ ArgumentError: If the query holds an unknown filter or a value out of place.
564
+ """
565
+ terms = _terms(query)
566
+ kinds = []
567
+ tests = []
568
+ words = []
569
+ for negated, key, value in terms:
570
+ if key == 'limit':
571
+ try:
572
+ limit = int(value) if limit is None else limit
573
+ except ValueError:
574
+ raise MessageError('server.search.limit_text', value=repr(value)) from None
575
+ continue
576
+ if key is None and fold(value) in _WORDS:
577
+ test = _kind_test(value)
578
+ if negated:
579
+ tests.append(lambda item, test=test: not test(item))
580
+ else:
581
+ kinds.append(test)
582
+ continue
583
+ if key is None:
584
+ words.append((negated, fold(value)))
585
+ continue
586
+ test = _filter(key, value)
587
+ tests.append((lambda item, test=test: not test(item)) if negated else test)
588
+ limit = LIMIT if limit is None else limit
589
+ if not 1 <= limit <= MAXIMUM_LIMIT:
590
+ raise MessageError('server.search.limit_range', most=MAXIMUM_LIMIT, limit=limit)
591
+ index = sync()
592
+ summaries = {summary['id']: summary for summary in _library.matches()}
593
+ try:
594
+ from .._registry import teams as _teams
595
+
596
+ registry = _teams.teams()
597
+ except Exception:
598
+ registry = []
599
+ with _LOCK:
600
+ entries = [(identifier, held[1]) for identifier, held in _cache(_home.home()).items()]
601
+ found = []
602
+ searched = 0
603
+ for identifier, held in entries:
604
+ summary = summaries.get(identifier)
605
+ if summary is None:
606
+ continue
607
+ searched += 1
608
+ record = _record(held, summary, registry)
609
+ text = fold(
610
+ ' '.join(
611
+ [
612
+ record['id'],
613
+ record['title'],
614
+ record['scenario'].replace('_', ' '),
615
+ record['folder'],
616
+ *[str(name) for name in record['teams'] if name],
617
+ *record['tags'],
618
+ ]
619
+ )
620
+ )
621
+ for moment in held['moments']:
622
+ item = _Moment(moment, record)
623
+ if kinds and not any(test(item) for test in kinds):
624
+ continue
625
+ if not all(test(item) for test in tests):
626
+ continue
627
+ if words:
628
+ name = fold((item.player() or {}).get('name'))
629
+ if not all(((word in text) or word in name) != out for out, word in words):
630
+ continue
631
+ found.append(item)
632
+ found.sort(
633
+ key=lambda item: (item.record['created'], item.record['id'], -item.moment['t']),
634
+ reverse=True,
635
+ )
636
+ return {
637
+ 'query': query,
638
+ 'results': [_result(item) for item in found[:limit]],
639
+ 'total': len(found),
640
+ 'recordings': searched,
641
+ 'index': index,
642
+ }
643
+
644
+
645
+ def moments_of(identifier: str) -> dict[str, Any]:
646
+ """Returns the moments of a recording of the library, each with its plain line of text."""
647
+ held = entry(identifier)
648
+ summary = _library.details(identifier)
649
+ try:
650
+ from .._registry import teams as _teams
651
+
652
+ registry = _teams.teams()
653
+ except Exception:
654
+ registry = []
655
+ record = _record(held, summary, registry)
656
+ return {
657
+ 'match': identifier,
658
+ 'version': VERSION,
659
+ 'moments': [_result(_Moment(moment, record)) for moment in held['moments']],
660
+ }
661
+
662
+
663
+ def _source(target: str | Path) -> tuple[dict[str, Any], list[dict[str, Any]]]:
664
+ """Returns the header and moments of a library recording or of a recording file."""
665
+ if isinstance(target, str) and _library.path_of(target) is not None:
666
+ held = entry(target)
667
+ return held['header'], held['moments']
668
+ path = Path(target)
669
+ if not path.is_file():
670
+ raise MessageError('server.search.target', target=repr(target))
671
+ document = _recording.read_header(path)
672
+ return document, _events.moments(document, _recording.frames(path), timing=True)
673
+
674
+
675
+ def _cues(target: str | Path) -> list[dict[str, Any]]:
676
+ """Returns the caption cues of a recording, with their times as the page computes them."""
677
+ header, moments = _source(target)
678
+ return _captions.cues(moments, _captions.context(header))
679
+
680
+
681
+ def captions(target: str | Path) -> list[dict[str, Any]]:
682
+ """Returns the caption cues of a recording of the library or of a recording file.
683
+
684
+ The times of the cues are in seconds to the millisecond, as a WebVTT file writes them.
685
+ """
686
+ found = _cues(target)
687
+ for cue in found:
688
+ cue['start'], cue['end'] = round(cue['start'], 3), round(cue['end'], 3)
689
+ return found
690
+
691
+
692
+ def captions_vtt(target: str | Path) -> str:
693
+ """Returns the captions of a recording of the library or of a recording file as WebVTT."""
694
+ return _captions.to_vtt(_cues(target))