feat: implement toLocaleString method in dstructs/named-typed-tuple

lib/node_modules/@stdlib/dstructs/named-typed-tuple/examples/index.js

@@ -57,5 +57,8 @@ console.log( p.orderedFields );
 // Serialize the tuple as a string:
 console.log( p.toString() );
 
+// Serialize the tuple as a locale string
+console.log( p.toLocaleString() );
+
 // Serialize the tuple a JSON string:
 console.log( JSON.stringify( p ) );

lib/node_modules/@stdlib/dstructs/named-typed-tuple/lib/main.js

@@ -204,6 +204,7 @@ function factory( names, options ) { // eslint-disable-line max-lines-per-functi
 		setNonEnumerableProperty( tuple, 'sort', sort );
 		setNonEnumerableProperty( tuple, 'subtuple', subtuple );
 		setNonEnumerableProperty( tuple, 'toJSON', toJSON );
+		setNonEnumerableProperty( tuple, 'toLocaleString', toLocaleString );
 		setNonEnumerableProperty( tuple, 'toString', toString );
 
 		return tuple;
@@ -1198,7 +1199,33 @@ function factory( names, options ) { // eslint-disable-line max-lines-per-functi
 			return out;
 		}
 
-		// TODO: consider adding `toLocaleString()` in a manner similar to `toString()` below
+		/**
+		* Serializes a tuple as a locale-aware string.
+		*
+		* @private
+		* @memberof tuple
+		* @param {(string|string[])} [locales] - locale(s)
+		* @param {Object} [options] - formatting options
+		* @throws {TypeError} `this` must be the host tuple
+		* @returns {string} tuple locale string representation
+		*/
+		function toLocaleString( locales, options ) {
+			var out = [];
+			var val;
+			var i;
+			if ( this !== tuple ) { // eslint-disable-line no-invalid-this
+				throw new TypeError( 'invalid invocation. `this` is not host tuple.' );
+			}
+			for ( i = 0; i < nfields; i++ ) {
+				val = tuple[ indices[ i ] ];
+				if ( val && typeof val.toLocaleString === 'function' ) {
+					out.push( val.toLocaleString( locales, options ) );
+				} else {
+					out.push( String( val ) );
+				}
+			}
+			return out.join(',');
+		}
 
 		/**
 		* Serializes a tuple as a string.