datatables.net 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/js/dataTables.mjs CHANGED
@@ -1,4 +1,4 @@
1
- /*! DataTables
1
+ /*! DataTables 3.0.1
2
2
  * Copyright (c) SpryMedia Ltd - datatables.net/license
3
3
  */
4
4
 
@@ -118,7 +118,7 @@ let _stripHtml = function (input, replacement = '') {
118
118
  * This function is replaceable if the user wishes to use a different library
119
119
  * for escaping HTML entities in a string.
120
120
  *
121
- * @param d Value to escape HTML in
121
+ * @param val Value to escape HTML in
122
122
  * @returns Escaped value
123
123
  */
124
124
  let _escapeHtml = function (val) {
@@ -517,7 +517,10 @@ function ajax(optionsIn) {
517
517
  options.contentType = 'application/json; charset=utf-8';
518
518
  }
519
519
  }
520
- xhr.open(method, options.url + (options.url.includes('?') ? '&' : '?') + urlParams, true, options.username || null, options.password || null);
520
+ xhr.open(method, options.url +
521
+ (urlParams
522
+ ? (options.url.includes('?') ? '&' : '?') + urlParams
523
+ : ''), true, options.username || null, options.password || null);
521
524
  // Content type for FormData requests gets set by the browser.
522
525
  if (options.contentType && !(options.data instanceof FormData)) {
523
526
  xhr.setRequestHeader('Content-Type', options.contentType);
@@ -607,7 +610,9 @@ ajax.serialize = serialize;
607
610
  * Run callback functions (allowing for none, one or array)
608
611
  *
609
612
  * @param fnIn Function(s) to run
610
- * @param parameters Parameters to pass to the function(s)
613
+ * @param arg1 Parameters to pass to the function(s)
614
+ * @param arg2 Parameters to pass to the function(s)
615
+ * @param arg3 Parameters to pass to the function(s)
611
616
  */
612
617
  function callback(fnIn, arg1, arg2, arg3) {
613
618
  if (!fnIn) {
@@ -827,6 +832,7 @@ function pluck(a, prop, prop2) {
827
832
  * as the indexes to pick from the source array
828
833
  *
829
834
  * @param a Array to get values from
835
+ * @param order Indexes to pick
830
836
  * @param prop Property to read values from
831
837
  * @param prop2 Inner property to get values from if a 2D array
832
838
  * @returns Array of read values
@@ -1885,7 +1891,7 @@ class Dom {
1885
1891
  /**
1886
1892
  * Add an element (or multiple) to the instance. Will ensure uniqueness.
1887
1893
  *
1888
- * @param el Element(s) to add
1894
+ * @param selector Element(s) to add
1889
1895
  * @param sort Indicate if the element should be added in document order.
1890
1896
  * @returns Self for chaining
1891
1897
  */
@@ -2286,7 +2292,7 @@ class Dom {
2286
2292
  /**
2287
2293
  * Get all matching descendants
2288
2294
  *
2289
- * @param selector Elements to find
2295
+ * @param input Elements to find
2290
2296
  * @returns A new Dom instance with all matching elements
2291
2297
  */
2292
2298
  find(input) {
@@ -3015,6 +3021,7 @@ const legacy = [];
3015
3021
  * @param name The name of the new feature.
3016
3022
  * @param cb A function that will create the elements and event listeners for
3017
3023
  * the feature being added.
3024
+ * @param legacyChar
3018
3025
  */
3019
3026
  function register$2(name, cb, legacyChar = '') {
3020
3027
  features[name] = cb;
@@ -3879,7 +3886,7 @@ const ext = {
3879
3886
  * Software version
3880
3887
  * @type string
3881
3888
  */
3882
- version: '3.0.0'
3889
+ version: '3.0.1'
3883
3890
  };
3884
3891
  //
3885
3892
  // Backwards compatibility. Alias to pre 1.10 Hungarian notation counter parts
@@ -4784,7 +4791,7 @@ function create$1(parts = {}) {
4784
4791
  * DOM source.
4785
4792
  *
4786
4793
  * @param settings DataTables settings object
4787
- * @param data data array to be added
4794
+ * @param dataIn data array to be added
4788
4795
  * @param tr TR element to add to the table - optional. If not given, DataTables
4789
4796
  * will create a row automatically
4790
4797
  * @param tds Array of TD|TH elements for the row - must be given if tr is.
@@ -4823,7 +4830,7 @@ function addData(settings, dataIn, tr, tds) {
4823
4830
  * it is not cloned).
4824
4831
  *
4825
4832
  * @param settings DataTables settings object
4826
- * @param trs The TR element(s) to add to the table
4833
+ * @param rows The TR element(s) to add to the table
4827
4834
  * @returns Array of indexes for the added rows
4828
4835
  */
4829
4836
  function addTr(settings, rows) {
@@ -5405,7 +5412,7 @@ function getWideStrings(settings, colIdx) {
5405
5412
  /**
5406
5413
  * Append a CSS unit (only if required) to a string
5407
5414
  *
5408
- * @param value to css-ify
5415
+ * @param s Value to css-ify
5409
5416
  * @returns Value with css unit
5410
5417
  */
5411
5418
  function stringToCss(s) {
@@ -6339,7 +6346,7 @@ function renderer(ctx, type) {
6339
6346
  /**
6340
6347
  * Add the options to the page HTML for the table
6341
6348
  *
6342
- * @param settings DataTables settings object
6349
+ * @param ctx DataTables context
6343
6350
  */
6344
6351
  function createLayout(ctx) {
6345
6352
  var classes = ctx.classes;
@@ -6716,6 +6723,7 @@ function sortAttachListener(settings, node, selector, column, callback) {
6716
6723
  * Sort the display array to match the master's order
6717
6724
  *
6718
6725
  * @param settings DataTables context
6726
+ * @param display The display array
6719
6727
  */
6720
6728
  function sortDisplay(settings, display) {
6721
6729
  if (display.length < 2) {
@@ -6943,7 +6951,6 @@ function sort(ctx, col, dir) {
6943
6951
  * Function to run on user sort request
6944
6952
  *
6945
6953
  * @param settings dataTables settings object
6946
- * @param attachTo node to attach the handler to
6947
6954
  * @param colIdx column sorting index
6948
6955
  * @param addIndex Counter
6949
6956
  * @param shift Shift click add
@@ -7760,7 +7767,6 @@ const __filter_div_textContent = __filter_div.textContent !== undefined;
7760
7767
  * Filter the table using both the global filter and column based filtering
7761
7768
  *
7762
7769
  * @param settings DataTables settings object
7763
- * @param input search information
7764
7770
  */
7765
7771
  function filterComplete(settings) {
7766
7772
  settings.columns;
@@ -7824,7 +7830,6 @@ function filterCustom(settings) {
7824
7830
  * @param settings
7825
7831
  * @param input
7826
7832
  * @param options
7827
- * @param column
7828
7833
  * @returns
7829
7834
  */
7830
7835
  function filter(searchRows, settings, input, options) {
@@ -9177,7 +9182,7 @@ function getPrototypeNames(name) {
9177
9182
  * Each of the input parameter types will be converted to a DataTables settings
9178
9183
  * object where possible.
9179
9184
  *
9180
- * @param mixed DataTable identifier. Can be one of:
9185
+ * @param mixedIn DataTable identifier. Can be one of:
9181
9186
  * * `string` - jQuery selector. Any DataTables' matching the given selector
9182
9187
  * with be found and used.
9183
9188
  * * `node` - `TABLE` node which has already been formed into a DataTable.
@@ -9466,7 +9471,7 @@ const __reload = function (settings, holdPosition, callback) {
9466
9471
  processingDisplay(settings, true);
9467
9472
  // Cancel an existing request
9468
9473
  var xhr = settings.jqXHR;
9469
- if (xhr && xhr.readyState !== 4) {
9474
+ if (xhr && xhr.readyState !== 4 && typeof xhr.abort === 'function') {
9470
9475
  xhr.abort();
9471
9476
  }
9472
9477
  // Trigger xhr
@@ -10243,7 +10248,7 @@ registerPlural('columns().orderable()', 'column().orderable()', function (direct
10243
10248
  /**
10244
10249
  * Set the page length
10245
10250
  *
10246
- * @param settings DataTables context
10251
+ * @param ctx DataTables context
10247
10252
  * @param val Value to change to
10248
10253
  */
10249
10254
  function lengthChange(ctx, val) {
@@ -11177,7 +11182,14 @@ function check(releaseDate, software) {
11177
11182
  return true;
11178
11183
  }
11179
11184
  }
11180
- else if (_licenseInfo.type === 'plus' ||
11185
+ else if (software === null) {
11186
+ // Validating the key only - there hasn't been any specific software
11187
+ // calling the `plus` parameter yet. The key is good, so carry on.
11188
+ return true;
11189
+ }
11190
+ else if (
11191
+ // Checking if the build version can be used with this key
11192
+ _licenseInfo.type === 'plus' ||
11181
11193
  (_licenseInfo.type === 'editor' && software === 'editor')) {
11182
11194
  if (!expires || new Date(releaseDate) > expires) {
11183
11195
  noticePrep('Upgrade required for this version');
@@ -11187,6 +11199,7 @@ function check(releaseDate, software) {
11187
11199
  return true;
11188
11200
  }
11189
11201
  else if (_licenseInfo.type === 'editor' && software !== 'editor') {
11202
+ // Editor specific license
11190
11203
  noticePrep('License for Editor only. Upgrade for Plus');
11191
11204
  noticeDisplay();
11192
11205
  return false;
@@ -11345,7 +11358,7 @@ function verify(licenseString) {
11345
11358
  */
11346
11359
  function plus (DataTable) {
11347
11360
  Object.defineProperty(DataTable, 'plus', {
11348
- value: function (releaseDate, software = null) {
11361
+ value: function (releaseDate, software = '') {
11349
11362
  // Unsecure sites are only useful for development, so allow there
11350
11363
  // and on the site.
11351
11364
  let host = window.location.hostname;
@@ -11496,6 +11509,8 @@ register$2('info', function (settings, optsIn) {
11496
11509
  /**
11497
11510
  * Update the information elements in the display
11498
11511
  * @param settings DataTables settings object
11512
+ * @param opts
11513
+ * @param node
11499
11514
  */
11500
11515
  function updateInfo(settings, opts, node) {
11501
11516
  var start = settings.displayStart + 1, end = displayEnd(settings), max = recordsTotal(settings), total = recordsDisplay(settings), out = total ? opts.text : opts.empty;
@@ -11568,7 +11583,7 @@ function _pagingDraw(settings, host, opts) {
11568
11583
  if (!settings.initDone) {
11569
11584
  return;
11570
11585
  }
11571
- let plugin = opts.type ? ext.pager[opts.type] : _pagingDynamic, aria = settings.language.aria.paginate || {}, start = settings.displayStart, len = settings.pageLength, visRecords = recordsDisplay(settings), all = len === -1, page = all ? 0 : Math.ceil(start / len), pages = Math.ceil(visRecords / (all ? 1 : len)), buttons = [], buttonEls = [], buttonsNested = plugin(opts).map(function (val) {
11586
+ let plugin = opts.type ? ext.pager[opts.type] : _pagingDynamic, aria = settings.language.aria.paginate || {}, start = settings.displayStart, len = settings.pageLength, visRecords = recordsDisplay(settings), all = len === -1, page = all ? 0 : Math.ceil(start / len), pages = all ? (visRecords ? 1 : 0) : Math.ceil(visRecords / len), buttons = [], buttonEls = [], buttonsNested = plugin(opts).map(function (val) {
11572
11587
  return val === 'numbers'
11573
11588
  ? pagingNumbers(page, pages, opts.buttons, opts.boundaryNumbers)
11574
11589
  : val;
@@ -12237,7 +12252,8 @@ const defaults = {
12237
12252
  },
12238
12253
  stateSaveParams: null,
12239
12254
  tabIndex: 0,
12240
- titleRow: null
12255
+ titleRow: null,
12256
+ typeDetect: true
12241
12257
  };
12242
12258
 
12243
12259
  const DataTable = function (selector, options) {
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "main": "js/dataTables.js",
5
5
  "module": "js/dataTables.mjs",
6
6
  "types": "./types/types.d.ts",
7
- "version": "3.0.0",
7
+ "version": "3.0.1",
8
8
  "files": [
9
9
  "js/**/*.js",
10
10
  "js/**/*.mjs",
package/types/types.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- /*! DataTables
1
+ /*! DataTables 3.0.1
2
2
  * Copyright (c) SpryMedia Ltd - datatables.net/license
3
3
  */
4
4
 
@@ -91,7 +91,7 @@ declare class Dom<T extends HTMLElement = HTMLElement> implements ArrayLike<T> {
91
91
  /**
92
92
  * Add an element (or multiple) to the instance. Will ensure uniqueness.
93
93
  *
94
- * @param el Element(s) to add
94
+ * @param selector Element(s) to add
95
95
  * @param sort Indicate if the element should be added in document order.
96
96
  * @returns Self for chaining
97
97
  */
@@ -330,7 +330,7 @@ declare class Dom<T extends HTMLElement = HTMLElement> implements ArrayLike<T> {
330
330
  /**
331
331
  * Get all matching descendants
332
332
  *
333
- * @param selector Elements to find
333
+ * @param input Elements to find
334
334
  * @returns A new Dom instance with all matching elements
335
335
  */
336
336
  find<R extends HTMLElement = T>(input: Dom | string | HTMLElement | Element | null): Dom<R>;
@@ -1222,9 +1222,9 @@ type LayoutElement = {
1222
1222
  };
1223
1223
  type LayoutComponent = LayoutElement | LayoutFeatures | (() => HTMLElement) | HTMLElement | JQuery<HTMLElement> | Dom | null;
1224
1224
  type Layout = Partial<Record<LayoutKeys, LayoutComponent>>;
1225
- type FunctionColumnRender = (this: DataTableDom, data: any, type: any, row: any, meta: CellMetaSettings) => any;
1225
+ type ColumnRenderFunction = (this: DataTableDom, data: any, type: any, row: any, meta: CellMeta) => any;
1226
1226
  type FunctionColumnCreatedCell = (this: DataTableDom, cell: HTMLTableCellElement, cellData: any, rowData: any, row: number, col: number) => void;
1227
- interface CellMetaSettings {
1227
+ interface CellMeta {
1228
1228
  row: number;
1229
1229
  col: number;
1230
1230
  settings: Context;
@@ -1248,8 +1248,8 @@ interface OrderFixed {
1248
1248
  post?: any[];
1249
1249
  }
1250
1250
  interface FunctionColumnData {
1251
- (row: any, type: 'set', s: any, meta: CellMetaSettings): void;
1252
- (row: any, type: 'display' | 'sort' | 'filter' | 'type', s: undefined, meta: CellMetaSettings): any;
1251
+ (row: any, type: 'set', s: any, meta: CellMeta): void;
1252
+ (row: any, type: 'display' | 'sort' | 'filter' | 'type', s: undefined, meta: CellMeta): any;
1253
1253
  }
1254
1254
  interface ObjectColumnData {
1255
1255
  _: string | number | FunctionColumnData;
@@ -1259,11 +1259,11 @@ interface ObjectColumnData {
1259
1259
  sort?: string | number | FunctionColumnData;
1260
1260
  }
1261
1261
  interface ObjectColumnRender {
1262
- _?: string | number | FunctionColumnRender;
1263
- filter?: string | number | FunctionColumnRender;
1264
- display?: string | number | FunctionColumnRender;
1265
- type?: string | number | FunctionColumnRender;
1266
- sort?: string | number | FunctionColumnRender;
1262
+ _?: string | number | ColumnRenderFunction;
1263
+ filter?: string | number | ColumnRenderFunction;
1264
+ display?: string | number | ColumnRenderFunction;
1265
+ type?: string | number | ColumnRenderFunction;
1266
+ sort?: string | number | ColumnRenderFunction;
1267
1267
  }
1268
1268
  interface AjaxData {
1269
1269
  draw?: number;
@@ -1411,7 +1411,7 @@ interface Defaults$1 {
1411
1411
  /**
1412
1412
  * Render (process) the data for use in the table.
1413
1413
  */
1414
- render: number | string | ObjectColumnData | FunctionColumnRender | ObjectColumnRender | null;
1414
+ render: number | string | ObjectColumnData | ColumnRenderFunction | ObjectColumnRender | null;
1415
1415
  search: SearchOptions | null;
1416
1416
  /**
1417
1417
  * Enable or disable filtering on the data in this column.
@@ -1728,6 +1728,8 @@ interface Defaults {
1728
1728
  tabIndex: number;
1729
1729
  /** Specify which row is the title row in the header. */
1730
1730
  titleRow: null | number | boolean;
1731
+ /** Ability to enable / disable auto type detection. */
1732
+ typeDetect: boolean;
1731
1733
  }
1732
1734
  type LanguageOption = string | {
1733
1735
  [key: string | number]: LanguageOption;
@@ -2354,6 +2356,7 @@ type RegisterCallback<T> = (settings: Context, options: T) => HTMLElement | Dom
2354
2356
  * @param name The name of the new feature.
2355
2357
  * @param cb A function that will create the elements and event listeners for
2356
2358
  * the feature being added.
2359
+ * @param legacyChar
2357
2360
  */
2358
2361
  declare function register$1<T>(name: string, cb: RegisterCallback<T>, legacyChar?: string): void;
2359
2362
 
@@ -2638,6 +2641,7 @@ declare function pluck(a: any[], prop: string | number, prop2?: string | number)
2638
2641
  * as the indexes to pick from the source array
2639
2642
  *
2640
2643
  * @param a Array to get values from
2644
+ * @param order Indexes to pick
2641
2645
  * @param prop Property to read values from
2642
2646
  * @param prop2 Inner property to get values from if a 2D array
2643
2647
  * @returns Array of read values
@@ -2952,7 +2956,7 @@ declare function escapeHtml<T>(mixed: T): T;
2952
2956
  /**
2953
2957
  * Set the function to use for HTML entity encoding from a string
2954
2958
  *
2955
- * @param fn HTML escape function
2959
+ * @param mixed HTML escape function
2956
2960
  */
2957
2961
  declare function escapeHtml<T = TEscapeHtml>(mixed: T): void;
2958
2962
  /**
@@ -2968,13 +2972,14 @@ declare function normalize(mixed: string, both?: boolean): string;
2968
2972
  /**
2969
2973
  * Set the function to use for string normalisation
2970
2974
  *
2971
- * @param mixed Normalisation function
2975
+ * @param fn Normalisation function
2972
2976
  */
2973
2977
  declare function normalize<T = TNormalize>(fn: T): void;
2974
2978
  /**
2975
2979
  * Strip HTML from a string, if a string is given, otherwise no action
2976
2980
  *
2977
2981
  * @param mixed Value to remove HTML from
2982
+ * @param replacement
2978
2983
  * @returns The stripped value (or original if not a string)
2979
2984
  */
2980
2985
  declare function stripHtml<T>(mixed: T, replacement?: string): T;
@@ -3002,7 +3007,7 @@ declare namespace string {
3002
3007
  * Debounce a function
3003
3008
  *
3004
3009
  * @param fn Function to be called
3005
- * @param timeout Call frequency in mS
3010
+ * @param freq Call frequency in mS
3006
3011
  * @returns Wrapped function
3007
3012
  */
3008
3013
  declare function debounce(fn: () => void, freq?: number): () => void;
@@ -3117,6 +3122,9 @@ type HeaderStructure = {
3117
3122
  rowspan: number;
3118
3123
  title: string;
3119
3124
  };
3125
+ interface DataTableEvent<T = any> extends Event {
3126
+ dt: Api<T>;
3127
+ }
3120
3128
  interface ApiConstructor {
3121
3129
  new (content: InstSelector, data?: any): Api;
3122
3130
  (content: InstSelector, data?: any): Api;
@@ -3424,7 +3432,7 @@ interface ApiScopeable<T, S> {
3424
3432
  * unbind a single event listener.
3425
3433
  * @returns DataTables Api instance
3426
3434
  */
3427
- off(event: string, callback?: (this: HTMLElement, e: Event, ...args: any[]) => void): Api<T>;
3435
+ off(event: string, callback?: (this: HTMLElement, e: DataTableEvent, ...args: any[]) => void): Api<T>;
3428
3436
  /**
3429
3437
  * Remove event handlers from selected elements
3430
3438
  *
@@ -3434,7 +3442,7 @@ interface ApiScopeable<T, S> {
3434
3442
  * unbind a single event listener.
3435
3443
  * @returns DataTables Api instance
3436
3444
  */
3437
- off(event: string, selector: string, callback?: (this: HTMLElement, e: Event, ...args: any[]) => void): Api<T>;
3445
+ off(event: string, selector: string, callback?: (this: HTMLElement, e: DataTableEvent, ...args: any[]) => void): Api<T>;
3438
3446
  /**
3439
3447
  * Table events listener.
3440
3448
  *
@@ -3442,7 +3450,7 @@ interface ApiScopeable<T, S> {
3442
3450
  * @param callback Event handler.
3443
3451
  * @returns DataTables Api instance
3444
3452
  */
3445
- on(event: string, callback: (this: HTMLElement, e: Event, ...args: any[]) => void): Api<T>;
3453
+ on(event: string, callback: (this: HTMLElement, e: DataTableEvent, ...args: any[]) => void): Api<T>;
3446
3454
  /**
3447
3455
  * Listen for events from selected elements
3448
3456
  *
@@ -3451,7 +3459,7 @@ interface ApiScopeable<T, S> {
3451
3459
  * @param callback Event handler.
3452
3460
  * @returns DataTables Api instance
3453
3461
  */
3454
- on(event: string, selector: string, callback: (this: HTMLElement, e: Event, ...args: any[]) => void): Api<T>;
3462
+ on(event: string, selector: string, callback: (this: HTMLElement, e: DataTableEvent, ...args: any[]) => void): Api<T>;
3455
3463
  /**
3456
3464
  * Listen for a table event once and then remove the listener.
3457
3465
  *
@@ -3460,7 +3468,7 @@ interface ApiScopeable<T, S> {
3460
3468
  * Listen for events from tables and fire a callback when they occur
3461
3469
  * @returns DataTables Api instance
3462
3470
  */
3463
- one(event: string, callback: (this: HTMLElement, e: Event, ...args: any[]) => void): Api<T>;
3471
+ one(event: string, callback: (this: HTMLElement, e: DataTableEvent, ...args: any[]) => void): Api<T>;
3464
3472
  /**
3465
3473
  * Listen for events from a selected element and trigger only once then
3466
3474
  * remove the listener.
@@ -3470,7 +3478,7 @@ interface ApiScopeable<T, S> {
3470
3478
  * @param callback Event handler.
3471
3479
  * @returns DataTables Api instance
3472
3480
  */
3473
- one(event: string, selector: string, callback: (this: HTMLElement, e: Event, ...args: any[]) => void): Api<T>;
3481
+ one(event: string, selector: string, callback: (this: HTMLElement, e: DataTableEvent, ...args: any[]) => void): Api<T>;
3474
3482
  /**
3475
3483
  * Order Methods / object
3476
3484
  */
@@ -3506,6 +3514,7 @@ interface ApiScopeable<T, S> {
3506
3514
  * Add one or more items to the end of an API instance's result set.
3507
3515
  *
3508
3516
  * @param value_1 Item to add to the API instance's result set.
3517
+ * @param value_2 Additional items to add.
3509
3518
  * @returns The length of the modified API instance
3510
3519
  */
3511
3520
  push(value_1: any, ...value_2: any[]): number;
@@ -3521,7 +3530,7 @@ interface ApiScopeable<T, S> {
3521
3530
  */
3522
3531
  ready(this: S, fn: (this: Api<T>) => void): Api<T>;
3523
3532
  /**
3524
- * Apply a callback function against and accumulator and each element in the
3533
+ * Apply a callback function against an accumulator and each element in the
3525
3534
  * Api's result set (left-to-right).
3526
3535
  *
3527
3536
  * @param fn Callback function which is called for each item in the API
@@ -3606,6 +3615,7 @@ interface ApiScopeable<T, S> {
3606
3615
  * @param howMany Number of elements to remove from the result set.
3607
3616
  * @param value_1 Item to add to the result set at the index specified by
3608
3617
  * the first parameter.
3618
+ * @param value_2 Additional items to add.
3609
3619
  * @returns An array of the items which were removed. If no elements were
3610
3620
  * removed, an empty array is returned.
3611
3621
  */
@@ -3682,6 +3692,7 @@ interface ApiScopeable<T, S> {
3682
3692
  * Add one or more items to the start of an API instance's result set.
3683
3693
  *
3684
3694
  * @param value_1 Item to add to the API instance's result set.
3695
+ * @param value_2 Additional items to add.
3685
3696
  * @returns The length of the modified API instance
3686
3697
  */
3687
3698
  unshift(value_1: any, ...value_2: any[]): number;
@@ -3695,7 +3706,7 @@ interface ApiCaption {
3695
3706
  * Set the contents of the `-tag caption` element. If the table doesn't have
3696
3707
  * a `-tag caption` element, one will be created automatically.
3697
3708
  *
3698
- * @param string The value to show in the table's `caption` tag.
3709
+ * @param set The value to show in the table's `caption` tag.
3699
3710
  * @param side `top` or `bottom` to set where the table will be shown on the
3700
3711
  * table. If not given the previous value will be used (can also be set in
3701
3712
  * CSS).
@@ -4397,7 +4408,7 @@ interface ApiColumnSearch<T> {
4397
4408
  * Set the search term for the matched column.
4398
4409
  *
4399
4410
  * @param input Search to apply.
4400
- * @param Search Search configuration options
4411
+ * @param options Search configuration options
4401
4412
  * @returns DataTables API instance
4402
4413
  */
4403
4414
  (input: SearchInput<T>, options: Partial<SearchOptions>): Api<any>;
@@ -4619,7 +4630,7 @@ interface ApiColumnsSearch<T> {
4619
4630
  * Set the search term for the matched columns.
4620
4631
  *
4621
4632
  * @param input Search to apply.
4622
- * @param Search Search configuration options
4633
+ * @param options Search configuration options
4623
4634
  * @returns DataTables API instance
4624
4635
  */
4625
4636
  (input: SearchInput<T>, options: Partial<SearchOptions>): Api<any>;
@@ -4655,26 +4666,20 @@ interface ApiRowChildMethods<T> {
4655
4666
  * result set, or undefined if there are no child rows set for the parent
4656
4667
  * yet.
4657
4668
  */
4658
- (): JQuery;
4659
- /**
4660
- * Get the child row(s) that have been set for a parent row
4661
- *
4662
- * @param showRemove This parameter can be given as true or false
4663
- * @returns DataTables Api instance.
4664
- */
4665
- (showRemove: boolean): RowChildMethods<T>;
4669
+ (): Dom;
4666
4670
  /**
4667
4671
  * Set the data to show in the child row(s). Note that calling this method
4668
4672
  * will replace any child rows which are already attached to the parent row.
4669
4673
  *
4670
4674
  * @param data The data to be shown in the child row can be given in
4671
- * multiple different ways.
4675
+ * multiple different ways. Can be set to boolean `false` to hide an
4676
+ * existing child row, or boolean `true` to show an existing child row.
4672
4677
  * @param className Class name that is added to the td cell node(s) of the
4673
4678
  * child row(s). As of 1.10.1 it is also added to the tr row node of the
4674
4679
  * child row(s).
4675
4680
  * @returns DataTables Api instance
4676
4681
  */
4677
- (data: (string | Node | JQuery) | Array<string | number | JQuery>, className?: string): RowChildMethods<T>;
4682
+ (data: (boolean | string | Node | JQuery) | Array<string | number | JQuery>, className?: string): RowChildMethods<T>;
4678
4683
  /**
4679
4684
  * Hide the child row(s) of a parent row
4680
4685
  *
@@ -5114,7 +5119,7 @@ interface DataTablesStatic {
5114
5119
  /**
5115
5120
  * Get all DataTable tables that have been initialised - as HTML elements
5116
5121
  *
5117
- * @param options Indicate if you want all tables on the page should be
5122
+ * @param visible Indicate if you want all tables on the page should be
5118
5123
  * returned (false), or visible tables only (true).
5119
5124
  * @returns Array of HTML table Elements
5120
5125
  */
@@ -5199,7 +5204,6 @@ interface DataTablesStaticRender {
5199
5204
  * Format an ISO8061 date value using the specified format
5200
5205
  * @param to Display format
5201
5206
  * @param locale Locale
5202
- * @param def Default value if empty
5203
5207
  */
5204
5208
  date(to: string, locale?: string): DateTimeRenderer;
5205
5209
  /**
@@ -5218,7 +5222,6 @@ interface DataTablesStaticRender {
5218
5222
  * Format an ISO8061 datetime value using the specified format
5219
5223
  * @param to Display format
5220
5224
  * @param locale Locale
5221
- * @param def Default value if empty
5222
5225
  */
5223
5226
  datetime(to: string, locale?: string): DateTimeRenderer;
5224
5227
  /**
@@ -5256,7 +5259,6 @@ interface DataTablesStaticRender {
5256
5259
  * Format an ISO8061 time value using the specified format
5257
5260
  * @param to Display format
5258
5261
  * @param locale Locale
5259
- * @param def Default value if empty
5260
5262
  */
5261
5263
  time(to: string, locale?: string): DateTimeRenderer;
5262
5264
  /**
@@ -5340,4 +5342,4 @@ interface DataTable extends DataTablesStatic {}
5340
5342
  declare const DataTable: typeof DataTable$1;
5341
5343
 
5342
5344
  export { Api, Settings as ColumnContext, DataTable, Dom, DataTable as default, _default as util };
5343
- export type { AjaxMethods, AjaxOptions, ApiAjax, ApiCaption, ApiCell, ApiCellMethods, ApiCells, ApiCellsMethods, ApiColumn, ApiColumnMethods, ApiColumnSearch, ApiColumns, ApiColumnsMethods, ApiColumnsSearch, ApiConstructor, ApiOrder, ApiPage, ApiPageInfo, ApiRow, ApiRowChildMethods, ApiRowMethods, ApiRows, ApiRowsMethods, ApiScopeable, ApiSearch, ApiSelector, ApiState, ApiStatic, ApiStaticRegisterFn, ApiTableFooterMethods, ApiTableHeaderMethods, ApiTableMethods, ApiTablesMethods, CellIdx, CellIdxWithVisible, CellSelector, ColumnIdx, ColumnSelector, Options$1 as ColumnsConfig, Context, DataTablesStatic, DataTablesStaticExtButtons, DataTablesStaticRender, Defaults, DomSelector, Ext, ExtButtons, ExtTypeSettings, HeaderStructure, IColumnControlContent, InstSelector, ConfigLanguage as Language, Options, RowChildMethods, Row as RowContext, RowIdx, RowSelector, SelectorModifier, Context as Settings, State, StateLoad, TableSelector };
5345
+ export type { AjaxMethods, AjaxOptions, ApiAjax, ApiCaption, ApiCell, ApiCellMethods, ApiCells, ApiCellsMethods, ApiColumn, ApiColumnMethods, ApiColumnSearch, ApiColumns, ApiColumnsMethods, ApiColumnsSearch, ApiConstructor, ApiOrder, ApiPage, ApiPageInfo, ApiRow, ApiRowChildMethods, ApiRowMethods, ApiRows, ApiRowsMethods, ApiScopeable, ApiSearch, ApiSelector, ApiState, ApiStatic, ApiStaticRegisterFn, ApiTableFooterMethods, ApiTableHeaderMethods, ApiTableMethods, ApiTablesMethods, CellIdx, CellIdxWithVisible, CellMeta, CellSelector, ColumnIdx, ColumnRenderFunction, ColumnSelector, Options$1 as ColumnsConfig, Context, DataTableEvent, DataTablesStatic, DataTablesStaticExtButtons, DataTablesStaticRender, DataType, DataTypeDetect, Defaults, DomSelector, Ext, ExtButtons, ExtTypeSettings, HeaderStructure, IColumnControlContent, InstSelector, ConfigLanguage as Language, Options, RowChildMethods, Row as RowContext, RowIdx, RowSelector, SelectorModifier, Context as Settings, State, StateLoad, TableSelector };