feat: add support for enforcing traversal order

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/ndarray/base/unary-strided1d/lib/defaults.js

@@ -0,0 +1,43 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+'use strict';
+
+// MAIN //
+
+/**
+* Returns default options.
+*
+* @private
+* @returns {Object} default options
+*
+* @example
+* var o = defaults();
+* // returns {...}
+*/
+function defaults() {
+	return {
+		// Require that the order of element traversal match the memory layout of an input ndarray:
+		'strictTraversalOrder': false
+	};
+}
+
+
+// EXPORTS //
+
+module.exports = defaults;

lib/node_modules/@stdlib/ndarray/base/unary-strided1d/lib/factory.js

@@ -21,7 +21,7 @@
 // MODULES //
 
 var isFunction = require( '@stdlib/assert/is-function' );
-var format = require( '@stdlib/string/format' );
+var mainFactory = require( './main_factory.js' );
 var main = require( './main.js' );
 
 
@@ -30,8 +30,11 @@ var main = require( './main.js' );
 /**
 * Return a function for applying a one-dimensional strided array function to a list of specified dimensions in an input ndarray and assigning results to a provided output ndarray.
 *
-* @param {Function} fcn - wrapper for a one-dimensional strided array function
-* @throws {TypeError} first argument must be a function
+* @param {Function} [fcn] - wrapper for a one-dimensional strided array function
+* @param {Options} [options] - function options
+* @param {boolean} [options.strictTraversalOrder=false] - boolean specifying whether to require that element traversal match the memory layout of an input ndarray
+* @throws {TypeError} options argument must be an object
+* @throws {TypeError} must provide valid options
 * @returns {Function} function for applying a strided array function
 *
 * @example
@@ -106,11 +109,37 @@ var main = require( './main.js' );
 * var arr = ndarray2array( y.data, y.shape, y.strides, y.offset, y.order );
 * // returns [ [ [ [ 1.0, 3.0 ], [ 6.0, 10.0 ] ], [ [ 5.0, 11.0 ], [ 18.0, 26.0 ] ], [ [ 9.0, 19.0 ], [ 30.0, 42.0 ] ] ] ]
 */
-function factory( fcn ) {
-	if ( !isFunction( fcn ) ) {
-		throw new TypeError( format( 'invalid argument. First argument must be a function. Value: `%s`.', fcn ) );
+function factory() {
+	var nargs;
+	var unary;
+	var fcn;
+	var f;
+
+	nargs = arguments.length;
+
+	// Case: factory()
+	if ( nargs === 0 ) {
+		unary = main;
+		f = wrap;
+	}
+	// Case: factory( fcn, opts )
+	else if ( nargs > 1 ) {
+		unary = mainFactory( arguments[ 1 ] );
+		fcn = arguments[ 0 ];
+		f = apply;
 	}
-	return apply;
+	// Case: factory( fcn )
+	else if ( isFunction( arguments[ 0 ] ) ) {
+		unary = main;
+		fcn = arguments[ 0 ];
+		f = apply;
+	}
+	// Case: factory( opts )
+	else {
+		unary = mainFactory( arguments[ 0 ] );
+		f = wrap;
+	}
+	return f;
 
 	/**
 	* Applies a one-dimensional strided array function to a list of specified dimensions in an input ndarray and assigns results to a provided output ndarray.
@@ -128,7 +157,27 @@ function factory( fcn ) {
 		} else {
 			opts = {};
 		}
-		return main( fcn, arrays, dims, opts );
+		return unary( fcn, arrays, dims, opts );
+	}
+
+	/**
+	* Applies a one-dimensional strided array function to a list of specified dimensions in an input ndarray and assigns results to a provided output ndarray.
+	*
+	* @private
+	* @param {Function} fcn - wrapper for a one-dimensional strided array function
+	* @param {ArrayLikeObject<Object>} arrays - array-like object containing ndarrays
+	* @param {IntegerArray} dims - list of dimensions to which to apply a strided array function
+	* @param {Options} [options] - function options
+	* @returns {void}
+	*/
+	function wrap( fcn, arrays, dims, options ) {
+		var opts;
+		if ( arguments.length > 3 ) {
+			opts = options;
+		} else {
+			opts = {};
+		}
+		return unary( fcn, arrays, dims, opts );
 	}
 }
 

lib/node_modules/@stdlib/ndarray/base/unary-strided1d/lib/index.js

@@ -168,9 +168,16 @@
 
 // MODULES //
 
+var setReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' );
+var factory = require( './factory.js' );
 var main = require( './main.js' );
 
 
+// MAIN //
+
+setReadOnly( main, 'factory', factory );
+
+
 // EXPORTS //
 
 module.exports = main;