@reicek/neataptic-ts 0.1.21 → 0.1.23

package/src/architecture/architect.ts

@@ -144,6 +144,10 @@ export default class Architect {
    * An MLP consists of an input layer, one or more hidden layers, and an output layer,
    * fully connected layer by layer.
    *
+   * The returned network is marked with the public `feed-forward` topology
+   * intent so acyclic enforcement and slab fast-path eligibility stay aligned
+   * with the builder users already chose.
+   *
    * @param {...number} layers - 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.
    * @returns {Network} The constructed MLP network.
    * @throws {Error} If fewer than 3 layer sizes (input, hidden, output) are provided.
@@ -197,6 +201,8 @@ export default class Architect {
     (net as unknown as { layers: Layer[] }).layers = nodes.filter(
       (n) => n instanceof Layer,
     );
+    net.setTopologyIntent('feed-forward');
+
     return net;
   }
 

package/src/architecture/layer/README.md

@@ -106,7 +106,7 @@ const propagationContext: LayerPropagationContext = { nodes: layer.nodes };
 
 ### activateLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerActivationContext, values: number[] | undefined, training: boolean) => number[]`
+`(context: import("src/architecture/layer/layer.utils.types").LayerActivationContext, values: number[] | undefined, training: boolean) => number[]`
 
 Orchestrates layer activation behavior with a high-level flow.
 
@@ -140,7 +140,7 @@ Returns: A cloned array of activation values.
 
 ### clearLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext) => void`
 
 Orchestrates clearing node activation state with a high-level flow.
 
@@ -154,7 +154,7 @@ clearLayer(layerConnectionContext);
 
 ### connectLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, 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[]`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, 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[]`
 
 Orchestrates layer connection behavior with a high-level flow.
 
@@ -177,7 +177,7 @@ Returns: The created connection list.
 
 ### createAttentionLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, heads: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, heads: number) => TLayer`
 
 Orchestrates attention layer creation with a high-level flow.
 
@@ -195,7 +195,7 @@ const attention = createAttentionLayer(factoryContext, 8, 4);
 
 ### createBatchNormLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Orchestrates batch normalization layer creation with a high-level flow.
 
@@ -212,7 +212,7 @@ const batchNorm = createBatchNormLayer(factoryContext, 16);
 
 ### createConv1dLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, kernelSize: number, stride: number, padding: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, kernelSize: number, stride: number, padding: number) => TLayer`
 
 Orchestrates 1D convolution layer creation with a high-level flow.
 
@@ -232,7 +232,7 @@ const conv1d = createConv1dLayer(factoryContext, 8, 3);
 
 ### createDenseLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Orchestrates dense layer creation with a high-level flow.
 
@@ -249,7 +249,7 @@ const dense = createDenseLayer(factoryContext, 8);
 
 ### createGruLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Orchestrates GRU layer creation with a high-level flow.
 
@@ -266,7 +266,7 @@ const gru = createGruLayer(factoryContext, 8);
 
 ### createLayerNormLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Orchestrates layer normalization layer creation with a high-level flow.
 
@@ -283,7 +283,7 @@ const layerNorm = createLayerNormLayer(factoryContext, 16);
 
 ### createLstmLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Orchestrates LSTM layer creation with a high-level flow.
 
@@ -300,7 +300,7 @@ const lstm = createLstmLayer(factoryContext, 8);
 
 ### createMemoryLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, memory: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, memory: number) => TLayer`
 
 Orchestrates Memory layer creation with a high-level flow.
 
@@ -318,7 +318,7 @@ const memoryLayer = createMemoryLayer(factoryContext, 4, 3);
 
 ### disconnectLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, target: import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/group").default, twoSided: boolean) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, target: import("src/architecture/node").default | import("src/architecture/group").default, twoSided: boolean) => void`
 
 Orchestrates disconnection behavior with a high-level flow.
 
@@ -335,7 +335,7 @@ Parameters:
 
 ### gateLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, connections: import("C:/NeatapticTS/src/architecture/connection").default[], method: unknown) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, connections: import("src/architecture/connection").default[], method: unknown) => void`
 
 Orchestrates layer gating behavior with a high-level flow.
 
@@ -352,7 +352,7 @@ Parameters:
 
 ### inputLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, 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[]`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, from: import("src/architecture/group").default | import("src/architecture/layer/layer.utils.types").LayerLike, method: unknown, weight: number | undefined) => import("src/architecture/connection").default[]`
 
 Orchestrates layer input wiring with a high-level flow.
 
@@ -372,7 +372,7 @@ Returns: The created connection list.
 
 ### propagateLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerPropagationContext, rate: number, momentum: number, targets: number[] | undefined) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerPropagationContext, rate: number, momentum: number, targets: number[] | undefined) => void`
 
 Orchestrates layer backpropagation behavior with a high-level flow.
 
@@ -450,7 +450,7 @@ Returns: A pooled output array.
 
 ### applyLayerMask
 
-`(nodeList: import("C:/NeatapticTS/src/architecture/node").default[], mask: number) => void`
+`(nodeList: import("src/architecture/node").default[], mask: number) => void`
 
 Applies one mask value to every node in the layer.
 
@@ -520,7 +520,7 @@ Returns: A cloned output array.
 
 ### fillActivationOutput
 
-`(nodeList: import("C:/NeatapticTS/src/architecture/node").default[], inputValues: number[] | undefined, output: number[]) => void`
+`(nodeList: import("src/architecture/node").default[], inputValues: number[] | undefined, output: number[]) => void`
 
 Activates each node and writes outputs into the provided buffer.
 
@@ -588,7 +588,7 @@ Returns: A mask value of 1 or 0 for all nodes in the layer.
 
 ### clearLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext) => void`
 
 Clears activation state for all nodes in a layer.
 
@@ -606,7 +606,7 @@ Parameters:
 
 ### connectLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, 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[]`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, 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[]`
 
 Connects a layer's output group to a target.
 
@@ -638,7 +638,7 @@ Returns: The created connection list.
 
 ### disconnectFromGroup
 
-`(layerNodes: import("C:/NeatapticTS/src/architecture/node").default[], targetGroup: import("C:/NeatapticTS/src/architecture/group").default, layerConnections: { in: import("C:/NeatapticTS/src/architecture/connection").default[]; out: import("C:/NeatapticTS/src/architecture/connection").default[]; self: import("C:/NeatapticTS/src/architecture/connection").default[]; }, removeTwoSided: boolean) => void`
+`(layerNodes: import("src/architecture/node").default[], targetGroup: import("src/architecture/group").default, layerConnections: { in: import("src/architecture/connection").default[]; out: import("src/architecture/connection").default[]; self: import("src/architecture/connection").default[]; }, removeTwoSided: boolean) => void`
 
 Disconnects all layer nodes from a target group.
 
@@ -653,7 +653,7 @@ Parameters:
 
 ### disconnectFromNode
 
-`(layerNodes: import("C:/NeatapticTS/src/architecture/node").default[], targetNode: import("C:/NeatapticTS/src/architecture/node").default, layerConnections: { in: import("C:/NeatapticTS/src/architecture/connection").default[]; out: import("C:/NeatapticTS/src/architecture/connection").default[]; self: import("C:/NeatapticTS/src/architecture/connection").default[]; }, removeTwoSided: boolean) => void`
+`(layerNodes: import("src/architecture/node").default[], targetNode: import("src/architecture/node").default, layerConnections: { in: import("src/architecture/connection").default[]; out: import("src/architecture/connection").default[]; self: import("src/architecture/connection").default[]; }, removeTwoSided: boolean) => void`
 
 Disconnects all layer nodes from a target node.
 
@@ -665,7 +665,7 @@ Parameters:
 
 ### disconnectLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, target: import("C:/NeatapticTS/src/architecture/node").default | import("C:/NeatapticTS/src/architecture/group").default, twoSided: boolean) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, target: import("src/architecture/node").default | import("src/architecture/group").default, twoSided: boolean) => void`
 
 Disconnects nodes in this layer from a target group or node.
 
@@ -686,7 +686,7 @@ Parameters:
 
 ### gateLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, connections: import("C:/NeatapticTS/src/architecture/connection").default[], method: unknown) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, connections: import("src/architecture/connection").default[], method: unknown) => void`
 
 Applies gating to the provided connections using the layer output group.
 
@@ -709,7 +709,7 @@ Parameters:
 
 ### inputLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerConnectionContext, 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[]`
+`(context: import("src/architecture/layer/layer.utils.types").LayerConnectionContext, from: import("src/architecture/group").default | import("src/architecture/layer/layer.utils.types").LayerLike, method: unknown, weight: number | undefined) => import("src/architecture/connection").default[]`
 
 Connects a source group or layer to this layer's input target.
 
@@ -740,7 +740,7 @@ Returns: The created connection list.
 
 ### removeIncomingConnection
 
-`(layerConnections: { in: import("C:/NeatapticTS/src/architecture/connection").default[]; out: import("C:/NeatapticTS/src/architecture/connection").default[]; self: import("C:/NeatapticTS/src/architecture/connection").default[]; }, sourceNode: import("C:/NeatapticTS/src/architecture/node").default, targetNode: import("C:/NeatapticTS/src/architecture/node").default) => void`
+`(layerConnections: { in: import("src/architecture/connection").default[]; out: import("src/architecture/connection").default[]; self: import("src/architecture/connection").default[]; }, sourceNode: import("src/architecture/node").default, targetNode: import("src/architecture/node").default) => void`
 
 Removes an incoming connection from layer tracking.
 
@@ -753,7 +753,7 @@ Parameters:
 
 ### removeOutgoingConnection
 
-`(layerConnections: { in: import("C:/NeatapticTS/src/architecture/connection").default[]; out: import("C:/NeatapticTS/src/architecture/connection").default[]; self: import("C:/NeatapticTS/src/architecture/connection").default[]; }, sourceNode: import("C:/NeatapticTS/src/architecture/node").default, targetNode: import("C:/NeatapticTS/src/architecture/node").default) => void`
+`(layerConnections: { in: import("src/architecture/connection").default[]; out: import("src/architecture/connection").default[]; self: import("src/architecture/connection").default[]; }, sourceNode: import("src/architecture/node").default, targetNode: import("src/architecture/node").default) => void`
 
 Removes an outgoing connection from layer tracking.
 
@@ -788,7 +788,7 @@ Parameters:
 
 ### propagateNodesInReverse
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerPropagationContext, rate: number, momentum: number, targets: number[] | undefined) => void`
+`(context: import("src/architecture/layer/layer.utils.types").LayerPropagationContext, rate: number, momentum: number, targets: number[] | undefined) => void`
 
 Propagates errors through all nodes in reverse order.
 
@@ -822,7 +822,7 @@ Parameters:
 
 ### buildDenseLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Builds a standard dense (fully connected) layer.
 
@@ -854,7 +854,7 @@ dense.input(previousLayerLike);
 
 ### buildGruLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Builds a GRU layer using the provided factory context.
 
@@ -878,7 +878,7 @@ gru.input(previousLayerLike);
 
 ### buildLstmLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Builds an LSTM layer using the provided factory context.
 
@@ -908,7 +908,7 @@ lstm.input(previousLayerLike);
 
 ### buildMemoryLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, memory: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, memory: number) => TLayer`
 
 Builds a Memory layer using the provided factory context.
 
@@ -936,7 +936,7 @@ memoryLayer.input(previousLayerLike);
 
 ### flattenConnections
 
-`(connectionLists: import("C:/NeatapticTS/src/architecture/connection").default[][]) => import("C:/NeatapticTS/src/architecture/connection").default[]`
+`(connectionLists: import("src/architecture/connection").default[][]) => import("src/architecture/connection").default[]`
 
 Flattens grouped connection arrays into a single list.
 
@@ -976,7 +976,7 @@ const method = resolveConnectionMethod(undefined);
 
 ### resolveSourceGroup
 
-`(factoryContext: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, from: import("C:/NeatapticTS/src/architecture/group").default | import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerLike) => import("C:/NeatapticTS/src/architecture/group").default`
+`(factoryContext: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, from: import("src/architecture/group").default | import("src/architecture/layer/layer.utils.types").LayerLike) => import("src/architecture/group").default`
 
 Resolves a source group from a layer-like or group input.
 
@@ -1019,7 +1019,7 @@ const outputs = activateStubNodes(layer);
 
 ### buildAttentionLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, heads: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, heads: number) => TLayer`
 
 Builds a lightweight attention-style stub layer.
 
@@ -1048,7 +1048,7 @@ const out = attention.activate([1, 2, 3, 4]);
 
 ### buildConv1dLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, kernelSize: number, stride: number, padding: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number, kernelSize: number, stride: number, padding: number) => TLayer`
 
 Builds a lightweight Conv1D-style stub layer.
 
@@ -1130,7 +1130,7 @@ activate([9, 8, 7, 6]); // -> [9, 8, 7]
 
 ### createStubLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Creates shared node/output scaffolding for experimental layers.
 
@@ -1176,7 +1176,7 @@ Example (conceptual flow):
 
 ### buildBatchNormLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Builds a dense layer decorated with batch-style normalization.
 
@@ -1204,7 +1204,7 @@ const normalized = buildBatchNormLayer(factoryContext, 16);
 
 ### buildLayerNormLayer
 
-`(context: import("C:/NeatapticTS/src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
+`(context: import("src/architecture/layer/layer.utils.types").LayerFactoryContext<TLayer>, size: number) => TLayer`
 
 Builds a dense layer decorated with layer-style normalization.
 

package/src/architecture/network/README.md

@@ -295,7 +295,7 @@ Internal normalized evolution config.
 
 ### EvolutionFitnessFunction
 
-`(arg0: import("C:/NeatapticTS/src/architecture/network").default & import("C:/NeatapticTS/src/architecture/network").default[]) => number | Promise<void>`
+`(arg0: import("src/architecture/network").default & import("src/architecture/network").default[]) => number | Promise<void>`
 
 Unified evolution fitness callback shape.
 
@@ -509,7 +509,7 @@ Smoothing can make early stopping and progress logging less noisy.
 
 ### MutationHandler
 
-`(method: import("C:/NeatapticTS/src/architecture/network/network.types").MutationMethod | undefined) => void`
+`(method: import("src/architecture/network/network.types").MutationMethod | undefined) => void`
 
 Mutation handler function contract.
 
@@ -543,6 +543,14 @@ Provenance of hidden-layer architecture information.
 
 Constructor signature for runtime Network import.
 
+### NetworkConstructorOptions
+
+Public constructor options for `Network`.
+
+`topologyIntent` is the semantic, DX-first contract. `enforceAcyclic`
+remains available for backward compatibility and must not contradict the
+declared topology intent.
+
 ### NetworkGeneticProps
 
 Runtime properties used during genetic operations.
@@ -595,6 +603,14 @@ Internal Network properties for slab operations.
 
 Internal standalone generation network view.
 
+### NetworkTopologyIntent
+
+Public topology intent exposed by the network API.
+
+Use `feed-forward` when the caller wants the library to preserve an acyclic,
+forward-only contract. Use `unconstrained` when recurrent, gated, or other
+cyclic structures may be introduced.
+
 ### NetworkTopoRuntime
 
 Runtime topology contract used to lazily rebuild topological order.
@@ -951,7 +967,7 @@ while keeping the ONNX parser itself mostly pure.
 
 ### OnnxRuntimeLayerFactory
 
-`(size: number) => import("C:/NeatapticTS/src/architecture/layer").default`
+`(size: number) => import("src/architecture/layer").default`
 
 Runtime layer-constructor signature used for recurrent layer reconstruction.
 
@@ -970,7 +986,7 @@ This is the minimal set of recurrent factories needed by the importer.
 
 ### OnnxRuntimePerceptronFactory
 
-`(sizes: number[]) => import("C:/NeatapticTS/src/architecture/network").default`
+`(sizes: number[]) => import("src/architecture/network").default`
 
 Runtime perceptron factory signature used by ONNX import orchestration.
 
@@ -1103,7 +1119,7 @@ Per-pool-key allocation & reuse counters (educational / diagnostics).
 
 ### PopulationFitnessFunction
 
-`(population: import("C:/NeatapticTS/src/architecture/network").default[]) => Promise<void>`
+`(population: import("src/architecture/network").default[]) => Promise<void>`
 
 Fitness signature evaluating full population asynchronously.
 
@@ -1272,7 +1288,7 @@ Shared parameters for constructing a Gemm node payload.
 
 ### SingleGenomeFitnessFunction
 
-`(genome: import("C:/NeatapticTS/src/architecture/network").default) => number`
+`(genome: import("src/architecture/network").default) => number`
 
 Fitness signature evaluating one genome.
 
@@ -1453,7 +1469,7 @@ Returns: Implementation-defined result of Network.activate (typically an output
 
 ### applyGradientClippingImpl
 
-`(net: import("C:/NeatapticTS/src/architecture/network").default, cfg: import("C:/NeatapticTS/src/architecture/network/training/network.training.utils.types").GradientClipRuntimeConfig) => void`
+`(net: import("src/architecture/network").default, cfg: import("src/architecture/network/training/network.training.utils.types").GradientClipRuntimeConfig) => void`
 
 Apply gradient clipping to a network using a normalized runtime configuration.
 
@@ -1505,7 +1521,7 @@ Design Notes:
 
 ### connect
 
-`(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[]`
+`(from: import("src/architecture/node").default, to: import("src/architecture/node").default, weight: number | undefined) => import("src/architecture/connection").default[]`
 
 Create and register one (or multiple) directed connection objects between two nodes.
 
@@ -1538,9 +1554,11 @@ Parameters:
 - `to` - - Target node (receives signal).
 - `weight` - - Optional explicit initial weight value.
 
+Returns: Array of created  {@link Connection} objects (possibly empty if acyclicity rejected the edge).
+
 ### createMLP
 
-`(inputCount: number, hiddenCounts: number[], outputCount: number) => import("C:/NeatapticTS/src/architecture/network").default`
+`(inputCount: number, hiddenCounts: number[], outputCount: number) => import("src/architecture/network").default`
 
 Build a strictly layered and fully connected MLP network.
 
@@ -1554,7 +1572,7 @@ Returns: Newly created MLP network.
 
 ### crossOver
 
-`(parentNetwork1: import("C:/NeatapticTS/src/architecture/network").default, parentNetwork2: import("C:/NeatapticTS/src/architecture/network").default, equal: boolean) => import("C:/NeatapticTS/src/architecture/network").default`
+`(parentNetwork1: import("src/architecture/network").default, parentNetwork2: import("src/architecture/network").default, equal: boolean) => import("src/architecture/network").default`
 
 Genetic operator: NEAT‑style crossover (legacy merge operator removed).
 
@@ -1571,7 +1589,7 @@ Design notes:
 
 ### describeArchitecture
 
-`(network: import("C:/NeatapticTS/src/architecture/network").default) => import("C:/NeatapticTS/src/architecture/network/network.types").NetworkArchitectureDescriptor`
+`(network: import("src/architecture/network").default) => import("src/architecture/network/network.types").NetworkArchitectureDescriptor`
 
 Describes network architecture for diagnostics, telemetry, and UI rendering.
 
@@ -1591,11 +1609,11 @@ Returns: Stable architecture descriptor.
 
 ### deserialize
 
-`(data: import("C:/NeatapticTS/src/architecture/network/network.types").CompactSerializedNetworkTuple, inputSize: number | undefined, outputSize: number | undefined) => import("C:/NeatapticTS/src/architecture/network").default`
+`(data: import("src/architecture/network/network.types").CompactSerializedNetworkTuple, inputSize: number | undefined, outputSize: number | undefined) => import("src/architecture/network").default`
 
 ### disconnect
 
-`(from: import("C:/NeatapticTS/src/architecture/node").default, to: import("C:/NeatapticTS/src/architecture/node").default) => void`
+`(from: import("src/architecture/node").default, to: import("src/architecture/node").default) => void`
 
 Remove (at most) one directed connection from source 'from' to target 'to'.
 
@@ -1626,7 +1644,7 @@ Parameters:
 
 ### evolveNetwork
 
-`(set: import("C:/NeatapticTS/src/architecture/network/network.types").TrainingSample[], options: import("C:/NeatapticTS/src/architecture/network/network.types").EvolveOptions) => Promise<{ error: number; iterations: number; time: number; }>`
+`(set: import("src/architecture/network/network.types").TrainingSample[], options: import("src/architecture/network/network.types").EvolveOptions) => Promise<{ error: number; iterations: number; time: number; }>`
 
 Evolves a network with a NEAT-style search loop until an error target or generation limit is reached.
 
@@ -1671,11 +1689,11 @@ Returns: Output activations (detached plain array) of length `network.output`.
 
 ### fromJSONImpl
 
-`(json: import("C:/NeatapticTS/src/architecture/network/network.types").NetworkJSON) => import("C:/NeatapticTS/src/architecture/network").default`
+`(json: import("src/architecture/network/network.types").NetworkJSON) => import("src/architecture/network").default`
 
 ### gate
 
-`(node: import("C:/NeatapticTS/src/architecture/node").default, connection: import("C:/NeatapticTS/src/architecture/connection").default) => void`
+`(node: import("src/architecture/node").default, connection: import("src/architecture/connection").default) => void`
 
 Attach a gater node to a connection so that the connection's effective weight
 becomes dynamically modulated by the gater's activation (see {@link Node.gate} for exact math).
@@ -1704,7 +1722,7 @@ Returns: Standard normal sample with mean 0 and variance 1.
 
 ### generateStandalone
 
-`(net: import("C:/NeatapticTS/src/architecture/network").default) => string`
+`(net: import("src/architecture/network").default) => string`
 
 Standalone forward pass code generator.
 
@@ -1734,7 +1752,7 @@ Not Supported / Simplifications:
 
 ### getConnectionSlab
 
-`() => import("C:/NeatapticTS/src/architecture/network/slab/network.slab.utils.types").ConnectionSlabView`
+`() => import("src/architecture/network/slab/network.slab.utils.types").ConnectionSlabView`
 
 Obtain (and lazily rebuild if dirty) the current packed SoA view of connections.
 
@@ -1782,7 +1800,7 @@ Returns: Numeric RNG state value, or `undefined` when no deterministic state exi
 
 ### getSlabAllocationStats
 
-`() => { pool: { [x: string]: import("C:/NeatapticTS/src/architecture/network/slab/network.slab.utils.types").PoolKeyMetrics; }; fresh: number; pooled: number; }`
+`() => { pool: { [x: string]: import("src/architecture/network/slab/network.slab.utils.types").PoolKeyMetrics; }; fresh: number; pooled: number; }`
 
 Slab Packing / Structure‑of‑Arrays Backend (Educational Module)
 ==============================================================
@@ -1816,7 +1834,7 @@ console.log('First weight from->to', slab.weights[0], slab.from[0], slab.to[0]);
 
 ### hasPath
 
-`(from: import("C:/NeatapticTS/src/architecture/node").default, to: import("C:/NeatapticTS/src/architecture/node").default) => boolean`
+`(from: import("src/architecture/node").default, to: import("src/architecture/node").default) => boolean`
 
 Depth-first reachability test (avoids infinite loops via visited set).
 
@@ -1844,7 +1862,7 @@ Internal State Fields (attached to Network via `any` casting):
 
 ### mutateImpl
 
-`(method: import("C:/NeatapticTS/src/architecture/network/network.types").MutationMethod | undefined) => void`
+`(method: import("src/architecture/network/network.types").MutationMethod | undefined) => void`
 
 Public entry point: apply a single mutation operator to the network.
 
@@ -1903,7 +1921,7 @@ Returns: Array of output neuron activations (length == network.output).
 
 ### propagate
 
-`(rate: number, momentum: number, update: boolean, target: number[], regularization: number, costDerivative: import("C:/NeatapticTS/src/architecture/network/training/network.training.utils.types").CostDerivative | undefined) => void`
+`(rate: number, momentum: number, update: boolean, target: number[], regularization: number, costDerivative: import("src/architecture/network/training/network.training.utils.types").CostDerivative | undefined) => void`
 
 Propagate output and hidden errors backward through the network.
 
@@ -1918,7 +1936,7 @@ Parameters:
 
 ### pruneToSparsity
 
-`(targetSparsity: number, method: import("C:/NeatapticTS/src/architecture/network/network.types").PruningMethod) => void`
+`(targetSparsity: number, method: import("src/architecture/network/network.types").PruningMethod) => void`
 
 Evolutionary (generation-based) pruning toward a target sparsity baseline.
 Unlike maybePrune this operates immediately relative to the first invocation's connection count
@@ -1932,7 +1950,7 @@ Returns: Nothing.
 
 ### rebuildConnections
 
-`(networkInstance: import("C:/NeatapticTS/src/architecture/network").default) => void`
+`(networkInstance: import("src/architecture/network").default) => void`
 
 Rebuild the canonical connection array from per-node outgoing lists.
 
@@ -1982,7 +2000,7 @@ Returns: Promise resolving once rebuild completes.
 
 ### removeNode
 
-`(node: import("C:/NeatapticTS/src/architecture/node").default) => void`
+`(node: import("src/architecture/node").default) => void`
 
 Node removal utilities.
 
@@ -2032,7 +2050,7 @@ Returns: Nothing.
 
 ### serialize
 
-`() => import("C:/NeatapticTS/src/architecture/network/network.types").CompactSerializedNetworkTuple`
+`() => import("src/architecture/network/network.types").CompactSerializedNetworkTuple`
 
 Serializes a network instance into the compact tuple format.
 
@@ -2080,7 +2098,7 @@ Returns: Nothing.
 
 ### snapshotRNG
 
-`() => import("C:/NeatapticTS/src/architecture/network/network.types").RNGSnapshot`
+`() => import("src/architecture/network/network.types").RNGSnapshot`
 
 Captures the current deterministic RNG lifecycle state as a portable snapshot.
 
@@ -2109,7 +2127,7 @@ Returns: Mean error and evaluation duration.
 
 ### toJSONImpl
 
-`() => import("C:/NeatapticTS/src/architecture/network/network.types").NetworkJSON`
+`() => import("src/architecture/network/network.types").NetworkJSON`
 
 Serializes a network instance into the verbose JSON format.
 
@@ -2123,7 +2141,7 @@ Returns: Versioned JSON payload with shape metadata, nodes, and connections.
 
 ### trainImpl
 
-`(net: import("C:/NeatapticTS/src/architecture/network").default, set: import("C:/NeatapticTS/src/architecture/network/training/network.training.utils.types").TrainingSample[], options: import("C:/NeatapticTS/src/architecture/network/network.types").TrainingOptions) => { error: number; iterations: number; time: number; }`
+`(net: import("src/architecture/network").default, set: import("src/architecture/network/training/network.training.utils.types").TrainingSample[], options: import("src/architecture/network/network.types").TrainingOptions) => { error: number; iterations: number; time: number; }`
 
 High-level training orchestration with early stopping, smoothing & callbacks.
 
@@ -2138,7 +2156,7 @@ Returns: Summary payload containing final error, iteration count, and elapsed ti
 
 ### trainSetImpl
 
-`(net: import("C:/NeatapticTS/src/architecture/network").default, set: import("C:/NeatapticTS/src/architecture/network/training/network.training.utils.types").TrainingSample[], batchSize: number, accumulationSteps: number, currentRate: number, momentum: number, regularization: import("C:/NeatapticTS/src/architecture/network/network.types").RegularizationConfig, costFunction: import("C:/NeatapticTS/src/architecture/network/network.types").CostFunction | import("C:/NeatapticTS/src/architecture/network/network.types").CostFunctionOrObject, optimizer: import("C:/NeatapticTS/src/architecture/network/network.types").OptimizerConfigBase | undefined) => number`
+`(net: import("src/architecture/network").default, set: import("src/architecture/network/training/network.training.utils.types").TrainingSample[], batchSize: number, accumulationSteps: number, currentRate: number, momentum: number, regularization: import("src/architecture/network/network.types").RegularizationConfig, costFunction: import("src/architecture/network/network.types").CostFunction | import("src/architecture/network/network.types").CostFunctionOrObject, optimizer: import("src/architecture/network/network.types").OptimizerConfigBase | undefined) => number`
 
 Execute one full pass over dataset (epoch) with optional accumulation & adaptive optimizer.
 Returns mean cost across processed samples.
@@ -2160,7 +2178,7 @@ Returns: Mean cost across the processed samples.
 
 ### ungate
 
-`(connection: import("C:/NeatapticTS/src/architecture/connection").default) => void`
+`(connection: import("src/architecture/connection").default) => void`
 
 Remove gating from a connection, restoring its static weight contribution.