feat: add "broadcasting" mode to require broadcast compatibility

kgryte · kgryte · commit dc29f108e512 · 2024-06-19T19:00:06.000-07:00
diff --git a/lib/node_modules/@stdlib/array/base/mskput/README.md b/lib/node_modules/@stdlib/array/base/mskput/README.md
@@ -54,20 +54,33 @@ The function supports the following parameters:
 The function supports the following modes:
 
 -   `'throw'`: specifies that the function must raise an exception when the function is provided insufficient `values` to satisfy the `mask` array.
+-   `'broadcast'`: specifies that the function must broadcast a single-element `values` array and otherwise raise an exception when the function is provided insufficient `values` to satisfy the `mask` array.
 -   `'repeat'`: specifies that the function must reuse provided `values` when replacing elements in `x` in order to satisfy the `mask` array.
 
-When `mode` is equal to `'repeat`', the function supports broadcasting a `values` array containing a single element against the number of falsy values in the `mask` array.
+When `mode` is equal to `'broadcast`', the function supports broadcasting a `values` array containing a single element against the number of falsy values in the `mask` array.
 
 ```javascript
 var x = [ 1, 2, 3, 4 ];
 
-var out = mskput( x, [ 1, 0, 1, 0 ], [ 20 ], 'repeat' );
+var out = mskput( x, [ 1, 0, 1, 0 ], [ 20 ], 'broadcast' );
 // returns [ 1, 20, 3, 20 ]
 
 var bool = ( out === x );
 // returns true
 ```
 
+When `mode` is equal to `repeat`, the function supports recycling elements in a `values` array to satisfy the number of falsy values in the `mask` array.
+
+```javascript
+var x = [ 1, 2, 3, 4 ];
+
+var out = mskput( x, [ 0, 0, 1, 0 ], [ 20, 40 ], 'repeat' );
+// returns [ 20, 40, 3, 20 ]
+
+var bool = ( out === x );
+// returns true
+```
+
 </section>
 
 <!-- /.usage -->
diff --git a/lib/node_modules/@stdlib/array/base/mskput/benchmark/benchmark.js b/lib/node_modules/@stdlib/array/base/mskput/benchmark/benchmark.js
@@ -65,7 +65,7 @@ bench( pkg+'::broadcasting:len=100', function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		v = mskput( x, mask, [ i ], 'repeat' );
+		v = mskput( x, mask, [ i ], 'broadcast' );
 		if ( typeof v !== 'object' ) {
 			b.fail( 'should return an array' );
 		}
diff --git a/lib/node_modules/@stdlib/array/base/mskput/docs/repl.txt b/lib/node_modules/@stdlib/array/base/mskput/docs/repl.txt
@@ -3,9 +3,12 @@
     Replaces elements of an array with provided values according to a provided
     mask array.
 
-    When the `mode` is `'repeat'`, the function supports broadcasting a `values`
-    array containing a single element against the number of falsy values in the
-    `mask` array.
+    When the `mode` is `'broadcast'`, the function supports broadcasting a
+    `values` array containing a single element against the number of falsy
+    values in the `mask` array.
+
+    When the `mode` is `'repeat'`, the function supports recycling elements in a
+    `values` array to satisfy the number of falsy values in the `mask` array.
 
     The function mutates the input array.
 
@@ -23,12 +26,15 @@
         Values to set.
 
     mode: string
-        String specifying whether to raise an exception when the number of
-        values to set is less than the number of falsy mask values. The function
-        supports the following modes:
+        String specifying behavior when the number of values to set is less than
+        the number of falsy mask values. The function supports the following
+        modes:
 
         - 'throw': specifies that the function must raise an exception when the
         function is provided insufficient values to satisfy the mask array.
+        - 'broadcast': specifies that the function must broadcast a single-
+        element values array and otherwise raise an exception when the function
+        is provided insufficient values to satisfy the mask array.
         - 'repeat': specifies that the function must reuse provided values when
         replacing elements in `x` in order to satisfy the mask array.
 
diff --git a/lib/node_modules/@stdlib/array/base/mskput/docs/types/index.d.ts b/lib/node_modules/@stdlib/array/base/mskput/docs/types/index.d.ts
@@ -34,24 +34,25 @@ type MaskArray = Collection | AccessorArrayLike<any>;
 type ValuesArray<T> = Collection<T> | AccessorArrayLike<T>;
 
 /**
-* Mode specifying whether to raise an exception when the number of values to set is less than the number of falsy values in the mask array.
+* Mode specifying behavior when the number of values to set is less than the number of falsy values in the mask array.
 *
 * ## Notes
 *
 * -   The function supports the following modes:
 *
 *     -   `'throw'`: specifies that the function must raise an exception when the function is provided insufficient `values` to satisfy the `mask` array.
+*     -   `'broadcast'`: specifies that the function must broadcast a single-element `values` array and otherwise raise an exception when the function is provided insufficient `values` to satisfy the `mask` array.
 *     -   `'repeat'`: specifies that the function must reuse provided `values` when replacing elements in `x` in order to satisfy the `mask` array.
 */
-type Mode = 'throw' | 'repeat';
+type Mode = 'throw' | 'broadcast' | 'repeat';
 
 /**
 * Replaces elements of an array with provided values according to a provided mask array.
 *
 * @param x - input array
 * @param mask - mask array
 * @param values - values to set
-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array
+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array
 * @returns input array
 *
 * @example
@@ -73,7 +74,7 @@ type Mode = 'throw' | 'repeat';
 *
 * var x = new Int32Array( [ 1, 2, 3, 4 ] );
 *
-* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'repeat' );
+* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'broadcast' );
 * // returns <Int32Array>[ 1, 30, 30, 4 ]
 *
 * var bool = ( out === x );
@@ -87,7 +88,7 @@ declare function mskput<T extends TypedArray | BooleanTypedArray, U = unknown>(
 * @param x - input array
 * @param mask - mask array
 * @param values - values to set
-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array
+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array
 * @returns input array
 *
 * @example
@@ -112,7 +113,7 @@ declare function mskput<T extends TypedArray | BooleanTypedArray, U = unknown>(
 * var mask = [ 1, 0, 0, 1 ];
 * var values = new Complex128Array( [ 20.0, 30.0 ] );
 *
-* var out = mskput( x, mask, values, 'repeat' );
+* var out = mskput( x, mask, values, 'broadcast' );
 * // returns <Complex128Array>
 *
 * var bool = ( out === x );
@@ -126,7 +127,7 @@ declare function mskput<T extends ComplexTypedArray>( x: T, mask: MaskArray, val
 * @param x - input array
 * @param mask - mask array
 * @param values - values to set
-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array
+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array
 * @returns input array
 *
 * @example
@@ -144,7 +145,7 @@ declare function mskput<T extends ComplexTypedArray>( x: T, mask: MaskArray, val
 * @example
 * var x = [ 1, 2, 3, 4 ];
 *
-* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'repeat' );
+* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'broadcast' );
 * // returns [ 1, 30, 30, 4 ]
 *
 * var bool = ( out === x );
@@ -158,7 +159,7 @@ declare function mskput<T = unknown, U = unknown>( x: Array<T>, mask: MaskArray,
 * @param x - input array
 * @param mask - mask array
 * @param values - values to set
-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array
+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array
 * @returns input array
 *
 * @example
@@ -179,7 +180,7 @@ declare function mskput<T = unknown, U = unknown>( x: Array<T>, mask: MaskArray,
 *
 * var x = toAccessorArray( [ 1, 2, 3, 4 ] );
 *
-* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'repeat' );
+* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'broadcast' );
 *
 * var bool = ( out === x );
 * // returns true
@@ -192,7 +193,7 @@ declare function mskput<T = unknown, U = unknown>( x: AccessorArrayLike<T>, mask
 * @param x - input array
 * @param mask - mask array
 * @param values - values to set
-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array
+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array
 * @returns input array
 *
 * @example
diff --git a/lib/node_modules/@stdlib/array/base/mskput/docs/types/test.ts b/lib/node_modules/@stdlib/array/base/mskput/docs/types/test.ts
@@ -28,6 +28,7 @@ import mskput = require( './index' );
 // The function returns an array...
 {
 	mskput( [ 1, 2, 3, 4 ], [ 1, 0, 0, 1 ], [ 20, 30 ], 'throw' ); // $ExpectType number[]
+	mskput( [ 1, 2, 3, 4 ], [ 1, 0, 0, 1 ], [ 20, 30 ], 'broadcast' ); // $ExpectType number[]
 	mskput( [ 1, 2, 3, 4 ], [ 1, 0, 0, 1 ], [ 20, 30 ], 'repeat' ); // $ExpectType number[]
 
 	mskput( new Int32Array( [ 1, 2, 3, 4 ] ), [ 1, 0, 0, 1 ], [ 20, 30 ], 'throw' ); // $ExpectType Int32Array
diff --git a/lib/node_modules/@stdlib/array/base/mskput/lib/main.js b/lib/node_modules/@stdlib/array/base/mskput/lib/main.js
@@ -214,7 +214,7 @@ function boolean( x, mask, values ) {
 * @param {Collection} x - input array
 * @param {Collection} mask - mask array
 * @param {Collection} values - values to set
-* @param {string} mode - string specifying whether to raise an exception when the number of values is less than the number of falsy mask values
+* @param {string} mode - string specifying behavior when the number of values is less than the number of falsy mask values
 * @throws {Error} insufficient values to satisfy mask array
 * @returns {Collection} input array
 *
@@ -236,11 +236,23 @@ function boolean( x, mask, values ) {
 * var mask = [ 1, 0, 0, 1 ];
 * var values = [ 30 ];
 *
-* var out = mskput( x, mask, values, 'repeat' );
+* var out = mskput( x, mask, values, 'broadcast' );
 * // returns [ 1, 30, 30, 4 ]
 *
 * var bool = ( out === x );
 * // returns true
+*
+* @example
+* var x = [ 1, 2, 3, 4 ];
+*
+* var mask = [ 0, 0, 1, 0 ];
+* var values = [ 20, 30 ];
+*
+* var out = mskput( x, mask, values, 'repeat' );
+* // returns [ 20, 30, 3, 20 ]
+*
+* var bool = ( out === x );
+* // returns true
 */
 function mskput( x, mask, values, mode ) {
 	var xo;
@@ -250,6 +262,9 @@ function mskput( x, mask, values, mode ) {
 	if ( mode === 'throw' && countFalsy( mask ) > values.length ) {
 		throw new Error( 'invalid arguments. Insufficient values to satisfy mask array.' );
 	}
+	if ( mode === 'broadcast' && values.length > 1 && countFalsy( mask ) > values.length ) {
+		throw new Error( 'invalid arguments. Insufficient values to satisfy mask array.' );
+	}
 	xo = arraylike2object( x );
 	mo = arraylike2object( mask );
 	vo = arraylike2object( values );
diff --git a/lib/node_modules/@stdlib/array/base/mskput/test/test.js b/lib/node_modules/@stdlib/array/base/mskput/test/test.js
@@ -78,21 +78,21 @@ tape( 'the function replaces elements in an array (generic, broadcasting)', func
 
 	x = [ 1, 2, 3, 4 ];
 	mask = [ 1, 0, 1, 0 ];
-	actual = mskput( x, mask, [ 20 ], 'repeat' );
+	actual = mskput( x, mask, [ 20 ], 'broadcast' );
 	expected = [ 1, 20, 3, 20 ];
 	t.strictEqual( actual, x, 'returns expected value' );
 	t.deepEqual( actual, expected, 'returns expected value' );
 
 	x = [ 1, 2, 3, 4 ];
 	mask = [ 0, 0, 0, 0 ];
-	actual = mskput( x, mask, [ 20 ], 'repeat' );
+	actual = mskput( x, mask, [ 20 ], 'broadcast' );
 	expected = [ 20, 20, 20, 20 ];
 	t.strictEqual( actual, x, 'returns expected value' );
 	t.deepEqual( actual, expected, 'returns expected value' );
 
 	x = [ 1, 2, 3, 4 ];
 	mask = [ 1, 1, 1, 1 ];
-	actual = mskput( x, mask, [ 20 ], 'repeat' );
+	actual = mskput( x, mask, [ 20 ], 'broadcast' );
 	expected = [ 1, 2, 3, 4 ];
 	t.strictEqual( actual, x, 'returns expected value' );
 	t.deepEqual( actual, expected, 'returns expected value' );
@@ -145,21 +145,21 @@ tape( 'the function replaces elements in an array (typed, broadcasting)', functi
 
 	x = new Int32Array( [ 1, 2, 3, 4 ] );
 	mask = [ 1, 0, 1, 0 ];
-	actual = mskput( x, mask, [ 20 ], 'repeat' );
+	actual = mskput( x, mask, [ 20 ], 'broadcast' );
 	expected = new Int32Array( [ 1, 20, 3, 20 ] );
 	t.strictEqual( actual, x, 'returns expected value' );
 	t.deepEqual( actual, expected, 'returns expected value' );
 
 	x = new Int32Array( [ 1, 2, 3, 4 ] );
 	mask = [ 0, 0, 0, 0 ];
-	actual = mskput( x, mask, [ 20 ], 'repeat' );
+	actual = mskput( x, mask, [ 20 ], 'broadcast' );
 	expected = new Int32Array( [ 20, 20, 20, 20 ] );
 	t.strictEqual( actual, x, 'returns expected value' );
 	t.deepEqual( actual, expected, 'returns expected value' );
 
 	x = new Int32Array( [ 1, 2, 3, 4 ] );
 	mask = [ 1, 1, 1, 1 ];
-	actual = mskput( x, mask, [ 20 ], 'repeat' );
+	actual = mskput( x, mask, [ 20 ], 'broadcast' );
 	expected = new Int32Array( [ 1, 2, 3, 4 ] );
 	t.strictEqual( actual, x, 'returns expected value' );
 	t.deepEqual( actual, expected, 'returns expected value' );
@@ -227,7 +227,7 @@ tape( 'the function replaces elements in an array (accessors, broadcasting)', fu
 		new Complex64( 5.0, 6.0 ),
 		new Complex64( 100.0, 200.0 )
 	];
-	actual = mskput( x, mask, values, 'repeat' );
+	actual = mskput( x, mask, values, 'broadcast' );
 
 	t.strictEqual( actual, x, 'returns expected value' );
 	for ( i = 0; i < mask.length; i++ ) {
@@ -287,7 +287,7 @@ tape( 'the function replaces elements in an array (accessors, complex, broadcast
 		new Complex64( 5.0, 6.0 ),
 		new Complex64( 100.0, 200.0 )
 	];
-	actual = mskput( x, mask, values, 'repeat' );
+	actual = mskput( x, mask, values, 'broadcast' );
 
 	t.strictEqual( actual, x, 'returns expected value' );
 	for ( i = 0; i < mask.length; i++ ) {
@@ -335,7 +335,7 @@ tape( 'the function replaces elements in an array (accessors, boolean, broadcast
 	mask = toAccessorArray( [ 1, 0, 0, 1 ] );
 	values = [ true ];
 	expected = [ true, true, true, true ];
-	actual = mskput( x, mask, values, 'repeat' );
+	actual = mskput( x, mask, values, 'broadcast' );
 
 	t.strictEqual( actual, x, 'returns expected value' );
 	for ( i = 0; i < mask.length; i++ ) {
@@ -359,3 +359,18 @@ tape( 'when the "mode" is "throw", the function throws an error if provided insu
 		mskput( x, mask, [ 200 ], 'throw' );
 	}
 });
+
+tape( 'when the "mode" is "broadcast", the function throws an error if a provided values array is broadcast incompatible with the number of falsy values in a mask array', function test( t ) {
+	var mask;
+	var x;
+
+	x = [ 1, 2, 3, 4 ];
+	mask = [ 0, 0, 0, 0 ];
+
+	t.throws( badValue, Error, 'throws an error' );
+	t.end();
+
+	function badValue() {
+		mskput( x, mask, [ 200, 400 ], 'broadcast' );
+	}
+});

Original file line number	Diff line number	Diff line change
`@@ -65,7 +65,7 @@ bench( pkg+'::broadcasting:len=100', function benchmark( b ) {`
`65`	`65`
`66`	`66`	`b.tic();`
`67`	`67`	`for ( i = 0; i < b.iterations; i++ ) {`
`68`		`- v = mskput( x, mask, [ i ], 'repeat' );`
	`68`	`+ v = mskput( x, mask, [ i ], 'broadcast' );`
`69`	`69`	`if ( typeof v !== 'object' ) {`
`70`	`70`	`b.fail( 'should return an array' );`
`71`	`71`	`}`
Original file line number	Diff line number	Diff line change
`@@ -34,24 +34,25 @@ type MaskArray = Collection \| AccessorArrayLike<any>;`
`34`	`34`	`type ValuesArray<T> = Collection<T> \| AccessorArrayLike<T>;`
`35`	`35`
`36`	`36`	`/**`
`37`		`-* Mode specifying whether to raise an exception when the number of values to set is less than the number of falsy values in the mask array.`
	`37`	`+* Mode specifying behavior when the number of values to set is less than the number of falsy values in the mask array.`
`38`	`38`	`*`
`39`	`39`	`* ## Notes`
`40`	`40`	`*`
`41`	`41`	`* - The function supports the following modes:`
`42`	`42`	`*`
`43`	`43`	* - `'throw'`: specifies that the function must raise an exception when the function is provided insufficient `values` to satisfy the `mask` array.
	`44`	+* - `'broadcast'`: specifies that the function must broadcast a single-element `values` array and otherwise raise an exception when the function is provided insufficient `values` to satisfy the `mask` array.
`44`	`45`	* - `'repeat'`: specifies that the function must reuse provided `values` when replacing elements in `x` in order to satisfy the `mask` array.
`45`	`46`	`*/`
`46`		`-type Mode = 'throw' \| 'repeat';`
	`47`	`+type Mode = 'throw' \| 'broadcast' \| 'repeat';`
`47`	`48`
`48`	`49`	`/**`
`49`	`50`	`* Replaces elements of an array with provided values according to a provided mask array.`
`50`	`51`	`*`
`51`	`52`	`* @param x - input array`
`52`	`53`	`* @param mask - mask array`
`53`	`54`	`* @param values - values to set`
`54`		`-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array`
	`55`	`+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array`
`55`	`56`	`* @returns input array`
`56`	`57`	`*`
`57`	`58`	`* @example`
`@@ -73,7 +74,7 @@ type Mode = 'throw' \| 'repeat';`
`73`	`74`	`*`
`74`	`75`	`* var x = new Int32Array( [ 1, 2, 3, 4 ] );`
`75`	`76`	`*`
`76`		`-* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'repeat' );`
	`77`	`+* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'broadcast' );`
`77`	`78`	`* // returns <Int32Array>[ 1, 30, 30, 4 ]`
`78`	`79`	`*`
`79`	`80`	`* var bool = ( out === x );`
`@@ -87,7 +88,7 @@ declare function mskput<T extends TypedArray \| BooleanTypedArray, U = unknown>(`
`87`	`88`	`* @param x - input array`
`88`	`89`	`* @param mask - mask array`
`89`	`90`	`* @param values - values to set`
`90`		`-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array`
	`91`	`+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array`
`91`	`92`	`* @returns input array`
`92`	`93`	`*`
`93`	`94`	`* @example`
`@@ -112,7 +113,7 @@ declare function mskput<T extends TypedArray \| BooleanTypedArray, U = unknown>(`
`112`	`113`	`* var mask = [ 1, 0, 0, 1 ];`
`113`	`114`	`* var values = new Complex128Array( [ 20.0, 30.0 ] );`
`114`	`115`	`*`
`115`		`-* var out = mskput( x, mask, values, 'repeat' );`
	`116`	`+* var out = mskput( x, mask, values, 'broadcast' );`
`116`	`117`	`* // returns <Complex128Array>`
`117`	`118`	`*`
`118`	`119`	`* var bool = ( out === x );`
`@@ -126,7 +127,7 @@ declare function mskput<T extends ComplexTypedArray>( x: T, mask: MaskArray, val`
`126`	`127`	`* @param x - input array`
`127`	`128`	`* @param mask - mask array`
`128`	`129`	`* @param values - values to set`
`129`		`-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array`
	`130`	`+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array`
`130`	`131`	`* @returns input array`
`131`	`132`	`*`
`132`	`133`	`* @example`
`@@ -144,7 +145,7 @@ declare function mskput<T extends ComplexTypedArray>( x: T, mask: MaskArray, val`
`144`	`145`	`* @example`
`145`	`146`	`* var x = [ 1, 2, 3, 4 ];`
`146`	`147`	`*`
`147`		`-* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'repeat' );`
	`148`	`+* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'broadcast' );`
`148`	`149`	`* // returns [ 1, 30, 30, 4 ]`
`149`	`150`	`*`
`150`	`151`	`* var bool = ( out === x );`
`@@ -158,7 +159,7 @@ declare function mskput<T = unknown, U = unknown>( x: Array<T>, mask: MaskArray,`
`158`	`159`	`* @param x - input array`
`159`	`160`	`* @param mask - mask array`
`160`	`161`	`* @param values - values to set`
`161`		`-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array`
	`162`	`+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array`
`162`	`163`	`* @returns input array`
`163`	`164`	`*`
`164`	`165`	`* @example`
`@@ -179,7 +180,7 @@ declare function mskput<T = unknown, U = unknown>( x: Array<T>, mask: MaskArray,`
`179`	`180`	`*`
`180`	`181`	`* var x = toAccessorArray( [ 1, 2, 3, 4 ] );`
`181`	`182`	`*`
`182`		`-* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'repeat' );`
	`183`	`+* var out = mskput( x, [ 1, 0, 0, 1 ], [ 30 ], 'broadcast' );`
`183`	`184`	`*`
`184`	`185`	`* var bool = ( out === x );`
`185`	`186`	`* // returns true`
`@@ -192,7 +193,7 @@ declare function mskput<T = unknown, U = unknown>( x: AccessorArrayLike<T>, mask`
`192`	`193`	`* @param x - input array`
`193`	`194`	`* @param mask - mask array`
`194`	`195`	`* @param values - values to set`
`195`		`-* @param mode - string specifying whether to raise an exception when the number of values is less than the number of falsy values in the mask array`
	`196`	`+* @param mode - string specifying behavior when the number of values is less than the number of falsy values in the mask array`
`196`	`197`	`* @returns input array`
`197`	`198`	`*`
`198`	`199`	`* @example`
Original file line number	Diff line number	Diff line change
`@@ -28,6 +28,7 @@ import mskput = require( './index' );`
`28`	`28`	`// The function returns an array...`
`29`	`29`	`{`
`30`	`30`	`mskput( [ 1, 2, 3, 4 ], [ 1, 0, 0, 1 ], [ 20, 30 ], 'throw' ); // $ExpectType number[]`
	`31`	`+ mskput( [ 1, 2, 3, 4 ], [ 1, 0, 0, 1 ], [ 20, 30 ], 'broadcast' ); // $ExpectType number[]`
`31`	`32`	`mskput( [ 1, 2, 3, 4 ], [ 1, 0, 0, 1 ], [ 20, 30 ], 'repeat' ); // $ExpectType number[]`
`32`	`33`
`33`	`34`	`mskput( new Int32Array( [ 1, 2, 3, 4 ] ), [ 1, 0, 0, 1 ], [ 20, 30 ], 'throw' ); // $ExpectType Int32Array`