From 92874ede79de2880f40dc3e99e73959e3a7db397 Mon Sep 17 00:00:00 2001
From: Stephannie Jimenez <steff456@hotmail.com>
Date: Mon, 30 Oct 2023 14:26:44 -0500
Subject: [PATCH 1/4] feat: add truncate-middle-code-point string package

---
 .../base/truncate-middle-code-point/README.md |  96 +++++++++++++++
 .../benchmark/benchmark.js                    |  56 +++++++++
 .../truncate-middle-code-point/docs/repl.txt  |  31 +++++
 .../docs/types/index.d.ts                     |  59 ++++++++++
 .../docs/types/test.ts                        |  64 ++++++++++
 .../examples/index.js                         |  41 +++++++
 .../truncate-middle-code-point/lib/index.js   |  43 +++++++
 .../truncate-middle-code-point/lib/main.js    | 110 ++++++++++++++++++
 .../truncate-middle-code-point/package.json   |  68 +++++++++++
 .../truncate-middle-code-point/test/test.js   |  93 +++++++++++++++
 10 files changed, 661 insertions(+)
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json
 create mode 100644 lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js

diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
new file mode 100644
index 000000000000..b1fd3640d253
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
@@ -0,0 +1,96 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 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.
+
+-->
+
+# truncateMiddleCodePoint
+
+> Truncate code points of string in the middle to a specified length.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var truncateMiddleCodePoint = require( '@stdlib/string/base/truncate-middle-code-point' );
+```
+
+#### truncateMiddleCodePoint( str, len\[, seq] )
+
+Truncates code points of string in the middle to a specified length.
+
+```javascript
+var out = truncateMiddleCodePoint( 'beep boop', 7 );
+// returns 'be...op'
+```
+
+By default, the truncated string uses the replacement sequence `'...'`. To customize the replacement sequence, provide a `seq` argument:
+
+```javascript
+var out = truncateMiddleCodePoint( 'beep boop', 7, '!' );
+// returns 'bee!oop'
+
+out = truncateMiddleCodePoint( 'beep boop', 7, '!!!' );
+// returns 'be!!!op'
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var truncateMiddleCodePoint = require( '@stdlib/string/base/truncate-middle-code-point' );
+
+var str = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.';
+var out = truncateMiddleCodePoint( str, 15 );
+// returns 'Lorem ... elit.'
+
+str = 'To be or not to be, that is the question';
+out = truncateMiddleCodePoint( str, 19, '|' );
+// returns 'To be or | question'
+
+str = 'The quick fox jumps over the lazy dog.';
+out = truncateMiddleCodePoint( str, 28, '...' );
+// returns 'The quick fox...he lazy dog.'
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js
new file mode 100644
index 000000000000..dd7188b820d4
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js
@@ -0,0 +1,56 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
+var pkg = require( './../package.json' ).name;
+var truncateMiddle = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg, function benchmark( b ) {
+	var values;
+	var out;
+	var i;
+
+	values = [
+		'beep boop',
+		'foo bar',
+		'xyz abc',
+		'🐶🐮🐷🐰🐸'
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		out = truncateMiddle( values[ i%values.length ], 1 );
+		if ( typeof out !== 'string' ) {
+			b.fail( 'should return a string' );
+		}
+	}
+	b.toc();
+	if ( !isString( out ) ) {
+		b.fail( 'should return a string' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
new file mode 100644
index 000000000000..f71dba5f8c96
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
@@ -0,0 +1,31 @@
+
+{{alias}}( str, len[, seq] )
+    Truncates code points of string in the middle to a specified length.
+
+    Parameters
+    ----------
+    str: string
+        Input string.
+
+    len: integer
+        Output string length.
+
+    seq: string (optional)
+        Custom replacement sequence. Default: '...'.
+
+    Returns
+    -------
+    out: string
+        Truncated string.
+
+    Examples
+    --------
+    > var str = 'beep boop';
+    > var out = {{alias}}( str, 5 )
+    'b...p'
+
+    > out = {{alias}}( str, 5, '|' )
+    'be|op'
+
+    See Also
+    --------
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
new file mode 100644
index 000000000000..c19c595019da
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
@@ -0,0 +1,59 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Truncates code points of string in the middle to a specified length.
+*
+* @param str - input string
+* @param len - output string length (including sequence)
+* @param seq - custom replacement sequence (default: `...`)
+* @returns truncated string
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 5 );
+* // returns 'b...p'
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 5, '>>>' );
+* // returns 'b>>>p'
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 10 );
+* // returns 'beep boop'
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 0 );
+* // returns ''
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 2 );
+* // returns '..'
+*/
+declare function truncateMiddle( str: string, len: number, seq?: string ): string; // tslint-disable-line max-line-length
+
+
+// EXPORTS //
+
+export = truncateMiddle;
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts
new file mode 100644
index 000000000000..e202cfab6c1d
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts
@@ -0,0 +1,64 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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.
+*/
+
+import truncateMiddle = require( './index' );
+
+
+// TESTS //
+
+// The function returns a string...
+{
+	truncateMiddle( 'abcdefghi', 3 ); // $ExpectType string
+	truncateMiddle( 'abcdefghi', 10, '|' ); // $ExpectType string
+}
+
+//  The compiler throws an error if the function is not provided a string as its first argument...
+{
+	truncateMiddle( true, 6 ); // $ExpectError
+	truncateMiddle( false, 6 ); // $ExpectError
+	truncateMiddle( 3, 6 ); // $ExpectError
+	truncateMiddle( [], 6 ); // $ExpectError
+	truncateMiddle( {}, 6 ); // $ExpectError
+	truncateMiddle( ( x: number ): number => x, 6 ); // $ExpectError
+}
+
+//  The compiler throws an error if the function is not provided a number as its second argument...
+{
+	truncateMiddle( 'abd', true ); // $ExpectError
+	truncateMiddle( 'abd', false ); // $ExpectError
+	truncateMiddle( 'abd', 'abc' ); // $ExpectError
+	truncateMiddle( 'abd', [], 0 ); // $ExpectError
+	truncateMiddle( 'abd', {}, 0 ); // $ExpectError
+	truncateMiddle( 'abd', ( x: number ): number => x, 0 ); // $ExpectError
+}
+
+//  The compiler throws an error if the function is not provided a string as its third argument...
+{
+	truncateMiddle( 'beep boop', 4, true ); // $ExpectError
+	truncateMiddle( 'beep boop', 4, false ); // $ExpectError
+	truncateMiddle( 'beep boop', 4, 123 ); // $ExpectError
+	truncateMiddle( 'beep boop', 4, [], 0 ); // $ExpectError
+	truncateMiddle( 'beep boop', 4, {}, 0 ); // $ExpectError
+	truncateMiddle( 'beep boop', 4, ( x: number ): number => x, 0 ); // $ExpectError
+}
+
+// The compiler throws an error if the function is provided an unsupported number of arguments...
+{
+	truncateMiddle(); // $ExpectError
+	truncateMiddle( 'abc', 4, '|', true ); // $ExpectError
+}
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js
new file mode 100644
index 000000000000..17cd3c2fa7d0
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js
@@ -0,0 +1,41 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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';
+
+var truncateMiddle = require( './../lib' );
+
+var str = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.';
+var out = truncateMiddle( str, 15 );
+console.log( out );
+// => 'Lorem ... elit.'
+
+str = 'To be or not to be, that is the question';
+out = truncateMiddle( str, 19, '|' );
+console.log( out );
+// => 'To be or | question'
+
+str = 'The quick fox jumps over the lazy dog.';
+out = truncateMiddle( str, 28, '...' );
+console.log( out );
+// => 'The quick fox...he lazy dog.'
+
+str = 'अनुच्छेद';
+out = truncateMiddle( str, 6, '...' );
+console.log( out );
+// => 'अनुच्...छेद'
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
new file mode 100644
index 000000000000..24149fa09fe8
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
@@ -0,0 +1,43 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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';
+
+/**
+* Truncate code points of string in the middle to a specified length.
+*
+* @module @stdlib/string/base/truncate-middle-code-point
+*
+* @example
+* var truncateMiddle = require( '@stdlib/string/base/truncate-middle-code-point' );
+*
+* var out = truncateMiddle( 'beep boop', 7 );
+* // returns 'be...op'
+*
+* out = truncateMiddle( 'beep boop', 7, '|' );
+* // returns 'bee|oop'
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
new file mode 100644
index 000000000000..1211aa2d7343
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
@@ -0,0 +1,110 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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';
+
+// MODULES //
+
+var round = require( '@stdlib/math/base/special/round' );
+var floor = require( '@stdlib/math/base/special/floor' );
+var numCodePoints = require( '@stdlib/string/num-code-points' );
+var nextCodePoint = require( '@stdlib/string/next-code-point' );
+
+
+// MAIN //
+
+/**
+* Truncates code points of string in the middle to a specified length.
+*
+* @param {string} str - input string
+* @param {integer} len - output string length (including sequence)
+* @param {string} [seq='...'] - custom replacement sequence
+* @returns {string} truncated string
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 5 );
+* // returns 'b...p'
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 5, '>>>' );
+* // returns 'b>>>p'
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 10 );
+* // returns 'beep boop'
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 0 );
+* // returns ''
+*
+* @example
+* var str = 'beep boop';
+* var out = truncateMiddle( str, 2 );
+* // returns '..'
+*/
+function truncateMiddle( str, len, seq ) {
+	var seqLength;
+	var strLength;
+	var seqStart;
+	var fromIdx;
+	var nVisual;
+	var seqEnd;
+	var idx1;
+	var idx2;
+
+	seq = seq || '...';
+	seqLength = numCodePoints( seq );
+	strLength = numCodePoints( str );
+	fromIdx = 0;
+	if ( len > strLength ) {
+		return str;
+	}
+	if ( len - seqLength < 0 ) {
+		return seq.slice( 0, len );
+	}
+	seqStart = round( ( len - seqLength ) / 2 );
+	seqEnd = strLength - floor( ( len - seqLength ) / 2 );
+	nVisual = 0;
+	while( nVisual < seqStart ) {
+		idx1 = nextCodePoint( str, fromIdx );
+		fromIdx = idx1;
+		nVisual += 1;
+	}
+	idx2 = idx1;
+	while( idx2 > 0 ) {
+		idx2 = nextCodePoint( str, fromIdx );
+		if ( idx2 >= seqEnd + fromIdx - nVisual ) {
+			break;
+		}
+		fromIdx = idx2;
+		nVisual += 1;
+	}
+	if ( idx2 === -1 ) {
+		idx2 = strLength - 1;
+	}
+	return str.substring( 0, idx1 ) + seq + str.substring( idx2 );
+}
+
+
+// EXPORTS //
+
+module.exports = truncateMiddle;
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json
new file mode 100644
index 000000000000..7985c5c439aa
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json
@@ -0,0 +1,68 @@
+{
+  "name": "@stdlib/string/base/truncate-middle-code-point",
+  "version": "0.0.0",
+  "description": "Truncate code points of string in the middle to a specified length.",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "The Stdlib Authors",
+    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+  },
+  "contributors": [
+    {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    }
+  ],
+  "main": "./lib",
+  "directories": {
+    "benchmark": "./benchmark",
+    "doc": "./docs",
+    "example": "./examples",
+    "lib": "./lib",
+    "test": "./test"
+  },
+  "types": "./docs/types",
+  "scripts": {},
+  "homepage": "https://github.com/stdlib-js/stdlib",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stdlib-js/stdlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdlib-js/stdlib/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "engines": {
+    "node": ">=0.10.0",
+    "npm": ">2.7.0"
+  },
+  "os": [
+    "aix",
+    "darwin",
+    "freebsd",
+    "linux",
+    "macos",
+    "openbsd",
+    "sunos",
+    "win32",
+    "windows"
+  ],
+  "keywords": [
+    "stdlib",
+    "stdstring",
+    "utilities",
+    "utility",
+    "utils",
+    "util",
+    "string",
+    "str",
+    "base",
+    "truncate",
+    "middle",
+    "character",
+    "char",
+    "codeunit",
+    "unicode"
+  ]
+}
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js
new file mode 100644
index 000000000000..2efbfbcb63d3
--- /dev/null
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js
@@ -0,0 +1,93 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var truncateMiddle = require( './../lib' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.strictEqual( typeof truncateMiddle, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'the function truncates a string to the specified length', function test( t ) {
+	var expected;
+	var actual;
+	var str;
+	var len;
+
+	str = 'beep boop';
+	len = 5;
+	expected = 'b...p';
+	actual = truncateMiddle( str, len );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	str = 'beep boop';
+	len = 10;
+	expected = 'beep boop';
+	actual = truncateMiddle( str, len );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	str = 'beep boop';
+	len = 0;
+	expected = '';
+	actual = truncateMiddle( str, len );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	str = 'beep boop';
+	len = 1;
+	expected = '.';
+	actual = truncateMiddle( str, len );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	t.end();
+});
+
+tape( 'the function truncates a string to the specified length (custom replacement sequence)', function test( t ) {
+	var expected;
+	var actual;
+	var str;
+	var len;
+
+	str = 'beep boop';
+	len = 5;
+	expected = 'be|op';
+	actual = truncateMiddle( str, len, '|' );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	str = 'beep boop';
+	len = 10;
+	expected = 'beep boop';
+	actual = truncateMiddle( str, len, '!' );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	str = 'beep boop';
+	len = 3;
+	expected = 'b!p';
+	actual = truncateMiddle( str, len, '!' );
+	t.strictEqual( actual, expected, 'returns expected value' );
+
+	t.end();
+});

From 13df71f20c5eed6fb4f88c8e7830d1a450d6eb67 Mon Sep 17 00:00:00 2001
From: Stephannie Jimenez <steff456@hotmail.com>
Date: Wed, 8 Nov 2023 11:46:01 -0500
Subject: [PATCH 2/4] set seq argument mandatory

---
 .../base/truncate-middle-code-point/README.md | 12 +++------
 .../benchmark/benchmark.js                    |  2 +-
 .../truncate-middle-code-point/docs/repl.txt  |  8 +++---
 .../docs/types/index.d.ts                     | 12 ++++-----
 .../docs/types/test.ts                        | 26 +++++++++----------
 .../truncate-middle-code-point/lib/index.js   |  2 +-
 .../truncate-middle-code-point/lib/main.js    | 11 ++++----
 .../truncate-middle-code-point/test/test.js   |  8 +++---
 8 files changed, 38 insertions(+), 43 deletions(-)

diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
index b1fd3640d253..d595d7d505bd 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
@@ -30,19 +30,15 @@ limitations under the License.
 var truncateMiddleCodePoint = require( '@stdlib/string/base/truncate-middle-code-point' );
 ```
 
-#### truncateMiddleCodePoint( str, len\[, seq] )
+#### truncateMiddleCodePoint( str, len, seq )
 
 Truncates code points of string in the middle to a specified length.
 
 ```javascript
-var out = truncateMiddleCodePoint( 'beep boop', 7 );
+var out = truncateMiddleCodePoint( 'beep boop', 7, '...' );
 // returns 'be...op'
-```
-
-By default, the truncated string uses the replacement sequence `'...'`. To customize the replacement sequence, provide a `seq` argument:
 
-```javascript
-var out = truncateMiddleCodePoint( 'beep boop', 7, '!' );
+out = truncateMiddleCodePoint( 'beep boop', 7, '!' );
 // returns 'bee!oop'
 
 out = truncateMiddleCodePoint( 'beep boop', 7, '!!!' );
@@ -63,7 +59,7 @@ out = truncateMiddleCodePoint( 'beep boop', 7, '!!!' );
 var truncateMiddleCodePoint = require( '@stdlib/string/base/truncate-middle-code-point' );
 
 var str = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.';
-var out = truncateMiddleCodePoint( str, 15 );
+var out = truncateMiddleCodePoint( str, 15, '...' );
 // returns 'Lorem ... elit.'
 
 str = 'To be or not to be, that is the question';
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js
index dd7188b820d4..6b9fc723d42d 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/benchmark/benchmark.js
@@ -42,7 +42,7 @@ bench( pkg, function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		out = truncateMiddle( values[ i%values.length ], 1 );
+		out = truncateMiddle( values[ i%values.length ], 1, '...' );
 		if ( typeof out !== 'string' ) {
 			b.fail( 'should return a string' );
 		}
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
index f71dba5f8c96..dc191ea29672 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
@@ -1,5 +1,5 @@
 
-{{alias}}( str, len[, seq] )
+{{alias}}( str, len, seq )
     Truncates code points of string in the middle to a specified length.
 
     Parameters
@@ -10,8 +10,8 @@
     len: integer
         Output string length.
 
-    seq: string (optional)
-        Custom replacement sequence. Default: '...'.
+    seq: string
+        Custom replacement sequence.
 
     Returns
     -------
@@ -21,7 +21,7 @@
     Examples
     --------
     > var str = 'beep boop';
-    > var out = {{alias}}( str, 5 )
+    > var out = {{alias}}( str, 5, '...' )
     'b...p'
 
     > out = {{alias}}( str, 5, '|' )
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
index c19c595019da..5f770e62fd38 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
@@ -23,12 +23,12 @@
 *
 * @param str - input string
 * @param len - output string length (including sequence)
-* @param seq - custom replacement sequence (default: `...`)
+* @param seq - custom replacement sequence
 * @returns truncated string
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 5 );
+* var out = truncateMiddle( str, 5, '...' );
 * // returns 'b...p'
 *
 * @example
@@ -38,20 +38,20 @@
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 10 );
+* var out = truncateMiddle( str, 10, '...' );
 * // returns 'beep boop'
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 0 );
+* var out = truncateMiddle( str, 0, '...' );
 * // returns ''
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 2 );
+* var out = truncateMiddle( str, 2, '...' );
 * // returns '..'
 */
-declare function truncateMiddle( str: string, len: number, seq?: string ): string; // tslint-disable-line max-line-length
+declare function truncateMiddle( str: string, len: number, seq: string ): string; // tslint-disable-line max-line-length
 
 
 // EXPORTS //
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts
index e202cfab6c1d..b43796e8bde0 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/test.ts
@@ -23,28 +23,28 @@ import truncateMiddle = require( './index' );
 
 // The function returns a string...
 {
-	truncateMiddle( 'abcdefghi', 3 ); // $ExpectType string
+	truncateMiddle( 'abcdefghi', 3, '...' ); // $ExpectType string
 	truncateMiddle( 'abcdefghi', 10, '|' ); // $ExpectType string
 }
 
 //  The compiler throws an error if the function is not provided a string as its first argument...
 {
-	truncateMiddle( true, 6 ); // $ExpectError
-	truncateMiddle( false, 6 ); // $ExpectError
-	truncateMiddle( 3, 6 ); // $ExpectError
-	truncateMiddle( [], 6 ); // $ExpectError
-	truncateMiddle( {}, 6 ); // $ExpectError
-	truncateMiddle( ( x: number ): number => x, 6 ); // $ExpectError
+	truncateMiddle( true, 6, '...' ); // $ExpectError
+	truncateMiddle( false, 6, '...' ); // $ExpectError
+	truncateMiddle( 3, 6, '...' ); // $ExpectError
+	truncateMiddle( [], 6, '...' ); // $ExpectError
+	truncateMiddle( {}, 6, '...' ); // $ExpectError
+	truncateMiddle( ( x: number ): number => x, 6, '...' ); // $ExpectError
 }
 
 //  The compiler throws an error if the function is not provided a number as its second argument...
 {
-	truncateMiddle( 'abd', true ); // $ExpectError
-	truncateMiddle( 'abd', false ); // $ExpectError
-	truncateMiddle( 'abd', 'abc' ); // $ExpectError
-	truncateMiddle( 'abd', [], 0 ); // $ExpectError
-	truncateMiddle( 'abd', {}, 0 ); // $ExpectError
-	truncateMiddle( 'abd', ( x: number ): number => x, 0 ); // $ExpectError
+	truncateMiddle( 'abd', true, '...' ); // $ExpectError
+	truncateMiddle( 'abd', false, '...' ); // $ExpectError
+	truncateMiddle( 'abd', 'abc', '...' ); // $ExpectError
+	truncateMiddle( 'abd', [], '...' ); // $ExpectError
+	truncateMiddle( 'abd', {}, '...' ); // $ExpectError
+	truncateMiddle( 'abd', ( x: number ): number => x, '...' ); // $ExpectError
 }
 
 //  The compiler throws an error if the function is not provided a string as its third argument...
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
index 24149fa09fe8..0af6c4ff2e7e 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
@@ -26,7 +26,7 @@
 * @example
 * var truncateMiddle = require( '@stdlib/string/base/truncate-middle-code-point' );
 *
-* var out = truncateMiddle( 'beep boop', 7 );
+* var out = truncateMiddle( 'beep boop', 7, '...' );
 * // returns 'be...op'
 *
 * out = truncateMiddle( 'beep boop', 7, '|' );
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
index 1211aa2d7343..c4847ea19b39 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
@@ -33,12 +33,12 @@ var nextCodePoint = require( '@stdlib/string/next-code-point' );
 *
 * @param {string} str - input string
 * @param {integer} len - output string length (including sequence)
-* @param {string} [seq='...'] - custom replacement sequence
+* @param {string} seq - custom replacement sequence
 * @returns {string} truncated string
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 5 );
+* var out = truncateMiddle( str, 5, '...' );
 * // returns 'b...p'
 *
 * @example
@@ -48,17 +48,17 @@ var nextCodePoint = require( '@stdlib/string/next-code-point' );
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 10 );
+* var out = truncateMiddle( str, 10, '...' );
 * // returns 'beep boop'
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 0 );
+* var out = truncateMiddle( str, 0, '...' );
 * // returns ''
 *
 * @example
 * var str = 'beep boop';
-* var out = truncateMiddle( str, 2 );
+* var out = truncateMiddle( str, 2, '...' );
 * // returns '..'
 */
 function truncateMiddle( str, len, seq ) {
@@ -71,7 +71,6 @@ function truncateMiddle( str, len, seq ) {
 	var idx1;
 	var idx2;
 
-	seq = seq || '...';
 	seqLength = numCodePoints( seq );
 	strLength = numCodePoints( str );
 	fromIdx = 0;
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js
index 2efbfbcb63d3..ccabaf53e871 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/test/test.js
@@ -41,25 +41,25 @@ tape( 'the function truncates a string to the specified length', function test(
 	str = 'beep boop';
 	len = 5;
 	expected = 'b...p';
-	actual = truncateMiddle( str, len );
+	actual = truncateMiddle( str, len, '...' );
 	t.strictEqual( actual, expected, 'returns expected value' );
 
 	str = 'beep boop';
 	len = 10;
 	expected = 'beep boop';
-	actual = truncateMiddle( str, len );
+	actual = truncateMiddle( str, len, '...' );
 	t.strictEqual( actual, expected, 'returns expected value' );
 
 	str = 'beep boop';
 	len = 0;
 	expected = '';
-	actual = truncateMiddle( str, len );
+	actual = truncateMiddle( str, len, '...' );
 	t.strictEqual( actual, expected, 'returns expected value' );
 
 	str = 'beep boop';
 	len = 1;
 	expected = '.';
-	actual = truncateMiddle( str, len );
+	actual = truncateMiddle( str, len, '...' );
 	t.strictEqual( actual, expected, 'returns expected value' );
 
 	t.end();

From e4345f0f93b0463b166dc18b2cfd3e4454e9cba6 Mon Sep 17 00:00:00 2001
From: Stephannie Jimenez <steff456@hotmail.com>
Date: Wed, 8 Nov 2023 11:56:15 -0500
Subject: [PATCH 3/4] docs: add missing argument in example

---
 .../string/base/truncate-middle-code-point/examples/index.js    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js
index 17cd3c2fa7d0..62e3e1dfbf76 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/examples/index.js
@@ -21,7 +21,7 @@
 var truncateMiddle = require( './../lib' );
 
 var str = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.';
-var out = truncateMiddle( str, 15 );
+var out = truncateMiddle( str, 15, '...' );
 console.log( out );
 // => 'Lorem ... elit.'
 

From ac36347485d05cfceae9507a0f57a65be86b4cf4 Mon Sep 17 00:00:00 2001
From: Stephannie Jimenez <steff456@hotmail.com>
Date: Fri, 10 Nov 2023 10:41:20 -0500
Subject: [PATCH 4/4] docs: update description of the package

---
 .../@stdlib/string/base/truncate-middle-code-point/README.md  | 4 ++--
 .../string/base/truncate-middle-code-point/docs/repl.txt      | 3 ++-
 .../base/truncate-middle-code-point/docs/types/index.d.ts     | 2 +-
 .../string/base/truncate-middle-code-point/lib/index.js       | 2 +-
 .../string/base/truncate-middle-code-point/lib/main.js        | 2 +-
 .../string/base/truncate-middle-code-point/package.json       | 2 +-
 6 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
index d595d7d505bd..2abbbb50edeb 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/README.md
@@ -20,7 +20,7 @@ limitations under the License.
 
 # truncateMiddleCodePoint
 
-> Truncate code points of string in the middle to a specified length.
+> Truncate code points in the middle of a string in order to return a string having a specified length.
 
 <section class="usage">
 
@@ -32,7 +32,7 @@ var truncateMiddleCodePoint = require( '@stdlib/string/base/truncate-middle-code
 
 #### truncateMiddleCodePoint( str, len, seq )
 
-Truncates code points of string in the middle to a specified length.
+Truncates code points in the middle of a string in order to return a string having a specified length.
 
 ```javascript
 var out = truncateMiddleCodePoint( 'beep boop', 7, '...' );
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
index dc191ea29672..d4583f892b27 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/repl.txt
@@ -1,6 +1,7 @@
 
 {{alias}}( str, len, seq )
-    Truncates code points of string in the middle to a specified length.
+    Truncates code points in the middle of a string in order to return a string
+    having a specified length.
 
     Parameters
     ----------
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
index 5f770e62fd38..b6f5e2867121 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/docs/types/index.d.ts
@@ -19,7 +19,7 @@
 // TypeScript Version: 4.1
 
 /**
-* Truncates code points of string in the middle to a specified length.
+* Truncates code points in the middle of a string in order to return a string having a specified length.
 *
 * @param str - input string
 * @param len - output string length (including sequence)
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
index 0af6c4ff2e7e..2f756e4bfc09 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/index.js
@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Truncate code points of string in the middle to a specified length.
+* Truncate code points in the middle of a string in order to return a string having a specified length.
 *
 * @module @stdlib/string/base/truncate-middle-code-point
 *
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
index c4847ea19b39..c1e6a91519c1 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/lib/main.js
@@ -29,7 +29,7 @@ var nextCodePoint = require( '@stdlib/string/next-code-point' );
 // MAIN //
 
 /**
-* Truncates code points of string in the middle to a specified length.
+* Truncates code points in the middle of a string in order to return a string having a specified length.
 *
 * @param {string} str - input string
 * @param {integer} len - output string length (including sequence)
diff --git a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json
index 7985c5c439aa..5f5cb8c1ae43 100644
--- a/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json
+++ b/lib/node_modules/@stdlib/string/base/truncate-middle-code-point/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/string/base/truncate-middle-code-point",
   "version": "0.0.0",
-  "description": "Truncate code points of string in the middle to a specified length.",
+  "description": "Truncate code points in the middle of a string in order to return a string having a specified length.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",