@adobe/data 0.1.3 → 0.2.0

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 (591) hide show
  1. package/.cursorrules +28 -0
  2. package/.eslintrc.cjs +48 -0
  3. package/.github/CONTRIBUTING.md +47 -0
  4. package/CODE_OF_CONDUCT.md +79 -0
  5. package/LICENSE +21 -0
  6. package/README.md +2 -2
  7. package/asconfig.json +22 -0
  8. package/assembly/index.ts +85 -0
  9. package/assembly/tsconfig.json +17 -0
  10. package/c/build_run.sh +2 -0
  11. package/c/vector_addition +0 -0
  12. package/c/vector_addition.c +125 -0
  13. package/{cache/functions/types.js → config/license.js} +0 -2
  14. package/docs/perftest.html +28 -0
  15. package/index.html +10 -0
  16. package/package.json +49 -27
  17. package/scripts/deploy-docs.sh +41 -0
  18. package/{assembly-test/assembly.test.js → src/assembly-test/assembly.test.ts} +4 -4
  19. package/src/cache/async-cache.ts +38 -0
  20. package/{cache/blob-store.test.js → src/cache/blob-store.test.ts} +41 -7
  21. package/src/cache/blob-store.ts +278 -0
  22. package/src/cache/data-cache.test.ts +61 -0
  23. package/src/cache/data-cache.ts +183 -0
  24. package/src/cache/expiring-data-cache.test.ts +81 -0
  25. package/src/cache/expiring-data-cache.ts +61 -0
  26. package/src/cache/fallback-async-cache.ts +49 -0
  27. package/src/cache/functions/async-data-function.ts +25 -0
  28. package/src/cache/functions/functions.test.ts +84 -0
  29. package/{cache/functions/get-cached.test.js → src/cache/functions/get-cached.test.ts} +24 -7
  30. package/{cache/functions/get-cached.js → src/cache/functions/get-cached.ts} +12 -6
  31. package/{cache/functions/hashing/blob-to-hash.js → src/cache/functions/hashing/blob-to-hash.ts} +20 -18
  32. package/{cache/functions/hashing/buffer-to-hash.js → src/cache/functions/hashing/buffer-to-hash.ts} +7 -7
  33. package/src/cache/functions/hashing/hashing.test.ts +95 -0
  34. package/{cache/functions/hashing/index.js → src/cache/functions/hashing/index.ts} +1 -1
  35. package/{cache/functions/hashing/json-to-hash.js → src/cache/functions/hashing/json-to-hash.ts} +3 -3
  36. package/{cache/functions/hashing/string-to-hash.js → src/cache/functions/hashing/string-to-hash.ts} +11 -10
  37. package/{cache/functions/index.js → src/cache/functions/index.ts} +2 -4
  38. package/{cache/functions/memoize.js → src/cache/functions/memoize.ts} +22 -15
  39. package/src/cache/functions/prevent-parallel-execution.ts +50 -0
  40. package/src/cache/get-persistent-cache.ts +62 -0
  41. package/{cache/index.js → src/cache/index.ts} +9 -3
  42. package/src/cache/managed-array.ts +243 -0
  43. package/{cache/managed-async-cache.browser.test.js → src/cache/managed-async-cache.browser.test.ts} +27 -24
  44. package/src/cache/managed-async-cache.ts +78 -0
  45. package/src/cache/memory-allocator.ts +176 -0
  46. package/src/cache/memory-async-cache.ts +51 -0
  47. package/src/data.ts +38 -0
  48. package/src/ecs/README.md +21 -0
  49. package/src/ecs/archetype/archetype.ts +39 -0
  50. package/src/ecs/archetype/create-archetype.test.ts +115 -0
  51. package/src/ecs/archetype/create-archetype.ts +52 -0
  52. package/src/ecs/archetype/delete-row.test.ts +110 -0
  53. package/src/ecs/archetype/delete-row.ts +37 -0
  54. package/src/ecs/archetype/index.ts +24 -0
  55. package/src/ecs/component-schemas.ts +24 -0
  56. package/src/ecs/core-components.ts +443 -0
  57. package/src/ecs/database/create-database.test.ts +745 -0
  58. package/src/ecs/database/create-database.ts +205 -0
  59. package/src/ecs/database/database.ts +81 -0
  60. package/src/ecs/database/index.ts +24 -0
  61. package/src/ecs/database/observe-dependent-value.test.ts +198 -0
  62. package/src/ecs/database/observe-dependent-value.ts +78 -0
  63. package/src/ecs/database/transactional-store/create-transactional-store.test.ts +250 -0
  64. package/src/ecs/database/transactional-store/create-transactional-store.ts +281 -0
  65. package/{ecs/ecs/ecs-types.js → src/ecs/database/transactional-store/index.ts} +1 -2
  66. package/src/ecs/database/transactional-store/transactional-store.ts +80 -0
  67. package/src/ecs/entity-location-table/create-entity-location-table.test.ts +170 -0
  68. package/src/ecs/entity-location-table/create-entity-location-table.ts +96 -0
  69. package/src/ecs/entity-location-table/entity-location-table.ts +30 -0
  70. package/{core/schema/schema.js → src/ecs/entity-location-table/entity-location.ts} +11 -11
  71. package/src/ecs/entity-location-table/index.ts +23 -0
  72. package/src/ecs/entity.ts +26 -0
  73. package/src/ecs/index.ts +26 -0
  74. package/src/ecs/store/core/core.ts +71 -0
  75. package/src/ecs/store/core/create-core.test.ts +440 -0
  76. package/src/ecs/store/core/create-core.ts +168 -0
  77. package/{cache/async-cache.js → src/ecs/store/core/index.ts} +1 -2
  78. package/src/ecs/store/create-store.test.ts +562 -0
  79. package/src/ecs/store/create-store.ts +97 -0
  80. package/src/ecs/store/index.ts +23 -0
  81. package/{types/types.js → src/ecs/store/resource-components.ts} +2 -6
  82. package/src/ecs/store/store.ts +55 -0
  83. package/src/equals-shallow.test.ts +133 -0
  84. package/src/equals-shallow.ts +37 -0
  85. package/src/equals.test.ts +175 -0
  86. package/src/equals.ts +70 -0
  87. package/src/index.ts +27 -0
  88. package/src/internal/array-buffer-like/copy.ts +469 -0
  89. package/src/internal/array-buffer-like/grow.ts +53 -0
  90. package/{core/index.js → src/internal/array-buffer-like/index.ts} +4 -4
  91. package/src/internal/array-buffer-like/is-array-buffer.ts +445 -0
  92. package/src/internal/array-buffer-like/is-shared-array-buffer.ts +445 -0
  93. package/{core/functions/is-async-generator.js → src/internal/async-generator/is-async-generator.ts} +2 -2
  94. package/{core/schema.js → src/internal/data-view-32/create-data-view-32.ts} +8 -11
  95. package/src/internal/data-view-32/data-view-32.ts +447 -0
  96. package/{ecs/action-ecs/index.js → src/internal/data-view-32/index.ts} +2 -2
  97. package/src/internal/function/memoize-factory.ts +12 -0
  98. package/src/internal/object/index.ts +23 -0
  99. package/{cache/functions/bind-functions.js → src/internal/object/map-entries.ts} +6 -11
  100. package/src/internal/promise/is-promise.ts +28 -0
  101. package/src/internal/typed-array/get-byte-size.ts +50 -0
  102. package/src/internal/typed-array/index.ts +24 -0
  103. package/src/internal/typed-array/typed-array-constructer.ts +32 -0
  104. package/src/internal/typed-array/typed-array.ts +25 -0
  105. package/src/is-data.ts +47 -0
  106. package/src/lit/decorators/apply-decorator.ts +24 -0
  107. package/src/lit/decorators/apply-service-decorators.ts +13 -0
  108. package/src/lit/decorators/index.ts +24 -0
  109. package/src/lit/decorators/require-service.ts +19 -0
  110. package/src/lit/elements/index.ts +3 -0
  111. package/src/lit/elements/service-application.ts +26 -0
  112. package/src/lit/elements/service-context.ts +3 -0
  113. package/src/lit/elements/service-element.ts +18 -0
  114. package/src/lit/hooks/component/component.ts +10 -0
  115. package/src/lit/hooks/component/stack.ts +17 -0
  116. package/src/lit/hooks/index.ts +13 -0
  117. package/src/lit/hooks/use-connected.ts +39 -0
  118. package/src/lit/hooks/use-effect.ts +17 -0
  119. package/src/lit/hooks/use-element.ts +8 -0
  120. package/src/lit/hooks/use-memo.ts +14 -0
  121. package/src/lit/hooks/use-observable-values.ts +9 -0
  122. package/src/lit/hooks/use-observable.ts +13 -0
  123. package/src/lit/hooks/use-ref.ts +6 -0
  124. package/src/lit/hooks/use-resize-observer.ts +27 -0
  125. package/src/lit/hooks/use-state.ts +17 -0
  126. package/src/lit/hooks/use-window-event.ts +14 -0
  127. package/src/lit/hooks/with-hooks.ts +20 -0
  128. package/src/lit/index.ts +3 -0
  129. package/src/mutable-clone.ts +29 -0
  130. package/{core/data.test.js → src/normalize.test.ts} +22 -22
  131. package/src/normalize.ts +37 -0
  132. package/src/observe/create-observable-event.ts +47 -0
  133. package/src/observe/create-observable-state.ts +51 -0
  134. package/src/observe/create-persisted-state.test.ts +143 -0
  135. package/src/observe/create-persisted-state.ts +60 -0
  136. package/src/observe/create-query-state.ts +70 -0
  137. package/{observe/from-array.js → src/observe/from-array.ts} +14 -3
  138. package/{service/service.js → src/observe/from-constant.ts} +13 -4
  139. package/{observe/from-element-id.js → src/observe/from-element-id.ts} +44 -39
  140. package/src/observe/from-element-properties-and-events.ts +47 -0
  141. package/{observe/from-element-property.js → src/observe/from-element-property.ts} +33 -25
  142. package/src/observe/from-promise-with-error.ts +51 -0
  143. package/src/observe/from-promise.ts +49 -0
  144. package/src/observe/from-properties.ts +67 -0
  145. package/{observe/index.js → src/observe/index.ts} +4 -1
  146. package/src/observe/observe.test.ts +467 -0
  147. package/src/observe/to-promise.ts +40 -0
  148. package/src/observe/to-properties.ts +41 -0
  149. package/src/observe/types.ts +40 -0
  150. package/src/observe/with-async-map.ts +37 -0
  151. package/src/observe/with-batch.test.ts +141 -0
  152. package/src/observe/with-batch.ts +67 -0
  153. package/{core/data.js → src/observe/with-cache.ts} +32 -26
  154. package/src/observe/with-copy.ts +32 -0
  155. package/src/observe/with-deduplicate-data.ts +43 -0
  156. package/src/observe/with-deduplicate.ts +41 -0
  157. package/src/observe/with-default.ts +48 -0
  158. package/src/observe/with-lazy.test.ts +68 -0
  159. package/{core/functions/is-promise.js → src/observe/with-lazy.ts} +17 -5
  160. package/{observe/with-map-data.js → src/observe/with-map-data.ts} +9 -3
  161. package/src/observe/with-map.ts +36 -0
  162. package/src/observe/with-optional.ts +47 -0
  163. package/src/observe/with-unwrap.ts +54 -0
  164. package/src/old-ecs/action-ecs/action-ecs.test.ts +420 -0
  165. package/src/old-ecs/action-ecs/action-ecs.ts +274 -0
  166. package/src/old-ecs/action-ecs/action-types.ts +178 -0
  167. package/src/old-ecs/action-ecs/index.ts +29 -0
  168. package/{service/sequential-action.js → src/old-ecs/action-ecs/sequential-action.ts} +19 -4
  169. package/src/old-ecs/core-ecs/core-ecs-serialization.test.ts +244 -0
  170. package/src/old-ecs/core-ecs/core-ecs-types.ts +183 -0
  171. package/src/old-ecs/core-ecs/core-ecs.test.ts +474 -0
  172. package/src/old-ecs/core-ecs/core-ecs.ts +640 -0
  173. package/{core/functions/index.js → src/old-ecs/core-ecs/index.ts} +9 -4
  174. package/src/old-ecs/ecs/ecs-types.ts +189 -0
  175. package/src/old-ecs/ecs/ecs-where-functions.ts +95 -0
  176. package/src/old-ecs/ecs/ecs.test.ts +461 -0
  177. package/src/old-ecs/ecs/ecs.ts +279 -0
  178. package/{ecs/core-ecs/core-ecs-types.js → src/old-ecs/ecs/index.ts} +2 -2
  179. package/src/old-ecs/entity.ts +26 -0
  180. package/{ecs/index.js → src/old-ecs/index.ts} +1 -1
  181. package/{ecs/transaction-ecs/index.js → src/old-ecs/transaction-ecs/index.ts} +0 -1
  182. package/src/old-ecs/transaction-ecs/transaction-ecs.test.ts +725 -0
  183. package/src/old-ecs/transaction-ecs/transaction-ecs.ts +283 -0
  184. package/src/old-ecs/transaction-ecs/transaction-types.ts +248 -0
  185. package/src/old-ecs/transaction-ecs/transactions.ts +243 -0
  186. package/src/perftest/ecs-perf.ts +255 -0
  187. package/src/perftest/helper-functions.ts +31 -0
  188. package/src/perftest/horizon-perf.ts +132 -0
  189. package/{perftest/index.js → src/perftest/index.ts} +9 -7
  190. package/src/perftest/perf-test.ts +193 -0
  191. package/src/perftest/perf.md +90 -0
  192. package/src/perftest/vanilla-perf.ts +136 -0
  193. package/src/schema/boolean.ts +5 -0
  194. package/src/schema/dynamic/deep-merge.test.ts +100 -0
  195. package/src/schema/dynamic/deep-merge.ts +67 -0
  196. package/{core/schema/dynamic/enumerate-patches.test.js → src/schema/dynamic/enumerate-patches.test.ts} +49 -23
  197. package/{core/schema/dynamic/enumerate-patches.js → src/schema/dynamic/enumerate-patches.ts} +44 -4
  198. package/{core/schema/dynamic/get-dynamic-schema.test.js → src/schema/dynamic/get-dynamic-schema.test.ts} +41 -6
  199. package/src/schema/dynamic/get-dynamic-schema.ts +48 -0
  200. package/src/schema/dynamic/index.ts +22 -0
  201. package/src/schema/f32.ts +30 -0
  202. package/src/schema/i32.ts +31 -0
  203. package/src/schema/index.ts +32 -0
  204. package/{cache/functions/omit.js → src/schema/nullable.ts} +10 -7
  205. package/src/schema/schema.ts +229 -0
  206. package/src/schema/time.ts +5 -0
  207. package/src/schema/true.ts +26 -0
  208. package/src/schema/tuple.ts +5 -0
  209. package/src/schema/u32.ts +31 -0
  210. package/{core/schema/validation/is-valid.test.js → src/schema/validation/is-valid.test.ts} +6 -3
  211. package/{core/functions/array-equals.js → src/schema/validation/is-valid.ts} +8 -10
  212. package/{core/schema/validation/validate.test.js → src/schema/validation/validate.test.ts} +18 -4
  213. package/{core/schema/validation/validate.js → src/schema/validation/validate.ts} +9 -6
  214. package/{core/functions/with-validation.test.js → src/schema/validation/with-validation.test.ts} +28 -12
  215. package/{core/functions/with-validation.js → src/schema/validation/with-validation.ts} +14 -10
  216. package/src/schema.test.ts +55 -0
  217. package/src/service/add-observable-actions.ts +207 -0
  218. package/{service/index.js → src/service/index.ts} +4 -4
  219. package/src/service/is-service.ts +7 -0
  220. package/src/service/progressive-result.ts +141 -0
  221. package/src/service/service.ts +27 -0
  222. package/src/table/add-row.ts +42 -0
  223. package/src/table/create-table.ts +36 -0
  224. package/src/table/delete-row.ts +42 -0
  225. package/src/table/ensure-capacity.ts +37 -0
  226. package/src/table/get-row-data.ts +31 -0
  227. package/src/table/index.ts +29 -0
  228. package/src/table/row-index.ts +26 -0
  229. package/src/table/table.ts +32 -0
  230. package/src/table/update-row.ts +35 -0
  231. package/src/tsconfig.json +6 -0
  232. package/src/typed-buffer/copy-to-gpu-buffer.ts +23 -0
  233. package/{cache/expiring-data-cache.js → src/typed-buffer/create-array-buffer.ts} +31 -25
  234. package/src/typed-buffer/create-number-buffer.ts +90 -0
  235. package/src/typed-buffer/create-struct-buffer.ts +93 -0
  236. package/src/typed-buffer/create-typed-buffer.ts +49 -0
  237. package/src/typed-buffer/index.ts +26 -0
  238. package/src/typed-buffer/structs/assert-struct.ts +37 -0
  239. package/src/typed-buffer/structs/create-read-struct.test.ts +202 -0
  240. package/src/typed-buffer/structs/create-read-struct.ts +77 -0
  241. package/src/typed-buffer/structs/create-write-struct.ts +73 -0
  242. package/src/typed-buffer/structs/get-field-offset.ts +36 -0
  243. package/src/typed-buffer/structs/get-struct-layout.test.ts +146 -0
  244. package/src/typed-buffer/structs/get-struct-layout.ts +222 -0
  245. package/src/typed-buffer/structs/index.ts +22 -0
  246. package/src/typed-buffer/structs/read-struct.ts +25 -0
  247. package/src/typed-buffer/structs/struct-layout.ts +465 -0
  248. package/src/typed-buffer/structs/write-struct.test.ts +195 -0
  249. package/src/typed-buffer/structs/write-struct.ts +25 -0
  250. package/src/typed-buffer/typed-buffer.test.ts +253 -0
  251. package/src/typed-buffer/typed-buffer.ts +41 -0
  252. package/src/types/assert.ts +22 -0
  253. package/src/types/equal.ts +24 -0
  254. package/{types/index.js → src/types/index.ts} +3 -1
  255. package/src/types/types.ts +166 -0
  256. package/tsconfig-base.json +25 -0
  257. package/tsconfig.json +8 -0
  258. package/typedoc.json +22 -0
  259. package/vite.config.js +16 -0
  260. package/assembly/index.d.ts +0 -30
  261. package/assembly/index.js +0 -18
  262. package/assembly/index.wasm +0 -0
  263. package/assembly/index.wasm.map +0 -1
  264. package/assembly-test/assembly.test.d.ts +0 -1
  265. package/assembly-test/assembly.test.js.map +0 -1
  266. package/cache/async-cache.d.ts +0 -15
  267. package/cache/async-cache.js.map +0 -1
  268. package/cache/blob-store.d.ts +0 -94
  269. package/cache/blob-store.js +0 -191
  270. package/cache/blob-store.js.map +0 -1
  271. package/cache/blob-store.test.d.ts +0 -1
  272. package/cache/blob-store.test.js.map +0 -1
  273. package/cache/data-cache.d.ts +0 -38
  274. package/cache/data-cache.js +0 -96
  275. package/cache/data-cache.js.map +0 -1
  276. package/cache/data-cache.test.d.ts +0 -1
  277. package/cache/data-cache.test.js +0 -50
  278. package/cache/data-cache.test.js.map +0 -1
  279. package/cache/expiring-data-cache.d.ts +0 -6
  280. package/cache/expiring-data-cache.js.map +0 -1
  281. package/cache/expiring-data-cache.test.d.ts +0 -1
  282. package/cache/expiring-data-cache.test.js +0 -62
  283. package/cache/expiring-data-cache.test.js.map +0 -1
  284. package/cache/fallback-async-cache.d.ts +0 -7
  285. package/cache/fallback-async-cache.js +0 -22
  286. package/cache/fallback-async-cache.js.map +0 -1
  287. package/cache/functions/bind-functions.d.ts +0 -6
  288. package/cache/functions/bind-functions.js.map +0 -1
  289. package/cache/functions/functions.test.d.ts +0 -1
  290. package/cache/functions/functions.test.js +0 -79
  291. package/cache/functions/functions.test.js.map +0 -1
  292. package/cache/functions/get-cached.d.ts +0 -11
  293. package/cache/functions/get-cached.js.map +0 -1
  294. package/cache/functions/get-cached.test.d.ts +0 -1
  295. package/cache/functions/get-cached.test.js.map +0 -1
  296. package/cache/functions/hashing/blob-to-hash.d.ts +0 -4
  297. package/cache/functions/hashing/blob-to-hash.js.map +0 -1
  298. package/cache/functions/hashing/buffer-to-hash.d.ts +0 -4
  299. package/cache/functions/hashing/buffer-to-hash.js.map +0 -1
  300. package/cache/functions/hashing/hashing.test.d.ts +0 -1
  301. package/cache/functions/hashing/hashing.test.js +0 -95
  302. package/cache/functions/hashing/hashing.test.js.map +0 -1
  303. package/cache/functions/hashing/index.d.ts +0 -4
  304. package/cache/functions/hashing/index.js.map +0 -1
  305. package/cache/functions/hashing/json-to-hash.d.ts +0 -4
  306. package/cache/functions/hashing/json-to-hash.js.map +0 -1
  307. package/cache/functions/hashing/string-to-hash.d.ts +0 -4
  308. package/cache/functions/hashing/string-to-hash.js.map +0 -1
  309. package/cache/functions/index.d.ts +0 -5
  310. package/cache/functions/index.js.map +0 -1
  311. package/cache/functions/memoize.d.ts +0 -12
  312. package/cache/functions/memoize.js.map +0 -1
  313. package/cache/functions/omit.d.ts +0 -1
  314. package/cache/functions/omit.js.map +0 -1
  315. package/cache/functions/prevent-parallel-execution.d.ts +0 -7
  316. package/cache/functions/prevent-parallel-execution.js +0 -25
  317. package/cache/functions/prevent-parallel-execution.js.map +0 -1
  318. package/cache/functions/types.d.ts +0 -1
  319. package/cache/functions/types.js.map +0 -1
  320. package/cache/get-persistent-cache.d.ts +0 -12
  321. package/cache/get-persistent-cache.js +0 -23
  322. package/cache/get-persistent-cache.js.map +0 -1
  323. package/cache/index.d.ts +0 -3
  324. package/cache/index.js.map +0 -1
  325. package/cache/managed-array.d.ts +0 -23
  326. package/cache/managed-array.js +0 -160
  327. package/cache/managed-array.js.map +0 -1
  328. package/cache/managed-async-cache.browser.test.d.ts +0 -1
  329. package/cache/managed-async-cache.browser.test.js.map +0 -1
  330. package/cache/managed-async-cache.d.ts +0 -4
  331. package/cache/managed-async-cache.js +0 -45
  332. package/cache/managed-async-cache.js.map +0 -1
  333. package/cache/memory-allocator.d.ts +0 -23
  334. package/cache/memory-allocator.js +0 -94
  335. package/cache/memory-allocator.js.map +0 -1
  336. package/cache/memory-async-cache.d.ts +0 -6
  337. package/cache/memory-async-cache.js +0 -23
  338. package/cache/memory-async-cache.js.map +0 -1
  339. package/core/data.d.ts +0 -22
  340. package/core/data.js.map +0 -1
  341. package/core/data.test.d.ts +0 -1
  342. package/core/data.test.js.map +0 -1
  343. package/core/functions/array-equals.d.ts +0 -1
  344. package/core/functions/array-equals.js.map +0 -1
  345. package/core/functions/deep-merge.d.ts +0 -32
  346. package/core/functions/deep-merge.js +0 -54
  347. package/core/functions/deep-merge.js.map +0 -1
  348. package/core/functions/deep-merge.test.d.ts +0 -1
  349. package/core/functions/deep-merge.test.js +0 -94
  350. package/core/functions/deep-merge.test.js.map +0 -1
  351. package/core/functions/index.d.ts +0 -3
  352. package/core/functions/index.js.map +0 -1
  353. package/core/functions/is-async-generator.d.ts +0 -1
  354. package/core/functions/is-async-generator.js.map +0 -1
  355. package/core/functions/is-promise.d.ts +0 -1
  356. package/core/functions/is-promise.js.map +0 -1
  357. package/core/functions/with-validation.d.ts +0 -5
  358. package/core/functions/with-validation.js.map +0 -1
  359. package/core/functions/with-validation.test.d.ts +0 -1
  360. package/core/functions/with-validation.test.js.map +0 -1
  361. package/core/index.d.ts +0 -3
  362. package/core/index.js.map +0 -1
  363. package/core/schema/dynamic/dynamic-schema.d.ts +0 -27
  364. package/core/schema/dynamic/dynamic-schema.js +0 -2
  365. package/core/schema/dynamic/dynamic-schema.js.map +0 -1
  366. package/core/schema/dynamic/enumerate-patches.d.ts +0 -9
  367. package/core/schema/dynamic/enumerate-patches.js.map +0 -1
  368. package/core/schema/dynamic/enumerate-patches.test.d.ts +0 -134
  369. package/core/schema/dynamic/enumerate-patches.test.js.map +0 -1
  370. package/core/schema/dynamic/get-dynamic-schema.d.ts +0 -5
  371. package/core/schema/dynamic/get-dynamic-schema.js +0 -26
  372. package/core/schema/dynamic/get-dynamic-schema.js.map +0 -1
  373. package/core/schema/dynamic/get-dynamic-schema.test.d.ts +0 -1
  374. package/core/schema/dynamic/get-dynamic-schema.test.js.map +0 -1
  375. package/core/schema/dynamic/index.d.ts +0 -1
  376. package/core/schema/dynamic/index.js +0 -2
  377. package/core/schema/dynamic/index.js.map +0 -1
  378. package/core/schema/dynamic/schema-path-value-path.d.ts +0 -5
  379. package/core/schema/dynamic/schema-path-value-path.js +0 -12
  380. package/core/schema/dynamic/schema-path-value-path.js.map +0 -1
  381. package/core/schema/dynamic-schema.d.ts +0 -27
  382. package/core/schema/dynamic-schema.js +0 -2
  383. package/core/schema/dynamic-schema.js.map +0 -1
  384. package/core/schema/index.d.ts +0 -4
  385. package/core/schema/index.js +0 -26
  386. package/core/schema/index.js.map +0 -1
  387. package/core/schema/schema.d.ts +0 -122
  388. package/core/schema/schema.js.map +0 -1
  389. package/core/schema/schemas.d.ts +0 -45
  390. package/core/schema/schemas.js +0 -39
  391. package/core/schema/schemas.js.map +0 -1
  392. package/core/schema/ui-schema.d.ts +0 -25
  393. package/core/schema/ui-schema.js +0 -2
  394. package/core/schema/ui-schema.js.map +0 -1
  395. package/core/schema/validation/is-valid.d.ts +0 -2
  396. package/core/schema/validation/is-valid.js +0 -14
  397. package/core/schema/validation/is-valid.js.map +0 -1
  398. package/core/schema/validation/is-valid.test.d.ts +0 -1
  399. package/core/schema/validation/is-valid.test.js.map +0 -1
  400. package/core/schema/validation/validate.d.ts +0 -2
  401. package/core/schema/validation/validate.js.map +0 -1
  402. package/core/schema/validation/validate.test.d.ts +0 -1
  403. package/core/schema/validation/validate.test.js.map +0 -1
  404. package/core/schema/validation/with-validation.d.ts +0 -5
  405. package/core/schema/validation/with-validation.js +0 -16
  406. package/core/schema/validation/with-validation.js.map +0 -1
  407. package/core/schema/validation/with-validation.test.d.ts +0 -1
  408. package/core/schema/validation/with-validation.test.js +0 -96
  409. package/core/schema/validation/with-validation.test.js.map +0 -1
  410. package/core/schema.d.ts +0 -86
  411. package/core/schema.js.map +0 -1
  412. package/core/schema.test.d.ts +0 -1
  413. package/core/schema.test.js +0 -16
  414. package/core/schema.test.js.map +0 -1
  415. package/core/schemas.d.ts +0 -45
  416. package/core/schemas.js +0 -39
  417. package/core/schemas.js.map +0 -1
  418. package/ecs/action-ecs/action-ecs.d.ts +0 -19
  419. package/ecs/action-ecs/action-ecs.js +0 -203
  420. package/ecs/action-ecs/action-ecs.js.map +0 -1
  421. package/ecs/action-ecs/action-ecs.test.d.ts +0 -1
  422. package/ecs/action-ecs/action-ecs.test.js +0 -362
  423. package/ecs/action-ecs/action-ecs.test.js.map +0 -1
  424. package/ecs/action-ecs/action-types.d.ts +0 -106
  425. package/ecs/action-ecs/action-types.js +0 -19
  426. package/ecs/action-ecs/action-types.js.map +0 -1
  427. package/ecs/action-ecs/index.d.ts +0 -2
  428. package/ecs/action-ecs/index.js.map +0 -1
  429. package/ecs/core-ecs/core-ecs-serialization.test.d.ts +0 -1
  430. package/ecs/core-ecs/core-ecs-serialization.test.js +0 -230
  431. package/ecs/core-ecs/core-ecs-serialization.test.js.map +0 -1
  432. package/ecs/core-ecs/core-ecs-types.d.ts +0 -141
  433. package/ecs/core-ecs/core-ecs-types.js.map +0 -1
  434. package/ecs/core-ecs/core-ecs.d.ts +0 -7
  435. package/ecs/core-ecs/core-ecs.js +0 -492
  436. package/ecs/core-ecs/core-ecs.js.map +0 -1
  437. package/ecs/core-ecs/core-ecs.test.d.ts +0 -1
  438. package/ecs/core-ecs/core-ecs.test.js +0 -425
  439. package/ecs/core-ecs/core-ecs.test.js.map +0 -1
  440. package/ecs/core-ecs/index.d.ts +0 -1
  441. package/ecs/core-ecs/index.js +0 -2
  442. package/ecs/core-ecs/index.js.map +0 -1
  443. package/ecs/ecs/ecs-types.d.ts +0 -132
  444. package/ecs/ecs/ecs-types.js.map +0 -1
  445. package/ecs/ecs/ecs-where-functions.d.ts +0 -6
  446. package/ecs/ecs/ecs-where-functions.js +0 -91
  447. package/ecs/ecs/ecs-where-functions.js.map +0 -1
  448. package/ecs/ecs/ecs.d.ts +0 -13
  449. package/ecs/ecs/ecs.js +0 -177
  450. package/ecs/ecs/ecs.js.map +0 -1
  451. package/ecs/ecs/ecs.test.d.ts +0 -1
  452. package/ecs/ecs/ecs.test.js +0 -399
  453. package/ecs/ecs/ecs.test.js.map +0 -1
  454. package/ecs/ecs/index.d.ts +0 -3
  455. package/ecs/ecs/index.js +0 -3
  456. package/ecs/ecs/index.js.map +0 -1
  457. package/ecs/index.d.ts +0 -4
  458. package/ecs/index.js.map +0 -1
  459. package/ecs/transaction-ecs/index.d.ts +0 -2
  460. package/ecs/transaction-ecs/index.js.map +0 -1
  461. package/ecs/transaction-ecs/transaction-ecs.d.ts +0 -11
  462. package/ecs/transaction-ecs/transaction-ecs.js +0 -184
  463. package/ecs/transaction-ecs/transaction-ecs.js.map +0 -1
  464. package/ecs/transaction-ecs/transaction-ecs.test.d.ts +0 -1
  465. package/ecs/transaction-ecs/transaction-ecs.test.js +0 -599
  466. package/ecs/transaction-ecs/transaction-ecs.test.js.map +0 -1
  467. package/ecs/transaction-ecs/transaction-types.d.ts +0 -135
  468. package/ecs/transaction-ecs/transaction-types.js +0 -2
  469. package/ecs/transaction-ecs/transaction-types.js.map +0 -1
  470. package/ecs/transaction-ecs/transactions.d.ts +0 -5
  471. package/ecs/transaction-ecs/transactions.js +0 -158
  472. package/ecs/transaction-ecs/transactions.js.map +0 -1
  473. package/index.d.ts +0 -1
  474. package/index.js +0 -23
  475. package/index.js.map +0 -1
  476. package/observe/create-observable-event.d.ts +0 -10
  477. package/observe/create-observable-event.js +0 -22
  478. package/observe/create-observable-event.js.map +0 -1
  479. package/observe/create-observable-state.d.ts +0 -7
  480. package/observe/create-observable-state.js +0 -27
  481. package/observe/create-observable-state.js.map +0 -1
  482. package/observe/create-persisted-state.d.ts +0 -11
  483. package/observe/create-persisted-state.js +0 -31
  484. package/observe/create-persisted-state.js.map +0 -1
  485. package/observe/create-persisted-state.test.d.ts +0 -1
  486. package/observe/create-persisted-state.test.js +0 -124
  487. package/observe/create-persisted-state.test.js.map +0 -1
  488. package/observe/from-array.d.ts +0 -5
  489. package/observe/from-array.js.map +0 -1
  490. package/observe/from-constant.d.ts +0 -5
  491. package/observe/from-constant.js +0 -12
  492. package/observe/from-constant.js.map +0 -1
  493. package/observe/from-element-id.d.ts +0 -7
  494. package/observe/from-element-id.js.map +0 -1
  495. package/observe/from-element-properties-and-events.d.ts +0 -2
  496. package/observe/from-element-properties-and-events.js +0 -18
  497. package/observe/from-element-properties-and-events.js.map +0 -1
  498. package/observe/from-element-property.d.ts +0 -11
  499. package/observe/from-element-property.js.map +0 -1
  500. package/observe/from-promise-with-error.d.ts +0 -7
  501. package/observe/from-promise-with-error.js +0 -27
  502. package/observe/from-promise-with-error.js.map +0 -1
  503. package/observe/from-promise.d.ts +0 -6
  504. package/observe/from-promise.js +0 -22
  505. package/observe/from-promise.js.map +0 -1
  506. package/observe/from-properties.d.ts +0 -10
  507. package/observe/from-properties.js +0 -33
  508. package/observe/from-properties.js.map +0 -1
  509. package/observe/index.d.ts +0 -27
  510. package/observe/index.js.map +0 -1
  511. package/observe/observe.test.d.ts +0 -7
  512. package/observe/observe.test.js +0 -417
  513. package/observe/observe.test.js.map +0 -1
  514. package/observe/to-promise.d.ts +0 -8
  515. package/observe/to-promise.js +0 -18
  516. package/observe/to-promise.js.map +0 -1
  517. package/observe/to-properties.d.ts +0 -11
  518. package/observe/to-properties.js +0 -9
  519. package/observe/to-properties.js.map +0 -1
  520. package/observe/types.d.ts +0 -17
  521. package/observe/types.js +0 -2
  522. package/observe/types.js.map +0 -1
  523. package/observe/with-async-map.d.ts +0 -6
  524. package/observe/with-async-map.js +0 -12
  525. package/observe/with-async-map.js.map +0 -1
  526. package/observe/with-cache.d.ts +0 -6
  527. package/observe/with-cache.js +0 -33
  528. package/observe/with-cache.js.map +0 -1
  529. package/observe/with-copy.d.ts +0 -5
  530. package/observe/with-copy.js +0 -10
  531. package/observe/with-copy.js.map +0 -1
  532. package/observe/with-deduplicate-data.d.ts +0 -7
  533. package/observe/with-deduplicate-data.js +0 -18
  534. package/observe/with-deduplicate-data.js.map +0 -1
  535. package/observe/with-deduplicate.d.ts +0 -6
  536. package/observe/with-deduplicate.js +0 -19
  537. package/observe/with-deduplicate.js.map +0 -1
  538. package/observe/with-default.d.ts +0 -6
  539. package/observe/with-default.js +0 -21
  540. package/observe/with-default.js.map +0 -1
  541. package/observe/with-map-data.d.ts +0 -7
  542. package/observe/with-map-data.js.map +0 -1
  543. package/observe/with-map.d.ts +0 -5
  544. package/observe/with-map.js +0 -11
  545. package/observe/with-map.js.map +0 -1
  546. package/observe/with-optional.d.ts +0 -5
  547. package/observe/with-optional.js +0 -20
  548. package/observe/with-optional.js.map +0 -1
  549. package/observe/with-unwrap.d.ts +0 -5
  550. package/observe/with-unwrap.js +0 -26
  551. package/observe/with-unwrap.js.map +0 -1
  552. package/perftest/ecs-perf.d.ts +0 -49
  553. package/perftest/ecs-perf.js +0 -230
  554. package/perftest/ecs-perf.js.map +0 -1
  555. package/perftest/helper-functions.d.ts +0 -1
  556. package/perftest/helper-functions.js +0 -31
  557. package/perftest/helper-functions.js.map +0 -1
  558. package/perftest/horizon-perf.d.ts +0 -22
  559. package/perftest/horizon-perf.js +0 -126
  560. package/perftest/horizon-perf.js.map +0 -1
  561. package/perftest/index.d.ts +0 -1
  562. package/perftest/index.js.map +0 -1
  563. package/perftest/perf-test.d.ts +0 -18
  564. package/perftest/perf-test.js +0 -124
  565. package/perftest/perf-test.js.map +0 -1
  566. package/perftest/vanilla-perf.d.ts +0 -38
  567. package/perftest/vanilla-perf.js +0 -128
  568. package/perftest/vanilla-perf.js.map +0 -1
  569. package/schemas/index.d.ts +0 -1
  570. package/schemas/index.js +0 -23
  571. package/schemas/index.js.map +0 -1
  572. package/schemas/schemas.d.ts +0 -45
  573. package/schemas/schemas.js +0 -39
  574. package/schemas/schemas.js.map +0 -1
  575. package/service/add-observable-actions.d.ts +0 -29
  576. package/service/add-observable-actions.js +0 -108
  577. package/service/add-observable-actions.js.map +0 -1
  578. package/service/index.d.ts +0 -4
  579. package/service/index.js.map +0 -1
  580. package/service/progressive-result.d.ts +0 -96
  581. package/service/progressive-result.js +0 -99
  582. package/service/progressive-result.js.map +0 -1
  583. package/service/sequential-action.d.ts +0 -18
  584. package/service/sequential-action.js.map +0 -1
  585. package/service/service.d.ts +0 -4
  586. package/service/service.js.map +0 -1
  587. package/tsconfig.tsbuildinfo +0 -1
  588. package/types/index.d.ts +0 -1
  589. package/types/index.js.map +0 -1
  590. package/types/types.d.ts +0 -61
  591. package/types/types.js.map +0 -1
@@ -0,0 +1,243 @@
1
+ /*MIT License
2
+
3
+ © Copyright 2025 Adobe. All rights reserved.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.*/
22
+
23
+ import { DELETE } from "../core-ecs/core-ecs.js";
24
+ import {
25
+ Archetype,
26
+ ECS,
27
+ ECSArchetypes,
28
+ ECSComponents,
29
+ ECSResources,
30
+ ECSWrite,
31
+ } from "../ecs/ecs-types.js";
32
+ import {
33
+ EntityCreateValues,
34
+ Entity,
35
+ EntityUpdateValues,
36
+ } from "../core-ecs/core-ecs-types.js";
37
+ import {
38
+ Transaction,
39
+ TransactionCancel,
40
+ TransactionChanges,
41
+ TransactionCommit,
42
+ TransactionComplete,
43
+ TransactionECS,
44
+ TransactionOptions,
45
+ TransactionUpdateOperation,
46
+ TransactionWriteOperation,
47
+ } from "./transaction-types.js";
48
+
49
+ export function createECSTransaction<
50
+ C extends ECSComponents, // name => Component Value Type
51
+ A extends ECSArchetypes, // name => Entity Values Type
52
+ R extends ECSResources, // name => Resource Value Type
53
+ >(
54
+ tecs: TransactionECS<C, A, R>,
55
+ ecs: ECS<C, A, R>,
56
+ options: Required<TransactionOptions>,
57
+ transactionCommmitted: (
58
+ value: TransactionCommit<C>,
59
+ changes: TransactionChanges<C>
60
+ ) => void,
61
+ parent?: Transaction<C, A, R>
62
+ ): Transaction<C, A, R> {
63
+ const write: ECSWrite<C> = parent ?? ecs;
64
+ const redoOperations: TransactionWriteOperation<C>[] = [];
65
+ const undoOperationsInReverseOrder: TransactionWriteOperation<C>[] = [];
66
+
67
+ const changed = {
68
+ entities: new Set<Entity>(),
69
+ components: new Set<keyof C>(),
70
+ archetypes: new Set<Archetype>(),
71
+ };
72
+
73
+ function createEntity(): Entity;
74
+ function createEntity<T>(
75
+ archetype: Archetype<T>,
76
+ values: EntityCreateValues<T>
77
+ ): Entity;
78
+ function createEntity<T>(
79
+ archetype?: Archetype<T>,
80
+ values?: EntityCreateValues<T>
81
+ ): Entity {
82
+ const entity =
83
+ archetype && values
84
+ ? write.createEntity(archetype, values)
85
+ : write.createEntity();
86
+ redoOperations.push({
87
+ type: "create",
88
+ values: (values ?? {}) as unknown as EntityCreateValues<C>,
89
+ });
90
+ undoOperationsInReverseOrder.push({ type: "delete", entity });
91
+ changed.entities.add(entity);
92
+ changed.archetypes.add(ecs.getEntityArchetype(entity));
93
+ for (const key in values) {
94
+ changed.components.add(key as keyof C);
95
+ }
96
+ return entity;
97
+ }
98
+
99
+ function updateEntity(entity: Entity, values: EntityUpdateValues<C>) {
100
+ const oldValues = ecs.getEntityValues(entity)!;
101
+ const replacedValues: any = {};
102
+ for (const name in values) {
103
+ const newValue = (values as any)[name];
104
+ let oldValue = (oldValues as any)[name];
105
+ if (newValue !== oldValue) {
106
+ if (oldValue === undefined) {
107
+ oldValue = DELETE;
108
+ }
109
+ replacedValues[name] = oldValue;
110
+ changed.components.add(name as keyof C);
111
+ }
112
+ }
113
+
114
+ changed.entities.add(entity);
115
+ changed.archetypes.add(ecs.getEntityArchetype(entity));
116
+ write.updateEntity(entity, values);
117
+ // archetype may have changed after update so we need to add new one.
118
+ changed.archetypes.add(ecs.getEntityArchetype(entity));
119
+
120
+ // maybe collapse adjacent updates to same entity.
121
+ const lastUndoOperation: TransactionWriteOperation<C> | undefined =
122
+ undoOperationsInReverseOrder[undoOperationsInReverseOrder.length - 1];
123
+ if (
124
+ lastUndoOperation?.type === "update" &&
125
+ lastUndoOperation.entity === entity
126
+ ) {
127
+ const lastRedoOperation = redoOperations[
128
+ redoOperations.length - 1
129
+ ] as TransactionUpdateOperation<C>;
130
+ lastRedoOperation.values = { ...lastRedoOperation.values, ...values };
131
+ lastUndoOperation.values = {
132
+ ...replacedValues,
133
+ ...lastUndoOperation.values,
134
+ };
135
+ } else {
136
+ redoOperations.push({ type: "update", entity, values });
137
+ undoOperationsInReverseOrder.push({
138
+ type: "update",
139
+ entity,
140
+ values: replacedValues,
141
+ });
142
+ }
143
+ }
144
+
145
+ function deleteEntity(entity: Entity) {
146
+ changed.archetypes.add(ecs.getEntityArchetype(entity));
147
+ changed.entities.add(entity);
148
+
149
+ const { id: _ignore, ...oldValues } = ecs.getEntityValues(entity) as any;
150
+ for (const key in oldValues) {
151
+ changed.components.add(key as keyof C);
152
+ }
153
+ write.deleteEntity(entity);
154
+ redoOperations.push({ type: "delete", entity });
155
+ undoOperationsInReverseOrder.push({ type: "create", values: oldValues });
156
+ }
157
+
158
+ function batch(operations: TransactionWriteOperation<C>[]) {
159
+ for (const operation of operations) {
160
+ switch (operation.type) {
161
+ case "create": {
162
+ const archetype = ecs.getArchetype(
163
+ "id",
164
+ ...(Object.keys(operation.values) as (keyof C)[])
165
+ );
166
+ createEntity(archetype, operation.values);
167
+ break;
168
+ }
169
+ case "update":
170
+ updateEntity(operation.entity, operation.values);
171
+ break;
172
+ case "delete":
173
+ deleteEntity(operation.entity);
174
+ break;
175
+ }
176
+ }
177
+ return transaction;
178
+ }
179
+
180
+ function complete(committed: true): TransactionCommit<C>;
181
+ function complete(committed: false): TransactionCancel;
182
+ function complete(committed: boolean): TransactionComplete<C> {
183
+ const undoOperations = undoOperationsInReverseOrder.slice(0).reverse();
184
+
185
+ if (!committed) {
186
+ batch(undoOperations);
187
+ }
188
+
189
+ if (committed) {
190
+ const result = { committed, options, redoOperations, undoOperations };
191
+ if (!parent && committed) {
192
+ transactionCommmitted(result, changed);
193
+ }
194
+ return result;
195
+ } else {
196
+ return { committed, options };
197
+ }
198
+ }
199
+
200
+ const setComponentValue = <Name extends keyof C>(
201
+ id: Entity,
202
+ component: Name,
203
+ value: C[Name] | undefined
204
+ ) => {
205
+ updateEntity(id, { [component]: value } as EntityUpdateValues<C>);
206
+ };
207
+
208
+ const transaction: Transaction<C, A, R> = {
209
+ ecs: tecs,
210
+ options,
211
+ resources: new Proxy(ecs.resources, {
212
+ set: (
213
+ _target: typeof ecs.resources,
214
+ p: string | symbol,
215
+ value: any,
216
+ _receiver: any
217
+ ): boolean => {
218
+ const archetype = ecs.getArchetype("id", p as keyof C);
219
+ const [table] = ecs.getTables(archetype, { mode: "read", exact: true });
220
+ const id = table.columns.id.get(0);
221
+ updateEntity(id, { [p as keyof C]: value } as any);
222
+ return true;
223
+ },
224
+ }),
225
+ setComponentValue,
226
+ createTransaction: () =>
227
+ createECSTransaction(
228
+ tecs,
229
+ ecs,
230
+ options,
231
+ transactionCommmitted,
232
+ transaction
233
+ ),
234
+ batch,
235
+ commit: () => complete(true),
236
+ cancel: () => complete(false),
237
+ createEntity,
238
+ updateEntity,
239
+ deleteEntity,
240
+ };
241
+
242
+ return transaction;
243
+ }
@@ -0,0 +1,255 @@
1
+ /*MIT License
2
+
3
+ © Copyright 2025 Adobe. All rights reserved.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.*/
22
+ import { Column, createECS } from "../old-ecs/index.js";
23
+ import { F32Schema, TrueSchema, U32Schema } from "../schema/index.js";
24
+ import { PerformanceTest } from "./perf-test.js";
25
+ import * as assembly from "../../dist/assembly/index.js";
26
+ import { createWasmMemoryAllocator } from "../cache/memory-allocator.js";
27
+ import { TypedArray } from "../internal/typed-array/index.js";
28
+
29
+ // const COUNT = 1_000_000;
30
+ // const SIZEOF_F32 = 4;
31
+ // const SIZEOF_BOOLEAN = 1;
32
+ // const OBJECT_OVERHEAD = 16;
33
+ // // Expected 50 Mb
34
+ // const EXPECTED_MEMORY = (8 * SIZEOF_F32 + 2 * SIZEOF_BOOLEAN + OBJECT_OVERHEAD) * COUNT;
35
+
36
+ function createECSWithParticles(count: number, batch = true) {
37
+ const ecs = createECS({
38
+ allocator: createWasmMemoryAllocator(assembly.memory),
39
+ })
40
+ .withComponents({
41
+ color: U32Schema,
42
+ enabled: TrueSchema,
43
+ mass: F32Schema,
44
+ positionX: F32Schema,
45
+ positionY: F32Schema,
46
+ positionZ: F32Schema,
47
+ velocityX: F32Schema,
48
+ velocityY: F32Schema,
49
+ velocityZ: F32Schema,
50
+ visible: TrueSchema,
51
+ })
52
+ .withArchetypes({
53
+ VisibleEnabled: [
54
+ "id",
55
+ "color",
56
+ "enabled",
57
+ "mass",
58
+ "positionX",
59
+ "positionY",
60
+ "positionZ",
61
+ "velocityX",
62
+ "velocityY",
63
+ "velocityZ",
64
+ "visible",
65
+ ],
66
+ InvisibleEnabled: [
67
+ "id",
68
+ "color",
69
+ "enabled",
70
+ "mass",
71
+ "positionX",
72
+ "positionY",
73
+ "positionZ",
74
+ "velocityX",
75
+ "velocityY",
76
+ "velocityZ",
77
+ ],
78
+ VisibleDisabled: [
79
+ "id",
80
+ "color",
81
+ "mass",
82
+ "positionX",
83
+ "positionY",
84
+ "positionZ",
85
+ "velocityX",
86
+ "velocityY",
87
+ "velocityZ",
88
+ "visible",
89
+ ],
90
+ InvisibleDisabled: [
91
+ "id",
92
+ "color",
93
+ "mass",
94
+ "positionX",
95
+ "positionY",
96
+ "positionZ",
97
+ "velocityX",
98
+ "velocityY",
99
+ "velocityZ",
100
+ ]
101
+ });
102
+
103
+ const particle_archetypes = [
104
+ ecs.archetypes.VisibleEnabled,
105
+ ecs.archetypes.VisibleDisabled,
106
+ ecs.archetypes.InvisibleEnabled,
107
+ ecs.archetypes.InvisibleDisabled,
108
+ ] as const;
109
+
110
+ if (batch) {
111
+
112
+ const particle_count_per_table = Math.ceil(count / 4);
113
+ const particle_tables = particle_archetypes.map(archetype => ecs.createBatch(archetype, particle_count_per_table));
114
+
115
+ for (let tableIndex = 0; tableIndex < particle_tables.length; tableIndex++) {
116
+ const table = particle_tables[tableIndex];
117
+ const positionX = table.columns.positionX.native as TypedArray;
118
+ const positionY = table.columns.positionY.native as TypedArray;
119
+ const positionZ = table.columns.positionZ.native as TypedArray;
120
+ const velocityX = table.columns.velocityX.native as TypedArray;
121
+ const velocityY = table.columns.velocityY.native as TypedArray;
122
+ const velocityZ = table.columns.velocityZ.native as TypedArray;
123
+ const color = table.columns.color.native!;
124
+ const mass = table.columns.mass.native!;
125
+ for (let k = 0; k < particle_count_per_table; k++) {
126
+ const i = tableIndex + k * 4;
127
+ color[k] = 0xff00ff;
128
+ mass[k] = 10;
129
+ positionX[k] = i + 1;
130
+ positionY[k] = i + 1;
131
+ positionZ[k] = i + 1;
132
+ velocityX[k] = -i;
133
+ velocityY[k] = -i;
134
+ velocityZ[k] = -i;
135
+ }
136
+ }
137
+ }
138
+ else {
139
+ for (let i = 0; i < count; i++) {
140
+ ecs.createEntity(particle_archetypes[i % 4], {
141
+ color: 0xff00ff,
142
+ mass: 10,
143
+ positionX: i + 1,
144
+ positionY: i + 1,
145
+ positionZ: i + 1,
146
+ velocityX: -i,
147
+ velocityY: -i,
148
+ velocityZ: -i,
149
+ visible: (i >> 0) % 2 === 0 ? true : false,
150
+ enabled: (i >> 1) % 2 === 0 ? true : false,
151
+ } as any);
152
+ }
153
+ }
154
+
155
+ return ecs;
156
+ }
157
+
158
+ const create = (batch: boolean) => {
159
+ let count = 0;
160
+ const setup = async (n: number) => {
161
+ count = n;
162
+ };
163
+ const run = () => {
164
+ createECSWithParticles(count, batch);
165
+ };
166
+ const cleanup = async () => { };
167
+ return { setup, run: run, cleanup, type: "create" } satisfies PerformanceTest;
168
+ };
169
+
170
+ function addManagedArrays(
171
+ a: Column<number>,
172
+ b: Column<number>,
173
+ rows: number,
174
+ addWasm: typeof assembly.addF32Arrays
175
+ ) {
176
+ const aptr = (a.native as unknown as Float32Array).byteOffset.valueOf();
177
+ const bptr = (b.native as unknown as Float32Array).byteOffset.valueOf();
178
+ addWasm(aptr, bptr, rows);
179
+ }
180
+
181
+ function createMoveParticlesPerformanceTest(options: {
182
+ mode: "column" | "native" | typeof assembly.addF32Arrays;
183
+ }) {
184
+ let ecs: ReturnType<typeof createECSWithParticles>;
185
+ const setup = async (n: number) => {
186
+ ecs = createECSWithParticles(n);
187
+ };
188
+ const run = () => {
189
+ let total = 0;
190
+ const addWasm = typeof options.mode === "function" ? options.mode : null;
191
+ for (const table of ecs.getTables(ecs.archetypes.VisibleEnabled, {
192
+ mode: "write",
193
+ })) {
194
+ const { rows, columns } = table;
195
+ total += rows;
196
+ if (addWasm) {
197
+ addManagedArrays(columns.positionX, columns.velocityX, rows, addWasm);
198
+ addManagedArrays(columns.positionY, columns.velocityY, rows, addWasm);
199
+ addManagedArrays(columns.positionZ, columns.velocityZ, rows, addWasm);
200
+ } else if (options.mode === "column") {
201
+ const {
202
+ positionX,
203
+ positionY,
204
+ positionZ,
205
+ velocityX,
206
+ velocityY,
207
+ velocityZ,
208
+ } = columns;
209
+ for (let i = 0; i < rows; i++) {
210
+ positionX.set(i, positionX.get(i) + velocityX.get(i));
211
+ positionY.set(i, positionY.get(i) + velocityY.get(i));
212
+ positionZ.set(i, positionZ.get(i) + velocityZ.get(i));
213
+ }
214
+ } else if (options.mode === "native") {
215
+ const positionX = columns.positionX.native!;
216
+ const positionY = columns.positionY.native!;
217
+ const positionZ = columns.positionZ.native!;
218
+ const velocityX = columns.velocityX.native!;
219
+ const velocityY = columns.velocityY.native!;
220
+ const velocityZ = columns.velocityZ.native!;
221
+ for (let i = 0; i < rows; i++) {
222
+ positionX[i] += velocityX[i];
223
+ positionY[i] += velocityY[i];
224
+ positionZ[i] += velocityZ[i];
225
+ }
226
+ }
227
+ }
228
+ };
229
+ const getVisibleEnabledPositions = () => {
230
+ const values: number[] = [];
231
+ for (const table of ecs.getTables(ecs.archetypes.VisibleEnabled, {
232
+ mode: "read",
233
+ })) {
234
+ const { rows, columns } = table;
235
+ const { positionX, positionY, positionZ } = columns;
236
+ for (let i = 0; i < rows; i++) {
237
+ values.push(positionX.get(i), positionY.get(i), positionZ.get(i));
238
+ }
239
+ }
240
+ return values;
241
+ }
242
+
243
+ const cleanup = async () => { };
244
+ return { setup, run: run, cleanup, getVisibleEnabledPositions, type: "move" } satisfies PerformanceTest;
245
+ }
246
+
247
+ export const ec2s = {
248
+ create: create(false),
249
+ create_batch: create(true),
250
+ move_column: createMoveParticlesPerformanceTest({ mode: "column" }),
251
+ move_native: createMoveParticlesPerformanceTest({ mode: "native" }),
252
+ move_wasm: createMoveParticlesPerformanceTest({ mode: assembly.addF32Arrays }),
253
+ move_wasm_simd4: createMoveParticlesPerformanceTest({ mode: assembly.addF32ArraysSimd4 }),
254
+ move_wasm_simd4_unrolled: createMoveParticlesPerformanceTest({ mode: assembly.addF32ArraysSimd4Unrolled }),
255
+ };
@@ -0,0 +1,31 @@
1
+ /*MIT License
2
+
3
+ © Copyright 2025 Adobe. All rights reserved.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.*/
22
+ export function shuffleArray<T>(array: T[]) {
23
+ for (let i = array.length - 1; i > 0; i--) {
24
+ // Generate a random index lower than the current element
25
+ const j = Math.floor(Math.random() * (i + 1));
26
+
27
+ // Swap elements at indices i and j
28
+ [array[i], array[j]] = [array[j], array[i]];
29
+ }
30
+ return array;
31
+ }
@@ -0,0 +1,132 @@
1
+ /*MIT License
2
+
3
+ © Copyright 2025 Adobe. All rights reserved.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.*/
22
+ import { shuffleArray } from "./helper-functions.js";
23
+ import { PerformanceTest } from "./perf-test.js";
24
+
25
+ function uuidv4(): string {
26
+ return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function (c) {
27
+ const r = (Math.random() * 16) | 0;
28
+ const v = c === "x" ? r : (r & 0x3) | 0x8;
29
+ return v.toString(16);
30
+ });
31
+ }
32
+ // uuid-imports.d.ts
33
+ async function createParticles(count: number) {
34
+ const particlesIds: string[] = [];
35
+ const components: Map<string, Map<string, any>> = new Map();
36
+ const setComponent = (name: string, key: string, value: any) => {
37
+ let component = components.get(name);
38
+ if (!component) {
39
+ component = new Map();
40
+ components.set(name, component);
41
+ }
42
+ component.set(key, value);
43
+ };
44
+ const getComponent = (name: string, key: string) => {
45
+ const component = components.get(name);
46
+ if (!component) {
47
+ return undefined;
48
+ }
49
+ return component.get(key);
50
+ };
51
+ const particles: any[] = [];
52
+ for (let i = 0; i < count; i++) {
53
+ const entity = uuidv4();
54
+ particlesIds.push(entity);
55
+ setComponent(entity, "color", { value: 0xff00ff });
56
+ setComponent(entity, "mass", { value: 10 });
57
+ setComponent(entity, "position", { x: i + 1, y: i + 1, z: i + 1 });
58
+ setComponent(entity, "velocity", { x: - i, y: - i, z: - i });
59
+ if ((i >> 0) % 2 === 0) {
60
+ setComponent(entity, "visible", true);
61
+ }
62
+ if ((i >> 1) % 2 === 0) {
63
+ setComponent(entity, "enabled", true);
64
+ }
65
+ }
66
+ const enabledVisibleParticles = particlesIds.filter((id, i) => {
67
+ return getComponent(id, "enabled") && getComponent(id, "visible");
68
+ });
69
+
70
+ return {
71
+ particles,
72
+ components,
73
+ setComponent,
74
+ getComponent,
75
+ enabledVisibleParticles,
76
+ };
77
+ }
78
+
79
+ const create = (() => {
80
+ let count = 0;
81
+ const setup = async (n: number) => {
82
+ count = n;
83
+ };
84
+ const run = () => {
85
+ createParticles(count);
86
+ };
87
+ const cleanup = async () => {};
88
+ return { setup, run: run, cleanup, type: "create" } satisfies PerformanceTest;
89
+ })();
90
+
91
+ function createMoveParticlesPerformanceTest(options: { shuffle: boolean }) {
92
+ let ecs: any;
93
+ const setup = async (n: number) => {
94
+ ecs = await createParticles(n);
95
+ if (options.shuffle) {
96
+ shuffleArray(ecs.particles);
97
+ }
98
+ };
99
+ const run = () => {
100
+ for (let i = 0; i < ecs.enabledVisibleParticles.length; i++) {
101
+ const p = ecs.enabledVisibleParticles[i];
102
+ const position = ecs.getComponent(p, "position");
103
+ const velocity = ecs.getComponent(p, "velocity");
104
+ const newPosition = {
105
+ x: position.x + velocity.x,
106
+ y: position.y + velocity.y,
107
+ z: position.z + velocity.z,
108
+ };
109
+ ecs.setComponent(p, "position", newPosition);
110
+ }
111
+ };
112
+ const getVisibleEnabledPositions = () => {
113
+ const values: number[] = [];
114
+ for (let i = 0; i < ecs.enabledVisibleParticles.length; i++) {
115
+ const p = ecs.enabledVisibleParticles[i];
116
+ const position = ecs.getComponent(p, "position");
117
+ values.push(position.x, position.y, position.z);
118
+ }
119
+ return values;
120
+ }
121
+ const cleanup = async () => {};
122
+ return { setup, run: run, cleanup, getVisibleEnabledPositions, type: "move" } satisfies PerformanceTest;
123
+ }
124
+
125
+ const move_best = createMoveParticlesPerformanceTest({ shuffle: false });
126
+ const move_worst = createMoveParticlesPerformanceTest({ shuffle: true });
127
+
128
+ export const horizon = {
129
+ create,
130
+ move_best,
131
+ move_worst,
132
+ };
@@ -20,16 +20,18 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.*/
22
22
  import * as vanilla_tests from "./vanilla-perf.js";
23
+ import * as horizon_tests from "./horizon-perf.js";
23
24
  import * as ecs_tests from "./ecs-perf.js";
24
25
  import { runTests } from "./perf-test.js";
26
+
25
27
  export function run() {
26
- runTests({
27
- ...ecs_tests,
28
- ...vanilla_tests,
29
- // ...horizon_tests,
30
- });
28
+ runTests({
29
+ ...ecs_tests,
30
+ ...vanilla_tests,
31
+ // ...horizon_tests,
32
+ });
31
33
  }
34
+
32
35
  if (typeof globalThis.process === "object" && import.meta.url === `file://${process?.argv[1]}`) {
33
- run();
36
+ run();
34
37
  }
35
- //# sourceMappingURL=index.js.map