@reicek/neataptic-ts 0.1.25 → 0.1.26

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

@@ -4,59 +4,61 @@ Output node discriminator used for standalone precondition checks.
 
 ## architecture/network/standalone/network.standalone.utils.types.ts
 
-### OUTPUT_NODE_TYPE
+### ACTIVATION_PRECISION_F32
 
-Output node discriminator used for standalone precondition checks.
+Precision token selecting Float32 activation/state buffers.
 
-### SINGLE_TERM_FALLBACK
+### ARROW_TOKEN
 
-Fallback literal used when a node has no incoming terms.
+Arrow token used during function-source normalization.
 
-### MASK_MULTIPLIER_IDENTITY
+### BUILTIN_ACTIVATION_SNIPPETS
 
-Multiplicative identity used to omit redundant mask expressions.
+Built-in activation snippets emitted as named JavaScript function declarations.
 
-### INPUT_LOOP_LINE
+Values are intentionally compact so emitted standalone source remains deterministic and small.
 
-Generated source line for copying external inputs into activation buffer.
+### COVERAGE_CALL_REGEX
 
-### ACTIVATION_PRECISION_F32
+Regex stripping Istanbul function invocations from source snippets.
 
-Precision token selecting Float32 activation/state buffers.
+### COVERAGE_COUNTER_REGEX
 
-### FLOAT32_ARRAY_TYPE
+Regex stripping Istanbul counters from stringified functions.
 
-Typed-array constructor names used in generated source.
+### COVERAGE_REPLACEMENT
 
-### FLOAT64_ARRAY_TYPE
+Empty replacement used while stripping coverage artifacts.
 
-Typed-array constructor names used in generated source.
+### EMPTY_TOKEN_REGEX
 
-### FUNCTION_PREFIX
+Regex removing empty punctuation-only token lines.
 
-Prefix token used when normalizing function sources.
+### FALLBACK_IDENTITY_BODY
 
-### ARROW_TOKEN
+Identity-function fallback body for invalid custom squash sources.
 
-Arrow token used during function-source normalization.
+### FLOAT32_ARRAY_TYPE
 
-### FALLBACK_IDENTITY_BODY
+Typed-array constructor names used in generated source.
 
-Identity-function fallback body for invalid custom squash sources.
+### FLOAT64_ARRAY_TYPE
 
-### COVERAGE_REPLACEMENT
+Typed-array constructor names used in generated source.
 
-Empty replacement used while stripping coverage artifacts.
+### FUNCTION_PREFIX
 
-### NO_OUTPUT_NODES_ERROR
+Prefix token used when normalizing function sources.
 
-Error message when attempting standalone generation without outputs.
+### INPUT_LOOP_LINE
 
-### INVALID_INPUT_SIZE_ERROR_PREFIX
+Generated source line for copying external inputs into activation buffer.
+
+### INVALID_INPUT_SIZE_ERROR_MIDDLE
 
 Input-size validation message fragments for generated activate guards.
 
-### INVALID_INPUT_SIZE_ERROR_MIDDLE
+### INVALID_INPUT_SIZE_ERROR_PREFIX
 
 Input-size validation message fragments for generated activate guards.
 
@@ -64,43 +66,33 @@ Input-size validation message fragments for generated activate guards.
 
 Regex stripping Istanbul ignore blocks from stringified functions.
 
-### COVERAGE_COUNTER_REGEX
+### MASK_MULTIPLIER_IDENTITY
 
-Regex stripping Istanbul counters from stringified functions.
+Multiplicative identity used to omit redundant mask expressions.
 
-### COVERAGE_CALL_REGEX
+### NO_OUTPUT_NODES_ERROR
 
-Regex stripping Istanbul function invocations from source snippets.
+Error message when attempting standalone generation without outputs.
 
-### SOURCE_MAP_REGEX
+### OUTPUT_NODE_TYPE
 
-Regex stripping sourceMappingURL comments from generated snippets.
+Output node discriminator used for standalone precondition checks.
 
-### STRAY_COMMA_OPEN_REGEX
+### REPEATED_SEMICOLON_REGEX
 
-Regex normalizing stray commas near opening parentheses.
+Regex collapsing repeated semicolons.
 
-### STRAY_COMMA_CLOSE_REGEX
+### SINGLE_TERM_FALLBACK
 
-Regex normalizing stray commas near closing parentheses.
+Fallback literal used when a node has no incoming terms.
 
 ### SOLITARY_SEMICOLON_REGEX
 
 Regex removing solitary semicolon lines created by instrumentation.
 
-### REPEATED_SEMICOLON_REGEX
-
-Regex collapsing repeated semicolons.
-
-### EMPTY_TOKEN_REGEX
-
-Regex removing empty punctuation-only token lines.
-
-### BUILTIN_ACTIVATION_SNIPPETS
-
-Built-in activation snippets emitted as named JavaScript function declarations.
+### SOURCE_MAP_REGEX
 
-Values are intentionally compact so emitted standalone source remains deterministic and small.
+Regex stripping sourceMappingURL comments from generated snippets.
 
 ### StandaloneSquashFunction
 
@@ -113,6 +105,14 @@ StandaloneSquashFunction(
 
 Activation function shape used by standalone source generation helpers.
 
+### STRAY_COMMA_CLOSE_REGEX
+
+Regex normalizing stray commas near closing parentheses.
+
+### STRAY_COMMA_OPEN_REGEX
+
+Regex normalizing stray commas near opening parentheses.
+
 ## architecture/network/standalone/network.standalone.utils.ts
 
 Standalone forward pass code generator.
@@ -169,18 +169,24 @@ Returns: Source string (ES5-compatible) – safe to eval in sandbox to obtain ac
 
 ## architecture/network/standalone/network.standalone.utils.loop.ts
 
-### appendInputSeedLine
+### appendActivationLine
 
 ```ts
-appendInputSeedLine(
+appendActivationLine(
   generationContext: StandaloneGenerationContext,
+  nodeTraversalIndex: number,
+  activationFunctionIndex: number,
+  maskValue: number,
 ): void
 ```
 
-Append the generated input-copy loop to the standalone body.
+Append generated activation assignment line for one node.
 
 Parameters:
 - `generationContext` - Mutable generation context.
+- `nodeTraversalIndex` - Node index.
+- `activationFunctionIndex` - Function table index.
+- `maskValue` - Multiplicative mask.
 
 Returns: Void.
 
@@ -199,6 +205,21 @@ Parameters:
 
 Returns: Void.
 
+### appendInputSeedLine
+
+```ts
+appendInputSeedLine(
+  generationContext: StandaloneGenerationContext,
+): void
+```
+
+Append the generated input-copy loop to the standalone body.
+
+Parameters:
+- `generationContext` - Mutable generation context.
+
+Returns: Void.
+
 ### appendOutputReturnLine
 
 ```ts
@@ -254,43 +275,39 @@ Parameters:
 
 Returns: Void.
 
-### appendActivationLine
+### buildMaskSuffix
 
 ```ts
-appendActivationLine(
-  generationContext: StandaloneGenerationContext,
-  nodeTraversalIndex: number,
-  activationFunctionIndex: number,
+buildMaskSuffix(
   maskValue: number,
-): void
+): string
 ```
 
-Append generated activation assignment line for one node.
+Build optional activation mask suffix for generated assignment line.
 
 Parameters:
-- `generationContext` - Mutable generation context.
-- `nodeTraversalIndex` - Node index.
-- `activationFunctionIndex` - Function table index.
-- `maskValue` - Multiplicative mask.
+- `maskValue` - Multiplicative mask value.
 
-Returns: Void.
+Returns: Empty suffix for identity, otherwise multiplicative fragment.
 
-### buildMaskSuffix
+## architecture/network/standalone/network.standalone.utils.graph.ts
+
+### appendGateMultiplier
 
 ```ts
-buildMaskSuffix(
-  maskValue: number,
+appendGateMultiplier(
+  connectionTerm: string,
+  gateNode: default | null,
 ): string
 ```
 
-Build optional activation mask suffix for generated assignment line.
+Append a gate activation multiplier to a connection term when a gate exists.
 
 Parameters:
-- `maskValue` - Multiplicative mask value.
-
-Returns: Empty suffix for identity, otherwise multiplicative fragment.
+- `connectionTerm` - Base connection term.
+- `gateNode` - Optional gate node.
 
-## architecture/network/standalone/network.standalone.utils.graph.ts
+Returns: Term with optional gate multiplier.
 
 ### buildNodeSumExpression
 
@@ -309,84 +326,82 @@ Parameters:
 
 Returns: String expression used for generated `S[index]` assignment.
 
-### collectOutputIndexes
+### collectIncomingTerms
 
 ```ts
-collectOutputIndexes(
-  generationContext: StandaloneGenerationContext,
-): number[]
+collectIncomingTerms(
+  currentNode: default,
+): string[]
 ```
 
-Collect output node indexes from the output tail segment.
+Collect feed-forward inbound connection terms for a node.
 
 Parameters:
-- `generationContext` - Mutable generation context.
+- `currentNode` - Current node.
 
-Returns: Output indexes used for result array emission.
+Returns: Weighted term expressions.
 
-### formatOutputArrayValues
+### collectOutputIndexes
 
 ```ts
-formatOutputArrayValues(
-  outputIndexes: number[],
-): string
+collectOutputIndexes(
+  generationContext: StandaloneGenerationContext,
+): number[]
 ```
 
-Format output activation selectors for generated return expression.
+Collect output node indexes from the output tail segment.
 
 Parameters:
-- `outputIndexes` - Output node indexes.
+- `generationContext` - Mutable generation context.
 
-Returns: Comma-separated `A[index]` selector list.
+Returns: Output indexes used for result array emission.
 
-### collectIncomingTerms
+### collectSelfConnectionTerms
 
 ```ts
-collectIncomingTerms(
+collectSelfConnectionTerms(
   currentNode: default,
+  nodeTraversalIndex: number,
 ): string[]
 ```
 
-Collect feed-forward inbound connection terms for a node.
+Collect recurrent self-connection term for a node when present.
 
 Parameters:
 - `currentNode` - Current node.
+- `nodeTraversalIndex` - Node index used for self-state reference.
 
-Returns: Weighted term expressions.
+Returns: Zero or one recurrent term expressions.
 
-### collectSelfConnectionTerms
+### foldTermsIntoExpression
 
 ```ts
-collectSelfConnectionTerms(
-  currentNode: default,
-  nodeTraversalIndex: number,
-): string[]
+foldTermsIntoExpression(
+  allTerms: string[],
+): string
 ```
 
-Collect recurrent self-connection term for a node when present.
+Fold a term collection into a summation expression.
 
 Parameters:
-- `currentNode` - Current node.
-- `nodeTraversalIndex` - Node index used for self-state reference.
+- `allTerms` - Term collection.
 
-Returns: Zero or one recurrent term expressions.
+Returns: Summation expression or fallback zero literal.
 
-### appendGateMultiplier
+### formatOutputArrayValues
 
 ```ts
-appendGateMultiplier(
-  connectionTerm: string,
-  gateNode: default | null,
+formatOutputArrayValues(
+  outputIndexes: number[],
 ): string
 ```
 
-Append a gate activation multiplier to a connection term when a gate exists.
+Format output activation selectors for generated return expression.
 
 Parameters:
-- `connectionTerm` - Base connection term.
-- `gateNode` - Optional gate node.
+- `outputIndexes` - Output node indexes.
 
-Returns: Term with optional gate multiplier.
+Returns: Comma-separated `A[index]` selector list.
 
 ### getOptionalNodeIndex
 
@@ -420,21 +435,6 @@ Parameters:
 
 Returns: Combined term collection.
 
-### foldTermsIntoExpression
-
-```ts
-foldTermsIntoExpression(
-  allTerms: string[],
-): string
-```
-
-Fold a term collection into a summation expression.
-
-Parameters:
-- `allTerms` - Term collection.
-
-Returns: Summation expression or fallback zero literal.
-
 ## architecture/network/standalone/network.standalone.utils.setup.ts
 
 ### asStandaloneProps
@@ -452,35 +452,35 @@ Parameters:
 
 Returns: Internal network properties used by the standalone generator.
 
-### ensureOutputNodesExist
+### createGenerationContext
 
 ```ts
-ensureOutputNodesExist(
+createGenerationContext(
   standaloneProps: NetworkStandaloneProps,
-): void
+): StandaloneGenerationContext
 ```
 
-Validate that the network has at least one output node.
+Create a fresh generation context used across orchestration steps.
 
 Parameters:
 - `standaloneProps` - Internal standalone network view.
 
-Returns: Void.
+Returns: Initialized generation context.
 
-### createGenerationContext
+### ensureOutputNodesExist
 
 ```ts
-createGenerationContext(
+ensureOutputNodesExist(
   standaloneProps: NetworkStandaloneProps,
-): StandaloneGenerationContext
+): void
 ```
 
-Create a fresh generation context used across orchestration steps.
+Validate that the network has at least one output node.
 
 Parameters:
 - `standaloneProps` - Internal standalone network view.
 
-Returns: Initialized generation context.
+Returns: Void.
 
 ### seedNodeIndexesAndState
 
@@ -546,54 +546,54 @@ Parameters:
 
 Returns: Comma-separated activation function names.
 
-### resolveActivationArrayType
+### buildInputGuardLine
 
 ```ts
-resolveActivationArrayType(
-  generationContext: StandaloneGenerationContext,
+buildInputGuardLine(
+  expectedInputSize: number,
 ): string
 ```
 
-Resolve typed-array constructor name based on configured activation precision.
+Build generated input length guard line.
 
 Parameters:
-- `generationContext` - Mutable generation context.
+- `expectedInputSize` - Required input vector size.
 
-Returns: Constructor name used in generated source.
+Returns: Guard statement line including trailing newline.
 
-### buildInputGuardLine
+### resolveActivationArrayType
 
 ```ts
-buildInputGuardLine(
-  expectedInputSize: number,
+resolveActivationArrayType(
+  generationContext: StandaloneGenerationContext,
 ): string
 ```
 
-Build generated input length guard line.
+Resolve typed-array constructor name based on configured activation precision.
 
 Parameters:
-- `expectedInputSize` - Required input vector size.
+- `generationContext` - Mutable generation context.
 
-Returns: Guard statement line including trailing newline.
+Returns: Constructor name used in generated source.
 
 ## architecture/network/standalone/network.standalone.utils.activation.ts
 
-### resolveSquashName
+### convertArrowToNamedFunction
 
 ```ts
-resolveSquashName(
-  currentNode: default,
-  nodeTraversalIndex: number,
+convertArrowToNamedFunction(
+  sourceCode: string,
+  squashName: string,
 ): string
 ```
 
-Resolve a stable activation function name for emission.
+Convert an arrow-function source string into a named function declaration source.
 
 Parameters:
-- `currentNode` - Current node.
-- `nodeTraversalIndex` - Node index for anonymous-name fallback.
+- `sourceCode` - Arrow-function source.
+- `squashName` - Required function name.
 
-Returns: Activation function identifier.
+Returns: Named function source.
 
 ### ensureActivationFunctionIndex
 
@@ -616,140 +616,140 @@ Parameters:
 
 Returns: Activation function index within generated `F` array.
 
-### resolveActivationFunctionSource
+### ensureNamedFunctionSource
 
 ```ts
-resolveActivationFunctionSource(
+ensureNamedFunctionSource(
+  sourceCode: string,
   squashName: string,
-  squashFunction: StandaloneSquashFunction,
-  nodeTraversalIndex: number,
 ): string
 ```
 
-Resolve emitted source for built-in or custom activation functions.
+Ensure generated function source starts with the required named signature.
 
 Parameters:
-- `squashName` - Activation function name.
-- `squashFunction` - Activation function implementation.
-- `nodeTraversalIndex` - Current node index for fallback flow.
+- `sourceCode` - Function source.
+- `squashName` - Required function name.
 
-Returns: Named function source string.
+Returns: Named function source.
 
-### normalizeBuiltinSource
+### normalizeArrowBody
 
 ```ts
-normalizeBuiltinSource(
-  sourceCode: string,
-  squashName: string,
+normalizeArrowBody(
+  bodySegment: string,
 ): string
 ```
 
-Normalize built-in activation source to a named function and strip coverage artifacts.
+Normalize arrow body into a function-body block.
 
 Parameters:
-- `sourceCode` - Built-in function source.
-- `squashName` - Required function name.
+- `bodySegment` - Raw arrow body segment.
 
-Returns: Cleaned named function source.
+Returns: Function body block string.
 
-### normalizeCustomSource
+### normalizeArrowParameters
 
 ```ts
-normalizeCustomSource(
-  sourceCode: string,
-  squashName: string,
-  nodeTraversalIndex: number,
+normalizeArrowParameters(
+  parameterSegment: string,
 ): string
 ```
 
-Normalize custom activation source with function/arrow/fallback handling.
+Normalize arrow parameter segment into comma-separated parameter list content.
 
 Parameters:
-- `sourceCode` - Custom function source.
-- `squashName` - Required function name.
-- `nodeTraversalIndex` - Current node index for traversal-context parity.
+- `parameterSegment` - Raw arrow parameter segment.
 
-Returns: Cleaned named function source.
+Returns: Parameter list body (without surrounding parentheses).
 
-### ensureNamedFunctionSource
+### normalizeBuiltinSource
 
 ```ts
-ensureNamedFunctionSource(
+normalizeBuiltinSource(
   sourceCode: string,
   squashName: string,
 ): string
 ```
 
-Ensure generated function source starts with the required named signature.
+Normalize built-in activation source to a named function and strip coverage artifacts.
 
 Parameters:
-- `sourceCode` - Function source.
+- `sourceCode` - Built-in function source.
 - `squashName` - Required function name.
 
-Returns: Named function source.
+Returns: Cleaned named function source.
 
-### convertArrowToNamedFunction
+### normalizeCustomSource
 
 ```ts
-convertArrowToNamedFunction(
+normalizeCustomSource(
   sourceCode: string,
   squashName: string,
+  nodeTraversalIndex: number,
 ): string
 ```
 
-Convert an arrow-function source string into a named function declaration source.
+Normalize custom activation source with function/arrow/fallback handling.
 
 Parameters:
-- `sourceCode` - Arrow-function source.
+- `sourceCode` - Custom function source.
 - `squashName` - Required function name.
+- `nodeTraversalIndex` - Current node index for traversal-context parity.
 
-Returns: Named function source.
+Returns: Cleaned named function source.
 
-### normalizeArrowParameters
+### registerActivationFunction
 
 ```ts
-normalizeArrowParameters(
-  parameterSegment: string,
-): string
+registerActivationFunction(
+  generationContext: StandaloneGenerationContext,
+  squashName: string,
+  functionSource: string,
+): void
 ```
 
-Normalize arrow parameter segment into comma-separated parameter list content.
+Register a function source and allocate its numeric index.
 
 Parameters:
-- `parameterSegment` - Raw arrow parameter segment.
+- `generationContext` - Mutable generation context.
+- `squashName` - Activation function name.
+- `functionSource` - Named function source to store.
 
-Returns: Parameter list body (without surrounding parentheses).
+Returns: Void.
 
-### normalizeArrowBody
+### resolveActivationFunctionSource
 
 ```ts
-normalizeArrowBody(
-  bodySegment: string,
+resolveActivationFunctionSource(
+  squashName: string,
+  squashFunction: StandaloneSquashFunction,
+  nodeTraversalIndex: number,
 ): string
 ```
 
-Normalize arrow body into a function-body block.
+Resolve emitted source for built-in or custom activation functions.
 
 Parameters:
-- `bodySegment` - Raw arrow body segment.
+- `squashName` - Activation function name.
+- `squashFunction` - Activation function implementation.
+- `nodeTraversalIndex` - Current node index for fallback flow.
 
-Returns: Function body block string.
+Returns: Named function source string.
 
-### registerActivationFunction
+### resolveSquashName
 
 ```ts
-registerActivationFunction(
-  generationContext: StandaloneGenerationContext,
-  squashName: string,
-  functionSource: string,
-): void
+resolveSquashName(
+  currentNode: default,
+  nodeTraversalIndex: number,
+): string
 ```
 
-Register a function source and allocate its numeric index.
+Resolve a stable activation function name for emission.
 
 Parameters:
-- `generationContext` - Mutable generation context.
-- `squashName` - Activation function name.
-- `functionSource` - Named function source to store.
+- `currentNode` - Current node.
+- `nodeTraversalIndex` - Node index for anonymous-name fallback.
 
-Returns: Void.
+Returns: Activation function identifier.