refactor: update type inference and docs and add test assertions

---
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: na
  - 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: passed
  - task: lint_license_headers
    status: passed
---

Author: kgryte

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

@@ -1,14 +1,14 @@
 
 {{alias}}( x, indices, value )
-    Returns an ndarray with element at specified indices replaced by a provided
-    value.
+    Returns a new ndarray with the element at a specified index replaced by a
+    provided value.
 
     Parameters
     ----------
     x: ndarray
         Input array.
 
-    indices: Collection<integer>
+    indices: Array<integer>
         Indices of the value to replace.
 
     value: any

lib/node_modules/@stdlib/ndarray/with/docs/types/index.d.ts

@@ -47,7 +47,7 @@ import { typedndarray } from '@stdlib/types/ndarray';
 * var v = out.get( 0, 0 );
 * // returns 5
 */
-declare function ndarrayWith<T = unknown, U extends typedndarray<T> = typedndarray<T>>( x: U, indices: Array<number>, value: T ): U;
+declare function ndarrayWith<T = unknown, U extends typedndarray<T> = typedndarray<T>>( x: typedndarray<T>, indices: Array<number>, value: T ): U;
 
 
 // EXPORTS //

lib/node_modules/@stdlib/ndarray/with/docs/types/test.ts

@@ -24,7 +24,7 @@ import ndarrayWith = require( './index' );
 
 // The function returns an ndarray...
 {
-	ndarrayWith( array( [ [ 1, 2 ], [ 3, 4 ] ] ), [ 0, 0 ], 5 ); // $ExpectType ndarray
+	ndarrayWith( array<number>( [ [ 1, 2 ], [ 3, 4 ] ] ), [ 0, 0 ], 5 ); // $ExpectType typedndarray<number>
 }
 
 // The compiler throws an error if the function is provided a first argument which is not an ndarray...
@@ -41,7 +41,7 @@ import ndarrayWith = require( './index' );
 
 // The compiler throws an error if the function is provided a second argument which is not an array of integers...
 {
-	var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
+	var x = array<number>( [ [ 1, 2 ], [ 3, 4 ] ] );
 
 	ndarrayWith( x, [ '1' ], 5 );
 	ndarrayWith( x, 1, 5 ); // $ExpectError
@@ -55,7 +55,7 @@ import ndarrayWith = require( './index' );
 
 // The compiler throws an error if the function is provided an unsupported number of arguments...
 {
-	const x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
+	const x = array<number>( [ [ 1, 2 ], [ 3, 4 ] ] );
 
 	ndarrayWith(); // $ExpectError
 	ndarrayWith( x, [ 0, 0 ] ); // $ExpectError

lib/node_modules/@stdlib/ndarray/with/test/test.js

@@ -121,7 +121,7 @@ tape( 'the function throws an error if provided a second argument with out-of-bo
 	}
 });
 
-tape( 'the function returns an ndarray with element at specified indices replaced by a provided value', function test( t ) {
+tape( 'the function returns a new ndarray with the element at a specified index replaced by a provided value', function test( t ) {
 	var out;
 	var x;
 
@@ -130,12 +130,15 @@ tape( 'the function returns an ndarray with element at specified indices replace
 	});
 
 	out = ndarrayWith( x, [ 0, 0, 0 ], 1.0 );
+	t.notEqual( out, x, 'returns expected value' );
 	t.strictEqual( out.get( 0, 0, 0 ), 1.0, 'returns expected value' );
 
 	out = ndarrayWith( x, [ 1, 1, 1 ], 1.0 );
+	t.notEqual( out, x, 'returns expected value' );
 	t.strictEqual( out.get( 1, 1, 1 ), 1.0, 'returns expected value' );
 
 	out = ndarrayWith( x, [ 2, 2, 2 ], 1.0 );
+	t.notEqual( out, x, 'returns expected value' );
 	t.strictEqual( out.get( 2, 2, 2 ), 1.0, 'returns expected value' );
 
 	t.end();