Merge branch 'stdlib-js:develop' into Quantile

Author: saurabhraghuvanshii

.github/workflows/lint_changed_files.yml

@@ -72,8 +72,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15
@@ -120,7 +133,7 @@ jobs:
       - name: 'Lint against EditorConfig'
         if: success() || failure()
         run: |
-          make lint-editorconfig-files FILES="${{ steps.changed-files.outputs.files }}"
+          make lint-editorconfig-files EDITORCONFIG_FORMAT=github-actions FILES="${{ steps.changed-files.outputs.files }}"
 
       # Lint Markdown files:
       - name: 'Lint Markdown files'

.github/workflows/run_affected_benchmarks.yml

@@ -78,8 +78,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15

.github/workflows/run_affected_examples.yml

@@ -79,8 +79,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15

.github/workflows/run_affected_tests.yml

@@ -114,8 +114,21 @@ jobs:
           node-version: '20' # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15

.github/workflows/run_tests_coverage.yml

@@ -120,8 +120,21 @@ jobs:
           node-version: 20 # 'lts/*'
         timeout-minutes: 5
 
+      # Cache dependencies:
+      - name: 'Cache dependencies'
+        # Pin action to full length commit SHA
+        uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+        id: cache
+        with:
+          path: |
+            ${{ github.workspace }}/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
       # Install dependencies (accounting for possible network failures, etc, when installing node module dependencies):
       - name: 'Install dependencies'
+        if: steps.cache.outputs.cache-hit != 'true'
         run: |
           make install-node-modules || make install-node-modules || make install-node-modules
         timeout-minutes: 15

lib/node_modules/@stdlib/_tools/eslint/rules/repl-namespace-order/README.md

@@ -38,7 +38,7 @@ var rule = require( '@stdlib/_tools/eslint/rules/repl-namespace-order' );
 
 #### rule
 
-[ESLint rule][eslint-rules] to enforce that packages are added to a REPL namespace object in alphabetical order according to alias (namespace key). 
+[ESLint rule][eslint-rules] to enforce that packages are added to a REPL namespace object in alphabetical order according to alias (namespace key).
 
 **Bad**:
 
@@ -117,8 +117,6 @@ var result;
 var code;
 
 code = [
-    '/* eslint-enable stdlib/repl-namespace-order */',
-    '',
     '/* When adding names to the namespace, ensure that they are added in alphabetical order according to alias (namespace key). */',
     '',
     'ns.push({',

lib/node_modules/@stdlib/_tools/eslint/rules/repl-namespace-order/examples/index.js

@@ -26,8 +26,6 @@ var result;
 var code;
 
 code = [
-	'/* eslint-enable stdlib/repl-namespace-order */',
-	'',
 	'/* When adding names to the namespace, ensure that they are added in alphabetical order according to alias (namespace key). */',
 	'',
 	'ns.push({',

lib/node_modules/@stdlib/_tools/eslint/rules/repl-namespace-order/lib/main.js

@@ -37,43 +37,81 @@ var OPTS_COMPARE = {
 * @returns {Object} validators
 */
 function main( context ) {
+	var expressions;
 	var prevAlias;
 
-	return {
-		'ObjectExpression': validate
-	};
+	expressions = [];
 
 	/**
-	* Checks whether packages are added to a REPL namespace object in alphabetical order according to alias (namespace key).
+	* Extracts the alias value from a given node.
 	*
 	* @private
-	* @param {ASTNode} node - node to examine
+	* @param {ASTNode} node - node containing properties to search
+	* @returns {string} alias value
 	*/
-	function validate( node ) {
-		var properties;
+	function getAlias( node ) {
+		var props;
 		var alias;
-		var prop;
 		var i;
 
-		properties = node.properties;
-		for ( i = 0; i < properties.length; i++ ) {
-			prop = properties[ i ];
-			if ( prop.key.value === 'alias' ) {
-				alias = prop.value.value;
+		props = node.properties;
+		for ( i = 0; i < props.length; i++ ) {
+			if ( props[ i ].key.value === 'alias' ) {
+				alias = props[ i ].value.value;
 				if ( alias ) {
-					if (
-						prevAlias &&
-						alias.localeCompare( prevAlias, 'en', OPTS_COMPARE ) < 0 )
-					{
-						report( prevAlias, alias, node );
-					} else {
-						prevAlias = alias;
-					}
+					return alias;
 				}
 			}
 		}
 	}
 
+	/**
+	* Compares two nodes and determines their order based on the alias property.
+	*
+	* @private
+	* @param {ASTNode} a - first node
+	* @param {ASTNode} b - second node
+	* @returns {number} number indicating sort order
+	*/
+	function sortExpressions( a, b ) {
+		var aliasA = getAlias( a.arguments[ 0 ] );
+		var aliasB = getAlias( b.arguments[ 0 ] );
+		return aliasA.localeCompare( aliasB, 'en', OPTS_COMPARE );
+	}
+
+	/**
+	* Fixes the lint error by reordering the packages.
+	*
+	* @private
+	* @param {Function} fixer - ESLint fixer
+	* @returns {(Object|null)} fix or null
+	*/
+	function fix( fixer ) {
+		var replacingText;
+		var startRange;
+		var endRange;
+		var sorted;
+		var source;
+		var txt;
+		var i;
+
+		source = context.getSourceCode();
+		replacingText = '';
+		startRange = expressions[0].range[ 0 ];
+		endRange = expressions[ expressions.length - 1 ].range[ 1 ];
+
+		sorted = expressions.slice().sort( sortExpressions );
+
+		for ( i = 0; i < sorted.length; i++ ) {
+			txt = source.getText( sorted[ i ] );
+			replacingText += txt;
+			if ( i < sorted.length - 1 ) {
+				replacingText += ';\n\n';
+			}
+		}
+		return fixer.replaceTextRange( [ startRange, endRange ], replacingText ); // eslint-disable-line max-len
+	}
+
 	/**
 	* Reports the error message.
 	*
@@ -85,19 +123,74 @@ function main( context ) {
 	function report( last, current, node ) {
 		context.report({
 			'node': node,
-			'message': '"'+current+'" should come before "'+last+'"'
+			'message': '"'+current+'" should come before "'+last+'"',
+			'fix': fix
 		});
 	}
+
+	/**
+	* Checks whether the packages are added to a REPL namespace object in alphabetical order according to alias (namespace key).
+	*
+	* @private
+	*/
+	function validate() {
+		var alias;
+		var i;
+
+		for ( i = 0; i < expressions.length; i++ ) {
+			alias = getAlias( expressions[ i ].arguments[ 0 ] );
+			if (
+				prevAlias &&
+				alias.localeCompare( prevAlias, 'en', OPTS_COMPARE ) < 0
+			) {
+				report( prevAlias, alias, expressions[ i ].arguments[ 0 ] );
+			} else {
+				prevAlias = alias;
+			}
+		}
+	}
+
+	/**
+	* Collects all expressions which add a package to a REPL namespace.
+	*
+	* @private
+	* @param {ASTNode} node - node to examine
+	*/
+	function collectExpressions( node ) {
+		var object;
+		var alias;
+
+		if (
+			node.callee.type === 'MemberExpression' &&
+			node.callee.object.name === 'ns' &&
+			node.callee.property.name === 'push'
+		) {
+			object = node.arguments[ 0 ];
+			if ( object.type === 'ObjectExpression' ) {
+				alias = getAlias( object );
+				if ( alias ) {
+					expressions.push( node );
+				}
+			}
+		}
+	}
+
+	return {
+		'CallExpression': collectExpressions,
+		'Program:exit': validate
+	};
 }
 
 
 // MAIN //
 
 rule = {
 	'meta': {
+		'type': 'suggestion',
 		'docs': {
 			'description': 'enforce that packages are added to a REPL namespace object in alphabetical order according to alias (namespace key)'
 		},
+		'fixable': 'code',
 		'schema': []
 	},
 	'create': main