@reicek/neataptic-ts 0.1.21 → 0.1.23

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 (361) hide show
  1. package/.github/agents/boundary-mapper.agent.md +31 -0
  2. package/.github/agents/docs-scout.agent.md +29 -0
  3. package/.github/agents/plan-scout.agent.md +31 -0
  4. package/.github/agents/solid-split.agent.md +143 -0
  5. package/.github/copilot-instructions.md +119 -0
  6. package/.github/skills/solid-split-playbook/SKILL.md +220 -0
  7. package/.github/skills/solid-split-playbook/assets/docs-checklist.md +34 -0
  8. package/.github/skills/solid-split-playbook/assets/split-plan-template.md +48 -0
  9. package/.github/skills/solid-split-playbook/assets/split-workflow-checklist.md +51 -0
  10. package/.github/skills/trace-analyzer-extension/SKILL.md +63 -0
  11. package/.github/skills/trace-analyzer-extension/assets/extension-checklist.md +24 -0
  12. package/.github/skills/trace-analyzer-extension/references/analyzer-extension-workflow.md +101 -0
  13. package/.github/skills/trace-audit-reporting/SKILL.md +96 -0
  14. package/.github/skills/trace-audit-reporting/assets/performance-report-template.md +123 -0
  15. package/.github/skills/trace-audit-reporting/references/trace-analysis-workflow.md +132 -0
  16. package/package.json +7 -3
  17. package/plans/ES2023 migration +13 -8
  18. package/plans/Evolution_Training_Interoperability_Contracts.md +1 -1
  19. package/plans/Flappy_Bird_Folder_Documentation_Pass.md +53 -0
  20. package/plans/Flappy_Evolution_Worker_Documentation_Pass.md +58 -0
  21. package/plans/Interactive_Examples_and_Learning_Path.md +10 -2
  22. package/plans/Memory_Optimization.md +3 -3
  23. package/plans/README.md +63 -0
  24. package/plans/Roadmap.md +15 -3
  25. package/plans/asciiMaze_SOLID_split.done.md +130 -0
  26. package/plans/flappy_bird_SOLID_split.done.md +67 -0
  27. package/scripts/analyze-trace.ts +590 -0
  28. package/scripts/assets/theme.css +221 -34
  29. package/scripts/copy-examples.mjs +9 -5
  30. package/scripts/export-onnx.mjs +3 -3
  31. package/scripts/generate-bench-tables.mjs +10 -10
  32. package/scripts/generate-bench-tables.ts +10 -10
  33. package/scripts/generate-docs.ts +1415 -449
  34. package/scripts/render-docs-html.ts +15 -8
  35. package/src/README.md +127 -222
  36. package/src/architecture/README.md +117 -184
  37. package/src/architecture/architect.ts +6 -0
  38. package/src/architecture/layer/README.md +38 -38
  39. package/src/architecture/network/README.md +49 -31
  40. package/src/architecture/network/activate/README.md +77 -77
  41. package/src/architecture/network/connect/README.md +15 -13
  42. package/src/architecture/network/deterministic/README.md +7 -7
  43. package/src/architecture/network/evolve/README.md +44 -44
  44. package/src/architecture/network/gating/README.md +20 -20
  45. package/src/architecture/network/genetic/README.md +51 -51
  46. package/src/architecture/network/mutate/README.md +97 -97
  47. package/src/architecture/network/network.types.ts +39 -0
  48. package/src/architecture/network/onnx/README.md +264 -264
  49. package/src/architecture/network/prune/README.md +39 -39
  50. package/src/architecture/network/remove/README.md +26 -26
  51. package/src/architecture/network/serialize/README.md +56 -56
  52. package/src/architecture/network/serialize/network.serialize.json.utils.ts +1 -0
  53. package/src/architecture/network/serialize/network.serialize.utils.ts +6 -1
  54. package/src/architecture/network/serialize/network.serialize.utils.types.ts +1 -1
  55. package/src/architecture/network/slab/README.md +61 -61
  56. package/src/architecture/network/standalone/README.md +24 -24
  57. package/src/architecture/network/stats/README.md +9 -9
  58. package/src/architecture/network/topology/README.md +46 -46
  59. package/src/architecture/network/training/README.md +21 -21
  60. package/src/architecture/network.ts +114 -10
  61. package/src/methods/README.md +9 -87
  62. package/src/multithreading/README.md +8 -77
  63. package/src/multithreading/workers/README.md +2 -2
  64. package/src/multithreading/workers/browser/README.md +0 -6
  65. package/src/multithreading/workers/node/README.md +0 -3
  66. package/src/neat/README.md +623 -568
  67. package/src/neat/neat.evolve.population.utils.ts +29 -5
  68. package/src/neat/neat.helpers.ts +16 -0
  69. package/src/neat/neat.topology-intent.utils.ts +160 -0
  70. package/src/utils/README.md +18 -18
  71. package/test/examples/asciiMaze/README.md +59 -59
  72. package/test/examples/asciiMaze/asciiMaze.e2e.test.ts +14 -9
  73. package/test/examples/asciiMaze/browser-entry/README.md +196 -0
  74. package/test/examples/asciiMaze/browser-entry/browser-entry.abort.services.ts +95 -0
  75. package/test/examples/asciiMaze/browser-entry/browser-entry.constants.ts +23 -0
  76. package/test/examples/asciiMaze/browser-entry/browser-entry.curriculum.services.ts +115 -0
  77. package/test/examples/asciiMaze/browser-entry/browser-entry.globals.services.ts +106 -0
  78. package/test/examples/asciiMaze/browser-entry/browser-entry.host.services.ts +157 -0
  79. package/test/examples/asciiMaze/browser-entry/browser-entry.services.ts +14 -0
  80. package/test/examples/asciiMaze/browser-entry/browser-entry.ts +129 -0
  81. package/test/examples/asciiMaze/browser-entry/browser-entry.types.ts +120 -0
  82. package/test/examples/asciiMaze/browser-entry/browser-entry.utils.ts +98 -0
  83. package/test/examples/asciiMaze/browser-entry.ts +10 -576
  84. package/test/examples/asciiMaze/dashboardManager/README.md +276 -0
  85. package/test/examples/asciiMaze/dashboardManager/archive/README.md +16 -0
  86. package/test/examples/asciiMaze/dashboardManager/archive/dashboardManager.archive.services.ts +267 -0
  87. package/test/examples/asciiMaze/dashboardManager/dashboardManager.constants.ts +35 -0
  88. package/test/examples/asciiMaze/dashboardManager/dashboardManager.services.ts +103 -0
  89. package/test/examples/asciiMaze/dashboardManager/dashboardManager.ts +181 -0
  90. package/test/examples/asciiMaze/dashboardManager/dashboardManager.types.ts +267 -0
  91. package/test/examples/asciiMaze/dashboardManager/dashboardManager.utils.ts +254 -0
  92. package/test/examples/asciiMaze/dashboardManager/live/README.md +14 -0
  93. package/test/examples/asciiMaze/dashboardManager/live/dashboardManager.live.services.ts +264 -0
  94. package/test/examples/asciiMaze/dashboardManager/telemetry/README.md +47 -0
  95. package/test/examples/asciiMaze/dashboardManager/telemetry/dashboardManager.telemetry.services.ts +513 -0
  96. package/test/examples/asciiMaze/dashboardManager.ts +13 -2335
  97. package/test/examples/asciiMaze/evolutionEngine/README.md +1058 -0
  98. package/test/examples/asciiMaze/evolutionEngine/curriculumPhase.ts +90 -0
  99. package/test/examples/asciiMaze/evolutionEngine/engineState.constants.ts +36 -0
  100. package/test/examples/asciiMaze/evolutionEngine/engineState.ts +58 -513
  101. package/test/examples/asciiMaze/evolutionEngine/engineState.types.ts +212 -0
  102. package/test/examples/asciiMaze/evolutionEngine/engineState.utils.ts +301 -0
  103. package/test/examples/asciiMaze/evolutionEngine/evolutionEngine.types.ts +445 -0
  104. package/test/examples/asciiMaze/evolutionEngine/evolutionLoop.ts +81 -50
  105. package/test/examples/asciiMaze/evolutionEngine/optionsAndSetup.ts +2 -4
  106. package/test/examples/asciiMaze/evolutionEngine/populationDynamics.ts +17 -33
  107. package/test/examples/asciiMaze/evolutionEngine/populationPruning.ts +1 -1
  108. package/test/examples/asciiMaze/evolutionEngine/rngAndTiming.ts +1 -2
  109. package/test/examples/asciiMaze/evolutionEngine/sampling.ts +1 -1
  110. package/test/examples/asciiMaze/evolutionEngine/scratchPools.ts +2 -5
  111. package/test/examples/asciiMaze/evolutionEngine/setupHelpers.ts +30 -37
  112. package/test/examples/asciiMaze/evolutionEngine/telemetryMetrics.ts +16 -58
  113. package/test/examples/asciiMaze/evolutionEngine/trainingWarmStart.ts +2 -2
  114. package/test/examples/asciiMaze/evolutionEngine.ts +55 -55
  115. package/test/examples/asciiMaze/fitness.ts +2 -2
  116. package/test/examples/asciiMaze/fitness.types.ts +65 -0
  117. package/test/examples/asciiMaze/interfaces.ts +64 -1352
  118. package/test/examples/asciiMaze/mazeMovement/README.md +356 -0
  119. package/test/examples/asciiMaze/mazeMovement/finalization/README.md +49 -0
  120. package/test/examples/asciiMaze/mazeMovement/finalization/mazeMovement.finalization.ts +138 -0
  121. package/test/examples/asciiMaze/mazeMovement/mazeMovement.constants.ts +101 -0
  122. package/test/examples/asciiMaze/mazeMovement/mazeMovement.services.ts +230 -0
  123. package/test/examples/asciiMaze/mazeMovement/mazeMovement.ts +299 -0
  124. package/test/examples/asciiMaze/mazeMovement/mazeMovement.types.ts +185 -0
  125. package/test/examples/asciiMaze/mazeMovement/mazeMovement.utils.ts +153 -0
  126. package/test/examples/asciiMaze/mazeMovement/policy/README.md +91 -0
  127. package/test/examples/asciiMaze/mazeMovement/policy/mazeMovement.policy.ts +467 -0
  128. package/test/examples/asciiMaze/mazeMovement/runtime/README.md +95 -0
  129. package/test/examples/asciiMaze/mazeMovement/runtime/mazeMovement.runtime.ts +354 -0
  130. package/test/examples/asciiMaze/mazeMovement/shaping/README.md +124 -0
  131. package/test/examples/asciiMaze/mazeMovement/shaping/mazeMovement.shaping.ts +459 -0
  132. package/test/examples/asciiMaze/mazeMovement.ts +12 -2978
  133. package/test/examples/flappy_bird/README.md +193 -88
  134. package/test/examples/flappy_bird/browser-entry/README.md +1441 -0
  135. package/test/examples/flappy_bird/browser-entry/browser-entry.host.utils.ts +4 -324
  136. package/test/examples/flappy_bird/browser-entry/browser-entry.network-view.utils.ts +9 -396
  137. package/test/examples/flappy_bird/browser-entry/browser-entry.playback.utils.ts +6 -714
  138. package/test/examples/flappy_bird/browser-entry/browser-entry.render.types.ts +26 -3
  139. package/test/examples/flappy_bird/browser-entry/browser-entry.runtime.types.ts +16 -1
  140. package/test/examples/flappy_bird/browser-entry/browser-entry.simulation.types.ts +39 -5
  141. package/test/examples/flappy_bird/browser-entry/browser-entry.spawn.utils.ts +11 -31
  142. package/test/examples/flappy_bird/browser-entry/browser-entry.stats.types.ts +32 -4
  143. package/test/examples/flappy_bird/browser-entry/browser-entry.ts +11 -0
  144. package/test/examples/flappy_bird/browser-entry/browser-entry.types.ts +8 -0
  145. package/test/examples/flappy_bird/browser-entry/browser-entry.visualization.types.ts +50 -7
  146. package/test/examples/flappy_bird/browser-entry/browser-entry.visualization.utils.ts +21 -893
  147. package/test/examples/flappy_bird/browser-entry/browser-entry.worker.types.ts +91 -10
  148. package/test/examples/flappy_bird/browser-entry/host/README.md +318 -0
  149. package/test/examples/flappy_bird/browser-entry/host/host.canvas.service.ts +16 -0
  150. package/test/examples/flappy_bird/browser-entry/host/host.constants.ts +20 -0
  151. package/test/examples/flappy_bird/browser-entry/host/host.dom.service.ts +10 -0
  152. package/test/examples/flappy_bird/browser-entry/host/host.resize.service.ts +1 -295
  153. package/test/examples/flappy_bird/browser-entry/host/host.stats.service.ts +14 -0
  154. package/test/examples/flappy_bird/browser-entry/host/host.ts +592 -6
  155. package/test/examples/flappy_bird/browser-entry/host/host.types.ts +13 -0
  156. package/test/examples/flappy_bird/browser-entry/host/resize/README.md +309 -0
  157. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.constants.ts +47 -0
  158. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.services.ts +392 -0
  159. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.ts +132 -0
  160. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.types.ts +92 -0
  161. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.utils.ts +272 -0
  162. package/test/examples/flappy_bird/browser-entry/network-view/README.md +389 -0
  163. package/test/examples/flappy_bird/browser-entry/network-view/network-view.draw.service.ts +13 -0
  164. package/test/examples/flappy_bird/browser-entry/network-view/network-view.labels.utils.ts +12 -0
  165. package/test/examples/flappy_bird/browser-entry/network-view/network-view.layout.utils.ts +14 -0
  166. package/test/examples/flappy_bird/browser-entry/network-view/network-view.topology.utils.ts +267 -0
  167. package/test/examples/flappy_bird/browser-entry/network-view/network-view.ts +823 -7
  168. package/test/examples/flappy_bird/browser-entry/network-view/network-view.types.ts +11 -0
  169. package/test/examples/flappy_bird/browser-entry/playback/README.md +845 -0
  170. package/test/examples/flappy_bird/browser-entry/playback/background/README.md +355 -0
  171. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/README.md +1068 -0
  172. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.batch.services.ts +64 -0
  173. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.cache.services.ts +207 -0
  174. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.constants.ts +197 -0
  175. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.batch.utils.ts +114 -0
  176. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.layout.utils.test.ts +96 -0
  177. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.layout.utils.ts +204 -0
  178. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.services.ts +49 -0
  179. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.utils.ts +313 -0
  180. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.layer.services.ts +81 -0
  181. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.math.utils.test.ts +33 -0
  182. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.math.utils.ts +201 -0
  183. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.selection.utils.ts +171 -0
  184. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.timing.utils.ts +124 -0
  185. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.utils.test.ts +279 -0
  186. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.utils.ts +132 -0
  187. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.scene.services.ts +26 -0
  188. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.services.ts +65 -0
  189. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.ts +48 -0
  190. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.types.ts +342 -0
  191. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.utils.ts +10 -0
  192. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.cache.services.ts +96 -0
  193. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.constants.ts +127 -0
  194. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.draw.services.ts +184 -0
  195. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.scene.services.ts +64 -0
  196. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.services.ts +6 -0
  197. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.ts +53 -0
  198. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.types.ts +105 -0
  199. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.utils.ts +100 -0
  200. package/test/examples/flappy_bird/browser-entry/playback/frame-render/README.md +541 -0
  201. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.bird.utils.ts +180 -0
  202. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.canvas.services.ts +77 -0
  203. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.entity.services.ts +167 -0
  204. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.scene.services.ts +57 -0
  205. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.service.test.ts +176 -0
  206. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.service.ts +113 -0
  207. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.services.ts +35 -0
  208. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.trail.utils.ts +248 -0
  209. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.types.ts +103 -0
  210. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.utils.ts +11 -0
  211. package/test/examples/flappy_bird/browser-entry/playback/playback.constants.ts +1 -1
  212. package/test/examples/flappy_bird/browser-entry/playback/playback.frame-render.service.ts +10 -0
  213. package/test/examples/flappy_bird/browser-entry/playback/playback.iteration.services.ts +192 -0
  214. package/test/examples/flappy_bird/browser-entry/playback/playback.loop.service.ts +12 -0
  215. package/test/examples/flappy_bird/browser-entry/playback/playback.orchestration.types.ts +78 -0
  216. package/test/examples/flappy_bird/browser-entry/playback/playback.render.pipe-outline.service.ts +128 -0
  217. package/test/examples/flappy_bird/browser-entry/playback/playback.render.service.ts +1 -116
  218. package/test/examples/flappy_bird/browser-entry/playback/playback.session.services.ts +184 -0
  219. package/test/examples/flappy_bird/browser-entry/playback/playback.snapshot.utils.test.ts +121 -0
  220. package/test/examples/flappy_bird/browser-entry/playback/playback.snapshot.utils.ts +8 -0
  221. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.layer.services.ts +36 -0
  222. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.service.ts +11 -128
  223. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.services.ts +268 -0
  224. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.types.ts +91 -0
  225. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.utils.ts +11 -4
  226. package/test/examples/flappy_bird/browser-entry/playback/playback.trail.utils.ts +9 -86
  227. package/test/examples/flappy_bird/browser-entry/playback/playback.ts +75 -7
  228. package/test/examples/flappy_bird/browser-entry/playback/playback.types.ts +12 -9
  229. package/test/examples/flappy_bird/browser-entry/playback/playback.worker-channel.utils.ts +11 -123
  230. package/test/examples/flappy_bird/browser-entry/playback/snapshot/README.md +55 -0
  231. package/test/examples/flappy_bird/browser-entry/playback/snapshot/playback.snapshot.services.ts +103 -0
  232. package/test/examples/flappy_bird/browser-entry/playback/snapshot/playback.snapshot.summary.utils.test.ts +45 -0
  233. package/test/examples/flappy_bird/browser-entry/playback/snapshot/playback.snapshot.summary.utils.ts +28 -0
  234. package/test/examples/flappy_bird/browser-entry/playback/trail/README.md +95 -0
  235. package/test/examples/flappy_bird/browser-entry/playback/trail/playback.trail.history.services.test.ts +35 -0
  236. package/test/examples/flappy_bird/browser-entry/playback/trail/playback.trail.history.services.ts +64 -0
  237. package/test/examples/flappy_bird/browser-entry/playback/trail/playback.trail.opacity.utils.test.ts +37 -0
  238. package/test/examples/flappy_bird/browser-entry/playback/trail/playback.trail.opacity.utils.ts +74 -0
  239. package/test/examples/flappy_bird/browser-entry/playback/worker-channel/README.md +71 -0
  240. package/test/examples/flappy_bird/browser-entry/playback/worker-channel/playback.worker-channel.request.services.ts +45 -0
  241. package/test/examples/flappy_bird/browser-entry/playback/worker-channel/playback.worker-channel.summary.services.ts +74 -0
  242. package/test/examples/flappy_bird/browser-entry/playback/worker-channel/playback.worker-channel.types.ts +53 -0
  243. package/test/examples/flappy_bird/browser-entry/runtime/README.md +304 -0
  244. package/test/examples/flappy_bird/browser-entry/runtime/runtime.browser-globals.service.ts +15 -0
  245. package/test/examples/flappy_bird/browser-entry/runtime/runtime.errors.ts +17 -0
  246. package/test/examples/flappy_bird/browser-entry/runtime/runtime.evolution-launch.service.ts +56 -0
  247. package/test/examples/flappy_bird/browser-entry/runtime/runtime.evolution-loop.service.ts +19 -0
  248. package/test/examples/flappy_bird/browser-entry/runtime/runtime.lifecycle.service.ts +96 -0
  249. package/test/examples/flappy_bird/browser-entry/runtime/runtime.startup.service.ts +92 -0
  250. package/test/examples/flappy_bird/browser-entry/runtime/runtime.telemetry.service.ts +24 -0
  251. package/test/examples/flappy_bird/browser-entry/runtime/runtime.ts +31 -121
  252. package/test/examples/flappy_bird/browser-entry/runtime/runtime.types.ts +65 -0
  253. package/test/examples/flappy_bird/browser-entry/visualization/README.md +568 -0
  254. package/test/examples/flappy_bird/browser-entry/visualization/visualization.colors.utils.ts +26 -0
  255. package/test/examples/flappy_bird/browser-entry/visualization/visualization.constants.ts +110 -0
  256. package/test/examples/flappy_bird/browser-entry/visualization/visualization.draw.service.ts +979 -19
  257. package/test/examples/flappy_bird/browser-entry/visualization/visualization.legend.utils.ts +157 -3
  258. package/test/examples/flappy_bird/browser-entry/visualization/visualization.topology.utils.ts +13 -27
  259. package/test/examples/flappy_bird/browser-entry/visualization/visualization.ts +7 -20
  260. package/test/examples/flappy_bird/browser-entry/visualization/visualization.types.ts +14 -0
  261. package/test/examples/flappy_bird/browser-entry/worker-channel/README.md +238 -0
  262. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.errors.ts +11 -0
  263. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.generation.service.ts +12 -0
  264. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.playback.service.test.ts +143 -0
  265. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.playback.service.ts +140 -14
  266. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.request.service.ts +27 -0
  267. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.ts +8 -0
  268. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.types.ts +23 -0
  269. package/test/examples/flappy_bird/browser-entry/worker-channel/worker-channel.url.service.ts +5 -0
  270. package/test/examples/flappy_bird/constants/README.md +1163 -0
  271. package/test/examples/flappy_bird/constants/constants.birds.ts +16 -38
  272. package/test/examples/flappy_bird/constants/constants.difficulty.ts +21 -0
  273. package/test/examples/flappy_bird/constants/constants.network-view.ts +24 -0
  274. package/test/examples/flappy_bird/constants/constants.network.ts +1 -1
  275. package/test/examples/flappy_bird/constants/constants.observation.ts +7 -0
  276. package/test/examples/flappy_bird/constants/constants.palette.ts +9 -2
  277. package/test/examples/flappy_bird/constants/constants.physics.ts +9 -0
  278. package/test/examples/flappy_bird/constants/constants.pipe-render.ts +3 -0
  279. package/test/examples/flappy_bird/constants/constants.pipes.ts +22 -3
  280. package/test/examples/flappy_bird/constants/constants.runtime.ts +28 -4
  281. package/test/examples/flappy_bird/constants/constants.starfield.ts +78 -3
  282. package/test/examples/flappy_bird/constants/constants.ts +6 -0
  283. package/test/examples/flappy_bird/environment/README.md +182 -0
  284. package/test/examples/flappy_bird/environment/environment.collision.utils.ts +7 -0
  285. package/test/examples/flappy_bird/environment/environment.constants.ts +16 -3
  286. package/test/examples/flappy_bird/environment/environment.observation.utils.ts +12 -19
  287. package/test/examples/flappy_bird/environment/environment.state.service.ts +10 -0
  288. package/test/examples/flappy_bird/environment/environment.step.service.ts +15 -66
  289. package/test/examples/flappy_bird/environment/environment.types.ts +14 -0
  290. package/test/examples/flappy_bird/evaluation/README.md +155 -0
  291. package/test/examples/flappy_bird/evaluation/evaluation.constants.ts +23 -4
  292. package/test/examples/flappy_bird/evaluation/evaluation.fitness.utils.ts +16 -1
  293. package/test/examples/flappy_bird/evaluation/evaluation.rollout.service.ts +7 -374
  294. package/test/examples/flappy_bird/evaluation/evaluation.seed.utils.ts +4 -0
  295. package/test/examples/flappy_bird/evaluation/evaluation.types.ts +18 -2
  296. package/test/examples/flappy_bird/evaluation/rollout/README.md +355 -0
  297. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.constants.ts +38 -0
  298. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.service.ts +71 -0
  299. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.services.ts +338 -0
  300. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.types.ts +69 -0
  301. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.utils.ts +399 -0
  302. package/test/examples/flappy_bird/flappy-evolution-worker/README.md +845 -0
  303. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.constants.ts +49 -7
  304. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.errors.ts +34 -3
  305. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.evolution.service.ts +22 -0
  306. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.playback.service.ts +62 -26
  307. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.protocol.service.ts +27 -1
  308. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.runtime.service.ts +23 -0
  309. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.simulation.frame.service.ts +378 -0
  310. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.simulation.types.ts +22 -0
  311. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.simulation.utils.ts +20 -203
  312. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.snapshot.utils.test.ts +94 -0
  313. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.snapshot.utils.ts +78 -13
  314. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.ts +235 -344
  315. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.types.ts +170 -22
  316. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.warm-start.service.ts +314 -0
  317. package/test/examples/flappy_bird/flappy.simulation.shared.utils.ts +17 -0
  318. package/test/examples/flappy_bird/flappyEnvironment.ts +21 -0
  319. package/test/examples/flappy_bird/flappyEvaluation.ts +12 -0
  320. package/test/examples/flappy_bird/flappyEvolution.worker.ts +7 -0
  321. package/test/examples/flappy_bird/index.ts +8 -2
  322. package/test/examples/flappy_bird/rng.ts +10 -0
  323. package/test/examples/flappy_bird/simulation-shared/README.md +518 -0
  324. package/test/examples/flappy_bird/simulation-shared/observation/README.md +255 -0
  325. package/test/examples/flappy_bird/simulation-shared/observation/observation.features.utils.ts +339 -0
  326. package/test/examples/flappy_bird/simulation-shared/observation/observation.ts +19 -0
  327. package/test/examples/flappy_bird/simulation-shared/observation/observation.vector.utils.ts +81 -0
  328. package/test/examples/flappy_bird/simulation-shared/simulation-shared.constants.ts +3 -0
  329. package/test/examples/flappy_bird/simulation-shared/simulation-shared.control.utils.ts +6 -0
  330. package/test/examples/flappy_bird/simulation-shared/simulation-shared.difficulty.utils.ts +9 -0
  331. package/test/examples/flappy_bird/simulation-shared/simulation-shared.errors.ts +10 -1
  332. package/test/examples/flappy_bird/simulation-shared/simulation-shared.memory.utils.ts +18 -0
  333. package/test/examples/flappy_bird/simulation-shared/simulation-shared.observation.utils.ts +7 -402
  334. package/test/examples/flappy_bird/simulation-shared/simulation-shared.spawn.utils.ts +36 -6
  335. package/test/examples/flappy_bird/{evaluation/evaluation.statistics.utils.ts → simulation-shared/simulation-shared.statistics.utils.ts} +30 -9
  336. package/test/examples/flappy_bird/simulation-shared/simulation-shared.types.ts +38 -5
  337. package/test/examples/flappy_bird/trainFlappyBird.ts +13 -0
  338. package/test/examples/flappy_bird/trainer/README.md +676 -0
  339. package/test/examples/flappy_bird/trainer/evaluation/README.md +253 -0
  340. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.constants.ts +15 -0
  341. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.services.ts +86 -0
  342. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.ts +187 -0
  343. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.types.ts +32 -0
  344. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.utils.ts +182 -0
  345. package/test/examples/flappy_bird/trainer/trainer.evaluation.service.ts +13 -0
  346. package/test/examples/flappy_bird/trainer/trainer.fitness.service.ts +23 -1
  347. package/test/examples/flappy_bird/trainer/trainer.loop.service.ts +17 -1
  348. package/test/examples/flappy_bird/trainer/trainer.report.service.services.ts +181 -0
  349. package/test/examples/flappy_bird/trainer/trainer.report.service.ts +136 -0
  350. package/test/examples/flappy_bird/trainer/trainer.selection.utils.ts +89 -0
  351. package/test/examples/flappy_bird/trainer/trainer.setup.service.ts +22 -0
  352. package/test/examples/flappy_bird/trainer/trainer.signals.service.ts +8 -0
  353. package/test/examples/flappy_bird/trainer/trainer.ts +38 -553
  354. package/test/examples/flappy_bird/trainer/trainer.types.ts +44 -7
  355. package/test/neat/neat.topology-intent.test.ts +129 -0
  356. package/test/network/network.topology-intent.test.ts +44 -0
  357. package/test/examples/flappy_bird/browser-entry/browser-entry.utils.ts +0 -12
  358. package/test/examples/flappy_bird/environment/environment.ts +0 -7
  359. package/test/examples/flappy_bird/evaluation/evaluation.ts +0 -7
  360. package/test/examples/flappy_bird/simulation-shared/simulation-shared.ts +0 -15
  361. package/test/examples/flappy_bird/trainer/trainer.statistics.utils.ts +0 -78
package/src/README.md CHANGED
@@ -1,4 +1,4 @@
1
- #
1
+ # src
2
2
 
3
3
  ## neat.ts
4
4
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  ### buildEmptyDiversityStats
8
8
 
9
- `(populationSize: number) => import("C:/NeatapticTS/src/neat/neat.diversity.utils").DiversityStats`
9
+ `(populationSize: number) => import("src/neat/neat.diversity.utils").DiversityStats`
10
10
 
11
11
  Build a zeroed diversity stats snapshot to use when no population metrics exist yet.
12
12
 
@@ -74,7 +74,7 @@ Returns: Adjusted species fitness data.
74
74
 
75
75
  #### _compatibilityDistance
76
76
 
77
- `(netA: import("C:/NeatapticTS/src/architecture/network").default, netB: import("C:/NeatapticTS/src/architecture/network").default) => number`
77
+ `(netA: import("src/architecture/network").default, netB: import("src/architecture/network").default) => number`
78
78
 
79
79
  Compute compatibility distance between two networks (delegates to compat module).
80
80
 
@@ -86,7 +86,7 @@ Returns: Compatibility distance scalar.
86
86
 
87
87
  #### _computeDiversityStats
88
88
 
89
- `() => import("C:/NeatapticTS/src/neat/neat.diversity.utils").DiversityStats`
89
+ `() => import("src/neat/neat.diversity.utils").DiversityStats`
90
90
 
91
91
  Compute and cache diversity statistics used by telemetry and tests.
92
92
 
@@ -109,7 +109,7 @@ Returns: Innovation id for the connection.
109
109
 
110
110
  #### _getObjectives
111
111
 
112
- `() => import("C:/NeatapticTS/src/neat/neat.types").ObjectiveDescriptor[]`
112
+ `() => import("src/neat/neat.types").ObjectiveDescriptor[]`
113
113
 
114
114
  Internal: return cached objective descriptors, building if stale.
115
115
 
@@ -150,7 +150,7 @@ Whether lineage metadata should be recorded on genomes.
150
150
 
151
151
  #### _mutateAddConnReuse
152
152
 
153
- `(genome: import("C:/NeatapticTS/src/architecture/network").default) => void`
153
+ `(genome: import("src/architecture/network").default) => void`
154
154
 
155
155
  Add-connection mutation that reuses global innovation ids when possible.
156
156
 
@@ -161,7 +161,7 @@ Returns: Mutated genome with added connection.
161
161
 
162
162
  #### _mutateAddNodeReuse
163
163
 
164
- `(genome: import("C:/NeatapticTS/src/architecture/network").default) => Promise<void>`
164
+ `(genome: import("src/architecture/network").default) => Promise<void>`
165
165
 
166
166
  Add-node mutation that reuses global innovation ids when possible.
167
167
 
@@ -204,7 +204,7 @@ Internal numeric state for the deterministic xorshift RNG when no user RNG is pr
204
204
 
205
205
  #### _sortSpeciesMembers
206
206
 
207
- `(sp: import("C:/NeatapticTS/src/neat/neat.types").SpeciesLike) => void`
207
+ `(sp: import("src/neat/neat.types").SpeciesLike) => void`
208
208
 
209
209
  Sort members within a species according to fitness and lineage rules.
210
210
 
@@ -227,7 +227,7 @@ Time-series history of species stats (for exports/telemetry).
227
227
 
228
228
  #### _structuralEntropy
229
229
 
230
- `(genome: import("C:/NeatapticTS/src/architecture/network").default) => number`
230
+ `(genome: import("src/architecture/network").default) => number`
231
231
 
232
232
  Compatibility wrapper retained for tests that reference (neat as any)._structuralEntropy.
233
233
 
@@ -256,7 +256,7 @@ Emit a standardized warning when evolution loop finds no valid best genome (test
256
256
 
257
257
  #### addGenome
258
258
 
259
- `(genome: import("C:/NeatapticTS/src/architecture/network").default, parents: number[] | undefined) => void`
259
+ `(genome: import("src/architecture/network").default, parents: number[] | undefined) => void`
260
260
 
261
261
  Register an externally-created genome into the `Neat` population.
262
262
 
@@ -293,19 +293,19 @@ Clear telemetry buffer and cached entries.
293
293
 
294
294
  #### createPool
295
295
 
296
- `(network: import("C:/NeatapticTS/src/architecture/network").default | null) => void`
296
+ `(network: import("src/architecture/network").default | null) => void`
297
297
 
298
298
  Create initial population pool. Delegates to helpers if present.
299
299
 
300
300
  #### ensureMinHiddenNodes
301
301
 
302
- `(network: import("C:/NeatapticTS/src/architecture/network").default, multiplierOverride: number | undefined) => Promise<void>`
302
+ `(network: import("src/architecture/network").default, multiplierOverride: number | undefined) => Promise<void>`
303
303
 
304
304
  Ensure a network has the minimum number of hidden nodes according to configured policy.
305
305
 
306
306
  #### ensureNoDeadEnds
307
307
 
308
- `(network: import("C:/NeatapticTS/src/architecture/network").default) => void`
308
+ `(network: import("src/architecture/network").default) => void`
309
309
 
310
310
  Delegate ensureNoDeadEnds to mutation module (added for backward compat).
311
311
 
@@ -320,7 +320,7 @@ Returns: Aggregated evaluation result (implementation specific).
320
320
 
321
321
  #### evolve
322
322
 
323
- `() => Promise<import("C:/NeatapticTS/src/architecture/network").default>`
323
+ `() => Promise<import("src/architecture/network").default>`
324
324
 
325
325
  Evolves the population by selecting, mutating, and breeding genomes.
326
326
  This method is delegated to `src/neat/neat.evolve.ts` during the migration.
@@ -381,13 +381,13 @@ Calculates the average fitness score of the population.
381
381
 
382
382
  #### getDiversityStats
383
383
 
384
- `() => import("C:/NeatapticTS/src/neat/neat.diversity.utils").DiversityStats`
384
+ `() => import("src/neat/neat.diversity.utils").DiversityStats`
385
385
 
386
386
  Return the latest cached diversity statistics.
387
387
 
388
388
  #### getFittest
389
389
 
390
- `() => import("C:/NeatapticTS/src/architecture/network").default`
390
+ `() => import("src/architecture/network").default`
391
391
 
392
392
  Retrieves the fittest genome from the population.
393
393
 
@@ -435,7 +435,7 @@ Return a lightweight list of registered objective keys and their directions.
435
435
 
436
436
  #### getOffspring
437
437
 
438
- `() => import("C:/NeatapticTS/src/architecture/network").default`
438
+ `() => import("src/architecture/network").default`
439
439
 
440
440
  Generates an offspring by crossing over two parent networks.
441
441
  Uses the crossover method described in the Instinct algorithm.
@@ -450,7 +450,7 @@ Returns a summary of mutation/operator statistics used by operator adaptation.
450
450
 
451
451
  #### getParent
452
452
 
453
- `() => import("C:/NeatapticTS/src/architecture/network").default`
453
+ `() => import("src/architecture/network").default`
454
454
 
455
455
  Selects a parent genome for breeding based on the selection method.
456
456
  Supports multiple selection strategies, including POWER, FITNESS_PROPORTIONATE, and TOURNAMENT.
@@ -459,13 +459,13 @@ Returns: The selected parent genome.
459
459
 
460
460
  #### getParetoArchive
461
461
 
462
- `(maxEntries: number) => import("C:/NeatapticTS/src/neat/neat.types").ParetoArchiveEntry[]`
462
+ `(maxEntries: number) => import("src/neat/neat.types").ParetoArchiveEntry[]`
463
463
 
464
464
  Get recent Pareto archive entries (meta information about archived fronts).
465
465
 
466
466
  #### getParetoFronts
467
467
 
468
- `(maxFronts: number) => import("C:/NeatapticTS/src/architecture/network").default[][]`
468
+ `(maxFronts: number) => import("src/architecture/network").default[][]`
469
469
 
470
470
  Reconstruct Pareto fronts for the current population snapshot.
471
471
 
@@ -477,7 +477,7 @@ Return recent performance statistics for the most recent evaluation and evolve o
477
477
 
478
478
  #### getSpeciesHistory
479
479
 
480
- `() => import("C:/NeatapticTS/src/neat/neat.types").SpeciesHistoryEntry[]`
480
+ `() => import("src/neat/neat.types").SpeciesHistoryEntry[]`
481
481
 
482
482
  Returns the historical species statistics recorded each generation.
483
483
 
@@ -489,7 +489,7 @@ Return a concise summary for each current species.
489
489
 
490
490
  #### getTelemetry
491
491
 
492
- `() => import("C:/NeatapticTS/src/neat/neat.types").TelemetryEntry[]`
492
+ `() => import("src/neat/neat.types").TelemetryEntry[]`
493
493
 
494
494
  Return the internal telemetry buffer.
495
495
 
@@ -510,7 +510,7 @@ Parameters:
510
510
 
511
511
  #### importState
512
512
 
513
- `(bundle: any, fitness: (n: import("C:/NeatapticTS/src/architecture/network").default) => number) => Promise<import("C:/NeatapticTS/src/neat").default>`
513
+ `(bundle: any, fitness: (n: import("src/architecture/network").default) => number) => Promise<import("src/neat").default>`
514
514
 
515
515
  Convenience: restore full evolutionary state previously produced by exportState().
516
516
 
@@ -561,7 +561,7 @@ Returns: Array of deterministic random samples.
561
561
 
562
562
  #### selectMutationMethod
563
563
 
564
- `(genome: import("C:/NeatapticTS/src/architecture/network").default, rawReturnForTest: boolean) => any`
564
+ `(genome: import("src/architecture/network").default, rawReturnForTest: boolean) => any`
565
565
 
566
566
  Selects a mutation method for a given genome based on constraints.
567
567
 
@@ -580,7 +580,7 @@ Sorts the population in descending order of fitness scores.
580
580
 
581
581
  #### spawnFromParent
582
582
 
583
- `(parent: import("C:/NeatapticTS/src/architecture/network").default, mutateCount: number) => import("C:/NeatapticTS/src/architecture/network").default`
583
+ `(parent: import("src/architecture/network").default, mutateCount: number) => import("src/architecture/network").default`
584
584
 
585
585
  Spawn a new genome derived from a single parent while preserving Neat bookkeeping.
586
586
 
@@ -717,7 +717,7 @@ Returns: True when fast-slab activation can be used.
717
717
 
718
718
  #### _compatibilityDistance
719
719
 
720
- `(netA: import("C:/NeatapticTS/src/architecture/network").default, netB: import("C:/NeatapticTS/src/architecture/network").default) => number`
720
+ `(netA: import("src/architecture/network").default, netB: import("src/architecture/network").default) => number`
721
721
 
722
722
  Compute compatibility distance between two networks (delegates to compat module).
723
723
 
@@ -729,7 +729,7 @@ Returns: Compatibility distance scalar.
729
729
 
730
730
  #### _computeDiversityStats
731
731
 
732
- `() => import("C:/NeatapticTS/src/neat/neat.diversity.utils").DiversityStats`
732
+ `() => import("src/neat/neat.diversity.utils").DiversityStats`
733
733
 
734
734
  Compute and cache diversity statistics used by telemetry and tests.
735
735
 
@@ -831,7 +831,7 @@ Returns: Gaussian random value.
831
831
 
832
832
  #### _getObjectives
833
833
 
834
- `() => import("C:/NeatapticTS/src/neat/neat.types").ObjectiveDescriptor[]`
834
+ `() => import("src/neat/neat.types").ObjectiveDescriptor[]`
835
835
 
836
836
  Internal: return cached objective descriptors, building if stale.
837
837
 
@@ -863,7 +863,7 @@ Whether to apply separate bias clipping.
863
863
 
864
864
  #### _hasPath
865
865
 
866
- `(from: import("C:/NeatapticTS/src/architecture/node").default, to: import("C:/NeatapticTS/src/architecture/node").default) => boolean`
866
+ `(from: import("src/architecture/node").default, to: import("src/architecture/node").default) => boolean`
867
867
 
868
868
  Check whether a directed path exists between two nodes.
869
869
 
@@ -943,7 +943,7 @@ Mixed precision state counters.
943
943
 
944
944
  #### _mutateAddConnReuse
945
945
 
946
- `(genome: import("C:/NeatapticTS/src/architecture/network").default) => void`
946
+ `(genome: import("src/architecture/network").default) => void`
947
947
 
948
948
  Add-connection mutation that reuses global innovation ids when possible.
949
949
 
@@ -954,7 +954,7 @@ Returns: Mutated genome with added connection.
954
954
 
955
955
  #### _mutateAddNodeReuse
956
956
 
957
- `(genome: import("C:/NeatapticTS/src/architecture/network").default) => Promise<void>`
957
+ `(genome: import("src/architecture/network").default) => Promise<void>`
958
958
 
959
959
  Add-node mutation that reuses global innovation ids when possible.
960
960
 
@@ -1035,7 +1035,7 @@ Internal numeric state for the deterministic xorshift RNG when no user RNG is pr
1035
1035
 
1036
1036
  #### _safeUpdateWeight
1037
1037
 
1038
- `(connection: import("C:/NeatapticTS/src/architecture/connection").default, delta: number) => void`
1038
+ `(connection: import("src/architecture/connection").default, delta: number) => void`
1039
1039
 
1040
1040
  Internal helper to safely update a connection weight with clipping and NaN checks.
1041
1041
 
@@ -1045,7 +1045,7 @@ Slab dirty marker.
1045
1045
 
1046
1046
  #### _sortSpeciesMembers
1047
1047
 
1048
- `(sp: import("C:/NeatapticTS/src/neat/neat.types").SpeciesLike) => void`
1048
+ `(sp: import("src/neat/neat.types").SpeciesLike) => void`
1049
1049
 
1050
1050
  Sort members within a species according to fitness and lineage rules.
1051
1051
 
@@ -1076,7 +1076,7 @@ Dynamic stochastic depth schedule.
1076
1076
 
1077
1077
  #### _structuralEntropy
1078
1078
 
1079
- `(genome: import("C:/NeatapticTS/src/architecture/network").default) => number`
1079
+ `(genome: import("src/architecture/network").default) => number`
1080
1080
 
1081
1081
  Compatibility wrapper retained for tests that reference (neat as any)._structuralEntropy.
1082
1082
 
@@ -1093,6 +1093,10 @@ Telemetry buffer storing diagnostic snapshots per generation.
1093
1093
 
1094
1094
  Topology dirty marker.
1095
1095
 
1096
+ #### _topologyIntent
1097
+
1098
+ Public topology intent used to preserve semantic API choices.
1099
+
1096
1100
  #### _topoOrder
1097
1101
 
1098
1102
  Cached topological order.
@@ -1137,7 +1141,7 @@ Original weights captured for weight-noise recovery.
1137
1141
 
1138
1142
  #### acquire
1139
1143
 
1140
- `(from: import("C:/NeatapticTS/src/architecture/node").default, to: import("C:/NeatapticTS/src/architecture/node").default, weight: number | undefined) => import("C:/NeatapticTS/src/architecture/connection").default`
1144
+ `(from: import("src/architecture/node").default, to: import("src/architecture/node").default, weight: number | undefined) => import("src/architecture/connection").default`
1141
1145
 
1142
1146
  Acquire a `Connection` from the pool (or construct new). Fields are fully reset & given
1143
1147
  a fresh sequential `innovation` id. Prefer this in evolutionary algorithms that mutate
@@ -1157,11 +1161,6 @@ Returns: Reinitialized connection instance.
1157
1161
  Activates the network using the given input array.
1158
1162
  Performs a forward pass through the network, calculating the activation of each node.
1159
1163
 
1160
- Parameters:
1161
- - `` - - An array of numerical values corresponding to the network's input nodes.
1162
- - `` - - Flag indicating if the activation is part of a training process.
1163
- - `` - - Maximum allowed activation depth to prevent infinite loops/cycles.
1164
-
1165
1164
  Returns: An array of numerical values representing the activations of the network's output nodes.
1166
1165
 
1167
1166
  #### activate
@@ -1214,9 +1213,6 @@ Activates all nodes in the group. If input values are provided, they are assigne
1214
1213
  sequentially to the nodes before activation. Otherwise, nodes activate based on their
1215
1214
  existing states and incoming connections.
1216
1215
 
1217
- Parameters:
1218
- - `` - - An optional array of input values. If provided, its length must match the number of nodes in the group.
1219
-
1220
1216
  Returns: An array containing the activation value of each node in the group, in order.
1221
1217
 
1222
1218
  #### activateBatch
@@ -1237,7 +1233,7 @@ Returns: Array of output vectors, each length equals this.output
1237
1233
 
1238
1234
  #### activateRaw
1239
1235
 
1240
- `(input: number[], training: boolean, maxActivationDepth: number) => import("C:/NeatapticTS/src/architecture/activationArrayPool").ActivationArray`
1236
+ `(input: number[], training: boolean, maxActivationDepth: number) => import("src/architecture/activationArrayPool").ActivationArray`
1241
1237
 
1242
1238
  Raw activation that can return a typed array when pooling is enabled (zero-copy).
1243
1239
  If reuseActivationArrays=false falls back to standard activate().
@@ -1255,7 +1251,7 @@ The output value of the node after applying the activation function. This is the
1255
1251
 
1256
1252
  #### addGenome
1257
1253
 
1258
- `(genome: import("C:/NeatapticTS/src/architecture/network").default, parents: number[] | undefined) => void`
1254
+ `(genome: import("src/architecture/network").default, parents: number[] | undefined) => void`
1259
1255
 
1260
1256
  Register an externally-created genome into the `Neat` population.
1261
1257
 
@@ -1344,7 +1340,7 @@ index and configuration in `options.evolutionPruning`.
1344
1340
 
1345
1341
  #### attention
1346
1342
 
1347
- `(size: number, heads: number) => import("C:/NeatapticTS/src/architecture/layer").default`
1343
+ `(size: number, heads: number) => import("src/architecture/layer").default`
1348
1344
 
1349
1345
  Creates a multi-head self-attention layer (stub implementation).
1350
1346
 
@@ -1356,7 +1352,7 @@ Returns: A new Layer instance representing an attention layer.
1356
1352
 
1357
1353
  #### batchNorm
1358
1354
 
1359
- `(size: number) => import("C:/NeatapticTS/src/architecture/layer").default`
1355
+ `(size: number) => import("src/architecture/layer").default`
1360
1356
 
1361
1357
  Creates a batch normalization layer.
1362
1358
  Applies batch normalization to the activations of the nodes in this layer during activation.
@@ -1411,7 +1407,7 @@ Clear the dynamic global weight-noise schedule.
1411
1407
 
1412
1408
  #### clone
1413
1409
 
1414
- `() => import("C:/NeatapticTS/src/architecture/network").default`
1410
+ `() => import("src/architecture/network").default`
1415
1411
 
1416
1412
  Creates a deep copy of the network.
1417
1413
 
@@ -1428,22 +1424,17 @@ Parameters:
1428
1424
 
1429
1425
  #### connect
1430
1426
 
1431
- `(from: import("C:/NeatapticTS/src/architecture/node").default, to: import("C:/NeatapticTS/src/architecture/node").default, weight: number | undefined) => import("C:/NeatapticTS/src/architecture/connection").default[]`
1427
+ `(from: import("src/architecture/node").default, to: import("src/architecture/node").default, weight: number | undefined) => import("src/architecture/connection").default[]`
1432
1428
 
1433
1429
  Creates a connection between two nodes in the network.
1434
1430
  Handles both regular connections and self-connections.
1435
1431
  Adds the new connection object(s) to the appropriate network list (`connections` or `selfconns`).
1436
1432
 
1437
- Parameters:
1438
- - `` - - The source node of the connection.
1439
- - `` - - The target node of the connection.
1440
- - `` - - Optional weight for the connection. If not provided, a random weight is usually assigned by the underlying `Node.connect` method.
1441
-
1442
1433
  Returns: An array containing the newly created connection object(s). Typically contains one connection, but might be empty or contain more in specialized node types.
1443
1434
 
1444
1435
  #### connect
1445
1436
 
1446
- `(target: import("C:/NeatapticTS/src/architecture/node").default | { nodes: import("C:/NeatapticTS/src/architecture/node").default[]; }, weight: number | undefined) => import("C:/NeatapticTS/src/architecture/connection").default[]`
1437
+ `(target: import("src/architecture/node").default | { nodes: import("src/architecture/node").default[]; }, weight: number | undefined) => import("src/architecture/connection").default[]`
1447
1438
 
1448
1439
  Creates a connection from this node to a target node or all nodes in a group.
1449
1440
 
@@ -1455,7 +1446,7 @@ Returns: An array containing the newly created Connection object(s).
1455
1446
 
1456
1447
  #### connect
1457
1448
 
1458
- `(target: import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/group").default | import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerLike, method: unknown, weight: number | undefined) => import("C:/NeatapticTS/src/architecture/connection").default[]`
1449
+ `(target: import("src/architecture/node").default | import("src/architecture/group").default | import("src/architecture/layer/layer.utils.types").LayerLike, method: unknown, weight: number | undefined) => import("src/architecture/connection").default[]`
1459
1450
 
1460
1451
  Connects this layer's output to a target component (Layer, Group, or Node).
1461
1452
 
@@ -1472,16 +1463,11 @@ Returns: An array containing the newly created connection objects.
1472
1463
 
1473
1464
  #### connect
1474
1465
 
1475
- `(target: import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/layer").default | import("C:/NeatapticTS/src/architecture/group").default, method: unknown, weight: number | undefined) => import("C:/NeatapticTS/src/architecture/connection").default[]`
1466
+ `(target: import("src/architecture/node").default | import("src/architecture/layer").default | import("src/architecture/group").default, method: unknown, weight: number | undefined) => import("src/architecture/connection").default[]`
1476
1467
 
1477
1468
  Establishes connections from all nodes in this group to a target Group, Layer, or Node.
1478
1469
  The connection pattern (e.g., all-to-all, one-to-one) can be specified.
1479
1470
 
1480
- Parameters:
1481
- - `` - - The destination entity (Group, Layer, or Node) to connect to.
1482
- - `` - - The connection method/type (e.g., `methods.groupConnection.ALL_TO_ALL`, `methods.groupConnection.ONE_TO_ONE`). Defaults depend on the target type and whether it's the same group.
1483
- - `` - - An optional fixed weight to assign to all created connections. If not provided, weights might be initialized randomly or based on node defaults.
1484
-
1485
1471
  Returns: An array containing all the connection objects created.
1486
1472
 
1487
1473
  #### connections
@@ -1490,7 +1476,7 @@ Connection list.
1490
1476
 
1491
1477
  #### construct
1492
1478
 
1493
- `(list: (import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/layer").default | import("C:/NeatapticTS/src/architecture/group").default)[]) => import("C:/NeatapticTS/src/architecture/network").default`
1479
+ `(list: (import("src/architecture/node").default | import("src/architecture/layer").default | import("src/architecture/group").default)[]) => import("src/architecture/network").default`
1494
1480
 
1495
1481
  Constructs a Network instance from an array of interconnected Layers, Groups, or Nodes.
1496
1482
 
@@ -1499,14 +1485,11 @@ gates, and self-connections, and determines the network's input and output sizes
1499
1485
  on the `type` property ('input' or 'output') set on the nodes. It uses Sets internally
1500
1486
  for efficient handling of unique elements during construction.
1501
1487
 
1502
- Parameters:
1503
- - `` - - An array containing the building blocks (Nodes, Layers, Groups) of the network, assumed to be already interconnected.
1504
-
1505
1488
  Returns: A Network object representing the constructed architecture.
1506
1489
 
1507
1490
  #### conv1d
1508
1491
 
1509
- `(size: number, kernelSize: number, stride: number, padding: number) => import("C:/NeatapticTS/src/architecture/layer").default`
1492
+ `(size: number, kernelSize: number, stride: number, padding: number) => import("src/architecture/layer").default`
1510
1493
 
1511
1494
  Creates a 1D convolutional layer (stub implementation).
1512
1495
 
@@ -1520,26 +1503,21 @@ Returns: A new Layer instance representing a 1D convolutional layer.
1520
1503
 
1521
1504
  #### createMLP
1522
1505
 
1523
- `(inputCount: number, hiddenCounts: number[], outputCount: number) => import("C:/NeatapticTS/src/architecture/network").default`
1506
+ `(inputCount: number, hiddenCounts: number[], outputCount: number) => import("src/architecture/network").default`
1524
1507
 
1525
1508
  Creates a fully connected, strictly layered MLP network.
1526
1509
 
1527
- Parameters:
1528
- - `` - - Number of input nodes
1529
- - `` - - Array of hidden layer sizes (e.g. [2,3] for two hidden layers)
1530
- - `` - - Number of output nodes
1531
-
1532
1510
  Returns: A new, fully connected, layered MLP
1533
1511
 
1534
1512
  #### createPool
1535
1513
 
1536
- `(network: import("C:/NeatapticTS/src/architecture/network").default | null) => void`
1514
+ `(network: import("src/architecture/network").default | null) => void`
1537
1515
 
1538
1516
  Create initial population pool. Delegates to helpers if present.
1539
1517
 
1540
1518
  #### crossOver
1541
1519
 
1542
- `(network1: import("C:/NeatapticTS/src/architecture/network").default, network2: import("C:/NeatapticTS/src/architecture/network").default, equal: boolean) => import("C:/NeatapticTS/src/architecture/network").default`
1520
+ `(network1: import("src/architecture/network").default, network2: import("src/architecture/network").default, equal: boolean) => import("src/architecture/network").default`
1543
1521
 
1544
1522
  Creates a new offspring network by performing crossover between two parent networks.
1545
1523
  This method implements the crossover mechanism inspired by the NEAT algorithm and described
@@ -1547,12 +1525,6 @@ in the Instinct paper, combining genes (nodes and connections) from both parents
1547
1525
  Fitness scores can influence the inheritance process. Matching genes are inherited randomly,
1548
1526
  while disjoint/excess genes are typically inherited from the fitter parent (or randomly if fitness is equal or `equal` flag is set).
1549
1527
 
1550
- Parameters:
1551
- - `` - - The first parent network.
1552
- - `` - - The second parent network.
1553
- - `` - - If true, disjoint and excess genes are inherited randomly regardless of fitness.
1554
- If false (default), they are inherited from the fitter parent.
1555
-
1556
1528
  Returns: A new Network instance representing the offspring.
1557
1529
 
1558
1530
  #### dcMask
@@ -1561,7 +1533,7 @@ DropConnect active mask: 1 = not dropped (active), 0 = dropped for this stochast
1561
1533
 
1562
1534
  #### dense
1563
1535
 
1564
- `(size: number) => import("C:/NeatapticTS/src/architecture/layer").default`
1536
+ `(size: number) => import("src/architecture/layer").default`
1565
1537
 
1566
1538
  Creates a standard fully connected (dense) layer.
1567
1539
 
@@ -1579,7 +1551,7 @@ The derivative of the activation function evaluated at the node's current state.
1579
1551
 
1580
1552
  #### describeArchitecture
1581
1553
 
1582
- `() => import("C:/NeatapticTS/src/architecture/network/network.types").NetworkArchitectureDescriptor`
1554
+ `() => import("src/architecture/network/network.types").NetworkArchitectureDescriptor`
1583
1555
 
1584
1556
  Resolves a stable architecture descriptor for telemetry/UI consumers.
1585
1557
 
@@ -1590,17 +1562,11 @@ Returns: Architecture descriptor with hidden-layer widths and provenance.
1590
1562
 
1591
1563
  #### deserialize
1592
1564
 
1593
- `(data: [number[], number[], string[], { from: number; to: number; weight: number; gater: number | null; }[], number, number] | unknown[], inputSize: number | undefined, outputSize: number | undefined) => import("C:/NeatapticTS/src/architecture/network").default`
1565
+ `(data: [number[], number[], string[], { from: number; to: number; weight: number; gater: number | null; }[], number, number] | unknown[], inputSize: number | undefined, outputSize: number | undefined) => import("src/architecture/network").default`
1594
1566
 
1595
1567
  Creates a Network instance from serialized data produced by `serialize()`.
1596
1568
  Reconstructs the network structure and state based on the provided arrays.
1597
1569
 
1598
- Parameters:
1599
- - `` - - The serialized network data array, typically obtained from `network.serialize()`.
1600
- Expected format: `[activations, states, squashNames, connectionData, inputSize, outputSize]`.
1601
- - `` - - Optional input size override.
1602
- - `` - - Optional output size override.
1603
-
1604
1570
  Returns: A new Network instance reconstructed from the serialized data.
1605
1571
 
1606
1572
  #### disableDropConnect
@@ -1623,19 +1589,15 @@ Disable all weight-noise settings.
1623
1589
 
1624
1590
  #### disconnect
1625
1591
 
1626
- `(from: import("C:/NeatapticTS/src/architecture/node").default, to: import("C:/NeatapticTS/src/architecture/node").default) => void`
1592
+ `(from: import("src/architecture/node").default, to: import("src/architecture/node").default) => void`
1627
1593
 
1628
1594
  Disconnects two nodes, removing the connection between them.
1629
1595
  Handles both regular connections and self-connections.
1630
1596
  If the connection being removed was gated, it is also ungated.
1631
1597
 
1632
- Parameters:
1633
- - `` - - The source node of the connection to remove.
1634
- - `` - - The target node of the connection to remove.
1635
-
1636
1598
  #### disconnect
1637
1599
 
1638
- `(target: import("C:/NeatapticTS/src/architecture/node").default, twosided: boolean) => void`
1600
+ `(target: import("src/architecture/node").default, twosided: boolean) => void`
1639
1601
 
1640
1602
  Removes the connection from this node to the target node.
1641
1603
 
@@ -1645,7 +1607,7 @@ Parameters:
1645
1607
 
1646
1608
  #### disconnect
1647
1609
 
1648
- `(target: import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/group").default, twosided: boolean | undefined) => void`
1610
+ `(target: import("src/architecture/node").default | import("src/architecture/group").default, twosided: boolean | undefined) => void`
1649
1611
 
1650
1612
  Removes connections between this layer's nodes and a target Group or Node.
1651
1613
 
@@ -1655,14 +1617,10 @@ Parameters:
1655
1617
 
1656
1618
  #### disconnect
1657
1619
 
1658
- `(target: import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/group").default, twosided: boolean) => void`
1620
+ `(target: import("src/architecture/node").default | import("src/architecture/group").default, twosided: boolean) => void`
1659
1621
 
1660
1622
  Removes connections between nodes in this group and a target Group or Node.
1661
1623
 
1662
- Parameters:
1663
- - `` - - The Group or Node to disconnect from.
1664
- - `` - - If true, also removes connections originating from the `target` and ending in this group. Defaults to false (only removes connections from this group to the target).
1665
-
1666
1624
  #### dropConnectActiveMask
1667
1625
 
1668
1626
  Convenience alias for DropConnect mask with clearer naming.
@@ -1699,27 +1657,24 @@ Parameters:
1699
1657
 
1700
1658
  #### enforceMinimumHiddenLayerSizes
1701
1659
 
1702
- `(network: import("C:/NeatapticTS/src/architecture/network").default) => import("C:/NeatapticTS/src/architecture/network").default`
1660
+ `(network: import("src/architecture/network").default) => import("src/architecture/network").default`
1703
1661
 
1704
1662
  Enforces the minimum hidden layer size rule on a network.
1705
1663
 
1706
1664
  This ensures that all hidden layers have at least min(input, output) + 1 nodes,
1707
1665
  which is a common heuristic to ensure networks have adequate representation capacity.
1708
1666
 
1709
- Parameters:
1710
- - `` - - The network to enforce minimum hidden layer sizes on
1711
-
1712
1667
  Returns: The same network with properly sized hidden layers
1713
1668
 
1714
1669
  #### ensureMinHiddenNodes
1715
1670
 
1716
- `(network: import("C:/NeatapticTS/src/architecture/network").default, multiplierOverride: number | undefined) => Promise<void>`
1671
+ `(network: import("src/architecture/network").default, multiplierOverride: number | undefined) => Promise<void>`
1717
1672
 
1718
1673
  Ensure a network has the minimum number of hidden nodes according to configured policy.
1719
1674
 
1720
1675
  #### ensureNoDeadEnds
1721
1676
 
1722
- `(network: import("C:/NeatapticTS/src/architecture/network").default) => void`
1677
+ `(network: import("src/architecture/network").default) => void`
1723
1678
 
1724
1679
  Delegate ensureNoDeadEnds to mutation module (added for backward compat).
1725
1680
 
@@ -1738,7 +1693,7 @@ Returns: Aggregated evaluation result (implementation specific).
1738
1693
 
1739
1694
  #### evolve
1740
1695
 
1741
- `() => Promise<import("C:/NeatapticTS/src/architecture/network").default>`
1696
+ `() => Promise<import("src/architecture/network").default>`
1742
1697
 
1743
1698
  Evolves the population by selecting, mutating, and breeding genomes.
1744
1699
  This method is delegated to `src/neat/neat.evolve.ts` during the migration.
@@ -1812,19 +1767,16 @@ The source (pre-synaptic) node supplying activation.
1812
1767
 
1813
1768
  #### fromJSON
1814
1769
 
1815
- `(json: Record<string, unknown>) => import("C:/NeatapticTS/src/architecture/network").default`
1770
+ `(json: Record<string, unknown>) => import("src/architecture/network").default`
1816
1771
 
1817
1772
  Reconstructs a network from a JSON object (latest standard).
1818
1773
  Handles formatVersion, robust error handling, and index-based references.
1819
1774
 
1820
- Parameters:
1821
- - `` - - The JSON object representing the network.
1822
-
1823
1775
  Returns: The reconstructed network.
1824
1776
 
1825
1777
  #### fromJSON
1826
1778
 
1827
- `(json: { bias: number; type: string; squash: string; mask: number; }) => import("C:/NeatapticTS/src/architecture/node").default`
1779
+ `(json: { bias: number; type: string; squash: string; mask: number; }) => import("src/architecture/node").default`
1828
1780
 
1829
1781
  Creates a Node instance from a JSON object.
1830
1782
 
@@ -1841,19 +1793,15 @@ large populations where most connections are ungated.
1841
1793
 
1842
1794
  #### gate
1843
1795
 
1844
- `(node: import("C:/NeatapticTS/src/architecture/node").default, connection: import("C:/NeatapticTS/src/architecture/connection").default) => void`
1796
+ `(node: import("src/architecture/node").default, connection: import("src/architecture/connection").default) => void`
1845
1797
 
1846
1798
  Gates a connection with a specified node.
1847
1799
  The activation of the `node` (gater) will modulate the weight of the `connection`.
1848
1800
  Adds the connection to the network's `gates` list.
1849
1801
 
1850
- Parameters:
1851
- - `` - - The node that will act as the gater. Must be part of this network.
1852
- - `` - - The connection to be gated.
1853
-
1854
1802
  #### gate
1855
1803
 
1856
- `(connections: import("C:/NeatapticTS/src/architecture/connection").default | import("C:/NeatapticTS/src/architecture/connection").default[]) => void`
1804
+ `(connections: import("src/architecture/connection").default | import("src/architecture/connection").default[]) => void`
1857
1805
 
1858
1806
  Makes this node gate the provided connection(s).
1859
1807
  The connection's gain will be controlled by this node's activation value.
@@ -1863,7 +1811,7 @@ Parameters:
1863
1811
 
1864
1812
  #### gate
1865
1813
 
1866
- `(connections: import("C:/NeatapticTS/src/architecture/connection").default[], method: unknown) => void`
1814
+ `(connections: import("src/architecture/connection").default[], method: unknown) => void`
1867
1815
 
1868
1816
  Applies gating to a set of connections originating from this layer's output group.
1869
1817
 
@@ -1876,15 +1824,11 @@ Parameters:
1876
1824
 
1877
1825
  #### gate
1878
1826
 
1879
- `(connections: import("C:/NeatapticTS/src/architecture/connection").default | import("C:/NeatapticTS/src/architecture/connection").default[], method: unknown) => void`
1827
+ `(connections: import("src/architecture/connection").default | import("src/architecture/connection").default[], method: unknown) => void`
1880
1828
 
1881
1829
  Configures nodes within this group to act as gates for the specified connection(s).
1882
1830
  Gating allows the output of a node in this group to modulate the flow of signal through the gated connection.
1883
1831
 
1884
- Parameters:
1885
- - `` - - A single connection object or an array of connection objects to be gated.
1886
- - `` - - The gating mechanism to use (e.g., `methods.gating.INPUT`, `methods.gating.OUTPUT`, `methods.gating.SELF`). Specifies which part of the connection is influenced by the gater node.
1887
-
1888
1832
  #### gater
1889
1833
 
1890
1834
  Optional gating node whose activation can modulate effective weight (symbol-backed).
@@ -1905,7 +1849,7 @@ Calculates the average fitness score of the population.
1905
1849
 
1906
1850
  #### getConnectionSlab
1907
1851
 
1908
- `() => import("C:/NeatapticTS/src/architecture/network/slab/network.slab.utils.types").ConnectionSlabView`
1852
+ `() => import("src/architecture/network/slab/network.slab.utils.types").ConnectionSlabView`
1909
1853
 
1910
1854
  Read slab structures for fast activation.
1911
1855
 
@@ -1921,13 +1865,13 @@ Returns: Current sparsity in $[0,1]$.
1921
1865
 
1922
1866
  #### getDiversityStats
1923
1867
 
1924
- `() => import("C:/NeatapticTS/src/neat/neat.diversity.utils").DiversityStats`
1868
+ `() => import("src/neat/neat.diversity.utils").DiversityStats`
1925
1869
 
1926
1870
  Return the latest cached diversity statistics.
1927
1871
 
1928
1872
  #### getFittest
1929
1873
 
1930
- `() => import("C:/NeatapticTS/src/architecture/network").default`
1874
+ `() => import("src/architecture/network").default`
1931
1875
 
1932
1876
  Retrieves the fittest genome from the population.
1933
1877
 
@@ -1987,7 +1931,7 @@ Return a lightweight list of registered objective keys and their directions.
1987
1931
 
1988
1932
  #### getOffspring
1989
1933
 
1990
- `() => import("C:/NeatapticTS/src/architecture/network").default`
1934
+ `() => import("src/architecture/network").default`
1991
1935
 
1992
1936
  Generates an offspring by crossing over two parent networks.
1993
1937
  Uses the crossover method described in the Instinct algorithm.
@@ -2002,7 +1946,7 @@ Returns a summary of mutation/operator statistics used by operator adaptation.
2002
1946
 
2003
1947
  #### getParent
2004
1948
 
2005
- `() => import("C:/NeatapticTS/src/architecture/network").default`
1949
+ `() => import("src/architecture/network").default`
2006
1950
 
2007
1951
  Selects a parent genome for breeding based on the selection method.
2008
1952
  Supports multiple selection strategies, including POWER, FITNESS_PROPORTIONATE, and TOURNAMENT.
@@ -2011,13 +1955,13 @@ Returns: The selected parent genome.
2011
1955
 
2012
1956
  #### getParetoArchive
2013
1957
 
2014
- `(maxEntries: number) => import("C:/NeatapticTS/src/neat/neat.types").ParetoArchiveEntry[]`
1958
+ `(maxEntries: number) => import("src/neat/neat.types").ParetoArchiveEntry[]`
2015
1959
 
2016
1960
  Get recent Pareto archive entries (meta information about archived fronts).
2017
1961
 
2018
1962
  #### getParetoFronts
2019
1963
 
2020
- `(maxFronts: number) => import("C:/NeatapticTS/src/architecture/network").default[][]`
1964
+ `(maxFronts: number) => import("src/architecture/network").default[][]`
2021
1965
 
2022
1966
  Reconstruct Pareto fronts for the current population snapshot.
2023
1967
 
@@ -2051,7 +1995,7 @@ Returns: RNG state value when present.
2051
1995
 
2052
1996
  #### getSpeciesHistory
2053
1997
 
2054
- `() => import("C:/NeatapticTS/src/neat/neat.types").SpeciesHistoryEntry[]`
1998
+ `() => import("src/neat/neat.types").SpeciesHistoryEntry[]`
2055
1999
 
2056
2000
  Returns the historical species statistics recorded each generation.
2057
2001
 
@@ -2063,10 +2007,18 @@ Return a concise summary for each current species.
2063
2007
 
2064
2008
  #### getTelemetry
2065
2009
 
2066
- `() => import("C:/NeatapticTS/src/neat/neat.types").TelemetryEntry[]`
2010
+ `() => import("src/neat/neat.types").TelemetryEntry[]`
2067
2011
 
2068
2012
  Return the internal telemetry buffer.
2069
2013
 
2014
+ #### getTopologyIntent
2015
+
2016
+ `() => import("src/architecture/network/network.types").NetworkTopologyIntent`
2017
+
2018
+ Returns the public topology intent for this network.
2019
+
2020
+ Returns: Current topology intent.
2021
+
2070
2022
  #### getTrainingStats
2071
2023
 
2072
2024
  `() => { gradNorm: number; gradNormRaw: number; lossScale: number; optimizerStep: number; mp: { good: number; bad: number; overflowCount: number; scaleUps: number; scaleDowns: number; lastOverflowStep: number; }; }`
@@ -2079,7 +2031,7 @@ Generic gradient accumulator (RMSProp / AdaGrad) (was opt_cache).
2079
2031
 
2080
2032
  #### gru
2081
2033
 
2082
- `(size: number) => import("C:/NeatapticTS/src/architecture/layer").default`
2034
+ `(size: number) => import("src/architecture/layer").default`
2083
2035
 
2084
2036
  Creates a Gated Recurrent Unit (GRU) layer.
2085
2037
 
@@ -2094,15 +2046,12 @@ Returns: A new Layer instance configured as a GRU layer.
2094
2046
 
2095
2047
  #### gru
2096
2048
 
2097
- `(layers: number[]) => import("C:/NeatapticTS/src/architecture/network").default`
2049
+ `(layers: number[]) => import("src/architecture/network").default`
2098
2050
 
2099
2051
  Creates a Gated Recurrent Unit (GRU) network.
2100
2052
  GRUs are another type of recurrent neural network, similar to LSTMs but often simpler.
2101
2053
  This constructor uses `Layer.gru` to create the core GRU blocks.
2102
2054
 
2103
- Parameters:
2104
- - `` - - A sequence of numbers representing the size (number of units) of each layer: input layer size, hidden GRU layer sizes..., output layer size. Must include at least input, one hidden, and output layer sizes.
2105
-
2106
2055
  Returns: The constructed GRU network.
2107
2056
 
2108
2057
  #### hasGater
@@ -2111,15 +2060,12 @@ Whether a gater node is assigned (modulates gain); true if the gater symbol fiel
2111
2060
 
2112
2061
  #### hopfield
2113
2062
 
2114
- `(size: number) => import("C:/NeatapticTS/src/architecture/network").default`
2063
+ `(size: number) => import("src/architecture/network").default`
2115
2064
 
2116
2065
  Creates a Hopfield network.
2117
2066
  Hopfield networks are a form of recurrent neural network often used for associative memory tasks.
2118
2067
  This implementation creates a simple, fully connected structure.
2119
2068
 
2120
- Parameters:
2121
- - `` - - The number of nodes in the network (input and output layers will have this size).
2122
-
2123
2069
  Returns: The constructed Hopfield network.
2124
2070
 
2125
2071
  #### import
@@ -2139,7 +2085,7 @@ Parameters:
2139
2085
 
2140
2086
  #### importState
2141
2087
 
2142
- `(bundle: any, fitness: (n: import("C:/NeatapticTS/src/architecture/network").default) => number) => Promise<import("C:/NeatapticTS/src/neat").default>`
2088
+ `(bundle: any, fitness: (n: import("src/architecture/network").default) => number) => Promise<import("src/neat").default>`
2143
2089
 
2144
2090
  Convenience: restore full evolutionary state previously produced by exportState().
2145
2091
 
@@ -2181,7 +2127,7 @@ Input node count.
2181
2127
 
2182
2128
  #### input
2183
2129
 
2184
- `(from: import("C:/NeatapticTS/src/architecture/group").default | import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerLike, method: unknown, weight: number | undefined) => import("C:/NeatapticTS/src/architecture/connection").default[]`
2130
+ `(from: import("src/architecture/group").default | import("src/architecture/layer/layer.utils.types").LayerLike, method: unknown, weight: number | undefined) => import("src/architecture/connection").default[]`
2185
2131
 
2186
2132
  Handles the connection logic when this layer is the *target* of a connection.
2187
2133
 
@@ -2202,7 +2148,7 @@ Internal flag to detect cycles during activation
2202
2148
 
2203
2149
  #### isConnectedTo
2204
2150
 
2205
- `(target: import("C:/NeatapticTS/src/architecture/node").default) => boolean`
2151
+ `(target: import("src/architecture/node").default) => boolean`
2206
2152
 
2207
2153
  Checks if this node is connected to another node.
2208
2154
 
@@ -2213,7 +2159,7 @@ Returns: True if connected, otherwise false.
2213
2159
 
2214
2160
  #### isProjectedBy
2215
2161
 
2216
- `(node: import("C:/NeatapticTS/src/architecture/node").default) => boolean`
2162
+ `(node: import("src/architecture/node").default) => boolean`
2217
2163
 
2218
2164
  Checks if the given node has a direct outgoing connection to this node.
2219
2165
  Considers both regular incoming connections and the self-connection.
@@ -2225,7 +2171,7 @@ Returns: True if the given node projects to this node, false otherwise.
2225
2171
 
2226
2172
  #### isProjectingTo
2227
2173
 
2228
- `(node: import("C:/NeatapticTS/src/architecture/node").default) => boolean`
2174
+ `(node: import("src/architecture/node").default) => boolean`
2229
2175
 
2230
2176
  Checks if this node has a direct outgoing connection to the given node.
2231
2177
  Considers both regular outgoing connections and the self-connection.
@@ -2241,7 +2187,7 @@ Last skipped stochastic-depth layers from activation runtime state.
2241
2187
 
2242
2188
  #### layerNorm
2243
2189
 
2244
- `(size: number) => import("C:/NeatapticTS/src/architecture/layer").default`
2190
+ `(size: number) => import("src/architecture/layer").default`
2245
2191
 
2246
2192
  Creates a layer normalization layer.
2247
2193
  Applies layer normalization to the activations of the nodes in this layer during activation.
@@ -2261,7 +2207,7 @@ Lookahead: shadow (slow) weight parameter (was _la_shadowWeight).
2261
2207
 
2262
2208
  #### lstm
2263
2209
 
2264
- `(size: number) => import("C:/NeatapticTS/src/architecture/layer").default`
2210
+ `(size: number) => import("src/architecture/layer").default`
2265
2211
 
2266
2212
  Creates a Long Short-Term Memory (LSTM) layer.
2267
2213
 
@@ -2276,18 +2222,12 @@ Returns: A new Layer instance configured as an LSTM layer.
2276
2222
 
2277
2223
  #### lstm
2278
2224
 
2279
- `(layerArgs: (number | { inputToOutput?: boolean | undefined; })[]) => import("C:/NeatapticTS/src/architecture/network").default`
2225
+ `(layerArgs: (number | { inputToOutput?: boolean | undefined; })[]) => import("src/architecture/network").default`
2280
2226
 
2281
2227
  Creates a Long Short-Term Memory (LSTM) network.
2282
2228
  LSTMs are a type of recurrent neural network (RNN) capable of learning long-range dependencies.
2283
2229
  This constructor uses `Layer.lstm` to create the core LSTM blocks.
2284
2230
 
2285
- Parameters:
2286
- - `` - - A sequence of arguments defining the network structure:
2287
- - Numbers represent the size (number of units) of each layer: input layer size, hidden LSTM layer sizes..., output layer size.
2288
- - An optional configuration object can be provided as the last argument.
2289
- - `` - - Configuration options (if passed as the last argument).
2290
-
2291
2231
  Returns: The constructed LSTM network.
2292
2232
 
2293
2233
  #### mask
@@ -2300,7 +2240,7 @@ AMSGrad: Maximum of past second moment (was opt_vhat).
2300
2240
 
2301
2241
  #### memory
2302
2242
 
2303
- `(size: number, memory: number) => import("C:/NeatapticTS/src/architecture/layer").default`
2243
+ `(size: number, memory: number) => import("src/architecture/layer").default`
2304
2244
 
2305
2245
  Creates a Memory layer, designed to hold state over a fixed number of time steps.
2306
2246
 
@@ -2325,7 +2265,7 @@ Slightly increases the chance of ADD_CONN mutation for more connectivity.
2325
2265
 
2326
2266
  #### mutate
2327
2267
 
2328
- `(method: import("C:/NeatapticTS/src/architecture/network/network.types").MutationMethod) => void`
2268
+ `(method: import("src/architecture/network/network.types").MutationMethod) => void`
2329
2269
 
2330
2270
  Mutates the network's structure or parameters according to the specified method.
2331
2271
  This is a core operation for neuro-evolutionary algorithms (like NEAT).
@@ -2349,20 +2289,13 @@ Parameters:
2349
2289
 
2350
2290
  #### narx
2351
2291
 
2352
- `(inputSize: number, hiddenLayers: number | number[], outputSize: number, previousInput: number, previousOutput: number) => import("C:/NeatapticTS/src/architecture/network").default`
2292
+ `(inputSize: number, hiddenLayers: number | number[], outputSize: number, previousInput: number, previousOutput: number) => import("src/architecture/network").default`
2353
2293
 
2354
2294
  Creates a Nonlinear AutoRegressive network with eXogenous inputs (NARX).
2355
2295
  NARX networks are recurrent networks often used for time series prediction.
2356
2296
  They predict the next value of a time series based on previous values of the series
2357
2297
  and previous values of external (exogenous) input series.
2358
2298
 
2359
- Parameters:
2360
- - `` - - The number of input nodes for the exogenous inputs at each time step.
2361
- - `` - - The size of the hidden layer(s). Can be a single number for one hidden layer, or an array of numbers for multiple hidden layers. Use 0 or [] for no hidden layers.
2362
- - `` - - The number of output nodes (predicting the time series).
2363
- - `` - - The number of past time steps of the exogenous input to feed back into the network.
2364
- - `` - - The number of past time steps of the network's own output to feed back into the network (autoregressive part).
2365
-
2366
2299
  Returns: The constructed NARX network.
2367
2300
 
2368
2301
  #### nodes
@@ -2377,10 +2310,6 @@ Activates the network without calculating eligibility traces.
2377
2310
  This is a performance optimization for scenarios where backpropagation is not needed,
2378
2311
  such as during testing, evaluation, or deployment (inference).
2379
2312
 
2380
- Parameters:
2381
- - `` - - An array of numerical values corresponding to the network's input nodes.
2382
- The length must match the network's `input` size.
2383
-
2384
2313
  Returns: An array of numerical values representing the activations of the network's output nodes.
2385
2314
 
2386
2315
  #### noTraceActivate
@@ -2406,14 +2335,15 @@ Output node count.
2406
2335
 
2407
2336
  #### perceptron
2408
2337
 
2409
- `(layers: number[]) => import("C:/NeatapticTS/src/architecture/network").default`
2338
+ `(layers: number[]) => import("src/architecture/network").default`
2410
2339
 
2411
2340
  Creates a standard Multi-Layer Perceptron (MLP) network.
2412
2341
  An MLP consists of an input layer, one or more hidden layers, and an output layer,
2413
2342
  fully connected layer by layer.
2414
2343
 
2415
- Parameters:
2416
- - `` - - A sequence of numbers representing the size (number of nodes) of each layer, starting with the input layer, followed by hidden layers, and ending with the output layer. Must include at least input, one hidden, and output layer sizes.
2344
+ The returned network is marked with the public `feed-forward` topology
2345
+ intent so acyclic enforcement and slab fast-path eligibility stay aligned
2346
+ with the builder users already chose.
2417
2347
 
2418
2348
  Returns: The constructed MLP network.
2419
2349
 
@@ -2444,15 +2374,6 @@ learning rate, momentum, and optional L2 regularization.
2444
2374
 
2445
2375
  The process starts from the output nodes and moves backward layer by layer (or topologically for recurrent nets).
2446
2376
 
2447
- Parameters:
2448
- - `` - - The learning rate (controls the step size of weight adjustments).
2449
- - `` - - The momentum factor (helps overcome local minima and speeds up convergence). Typically between 0 and 1.
2450
- - `` - - If true, apply the calculated weight and bias updates. If false, only calculate gradients (e.g., for batch accumulation).
2451
- - `` - - An array of target values corresponding to the network's output nodes.
2452
- The length must match the network's `output` size.
2453
- - `` - - The L2 regularization factor (lambda). Helps prevent overfitting by penalizing large weights.
2454
- - `` - - Optional derivative of the cost function for output nodes.
2455
-
2456
2377
  #### propagate
2457
2378
 
2458
2379
  `(rate: number, momentum: number, update: boolean, regularization: number | { type: "L1" | "L2"; lambda: number; } | ((weight: number) => number), target: number | undefined) => void`
@@ -2494,7 +2415,6 @@ Parameters:
2494
2415
  - `rate` - - The learning rate, controlling the step size of weight adjustments.
2495
2416
  - `momentum` - - The momentum factor, used to smooth weight updates and escape local minima.
2496
2417
  - `target` - - An optional array of target values (expected outputs) for the layer's nodes. The length must match the number of nodes.
2497
- - `` - - The learning rate to apply during weight updates.
2498
2418
 
2499
2419
  #### pruneToSparsity
2500
2420
 
@@ -2509,7 +2429,7 @@ Parameters:
2509
2429
 
2510
2430
  #### random
2511
2431
 
2512
- `(input: number, hidden: number, output: number, options: { connections?: number | undefined; backconnections?: number | undefined; selfconnections?: number | undefined; gates?: number | undefined; }) => import("C:/NeatapticTS/src/architecture/network").default`
2432
+ `(input: number, hidden: number, output: number, options: { connections?: number | undefined; backconnections?: number | undefined; selfconnections?: number | undefined; gates?: number | undefined; }) => import("src/architecture/network").default`
2513
2433
 
2514
2434
  Creates a randomly structured network based on specified node counts and connection options.
2515
2435
 
@@ -2518,25 +2438,16 @@ It initializes a network with input and output nodes and then iteratively adds h
2518
2438
  and various types of connections (forward, backward, self) and gates using mutation methods.
2519
2439
  This approach is inspired by neuro-evolution techniques where network topology evolves.
2520
2440
 
2521
- Parameters:
2522
- - `` - - The number of input nodes.
2523
- - `` - - The number of hidden nodes to add.
2524
- - `` - - The number of output nodes.
2525
- - `` - - Optional configuration for the network structure.
2526
-
2527
2441
  Returns: The constructed network with a randomized topology.
2528
2442
 
2529
2443
  #### rebuildConnections
2530
2444
 
2531
- `(net: import("C:/NeatapticTS/src/architecture/network").default) => void`
2445
+ `(net: import("src/architecture/network").default) => void`
2532
2446
 
2533
2447
  Rebuilds the network's connections array from all per-node connections.
2534
2448
  This ensures that the network.connections array is consistent with the actual
2535
2449
  outgoing connections of all nodes. Useful after manual wiring or node manipulation.
2536
2450
 
2537
- Parameters:
2538
- - `` - - The network instance to rebuild connections for.
2539
-
2540
2451
  Returns: Example usage:
2541
2452
  Network.rebuildConnections(net);
2542
2453
 
@@ -2559,7 +2470,7 @@ Register a custom objective for multi-objective optimization.
2559
2470
 
2560
2471
  #### release
2561
2472
 
2562
- `(conn: import("C:/NeatapticTS/src/architecture/connection").default) => void`
2473
+ `(conn: import("src/architecture/connection").default) => void`
2563
2474
 
2564
2475
  Return a `Connection` to the internal pool for later reuse. Do NOT use the instance again
2565
2476
  afterward unless re-acquired (treat as surrendered). Optimizer / trace fields are not
@@ -2570,7 +2481,7 @@ Parameters:
2570
2481
 
2571
2482
  #### remove
2572
2483
 
2573
- `(node: import("C:/NeatapticTS/src/architecture/node").default) => void`
2484
+ `(node: import("src/architecture/node").default) => void`
2574
2485
 
2575
2486
  Removes a node from the network.
2576
2487
  This involves:
@@ -2582,9 +2493,6 @@ This involves:
2582
2493
  5. Handling gates involving the removed node (ungating connections gated *by* this node,
2583
2494
  and potentially re-gating connections that were gated *by other nodes* onto the removed node's connections).
2584
2495
 
2585
- Parameters:
2586
- - `` - - The node instance to remove. Must exist within the network's `nodes` list.
2587
-
2588
2496
  #### resetDropoutMasks
2589
2497
 
2590
2498
  `() => void`
@@ -2652,7 +2560,7 @@ Secondary momentum (Lion variant) (was opt_m2).
2652
2560
 
2653
2561
  #### selectMutationMethod
2654
2562
 
2655
- `(genome: import("C:/NeatapticTS/src/architecture/network").default, rawReturnForTest: boolean) => any`
2563
+ `(genome: import("src/architecture/network").default, rawReturnForTest: boolean) => any`
2656
2564
 
2657
2565
  Selects a mutation method for a given genome based on constraints.
2658
2566
 
@@ -2662,7 +2570,7 @@ Self-connection list.
2662
2570
 
2663
2571
  #### serialize
2664
2572
 
2665
- `() => [number[], number[], string[], import("C:/NeatapticTS/src/architecture/network/network.types").SerializedConnection[], number, number]`
2573
+ `() => [number[], number[], string[], import("src/architecture/network/network.types").SerializedConnection[], number, number]`
2666
2574
 
2667
2575
  Lightweight tuple serializer delegating to network.serialize.ts
2668
2576
 
@@ -2673,9 +2581,6 @@ Lightweight tuple serializer delegating to network.serialize.ts
2673
2581
  Sets specified properties (e.g., bias, squash function) for all nodes in the network.
2674
2582
  Useful for initializing or resetting node properties uniformly.
2675
2583
 
2676
- Parameters:
2677
- - `` - - An object containing the properties and values to set.
2678
-
2679
2584
  #### set
2680
2585
 
2681
2586
  `(values: { bias?: number | undefined; squash?: ((x: number, derivate?: boolean | undefined) => number) | undefined; type?: string | undefined; }) => void`
@@ -2689,10 +2594,6 @@ the configuration is applied recursively to the nodes within that group.
2689
2594
  Parameters:
2690
2595
  - `values` - - An object containing the properties and their values to set.
2691
2596
  Example: `{ bias: 0.5, squash: methods.Activation.ReLU }`
2692
- - `` - - An object containing the properties and their new values. Only provided properties are updated.
2693
- `bias`: Sets the bias term for all nodes.
2694
- `squash`: Sets the activation function (squashing function) for all nodes.
2695
- `type`: Sets the node type (e.g., 'input', 'hidden', 'output') for all nodes.
2696
2597
 
2697
2598
  #### setActivation
2698
2599
 
@@ -2757,6 +2658,17 @@ Set stochastic-depth schedule function.
2757
2658
  Parameters:
2758
2659
  - `fn` - Function mapping step and current schedule to next schedule.
2759
2660
 
2661
+ #### setTopologyIntent
2662
+
2663
+ `(topologyIntent: import("src/architecture/network/network.types").NetworkTopologyIntent) => void`
2664
+
2665
+ Sets the public topology intent and keeps acyclic enforcement aligned.
2666
+
2667
+ Parameters:
2668
+ - `topologyIntent` - Desired topology intent.
2669
+
2670
+ Returns: Nothing.
2671
+
2760
2672
  #### setWeightNoiseSchedule
2761
2673
 
2762
2674
  `(fn: (step: number) => number) => void`
@@ -2768,7 +2680,7 @@ Parameters:
2768
2680
 
2769
2681
  #### snapshotRNG
2770
2682
 
2771
- `() => import("C:/NeatapticTS/src/architecture/network/network.types").RNGSnapshot`
2683
+ `() => import("src/architecture/network/network.types").RNGSnapshot`
2772
2684
 
2773
2685
  Snapshot deterministic RNG runtime state.
2774
2686
 
@@ -2789,7 +2701,7 @@ Sorts the population in descending order of fitness scores.
2789
2701
 
2790
2702
  #### spawnFromParent
2791
2703
 
2792
- `(parent: import("C:/NeatapticTS/src/architecture/network").default, mutateCount: number) => import("C:/NeatapticTS/src/architecture/network").default`
2704
+ `(parent: import("src/architecture/network").default, mutateCount: number) => import("src/architecture/network").default`
2793
2705
 
2794
2706
  Spawn a new genome derived from a single parent while preserving Neat bookkeeping.
2795
2707
 
@@ -2819,10 +2731,6 @@ Calculates the average error over the dataset using a specified cost function.
2819
2731
  Uses `noTraceActivate` for efficiency as gradients are not needed.
2820
2732
  Handles dropout scaling if dropout was used during training.
2821
2733
 
2822
- Parameters:
2823
- - `` - - The test dataset, an array of objects with `input` and `output` arrays.
2824
- - `` - - The cost function to evaluate the error. Defaults to Mean Squared Error.
2825
-
2826
2734
  Returns: An object containing the calculated average error over the dataset and the time taken for the test in milliseconds.
2827
2735
 
2828
2736
  #### testForceOverflow
@@ -2881,7 +2789,7 @@ Returns: Object with node indices, weight, gain, gater index (if any), innovatio
2881
2789
 
2882
2790
  #### toONNX
2883
2791
 
2884
- `() => import("C:/NeatapticTS/src/architecture/network/onnx/network.onnx.utils.types").OnnxModel`
2792
+ `() => import("src/architecture/network/onnx/network.onnx.utils.types").OnnxModel`
2885
2793
 
2886
2794
  Exports the network to ONNX format (JSON object, minimal MLP support).
2887
2795
  Only standard feedforward architectures and standard activations are supported.
@@ -2908,18 +2816,15 @@ Determines behavior (e.g., input nodes don't have biases modified typically, out
2908
2816
 
2909
2817
  #### ungate
2910
2818
 
2911
- `(connection: import("C:/NeatapticTS/src/architecture/connection").default) => void`
2819
+ `(connection: import("src/architecture/connection").default) => void`
2912
2820
 
2913
2821
  Removes the gate from a specified connection.
2914
2822
  The connection will no longer be modulated by its gater node.
2915
2823
  Removes the connection from the network's `gates` list.
2916
2824
 
2917
- Parameters:
2918
- - `` - - The connection object to ungate.
2919
-
2920
2825
  #### ungate
2921
2826
 
2922
- `(connections: import("C:/NeatapticTS/src/architecture/connection").default | import("C:/NeatapticTS/src/architecture/connection").default[]) => void`
2827
+ `(connections: import("src/architecture/connection").default | import("src/architecture/connection").default[]) => void`
2923
2828
 
2924
2829
  Removes this node's gating control over the specified connection(s).
2925
2830
  Resets the connection's gain to 1 and removes it from the `connections.gated` list.