datatables.net 1.13.2 → 1.13.4

package/js/jquery.dataTables.mjs

@@ -1,16 +1,22 @@
-/*! DataTables 1.13.2
+/*! DataTables 1.13.4
  * ©2008-2023 SpryMedia Ltd - datatables.net/license
  */
 
 import jQuery from 'jquery';
 
 // DataTables code uses $ internally, but we want to be able to
-// reassign $ with the `use` method below, so it is a regular var.
+// reassign $ with the `use` method, so it is a regular var.
 let $ = jQuery;
 
 
 var DataTable = function ( selector, options )
 {
+	// Check if called with a window or jQuery object for DOM less applications
+	// This is for backwards compatibility
+	if (DataTable.factory(selector, options)) {
+		return DataTable;
+	}
+
 	// When creating with `new`, create a new DataTable, returning the API instance
 	if (this instanceof DataTable) {
 		return $(selector).DataTable(options);
@@ -1115,6 +1121,7 @@ var DataTable = function ( selector, options )
 							type:   sort !== null   ? i+'.@data-'+sort   : undefined,
 							filter: filter !== null ? i+'.@data-'+filter : undefined
 						};
+						col._isArrayHost = true;
 		
 						_fnColumnOptions( oSettings, i );
 					}
@@ -2303,7 +2310,7 @@ function _fnColumnOptions( oSettings, iCol, oOptions )
 
 	// Indicate if DataTables should read DOM data as an object or array
 	// Used in _fnGetRowElements
-	if ( typeof mDataSrc !== 'number' ) {
+	if ( typeof mDataSrc !== 'number' && ! oCol._isArrayHost ) {
 		oSettings._rowReadObject = true;
 	}
 
@@ -5057,7 +5064,8 @@ function _fnFeatureHtmlProcessing ( settings )
 {
 	return $('<div/>', {
 			'id': ! settings.aanFeatures.r ? settings.sTableId+'_processing' : null,
-			'class': settings.oClasses.sProcessing
+			'class': settings.oClasses.sProcessing,
+			'role': 'status'
 		} )
 		.html( settings.oLanguage.sProcessing )
 		.append('<div><div></div><div></div><div></div><div></div></div>')
@@ -9305,6 +9313,48 @@ _api_register( 'state.save()', function () {
 
 
 
+/**
+ * Set the jQuery or window object to be used by DataTables
+ *
+ * @param {*} module Library / container object
+ * @param {string} type Library or container type `lib` or `win`.
+ */
+DataTable.use = function (module, type) {
+	if (type === 'lib' || module.fn) {
+		$ = module;
+	}
+	else if (type == 'win' || module.document) {
+		window = module;
+		document = module.document;
+	}
+}
+
+/**
+ * CommonJS factory function pass through. This will check if the arguments
+ * given are a window object or a jQuery object. If so they are set
+ * accordingly.
+ * @param {*} root Window
+ * @param {*} jq jQUery
+ * @returns {boolean} Indicator
+ */
+DataTable.factory = function (root, jq) {
+	var is = false;
+
+	// Test if the first parameter is a window object
+	if (root && root.document) {
+		window = root;
+		document = root.document;
+	}
+
+	// Test if the second parameter is a jQuery object
+	if (jq && jq.fn && jq.fn.jquery) {
+		$ = jq;
+		is = true;
+	}
+
+	return is;
+}
+
 /**
  * Provide a common method for plug-ins to check the version of DataTables being
  * used, in order to ensure compatibility.
@@ -9646,7 +9696,7 @@ _api_register( 'i18n()', function ( token, def, plural ) {
  *  @type string
  *  @default Version number
  */
-DataTable.version = "1.13.2";
+DataTable.version = "1.13.4";
 
 /**
  * Private data store, containing all of the settings objects that are
@@ -15575,13 +15625,4 @@ $.each( DataTable, function ( prop, val ) {
 	$.fn.DataTable[ prop ] = val;
 } );
 
-DataTable.use = function (module, type) {
-	if (type === 'lib' || module.fn) {
-		$ = module;
-	}
-	else if (type == 'win' || module.document) {
-		window = module;
-	}
-}
-
 export default DataTable;

package/package.json

@@ -4,7 +4,7 @@
     "main": "js/jquery.dataTables.js",
     "module": "js/jquery.dataTables.mjs",
     "types": "./types/types.d.ts",
-    "version": "1.13.2",
+    "version": "1.13.4",
     "files": [
         "js/**/*.js",
         "js/**/*.mjs",

package/types/types.d.ts

@@ -69,7 +69,7 @@ export type CellIdxWithVisible = {
 /**
  * DataTables class
  */
-declare interface DataTables<T> extends ApiStatic {
+declare interface DataTables<T> extends DataTablesStatic {
     /**
      * Create a new DataTable
      * @param selector Selector to pick one or more `<table>` elements
@@ -79,6 +79,12 @@ declare interface DataTables<T> extends ApiStatic {
         selector: InstSelector,
         opts?: Config
     ): Api<T>
+
+    /**
+     * CommonJS factory. This only applies to CommonJS environments,
+     * in all others it would throw an error.
+     */
+    (win?: Window, jQuery?: JQuery): DataTables<T>;
 }
 
 declare const DataTables: DataTables<any>;
@@ -97,12 +103,20 @@ interface JQueryDataTables extends JQuery {
 
 // Extend the jQuery object with DataTables' construction methods
 declare global {
+    interface JQueryDataTableApi extends DataTablesStatic {
+        <T = any>(opts?: Config): Api<T>;
+    }
+
+    interface JQueryDataTableJq extends DataTablesStatic {
+        (opts?: Config): JQueryDataTables;
+    }
+
     interface JQuery {
         /**
          * Create a new DataTable, returning a DataTables API instance.
          * @param opts Configuration settings
          */
-        DataTable<T = any>(opts?: Config): Api<T>;
+        DataTable: JQueryDataTableApi;
 
         /**
          * Create a new DataTable, returning a jQuery object, extended
@@ -110,7 +124,7 @@ declare global {
          * DataTables API.
          * @param opts Configuration settings
          */
-        dataTable(opts?: Config): JQueryDataTables;
+        dataTable: JQueryDataTableJq;
     }
 }
 
@@ -573,6 +587,7 @@ export interface ConfigSearch {
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  * API
  */
+
 export interface Api<T> {
     /**
      * API should be array-like
@@ -955,7 +970,7 @@ export interface Api<T> {
      * @param tableSelector Table selector.
      * @returns DataTables API instance with selected table in its context.
      */
-    table(tableSelector: any): ApiTableMethods<T> | Api<Array<any>>;
+    table(tableSelector?: any): ApiTableMethods<T>;
 
     /**
      * Select tables based on the given selector
@@ -963,7 +978,7 @@ export interface Api<T> {
      * @param tableSelector Table selector.
      * @returns DataTables API instance with all tables in the current context.
      */
-    tables(tableSelector?: any): ApiTablesMethods<T> | Api<Array<any>>;
+    tables(tableSelector?: any): ApiTablesMethods<T>;
 
     /**
      * Convert the API instance to a jQuery object, with the objects from the instance's result set in the jQuery result set.
@@ -2034,7 +2049,7 @@ export interface ApiTablesMethods<T> extends Api<T> {
 
 
 
-export interface ApiStatic {
+export interface DataTablesStatic {
     /**
      * Check if a table node is a DataTable already or not.
      *
@@ -2051,7 +2066,7 @@ export interface ApiStatic {
      * The options defined here can be used with the `columns.render` initialisation
      * option to provide a display renderer.
      */
-    render: ApiStaticRender;
+    render: DataTablesStaticRender;
 
     /**
      * Get all DataTable tables that have been initialised - optionally you can select to get only currently visible tables and / or retrieve the tables as API instances.
@@ -2085,14 +2100,14 @@ export interface ApiStatic {
     /**
      * Utils
      */
-    util: ApiStaticUtil;
+    util: DataTablesStaticUtil;
 
     /**
      * Get DataTable API instance
      *
      * @param table Selector string for table
      */
-    Api: new (selector: string | Node | Node[] | JQuery) => Api<any>;
+    Api: ApiStatic;
 
     /**
      * Default Settings
@@ -2102,7 +2117,18 @@ export interface ApiStatic {
     /**
      * Default Settings
      */
-    ext: ApiStaticExt;
+    ext: DataTablesStaticExt;
+}
+
+export interface ApiStatic {
+    /**
+     * Create a new API instance to an existing DataTable. Note that this
+     * does not create a new DataTable.
+     */
+    new (selector: string | Node | Node[] | JQuery | InternalSettings): Api<any>;
+
+    register<T=any>(name: string, fn: Function): T;
+    registerPlural<T=any>(name: string, fn: Function): T;
 }
 
 export interface OrderFixed {
@@ -2121,7 +2147,7 @@ export interface OrderFixed {
     post?: any[];
 }
 
-export interface ApiStaticRender {
+export interface DataTablesStaticRender {
     /**
      * Format an ISO8061 date in auto locale detected format
      */
@@ -2210,7 +2236,7 @@ export interface ApiStaticRender {
     time(from?: string, to?: string, locale?: string, def?: string): ObjectColumnRender;
 }
 
-export interface ApiStaticUtil {
+export interface DataTablesStaticUtil {
     /**
      * Escape special characters in a regular expression string. Since: 1.10.4
      *
@@ -2318,8 +2344,9 @@ interface CellMetaSettings {
     settings: InternalSettings;
 }
 
-export interface ApiStaticExt {
+export interface DataTablesStaticExt {
     builder: string;
+    buttons: {[key: string]: object};
     classes: ExtClassesSettings;
     errMode: string;
     feature: any[];