test: add tests and update docs

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/ndarray/concat/README.md

@@ -60,7 +60,7 @@ var arr = ndarray2array( out );
 
 The function accepts the following arguments:
 
--   **arrays**: a list of input [ndarrays][@stdlib/ndarray/ctor]. Must be [broadcast compatible][@stdlib/ndarray/base/broadcast-shapes] except for the dimension along which to concatenate. The data type of the output [ndarray][@stdlib/ndarray/ctor] is determined by applying [type promotion rules][@stdlib/ndarray/promotion-rules] to the list of input [ndarrays][@stdlib/ndarray/ctor].
+-   **arrays**: a list of input [ndarrays][@stdlib/ndarray/ctor]. Must be [broadcast compatible][@stdlib/ndarray/base/broadcast-shapes] except for the dimension along which to concatenate. The data type of the output [ndarray][@stdlib/ndarray/ctor] is determined by applying [type promotion rules][@stdlib/ndarray/promotion-rules] to the list of input [ndarrays][@stdlib/ndarray/ctor]. If provided [ndarrays][@stdlib/ndarray/ctor] having different [memory layouts][@stdlib/ndarray/orders], the output [ndarray][@stdlib/ndarray/ctor] has the [default order][@stdlib/ndarray/defaults].
 -   **dim**: dimension along which to concatenate input [ndarrays][@stdlib/ndarray/ctor] (_optional_). Must be a negative integer. The index of the dimension along which to concatenate is resolved relative to the last dimension, with the last dimension corresponding to the value `-1`. Default: `-1`.
 
 #### concat.assign( arrays, out\[, dim] )
@@ -161,6 +161,10 @@ console.log( ndarray2array( out ) );
 
 [@stdlib/ndarray/dtypes]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/ndarray/dtypes
 
+[@stdlib/ndarray/orders]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/ndarray/orders
+
+[@stdlib/ndarray/defaults]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/ndarray/defaults
+
 [@stdlib/ndarray/promotion-rules]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/ndarray/promotion-rules
 
 [@stdlib/ndarray/mostly-safe-casts]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/ndarray/mostly-safe-casts

lib/node_modules/@stdlib/ndarray/concat/docs/repl.txt

@@ -5,7 +5,11 @@
     Parameters
     ----------
     arrays: ArrayLikeObject<ndarray>
-        Array-like object containing input ndarrays.
+        List of ndarrays to concatenate. Must be broadcast compatible except for
+        the dimension along which to concatenate. The data type of the output
+        ndarray is determined by applying type promotion rules to the list of
+        input ndarrays. If provided ndarrays having different memory layouts,
+        the output ndarray has the default order.
 
     dim: integer (optional)
         Dimension along which to concatenate input ndarrays. Must be a negative
@@ -35,7 +39,10 @@
     Parameters
     ----------
     arrays: ArrayLikeObject<ndarray>
-        Array-like object containing input ndarrays.
+        List of ndarrays to concatenate. Must be broadcast compatible except for
+        the dimension along which to concatenate. Must promote] to a data type
+        which can be (mostly) safely cast to the data type of the output
+        ndarray.
 
     out: ndarray
         Output ndarray.

lib/node_modules/@stdlib/ndarray/concat/test/test.main.js

@@ -25,6 +25,8 @@ var resolveStr = require( '@stdlib/ndarray/base/dtype-resolve-str' );
 var ndarray = require( '@stdlib/ndarray/ctor' );
 var getShape = require( '@stdlib/ndarray/shape' );
 var getDType = require( '@stdlib/ndarray/dtype' );
+var getOrder = require( '@stdlib/ndarray/order' );
+var defaults = require( '@stdlib/ndarray/defaults' );
 var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var Float64Array = require( '@stdlib/array/float64' );
 var Int32Array = require( '@stdlib/array/int32' );
@@ -333,6 +335,37 @@ tape( 'the function concatenates ndarrays along a specified dimension', function
 	t.end();
 });
 
+tape( 'the function concatenates ndarrays along a specified dimension (different orders)', function test( t ) {
+	var expected;
+	var actual;
+	var xbuf;
+	var ybuf;
+	var out;
+	var x;
+	var y;
+
+	xbuf = new Float64Array( [ 1.0, 2.0, 3.0, 4.0 ] );
+	x = new ndarray( 'float64', xbuf, [ 2, 2 ], [ 2, 1 ], 0, 'row-major' );
+
+	ybuf = new Float64Array( [ 5.0, 6.0, 7.0, 8.0, 9.0, 10.0 ] );
+	y = new ndarray( 'float64', ybuf, [ 2, 3 ], [ 1, 2 ], 0, 'column-major' );
+
+	out = concat( [ x, y ] );
+
+	actual = ndarray2array( out );
+	expected = [
+		[ 1.0, 2.0, 5.0, 7.0, 9.0 ],
+		[ 3.0, 4.0, 6.0, 8.0, 10.0 ]
+	];
+
+	t.strictEqual( resolveStr( getDType( out ) ), 'float64', 'returns expected value' );
+	t.deepEqual( getShape( out ), [ 2, 5 ], 'returns expected value' );
+	t.strictEqual( getOrder( out ), defaults.get( 'order' ), 'returns expected value' );
+	t.deepEqual( actual, expected, 'returns expected value' );
+
+	t.end();
+});
+
 tape( 'the function concatenates ndarrays along a specified dimension (type promotion)', function test( t ) {
 	var expected;
 	var actual;