@reicek/neataptic-ts 0.1.25 → 0.1.26

package/src/architecture/network/genetic/README.md

@@ -4,26 +4,26 @@ Canonical threshold used for random binary parent/gene choice.
 
 ## architecture/network/genetic/network.genetic.utils.types.ts
 
-### RANDOM_BINARY_SELECTION_THRESHOLD
-
-Canonical threshold used for random binary parent/gene choice.
-
 ### DEFAULT_REENABLE_PROBABILITY
 
 Default probability for re-enabling disabled genes during crossover.
 
-### NO_GATER_INDEX
-
-Sentinel index representing that no gater node is assigned.
-
 ### FIRST_INDEX
 
 First element index used when reading newly created connections.
 
+### NO_GATER_INDEX
+
+Sentinel index representing that no gater node is assigned.
+
 ### PARENT_COMPATIBILITY_ERROR_MESSAGE
 
 Shared compatibility error message for crossover parent validation.
 
+### RANDOM_BINARY_SELECTION_THRESHOLD
+
+Canonical threshold used for random binary parent/gene choice.
+
 ### RandomGenerator
 
 ```ts
@@ -116,39 +116,35 @@ offspring.mutate();
 
 ## architecture/network/genetic/network.genetic.setup.utils.ts
 
-### createCrossoverContext
+### asGeneticNetwork
 
 ```ts
-createCrossoverContext(
-  parentNetwork1: default,
-  parentNetwork2: default,
-  equal: boolean,
-): CrossoverContext
+asGeneticNetwork(
+  network: default,
+): GeneticNetwork
 ```
 
-Creates the immutable crossover baseline context.
+Coerces a network to the internal genetic runtime shape.
 
 Parameters:
-- `parentNetwork1` - - First parent network.
-- `parentNetwork2` - - Second parent network.
-- `equal` - - Equal-treatment mode flag.
+- `network` - - Source network.
 
-Returns: Initialized crossover context.
+Returns: Network with runtime genetic properties.
 
-### createNodeBuildContext
+### assignNodeIndexes
 
 ```ts
-createNodeBuildContext(
-  context: CrossoverContext,
-): CrossoverNodeBuildContext
+assignNodeIndexes(
+  nodes: default[],
+): void
 ```
 
-Creates the node-build context for offspring node selection.
+Assigns contiguous indices to a node list.
 
 Parameters:
-- `context` - - Crossover baseline context.
+- `nodes` - - Nodes to reindex.
 
-Returns: Node-build context.
+Returns: Nothing.
 
 ### assignOffspringNodes
 
@@ -165,6 +161,31 @@ Parameters:
 
 Returns: Nothing.
 
+### buildOffspringNodes
+
+```ts
+buildOffspringNodes(
+  parent1: GeneticNetwork,
+  parent2: GeneticNetwork,
+  parentMetrics: ParentMetrics,
+  offspringNodeCount: number,
+  equal: boolean,
+  randomGenerator: RandomGenerator,
+): default[]
+```
+
+Builds the offspring node list by selecting genes per slot.
+
+Parameters:
+- `parent1` - - First parent.
+- `parent2` - - Second parent.
+- `parentMetrics` - - Parent metrics.
+- `offspringNodeCount` - - Target offspring size.
+- `equal` - - Equal-treatment mode.
+- `randomGenerator` - - Random generator.
+
+Returns: Cloned offspring node genes.
+
 ### chooseOffspringConnectionGenes
 
 ```ts
@@ -180,37 +201,54 @@ Parameters:
 
 Returns: Chosen connection genes.
 
-### validateParentCompatibility
+### cloneNodeGene
 
 ```ts
-validateParentCompatibility(
+cloneNodeGene(
+  sourceNode: default,
+): default
+```
+
+Clones node structural gene attributes.
+
+Parameters:
+- `sourceNode` - - Source node gene.
+
+Returns: Cloned node.
+
+### createCrossoverContext
+
+```ts
+createCrossoverContext(
   parentNetwork1: default,
   parentNetwork2: default,
-): void
+  equal: boolean,
+): CrossoverContext
 ```
 
-Validates parent compatibility for crossover.
+Creates the immutable crossover baseline context.
 
 Parameters:
-- `parentNetwork1` - - First parent candidate.
-- `parentNetwork2` - - Second parent candidate.
+- `parentNetwork1` - - First parent network.
+- `parentNetwork2` - - Second parent network.
+- `equal` - - Equal-treatment mode flag.
 
-Returns: Nothing.
+Returns: Initialized crossover context.
 
-### asGeneticNetwork
+### createNodeBuildContext
 
 ```ts
-asGeneticNetwork(
-  network: default,
-): GeneticNetwork
+createNodeBuildContext(
+  context: CrossoverContext,
+): CrossoverNodeBuildContext
 ```
 
-Coerces a network to the internal genetic runtime shape.
+Creates the node-build context for offspring node selection.
 
 Parameters:
-- `network` - - Source network.
+- `context` - - Crossover baseline context.
 
-Returns: Network with runtime genetic properties.
+Returns: Node-build context.
 
 ### createOffspringScaffold
 
@@ -229,40 +267,6 @@ Parameters:
 
 Returns: Initialized offspring runtime object.
 
-### resolveParentMetrics
-
-```ts
-resolveParentMetrics(
-  parent1: GeneticNetwork,
-  parent2: GeneticNetwork,
-  outputSize: number,
-): ParentMetrics
-```
-
-Computes common parent metrics reused across helper functions.
-
-Parameters:
-- `parent1` - - First parent network.
-- `parent2` - - Second parent network.
-- `outputSize` - - Shared output size.
-
-Returns: Parent metrics.
-
-### getRandomGenerator
-
-```ts
-getRandomGenerator(
-  parentNetwork: default,
-): RandomGenerator
-```
-
-Resolves the random generator used by crossover decisions.
-
-Parameters:
-- `parentNetwork` - - Parent network that may provide a deterministic `_rand` source.
-
-Returns: Random function.
-
 ### determineOffspringNodeCount
 
 ```ts
@@ -282,52 +286,62 @@ Parameters:
 
 Returns: Offspring node count.
 
-### assignNodeIndexes
+### getAlignedOutputNode
 
 ```ts
-assignNodeIndexes(
-  nodes: default[],
-): void
+getAlignedOutputNode(
+  parent: GeneticNetwork,
+  alignedIndex: number,
+): default | undefined
 ```
 
-Assigns contiguous indices to a node list.
+Reads an aligned output candidate node if index is in the valid non-input range.
 
 Parameters:
-- `nodes` - - Nodes to reindex.
+- `parent` - - Parent network.
+- `alignedIndex` - - Tail-aligned index.
 
-Returns: Nothing.
+Returns: Output candidate node.
 
-### buildOffspringNodes
+### getRandomGenerator
 
 ```ts
-buildOffspringNodes(
+getRandomGenerator(
+  parentNetwork: default,
+): RandomGenerator
+```
+
+Resolves the random generator used by crossover decisions.
+
+Parameters:
+- `parentNetwork` - - Parent network that may provide a deterministic `_rand` source.
+
+Returns: Random function.
+
+### resolveParentMetrics
+
+```ts
+resolveParentMetrics(
   parent1: GeneticNetwork,
   parent2: GeneticNetwork,
-  parentMetrics: ParentMetrics,
-  offspringNodeCount: number,
-  equal: boolean,
-  randomGenerator: RandomGenerator,
-): default[]
+  outputSize: number,
+): ParentMetrics
 ```
 
-Builds the offspring node list by selecting genes per slot.
+Computes common parent metrics reused across helper functions.
 
 Parameters:
-- `parent1` - - First parent.
-- `parent2` - - Second parent.
-- `parentMetrics` - - Parent metrics.
-- `offspringNodeCount` - - Target offspring size.
-- `equal` - - Equal-treatment mode.
-- `randomGenerator` - - Random generator.
+- `parent1` - - First parent network.
+- `parent2` - - Second parent network.
+- `outputSize` - - Shared output size.
 
-Returns: Cloned offspring node genes.
+Returns: Parent metrics.
 
-### selectNodeGeneAtIndex
+### selectHiddenNodeGene
 
 ```ts
-selectNodeGeneAtIndex(
+selectHiddenNodeGene(
   nodeIndex: number,
-  offspringNodeCount: number,
   parent1: GeneticNetwork,
   parent2: GeneticNetwork,
   parentMetrics: ParentMetrics,
@@ -336,18 +350,17 @@ selectNodeGeneAtIndex(
 ): default | undefined
 ```
 
-Selects a node gene for a specific offspring slot.
+Selects a hidden-region node gene.
 
 Parameters:
 - `nodeIndex` - - Slot index.
-- `offspringNodeCount` - - Total offspring slots.
 - `parent1` - - First parent.
 - `parent2` - - Second parent.
 - `parentMetrics` - - Parent metrics.
 - `equal` - - Equal-treatment mode.
 - `randomGenerator` - - Random generator.
 
-Returns: Selected parent node gene, when present.
+Returns: Selected hidden node gene.
 
 ### selectInputNodeGene
 
@@ -366,104 +379,121 @@ Parameters:
 
 Returns: Parent 1 input node gene.
 
-### selectOutputNodeGene
+### selectNodeGeneAtIndex
 
 ```ts
-selectOutputNodeGene(
+selectNodeGeneAtIndex(
   nodeIndex: number,
   offspringNodeCount: number,
   parent1: GeneticNetwork,
   parent2: GeneticNetwork,
   parentMetrics: ParentMetrics,
+  equal: boolean,
   randomGenerator: RandomGenerator,
 ): default | undefined
 ```
 
-Selects an output-region node gene using tail alignment.
+Selects a node gene for a specific offspring slot.
 
 Parameters:
 - `nodeIndex` - - Slot index.
-- `offspringNodeCount` - - Target offspring size.
+- `offspringNodeCount` - - Total offspring slots.
 - `parent1` - - First parent.
 - `parent2` - - Second parent.
 - `parentMetrics` - - Parent metrics.
+- `equal` - - Equal-treatment mode.
 - `randomGenerator` - - Random generator.
 
-Returns: Selected output node gene.
-
-### getAlignedOutputNode
-
-```ts
-getAlignedOutputNode(
-  parent: GeneticNetwork,
-  alignedIndex: number,
-): default | undefined
-```
-
-Reads an aligned output candidate node if index is in the valid non-input range.
-
-Parameters:
-- `parent` - - Parent network.
-- `alignedIndex` - - Tail-aligned index.
-
-Returns: Output candidate node.
+Returns: Selected parent node gene, when present.
 
-### selectHiddenNodeGene
+### selectOutputNodeGene
 
 ```ts
-selectHiddenNodeGene(
+selectOutputNodeGene(
   nodeIndex: number,
+  offspringNodeCount: number,
   parent1: GeneticNetwork,
   parent2: GeneticNetwork,
   parentMetrics: ParentMetrics,
-  equal: boolean,
   randomGenerator: RandomGenerator,
 ): default | undefined
 ```
 
-Selects a hidden-region node gene.
+Selects an output-region node gene using tail alignment.
 
 Parameters:
 - `nodeIndex` - - Slot index.
+- `offspringNodeCount` - - Target offspring size.
 - `parent1` - - First parent.
 - `parent2` - - Second parent.
 - `parentMetrics` - - Parent metrics.
-- `equal` - - Equal-treatment mode.
 - `randomGenerator` - - Random generator.
 
-Returns: Selected hidden node gene.
+Returns: Selected output node gene.
 
-### cloneNodeGene
+### validateParentCompatibility
 
 ```ts
-cloneNodeGene(
-  sourceNode: default,
-): default
+validateParentCompatibility(
+  parentNetwork1: default,
+  parentNetwork2: default,
+): void
 ```
 
-Clones node structural gene attributes.
+Validates parent compatibility for crossover.
 
 Parameters:
-- `sourceNode` - - Source node gene.
+- `parentNetwork1` - - First parent candidate.
+- `parentNetwork2` - - Second parent candidate.
 
-Returns: Cloned node.
+Returns: Nothing.
 
 ## architecture/network/genetic/network.genetic.selection.utils.ts
 
-### collectConnectionGenes
+### buildConnectionGene
 
 ```ts
-collectConnectionGenes(
-  parent: GeneticNetwork,
-): Record<string, ConnectionGene>
+buildConnectionGene(
+  connection: default,
+): ConnectionGene | undefined
 ```
 
-Collects all connection genes (standard + self) keyed by innovation ID.
+Builds a connection gene from a concrete connection instance.
 
 Parameters:
-- `parent` - - Parent network.
+- `connection` - - Runtime connection.
 
-Returns: Innovation-keyed connection gene map.
+Returns: Gene descriptor, or undefined when endpoints lack valid indices.
+
+### canInheritParent1DisjointGenes
+
+```ts
+canInheritParent1DisjointGenes(
+  context: ConnectionGeneSelectionContext,
+): boolean
+```
+
+Determines if parent-1 disjoint/excess genes are inheritable.
+
+Parameters:
+- `context` - - Selection context.
+
+Returns: True when parent-1 disjoint genes can be selected.
+
+### canInheritParent2DisjointGenes
+
+```ts
+canInheritParent2DisjointGenes(
+  context: ConnectionGeneSelectionContext,
+): boolean
+```
+
+Determines if parent-2 disjoint/excess genes are inheritable.
+
+Parameters:
+- `context` - - Selection context.
+
+Returns: True when parent-2 disjoint genes can be selected.
 
 ### chooseConnectionGenes
 
@@ -492,62 +522,92 @@ Parameters:
 
 Returns: Chosen genes for offspring materialization.
 
-### buildConnectionGene
+### chooseDisjointGeneFromParent
 
 ```ts
-buildConnectionGene(
-  connection: default,
-): ConnectionGene | undefined
+chooseDisjointGeneFromParent(
+  parent: GeneticNetwork,
+  sourceGene: ConnectionGene,
+): ConnectionGene
 ```
 
-Builds a connection gene from a concrete connection instance.
+Chooses a disjoint/excess gene from a single parent.
 
 Parameters:
-- `connection` - - Runtime connection.
+- `parent` - - Source parent.
+- `sourceGene` - - Source gene.
 
-Returns: Gene descriptor, or undefined when endpoints lack valid indices.
+Returns: Selected disjoint gene.
 
-### createSelectionContext
+### chooseMatchingGene
 
 ```ts
-createSelectionContext(
-  sourceParent1: GeneticNetwork,
-  sourceParent2: GeneticNetwork,
-  sourceParentMetrics: ParentMetrics,
-  sourceParent1Genes: Record<string, ConnectionGene>,
-  sourceParent2Genes: Record<string, ConnectionGene>,
-  sourceEqual: boolean,
-  sourceRandomGenerator: RandomGenerator,
-): ConnectionGeneSelectionContext
+chooseMatchingGene(
+  parent1: GeneticNetwork,
+  parent2: GeneticNetwork,
+  parent1Gene: ConnectionGene,
+  parent2Gene: ConnectionGene,
+  randomGenerator: RandomGenerator,
+): ConnectionGene
 ```
 
-Creates the immutable context for this selection pass.
+Chooses a gene for matching innovation IDs.
 
 Parameters:
-- `sourceParent1` - - First parent.
-- `sourceParent2` - - Second parent.
-- `sourceParentMetrics` - - Shared parent metrics.
-- `sourceParent1Genes` - - Parent-1 genes.
-- `sourceParent2Genes` - - Parent-2 genes.
-- `sourceEqual` - - Equal-treatment flag.
-- `sourceRandomGenerator` - - Random source.
+- `parent1` - - First parent.
+- `parent2` - - Second parent.
+- `parent1Gene` - - Parent 1 matching gene.
+- `parent2Gene` - - Parent 2 matching gene.
+- `randomGenerator` - - Random generator.
 
-Returns: Selection context.
+Returns: Selected gene.
 
-### selectParent1TraversalGenes
+### cloneConnectionGene
 
 ```ts
-selectParent1TraversalGenes(
-  context: ConnectionGeneSelectionContext,
-): Parent1TraversalSelectionResult
+cloneConnectionGene(
+  sourceGene: ConnectionGene,
+): ConnectionGene
 ```
 
-Selects genes reachable from parent-1 innovation traversal.
+Clones a connection gene.
 
 Parameters:
-- `context` - - Selection context.
+- `sourceGene` - - Source gene.
 
-Returns: Parent-1 traversal result.
+Returns: Independent clone.
+
+### collectConnectionGenes
+
+```ts
+collectConnectionGenes(
+  parent: GeneticNetwork,
+): Record<string, ConnectionGene>
+```
+
+Collects all connection genes (standard + self) keyed by innovation ID.
+
+Parameters:
+- `parent` - - Parent network.
+
+Returns: Innovation-keyed connection gene map.
+
+### combineChosenGenes
+
+```ts
+combineChosenGenes(
+  parent1TraversalGenes: ConnectionGene[],
+  parent2OnlyGenesToAppend: ConnectionGene[],
+): ConnectionGene[]
+```
+
+Combines selected gene partitions into one ordered list.
+
+Parameters:
+- `parent1TraversalGenes` - - Genes selected from parent-1 traversal.
+- `parent2OnlyGenesToAppend` - - Parent-2-only genes.
+
+Returns: Combined chosen genes.
 
 ### createParent1TraversalContexts
 
@@ -564,6 +624,33 @@ Parameters:
 
 Returns: Parent-1 traversal contexts.
 
+### createSelectionContext
+
+```ts
+createSelectionContext(
+  sourceParent1: GeneticNetwork,
+  sourceParent2: GeneticNetwork,
+  sourceParentMetrics: ParentMetrics,
+  sourceParent1Genes: Record<string, ConnectionGene>,
+  sourceParent2Genes: Record<string, ConnectionGene>,
+  sourceEqual: boolean,
+  sourceRandomGenerator: RandomGenerator,
+): ConnectionGeneSelectionContext
+```
+
+Creates the immutable context for this selection pass.
+
+Parameters:
+- `sourceParent1` - - First parent.
+- `sourceParent2` - - Second parent.
+- `sourceParentMetrics` - - Shared parent metrics.
+- `sourceParent1Genes` - - Parent-1 genes.
+- `sourceParent2Genes` - - Parent-2 genes.
+- `sourceEqual` - - Equal-treatment flag.
+- `sourceRandomGenerator` - - Random source.
+
+Returns: Selection context.
+
 ### foldParent1TraversalContexts
 
 ```ts
@@ -579,6 +666,23 @@ Parameters:
 
 Returns: Parent-1 selection result.
 
+### resolveReenableProbability
+
+```ts
+resolveReenableProbability(
+  preferredProbability: number | undefined,
+  fallbackProbability: number | undefined,
+): number
+```
+
+Resolves re-enable probability with fallback to default value.
+
+Parameters:
+- `preferredProbability` - - Preferred parent probability.
+- `fallbackProbability` - - Secondary parent probability.
+
+Returns: Probability in [0, 1].
+
 ### selectGeneForParent1TraversalContext
 
 ```ts
@@ -594,22 +698,20 @@ Parameters:
 
 Returns: Selected gene or undefined.
 
-### selectRemainingParent2Genes
+### selectParent1TraversalGenes
 
 ```ts
-selectRemainingParent2Genes(
+selectParent1TraversalGenes(
   context: ConnectionGeneSelectionContext,
-  consumedInnovationIds: string[],
-): Record<string, ConnectionGene>
+): Parent1TraversalSelectionResult
 ```
 
-Builds parent-2 gene map after removing consumed matching innovations.
+Selects genes reachable from parent-1 innovation traversal.
 
 Parameters:
 - `context` - - Selection context.
-- `consumedInnovationIds` - - Innovation IDs already consumed via matching genes.
 
-Returns: Remaining parent-2 genes.
+Returns: Parent-1 traversal result.
 
 ### selectParent2OnlyGenes
 
@@ -628,143 +730,92 @@ Parameters:
 
 Returns: Selected parent-2-only genes.
 
-### canInheritParent1DisjointGenes
+### selectRemainingParent2Genes
 
 ```ts
-canInheritParent1DisjointGenes(
+selectRemainingParent2Genes(
   context: ConnectionGeneSelectionContext,
-): boolean
+  consumedInnovationIds: string[],
+): Record<string, ConnectionGene>
 ```
 
-Determines if parent-1 disjoint/excess genes are inheritable.
+Builds parent-2 gene map after removing consumed matching innovations.
 
 Parameters:
 - `context` - - Selection context.
+- `consumedInnovationIds` - - Innovation IDs already consumed via matching genes.
 
-Returns: True when parent-1 disjoint genes can be selected.
+Returns: Remaining parent-2 genes.
 
-### canInheritParent2DisjointGenes
+## architecture/network/genetic/network.genetic.materialize.utils.ts
+
+### applyConnectionGeneToConnection
 
 ```ts
-canInheritParent2DisjointGenes(
-  context: ConnectionGeneSelectionContext,
-): boolean
+applyConnectionGeneToConnection(
+  connection: default,
+  connectionGene: ConnectionGene,
+): void
 ```
 
-Determines if parent-2 disjoint/excess genes are inheritable.
+Applies gene properties to a runtime connection.
 
 Parameters:
-- `context` - - Selection context.
+- `connection` - - Runtime connection.
+- `connectionGene` - - Gene source.
 
-Returns: True when parent-2 disjoint genes can be selected.
+Returns: Nothing.
 
-### combineChosenGenes
+### attachGaterIfAvailable
 
 ```ts
-combineChosenGenes(
-  parent1TraversalGenes: ConnectionGene[],
-  parent2OnlyGenesToAppend: ConnectionGene[],
-): ConnectionGene[]
+attachGaterIfAvailable(
+  offspring: GeneticNetwork,
+  connection: default,
+  gaterIndex: number,
+): void
 ```
 
-Combines selected gene partitions into one ordered list.
-
-Parameters:
-- `parent1TraversalGenes` - - Genes selected from parent-1 traversal.
-- `parent2OnlyGenesToAppend` - - Parent-2-only genes.
-
-Returns: Combined chosen genes.
-
-### chooseMatchingGene
-
-```ts
-chooseMatchingGene(
-  parent1: GeneticNetwork,
-  parent2: GeneticNetwork,
-  parent1Gene: ConnectionGene,
-  parent2Gene: ConnectionGene,
-  randomGenerator: RandomGenerator,
-): ConnectionGene
-```
-
-Chooses a gene for matching innovation IDs.
-
-Parameters:
-- `parent1` - - First parent.
-- `parent2` - - Second parent.
-- `parent1Gene` - - Parent 1 matching gene.
-- `parent2Gene` - - Parent 2 matching gene.
-- `randomGenerator` - - Random generator.
-
-Returns: Selected gene.
-
-### chooseDisjointGeneFromParent
-
-```ts
-chooseDisjointGeneFromParent(
-  parent: GeneticNetwork,
-  sourceGene: ConnectionGene,
-): ConnectionGene
-```
-
-Chooses a disjoint/excess gene from a single parent.
-
-Parameters:
-- `parent` - - Source parent.
-- `sourceGene` - - Source gene.
-
-Returns: Selected disjoint gene.
-
-### cloneConnectionGene
-
-```ts
-cloneConnectionGene(
-  sourceGene: ConnectionGene,
-): ConnectionGene
-```
-
-Clones a connection gene.
+Attaches a gater node when the target index is valid.
 
 Parameters:
-- `sourceGene` - - Source gene.
+- `offspring` - - Offspring network.
+- `connection` - - Connection to gate.
+- `gaterIndex` - - Candidate gater node index.
 
-Returns: Independent clone.
+Returns: Nothing.
 
-### resolveReenableProbability
+### collectEligibleTraversalContexts
 
 ```ts
-resolveReenableProbability(
-  preferredProbability: number | undefined,
-  fallbackProbability: number | undefined,
-): number
+collectEligibleTraversalContexts(
+  context: OffspringMaterializationContext,
+  genes: ConnectionGene[],
+): GeneTraversalContext[]
 ```
 
-Resolves re-enable probability with fallback to default value.
+Collects traversal contexts that satisfy all structural eligibility checks.
 
 Parameters:
-- `preferredProbability` - - Preferred parent probability.
-- `fallbackProbability` - - Secondary parent probability.
-
-Returns: Probability in [0, 1].
+- `context` - - Top-level materialization context.
+- `genes` - - Candidate genes.
 
-## architecture/network/genetic/network.genetic.materialize.utils.ts
+Returns: Eligible traversal contexts.
 
-### materializeOffspringConnections
+### createConnectionForEndpoints
 
 ```ts
-materializeOffspringConnections(
-  offspring: GeneticNetwork,
-  chosenGenes: ConnectionGene[],
-): void
+createConnectionForEndpoints(
+  endpointsContext: GeneEndpointsContext,
+): default | undefined
 ```
 
-Materializes selected connection genes in the offspring network.
+Creates a runtime connection for endpoint nodes.
 
 Parameters:
-- `offspring` - - Offspring network.
-- `chosenGenes` - - Chosen connection genes.
+- `endpointsContext` - - Endpoint context.
 
-Returns: Nothing.
+Returns: Created connection or undefined.
 
 ### createMaterializationContext
 
@@ -781,22 +832,24 @@ Parameters:
 
 Returns: Materialization context.
 
-### collectEligibleTraversalContexts
+### createOffspringConnection
 
 ```ts
-collectEligibleTraversalContexts(
-  context: OffspringMaterializationContext,
-  genes: ConnectionGene[],
-): GeneTraversalContext[]
+createOffspringConnection(
+  offspring: GeneticNetwork,
+  fromNode: default,
+  toNode: default,
+): default | undefined
 ```
 
-Collects traversal contexts that satisfy all structural eligibility checks.
+Creates a single offspring connection edge.
 
 Parameters:
-- `context` - - Top-level materialization context.
-- `genes` - - Candidate genes.
+- `offspring` - - Offspring network.
+- `fromNode` - - Source node.
+- `toNode` - - Destination node.
 
-Returns: Eligible traversal contexts.
+Returns: Created connection or undefined.
 
 ### createTraversalContexts
 
@@ -815,192 +868,139 @@ Parameters:
 
 Returns: Traversal contexts.
 
-### keepTraversalContextsWithinNodeBounds
-
-```ts
-keepTraversalContextsWithinNodeBounds(
-  traversalContexts: GeneTraversalContext[],
-): GeneTraversalContext[]
-```
-
-Keeps traversal contexts whose endpoints are inside offspring bounds.
-
-Parameters:
-- `traversalContexts` - - Candidate traversal contexts.
-
-Returns: Node-bounded contexts.
-
-### keepFeedForwardTraversalContexts
-
-```ts
-keepFeedForwardTraversalContexts(
-  traversalContexts: GeneTraversalContext[],
-): GeneTraversalContext[]
-```
-
-Keeps traversal contexts that preserve feed-forward edge direction.
-
-Parameters:
-- `traversalContexts` - - Node-bounded traversal contexts.
-
-Returns: Feed-forward contexts.
-
-### materializeTraversalContexts
+### hasExistingProjection
 
 ```ts
-materializeTraversalContexts(
-  traversalContexts: GeneTraversalContext[],
-): void
+hasExistingProjection(
+  endpointsContext: GeneEndpointsContext,
+): boolean
 ```
 
-Materializes each eligible traversal context independently.
+Checks whether the source endpoint already projects to the target endpoint.
 
 Parameters:
-- `traversalContexts` - - Eligible traversal contexts.
+- `endpointsContext` - - Endpoint context.
 
-Returns: Nothing.
+Returns: True when projection already exists.
 
-### materializeSingleTraversalContext
+### isTraversalContextFeedForward
 
 ```ts
-materializeSingleTraversalContext(
+isTraversalContextFeedForward(
   traversalContext: GeneTraversalContext,
-): void
+): boolean
 ```
 
-Materializes one eligible traversal context when no duplicate projection exists.
+Validates that a traversal context follows feed-forward ordering.
 
 Parameters:
 - `traversalContext` - - Traversal context.
 
-Returns: Nothing.
+Returns: True when the gene is strictly forward.
 
-### resolveGeneEndpointsContext
+### isTraversalContextWithinNodeBounds
 
 ```ts
-resolveGeneEndpointsContext(
+isTraversalContextWithinNodeBounds(
   traversalContext: GeneTraversalContext,
-): GeneEndpointsContext | undefined
+): boolean
 ```
 
-Resolves concrete endpoint nodes for a traversal context.
+Validates that a traversal context endpoints are inside offspring bounds.
 
 Parameters:
 - `traversalContext` - - Traversal context.
 
-Returns: Endpoint context or undefined.
+Returns: True when both indices are bounded.
 
-### createConnectionForEndpoints
+### keepFeedForwardTraversalContexts
 
 ```ts
-createConnectionForEndpoints(
-  endpointsContext: GeneEndpointsContext,
-): default | undefined
+keepFeedForwardTraversalContexts(
+  traversalContexts: GeneTraversalContext[],
+): GeneTraversalContext[]
 ```
 
-Creates a runtime connection for endpoint nodes.
+Keeps traversal contexts that preserve feed-forward edge direction.
 
 Parameters:
-- `endpointsContext` - - Endpoint context.
+- `traversalContexts` - - Node-bounded traversal contexts.
 
-Returns: Created connection or undefined.
+Returns: Feed-forward contexts.
 
-### hasExistingProjection
+### keepTraversalContextsWithinNodeBounds
 
 ```ts
-hasExistingProjection(
-  endpointsContext: GeneEndpointsContext,
-): boolean
+keepTraversalContextsWithinNodeBounds(
+  traversalContexts: GeneTraversalContext[],
+): GeneTraversalContext[]
 ```
 
-Checks whether the source endpoint already projects to the target endpoint.
+Keeps traversal contexts whose endpoints are inside offspring bounds.
 
 Parameters:
-- `endpointsContext` - - Endpoint context.
+- `traversalContexts` - - Candidate traversal contexts.
 
-Returns: True when projection already exists.
+Returns: Node-bounded contexts.
 
-### isTraversalContextWithinNodeBounds
+### materializeOffspringConnections
 
 ```ts
-isTraversalContextWithinNodeBounds(
-  traversalContext: GeneTraversalContext,
-): boolean
+materializeOffspringConnections(
+  offspring: GeneticNetwork,
+  chosenGenes: ConnectionGene[],
+): void
 ```
 
-Validates that a traversal context endpoints are inside offspring bounds.
+Materializes selected connection genes in the offspring network.
 
 Parameters:
-- `traversalContext` - - Traversal context.
+- `offspring` - - Offspring network.
+- `chosenGenes` - - Chosen connection genes.
 
-Returns: True when both indices are bounded.
+Returns: Nothing.
 
-### isTraversalContextFeedForward
+### materializeSingleTraversalContext
 
 ```ts
-isTraversalContextFeedForward(
+materializeSingleTraversalContext(
   traversalContext: GeneTraversalContext,
-): boolean
+): void
 ```
 
-Validates that a traversal context follows feed-forward ordering.
+Materializes one eligible traversal context when no duplicate projection exists.
 
 Parameters:
 - `traversalContext` - - Traversal context.
 
-Returns: True when the gene is strictly forward.
-
-### createOffspringConnection
-
-```ts
-createOffspringConnection(
-  offspring: GeneticNetwork,
-  fromNode: default,
-  toNode: default,
-): default | undefined
-```
-
-Creates a single offspring connection edge.
-
-Parameters:
-- `offspring` - - Offspring network.
-- `fromNode` - - Source node.
-- `toNode` - - Destination node.
-
-Returns: Created connection or undefined.
+Returns: Nothing.
 
-### applyConnectionGeneToConnection
+### materializeTraversalContexts
 
 ```ts
-applyConnectionGeneToConnection(
-  connection: default,
-  connectionGene: ConnectionGene,
+materializeTraversalContexts(
+  traversalContexts: GeneTraversalContext[],
 ): void
 ```
 
-Applies gene properties to a runtime connection.
+Materializes each eligible traversal context independently.
 
 Parameters:
-- `connection` - - Runtime connection.
-- `connectionGene` - - Gene source.
+- `traversalContexts` - - Eligible traversal contexts.
 
 Returns: Nothing.
 
-### attachGaterIfAvailable
+### resolveGeneEndpointsContext
 
 ```ts
-attachGaterIfAvailable(
-  offspring: GeneticNetwork,
-  connection: default,
-  gaterIndex: number,
-): void
+resolveGeneEndpointsContext(
+  traversalContext: GeneTraversalContext,
+): GeneEndpointsContext | undefined
 ```
 
-Attaches a gater node when the target index is valid.
+Resolves concrete endpoint nodes for a traversal context.
 
 Parameters:
-- `offspring` - - Offspring network.
-- `connection` - - Connection to gate.
-- `gaterIndex` - - Candidate gater node index.
+- `traversalContext` - - Traversal context.
 
-Returns: Nothing.
+Returns: Endpoint context or undefined.