feat(repl): add settings and prototype methods for keybindings

lib/node_modules/@stdlib/repl/lib/actions.js

@@ -0,0 +1,60 @@
+/**
+* @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 //
+
+/**
+* List of REPL actions.
+*
+* @private
+* @name ACTIONS
+* @type {Object}
+*/
+var ACTIONS = [
+	'moveRight',
+	'moveLeft',
+	'moveWordRight',
+	'moveWordLeft',
+	'moveBeginning',
+	'moveEnd',
+	'tab',
+	'indentLineRight',
+	'indentLineLeft',
+	'deleteLeft',
+	'deleteRight',
+	'deleteWordLeft',
+	'deleteWordRight',
+	'deleteLineLeft',
+	'deleteLineRight',
+	'yankKilled',
+	'yankPop',
+	'undo',
+	'redo',
+	'transposeAboutCursor',
+	'uppercaseNextWord',
+	'capitalizeNextWord',
+	'lowercaseNextWord',
+	'clearScreen'
+];
+
+
+// EXPORTS //
+
+module.exports = ACTIONS;

lib/node_modules/@stdlib/repl/lib/commands.js

@@ -48,6 +48,7 @@ var onHelp = require( './commands/help.js' );
 var onInfo = require( './commands/info.js' );
 var isWorkspace = require( './commands/is_workspace.js' );
 var isKeyword = require( './commands/is_keyword.js' );
+var onKeybindings = require( './commands/keybindings.js' );
 var onLicense = require( './commands/license_text.js' );
 var onLoad = require( './commands/load.js' );
 var onLoadWorkspace = require( './commands/load_workspace.js' );
@@ -60,6 +61,7 @@ var onRenameWorkspace = require( './commands/rename_workspace.js' );
 var onRerequire = require( './commands/rerequire.js' );
 var onRerun = require( './commands/rerun.js' );
 var onReset = require( './commands/reset.js' );
+var onSetKeybinding = require( './commands/set_keybinding.js' );
 var onSettings = require( './commands/settings.js' );
 var onThemes = require( './commands/themes.js' );
 var onTutorial = require( './commands/tutorial.js' );
@@ -122,6 +124,7 @@ function commands( repl ) {
 	cmds.push( [ 'info', onInfo( repl, cmds ), false ] );
 	cmds.push( [ 'isKeyword', isKeyword( repl ), false ] );
 	cmds.push( [ 'isWorkspace', isWorkspace( repl ), false ] );
+	cmds.push( [ 'keybindings', onKeybindings( repl ), false ] );
 	cmds.push( [ 'license', onLicense( repl ), false ] );
 	cmds.push( [ 'load', onLoad( repl ), false ] );
 	cmds.push( [ 'loadWorkspace', onLoadWorkspace( repl ), false ] );
@@ -134,6 +137,7 @@ function commands( repl ) {
 	cmds.push( [ 'rerequire', onRerequire( repl ), false ] );
 	cmds.push( [ 'rerun', onRerun( repl ), false ] );
 	cmds.push( [ 'reset', onReset( repl ), false ] );
+	cmds.push( [ 'setKeybinding', onSetKeybinding( repl ), false ] );
 	cmds.push( [ 'settings', onSettings( repl ), false ] );
 	cmds.push( [ 'themes', onThemes( repl ), false ] );
 	cmds.push( [ 'tutorial', onTutorial( repl ), false ] );

lib/node_modules/@stdlib/repl/lib/commands/keybindings.js

@@ -0,0 +1,81 @@
+/**
+* @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.
+*/
+
+/* eslint-disable no-underscore-dangle */
+
+'use strict';
+
+// MODULES //
+
+var format = require( '@stdlib/string/format' );
+var contains = require( '@stdlib/array/base/assert/contains' ).factory;
+var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
+var ACTIONS = require( './../actions.js' );
+
+
+// VARIABLES //
+
+var isAction = contains( ACTIONS );
+
+
+// MAIN //
+
+/**
+* Returns a callback to be invoked upon calling the `keybindings` command.
+*
+* @private
+* @param {REPL} repl - REPL instance
+* @returns {Function} callback
+*/
+function command( repl ) {
+	return onCommand;
+
+	/**
+	* Returns all (or select) keybindings.
+	*
+	* @private
+	* @param {string} [action] - action name
+	* @returns {(Object|Array<Object>)} keybindings object or a list of keybindings for an action
+	*/
+	function onCommand() {
+		var action;
+		var nargs;
+
+		nargs = arguments.length;
+		if ( nargs === 0 ) {
+			return repl.keybindings();
+		}
+		if ( nargs === 1 ) {
+			action = arguments[ 0 ];
+			if ( !isString( action ) ) {
+				repl._ostream.write( format( 'Error: invalid argument. First argument must be a string. Value: `%s`.', action ) );
+				return;
+			}
+			if ( !isAction( action ) ) {
+				repl._ostream.write( format( 'Error: invalid argument. First argument must be a valid action name. Value: `%s`.', action ) );
+				return;
+			}
+			return repl.keybindings()[ action ];
+		}
+	}
+}
+
+
+// EXPORTS //
+
+module.exports = command;

lib/node_modules/@stdlib/repl/lib/commands/set_keybinding.js

@@ -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.
+*/
+
+/* eslint-disable no-underscore-dangle */
+
+'use strict';
+
+// MODULES //
+
+var format = require( '@stdlib/string/format' );
+var contains = require( '@stdlib/assert/contains' );
+var isString = require( '@stdlib/assert/is-string' );
+var ACTIONS = require( './../actions.js' );
+
+
+// MAIN //
+
+/**
+* Returns a callback to be invoked upon calling the `setKeybinding` command.
+*
+* @private
+* @param {REPL} repl - REPL instance
+* @returns {Function} callback
+*/
+function command( repl ) {
+	return onCommand;
+
+	/**
+	* Allows the user to set a keybinding.
+	*
+	* @private
+	* @param {string} action - action name
+	* @param {Array<Object>} [keys] - list of keys
+	* @returns {void}
+	*/
+	function onCommand() {
+		var action;
+		var nargs;
+		var keys;
+
+		nargs = arguments.length;
+		if ( nargs === 0 ) {
+			repl._ostream.write( 'Error: invalid argument. First argument must be an action name.\n' );
+			return;
+		}
+		action = arguments[ 0 ];
+		if ( nargs === 1 ) {
+			if ( !isString( action ) ) {
+				repl._ostream.write( format( 'Error: invalid argument. First argument must be a string. Value: `%s`.\n', action ) );
+				return;
+			}
+			if ( !contains( ACTIONS, action ) ) {
+				repl._ostream.write( format( 'Error: invalid argument. First argument must be a valid action name. Value: `%s`.\n', action ) );
+				return;
+			}
+			repl._ostream.write( 'Listening for keypresses...' );
+			repl._isCapturingKeybinding = true;
+			repl._targetAction = action;
+			return;
+		}
+		keys = arguments[ 1 ];
+		try {
+			repl.setKeybinding( action, keys );
+			repl._ostream.write( format( '\nSuccessfully set keybindings for action `%s`.\n', action ) );
+		} catch ( err ) {
+			repl._ostream.write( format( 'Error: %s\n', err.message ) );
+		}
+	}
+}
+
+
+// EXPORTS //
+
+module.exports = command;