Add Typescript definition

Author: Planeshifter

lib/node_modules/@stdlib/utils/append/docs/types/index.d.ts

@@ -0,0 +1,50 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2019 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: 2.0
+
+/// <reference types="@stdlib/types"/>
+
+import { Collection } from '@stdlib/types/object';
+
+/**
+* Adds elements from one collection to the end of another collection.
+*
+* @param collection1 - collection
+* @param collection2 - collection containing elements to add
+* @returns updated collection
+*
+* @example
+* var arr = [ 1.0, 2.0, 3.0, 4.0, 5.0 ];
+*
+* arr = append( arr, [ 6.0, 7.0 ] );
+* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0 ]
+*
+* @example
+* var arr = new Float64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+* // returns <Float64Array>[ 1.0, 2.0, 3.0, 4.0, 5.0 ]
+*
+* arr = append( arr, [ 6.0, 7.0 ] );
+* // returns <Float64Array>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0 ]
+*/
+declare function append( collection1: Collection, collection2 ): Collection;
+
+
+// EXPORTS //
+
+export = append;

lib/node_modules/@stdlib/utils/append/docs/types/test.ts

@@ -0,0 +1,51 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2019 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.
+*/
+
+import append = require( './index' );
+
+
+// TESTS //
+
+// The function returns a collection...
+{
+	append( [ 0, 0 ], [ 1, 1 ] ); // $ExpectType Collection
+	append( [ false, true ], [ 0, 1 ] ); // $ExpectType Collection
+	append( [ 'abc', 'abc' ], [ 0, 1 ] ); // $ExpectType Collection
+	append( [ true, true ], [ false, false ] ); // $ExpectType Collection
+}
+
+// The compiler throws an error if the function is provided a first argument which is not a collection...
+{
+	append( true, [] ); // $ExpectError
+	append( false, [] ); // $ExpectError
+	append( 5, [] ); // $ExpectError
+}
+
+// The compiler throws an error if the function is provided a second argument which is not a collection...
+{
+	append( [], true ); // $ExpectError
+	append( [], false ); // $ExpectError
+	append( [], 5 ); // $ExpectError
+}
+
+// The compiler throws an error if the function is not provided two arguments...
+{
+	append(); // $ExpectError
+	append( [ true, true ] ); // $ExpectError
+	append( [ true, true ], [ true, false ], 3 ); // $ExpectError
+}

lib/node_modules/@stdlib/utils/append/package.json

@@ -21,6 +21,7 @@
     "lib": "./lib",
     "test": "./test"
   },
+  "types": "./docs/types",
   "scripts": {},
   "homepage": "https://github.com/stdlib-js/stdlib",
   "repository": {