@reicek/neataptic-ts 0.1.25 → 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 (210) 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/package.json +19 -13
  8. package/plans/Flappy_Bird_Folder_Documentation_Pass.md +4 -4
  9. package/plans/README.md +24 -0
  10. package/plans/Roadmap.md +62 -40
  11. package/plans/analyze-trace-solid-split.plans.md +66 -0
  12. package/plans/architecture-solid-split.plans.md +9 -15
  13. package/plans/asciiMaze-typescript-repair.plans.md +1 -1
  14. package/plans/generate-docs-solid-split.plans.md +87 -0
  15. package/plans/methods-docs.plans.md +25 -1
  16. package/plans/methods-solid-split.plans.md +14 -14
  17. package/plans/neat-docs.plans.md +9 -1
  18. package/plans/neat-test-surface-repair.plans.md +1 -1
  19. package/plans/render-docs-html-solid-split.plans.md +68 -0
  20. package/plans/src-no-explicit-any-cleanup.plans.md +1 -1
  21. package/plans/utils-docs.plans.md +6 -1
  22. package/scripts/analyze-trace/analyze-trace.analysis.ts +479 -0
  23. package/scripts/analyze-trace/analyze-trace.constants.ts +35 -0
  24. package/scripts/analyze-trace/analyze-trace.io.ts +69 -0
  25. package/scripts/analyze-trace/analyze-trace.report.ts +100 -0
  26. package/scripts/analyze-trace/analyze-trace.shared.ts +116 -0
  27. package/scripts/analyze-trace/analyze-trace.ts +45 -0
  28. package/scripts/analyze-trace/analyze-trace.types.ts +72 -0
  29. package/scripts/assets/theme.css +80 -23
  30. package/scripts/copy-examples.ts +239 -0
  31. package/scripts/export-onnx.ts +223 -0
  32. package/scripts/generate-bench-tables.ts +378 -37
  33. package/scripts/generate-docs/generate-docs.constants.ts +107 -0
  34. package/scripts/generate-docs/generate-docs.order.ts +355 -0
  35. package/scripts/generate-docs/generate-docs.state.ts +31 -0
  36. package/scripts/generate-docs/generate-docs.targets.ts +165 -0
  37. package/scripts/generate-docs/generate-docs.ts +63 -0
  38. package/scripts/generate-docs/generate-docs.types.ts +112 -0
  39. package/scripts/generate-docs/output/generate-docs.output.folder-index.utils.ts +167 -0
  40. package/scripts/generate-docs/output/generate-docs.output.ordering.utils.ts +353 -0
  41. package/scripts/generate-docs/output/generate-docs.output.readme.utils.ts +420 -0
  42. package/scripts/generate-docs/output/generate-docs.output.ts +123 -0
  43. package/scripts/generate-docs/output/generate-docs.output.warnings.utils.ts +219 -0
  44. package/scripts/generate-docs/symbols/generate-docs.symbols.collection.utils.ts +365 -0
  45. package/scripts/generate-docs/symbols/generate-docs.symbols.jsdoc.utils.ts +373 -0
  46. package/scripts/generate-docs/symbols/generate-docs.symbols.normalize.utils.ts +155 -0
  47. package/scripts/generate-docs/symbols/generate-docs.symbols.render.utils.ts +149 -0
  48. package/scripts/generate-docs/symbols/generate-docs.symbols.signature.utils.ts +289 -0
  49. package/scripts/generate-docs/symbols/generate-docs.symbols.ts +11 -0
  50. package/scripts/mermaid-cli.mjs +102 -22
  51. package/scripts/mermaid-cli.ts +736 -0
  52. package/scripts/render-docs-html/render-docs-html.assets.ts +54 -0
  53. package/scripts/render-docs-html/render-docs-html.mermaid.ts +245 -0
  54. package/scripts/{render-docs-html.sidebar.ts → render-docs-html/render-docs-html.navigation.ts} +141 -144
  55. package/scripts/render-docs-html/render-docs-html.pages.ts +333 -0
  56. package/scripts/render-docs-html/render-docs-html.shared.ts +333 -0
  57. package/scripts/render-docs-html/render-docs-html.types.ts +42 -0
  58. package/scripts/render-docs-html.ts +23 -587
  59. package/scripts/run-docs.ts +238 -0
  60. package/scripts/write-dist-docs-pkg.ts +40 -0
  61. package/src/README.md +75 -75
  62. package/src/architecture/connection/README.md +5 -5
  63. package/src/architecture/layer/README.md +508 -508
  64. package/src/architecture/network/README.md +1458 -1458
  65. package/src/architecture/network/activate/README.md +694 -694
  66. package/src/architecture/network/bootstrap/README.md +77 -77
  67. package/src/architecture/network/connect/README.md +74 -74
  68. package/src/architecture/network/deterministic/README.md +135 -135
  69. package/src/architecture/network/evolve/README.md +364 -364
  70. package/src/architecture/network/gating/README.md +130 -130
  71. package/src/architecture/network/genetic/README.md +399 -399
  72. package/src/architecture/network/mutate/README.md +897 -897
  73. package/src/architecture/network/onnx/README.md +720 -720
  74. package/src/architecture/network/onnx/export/README.md +728 -728
  75. package/src/architecture/network/onnx/export/layers/README.md +450 -450
  76. package/src/architecture/network/onnx/import/README.md +618 -618
  77. package/src/architecture/network/onnx/schema/README.md +32 -32
  78. package/src/architecture/network/prune/README.md +245 -245
  79. package/src/architecture/network/remove/README.md +135 -135
  80. package/src/architecture/network/runtime/README.md +106 -106
  81. package/src/architecture/network/serialize/README.md +542 -542
  82. package/src/architecture/network/slab/README.md +608 -608
  83. package/src/architecture/network/standalone/README.md +212 -212
  84. package/src/architecture/network/stats/README.md +84 -84
  85. package/src/architecture/network/topology/README.md +465 -465
  86. package/src/architecture/network/training/README.md +200 -200
  87. package/src/architecture/node/README.md +5 -5
  88. package/src/architecture/nodePool/README.md +14 -14
  89. package/src/methods/README.md +99 -99
  90. package/src/methods/activation/README.md +189 -189
  91. package/src/methods/cost/README.md +131 -131
  92. package/src/methods/rate/README.md +86 -86
  93. package/src/multithreading/README.md +77 -77
  94. package/src/multithreading/workers/browser/README.md +8 -8
  95. package/src/multithreading/workers/node/README.md +8 -8
  96. package/src/neat/README.md +148 -148
  97. package/src/neat/adaptive/README.md +120 -120
  98. package/src/neat/adaptive/acceptance/README.md +40 -40
  99. package/src/neat/adaptive/complexity/README.md +137 -137
  100. package/src/neat/adaptive/core/README.md +197 -197
  101. package/src/neat/adaptive/lineage/README.md +90 -90
  102. package/src/neat/adaptive/mutation/README.md +284 -284
  103. package/src/neat/compat/README.md +43 -43
  104. package/src/neat/compat/core/README.md +90 -90
  105. package/src/neat/diversity/README.md +35 -35
  106. package/src/neat/diversity/core/README.md +88 -88
  107. package/src/neat/evaluate/README.md +85 -85
  108. package/src/neat/evaluate/auto-distance/README.md +75 -75
  109. package/src/neat/evaluate/entropy-compat/README.md +37 -37
  110. package/src/neat/evaluate/entropy-sharing/README.md +43 -43
  111. package/src/neat/evaluate/fitness/README.md +23 -23
  112. package/src/neat/evaluate/novelty/README.md +120 -120
  113. package/src/neat/evaluate/objectives/README.md +17 -17
  114. package/src/neat/evaluate/shared/README.md +94 -94
  115. package/src/neat/evolve/README.md +96 -96
  116. package/src/neat/evolve/adaptive/README.md +60 -60
  117. package/src/neat/evolve/objectives/README.md +63 -63
  118. package/src/neat/evolve/offspring/README.md +56 -56
  119. package/src/neat/evolve/population/README.md +171 -171
  120. package/src/neat/evolve/runtime/README.md +79 -79
  121. package/src/neat/evolve/speciation/README.md +74 -74
  122. package/src/neat/evolve/warnings/README.md +10 -10
  123. package/src/neat/export/README.md +114 -114
  124. package/src/neat/helpers/README.md +50 -50
  125. package/src/neat/init/README.md +9 -9
  126. package/src/neat/lineage/core/README.md +101 -101
  127. package/src/neat/multiobjective/category/README.md +74 -74
  128. package/src/neat/multiobjective/crowding/README.md +272 -272
  129. package/src/neat/multiobjective/dominance/README.md +171 -171
  130. package/src/neat/multiobjective/fronts/README.md +68 -68
  131. package/src/neat/multiobjective/metrics/README.md +43 -43
  132. package/src/neat/multiobjective/objectives/README.md +31 -31
  133. package/src/neat/multiobjective/shared/README.md +27 -27
  134. package/src/neat/mutation/README.md +97 -97
  135. package/src/neat/mutation/add-conn/README.md +115 -115
  136. package/src/neat/mutation/add-node/README.md +126 -126
  137. package/src/neat/mutation/flow/README.md +149 -149
  138. package/src/neat/mutation/repair/README.md +185 -185
  139. package/src/neat/mutation/select/README.md +117 -117
  140. package/src/neat/mutation/shared/README.md +32 -32
  141. package/src/neat/objectives/README.md +25 -25
  142. package/src/neat/objectives/core/README.md +67 -67
  143. package/src/neat/pruning/README.md +40 -40
  144. package/src/neat/pruning/core/README.md +171 -171
  145. package/src/neat/pruning/facade/README.md +32 -32
  146. package/src/neat/rng/README.md +104 -104
  147. package/src/neat/rng/core/README.md +137 -137
  148. package/src/neat/rng/facade/README.md +50 -50
  149. package/src/neat/selection/README.md +111 -111
  150. package/src/neat/selection/core/README.md +227 -227
  151. package/src/neat/selection/facade/README.md +61 -61
  152. package/src/neat/shared/README.md +163 -163
  153. package/src/neat/speciation/README.md +31 -31
  154. package/src/neat/speciation/threshold/README.md +35 -35
  155. package/src/neat/species/README.md +25 -25
  156. package/src/neat/species/core/README.md +20 -20
  157. package/src/neat/species/core/shared/README.md +18 -18
  158. package/src/neat/species/history/context/README.md +22 -22
  159. package/src/neat/telemetry/accessors/README.md +58 -58
  160. package/src/neat/telemetry/exports/README.md +233 -233
  161. package/src/neat/telemetry/facade/README.md +252 -252
  162. package/src/neat/telemetry/facade/archive/README.md +57 -57
  163. package/src/neat/telemetry/facade/buffer/README.md +43 -43
  164. package/src/neat/telemetry/facade/lineage/README.md +12 -12
  165. package/src/neat/telemetry/facade/objectives/README.md +44 -44
  166. package/src/neat/telemetry/facade/runtime/README.md +26 -26
  167. package/src/neat/telemetry/facade/species/README.md +27 -27
  168. package/src/neat/telemetry/metrics/README.md +696 -696
  169. package/src/neat/telemetry/recorder/README.md +57 -57
  170. package/src/neat/telemetry/types/README.md +32 -32
  171. package/src/neat/topology-intent/README.md +75 -75
  172. package/src/utils/README.md +193 -193
  173. package/test/examples/asciiMaze/browser-entry/README.md +92 -92
  174. package/test/examples/asciiMaze/dashboardManager/README.md +109 -109
  175. package/test/examples/asciiMaze/dashboardManager/telemetry/README.md +28 -28
  176. package/test/examples/asciiMaze/evolutionEngine/README.md +1527 -1527
  177. package/test/examples/asciiMaze/mazeMovement/README.md +105 -105
  178. package/test/examples/asciiMaze/mazeMovement/finalization/README.md +16 -16
  179. package/test/examples/asciiMaze/mazeMovement/policy/README.md +57 -57
  180. package/test/examples/asciiMaze/mazeMovement/runtime/README.md +52 -52
  181. package/test/examples/asciiMaze/mazeMovement/shaping/README.md +46 -46
  182. package/test/examples/flappy_bird/browser-entry/README.md +508 -508
  183. package/test/examples/flappy_bird/browser-entry/host/README.md +101 -101
  184. package/test/examples/flappy_bird/browser-entry/host/resize/README.md +144 -144
  185. package/test/examples/flappy_bird/browser-entry/network-view/README.md +194 -194
  186. package/test/examples/flappy_bird/browser-entry/playback/README.md +278 -278
  187. package/test/examples/flappy_bird/browser-entry/playback/background/README.md +129 -129
  188. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/README.md +502 -502
  189. package/test/examples/flappy_bird/browser-entry/playback/frame-render/README.md +139 -139
  190. package/test/examples/flappy_bird/browser-entry/playback/snapshot/README.md +10 -10
  191. package/test/examples/flappy_bird/browser-entry/playback/trail/README.md +43 -43
  192. package/test/examples/flappy_bird/browser-entry/playback/worker-channel/README.md +30 -30
  193. package/test/examples/flappy_bird/browser-entry/runtime/README.md +59 -59
  194. package/test/examples/flappy_bird/browser-entry/visualization/README.md +276 -276
  195. package/test/examples/flappy_bird/browser-entry/worker-channel/README.md +16 -16
  196. package/test/examples/flappy_bird/constants/README.md +1070 -1070
  197. package/test/examples/flappy_bird/environment/README.md +22 -22
  198. package/test/examples/flappy_bird/evaluation/README.md +32 -32
  199. package/test/examples/flappy_bird/evaluation/rollout/README.md +141 -141
  200. package/test/examples/flappy_bird/flappy-evolution-worker/README.md +425 -425
  201. package/test/examples/flappy_bird/simulation-shared/README.md +170 -170
  202. package/test/examples/flappy_bird/simulation-shared/observation/README.md +109 -109
  203. package/test/examples/flappy_bird/trainer/README.md +325 -325
  204. package/test/examples/flappy_bird/trainer/evaluation/README.md +74 -74
  205. package/scripts/analyze-trace.ts +0 -590
  206. package/scripts/copy-examples.mjs +0 -114
  207. package/scripts/export-onnx.mjs +0 -86
  208. package/scripts/generate-bench-tables.mjs +0 -182
  209. package/scripts/generate-docs.ts +0 -2900
  210. 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.