refactor!: abstract part of REPL into a base implementation

lib/node_modules/@stdlib/repl/base/README.md

@@ -0,0 +1,89 @@
+<!--
+
+@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.
+
+-->
+
+# Base
+
+> Base REPL functionality.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var ns = require( '@stdlib/repl/base' );
+```
+
+#### ns
+
+Namespace containing "base" (i.e., lower-level) REPL functionality.
+
+```javascript
+var o = ns;
+// returns {...}
+```
+
+<!-- <toc pattern="*"> -->
+
+<div class="namespace-toc">
+
+</div>
+
+<!-- </toc> -->
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var objectKeys = require( '@stdlib/utils/keys' );
+var ns = require( '@stdlib/repl/base' );
+
+console.log( objectKeys( ns ) );
+```
+
+</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">
+
+<!-- <toc-links> -->
+
+<!-- </toc-links> -->
+
+</section>
+
+<!-- /.links -->

lib/node_modules/@stdlib/repl/base/ctor/README.md

@@ -0,0 +1,271 @@
+<!--
+
+@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.
+
+-->
+
+# REPL
+
+> Base class for Read-Eval-Print Loop (REPL) environment.
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+A Read-Eval-Print Loop (REPL) environment is an interactive programming environment which takes individual user inputs (e.g., single expressions), evaluates those inputs, and returns the result. Accordingly, a program written in a REPL environment is executed piecewise and sequentially.
+
+REPL environments find common use in exploratory programming, prototyping, and debugging.
+
+The REPL environment exposed here is available both as a standalone application and as a library which is embeddable in other libraries and applications.
+
+</section>
+
+<!-- /.intro -->
+
+<!-- Package usage documentation. -->
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var REPL = require( '@stdlib/repl/base/ctor' );
+```
+
+#### REPL( \[options] )
+
+Returns a `REPL` instance.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Execute a command:
+repl.emit( 'input', '2 + 3' );
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+The function accepts the following `options`:
+
+-   **input**: input (readable) stream. Default: [`stdin`][@stdlib/streams/node/stdin].
+-   **output**: output (writable) stream. Default: [`stdout`][@stdlib/streams/node/stdout].
+-   **error**: error (writable) stream. Default: [`stderr`][@stdlib/streams/node/stderr].
+-   **sandbox**: boolean indicating whether to run a REPL in a sandboxed context. Default: `false`.
+-   **timeout**: number of milliseconds to execute a command before terminating execution. Default: `4294967295`.
+-   **save**: file path specifying where to save REPL command history.
+-   **log**: file path specifying where to save REPL commands and printed output.
+-   **quiet**: boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced. Default: `false`.
+
+#### REPL.prototype.createContext()
+
+Returns a REPL context.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Return a new REPL context:
+var ctx = repl.createContext();
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+#### REPL.prototype.resetContext()
+
+Resets a REPL's execution context.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Reset the REPL context:
+repl.resetContext();
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+#### REPL.prototype.clearHistory()
+
+Clears a REPL's history.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Clear the REPL history:
+repl.clearHistory();
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+#### REPL.prototype.clearUserDocs()
+
+Clears user-defined documentation.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Clear user-defined documentation:
+repl.clearUserDocs();
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+#### REPL.prototype.reset()
+
+Resets a REPL.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Reset the REPL:
+repl.reset();
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+#### REPL.prototype.close()
+
+Closes a REPL.
+
+```javascript
+// Create a new REPL:
+var repl = new REPL();
+
+// ...
+
+// Close the REPL:
+repl.close();
+```
+
+* * *
+
+</section>
+
+<!-- /.usage -->
+
+<!-- Package usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+</section>
+
+<!-- /.notes -->
+
+<!-- Package usage examples. -->
+
+* * *
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var REPL = require( '@stdlib/repl/base/ctor' );
+
+function onCommand( cmd, success, res ) {
+    console.log( cmd + ' = ' + res.toString() );
+}
+
+// Create a new REPL:
+var repl = new REPL();
+repl.on( 'command', onCommand );
+
+// Execute a command:
+repl.emit( 'input', '3 + 2' );
+
+// Close the REPL:
+repl.close();
+console.log( 'REPL closed.' );
+```
+
+</section>
+
+<!-- /.examples -->
+
+* * *
+
+<section class="notes">
+
+</section>
+
+<!-- /.notes -->
+
+<!-- Section to include cited references. If references are included, add a horizontal rule *before* the section. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="references">
+
+</section>
+
+<!-- /.references -->
+
+<!-- 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">
+
+[@stdlib/streams/node/stdin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/streams/node/stdin
+
+[@stdlib/streams/node/stdout]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/streams/node/stdout
+
+[@stdlib/streams/node/stderr]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/streams/node/stderr
+
+</section>
+
+<!-- /.links -->