super-three 0.173.5 → 0.176.0

package/src/nodes/accessors/VertexColorNode.js

@@ -2,12 +2,10 @@ import AttributeNode from '../core/AttributeNode.js';
 import { nodeObject } from '../tsl/TSLBase.js';
 import { Vector4 } from '../../math/Vector4.js';
 
-/** @module VertexColorNode **/
-
 /**
  * An attribute node for representing vertex colors.
  *
- * @augments module:AttributeNode~AttributeNode
+ * @augments AttributeNode
  */
 class VertexColorNode extends AttributeNode {
 
@@ -20,7 +18,7 @@ class VertexColorNode extends AttributeNode {
 	/**
 	 * Constructs a new vertex color node.
 	 *
-	 * @param {Number} [index=0] - The attribute index.
+	 * @param {number} [index=0] - The attribute index.
 	 */
 	constructor( index = 0 ) {
 
@@ -29,7 +27,7 @@ class VertexColorNode extends AttributeNode {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -38,7 +36,7 @@ class VertexColorNode extends AttributeNode {
 		/**
 		 * The attribute index to enable more than one sets of vertex colors.
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default 0
 		 */
 		this.index = index;
@@ -49,7 +47,7 @@ class VertexColorNode extends AttributeNode {
 	 * Overwrites the default implementation by honoring the attribute index.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The attribute name.
+	 * @return {string} The attribute name.
 	 */
 	getAttributeName( /*builder*/ ) {
 
@@ -104,8 +102,9 @@ export default VertexColorNode;
 /**
  * TSL function for creating a reference node.
  *
+ * @tsl
  * @function
- * @param {Number} index - The attribute index.
+ * @param {number} index - The attribute index.
  * @returns {VertexColorNode}
  */
 export const vertexColor = ( index ) => nodeObject( new VertexColorNode( index ) );

package/src/nodes/code/CodeNode.js

@@ -1,8 +1,6 @@
 import Node from '../core/Node.js';
 import { nodeProxy } from '../tsl/TSLBase.js';
 
-/** @module CodeNode **/
-
 /**
  * This class represents native code sections. It is the base
  * class for modules like {@link FunctionNode} which allows to implement
@@ -21,7 +19,7 @@ class CodeNode extends Node {
 	/**
 	 * Constructs a new code node.
 	 *
-	 * @param {String} [code=''] - The native code.
+	 * @param {string} [code=''] - The native code.
 	 * @param {Array<Node>} [includes=[]] - An array of includes.
 	 * @param {('js'|'wgsl'|'glsl')} [language=''] - The used language.
 	 */
@@ -32,7 +30,7 @@ class CodeNode extends Node {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -41,7 +39,7 @@ class CodeNode extends Node {
 		/**
 		 * The native code.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 * @default ''
 		 */
 		this.code = code;
@@ -67,7 +65,7 @@ class CodeNode extends Node {
 	/**
 	 * The method is overwritten so it always returns `true`.
 	 *
-	 * @return {Boolean} Whether this node is global or not.
+	 * @return {boolean} Whether this node is global or not.
 	 */
 	isGlobal() {
 
@@ -143,19 +141,21 @@ export default CodeNode;
 /**
  * TSL function for creating a code node.
  *
+ * @tsl
  * @function
- * @param {String} [code=''] - The native code.
- * @param {Array<Node>} [includes=[]] - An array of includes.
- * @param {('js'|'wgsl'|'glsl')} [language=''] - The used language.
+ * @param {string} [code] - The native code.
+ * @param {?Array<Node>} [includes=[]] - An array of includes.
+ * @param {?('js'|'wgsl'|'glsl')} [language=''] - The used language.
  * @returns {CodeNode}
  */
-export const code = /*@__PURE__*/ nodeProxy( CodeNode );
+export const code = /*@__PURE__*/ nodeProxy( CodeNode ).setParameterLength( 1, 3 );
 
 /**
  * TSL function for creating a JS code node.
  *
+ * @tsl
  * @function
- * @param {String} src - The native code.
+ * @param {string} src - The native code.
  * @param {Array<Node>} includes - An array of includes.
  * @returns {CodeNode}
  */
@@ -164,8 +164,9 @@ export const js = ( src, includes ) => code( src, includes, 'js' );
 /**
  * TSL function for creating a WGSL code node.
  *
+ * @tsl
  * @function
- * @param {String} src - The native code.
+ * @param {string} src - The native code.
  * @param {Array<Node>} includes - An array of includes.
  * @returns {CodeNode}
  */
@@ -174,8 +175,9 @@ export const wgsl = ( src, includes ) => code( src, includes, 'wgsl' );
 /**
  * TSL function for creating a GLSL code node.
  *
+ * @tsl
  * @function
- * @param {String} src - The native code.
+ * @param {string} src - The native code.
  * @param {Array<Node>} includes - An array of includes.
  * @returns {CodeNode}
  */

package/src/nodes/code/ExpressionNode.js

@@ -1,8 +1,6 @@
 import Node from '../core/Node.js';
 import { nodeProxy } from '../tsl/TSLCore.js';
 
-/** @module ExpressionNode **/
-
 /**
  * This class can be used to implement basic expressions in shader code.
  * Basic examples for that are `return`, `continue` or `discard` statements.
@@ -20,8 +18,8 @@ class ExpressionNode extends Node {
 	/**
 	 * Constructs a new expression node.
 	 *
-	 * @param {String} [snippet=''] - The native code snippet.
-	 * @param {String} [nodeType='void'] - The node type.
+	 * @param {string} [snippet=''] - The native code snippet.
+	 * @param {string} [nodeType='void'] - The node type.
 	 */
 	constructor( snippet = '', nodeType = 'void' ) {
 
@@ -30,7 +28,7 @@ class ExpressionNode extends Node {
 		/**
 		 * The native code snippet.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 * @default ''
 		 */
 		this.snippet = snippet;
@@ -48,7 +46,7 @@ class ExpressionNode extends Node {
 
 		} else {
 
-			return builder.format( `( ${ snippet } )`, type, output );
+			return builder.format( snippet, type, output );
 
 		}
 
@@ -61,9 +59,10 @@ export default ExpressionNode;
 /**
  * TSL function for creating an expression node.
  *
+ * @tsl
  * @function
- * @param {String} [snippet=''] - The native code snippet.
- * @param {String} [nodeType='void'] - The node type.
+ * @param {string} [snippet] - The native code snippet.
+ * @param {?string} [nodeType='void'] - The node type.
  * @returns {ExpressionNode}
  */
-export const expression = /*@__PURE__*/ nodeProxy( ExpressionNode );
+export const expression = /*@__PURE__*/ nodeProxy( ExpressionNode ).setParameterLength( 1, 2 );

package/src/nodes/code/FunctionCallNode.js

@@ -1,5 +1,5 @@
 import TempNode from '../core/TempNode.js';
-import { addMethodChaining, nodeArray, nodeObject, nodeObjects } from '../tsl/TSLCore.js';
+import { addMethodChaining, nodeArray, nodeObject, nodeObjects, float } from '../tsl/TSLCore.js';
 
 /**
  * This module represents the call of a {@link FunctionNode}. Developers are usually not confronted
@@ -19,8 +19,8 @@ class FunctionCallNode extends TempNode {
 	/**
 	 * Constructs a new function call node.
 	 *
-	 * @param {FunctionNode?} functionNode - The function node.
-	 * @param {Object<String, Node>} [parameters={}] - The parameters for the function call.
+	 * @param {?FunctionNode} functionNode - The function node.
+	 * @param {Object<string, Node>} [parameters={}] - The parameters for the function call.
 	 */
 	constructor( functionNode = null, parameters = {} ) {
 
@@ -29,7 +29,7 @@ class FunctionCallNode extends TempNode {
 		/**
 		 * The function node.
 		 *
-		 * @type {FunctionNode}
+		 * @type {?FunctionNode}
 		 * @default null
 		 */
 		this.functionNode = functionNode;
@@ -37,7 +37,7 @@ class FunctionCallNode extends TempNode {
 		/**
 		 * The parameters of the function call.
 		 *
-		 * @type {Object<String, Node>}
+		 * @type {Object<string, Node>}
 		 * @default {}
 		 */
 		this.parameters = parameters;
@@ -47,7 +47,7 @@ class FunctionCallNode extends TempNode {
 	/**
 	 * Sets the parameters of the function call node.
 	 *
-	 * @param {Object<String, Node>} parameters - The parameters to set.
+	 * @param {Object<string, Node>} parameters - The parameters to set.
 	 * @return {FunctionCallNode} A reference to this node.
 	 */
 	setParameters( parameters ) {
@@ -61,7 +61,7 @@ class FunctionCallNode extends TempNode {
 	/**
 	 * Returns the parameters of the function call node.
 	 *
-	 * @return {Object<String, Node>} The parameters of this node.
+	 * @return {Object<string, Node>} The parameters of this node.
 	 */
 	getParameters() {
 
@@ -100,6 +100,24 @@ class FunctionCallNode extends TempNode {
 
 		if ( Array.isArray( parameters ) ) {
 
+			if ( parameters.length > inputs.length ) {
+
+				console.error( 'THREE.TSL: The number of provided parameters exceeds the expected number of inputs in \'Fn()\'.' );
+
+				parameters.length = inputs.length;
+
+			} else if ( parameters.length < inputs.length ) {
+
+				console.error( 'THREE.TSL: The number of provided parameters is less than the expected number of inputs in \'Fn()\'.' );
+
+				while ( parameters.length < inputs.length ) {
+
+					parameters.push( float( 0 ) );
+
+				}
+
+			}
+
 			for ( let i = 0; i < parameters.length; i ++ ) {
 
 				params.push( generateInput( parameters[ i ], inputs[ i ] ) );
@@ -118,7 +136,9 @@ class FunctionCallNode extends TempNode {
 
 				} else {
 
-					throw new Error( `FunctionCallNode: Input '${inputNode.name}' not found in FunctionNode.` );
+					console.error( `THREE.TSL: Input '${ inputNode.name }' not found in \'Fn()\'.` );
+
+					params.push( generateInput( float( 0 ), inputNode ) );
 
 				}
 
@@ -128,7 +148,7 @@ class FunctionCallNode extends TempNode {
 
 		const functionName = functionNode.build( builder, 'property' );
 
-		return `${functionName}( ${params.join( ', ' )} )`;
+		return `${ functionName }( ${ params.join( ', ' ) } )`;
 
 	}
 

package/src/nodes/code/FunctionNode.js

@@ -38,7 +38,7 @@ class FunctionNode extends CodeNode {
 	/**
 	 * Constructs a new function node.
 	 *
-	 * @param {String} [code=''] - The native code.
+	 * @param {string} [code=''] - The native code.
 	 * @param {Array<Node>} [includes=[]] - An array of includes.
 	 * @param {('js'|'wgsl'|'glsl')} [language=''] - The used language.
 	 */

package/src/nodes/code/ScriptableNode.js

@@ -3,8 +3,6 @@ import { scriptableValue } from './ScriptableValueNode.js';
 import { nodeProxy, float } from '../tsl/TSLBase.js';
 import { hashArray, hashString } from '../core/NodeUtils.js';
 
-/** @module ScriptableNode **/
-
 /**
  * A Map-like data structure for managing resources of scriptable nodes.
  *
@@ -119,7 +117,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Constructs a new scriptable node.
 	 *
-	 * @param {CodeNode?} [codeNode=null] - The code node.
+	 * @param {?CodeNode} [codeNode=null] - The code node.
 	 * @param {Object} [parameters={}] - The parameters definition.
 	 */
 	constructor( codeNode = null, parameters = {} ) {
@@ -129,7 +127,7 @@ class ScriptableNode extends Node {
 		/**
 		 * The code node.
 		 *
-		 * @type {CodeNode?}
+		 * @type {?CodeNode}
 		 * @default null
 		 */
 		this.codeNode = codeNode;
@@ -143,7 +141,7 @@ class ScriptableNode extends Node {
 		this.parameters = parameters;
 
 		this._local = new Resources();
-		this._output = scriptableValue();
+		this._output = scriptableValue( null );
 		this._outputs = {};
 		this._source = this.source;
 		this._method = null;
@@ -156,7 +154,7 @@ class ScriptableNode extends Node {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -167,7 +165,7 @@ class ScriptableNode extends Node {
 	/**
 	 * The source code of the scriptable node.
 	 *
-	 * @type {String}
+	 * @type {string}
 	 */
 	get source() {
 
@@ -178,7 +176,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Sets the reference of a local script variable.
 	 *
-	 * @param {String} name - The variable name.
+	 * @param {string} name - The variable name.
 	 * @param {Object} value - The reference to set.
 	 * @return {Resources} The resource map
 	 */
@@ -191,7 +189,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Gets the value of a local script variable.
 	 *
-	 * @param {String} name - The variable name.
+	 * @param {string} name - The variable name.
 	 * @return {Object} The value.
 	 */
 	getLocal( name ) {
@@ -212,7 +210,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Returns an input from the layout with the given id/name.
 	 *
-	 * @param {String} id - The id/name of the input.
+	 * @param {string} id - The id/name of the input.
 	 * @return {Object} The element entry.
 	 */
 	getInputLayout( id ) {
@@ -232,7 +230,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Returns an output from the layout with the given id/name.
 	 *
-	 * @param {String} id - The id/name of the output.
+	 * @param {string} id - The id/name of the output.
 	 * @return {Object} The element entry.
 	 */
 	getOutputLayout( id ) {
@@ -252,7 +250,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Defines a script output for the given name and value.
 	 *
-	 * @param {String} name - The name of the output.
+	 * @param {string} name - The name of the output.
 	 * @param {Node} value - The node value.
 	 * @return {ScriptableNode} A reference to this node.
 	 */
@@ -277,7 +275,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Returns a script output for the given name.
 	 *
-	 * @param {String} name - The name of the output.
+	 * @param {string} name - The name of the output.
 	 * @return {ScriptableValueNode} The node value.
 	 */
 	getOutput( name ) {
@@ -289,7 +287,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Returns a parameter for the given name
 	 *
-	 * @param {String} name - The name of the parameter.
+	 * @param {string} name - The name of the parameter.
 	 * @return {ScriptableValueNode} The node value.
 	 */
 	getParameter( name ) {
@@ -301,8 +299,8 @@ class ScriptableNode extends Node {
 	/**
 	 * Sets a value for the given parameter name.
 	 *
-	 * @param {String} name - The parameter name.
-	 * @param {Any} value - The parameter value.
+	 * @param {string} name - The parameter name.
+	 * @param {any} value - The parameter value.
 	 * @return {ScriptableNode} A reference to this node.
 	 */
 	setParameter( name, value ) {
@@ -353,7 +351,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Deletes a parameter from the script.
 	 *
-	 * @param {String} name - The parameter to remove.
+	 * @param {string} name - The parameter to remove.
 	 * @return {ScriptableNode} A reference to this node.
 	 */
 	deleteParameter( name ) {
@@ -394,9 +392,9 @@ class ScriptableNode extends Node {
 	/**
 	 * Calls a function from the script.
 	 *
-	 * @param {String} name - The function name.
-	 * @param {...Any} params - A list of parameters.
-	 * @return {Any} The result of the function call.
+	 * @param {string} name - The function name.
+	 * @param {...any} params - A list of parameters.
+	 * @return {any} The result of the function call.
 	 */
 	call( name, ...params ) {
 
@@ -414,9 +412,9 @@ class ScriptableNode extends Node {
 	/**
 	 * Asynchronously calls a function from the script.
 	 *
-	 * @param {String} name - The function name.
-	 * @param {...Any} params - A list of parameters.
-	 * @return {Promise<Any>} The result of the function call.
+	 * @param {string} name - The function name.
+	 * @param {...any} params - A list of parameters.
+	 * @return {Promise<any>} The result of the function call.
 	 */
 	async callAsync( name, ...params ) {
 
@@ -435,7 +433,7 @@ class ScriptableNode extends Node {
 	 * Overwritten since the node types is inferred from the script's output.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder
-	 * @return {String} The node type.
+	 * @return {string} The node type.
 	 */
 	getNodeType( builder ) {
 
@@ -446,7 +444,7 @@ class ScriptableNode extends Node {
 	/**
 	 * Refreshes the script node.
 	 *
-	 * @param {String?} [output=null] - An optional output.
+	 * @param {?string} [output=null] - An optional output.
 	 */
 	refresh( output = null ) {
 
@@ -719,9 +717,10 @@ export default ScriptableNode;
 /**
  * TSL function for creating a scriptable node.
  *
+ * @tsl
  * @function
- * @param {CodeNode?} [codeNode=null] - The code node.
- * @param {Object} [parameters={}] - The parameters definition.
+ * @param {CodeNode} [codeNode] - The code node.
+ * @param {?Object} [parameters={}] - The parameters definition.
  * @returns {ScriptableNode}
  */
-export const scriptable = /*@__PURE__*/ nodeProxy( ScriptableNode );
+export const scriptable = /*@__PURE__*/ nodeProxy( ScriptableNode ).setParameterLength( 1, 2 );

package/src/nodes/code/ScriptableValueNode.js

@@ -4,8 +4,6 @@ import { nodeProxy, float } from '../tsl/TSLBase.js';
 
 import { EventDispatcher } from '../../core/EventDispatcher.js';
 
-/** @module ScriptableValueNode **/
-
 /**
  * `ScriptableNode` uses this class to manage script inputs and outputs.
  *
@@ -22,7 +20,7 @@ class ScriptableValueNode extends Node {
 	/**
 	 * Constructs a new scriptable node.
 	 *
-	 * @param {Any} [value=null] - The value.
+	 * @param {any} [value=null] - The value.
 	 */
 	constructor( value = null ) {
 
@@ -47,7 +45,7 @@ class ScriptableValueNode extends Node {
 		/**
 		 * If this node represents an input, this property represents the input type.
 		 *
-		 * @type {String?}
+		 * @type {?string}
 		 * @default null
 		 */
 		this.inputType = null;
@@ -55,7 +53,7 @@ class ScriptableValueNode extends Node {
 		/**
 		 * If this node represents an output, this property represents the output type.
 		 *
-		 * @type {String?}
+		 * @type {?string}
 		 * @default null
 		 */
 		this.outputType = null;
@@ -70,7 +68,7 @@ class ScriptableValueNode extends Node {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -81,7 +79,7 @@ class ScriptableValueNode extends Node {
 	/**
 	 * Whether this node represents an output or not.
 	 *
-	 * @type {Boolean}
+	 * @type {boolean}
 	 * @readonly
 	 * @default true
 	 */
@@ -114,7 +112,7 @@ class ScriptableValueNode extends Node {
 	/**
 	 * The node's value.
 	 *
-	 * @type {Any}
+	 * @type {any}
 	 */
 	get value() {
 
@@ -135,7 +133,7 @@ class ScriptableValueNode extends Node {
 	 * The `value` property usually represents a node or even binary data in form of array buffers.
 	 * In this case, this method tries to return the actual value behind the complex type.
 	 *
-	 * @return {Any} The value.
+	 * @return {any} The value.
 	 */
 	getValue() {
 
@@ -168,7 +166,7 @@ class ScriptableValueNode extends Node {
 	 * Overwritten since the node type is inferred from the value.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The node type.
+	 * @return {string} The node type.
 	 */
 	getNodeType( builder ) {
 
@@ -247,8 +245,9 @@ export default ScriptableValueNode;
 /**
  * TSL function for creating a scriptable value node.
  *
+ * @tsl
  * @function
- * @param {Any} [value=null] - The value.
+ * @param {any} [value] - The value.
  * @returns {ScriptableValueNode}
  */
-export const scriptableValue = /*@__PURE__*/ nodeProxy( ScriptableValueNode );
+export const scriptableValue = /*@__PURE__*/ nodeProxy( ScriptableValueNode ).setParameterLength( 1 );

package/src/nodes/core/ArrayNode.js

@@ -1,10 +1,8 @@
 import TempNode from './TempNode.js';
 import { addMethodChaining, nodeObject } from '../tsl/TSLCore.js';
 
-/** @module ArrayNode **/
-
 /**
- * ArrayNode represents a collection of nodes, typically created using the {@link module:TSL~array} function.
+ * ArrayNode represents a collection of nodes, typically created using the {@link array} function.
  * ```js
  * const colors = array( [
  * 	vec3( 1, 0, 0 ),
@@ -14,7 +12,7 @@ import { addMethodChaining, nodeObject } from '../tsl/TSLCore.js';
  *
  * const redColor = tintColors.element( 0 );
  *
- * @augments Node
+ * @augments TempNode
  */
 class ArrayNode extends TempNode {
 
@@ -27,9 +25,9 @@ class ArrayNode extends TempNode {
 	/**
 	 * Constructs a new array node.
 	 *
-	 * @param {String} [nodeType] - The data type of the elements.
-	 * @param {Number} [count] - Size of the array.
-	 * @param {Array<Node>?} [values=null] - Array default values.
+	 * @param {?string} nodeType - The data type of the elements.
+	 * @param {number} count - Size of the array.
+	 * @param {?Array<Node>} [values=null] - Array default values.
 	 */
 	constructor( nodeType, count, values = null ) {
 
@@ -38,21 +36,21 @@ class ArrayNode extends TempNode {
 		/**
 		 * Array size.
 		 *
-		 * @type {Array<Node>}
+		 * @type {number}
 		 */
 		this.count = count;
 
 		/**
 		 * Array default values.
 		 *
-		 * @type {Array<Node>}
+		 * @type {?Array<Node>}
 		 */
 		this.values = values;
 
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -60,6 +58,12 @@ class ArrayNode extends TempNode {
 
 	}
 
+	/**
+	 * Returns the node's type.
+	 *
+	 * @param {NodeBuilder} builder - The current node builder.
+	 * @return {string} The type of the node.
+	 */
 	getNodeType( builder ) {
 
 		if ( this.nodeType === null ) {
@@ -72,12 +76,24 @@ class ArrayNode extends TempNode {
 
 	}
 
+	/**
+	 * Returns the node's type.
+	 *
+	 * @param {NodeBuilder} builder - The current node builder.
+	 * @return {string} The type of the node.
+	 */
 	getElementType( builder ) {
 
 		return this.getNodeType( builder );
 
 	}
 
+	/**
+	 * This method builds the output node and returns the resulting array as a shader string.
+	 *
+	 * @param {NodeBuilder} builder - The current node builder.
+	 * @return {string} The generated shader string.
+	 */
 	generate( builder ) {
 
 		const type = this.getNodeType( builder );
@@ -93,10 +109,11 @@ export default ArrayNode;
 /**
  * TSL function for creating an array node.
  *
+ * @tsl
  * @function
- * @param {String|Array<Node>} nodeTypeOrValues - A string representing the element type (e.g., 'vec3')
+ * @param {string|Array<Node>} nodeTypeOrValues - A string representing the element type (e.g., 'vec3')
  * or an array containing the default values (e.g., [ vec3() ]).
- * @param {Number?} [count] - Size of the array.
+ * @param {?number} [count] - Size of the array.
  * @returns {ArrayNode}
  */
 export const array = ( ...params ) => {