@fundamental-engine/core 0.9.1 → 0.9.3

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 (124) hide show
  1. package/README.md +12 -11
  2. package/dist/agents/event-agent.d.ts.map +1 -1
  3. package/dist/agents/event-agent.js +13 -9
  4. package/dist/agents/event-agent.js.map +1 -1
  5. package/dist/config/forces.config.js +2 -2
  6. package/dist/config/forces.config.js.map +1 -1
  7. package/dist/conformance/run.d.ts +2 -2
  8. package/dist/conformance/run.d.ts.map +1 -1
  9. package/dist/conformance/run.js +30 -27
  10. package/dist/conformance/run.js.map +1 -1
  11. package/dist/conformance/types.d.ts +3 -0
  12. package/dist/conformance/types.d.ts.map +1 -1
  13. package/dist/contracts/guards.d.ts +3 -1
  14. package/dist/contracts/guards.d.ts.map +1 -1
  15. package/dist/contracts/guards.js.map +1 -1
  16. package/dist/contracts/passport.d.ts +6 -0
  17. package/dist/contracts/passport.d.ts.map +1 -1
  18. package/dist/contracts/passport.js +12 -3
  19. package/dist/contracts/passport.js.map +1 -1
  20. package/dist/core/accretion.d.ts +1 -1
  21. package/dist/core/accretion.d.ts.map +1 -1
  22. package/dist/core/accretion.js +1 -1
  23. package/dist/core/accretion.js.map +1 -1
  24. package/dist/core/events.d.ts +3 -3
  25. package/dist/core/events.d.ts.map +1 -1
  26. package/dist/core/events.js +1 -1
  27. package/dist/core/feedback-sink.d.ts +1 -1
  28. package/dist/core/feedback-sink.d.ts.map +1 -1
  29. package/dist/core/feedback-sink.js +1 -2
  30. package/dist/core/feedback-sink.js.map +1 -1
  31. package/dist/core/field-snapshot.d.ts +21 -0
  32. package/dist/core/field-snapshot.d.ts.map +1 -0
  33. package/dist/core/field-snapshot.js +0 -0
  34. package/dist/core/field-snapshot.js.map +1 -0
  35. package/dist/core/field.d.ts.map +1 -1
  36. package/dist/core/field.js +1006 -58
  37. package/dist/core/field.js.map +1 -1
  38. package/dist/core/frame-harness.d.ts +2 -2
  39. package/dist/core/frame-harness.d.ts.map +1 -1
  40. package/dist/core/frame-harness.js +2 -2
  41. package/dist/core/frame-harness.js.map +1 -1
  42. package/dist/core/geometry.d.ts +9 -0
  43. package/dist/core/geometry.d.ts.map +1 -1
  44. package/dist/core/geometry.js +16 -0
  45. package/dist/core/geometry.js.map +1 -1
  46. package/dist/core/governance.d.ts +20 -0
  47. package/dist/core/governance.d.ts.map +1 -0
  48. package/dist/core/governance.js +77 -0
  49. package/dist/core/governance.js.map +1 -0
  50. package/dist/core/host.d.ts +95 -21
  51. package/dist/core/host.d.ts.map +1 -1
  52. package/dist/core/host.js +53 -1
  53. package/dist/core/host.js.map +1 -1
  54. package/dist/core/integrator.d.ts +42 -1
  55. package/dist/core/integrator.d.ts.map +1 -1
  56. package/dist/core/integrator.js +229 -27
  57. package/dist/core/integrator.js.map +1 -1
  58. package/dist/core/lane-registry.d.ts +14 -0
  59. package/dist/core/lane-registry.d.ts.map +1 -0
  60. package/dist/core/lane-registry.js +64 -0
  61. package/dist/core/lane-registry.js.map +1 -0
  62. package/dist/core/projection-agent-json.d.ts +12 -0
  63. package/dist/core/projection-agent-json.d.ts.map +1 -0
  64. package/dist/core/projection-agent-json.js +37 -0
  65. package/dist/core/projection-agent-json.js.map +1 -0
  66. package/dist/core/query-lens.d.ts +6 -0
  67. package/dist/core/query-lens.d.ts.map +1 -0
  68. package/dist/core/query-lens.js +24 -0
  69. package/dist/core/query-lens.js.map +1 -0
  70. package/dist/core/reactions.d.ts +7 -0
  71. package/dist/core/reactions.d.ts.map +1 -1
  72. package/dist/core/reactions.js +7 -0
  73. package/dist/core/reactions.js.map +1 -1
  74. package/dist/core/render-modes.d.ts +64 -0
  75. package/dist/core/render-modes.d.ts.map +1 -1
  76. package/dist/core/render-modes.js +165 -0
  77. package/dist/core/render-modes.js.map +1 -1
  78. package/dist/core/scanner.d.ts +29 -3
  79. package/dist/core/scanner.d.ts.map +1 -1
  80. package/dist/core/scanner.js +46 -3
  81. package/dist/core/scanner.js.map +1 -1
  82. package/dist/core/spatial-hash.d.ts +8 -0
  83. package/dist/core/spatial-hash.d.ts.map +1 -1
  84. package/dist/core/spatial-hash.js +26 -3
  85. package/dist/core/spatial-hash.js.map +1 -1
  86. package/dist/core/types.d.ts +762 -8
  87. package/dist/core/types.d.ts.map +1 -1
  88. package/dist/diagnostics/probes.d.ts +11 -1
  89. package/dist/diagnostics/probes.d.ts.map +1 -1
  90. package/dist/diagnostics/probes.js +48 -8
  91. package/dist/diagnostics/probes.js.map +1 -1
  92. package/dist/forces/extended.d.ts.map +1 -1
  93. package/dist/forces/extended.js +8 -2
  94. package/dist/forces/extended.js.map +1 -1
  95. package/dist/forces/natural.d.ts.map +1 -1
  96. package/dist/forces/natural.js +11 -12
  97. package/dist/forces/natural.js.map +1 -1
  98. package/dist/index.d.ts +6 -1
  99. package/dist/index.d.ts.map +1 -1
  100. package/dist/index.js +6 -1
  101. package/dist/index.js.map +1 -1
  102. package/dist/recipes/compile.d.ts.map +1 -1
  103. package/dist/recipes/compile.js +3 -1
  104. package/dist/recipes/compile.js.map +1 -1
  105. package/dist/recipes/schema.d.ts +1 -1
  106. package/dist/recipes/schema.d.ts.map +1 -1
  107. package/dist/recipes/schema.js +1 -0
  108. package/dist/recipes/schema.js.map +1 -1
  109. package/dist/record/record.d.ts +1 -1
  110. package/dist/record/record.d.ts.map +1 -1
  111. package/dist/semantic/layers.d.ts +16 -2
  112. package/dist/semantic/layers.d.ts.map +1 -1
  113. package/dist/semantic/layers.js +20 -3
  114. package/dist/semantic/layers.js.map +1 -1
  115. package/dist/semantic/materials.js +3 -3
  116. package/dist/semantic/materials.js.map +1 -1
  117. package/dist/semantic/states.js +1 -1
  118. package/dist/semantic/states.js.map +1 -1
  119. package/dist/version.d.ts +1 -1
  120. package/dist/version.js +1 -1
  121. package/dist/visual/visualization.d.ts.map +1 -1
  122. package/dist/visual/visualization.js +4 -0
  123. package/dist/visual/visualization.js.map +1 -1
  124. package/package.json +3 -2
package/dist/core/spatial-hash.js CHANGED
@@ -8,6 +8,14 @@
8
8
  export class SpatialHash {
9
9
  cell;
10
10
  bins = new Map();
11
+ /**
12
+ * Bin arrays retired by `clear()` — held for reuse so a `rebuild()` that re-populates the same
13
+ * (or a similar) set of cells does not allocate a fresh array per cell every frame. The index is
14
+ * rebuilt each frame (field-store `reindex`), so without this the GC churns one array per non-empty
15
+ * cell per frame at high particle counts. Query behaviour is unchanged: a bin is only ever exposed
16
+ * once it holds live items, and `clear()` empties every live bin before any are handed out.
17
+ */
18
+ freeBins = [];
11
19
  constructor(cellSize = 64) {
12
20
  this.cell = cellSize > 0 ? cellSize : 64;
13
21
  }
@@ -16,15 +24,30 @@ export class SpatialHash {
16
24
  return (cx + 0x8000) * 0x10000 + (cy + 0x8000);
17
25
  }
18
26
  clear() {
27
+ // Retain the arrays: empty each live bin (length = 0 keeps the backing store) and move it to the
28
+ // free-list, then drop the map entries. Next rebuild pulls from the free-list before allocating.
29
+ for (const bin of this.bins.values()) {
30
+ bin.length = 0;
31
+ this.freeBins.push(bin);
32
+ }
19
33
  this.bins.clear();
20
34
  }
21
35
  insert(item) {
22
36
  const k = this.key(Math.floor(item.x / this.cell), Math.floor(item.y / this.cell));
23
37
  const bin = this.bins.get(k);
24
- if (bin)
38
+ if (bin) {
25
39
  bin.push(item);
26
- else
27
- this.bins.set(k, [item]);
40
+ }
41
+ else {
42
+ const fresh = this.freeBins.pop();
43
+ if (fresh) {
44
+ fresh.push(item);
45
+ this.bins.set(k, fresh);
46
+ }
47
+ else {
48
+ this.bins.set(k, [item]);
49
+ }
50
+ }
28
51
  }
29
52
  rebuild(items) {
30
53
  this.clear();
package/dist/core/spatial-hash.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"spatial-hash.js","sourceRoot":"","sources":["../../src/core/spatial-hash.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"spatial-hash.js","sourceRoot":"","sources":["../../src/core/spatial-hash.ts"],"names":[],"mappings":"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"}