@reicek/neataptic-ts 0.1.24 → 0.1.26

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 (215) hide show
  1. package/.github/copilot-instructions.md +11 -0
  2. package/.github/skills/trace-analyzer-extension/SKILL.md +3 -3
  3. package/.github/skills/trace-analyzer-extension/assets/extension-checklist.md +1 -1
  4. package/.github/skills/trace-analyzer-extension/references/analyzer-extension-workflow.md +1 -1
  5. package/.github/skills/trace-audit-reporting/SKILL.md +3 -3
  6. package/.github/skills/trace-audit-reporting/references/trace-analysis-workflow.md +1 -1
  7. package/.github/workflows/ci.yml +3 -3
  8. package/.github/workflows/deploy-pages.yml +6 -6
  9. package/.github/workflows/manual_release_pipeline.yml +3 -3
  10. package/.github/workflows/publish.yml +18 -19
  11. package/.github/workflows/release_dispatch.yml +3 -3
  12. package/package.json +26 -20
  13. package/plans/Flappy_Bird_Folder_Documentation_Pass.md +4 -4
  14. package/plans/README.md +24 -0
  15. package/plans/Roadmap.md +62 -40
  16. package/plans/analyze-trace-solid-split.plans.md +66 -0
  17. package/plans/architecture-solid-split.plans.md +9 -15
  18. package/plans/asciiMaze-typescript-repair.plans.md +1 -1
  19. package/plans/generate-docs-solid-split.plans.md +87 -0
  20. package/plans/methods-docs.plans.md +25 -1
  21. package/plans/methods-solid-split.plans.md +14 -14
  22. package/plans/neat-docs.plans.md +9 -1
  23. package/plans/neat-test-surface-repair.plans.md +1 -1
  24. package/plans/render-docs-html-solid-split.plans.md +68 -0
  25. package/plans/src-no-explicit-any-cleanup.plans.md +1 -1
  26. package/plans/utils-docs.plans.md +6 -1
  27. package/scripts/analyze-trace/analyze-trace.analysis.ts +479 -0
  28. package/scripts/analyze-trace/analyze-trace.constants.ts +35 -0
  29. package/scripts/analyze-trace/analyze-trace.io.ts +69 -0
  30. package/scripts/analyze-trace/analyze-trace.report.ts +100 -0
  31. package/scripts/analyze-trace/analyze-trace.shared.ts +116 -0
  32. package/scripts/analyze-trace/analyze-trace.ts +45 -0
  33. package/scripts/analyze-trace/analyze-trace.types.ts +72 -0
  34. package/scripts/assets/theme.css +80 -23
  35. package/scripts/copy-examples.ts +239 -0
  36. package/scripts/export-onnx.ts +223 -0
  37. package/scripts/generate-bench-tables.ts +378 -37
  38. package/scripts/generate-docs/generate-docs.constants.ts +107 -0
  39. package/scripts/generate-docs/generate-docs.order.ts +355 -0
  40. package/scripts/generate-docs/generate-docs.state.ts +31 -0
  41. package/scripts/generate-docs/generate-docs.targets.ts +165 -0
  42. package/scripts/generate-docs/generate-docs.ts +63 -0
  43. package/scripts/generate-docs/generate-docs.types.ts +112 -0
  44. package/scripts/generate-docs/output/generate-docs.output.folder-index.utils.ts +167 -0
  45. package/scripts/generate-docs/output/generate-docs.output.ordering.utils.ts +353 -0
  46. package/scripts/generate-docs/output/generate-docs.output.readme.utils.ts +420 -0
  47. package/scripts/generate-docs/output/generate-docs.output.ts +123 -0
  48. package/scripts/generate-docs/output/generate-docs.output.warnings.utils.ts +219 -0
  49. package/scripts/generate-docs/symbols/generate-docs.symbols.collection.utils.ts +365 -0
  50. package/scripts/generate-docs/symbols/generate-docs.symbols.jsdoc.utils.ts +373 -0
  51. package/scripts/generate-docs/symbols/generate-docs.symbols.normalize.utils.ts +155 -0
  52. package/scripts/generate-docs/symbols/generate-docs.symbols.render.utils.ts +149 -0
  53. package/scripts/generate-docs/symbols/generate-docs.symbols.signature.utils.ts +289 -0
  54. package/scripts/generate-docs/symbols/generate-docs.symbols.ts +11 -0
  55. package/scripts/mermaid-cli.mjs +102 -22
  56. package/scripts/mermaid-cli.ts +736 -0
  57. package/scripts/render-docs-html/render-docs-html.assets.ts +54 -0
  58. package/scripts/render-docs-html/render-docs-html.mermaid.ts +245 -0
  59. package/scripts/{render-docs-html.sidebar.ts → render-docs-html/render-docs-html.navigation.ts} +141 -144
  60. package/scripts/render-docs-html/render-docs-html.pages.ts +333 -0
  61. package/scripts/render-docs-html/render-docs-html.shared.ts +333 -0
  62. package/scripts/render-docs-html/render-docs-html.types.ts +42 -0
  63. package/scripts/render-docs-html.ts +23 -587
  64. package/scripts/run-docs.ts +238 -0
  65. package/scripts/write-dist-docs-pkg.ts +40 -0
  66. package/src/README.md +75 -75
  67. package/src/architecture/connection/README.md +5 -5
  68. package/src/architecture/layer/README.md +508 -508
  69. package/src/architecture/network/README.md +1458 -1458
  70. package/src/architecture/network/activate/README.md +694 -694
  71. package/src/architecture/network/bootstrap/README.md +77 -77
  72. package/src/architecture/network/connect/README.md +74 -74
  73. package/src/architecture/network/deterministic/README.md +135 -135
  74. package/src/architecture/network/evolve/README.md +364 -364
  75. package/src/architecture/network/gating/README.md +130 -130
  76. package/src/architecture/network/genetic/README.md +399 -399
  77. package/src/architecture/network/mutate/README.md +897 -897
  78. package/src/architecture/network/onnx/README.md +720 -720
  79. package/src/architecture/network/onnx/export/README.md +728 -728
  80. package/src/architecture/network/onnx/export/layers/README.md +450 -450
  81. package/src/architecture/network/onnx/import/README.md +618 -618
  82. package/src/architecture/network/onnx/schema/README.md +32 -32
  83. package/src/architecture/network/prune/README.md +245 -245
  84. package/src/architecture/network/remove/README.md +135 -135
  85. package/src/architecture/network/runtime/README.md +106 -106
  86. package/src/architecture/network/serialize/README.md +542 -542
  87. package/src/architecture/network/slab/README.md +608 -608
  88. package/src/architecture/network/standalone/README.md +212 -212
  89. package/src/architecture/network/stats/README.md +84 -84
  90. package/src/architecture/network/topology/README.md +465 -465
  91. package/src/architecture/network/training/README.md +200 -200
  92. package/src/architecture/node/README.md +5 -5
  93. package/src/architecture/nodePool/README.md +14 -14
  94. package/src/methods/README.md +99 -99
  95. package/src/methods/activation/README.md +189 -189
  96. package/src/methods/cost/README.md +131 -131
  97. package/src/methods/rate/README.md +86 -86
  98. package/src/multithreading/README.md +77 -77
  99. package/src/multithreading/workers/browser/README.md +8 -8
  100. package/src/multithreading/workers/node/README.md +8 -8
  101. package/src/neat/README.md +148 -148
  102. package/src/neat/adaptive/README.md +120 -120
  103. package/src/neat/adaptive/acceptance/README.md +40 -40
  104. package/src/neat/adaptive/complexity/README.md +137 -137
  105. package/src/neat/adaptive/core/README.md +197 -197
  106. package/src/neat/adaptive/lineage/README.md +90 -90
  107. package/src/neat/adaptive/mutation/README.md +284 -284
  108. package/src/neat/compat/README.md +43 -43
  109. package/src/neat/compat/core/README.md +90 -90
  110. package/src/neat/diversity/README.md +35 -35
  111. package/src/neat/diversity/core/README.md +88 -88
  112. package/src/neat/evaluate/README.md +85 -85
  113. package/src/neat/evaluate/auto-distance/README.md +75 -75
  114. package/src/neat/evaluate/entropy-compat/README.md +37 -37
  115. package/src/neat/evaluate/entropy-sharing/README.md +43 -43
  116. package/src/neat/evaluate/fitness/README.md +23 -23
  117. package/src/neat/evaluate/novelty/README.md +120 -120
  118. package/src/neat/evaluate/objectives/README.md +17 -17
  119. package/src/neat/evaluate/shared/README.md +94 -94
  120. package/src/neat/evolve/README.md +96 -96
  121. package/src/neat/evolve/adaptive/README.md +60 -60
  122. package/src/neat/evolve/objectives/README.md +63 -63
  123. package/src/neat/evolve/offspring/README.md +56 -56
  124. package/src/neat/evolve/population/README.md +171 -171
  125. package/src/neat/evolve/runtime/README.md +79 -79
  126. package/src/neat/evolve/speciation/README.md +74 -74
  127. package/src/neat/evolve/warnings/README.md +10 -10
  128. package/src/neat/export/README.md +114 -114
  129. package/src/neat/helpers/README.md +50 -50
  130. package/src/neat/init/README.md +9 -9
  131. package/src/neat/lineage/core/README.md +101 -101
  132. package/src/neat/multiobjective/category/README.md +74 -74
  133. package/src/neat/multiobjective/crowding/README.md +272 -272
  134. package/src/neat/multiobjective/dominance/README.md +171 -171
  135. package/src/neat/multiobjective/fronts/README.md +68 -68
  136. package/src/neat/multiobjective/metrics/README.md +43 -43
  137. package/src/neat/multiobjective/objectives/README.md +31 -31
  138. package/src/neat/multiobjective/shared/README.md +27 -27
  139. package/src/neat/mutation/README.md +97 -97
  140. package/src/neat/mutation/add-conn/README.md +115 -115
  141. package/src/neat/mutation/add-node/README.md +126 -126
  142. package/src/neat/mutation/flow/README.md +149 -149
  143. package/src/neat/mutation/repair/README.md +185 -185
  144. package/src/neat/mutation/select/README.md +117 -117
  145. package/src/neat/mutation/shared/README.md +32 -32
  146. package/src/neat/objectives/README.md +25 -25
  147. package/src/neat/objectives/core/README.md +67 -67
  148. package/src/neat/pruning/README.md +40 -40
  149. package/src/neat/pruning/core/README.md +171 -171
  150. package/src/neat/pruning/facade/README.md +32 -32
  151. package/src/neat/rng/README.md +104 -104
  152. package/src/neat/rng/core/README.md +137 -137
  153. package/src/neat/rng/facade/README.md +50 -50
  154. package/src/neat/selection/README.md +111 -111
  155. package/src/neat/selection/core/README.md +227 -227
  156. package/src/neat/selection/facade/README.md +61 -61
  157. package/src/neat/shared/README.md +163 -163
  158. package/src/neat/speciation/README.md +31 -31
  159. package/src/neat/speciation/threshold/README.md +35 -35
  160. package/src/neat/species/README.md +25 -25
  161. package/src/neat/species/core/README.md +20 -20
  162. package/src/neat/species/core/shared/README.md +18 -18
  163. package/src/neat/species/history/context/README.md +22 -22
  164. package/src/neat/telemetry/accessors/README.md +58 -58
  165. package/src/neat/telemetry/exports/README.md +233 -233
  166. package/src/neat/telemetry/facade/README.md +252 -252
  167. package/src/neat/telemetry/facade/archive/README.md +57 -57
  168. package/src/neat/telemetry/facade/buffer/README.md +43 -43
  169. package/src/neat/telemetry/facade/lineage/README.md +12 -12
  170. package/src/neat/telemetry/facade/objectives/README.md +44 -44
  171. package/src/neat/telemetry/facade/runtime/README.md +26 -26
  172. package/src/neat/telemetry/facade/species/README.md +27 -27
  173. package/src/neat/telemetry/metrics/README.md +696 -696
  174. package/src/neat/telemetry/recorder/README.md +57 -57
  175. package/src/neat/telemetry/types/README.md +32 -32
  176. package/src/neat/topology-intent/README.md +75 -75
  177. package/src/utils/README.md +193 -193
  178. package/test/examples/asciiMaze/browser-entry/README.md +92 -92
  179. package/test/examples/asciiMaze/dashboardManager/README.md +109 -109
  180. package/test/examples/asciiMaze/dashboardManager/telemetry/README.md +28 -28
  181. package/test/examples/asciiMaze/evolutionEngine/README.md +1527 -1527
  182. package/test/examples/asciiMaze/mazeMovement/README.md +105 -105
  183. package/test/examples/asciiMaze/mazeMovement/finalization/README.md +16 -16
  184. package/test/examples/asciiMaze/mazeMovement/policy/README.md +57 -57
  185. package/test/examples/asciiMaze/mazeMovement/runtime/README.md +52 -52
  186. package/test/examples/asciiMaze/mazeMovement/shaping/README.md +46 -46
  187. package/test/examples/flappy_bird/browser-entry/README.md +508 -508
  188. package/test/examples/flappy_bird/browser-entry/host/README.md +101 -101
  189. package/test/examples/flappy_bird/browser-entry/host/resize/README.md +144 -144
  190. package/test/examples/flappy_bird/browser-entry/network-view/README.md +194 -194
  191. package/test/examples/flappy_bird/browser-entry/playback/README.md +278 -278
  192. package/test/examples/flappy_bird/browser-entry/playback/background/README.md +129 -129
  193. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/README.md +502 -502
  194. package/test/examples/flappy_bird/browser-entry/playback/frame-render/README.md +139 -139
  195. package/test/examples/flappy_bird/browser-entry/playback/snapshot/README.md +10 -10
  196. package/test/examples/flappy_bird/browser-entry/playback/trail/README.md +43 -43
  197. package/test/examples/flappy_bird/browser-entry/playback/worker-channel/README.md +30 -30
  198. package/test/examples/flappy_bird/browser-entry/runtime/README.md +59 -59
  199. package/test/examples/flappy_bird/browser-entry/visualization/README.md +276 -276
  200. package/test/examples/flappy_bird/browser-entry/worker-channel/README.md +16 -16
  201. package/test/examples/flappy_bird/constants/README.md +1070 -1070
  202. package/test/examples/flappy_bird/environment/README.md +22 -22
  203. package/test/examples/flappy_bird/evaluation/README.md +32 -32
  204. package/test/examples/flappy_bird/evaluation/rollout/README.md +141 -141
  205. package/test/examples/flappy_bird/flappy-evolution-worker/README.md +425 -425
  206. package/test/examples/flappy_bird/simulation-shared/README.md +170 -170
  207. package/test/examples/flappy_bird/simulation-shared/observation/README.md +109 -109
  208. package/test/examples/flappy_bird/trainer/README.md +325 -325
  209. package/test/examples/flappy_bird/trainer/evaluation/README.md +74 -74
  210. package/scripts/analyze-trace.ts +0 -590
  211. package/scripts/copy-examples.mjs +0 -114
  212. package/scripts/export-onnx.mjs +0 -86
  213. package/scripts/generate-bench-tables.mjs +0 -182
  214. package/scripts/generate-docs.ts +0 -2900
  215. package/scripts/write-dist-docs-pkg.mjs +0 -16
@@ -53,96 +53,90 @@ Returns: Mean error and evaluation duration.
53
53
 
54
54
  ## architecture/network/stats/network.stats.test.utils.ts
55
55
 
56
- ### testNetwork
56
+ ### createTestResult
57
57
 
58
58
  ```ts
59
- testNetwork(
60
- set: TestSample[],
61
- cost: CostFunction | undefined,
59
+ createTestResult(
60
+ cumulativeError: number,
61
+ sampleCount: number,
62
+ startTime: number,
62
63
  ): TestNetworkResult
63
64
  ```
64
65
 
65
- Evaluate a dataset and return average error and elapsed time.
66
+ Build the final test result payload.
66
67
 
67
68
  Parameters:
68
- - `this` - Bound network instance.
69
- - `set` - Evaluation samples.
70
- - `cost` - Optional cost function override.
69
+ - `cumulativeError` - Cumulative sample error.
70
+ - `sampleCount` - Number of evaluated samples.
71
+ - `startTime` - Evaluation start timestamp.
71
72
 
72
- Returns: Mean error and evaluation duration.
73
+ Returns: Mean error and elapsed duration.
73
74
 
74
- ### validateTestSet
75
+ ### disableDropoutForTesting
75
76
 
76
77
  ```ts
77
- validateTestSet(
78
+ disableDropoutForTesting(
78
79
  network: default,
79
- testSet: TestSample[],
80
- ): void
80
+ ): number
81
81
  ```
82
82
 
83
- Validate that the evaluation set exists and each sample matches network dimensions.
83
+ Disable dropout while preserving previous runtime dropout value.
84
84
 
85
85
  Parameters:
86
86
  - `network` - Bound network instance.
87
- - `testSet` - Evaluation sample set.
88
87
 
89
- ### validateTestSetPresence
90
-
91
- ```ts
92
- validateTestSetPresence(
93
- testSet: TestSample[],
94
- ): void
95
- ```
96
-
97
- Validate that the test set is a non-empty array.
98
-
99
- Parameters:
100
- - `testSet` - Evaluation sample set.
88
+ Returns: Previous dropout value.
101
89
 
102
- ### validateAllSampleDimensions
90
+ ### evaluateSamples
103
91
 
104
92
  ```ts
105
- validateAllSampleDimensions(
93
+ evaluateSamples(
106
94
  network: default,
107
95
  testSet: TestSample[],
108
- ): void
96
+ costFunction: CostFunction,
97
+ ): number
109
98
  ```
110
99
 
111
- Validate input and output dimensions for every sample.
100
+ Evaluate all test samples and accumulate total cost.
112
101
 
113
102
  Parameters:
114
103
  - `network` - Bound network instance.
115
104
  - `testSet` - Evaluation sample set.
105
+ - `costFunction` - Cost function used for scoring.
116
106
 
117
- ### validateSampleInputDimensions
107
+ Returns: Cumulative error across all samples.
108
+
109
+ ### evaluateSingleSample
118
110
 
119
111
  ```ts
120
- validateSampleInputDimensions(
112
+ evaluateSingleSample(
121
113
  network: default,
122
114
  sample: TestSample,
123
- ): void
115
+ costFunction: CostFunction,
116
+ ): number
124
117
  ```
125
118
 
126
- Validate one sample input vector size.
119
+ Evaluate a single sample and return its cost.
127
120
 
128
121
  Parameters:
129
122
  - `network` - Bound network instance.
130
123
  - `sample` - Evaluation sample.
124
+ - `costFunction` - Cost function used for scoring.
131
125
 
132
- ### validateSampleOutputDimensions
126
+ Returns: Error for the sample.
127
+
128
+ ### resetHiddenMasks
133
129
 
134
130
  ```ts
135
- validateSampleOutputDimensions(
131
+ resetHiddenMasks(
136
132
  network: default,
137
- sample: TestSample,
138
133
  ): void
139
134
  ```
140
135
 
141
- Validate one sample output vector size.
136
+ Force hidden-node masks to active state for deterministic testing.
142
137
 
143
138
  Parameters:
144
139
  - `network` - Bound network instance.
145
- - `sample` - Evaluation sample.
146
140
 
147
141
  ### resolveCostFunction
148
142
 
@@ -159,102 +153,108 @@ Parameters:
159
153
 
160
154
  Returns: Cost function used for test evaluation.
161
155
 
162
- ### resetHiddenMasks
156
+ ### restoreDropout
163
157
 
164
158
  ```ts
165
- resetHiddenMasks(
159
+ restoreDropout(
166
160
  network: default,
161
+ previousDropout: number,
167
162
  ): void
168
163
  ```
169
164
 
170
- Force hidden-node masks to active state for deterministic testing.
165
+ Restore dropout value after test evaluation.
171
166
 
172
167
  Parameters:
173
168
  - `network` - Bound network instance.
169
+ - `previousDropout` - Dropout value to restore.
174
170
 
175
- ### disableDropoutForTesting
171
+ ### testNetwork
176
172
 
177
173
  ```ts
178
- disableDropoutForTesting(
179
- network: default,
180
- ): number
174
+ testNetwork(
175
+ set: TestSample[],
176
+ cost: CostFunction | undefined,
177
+ ): TestNetworkResult
181
178
  ```
182
179
 
183
- Disable dropout while preserving previous runtime dropout value.
180
+ Evaluate a dataset and return average error and elapsed time.
184
181
 
185
182
  Parameters:
186
- - `network` - Bound network instance.
183
+ - `this` - Bound network instance.
184
+ - `set` - Evaluation samples.
185
+ - `cost` - Optional cost function override.
187
186
 
188
- Returns: Previous dropout value.
187
+ Returns: Mean error and evaluation duration.
189
188
 
190
- ### restoreDropout
189
+ ### validateAllSampleDimensions
191
190
 
192
191
  ```ts
193
- restoreDropout(
192
+ validateAllSampleDimensions(
194
193
  network: default,
195
- previousDropout: number,
194
+ testSet: TestSample[],
196
195
  ): void
197
196
  ```
198
197
 
199
- Restore dropout value after test evaluation.
198
+ Validate input and output dimensions for every sample.
200
199
 
201
200
  Parameters:
202
201
  - `network` - Bound network instance.
203
- - `previousDropout` - Dropout value to restore.
202
+ - `testSet` - Evaluation sample set.
204
203
 
205
- ### evaluateSamples
204
+ ### validateSampleInputDimensions
206
205
 
207
206
  ```ts
208
- evaluateSamples(
207
+ validateSampleInputDimensions(
209
208
  network: default,
210
- testSet: TestSample[],
211
- costFunction: CostFunction,
212
- ): number
209
+ sample: TestSample,
210
+ ): void
213
211
  ```
214
212
 
215
- Evaluate all test samples and accumulate total cost.
213
+ Validate one sample input vector size.
216
214
 
217
215
  Parameters:
218
216
  - `network` - Bound network instance.
219
- - `testSet` - Evaluation sample set.
220
- - `costFunction` - Cost function used for scoring.
221
-
222
- Returns: Cumulative error across all samples.
217
+ - `sample` - Evaluation sample.
223
218
 
224
- ### evaluateSingleSample
219
+ ### validateSampleOutputDimensions
225
220
 
226
221
  ```ts
227
- evaluateSingleSample(
222
+ validateSampleOutputDimensions(
228
223
  network: default,
229
224
  sample: TestSample,
230
- costFunction: CostFunction,
231
- ): number
225
+ ): void
232
226
  ```
233
227
 
234
- Evaluate a single sample and return its cost.
228
+ Validate one sample output vector size.
235
229
 
236
230
  Parameters:
237
231
  - `network` - Bound network instance.
238
232
  - `sample` - Evaluation sample.
239
- - `costFunction` - Cost function used for scoring.
240
-
241
- Returns: Error for the sample.
242
233
 
243
- ### createTestResult
234
+ ### validateTestSet
244
235
 
245
236
  ```ts
246
- createTestResult(
247
- cumulativeError: number,
248
- sampleCount: number,
249
- startTime: number,
250
- ): TestNetworkResult
237
+ validateTestSet(
238
+ network: default,
239
+ testSet: TestSample[],
240
+ ): void
251
241
  ```
252
242
 
253
- Build the final test result payload.
243
+ Validate that the evaluation set exists and each sample matches network dimensions.
254
244
 
255
245
  Parameters:
256
- - `cumulativeError` - Cumulative sample error.
257
- - `sampleCount` - Number of evaluated samples.
258
- - `startTime` - Evaluation start timestamp.
246
+ - `network` - Bound network instance.
247
+ - `testSet` - Evaluation sample set.
259
248
 
260
- Returns: Mean error and elapsed duration.
249
+ ### validateTestSetPresence
250
+
251
+ ```ts
252
+ validateTestSetPresence(
253
+ testSet: TestSample[],
254
+ ): void
255
+ ```
256
+
257
+ Validate that the test set is a non-empty array.
258
+
259
+ Parameters:
260
+ - `testSet` - Evaluation sample set.