/*
* @license Apache-2.0
*
* Copyright (c) 2021 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*    http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

// TypeScript Version: 4.1

/* eslint-disable max-lines */

import base = require( './../../base' );
import ddot = require( './../../ddot' );
import dswap = require( './../../dswap' );
import ext = require( './../../ext' );
import gdot = require( './../../gdot' );
import gswap = require( './../../gswap' );
import sdot = require( './../../sdot' );
import sswap = require( './../../sswap' );

/**
* Interface describing the `blas` namespace.
*/
interface Namespace {
	/**
	* Base (i.e., lower-level) basic linear algebra subprograms (BLAS).
	*/
	base: typeof base;

	/**
	* Computes the dot product of two double-precision floating-point vectors.
	*
	* @param x - first input array
	* @param y - second input array
	* @throws first argument must be a 1-dimensional `ndarray` containing double-precision floating-point numbers
	* @throws second argument must be a 1-dimensional `ndarray` containing double-precision floating-point numbers
	* @throws input arrays must be the same length
	* @returns dot product
	*
	* @example
	* var Float64Array = require( '@stdlib/array/float64' );
	* var array = require( '@stdlib/ndarray/array' );
	*
	* var x = array( new Float64Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] ) );
	* var y = array( new Float64Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] ) );
	*
	* var z = ns.ddot( x, y );
	* // returns -5.0
	*/
	ddot: typeof ddot;

	/**
	* Interchanges two double-precision floating-point vectors.
	*
	* @param x - first input array
	* @param y - second input array
	* @throws first argument must be a 1-dimensional `ndarray` containing double-precision floating-point numbers
	* @throws second argument must be a 1-dimensional `ndarray` containing double-precision floating-point numbers
	* @throws input arrays must be the same length
	* @returns `y`
	*
	* @example
	* var Float64Array = require( '@stdlib/array/float64' );
	* var array = require( '@stdlib/ndarray/array' );
	*
	* var x = array( new Float64Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] ) );
	* var y = array( new Float64Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] ) );
	*
	* ns.dswap( x, y );
	*
	* var xbuf = x.data;
	* // returns <Float64Array>[ 2.0, 6.0, -1.0, -4.0, 8.0 ]
	*
	* var ybuf = y.data;
	* // returns <Float64Array>[ 4.0, 2.0, -3.0, 5.0, -1.0 ]
	*/
	dswap: typeof dswap;

	/**
	* Extended BLAS.
	*/
	ext: typeof ext;

	/**
	* Computes the dot product of two vectors.
	*
	* ## Notes
	*
	* -   In general, for best performance, especially for large vectors, provide 1-dimensional `ndarrays` whose underlying data type is either `float64` or `float32`.
	*
	* @param x - first input array
	* @param y - second input array
	* @throws first argument must be either an array-like object or a 1-dimensional `ndarray`
	* @throws second argument must be either an array-like object or a 1-dimensional `ndarray`
	* @throws input arrays must be the same length
	* @returns dot product
	*
	* @example
	* var x = [ 4.0, 2.0, -3.0, 5.0, -1.0 ];
	* var y = [ 2.0, 6.0, -1.0, -4.0, 8.0 ];
	*
	* var z = ns.gdot( x, y );
	* // returns -5.0
	*/
	gdot: typeof gdot;

	/**
	* Interchanges two vectors.
	*
	* ## Notes
	*
	* -   In general, for best performance, especially for large vectors, provide 1-dimensional `ndarrays` whose underlying data type is either `float64` or `float32`.
	*
	* @param x - first input array
	* @param y - second input array
	* @throws first argument must be either an array-like object or a 1-dimensional `ndarray`
	* @throws second argument must be either an array-like object or a 1-dimensional `ndarray`
	* @throws input arrays must be the same length
	* @returns `y`
	*
	* @example
	* var x = [ 4.0, 2.0, -3.0, 5.0, -1.0 ];
	* var y = [ 2.0, 6.0, -1.0, -4.0, 8.0 ];
	*
	* ns.gswap( x, y );
	* // x => [ 2.0, 6.0, -1.0, -4.0, 8.0 ]
	* // y => [ 4.0, 2.0, -3.0, 5.0, -1.0 ]
	*/
	gswap: typeof gswap;

	/**
	* Computes the dot product of two single-precision floating-point vectors.
	*
	* @param x - first input array
	* @param y - second input array
	* @throws first argument must be a 1-dimensional `ndarray` containing single-precision floating-point numbers
	* @throws second argument must be a 1-dimensional `ndarray` containing single-precision floating-point numbers
	* @throws input arrays must be the same length
	* @returns dot product
	*
	* @example
	* var Float32Array = require( '@stdlib/array/float32' );
	* var array = require( '@stdlib/ndarray/array' );
	*
	* var x = array( new Float32Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] ) );
	* var y = array( new Float32Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] ) );
	*
	* var z = ns.sdot( x, y );
	* // returns -5.0
	*/
	sdot: typeof sdot;

	/**
	* Interchanges two single-precision floating-point vectors.
	*
	* @param x - first input array
	* @param y - second input array
	* @throws first argument must be a 1-dimensional `ndarray` containing single-precision floating-point numbers
	* @throws second argument must be a 1-dimensional `ndarray` containing single-precision floating-point numbers
	* @throws input arrays must be the same length
	* @returns `y`
	*
	* @example
	* var Float32Array = require( '@stdlib/array/float32' );
	* var array = require( '@stdlib/ndarray/array' );
	*
	* var x = array( new Float32Array( [ 4.0, 2.0, -3.0, 5.0, -1.0 ] ) );
	* var y = array( new Float32Array( [ 2.0, 6.0, -1.0, -4.0, 8.0 ] ) );
	*
	* ns.sswap( x, y );
	*
	* var xbuf = x.data;
	* // returns <Float32Array>[ 2.0, 6.0, -1.0, -4.0, 8.0 ]
	*
	* var ybuf = y.data;
	* // returns <Float32Array>[ 4.0, 2.0, -3.0, 5.0, -1.0 ]
	*/
	sswap: typeof sswap;
}

/**
* BLAS.
*/
declare var ns: Namespace;


// EXPORTS //

export = ns;