@forgeax/engine-app 0.1.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 (354) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +418 -0
  3. package/dist/.tsbuildinfo +1 -0
  4. package/dist/__tests__/animation-asset-lookup.unit.test.d.ts +2 -0
  5. package/dist/__tests__/animation-asset-lookup.unit.test.d.ts.map +1 -0
  6. package/dist/__tests__/app-rebuild.test.d.ts +2 -0
  7. package/dist/__tests__/app-rebuild.test.d.ts.map +1 -0
  8. package/dist/__tests__/asset-registry-types.test-d.d.ts +2 -0
  9. package/dist/__tests__/asset-registry-types.test-d.d.ts.map +1 -0
  10. package/dist/__tests__/assets-runtime-assembly.integration.test.d.ts +2 -0
  11. package/dist/__tests__/assets-runtime-assembly.integration.test.d.ts.map +1 -0
  12. package/dist/__tests__/callback-deletion.unit.test.d.ts +2 -0
  13. package/dist/__tests__/callback-deletion.unit.test.d.ts.map +1 -0
  14. package/dist/__tests__/callback-inference.test-d.d.ts +2 -0
  15. package/dist/__tests__/callback-inference.test-d.d.ts.map +1 -0
  16. package/dist/__tests__/component-introspection.unit.test.d.ts +2 -0
  17. package/dist/__tests__/component-introspection.unit.test.d.ts.map +1 -0
  18. package/dist/__tests__/consumer-migration.unit.test.d.ts +2 -0
  19. package/dist/__tests__/consumer-migration.unit.test.d.ts.map +1 -0
  20. package/dist/__tests__/create-app-features.test.d.ts +2 -0
  21. package/dist/__tests__/create-app-features.test.d.ts.map +1 -0
  22. package/dist/__tests__/create-app-listener-sync.test.d.ts +2 -0
  23. package/dist/__tests__/create-app-listener-sync.test.d.ts.map +1 -0
  24. package/dist/__tests__/create-app-lock-provider.test.d.ts +2 -0
  25. package/dist/__tests__/create-app-lock-provider.test.d.ts.map +1 -0
  26. package/dist/__tests__/create-app-plugin.test.d.ts +2 -0
  27. package/dist/__tests__/create-app-plugin.test.d.ts.map +1 -0
  28. package/dist/__tests__/create-app-stop.test.d.ts +2 -0
  29. package/dist/__tests__/create-app-stop.test.d.ts.map +1 -0
  30. package/dist/__tests__/create-app-time.unit.test.d.ts +2 -0
  31. package/dist/__tests__/create-app-time.unit.test.d.ts.map +1 -0
  32. package/dist/__tests__/create-app.test-d.d.ts +2 -0
  33. package/dist/__tests__/create-app.test-d.d.ts.map +1 -0
  34. package/dist/__tests__/create-app.test.d.ts +2 -0
  35. package/dist/__tests__/create-app.test.d.ts.map +1 -0
  36. package/dist/__tests__/create-renderer-error.integration.test.d.ts +2 -0
  37. package/dist/__tests__/create-renderer-error.integration.test.d.ts.map +1 -0
  38. package/dist/__tests__/create-renderer-lifecycle.integration.test.d.ts +2 -0
  39. package/dist/__tests__/create-renderer-lifecycle.integration.test.d.ts.map +1 -0
  40. package/dist/__tests__/docs-gate-green.unit.test.d.ts +2 -0
  41. package/dist/__tests__/docs-gate-green.unit.test.d.ts.map +1 -0
  42. package/dist/__tests__/draw-source-headless-full-chain.test.d.ts +2 -0
  43. package/dist/__tests__/draw-source-headless-full-chain.test.d.ts.map +1 -0
  44. package/dist/__tests__/draw-source-injected-world-update-visibility.test.d.ts +2 -0
  45. package/dist/__tests__/draw-source-injected-world-update-visibility.test.d.ts.map +1 -0
  46. package/dist/__tests__/draw-source-single-world-regression.test.d.ts +2 -0
  47. package/dist/__tests__/draw-source-single-world-regression.test.d.ts.map +1 -0
  48. package/dist/__tests__/ecs-import.unit.test.d.ts +2 -0
  49. package/dist/__tests__/ecs-import.unit.test.d.ts.map +1 -0
  50. package/dist/__tests__/engine-worker-bootstrap-channel.unit.test.d.ts +2 -0
  51. package/dist/__tests__/engine-worker-bootstrap-channel.unit.test.d.ts.map +1 -0
  52. package/dist/__tests__/engine-worker-world-swap.unit.test.d.ts +2 -0
  53. package/dist/__tests__/engine-worker-world-swap.unit.test.d.ts.map +1 -0
  54. package/dist/__tests__/errors-pointer-lock-failed.test.d.ts +2 -0
  55. package/dist/__tests__/errors-pointer-lock-failed.test.d.ts.map +1 -0
  56. package/dist/__tests__/execution-bootstrap-isolation.unit.test.d.ts +2 -0
  57. package/dist/__tests__/execution-bootstrap-isolation.unit.test.d.ts.map +1 -0
  58. package/dist/__tests__/execution-error-detail.test-d.d.ts +2 -0
  59. package/dist/__tests__/execution-error-detail.test-d.d.ts.map +1 -0
  60. package/dist/__tests__/execution-error-detail.unit.test.d.ts +2 -0
  61. package/dist/__tests__/execution-error-detail.unit.test.d.ts.map +1 -0
  62. package/dist/__tests__/execution-frame-order.unit.test.d.ts +2 -0
  63. package/dist/__tests__/execution-frame-order.unit.test.d.ts.map +1 -0
  64. package/dist/__tests__/execution-frame-protocol.unit.test.d.ts +2 -0
  65. package/dist/__tests__/execution-frame-protocol.unit.test.d.ts.map +1 -0
  66. package/dist/__tests__/execution-input-sample.contract.test.d.ts +2 -0
  67. package/dist/__tests__/execution-input-sample.contract.test.d.ts.map +1 -0
  68. package/dist/__tests__/execution-measurement.unit.test.d.ts +2 -0
  69. package/dist/__tests__/execution-measurement.unit.test.d.ts.map +1 -0
  70. package/dist/__tests__/execution-public-api.test-d.d.ts +2 -0
  71. package/dist/__tests__/execution-public-api.test-d.d.ts.map +1 -0
  72. package/dist/__tests__/execution-public-api.unit.test.d.ts +2 -0
  73. package/dist/__tests__/execution-public-api.unit.test.d.ts.map +1 -0
  74. package/dist/__tests__/execution-rebuild.contract.test.d.ts +2 -0
  75. package/dist/__tests__/execution-rebuild.contract.test.d.ts.map +1 -0
  76. package/dist/__tests__/execution-report.contract.test.d.ts +2 -0
  77. package/dist/__tests__/execution-report.contract.test.d.ts.map +1 -0
  78. package/dist/__tests__/execution-report.types.test-d.d.ts +2 -0
  79. package/dist/__tests__/execution-report.types.test-d.d.ts.map +1 -0
  80. package/dist/__tests__/execution-schema-freshness.unit.test.d.ts +2 -0
  81. package/dist/__tests__/execution-schema-freshness.unit.test.d.ts.map +1 -0
  82. package/dist/__tests__/execution-selector.unit.test.d.ts +2 -0
  83. package/dist/__tests__/execution-selector.unit.test.d.ts.map +1 -0
  84. package/dist/__tests__/execution-shared-kernel.unit.test.d.ts +2 -0
  85. package/dist/__tests__/execution-shared-kernel.unit.test.d.ts.map +1 -0
  86. package/dist/__tests__/execution-world-health-owner.test-d.d.ts +2 -0
  87. package/dist/__tests__/execution-world-health-owner.test-d.d.ts.map +1 -0
  88. package/dist/__tests__/fallback-camera.unit.test.d.ts +2 -0
  89. package/dist/__tests__/fallback-camera.unit.test.d.ts.map +1 -0
  90. package/dist/__tests__/frame-loop-time-elapsed.test.d.ts +2 -0
  91. package/dist/__tests__/frame-loop-time-elapsed.test.d.ts.map +1 -0
  92. package/dist/__tests__/frame-loop-time.unit.test.d.ts +2 -0
  93. package/dist/__tests__/frame-loop-time.unit.test.d.ts.map +1 -0
  94. package/dist/__tests__/frame-loop-world-array.test.d.ts +2 -0
  95. package/dist/__tests__/frame-loop-world-array.test.d.ts.map +1 -0
  96. package/dist/__tests__/kernel-worker-runtime.unit.test.d.ts +2 -0
  97. package/dist/__tests__/kernel-worker-runtime.unit.test.d.ts.map +1 -0
  98. package/dist/__tests__/migration-surface-inventory.unit.test.d.ts +2 -0
  99. package/dist/__tests__/migration-surface-inventory.unit.test.d.ts.map +1 -0
  100. package/dist/__tests__/plugin-policy.integration.test.d.ts +2 -0
  101. package/dist/__tests__/plugin-policy.integration.test.d.ts.map +1 -0
  102. package/dist/__tests__/plugin-profiles.unit.test.d.ts +2 -0
  103. package/dist/__tests__/plugin-profiles.unit.test.d.ts.map +1 -0
  104. package/dist/__tests__/profiler-default-off.test.d.ts +2 -0
  105. package/dist/__tests__/profiler-default-off.test.d.ts.map +1 -0
  106. package/dist/__tests__/profiler-frame-token.test.d.ts +2 -0
  107. package/dist/__tests__/profiler-frame-token.test.d.ts.map +1 -0
  108. package/dist/__tests__/profiler-phase-catalog.test.d.ts +2 -0
  109. package/dist/__tests__/profiler-phase-catalog.test.d.ts.map +1 -0
  110. package/dist/__tests__/profiler-phase-integration.test.d.ts +2 -0
  111. package/dist/__tests__/profiler-phase-integration.test.d.ts.map +1 -0
  112. package/dist/__tests__/profiler-remote-bridge.test.d.ts +2 -0
  113. package/dist/__tests__/profiler-remote-bridge.test.d.ts.map +1 -0
  114. package/dist/__tests__/remote-integration.test.d.ts +2 -0
  115. package/dist/__tests__/remote-integration.test.d.ts.map +1 -0
  116. package/dist/__tests__/remote-serve-flag.test.d.ts +2 -0
  117. package/dist/__tests__/remote-serve-flag.test.d.ts.map +1 -0
  118. package/dist/__tests__/rhi-capture-capability.test-d.d.ts +2 -0
  119. package/dist/__tests__/rhi-capture-capability.test-d.d.ts.map +1 -0
  120. package/dist/__tests__/rhi-capture-host.integration.test.d.ts +2 -0
  121. package/dist/__tests__/rhi-capture-host.integration.test.d.ts.map +1 -0
  122. package/dist/__tests__/rhi-capture.browser.test.d.ts +2 -0
  123. package/dist/__tests__/rhi-capture.browser.test.d.ts.map +1 -0
  124. package/dist/__tests__/surface-handoff.test.d.ts +2 -0
  125. package/dist/__tests__/surface-handoff.test.d.ts.map +1 -0
  126. package/dist/__tests__/types-m2.test-d.d.ts +2 -0
  127. package/dist/__tests__/types-m2.test-d.d.ts.map +1 -0
  128. package/dist/__tests__/visibility-remote.integration.test.d.ts +2 -0
  129. package/dist/__tests__/visibility-remote.integration.test.d.ts.map +1 -0
  130. package/dist/__tests__/worker-execution-stop.test.d.ts +2 -0
  131. package/dist/__tests__/worker-execution-stop.test.d.ts.map +1 -0
  132. package/dist/animation-asset-lookup.d.ts +8 -0
  133. package/dist/animation-asset-lookup.d.ts.map +1 -0
  134. package/dist/assets-runtime-assembly.d.ts +19 -0
  135. package/dist/assets-runtime-assembly.d.ts.map +1 -0
  136. package/dist/canvas-policy.d.ts +4 -0
  137. package/dist/canvas-policy.d.ts.map +1 -0
  138. package/dist/create-app.d.ts +57 -0
  139. package/dist/create-app.d.ts.map +1 -0
  140. package/dist/engine-worker-runtime.mjs +884 -0
  141. package/dist/engine-worker-runtime.mjs.map +1 -0
  142. package/dist/errors.d.ts +263 -0
  143. package/dist/errors.d.ts.map +1 -0
  144. package/dist/execution/attached-world-swap.d.ts +21 -0
  145. package/dist/execution/attached-world-swap.d.ts.map +1 -0
  146. package/dist/execution/bootstrap-entry.d.ts +30 -0
  147. package/dist/execution/bootstrap-entry.d.ts.map +1 -0
  148. package/dist/execution/capabilities.d.ts +5 -0
  149. package/dist/execution/capabilities.d.ts.map +1 -0
  150. package/dist/execution/control.d.ts +14 -0
  151. package/dist/execution/control.d.ts.map +1 -0
  152. package/dist/execution/engine-worker-runtime.d.ts +2 -0
  153. package/dist/execution/engine-worker-runtime.d.ts.map +1 -0
  154. package/dist/execution/engine-worker.d.ts +23 -0
  155. package/dist/execution/engine-worker.d.ts.map +1 -0
  156. package/dist/execution/host-controller.d.ts +16 -0
  157. package/dist/execution/host-controller.d.ts.map +1 -0
  158. package/dist/execution/index.d.ts +10 -0
  159. package/dist/execution/index.d.ts.map +1 -0
  160. package/dist/execution/kernel-pool.d.ts +14 -0
  161. package/dist/execution/kernel-pool.d.ts.map +1 -0
  162. package/dist/execution/kernel-worker-runtime.d.ts +2 -0
  163. package/dist/execution/kernel-worker-runtime.d.ts.map +1 -0
  164. package/dist/execution/measurement.d.ts +7 -0
  165. package/dist/execution/measurement.d.ts.map +1 -0
  166. package/dist/execution/protocol.d.ts +84 -0
  167. package/dist/execution/protocol.d.ts.map +1 -0
  168. package/dist/execution/report.d.ts +5 -0
  169. package/dist/execution/report.d.ts.map +1 -0
  170. package/dist/execution/schema.d.ts +4 -0
  171. package/dist/execution/schema.d.ts.map +1 -0
  172. package/dist/execution/selector.d.ts +10 -0
  173. package/dist/execution/selector.d.ts.map +1 -0
  174. package/dist/execution/types.d.ts +107 -0
  175. package/dist/execution/types.d.ts.map +1 -0
  176. package/dist/fallback-camera.d.ts +8 -0
  177. package/dist/fallback-camera.d.ts.map +1 -0
  178. package/dist/game-context.d.ts +98 -0
  179. package/dist/game-context.d.ts.map +1 -0
  180. package/dist/index.d.ts +24 -0
  181. package/dist/index.d.ts.map +1 -0
  182. package/dist/index.mjs +3985 -0
  183. package/dist/index.mjs.map +1 -0
  184. package/dist/input-map-plugin.d.ts +5 -0
  185. package/dist/input-map-plugin.d.ts.map +1 -0
  186. package/dist/input-plugin.d.ts +4 -0
  187. package/dist/input-plugin.d.ts.map +1 -0
  188. package/dist/internal/assembled-engine-profile.d.ts +5 -0
  189. package/dist/internal/assembled-engine-profile.d.ts.map +1 -0
  190. package/dist/internal/assets-world-plugin.d.ts +21 -0
  191. package/dist/internal/assets-world-plugin.d.ts.map +1 -0
  192. package/dist/internal/browser-remote-bridge.d.ts +25 -0
  193. package/dist/internal/browser-remote-bridge.d.ts.map +1 -0
  194. package/dist/internal/browser-rhi-debug-runtime.d.ts +18 -0
  195. package/dist/internal/browser-rhi-debug-runtime.d.ts.map +1 -0
  196. package/dist/internal/component-introspection.d.ts +24 -0
  197. package/dist/internal/component-introspection.d.ts.map +1 -0
  198. package/dist/internal/ecs-import.d.ts +6 -0
  199. package/dist/internal/ecs-import.d.ts.map +1 -0
  200. package/dist/internal/engine-profile-common.d.ts +9 -0
  201. package/dist/internal/engine-profile-common.d.ts.map +1 -0
  202. package/dist/internal/error-fanout.d.ts +66 -0
  203. package/dist/internal/error-fanout.d.ts.map +1 -0
  204. package/dist/internal/frame-loop.d.ts +35 -0
  205. package/dist/internal/frame-loop.d.ts.map +1 -0
  206. package/dist/internal/input-attach.d.ts +44 -0
  207. package/dist/internal/input-attach.d.ts.map +1 -0
  208. package/dist/internal/main-engine-profile.d.ts +15 -0
  209. package/dist/internal/main-engine-profile.d.ts.map +1 -0
  210. package/dist/internal/remote-serve-flag.d.ts +23 -0
  211. package/dist/internal/remote-serve-flag.d.ts.map +1 -0
  212. package/dist/internal/remote-server-plugin.d.ts +8 -0
  213. package/dist/internal/remote-server-plugin.d.ts.map +1 -0
  214. package/dist/internal/rhi-capture.d.ts +19 -0
  215. package/dist/internal/rhi-capture.d.ts.map +1 -0
  216. package/dist/internal/rhi-debug-flag.d.ts +18 -0
  217. package/dist/internal/rhi-debug-flag.d.ts.map +1 -0
  218. package/dist/internal/worker-engine-profile.d.ts +13 -0
  219. package/dist/internal/worker-engine-profile.d.ts.map +1 -0
  220. package/dist/kernel-worker-runtime.mjs +69 -0
  221. package/dist/kernel-worker-runtime.mjs.map +1 -0
  222. package/dist/load-game-errors.d.ts +131 -0
  223. package/dist/load-game-errors.d.ts.map +1 -0
  224. package/dist/load-game.d.ts +34 -0
  225. package/dist/load-game.d.ts.map +1 -0
  226. package/dist/plugin-factories.d.ts +3 -0
  227. package/dist/plugin-factories.d.ts.map +1 -0
  228. package/dist/tool-preview/bootstrap.d.ts +113 -0
  229. package/dist/tool-preview/bootstrap.d.ts.map +1 -0
  230. package/dist/tool-preview/evidence.d.ts +20 -0
  231. package/dist/tool-preview/evidence.d.ts.map +1 -0
  232. package/dist/tool-preview/framing.d.ts +13 -0
  233. package/dist/tool-preview/framing.d.ts.map +1 -0
  234. package/dist/tool-preview/recipe.d.ts +54 -0
  235. package/dist/tool-preview/recipe.d.ts.map +1 -0
  236. package/dist/types.d.ts +444 -0
  237. package/dist/types.d.ts.map +1 -0
  238. package/package.json +86 -0
  239. package/schema/execution-report.schema.json +168 -0
  240. package/src/__tests__/animation-asset-lookup.unit.test.ts +20 -0
  241. package/src/__tests__/app-rebuild.test.ts +31 -0
  242. package/src/__tests__/asset-registry-types.test-d.ts +16 -0
  243. package/src/__tests__/assets-runtime-assembly.integration.test.ts +68 -0
  244. package/src/__tests__/callback-deletion.unit.test.ts +14 -0
  245. package/src/__tests__/callback-inference.test-d.ts +32 -0
  246. package/src/__tests__/component-introspection.unit.test.ts +56 -0
  247. package/src/__tests__/consumer-migration.unit.test.ts +21 -0
  248. package/src/__tests__/create-app-features.test.ts +40 -0
  249. package/src/__tests__/create-app-listener-sync.test.ts +377 -0
  250. package/src/__tests__/create-app-lock-provider.test.ts +212 -0
  251. package/src/__tests__/create-app-plugin.test.ts +217 -0
  252. package/src/__tests__/create-app-stop.test.ts +617 -0
  253. package/src/__tests__/create-app-time.unit.test.ts +26 -0
  254. package/src/__tests__/create-app.test-d.ts +82 -0
  255. package/src/__tests__/create-app.test.ts +346 -0
  256. package/src/__tests__/create-renderer-error.integration.test.ts +24 -0
  257. package/src/__tests__/create-renderer-lifecycle.integration.test.ts +19 -0
  258. package/src/__tests__/docs-gate-green.unit.test.ts +61 -0
  259. package/src/__tests__/draw-source-headless-full-chain.test.ts +226 -0
  260. package/src/__tests__/draw-source-injected-world-update-visibility.test.ts +182 -0
  261. package/src/__tests__/draw-source-single-world-regression.test.ts +185 -0
  262. package/src/__tests__/ecs-import.unit.test.ts +40 -0
  263. package/src/__tests__/engine-worker-bootstrap-channel.unit.test.ts +74 -0
  264. package/src/__tests__/engine-worker-world-swap.unit.test.ts +76 -0
  265. package/src/__tests__/errors-pointer-lock-failed.test.ts +268 -0
  266. package/src/__tests__/execution-bootstrap-isolation.unit.test.ts +80 -0
  267. package/src/__tests__/execution-error-detail.test-d.ts +13 -0
  268. package/src/__tests__/execution-error-detail.unit.test.ts +35 -0
  269. package/src/__tests__/execution-frame-order.unit.test.ts +38 -0
  270. package/src/__tests__/execution-frame-protocol.unit.test.ts +61 -0
  271. package/src/__tests__/execution-input-sample.contract.test.ts +23 -0
  272. package/src/__tests__/execution-measurement.unit.test.ts +20 -0
  273. package/src/__tests__/execution-public-api.test-d.ts +10 -0
  274. package/src/__tests__/execution-public-api.unit.test.ts +9 -0
  275. package/src/__tests__/execution-rebuild.contract.test.ts +36 -0
  276. package/src/__tests__/execution-report.contract.test.ts +50 -0
  277. package/src/__tests__/execution-report.types.test-d.ts +16 -0
  278. package/src/__tests__/execution-schema-freshness.unit.test.ts +20 -0
  279. package/src/__tests__/execution-selector.unit.test.ts +72 -0
  280. package/src/__tests__/execution-shared-kernel.unit.test.ts +180 -0
  281. package/src/__tests__/execution-world-health-owner.test-d.ts +9 -0
  282. package/src/__tests__/fallback-camera.unit.test.ts +32 -0
  283. package/src/__tests__/frame-loop-time-elapsed.test.ts +115 -0
  284. package/src/__tests__/frame-loop-time.unit.test.ts +61 -0
  285. package/src/__tests__/frame-loop-world-array.test.ts +441 -0
  286. package/src/__tests__/kernel-worker-runtime.unit.test.ts +50 -0
  287. package/src/__tests__/migration-surface-inventory.unit.test.ts +13 -0
  288. package/src/__tests__/plugin-policy.integration.test.ts +15 -0
  289. package/src/__tests__/plugin-profiles.unit.test.ts +190 -0
  290. package/src/__tests__/profiler-default-off.test.ts +53 -0
  291. package/src/__tests__/profiler-frame-token.test.ts +248 -0
  292. package/src/__tests__/profiler-phase-catalog.test.ts +30 -0
  293. package/src/__tests__/profiler-phase-integration.test.ts +129 -0
  294. package/src/__tests__/profiler-remote-bridge.test.ts +31 -0
  295. package/src/__tests__/remote-integration.test.ts +224 -0
  296. package/src/__tests__/remote-serve-flag.test.ts +24 -0
  297. package/src/__tests__/rhi-capture-capability.test-d.ts +22 -0
  298. package/src/__tests__/rhi-capture-host.integration.test.ts +157 -0
  299. package/src/__tests__/rhi-capture.browser.test.ts +51 -0
  300. package/src/__tests__/surface-handoff.test.ts +92 -0
  301. package/src/__tests__/types-m2.test-d.ts +81 -0
  302. package/src/__tests__/visibility-remote.integration.test.ts +119 -0
  303. package/src/__tests__/worker-execution-stop.test.ts +116 -0
  304. package/src/animation-asset-lookup.ts +13 -0
  305. package/src/assets-runtime-assembly.ts +70 -0
  306. package/src/canvas-policy.ts +16 -0
  307. package/src/create-app.ts +1351 -0
  308. package/src/errors.ts +454 -0
  309. package/src/execution/attached-world-swap.ts +67 -0
  310. package/src/execution/bootstrap-entry.ts +122 -0
  311. package/src/execution/capabilities.ts +102 -0
  312. package/src/execution/control.ts +52 -0
  313. package/src/execution/engine-worker-runtime.ts +400 -0
  314. package/src/execution/engine-worker.ts +161 -0
  315. package/src/execution/host-controller.ts +454 -0
  316. package/src/execution/index.ts +43 -0
  317. package/src/execution/kernel-pool.ts +236 -0
  318. package/src/execution/kernel-worker-runtime.ts +103 -0
  319. package/src/execution/measurement.ts +39 -0
  320. package/src/execution/protocol.ts +131 -0
  321. package/src/execution/report.ts +66 -0
  322. package/src/execution/schema.ts +168 -0
  323. package/src/execution/selector.ts +98 -0
  324. package/src/execution/types.ts +146 -0
  325. package/src/fallback-camera.ts +20 -0
  326. package/src/game-context.ts +126 -0
  327. package/src/index.ts +176 -0
  328. package/src/input-map-plugin.ts +21 -0
  329. package/src/input-plugin.ts +26 -0
  330. package/src/internal/assembled-engine-profile.ts +22 -0
  331. package/src/internal/assets-world-plugin.ts +79 -0
  332. package/src/internal/browser-remote-bridge.ts +267 -0
  333. package/src/internal/browser-rhi-debug-runtime.ts +67 -0
  334. package/src/internal/component-introspection.ts +116 -0
  335. package/src/internal/ecs-import.ts +41 -0
  336. package/src/internal/engine-profile-common.ts +10 -0
  337. package/src/internal/error-fanout.ts +129 -0
  338. package/src/internal/frame-loop.ts +525 -0
  339. package/src/internal/input-attach.ts +104 -0
  340. package/src/internal/main-engine-profile.ts +80 -0
  341. package/src/internal/remote-serve-flag.ts +50 -0
  342. package/src/internal/remote-server-plugin.ts +16 -0
  343. package/src/internal/rhi-capture.ts +211 -0
  344. package/src/internal/rhi-debug-flag.ts +40 -0
  345. package/src/internal/worker-engine-profile.ts +47 -0
  346. package/src/load-game-errors.ts +211 -0
  347. package/src/load-game.ts +115 -0
  348. package/src/plugin-factories.ts +2 -0
  349. package/src/tool-preview/bootstrap.ts +848 -0
  350. package/src/tool-preview/evidence.ts +59 -0
  351. package/src/tool-preview/framing.ts +52 -0
  352. package/src/tool-preview/recipe.ts +137 -0
  353. package/src/types.ts +505 -0
  354. package/src/vite-env.d.ts +12 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-app.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-app.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=create-renderer-error.integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-renderer-error.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-renderer-error.integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=create-renderer-lifecycle.integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-renderer-lifecycle.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-renderer-lifecycle.integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=docs-gate-green.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"docs-gate-green.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/docs-gate-green.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=draw-source-headless-full-chain.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"draw-source-headless-full-chain.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/draw-source-headless-full-chain.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=draw-source-injected-world-update-visibility.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"draw-source-injected-world-update-visibility.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/draw-source-injected-world-update-visibility.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=draw-source-single-world-regression.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"draw-source-single-world-regression.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/draw-source-single-world-regression.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=ecs-import.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ecs-import.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ecs-import.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=engine-worker-bootstrap-channel.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-worker-bootstrap-channel.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/engine-worker-bootstrap-channel.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=engine-worker-world-swap.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine-worker-world-swap.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/engine-worker-world-swap.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=errors-pointer-lock-failed.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors-pointer-lock-failed.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/errors-pointer-lock-failed.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-bootstrap-isolation.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-bootstrap-isolation.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-bootstrap-isolation.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-error-detail.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-error-detail.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-error-detail.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-error-detail.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-error-detail.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-error-detail.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-frame-order.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-frame-order.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-frame-order.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-frame-protocol.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-frame-protocol.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-frame-protocol.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-input-sample.contract.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-input-sample.contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-input-sample.contract.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-measurement.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-measurement.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-measurement.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-public-api.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-public-api.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-public-api.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-public-api.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-public-api.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-public-api.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-rebuild.contract.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-rebuild.contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-rebuild.contract.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-report.contract.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-report.contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-report.contract.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-report.types.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-report.types.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-report.types.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-schema-freshness.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-schema-freshness.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-schema-freshness.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-selector.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-selector.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-selector.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-shared-kernel.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-shared-kernel.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-shared-kernel.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=execution-world-health-owner.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"execution-world-health-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/execution-world-health-owner.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=fallback-camera.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fallback-camera.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fallback-camera.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=frame-loop-time-elapsed.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-loop-time-elapsed.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/frame-loop-time-elapsed.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=frame-loop-time.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-loop-time.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/frame-loop-time.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=frame-loop-world-array.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-loop-world-array.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/frame-loop-world-array.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=kernel-worker-runtime.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kernel-worker-runtime.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/kernel-worker-runtime.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=migration-surface-inventory.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migration-surface-inventory.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/migration-surface-inventory.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=plugin-policy.integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-policy.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/plugin-policy.integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=plugin-profiles.unit.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-profiles.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/plugin-profiles.unit.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=profiler-default-off.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profiler-default-off.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/profiler-default-off.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=profiler-frame-token.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profiler-frame-token.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/profiler-frame-token.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=profiler-phase-catalog.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profiler-phase-catalog.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/profiler-phase-catalog.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=profiler-phase-integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profiler-phase-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/profiler-phase-integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=profiler-remote-bridge.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"profiler-remote-bridge.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/profiler-remote-bridge.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=remote-integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"remote-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/remote-integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=remote-serve-flag.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"remote-serve-flag.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/remote-serve-flag.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rhi-capture-capability.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rhi-capture-capability.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/rhi-capture-capability.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rhi-capture-host.integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rhi-capture-host.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rhi-capture-host.integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rhi-capture.browser.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rhi-capture.browser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rhi-capture.browser.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=surface-handoff.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"surface-handoff.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/surface-handoff.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types-m2.test-d.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-m2.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/types-m2.test-d.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=visibility-remote.integration.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visibility-remote.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/visibility-remote.integration.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=worker-execution-stop.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-execution-stop.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/worker-execution-stop.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,8 @@
1
+ import type { AnimationPayloadLookup } from '@forgeax/engine-animation';
2
+ import type { Asset } from '@forgeax/engine-types';
3
+ export interface AnimationPayloadSource {
4
+ lookup<T extends Asset = Asset>(guid: string): T | undefined;
5
+ }
6
+ /** Bridge the renderer-owned GUID catalogue into the animation plugin. */
7
+ export declare function createAnimationPayloadLookup(source: AnimationPayloadSource | undefined): AnimationPayloadLookup;
8
+ //# sourceMappingURL=animation-asset-lookup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"animation-asset-lookup.d.ts","sourceRoot":"","sources":["../src/animation-asset-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAiB,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC9D;AAED,0EAA0E;AAC1E,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,GAAG,SAAS,GACzC,sBAAsB,CAExB"}
@@ -0,0 +1,19 @@
1
+ import type { AssetDecoderLease, AssetRegistry } from '@forgeax/engine-assets-runtime';
2
+ import { type AssetDecoderContributionRef, type Result } from '@forgeax/engine-types';
3
+ export interface AssetRuntimeAssemblyError {
4
+ readonly code: 'asset-assembly-failed';
5
+ readonly expected: string;
6
+ readonly hint: string;
7
+ readonly detail: {
8
+ readonly kind: string;
9
+ readonly cause: unknown;
10
+ };
11
+ }
12
+ export interface AssetRuntimeAssembly {
13
+ readonly registry: AssetRegistry;
14
+ readonly leases: readonly AssetDecoderLease[];
15
+ dispose(): void;
16
+ }
17
+ /** Install owner decoder contributions into the realm's one asset registry. */
18
+ export declare function assembleAssetRuntime(registry: AssetRegistry, contributions: readonly AssetDecoderContributionRef[]): Result<AssetRuntimeAssembly, AssetRuntimeAssemblyError>;
19
+ //# sourceMappingURL=assets-runtime-assembly.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assets-runtime-assembly.d.ts","sourceRoot":"","sources":["../src/assets-runtime-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEvF,OAAO,EACL,KAAK,2BAA2B,EAIhC,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACrE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,SAAS,2BAA2B,EAAE,GACpD,MAAM,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CA0CzD"}
@@ -0,0 +1,4 @@
1
+ import type { World } from '@forgeax/engine-ecs';
2
+ /** Keep host-owned perspective camera aspect policy in one execution-tier seam. */
3
+ export declare function syncCameraAspect(world: World, canvasW: number, canvasH: number): void;
4
+ //# sourceMappingURL=canvas-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"canvas-policy.d.ts","sourceRoot":"","sources":["../src/canvas-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAWrF"}
@@ -0,0 +1,57 @@
1
+ import { type Result } from '@forgeax/engine-types';
2
+ export { syncCameraAspect } from './canvas-policy';
3
+ import type { App, AppAssembleArgs, AssembleAppError, BundlerOptions, CanvasAppError, CanvasDrawingBufferSize, CreateAppOptions, ExecutionApp } from './types';
4
+ /**
5
+ * createApp(canvas, opts?, bundler?) -- canvas thin wrapper SSOT (per
6
+ * plan-strategy D-5). Resolves with Result.ok(app) on success; failure routes
7
+ * through AppError | RhiError | EngineEnvironmentError per requirements AC-01.
8
+ *
9
+ * feat-20260608-create-app-param-surface-trim / M2 / D-3: the third arg is
10
+ * `BundlerOptions` (importTransport + shaderManifestUrl) -- the SSOT for
11
+ * host-injected build-tool emit knowledge. M3 demos collapse the third-arg
12
+ * literal to `forgeaxBundlerAdapter()` exported by `virtual:forgeax/bundler`.
13
+ *
14
+ * M3 ships the path needed by AC-05 (auto input acquisition plus an ECS scan
15
+ * plugin). M4 finalises the canvas-detached guard +
16
+ * EngineEnvironmentError try/catch + onError default fallback.
17
+ *
18
+ * The host-engine contract defines the boundary between host (DOM, canvas, UI)
19
+ * and engine (renderer, world, frame loop). Only the `createApp(canvas)` path
20
+ * auto-wires the aspect-sync sidecar; the assemble form and bare
21
+ * `createRenderer` path do not.
22
+ *
23
+ * @see {@link https://github.com/Ubpa/forgeax-engine/blob/main/docs/how-to/2026-06-18-host-engine-contract.md | Host-engine contract SSOT}
24
+ */
25
+ export declare function createApp(canvas: HTMLCanvasElement, opts: CreateAppOptions & {
26
+ readonly execution: NonNullable<CreateAppOptions['execution']>;
27
+ }, bundler?: BundlerOptions): Promise<Result<ExecutionApp, CanvasAppError>>;
28
+ export declare function createApp(canvas: HTMLCanvasElement, opts?: CreateAppOptions, bundler?: BundlerOptions): Promise<Result<App, CanvasAppError>>;
29
+ /**
30
+ * createApp({ renderer, world, input?, schedule?, ... }) -- assemble-form
31
+ * SSOT (per plan-strategy D-5). Host already owns renderer / world; the
32
+ * returned App holds them by reference equality (per AC-02).
33
+ *
34
+ * M3 wires the rAF frame-loop + listener-registry-backed onError. When
35
+ * args.input is supplied, the assemble form treats it as host-managed:
36
+ * it is exposed verbatim as app.input, and the host is responsible for
37
+ * detaching it (no auto-cleanup on stop). The canvas form is the entry
38
+ * that engages the auto-attach helper (input-attach.ts).
39
+ */
40
+ export declare function createApp(args: AppAssembleArgs): Promise<Result<App, AssembleAppError>>;
41
+ /**
42
+ * Synchronize a DOM canvas drawing buffer with its CSS size and device pixel
43
+ * ratio. Detached or zero-sized hosts are left untouched so a hidden canvas
44
+ * cannot be converted into a 1x1 render target accidentally.
45
+ */
46
+ export declare function syncCanvasDrawingBuffer(canvas: Pick<HTMLCanvasElement, 'clientWidth' | 'clientHeight' | 'width' | 'height'> & {
47
+ readonly style?: Pick<CSSStyleDeclaration, 'width' | 'height'>;
48
+ }, maxCanvasPixelRatio?: number): CanvasDrawingBufferSize;
49
+ /**
50
+ * Measure the next effective drawing buffer without writing the DOM canvas.
51
+ * This is the Worker host path because transferControlToOffscreen makes the
52
+ * HTML canvas dimensions immutable; the Worker owns the transferred surface.
53
+ */
54
+ export declare function measureCanvasDrawingBuffer(canvas: Pick<HTMLCanvasElement, 'clientWidth' | 'clientHeight' | 'width' | 'height'> & {
55
+ readonly style?: Pick<CSSStyleDeclaration, 'width' | 'height'>;
56
+ }, maxCanvasPixelRatio?: number): CanvasDrawingBufferSize;
57
+ //# sourceMappingURL=create-app.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../src/create-app.ts"],"names":[],"mappings":"AA+CA,OAAO,EAA6C,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAqCnD,OAAO,KAAK,EACV,GAAG,EACH,eAAe,EAEf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAiFjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,gBAAgB,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAA;CAAE,EAC3F,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;AACjD,wBAAgB,SAAS,CACvB,MAAM,EAAE,iBAAiB,EACzB,IAAI,CAAC,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;AAExC;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAuhBzF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;CAChE,EACD,mBAAmB,CAAC,EAAE,MAAM,GAC3B,uBAAuB,CAMzB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;CAChE,EACD,mBAAmB,CAAC,EAAE,MAAM,GAC3B,uBAAuB,CAOzB"}