@reicek/neataptic-ts 0.1.25 → 0.1.26

package/src/architecture/network/onnx/export/layers/README.md

@@ -64,89 +64,77 @@ const outputName = tryEmitConvLayer({
 
 ## architecture/network/onnx/export/layers/network.onnx.export-dense.utils.ts
 
-### emitDenseLayer
+### appendDenseBiasInitializer
 
 ```ts
-emitDenseLayer(
-  params: DenseLayerParams,
-): string
+appendDenseBiasInitializer(
+  layerContext: DenseLayerContext,
+  biasTensorName: string,
+  biasVector: number[],
+): void
 ```
 
-Emit the compact dense export path for a layer whose neurons all share the
-same activation.
-
-This is the cheapest ONNX shape the exporter can produce for a standard MLP
-layer: one Gemm node for the affine transform and one activation node for the
-whole layer. The same helper also preserves the library's legacy node-ordering
-compatibility mode when older snapshots need deterministic graph ordering.
+Append dense bias initializer.
 
 Parameters:
-- `params` - Dense emission parameters.
-
-Returns: Output tensor name.
-
-Example:
+- `layerContext` - Dense layer context.
+- `biasTensorName` - Bias tensor name.
+- `biasVector` - Bias vector values.
 
-```ts
-const outputName = emitDenseLayer({
-  model,
-  layerIndex: 2,
-  previousOutputName: 'Layer_1',
-  previousLayerNodes,
-  currentLayerNodes,
-  options: {},
-  legacyNodeOrdering: false,
-});
-```
+Returns: Nothing.
 
-### emitPerNeuronLayer
+### appendDenseNodes
 
 ```ts
-emitPerNeuronLayer(
-  params: PerNeuronLayerParams,
-): string
+appendDenseNodes(
+  model: OnnxModel,
+  orderedNodes: DenseOrderedNodePayload[],
+): void
 ```
 
-Emit the fallback dense-family representation for a layer whose target
-neurons use different activations.
-
-Instead of pretending the layer is homogeneous, this path exports one tiny
-Gemm-plus-activation subgraph per neuron and then concatenates the results.
-The graph is larger, but it preserves mixed activation behavior that a single
-layer-wide activation node cannot express.
+Append ordered dense nodes to the model graph.
 
 Parameters:
-- `params` - Per-neuron emission parameters.
+- `model` - Target model.
+- `orderedNodes` - Ordered dense nodes.
 
-Returns: Output tensor name.
+Returns: Nothing.
 
-Example:
+### appendDenseWeightInitializer
 
 ```ts
-const outputName = emitPerNeuronLayer({
-  model,
-  layerIndex: 2,
-  previousOutputName: 'Layer_1',
-  previousLayerNodes,
-  currentLayerNodes,
-  options: { allowMixedActivations: true },
-});
+appendDenseWeightInitializer(
+  layerContext: DenseLayerContext,
+  weightTensorName: string,
+  weightMatrixValues: number[],
+): void
 ```
 
-### emitDenseInitializers
+Append dense weight initializer.
+
+Parameters:
+- `layerContext` - Dense layer context.
+- `weightTensorName` - Weight tensor name.
+- `weightMatrixValues` - Weight values.
+
+Returns: Nothing.
+
+### buildSingleNeuronWeightRow
 
 ```ts
-emitDenseInitializers(
-  layerContext: DenseLayerContext,
-): DenseTensorNames
+buildSingleNeuronWeightRow(
+  targetNodeInternal: NodeInternals,
+  previousLayerNodes: default[],
+): number[]
 ```
 
-Emit dense initializers and return tensor names.
+Build one neuron's incoming weight row against previous layer.
 
 Parameters:
-- `layerContext` - Dense layer context.
+- `targetNodeInternal` - Target node internals.
+- `previousLayerNodes` - Previous layer nodes.
 
-Returns: Tensor names.
+Returns: Weight row values.
 
 ### collectDenseInitializerValues
 
@@ -163,6 +151,31 @@ Parameters:
 
 Returns: Dense initializer values.
 
+### createActivationNode
+
+```ts
+createActivationNode(
+  denseActivationContext: DenseActivationContext,
+): DenseActivationNodePayload
+```
+
+Create dense activation node definition.
+
+Parameters:
+- `denseActivationContext` - Dense activation context.
+
+Returns: ONNX activation node payload.
+
+### createDefaultGemmAttributes
+
+```ts
+createDefaultGemmAttributes(): { name: string; type: string; f?: number | undefined; i?: number | undefined; }[]
+```
+
+Build default Gemm attributes for ONNX export.
+
+Returns: Default Gemm attribute list.
+
 ### createDenseTensorNames
 
 ```ts
@@ -178,43 +191,50 @@ Parameters:
 
 Returns: Dense tensor names.
 
-### appendDenseWeightInitializer
+### createGemmNode
 
 ```ts
-appendDenseWeightInitializer(
-  layerContext: DenseLayerContext,
-  weightTensorName: string,
-  weightMatrixValues: number[],
-): void
+createGemmNode(
+  denseActivationContext: DenseActivationContext,
+): DenseGemmNodePayload
 ```
 
-Append dense weight initializer.
+Create dense Gemm node definition.
 
 Parameters:
-- `layerContext` - Dense layer context.
-- `weightTensorName` - Weight tensor name.
-- `weightMatrixValues` - Weight values.
+- `denseActivationContext` - Dense activation context.
 
-Returns: Nothing.
+Returns: ONNX Gemm node payload.
 
-### appendDenseBiasInitializer
+### createSharedActivationNodePayload
 
 ```ts
-appendDenseBiasInitializer(
-  layerContext: DenseLayerContext,
-  biasTensorName: string,
-  biasVector: number[],
-): void
+createSharedActivationNodePayload(
+  params: SharedActivationNodeBuildParams,
+): DenseActivationNodePayload
 ```
 
-Append dense bias initializer.
+Build a shared activation node payload.
 
 Parameters:
-- `layerContext` - Dense layer context.
-- `biasTensorName` - Bias tensor name.
-- `biasVector` - Bias vector values.
+- `params` - Shared activation build parameters.
 
-Returns: Nothing.
+Returns: Activation node payload.
+
+### createSharedGemmNodePayload
+
+```ts
+createSharedGemmNodePayload(
+  params: SharedGemmNodeBuildParams,
+): DenseGemmNodePayload
+```
+
+Build a shared Gemm node payload.
+
+Parameters:
+- `params` - Shared Gemm build parameters.
+
+Returns: Gemm node payload.
 
 ### emitDenseActivationSubgraph
 
@@ -233,71 +253,104 @@ Parameters:
 
 Returns: Nothing.
 
-### resolveDenseNodeOrder
+### emitDenseInitializers
 
 ```ts
-resolveDenseNodeOrder(
-  gemmNode: DenseGemmNodePayload,
-  activationNode: DenseActivationNodePayload,
-  legacyNodeOrdering: boolean,
-): DenseOrderedNodePayload[]
+emitDenseInitializers(
+  layerContext: DenseLayerContext,
+): DenseTensorNames
 ```
 
-Resolve dense node order for legacy and current exports.
+Emit dense initializers and return tensor names.
 
 Parameters:
-- `gemmNode` - Gemm node.
-- `activationNode` - Activation node.
-- `legacyNodeOrdering` - Whether legacy ordering is required.
+- `layerContext` - Dense layer context.
 
-Returns: Ordered node list.
+Returns: Tensor names.
 
-### appendDenseNodes
+### emitDenseLayer
 
 ```ts
-appendDenseNodes(
-  model: OnnxModel,
-  orderedNodes: DenseOrderedNodePayload[],
-): void
+emitDenseLayer(
+  params: DenseLayerParams,
+): string
 ```
 
-Append ordered dense nodes to the model graph.
+Emit the compact dense export path for a layer whose neurons all share the
+same activation.
+
+This is the cheapest ONNX shape the exporter can produce for a standard MLP
+layer: one Gemm node for the affine transform and one activation node for the
+whole layer. The same helper also preserves the library's legacy node-ordering
+compatibility mode when older snapshots need deterministic graph ordering.
 
 Parameters:
-- `model` - Target model.
-- `orderedNodes` - Ordered dense nodes.
+- `params` - Dense emission parameters.
 
-Returns: Nothing.
+Returns: Output tensor name.
 
-### createGemmNode
+Example:
 
 ```ts
-createGemmNode(
-  denseActivationContext: DenseActivationContext,
-): DenseGemmNodePayload
+const outputName = emitDenseLayer({
+  model,
+  layerIndex: 2,
+  previousOutputName: 'Layer_1',
+  previousLayerNodes,
+  currentLayerNodes,
+  options: {},
+  legacyNodeOrdering: false,
+});
 ```
 
-Create dense Gemm node definition.
+### emitOptionalLayerOutput
+
+```ts
+emitOptionalLayerOutput(
+  params: OptionalLayerOutputParams,
+): string
+```
+
+Emit optional pooling and flatten output fold.
 
 Parameters:
-- `denseActivationContext` - Dense activation context.
+- `params` - Optional output parameters.
 
-Returns: ONNX Gemm node payload.
+Returns: Output tensor name.
 
-### createActivationNode
+### emitPerNeuronLayer
 
 ```ts
-createActivationNode(
-  denseActivationContext: DenseActivationContext,
-): DenseActivationNodePayload
+emitPerNeuronLayer(
+  params: PerNeuronLayerParams,
+): string
 ```
 
-Create dense activation node definition.
+Emit the fallback dense-family representation for a layer whose target
+neurons use different activations.
+
+Instead of pretending the layer is homogeneous, this path exports one tiny
+Gemm-plus-activation subgraph per neuron and then concatenates the results.
+The graph is larger, but it preserves mixed activation behavior that a single
+layer-wide activation node cannot express.
 
 Parameters:
-- `denseActivationContext` - Dense activation context.
+- `params` - Per-neuron emission parameters.
 
-Returns: ONNX activation node payload.
+Returns: Output tensor name.
+
+Example:
+
+```ts
+const outputName = emitPerNeuronLayer({
+  model,
+  layerIndex: 2,
+  previousOutputName: 'Layer_1',
+  previousLayerNodes,
+  currentLayerNodes,
+  options: { allowMixedActivations: true },
+});
+```
 
 ### emitPerNeuronSubgraph
 
@@ -314,22 +367,24 @@ Parameters:
 
 Returns: Per-neuron activation output name.
 
-### buildSingleNeuronWeightRow
+### resolveDenseNodeOrder
 
 ```ts
-buildSingleNeuronWeightRow(
-  targetNodeInternal: NodeInternals,
-  previousLayerNodes: default[],
-): number[]
+resolveDenseNodeOrder(
+  gemmNode: DenseGemmNodePayload,
+  activationNode: DenseActivationNodePayload,
+  legacyNodeOrdering: boolean,
+): DenseOrderedNodePayload[]
 ```
 
-Build one neuron's incoming weight row against previous layer.
+Resolve dense node order for legacy and current exports.
 
 Parameters:
-- `targetNodeInternal` - Target node internals.
-- `previousLayerNodes` - Previous layer nodes.
+- `gemmNode` - Gemm node.
+- `activationNode` - Activation node.
+- `legacyNodeOrdering` - Whether legacy ordering is required.
 
-Returns: Weight row values.
+Returns: Ordered node list.
 
 ### resolveSingleNeuronInboundWeight
 
@@ -348,130 +403,55 @@ Parameters:
 
 Returns: Inbound weight or zero when missing.
 
-### createSharedGemmNodePayload
-
-```ts
-createSharedGemmNodePayload(
-  params: SharedGemmNodeBuildParams,
-): DenseGemmNodePayload
-```
-
-Build a shared Gemm node payload.
-
-Parameters:
-- `params` - Shared Gemm build parameters.
-
-Returns: Gemm node payload.
-
-### createSharedActivationNodePayload
-
-```ts
-createSharedActivationNodePayload(
-  params: SharedActivationNodeBuildParams,
-): DenseActivationNodePayload
-```
-
-Build a shared activation node payload.
-
-Parameters:
-- `params` - Shared activation build parameters.
-
-Returns: Activation node payload.
-
-### createDefaultGemmAttributes
-
-```ts
-createDefaultGemmAttributes(): { name: string; type: string; f?: number | undefined; i?: number | undefined; }[]
-```
-
-Build default Gemm attributes for ONNX export.
-
-Returns: Default Gemm attribute list.
-
-### emitOptionalLayerOutput
-
-```ts
-emitOptionalLayerOutput(
-  params: OptionalLayerOutputParams,
-): string
-```
-
-Emit optional pooling and flatten output fold.
-
-Parameters:
-- `params` - Optional output parameters.
-
-Returns: Output tensor name.
-
 ## architecture/network/onnx/export/layers/network.onnx.export-recurrent.utils.ts
 
-### emitRecurrentLayer
+### buildDefaultGemmAttributes
 
 ```ts
-emitRecurrentLayer(
-  params: RecurrentLayerEmissionParams,
-): string
+buildDefaultGemmAttributes(): { name: string; type: string; f?: number | undefined; i?: number | undefined; }[]
 ```
 
-Emit the constrained recurrent single-step export path for one hidden layer.
-
-This boundary models recurrence with two parallel Gemm branches:
-one for the feed-forward input and one for the previous hidden state. The
-recurrent branch uses a diagonal matrix derived from self-connections only,
-which keeps the exported shape simple and matches the importer's current
-reconstruction contract.
-
-Hidden-state inputs are named `hidden_prev` for the first recurrent layer and
-`hidden_prev_l{n}` for later recurrent layers. Mixed activations are not
-supported on this path because the single activation node is applied after
-the input and recurrent branches are summed.
-
-Parameters:
-- `params` - Recurrent emission parameters.
-
-Returns: Output tensor name.
-
-Example:
+Build the shared attribute list for ONNX Gemm node payloads.
 
-```ts
-const outputName = emitRecurrentLayer({
-  model,
-  layerIndex: 1,
-  previousOutputName: 'input',
-  previousLayerNodes,
-  currentLayerNodes,
-});
-```
+Returns: Gemm attribute payload list.
 
-### buildRecurrentLayerEmissionContext
+### buildInputBranchGemmEmissionContext
 
 ```ts
-buildRecurrentLayerEmissionContext(
-  params: RecurrentLayerEmissionParams,
-): RecurrentLayerEmissionContext
+buildInputBranchGemmEmissionContext(
+  context: RecurrentLayerEmissionContext,
+  initializerNames: RecurrentInitializerNames,
+  graphNames: RecurrentGraphNames,
+): RecurrentGemmEmissionContext
 ```
 
-Build derived recurrent-layer context from input params.
+Build Gemm emission context for the feed-forward branch.
 
 Parameters:
-- `params` - User-provided recurrent layer params.
+- `context` - Recurrent layer execution context.
+- `initializerNames` - Recurrent initializer names.
+- `graphNames` - Recurrent graph names.
 
-Returns: Derived context with cached dimensions and layer slot.
+Returns: Gemm emission context.
 
-### buildRecurrentInitializerNames
+### buildRecurrentBranchGemmEmissionContext
 
 ```ts
-buildRecurrentInitializerNames(
+buildRecurrentBranchGemmEmissionContext(
   context: RecurrentLayerEmissionContext,
-): RecurrentInitializerNames
+  initializerNames: RecurrentInitializerNames,
+  graphNames: RecurrentGraphNames,
+): RecurrentGemmEmissionContext
 ```
 
-Build deterministic tensor names for recurrent initializer emission.
+Build Gemm emission context for the recurrent hidden-state branch.
 
 Parameters:
 - `context` - Recurrent layer execution context.
+- `initializerNames` - Recurrent initializer names.
+- `graphNames` - Recurrent graph names.
 
-Returns: Tensor-name group for initializer emission.
+Returns: Gemm emission context.
 
 ### buildRecurrentGraphNames
 
@@ -488,88 +468,82 @@ Parameters:
 
 Returns: Graph-name group for branch and activation nodes.
 
-### collectRecurrentInitializerValues
+### buildRecurrentInitializerNames
 
 ```ts
-collectRecurrentInitializerValues(
+buildRecurrentInitializerNames(
   context: RecurrentLayerEmissionContext,
-): RecurrentInitializerValues
+): RecurrentInitializerNames
 ```
 
-Collect recurrent initializer vectors for one layer.
+Build deterministic tensor names for recurrent initializer emission.
 
 Parameters:
 - `context` - Recurrent layer execution context.
 
-Returns: Dense and recurrent initializer vectors.
+Returns: Tensor-name group for initializer emission.
 
-### emitRecurrentInitializers
+### buildRecurrentLayerEmissionContext
 
 ```ts
-emitRecurrentInitializers(
-  context: RecurrentInitializerEmissionContext,
-): void
+buildRecurrentLayerEmissionContext(
+  params: RecurrentLayerEmissionParams,
+): RecurrentLayerEmissionContext
 ```
 
-Emit dense and recurrent initializer tensors.
+Build derived recurrent-layer context from input params.
 
 Parameters:
-- `context` - Initializer emission context.
+- `params` - User-provided recurrent layer params.
 
-Returns: Nothing.
+Returns: Derived context with cached dimensions and layer slot.
 
-### buildInputBranchGemmEmissionContext
+### collectRecurrentInitializerValues
 
 ```ts
-buildInputBranchGemmEmissionContext(
+collectRecurrentInitializerValues(
   context: RecurrentLayerEmissionContext,
-  initializerNames: RecurrentInitializerNames,
-  graphNames: RecurrentGraphNames,
-): RecurrentGemmEmissionContext
+): RecurrentInitializerValues
 ```
 
-Build Gemm emission context for the feed-forward branch.
+Collect recurrent initializer vectors for one layer.
 
 Parameters:
 - `context` - Recurrent layer execution context.
-- `initializerNames` - Recurrent initializer names.
-- `graphNames` - Recurrent graph names.
 
-Returns: Gemm emission context.
+Returns: Dense and recurrent initializer vectors.
 
-### buildRecurrentBranchGemmEmissionContext
+### emitRecurrentActivationNode
 
 ```ts
-buildRecurrentBranchGemmEmissionContext(
-  context: RecurrentLayerEmissionContext,
-  initializerNames: RecurrentInitializerNames,
-  graphNames: RecurrentGraphNames,
-): RecurrentGemmEmissionContext
+emitRecurrentActivationNode(
+  context: RecurrentActivationEmissionContext,
+): void
 ```
 
-Build Gemm emission context for the recurrent hidden-state branch.
+Emit activation node for recurrent branch sum output.
 
 Parameters:
-- `context` - Recurrent layer execution context.
-- `initializerNames` - Recurrent initializer names.
-- `graphNames` - Recurrent graph names.
+- `context` - Activation emission context.
 
-Returns: Gemm emission context.
+Returns: Nothing.
 
-### resolvePreviousHiddenInputName
+### emitRecurrentAddNode
 
 ```ts
-resolvePreviousHiddenInputName(
-  layerIndex: number,
-): string
+emitRecurrentAddNode(
+  model: OnnxModel,
+  graphNames: RecurrentGraphNames,
+): void
 ```
 
-Resolve recurrent branch hidden-state input for one layer.
+Emit Add node that fuses feed-forward and recurrent branch outputs.
 
 Parameters:
-- `layerIndex` - Current recurrent layer index.
+- `model` - Target ONNX model.
+- `graphNames` - Deterministic graph names for this layer.
 
-Returns: Hidden-state tensor input name.
+Returns: Nothing.
 
 ### emitRecurrentGemmNode
 
@@ -586,53 +560,59 @@ Parameters:
 
 Returns: Nothing.
 
-### emitRecurrentAddNode
+### emitRecurrentInitializers
 
 ```ts
-emitRecurrentAddNode(
-  model: OnnxModel,
-  graphNames: RecurrentGraphNames,
+emitRecurrentInitializers(
+  context: RecurrentInitializerEmissionContext,
 ): void
 ```
 
-Emit Add node that fuses feed-forward and recurrent branch outputs.
+Emit dense and recurrent initializer tensors.
 
 Parameters:
-- `model` - Target ONNX model.
-- `graphNames` - Deterministic graph names for this layer.
+- `context` - Initializer emission context.
 
 Returns: Nothing.
 
-### emitRecurrentActivationNode
+### emitRecurrentLayer
 
 ```ts
-emitRecurrentActivationNode(
-  context: RecurrentActivationEmissionContext,
-): void
+emitRecurrentLayer(
+  params: RecurrentLayerEmissionParams,
+): string
 ```
 
-Emit activation node for recurrent branch sum output.
+Emit the constrained recurrent single-step export path for one hidden layer.
+
+This boundary models recurrence with two parallel Gemm branches:
+one for the feed-forward input and one for the previous hidden state. The
+recurrent branch uses a diagonal matrix derived from self-connections only,
+which keeps the exported shape simple and matches the importer's current
+reconstruction contract.
+
+Hidden-state inputs are named `hidden_prev` for the first recurrent layer and
+`hidden_prev_l{n}` for later recurrent layers. Mixed activations are not
+supported on this path because the single activation node is applied after
+the input and recurrent branches are summed.
 
 Parameters:
-- `context` - Activation emission context.
+- `params` - Recurrent emission parameters.
 
-Returns: Nothing.
+Returns: Output tensor name.
 
-### resolveRecurrentActivationType
+Example:
 
 ```ts
-resolveRecurrentActivationType(
-  currentLayerNodes: default[],
-): string
+const outputName = emitRecurrentLayer({
+  model,
+  layerIndex: 1,
+  previousOutputName: 'input',
+  previousLayerNodes,
+  currentLayerNodes,
+});
 ```
 
-Resolve ONNX activation type from first node in recurrent layer.
-
-Parameters:
-- `currentLayerNodes` - Current recurrent layer nodes.
-
-Returns: ONNX activation op type.
-
 ### readNodeInternals
 
 ```ts
@@ -648,15 +628,35 @@ Parameters:
 
 Returns: Node internals used by ONNX emission helpers.
 
-### buildDefaultGemmAttributes
+### resolvePreviousHiddenInputName
 
 ```ts
-buildDefaultGemmAttributes(): { name: string; type: string; f?: number | undefined; i?: number | undefined; }[]
+resolvePreviousHiddenInputName(
+  layerIndex: number,
+): string
 ```
 
-Build the shared attribute list for ONNX Gemm node payloads.
+Resolve recurrent branch hidden-state input for one layer.
 
-Returns: Gemm attribute payload list.
+Parameters:
+- `layerIndex` - Current recurrent layer index.
+
+Returns: Hidden-state tensor input name.
+
+### resolveRecurrentActivationType
+
+```ts
+resolveRecurrentActivationType(
+  currentLayerNodes: default[],
+): string
+```
+
+Resolve ONNX activation type from first node in recurrent layer.
+
+Parameters:
+- `currentLayerNodes` - Current recurrent layer nodes.
+
+Returns: ONNX activation op type.
 
 ## architecture/network/onnx/export/layers/network.onnx.export-layer-graph.utils.ts
 
@@ -706,6 +706,74 @@ const outputName = emitLayerGraph({
 
 ## architecture/network/onnx/export/layers/network.onnx.export-layer-common.utils.ts
 
+### appendIndexedMetadata
+
+```ts
+appendIndexedMetadata(
+  model: OnnxModel,
+  key: string,
+  layerIndex: number,
+): void
+```
+
+Append an integer index to JSON-array metadata key.
+
+Parameters:
+- `model` - Target model.
+- `key` - Metadata key.
+- `layerIndex` - Layer index to append.
+
+Returns: Nothing.
+
+### appendMetadataSpec
+
+```ts
+appendMetadataSpec(
+  model: OnnxModel,
+  key: string,
+  spec: Conv2DMapping | Pool2DMapping,
+): void
+```
+
+Append a JSON object to JSON-array metadata key.
+
+Parameters:
+- `model` - Target model.
+- `key` - Metadata key.
+- `spec` - Metadata object.
+
+Returns: Nothing.
+
+### appendPoolingMetadata
+
+```ts
+appendPoolingMetadata(
+  context: PoolingEmissionContext,
+): void
+```
+
+Append pooling metadata for one emitted pooling layer.
+
+Parameters:
+- `context` - Pooling emission context.
+
+Returns: Nothing.
+
+### asNodeInternals
+
+```ts
+asNodeInternals(
+  node: default,
+): NodeInternals
+```
+
+Normalize a public node instance into ONNX export internals.
+
+Parameters:
+- `node` - Source node.
+
+Returns: Internal runtime-facing node representation.
+
 ### buildDenseWeightsAndBiases
 
 ```ts
@@ -753,58 +821,39 @@ Parameters:
 
 Returns: Flattened row-major recurrent matrix.
 
-### emitOptionalPoolingAndFlatten
-
-```ts
-emitOptionalPoolingAndFlatten(
-  params: OptionalPoolingAndFlattenParams,
-): string
-```
-
-Emit optional pooling and flatten nodes after a layer output.
-
-Parameters:
-- `params` - Pooling parameters.
-
-Returns: Final output tensor name after optional pooling/flatten.
-
-### appendIndexedMetadata
+### buildIndexedMetadataProperty
 
 ```ts
-appendIndexedMetadata(
-  model: OnnxModel,
+buildIndexedMetadataProperty(
   key: string,
   layerIndex: number,
-): void
+): OnnxMetadataProperty
 ```
 
-Append an integer index to JSON-array metadata key.
+Build a new index-array metadata property.
 
 Parameters:
-- `model` - Target model.
 - `key` - Metadata key.
-- `layerIndex` - Layer index to append.
+- `layerIndex` - Layer index.
 
-Returns: Nothing.
+Returns: Metadata property.
 
-### appendMetadataSpec
+### buildSpecMetadataProperty
 
 ```ts
-appendMetadataSpec(
-  model: OnnxModel,
+buildSpecMetadataProperty(
   key: string,
   spec: Conv2DMapping | Pool2DMapping,
-): void
+): OnnxMetadataProperty
 ```
 
-Append a JSON object to JSON-array metadata key.
+Build a new spec-array metadata property.
 
 Parameters:
-- `model` - Target model.
 - `key` - Metadata key.
-- `spec` - Metadata object.
+- `spec` - Mapping spec.
 
-Returns: Nothing.
+Returns: Metadata property.
 
 ### collectDenseRows
 
@@ -821,21 +870,6 @@ Parameters:
 
 Returns: Dense rows containing per-target weights and bias.
 
-### foldDenseRowsToInitializers
-
-```ts
-foldDenseRowsToInitializers(
-  denseRows: DenseWeightRow[],
-): DenseWeightBuildResult
-```
-
-Fold dense rows into flattened ONNX initializer arrays.
-
-Parameters:
-- `denseRows` - Dense rows.
-
-Returns: Flattened dense initializer result.
-
 ### collectDenseRowWeights
 
 ```ts
@@ -851,37 +885,35 @@ Parameters:
 
 Returns: Row weights in source-node order.
 
-### resolveInboundWeight
+### collectPoolingAttributes
 
 ```ts
-resolveInboundWeight(
-  targetNodeInternal: NodeInternals,
-  sourceNode: default,
-): number
+collectPoolingAttributes(
+  poolSpec: Pool2DMapping,
+): PoolingAttributes
 ```
 
-Resolve source-to-target inbound connection weight.
+Collect ONNX pooling attributes from one pooling spec.
 
 Parameters:
-- `targetNodeInternal` - Target node internals.
-- `sourceNode` - Source node.
+- `poolSpec` - Pooling spec.
 
-Returns: Inbound weight or zero for disconnected edges.
+Returns: Pooling attributes for ONNX node payload.
 
-### asNodeInternals
+### collectRecurrentRow
 
 ```ts
-asNodeInternals(
-  node: default,
-): NodeInternals
+collectRecurrentRow(
+  context: RecurrentRowCollectionContext,
+): number[]
 ```
 
-Normalize a public node instance into ONNX export internals.
+Collect one recurrent matrix row.
 
 Parameters:
-- `node` - Source node.
+- `context` - Row collection context.
 
-Returns: Internal runtime-facing node representation.
+Returns: Recurrent row values.
 
 ### collectRecurrentRows
 
@@ -898,52 +930,35 @@ Parameters:
 
 Returns: Recurrent row collection.
 
-### collectRecurrentRow
-
-```ts
-collectRecurrentRow(
-  context: RecurrentRowCollectionContext,
-): number[]
-```
-
-Collect one recurrent matrix row.
-
-Parameters:
-- `context` - Row collection context.
-
-Returns: Recurrent row values.
-
-### resolveDiagonalRecurrentWeight
+### emitOptionalFlattenAfterPooling
 
 ```ts
-resolveDiagonalRecurrentWeight(
-  context: RecurrentRowCollectionContext,
-  columnIndex: number,
-): number
+emitOptionalFlattenAfterPooling(
+  context: FlattenAfterPoolingContext,
+): string
 ```
 
-Resolve recurrent weight value for one matrix coordinate.
+Conditionally emit flatten node after pooling.
 
 Parameters:
-- `context` - Row collection context.
-- `columnIndex` - Column index in row.
+- `context` - Flatten emission context.
 
-Returns: Recurrent weight for diagonal entries, otherwise zero.
+Returns: Output tensor name after optional flatten.
 
-### toPoolingEmissionContext
+### emitOptionalPoolingAndFlatten
 
 ```ts
-toPoolingEmissionContext(
+emitOptionalPoolingAndFlatten(
   params: OptionalPoolingAndFlattenParams,
-): PoolingEmissionContext
+): string
 ```
 
-Resolve pooling emission context from optional pooling parameters.
+Emit optional pooling and flatten nodes after a layer output.
 
 Parameters:
-- `params` - Optional pooling and flatten parameters.
+- `params` - Pooling parameters.
 
-Returns: Pooling emission context.
+Returns: Final output tensor name after optional pooling/flatten.
 
 ### emitPoolingNode
 
@@ -960,51 +975,6 @@ Parameters:
 
 Returns: Pooling output tensor name.
 
-### collectPoolingAttributes
-
-```ts
-collectPoolingAttributes(
-  poolSpec: Pool2DMapping,
-): PoolingAttributes
-```
-
-Collect ONNX pooling attributes from one pooling spec.
-
-Parameters:
-- `poolSpec` - Pooling spec.
-
-Returns: Pooling attributes for ONNX node payload.
-
-### emitOptionalFlattenAfterPooling
-
-```ts
-emitOptionalFlattenAfterPooling(
-  context: FlattenAfterPoolingContext,
-): string
-```
-
-Conditionally emit flatten node after pooling.
-
-Parameters:
-- `context` - Flatten emission context.
-
-Returns: Output tensor name after optional flatten.
-
-### appendPoolingMetadata
-
-```ts
-appendPoolingMetadata(
-  context: PoolingEmissionContext,
-): void
-```
-
-Append pooling metadata for one emitted pooling layer.
-
-Parameters:
-- `context` - Pooling emission context.
-
-Returns: Nothing.
-
 ### ensureMetadataRegistry
 
 ```ts
@@ -1037,39 +1007,69 @@ Parameters:
 
 Returns: Matching metadata property if present.
 
-### buildIndexedMetadataProperty
+### foldDenseRowsToInitializers
 
 ```ts
-buildIndexedMetadataProperty(
-  key: string,
-  layerIndex: number,
-): OnnxMetadataProperty
+foldDenseRowsToInitializers(
+  denseRows: DenseWeightRow[],
+): DenseWeightBuildResult
 ```
 
-Build a new index-array metadata property.
+Fold dense rows into flattened ONNX initializer arrays.
 
 Parameters:
-- `key` - Metadata key.
-- `layerIndex` - Layer index.
+- `denseRows` - Dense rows.
 
-Returns: Metadata property.
+Returns: Flattened dense initializer result.
 
-### buildSpecMetadataProperty
+### parseMetadataArray
 
 ```ts
-buildSpecMetadataProperty(
-  key: string,
-  spec: Conv2DMapping | Pool2DMapping,
-): OnnxMetadataProperty
+parseMetadataArray(
+  metadataValue: string,
+): ItemType[] | undefined
 ```
 
-Build a new spec-array metadata property.
+Parse a metadata JSON array value safely.
 
 Parameters:
-- `key` - Metadata key.
-- `spec` - Mapping spec.
+- `metadataValue` - Metadata JSON string.
 
-Returns: Metadata property.
+Returns: Parsed array when valid, otherwise undefined.
+
+### resolveDiagonalRecurrentWeight
+
+```ts
+resolveDiagonalRecurrentWeight(
+  context: RecurrentRowCollectionContext,
+  columnIndex: number,
+): number
+```
+
+Resolve recurrent weight value for one matrix coordinate.
+
+Parameters:
+- `context` - Row collection context.
+- `columnIndex` - Column index in row.
+
+Returns: Recurrent weight for diagonal entries, otherwise zero.
+
+### resolveInboundWeight
+
+```ts
+resolveInboundWeight(
+  targetNodeInternal: NodeInternals,
+  sourceNode: default,
+): number
+```
+
+Resolve source-to-target inbound connection weight.
+
+Parameters:
+- `targetNodeInternal` - Target node internals.
+- `sourceNode` - Source node.
+
+Returns: Inbound weight or zero for disconnected edges.
 
 ### serializeIndexedMetadataValue
 
@@ -1105,17 +1105,17 @@ Parameters:
 
 Returns: Serialized JSON value.
 
-### parseMetadataArray
+### toPoolingEmissionContext
 
 ```ts
-parseMetadataArray(
-  metadataValue: string,
-): ItemType[] | undefined
+toPoolingEmissionContext(
+  params: OptionalPoolingAndFlattenParams,
+): PoolingEmissionContext
 ```
 
-Parse a metadata JSON array value safely.
+Resolve pooling emission context from optional pooling parameters.
 
 Parameters:
-- `metadataValue` - Metadata JSON string.
+- `params` - Optional pooling and flatten parameters.
 
-Returns: Parsed array when valid, otherwise undefined.
+Returns: Pooling emission context.