/*! © SpryMedia Ltd - datatables.net/license */

/**
 * It can be quite useful to jump straight to a page which contains a certain
 * piece of data (a user name for example). This plug-in provides exactly that
 * ability, searching for a given data parameter from a given column and
 * immediately shifting the paging of the table to jump to that point.
 *
 * If multiple data points match the requested data, the paging will be shifted
 * to show the first instance. If there are no matches, the paging will not
 * change.
 *
 * Note that unlike the core DataTables API methods, this plug-in will
 * automatically call `dt-api draw()` to redraw the table with the current page
 * shown.
 *
 * @name page.JumpToData()
 * @summary Jump to a page by searching for data from a column
 * @author [Allan Jardine](http://datatables.net)
 * @requires DataTables 3+
 *
 * @param {*} data Data to search for
 * @param {integer} column Column index
 * @returns {Api} DataTables API instance
 *
 * @example
 *    var table = new DataTable('#example');
 *    table.page.jumpToData( 'Allan', 0 );
 */

import DataTable, { Api, ApiPage, ColumnSelector } from 'datatables.net';

declare module 'datatables.net' {
	interface ApiPage {
		/** Change ordering of the table to its data load order */
		jumpToData(this: Api, data: any, column: ColumnSelector): Api<any>;
	}
}

DataTable.Api.register<ApiPage['jumpToData']>(
	'page.jumpToData()',
	function (data, column) {
		var pos = this.column(column, { order: 'current' })
			.data()
			.indexOf(data);

		if (pos >= 0) {
			var page = Math.floor(pos / this.page.info().length);
			this.page(page).draw(false);
		}

		return this;
	}
);