From 489a9122267d96d44143fa416054e6b7c6b3ca11 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Feb 2025 09:20:07 +0000 Subject: [PATCH 01/26] refactor!: move presentation into the `cli` namespace Signed-off-by: Snehil Shah --- 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: passed - task: lint_package_json status: passed - task: lint_repl_help status: na - task: lint_javascript_src status: passed - task: lint_javascript_cli status: passed - 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 --- --- .../@stdlib/repl/{ => cli}/presentation/README.md | 2 +- .../@stdlib/repl/{ => cli}/presentation/bin/cli | 0 .../@stdlib/repl/{ => cli}/presentation/data/example.csv | 0 .../@stdlib/repl/{ => cli}/presentation/data/example.json | 0 .../@stdlib/repl/{ => cli}/presentation/data/help.csv | 0 .../@stdlib/repl/{ => cli}/presentation/data/help.json | 0 .../@stdlib/repl/{ => cli}/presentation/data/info.csv | 0 .../@stdlib/repl/{ => cli}/presentation/data/info.json | 0 .../repl/{ => cli}/presentation/docs/commands/blank.txt | 0 .../{ => cli}/presentation/docs/commands/current_slide.txt | 0 .../repl/{ => cli}/presentation/docs/commands/end.txt | 0 .../repl/{ => cli}/presentation/docs/commands/first.txt | 0 .../{ => cli}/presentation/docs/commands/first_fragment.txt | 0 .../repl/{ => cli}/presentation/docs/commands/jump.txt | 0 .../repl/{ => cli}/presentation/docs/commands/jump_to.txt | 0 .../repl/{ => cli}/presentation/docs/commands/last.txt | 0 .../{ => cli}/presentation/docs/commands/last_fragment.txt | 0 .../presentation/docs/commands/load_presentation.txt | 0 .../repl/{ => cli}/presentation/docs/commands/next.txt | 0 .../{ => cli}/presentation/docs/commands/next_slide.txt | 0 .../{ => cli}/presentation/docs/commands/num_slides.txt | 0 .../repl/{ => cli}/presentation/docs/commands/pres.txt | 0 .../repl/{ => cli}/presentation/docs/commands/prev.txt | 0 .../{ => cli}/presentation/docs/commands/prev_slide.txt | 0 .../repl/{ => cli}/presentation/docs/commands/redraw.txt | 0 .../presentation/docs/commands/reload_presentation.txt | 0 .../{ => cli}/presentation/docs/commands/render_slide.txt | 0 .../repl/{ => cli}/presentation/docs/commands/run_slide.txt | 0 .../repl/{ => cli}/presentation/docs/commands/unwatch.txt | 0 .../repl/{ => cli}/presentation/docs/commands/watch.txt | 0 .../@stdlib/repl/{ => cli}/presentation/docs/usage.txt | 0 .../@stdlib/repl/{ => cli}/presentation/etc/cli_opts.json | 0 .../repl/{ => cli}/presentation/examples/presentation.txt | 0 .../@stdlib/repl/{ => cli}/presentation/lib/align_center.js | 0 .../repl/{ => cli}/presentation/lib/align_flush_left.js | 0 .../repl/{ => cli}/presentation/lib/align_flush_right.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/align_left.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/align_line.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/align_right.js | 0 .../repl/{ => cli}/presentation/lib/ansi_escape_code.js | 0 .../repl/{ => cli}/presentation/lib/ansi_escape_codes.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/blank_line.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/commands.js | 0 .../repl/{ => cli}/presentation/lib/commands/blank.js | 0 .../{ => cli}/presentation/lib/commands/current_slide.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/commands/end.js | 0 .../repl/{ => cli}/presentation/lib/commands/first.js | 0 .../{ => cli}/presentation/lib/commands/first_fragment.js | 0 .../repl/{ => cli}/presentation/lib/commands/jump.js | 0 .../repl/{ => cli}/presentation/lib/commands/jump_to.js | 0 .../repl/{ => cli}/presentation/lib/commands/last.js | 0 .../{ => cli}/presentation/lib/commands/last_fragment.js | 0 .../presentation/lib/commands/load_presentation.js | 0 .../repl/{ => cli}/presentation/lib/commands/next.js | 0 .../repl/{ => cli}/presentation/lib/commands/next_slide.js | 0 .../repl/{ => cli}/presentation/lib/commands/num_slides.js | 0 .../repl/{ => cli}/presentation/lib/commands/pres.js | 0 .../repl/{ => cli}/presentation/lib/commands/prev.js | 0 .../repl/{ => cli}/presentation/lib/commands/prev_slide.js | 0 .../repl/{ => cli}/presentation/lib/commands/redraw.js | 0 .../presentation/lib/commands/reload_presentation.js | 0 .../{ => cli}/presentation/lib/commands/render_slide.js | 0 .../repl/{ => cli}/presentation/lib/commands/run_slide.js | 0 .../repl/{ => cli}/presentation/lib/commands/unwatch.js | 0 .../repl/{ => cli}/presentation/lib/commands/watch.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/defaults.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/docs.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/emoji.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/fill_line.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/footer.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/format.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/help_text.js | 0 .../repl/{ => cli}/presentation/lib/horizontal_rule.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/index.js | 6 +++--- .../@stdlib/repl/{ => cli}/presentation/lib/main.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/parse.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/parse_slide.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/set_commands.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/style_line.js | 0 .../repl/{ => cli}/presentation/lib/style_to_ansi.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/styles.js | 0 .../@stdlib/repl/{ => cli}/presentation/lib/validate.js | 0 .../@stdlib/repl/{ => cli}/presentation/package.json | 2 +- .../@stdlib/repl/{ => cli}/presentation/scripts/build.js | 0 84 files changed, 5 insertions(+), 5 deletions(-) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/README.md (99%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/bin/cli (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/data/example.csv (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/data/example.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/data/help.csv (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/data/help.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/data/info.csv (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/data/info.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/blank.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/current_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/end.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/first.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/first_fragment.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/jump.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/jump_to.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/last.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/last_fragment.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/load_presentation.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/next.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/next_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/num_slides.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/pres.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/prev.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/prev_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/redraw.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/reload_presentation.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/render_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/run_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/unwatch.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/commands/watch.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/docs/usage.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/etc/cli_opts.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/examples/presentation.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/align_center.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/align_flush_left.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/align_flush_right.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/align_left.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/align_line.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/align_right.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/ansi_escape_code.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/ansi_escape_codes.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/blank_line.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/blank.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/current_slide.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/end.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/first.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/first_fragment.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/jump.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/jump_to.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/last.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/last_fragment.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/load_presentation.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/next.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/next_slide.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/num_slides.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/pres.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/prev.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/prev_slide.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/redraw.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/reload_presentation.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/render_slide.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/run_slide.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/unwatch.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/commands/watch.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/defaults.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/docs.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/emoji.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/fill_line.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/footer.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/format.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/help_text.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/horizontal_rule.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/index.js (88%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/main.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/parse.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/parse_slide.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/set_commands.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/style_line.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/style_to_ansi.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/styles.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/lib/validate.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/package.json (97%) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/scripts/build.js (100%) diff --git a/lib/node_modules/@stdlib/repl/presentation/README.md b/lib/node_modules/@stdlib/repl/cli/presentation/README.md similarity index 99% rename from lib/node_modules/@stdlib/repl/presentation/README.md rename to lib/node_modules/@stdlib/repl/cli/presentation/README.md index d89fb3627258..d27fc703d301 100644 --- a/lib/node_modules/@stdlib/repl/presentation/README.md +++ b/lib/node_modules/@stdlib/repl/cli/presentation/README.md @@ -46,7 +46,7 @@ This package allows building presentations using only a [REPL][@stdlib/repl] env ### Authoring -A [REPL][@stdlib/repl] presentation source file is a text file which includes minimal markup for delineating slides, slide fragments, speaker notes, code, text alignment, and styling. +A [REPL][@stdlib/repl] presentation source file is a text file which includes minimal markup for delineating slides, slide fragments, speaker notes, code, text alignment, and styling. #### Slides diff --git a/lib/node_modules/@stdlib/repl/presentation/bin/cli b/lib/node_modules/@stdlib/repl/cli/presentation/bin/cli similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/bin/cli rename to lib/node_modules/@stdlib/repl/cli/presentation/bin/cli diff --git a/lib/node_modules/@stdlib/repl/presentation/data/example.csv b/lib/node_modules/@stdlib/repl/cli/presentation/data/example.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/data/example.csv rename to lib/node_modules/@stdlib/repl/cli/presentation/data/example.csv diff --git a/lib/node_modules/@stdlib/repl/presentation/data/example.json b/lib/node_modules/@stdlib/repl/cli/presentation/data/example.json similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/data/example.json rename to lib/node_modules/@stdlib/repl/cli/presentation/data/example.json diff --git a/lib/node_modules/@stdlib/repl/presentation/data/help.csv b/lib/node_modules/@stdlib/repl/cli/presentation/data/help.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/data/help.csv rename to lib/node_modules/@stdlib/repl/cli/presentation/data/help.csv diff --git a/lib/node_modules/@stdlib/repl/presentation/data/help.json b/lib/node_modules/@stdlib/repl/cli/presentation/data/help.json similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/data/help.json rename to lib/node_modules/@stdlib/repl/cli/presentation/data/help.json diff --git a/lib/node_modules/@stdlib/repl/presentation/data/info.csv b/lib/node_modules/@stdlib/repl/cli/presentation/data/info.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/data/info.csv rename to lib/node_modules/@stdlib/repl/cli/presentation/data/info.csv diff --git a/lib/node_modules/@stdlib/repl/presentation/data/info.json b/lib/node_modules/@stdlib/repl/cli/presentation/data/info.json similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/data/info.json rename to lib/node_modules/@stdlib/repl/cli/presentation/data/info.json diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/blank.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/blank.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/blank.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/blank.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/current_slide.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/current_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/current_slide.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/current_slide.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/end.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/end.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/end.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/end.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/first.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/first.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/first_fragment.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first_fragment.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/first_fragment.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first_fragment.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/jump.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/jump.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/jump_to.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump_to.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/jump_to.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump_to.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/last.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/last.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/last_fragment.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last_fragment.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/last_fragment.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last_fragment.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/load_presentation.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/load_presentation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/load_presentation.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/load_presentation.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/next.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/next.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/next_slide.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/next_slide.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next_slide.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/num_slides.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/num_slides.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/num_slides.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/num_slides.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/pres.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/pres.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/pres.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/pres.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/prev.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/prev.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/prev_slide.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/prev_slide.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev_slide.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/redraw.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/redraw.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/redraw.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/redraw.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/reload_presentation.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/reload_presentation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/reload_presentation.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/reload_presentation.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/render_slide.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/render_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/render_slide.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/render_slide.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/run_slide.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/run_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/run_slide.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/run_slide.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/unwatch.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/unwatch.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/unwatch.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/unwatch.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/commands/watch.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/watch.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/commands/watch.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/watch.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/docs/usage.txt b/lib/node_modules/@stdlib/repl/cli/presentation/docs/usage.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/docs/usage.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/docs/usage.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/etc/cli_opts.json b/lib/node_modules/@stdlib/repl/cli/presentation/etc/cli_opts.json similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/etc/cli_opts.json rename to lib/node_modules/@stdlib/repl/cli/presentation/etc/cli_opts.json diff --git a/lib/node_modules/@stdlib/repl/presentation/examples/presentation.txt b/lib/node_modules/@stdlib/repl/cli/presentation/examples/presentation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/examples/presentation.txt rename to lib/node_modules/@stdlib/repl/cli/presentation/examples/presentation.txt diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/align_center.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_center.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/align_center.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/align_center.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/align_flush_left.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_left.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/align_flush_left.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_left.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/align_flush_right.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_right.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/align_flush_right.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_right.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/align_left.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_left.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/align_left.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/align_left.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/align_line.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/align_line.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/align_line.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/align_right.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_right.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/align_right.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/align_right.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_code.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_code.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_code.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_code.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_codes.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_codes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_codes.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_codes.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/blank_line.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/blank_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/blank_line.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/blank_line.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/blank.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/blank.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/blank.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/blank.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/current_slide.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/current_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/current_slide.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/current_slide.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/end.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/end.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/end.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/end.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/first.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/first.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/first_fragment.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first_fragment.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/first_fragment.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first_fragment.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/jump.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/jump.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/jump_to.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump_to.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/jump_to.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump_to.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/last.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/last.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/last_fragment.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last_fragment.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/last_fragment.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last_fragment.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/load_presentation.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/load_presentation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/load_presentation.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/load_presentation.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/next.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/next.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/next_slide.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/next_slide.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next_slide.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/num_slides.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/num_slides.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/num_slides.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/num_slides.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/pres.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/pres.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/pres.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/pres.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/prev.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/prev.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/prev_slide.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/prev_slide.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev_slide.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/redraw.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/redraw.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/redraw.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/redraw.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/reload_presentation.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/reload_presentation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/reload_presentation.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/reload_presentation.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/render_slide.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/render_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/render_slide.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/render_slide.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/run_slide.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/run_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/run_slide.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/run_slide.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/unwatch.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/unwatch.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/unwatch.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/unwatch.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/commands/watch.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/watch.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/commands/watch.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/watch.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/defaults.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/defaults.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/defaults.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/defaults.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/docs.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/docs.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/docs.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/emoji.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/emoji.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/emoji.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/emoji.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/fill_line.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/fill_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/fill_line.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/fill_line.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/footer.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/footer.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/footer.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/footer.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/format.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/format.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/format.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/format.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/help_text.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/help_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/help_text.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/help_text.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/horizontal_rule.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/horizontal_rule.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/horizontal_rule.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/horizontal_rule.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/index.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/index.js similarity index 88% rename from lib/node_modules/@stdlib/repl/presentation/lib/index.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/index.js index 73364031e9fb..00c58c9544eb 100644 --- a/lib/node_modules/@stdlib/repl/presentation/lib/index.js +++ b/lib/node_modules/@stdlib/repl/cli/presentation/lib/index.js @@ -21,12 +21,12 @@ /** * REPL presentation. * -* @module @stdlib/repl/presentation +* @module @stdlib/repl/cli/presentation * * @example * var debug = require( '@stdlib/streams/node/debug-sink' ); -* var REPL = require( '@stdlib/repl' ); -* var Presentation = require( '@stdlib/repl/presentation' ); +* var REPL = require( '@stdlib/repl/cli' ); +* var Presentation = require( '@stdlib/repl/cli/presentation' ); * * function onExit() { * console.log( 'REPL closed.' ); diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/main.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/main.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/main.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/main.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/parse.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/parse.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/parse.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/parse.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/parse_slide.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/parse_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/parse_slide.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/parse_slide.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/set_commands.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/set_commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/set_commands.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/set_commands.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/style_line.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/style_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/style_line.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/style_line.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/style_to_ansi.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/style_to_ansi.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/style_to_ansi.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/style_to_ansi.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/styles.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/styles.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/styles.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/styles.js diff --git a/lib/node_modules/@stdlib/repl/presentation/lib/validate.js b/lib/node_modules/@stdlib/repl/cli/presentation/lib/validate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/lib/validate.js rename to lib/node_modules/@stdlib/repl/cli/presentation/lib/validate.js diff --git a/lib/node_modules/@stdlib/repl/presentation/package.json b/lib/node_modules/@stdlib/repl/cli/presentation/package.json similarity index 97% rename from lib/node_modules/@stdlib/repl/presentation/package.json rename to lib/node_modules/@stdlib/repl/cli/presentation/package.json index 6f31caed483e..f3166178e52b 100644 --- a/lib/node_modules/@stdlib/repl/presentation/package.json +++ b/lib/node_modules/@stdlib/repl/cli/presentation/package.json @@ -1,5 +1,5 @@ { - "name": "@stdlib/repl/presentation", + "name": "@stdlib/repl/cli/presentation", "version": "0.0.0", "description": "REPL presentation.", "license": "Apache-2.0", diff --git a/lib/node_modules/@stdlib/repl/presentation/scripts/build.js b/lib/node_modules/@stdlib/repl/cli/presentation/scripts/build.js similarity index 100% rename from lib/node_modules/@stdlib/repl/presentation/scripts/build.js rename to lib/node_modules/@stdlib/repl/cli/presentation/scripts/build.js From e4e0c686f976615441625c6477d21aae9f3ee92b Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Feb 2025 11:48:55 +0000 Subject: [PATCH 02/26] refactor!: abstract part of REPL into a base implementation Signed-off-by: Snehil Shah --- 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: passed - task: lint_package_json status: passed - task: lint_repl_help status: na - task: lint_javascript_src status: passed - task: lint_javascript_cli status: passed - task: lint_javascript_examples status: passed - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: passed - 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 --- --- .../repl/{ => base}/data/contributor.json | 0 .../@stdlib/repl/{ => base}/data/example.csv | 0 .../@stdlib/repl/{ => base}/data/example.json | 0 .../@stdlib/repl/{ => base}/data/help.csv | 0 .../@stdlib/repl/{ => base}/data/help.json | 0 .../@stdlib/repl/{ => base}/data/info.csv | 0 .../@stdlib/repl/{ => base}/data/info.json | 0 .../repl/{ => base}/data/license_text.json | 0 .../@stdlib/repl/{ => base}/data/tutorial.csv | 0 .../repl/{ => base}/data/tutorial.json | 0 .../{ => base}/docs/commands/__done__.txt | 0 .../{ => base}/docs/commands/_require.txt | 0 .../{ => base}/docs/commands/alias2pkg.txt | 0 .../docs/commands/alias2related.txt | 0 .../repl/{ => base}/docs/commands/ans.txt | 0 .../{ => base}/docs/commands/assignfrom.txt | 0 .../{ => base}/docs/commands/assignin.txt | 0 .../{ => base}/docs/commands/citation.txt | 0 .../docs/commands/clear_history.txt | 0 .../docs/commands/clear_user_docs.txt | 0 .../{ => base}/docs/commands/clear_vars.txt | 0 .../docs/commands/clear_workspace.txt | 0 .../{ => base}/docs/commands/contributor.txt | 0 .../{ => base}/docs/commands/copyright.txt | 0 .../repl/{ => base}/docs/commands/credits.txt | 0 .../docs/commands/current_workspace.txt | 0 .../docs/commands/deeprerequire.txt | 0 .../docs/commands/delete_workspace.txt | 0 .../repl/{ => base}/docs/commands/donate.txt | 0 .../repl/{ => base}/docs/commands/evalin.txt | 0 .../repl/{ => base}/docs/commands/example.txt | 0 .../repl/{ => base}/docs/commands/global.txt | 0 .../repl/{ => base}/docs/commands/help.txt | 0 .../repl/{ => base}/docs/commands/info.txt | 0 .../{ => base}/docs/commands/is_keyword.txt | 0 .../{ => base}/docs/commands/is_workspace.txt | 0 .../{ => base}/docs/commands/license_text.txt | 0 .../repl/{ => base}/docs/commands/load.txt | 0 .../docs/commands/load_workspace.txt | 0 .../{ => base}/docs/commands/log_start.txt | 0 .../{ => base}/docs/commands/log_stop.txt | 0 .../repl/{ => base}/docs/commands/quit.txt | 0 .../docs/commands/rename_workspace.txt | 0 .../{ => base}/docs/commands/rerequire.txt | 0 .../repl/{ => base}/docs/commands/rerun.txt | 0 .../repl/{ => base}/docs/commands/reset.txt | 0 .../repl/{ => base}/docs/commands/save.txt | 0 .../{ => base}/docs/commands/save_start.txt | 0 .../{ => base}/docs/commands/save_stop.txt | 0 .../{ => base}/docs/commands/tutorial.txt | 0 .../{ => base}/docs/commands/user_doc.txt | 0 .../repl/{ => base}/docs/commands/vars.txt | 0 .../docs/commands/vars_workspace.txt | 0 .../{ => base}/docs/commands/workspace.txt | 0 .../{ => base}/docs/commands/workspaces.txt | 0 .../lib/acorn_detect_multiline_input.js | 0 .../repl/{ => base}/lib/alias_overrides.js | 0 .../repl/{ => base}/lib/alias_to_string.js | 0 .../@stdlib/repl/{ => base}/lib/aliases.js | 0 .../repl/{ => base}/lib/append_unique.js | 0 .../@stdlib/repl/{ => base}/lib/commands.js | 26 - .../repl/{ => base}/lib/commands/__done__.js | 0 .../repl/{ => base}/lib/commands/alias2pkg.js | 0 .../{ => base}/lib/commands/alias2related.js | 0 .../repl/{ => base}/lib/commands/ans.js | 0 .../{ => base}/lib/commands/assignfrom.js | 0 .../repl/{ => base}/lib/commands/assignin.js | 0 .../repl/{ => base}/lib/commands/citation.js | 0 .../{ => base}/lib/commands/clear_history.js | 0 .../lib/commands/clear_user_docs.js | 0 .../{ => base}/lib/commands/clear_vars.js | 0 .../lib/commands/clear_workspace.js | 0 .../{ => base}/lib/commands/contributor.js | 0 .../repl/{ => base}/lib/commands/copyright.js | 0 .../repl/{ => base}/lib/commands/credits.js | 0 .../lib/commands/current_workspace.js | 0 .../{ => base}/lib/commands/deeprerequire.js | 0 .../lib/commands/delete_workspace.js | 0 .../repl/{ => base}/lib/commands/donate.js | 0 .../repl/{ => base}/lib/commands/evalin.js | 0 .../repl/{ => base}/lib/commands/example.js | 0 .../repl/{ => base}/lib/commands/help.js | 3 +- .../repl/{ => base}/lib/commands/info.js | 0 .../{ => base}/lib/commands/is_keyword.js | 0 .../{ => base}/lib/commands/is_workspace.js | 0 .../{ => base}/lib/commands/license_text.js | 0 .../repl/{ => base}/lib/commands/load.js | 0 .../{ => base}/lib/commands/load_workspace.js | 0 .../repl/{ => base}/lib/commands/quit.js | 0 .../lib/commands/rename_workspace.js | 0 .../repl/{ => base}/lib/commands/rerequire.js | 0 .../repl/{ => base}/lib/commands/reset.js | 0 .../repl/{ => base}/lib/commands/tutorial.js | 0 .../repl/{ => base}/lib/commands/user_doc.js | 0 .../repl/{ => base}/lib/commands/vars.js | 0 .../{ => base}/lib/commands/vars_workspace.js | 0 .../repl/{ => base}/lib/commands/workspace.js | 0 .../{ => base}/lib/commands/workspaces.js | 0 .../repl/{ => base}/lib/compile_code.js | 0 .../repl/{ => base}/lib/compile_command.js | 0 .../{ => base}/lib/complete_expression.js | 0 .../repl/{ => base}/lib/complete_fs.js | 0 .../repl/{ => base}/lib/complete_require.js | 2 +- .../repl/{ => base}/lib/complete_tutorial.js | 0 .../{ => base}/lib/complete_walk_find_last.js | 0 .../repl/{ => base}/lib/complete_workspace.js | 0 .../@stdlib/repl/{ => base}/lib/completer.js | 17 - .../@stdlib/repl/{ => base}/lib/contains.js | 0 .../repl/{ => base}/lib/create_accessor.js | 0 .../lib/create_evaluation_context.js | 5 +- .../repl/{ => base}/lib/create_require.js | 0 .../@stdlib/repl/base/lib/defaults.js | 74 ++ .../@stdlib/repl/{ => base}/lib/drain.js | 36 +- .../repl/{ => base}/lib/filter_by_prefix.js | 0 .../repl/{ => base}/lib/find_unique_entry.js | 0 .../repl/{ => base}/lib/fs_alias_args.js | 0 .../@stdlib/repl/{ => base}/lib/fs_aliases.js | 0 .../@stdlib/repl/{ => base}/lib/globals.js | 0 .../{ => base}/lib/has_async_directive.js | 0 .../@stdlib/repl/{ => base}/lib/index.js | 6 +- .../@stdlib/repl/{ => base}/lib/index_of.js | 0 .../repl/{ => base}/lib/is_block_scope.js | 0 .../repl/base/lib/is_multiline_input.js | 95 +++ .../@stdlib/repl/{ => base}/lib/is_scope.js | 0 .../repl/{ => base}/lib/is_silent_command.js | 0 .../@stdlib/repl/{ => base}/lib/log.js | 0 .../{ => base}/lib/longest_common_prefix.js | 0 .../@stdlib/repl/base/lib/main.js | 719 ++++++++++++++++++ .../repl/{ => base}/lib/process_command.js | 0 .../@stdlib/repl/base/lib/process_input.js | 89 +++ .../{ => base}/lib/process_top_level_await.js | 0 .../{ => base}/lib/property_comparator.js | 0 .../repl/{ => base}/lib/regexp_fs_aliases.js | 0 .../repl/{ => base}/lib/regexp_index.js | 0 .../repl/{ => base}/lib/regexp_path.js | 0 .../lib/regexp_relative_require_path.js | 0 .../repl/{ => base}/lib/regexp_require.js | 0 .../lib/regexp_reserved_syntax_characters.js | 0 .../repl/{ => base}/lib/regexp_tutorial.js | 0 .../repl/{ => base}/lib/regexp_workspace.js | 0 .../@stdlib/repl/{ => base}/lib/repl_docs.js | 0 .../repl/{ => base}/lib/reserved_keywords.js | 0 .../lib/reserved_keywords_common.js | 0 ...reserved_keywords_empty_block_statement.js | 0 .../repl/{ => base}/lib/resolve_globals.js | 0 .../{ => base}/lib/resolve_local_scope.js | 0 .../{ => base}/lib/resolve_local_scopes.js | 0 .../{ => base}/lib/restore_regexp_matches.js | 0 .../repl/{ => base}/lib/set_aliases.js | 0 .../repl/{ => base}/lib/set_aliases_global.js | 0 .../repl/{ => base}/lib/set_commands.js | 0 .../{ => base}/lib/set_commands_global.js | 0 .../@stdlib/repl/{ => base}/lib/setdiff.js | 0 .../@stdlib/repl/base/lib/settings.js | 68 ++ .../repl/{ => base}/lib/settings_names.js | 0 .../{ => base}/lib/settings_validators.js | 0 .../@stdlib/repl/{ => base}/lib/tokenizer.js | 17 - .../{ => base}/lib/tutorial_alias_args.js | 0 .../repl/{ => base}/lib/tutorial_aliases.js | 0 .../{ => base}/lib/update_regexp_cache.js | 0 .../@stdlib/repl/base/lib/validate.js | 131 ++++ .../repl/{ => base}/lib/validate_settings.js | 0 .../{ => base}/lib/workspace_alias_args.js | 0 .../repl/{ => base}/lib/workspace_aliases.js | 0 .../@stdlib/repl/base/package.json | 78 ++ .../@stdlib/repl/{ => base}/scripts/build.js | 0 .../{ => base}/scripts/build_contributors.js | 0 .../repl/{ => base}/scripts/build_help.js | 0 .../repl/{ => base}/scripts/build_license.js | 0 .../{ => base}/scripts/build_tutorials.js | 0 .../@stdlib/repl/{ => cli}/README.md | 0 .../repl/{ => cli}/benchmark/benchmark.js | 0 .../@stdlib/repl/{ => cli}/bin/cli | 4 +- .../repl/{ => cli}/docs/commands/clear.txt | 0 .../docs/commands/presentation_start.txt | 0 .../docs/commands/presentation_stop.txt | 0 .../{ => cli}/docs/migration-guides/README.md | 0 .../docs/migration-guides/ipython/README.md | 0 .../migration-guides/ipython/data/data.csv | 0 .../docs/migration-guides/matlab/README.md | 0 .../migration-guides/matlab/data/data.csv | 0 .../docs/tutorials/read_eval_print_loop.txt | 0 .../@stdlib/repl/{ => cli}/docs/usage.txt | 0 .../@stdlib/repl/{ => cli}/etc/cli_opts.json | 0 .../repl/{ => cli}/examples/history.txt | 0 .../{ => cli}/examples/http/client.js.txt | 0 .../{ => cli}/examples/http/server.js.txt | 0 .../@stdlib/repl/{ => cli}/examples/index.js | 0 .../examples/net-socket-2/client.js.txt | 0 .../examples/net-socket-2/server.js.txt | 0 .../examples/net-socket/client.js.txt | 0 .../examples/net-socket/server.js.txt | 0 .../@stdlib/repl/{ => cli}/lib/actions.js | 0 .../@stdlib/repl/{ => cli}/lib/ansi_colors.js | 0 .../repl/{ => cli}/lib/auto_close_pairs.js | 0 .../lib/auto_close_pairs_close_symbols.js | 0 .../lib/auto_close_pairs_open_symbols.js | 0 .../{ => cli}/lib/auto_close_pairs_walk.js | 0 .../repl/{ => cli}/lib/browser/index.js | 0 .../@stdlib/repl/cli/lib/commands.js | 82 ++ .../repl/{ => cli}/lib/commands/add_theme.js | 0 .../repl/{ => cli}/lib/commands/clear.js | 0 .../{ => cli}/lib/commands/delete_theme.js | 0 .../repl/{ => cli}/lib/commands/get_theme.js | 0 .../{ => cli}/lib/commands/keybindings.js | 0 .../repl/{ => cli}/lib/commands/pager.js | 0 .../lib/commands/presentation_start.js | 2 +- .../lib/commands/presentation_stop.js | 0 .../{ => cli}/lib/commands/rename_theme.js | 0 .../repl/{ => cli}/lib/commands/rerun.js | 0 .../{ => cli}/lib/commands/set_keybinding.js | 0 .../repl/{ => cli}/lib/commands/settings.js | 0 .../repl/{ => cli}/lib/commands/themes.js | 0 .../repl/{ => cli}/lib/completer_engine.js | 0 .../repl/{ => cli}/lib/completer_preview.js | 0 .../repl/{ => cli}/lib/default_keybindings.js | 0 .../@stdlib/repl/{ => cli}/lib/defaults.js | 0 .../repl/{ => cli}/lib/display_prompt.js | 0 .../repl/{ => cli}/lib/eager_evaluator.js | 6 +- .../repl/{ => cli}/lib/editor_actions.js | 0 .../@stdlib/repl/{ => cli}/lib/help_text.js | 0 .../@stdlib/repl/cli/lib/index.js | 53 ++ .../repl/{ => cli}/lib/input_prompt.js | 0 .../repl/{ => cli}/lib/is_setting_name.js | 0 .../@stdlib/repl/{ => cli}/lib/keybindings.js | 0 lib/node_modules/@stdlib/repl/cli/lib/log.js | 45 ++ .../repl/cli/lib/longest_common_prefix.js | 101 +++ .../@stdlib/repl/{ => cli}/lib/main.js | 448 ++--------- .../repl/{ => cli}/lib/multiline_handler.js | 114 +-- .../repl/{ => cli}/lib/output_stream.js | 0 .../@stdlib/repl/{ => cli}/lib/parse_key.js | 0 .../repl/cli/lib/property_comparator.js | 63 ++ .../lib/regexp_leading_whitespace.js | 0 .../lib/regexp_reserved_syntax_characters.js | 42 + .../@stdlib/repl/cli/lib/set_commands.js | 64 ++ .../repl/cli/lib/set_commands_global.js | 72 ++ .../@stdlib/repl/cli/lib/setdiff.js | 193 +++++ .../@stdlib/repl/{ => cli}/lib/settings.js | 8 +- .../lib/settings_names.js} | 21 +- .../repl/cli/lib/settings_validators.js | 112 +++ .../repl/{ => cli}/lib/syntax_highlighter.js | 3 +- .../@stdlib/repl/{ => cli}/lib/themes.js | 0 .../@stdlib/repl/{ => cli}/lib/validate.js | 0 .../{ => cli}/lib/validate_keybindings.js | 0 .../@stdlib/repl/cli/lib/validate_settings.js | 78 ++ .../repl/{ => cli}/lib/welcome_text.js | 0 .../@stdlib/repl/cli/package.json | 78 ++ .../array_expression_right_bracket.json | 0 .../object_expression_right_brace.json | 0 .../negative/right_backtick.json | 0 .../negative/right_double_quote.json | 0 .../negative/right_parenthesis.json | 0 .../negative/right_single_quote.json | 0 .../negative/template_literal.json | 0 .../template_literal_with_expression.json | 0 .../positive/arrow_function_body.json | 0 ...binary_left_member_expression_literal.json | 0 .../positive/call_expression.json | 0 ...pression_string_argument_single_quote.json | 0 ...ssion_template_argument_left_backtick.json | 0 .../positive/do_while_body.json | 0 .../positive/do_while_test.json | 0 .../positive/do_while_test_left_bracket.json | 0 .../auto-close-pairs/positive/for_body.json | 0 .../auto-close-pairs/positive/for_init.json | 0 .../auto-close-pairs/positive/for_test.json | 0 .../positive/for_test_member_expression.json | 0 .../auto-close-pairs/positive/for_update.json | 0 .../for_update_member_expression.json | 0 .../positive/function_declaration_body.json | 0 .../function_declaration_signature.json | 0 .../positive/left_backtick.json | 0 .../auto-close-pairs/positive/left_brace.json | 0 .../positive/left_bracket.json | 0 .../positive/left_double_quote.json | 0 .../positive/left_parenthesis.json | 0 .../positive/left_single_quote.json | 0 ...ogical_left_member_expression_literal.json | 0 .../logical_with_left_member_expression.json | 0 ...al_with_left_nested_member_expression.json | 0 .../logical_with_right_member_expression.json | 0 .../member_assignment_expression.json | 0 .../member_assignment_expression_literal.json | 0 .../positive/member_expression.json | 0 .../member_expression_call_expression.json | 0 .../object_expression_left_single_quote.json | 0 .../positive/regexp_body_single_quote.json | 0 .../positive/regexp_literal_left_bracket.json | 0 .../positive/regexp_single_quote.json | 0 .../positive/tagged_template.json | 0 .../tagged_template_left_backtick.json | 0 ...te_literal_expression_with_left_brace.json | 0 ..._literal_expression_with_left_bracket.json | 0 ...ral_expression_with_left_double_quote.json | 0 ...eral_expression_with_left_parenthesis.json | 0 .../positive/three_backticks.json | 0 .../positive/variable_declaration_string.json | 0 .../auto-close-pairs/positive/while_body.json | 0 .../auto-close-pairs/positive/while_test.json | 0 .../fixtures/auto-close-pairs/script.js | 0 ...expression_left_bracket_within_string.json | 0 .../negative/left_backtick_within_string.json | 0 .../left_double_quote_within_string.json | 0 .../left_parenthesis_within_string.json | 0 .../left_single_quote_within_string.json | 0 ...t_expression_left_brace_within_string.json | 0 .../array_expression_left_bracket.json | 0 .../positive/left_backtick.json | 0 .../positive/left_double_quote.json | 0 .../positive/left_parenthesis.json | 0 .../positive/left_single_quote.json | 0 .../object_expression_left_brace.json | 0 .../fixtures/auto-delete-pairs/script.js | 0 .../test/integration/fixtures/repl.js | 0 .../syntax-highlighting/comments.json | 0 .../syntax-highlighting/control_keywords.json | 0 .../declaration_names.json | 0 .../syntax-highlighting/functions.json | 0 .../syntax-highlighting/keywords.json | 0 .../syntax-highlighting/local_scopes.json | 0 .../member_expressions.json | 0 .../syntax-highlighting/numeric_literals.json | 0 .../fixtures/syntax-highlighting/objects.json | 0 .../syntax-highlighting/operators.json | 0 .../syntax-highlighting/punctuation.json | 0 .../fixtures/syntax-highlighting/regexp.json | 0 .../reserved_literals.json | 0 .../special_identifiers.json | 0 .../syntax-highlighting/string_literals.json | 0 .../syntax-highlighting/variables.json | 0 .../test/integration/test.auto_close_pairs.js | 1 - .../integration/test.auto_delete_pairs.js | 0 .../test/integration/test.auto_page.js | 0 .../test/integration/test.completer_engine.js | 4 +- .../integration/test.completion_previews.js | 32 +- .../integration/test.syntax_highlighting.js | 0 .../@stdlib/repl/{ => cli}/test/test.cli.js | 0 .../@stdlib/repl/{ => cli}/test/test.js | 0 .../@stdlib/repl/lib/complete_settings.js | 91 --- .../@stdlib/repl/lib/regexp_settings.js | 106 --- .../@stdlib/repl/lib/settings_aliases.js | 46 -- 341 files changed, 2343 insertions(+), 892 deletions(-) rename lib/node_modules/@stdlib/repl/{ => base}/data/contributor.json (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/example.csv (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/example.json (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/help.csv (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/help.json (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/info.csv (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/info.json (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/license_text.json (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/tutorial.csv (100%) rename lib/node_modules/@stdlib/repl/{ => base}/data/tutorial.json (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/__done__.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/_require.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/alias2pkg.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/alias2related.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/ans.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/assignfrom.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/assignin.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/citation.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/clear_history.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/clear_user_docs.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/clear_vars.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/clear_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/contributor.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/copyright.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/credits.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/current_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/deeprerequire.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/delete_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/donate.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/evalin.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/example.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/global.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/help.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/info.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/is_keyword.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/is_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/license_text.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/load.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/load_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/log_start.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/log_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/quit.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/rename_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/rerequire.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/rerun.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/reset.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/save.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/save_start.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/save_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/tutorial.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/user_doc.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/vars.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/vars_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/docs/commands/workspaces.txt (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/acorn_detect_multiline_input.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/alias_overrides.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/alias_to_string.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/aliases.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/append_unique.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands.js (78%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/__done__.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/alias2pkg.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/alias2related.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/ans.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/assignfrom.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/assignin.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/citation.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/clear_history.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/clear_user_docs.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/clear_vars.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/clear_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/contributor.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/copyright.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/credits.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/current_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/deeprerequire.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/delete_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/donate.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/evalin.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/example.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/help.js (98%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/info.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/is_keyword.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/is_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/license_text.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/load.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/load_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/quit.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/rename_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/rerequire.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/reset.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/tutorial.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/user_doc.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/vars.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/vars_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/commands/workspaces.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/compile_code.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/compile_command.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/complete_expression.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/complete_fs.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/complete_require.js (98%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/complete_tutorial.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/complete_walk_find_last.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/complete_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/completer.js (88%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/contains.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/create_accessor.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/create_evaluation_context.js (94%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/create_require.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/lib/defaults.js rename lib/node_modules/@stdlib/repl/{ => base}/lib/drain.js (73%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/filter_by_prefix.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/find_unique_entry.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/fs_alias_args.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/fs_aliases.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/globals.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/has_async_directive.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/index.js (92%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/index_of.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/is_block_scope.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/lib/is_multiline_input.js rename lib/node_modules/@stdlib/repl/{ => base}/lib/is_scope.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/is_silent_command.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/log.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/longest_common_prefix.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/lib/main.js rename lib/node_modules/@stdlib/repl/{ => base}/lib/process_command.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/lib/process_input.js rename lib/node_modules/@stdlib/repl/{ => base}/lib/process_top_level_await.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/property_comparator.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_fs_aliases.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_index.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_path.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_relative_require_path.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_require.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_reserved_syntax_characters.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_tutorial.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/regexp_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/repl_docs.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/reserved_keywords.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/reserved_keywords_common.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/reserved_keywords_empty_block_statement.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/resolve_globals.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/resolve_local_scope.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/resolve_local_scopes.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/restore_regexp_matches.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/set_aliases.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/set_aliases_global.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/set_commands.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/set_commands_global.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/setdiff.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/lib/settings.js rename lib/node_modules/@stdlib/repl/{ => base}/lib/settings_names.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/settings_validators.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/tokenizer.js (96%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/tutorial_alias_args.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/tutorial_aliases.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/update_regexp_cache.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/lib/validate.js rename lib/node_modules/@stdlib/repl/{ => base}/lib/validate_settings.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/workspace_alias_args.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/lib/workspace_aliases.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/package.json rename lib/node_modules/@stdlib/repl/{ => base}/scripts/build.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/scripts/build_contributors.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/scripts/build_help.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/scripts/build_license.js (100%) rename lib/node_modules/@stdlib/repl/{ => base}/scripts/build_tutorials.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/README.md (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/benchmark/benchmark.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/bin/cli (96%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/commands/clear.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/commands/presentation_start.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/commands/presentation_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/migration-guides/README.md (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/migration-guides/ipython/README.md (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/migration-guides/ipython/data/data.csv (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/migration-guides/matlab/README.md (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/migration-guides/matlab/data/data.csv (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/tutorials/read_eval_print_loop.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/docs/usage.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/etc/cli_opts.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/history.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/http/client.js.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/http/server.js.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/index.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/net-socket-2/client.js.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/net-socket-2/server.js.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/net-socket/client.js.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/examples/net-socket/server.js.txt (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/actions.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/ansi_colors.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/auto_close_pairs.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/auto_close_pairs_close_symbols.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/auto_close_pairs_open_symbols.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/auto_close_pairs_walk.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/browser/index.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/commands.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/add_theme.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/clear.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/delete_theme.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/get_theme.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/keybindings.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/pager.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/presentation_start.js (98%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/presentation_stop.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/rename_theme.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/rerun.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/set_keybinding.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/settings.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/commands/themes.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/completer_engine.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/completer_preview.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/default_keybindings.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/defaults.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/display_prompt.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/eager_evaluator.js (98%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/editor_actions.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/help_text.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/index.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/input_prompt.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/is_setting_name.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/keybindings.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/log.js create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/longest_common_prefix.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/main.js (72%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/multiline_handler.js (84%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/output_stream.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/parse_key.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/property_comparator.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/regexp_leading_whitespace.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/regexp_reserved_syntax_characters.js create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/set_commands.js create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/set_commands_global.js create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/setdiff.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/settings.js (100%) rename lib/node_modules/@stdlib/repl/{lib/settings_alias_args.js => cli/lib/settings_names.js} (60%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/settings_validators.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/syntax_highlighter.js (99%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/themes.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/validate.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/lib/validate_keybindings.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/validate_settings.js rename lib/node_modules/@stdlib/repl/{ => cli}/lib/welcome_text.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/package.json rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/template_literal.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/call_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/for_body.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/for_init.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/for_test.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/for_update.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/left_brace.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/while_body.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/positive/while_test.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-close-pairs/script.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/auto-delete-pairs/script.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/repl.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/comments.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/control_keywords.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/declaration_names.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/functions.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/keywords.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/local_scopes.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/member_expressions.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/numeric_literals.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/objects.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/operators.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/punctuation.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/regexp.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/reserved_literals.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/special_identifiers.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/string_literals.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/fixtures/syntax-highlighting/variables.json (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/test.auto_close_pairs.js (99%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/test.auto_delete_pairs.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/test.auto_page.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/test.completer_engine.js (99%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/test.completion_previews.js (95%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/integration/test.syntax_highlighting.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/test.cli.js (100%) rename lib/node_modules/@stdlib/repl/{ => cli}/test/test.js (100%) delete mode 100644 lib/node_modules/@stdlib/repl/lib/complete_settings.js delete mode 100644 lib/node_modules/@stdlib/repl/lib/regexp_settings.js delete mode 100644 lib/node_modules/@stdlib/repl/lib/settings_aliases.js diff --git a/lib/node_modules/@stdlib/repl/data/contributor.json b/lib/node_modules/@stdlib/repl/base/data/contributor.json similarity index 100% rename from lib/node_modules/@stdlib/repl/data/contributor.json rename to lib/node_modules/@stdlib/repl/base/data/contributor.json diff --git a/lib/node_modules/@stdlib/repl/data/example.csv b/lib/node_modules/@stdlib/repl/base/data/example.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/data/example.csv rename to lib/node_modules/@stdlib/repl/base/data/example.csv diff --git a/lib/node_modules/@stdlib/repl/data/example.json b/lib/node_modules/@stdlib/repl/base/data/example.json similarity index 100% rename from lib/node_modules/@stdlib/repl/data/example.json rename to lib/node_modules/@stdlib/repl/base/data/example.json diff --git a/lib/node_modules/@stdlib/repl/data/help.csv b/lib/node_modules/@stdlib/repl/base/data/help.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/data/help.csv rename to lib/node_modules/@stdlib/repl/base/data/help.csv diff --git a/lib/node_modules/@stdlib/repl/data/help.json b/lib/node_modules/@stdlib/repl/base/data/help.json similarity index 100% rename from lib/node_modules/@stdlib/repl/data/help.json rename to lib/node_modules/@stdlib/repl/base/data/help.json diff --git a/lib/node_modules/@stdlib/repl/data/info.csv b/lib/node_modules/@stdlib/repl/base/data/info.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/data/info.csv rename to lib/node_modules/@stdlib/repl/base/data/info.csv diff --git a/lib/node_modules/@stdlib/repl/data/info.json b/lib/node_modules/@stdlib/repl/base/data/info.json similarity index 100% rename from lib/node_modules/@stdlib/repl/data/info.json rename to lib/node_modules/@stdlib/repl/base/data/info.json diff --git a/lib/node_modules/@stdlib/repl/data/license_text.json b/lib/node_modules/@stdlib/repl/base/data/license_text.json similarity index 100% rename from lib/node_modules/@stdlib/repl/data/license_text.json rename to lib/node_modules/@stdlib/repl/base/data/license_text.json diff --git a/lib/node_modules/@stdlib/repl/data/tutorial.csv b/lib/node_modules/@stdlib/repl/base/data/tutorial.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/data/tutorial.csv rename to lib/node_modules/@stdlib/repl/base/data/tutorial.csv diff --git a/lib/node_modules/@stdlib/repl/data/tutorial.json b/lib/node_modules/@stdlib/repl/base/data/tutorial.json similarity index 100% rename from lib/node_modules/@stdlib/repl/data/tutorial.json rename to lib/node_modules/@stdlib/repl/base/data/tutorial.json diff --git a/lib/node_modules/@stdlib/repl/docs/commands/__done__.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/__done__.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/__done__.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/__done__.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/_require.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/_require.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/_require.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/_require.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/alias2pkg.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/alias2pkg.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/alias2pkg.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/alias2pkg.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/alias2related.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/alias2related.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/alias2related.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/alias2related.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/ans.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/ans.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/ans.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/ans.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/assignfrom.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/assignfrom.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/assignfrom.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/assignfrom.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/assignin.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/assignin.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/assignin.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/assignin.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/citation.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/citation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/citation.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/citation.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/clear_history.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/clear_history.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/clear_history.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/clear_history.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/clear_user_docs.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/clear_user_docs.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/clear_user_docs.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/clear_user_docs.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/clear_vars.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/clear_vars.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/clear_vars.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/clear_vars.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/clear_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/clear_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/clear_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/clear_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/contributor.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/contributor.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/contributor.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/contributor.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/copyright.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/copyright.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/copyright.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/copyright.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/credits.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/credits.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/credits.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/credits.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/current_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/current_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/current_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/current_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/deeprerequire.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/deeprerequire.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/deeprerequire.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/deeprerequire.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/delete_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/delete_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/delete_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/delete_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/donate.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/donate.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/donate.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/donate.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/evalin.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/evalin.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/evalin.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/evalin.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/example.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/example.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/example.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/example.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/global.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/global.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/global.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/global.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/help.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/help.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/help.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/help.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/info.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/info.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/info.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/info.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/is_keyword.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/is_keyword.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/is_keyword.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/is_keyword.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/is_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/is_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/is_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/is_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/license_text.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/license_text.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/license_text.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/license_text.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/load.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/load.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/load.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/load.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/load_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/load_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/load_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/load_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/log_start.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/log_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/log_start.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/log_start.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/log_stop.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/log_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/log_stop.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/log_stop.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/quit.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/quit.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/quit.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/quit.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/rename_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/rename_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/rename_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/rename_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/rerequire.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/rerequire.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/rerequire.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/rerequire.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/rerun.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/rerun.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/rerun.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/rerun.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/reset.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/reset.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/reset.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/reset.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/save.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/save.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/save.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/save.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/save_start.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/save_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/save_start.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/save_start.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/save_stop.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/save_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/save_stop.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/save_stop.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/tutorial.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/tutorial.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/tutorial.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/tutorial.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/user_doc.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/user_doc.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/user_doc.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/user_doc.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/vars.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/vars.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/vars.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/vars.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/vars_workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/vars_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/vars_workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/vars_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/workspace.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/workspace.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/workspace.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/workspaces.txt b/lib/node_modules/@stdlib/repl/base/docs/commands/workspaces.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/workspaces.txt rename to lib/node_modules/@stdlib/repl/base/docs/commands/workspaces.txt diff --git a/lib/node_modules/@stdlib/repl/lib/acorn_detect_multiline_input.js b/lib/node_modules/@stdlib/repl/base/lib/acorn_detect_multiline_input.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/acorn_detect_multiline_input.js rename to lib/node_modules/@stdlib/repl/base/lib/acorn_detect_multiline_input.js diff --git a/lib/node_modules/@stdlib/repl/lib/alias_overrides.js b/lib/node_modules/@stdlib/repl/base/lib/alias_overrides.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/alias_overrides.js rename to lib/node_modules/@stdlib/repl/base/lib/alias_overrides.js diff --git a/lib/node_modules/@stdlib/repl/lib/alias_to_string.js b/lib/node_modules/@stdlib/repl/base/lib/alias_to_string.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/alias_to_string.js rename to lib/node_modules/@stdlib/repl/base/lib/alias_to_string.js diff --git a/lib/node_modules/@stdlib/repl/lib/aliases.js b/lib/node_modules/@stdlib/repl/base/lib/aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/aliases.js rename to lib/node_modules/@stdlib/repl/base/lib/aliases.js diff --git a/lib/node_modules/@stdlib/repl/lib/append_unique.js b/lib/node_modules/@stdlib/repl/base/lib/append_unique.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/append_unique.js rename to lib/node_modules/@stdlib/repl/base/lib/append_unique.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands.js b/lib/node_modules/@stdlib/repl/base/lib/commands.js similarity index 78% rename from lib/node_modules/@stdlib/repl/lib/commands.js rename to lib/node_modules/@stdlib/repl/base/lib/commands.js index 88c4a5a63ea9..252afaf8d3d6 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands.js +++ b/lib/node_modules/@stdlib/repl/base/lib/commands.js @@ -20,14 +20,12 @@ // MODULES // -var onAddTheme = require( './commands/add_theme.js' ); var onAlias2Pkg = require( './commands/alias2pkg.js' ); var onAlias2Related = require( './commands/alias2related.js' ); var onAns = require( './commands/ans.js' ); var onAssignin = require( './commands/assignin.js' ); var onAssignfrom = require( './commands/assignfrom.js' ); var onCitation = require( './commands/citation.js' ); -var onClear = require( './commands/clear.js' ); var onClearHistory = require( './commands/clear_history.js' ); var onClearUserDocs = require( './commands/clear_user_docs.js' ); var onClearVars = require( './commands/clear_vars.js' ); @@ -36,34 +34,23 @@ var onContributors = require( './commands/contributor.js' ); var onCopyright = require( './commands/copyright.js' ); var onCredits = require( './commands/credits.js' ); var onCurrentWorkspace = require( './commands/current_workspace.js' ); -var onDeleteTheme = require( './commands/delete_theme.js' ); var onDeleteWorkspace = require( './commands/delete_workspace.js' ); var onDeeprerequire = require( './commands/deeprerequire.js' ); var onDonate = require( './commands/donate.js' ); var onDone = require( './commands/__done__.js' ); var onEvalin = require( './commands/evalin.js' ); var onExample = require( './commands/example.js' ); -var onGetTheme = require( './commands/get_theme.js' ); 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' ); -var onPager = require( './commands/pager.js' ); -var onPresentationStart = require( './commands/presentation_start.js' ); -var onPresentationStop = require( './commands/presentation_stop.js' ); var onQuit = require( './commands/quit.js' ); -var onRenameTheme = require( './commands/rename_theme.js' ); 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' ); var onUserDoc = require( './commands/user_doc.js' ); var onVars = require( './commands/vars.js' ); @@ -97,14 +84,12 @@ function commands( repl ) { // Define a list of REPL-specific commands (NOTE: keep in alphabetical order): cmds = []; cmds.push( [ '__done__', onDone( repl ), false ] ); - cmds.push( [ 'addTheme', onAddTheme( repl ), false ] ); cmds.push( [ 'alias2pkg', onAlias2Pkg( repl ), false ] ); cmds.push( [ 'alias2related', onAlias2Related( repl, cmds ), false ] ); cmds.push( [ 'ans', onAns( repl ), true ] ); cmds.push( [ 'assignfrom', onAssignfrom( repl ), false ] ); cmds.push( [ 'assignin', onAssignin( repl ), false ] ); cmds.push( [ 'citation', onCitation( repl ), false ] ); - cmds.push( [ 'clear', onClear( repl ), false ] ); cmds.push( [ 'clearHistory', onClearHistory( repl ), false ] ); cmds.push( [ 'clearUserDocs', onClearUserDocs( repl ), false ] ); cmds.push( [ 'clearVars', onClearVars( repl ), false ] ); @@ -113,33 +98,22 @@ function commands( repl ) { cmds.push( [ 'copyright', onCopyright( repl ), false ] ); cmds.push( [ 'credits', onCredits( repl ), false ] ); cmds.push( [ 'currentWorkspace', onCurrentWorkspace( repl ), true ] ); - cmds.push( [ 'deleteTheme', onDeleteTheme( repl ), false ] ); cmds.push( [ 'deleteWorkspace', onDeleteWorkspace( repl ), false ] ); cmds.push( [ 'deeprerequire', onDeeprerequire( repl ), false ] ); cmds.push( [ 'donate', onDonate( repl ), false ] ); cmds.push( [ 'evalin', onEvalin( repl, cmds ), false ] ); cmds.push( [ 'example', onExample( repl, cmds ), false ] ); - cmds.push( [ 'getTheme', onGetTheme( repl ), false ] ); cmds.push( [ 'help', onHelp( repl, cmds ), false ] ); 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 ] ); - cmds.push( [ 'pager', onPager( repl ), false ] ); - cmds.push( [ 'presentationStart', onPresentationStart( repl ), false ] ); - cmds.push( [ 'presentationStop', onPresentationStop( repl ), false ] ); cmds.push( [ 'quit', onQuit( repl ), false ] ); - cmds.push( [ 'renameTheme', onRenameTheme( repl ), false ] ); cmds.push( [ 'renameWorkspace', onRenameWorkspace( repl ), false ] ); 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 ] ); cmds.push( [ 'userDoc', onUserDoc( repl ), false ] ); cmds.push( [ 'vars', onVars( repl ), false ] ); diff --git a/lib/node_modules/@stdlib/repl/lib/commands/__done__.js b/lib/node_modules/@stdlib/repl/base/lib/commands/__done__.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/__done__.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/__done__.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js b/lib/node_modules/@stdlib/repl/base/lib/commands/alias2pkg.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/alias2pkg.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/alias2related.js b/lib/node_modules/@stdlib/repl/base/lib/commands/alias2related.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/alias2related.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/alias2related.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/ans.js b/lib/node_modules/@stdlib/repl/base/lib/commands/ans.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/ans.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/ans.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/assignfrom.js b/lib/node_modules/@stdlib/repl/base/lib/commands/assignfrom.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/assignfrom.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/assignfrom.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/assignin.js b/lib/node_modules/@stdlib/repl/base/lib/commands/assignin.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/assignin.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/assignin.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/citation.js b/lib/node_modules/@stdlib/repl/base/lib/commands/citation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/citation.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/citation.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear_history.js b/lib/node_modules/@stdlib/repl/base/lib/commands/clear_history.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/clear_history.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/clear_history.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear_user_docs.js b/lib/node_modules/@stdlib/repl/base/lib/commands/clear_user_docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/clear_user_docs.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/clear_user_docs.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js b/lib/node_modules/@stdlib/repl/base/lib/commands/clear_vars.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/clear_vars.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/clear_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/clear_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/contributor.js b/lib/node_modules/@stdlib/repl/base/lib/commands/contributor.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/contributor.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/contributor.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/copyright.js b/lib/node_modules/@stdlib/repl/base/lib/commands/copyright.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/copyright.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/copyright.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/credits.js b/lib/node_modules/@stdlib/repl/base/lib/commands/credits.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/credits.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/credits.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/current_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/current_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/deeprerequire.js b/lib/node_modules/@stdlib/repl/base/lib/commands/deeprerequire.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/deeprerequire.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/deeprerequire.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/delete_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/delete_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/donate.js b/lib/node_modules/@stdlib/repl/base/lib/commands/donate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/donate.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/donate.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/evalin.js b/lib/node_modules/@stdlib/repl/base/lib/commands/evalin.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/evalin.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/evalin.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/example.js b/lib/node_modules/@stdlib/repl/base/lib/commands/example.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/example.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/example.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/help.js b/lib/node_modules/@stdlib/repl/base/lib/commands/help.js similarity index 98% rename from lib/node_modules/@stdlib/repl/lib/commands/help.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/help.js index cf849a33b582..c1aa57b58da1 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/help.js +++ b/lib/node_modules/@stdlib/repl/base/lib/commands/help.js @@ -29,7 +29,6 @@ var alias2help = require( '@stdlib/repl/help' ); var indexOf = require( './../index_of.js' ); var findUniqueEntry = require( './../find_unique_entry.js' ); var alias2string = require( './../alias_to_string.js' ); -var HELP_TEXT = require( './../help_text.js' ); var DOCS = require( './../repl_docs.js' ); @@ -60,7 +59,7 @@ function command( repl, cmds ) { var N; var i; if ( arguments.length === 0 ) { - repl._ostream.write( HELP_TEXT ); + repl._ostream.write( repl._helpText ); return; } aliases = repl._aliases; diff --git a/lib/node_modules/@stdlib/repl/lib/commands/info.js b/lib/node_modules/@stdlib/repl/base/lib/commands/info.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/info.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/info.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/is_keyword.js b/lib/node_modules/@stdlib/repl/base/lib/commands/is_keyword.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/is_keyword.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/is_keyword.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/is_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/is_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/license_text.js b/lib/node_modules/@stdlib/repl/base/lib/commands/license_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/license_text.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/license_text.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/load.js b/lib/node_modules/@stdlib/repl/base/lib/commands/load.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/load.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/load.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/load_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/load_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/quit.js b/lib/node_modules/@stdlib/repl/base/lib/commands/quit.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/quit.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/quit.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/rename_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/rename_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/rerequire.js b/lib/node_modules/@stdlib/repl/base/lib/commands/rerequire.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/rerequire.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/rerequire.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/reset.js b/lib/node_modules/@stdlib/repl/base/lib/commands/reset.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/reset.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/reset.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/tutorial.js b/lib/node_modules/@stdlib/repl/base/lib/commands/tutorial.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/tutorial.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/tutorial.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/user_doc.js b/lib/node_modules/@stdlib/repl/base/lib/commands/user_doc.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/user_doc.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/user_doc.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/vars.js b/lib/node_modules/@stdlib/repl/base/lib/commands/vars.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/vars.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/vars.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/vars_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/vars_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/workspace.js b/lib/node_modules/@stdlib/repl/base/lib/commands/workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/workspaces.js b/lib/node_modules/@stdlib/repl/base/lib/commands/workspaces.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/workspaces.js rename to lib/node_modules/@stdlib/repl/base/lib/commands/workspaces.js diff --git a/lib/node_modules/@stdlib/repl/lib/compile_code.js b/lib/node_modules/@stdlib/repl/base/lib/compile_code.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/compile_code.js rename to lib/node_modules/@stdlib/repl/base/lib/compile_code.js diff --git a/lib/node_modules/@stdlib/repl/lib/compile_command.js b/lib/node_modules/@stdlib/repl/base/lib/compile_command.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/compile_command.js rename to lib/node_modules/@stdlib/repl/base/lib/compile_command.js diff --git a/lib/node_modules/@stdlib/repl/lib/complete_expression.js b/lib/node_modules/@stdlib/repl/base/lib/complete_expression.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/complete_expression.js rename to lib/node_modules/@stdlib/repl/base/lib/complete_expression.js diff --git a/lib/node_modules/@stdlib/repl/lib/complete_fs.js b/lib/node_modules/@stdlib/repl/base/lib/complete_fs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/complete_fs.js rename to lib/node_modules/@stdlib/repl/base/lib/complete_fs.js diff --git a/lib/node_modules/@stdlib/repl/lib/complete_require.js b/lib/node_modules/@stdlib/repl/base/lib/complete_require.js similarity index 98% rename from lib/node_modules/@stdlib/repl/lib/complete_require.js rename to lib/node_modules/@stdlib/repl/base/lib/complete_require.js index 03888ac53a42..6f367dbb2b87 100644 --- a/lib/node_modules/@stdlib/repl/lib/complete_require.js +++ b/lib/node_modules/@stdlib/repl/base/lib/complete_require.js @@ -27,7 +27,7 @@ var readDir = require( '@stdlib/fs/read-dir' ).sync; var startsWith = require( '@stdlib/string/starts-with' ); var extname = require( '@stdlib/utils/extname' ); var cwd = require( '@stdlib/process/cwd' ); -var indexRegExp = require( './regexp_index.js' ); // eslint-disable-line stdlib/no-require-index +var indexRegExp = require( './regexp_index.js' ); var relativePathRegExp = require( './regexp_relative_require_path.js' ); var pathRegExp = require( './regexp_path.js' ); var contains = require( './contains.js' ); diff --git a/lib/node_modules/@stdlib/repl/lib/complete_tutorial.js b/lib/node_modules/@stdlib/repl/base/lib/complete_tutorial.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/complete_tutorial.js rename to lib/node_modules/@stdlib/repl/base/lib/complete_tutorial.js diff --git a/lib/node_modules/@stdlib/repl/lib/complete_walk_find_last.js b/lib/node_modules/@stdlib/repl/base/lib/complete_walk_find_last.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/complete_walk_find_last.js rename to lib/node_modules/@stdlib/repl/base/lib/complete_walk_find_last.js diff --git a/lib/node_modules/@stdlib/repl/lib/complete_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/complete_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/complete_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/complete_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/completer.js b/lib/node_modules/@stdlib/repl/base/lib/completer.js similarity index 88% rename from lib/node_modules/@stdlib/repl/lib/completer.js rename to lib/node_modules/@stdlib/repl/base/lib/completer.js index ce393c6e5b43..d859c4a6a92c 100644 --- a/lib/node_modules/@stdlib/repl/lib/completer.js +++ b/lib/node_modules/@stdlib/repl/base/lib/completer.js @@ -29,13 +29,11 @@ var fsRegExp = require( './regexp_fs_aliases.js' ); var requireRegExp = require( './regexp_require.js' ); var workspaceRegExp = require( './regexp_workspace.js' ); var tutorialRegExp = require( './regexp_tutorial.js' ); -var settingsRegExp = require( './regexp_settings.js' ); var reservedCharsRegExp = require( './regexp_reserved_syntax_characters.js' ); var completeRequire = require( './complete_require.js' ); var completeFS = require( './complete_fs.js' ); var completeWorkspace = require( './complete_workspace.js' ); var completeTutorial = require( './complete_tutorial.js' ); -var completeSettings = require( './complete_settings.js' ); var completeExpression = require( './complete_expression.js' ); @@ -165,21 +163,6 @@ function completer( repl ) { debug( 'Results: %s', res.join( ', ' ) ); return clbk( null, [ res, line ] ); } - // Test if the line has an incomplete settings expression: - match = line.match( settingsRegExp() ); - if ( match ) { - debug( 'Detected incomplete settings expression.' ); - - debug( 'Expression: %s', match[ 0 ] ); - debug( 'Settings API: %s', match[ 1 ] ); - debug( 'Value to complete: %s', match[ 3 ] ); - line = completeSettings( res, repl, match[ 0 ], match[ 1 ], match[ 3 ] ); // eslint-disable-line max-len - res = normalize( res ); - - debug( 'Completion filter: %s', line ); - debug( 'Results: %s', res.join( ', ' ) ); - return clbk( null, [ res, line ] ); - } // Sanity check that we are attempting to complete something which is completable: if ( reservedCharsRegExp().test( line[ repl._rli.cursor-1 ] ) ) { debug( 'Detected attempt to trigger completion after a special character.' ); diff --git a/lib/node_modules/@stdlib/repl/lib/contains.js b/lib/node_modules/@stdlib/repl/base/lib/contains.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/contains.js rename to lib/node_modules/@stdlib/repl/base/lib/contains.js diff --git a/lib/node_modules/@stdlib/repl/lib/create_accessor.js b/lib/node_modules/@stdlib/repl/base/lib/create_accessor.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/create_accessor.js rename to lib/node_modules/@stdlib/repl/base/lib/create_accessor.js diff --git a/lib/node_modules/@stdlib/repl/lib/create_evaluation_context.js b/lib/node_modules/@stdlib/repl/base/lib/create_evaluation_context.js similarity index 94% rename from lib/node_modules/@stdlib/repl/lib/create_evaluation_context.js rename to lib/node_modules/@stdlib/repl/base/lib/create_evaluation_context.js index 1850354df078..7020e14162ed 100644 --- a/lib/node_modules/@stdlib/repl/lib/create_evaluation_context.js +++ b/lib/node_modules/@stdlib/repl/base/lib/create_evaluation_context.js @@ -45,10 +45,11 @@ var resolveLookupPaths = Module._resolveLookupPaths; // eslint-disable-line no-u * @private * @param {Array} out - strided output array for storing variables added to the evaluation context * @param {Stream} ostream - output stream +* @param {Stream} estream - error stream * @param {boolean} sandbox - boolean indicating whether the evaluation context should be "sandboxed" * @returns {Object} context */ -function createContext( out, ostream, sandbox ) { +function createContext( out, ostream, estream, sandbox ) { var context; var keys; var i; @@ -67,7 +68,7 @@ function createContext( out, ostream, sandbox ) { setReadOnly( context, 'global', context ); // Create a new `console` interface: - setReadOnly( context, 'console', new Console( ostream ) ); + setReadOnly( context, 'console', new Console( ostream, estream ) ); // Create a new `module` object: setReadOnly( context, 'module', new Module( '' ) ); diff --git a/lib/node_modules/@stdlib/repl/lib/create_require.js b/lib/node_modules/@stdlib/repl/base/lib/create_require.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/create_require.js rename to lib/node_modules/@stdlib/repl/base/lib/create_require.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/defaults.js b/lib/node_modules/@stdlib/repl/base/lib/defaults.js new file mode 100644 index 000000000000..02b42792e96b --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/lib/defaults.js @@ -0,0 +1,74 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 stdin = require( '@stdlib/streams/node/stdin' ); +var stdout = require( '@stdlib/streams/node/stdout' ); +var stderr = require( '@stdlib/streams/node/stderr' ); + + +// MAIN // + +/** +* Returns default options. +* +* @private +* @returns {Object} default options +* +* @example +* var opts = defaults(); +* // returns {...} +*/ +function defaults() { + return { + // Default input stream: + 'input': stdin, + + // Default output stream: + 'output': stdout, + + // Default error stream: + 'error': stderr, + + // Number of milliseconds to execute a command before terminating execution: + 'timeout': 4294967295, + + // Flag indicating whether to run a REPL in a sandboxed context: + 'sandbox': true, + + // File path specifying where to save REPL command history: + 'save': '', + + // File path specifying a JavaScript file to load and evaluate line-by-line (e.g., a previous REPL history file): + 'load': '', + + // File path specifying where to save REPL commands and printed output: + 'log': '', + + // Flag indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced: + 'quiet': false + }; +} + + +// EXPORTS // + +module.exports = defaults; diff --git a/lib/node_modules/@stdlib/repl/lib/drain.js b/lib/node_modules/@stdlib/repl/base/lib/drain.js similarity index 73% rename from lib/node_modules/@stdlib/repl/lib/drain.js rename to lib/node_modules/@stdlib/repl/base/lib/drain.js index 84187842c4c5..78aab49df7ce 100644 --- a/lib/node_modules/@stdlib/repl/lib/drain.js +++ b/lib/node_modules/@stdlib/repl/base/lib/drain.js @@ -22,13 +22,9 @@ // MODULES // -var inspect = require( 'util' ).inspect; var logger = require( 'debug' ); -var isndarrayLike = require( '@stdlib/assert/is-ndarray-like' ); -var replace = require( '@stdlib/string/replace' ); var noop = require( '@stdlib/utils/noop' ); var nextTick = require( '@stdlib/utils/next-tick' ); -var displayPrompt = require( './display_prompt.js' ); var updateRegExpCache = require( './update_regexp_cache.js' ); var restoreRegExpMatches = require( './restore_regexp_matches.js' ); @@ -53,8 +49,6 @@ function drain( repl ) { var opts; var code; var res; - var pre; - var tmp; if ( repl._busy ) { debug( 'Waiting on a command to finish...' ); @@ -62,9 +56,6 @@ function drain( repl ) { } if ( repl._queue.length === 0 ) { debug( 'Command queue is empty.' ); - if ( !repl._closed ) { - displayPrompt( repl, false ); - } repl.emit( 'drain' ); return; } @@ -100,12 +91,10 @@ function drain( repl ) { } } catch ( error ) { debug( 'Error: %s', error.message ); - repl._ostream.write( 'Error: '+error.message+'\n' ); - repl.emit( 'command', code.raw, false ); // command failed + repl.emit( 'command', code.raw, false, error, false ); // command failed updateRegExpCache( repl._regexp ); repl._busy = false; - displayPrompt( repl, false ); // Clear the command queue, as an error may cause downstream "dependencies" to not be fulfilled, etc: repl._queue.clear(); @@ -125,17 +114,6 @@ function drain( repl ) { // Cache the result: repl._ans = res; - if ( code.silent === false && res !== void 0 ) { - pre = replace( repl._outputPrompt, '%d', (repl._count+1).toString() ); - - // TODO: pretty printing (can defer to `util.inspect` for now, but will invariably want more control over this later, possibly including default configuration, etc, either at startup, during runtime, or according to an external configuration file) - if ( isndarrayLike( res ) ) { - tmp = res.toString(); // FIXME: this is a hack in order to avoid printing private ndarray properties in the REPL, as done by the built-in `util.inspect`. Ideally, we'd roll our own inspector which specifically accommodates stdlib's ndarray and other specialized classes. - } else { - tmp = repl._ans; - } - repl._ostream.write( pre+inspect( tmp )+'\n' ); - } // Finish processing: return beforeNextTick(); @@ -178,9 +156,7 @@ function drain( repl ) { if ( error ) { debug( 'Error: %s', error.message ); - repl._ostream.write( 'Error: '+error.message+'\n' ); - repl.emit( 'command', code.raw, false ); // command failed - displayPrompt( repl, false ); + repl.emit( 'command', code.raw, false, error, false ); // command failed // Indicate that command execution has completed: repl._busy = false; @@ -193,12 +169,6 @@ function drain( repl ) { // Cache the result: repl._ans = [ res, results ]; - if ( code.silent === false && ( res !== void 0 || results !== void 0 ) ) { // eslint-disable-line max-len - pre = replace( repl._outputPrompt, '%d', (repl._count+1).toString() ); - - // TODO: pretty printing (can defer to `util.inspect` for now, but will invariably want more control over this later, possibly including default configuration, etc, either at startup, during runtime, or according to an external configuration file) - repl._ostream.write( pre+inspect( repl._ans )+'\n' ); - } // Finish processing: beforeNextTick(); @@ -220,7 +190,7 @@ function drain( repl ) { function beforeNextTick() { // Announce that the command succeeded: debug( 'Finished evaluating command.' ); - repl.emit( 'command', code.raw, true ); + repl.emit( 'command', code.raw, true, repl._ans, code.silent ); nextTick( onTick ); } diff --git a/lib/node_modules/@stdlib/repl/lib/filter_by_prefix.js b/lib/node_modules/@stdlib/repl/base/lib/filter_by_prefix.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/filter_by_prefix.js rename to lib/node_modules/@stdlib/repl/base/lib/filter_by_prefix.js diff --git a/lib/node_modules/@stdlib/repl/lib/find_unique_entry.js b/lib/node_modules/@stdlib/repl/base/lib/find_unique_entry.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/find_unique_entry.js rename to lib/node_modules/@stdlib/repl/base/lib/find_unique_entry.js diff --git a/lib/node_modules/@stdlib/repl/lib/fs_alias_args.js b/lib/node_modules/@stdlib/repl/base/lib/fs_alias_args.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/fs_alias_args.js rename to lib/node_modules/@stdlib/repl/base/lib/fs_alias_args.js diff --git a/lib/node_modules/@stdlib/repl/lib/fs_aliases.js b/lib/node_modules/@stdlib/repl/base/lib/fs_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/fs_aliases.js rename to lib/node_modules/@stdlib/repl/base/lib/fs_aliases.js diff --git a/lib/node_modules/@stdlib/repl/lib/globals.js b/lib/node_modules/@stdlib/repl/base/lib/globals.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/globals.js rename to lib/node_modules/@stdlib/repl/base/lib/globals.js diff --git a/lib/node_modules/@stdlib/repl/lib/has_async_directive.js b/lib/node_modules/@stdlib/repl/base/lib/has_async_directive.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/has_async_directive.js rename to lib/node_modules/@stdlib/repl/base/lib/has_async_directive.js diff --git a/lib/node_modules/@stdlib/repl/lib/index.js b/lib/node_modules/@stdlib/repl/base/lib/index.js similarity index 92% rename from lib/node_modules/@stdlib/repl/lib/index.js rename to lib/node_modules/@stdlib/repl/base/lib/index.js index 063fd52f6aa5..80fec5e90aaf 100644 --- a/lib/node_modules/@stdlib/repl/lib/index.js +++ b/lib/node_modules/@stdlib/repl/base/lib/index.js @@ -19,13 +19,13 @@ 'use strict'; /** -* REPL environment. +* REPL. * -* @module @stdlib/repl +* @module @stdlib/repl/base * * @example * var debug = require( '@stdlib/streams/node/debug-sink' ); -* var REPL = require( '@stdlib/repl' ); +* var REPL = require( '@stdlib/repl/base' ); * * function onExit() { * console.log( 'REPL closed.' ); diff --git a/lib/node_modules/@stdlib/repl/lib/index_of.js b/lib/node_modules/@stdlib/repl/base/lib/index_of.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/index_of.js rename to lib/node_modules/@stdlib/repl/base/lib/index_of.js diff --git a/lib/node_modules/@stdlib/repl/lib/is_block_scope.js b/lib/node_modules/@stdlib/repl/base/lib/is_block_scope.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/is_block_scope.js rename to lib/node_modules/@stdlib/repl/base/lib/is_block_scope.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/is_multiline_input.js b/lib/node_modules/@stdlib/repl/base/lib/is_multiline_input.js new file mode 100644 index 000000000000..c768485bde47 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/lib/is_multiline_input.js @@ -0,0 +1,95 @@ +/** +* @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-invalid-this */ + +'use strict'; + +// MODULES // + +var Parser = require( 'acorn' ).Parser; +var parseLoose = require( 'acorn-loose' ).parse; +var logger = require( 'debug' ); +var multilinePlugin = require( './acorn_detect_multiline_input.js' ); + + +// VARIABLES // + +var debug = logger( 'repl:is-multiline-input' ); +var hasMultilineError = Parser.extend( multilinePlugin ).hasMultilineError; +var RE_WHITESPACE = /^\s*$/; +var RE_SINGLE_LINE_COMMENT = /^\s*\/\//; +var RE_MULTI_LINE_COMMENT = /^\s*\/\*.*\*\/$/; +var AOPTS = { + 'ecmaVersion': 'latest' +}; + + +// MAIN // + +/** +* Checks if the given input is a possible multi-line command. +* +* @private +* @param {string} input - input command +* @returns {boolean} boolean indicating whether the given input is a possible multi-line command +*/ +function isMultilineInput( input ) { + var node; + var tmp; + var ast; + + debug( 'Attempting to detect multi-line input...' ); + if ( RE_WHITESPACE.test( input ) ) { + debug( 'Multi-line input not detected.' ); + return false; + } + if ( RE_SINGLE_LINE_COMMENT.test( input ) || RE_MULTI_LINE_COMMENT.test( input ) ) { // eslint-disable-line max-len + debug( 'Multi-line input not detected.' ); + return false; + } + // Check if the command has valid syntax... + tmp = this._processCommand( input ); + if ( !( tmp instanceof Error ) ) { + debug( 'Multi-line input not detected.' ); + return false; + } + if ( hasMultilineError( input, AOPTS ) ) { + debug( 'Detected multi-line input. Triggering multi-line mode...' ); + return true; + } + // Still possible that a user is attempting to enter an object literal across multiple lines... + ast = parseLoose( input, AOPTS ); + + // Check for a trailing node which is being interpreted as a block statement, as this could be an object literal... + node = ast.body[ ast.body.length-1 ]; + if ( node.type === 'BlockStatement' && node.end === ast.end ) { + tmp = input.slice( node.start, node.end ); + if ( hasMultilineError( tmp, AOPTS ) ) { + debug( 'Detected multi-line input. Triggering multi-line mode...' ); + return true; + } + } + debug( 'Multi-line input not detected.' ); + return false; +} + + +// EXPORTS // + +module.exports = isMultilineInput; diff --git a/lib/node_modules/@stdlib/repl/lib/is_scope.js b/lib/node_modules/@stdlib/repl/base/lib/is_scope.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/is_scope.js rename to lib/node_modules/@stdlib/repl/base/lib/is_scope.js diff --git a/lib/node_modules/@stdlib/repl/lib/is_silent_command.js b/lib/node_modules/@stdlib/repl/base/lib/is_silent_command.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/is_silent_command.js rename to lib/node_modules/@stdlib/repl/base/lib/is_silent_command.js diff --git a/lib/node_modules/@stdlib/repl/lib/log.js b/lib/node_modules/@stdlib/repl/base/lib/log.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/log.js rename to lib/node_modules/@stdlib/repl/base/lib/log.js diff --git a/lib/node_modules/@stdlib/repl/lib/longest_common_prefix.js b/lib/node_modules/@stdlib/repl/base/lib/longest_common_prefix.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/longest_common_prefix.js rename to lib/node_modules/@stdlib/repl/base/lib/longest_common_prefix.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/main.js b/lib/node_modules/@stdlib/repl/base/lib/main.js new file mode 100644 index 000000000000..4816c427590c --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/lib/main.js @@ -0,0 +1,719 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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-restricted-syntax, no-invalid-this, no-underscore-dangle */ + +'use strict'; + +// MODULES // + +var EventEmitter = require( 'events' ).EventEmitter; +var resolve = require( 'path' ).resolve; +var logger = require( 'debug' ); +var inherit = require( '@stdlib/utils/inherit' ); +var isString = require( '@stdlib/assert/is-string' ).isPrimitive; +var isFunction = require( '@stdlib/assert/is-function' ); +var isConfigurableProperty = require( '@stdlib/assert/is-configurable-property' ); +var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); +var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); +var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); +var format = require( '@stdlib/string/format' ); +var cwd = require( '@stdlib/process/cwd' ); +var readFileSync = require( '@stdlib/fs/read-file' ).sync; +var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; +var fifo = require( '@stdlib/utils/fifo' ); +var nextTick = require( '@stdlib/utils/next-tick' ); +var validate = require( './validate.js' ); +var defaults = require( './defaults.js' ); +var setAliases = require( './set_aliases.js' ); +var setAliasesGlobal = require( './set_aliases_global.js' ); +var setCommands = require( './set_commands.js' ); +var setCommandsGlobal = require( './set_commands_global.js' ); +var createEvalContext = require( './create_evaluation_context.js' ); +var commands = require( './commands.js' ); +var completerFactory = require( './completer.js' ); +var tokenizer = require( './tokenizer.js' ); +var processCommand = require( './process_command.js' ); +var compileCommand = require( './compile_command.js' ); +var processInput = require( './process_input.js' ); +var isMultilineInput = require( './is_multiline_input.js' ); +var ALIAS_OVERRIDES = require( './alias_overrides.js' ); + + +// VARIABLES // + +var debug = logger( 'repl' ); + + +// MAIN // + +/** +* REPL base constructor. +* +* @constructor +* @param {Options} options - constructor options +* @param {ReadableStream} [options.input=process.stdin] - input stream +* @param {WritableStream} [options.output=process.stdout] - output stream +* @param {WritableStream} [options.error=process.stderr] - error stream +* @param {boolean} [options.sandbox=true] - boolean indicating whether to run a REPL in a sandboxed context +* @param {PositiveInteger} [options.timeout=4294967295] - number of milliseconds to execute a command before terminating execution +* @param {string} [options.load] - file path specifying a JavaScript file to load and evaluate line-by-line (e.g., a previous REPL history file) +* @param {string} [options.save] - file path specifying where to save REPL command history +* @param {string} [options.log] - file path specifying where to save REPL commands and printed output +* @param {string} [options.quiet=false] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced +* @throws {Error} must provide valid options +* @returns {REPL} REPL instance +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* function onExit() { +* console.log( 'REPL closed.' ); +* } +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* repl.on( 'exit', onExit ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +function REPL( options ) { + var opts; + var self; + var err; + + if ( !( this instanceof REPL ) ) { + if ( arguments.length ) { + return new REPL( options ); + } + return new REPL(); + } + self = this; + + opts = defaults(); + if ( arguments.length ) { + err = validate( opts, options ); + if ( err ) { + throw err; + } + } + + debug( 'Options: %s', JSON.stringify({ + 'input': '', + 'output': '', + 'sandbox': opts.sandbox, + 'timeout': opts.timeout, + 'isTTY': opts.isTTY, + 'padding': opts.padding, + 'load': opts.load, + 'save': opts.save, + 'log': opts.log, + 'quiet': opts.quiet + })); + + // Call the parent constructor: + EventEmitter.call( this ); + + // Cache references to the input and output streams: + setNonEnumerableReadOnly( this, '_istream', opts.input ); + setNonEnumerableReadOnly( this, '_ostream', opts.output ); + setNonEnumerableReadOnly( this, '_estream', opts.error ); + + // Cache options: + setNonEnumerableReadOnly( this, '_timeout', opts.timeout ); + setNonEnumerableReadOnly( this, '_sandbox', opts.sandbox ); + setNonEnumerable( this, '_quiet', opts.quiet ); // allow this to be internally toggled + + // Initialize an internal data store: + setNonEnumerableReadOnly( this, '_internal', {} ); + setNonEnumerableReadOnly( this._internal, 'presentation', {} ); + setNonEnumerableReadOnly( this._internal.presentation, 'cache', {} ); + setNonEnumerable( this._internal.presentation, 'counter', 0 ); + + // Initialize an internal command queue: + setNonEnumerableReadOnly( this, '_queue', fifo() ); + + // Initialize a strided internal buffer for storing the command history: + setNonEnumerableReadOnly( this, '_history', [] ); + + // Initialize an internal buffer for storing the current command: + setNonEnumerableReadOnly( this, '_cmd', [] ); + + // Initialize a executed command counter: + setNonEnumerable( this, '_count', -1 ); + + // Initialize an internal buffer for saving regular expression matches between command evaluations: + setNonEnumerableReadOnly( this, '_regexp', [ '', '', '', '', '', '', '', '', '', '' ] ); + + // Initialize a strided internal cache of context globals: + setNonEnumerableReadOnly( this, '_contextVars', [] ); + + // For non-sandboxed REPLs, initialize an internal buffer for storing a (unique) sorted list of "built-in" REPL global variables/properties which need to be deleted upon closing a REPL in order to allow garbage collection and prevent memory leaks: + setNonEnumerableReadOnly( this, '_globalVars', ( this._sandbox ) ? null : [] ); + + // Initialize a strided internal cache of resolved global variables/properties in order to allow, e.g., help text look-up based on object reference, not just alias name (note: members alternate between `''` and ``): + setNonEnumerableReadOnly( this, '_aliases', [] ); + + // Initialize a strided internal buffer for storing user-defined documentation: + setNonEnumerableReadOnly( this, '_userdocs', [] ); + + // Initialize an internal buffer for storing a (unique) sorted list of workspace global variables/properties which were *initially* introduced during a REPL session (note: this overlaps with `_globalVars`, but more accurately represents a snapshot of the `global` state *before* a user begins entering commands, which is useful when wanting determine what variables/identifiers a user has introduced during a REPL session): + setNonEnumerableReadOnly( this, '_workspace', [] ); + + // Initialize a strided internal buffer for caching "base" workspace variables: + setNonEnumerableReadOnly( this, '_workspaces', {} ); + setReadOnly( this._workspaces, 'base', [] ); + + // Define the current workspace: + setNonEnumerable( this, '_currentWorkspace', 'base' ); + + // Initialize an internal flag indicating whether the REPL has been closed: + setNonEnumerable( this, '_closed', false ); + + // Initialize an internal flag indicating whether the REPL is currently busy with asynchronous processing: + setNonEnumerable( this, '_busy', false ); + + // Initialize an internal variable for caching the result of the last successfully evaluated command: + setNonEnumerable( this, '_ans', void 0 ); + + // Initialize an internal variable for setting a command callback: + setNonEnumerable( this, '_done', void 0 ); + + // Create a REPL execution context: + setNonEnumerable( this, '_context', this.createContext() ); + + // Create a new TAB completer: + setNonEnumerableReadOnly( this, '_completer', completerFactory( this ) ); + + // Create a new tokenizer: + setNonEnumerableReadOnly( this, '_tokenizer', tokenizer ); + + // Add listener for "command" events: + this.on( 'command', onCommand ); + this.on( 'input', onInput ); + this.on( 'interrupt', onInterrupt ); + + // TODO: check whether to synchronously initialize a REPL history file + + // TODO: check whether to synchronously initialize a REPL log file + + // Check whether to load and execute a JavaScript file (e.g., prior REPL history) upon startup... + if ( opts.load ) { + this.load( opts.load ); + } else { + this._count += 1; + } + return this; + + /** + * Callback invoked upon encountering a command input. + * + * @private + * @param {string} input - input command + */ + function onInput( input ) { + debug( 'Received an input: %s', input ); + if ( self._closed === false ) { + processInput( self, input ); + } + } + + /** + * Callback invoked upon receiving an interrupt. + * + * @private + * @returns {void} + */ + function onInterrupt() { + debug( 'Received an interrupt.' ); + + // If the REPL is currently busy executing a command, stop waiting for it to finish: + if ( self._busy ) { + self._done( new Error( 'unexpected error. Command execution terminated.' ) ); + return; + } + + // Reset the command queue: + self._queue.clear(); + } + + /** + * Callback invoked upon executing a command. + * + * @private + * @param {string} cmd - command + * @param {boolean} success - boolean indicating whether the command successfully executed + * @param {*} res - result + * @param {boolean} silent - boolean indicating whether the command output should be silenced + */ + function onCommand( cmd, success ) { + self._count += 1; + debug( 'Command count: %d', self._count ); + + // Update the internal command history buffer: [..., , , , ...] + self._history.push( self._count, cmd, success ); + + // TODO: if successful and if necessary, (asynchronously?) write the command to a history file (question: do we only want to write successful commands to the history file? maybe we need to option for limiting to successful commands?) + + // TODO: if necessary, (asynchronously?) write the command and result to a log file (JSON serialization?) + } +} + +/* +* Inherit from the `EventEmitter` prototype. +*/ +inherit( REPL, EventEmitter ); + +/** +* Checks if the given input is a possible multi-line command. +* +* @private +* @name _isMultilineInput +* @memberof REPL.prototype +* @type {Function} +* @param {string} input - input command +* @returns {boolean} boolean indicating whether the given input is a possible multi-line command +*/ +setNonEnumerableReadOnly( REPL.prototype, '_isMultilineInput', isMultilineInput ); + +/** +* Processes a "raw" input command.. +* +* @private +* @name _processCommand +* @memberof REPL.prototype +* @type {Function} +* @param {string} code - unevaluated command +* @returns {(string|Error)} processed command or an error +*/ +setNonEnumerableReadOnly( REPL.prototype, '_processCommand', processCommand ); + +/** +* Compiles a command. +* +* @private +* @name _compileCommand +* @memberof REPL.prototype +* @type {Function} +* @param {string} cmd - command string +* @returns {(Object|Error)} compiled command or an error +*/ +setNonEnumerableReadOnly( REPL.prototype, '_compileCommand', compileCommand ); + +/** +* Creates a REPL context. +* +* @name createContext +* @memberof REPL.prototype +* @type {Function} +* @returns {Object} REPL context +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* +* // Return a new REPL context: +* var ctx = repl.createContext(); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContext() { + var context; + var cmds; + + debug( 'Creating REPL execution context...' ); + + // Create an evaluation context: + context = createEvalContext( this._contextVars, this._ostream, this._estream, this._sandbox ); // eslint-disable-line max-len + + // Add project APIs... + if ( this._sandbox ) { + setAliases( this._aliases, context, ALIAS_OVERRIDES ); + } else { + setAliasesGlobal( this._globalVars, this._aliases, context, ALIAS_OVERRIDES ); // eslint-disable-line max-len + } + + // Get the list of REPL-specific commands: + cmds = commands( this ); + + // Add commands requiring privileged access to internal instance variables... + if ( this._sandbox ) { + setCommands( context, cmds ); + } else { + setCommandsGlobal( this._globalVars, context, cmds ); + } + + return context; +}); + +/** +* Resets a REPL's context. +* +* @name resetContext +* @memberof REPL.prototype +* @type {Function} +* @returns {REPL} REPL instance +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* +* // ... +* +* // Reset the REPL context: +* repl.resetContext(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext() { + var tmp; + var key; + var o; + var i; + var j; + + debug( 'Resetting REPL execution context...' ); + + // Before creating a new execution context in a non-sandboxed environment, remove current workspace variables in order to allow garbage collection and avoid memory leaks (e.g., variables/functions declared during a REPL session which might remain bound to the environment `global` after clearing a REPL): + if ( this._sandbox === false ) { + // WARNING: in a non-sandboxed environment, if a global variable is externally introduced during a REPL session (i.e., introduced via a mechanism outside of the REPL environment), we will delete that global variable, which means the following logic may introduce unintended side-effects for this particular edge case (e.g., application code may expect the presence of the subsequently deleted global variable). While not ideal, (a) user applications should not be introducing globals to begin with and (b) the probability of a user running a REPL session, a user clearing that REPL session, AND a global variable being introduced between starting a REPL and clearing the REPL should be negligible. + tmp = this._context.vars(); + for ( i = 0; i < tmp.length; i++ ) { + if ( isConfigurableProperty( this._context, tmp[ i ] ) ) { + delete this._context[ tmp[ i ] ]; + } + } + + // Remove REPL globals: + for ( i = 0; i < this._globalVars.length; i++ ) { + o = this._context; + key = this._globalVars[ i ].split( '.' ); // Note: this addresses nested key paths (e.g., `a.b.c`) + for ( j = 0; j < key.length-1; j++ ) { + if ( !hasOwnProp( o, key[ j ] ) ) { + o = null; + break; + } + o = o[ key[ j ] ]; + } + if ( o && isConfigurableProperty( o, key[ j ] ) ) { + delete o[ key[ j ] ]; + } + } + } + // Reset internal buffers for storing context data: + if ( this._sandbox === false ) { + this._globalVars.length = 0; + } + this._aliases.length = 0; + this._workspace.length = 0; + this._contextVars.length = 0; + + // Create a new execution context... + this._context = this.createContext(); + this.emit( 'reset', this._context ); // note: emitting the context allows REPL wrappers to extend the newly created context + + return this; +}); + +/** +* Clears a REPL's history. +* +* @name clearHistory +* @memberof REPL.prototype +* @type {Function} +* @returns {REPL} REPL instance +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* +* // ... +* +* // Clear the REPL history: +* repl.clearHistory(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory() { + debug( 'Resetting REPL history...' ); + this._history.length = 0; + return this; +}); + +/** +* Clears user-defined documentation. +* +* @name clearUserDocs +* @memberof REPL.prototype +* @type {Function} +* @returns {REPL} REPL instance +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* +* // ... +* +* // Clear the user defined documentation: +* repl.clearUserDocs(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'clearUserDocs', function clearUserDocs() { + debug( 'Resetting REPL user-defined documentation...' ); + this._userdocs.length = 0; + return this; +}); + +/** +* Loads and evaluates a JavaScript file line-by-line. +* +* @name load +* @memberof REPL.prototype +* @type {Function} +* @param {string} fpath - file path +* @param {Function} clbk - callback +* @throws {Error} cannot load a file into a closed REPL +* @throws {TypeError} first argument must be a string +* @throws {TypeError} second argument must be a function +* @returns {void} +* +* @example +* // TODO +*/ +setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { + var self; + var file; + var len; + var i; + if ( this._closed ) { + throw new Error( 'invalid operation. Cannot load a file into a REPL which has already closed.' ); + } + if ( !isString( fpath ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', fpath ) ); + } + if ( !isFunction( clbk ) ) { + throw new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) ); + } + // Resolve the provided path to an absolute file path: + fpath = resolve( cwd(), fpath ); + debug( 'Loading filepath: %s', fpath ); + + // Attempt to synchronously read the file: + file = readFileSync( fpath, 'utf8' ); + if ( file instanceof Error ) { + debug( 'Error: %s', file.message ); + clbk( file ); + return; + } + self = this; + + // Split the file content into individual lines: + file = file.split( RE_EOL ); + + // Forward each line to the REPL readline interface in order to mimic user input... + len = file.length; + i = -1; + + nextTick( next ); + + /** + * Callback invoked after draining the command queue. + * + * @private + * @param {string} cmd - command + * @param {boolean} success - boolean indicating whether the command successfully executed + */ + function next() { + i += 1; + if ( i < len ) { + if ( file[ i ] ) { + self._rli.write( file[ i ]+'\n' ); + self.once( 'drain', next ); + } else { + nextTick( next ); + } + } else { + nextTick( clbk ); + } + } +}); + +/** +* Resets a REPL. +* +* @name reset +* @memberof REPL.prototype +* @type {Function} +* @throws {Error} cannot reset a closed REPL +* @returns {REPL} REPL instance +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* +* // ... +* +* // Reset the REPL: +* repl.reset(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { + if ( this._closed ) { + throw new Error( 'invalid operation. Cannot reset a REPL which has already closed.' ); + } + debug( 'Resetting REPL...' ); + + // Reset the command queue: + this._queue.clear(); + + // Clear the command history: + this.clearHistory(); + + // Reset the execution context: + this.resetContext(); + + return this; +}); + +/** +* Closes a REPL. +* +* @name close +* @memberof REPL.prototype +* @type {Function} +* @returns {REPL} REPL instance +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'close', function close() { + var self; + if ( this._closed ) { + debug( 'Attempted to close an already closed REPL.' ); + return this; + } + self = this; + this._closed = true; + + // Clear the command queue: + this._queue.clear(); + + // TODO: ensure REPL history is saved (flushed) to file before closing the REPL (see https://github.com/nodejs/node/blob/b21e7c7bcf23a2715951e4cd96180e4dbf1dcd4d/lib/repl.js#L805) + + // TODO: ensure REPL log is saved (flushed) to file before closing the REPL + + nextTick( onTick ); + + return this; + + /** + * Callback invoked upon the next tick of the event loop. + * + * @private + */ + function onTick() { + var tmp; + var key; + var o; + var i; + var j; + + // If this is a non-sandboxed REPL, remove global variables/properties which were introduced during context creation and by a user during a REPL session... + if ( self._sandbox === false ) { + // WARNING: in a non-sandboxed environment, if a global variable is externally introduced during a REPL session (i.e., introduced via a mechanism outside of the REPL environment), we will delete that global variable, which means the following logic may introduce unintended side-effects for this particular edge case (e.g., application code may expect the presence of the subsequently deleted global variable). While not ideal, (a) user applications should not be introducing globals to begin with and (b) the probability of a user running a REPL session, a user closing that REPL session, AND a global variable being introduced between starting a REPL and closing the REPL should be negligible. + tmp = self._context.vars(); // current workspace variables + for ( i = 0; i < tmp.length; i++ ) { + if ( isConfigurableProperty( self._context, tmp[ i ] ) ) { + delete self._context[ tmp[ i ] ]; + } + } + + // Remove REPL globals: + for ( i = 0; i < self._globalVars.length; i++ ) { + o = self._context; + key = self._globalVars[ i ].split( '.' ); // Note: this addresses nested key paths (e.g., `a.b.c`) + for ( j = 0; j < key.length-1; j++ ) { + if ( !hasOwnProp( o, key[ j ] ) ) { + o = null; + break; + } + o = o[ key[ j ] ]; + } + if ( o && isConfigurableProperty( o, key[ j ] ) ) { + delete o[ key[ j ] ]; + } + } + } + } +}); + + +// EXPORTS // + +module.exports = REPL; diff --git a/lib/node_modules/@stdlib/repl/lib/process_command.js b/lib/node_modules/@stdlib/repl/base/lib/process_command.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/process_command.js rename to lib/node_modules/@stdlib/repl/base/lib/process_command.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/process_input.js b/lib/node_modules/@stdlib/repl/base/lib/process_input.js new file mode 100644 index 000000000000..891d6a0af56c --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/lib/process_input.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 logger = require( 'debug' ); +var drain = require( './drain.js' ); + + +// VARIABLES // + +var debug = logger( 'repl:process-command' ); +var RE_WHITESPACE = /^\s*$/; +var RE_SINGLE_LINE_COMMENT = /^\s*\/\//; +var RE_MULTI_LINE_COMMENT = /^\s*\/\*.*\*\/$/; + + +// MAIN // + +/** +* Processes input command. +* +* @private +* @param {REPL} repl - REPL instance +* @param {string} input - input command +* @returns {void} +*/ +function processInput( repl, input ) { + var code; + var tmp; + + if ( RE_WHITESPACE.test( input ) ) { + return; + } + if ( RE_SINGLE_LINE_COMMENT.test( input ) || RE_MULTI_LINE_COMMENT.test( input ) ) { // eslint-disable-line max-len + debug( 'Detected single-line comment.' ); + tmp = input; + } else { + // Check if the command has valid syntax... + debug( 'Processing command...' ); + tmp = repl._processCommand( input ); + if ( tmp instanceof Error ) { + repl.emit( 'command', input, false, tmp, false ); // command failed + return; + } + } + debug( 'Successfully processed command.' ); + + // Attempt to compile the command: + debug( 'Attempting to compile command...' ); + code = repl._compileCommand( tmp ); + if ( code instanceof Error ) { + debug( 'Error: %s', code.message ); + repl.emit( 'command', input, false, code, false ); // command failed + return; + } + debug( 'Successfully compiled command.' ); + code.raw = input; + + // Add the command to the command queue: + repl._queue.push( code ); + + // Request to run the command: + drain( repl ); +} + + +// EXPORTS // + +module.exports = processInput; diff --git a/lib/node_modules/@stdlib/repl/lib/process_top_level_await.js b/lib/node_modules/@stdlib/repl/base/lib/process_top_level_await.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/process_top_level_await.js rename to lib/node_modules/@stdlib/repl/base/lib/process_top_level_await.js diff --git a/lib/node_modules/@stdlib/repl/lib/property_comparator.js b/lib/node_modules/@stdlib/repl/base/lib/property_comparator.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/property_comparator.js rename to lib/node_modules/@stdlib/repl/base/lib/property_comparator.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_fs_aliases.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_fs_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_fs_aliases.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_fs_aliases.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_index.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_index.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_index.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_index.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_path.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_path.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_path.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_path.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_relative_require_path.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_relative_require_path.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_relative_require_path.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_relative_require_path.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_require.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_require.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_require.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_require.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_reserved_syntax_characters.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_reserved_syntax_characters.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_reserved_syntax_characters.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_reserved_syntax_characters.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_tutorial.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_tutorial.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_tutorial.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_tutorial.js diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_workspace.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_workspace.js rename to lib/node_modules/@stdlib/repl/base/lib/regexp_workspace.js diff --git a/lib/node_modules/@stdlib/repl/lib/repl_docs.js b/lib/node_modules/@stdlib/repl/base/lib/repl_docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/repl_docs.js rename to lib/node_modules/@stdlib/repl/base/lib/repl_docs.js diff --git a/lib/node_modules/@stdlib/repl/lib/reserved_keywords.js b/lib/node_modules/@stdlib/repl/base/lib/reserved_keywords.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/reserved_keywords.js rename to lib/node_modules/@stdlib/repl/base/lib/reserved_keywords.js diff --git a/lib/node_modules/@stdlib/repl/lib/reserved_keywords_common.js b/lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_common.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/reserved_keywords_common.js rename to lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_common.js diff --git a/lib/node_modules/@stdlib/repl/lib/reserved_keywords_empty_block_statement.js b/lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_empty_block_statement.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/reserved_keywords_empty_block_statement.js rename to lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_empty_block_statement.js diff --git a/lib/node_modules/@stdlib/repl/lib/resolve_globals.js b/lib/node_modules/@stdlib/repl/base/lib/resolve_globals.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/resolve_globals.js rename to lib/node_modules/@stdlib/repl/base/lib/resolve_globals.js diff --git a/lib/node_modules/@stdlib/repl/lib/resolve_local_scope.js b/lib/node_modules/@stdlib/repl/base/lib/resolve_local_scope.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/resolve_local_scope.js rename to lib/node_modules/@stdlib/repl/base/lib/resolve_local_scope.js diff --git a/lib/node_modules/@stdlib/repl/lib/resolve_local_scopes.js b/lib/node_modules/@stdlib/repl/base/lib/resolve_local_scopes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/resolve_local_scopes.js rename to lib/node_modules/@stdlib/repl/base/lib/resolve_local_scopes.js diff --git a/lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js b/lib/node_modules/@stdlib/repl/base/lib/restore_regexp_matches.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js rename to lib/node_modules/@stdlib/repl/base/lib/restore_regexp_matches.js diff --git a/lib/node_modules/@stdlib/repl/lib/set_aliases.js b/lib/node_modules/@stdlib/repl/base/lib/set_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/set_aliases.js rename to lib/node_modules/@stdlib/repl/base/lib/set_aliases.js diff --git a/lib/node_modules/@stdlib/repl/lib/set_aliases_global.js b/lib/node_modules/@stdlib/repl/base/lib/set_aliases_global.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/set_aliases_global.js rename to lib/node_modules/@stdlib/repl/base/lib/set_aliases_global.js diff --git a/lib/node_modules/@stdlib/repl/lib/set_commands.js b/lib/node_modules/@stdlib/repl/base/lib/set_commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/set_commands.js rename to lib/node_modules/@stdlib/repl/base/lib/set_commands.js diff --git a/lib/node_modules/@stdlib/repl/lib/set_commands_global.js b/lib/node_modules/@stdlib/repl/base/lib/set_commands_global.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/set_commands_global.js rename to lib/node_modules/@stdlib/repl/base/lib/set_commands_global.js diff --git a/lib/node_modules/@stdlib/repl/lib/setdiff.js b/lib/node_modules/@stdlib/repl/base/lib/setdiff.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/setdiff.js rename to lib/node_modules/@stdlib/repl/base/lib/setdiff.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/settings.js b/lib/node_modules/@stdlib/repl/base/lib/settings.js new file mode 100644 index 000000000000..53a38eaffc00 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/lib/settings.js @@ -0,0 +1,68 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2024 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 // + +/** +* REPL settings. +* +* @private +* @name SETTINGS +* @type {Object} +*/ +var SETTINGS = { + 'autoClosePairs': { + 'desc': 'Automatically insert matching brackets, parentheses, and quotes.', + 'type': 'boolean' + }, + 'autoDeletePairs': { + 'desc': 'Automatically delete adjacent matching brackets, parentheses, and quotes.', + 'type': 'boolean' + }, + 'autoPage': { + 'desc': 'Automatically page return values whose display size exceeds the visible screen.', + 'type': 'boolean' + }, + 'bracketedPaste': { + 'desc': 'Enable bracketed-paste mode.', + 'type': 'boolean' + }, + 'completionPreviews': { + 'desc': 'Enable the display of completion previews for auto-completion.', + 'type': 'boolean' + }, + 'autoDisableBracketedPasteOnExit': { + 'desc': 'Automatically disable bracketed-paste upon exiting the REPL.', + 'type': 'boolean' + }, + 'syntaxHighlighting': { + 'desc': 'Enable syntax highlighting.', + 'type': 'boolean' + }, + 'theme': { + 'desc': 'Set the syntax highlighting theme.', + 'type': 'string' + } +}; + + +// EXPORTS // + +module.exports = SETTINGS; diff --git a/lib/node_modules/@stdlib/repl/lib/settings_names.js b/lib/node_modules/@stdlib/repl/base/lib/settings_names.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/settings_names.js rename to lib/node_modules/@stdlib/repl/base/lib/settings_names.js diff --git a/lib/node_modules/@stdlib/repl/lib/settings_validators.js b/lib/node_modules/@stdlib/repl/base/lib/settings_validators.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/settings_validators.js rename to lib/node_modules/@stdlib/repl/base/lib/settings_validators.js diff --git a/lib/node_modules/@stdlib/repl/lib/tokenizer.js b/lib/node_modules/@stdlib/repl/base/lib/tokenizer.js similarity index 96% rename from lib/node_modules/@stdlib/repl/lib/tokenizer.js rename to lib/node_modules/@stdlib/repl/base/lib/tokenizer.js index fe0d9d8482b5..5a4ff1c8807a 100644 --- a/lib/node_modules/@stdlib/repl/lib/tokenizer.js +++ b/lib/node_modules/@stdlib/repl/base/lib/tokenizer.js @@ -29,12 +29,10 @@ var linkedList = require( '@stdlib/dstructs/linked-list' ); var contains = require( '@stdlib/array/base/assert/contains' ); var resolveLocalScopes = require( './resolve_local_scopes.js' ); var resolveLocalScope = require( './resolve_local_scope.js' ); -var commands = require( './commands.js' ); // VARIABLES // -var COMMANDS = commands(); var isUnrecognizedKeyword = contains.factory( [ 'async', 'let' ] ); var isControlKeyword = contains.factory( [ 'if', 'else', 'switch', 'case', 'catch', 'finally', 'try', 'return', 'break', 'continue' ] ); var isUnrecognizedControlKeyword = contains.factory( [ 'await' ] ); @@ -197,8 +195,6 @@ function tokenizer( line, context ) { */ function resolveIdentifier( node ) { var identifier; - var command; - var i; // Ignore placeholder nodes: if ( node.start >= node.end ) { @@ -228,19 +224,6 @@ function tokenizer( line, context ) { }); return true; } - // If identifier is a REPL command, push it as a token... - for ( i = 0; i < COMMANDS.length; i++ ) { - command = COMMANDS[ i ]; - if ( node.name === command[ 0 ] ) { - tokens.push({ - 'value': node.name, - 'type': 'command', - 'start': node.start, - 'end': node.end - }); - return true; - } - } // If identifier is in global context, push it as a token... identifier = context[ node.name ]; if ( identifier ) { diff --git a/lib/node_modules/@stdlib/repl/lib/tutorial_alias_args.js b/lib/node_modules/@stdlib/repl/base/lib/tutorial_alias_args.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/tutorial_alias_args.js rename to lib/node_modules/@stdlib/repl/base/lib/tutorial_alias_args.js diff --git a/lib/node_modules/@stdlib/repl/lib/tutorial_aliases.js b/lib/node_modules/@stdlib/repl/base/lib/tutorial_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/tutorial_aliases.js rename to lib/node_modules/@stdlib/repl/base/lib/tutorial_aliases.js diff --git a/lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js b/lib/node_modules/@stdlib/repl/base/lib/update_regexp_cache.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js rename to lib/node_modules/@stdlib/repl/base/lib/update_regexp_cache.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/validate.js b/lib/node_modules/@stdlib/repl/base/lib/validate.js new file mode 100644 index 000000000000..98ee9d76a257 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/lib/validate.js @@ -0,0 +1,131 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 isPlainObject = require( '@stdlib/assert/is-plain-object' ); +var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var isReadableStreamLike = require( '@stdlib/assert/is-node-readable-stream-like' ); +var isWritableStreamLike = require( '@stdlib/assert/is-node-writable-stream-like' ); +var isString = require( '@stdlib/assert/is-string' ).isPrimitive; +var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; +var isPositiveInteger = require( '@stdlib/assert/is-positive-integer' ).isPrimitive; +var format = require( '@stdlib/string/format' ); + + +// MAIN // + +/** +* Validates function options. +* +* @private +* @param {Object} opts - destination object +* @param {Options} options - function options +* @param {string} [options.inputPrompt] - input prompt +* @param {string} [options.outputPrompt] - output prompt +* @param {ReadableStream} [options.input=] - input stream +* @param {WritableStream} [options.output] - output stream +* @param {boolean} [options.sandbox] - boolean indicating whether to run a REPL in a sandboxed context +* @param {PositiveInteger} [options.timeout] - number of milliseconds to execute a command before terminating execution +* @param {boolean} [options.isTTY] - boolean indicating whether the input and output streams should be treated like a TTY (terminal) and whether the REPL should use ANSI/VT100 escape codes when writing to the output stream +* @param {string} [options.welcome] - welcome message +* @param {NonNegativeInteger} [options.padding] - number of empty lines between successive commands +* @param {string} [options.load] - file path specifying a JavaScript file to load and evaluate line-by-line (e.g., a previous REPL history file) +* @param {string} [options.save] - file path specifying where to save REPL command history +* @param {string} [options.log] - file path specifying where to save REPL commands and printed output +* @param {string} [options.quiet] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced +* @param {Object} [options.settings] - REPL settings +* @returns {(Error|null)} error or null +* +* @example +* var options = { +* 'sandbox': true +* }; +* var opts = {}; +* var err = validate( opts, options ); +* if ( err ) { +* throw err; +* } +*/ +function validate( opts, options ) { + if ( !isPlainObject( options ) ) { + return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) ); + } + if ( hasOwnProp( options, 'input' ) ) { + opts.input = options.input; + if ( !isReadableStreamLike( options.input ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a readable stream. Option: `%s`.', 'input', options.input ) ); + } + } + if ( hasOwnProp( options, 'output' ) ) { + opts.output = options.output; + if ( !isWritableStreamLike( options.output ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a writable stream. Option: `%s`.', 'output', options.output ) ); + } + } + if ( hasOwnProp( options, 'error' ) ) { + opts.output = options.error; + if ( !isWritableStreamLike( options.error ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a writable stream. Option: `%s`.', 'error', options.error ) ); + } + } + if ( hasOwnProp( options, 'save' ) ) { + opts.save = options.save; + if ( !isString( options.save ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'save', options.save ) ); + } + } + if ( hasOwnProp( options, 'load' ) ) { + opts.load = options.load; + if ( !isString( options.load ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'load', options.load ) ); + } + } + if ( hasOwnProp( options, 'log' ) ) { + opts.log = options.log; + if ( !isString( options.log ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'log', options.log ) ); + } + } + if ( hasOwnProp( options, 'timeout' ) ) { + opts.timeout = options.timeout; + if ( !isPositiveInteger( options.timeout ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'timeout', options.timeout ) ); + } + } + if ( hasOwnProp( options, 'sandbox' ) ) { + opts.sandbox = options.sandbox; + if ( !isBoolean( options.sandbox ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'sandbox', options.sandbox ) ); + } + } + if ( hasOwnProp( options, 'quiet' ) ) { + opts.quiet = options.quiet; + if ( !isBoolean( options.quiet ) ) { + return new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'quiet', options.quiet ) ); + } + } + return null; +} + + +// EXPORTS // + +module.exports = validate; diff --git a/lib/node_modules/@stdlib/repl/lib/validate_settings.js b/lib/node_modules/@stdlib/repl/base/lib/validate_settings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/validate_settings.js rename to lib/node_modules/@stdlib/repl/base/lib/validate_settings.js diff --git a/lib/node_modules/@stdlib/repl/lib/workspace_alias_args.js b/lib/node_modules/@stdlib/repl/base/lib/workspace_alias_args.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/workspace_alias_args.js rename to lib/node_modules/@stdlib/repl/base/lib/workspace_alias_args.js diff --git a/lib/node_modules/@stdlib/repl/lib/workspace_aliases.js b/lib/node_modules/@stdlib/repl/base/lib/workspace_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/workspace_aliases.js rename to lib/node_modules/@stdlib/repl/base/lib/workspace_aliases.js diff --git a/lib/node_modules/@stdlib/repl/base/package.json b/lib/node_modules/@stdlib/repl/base/package.json new file mode 100644 index 000000000000..99f01f492489 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/package.json @@ -0,0 +1,78 @@ +{ + "name": "@stdlib/repl/base", + "version": "0.0.0", + "description": "REPL environment.", + "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" + } + ], + "bin": { + "stdlib-repl": "./bin/cli" + }, + "main": "./lib", + "browser": { + "./lib": "./lib/browser/index.js", + "process": "process/" + }, + "directories": { + "benchmark": "./benchmark", + "data": "./data", + "doc": "./docs", + "example": "./examples", + "lib": "./lib", + "scripts": "./scripts", + "test": "./test" + }, + "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", + "repl", + "read-eval-print-loop", + "eval", + "evaluate", + "interact", + "interactive", + "console", + "terminal", + "shell", + "server", + "toplevel" + ], + "__stdlib__": { + "envs": { + "browser": false + } + } +} diff --git a/lib/node_modules/@stdlib/repl/scripts/build.js b/lib/node_modules/@stdlib/repl/base/scripts/build.js similarity index 100% rename from lib/node_modules/@stdlib/repl/scripts/build.js rename to lib/node_modules/@stdlib/repl/base/scripts/build.js diff --git a/lib/node_modules/@stdlib/repl/scripts/build_contributors.js b/lib/node_modules/@stdlib/repl/base/scripts/build_contributors.js similarity index 100% rename from lib/node_modules/@stdlib/repl/scripts/build_contributors.js rename to lib/node_modules/@stdlib/repl/base/scripts/build_contributors.js diff --git a/lib/node_modules/@stdlib/repl/scripts/build_help.js b/lib/node_modules/@stdlib/repl/base/scripts/build_help.js similarity index 100% rename from lib/node_modules/@stdlib/repl/scripts/build_help.js rename to lib/node_modules/@stdlib/repl/base/scripts/build_help.js diff --git a/lib/node_modules/@stdlib/repl/scripts/build_license.js b/lib/node_modules/@stdlib/repl/base/scripts/build_license.js similarity index 100% rename from lib/node_modules/@stdlib/repl/scripts/build_license.js rename to lib/node_modules/@stdlib/repl/base/scripts/build_license.js diff --git a/lib/node_modules/@stdlib/repl/scripts/build_tutorials.js b/lib/node_modules/@stdlib/repl/base/scripts/build_tutorials.js similarity index 100% rename from lib/node_modules/@stdlib/repl/scripts/build_tutorials.js rename to lib/node_modules/@stdlib/repl/base/scripts/build_tutorials.js diff --git a/lib/node_modules/@stdlib/repl/README.md b/lib/node_modules/@stdlib/repl/cli/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/README.md rename to lib/node_modules/@stdlib/repl/cli/README.md diff --git a/lib/node_modules/@stdlib/repl/benchmark/benchmark.js b/lib/node_modules/@stdlib/repl/cli/benchmark/benchmark.js similarity index 100% rename from lib/node_modules/@stdlib/repl/benchmark/benchmark.js rename to lib/node_modules/@stdlib/repl/cli/benchmark/benchmark.js diff --git a/lib/node_modules/@stdlib/repl/bin/cli b/lib/node_modules/@stdlib/repl/cli/bin/cli similarity index 96% rename from lib/node_modules/@stdlib/repl/bin/cli rename to lib/node_modules/@stdlib/repl/cli/bin/cli index 2a0199695efc..ca58c9c807ff 100755 --- a/lib/node_modules/@stdlib/repl/bin/cli +++ b/lib/node_modules/@stdlib/repl/cli/bin/cli @@ -37,7 +37,7 @@ var REPL = require( './../lib' ); */ function main() { var flags; - var repl; // eslint-disable-line no-unused-vars + var repl; var opts; var cli; @@ -86,7 +86,7 @@ function main() { } // Create a new REPL instance: - repl = new REPL( opts ); + repl = new REPL( opts ); // eslint-disable-line no-unused-vars } main(); diff --git a/lib/node_modules/@stdlib/repl/docs/commands/clear.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/clear.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/clear.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/clear.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/presentation_start.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/presentation_start.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_start.txt diff --git a/lib/node_modules/@stdlib/repl/docs/commands/presentation_stop.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/commands/presentation_stop.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_stop.txt diff --git a/lib/node_modules/@stdlib/repl/docs/migration-guides/README.md b/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/migration-guides/README.md rename to lib/node_modules/@stdlib/repl/cli/docs/migration-guides/README.md diff --git a/lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/README.md b/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/README.md rename to lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/README.md diff --git a/lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/data/data.csv b/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/data/data.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/data/data.csv rename to lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/data/data.csv diff --git a/lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/README.md b/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/README.md rename to lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/README.md diff --git a/lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/data/data.csv b/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/data/data.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/data/data.csv rename to lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/data/data.csv diff --git a/lib/node_modules/@stdlib/repl/docs/tutorials/read_eval_print_loop.txt b/lib/node_modules/@stdlib/repl/cli/docs/tutorials/read_eval_print_loop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/tutorials/read_eval_print_loop.txt rename to lib/node_modules/@stdlib/repl/cli/docs/tutorials/read_eval_print_loop.txt diff --git a/lib/node_modules/@stdlib/repl/docs/usage.txt b/lib/node_modules/@stdlib/repl/cli/docs/usage.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/docs/usage.txt rename to lib/node_modules/@stdlib/repl/cli/docs/usage.txt diff --git a/lib/node_modules/@stdlib/repl/etc/cli_opts.json b/lib/node_modules/@stdlib/repl/cli/etc/cli_opts.json similarity index 100% rename from lib/node_modules/@stdlib/repl/etc/cli_opts.json rename to lib/node_modules/@stdlib/repl/cli/etc/cli_opts.json diff --git a/lib/node_modules/@stdlib/repl/examples/history.txt b/lib/node_modules/@stdlib/repl/cli/examples/history.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/history.txt rename to lib/node_modules/@stdlib/repl/cli/examples/history.txt diff --git a/lib/node_modules/@stdlib/repl/examples/http/client.js.txt b/lib/node_modules/@stdlib/repl/cli/examples/http/client.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/http/client.js.txt rename to lib/node_modules/@stdlib/repl/cli/examples/http/client.js.txt diff --git a/lib/node_modules/@stdlib/repl/examples/http/server.js.txt b/lib/node_modules/@stdlib/repl/cli/examples/http/server.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/http/server.js.txt rename to lib/node_modules/@stdlib/repl/cli/examples/http/server.js.txt diff --git a/lib/node_modules/@stdlib/repl/examples/index.js b/lib/node_modules/@stdlib/repl/cli/examples/index.js similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/index.js rename to lib/node_modules/@stdlib/repl/cli/examples/index.js diff --git a/lib/node_modules/@stdlib/repl/examples/net-socket-2/client.js.txt b/lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/client.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/net-socket-2/client.js.txt rename to lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/client.js.txt diff --git a/lib/node_modules/@stdlib/repl/examples/net-socket-2/server.js.txt b/lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/server.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/net-socket-2/server.js.txt rename to lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/server.js.txt diff --git a/lib/node_modules/@stdlib/repl/examples/net-socket/client.js.txt b/lib/node_modules/@stdlib/repl/cli/examples/net-socket/client.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/net-socket/client.js.txt rename to lib/node_modules/@stdlib/repl/cli/examples/net-socket/client.js.txt diff --git a/lib/node_modules/@stdlib/repl/examples/net-socket/server.js.txt b/lib/node_modules/@stdlib/repl/cli/examples/net-socket/server.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/examples/net-socket/server.js.txt rename to lib/node_modules/@stdlib/repl/cli/examples/net-socket/server.js.txt diff --git a/lib/node_modules/@stdlib/repl/lib/actions.js b/lib/node_modules/@stdlib/repl/cli/lib/actions.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/actions.js rename to lib/node_modules/@stdlib/repl/cli/lib/actions.js diff --git a/lib/node_modules/@stdlib/repl/lib/ansi_colors.js b/lib/node_modules/@stdlib/repl/cli/lib/ansi_colors.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/ansi_colors.js rename to lib/node_modules/@stdlib/repl/cli/lib/ansi_colors.js diff --git a/lib/node_modules/@stdlib/repl/lib/auto_close_pairs.js b/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/auto_close_pairs.js rename to lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs.js diff --git a/lib/node_modules/@stdlib/repl/lib/auto_close_pairs_close_symbols.js b/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_close_symbols.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/auto_close_pairs_close_symbols.js rename to lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_close_symbols.js diff --git a/lib/node_modules/@stdlib/repl/lib/auto_close_pairs_open_symbols.js b/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_open_symbols.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/auto_close_pairs_open_symbols.js rename to lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_open_symbols.js diff --git a/lib/node_modules/@stdlib/repl/lib/auto_close_pairs_walk.js b/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_walk.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/auto_close_pairs_walk.js rename to lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_walk.js diff --git a/lib/node_modules/@stdlib/repl/lib/browser/index.js b/lib/node_modules/@stdlib/repl/cli/lib/browser/index.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/browser/index.js rename to lib/node_modules/@stdlib/repl/cli/lib/browser/index.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands.js b/lib/node_modules/@stdlib/repl/cli/lib/commands.js new file mode 100644 index 000000000000..9d7c5d124895 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/commands.js @@ -0,0 +1,82 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 onAddTheme = require( './commands/add_theme.js' ); +var onClear = require( './commands/clear.js' ); +var onDeleteTheme = require( './commands/delete_theme.js' ); +var onGetTheme = require( './commands/get_theme.js' ); +var onKeybindings = require( './commands/keybindings.js' ); +var onPager = require( './commands/pager.js' ); +var onPresentationStart = require( './commands/presentation_start.js' ); +var onPresentationStop = require( './commands/presentation_stop.js' ); +var onRenameTheme = require( './commands/rename_theme.js' ); +var onRerun = require( './commands/rerun.js' ); +var onSetKeybinding = require( './commands/set_keybinding.js' ); +var onSettings = require( './commands/settings.js' ); +var onThemes = require( './commands/themes.js' ); + + +// MAIN // + +/** +* Returns a list of REPL-specific commands. +* +* ## Notes +* +* - Each array element is comprised as follows: +* +* ```text +* [ , , ] +* ``` +* +* where the first element is the command alias, the second element the command callback, and the third element a boolean indicating whether the callback is an accessor (getter; i.e., the command refers to a property rather than a function to be explicitly invoked). +* +* @private +* @param {REPL} repl - REPL instance +* @returns {ArrayArray} commands +*/ +function commands( repl ) { + var cmds; + + // Define a list of REPL-specific commands (NOTE: keep in alphabetical order): + cmds = []; + cmds.push( [ 'addTheme', onAddTheme( repl ), false ] ); + cmds.push( [ 'clear', onClear( repl ), false ] ); + cmds.push( [ 'deleteTheme', onDeleteTheme( repl ), false ] ); + cmds.push( [ 'getTheme', onGetTheme( repl ), false ] ); + cmds.push( [ 'keybindings', onKeybindings( repl ), false ] ); + cmds.push( [ 'pager', onPager( repl ), false ] ); + cmds.push( [ 'presentationStart', onPresentationStart( repl ), false ] ); + cmds.push( [ 'presentationStop', onPresentationStop( repl ), false ] ); + cmds.push( [ 'renameTheme', onRenameTheme( repl ), false ] ); + cmds.push( [ 'rerun', onRerun( repl ), false ] ); + cmds.push( [ 'setKeybinding', onSetKeybinding( repl ), false ] ); + cmds.push( [ 'settings', onSettings( repl ), false ] ); + cmds.push( [ 'themes', onThemes( repl ), false ] ); + + return cmds; +} + + +// EXPORTS // + +module.exports = commands; diff --git a/lib/node_modules/@stdlib/repl/lib/commands/add_theme.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/add_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/add_theme.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/add_theme.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/clear.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/clear.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/clear.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/delete_theme.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/delete_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/delete_theme.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/delete_theme.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/get_theme.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/get_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/get_theme.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/get_theme.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/keybindings.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/keybindings.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/keybindings.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/pager.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/pager.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/pager.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/pager.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_start.js similarity index 98% rename from lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_start.js index 949a23831efd..127ad2a6f584 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_start.js @@ -29,7 +29,7 @@ var isPlainObject = require( '@stdlib/assert/is-plain-object' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var propertyDescriptor = require( '@stdlib/utils/property-descriptor' ); var properties = require( '@stdlib/utils/properties' ); -var Presentation = require( '@stdlib/repl/presentation' ); // eslint-disable-line stdlib/no-redeclare +var Presentation = require( '@stdlib/repl/cli/presentation' ); // eslint-disable-line stdlib/no-redeclare var format = require( '@stdlib/string/format' ); var setdiff = require( './../setdiff.js' ); var propertyComparator = require( './../property_comparator.js' ); diff --git a/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_stop.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_stop.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/rename_theme.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/rename_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/rename_theme.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/rename_theme.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/rerun.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/rerun.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/rerun.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/rerun.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/set_keybinding.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/set_keybinding.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/set_keybinding.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/set_keybinding.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/settings.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/settings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/settings.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/settings.js diff --git a/lib/node_modules/@stdlib/repl/lib/commands/themes.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/themes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/commands/themes.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/themes.js diff --git a/lib/node_modules/@stdlib/repl/lib/completer_engine.js b/lib/node_modules/@stdlib/repl/cli/lib/completer_engine.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/completer_engine.js rename to lib/node_modules/@stdlib/repl/cli/lib/completer_engine.js diff --git a/lib/node_modules/@stdlib/repl/lib/completer_preview.js b/lib/node_modules/@stdlib/repl/cli/lib/completer_preview.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/completer_preview.js rename to lib/node_modules/@stdlib/repl/cli/lib/completer_preview.js diff --git a/lib/node_modules/@stdlib/repl/lib/default_keybindings.js b/lib/node_modules/@stdlib/repl/cli/lib/default_keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/default_keybindings.js rename to lib/node_modules/@stdlib/repl/cli/lib/default_keybindings.js diff --git a/lib/node_modules/@stdlib/repl/lib/defaults.js b/lib/node_modules/@stdlib/repl/cli/lib/defaults.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/defaults.js rename to lib/node_modules/@stdlib/repl/cli/lib/defaults.js diff --git a/lib/node_modules/@stdlib/repl/lib/display_prompt.js b/lib/node_modules/@stdlib/repl/cli/lib/display_prompt.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/display_prompt.js rename to lib/node_modules/@stdlib/repl/cli/lib/display_prompt.js diff --git a/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js b/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js similarity index 98% rename from lib/node_modules/@stdlib/repl/lib/eager_evaluator.js rename to lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js index c8cd708df713..5ace79a1d910 100644 --- a/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js @@ -30,8 +30,6 @@ var replace = require( '@stdlib/string/replace' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); var copy = require( '@stdlib/array/base/copy' ); var max = require( '@stdlib/math/base/special/max' ); -var processCommand = require( './process_command.js' ); -var compileCommand = require( './compile_command.js' ); var ANSI_COLORS = require( './ansi_colors.js' ); @@ -301,13 +299,13 @@ setNonEnumerableReadOnly( EagerEvaluator.prototype, 'onKeypress', function onKey return; } debug( 'Processing command...' ); - tmp = processCommand( code ); + tmp = this._repl._processCommand( code ); if ( tmp instanceof Error ) { debug( 'Error encountered when processing command: %s', tmp.message ); return; } debug( 'Compiling command...' ); - executable = compileCommand( tmp ); + executable = this._repl._compileCommand( tmp ); if ( executable instanceof Error ) { debug( 'Error encountered when compiling command: %s', executable.message ); return; diff --git a/lib/node_modules/@stdlib/repl/lib/editor_actions.js b/lib/node_modules/@stdlib/repl/cli/lib/editor_actions.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/editor_actions.js rename to lib/node_modules/@stdlib/repl/cli/lib/editor_actions.js diff --git a/lib/node_modules/@stdlib/repl/lib/help_text.js b/lib/node_modules/@stdlib/repl/cli/lib/help_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/help_text.js rename to lib/node_modules/@stdlib/repl/cli/lib/help_text.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/index.js b/lib/node_modules/@stdlib/repl/cli/lib/index.js new file mode 100644 index 000000000000..54ac5fec5412 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/index.js @@ -0,0 +1,53 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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'; + +/** +* REPL. +* +* @module @stdlib/repl/cli +* +* @example +* var debug = require( '@stdlib/streams/node/debug-sink' ); +* var REPL = require( '@stdlib/repl/cli' ); +* +* function onExit() { +* console.log( 'REPL closed.' ); +* } +* +* // Create a new REPL: +* var repl = new REPL({ +* 'output': debug() +* }); +* repl.on( 'exit', onExit ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ + +// MODULES // + +var main = require( './main.js' ); + + +// EXPORTS // + +module.exports = main; diff --git a/lib/node_modules/@stdlib/repl/lib/input_prompt.js b/lib/node_modules/@stdlib/repl/cli/lib/input_prompt.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/input_prompt.js rename to lib/node_modules/@stdlib/repl/cli/lib/input_prompt.js diff --git a/lib/node_modules/@stdlib/repl/lib/is_setting_name.js b/lib/node_modules/@stdlib/repl/cli/lib/is_setting_name.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/is_setting_name.js rename to lib/node_modules/@stdlib/repl/cli/lib/is_setting_name.js diff --git a/lib/node_modules/@stdlib/repl/lib/keybindings.js b/lib/node_modules/@stdlib/repl/cli/lib/keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/keybindings.js rename to lib/node_modules/@stdlib/repl/cli/lib/keybindings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/log.js b/lib/node_modules/@stdlib/repl/cli/lib/log.js new file mode 100644 index 000000000000..1ae2f532f99b --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/log.js @@ -0,0 +1,45 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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'; + +// MAIN // + +/** +* Writes a message to the REPL output stream. +* +* ## Notes +* +* - Automatically appends a newline character to a provide message. +* +* @private +* @param {REPL} repl - REPL instance +* @param {string} msg - message +*/ +function log( repl, msg ) { + if ( repl._quiet === false ) { + repl._ostream.write( msg+'\n' ); + } +} + + +// EXPORTS // + +module.exports = log; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/longest_common_prefix.js b/lib/node_modules/@stdlib/repl/cli/lib/longest_common_prefix.js new file mode 100644 index 000000000000..08812654674a --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/longest_common_prefix.js @@ -0,0 +1,101 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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. +*/ + +// TODO: move implementation to package: @stdlib/string/longest-common-prefix + +'use strict'; + +// MODULES // + +var isArrayLikeObject = require( '@stdlib/assert/is-array-like-object' ); +var isString = require( '@stdlib/assert/is-string' ).isPrimitive; +var format = require( '@stdlib/string/format' ); + + +// MAIN // + +/** +* Returns the longest common prefix. +* +* ## Notes +* +* - The algorithmic complexity is `O(M*N)` where `M` is the number of strings and `N` is the length of the first string. +* +* @private +* @param {(string|StringArray)} arg - a string or list of strings +* @param {string} [...str] - strings +* @throws {TypeError} must provide strings +* @returns {string} longest common prefix +* +* @example +* var prefix = longestCommonPrefix( 'beep', 'bebop' ); +* // returns 'be' +* +* @example +* var prefix = longestCommonPrefix( [ 'beep', 'bebop' ] ); +* // returns 'be' +*/ +function longestCommonPrefix() { + var prefix; + var list; + var str; + var ch; + var M; + var N; + var i; + var j; + + if ( arguments.length === 1 && isArrayLikeObject( arguments[ 0 ] ) ) { + list = arguments[ 0 ]; + } else { + list = []; + for ( i = 0; i < arguments.length; i++ ) { + list.push( arguments[ i ] ); + } + } + M = list.length; + if ( M === 0 ) { + return ''; + } + prefix = list[ 0 ]; + if ( !isString( prefix ) ) { + throw new TypeError( format( 'invalid argument. Must provide a string. Value: `%s`.', prefix ) ); + } + if ( M === 1 ) { + return prefix; + } + N = prefix.length; + for ( i = 0; i < N; i++ ) { + ch = prefix[ i ]; + for ( j = 1; j < M; j++ ) { + str = list[ j ]; + if ( !isString( str ) ) { + throw new TypeError( format( 'invalid argument. Must provide a string. Value: `%s`.', str ) ); + } + if ( i >= str.length || str[ i ] !== ch ) { + return prefix.substring( 0, i ); + } + } + } + return prefix; +} + + +// EXPORTS // + +module.exports = longestCommonPrefix; diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/cli/lib/main.js similarity index 72% rename from lib/node_modules/@stdlib/repl/lib/main.js rename to lib/node_modules/@stdlib/repl/cli/lib/main.js index 8bb1b56fec8b..56f48dc872b1 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/main.js @@ -16,53 +16,42 @@ * limitations under the License. */ -/* eslint-disable no-restricted-syntax, no-invalid-this, no-underscore-dangle, max-lines, max-lines-per-function, max-statements */ +/* eslint-disable no-restricted-syntax, no-invalid-this, no-underscore-dangle, max-lines, max-lines-per-function */ 'use strict'; // MODULES // -var EventEmitter = require( 'events' ).EventEmitter; var readline = require( 'readline' ); var proc = require( 'process' ); -var resolve = require( 'path' ).resolve; +var inspect = require( 'util' ).inspect; var logger = require( 'debug' ); var inherit = require( '@stdlib/utils/inherit' ); +var isndarrayLike = require( '@stdlib/assert/is-ndarray-like' ); +var replace = require( '@stdlib/string/replace' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isNumber = require( '@stdlib/assert/is-number' ).isPrimitive; var isPlainObject = require( '@stdlib/assert/is-plain-object' ); -var isFunction = require( '@stdlib/assert/is-function' ); -var isConfigurableProperty = require( '@stdlib/assert/is-configurable-property' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var objectKeys = require( '@stdlib/utils/keys' ); var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); -var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); var properties = require( '@stdlib/utils/properties' ); var append = require( '@stdlib/utils/append' ); var format = require( '@stdlib/string/format' ); var Boolean = require( '@stdlib/boolean/ctor' ); -var cwd = require( '@stdlib/process/cwd' ); -var readFileSync = require( '@stdlib/fs/read-file' ).sync; -var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; -var fifo = require( '@stdlib/dstructs/fifo' ); -var nextTick = require( '@stdlib/utils/next-tick' ); var assign = require( '@stdlib/object/assign' ); +var BaseREPL = require( '@stdlib/repl/base' ); var validate = require( './validate.js' ); var parseKey = require( './parse_key.js' ); var defaults = require( './defaults.js' ); var isSettingName = require( './is_setting_name.js' ); -var setAliases = require( './set_aliases.js' ); -var setAliasesGlobal = require( './set_aliases_global.js' ); var setCommands = require( './set_commands.js' ); var setCommandsGlobal = require( './set_commands_global.js' ); var propertyComparator = require( './property_comparator.js' ); -var createEvalContext = require( './create_evaluation_context.js' ); var commands = require( './commands.js' ); var displayPrompt = require( './display_prompt.js' ); var inputPrompt = require( './input_prompt.js' ); var OutputStream = require( './output_stream.js' ); -var completerFactory = require( './completer.js' ); var MultilineHandler = require( './multiline_handler.js' ); var Keybindings = require( './keybindings.js' ); var EditorActions = require( './editor_actions.js' ); @@ -71,9 +60,9 @@ var PreviewCompleter = require( './completer_preview.js' ); var AutoCloser = require( './auto_close_pairs.js' ); var SyntaxHighlighter = require( './syntax_highlighter.js' ); var EagerEvaluator = require( './eager_evaluator.js' ); -var ALIAS_OVERRIDES = require( './alias_overrides.js' ); var SETTINGS = require( './settings.js' ); var SETTINGS_VALIDATORS = require( './settings_validators.js' ); +var HELP_TEXT = require( './help_text.js' ); // VARIABLES // @@ -111,8 +100,8 @@ var debug = logger( 'repl' ); * @param {boolean} [options.settings.completionPreviews] - boolean indicating whether to enable completion previews for auto-completion * @param {boolean} [options.settings.autoDisableBracketedPasteOnExit] - boolean indicating whether to automatically disable bracketed-paste upon exiting the REPL * @param {boolean} [options.settings.syntaxHighlighting] - boolean indicating whether to enable syntax highlighting -* @param {boolean} [options.settings.eagerEvaluation] - boolean indicating whether to enable eager evaluation * @param {string} [options.settings.theme] - initial color theme for syntax highlighting +* @param {boolean} [options.settings.eagerEvaluation] - boolean indicating whether to enable eager evaluation * @throws {Error} must provide valid options * @returns {REPL} REPL instance * @@ -182,98 +171,45 @@ function REPL( options ) { 'settings': opts.settings })); - // Call the parent constructor: - EventEmitter.call( this ); - // Create an internal output stream: ostream = new OutputStream( this, opts.settings.autoPage ); // Setup the output stream pipeline: ostream.pipe( opts.output ); - // Cache references to the input and output streams: - setNonEnumerableReadOnly( this, '_istream', opts.input ); - setNonEnumerableReadOnly( this, '_ostream', ostream ); + // Call the parent constructor: + BaseREPL.call( this, { + 'input': opts.input, + 'output': ostream, + 'error': ostream, + 'sandbox': opts.sandbox, + 'timeout': opts.timeout, + 'load': opts.load, + 'save': opts.save, + 'log': opts.log, + 'quiet': opts.quiet + }); + + // Cache reference to the output stream: setNonEnumerableReadOnly( this, '_wstream', opts.output ); + // Define help text: + setNonEnumerableReadOnly( this, '_helpText', HELP_TEXT ); + // Cache options: setNonEnumerableReadOnly( this, '_inputPrompt', opts.inputPrompt ); setNonEnumerableReadOnly( this, '_outputPrompt', opts.outputPrompt ); setNonEnumerableReadOnly( this, '_padding', opts.padding ); - setNonEnumerableReadOnly( this, '_timeout', opts.timeout ); setNonEnumerableReadOnly( this, '_isTTY', opts.isTTY ); - setNonEnumerableReadOnly( this, '_sandbox', opts.sandbox ); setNonEnumerableReadOnly( this, '_settings', opts.settings ); - setNonEnumerable( this, '_quiet', opts.quiet ); // allow this to be internally toggled - - // Initialize an internal data store: - setNonEnumerableReadOnly( this, '_internal', {} ); - setNonEnumerableReadOnly( this._internal, 'presentation', {} ); - setNonEnumerableReadOnly( this._internal.presentation, 'cache', {} ); - setNonEnumerable( this._internal.presentation, 'counter', 0 ); - - // Initialize an internal command queue: - setNonEnumerableReadOnly( this, '_queue', fifo() ); - - // Initialize a strided internal buffer for storing the command history: - setNonEnumerableReadOnly( this, '_history', [] ); - - // Initialize an internal buffer for storing the current command: - setNonEnumerableReadOnly( this, '_cmd', [] ); - - // Initialize a executed command counter: - setNonEnumerable( this, '_count', -1 ); - - // Initialize an internal buffer for saving regular expression matches between command evaluations: - setNonEnumerableReadOnly( this, '_regexp', [ '', '', '', '', '', '', '', '', '', '' ] ); - - // Initialize a strided internal cache of context globals: - setNonEnumerableReadOnly( this, '_contextVars', [] ); - - // For non-sandboxed REPLs, initialize an internal buffer for storing a (unique) sorted list of "built-in" REPL global variables/properties which need to be deleted upon closing a REPL in order to allow garbage collection and prevent memory leaks: - setNonEnumerableReadOnly( this, '_globalVars', ( this._sandbox ) ? null : [] ); - - // Initialize a strided internal cache of resolved global variables/properties in order to allow, e.g., help text look-up based on object reference, not just alias name (note: members alternate between `''` and ``): - setNonEnumerableReadOnly( this, '_aliases', [] ); - - // Initialize a strided internal buffer for storing user-defined documentation: - setNonEnumerableReadOnly( this, '_userdocs', [] ); - - // Initialize an internal buffer for storing a (unique) sorted list of workspace global variables/properties which were *initially* introduced during a REPL session (note: this overlaps with `_globalVars`, but more accurately represents a snapshot of the `global` state *before* a user begins entering commands, which is useful when wanting determine what variables/identifiers a user has introduced during a REPL session): - setNonEnumerableReadOnly( this, '_workspace', [] ); - - // Initialize a strided internal buffer for caching "base" workspace variables: - setNonEnumerableReadOnly( this, '_workspaces', {} ); - setReadOnly( this._workspaces, 'base', [] ); - - // Define the current workspace: - setNonEnumerable( this, '_currentWorkspace', 'base' ); - - // Initialize an internal flag indicating whether the REPL has been closed: - setNonEnumerable( this, '_closed', false ); - - // Initialize an internal flag indicating whether the REPL is currently busy with asynchronous processing: - setNonEnumerable( this, '_busy', false ); // Initialize an internal flag indicating whether we've received a `SIGINT` signal: setNonEnumerable( this, '_SIGINT', false ); - // Initialize an internal variable for caching the result of the last successfully evaluated command: - setNonEnumerable( this, '_ans', void 0 ); - - // Initialize an internal variable for setting a command callback: - setNonEnumerable( this, '_done', void 0 ); - // Initialize internal variables for setting a keybinding: setNonEnumerable( this, '_isCapturingKeybinding', false ); setNonEnumerable( this, '_targetAction', '' ); - // Create a REPL execution context: - setNonEnumerable( this, '_context', this.createContext() ); - - // Create a new TAB completer: - setNonEnumerableReadOnly( this, '_completer', completerFactory( this ) ); - // Create an internal readline interface: debug( 'Creating readline interface...' ); setNonEnumerableReadOnly( this, '_rli', readline.createInterface({ @@ -354,7 +290,6 @@ function REPL( options ) { this.load( opts.load ); } else { displayPrompt( this, false ); - this._count += 1; } return this; @@ -481,11 +416,9 @@ function REPL( options ) { debug( 'Received a SIGINT event.' ); - // If the REPL is currently busy executing a command, stop waiting for it to finish: - if ( self._busy ) { - self._done( new Error( 'unexpected error. Command execution terminated.' ) ); - return; - } + // Emit an interrupt: + self.emit( 'interrupt' ); + // Check whether the user has entered any characters: isEmpty = ( self._rli.line.length === 0 ); @@ -507,9 +440,6 @@ function REPL( options ) { } else { self._SIGINT = false; } - // Reset the command queue: - self._queue.clear(); - // Clear any command which has been buffered but not yet executed: self.clearCommand(); @@ -523,13 +453,28 @@ function REPL( options ) { * @private * @param {string} cmd - command * @param {boolean} success - boolean indicating whether the command successfully executed + * @param {*} res - result + * @param {boolean} silent - boolean indicating whether the command output should be silenced */ - function onCommand( cmd, success ) { - self._count += 1; - debug( 'Command count: %d', self._count ); + function onCommand( cmd, success, res, silent ) { + var pre; + var tmp; - // Update the internal command history buffer: [..., , , , ...] - self._history.push( self._count, cmd, success ); + if ( success === false ) { + self._ostream.write( 'Error: '+res.message+'\n' ); + } else if ( !silent && res !== void 0 ) { + pre = replace( self._outputPrompt, '%d', (self._count).toString() ); + + if ( isndarrayLike( res ) ) { + tmp = res.toString(); // FIXME: this is a hack in order to avoid printing private ndarray properties in the REPL, as done by the built-in `util.inspect`. Ideally, we'd roll our own inspector which specifically accommodates stdlib's ndarray and other specialized classes. + } else { + tmp = res; + } + self._ostream.write( pre+inspect( tmp )+'\n' ); + } + if ( !self._closed ) { + displayPrompt( self, false ); + } // TODO: if successful and if necessary, (asynchronously?) write the command to a history file (question: do we only want to write successful commands to the history file? maybe we need to option for limiting to successful commands?) @@ -540,7 +485,7 @@ function REPL( options ) { /* * Inherit from the `EventEmitter` prototype. */ -inherit( REPL, EventEmitter ); +inherit( REPL, BaseREPL ); /** * Displays a command prompt. @@ -729,17 +674,8 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex var context; var cmds; - debug( 'Creating REPL execution context...' ); - - // Create an evaluation context: - context = createEvalContext( this._contextVars, this._ostream, this._sandbox ); // eslint-disable-line max-len - - // Add project APIs... - if ( this._sandbox ) { - setAliases( this._aliases, context, ALIAS_OVERRIDES ); - } else { - setAliasesGlobal( this._globalVars, this._aliases, context, ALIAS_OVERRIDES ); // eslint-disable-line max-len - } + // TODO: Call parent method + context = BaseREPL.prototype.createContext.call( this ); // Get the list of REPL-specific commands: cmds = commands( this ); @@ -763,146 +699,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex return context; }); -/** -* Resets a REPL's context. -* -* @name resetContext -* @memberof REPL.prototype -* @type {Function} -* @returns {REPL} REPL instance -* -* @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* -* // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); -* -* // ... -* -* // Reset the REPL context: -* repl.resetContext(); -* -* // ... -* -* // Close the REPL: -* repl.close(); -*/ -setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext() { - var tmp; - var key; - var o; - var i; - var j; - - debug( 'Resetting REPL execution context...' ); - - // Before creating a new execution context in a non-sandboxed environment, remove current workspace variables in order to allow garbage collection and avoid memory leaks (e.g., variables/functions declared during a REPL session which might remain bound to the environment `global` after clearing a REPL): - if ( this._sandbox === false ) { - // WARNING: in a non-sandboxed environment, if a global variable is externally introduced during a REPL session (i.e., introduced via a mechanism outside of the REPL environment), we will delete that global variable, which means the following logic may introduce unintended side-effects for this particular edge case (e.g., application code may expect the presence of the subsequently deleted global variable). While not ideal, (a) user applications should not be introducing globals to begin with and (b) the probability of a user running a REPL session, a user clearing that REPL session, AND a global variable being introduced between starting a REPL and clearing the REPL should be negligible. - tmp = this._context.vars(); - for ( i = 0; i < tmp.length; i++ ) { - if ( isConfigurableProperty( this._context, tmp[ i ] ) ) { - delete this._context[ tmp[ i ] ]; - } - } - - // Remove REPL globals: - for ( i = 0; i < this._globalVars.length; i++ ) { - o = this._context; - key = this._globalVars[ i ].split( '.' ); // Note: this addresses nested key paths (e.g., `a.b.c`) - for ( j = 0; j < key.length-1; j++ ) { - if ( !hasOwnProp( o, key[ j ] ) ) { - o = null; - break; - } - o = o[ key[ j ] ]; - } - if ( o && isConfigurableProperty( o, key[ j ] ) ) { - delete o[ key[ j ] ]; - } - } - } - // Reset internal buffers for storing context data: - if ( this._sandbox === false ) { - this._globalVars.length = 0; - } - this._aliases.length = 0; - this._workspace.length = 0; - this._contextVars.length = 0; - - // Create a new execution context... - this._context = this.createContext(); - this.emit( 'reset', this._context ); // note: emitting the context allows REPL wrappers to extend the newly created context - - return this; -}); - -/** -* Clears a REPL's history. -* -* @name clearHistory -* @memberof REPL.prototype -* @type {Function} -* @returns {REPL} REPL instance -* -* @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* -* // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); -* -* // ... -* -* // Clear the REPL history: -* repl.clearHistory(); -* -* // ... -* -* // Close the REPL: -* repl.close(); -*/ -setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory() { - debug( 'Resetting REPL history...' ); - this._history.length = 0; - return this; -}); - -/** -* Clears user-defined documentation. -* -* @name clearUserDocs -* @memberof REPL.prototype -* @type {Function} -* @returns {REPL} REPL instance -* -* @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* -* // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); -* -* // ... -* -* // Clear the user defined documentation: -* repl.clearUserDocs(); -* -* // ... -* -* // Close the REPL: -* repl.close(); -*/ -setNonEnumerableReadOnly( REPL.prototype, 'clearUserDocs', function clearUserDocs() { - debug( 'Resetting REPL user-defined documentation...' ); - this._userdocs.length = 0; - return this; -}); - /** * Returns a list of all available themes for syntax highlighting. * @@ -1188,80 +984,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'setKeybinding', function setKeybindin this._keybindings.set( action, keys ); }); -/** -* Loads and evaluates a JavaScript file line-by-line. -* -* @name load -* @memberof REPL.prototype -* @type {Function} -* @param {string} fpath - file path -* @param {Function} clbk - callback -* @throws {Error} cannot load a file into a closed REPL -* @throws {TypeError} first argument must be a string -* @throws {TypeError} second argument must be a function -* @returns {void} -* -* @example -* // TODO -*/ -setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { - var self; - var file; - var len; - var i; - if ( this._closed ) { - throw new Error( 'invalid operation. Cannot load a file into a REPL which has already closed.' ); - } - if ( !isString( fpath ) ) { - throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', fpath ) ); - } - if ( !isFunction( clbk ) ) { - throw new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) ); - } - // Resolve the provided path to an absolute file path: - fpath = resolve( cwd(), fpath ); - debug( 'Loading filepath: %s', fpath ); - - // Attempt to synchronously read the file: - file = readFileSync( fpath, 'utf8' ); - if ( file instanceof Error ) { - debug( 'Error: %s', file.message ); - clbk( file ); - return; - } - self = this; - - // Split the file content into individual lines: - file = file.split( RE_EOL ); - - // Forward each line to the REPL readline interface in order to mimic user input... - len = file.length; - i = -1; - - nextTick( next ); - - /** - * Callback invoked after draining the command queue. - * - * @private - * @param {string} cmd - command - * @param {boolean} success - boolean indicating whether the command successfully executed - */ - function next() { - i += 1; - if ( i < len ) { - if ( file[ i ] ) { - self._rli.write( file[ i ]+'\n' ); - self.once( 'drain', next ); - } else { - nextTick( next ); - } - } else { - nextTick( clbk ); - } - } -}); - /** * Resets a REPL. * @@ -1290,23 +1012,17 @@ setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { + // Call the parent method: + BaseREPL.prototype.reset( this ); + if ( this._closed ) { throw new Error( 'invalid operation. Cannot reset a REPL which has already closed.' ); } debug( 'Resetting REPL...' ); - // Reset the command queue: - this._queue.clear(); - // Clear any command which has been buffered but not yet executed: this.clearCommand(); - // Clear the command history: - this.clearHistory(); - - // Reset the execution context: - this.resetContext(); - // Clear an output TTY stream of any previous commands and output: this.clear(); @@ -1467,67 +1183,17 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearCommand', function onClearComman * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'close', function close() { - var self; if ( this._closed ) { debug( 'Attempted to close an already closed REPL.' ); return this; } - self = this; - this._closed = true; - - // Clear the command queue: - this._queue.clear(); - - // TODO: ensure REPL history is saved (flushed) to file before closing the REPL (see https://github.com/nodejs/node/blob/b21e7c7bcf23a2715951e4cd96180e4dbf1dcd4d/lib/repl.js#L805) - - // TODO: ensure REPL log is saved (flushed) to file before closing the REPL + // Call the parent method: + BaseREPL.prototype.close.call( this ); - nextTick( onTick ); + debug( 'Closing readline interface...' ); + this._rli.close(); return this; - - /** - * Callback invoked upon the next tick of the event loop. - * - * @private - */ - function onTick() { - var tmp; - var key; - var o; - var i; - var j; - - debug( 'Closing readline interface...' ); - self._rli.close(); - - // If this is a non-sandboxed REPL, remove global variables/properties which were introduced during context creation and by a user during a REPL session... - if ( self._sandbox === false ) { - // WARNING: in a non-sandboxed environment, if a global variable is externally introduced during a REPL session (i.e., introduced via a mechanism outside of the REPL environment), we will delete that global variable, which means the following logic may introduce unintended side-effects for this particular edge case (e.g., application code may expect the presence of the subsequently deleted global variable). While not ideal, (a) user applications should not be introducing globals to begin with and (b) the probability of a user running a REPL session, a user closing that REPL session, AND a global variable being introduced between starting a REPL and closing the REPL should be negligible. - tmp = self._context.vars(); // current workspace variables - for ( i = 0; i < tmp.length; i++ ) { - if ( isConfigurableProperty( self._context, tmp[ i ] ) ) { - delete self._context[ tmp[ i ] ]; - } - } - - // Remove REPL globals: - for ( i = 0; i < self._globalVars.length; i++ ) { - o = self._context; - key = self._globalVars[ i ].split( '.' ); // Note: this addresses nested key paths (e.g., `a.b.c`) - for ( j = 0; j < key.length-1; j++ ) { - if ( !hasOwnProp( o, key[ j ] ) ) { - o = null; - break; - } - o = o[ key[ j ] ]; - } - if ( o && isConfigurableProperty( o, key[ j ] ) ) { - delete o[ key[ j ] ]; - } - } - } - } }); /** diff --git a/lib/node_modules/@stdlib/repl/lib/multiline_handler.js b/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js similarity index 84% rename from lib/node_modules/@stdlib/repl/lib/multiline_handler.js rename to lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js index d78009de4959..2d95dc21112b 100644 --- a/lib/node_modules/@stdlib/repl/lib/multiline_handler.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js @@ -24,30 +24,17 @@ var readline = require( 'readline' ); var logger = require( 'debug' ); -var Parser = require( 'acorn' ).Parser; -var parseLoose = require( 'acorn-loose' ).parse; var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); var startsWith = require( '@stdlib/string/starts-with' ); var copy = require( '@stdlib/array/base/copy' ); var min = require( '@stdlib/math/base/special/min' ); var max = require( '@stdlib/math/base/special/max' ); var displayPrompt = require( './display_prompt.js' ); -var drain = require( './drain.js' ); -var multilinePlugin = require( './acorn_detect_multiline_input.js' ); -var processCommand = require( './process_command.js' ); -var compileCommand = require( './compile_command.js' ); // VARIABLES // var debug = logger( 'repl:line' ); -var hasMultilineError = Parser.extend( multilinePlugin ).hasMultilineError; -var RE_WHITESPACE = /^\s*$/; -var RE_SINGLE_LINE_COMMENT = /^\s*\/\//; -var RE_MULTI_LINE_COMMENT = /^\s*\/\*.*\*\/$/; -var AOPTS = { - 'ecmaVersion': 'latest' -}; // MAIN // @@ -531,55 +518,6 @@ setNonEnumerableReadOnly( MultilineHandler.prototype, 'isPasting', function isPa return this._multiline.pasteMode; }); -/** -* Checks if the command is incomplete and a multi-line input. -* -* @name isMultilineInput -* @memberof MultilineHandler.prototype -* @type {Function} -* @param {string} cmd - command -* @returns {boolean} boolean indicating whether the command is a multi-line input -*/ -setNonEnumerableReadOnly( MultilineHandler.prototype, 'isMultilineInput', function isMultilineInput( cmd ) { - var node; - var tmp; - var ast; - - debug( 'Attempting to detect multi-line input...' ); - if ( RE_WHITESPACE.test( cmd ) ) { - debug( 'Multi-line input not detected.' ); - return false; - } - if ( RE_SINGLE_LINE_COMMENT.test( cmd ) || RE_MULTI_LINE_COMMENT.test( cmd ) ) { // eslint-disable-line max-len - debug( 'Multi-line input not detected.' ); - return false; - } - // Check if the command has valid syntax... - tmp = processCommand( cmd ); - if ( !( tmp instanceof Error ) ) { - debug( 'Multi-line input not detected.' ); - return false; - } - if ( hasMultilineError( cmd, AOPTS ) ) { - debug( 'Detected multi-line input. Triggering multi-line mode...' ); - return true; - } - // Still possible that a user is attempting to enter an object literal across multiple lines... - ast = parseLoose( cmd, AOPTS ); - - // Check for a trailing node which is being interpreted as a block statement, as this could be an object literal... - node = ast.body[ ast.body.length-1 ]; - if ( node.type === 'BlockStatement' && node.end === ast.end ) { - tmp = cmd.slice( node.start, node.end ); - if ( hasMultilineError( tmp, AOPTS ) ) { - debug( 'Detected multi-line input. Triggering multi-line mode...' ); - return true; - } - } - debug( 'Multi-line input not detected.' ); - return false; -}); - /** * Processes input line data. * @@ -590,9 +528,7 @@ setNonEnumerableReadOnly( MultilineHandler.prototype, 'isMultilineInput', functi * @returns {void} */ setNonEnumerableReadOnly( MultilineHandler.prototype, 'processLine', function processLine( line ) { - var code; var cmd; - var tmp; var dy; // Save line: @@ -622,34 +558,6 @@ setNonEnumerableReadOnly( MultilineHandler.prototype, 'processLine', function pr } this._multiline.active = false; // false until proven otherwise cmd = this._cmd.join( '\n' ); - if ( RE_WHITESPACE.test( cmd ) ) { - this.resetInput(); - displayPrompt( this._repl, false ); - return; - } - if ( RE_SINGLE_LINE_COMMENT.test( cmd ) || RE_MULTI_LINE_COMMENT.test( cmd ) ) { // eslint-disable-line max-len - debug( 'Detected single-line comment.' ); - tmp = cmd; - } else { - // Check if the command has valid syntax... - debug( 'Processing command...' ); - tmp = processCommand( cmd ); - if ( tmp instanceof Error ) { - // Move cursor to the output row: - dy = this._lines.length - this._lineIndex - 1; - readline.moveCursor( this._ostream, 0, dy ); - - // Reset the input buffers: - this.resetInput(); - - // Write error message and display next prompt: - this._ostream.write( 'Error: '+tmp.message+'\n' ); - this._repl.emit( 'command', cmd, false ); // command failed - displayPrompt( this._repl, false ); - return; - } - } - debug( 'Successfully processed command.' ); // Move cursor to the output row: dy = this._lines.length - this._lineIndex - 1; @@ -658,24 +566,8 @@ setNonEnumerableReadOnly( MultilineHandler.prototype, 'processLine', function pr // Reset the input buffers: this.resetInput(); - // Attempt to compile the command: - debug( 'Attempting to compile command...' ); - code = compileCommand( tmp ); - if ( code instanceof Error ) { - debug( 'Error: %s', code.message ); - this._ostream.write( 'Error: '+code.message+'\n' ); - this._repl.emit( 'command', cmd, false ); // command failed - displayPrompt( this._repl, false ); - return; - } - debug( 'Successfully compiled command.' ); - code.raw = cmd; - - // Add the command to the command queue: - this._queue.push( code ); - - // Request to run the command: - drain( this._repl ); + // Evaluate command: + this._repl.emit( 'input', cmd ); }); /** @@ -739,7 +631,7 @@ setNonEnumerableReadOnly( MultilineHandler.prototype, 'beforeKeypress', function this._lines[ this._lineIndex ] = this._rli.line; // If we are in paste mode or the command is incomplete, trigger multi-line mode... - if ( !this._multiline.pasteMode && !this.isMultilineInput( cmd.join( '\n' ) ) ) { + if ( !this._multiline.pasteMode && !this._repl._isMultilineInput( cmd.join( '\n' ) ) ) { this._ttyWrite.call( this._rli, data, key ); return; } diff --git a/lib/node_modules/@stdlib/repl/lib/output_stream.js b/lib/node_modules/@stdlib/repl/cli/lib/output_stream.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/output_stream.js rename to lib/node_modules/@stdlib/repl/cli/lib/output_stream.js diff --git a/lib/node_modules/@stdlib/repl/lib/parse_key.js b/lib/node_modules/@stdlib/repl/cli/lib/parse_key.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/parse_key.js rename to lib/node_modules/@stdlib/repl/cli/lib/parse_key.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/property_comparator.js b/lib/node_modules/@stdlib/repl/cli/lib/property_comparator.js new file mode 100644 index 000000000000..856e1a3c1367 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/property_comparator.js @@ -0,0 +1,63 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 // + +/** +* Comparator function for sorting property names and symbols in lexicography order. +* +* ## Notes +* +* - Symbols are sorted **after** names. +* +* @private +* @param {(string|symbol)} a - property +* @param {(string|symbol)} b - property +* @returns {integer} comparison result +*/ +function comparator( a, b ) { + var ta = typeof a; + var tb = typeof b; + + // Strings are sorted before symbols: + if ( ta === 'string' && tb === 'symbol' ) { + return -1; + } + if ( ta === 'symbol' && tb === 'string' ) { + return 1; + } + // Convert symbols to strings: + a = String( a ); + b = String( b ); + + // Sort in lexicographic order: + if ( a < b ) { + return -1; + } + if ( a === b ) { + return 0; + } + return 1; +} + + +// EXPORTS // + +module.exports = comparator; diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_leading_whitespace.js b/lib/node_modules/@stdlib/repl/cli/lib/regexp_leading_whitespace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/regexp_leading_whitespace.js rename to lib/node_modules/@stdlib/repl/cli/lib/regexp_leading_whitespace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/regexp_reserved_syntax_characters.js b/lib/node_modules/@stdlib/repl/cli/lib/regexp_reserved_syntax_characters.js new file mode 100644 index 000000000000..c72e86e13e6a --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/regexp_reserved_syntax_characters.js @@ -0,0 +1,42 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2024 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 a regular expression for matching reserved JavaScript syntax characters. +* +* @private +* @returns {RegExp} regular expression +* +* @example +* var RE_SYNTAX_CHARS = createRegExp(); +* +* var bool = RE_SYNTAX_CHARS.test( '()' ); +* // returns true +*/ +function createRegExp() { + return /[`~!@#%^&*()\-=+[\]{}\\/|;:'",<>? ]/; +} + + +// EXPORTS // + +module.exports = createRegExp; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/set_commands.js b/lib/node_modules/@stdlib/repl/cli/lib/set_commands.js new file mode 100644 index 000000000000..c35a6736d8d4 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/set_commands.js @@ -0,0 +1,64 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 logger = require( 'debug' ); +var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); +var setReadOnlyAccessor = require( '@stdlib/utils/define-read-only-accessor' ); + + +// VARIABLES // + +var debug = logger( 'repl:set_commands' ); + + +// MAIN // + +/** +* Sets commands on a sandboxed `context` object. +* +* @private +* @param {Object} context - context object +* @param {ArrayArray} commands - commands +* @returns {Object} context object +*/ +function setCommands( context, commands ) { + var cmd; + var i; + + for ( i = 0; i < commands.length; i++ ) { + cmd = commands[ i ]; + if ( hasOwnProp( context, cmd[ 0 ] ) ) { + debug( 'Skipping command as global context property `'+cmd[0]+'` is already assigned.' ); + } else if ( cmd[ 2 ] ) { + setReadOnlyAccessor( context, cmd[ 0 ], cmd[ 1 ] ); + } else { + setReadOnly( context, cmd[ 0 ], cmd[ 1 ] ); + } + } + return context; +} + + +// EXPORTS // + +module.exports = setCommands; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/set_commands_global.js b/lib/node_modules/@stdlib/repl/cli/lib/set_commands_global.js new file mode 100644 index 000000000000..3f3c7b36ce60 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/set_commands_global.js @@ -0,0 +1,72 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 logger = require( 'debug' ); +var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var setConfigurableReadOnly = require( '@stdlib/utils/define-configurable-read-only-property' ); +var setConfigurableReadOnlyAccessor = require( '@stdlib/utils/define-configurable-read-only-accessor' ); // eslint-disable-line id-length + + +// VARIABLES // + +var debug = logger( 'repl:set_commands_global' ); + + +// MAIN // + +/** +* Sets commands on non-sandboxed `context` object. +* +* ## Notes +* +* - This function avoids overwriting properties in a non-sandboxed environment in order to avoid unintended side-effects. +* +* @private +* @param {Array} out - output array for storing a list of global variables added to the global namespace +* @param {Object} context - context object +* @param {ArrayArray} commands - commands +* @returns {Object} context object +*/ +function setCommandsGlobal( out, context, commands ) { + var cmd; + var i; + + for ( i = 0; i < commands.length; i++ ) { + cmd = commands[ i ]; + if ( hasOwnProp( context, cmd[ 0 ] ) ) { + debug( 'Skipping command as global context property `'+cmd[0]+'` is already assigned.' ); + } else { + out.push( cmd[ 0 ] ); + if ( cmd[ 2 ] ) { + setConfigurableReadOnlyAccessor( context, cmd[ 0 ], cmd[ 1 ] ); + } else { + setConfigurableReadOnly( context, cmd[ 0 ], cmd[ 1 ] ); + } + } + } + return context; +} + + +// EXPORTS // + +module.exports = setCommandsGlobal; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/setdiff.js b/lib/node_modules/@stdlib/repl/cli/lib/setdiff.js new file mode 100644 index 000000000000..a646ba1dad93 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/setdiff.js @@ -0,0 +1,193 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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'; + +// VARIABLES // + +var TYPE_SORT_ORDER = { + 'number': 0, + 'string': 1, + 'symbol': 2 +}; + + +// MAIN // + +/** +* Returns the set difference between two similarly **sorted** lists. +* +* ## Notes +* +* - The contents of the provided arrays are assumed to be either numbers, strings, or symbols. +* +* - The lists are **expected** to be sorted not only, e.g., lexicographically, but also according to type in the **following** order: `numbers`, `strings`, and then `symbols`. +* +* ```text +* A = [ 1, 2, 3, '1', '2', '3', Symbol('1'), Symbol('2'), Symbol('3') ] +* B = [ 1, 2, '1', '3', Symbol('2'), Symbol('3') ] +* // => [ 3, '2', Symbol('1') ] +* ``` +* +* @private +* @param {Array} A - first sorted list +* @param {Array} B - second sorted list +* @returns {Array} set difference +* +* @example +* var out = setdiff( [ 1, 2, 3 ], [ 2, 4, 5 ] ); +* // returns [ 1, 3, 4, 5 ] +* +* @example +* var out = setdiff( [ 1 ], [ 2, 4, 5 ] ); +* // returns [ 1, 2, 4, 5 ] +* +* @example +* var out = setdiff( [ 1, 2, 3 ], [ 2 ] ); +* // returns [ 1, 3 ] +* +* @example +* var out = setdiff( [ 1, 2, 3 ], [] ); +* // returns [ 1, 2, 3 ] +* +* @example +* var out = setdiff( [], [ 2, 4, 5 ] ); +* // returns [ 2, 4, 5 ] +* +* @example +* var out = setdiff( [ 1, 2, 3 ], [ 1, 2, 3 ] ); +* // returns [] +* +* @example +* var out = setdiff( [], [] ); +* // returns [] +* +* @example +* var out = setdiff( [ 1 ], [ 1 ] ); +* // returns [] +* +* @example +* var out = setdiff( [ 1, 2, 2, 3, 3 ], [ 2, 4, 5, 5 ] ); +* // returns [ 1, 2, 3, 3, 4, 5, 5 ] +* +* @example +* var out = setdiff( [ 1, 2, 3 ], [ 4, 5 ] ); +* // returns [ 1, 2, 3, 4, 5 ] +* +* @example +* var out = setdiff( [ 1, 2 ], [ 3, 4, 5 ] ); +* // returns [ 1, 2, 3, 4, 5 ] +* +* @example +* var out = setdiff( [ 1, 2, 3, 7 ], [ 0, 1, 2, 4, 5 ] ); +* // returns [ 0, 3, 4, 5, 7 ] +* +* @example +* var out = setdiff( [ 1, 2, 3, 7, 9 ], [ -2, -1, 0, 1, 2, 4, 5 ] ); +* // returns [ -2, -1, 0, 3, 4, 5, 7, 9 ] +*/ +function setdiff( A, B ) { + var out; + var la; + var lb; + var ta; + var tb; + var a; + var b; + var i; + var j; + var k; + + la = A.length; + lb = B.length; + if ( la === 0 ) { + return B.slice(); + } + if ( lb === 0 ) { + return A.slice(); + } + out = []; + i = 0; + j = 0; + while ( i < la && j < lb ) { + a = A[ i ]; + b = B[ j ]; + if ( a === b ) { // addresses numbers, strings, and symbols alike + i += 1; + j += 1; + continue; + } + ta = typeof a; + tb = typeof b; + if ( ta !== tb ) { + // Note: we assume we have found a "type" border! + ta = TYPE_SORT_ORDER[ ta ]; + tb = TYPE_SORT_ORDER[ tb ]; + if ( ta < tb ) { + out.push( a ); + i += 1; + } else { // tb < ta + out.push( b ); + j += 1; + } + } + // Note: the types for `a` and `b` are the *same*! + else if ( ta === 'symbol' ) { + // Note: symbols don't have a "natural" sort order, so we need to do things in a more computationally intensive way via linear scans... + while ( i < la ) { + for ( k = j+1; k < lb; k++ ) { // `j+1` because we already know the symbols are not equal + if ( a === B[ k ] ) { + break; + } + } + // If we searched through all the symbols in `B` and failed to find a match, we found a unique symbol... + if ( k === lb ) { + out.push( a ); + } else { + // We can leverage the fact that symbols in `A` and `B` should be similarly sorted by recognizing that, if we found a match, this means that the symbols in `B` preceding the match should be unique... + for ( ; j < k; j++ ) { + out.push( B[ j ] ); + } + } + i += 1; + } + } else if ( a < b ) { + out.push( a ); + i += 1; + } else { // b < a + out.push( b ); + j += 1; + } + } + if ( i < la ) { + for ( ; i < la; i++ ) { + out.push( A[ i ] ); + } + } + if ( j < lb ) { + for ( ; j < lb; j++ ) { + out.push( B[ j ] ); + } + } + return out; +} + + +// EXPORTS // + +module.exports = setdiff; diff --git a/lib/node_modules/@stdlib/repl/lib/settings.js b/lib/node_modules/@stdlib/repl/cli/lib/settings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/settings.js rename to lib/node_modules/@stdlib/repl/cli/lib/settings.js index 429e21b3d1a5..91103b5891ee 100644 --- a/lib/node_modules/@stdlib/repl/lib/settings.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/settings.js @@ -56,13 +56,13 @@ var SETTINGS = { 'desc': 'Enable syntax highlighting.', 'type': 'boolean' }, - 'eagerEvaluation': { - 'desc': 'Enable eager evaluation.', - 'type': 'boolean' - }, 'theme': { 'desc': 'Set the syntax highlighting theme.', 'type': 'string' + }, + 'eagerEvaluation': { + 'desc': 'Enable eager evaluation.', + 'type': 'boolean' } }; diff --git a/lib/node_modules/@stdlib/repl/lib/settings_alias_args.js b/lib/node_modules/@stdlib/repl/cli/lib/settings_names.js similarity index 60% rename from lib/node_modules/@stdlib/repl/lib/settings_alias_args.js rename to lib/node_modules/@stdlib/repl/cli/lib/settings_names.js index ead6beda6e6e..fb750e4b5663 100644 --- a/lib/node_modules/@stdlib/repl/lib/settings_alias_args.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/settings_names.js @@ -20,29 +20,22 @@ // MODULES // -var SETTINGS_ALIASES = require( './settings_aliases.js' ); +var objectKeys = require( '@stdlib/utils/keys' ); +var SETTINGS = require( './settings.js' ); // MAIN // /** -* Returns a list of argument completion flags for a specified settings API. +* List of settings names. * * @private -* @param {string} alias - alias -* @returns {(Array|null)} argument completion flags +* @name SETTINGS_NAMES +* @type {Array} */ -function argFlags( alias ) { - var i; - for ( i = 0; i < SETTINGS_ALIASES.length; i++ ) { - if ( SETTINGS_ALIASES[ i ][ 0 ] === alias ) { - return SETTINGS_ALIASES[ i ].slice( 1 ); - } - } - return null; -} +var SETTINGS_NAMES = objectKeys( SETTINGS ); // EXPORTS // -module.exports = argFlags; +module.exports = SETTINGS_NAMES; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/settings_validators.js b/lib/node_modules/@stdlib/repl/cli/lib/settings_validators.js new file mode 100644 index 000000000000..345b07acaa48 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/settings_validators.js @@ -0,0 +1,112 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2024 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 isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; +var isString = require( '@stdlib/assert/is-string' ).isPrimitive; +var isNumber = require( '@stdlib/assert/is-number' ).isPrimitive; +var isInteger = require( '@stdlib/assert/is-integer' ).isPrimitive; +var format = require( '@stdlib/string/format' ); + + +// FUNCTIONS // + +/** +* Returns a formatted error message for a value is not a boolean. +* +* @private +* @param {string} name - setting name +* @param {*} value - invalid value +* @returns {string} formatted error message +*/ +function booleanErrMsg( name, value ) { + return format( 'invalid argument. `%s` setting must be a boolean. Value: `%s`.', name, value ); +} + +/** +* Returns a formatted error message for a value is not an integer. +* +* @private +* @param {string} name - setting name +* @param {*} value - invalid value +* @returns {string} formatted error message +*/ +function integerErrMsg( name, value ) { + return format( 'invalid argument. `%s` setting must be an integer. Value: `%s`.', name, value ); +} + +/** +* Returns a formatted error message for a value is not a number. +* +* @private +* @param {string} name - setting name +* @param {*} value - invalid value +* @returns {string} formatted error message +*/ +function numberErrMsg( name, value ) { + return format( 'invalid argument. `%s` setting must be a number. Value: `%s`.', name, value ); +} + +/** +* Returns a formatted error message for a value is not a string. +* +* @private +* @param {string} name - setting name +* @param {*} value - invalid value +* @returns {string} formatted error message +*/ +function stringErrMsg( name, value ) { + return format( 'invalid argument. `%s` setting must be a string. Value: `%s`.', name, value ); +} + + +// MAIN // + +/** +* Mapping from data types to validation functions. +* +* @private +* @name VALIDATORS +* @type {Object} +*/ +var VALIDATORS = { // eslint-disable-line vars-on-top + 'boolean': { + 'assert': isBoolean, + 'msg': booleanErrMsg + }, + 'integer': { + 'assert': isInteger, + 'msg': integerErrMsg + }, + 'number': { + 'assert': isNumber, + 'msg': numberErrMsg + }, + 'string': { + 'assert': isString, + 'msg': stringErrMsg + } +}; + + +// EXPORTS // + +module.exports = VALIDATORS; diff --git a/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js b/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js similarity index 99% rename from lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js rename to lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js index 0e09f00cb332..779273cbb1b8 100644 --- a/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js @@ -30,7 +30,6 @@ var isEmptyArray = require( '@stdlib/assert/is-empty-array' ); var objectKeys = require( '@stdlib/utils/keys' ); var omit = require( '@stdlib/utils/omit' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var tokenizer = require( './tokenizer.js' ); var THEMES = require( './themes.js' ); var ANSI = require( './ansi_colors.js' ); @@ -329,7 +328,7 @@ setNonEnumerableReadOnly( SyntaxHighlighter.prototype, 'onKeypress', function on // Tokenize: debug( 'Line change detected. Tokenizing line: %s', this._rli.line ); this._line = this._rli.line; // update line buffer - tokens = tokenizer( this._line, this._repl._context ); + tokens = this._repl._tokenizer( this._line, this._repl._context ); if ( isEmptyArray( tokens ) ) { debug( 'No tokens found. Skipping highlighting...' ); this._highlightedLine = this._line; diff --git a/lib/node_modules/@stdlib/repl/lib/themes.js b/lib/node_modules/@stdlib/repl/cli/lib/themes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/themes.js rename to lib/node_modules/@stdlib/repl/cli/lib/themes.js diff --git a/lib/node_modules/@stdlib/repl/lib/validate.js b/lib/node_modules/@stdlib/repl/cli/lib/validate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/validate.js rename to lib/node_modules/@stdlib/repl/cli/lib/validate.js diff --git a/lib/node_modules/@stdlib/repl/lib/validate_keybindings.js b/lib/node_modules/@stdlib/repl/cli/lib/validate_keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/validate_keybindings.js rename to lib/node_modules/@stdlib/repl/cli/lib/validate_keybindings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/validate_settings.js b/lib/node_modules/@stdlib/repl/cli/lib/validate_settings.js new file mode 100644 index 000000000000..923f860f6026 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/validate_settings.js @@ -0,0 +1,78 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2024 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 isPlainObject = require( '@stdlib/assert/is-plain-object' ); +var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var format = require( '@stdlib/string/format' ); +var SETTINGS = require( './settings.js' ); +var SETTINGS_NAMES = require( './settings_names.js' ); +var VALIDATORS = require( './settings_validators.js' ); + + +// MAIN // + +/** +* Validates settings. +* +* @private +* @param {Object} opts - destination object +* @param {Object} options - settings options +* @returns {(Error|null)} error or null +* +* @example +* var options = { +* 'autoClosePairs': true +* }; +* var opts = {}; +* var err = validate( opts, options ); +* if ( err ) { +* throw err; +* } +*/ +function validate( opts, options ) { + var name; + var o; + var f; + var v; + var i; + if ( !isPlainObject( options ) ) { + return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) ); + } + for ( i = 0; i < SETTINGS_NAMES.length; i++ ) { + name = SETTINGS_NAMES[ i ]; + if ( hasOwnProp( options, name ) ) { + v = options[ name ]; + o = SETTINGS[ name ]; + f = VALIDATORS[ o.type ]; + if ( !f.assert( v ) ) { + return new TypeError( f.msg( name, v ) ); + } + opts[ name ] = v; + } + } + return null; +} + + +// EXPORTS // + +module.exports = validate; diff --git a/lib/node_modules/@stdlib/repl/lib/welcome_text.js b/lib/node_modules/@stdlib/repl/cli/lib/welcome_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/welcome_text.js rename to lib/node_modules/@stdlib/repl/cli/lib/welcome_text.js diff --git a/lib/node_modules/@stdlib/repl/cli/package.json b/lib/node_modules/@stdlib/repl/cli/package.json new file mode 100644 index 000000000000..7e75fc1fac41 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/package.json @@ -0,0 +1,78 @@ +{ + "name": "@stdlib/repl/cli", + "version": "0.0.0", + "description": "REPL environment.", + "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" + } + ], + "bin": { + "stdlib-repl": "./bin/cli" + }, + "main": "./lib", + "browser": { + "./lib": "./lib/browser/index.js", + "process": "process/" + }, + "directories": { + "benchmark": "./benchmark", + "data": "./data", + "doc": "./docs", + "example": "./examples", + "lib": "./lib", + "scripts": "./scripts", + "test": "./test" + }, + "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", + "repl", + "read-eval-print-loop", + "eval", + "evaluate", + "interact", + "interactive", + "console", + "terminal", + "shell", + "server", + "toplevel" + ], + "__stdlib__": { + "envs": { + "browser": false + } + } +} diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_body.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_body.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_body.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_init.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_init.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_init.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_init.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_brace.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_brace.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_brace.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_body.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_body.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_body.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_test.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_test.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_test.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_test.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/script.js b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/script.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/script.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/script.js diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/script.js b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/script.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/script.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/script.js diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/repl.js b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/repl.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/repl.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/repl.js diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/comments.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/comments.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/comments.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/comments.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/control_keywords.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/control_keywords.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/control_keywords.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/control_keywords.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/declaration_names.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/declaration_names.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/declaration_names.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/declaration_names.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/functions.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/functions.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/functions.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/functions.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/keywords.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/keywords.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/keywords.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/keywords.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/local_scopes.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/local_scopes.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/local_scopes.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/local_scopes.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/member_expressions.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/member_expressions.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/member_expressions.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/member_expressions.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/numeric_literals.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/numeric_literals.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/numeric_literals.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/numeric_literals.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/objects.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/objects.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/objects.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/objects.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/operators.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/operators.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/operators.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/operators.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/punctuation.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/punctuation.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/punctuation.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/punctuation.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/regexp.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/regexp.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/regexp.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/regexp.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/reserved_literals.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/reserved_literals.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/reserved_literals.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/reserved_literals.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/special_identifiers.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/special_identifiers.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/special_identifiers.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/special_identifiers.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/string_literals.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/string_literals.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/string_literals.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/string_literals.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/variables.json b/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/variables.json similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/variables.json rename to lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/variables.json diff --git a/lib/node_modules/@stdlib/repl/test/integration/test.auto_close_pairs.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_close_pairs.js similarity index 99% rename from lib/node_modules/@stdlib/repl/test/integration/test.auto_close_pairs.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_close_pairs.js index 67e6198e2c58..3e4222762350 100644 --- a/lib/node_modules/@stdlib/repl/test/integration/test.auto_close_pairs.js +++ b/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_close_pairs.js @@ -147,7 +147,6 @@ function defaultSettings() { 'completionPreviews': false, 'syntaxHighlighting': false, 'eagerEvaluation': false - }; } diff --git a/lib/node_modules/@stdlib/repl/test/integration/test.auto_delete_pairs.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_delete_pairs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/test.auto_delete_pairs.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_delete_pairs.js diff --git a/lib/node_modules/@stdlib/repl/test/integration/test.auto_page.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/test.auto_page.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js diff --git a/lib/node_modules/@stdlib/repl/test/integration/test.completer_engine.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.completer_engine.js similarity index 99% rename from lib/node_modules/@stdlib/repl/test/integration/test.completer_engine.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/test.completer_engine.js index ffcc95ba8562..289ddb2fe99f 100644 --- a/lib/node_modules/@stdlib/repl/test/integration/test.completer_engine.js +++ b/lib/node_modules/@stdlib/repl/cli/test/integration/test.completer_engine.js @@ -48,8 +48,8 @@ function defaultSettings() { 'autoDisableBracketedPasteOnExit': false, 'completionPreviews': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoPage': false + 'autoPage': false, + 'eagerEvaluation': false }; } diff --git a/lib/node_modules/@stdlib/repl/test/integration/test.completion_previews.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js similarity index 95% rename from lib/node_modules/@stdlib/repl/test/integration/test.completion_previews.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js index 6f572938b9a7..f8762ff4904a 100644 --- a/lib/node_modules/@stdlib/repl/test/integration/test.completion_previews.js +++ b/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js @@ -47,8 +47,8 @@ tape( 'a REPL instance supports displaying a completion preview of user-defined 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -93,8 +93,8 @@ tape( 'a REPL instance supports displaying a completion preview for common prefi 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -140,8 +140,8 @@ tape( 'a REPL instance supports displaying a completion preview for recognized i 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -186,8 +186,8 @@ tape( 'a REPL instance supports displaying a completion preview when a cursor is 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -241,8 +241,8 @@ tape( 'a REPL instance supports auto-completing a completion candidate by moving 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -295,8 +295,8 @@ tape( 'a REPL instance supports auto-completing a completion preview and executi 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -350,8 +350,8 @@ tape( 'a REPL instance does not display a completion preview when no completion 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); @@ -410,8 +410,8 @@ tape( 'a REPL instance does not display a completion preview once a user enters 'settings': { 'autoPage': false, 'syntaxHighlighting': false, - 'eagerEvaluation': false, - 'autoDisableBracketedPasteOnExit': false + 'autoDisableBracketedPasteOnExit': false, + 'eagerEvaluation': false } }; r = repl( opts, onClose ); diff --git a/lib/node_modules/@stdlib/repl/test/integration/test.syntax_highlighting.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.syntax_highlighting.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/integration/test.syntax_highlighting.js rename to lib/node_modules/@stdlib/repl/cli/test/integration/test.syntax_highlighting.js diff --git a/lib/node_modules/@stdlib/repl/test/test.cli.js b/lib/node_modules/@stdlib/repl/cli/test/test.cli.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/test.cli.js rename to lib/node_modules/@stdlib/repl/cli/test/test.cli.js diff --git a/lib/node_modules/@stdlib/repl/test/test.js b/lib/node_modules/@stdlib/repl/cli/test/test.js similarity index 100% rename from lib/node_modules/@stdlib/repl/test/test.js rename to lib/node_modules/@stdlib/repl/cli/test/test.js diff --git a/lib/node_modules/@stdlib/repl/lib/complete_settings.js b/lib/node_modules/@stdlib/repl/lib/complete_settings.js deleted file mode 100644 index 93672a1f4da7..000000000000 --- a/lib/node_modules/@stdlib/repl/lib/complete_settings.js +++ /dev/null @@ -1,91 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2024 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 logger = require( 'debug' ); -var parse = require( 'acorn-loose' ).parse; -var startsWith = require( '@stdlib/string/starts-with' ); -var settingsAliasArgs = require( './settings_alias_args.js' ); -var SETTINGS_NAMES = require( './settings_names.js' ); - - -// VARIABLES // - -var debug = logger( 'repl:completer:settings' ); -var AOPTS = { - 'ecmaVersion': 'latest' -}; - - -// MAIN // - -/** -* Completes a settings API expression. -* -* @private -* @param {Array} out - output array for storing completions -* @param {REPL} repl - REPL instance -* @param {string} expression - expression to complete -* @param {string} alias - settings API alias -* @param {string} value - value to complete -* @returns {string} value filter -*/ -function complete( out, repl, expression, alias, value ) { - var args; - var ast; - var arg; - var v; - var i; - - // Get the list of argument types for the desired API: - debug( 'Settings API: %s', alias ); - args = settingsAliasArgs( alias ); - - // Parse the expression into an AST: - debug( 'Expression: %s', expression ); - ast = parse( expression, AOPTS ); - - // Check whether the argument which triggered TAB completion has a corresponding argument type which is completable: - debug( 'Checking if argument is completable...' ); - arg = args[ ast.body[ 0 ].expression.arguments.length-1 ]; - if ( !arg ) { - debug( 'Argument which triggered TAB completion is not completable.' ); - return ''; - } - debug( 'Argument is completable.' ); - - debug( 'Searching for completion candidates...' ); - for ( i = 0; i < SETTINGS_NAMES.length; i++ ) { - v = SETTINGS_NAMES[ i ]; - if ( startsWith( v, value ) ) { - debug( 'Found a completion: %s', v ); - out.push( v ); - } else { - debug( '%s does not match filter %s. Skipping...', v, value ); - } - } - return value; -} - - -// EXPORTS // - -module.exports = complete; diff --git a/lib/node_modules/@stdlib/repl/lib/regexp_settings.js b/lib/node_modules/@stdlib/repl/lib/regexp_settings.js deleted file mode 100644 index 161d77940a1f..000000000000 --- a/lib/node_modules/@stdlib/repl/lib/regexp_settings.js +++ /dev/null @@ -1,106 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2024 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 SETTINGS_ALIASES = require( './settings_aliases.js' ); - - -// MAIN // - -/** -* Returns a regular expression for matching settings APIs. -* -* ## Notes -* -* - Example output: -* -* ```text -* /\b(?:(settings)\s*\(\s*(.*,\s*)*(?:\[\s*(?:[^\]]*,\s*)*)?['"]([^'"]*))$/ -* ``` -* -* @private -* @returns {RegExp} regular expression -*/ -function createRegExp() { - var re; - var N; - var M; - var i; - - N = SETTINGS_ALIASES.length; - M = N - 1; - re = ''; - - // Match a word boundary: - re += '\\b'; - - // Create a capture group for detecting an alias with an incomplete invocation (e.g., `settings( 'foo`): - re += '(?:'; - - // Create a capture group for matching the alias... - re += '('; - for ( i = 0; i < N; i++ ) { - // Append the alias: - re += SETTINGS_ALIASES[ i ][ 0 ]; - - // Separate aliases with an OR separator: - if ( i < M ) { - re += '|'; - } - } - // Close the alias capture group: - re += ')'; - - // Match zero or more whitespace characters after the alias: - re += '\\s*'; - - // Match an opening parenthesis literal: - re += '\\('; - - // Match zero or more whitespace characters after the opening parenthesis: - re += '\\s*'; - - // Capture provided (comma-separated) arguments which precede the last argument: - re += '(.*,\\s*)*'; - - // Capture, but don't remember, an incomplete array argument (including all items except for the last) which occurs zero or one time: - re += '(?:\\[\\s*(?:[^\\]]*,\\s*)*)?'; - - // Match either a `'` or `"` literal: - re += '[\'"]'; - - // Capture the last (incomplete) argument (or array item): - re += '([^\'"]*)'; - - // Close the incomplete invocation capture group: - re += ')'; - - // Match the end of input (i.e., ensure that the match is an incomplete invocation): - re += '$'; - - // Return the regular expression: - return new RegExp( re ); -} - - -// EXPORTS // - -module.exports = createRegExp; diff --git a/lib/node_modules/@stdlib/repl/lib/settings_aliases.js b/lib/node_modules/@stdlib/repl/lib/settings_aliases.js deleted file mode 100644 index 7e27cf222120..000000000000 --- a/lib/node_modules/@stdlib/repl/lib/settings_aliases.js +++ /dev/null @@ -1,46 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2024 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 settings API aliases and corresponding argument completion compatibility. -* -* ## Notes -* -* - Each entry in the list has the following format: -* -* ``` -* [ , , ... ] -* ``` -* -* where `` is a settings API alias and `` is a `boolean` indicating whether an argument is compatible with settings name completion. -* -* - For the purposes of TAB completion, only those positional arguments which expect settings names need to be included. For example, if an API has three parameters and only the first argument expects a settings name, only that first argument needs to be included below; the remaining two arguments can be omitted, as those arguments are assumed to be incompatible with settings name completion. If an API has three parameters and only the second argument expects a settings name, only the first two arguments need to be included below, with the first argument documented as `null`; the remaining argument can be omitted. -*/ -var aliases = [ - // Note: keep in alphabetical order... - [ 'settings', true ] -]; - - -// EXPORTS // - -module.exports = aliases; From 93672455072fdb31c6eadd19e1433fd203f019fe Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Feb 2025 13:28:28 +0000 Subject: [PATCH 03/26] refactor: move example --- type: pre_push_report description: Results of running various checks prior to pushing changes. report: - task: run_javascript_examples status: na - task: run_c_examples status: na - task: run_cpp_examples status: na - task: run_javascript_readme_examples status: na - task: run_c_benchmarks status: na - task: run_cpp_benchmarks status: na - task: run_fortran_benchmarks status: na - task: run_javascript_benchmarks status: na - task: run_julia_benchmarks status: na - task: run_python_benchmarks status: na - task: run_r_benchmarks status: na - task: run_javascript_tests status: na --- --- .../@stdlib/repl/{ => cli}/presentation/examples/index.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename lib/node_modules/@stdlib/repl/{ => cli}/presentation/examples/index.js (97%) diff --git a/lib/node_modules/@stdlib/repl/presentation/examples/index.js b/lib/node_modules/@stdlib/repl/cli/presentation/examples/index.js similarity index 97% rename from lib/node_modules/@stdlib/repl/presentation/examples/index.js rename to lib/node_modules/@stdlib/repl/cli/presentation/examples/index.js index f74db49e0416..0a34df541338 100644 --- a/lib/node_modules/@stdlib/repl/presentation/examples/index.js +++ b/lib/node_modules/@stdlib/repl/cli/presentation/examples/index.js @@ -19,7 +19,7 @@ 'use strict'; var join = require( 'path' ).join; -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); var Presentation = require( './../lib' ); // eslint-disable-line stdlib/no-redeclare function onExit() { From 1808c07ba42a1623a12dac8d598785a534e44e40 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Thu, 6 Mar 2025 19:10:54 +0000 Subject: [PATCH 04/26] refactor: move commands to client implementation Signed-off-by: Snehil Shah --- 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: passed - task: lint_package_json status: passed - task: lint_repl_help status: na - task: lint_javascript_src status: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: passed - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: passed - 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 --- --- type: pre_push_report description: Results of running various checks prior to pushing changes. report: - task: run_javascript_examples status: passed - task: run_c_examples status: na - task: run_cpp_examples status: na - task: run_javascript_readme_examples status: passed - task: run_c_benchmarks status: na - task: run_cpp_benchmarks status: na - task: run_fortran_benchmarks status: na - task: run_javascript_benchmarks status: passed - task: run_julia_benchmarks status: na - task: run_python_benchmarks status: na - task: run_r_benchmarks status: na - task: run_javascript_tests status: passed --- --- lib/node_modules/@stdlib/repl/base/README.md | 271 ++++++++++++++++++ .../@stdlib/repl/base/benchmark/benchmark.js | 95 ++++++ .../base/{lib/log.js => examples/index.js} | 33 +-- .../@stdlib/repl/base/lib/commands.js | 130 --------- .../repl/base/lib/complete_tutorial.js | 93 ------ .../@stdlib/repl/base/lib/completer.js | 17 -- .../@stdlib/repl/base/lib/defaults.js | 3 - .../@stdlib/repl/base/lib/index.js | 17 +- .../@stdlib/repl/base/lib/main.js | 158 +--------- .../@stdlib/repl/base/lib/regexp_tutorial.js | 106 ------- .../@stdlib/repl/base/lib/set_commands.js | 64 ----- .../repl/base/lib/set_commands_global.js | 72 ----- .../@stdlib/repl/base/lib/settings.js | 68 ----- .../repl/base/lib/settings_validators.js | 112 -------- .../@stdlib/repl/base/lib/tutorial_aliases.js | 46 --- .../@stdlib/repl/base/lib/validate.js | 24 +- .../repl/base/lib/validate_settings.js | 78 ----- .../@stdlib/repl/base/package.json | 7 - .../{lib/settings_names.js => test/test.js} | 26 +- lib/node_modules/@stdlib/repl/cli/README.md | 4 +- .../repl/{base => cli}/data/contributor.json | 0 .../repl/{base => cli}/data/example.csv | 0 .../repl/{base => cli}/data/example.json | 0 .../@stdlib/repl/{base => cli}/data/help.csv | 0 .../@stdlib/repl/{base => cli}/data/help.json | 0 .../@stdlib/repl/{base => cli}/data/info.csv | 0 .../@stdlib/repl/{base => cli}/data/info.json | 0 .../repl/{base => cli}/data/license_text.json | 0 .../repl/{base => cli}/data/tutorial.csv | 0 .../repl/{base => cli}/data/tutorial.json | 0 .../{base => cli}/docs/commands/__done__.txt | 0 .../{base => cli}/docs/commands/_require.txt | 0 .../{base => cli}/docs/commands/alias2pkg.txt | 0 .../docs/commands/alias2related.txt | 0 .../repl/{base => cli}/docs/commands/ans.txt | 0 .../docs/commands/assignfrom.txt | 0 .../{base => cli}/docs/commands/assignin.txt | 0 .../{base => cli}/docs/commands/citation.txt | 0 .../docs/commands/clear_history.txt | 0 .../docs/commands/clear_user_docs.txt | 0 .../docs/commands/clear_vars.txt | 0 .../docs/commands/clear_workspace.txt | 0 .../docs/commands/contributor.txt | 0 .../{base => cli}/docs/commands/copyright.txt | 0 .../{base => cli}/docs/commands/credits.txt | 0 .../docs/commands/current_workspace.txt | 0 .../docs/commands/deeprerequire.txt | 0 .../docs/commands/delete_workspace.txt | 0 .../{base => cli}/docs/commands/donate.txt | 0 .../{base => cli}/docs/commands/evalin.txt | 0 .../{base => cli}/docs/commands/example.txt | 0 .../{base => cli}/docs/commands/global.txt | 0 .../repl/{base => cli}/docs/commands/help.txt | 0 .../repl/{base => cli}/docs/commands/info.txt | 0 .../docs/commands/is_keyword.txt | 0 .../docs/commands/is_workspace.txt | 0 .../docs/commands/license_text.txt | 0 .../repl/{base => cli}/docs/commands/load.txt | 0 .../docs/commands/load_workspace.txt | 0 .../{base => cli}/docs/commands/log_start.txt | 0 .../{base => cli}/docs/commands/log_stop.txt | 0 .../repl/{base => cli}/docs/commands/quit.txt | 0 .../docs/commands/rename_workspace.txt | 0 .../{base => cli}/docs/commands/rerequire.txt | 0 .../{base => cli}/docs/commands/rerun.txt | 0 .../{base => cli}/docs/commands/reset.txt | 0 .../repl/{base => cli}/docs/commands/save.txt | 0 .../docs/commands/save_start.txt | 0 .../{base => cli}/docs/commands/save_stop.txt | 0 .../{base => cli}/docs/commands/tutorial.txt | 0 .../{base => cli}/docs/commands/user_doc.txt | 0 .../repl/{base => cli}/docs/commands/vars.txt | 0 .../docs/commands/vars_workspace.txt | 0 .../{base => cli}/docs/commands/workspace.txt | 0 .../docs/commands/workspaces.txt | 0 .../repl/{base => cli}/lib/alias_to_string.js | 0 .../@stdlib/repl/cli/lib/commands.js | 74 +++++ .../{base => cli}/lib/commands/__done__.js | 0 .../{base => cli}/lib/commands/alias2pkg.js | 0 .../lib/commands/alias2related.js | 0 .../repl/{base => cli}/lib/commands/ans.js | 0 .../{base => cli}/lib/commands/assignfrom.js | 0 .../{base => cli}/lib/commands/assignin.js | 0 .../{base => cli}/lib/commands/citation.js | 0 .../lib/commands/clear_history.js | 0 .../lib/commands/clear_user_docs.js | 0 .../{base => cli}/lib/commands/clear_vars.js | 0 .../lib/commands/clear_workspace.js | 0 .../{base => cli}/lib/commands/contributor.js | 0 .../{base => cli}/lib/commands/copyright.js | 0 .../{base => cli}/lib/commands/credits.js | 0 .../lib/commands/current_workspace.js | 0 .../lib/commands/deeprerequire.js | 0 .../lib/commands/delete_workspace.js | 0 .../repl/{base => cli}/lib/commands/donate.js | 0 .../repl/{base => cli}/lib/commands/evalin.js | 0 .../{base => cli}/lib/commands/example.js | 2 +- .../repl/{base => cli}/lib/commands/help.js | 0 .../repl/{base => cli}/lib/commands/info.js | 0 .../{base => cli}/lib/commands/is_keyword.js | 0 .../lib/commands/is_workspace.js | 0 .../lib/commands/license_text.js | 0 .../repl/{base => cli}/lib/commands/load.js | 0 .../lib/commands/load_workspace.js | 0 .../repl/{base => cli}/lib/commands/quit.js | 0 .../lib/commands/rename_workspace.js | 0 .../{base => cli}/lib/commands/rerequire.js | 0 .../repl/{base => cli}/lib/commands/reset.js | 0 .../{base => cli}/lib/commands/tutorial.js | 0 .../{base => cli}/lib/commands/user_doc.js | 0 .../repl/{base => cli}/lib/commands/vars.js | 0 .../lib/commands/vars_workspace.js | 0 .../{base => cli}/lib/commands/workspace.js | 0 .../{base => cli}/lib/commands/workspaces.js | 0 .../@stdlib/repl/cli/lib/contains.js | 60 ++++ .../{base => cli}/lib/find_unique_entry.js | 0 .../repl/{base => cli}/lib/index_of.js | 0 lib/node_modules/@stdlib/repl/cli/lib/main.js | 98 ++++++- .../repl/{base => cli}/lib/repl_docs.js | 0 .../repl/cli/lib/restore_regexp_matches.js | 48 ++++ .../lib/update_regexp_cache.js} | 29 +- .../repl/{base => cli}/scripts/build.js | 0 .../scripts/build_contributors.js | 0 .../repl/{base => cli}/scripts/build_help.js | 0 .../{base => cli}/scripts/build_license.js | 0 .../{base => cli}/scripts/build_tutorials.js | 0 .../cli/test/integration/test.auto_page.js | 2 +- .../integration/test.completion_previews.js | 8 +- 128 files changed, 710 insertions(+), 1035 deletions(-) create mode 100644 lib/node_modules/@stdlib/repl/base/README.md create mode 100644 lib/node_modules/@stdlib/repl/base/benchmark/benchmark.js rename lib/node_modules/@stdlib/repl/base/{lib/log.js => examples/index.js} (57%) delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/commands.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/complete_tutorial.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/regexp_tutorial.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/set_commands.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/set_commands_global.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/settings.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/settings_validators.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/tutorial_aliases.js delete mode 100644 lib/node_modules/@stdlib/repl/base/lib/validate_settings.js rename lib/node_modules/@stdlib/repl/base/{lib/settings_names.js => test/test.js} (64%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/contributor.json (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/example.csv (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/example.json (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/help.csv (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/help.json (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/info.csv (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/info.json (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/license_text.json (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/tutorial.csv (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/data/tutorial.json (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/__done__.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/_require.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/alias2pkg.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/alias2related.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/ans.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/assignfrom.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/assignin.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/citation.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/clear_history.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/clear_user_docs.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/clear_vars.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/clear_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/contributor.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/copyright.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/credits.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/current_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/deeprerequire.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/delete_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/donate.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/evalin.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/example.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/global.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/help.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/info.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/is_keyword.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/is_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/license_text.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/load.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/load_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/log_start.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/log_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/quit.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/rename_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/rerequire.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/rerun.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/reset.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/save.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/save_start.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/save_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/tutorial.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/user_doc.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/vars.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/vars_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/docs/commands/workspaces.txt (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/alias_to_string.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/__done__.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/alias2pkg.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/alias2related.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/ans.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/assignfrom.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/assignin.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/citation.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/clear_history.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/clear_user_docs.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/clear_vars.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/clear_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/contributor.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/copyright.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/credits.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/current_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/deeprerequire.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/delete_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/donate.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/evalin.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/example.js (98%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/help.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/info.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/is_keyword.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/is_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/license_text.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/load.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/load_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/quit.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/rename_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/rerequire.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/reset.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/tutorial.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/user_doc.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/vars.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/vars_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/workspace.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/commands/workspaces.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/contains.js rename lib/node_modules/@stdlib/repl/{base => cli}/lib/find_unique_entry.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/index_of.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/lib/repl_docs.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/cli/lib/restore_regexp_matches.js rename lib/node_modules/@stdlib/repl/{base/lib/tutorial_alias_args.js => cli/lib/update_regexp_cache.js} (51%) rename lib/node_modules/@stdlib/repl/{base => cli}/scripts/build.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/scripts/build_contributors.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/scripts/build_help.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/scripts/build_license.js (100%) rename lib/node_modules/@stdlib/repl/{base => cli}/scripts/build_tutorials.js (100%) diff --git a/lib/node_modules/@stdlib/repl/base/README.md b/lib/node_modules/@stdlib/repl/base/README.md new file mode 100644 index 000000000000..0e9742584878 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/README.md @@ -0,0 +1,271 @@ + + +# REPL + +> Base class for Read-Eval-Print Loop (REPL) environment. + + + +
+ +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. + +
+ + + + + +
+ +## Usage + +```javascript +var REPL = require( '@stdlib/repl/base' ); +``` + +#### 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(); +``` + +* * * + +
+ + + + + +
+ +
+ + + + + +* * * + +
+ +## Examples + + + +```javascript +var REPL = require( '@stdlib/repl/base' ); + +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.' ); +``` + +
+ + + +* * * + +
+ +
+ + + + + +
+ +
+ + + + + +
+ +
+ + + + + +
+ +[@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 + +
+ + diff --git a/lib/node_modules/@stdlib/repl/base/benchmark/benchmark.js b/lib/node_modules/@stdlib/repl/base/benchmark/benchmark.js new file mode 100644 index 000000000000..4b0a69062900 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/benchmark/benchmark.js @@ -0,0 +1,95 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 inspectSinkStream = require( '@stdlib/streams/node/inspect-sink' ); +var randu = require( '@stdlib/random/streams/randu' ); +var noop = require( '@stdlib/utils/noop' ); +var pkg = require( './../package.json' ).name; +var REPL = require( './../lib' ); + + +// MAIN // + +bench( pkg+'::new', function benchmark( b ) { + var sopts; + var opts; + var r; + var i; + + opts = { + 'output': inspectSinkStream( noop ), + 'error': inspectSinkStream( noop ) + }; + sopts = { + 'iter': 1 + }; + + b.tic(); + for ( i = 0; i < b.iterations; i++ ) { + opts.input = randu( sopts ); // Note: this is slow, but should not be rate-limiting + r = new REPL( opts ); + if ( typeof r !== 'object' ) { + b.fail( 'should return an object' ); + } + r.close(); + } + b.toc(); + if ( !( r instanceof REPL ) ) { + b.fail( 'should return an instance' ); + } + b.pass( 'benchmark finished' ); + b.end(); +}); + +bench( pkg+'::no_new', function benchmark( b ) { + var sopts; + var repl; + var opts; + var r; + var i; + + repl = REPL; + opts = { + 'output': inspectSinkStream( noop ), + 'error': inspectSinkStream( noop ) + }; + sopts = { + 'iter': 1 + }; + + b.tic(); + for ( i = 0; i < b.iterations; i++ ) { + opts.input = randu( sopts ); // Note: this is slow, but should not be rate-limiting + r = repl( opts ); + if ( typeof r !== 'object' ) { + b.fail( 'should return an object' ); + } + r.close(); + } + b.toc(); + if ( !( r instanceof REPL ) ) { + b.fail( 'should return an instance' ); + } + b.pass( 'benchmark finished' ); + b.end(); +}); diff --git a/lib/node_modules/@stdlib/repl/base/lib/log.js b/lib/node_modules/@stdlib/repl/base/examples/index.js similarity index 57% rename from lib/node_modules/@stdlib/repl/base/lib/log.js rename to lib/node_modules/@stdlib/repl/base/examples/index.js index 1ae2f532f99b..19ad97ab2eac 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/log.js +++ b/lib/node_modules/@stdlib/repl/base/examples/index.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* 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. @@ -16,30 +16,21 @@ * limitations under the License. */ -/* eslint-disable no-underscore-dangle */ - 'use strict'; -// MAIN // +var REPL = require( './../lib' ); -/** -* Writes a message to the REPL output stream. -* -* ## Notes -* -* - Automatically appends a newline character to a provide message. -* -* @private -* @param {REPL} repl - REPL instance -* @param {string} msg - message -*/ -function log( repl, msg ) { - if ( repl._quiet === false ) { - repl._ostream.write( msg+'\n' ); - } +function onCommand( cmd, success, res ) { + console.log( cmd + ' = ' + res.toString() ); } +// Create a new REPL: +var repl = new REPL(); +repl.on( 'command', onCommand ); -// EXPORTS // +// Execute a command: +repl.emit( 'input', '3 + 2' ); -module.exports = log; +// Close the REPL: +repl.close(); +console.log( 'REPL closed.' ); diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands.js b/lib/node_modules/@stdlib/repl/base/lib/commands.js deleted file mode 100644 index 252afaf8d3d6..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/commands.js +++ /dev/null @@ -1,130 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 onAlias2Pkg = require( './commands/alias2pkg.js' ); -var onAlias2Related = require( './commands/alias2related.js' ); -var onAns = require( './commands/ans.js' ); -var onAssignin = require( './commands/assignin.js' ); -var onAssignfrom = require( './commands/assignfrom.js' ); -var onCitation = require( './commands/citation.js' ); -var onClearHistory = require( './commands/clear_history.js' ); -var onClearUserDocs = require( './commands/clear_user_docs.js' ); -var onClearVars = require( './commands/clear_vars.js' ); -var onClearWorkspace = require( './commands/clear_workspace.js' ); -var onContributors = require( './commands/contributor.js' ); -var onCopyright = require( './commands/copyright.js' ); -var onCredits = require( './commands/credits.js' ); -var onCurrentWorkspace = require( './commands/current_workspace.js' ); -var onDeleteWorkspace = require( './commands/delete_workspace.js' ); -var onDeeprerequire = require( './commands/deeprerequire.js' ); -var onDonate = require( './commands/donate.js' ); -var onDone = require( './commands/__done__.js' ); -var onEvalin = require( './commands/evalin.js' ); -var onExample = require( './commands/example.js' ); -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 onLicense = require( './commands/license_text.js' ); -var onLoad = require( './commands/load.js' ); -var onLoadWorkspace = require( './commands/load_workspace.js' ); -var onQuit = require( './commands/quit.js' ); -var onRenameWorkspace = require( './commands/rename_workspace.js' ); -var onRerequire = require( './commands/rerequire.js' ); -var onReset = require( './commands/reset.js' ); -var onTutorial = require( './commands/tutorial.js' ); -var onUserDoc = require( './commands/user_doc.js' ); -var onVars = require( './commands/vars.js' ); -var onVarsWorkspace = require( './commands/vars_workspace.js' ); -var onWorkspace = require( './commands/workspace.js' ); -var onWorkspaces = require( './commands/workspaces.js' ); - - -// MAIN // - -/** -* Returns a list of REPL-specific commands. -* -* ## Notes -* -* - Each array element is comprised as follows: -* -* ```text -* [ , , ] -* ``` -* -* where the first element is the command alias, the second element the command callback, and the third element a boolean indicating whether the callback is an accessor (getter; i.e., the command refers to a property rather than a function to be explicitly invoked). -* -* @private -* @param {REPL} repl - REPL instance -* @returns {ArrayArray} commands -*/ -function commands( repl ) { - var cmds; - - // Define a list of REPL-specific commands (NOTE: keep in alphabetical order): - cmds = []; - cmds.push( [ '__done__', onDone( repl ), false ] ); - cmds.push( [ 'alias2pkg', onAlias2Pkg( repl ), false ] ); - cmds.push( [ 'alias2related', onAlias2Related( repl, cmds ), false ] ); - cmds.push( [ 'ans', onAns( repl ), true ] ); - cmds.push( [ 'assignfrom', onAssignfrom( repl ), false ] ); - cmds.push( [ 'assignin', onAssignin( repl ), false ] ); - cmds.push( [ 'citation', onCitation( repl ), false ] ); - cmds.push( [ 'clearHistory', onClearHistory( repl ), false ] ); - cmds.push( [ 'clearUserDocs', onClearUserDocs( repl ), false ] ); - cmds.push( [ 'clearVars', onClearVars( repl ), false ] ); - cmds.push( [ 'clearWorkspace', onClearWorkspace( repl ), false ] ); - cmds.push( [ 'contributors', onContributors( repl ), false ] ); - cmds.push( [ 'copyright', onCopyright( repl ), false ] ); - cmds.push( [ 'credits', onCredits( repl ), false ] ); - cmds.push( [ 'currentWorkspace', onCurrentWorkspace( repl ), true ] ); - cmds.push( [ 'deleteWorkspace', onDeleteWorkspace( repl ), false ] ); - cmds.push( [ 'deeprerequire', onDeeprerequire( repl ), false ] ); - cmds.push( [ 'donate', onDonate( repl ), false ] ); - cmds.push( [ 'evalin', onEvalin( repl, cmds ), false ] ); - cmds.push( [ 'example', onExample( repl, cmds ), false ] ); - cmds.push( [ 'help', onHelp( repl, cmds ), false ] ); - cmds.push( [ 'info', onInfo( repl, cmds ), false ] ); - cmds.push( [ 'isKeyword', isKeyword( repl ), false ] ); - cmds.push( [ 'isWorkspace', isWorkspace( repl ), false ] ); - cmds.push( [ 'license', onLicense( repl ), false ] ); - cmds.push( [ 'load', onLoad( repl ), false ] ); - cmds.push( [ 'loadWorkspace', onLoadWorkspace( repl ), false ] ); - cmds.push( [ 'quit', onQuit( repl ), false ] ); - cmds.push( [ 'renameWorkspace', onRenameWorkspace( repl ), false ] ); - cmds.push( [ 'rerequire', onRerequire( repl ), false ] ); - cmds.push( [ 'reset', onReset( repl ), false ] ); - cmds.push( [ 'tutorial', onTutorial( repl ), false ] ); - cmds.push( [ 'userDoc', onUserDoc( repl ), false ] ); - cmds.push( [ 'vars', onVars( repl ), false ] ); - cmds.push( [ 'varsWorkspace', onVarsWorkspace( repl ), false ] ); - cmds.push( [ 'workspace', onWorkspace( repl ), false ] ); - cmds.push( [ 'workspaces', onWorkspaces( repl ), false ] ); - - return cmds; -} - - -// EXPORTS // - -module.exports = commands; diff --git a/lib/node_modules/@stdlib/repl/base/lib/complete_tutorial.js b/lib/node_modules/@stdlib/repl/base/lib/complete_tutorial.js deleted file mode 100644 index d66e1be6ca39..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/complete_tutorial.js +++ /dev/null @@ -1,93 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 logger = require( 'debug' ); -var parse = require( 'acorn-loose' ).parse; -var startsWith = require( '@stdlib/string/starts-with' ); -var objectKeys = require( '@stdlib/utils/keys' ); -var tutorialAliasArgs = require( './tutorial_alias_args.js' ); -var TUTORIALS = require( './repl_docs.js' ).tutorial; - - -// VARIABLES // - -var debug = logger( 'repl:completer:tutorial' ); -var TUTS = objectKeys( TUTORIALS ); -var AOPTS = { - 'ecmaVersion': 'latest' -}; - - -// MAIN // - -/** -* Completes a tutorial API expression. -* -* @private -* @param {Array} out - output array for storing completions -* @param {REPL} repl - REPL instance -* @param {string} expression - expression to complete -* @param {string} alias - tutorial API alias -* @param {string} value - value to complete -* @returns {string} value filter -*/ -function complete( out, repl, expression, alias, value ) { - var args; - var ast; - var arg; - var t; - var i; - - // Get the list of argument types for the desired API: - debug( 'Tutorial API: %s', alias ); - args = tutorialAliasArgs( alias ); - - // Parse the expression into an AST: - debug( 'Expression: %s', expression ); - ast = parse( expression, AOPTS ); - - // Check whether the argument which triggered TAB completion has a corresponding argument type which is completable: - debug( 'Checking if argument is completable...' ); - arg = args[ ast.body[ 0 ].expression.arguments.length-1 ]; - if ( !arg ) { - debug( 'Argument which triggered TAB completion is not completable.' ); - return ''; - } - debug( 'Argument is completable.' ); - - debug( 'Searching for completion candidates...' ); - for ( i = 0; i < TUTS.length; i++ ) { - t = TUTS[ i ]; - if ( startsWith( t, value ) ) { - debug( 'Found a completion: %s', t ); - out.push( t ); - } else { - debug( '%s does not match filter %s. Skipping...', t, value ); - } - } - return value; -} - - -// EXPORTS // - -module.exports = complete; diff --git a/lib/node_modules/@stdlib/repl/base/lib/completer.js b/lib/node_modules/@stdlib/repl/base/lib/completer.js index d859c4a6a92c..2688055ee4a9 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/completer.js +++ b/lib/node_modules/@stdlib/repl/base/lib/completer.js @@ -28,12 +28,10 @@ var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var fsRegExp = require( './regexp_fs_aliases.js' ); var requireRegExp = require( './regexp_require.js' ); var workspaceRegExp = require( './regexp_workspace.js' ); -var tutorialRegExp = require( './regexp_tutorial.js' ); var reservedCharsRegExp = require( './regexp_reserved_syntax_characters.js' ); var completeRequire = require( './complete_require.js' ); var completeFS = require( './complete_fs.js' ); var completeWorkspace = require( './complete_workspace.js' ); -var completeTutorial = require( './complete_tutorial.js' ); var completeExpression = require( './complete_expression.js' ); @@ -148,21 +146,6 @@ function completer( repl ) { debug( 'Results: %s', res.join( ', ' ) ); return clbk( null, [ res, line ] ); } - // Test if the line has an incomplete tutorial expression: - match = line.match( tutorialRegExp() ); - if ( match ) { - debug( 'Detected incomplete tutorial expression.' ); - - debug( 'Expression: %s', match[ 0 ] ); - debug( 'Tutorial API: %s', match[ 1 ] ); - debug( 'Value to complete: %s', match[ 3 ] ); - line = completeTutorial( res, repl, match[ 0 ], match[ 1 ], match[ 3 ] ); // eslint-disable-line max-len - res = normalize( res ); - - debug( 'Completion filter: %s', line ); - debug( 'Results: %s', res.join( ', ' ) ); - return clbk( null, [ res, line ] ); - } // Sanity check that we are attempting to complete something which is completable: if ( reservedCharsRegExp().test( line[ repl._rli.cursor-1 ] ) ) { debug( 'Detected attempt to trigger completion after a special character.' ); diff --git a/lib/node_modules/@stdlib/repl/base/lib/defaults.js b/lib/node_modules/@stdlib/repl/base/lib/defaults.js index 02b42792e96b..bb9686d6114c 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/defaults.js +++ b/lib/node_modules/@stdlib/repl/base/lib/defaults.js @@ -57,9 +57,6 @@ function defaults() { // File path specifying where to save REPL command history: 'save': '', - // File path specifying a JavaScript file to load and evaluate line-by-line (e.g., a previous REPL history file): - 'load': '', - // File path specifying where to save REPL commands and printed output: 'log': '', diff --git a/lib/node_modules/@stdlib/repl/base/lib/index.js b/lib/node_modules/@stdlib/repl/base/lib/index.js index 80fec5e90aaf..a19109130546 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/index.js +++ b/lib/node_modules/@stdlib/repl/base/lib/index.js @@ -19,23 +19,20 @@ 'use strict'; /** -* REPL. +* Base class for REPL. * * @module @stdlib/repl/base * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); * var REPL = require( '@stdlib/repl/base' ); * -* function onExit() { -* console.log( 'REPL closed.' ); -* } -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); -* repl.on( 'exit', onExit ); +* var repl = new REPL(); +* +* // ... +* +* // Execute a command: +* repl.emit( 'input', '2 + 3' ); * * // ... * diff --git a/lib/node_modules/@stdlib/repl/base/lib/main.js b/lib/node_modules/@stdlib/repl/base/lib/main.js index 4816c427590c..345598f25bb4 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/lib/main.js @@ -23,30 +23,20 @@ // MODULES // var EventEmitter = require( 'events' ).EventEmitter; -var resolve = require( 'path' ).resolve; var logger = require( 'debug' ); var inherit = require( '@stdlib/utils/inherit' ); -var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var isFunction = require( '@stdlib/assert/is-function' ); var isConfigurableProperty = require( '@stdlib/assert/is-configurable-property' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); -var format = require( '@stdlib/string/format' ); -var cwd = require( '@stdlib/process/cwd' ); -var readFileSync = require( '@stdlib/fs/read-file' ).sync; -var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; var fifo = require( '@stdlib/utils/fifo' ); var nextTick = require( '@stdlib/utils/next-tick' ); var validate = require( './validate.js' ); var defaults = require( './defaults.js' ); var setAliases = require( './set_aliases.js' ); var setAliasesGlobal = require( './set_aliases_global.js' ); -var setCommands = require( './set_commands.js' ); -var setCommandsGlobal = require( './set_commands_global.js' ); var createEvalContext = require( './create_evaluation_context.js' ); -var commands = require( './commands.js' ); var completerFactory = require( './completer.js' ); var tokenizer = require( './tokenizer.js' ); var processCommand = require( './process_command.js' ); @@ -64,7 +54,7 @@ var debug = logger( 'repl' ); // MAIN // /** -* REPL base constructor. +* REPL constructor. * * @constructor * @param {Options} options - constructor options @@ -73,7 +63,6 @@ var debug = logger( 'repl' ); * @param {WritableStream} [options.error=process.stderr] - error stream * @param {boolean} [options.sandbox=true] - boolean indicating whether to run a REPL in a sandboxed context * @param {PositiveInteger} [options.timeout=4294967295] - number of milliseconds to execute a command before terminating execution -* @param {string} [options.load] - file path specifying a JavaScript file to load and evaluate line-by-line (e.g., a previous REPL history file) * @param {string} [options.save] - file path specifying where to save REPL command history * @param {string} [options.log] - file path specifying where to save REPL commands and printed output * @param {string} [options.quiet=false] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced @@ -81,17 +70,15 @@ var debug = logger( 'repl' ); * @returns {REPL} REPL instance * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* -* function onExit() { -* console.log( 'REPL closed.' ); -* } +* var REPL = require( '@stdlib/repl/base' ); * * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); -* repl.on( 'exit', onExit ); +* var repl = new REPL(); +* +* // ... +* +* // Execute a command: +* repl.emit( 'input', '2 + 3' ); * * // ... * @@ -126,7 +113,6 @@ function REPL( options ) { 'timeout': opts.timeout, 'isTTY': opts.isTTY, 'padding': opts.padding, - 'load': opts.load, 'save': opts.save, 'log': opts.log, 'quiet': opts.quiet @@ -218,12 +204,7 @@ function REPL( options ) { // TODO: check whether to synchronously initialize a REPL log file - // Check whether to load and execute a JavaScript file (e.g., prior REPL history) upon startup... - if ( opts.load ) { - this.load( opts.load ); - } else { - this._count += 1; - } + this._count += 1; return this; /** @@ -330,12 +311,8 @@ setNonEnumerableReadOnly( REPL.prototype, '_compileCommand', compileCommand ); * @returns {Object} REPL context * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); +* var repl = new REPL(); * * // Return a new REPL context: * var ctx = repl.createContext(); @@ -345,7 +322,6 @@ setNonEnumerableReadOnly( REPL.prototype, '_compileCommand', compileCommand ); */ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContext() { var context; - var cmds; debug( 'Creating REPL execution context...' ); @@ -359,16 +335,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex setAliasesGlobal( this._globalVars, this._aliases, context, ALIAS_OVERRIDES ); // eslint-disable-line max-len } - // Get the list of REPL-specific commands: - cmds = commands( this ); - - // Add commands requiring privileged access to internal instance variables... - if ( this._sandbox ) { - setCommands( context, cmds ); - } else { - setCommandsGlobal( this._globalVars, context, cmds ); - } - return context; }); @@ -381,12 +347,8 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex * @returns {REPL} REPL instance * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); +* var repl = new REPL(); * * // ... * @@ -457,12 +419,8 @@ setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext( * @returns {REPL} REPL instance * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); +* var repl = new REPL(); * * // ... * @@ -489,12 +447,8 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory( * @returns {REPL} REPL instance * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); +* var repl = new REPL(); * * // ... * @@ -512,80 +466,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearUserDocs', function clearUserDoc return this; }); -/** -* Loads and evaluates a JavaScript file line-by-line. -* -* @name load -* @memberof REPL.prototype -* @type {Function} -* @param {string} fpath - file path -* @param {Function} clbk - callback -* @throws {Error} cannot load a file into a closed REPL -* @throws {TypeError} first argument must be a string -* @throws {TypeError} second argument must be a function -* @returns {void} -* -* @example -* // TODO -*/ -setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { - var self; - var file; - var len; - var i; - if ( this._closed ) { - throw new Error( 'invalid operation. Cannot load a file into a REPL which has already closed.' ); - } - if ( !isString( fpath ) ) { - throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', fpath ) ); - } - if ( !isFunction( clbk ) ) { - throw new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) ); - } - // Resolve the provided path to an absolute file path: - fpath = resolve( cwd(), fpath ); - debug( 'Loading filepath: %s', fpath ); - - // Attempt to synchronously read the file: - file = readFileSync( fpath, 'utf8' ); - if ( file instanceof Error ) { - debug( 'Error: %s', file.message ); - clbk( file ); - return; - } - self = this; - - // Split the file content into individual lines: - file = file.split( RE_EOL ); - - // Forward each line to the REPL readline interface in order to mimic user input... - len = file.length; - i = -1; - - nextTick( next ); - - /** - * Callback invoked after draining the command queue. - * - * @private - * @param {string} cmd - command - * @param {boolean} success - boolean indicating whether the command successfully executed - */ - function next() { - i += 1; - if ( i < len ) { - if ( file[ i ] ) { - self._rli.write( file[ i ]+'\n' ); - self.once( 'drain', next ); - } else { - nextTick( next ); - } - } else { - nextTick( clbk ); - } - } -}); - /** * Resets a REPL. * @@ -596,12 +476,8 @@ setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { * @returns {REPL} REPL instance * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); +* var repl = new REPL(); * * // ... * @@ -640,12 +516,8 @@ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { * @returns {REPL} REPL instance * * @example -* var debug = require( '@stdlib/streams/node/debug-sink' ); -* * // Create a new REPL: -* var repl = new REPL({ -* 'output': debug() -* }); +* var repl = new REPL(); * * // ... * diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_tutorial.js b/lib/node_modules/@stdlib/repl/base/lib/regexp_tutorial.js deleted file mode 100644 index 280554a6fe25..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/regexp_tutorial.js +++ /dev/null @@ -1,106 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 TUTORIAL_ALIASES = require( './tutorial_aliases.js' ); - - -// MAIN // - -/** -* Returns a regular expression for matching tutorial APIs. -* -* ## Notes -* -* - Example output: -* -* ```text -* /\b(?:(tutorial)\s*\(\s*(.*,\s*)*(?:\[\s*(?:[^\]]*,\s*)*)?['"]([^'"]*))$/ -* ``` -* -* @private -* @returns {RegExp} regular expression -*/ -function createRegExp() { - var re; - var N; - var M; - var i; - - N = TUTORIAL_ALIASES.length; - M = N - 1; - re = ''; - - // Match a word boundary: - re += '\\b'; - - // Create a capture group for detecting an alias with an incomplete invocation (e.g., `tutorial( 'foo`): - re += '(?:'; - - // Create a capture group for matching the alias... - re += '('; - for ( i = 0; i < N; i++ ) { - // Append the alias: - re += TUTORIAL_ALIASES[ i ][ 0 ]; - - // Separate aliases with an OR separator: - if ( i < M ) { - re += '|'; - } - } - // Close the alias capture group: - re += ')'; - - // Match zero or more whitespace characters after the alias: - re += '\\s*'; - - // Match an opening parenthesis literal: - re += '\\('; - - // Match zero or more whitespace characters after the opening parenthesis: - re += '\\s*'; - - // Capture provided (comma-separated) arguments which precede the last argument: - re += '(.*,\\s*)*'; - - // Capture, but don't remember, an incomplete array argument (including all items except for the last) which occurs zero or one time: - re += '(?:\\[\\s*(?:[^\\]]*,\\s*)*)?'; - - // Match either a `'` or `"` literal: - re += '[\'"]'; - - // Capture the last (incomplete) argument (or array item): - re += '([^\'"]*)'; - - // Close the incomplete invocation capture group: - re += ')'; - - // Match the end of input (i.e., ensure that the match is an incomplete invocation): - re += '$'; - - // Return the regular expression: - return new RegExp( re ); -} - - -// EXPORTS // - -module.exports = createRegExp; diff --git a/lib/node_modules/@stdlib/repl/base/lib/set_commands.js b/lib/node_modules/@stdlib/repl/base/lib/set_commands.js deleted file mode 100644 index c35a6736d8d4..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/set_commands.js +++ /dev/null @@ -1,64 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 logger = require( 'debug' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); -var setReadOnlyAccessor = require( '@stdlib/utils/define-read-only-accessor' ); - - -// VARIABLES // - -var debug = logger( 'repl:set_commands' ); - - -// MAIN // - -/** -* Sets commands on a sandboxed `context` object. -* -* @private -* @param {Object} context - context object -* @param {ArrayArray} commands - commands -* @returns {Object} context object -*/ -function setCommands( context, commands ) { - var cmd; - var i; - - for ( i = 0; i < commands.length; i++ ) { - cmd = commands[ i ]; - if ( hasOwnProp( context, cmd[ 0 ] ) ) { - debug( 'Skipping command as global context property `'+cmd[0]+'` is already assigned.' ); - } else if ( cmd[ 2 ] ) { - setReadOnlyAccessor( context, cmd[ 0 ], cmd[ 1 ] ); - } else { - setReadOnly( context, cmd[ 0 ], cmd[ 1 ] ); - } - } - return context; -} - - -// EXPORTS // - -module.exports = setCommands; diff --git a/lib/node_modules/@stdlib/repl/base/lib/set_commands_global.js b/lib/node_modules/@stdlib/repl/base/lib/set_commands_global.js deleted file mode 100644 index 3f3c7b36ce60..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/set_commands_global.js +++ /dev/null @@ -1,72 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 logger = require( 'debug' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var setConfigurableReadOnly = require( '@stdlib/utils/define-configurable-read-only-property' ); -var setConfigurableReadOnlyAccessor = require( '@stdlib/utils/define-configurable-read-only-accessor' ); // eslint-disable-line id-length - - -// VARIABLES // - -var debug = logger( 'repl:set_commands_global' ); - - -// MAIN // - -/** -* Sets commands on non-sandboxed `context` object. -* -* ## Notes -* -* - This function avoids overwriting properties in a non-sandboxed environment in order to avoid unintended side-effects. -* -* @private -* @param {Array} out - output array for storing a list of global variables added to the global namespace -* @param {Object} context - context object -* @param {ArrayArray} commands - commands -* @returns {Object} context object -*/ -function setCommandsGlobal( out, context, commands ) { - var cmd; - var i; - - for ( i = 0; i < commands.length; i++ ) { - cmd = commands[ i ]; - if ( hasOwnProp( context, cmd[ 0 ] ) ) { - debug( 'Skipping command as global context property `'+cmd[0]+'` is already assigned.' ); - } else { - out.push( cmd[ 0 ] ); - if ( cmd[ 2 ] ) { - setConfigurableReadOnlyAccessor( context, cmd[ 0 ], cmd[ 1 ] ); - } else { - setConfigurableReadOnly( context, cmd[ 0 ], cmd[ 1 ] ); - } - } - } - return context; -} - - -// EXPORTS // - -module.exports = setCommandsGlobal; diff --git a/lib/node_modules/@stdlib/repl/base/lib/settings.js b/lib/node_modules/@stdlib/repl/base/lib/settings.js deleted file mode 100644 index 53a38eaffc00..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/settings.js +++ /dev/null @@ -1,68 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2024 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 // - -/** -* REPL settings. -* -* @private -* @name SETTINGS -* @type {Object} -*/ -var SETTINGS = { - 'autoClosePairs': { - 'desc': 'Automatically insert matching brackets, parentheses, and quotes.', - 'type': 'boolean' - }, - 'autoDeletePairs': { - 'desc': 'Automatically delete adjacent matching brackets, parentheses, and quotes.', - 'type': 'boolean' - }, - 'autoPage': { - 'desc': 'Automatically page return values whose display size exceeds the visible screen.', - 'type': 'boolean' - }, - 'bracketedPaste': { - 'desc': 'Enable bracketed-paste mode.', - 'type': 'boolean' - }, - 'completionPreviews': { - 'desc': 'Enable the display of completion previews for auto-completion.', - 'type': 'boolean' - }, - 'autoDisableBracketedPasteOnExit': { - 'desc': 'Automatically disable bracketed-paste upon exiting the REPL.', - 'type': 'boolean' - }, - 'syntaxHighlighting': { - 'desc': 'Enable syntax highlighting.', - 'type': 'boolean' - }, - 'theme': { - 'desc': 'Set the syntax highlighting theme.', - 'type': 'string' - } -}; - - -// EXPORTS // - -module.exports = SETTINGS; diff --git a/lib/node_modules/@stdlib/repl/base/lib/settings_validators.js b/lib/node_modules/@stdlib/repl/base/lib/settings_validators.js deleted file mode 100644 index 345b07acaa48..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/settings_validators.js +++ /dev/null @@ -1,112 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2024 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 isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; -var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var isNumber = require( '@stdlib/assert/is-number' ).isPrimitive; -var isInteger = require( '@stdlib/assert/is-integer' ).isPrimitive; -var format = require( '@stdlib/string/format' ); - - -// FUNCTIONS // - -/** -* Returns a formatted error message for a value is not a boolean. -* -* @private -* @param {string} name - setting name -* @param {*} value - invalid value -* @returns {string} formatted error message -*/ -function booleanErrMsg( name, value ) { - return format( 'invalid argument. `%s` setting must be a boolean. Value: `%s`.', name, value ); -} - -/** -* Returns a formatted error message for a value is not an integer. -* -* @private -* @param {string} name - setting name -* @param {*} value - invalid value -* @returns {string} formatted error message -*/ -function integerErrMsg( name, value ) { - return format( 'invalid argument. `%s` setting must be an integer. Value: `%s`.', name, value ); -} - -/** -* Returns a formatted error message for a value is not a number. -* -* @private -* @param {string} name - setting name -* @param {*} value - invalid value -* @returns {string} formatted error message -*/ -function numberErrMsg( name, value ) { - return format( 'invalid argument. `%s` setting must be a number. Value: `%s`.', name, value ); -} - -/** -* Returns a formatted error message for a value is not a string. -* -* @private -* @param {string} name - setting name -* @param {*} value - invalid value -* @returns {string} formatted error message -*/ -function stringErrMsg( name, value ) { - return format( 'invalid argument. `%s` setting must be a string. Value: `%s`.', name, value ); -} - - -// MAIN // - -/** -* Mapping from data types to validation functions. -* -* @private -* @name VALIDATORS -* @type {Object} -*/ -var VALIDATORS = { // eslint-disable-line vars-on-top - 'boolean': { - 'assert': isBoolean, - 'msg': booleanErrMsg - }, - 'integer': { - 'assert': isInteger, - 'msg': integerErrMsg - }, - 'number': { - 'assert': isNumber, - 'msg': numberErrMsg - }, - 'string': { - 'assert': isString, - 'msg': stringErrMsg - } -}; - - -// EXPORTS // - -module.exports = VALIDATORS; diff --git a/lib/node_modules/@stdlib/repl/base/lib/tutorial_aliases.js b/lib/node_modules/@stdlib/repl/base/lib/tutorial_aliases.js deleted file mode 100644 index 4ce3ee14a9f4..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/tutorial_aliases.js +++ /dev/null @@ -1,46 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 tutorial API aliases and corresponding argument completion compatibility. -* -* ## Notes -* -* - Each entry in the list has the following format: -* -* ``` -* [ , , ... ] -* ``` -* -* where `` is a tutorial API alias and `` is a `boolean` indicating whether an argument is compatible with tutorial name completion. -* -* - For the purposes of TAB completion, only those positional arguments which expect tutorial names need to be included. For example, if an API has three parameters and only the first argument expects a tutorial name, only that first argument needs to be included below; the remaining two arguments can be omitted, as those arguments are assumed to be incompatible with tutorial name completion. If an API has three parameters and only the second argument expects a tutorial name, only the first two arguments need to be included below, with the first argument documented as `null`; the remaining argument can be omitted. -*/ -var aliases = [ - // Note: keep in alphabetical order... - [ 'tutorial', true ] -]; - - -// EXPORTS // - -module.exports = aliases; diff --git a/lib/node_modules/@stdlib/repl/base/lib/validate.js b/lib/node_modules/@stdlib/repl/base/lib/validate.js index 98ee9d76a257..ab7ad4fc1453 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/validate.js +++ b/lib/node_modules/@stdlib/repl/base/lib/validate.js @@ -38,20 +38,14 @@ var format = require( '@stdlib/string/format' ); * @private * @param {Object} opts - destination object * @param {Options} options - function options -* @param {string} [options.inputPrompt] - input prompt -* @param {string} [options.outputPrompt] - output prompt -* @param {ReadableStream} [options.input=] - input stream -* @param {WritableStream} [options.output] - output stream -* @param {boolean} [options.sandbox] - boolean indicating whether to run a REPL in a sandboxed context -* @param {PositiveInteger} [options.timeout] - number of milliseconds to execute a command before terminating execution -* @param {boolean} [options.isTTY] - boolean indicating whether the input and output streams should be treated like a TTY (terminal) and whether the REPL should use ANSI/VT100 escape codes when writing to the output stream -* @param {string} [options.welcome] - welcome message -* @param {NonNegativeInteger} [options.padding] - number of empty lines between successive commands -* @param {string} [options.load] - file path specifying a JavaScript file to load and evaluate line-by-line (e.g., a previous REPL history file) +* @param {ReadableStream} [options.input=process.stdin] - input stream +* @param {WritableStream} [options.output=process.stdout] - output stream +* @param {WritableStream} [options.error=process.stderr] - error stream +* @param {boolean} [options.sandbox=true] - boolean indicating whether to run a REPL in a sandboxed context +* @param {PositiveInteger} [options.timeout=4294967295] - number of milliseconds to execute a command before terminating execution * @param {string} [options.save] - file path specifying where to save REPL command history * @param {string} [options.log] - file path specifying where to save REPL commands and printed output -* @param {string} [options.quiet] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced -* @param {Object} [options.settings] - REPL settings +* @param {string} [options.quiet=false] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced * @returns {(Error|null)} error or null * * @example @@ -92,12 +86,6 @@ function validate( opts, options ) { return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'save', options.save ) ); } } - if ( hasOwnProp( options, 'load' ) ) { - opts.load = options.load; - if ( !isString( options.load ) ) { - return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'load', options.load ) ); - } - } if ( hasOwnProp( options, 'log' ) ) { opts.log = options.log; if ( !isString( options.log ) ) { diff --git a/lib/node_modules/@stdlib/repl/base/lib/validate_settings.js b/lib/node_modules/@stdlib/repl/base/lib/validate_settings.js deleted file mode 100644 index 923f860f6026..000000000000 --- a/lib/node_modules/@stdlib/repl/base/lib/validate_settings.js +++ /dev/null @@ -1,78 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2024 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 isPlainObject = require( '@stdlib/assert/is-plain-object' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var format = require( '@stdlib/string/format' ); -var SETTINGS = require( './settings.js' ); -var SETTINGS_NAMES = require( './settings_names.js' ); -var VALIDATORS = require( './settings_validators.js' ); - - -// MAIN // - -/** -* Validates settings. -* -* @private -* @param {Object} opts - destination object -* @param {Object} options - settings options -* @returns {(Error|null)} error or null -* -* @example -* var options = { -* 'autoClosePairs': true -* }; -* var opts = {}; -* var err = validate( opts, options ); -* if ( err ) { -* throw err; -* } -*/ -function validate( opts, options ) { - var name; - var o; - var f; - var v; - var i; - if ( !isPlainObject( options ) ) { - return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) ); - } - for ( i = 0; i < SETTINGS_NAMES.length; i++ ) { - name = SETTINGS_NAMES[ i ]; - if ( hasOwnProp( options, name ) ) { - v = options[ name ]; - o = SETTINGS[ name ]; - f = VALIDATORS[ o.type ]; - if ( !f.assert( v ) ) { - return new TypeError( f.msg( name, v ) ); - } - opts[ name ] = v; - } - } - return null; -} - - -// EXPORTS // - -module.exports = validate; diff --git a/lib/node_modules/@stdlib/repl/base/package.json b/lib/node_modules/@stdlib/repl/base/package.json index 99f01f492489..f592b42aad09 100644 --- a/lib/node_modules/@stdlib/repl/base/package.json +++ b/lib/node_modules/@stdlib/repl/base/package.json @@ -13,21 +13,14 @@ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors" } ], - "bin": { - "stdlib-repl": "./bin/cli" - }, "main": "./lib", "browser": { - "./lib": "./lib/browser/index.js", "process": "process/" }, "directories": { "benchmark": "./benchmark", - "data": "./data", - "doc": "./docs", "example": "./examples", "lib": "./lib", - "scripts": "./scripts", "test": "./test" }, "scripts": {}, diff --git a/lib/node_modules/@stdlib/repl/base/lib/settings_names.js b/lib/node_modules/@stdlib/repl/base/test/test.js similarity index 64% rename from lib/node_modules/@stdlib/repl/base/lib/settings_names.js rename to lib/node_modules/@stdlib/repl/base/test/test.js index fb750e4b5663..f302074f6ef2 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/settings_names.js +++ b/lib/node_modules/@stdlib/repl/base/test/test.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2024 The Stdlib Authors. +* Copyright (c) 2019 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. @@ -20,22 +20,16 @@ // MODULES // -var objectKeys = require( '@stdlib/utils/keys' ); -var SETTINGS = require( './settings.js' ); +var tape = require( 'tape' ); +var repl = require( './../lib' ); -// MAIN // +// TESTS // -/** -* List of settings names. -* -* @private -* @name SETTINGS_NAMES -* @type {Array} -*/ -var SETTINGS_NAMES = objectKeys( SETTINGS ); - - -// EXPORTS // +tape( 'main export is a function', function test( t ) { + t.ok( true, __filename ); + t.strictEqual( typeof repl, 'function', 'main export is a function' ); + t.end(); +}); -module.exports = SETTINGS_NAMES; +// TODO: tests diff --git a/lib/node_modules/@stdlib/repl/cli/README.md b/lib/node_modules/@stdlib/repl/cli/README.md index 7647a61919fd..281c5a156919 100644 --- a/lib/node_modules/@stdlib/repl/cli/README.md +++ b/lib/node_modules/@stdlib/repl/cli/README.md @@ -43,7 +43,7 @@ The REPL environment exposed here is available both as a standalone application ## Usage ```javascript -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); ``` #### REPL( \[options] ) @@ -1504,7 +1504,7 @@ In [1]: workspaces( { 'details': true } ) ```javascript var join = require( 'path' ).join; -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); function onExit() { console.log( '' ); diff --git a/lib/node_modules/@stdlib/repl/base/data/contributor.json b/lib/node_modules/@stdlib/repl/cli/data/contributor.json similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/contributor.json rename to lib/node_modules/@stdlib/repl/cli/data/contributor.json diff --git a/lib/node_modules/@stdlib/repl/base/data/example.csv b/lib/node_modules/@stdlib/repl/cli/data/example.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/example.csv rename to lib/node_modules/@stdlib/repl/cli/data/example.csv diff --git a/lib/node_modules/@stdlib/repl/base/data/example.json b/lib/node_modules/@stdlib/repl/cli/data/example.json similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/example.json rename to lib/node_modules/@stdlib/repl/cli/data/example.json diff --git a/lib/node_modules/@stdlib/repl/base/data/help.csv b/lib/node_modules/@stdlib/repl/cli/data/help.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/help.csv rename to lib/node_modules/@stdlib/repl/cli/data/help.csv diff --git a/lib/node_modules/@stdlib/repl/base/data/help.json b/lib/node_modules/@stdlib/repl/cli/data/help.json similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/help.json rename to lib/node_modules/@stdlib/repl/cli/data/help.json diff --git a/lib/node_modules/@stdlib/repl/base/data/info.csv b/lib/node_modules/@stdlib/repl/cli/data/info.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/info.csv rename to lib/node_modules/@stdlib/repl/cli/data/info.csv diff --git a/lib/node_modules/@stdlib/repl/base/data/info.json b/lib/node_modules/@stdlib/repl/cli/data/info.json similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/info.json rename to lib/node_modules/@stdlib/repl/cli/data/info.json diff --git a/lib/node_modules/@stdlib/repl/base/data/license_text.json b/lib/node_modules/@stdlib/repl/cli/data/license_text.json similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/license_text.json rename to lib/node_modules/@stdlib/repl/cli/data/license_text.json diff --git a/lib/node_modules/@stdlib/repl/base/data/tutorial.csv b/lib/node_modules/@stdlib/repl/cli/data/tutorial.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/tutorial.csv rename to lib/node_modules/@stdlib/repl/cli/data/tutorial.csv diff --git a/lib/node_modules/@stdlib/repl/base/data/tutorial.json b/lib/node_modules/@stdlib/repl/cli/data/tutorial.json similarity index 100% rename from lib/node_modules/@stdlib/repl/base/data/tutorial.json rename to lib/node_modules/@stdlib/repl/cli/data/tutorial.json diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/__done__.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/__done__.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/__done__.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/__done__.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/_require.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/_require.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/_require.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/_require.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/alias2pkg.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/alias2pkg.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/alias2pkg.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/alias2pkg.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/alias2related.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/alias2related.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/alias2related.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/alias2related.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/ans.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/ans.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/ans.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/ans.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/assignfrom.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/assignfrom.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/assignfrom.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/assignfrom.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/assignin.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/assignin.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/assignin.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/assignin.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/citation.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/citation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/citation.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/citation.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/clear_history.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_history.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/clear_history.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/clear_history.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/clear_user_docs.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_user_docs.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/clear_user_docs.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/clear_user_docs.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/clear_vars.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_vars.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/clear_vars.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/clear_vars.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/clear_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/clear_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/clear_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/contributor.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/contributor.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/contributor.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/contributor.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/copyright.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/copyright.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/copyright.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/copyright.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/credits.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/credits.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/credits.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/credits.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/current_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/current_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/current_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/current_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/deeprerequire.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/deeprerequire.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/deeprerequire.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/deeprerequire.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/delete_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/delete_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/delete_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/delete_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/donate.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/donate.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/donate.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/donate.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/evalin.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/evalin.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/evalin.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/evalin.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/example.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/example.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/example.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/example.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/global.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/global.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/global.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/global.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/help.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/help.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/help.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/help.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/info.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/info.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/info.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/info.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/is_keyword.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/is_keyword.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/is_keyword.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/is_keyword.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/is_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/is_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/is_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/is_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/license_text.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/license_text.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/license_text.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/license_text.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/load.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/load.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/load.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/load.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/load_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/load_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/load_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/load_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/log_start.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/log_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/log_start.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/log_start.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/log_stop.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/log_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/log_stop.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/log_stop.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/quit.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/quit.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/quit.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/quit.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/rename_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/rename_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/rename_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/rename_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/rerequire.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/rerequire.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/rerequire.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/rerequire.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/rerun.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/rerun.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/rerun.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/rerun.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/reset.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/reset.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/reset.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/reset.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/save.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/save.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/save.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/save.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/save_start.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/save_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/save_start.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/save_start.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/save_stop.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/save_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/save_stop.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/save_stop.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/tutorial.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/tutorial.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/tutorial.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/tutorial.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/user_doc.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/user_doc.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/user_doc.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/user_doc.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/vars.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/vars.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/vars.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/vars.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/vars_workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/vars_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/vars_workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/vars_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/workspace.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/workspace.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/workspace.txt diff --git a/lib/node_modules/@stdlib/repl/base/docs/commands/workspaces.txt b/lib/node_modules/@stdlib/repl/cli/docs/commands/workspaces.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/base/docs/commands/workspaces.txt rename to lib/node_modules/@stdlib/repl/cli/docs/commands/workspaces.txt diff --git a/lib/node_modules/@stdlib/repl/base/lib/alias_to_string.js b/lib/node_modules/@stdlib/repl/cli/lib/alias_to_string.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/alias_to_string.js rename to lib/node_modules/@stdlib/repl/cli/lib/alias_to_string.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands.js b/lib/node_modules/@stdlib/repl/cli/lib/commands.js index 9d7c5d124895..88c4a5a63ea9 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/commands.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/commands.js @@ -21,18 +21,55 @@ // MODULES // var onAddTheme = require( './commands/add_theme.js' ); +var onAlias2Pkg = require( './commands/alias2pkg.js' ); +var onAlias2Related = require( './commands/alias2related.js' ); +var onAns = require( './commands/ans.js' ); +var onAssignin = require( './commands/assignin.js' ); +var onAssignfrom = require( './commands/assignfrom.js' ); +var onCitation = require( './commands/citation.js' ); var onClear = require( './commands/clear.js' ); +var onClearHistory = require( './commands/clear_history.js' ); +var onClearUserDocs = require( './commands/clear_user_docs.js' ); +var onClearVars = require( './commands/clear_vars.js' ); +var onClearWorkspace = require( './commands/clear_workspace.js' ); +var onContributors = require( './commands/contributor.js' ); +var onCopyright = require( './commands/copyright.js' ); +var onCredits = require( './commands/credits.js' ); +var onCurrentWorkspace = require( './commands/current_workspace.js' ); var onDeleteTheme = require( './commands/delete_theme.js' ); +var onDeleteWorkspace = require( './commands/delete_workspace.js' ); +var onDeeprerequire = require( './commands/deeprerequire.js' ); +var onDonate = require( './commands/donate.js' ); +var onDone = require( './commands/__done__.js' ); +var onEvalin = require( './commands/evalin.js' ); +var onExample = require( './commands/example.js' ); var onGetTheme = require( './commands/get_theme.js' ); +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' ); var onPager = require( './commands/pager.js' ); var onPresentationStart = require( './commands/presentation_start.js' ); var onPresentationStop = require( './commands/presentation_stop.js' ); +var onQuit = require( './commands/quit.js' ); var onRenameTheme = require( './commands/rename_theme.js' ); +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' ); +var onUserDoc = require( './commands/user_doc.js' ); +var onVars = require( './commands/vars.js' ); +var onVarsWorkspace = require( './commands/vars_workspace.js' ); +var onWorkspace = require( './commands/workspace.js' ); +var onWorkspaces = require( './commands/workspaces.js' ); // MAIN // @@ -59,19 +96,56 @@ function commands( repl ) { // Define a list of REPL-specific commands (NOTE: keep in alphabetical order): cmds = []; + cmds.push( [ '__done__', onDone( repl ), false ] ); cmds.push( [ 'addTheme', onAddTheme( repl ), false ] ); + cmds.push( [ 'alias2pkg', onAlias2Pkg( repl ), false ] ); + cmds.push( [ 'alias2related', onAlias2Related( repl, cmds ), false ] ); + cmds.push( [ 'ans', onAns( repl ), true ] ); + cmds.push( [ 'assignfrom', onAssignfrom( repl ), false ] ); + cmds.push( [ 'assignin', onAssignin( repl ), false ] ); + cmds.push( [ 'citation', onCitation( repl ), false ] ); cmds.push( [ 'clear', onClear( repl ), false ] ); + cmds.push( [ 'clearHistory', onClearHistory( repl ), false ] ); + cmds.push( [ 'clearUserDocs', onClearUserDocs( repl ), false ] ); + cmds.push( [ 'clearVars', onClearVars( repl ), false ] ); + cmds.push( [ 'clearWorkspace', onClearWorkspace( repl ), false ] ); + cmds.push( [ 'contributors', onContributors( repl ), false ] ); + cmds.push( [ 'copyright', onCopyright( repl ), false ] ); + cmds.push( [ 'credits', onCredits( repl ), false ] ); + cmds.push( [ 'currentWorkspace', onCurrentWorkspace( repl ), true ] ); cmds.push( [ 'deleteTheme', onDeleteTheme( repl ), false ] ); + cmds.push( [ 'deleteWorkspace', onDeleteWorkspace( repl ), false ] ); + cmds.push( [ 'deeprerequire', onDeeprerequire( repl ), false ] ); + cmds.push( [ 'donate', onDonate( repl ), false ] ); + cmds.push( [ 'evalin', onEvalin( repl, cmds ), false ] ); + cmds.push( [ 'example', onExample( repl, cmds ), false ] ); cmds.push( [ 'getTheme', onGetTheme( repl ), false ] ); + cmds.push( [ 'help', onHelp( repl, cmds ), false ] ); + 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 ] ); cmds.push( [ 'pager', onPager( repl ), false ] ); cmds.push( [ 'presentationStart', onPresentationStart( repl ), false ] ); cmds.push( [ 'presentationStop', onPresentationStop( repl ), false ] ); + cmds.push( [ 'quit', onQuit( repl ), false ] ); cmds.push( [ 'renameTheme', onRenameTheme( repl ), false ] ); + cmds.push( [ 'renameWorkspace', onRenameWorkspace( repl ), false ] ); + 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 ] ); + cmds.push( [ 'userDoc', onUserDoc( repl ), false ] ); + cmds.push( [ 'vars', onVars( repl ), false ] ); + cmds.push( [ 'varsWorkspace', onVarsWorkspace( repl ), false ] ); + cmds.push( [ 'workspace', onWorkspace( repl ), false ] ); + cmds.push( [ 'workspaces', onWorkspaces( repl ), false ] ); return cmds; } diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/__done__.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/__done__.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/__done__.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/__done__.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/alias2pkg.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/alias2pkg.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/alias2pkg.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/alias2pkg.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/alias2related.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/alias2related.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/alias2related.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/alias2related.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/ans.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/ans.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/ans.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/ans.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/assignfrom.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/assignfrom.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/assignfrom.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/assignfrom.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/assignin.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/assignin.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/assignin.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/assignin.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/citation.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/citation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/citation.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/citation.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/clear_history.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_history.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/clear_history.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/clear_history.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/clear_user_docs.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_user_docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/clear_user_docs.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/clear_user_docs.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/clear_vars.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_vars.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/clear_vars.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/clear_vars.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/clear_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/clear_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/clear_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/contributor.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/contributor.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/contributor.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/contributor.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/copyright.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/copyright.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/copyright.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/copyright.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/credits.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/credits.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/credits.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/credits.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/current_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/current_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/current_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/current_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/deeprerequire.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/deeprerequire.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/deeprerequire.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/deeprerequire.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/delete_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/delete_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/delete_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/delete_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/donate.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/donate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/donate.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/donate.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/evalin.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/evalin.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/evalin.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/evalin.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/example.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js similarity index 98% rename from lib/node_modules/@stdlib/repl/base/lib/commands/example.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/example.js index 28307dfac132..c60954b71b98 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/commands/example.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js @@ -162,7 +162,7 @@ function command( repl, cmds ) { lines.push( out[ i ] ); // If line is part of a multi-line input, wait for the next line... - if ( repl._multilineHandler.isMultilineInput( lines.join( '\n' ) ) ) { + if ( repl._isMultilineInput( lines.join( '\n' ) ) ) { return next(); } for ( j = 0; j < lines.length; j++ ) { diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/help.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/help.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/help.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/help.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/info.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/info.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/info.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/info.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/is_keyword.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/is_keyword.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/is_keyword.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/is_keyword.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/is_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/is_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/is_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/is_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/license_text.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/license_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/license_text.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/license_text.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/load.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/load.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/load.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/load.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/load_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/load_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/load_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/load_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/quit.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/quit.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/quit.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/quit.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/rename_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/rename_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/rename_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/rename_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/rerequire.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/rerequire.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/rerequire.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/rerequire.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/reset.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/reset.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/reset.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/reset.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/tutorial.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/tutorial.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/tutorial.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/tutorial.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/user_doc.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/user_doc.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/user_doc.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/user_doc.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/vars.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/vars.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/vars.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/vars.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/vars_workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/vars_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/vars_workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/vars_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/workspace.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/workspace.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/commands/workspaces.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/workspaces.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/commands/workspaces.js rename to lib/node_modules/@stdlib/repl/cli/lib/commands/workspaces.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/contains.js b/lib/node_modules/@stdlib/repl/cli/lib/contains.js new file mode 100644 index 000000000000..c525a07d7d24 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/contains.js @@ -0,0 +1,60 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 a boolean indicating if a strided array-like object contains a provided value. +* +* @private +* @param {NonNegativeInteger} N - number of elements to search +* @param {ArrayLike} arr - array to search +* @param {integer} stride - index stride +* @param {NonNegativeInteger} offset - index offset +* @param {*} value - search value +* @returns {boolean} boolean indicating if an array-like object contains a provided value +* +* @example +* var arr = [ 1, 2, 3 ]; +* +* var bool = contains( arr.length, arr, 1, 0, 2 ); +* // returns true +* +* bool = contains( arr.length, arr, 1, 0, 4 ); +* // returns false +*/ +function contains( N, arr, stride, offset, value ) { + var idx; + var i; + + idx = offset; + for ( i = 0; i < N; i++ ) { + if ( arr[ idx ] === value ) { + return true; + } + idx += stride; + } + return false; +} + + +// EXPORTS // + +module.exports = contains; diff --git a/lib/node_modules/@stdlib/repl/base/lib/find_unique_entry.js b/lib/node_modules/@stdlib/repl/cli/lib/find_unique_entry.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/find_unique_entry.js rename to lib/node_modules/@stdlib/repl/cli/lib/find_unique_entry.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/index_of.js b/lib/node_modules/@stdlib/repl/cli/lib/index_of.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/index_of.js rename to lib/node_modules/@stdlib/repl/cli/lib/index_of.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/main.js b/lib/node_modules/@stdlib/repl/cli/lib/main.js index 56f48dc872b1..84dc95401311 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/main.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/main.js @@ -23,6 +23,7 @@ // MODULES // var readline = require( 'readline' ); +var resolve = require( 'path' ).resolve; var proc = require( 'process' ); var inspect = require( 'util' ).inspect; var logger = require( 'debug' ); @@ -30,14 +31,19 @@ var inherit = require( '@stdlib/utils/inherit' ); var isndarrayLike = require( '@stdlib/assert/is-ndarray-like' ); var replace = require( '@stdlib/string/replace' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; +var isFunction = require( '@stdlib/assert/is-function' ); var isNumber = require( '@stdlib/assert/is-number' ).isPrimitive; var isPlainObject = require( '@stdlib/assert/is-plain-object' ); var objectKeys = require( '@stdlib/utils/keys' ); +var format = require( '@stdlib/string/format' ); +var cwd = require( '@stdlib/process/cwd' ); +var readFileSync = require( '@stdlib/fs/read-file' ).sync; +var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); var properties = require( '@stdlib/utils/properties' ); var append = require( '@stdlib/utils/append' ); -var format = require( '@stdlib/string/format' ); +var nextTick = require( '@stdlib/utils/next-tick' ); var Boolean = require( '@stdlib/boolean/ctor' ); var assign = require( '@stdlib/object/assign' ); var BaseREPL = require( '@stdlib/repl/base' ); @@ -184,7 +190,6 @@ function REPL( options ) { 'error': ostream, 'sandbox': opts.sandbox, 'timeout': opts.timeout, - 'load': opts.load, 'save': opts.save, 'log': opts.log, 'quiet': opts.quiet @@ -984,6 +989,83 @@ setNonEnumerableReadOnly( REPL.prototype, 'setKeybinding', function setKeybindin this._keybindings.set( action, keys ); }); +/** +* Loads and evaluates a JavaScript file line-by-line. +* +* @name load +* @memberof REPL.prototype +* @type {Function} +* @param {string} fpath - file path +* @param {Function} clbk - callback +* @throws {Error} cannot load a file into a closed REPL +* @throws {TypeError} first argument must be a string +* @throws {TypeError} second argument must be a function +* @returns {void} +* +* @example +* // TODO +*/ +setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { + var self; + var file; + var len; + var i; + if ( this._closed ) { + throw new Error( 'invalid operation. Cannot load a file into a REPL which has already closed.' ); + } + if ( !isString( fpath ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', fpath ) ); + } + if ( !isFunction( clbk ) ) { + throw new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) ); + } + // Resolve the provided path to an absolute file path: + fpath = resolve( cwd(), fpath ); + debug( 'Loading filepath: %s', fpath ); + + // Attempt to synchronously read the file: + file = readFileSync( fpath, 'utf8' ); + if ( file instanceof Error ) { + debug( 'Error: %s', file.message ); + clbk( file ); + return; + } + self = this; + + // Split the file content into individual lines: + file = file.split( RE_EOL ); + + // Forward each line to the REPL readline interface in order to mimic user input... + len = file.length; + i = -1; + + nextTick( next ); + + /** + * Callback invoked after draining the command queue. + * + * @private + * @param {string} cmd - command + * @param {boolean} success - boolean indicating whether the command successfully executed + */ + function next() { + i += 1; + if ( i < len ) { + if ( file[ i ] ) { + self._rli.write( file[ i ] ); + self._rli.write( '\n', { + 'name': 'return' + }); + self.once( 'drain', next ); + } else { + nextTick( next ); + } + } else { + nextTick( clbk ); + } + } +}); + /** * Resets a REPL. * @@ -1012,14 +1094,14 @@ setNonEnumerableReadOnly( REPL.prototype, 'setKeybinding', function setKeybindin * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { - // Call the parent method: - BaseREPL.prototype.reset( this ); - if ( this._closed ) { throw new Error( 'invalid operation. Cannot reset a REPL which has already closed.' ); } debug( 'Resetting REPL...' ); + // Call the parent method: + BaseREPL.prototype.reset.call( this ); + // Clear any command which has been buffered but not yet executed: this.clearCommand(); @@ -1187,12 +1269,12 @@ setNonEnumerableReadOnly( REPL.prototype, 'close', function close() { debug( 'Attempted to close an already closed REPL.' ); return this; } - // Call the parent method: - BaseREPL.prototype.close.call( this ); - debug( 'Closing readline interface...' ); this._rli.close(); + // Call the parent method: + BaseREPL.prototype.close.call( this ); + return this; }); diff --git a/lib/node_modules/@stdlib/repl/base/lib/repl_docs.js b/lib/node_modules/@stdlib/repl/cli/lib/repl_docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/repl_docs.js rename to lib/node_modules/@stdlib/repl/cli/lib/repl_docs.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/restore_regexp_matches.js b/lib/node_modules/@stdlib/repl/cli/lib/restore_regexp_matches.js new file mode 100644 index 000000000000..e1658458d972 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/cli/lib/restore_regexp_matches.js @@ -0,0 +1,48 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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'; + +// VARIABLES // + +var SEP_REGEXP_MATCHES = '\u0000\u0000\u0000'; +var RE_REGEXP_MATCHES = new RegExp( [ '^', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)$' ].join( SEP_REGEXP_MATCHES ) ); + + +// MAIN // + +/** +* Restores the (non-standard) properties on the `RegExp` expression object to cached matches. +* +* ## Notes +* +* - In certain JavaScript engines (e.g., V8, SpiderMonkey), the global `RegExp` object has ([non-standard][1]) static, read-only properties (`$1`, `$2`, ..., `$9`) with cached substring matches. This function restores matches to a prior state based on a provided list of cached matches. +* +* [1]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/n +* +* @private +* @param {StringArray} cache - list of previously saved substring matches +*/ +function restoreRegExpMatches( cache ) { + RE_REGEXP_MATCHES.test( cache.join( SEP_REGEXP_MATCHES ) ); +} + + +// EXPORTS // + +module.exports = restoreRegExpMatches; diff --git a/lib/node_modules/@stdlib/repl/base/lib/tutorial_alias_args.js b/lib/node_modules/@stdlib/repl/cli/lib/update_regexp_cache.js similarity index 51% rename from lib/node_modules/@stdlib/repl/base/lib/tutorial_alias_args.js rename to lib/node_modules/@stdlib/repl/cli/lib/update_regexp_cache.js index 92da3c082457..b630b6679ea5 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/tutorial_alias_args.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/update_regexp_cache.js @@ -18,31 +18,30 @@ 'use strict'; -// MODULES // - -var TUTORIAL_ALIASES = require( './tutorial_aliases.js' ); - - // MAIN // /** -* Returns a list of argument completion flags for a specified tutorial API. +* Updates the cache of saved regular expression substring matches. +* +* ## Notes +* +* - In certain JavaScript engines (e.g., V8, SpiderMonkey), the global `RegExp` object has ([non-standard][1]) static, read-only properties (`$1`, `$2`, ..., `$9`) with cached substring matches. +* +* [1]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/n * * @private -* @param {string} alias - alias -* @returns {(Array|null)} argument completion flags +* @param {StringArray} cache - list of previously saved substring matches +* @returns {StringArray} cache */ -function argFlags( alias ) { +function updateRegExpCache( cache ) { var i; - for ( i = 0; i < TUTORIAL_ALIASES.length; i++ ) { - if ( TUTORIAL_ALIASES[ i ][ 0 ] === alias ) { - return TUTORIAL_ALIASES[ i ].slice( 1 ); - } + for ( i = 1; i < cache.length; i++ ) { + cache[ i ] = RegExp[ '$'+i ]; } - return null; + return cache; } // EXPORTS // -module.exports = argFlags; +module.exports = updateRegExpCache; diff --git a/lib/node_modules/@stdlib/repl/base/scripts/build.js b/lib/node_modules/@stdlib/repl/cli/scripts/build.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/scripts/build.js rename to lib/node_modules/@stdlib/repl/cli/scripts/build.js diff --git a/lib/node_modules/@stdlib/repl/base/scripts/build_contributors.js b/lib/node_modules/@stdlib/repl/cli/scripts/build_contributors.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/scripts/build_contributors.js rename to lib/node_modules/@stdlib/repl/cli/scripts/build_contributors.js diff --git a/lib/node_modules/@stdlib/repl/base/scripts/build_help.js b/lib/node_modules/@stdlib/repl/cli/scripts/build_help.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/scripts/build_help.js rename to lib/node_modules/@stdlib/repl/cli/scripts/build_help.js diff --git a/lib/node_modules/@stdlib/repl/base/scripts/build_license.js b/lib/node_modules/@stdlib/repl/cli/scripts/build_license.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/scripts/build_license.js rename to lib/node_modules/@stdlib/repl/cli/scripts/build_license.js diff --git a/lib/node_modules/@stdlib/repl/base/scripts/build_tutorials.js b/lib/node_modules/@stdlib/repl/cli/scripts/build_tutorials.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/scripts/build_tutorials.js rename to lib/node_modules/@stdlib/repl/cli/scripts/build_tutorials.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js index b2b9cf1fc4bc..66c70b020261 100644 --- a/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js +++ b/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js @@ -202,7 +202,7 @@ tape( 'a REPL instance avoids auto-paging short outputs', function test( t ) { } // Check if the output is printed without paging: expected = replace( FIXTURE, '\\n', '\n' ) + '\n'; - t.strictEqual( data[ data.length - 1 ], expected, 'returns expected value' ); + t.strictEqual( data[ data.length - 6 ], expected, 'returns expected value' ); t.end(); } diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js b/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js index f8762ff4904a..58dd382361f1 100644 --- a/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js +++ b/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js @@ -322,16 +322,16 @@ tape( 'a REPL instance supports auto-completing a completion preview and executi return; } // Check for an ANSI-escaped color-coded 'gh' completion: - t.strictEqual( data[ data.length-5 ], '\u001b[90mgh\u001b[0m', 'returns expected value' ); + t.strictEqual( data[ data.length-10 ], '\u001b[90mgh\u001b[0m', 'returns expected value' ); // Check that the cursor is positioned BEFORE the completion preview: - t.strictEqual( data[ data.length-4 ], '\u001b[2D', 'returns expected value' ); + t.strictEqual( data[ data.length-9 ], '\u001b[2D', 'returns expected value' ); // Check that the completion preview was auto-completed prior to execution: - t.strictEqual( data[ data.length-3 ], 'gh', 'returns expected value' ); + t.strictEqual( data[ data.length-8 ], 'gh', 'returns expected value' ); // Check that the expression was executed: - t.strictEqual( trim( data[ data.length-1 ] ), '1', 'returns expected value' ); + t.strictEqual( trim( data[ data.length-6 ] ), '1', 'returns expected value' ); t.end(); } From fdbd335444d3d10a25152719bb32527e64d9476d Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Thu, 6 Mar 2025 22:14:38 +0000 Subject: [PATCH 05/26] fix: remove `command` token from themes Signed-off-by: Snehil Shah --- 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: passed - 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 --- --- type: pre_push_report description: Results of running various checks prior to pushing changes. report: - task: run_javascript_examples status: na - task: run_c_examples status: na - task: run_cpp_examples status: na - task: run_javascript_readme_examples status: passed - task: run_c_benchmarks status: na - task: run_cpp_benchmarks status: na - task: run_fortran_benchmarks status: na - task: run_javascript_benchmarks status: na - task: run_julia_benchmarks status: na - task: run_python_benchmarks status: na - task: run_r_benchmarks status: na - task: run_javascript_tests status: na --- --- lib/node_modules/@stdlib/repl/cli/README.md | 1 - lib/node_modules/@stdlib/repl/cli/lib/themes.js | 7 ------- 2 files changed, 8 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/cli/README.md b/lib/node_modules/@stdlib/repl/cli/README.md index 281c5a156919..16ece9fc3da4 100644 --- a/lib/node_modules/@stdlib/repl/cli/README.md +++ b/lib/node_modules/@stdlib/repl/cli/README.md @@ -290,7 +290,6 @@ The syntax-highlighter supports the following tokens and associated theme fields - **number**: numeric literals. - **literal**: reserved literals (e.g., `true`, `false`, `null`, and `undefined`). - **regexp**: regular expressions. -- **command**: built-in REPL commands. - **function**: function identifiers. - **object**: object identifiers. - **variable**: literal identifiers. diff --git a/lib/node_modules/@stdlib/repl/cli/lib/themes.js b/lib/node_modules/@stdlib/repl/cli/lib/themes.js index 63edd47db577..36a0bc4e47a4 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/themes.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/themes.js @@ -41,7 +41,6 @@ var THEMES = { 'regexp': 'underline brightRed', // Identifiers: - 'command': 'bold magenta', 'function': 'bold yellow', 'object': 'cyan', 'variable': null, @@ -65,7 +64,6 @@ var THEMES = { 'regexp': 'bold red', // Identifiers: - 'command': 'brightGreen', 'function': 'bold magenta', 'object': 'cyan', 'variable': null, @@ -89,7 +87,6 @@ var THEMES = { 'regexp': 'underline red', // Identifiers: - 'command': 'brightMagenta', 'function': 'yellow', 'object': 'bold', 'variable': null, @@ -113,7 +110,6 @@ var THEMES = { 'regexp': 'underline red', // Identifiers: - 'command': 'underline brightBlue', 'function': 'bold yellow', 'object': 'italic cyan', 'variable': 'green', @@ -137,7 +133,6 @@ var THEMES = { 'regexp': 'bold underline', // Identifiers: - 'command': 'underline bold', 'function': 'italic bold', 'object': 'italic', 'variable': null, @@ -161,7 +156,6 @@ var THEMES = { 'regexp': 'red', // Identifiers: - 'command': 'bold magenta', 'function': 'brightBlue', 'object': 'brightRed', 'variable': 'brightBlue', @@ -185,7 +179,6 @@ var THEMES = { 'regexp': 'underline yellow', // Identifiers: - 'command': 'bold brightGreen', 'function': 'brightGreen', 'object': 'italic brightMagenta', 'variable': null, From b7b5082662d1d3c3f8194afb99b838a7ee1af8c8 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 17:54:12 +0000 Subject: [PATCH 06/26] refactor: move base implementation to `ctor` package Signed-off-by: Snehil Shah --- 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: passed - task: lint_package_json status: passed - task: lint_repl_help status: na - task: lint_javascript_src status: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: passed - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: passed - 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 --- --- lib/node_modules/@stdlib/repl/base/README.md | 214 ++------------ .../@stdlib/repl/base/ctor/README.md | 271 ++++++++++++++++++ .../base/{ => ctor}/benchmark/benchmark.js | 0 .../@stdlib/repl/base/ctor/examples/index.js | 36 +++ .../lib/acorn_detect_multiline_input.js | 0 .../base/{ => ctor}/lib/alias_overrides.js | 0 .../repl/base/{ => ctor}/lib/aliases.js | 0 .../repl/base/{ => ctor}/lib/append_unique.js | 0 .../repl/base/{ => ctor}/lib/compile_code.js | 0 .../base/{ => ctor}/lib/compile_command.js | 0 .../{ => ctor}/lib/complete_expression.js | 0 .../repl/base/{ => ctor}/lib/complete_fs.js | 0 .../base/{ => ctor}/lib/complete_require.js | 0 .../{ => ctor}/lib/complete_walk_find_last.js | 0 .../base/{ => ctor}/lib/complete_workspace.js | 0 .../repl/base/{ => ctor}/lib/completer.js | 0 .../repl/base/{ => ctor}/lib/contains.js | 0 .../base/{ => ctor}/lib/create_accessor.js | 0 .../lib/create_evaluation_context.js | 0 .../base/{ => ctor}/lib/create_require.js | 0 .../repl/base/{ => ctor}/lib/defaults.js | 0 .../@stdlib/repl/base/{ => ctor}/lib/drain.js | 0 .../base/{ => ctor}/lib/filter_by_prefix.js | 0 .../repl/base/{ => ctor}/lib/fs_alias_args.js | 0 .../repl/base/{ => ctor}/lib/fs_aliases.js | 0 .../repl/base/{ => ctor}/lib/globals.js | 0 .../{ => ctor}/lib/has_async_directive.js | 0 .../@stdlib/repl/base/ctor/lib/index.js | 50 ++++ .../base/{ => ctor}/lib/is_block_scope.js | 0 .../base/{ => ctor}/lib/is_multiline_input.js | 0 .../repl/base/{ => ctor}/lib/is_scope.js | 0 .../base/{ => ctor}/lib/is_silent_command.js | 0 .../{ => ctor}/lib/longest_common_prefix.js | 0 .../@stdlib/repl/base/{ => ctor}/lib/main.js | 0 .../base/{ => ctor}/lib/process_command.js | 0 .../repl/base/{ => ctor}/lib/process_input.js | 0 .../{ => ctor}/lib/process_top_level_await.js | 0 .../{ => ctor}/lib/property_comparator.js | 0 .../base/{ => ctor}/lib/regexp_fs_aliases.js | 0 .../repl/base/{ => ctor}/lib/regexp_index.js | 0 .../repl/base/{ => ctor}/lib/regexp_path.js | 0 .../lib/regexp_relative_require_path.js | 0 .../base/{ => ctor}/lib/regexp_require.js | 0 .../lib/regexp_reserved_syntax_characters.js | 0 .../base/{ => ctor}/lib/regexp_workspace.js | 0 .../base/{ => ctor}/lib/reserved_keywords.js | 0 .../lib/reserved_keywords_common.js | 0 ...reserved_keywords_empty_block_statement.js | 0 .../base/{ => ctor}/lib/resolve_globals.js | 0 .../{ => ctor}/lib/resolve_local_scope.js | 0 .../{ => ctor}/lib/resolve_local_scopes.js | 0 .../{ => ctor}/lib/restore_regexp_matches.js | 0 .../repl/base/{ => ctor}/lib/set_aliases.js | 0 .../base/{ => ctor}/lib/set_aliases_global.js | 0 .../repl/base/{ => ctor}/lib/setdiff.js | 0 .../repl/base/{ => ctor}/lib/tokenizer.js | 0 .../{ => ctor}/lib/update_regexp_cache.js | 0 .../repl/base/{ => ctor}/lib/validate.js | 0 .../{ => ctor}/lib/workspace_alias_args.js | 0 .../base/{ => ctor}/lib/workspace_aliases.js | 0 .../@stdlib/repl/base/ctor/package.json | 71 +++++ .../@stdlib/repl/base/ctor/test/test.js | 35 +++ .../@stdlib/repl/base/examples/index.js | 18 +- .../@stdlib/repl/base/lib/index.js | 47 +-- .../@stdlib/repl/base/package.json | 13 +- .../@stdlib/repl/base/test/test.js | 15 +- 66 files changed, 518 insertions(+), 252 deletions(-) create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/README.md rename lib/node_modules/@stdlib/repl/base/{ => ctor}/benchmark/benchmark.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/examples/index.js rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/acorn_detect_multiline_input.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/alias_overrides.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/aliases.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/append_unique.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/compile_code.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/compile_command.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/complete_expression.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/complete_fs.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/complete_require.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/complete_walk_find_last.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/complete_workspace.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/completer.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/contains.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/create_accessor.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/create_evaluation_context.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/create_require.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/defaults.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/drain.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/filter_by_prefix.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/fs_alias_args.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/fs_aliases.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/globals.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/has_async_directive.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/lib/index.js rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/is_block_scope.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/is_multiline_input.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/is_scope.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/is_silent_command.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/longest_common_prefix.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/main.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/process_command.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/process_input.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/process_top_level_await.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/property_comparator.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_fs_aliases.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_index.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_path.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_relative_require_path.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_require.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_reserved_syntax_characters.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/regexp_workspace.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/reserved_keywords.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/reserved_keywords_common.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/reserved_keywords_empty_block_statement.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/resolve_globals.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/resolve_local_scope.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/resolve_local_scopes.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/restore_regexp_matches.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/set_aliases.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/set_aliases_global.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/setdiff.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/tokenizer.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/update_regexp_cache.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/validate.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/workspace_alias_args.js (100%) rename lib/node_modules/@stdlib/repl/base/{ => ctor}/lib/workspace_aliases.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/package.json create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/test/test.js diff --git a/lib/node_modules/@stdlib/repl/base/README.md b/lib/node_modules/@stdlib/repl/base/README.md index 0e9742584878..be4dbb3c7849 100644 --- a/lib/node_modules/@stdlib/repl/base/README.md +++ b/lib/node_modules/@stdlib/repl/base/README.md @@ -18,191 +18,39 @@ limitations under the License. --> -# REPL +# Base -> Base class for Read-Eval-Print Loop (REPL) environment. - - - -
- -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. - -
- - - - +> Base REPL functionality.
## Usage ```javascript -var REPL = require( '@stdlib/repl/base' ); +var ns = require( '@stdlib/repl/base' ); ``` -#### REPL( \[options] ) +#### ns -Returns a `REPL` instance. +Namespace containing "base" (i.e., lower-level) REPL functionality. ```javascript -// Create a new REPL: -var repl = new REPL(); - -// ... - -// Execute a command: -repl.emit( 'input', '2 + 3' ); - -// ... - -// Close the REPL: -repl.close(); +var o = ns; +// returns {...} ``` -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(); -``` - -* * * +
- - -
- -
- - - - - -* * * -
## Examples @@ -210,44 +58,16 @@ repl.close(); ```javascript -var REPL = require( '@stdlib/repl/base' ); - -function onCommand( cmd, success, res ) { - console.log( cmd + ' = ' + res.toString() ); -} - -// Create a new REPL: -var repl = new REPL(); -repl.on( 'command', onCommand ); +var objectKeys = require( '@stdlib/utils/keys' ); +var ns = require( '@stdlib/repl/base' ); -// Execute a command: -repl.emit( 'input', '3 + 2' ); - -// Close the REPL: -repl.close(); -console.log( 'REPL closed.' ); +console.log( objectKeys( ns ) ); ```
-* * * - -
- -
- - - - - -
- -
- - -
@@ -260,11 +80,9 @@ console.log( 'REPL closed.' );
-[@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 +
diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md new file mode 100644 index 000000000000..7aed15b623f9 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -0,0 +1,271 @@ + + +# REPL + +> Base class for Read-Eval-Print Loop (REPL) environment. + + + +
+ +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. + +
+ + + + + +
+ +## 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(); +``` + +* * * + +
+ + + + + +
+ +
+ + + + + +* * * + +
+ +## Examples + + + +```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.' ); +``` + +
+ + + +* * * + +
+ +
+ + + + + +
+ +
+ + + + + +
+ +
+ + + + + +
+ +[@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 + +
+ + diff --git a/lib/node_modules/@stdlib/repl/base/benchmark/benchmark.js b/lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/benchmark/benchmark.js rename to lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/examples/index.js b/lib/node_modules/@stdlib/repl/base/ctor/examples/index.js new file mode 100644 index 000000000000..19ad97ab2eac --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/examples/index.js @@ -0,0 +1,36 @@ +/** +* @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'; + +var REPL = require( './../lib' ); + +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.' ); diff --git a/lib/node_modules/@stdlib/repl/base/lib/acorn_detect_multiline_input.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/acorn_detect_multiline_input.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/acorn_detect_multiline_input.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/acorn_detect_multiline_input.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/alias_overrides.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/alias_overrides.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/alias_overrides.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/alias_overrides.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/aliases.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/aliases.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/aliases.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/append_unique.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/append_unique.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/append_unique.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/append_unique.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/compile_code.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/compile_code.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/compile_code.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/compile_code.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/compile_command.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/compile_command.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/compile_command.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/compile_command.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/complete_expression.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/complete_expression.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/complete_expression.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/complete_expression.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/complete_fs.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/complete_fs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/complete_fs.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/complete_fs.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/complete_require.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/complete_require.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/complete_require.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/complete_require.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/complete_walk_find_last.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/complete_walk_find_last.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/complete_walk_find_last.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/complete_walk_find_last.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/complete_workspace.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/complete_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/complete_workspace.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/complete_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/completer.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/completer.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/contains.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/contains.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/contains.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/contains.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/create_accessor.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/create_accessor.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/create_accessor.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/create_accessor.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/create_evaluation_context.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/create_evaluation_context.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/create_evaluation_context.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/create_evaluation_context.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/create_require.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/create_require.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/create_require.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/create_require.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/defaults.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/defaults.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/drain.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/drain.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/drain.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/drain.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/filter_by_prefix.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/filter_by_prefix.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/filter_by_prefix.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/filter_by_prefix.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/fs_alias_args.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/fs_alias_args.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/fs_alias_args.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/fs_alias_args.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/fs_aliases.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/fs_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/fs_aliases.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/fs_aliases.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/globals.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/globals.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/globals.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/globals.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/has_async_directive.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/has_async_directive.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/has_async_directive.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/has_async_directive.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/index.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/index.js new file mode 100644 index 000000000000..f7da2d9723dd --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/index.js @@ -0,0 +1,50 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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'; + +/** +* Base class for REPL. +* +* @module @stdlib/repl/base/ctor +* +* @example +* var REPL = require( '@stdlib/repl/base/ctor' ); +* +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Execute a command: +* repl.emit( 'input', '2 + 3' ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ + +// MODULES // + +var main = require( './main.js' ); + + +// EXPORTS // + +module.exports = main; diff --git a/lib/node_modules/@stdlib/repl/base/lib/is_block_scope.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_block_scope.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/is_block_scope.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/is_block_scope.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/is_multiline_input.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/is_multiline_input.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/is_scope.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_scope.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/is_scope.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/is_scope.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/is_silent_command.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_silent_command.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/is_silent_command.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/is_silent_command.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/longest_common_prefix.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/longest_common_prefix.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/longest_common_prefix.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/longest_common_prefix.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/main.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/main.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/process_command.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/process_command.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/process_command.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/process_command.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/process_input.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/process_input.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/process_input.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/process_input.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/process_top_level_await.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/process_top_level_await.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/process_top_level_await.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/process_top_level_await.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/property_comparator.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/property_comparator.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/property_comparator.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/property_comparator.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_fs_aliases.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_fs_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_fs_aliases.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_fs_aliases.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_index.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_index.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_index.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_index.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_path.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_path.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_path.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_path.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_relative_require_path.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_relative_require_path.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_relative_require_path.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_relative_require_path.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_require.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_require.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_require.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_require.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_reserved_syntax_characters.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_reserved_syntax_characters.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_reserved_syntax_characters.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_reserved_syntax_characters.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/regexp_workspace.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/regexp_workspace.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/regexp_workspace.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/reserved_keywords.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/reserved_keywords.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/reserved_keywords.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/reserved_keywords.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_common.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/reserved_keywords_common.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_common.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/reserved_keywords_common.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_empty_block_statement.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/reserved_keywords_empty_block_statement.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/reserved_keywords_empty_block_statement.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/reserved_keywords_empty_block_statement.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/resolve_globals.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/resolve_globals.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/resolve_globals.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/resolve_globals.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/resolve_local_scope.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/resolve_local_scope.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/resolve_local_scope.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/resolve_local_scope.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/resolve_local_scopes.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/resolve_local_scopes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/resolve_local_scopes.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/resolve_local_scopes.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/restore_regexp_matches.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/restore_regexp_matches.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/restore_regexp_matches.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/restore_regexp_matches.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/set_aliases.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/set_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/set_aliases.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/set_aliases.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/set_aliases_global.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/set_aliases_global.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/set_aliases_global.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/set_aliases_global.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/setdiff.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/setdiff.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/setdiff.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/setdiff.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/tokenizer.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/tokenizer.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/tokenizer.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/tokenizer.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/update_regexp_cache.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/update_regexp_cache.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/update_regexp_cache.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/update_regexp_cache.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/validate.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/validate.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/workspace_alias_args.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/workspace_alias_args.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/workspace_alias_args.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/workspace_alias_args.js diff --git a/lib/node_modules/@stdlib/repl/base/lib/workspace_aliases.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/workspace_aliases.js similarity index 100% rename from lib/node_modules/@stdlib/repl/base/lib/workspace_aliases.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/workspace_aliases.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/package.json b/lib/node_modules/@stdlib/repl/base/ctor/package.json new file mode 100644 index 000000000000..b87e6cc4ebc2 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/package.json @@ -0,0 +1,71 @@ +{ + "name": "@stdlib/repl/base/ctor", + "version": "0.0.0", + "description": "REPL environment.", + "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", + "browser": { + "process": "process/" + }, + "directories": { + "benchmark": "./benchmark", + "example": "./examples", + "lib": "./lib", + "test": "./test" + }, + "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", + "repl", + "read-eval-print-loop", + "eval", + "evaluate", + "interact", + "interactive", + "console", + "terminal", + "shell", + "server", + "toplevel" + ], + "__stdlib__": { + "envs": { + "browser": false + } + } +} diff --git a/lib/node_modules/@stdlib/repl/base/ctor/test/test.js b/lib/node_modules/@stdlib/repl/base/ctor/test/test.js new file mode 100644 index 000000000000..f302074f6ef2 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/test/test.js @@ -0,0 +1,35 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 repl = require( './../lib' ); + + +// TESTS // + +tape( 'main export is a function', function test( t ) { + t.ok( true, __filename ); + t.strictEqual( typeof repl, 'function', 'main export is a function' ); + t.end(); +}); + +// TODO: tests diff --git a/lib/node_modules/@stdlib/repl/base/examples/index.js b/lib/node_modules/@stdlib/repl/base/examples/index.js index 19ad97ab2eac..f5349d26ce9b 100644 --- a/lib/node_modules/@stdlib/repl/base/examples/index.js +++ b/lib/node_modules/@stdlib/repl/base/examples/index.js @@ -18,19 +18,7 @@ 'use strict'; -var REPL = require( './../lib' ); +var objectKeys = require( '@stdlib/utils/keys' ); +var ns = require( './../lib' ); -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.' ); +console.log( objectKeys( ns ) ); diff --git a/lib/node_modules/@stdlib/repl/base/lib/index.js b/lib/node_modules/@stdlib/repl/base/lib/index.js index a19109130546..2cb987b48dd3 100644 --- a/lib/node_modules/@stdlib/repl/base/lib/index.js +++ b/lib/node_modules/@stdlib/repl/base/lib/index.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* 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. @@ -18,33 +18,34 @@ 'use strict'; -/** -* Base class for REPL. -* -* @module @stdlib/repl/base -* -* @example -* var REPL = require( '@stdlib/repl/base' ); -* -* // Create a new REPL: -* var repl = new REPL(); -* -* // ... -* -* // Execute a command: -* repl.emit( 'input', '2 + 3' ); -* -* // ... -* -* // Close the REPL: -* repl.close(); +/* +* When adding modules to the namespace, ensure that they are added in alphabetical order according to module name. */ // MODULES // -var main = require( './main.js' ); +var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); + + +// MAIN // + +/** +* Top-level namespace. +* +* @namespace ns +*/ +var ns = {}; + +/** +* @name REPL +* @memberof ns +* @readonly +* @type {Function} +* @see {@link module:@stdlib/repl/base/ctor} +*/ +setReadOnly( ns, 'REPL', require( '@stdlib/repl/base/ctor' ) ); // EXPORTS // -module.exports = main; +module.exports = ns; diff --git a/lib/node_modules/@stdlib/repl/base/package.json b/lib/node_modules/@stdlib/repl/base/package.json index f592b42aad09..17a48c7e4722 100644 --- a/lib/node_modules/@stdlib/repl/base/package.json +++ b/lib/node_modules/@stdlib/repl/base/package.json @@ -1,7 +1,7 @@ { "name": "@stdlib/repl/base", "version": "0.0.0", - "description": "REPL environment.", + "description": "Base (i.e., lower-level) REPL functionality.", "license": "Apache-2.0", "author": { "name": "The Stdlib Authors", @@ -14,11 +14,7 @@ } ], "main": "./lib", - "browser": { - "process": "process/" - }, "directories": { - "benchmark": "./benchmark", "example": "./examples", "lib": "./lib", "test": "./test" @@ -62,10 +58,5 @@ "shell", "server", "toplevel" - ], - "__stdlib__": { - "envs": { - "browser": false - } - } + ] } diff --git a/lib/node_modules/@stdlib/repl/base/test/test.js b/lib/node_modules/@stdlib/repl/base/test/test.js index f302074f6ef2..14dda1f7d171 100644 --- a/lib/node_modules/@stdlib/repl/base/test/test.js +++ b/lib/node_modules/@stdlib/repl/base/test/test.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* Copyright (c) 2018 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. @@ -21,15 +21,20 @@ // MODULES // var tape = require( 'tape' ); -var repl = require( './../lib' ); +var objectKeys = require( '@stdlib/utils/keys' ); +var ns = require( './../lib' ); // TESTS // -tape( 'main export is a function', function test( t ) { +tape( 'main export is an object', function test( t ) { t.ok( true, __filename ); - t.strictEqual( typeof repl, 'function', 'main export is a function' ); + t.equal( typeof ns, 'object', 'main export is an object' ); t.end(); }); -// TODO: tests +tape( 'the exported object contains key-value pairs', function test( t ) { + var keys = objectKeys( ns ); + t.equal( keys.length > 0, true, 'has keys' ); + t.end(); +}); From d48530c92f5b418fce180548fdbfa444b85e58ff Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 18:12:01 +0000 Subject: [PATCH 07/26] fix: update redundant paths for make and cli Signed-off-by: Snehil Shah --- 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: failed --- --- bin/cli_commands.json | 4 ++-- lib/node_modules/@stdlib/repl/cli/lib/main.js | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/bin/cli_commands.json b/bin/cli_commands.json index bb3c9e94231f..fd9a0f4f37e6 100644 --- a/bin/cli_commands.json +++ b/bin/cli_commands.json @@ -788,13 +788,13 @@ { "command": "repl", "description": "Start a REPL.", - "path": "@stdlib/repl", + "path": "@stdlib/repl/cli", "group": "general" }, { "command": "repl-presentation", "description": "Start a REPL presentation.", - "path": "@stdlib/repl/presentation", + "path": "@stdlib/repl/cli/presentation", "group": "general" }, { diff --git a/lib/node_modules/@stdlib/repl/cli/lib/main.js b/lib/node_modules/@stdlib/repl/cli/lib/main.js index 84dc95401311..8a6a24b94a7b 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/main.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/main.js @@ -46,7 +46,7 @@ var append = require( '@stdlib/utils/append' ); var nextTick = require( '@stdlib/utils/next-tick' ); var Boolean = require( '@stdlib/boolean/ctor' ); var assign = require( '@stdlib/object/assign' ); -var BaseREPL = require( '@stdlib/repl/base' ); +var BaseREPL = require( '@stdlib/repl/base/ctor' ); var validate = require( './validate.js' ); var parseKey = require( './parse_key.js' ); var defaults = require( './defaults.js' ); From 87377b3a2d6d8d5d70028c2034cc51b55afda563 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 18:17:10 +0000 Subject: [PATCH 08/26] fix: update import paths Signed-off-by: Snehil Shah --- 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: failed --- --- type: pre_push_report description: Results of running various checks prior to pushing changes. report: - task: run_javascript_examples status: passed - task: run_c_examples status: passed - task: run_cpp_examples status: na - task: run_javascript_readme_examples status: failed --- --- lib/node_modules/@stdlib/repl/base/ctor/lib/main.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 345598f25bb4..f554ad85edae 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -30,7 +30,7 @@ var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); -var fifo = require( '@stdlib/utils/fifo' ); +var fifo = require( '@stdlib/dstructs/fifo' ); var nextTick = require( '@stdlib/utils/next-tick' ); var validate = require( './validate.js' ); var defaults = require( './defaults.js' ); From cdf34d2815daf74e6a3fbc0e8f21cac57ff18746 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 18:51:45 +0000 Subject: [PATCH 09/26] build: update workflow paths Signed-off-by: Snehil Shah --- tools/make/lib/docs/repl.mk | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tools/make/lib/docs/repl.mk b/tools/make/lib/docs/repl.mk index 798ce5fef305..e48b0646ba1f 100644 --- a/tools/make/lib/docs/repl.mk +++ b/tools/make/lib/docs/repl.mk @@ -22,8 +22,8 @@ # # This target generates REPL documentation. -repl-docs: repl-help repl-info repl-examples repl-signatures repl-typed-signatures repl-aliases repl-alias2pkg repl-pkg2alias repl-alias2related repl-alias2standalone repl-pkg2related repl-pkg2standalone repl-standalone2pkg $(NODE_MODULES) $(SRC_DIR)/@stdlib/repl/scripts/build.js - $(QUIET) $(NODE) "$(SRC_DIR)/@stdlib/repl/scripts/build.js" +repl-docs: repl-help repl-info repl-examples repl-signatures repl-typed-signatures repl-aliases repl-alias2pkg repl-pkg2alias repl-alias2related repl-alias2standalone repl-pkg2related repl-pkg2standalone repl-standalone2pkg $(NODE_MODULES) $(SRC_DIR)/@stdlib/repl/cli/scripts/build.js + $(QUIET) $(NODE) "$(SRC_DIR)/@stdlib/repl/cli/scripts/build.js" .PHONY: repl-docs From 00846de5524d88cbb6c3522b620895d472ae5c3a Mon Sep 17 00:00:00 2001 From: stdlib-bot <82920195+stdlib-bot@users.noreply.github.com> Date: Sat, 8 Mar 2025 18:57:23 +0000 Subject: [PATCH 10/26] chore: update copyright years --- lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js | 2 +- lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js | 2 +- lib/node_modules/@stdlib/repl/base/ctor/lib/main.js | 2 +- lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js | 2 +- lib/node_modules/@stdlib/repl/base/test/test.js | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js b/lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js index 4b0a69062900..364db7818d05 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/benchmark/benchmark.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* 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. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js index bb9686d6114c..7b9141c2df42 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* 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. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index f554ad85edae..a87eb1ae3780 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* 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. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js index ab7ad4fc1453..eadad0485db4 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2019 The Stdlib Authors. +* 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. diff --git a/lib/node_modules/@stdlib/repl/base/test/test.js b/lib/node_modules/@stdlib/repl/base/test/test.js index 14dda1f7d171..ff0bea34c42b 100644 --- a/lib/node_modules/@stdlib/repl/base/test/test.js +++ b/lib/node_modules/@stdlib/repl/base/test/test.js @@ -1,7 +1,7 @@ /** * @license Apache-2.0 * -* Copyright (c) 2018 The Stdlib Authors. +* 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. From f865e107c6b9605923a7d6f3eff1a12fa4959fa1 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 19:05:18 +0000 Subject: [PATCH 11/26] style: convert indents to 2 spaces Signed-off-by: Snehil Shah --- 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: na - 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 --- --- bin/cli_commands.json | 1908 ++++++++++++++++++++--------------------- 1 file changed, 954 insertions(+), 954 deletions(-) diff --git a/bin/cli_commands.json b/bin/cli_commands.json index fd9a0f4f37e6..78212a2b543d 100644 --- a/bin/cli_commands.json +++ b/bin/cli_commands.json @@ -1,956 +1,956 @@ [ - { - "command": "help [command]", - "description": "Print a help message.", - "path": "", - "group": "general" - }, - { - "command": "arch", - "description": "Operating system CPU architecture.", - "path": "@stdlib/os/arch", - "group": "system" - }, - { - "command": "bench", - "description": "Run JavaScript benchmark files.", - "path": "@stdlib/bench", - "group": "benchmarking" - }, - { - "command": "bundle-pkg-list", - "description": "Bundle a list of stdlib packages.", - "path": "@stdlib/_tools/bundle/pkg-list", - "group": "tools" - }, - { - "command": "capitalize", - "description": "Capitalize the first character in a string.", - "path": "@stdlib/string/capitalize", - "group": "utilities" - }, - { - "command": "configdir", - "description": "Configuration directory path.", - "path": "@stdlib/os/configdir", - "group": "system" - }, - { - "command": "convert-path", - "description": "Convert between Windows and POSIX paths.", - "path": "@stdlib/utils/convert-path", - "group": "utilities" - }, - { - "command": "cwd", - "description": "Current working directory.", - "path": "@stdlib/process/cwd", - "group": "system" - }, - { - "command": "datasets", - "description": "Retrieve a dataset.", - "path": "@stdlib/datasets", - "group": "general" - }, - { - "command": "day-of-quarter", - "description": "Calculate day of quarter.", - "path": "@stdlib/time/day-of-quarter", - "group": "time" - }, - { - "command": "day-of-year", - "description": "Calculate day of year.", - "path": "@stdlib/time/day-of-year", - "group": "time" - }, - { - "command": "days-in-month", - "description": "Calculate the number of days in a month.", - "path": "@stdlib/time/days-in-month", - "group": "time" - }, - { - "command": "days-in-year", - "description": "Calculate the number of days in a year.", - "path": "@stdlib/time/days-in-year", - "group": "time" - }, - { - "command": "ends-with", - "description": "Test if a string ends with another string.", - "path": "@stdlib/string/ends-with", - "group": "utilities" - }, - { - "command": "exists", - "description": "Test if a file exists.", - "path": "@stdlib/fs/exists", - "group": "filesystem" - }, - { - "command": "from-code-point", - "description": "Create a string from code points.", - "path": "@stdlib/string/from-code-point", - "group": "utilities" - }, - { - "command": "has-arraybuffer-support", - "description": "Detect ArrayBuffer support.", - "path": "@stdlib/assert/has-arraybuffer-support", - "group": "assert" - }, - { - "command": "has-async-await-support", - "description": "Detect async/await support.", - "path": "@stdlib/assert/has-async-await-support", - "group": "assert" - }, - { - "command": "has-async-iterator-symbol-support", - "description": "Detect Symbol.asyncIterator support.", - "path": "@stdlib/assert/has-async-iterator-symbol-support", - "group": "assert" - }, - { - "command": "has-class-support", - "description": "Detect ES6 class support.", - "path": "@stdlib/assert/has-class-support", - "group": "assert" - }, - { - "command": "has-float32array-support", - "description": "Detect Float32Array support.", - "path": "@stdlib/assert/has-float32array-support", - "group": "assert" - }, - { - "command": "has-float64array-support", - "description": "Detect Float64Array support.", - "path": "@stdlib/assert/has-float64array-support", - "group": "assert" - }, - { - "command": "has-function-name-support", - "description": "Detect function name support.", - "path": "@stdlib/assert/has-function-name-support", - "group": "assert" - }, - { - "command": "has-generator-support", - "description": "Detect generator support.", - "path": "@stdlib/assert/has-generator-support", - "group": "assert" - }, - { - "command": "has-int16array-support", - "description": "Detect Int16Array support.", - "path": "@stdlib/assert/has-int16array-support", - "group": "assert" - }, - { - "command": "has-int32array-support", - "description": "Detect Int32Array support.", - "path": "@stdlib/assert/has-int32array-support", - "group": "assert" - }, - { - "command": "has-int8array-support", - "description": "Detect Int8Array support.", - "path": "@stdlib/assert/has-int8array-support", - "group": "assert" - }, - { - "command": "has-iterator-symbol-support", - "description": "Detect Symbol.iterator support.", - "path": "@stdlib/assert/has-iterator-symbol-support", - "group": "assert" - }, - { - "command": "has-map-support", - "description": "Detect Map support.", - "path": "@stdlib/assert/has-map-support", - "group": "assert" - }, - { - "command": "has-node-buffer-support", - "description": "Detect Node buffer support.", - "path": "@stdlib/assert/has-node-buffer-support", - "group": "assert" - }, - { - "command": "has-proxy-support", - "description": "Detect Proxy support.", - "path": "@stdlib/assert/has-proxy-support", - "group": "assert" - }, - { - "command": "has-set-support", - "description": "Detect Set support.", - "path": "@stdlib/assert/has-set-support", - "group": "assert" - }, - { - "command": "has-sharedarraybuffer-support", - "description": "Detect SharedArrayBuffer support.", - "path": "@stdlib/assert/has-sharedarraybuffer-support", - "group": "assert" - }, - { - "command": "has-symbol-support", - "description": "Detect Symbol support.", - "path": "@stdlib/assert/has-symbol-support", - "group": "assert" - }, - { - "command": "has-tostringtag-support", - "description": "Detect Symbol.toStringTag support.", - "path": "@stdlib/assert/has-tostringtag-support", - "group": "assert" - }, - { - "command": "has-uint16array-support", - "description": "Detect Uit16Array support.", - "path": "@stdlib/assert/has-uint16array-support", - "group": "assert" - }, - { - "command": "has-uint32array-support", - "description": "Detect Uit32Array support.", - "path": "@stdlib/assert/has-uint32array-support", - "group": "assert" - }, - { - "command": "has-uint8array-support", - "description": "Detect Uit8Array support.", - "path": "@stdlib/assert/has-uint8array-support", - "group": "assert" - }, - { - "command": "has-uint8clampedarray-support", - "description": "Detect Uit8ClampedArray support.", - "path": "@stdlib/assert/has-uint8clampedarray-support", - "group": "assert" - }, - { - "command": "has-wasm-support", - "description": "Detect WebAssembly support.", - "path": "@stdlib/assert/has-wasm-support", - "group": "assert" - }, - { - "command": "has-weakmap-support", - "description": "Detect WeakMap support.", - "path": "@stdlib/assert/has-weakmap-support", - "group": "assert" - }, - { - "command": "has-weakset-support", - "description": "Detect WeakSet support.", - "path": "@stdlib/assert/has-weakset-support", - "group": "assert" - }, - { - "command": "homedir", - "description": "Home directory path.", - "path": "@stdlib/os/homedir", - "group": "system" - }, - { - "command": "hours-in-month", - "description": "Calculate the number of hours in a month.", - "path": "@stdlib/time/hours-in-month", - "group": "time" - }, - { - "command": "hours-in-year", - "description": "Calculate the number of hours in a year.", - "path": "@stdlib/time/hours-in-year", - "group": "time" - }, - { - "command": "iso-weeks-in-year", - "description": "Calculate the number of ISO weeks in a year.", - "path": "@stdlib/time/iso-weeks-in-year", - "group": "time" - }, - { - "command": "is-absolute-path", - "description": "Assert an absolute path.", - "path": "@stdlib/assert/is-absolute-path", - "group": "assert" - }, - { - "command": "is-alphagram", - "description": "Assert if a value is an alphagram.", - "path": "@stdlib/assert/is-alphagram", - "group": "assert" - }, - { - "command": "is-alphanumeric", - "description": "Assert if a value is alphanumeric.", - "path": "@stdlib/assert/is-alphanumeric", - "group": "assert" - }, - { - "command": "is-anagram", - "description": "Assert if a value is an anagram.", - "path": "@stdlib/assert/is-anagram", - "group": "assert" - }, - { - "command": "is-ascii", - "description": "Assert if a value is ASCII.", - "path": "@stdlib/assert/is-ascii", - "group": "assert" - }, - { - "command": "is-binary-string", - "description": "Assert if a value is a binary string.", - "path": "@stdlib/assert/is-binary-string", - "group": "assert" - }, - { - "command": "is-capitalized", - "description": "Assert if a value is capitalized.", - "path": "@stdlib/assert/is-capitalized", - "group": "assert" - }, - { - "command": "is-digit-string", - "description": "Assert if a value is a digit string.", - "path": "@stdlib/assert/is-digit-string", - "group": "assert" - }, - { - "command": "is-email-address", - "description": "Assert if a value is an email address.", - "path": "@stdlib/assert/is-email-address", - "group": "assert" - }, - { - "command": "is-hex-string", - "description": "Assert if a value is a hexadecimal string.", - "path": "@stdlib/assert/is-hex-string", - "group": "assert" - }, - { - "command": "is-leap-year", - "description": "Assert if a leap year.", - "path": "@stdlib/assert/is-leap-year", - "group": "assert" - }, - { - "command": "is-little-endian", - "description": "Assert if little endian.", - "path": "@stdlib/assert/is-little-endian", - "group": "assert" - }, - { - "command": "is-lowercase", - "description": "Assert if a value is lowercase.", - "path": "@stdlib/assert/is-lowercase", - "group": "assert" - }, - { - "command": "is-regexp-string", - "description": "Assert if a value is a regexp string.", - "path": "@stdlib/assert/is-regexp-string", - "group": "assert" - }, - { - "command": "is-unc-path", - "description": "Assert a UNC path.", - "path": "@stdlib/assert/is-unc-path", - "group": "assert" - }, - { - "command": "is-uppercase", - "description": "Assert if a value is uppercase.", - "path": "@stdlib/assert/is-uppercase", - "group": "assert" - }, - { - "command": "is-uri", - "description": "Assert if a value is a URI.", - "path": "@stdlib/assert/is-uri", - "group": "assert" - }, - { - "command": "is-whitespace", - "description": "Assert if a value is only whitespace.", - "path": "@stdlib/assert/is-whitespace", - "group": "assert" - }, - { - "command": "js-eval", - "description": "Evaluate a JavaScript string.", - "path": "@stdlib/utils/eval", - "group": "utilities" - }, - { - "command": "library-manifest", - "description": "Load a manifest for compiling source files.", - "path": "@stdlib/utils/library-manifest", - "group": "meta" - }, - { - "command": "lpad", - "description": "Left pad a string.", - "path": "@stdlib/string/left-pad", - "group": "utilities" - }, - { - "command": "ltrim", - "description": "Left trim a string.", - "path": "@stdlib/string/left-trim", - "group": "utilities" - }, - { - "command": "lowercase", - "description": "Lowercase a string.", - "path": "@stdlib/string/lowercase", - "group": "utilities" - }, - { - "command": "ls", - "description": "List stdlib package names.", - "path": "@stdlib/_tools/pkgs/names", - "group": "meta" - }, - { - "command": "ls-tree", - "description": "Show stdlib package tree.", - "path": "@stdlib/_tools/pkgs/tree", - "group": "meta" - }, - { - "command": "minutes-in-month", - "description": "Calculate the number of minutes in a month.", - "path": "@stdlib/time/minutes-in-month", - "group": "time" - }, - { - "command": "minutes-in-year", - "description": "Calculate the number of minutes in a year.", - "path": "@stdlib/time/minutes-in-year", - "group": "time" - }, - { - "command": "node-version", - "description": "Node.js version.", - "path": "@stdlib/process/node-version", - "group": "meta" - }, - { - "command": "now", - "description": "Number of seconds since the epoch.", - "path": "@stdlib/time/now", - "group": "time" - }, - { - "command": "ns", - "description": "Print stdlib namespace.", - "path": "@stdlib/namespace", - "group": "meta" - }, - { - "command": "num-cpus", - "description": "Number of CPUs.", - "path": "@stdlib/os/num-cpus", - "group": "system" - }, - { - "command": "random-arcsine", - "description": "Arcsine distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/arcsine", - "group": "random" - }, - { - "command": "random-bernoulli", - "description": "Bernoulli distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/bernoulli", - "group": "random" - }, - { - "command": "random-beta", - "description": "Beta distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/beta", - "group": "random" - }, - { - "command": "random-betaprime", - "description": "Beta prime distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/betaprime", - "group": "random" - }, - { - "command": "random-box-muller", - "description": "Box-Muller pseudorandom numbers.", - "path": "@stdlib/random/streams/box-muller", - "group": "random" - }, - { - "command": "random-cauchy", - "description": "Cauchy distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/cauchy", - "group": "random" - }, - { - "command": "random-chi", - "description": "Chi distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/chi", - "group": "random" - }, - { - "command": "random-chisquare", - "description": "Chi-square distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/chisquare", - "group": "random" - }, - { - "command": "random-cosine", - "description": "Raised cosine distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/cosine", - "group": "random" - }, - { - "command": "random-discrete-uniform", - "description": "Uniformly distributed pseudorandom integers.", - "path": "@stdlib/random/streams/discrete-uniform", - "group": "random" - }, - { - "command": "random-erlang", - "description": "Erlang distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/erlang", - "group": "random" - }, - { - "command": "random-exponential", - "description": "Exponentially distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/exponential", - "group": "random" - }, - { - "command": "random-f", - "description": "F distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/f", - "group": "random" - }, - { - "command": "random-gamma", - "description": "Gamma distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/gamma", - "group": "random" - }, - { - "command": "random-geometric", - "description": "Geometric distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/geometric", - "group": "random" - }, - { - "command": "random-gumbel", - "description": "Gumbel distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/gumbel", - "group": "random" - }, - { - "command": "random-improved-ziggurat", - "description": "Improved Ziggurat pseudorandom numbers.", - "path": "@stdlib/random/streams/improved-ziggurat", - "group": "random" - }, - { - "command": "random-invgamma", - "description": "Inverse gamma distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/invgamma", - "group": "random" - }, - { - "command": "random-kumaraswamy", - "description": "Kumaraswamy distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/kumaraswamy", - "group": "random" - }, - { - "command": "random-laplace", - "description": "Laplace distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/laplace", - "group": "random" - }, - { - "command": "random-levy", - "description": "Lévy distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/levy", - "group": "random" - }, - { - "command": "random-logistic", - "description": "Logistic distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/logistic", - "group": "random" - }, - { - "command": "random-lognormal", - "description": "Lognormal distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/lognormal", - "group": "random" - }, - { - "command": "random-minstd", - "description": "Park and Miller LCG pseudorandom numbers.", - "path": "@stdlib/random/streams/minstd", - "group": "random" - }, - { - "command": "random-minstd-shuffle", - "description": "Shuffled LCG pseudorandom numbers.", - "path": "@stdlib/random/streams/minstd-shuffle", - "group": "random" - }, - { - "command": "random-mt19937", - "description": "32-bit Mersenne Twister pseudorandom numbers.", - "path": "@stdlib/random/streams/mt19937", - "group": "random" - }, - { - "command": "random-normal", - "description": "Normally distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/normal", - "group": "random" - }, - { - "command": "random-pareto-type1", - "description": "Pareto (type 1) distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/pareto-type1", - "group": "random" - }, - { - "command": "random-poisson", - "description": "Poisson distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/poisson", - "group": "random" - }, - { - "command": "random-randi", - "description": "Pseudorandom numbers having integer values.", - "path": "@stdlib/random/streams/randi", - "group": "random" - }, - { - "command": "random-randn", - "description": "Normally distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/randn", - "group": "random" - }, - { - "command": "random-randu", - "description": "Pseudorandom numbers between 0 and 1.", - "path": "@stdlib/random/streams/randu", - "group": "random" - }, - { - "command": "random-Rayleigh", - "description": "Rayleigh distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/rayleigh", - "group": "random" - }, - { - "command": "random-t", - "description": "Student's t distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/t", - "group": "random" - }, - { - "command": "random-uniform", - "description": "Uniformly distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/uniform", - "group": "random" - }, - { - "command": "random-weibull", - "description": "Weibull distributed pseudorandom numbers.", - "path": "@stdlib/random/streams/weibull", - "group": "random" - }, - { - "command": "open-url", - "description": "Open a URL.", - "path": "@stdlib/utils/open-url", - "group": "utilities" - }, - { - "command": "padstr", - "description": "Pad a string.", - "path": "@stdlib/string/pad", - "group": "utilities" - }, - { - "command": "parallel", - "description": "Execute scripts in parallel.", - "path": "@stdlib/utils/parallel", - "group": "utilities" - }, - { - "command": "percent-encode", - "description": "Percent-encode a UTF-16 encoded string.", - "path": "@stdlib/string/percent-encode", - "group": "utilities" - }, - { - "command": "platform", - "description": "Platform.", - "path": "@stdlib/os/platform", - "group": "system" - }, - { - "command": "quarter-of-year", - "description": "Calculate the quarter of a year.", - "path": "@stdlib/time/quarter-of-year", - "group": "time" - }, - { - "command": "read-dir", - "description": "Read all files in a directory.", - "path": "@stdlib/fs/read-dir", - "group": "filesystem" - }, - { - "command": "read-file", - "description": "Read a file.", - "path": "@stdlib/fs/read-file", - "group": "filesystem" - }, - { - "command": "read-file-list", - "description": "Read a list of files.", - "path": "@stdlib/fs/read-file-list", - "group": "filesystem" - }, - { - "command": "realmax", - "description": "Maximum representable finite value.", - "path": "@stdlib/utils/real-max", - "group": "utilities" - }, - { - "command": "realmin", - "description": "Minimum representable finite value.", - "path": "@stdlib/utils/real-min", - "group": "utilities" - }, - { - "command": "remove-first", - "description": "Remove the first character in a string.", - "path": "@stdlib/string/remove-first", - "group": "utilities" - }, - { - "command": "remove-last", - "description": "Remove the last character in a string.", - "path": "@stdlib/string/remove-last", - "group": "utilities" - }, - { - "command": "remove-punctuation", - "description": "Remove punctuation characters from a string.", - "path": "@stdlib/string/remove-punctuation", - "group": "utilities" - }, - { - "command": "remove-utf8-bom", - "description": "Remove a UTF-8 byte order mark (BOM).", - "path": "@stdlib/string/remove-first", - "group": "utilities" - }, - { - "command": "remove-words", - "description": "Remove a list of words from a string.", - "path": "@stdlib/string/remove-words", - "group": "utilities" - }, - { - "command": "rename", - "description": "Rename a file.", - "path": "@stdlib/fs/rename", - "group": "filesystem" - }, - { - "command": "repstr", - "description": "Repeat a string.", - "path": "@stdlib/string/repeat", - "group": "utilities" - }, - { - "command": "repl", - "description": "Start a REPL.", - "path": "@stdlib/repl/cli", - "group": "general" - }, - { - "command": "repl-presentation", - "description": "Start a REPL presentation.", - "path": "@stdlib/repl/cli/presentation", - "group": "general" - }, - { - "command": "replace", - "description": "Replace search occurrences in a string.", - "path": "@stdlib/string/replace", - "group": "utilities" - }, - { - "command": "resolve-parent-path", - "description": "Resolve a path by walking parent directories.", - "path": "@stdlib/fs/resolve-parent-path", - "group": "filesystem" - }, - { - "command": "reverse", - "description": "Reverse a string.", - "path": "@stdlib/string/reverse", - "group": "utilities" - }, - { - "command": "rpad", - "description": "Right pad a string.", - "path": "@stdlib/string/right-pad", - "group": "utilities" - }, - { - "command": "rtrim", - "description": "Right trim a string.", - "path": "@stdlib/string/right-trim", - "group": "utilities" - }, - { - "command": "safeintmax", - "description": "Maximum representable safe integer value.", - "path": "@stdlib/utils/safe-int-max", - "group": "utilities" - }, - { - "command": "safeintmin", - "description": "Minimum representable safe integer value.", - "path": "@stdlib/utils/safe-int-min", - "group": "utilities" - }, - { - "command": "seconds-in-month", - "description": "Calculate the number of seconds in a month.", - "path": "@stdlib/time/seconds-in-month", - "group": "time" - }, - { - "command": "seconds-in-year", - "description": "Calculate the number of seconds in a year.", - "path": "@stdlib/time/seconds-in-year", - "group": "time" - }, - { - "command": "sizeof", - "description": "Size (in bytes) of a numeric data type.", - "path": "@stdlib/utils/size-of", - "group": "utilities" - }, - { - "command": "sparkline", - "description": "Plot a sparkline.", - "path": "@stdlib/plot/sparklines/unicode", - "group": "plot" - }, - { - "command": "startcase", - "description": "Capitalize each word in a string.", - "path": "@stdlib/string/startcase", - "group": "utilities" - }, - { - "command": "starts-with", - "description": "Test if a string starts with another string.", - "path": "@stdlib/string/starts-with", - "group": "utilities" - }, - { - "command": "temp-http-server", - "description": "Create a temporary HTTP server.", - "path": "@stdlib/net/disposable-http-server", - "group": "utilities" - }, - { - "command": "timeit", - "description": "Time a JavaScript snippet.", - "path": "@stdlib/utils/timeit", - "group": "benchmarking" - }, - { - "command": "tmpdir", - "description": "Directory path for storing temporary files.", - "path": "@stdlib/os/tmpdir", - "group": "system" - }, - { - "command": "trim", - "description": "Trim a string.", - "path": "@stdlib/string/trim", - "group": "utilities" - }, - { - "command": "typemax", - "description": "Maximum value for a numeric data type.", - "path": "@stdlib/utils/type-max", - "group": "utilities" - }, - { - "command": "typemin", - "description": "Minimum value for a numeric data type.", - "path": "@stdlib/utils/type-min", - "group": "utilities" - }, - { - "command": "umask", - "description": "Process mask.", - "path": "@stdlib/process/umask", - "group": "system" - }, - { - "command": "uncapitalize", - "description": "Uncapitalize a string.", - "path": "@stdlib/string/uncapitalize", - "group": "utilities" - }, - { - "command": "unlink", - "description": "Remove a file.", - "path": "@stdlib/fs/unlink", - "group": "filesystem" - }, - { - "command": "uppercase", - "description": "Uppercase a string.", - "path": "@stdlib/string/uppercase", - "group": "utilities" - }, - { - "command": "write-file", - "description": "Write to file.", - "path": "@stdlib/fs/write-file", - "group": "filesystem" - }, - { - "command": "constant-stream", - "description": "Stream a constant value.", - "path": "@stdlib/streams/node/from-constant", - "group": "utilities" - }, - { - "command": "empty-stream", - "description": "Empty stream.", - "path": "@stdlib/streams/node/empty", - "group": "utilities" - } + { + "command": "help [command]", + "description": "Print a help message.", + "path": "", + "group": "general" + }, + { + "command": "arch", + "description": "Operating system CPU architecture.", + "path": "@stdlib/os/arch", + "group": "system" + }, + { + "command": "bench", + "description": "Run JavaScript benchmark files.", + "path": "@stdlib/bench", + "group": "benchmarking" + }, + { + "command": "bundle-pkg-list", + "description": "Bundle a list of stdlib packages.", + "path": "@stdlib/_tools/bundle/pkg-list", + "group": "tools" + }, + { + "command": "capitalize", + "description": "Capitalize the first character in a string.", + "path": "@stdlib/string/capitalize", + "group": "utilities" + }, + { + "command": "configdir", + "description": "Configuration directory path.", + "path": "@stdlib/os/configdir", + "group": "system" + }, + { + "command": "convert-path", + "description": "Convert between Windows and POSIX paths.", + "path": "@stdlib/utils/convert-path", + "group": "utilities" + }, + { + "command": "cwd", + "description": "Current working directory.", + "path": "@stdlib/process/cwd", + "group": "system" + }, + { + "command": "datasets", + "description": "Retrieve a dataset.", + "path": "@stdlib/datasets", + "group": "general" + }, + { + "command": "day-of-quarter", + "description": "Calculate day of quarter.", + "path": "@stdlib/time/day-of-quarter", + "group": "time" + }, + { + "command": "day-of-year", + "description": "Calculate day of year.", + "path": "@stdlib/time/day-of-year", + "group": "time" + }, + { + "command": "days-in-month", + "description": "Calculate the number of days in a month.", + "path": "@stdlib/time/days-in-month", + "group": "time" + }, + { + "command": "days-in-year", + "description": "Calculate the number of days in a year.", + "path": "@stdlib/time/days-in-year", + "group": "time" + }, + { + "command": "ends-with", + "description": "Test if a string ends with another string.", + "path": "@stdlib/string/ends-with", + "group": "utilities" + }, + { + "command": "exists", + "description": "Test if a file exists.", + "path": "@stdlib/fs/exists", + "group": "filesystem" + }, + { + "command": "from-code-point", + "description": "Create a string from code points.", + "path": "@stdlib/string/from-code-point", + "group": "utilities" + }, + { + "command": "has-arraybuffer-support", + "description": "Detect ArrayBuffer support.", + "path": "@stdlib/assert/has-arraybuffer-support", + "group": "assert" + }, + { + "command": "has-async-await-support", + "description": "Detect async/await support.", + "path": "@stdlib/assert/has-async-await-support", + "group": "assert" + }, + { + "command": "has-async-iterator-symbol-support", + "description": "Detect Symbol.asyncIterator support.", + "path": "@stdlib/assert/has-async-iterator-symbol-support", + "group": "assert" + }, + { + "command": "has-class-support", + "description": "Detect ES6 class support.", + "path": "@stdlib/assert/has-class-support", + "group": "assert" + }, + { + "command": "has-float32array-support", + "description": "Detect Float32Array support.", + "path": "@stdlib/assert/has-float32array-support", + "group": "assert" + }, + { + "command": "has-float64array-support", + "description": "Detect Float64Array support.", + "path": "@stdlib/assert/has-float64array-support", + "group": "assert" + }, + { + "command": "has-function-name-support", + "description": "Detect function name support.", + "path": "@stdlib/assert/has-function-name-support", + "group": "assert" + }, + { + "command": "has-generator-support", + "description": "Detect generator support.", + "path": "@stdlib/assert/has-generator-support", + "group": "assert" + }, + { + "command": "has-int16array-support", + "description": "Detect Int16Array support.", + "path": "@stdlib/assert/has-int16array-support", + "group": "assert" + }, + { + "command": "has-int32array-support", + "description": "Detect Int32Array support.", + "path": "@stdlib/assert/has-int32array-support", + "group": "assert" + }, + { + "command": "has-int8array-support", + "description": "Detect Int8Array support.", + "path": "@stdlib/assert/has-int8array-support", + "group": "assert" + }, + { + "command": "has-iterator-symbol-support", + "description": "Detect Symbol.iterator support.", + "path": "@stdlib/assert/has-iterator-symbol-support", + "group": "assert" + }, + { + "command": "has-map-support", + "description": "Detect Map support.", + "path": "@stdlib/assert/has-map-support", + "group": "assert" + }, + { + "command": "has-node-buffer-support", + "description": "Detect Node buffer support.", + "path": "@stdlib/assert/has-node-buffer-support", + "group": "assert" + }, + { + "command": "has-proxy-support", + "description": "Detect Proxy support.", + "path": "@stdlib/assert/has-proxy-support", + "group": "assert" + }, + { + "command": "has-set-support", + "description": "Detect Set support.", + "path": "@stdlib/assert/has-set-support", + "group": "assert" + }, + { + "command": "has-sharedarraybuffer-support", + "description": "Detect SharedArrayBuffer support.", + "path": "@stdlib/assert/has-sharedarraybuffer-support", + "group": "assert" + }, + { + "command": "has-symbol-support", + "description": "Detect Symbol support.", + "path": "@stdlib/assert/has-symbol-support", + "group": "assert" + }, + { + "command": "has-tostringtag-support", + "description": "Detect Symbol.toStringTag support.", + "path": "@stdlib/assert/has-tostringtag-support", + "group": "assert" + }, + { + "command": "has-uint16array-support", + "description": "Detect Uit16Array support.", + "path": "@stdlib/assert/has-uint16array-support", + "group": "assert" + }, + { + "command": "has-uint32array-support", + "description": "Detect Uit32Array support.", + "path": "@stdlib/assert/has-uint32array-support", + "group": "assert" + }, + { + "command": "has-uint8array-support", + "description": "Detect Uit8Array support.", + "path": "@stdlib/assert/has-uint8array-support", + "group": "assert" + }, + { + "command": "has-uint8clampedarray-support", + "description": "Detect Uit8ClampedArray support.", + "path": "@stdlib/assert/has-uint8clampedarray-support", + "group": "assert" + }, + { + "command": "has-wasm-support", + "description": "Detect WebAssembly support.", + "path": "@stdlib/assert/has-wasm-support", + "group": "assert" + }, + { + "command": "has-weakmap-support", + "description": "Detect WeakMap support.", + "path": "@stdlib/assert/has-weakmap-support", + "group": "assert" + }, + { + "command": "has-weakset-support", + "description": "Detect WeakSet support.", + "path": "@stdlib/assert/has-weakset-support", + "group": "assert" + }, + { + "command": "homedir", + "description": "Home directory path.", + "path": "@stdlib/os/homedir", + "group": "system" + }, + { + "command": "hours-in-month", + "description": "Calculate the number of hours in a month.", + "path": "@stdlib/time/hours-in-month", + "group": "time" + }, + { + "command": "hours-in-year", + "description": "Calculate the number of hours in a year.", + "path": "@stdlib/time/hours-in-year", + "group": "time" + }, + { + "command": "iso-weeks-in-year", + "description": "Calculate the number of ISO weeks in a year.", + "path": "@stdlib/time/iso-weeks-in-year", + "group": "time" + }, + { + "command": "is-absolute-path", + "description": "Assert an absolute path.", + "path": "@stdlib/assert/is-absolute-path", + "group": "assert" + }, + { + "command": "is-alphagram", + "description": "Assert if a value is an alphagram.", + "path": "@stdlib/assert/is-alphagram", + "group": "assert" + }, + { + "command": "is-alphanumeric", + "description": "Assert if a value is alphanumeric.", + "path": "@stdlib/assert/is-alphanumeric", + "group": "assert" + }, + { + "command": "is-anagram", + "description": "Assert if a value is an anagram.", + "path": "@stdlib/assert/is-anagram", + "group": "assert" + }, + { + "command": "is-ascii", + "description": "Assert if a value is ASCII.", + "path": "@stdlib/assert/is-ascii", + "group": "assert" + }, + { + "command": "is-binary-string", + "description": "Assert if a value is a binary string.", + "path": "@stdlib/assert/is-binary-string", + "group": "assert" + }, + { + "command": "is-capitalized", + "description": "Assert if a value is capitalized.", + "path": "@stdlib/assert/is-capitalized", + "group": "assert" + }, + { + "command": "is-digit-string", + "description": "Assert if a value is a digit string.", + "path": "@stdlib/assert/is-digit-string", + "group": "assert" + }, + { + "command": "is-email-address", + "description": "Assert if a value is an email address.", + "path": "@stdlib/assert/is-email-address", + "group": "assert" + }, + { + "command": "is-hex-string", + "description": "Assert if a value is a hexadecimal string.", + "path": "@stdlib/assert/is-hex-string", + "group": "assert" + }, + { + "command": "is-leap-year", + "description": "Assert if a leap year.", + "path": "@stdlib/assert/is-leap-year", + "group": "assert" + }, + { + "command": "is-little-endian", + "description": "Assert if little endian.", + "path": "@stdlib/assert/is-little-endian", + "group": "assert" + }, + { + "command": "is-lowercase", + "description": "Assert if a value is lowercase.", + "path": "@stdlib/assert/is-lowercase", + "group": "assert" + }, + { + "command": "is-regexp-string", + "description": "Assert if a value is a regexp string.", + "path": "@stdlib/assert/is-regexp-string", + "group": "assert" + }, + { + "command": "is-unc-path", + "description": "Assert a UNC path.", + "path": "@stdlib/assert/is-unc-path", + "group": "assert" + }, + { + "command": "is-uppercase", + "description": "Assert if a value is uppercase.", + "path": "@stdlib/assert/is-uppercase", + "group": "assert" + }, + { + "command": "is-uri", + "description": "Assert if a value is a URI.", + "path": "@stdlib/assert/is-uri", + "group": "assert" + }, + { + "command": "is-whitespace", + "description": "Assert if a value is only whitespace.", + "path": "@stdlib/assert/is-whitespace", + "group": "assert" + }, + { + "command": "js-eval", + "description": "Evaluate a JavaScript string.", + "path": "@stdlib/utils/eval", + "group": "utilities" + }, + { + "command": "library-manifest", + "description": "Load a manifest for compiling source files.", + "path": "@stdlib/utils/library-manifest", + "group": "meta" + }, + { + "command": "lpad", + "description": "Left pad a string.", + "path": "@stdlib/string/left-pad", + "group": "utilities" + }, + { + "command": "ltrim", + "description": "Left trim a string.", + "path": "@stdlib/string/left-trim", + "group": "utilities" + }, + { + "command": "lowercase", + "description": "Lowercase a string.", + "path": "@stdlib/string/lowercase", + "group": "utilities" + }, + { + "command": "ls", + "description": "List stdlib package names.", + "path": "@stdlib/_tools/pkgs/names", + "group": "meta" + }, + { + "command": "ls-tree", + "description": "Show stdlib package tree.", + "path": "@stdlib/_tools/pkgs/tree", + "group": "meta" + }, + { + "command": "minutes-in-month", + "description": "Calculate the number of minutes in a month.", + "path": "@stdlib/time/minutes-in-month", + "group": "time" + }, + { + "command": "minutes-in-year", + "description": "Calculate the number of minutes in a year.", + "path": "@stdlib/time/minutes-in-year", + "group": "time" + }, + { + "command": "node-version", + "description": "Node.js version.", + "path": "@stdlib/process/node-version", + "group": "meta" + }, + { + "command": "now", + "description": "Number of seconds since the epoch.", + "path": "@stdlib/time/now", + "group": "time" + }, + { + "command": "ns", + "description": "Print stdlib namespace.", + "path": "@stdlib/namespace", + "group": "meta" + }, + { + "command": "num-cpus", + "description": "Number of CPUs.", + "path": "@stdlib/os/num-cpus", + "group": "system" + }, + { + "command": "random-arcsine", + "description": "Arcsine distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/arcsine", + "group": "random" + }, + { + "command": "random-bernoulli", + "description": "Bernoulli distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/bernoulli", + "group": "random" + }, + { + "command": "random-beta", + "description": "Beta distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/beta", + "group": "random" + }, + { + "command": "random-betaprime", + "description": "Beta prime distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/betaprime", + "group": "random" + }, + { + "command": "random-box-muller", + "description": "Box-Muller pseudorandom numbers.", + "path": "@stdlib/random/streams/box-muller", + "group": "random" + }, + { + "command": "random-cauchy", + "description": "Cauchy distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/cauchy", + "group": "random" + }, + { + "command": "random-chi", + "description": "Chi distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/chi", + "group": "random" + }, + { + "command": "random-chisquare", + "description": "Chi-square distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/chisquare", + "group": "random" + }, + { + "command": "random-cosine", + "description": "Raised cosine distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/cosine", + "group": "random" + }, + { + "command": "random-discrete-uniform", + "description": "Uniformly distributed pseudorandom integers.", + "path": "@stdlib/random/streams/discrete-uniform", + "group": "random" + }, + { + "command": "random-erlang", + "description": "Erlang distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/erlang", + "group": "random" + }, + { + "command": "random-exponential", + "description": "Exponentially distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/exponential", + "group": "random" + }, + { + "command": "random-f", + "description": "F distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/f", + "group": "random" + }, + { + "command": "random-gamma", + "description": "Gamma distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/gamma", + "group": "random" + }, + { + "command": "random-geometric", + "description": "Geometric distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/geometric", + "group": "random" + }, + { + "command": "random-gumbel", + "description": "Gumbel distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/gumbel", + "group": "random" + }, + { + "command": "random-improved-ziggurat", + "description": "Improved Ziggurat pseudorandom numbers.", + "path": "@stdlib/random/streams/improved-ziggurat", + "group": "random" + }, + { + "command": "random-invgamma", + "description": "Inverse gamma distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/invgamma", + "group": "random" + }, + { + "command": "random-kumaraswamy", + "description": "Kumaraswamy distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/kumaraswamy", + "group": "random" + }, + { + "command": "random-laplace", + "description": "Laplace distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/laplace", + "group": "random" + }, + { + "command": "random-levy", + "description": "Lévy distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/levy", + "group": "random" + }, + { + "command": "random-logistic", + "description": "Logistic distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/logistic", + "group": "random" + }, + { + "command": "random-lognormal", + "description": "Lognormal distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/lognormal", + "group": "random" + }, + { + "command": "random-minstd", + "description": "Park and Miller LCG pseudorandom numbers.", + "path": "@stdlib/random/streams/minstd", + "group": "random" + }, + { + "command": "random-minstd-shuffle", + "description": "Shuffled LCG pseudorandom numbers.", + "path": "@stdlib/random/streams/minstd-shuffle", + "group": "random" + }, + { + "command": "random-mt19937", + "description": "32-bit Mersenne Twister pseudorandom numbers.", + "path": "@stdlib/random/streams/mt19937", + "group": "random" + }, + { + "command": "random-normal", + "description": "Normally distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/normal", + "group": "random" + }, + { + "command": "random-pareto-type1", + "description": "Pareto (type 1) distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/pareto-type1", + "group": "random" + }, + { + "command": "random-poisson", + "description": "Poisson distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/poisson", + "group": "random" + }, + { + "command": "random-randi", + "description": "Pseudorandom numbers having integer values.", + "path": "@stdlib/random/streams/randi", + "group": "random" + }, + { + "command": "random-randn", + "description": "Normally distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/randn", + "group": "random" + }, + { + "command": "random-randu", + "description": "Pseudorandom numbers between 0 and 1.", + "path": "@stdlib/random/streams/randu", + "group": "random" + }, + { + "command": "random-Rayleigh", + "description": "Rayleigh distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/rayleigh", + "group": "random" + }, + { + "command": "random-t", + "description": "Student's t distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/t", + "group": "random" + }, + { + "command": "random-uniform", + "description": "Uniformly distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/uniform", + "group": "random" + }, + { + "command": "random-weibull", + "description": "Weibull distributed pseudorandom numbers.", + "path": "@stdlib/random/streams/weibull", + "group": "random" + }, + { + "command": "open-url", + "description": "Open a URL.", + "path": "@stdlib/utils/open-url", + "group": "utilities" + }, + { + "command": "padstr", + "description": "Pad a string.", + "path": "@stdlib/string/pad", + "group": "utilities" + }, + { + "command": "parallel", + "description": "Execute scripts in parallel.", + "path": "@stdlib/utils/parallel", + "group": "utilities" + }, + { + "command": "percent-encode", + "description": "Percent-encode a UTF-16 encoded string.", + "path": "@stdlib/string/percent-encode", + "group": "utilities" + }, + { + "command": "platform", + "description": "Platform.", + "path": "@stdlib/os/platform", + "group": "system" + }, + { + "command": "quarter-of-year", + "description": "Calculate the quarter of a year.", + "path": "@stdlib/time/quarter-of-year", + "group": "time" + }, + { + "command": "read-dir", + "description": "Read all files in a directory.", + "path": "@stdlib/fs/read-dir", + "group": "filesystem" + }, + { + "command": "read-file", + "description": "Read a file.", + "path": "@stdlib/fs/read-file", + "group": "filesystem" + }, + { + "command": "read-file-list", + "description": "Read a list of files.", + "path": "@stdlib/fs/read-file-list", + "group": "filesystem" + }, + { + "command": "realmax", + "description": "Maximum representable finite value.", + "path": "@stdlib/utils/real-max", + "group": "utilities" + }, + { + "command": "realmin", + "description": "Minimum representable finite value.", + "path": "@stdlib/utils/real-min", + "group": "utilities" + }, + { + "command": "remove-first", + "description": "Remove the first character in a string.", + "path": "@stdlib/string/remove-first", + "group": "utilities" + }, + { + "command": "remove-last", + "description": "Remove the last character in a string.", + "path": "@stdlib/string/remove-last", + "group": "utilities" + }, + { + "command": "remove-punctuation", + "description": "Remove punctuation characters from a string.", + "path": "@stdlib/string/remove-punctuation", + "group": "utilities" + }, + { + "command": "remove-utf8-bom", + "description": "Remove a UTF-8 byte order mark (BOM).", + "path": "@stdlib/string/remove-first", + "group": "utilities" + }, + { + "command": "remove-words", + "description": "Remove a list of words from a string.", + "path": "@stdlib/string/remove-words", + "group": "utilities" + }, + { + "command": "rename", + "description": "Rename a file.", + "path": "@stdlib/fs/rename", + "group": "filesystem" + }, + { + "command": "repstr", + "description": "Repeat a string.", + "path": "@stdlib/string/repeat", + "group": "utilities" + }, + { + "command": "repl", + "description": "Start a REPL.", + "path": "@stdlib/repl/cli", + "group": "general" + }, + { + "command": "repl-presentation", + "description": "Start a REPL presentation.", + "path": "@stdlib/repl/cli/presentation", + "group": "general" + }, + { + "command": "replace", + "description": "Replace search occurrences in a string.", + "path": "@stdlib/string/replace", + "group": "utilities" + }, + { + "command": "resolve-parent-path", + "description": "Resolve a path by walking parent directories.", + "path": "@stdlib/fs/resolve-parent-path", + "group": "filesystem" + }, + { + "command": "reverse", + "description": "Reverse a string.", + "path": "@stdlib/string/reverse", + "group": "utilities" + }, + { + "command": "rpad", + "description": "Right pad a string.", + "path": "@stdlib/string/right-pad", + "group": "utilities" + }, + { + "command": "rtrim", + "description": "Right trim a string.", + "path": "@stdlib/string/right-trim", + "group": "utilities" + }, + { + "command": "safeintmax", + "description": "Maximum representable safe integer value.", + "path": "@stdlib/utils/safe-int-max", + "group": "utilities" + }, + { + "command": "safeintmin", + "description": "Minimum representable safe integer value.", + "path": "@stdlib/utils/safe-int-min", + "group": "utilities" + }, + { + "command": "seconds-in-month", + "description": "Calculate the number of seconds in a month.", + "path": "@stdlib/time/seconds-in-month", + "group": "time" + }, + { + "command": "seconds-in-year", + "description": "Calculate the number of seconds in a year.", + "path": "@stdlib/time/seconds-in-year", + "group": "time" + }, + { + "command": "sizeof", + "description": "Size (in bytes) of a numeric data type.", + "path": "@stdlib/utils/size-of", + "group": "utilities" + }, + { + "command": "sparkline", + "description": "Plot a sparkline.", + "path": "@stdlib/plot/sparklines/unicode", + "group": "plot" + }, + { + "command": "startcase", + "description": "Capitalize each word in a string.", + "path": "@stdlib/string/startcase", + "group": "utilities" + }, + { + "command": "starts-with", + "description": "Test if a string starts with another string.", + "path": "@stdlib/string/starts-with", + "group": "utilities" + }, + { + "command": "temp-http-server", + "description": "Create a temporary HTTP server.", + "path": "@stdlib/net/disposable-http-server", + "group": "utilities" + }, + { + "command": "timeit", + "description": "Time a JavaScript snippet.", + "path": "@stdlib/utils/timeit", + "group": "benchmarking" + }, + { + "command": "tmpdir", + "description": "Directory path for storing temporary files.", + "path": "@stdlib/os/tmpdir", + "group": "system" + }, + { + "command": "trim", + "description": "Trim a string.", + "path": "@stdlib/string/trim", + "group": "utilities" + }, + { + "command": "typemax", + "description": "Maximum value for a numeric data type.", + "path": "@stdlib/utils/type-max", + "group": "utilities" + }, + { + "command": "typemin", + "description": "Minimum value for a numeric data type.", + "path": "@stdlib/utils/type-min", + "group": "utilities" + }, + { + "command": "umask", + "description": "Process mask.", + "path": "@stdlib/process/umask", + "group": "system" + }, + { + "command": "uncapitalize", + "description": "Uncapitalize a string.", + "path": "@stdlib/string/uncapitalize", + "group": "utilities" + }, + { + "command": "unlink", + "description": "Remove a file.", + "path": "@stdlib/fs/unlink", + "group": "filesystem" + }, + { + "command": "uppercase", + "description": "Uppercase a string.", + "path": "@stdlib/string/uppercase", + "group": "utilities" + }, + { + "command": "write-file", + "description": "Write to file.", + "path": "@stdlib/fs/write-file", + "group": "filesystem" + }, + { + "command": "constant-stream", + "description": "Stream a constant value.", + "path": "@stdlib/streams/node/from-constant", + "group": "utilities" + }, + { + "command": "empty-stream", + "description": "Empty stream.", + "path": "@stdlib/streams/node/empty", + "group": "utilities" + } ] From fd1951ab3601d0f045a520e3049ddd270febad63 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 19:30:32 +0000 Subject: [PATCH 12/26] fix: revert redundant changes Signed-off-by: Snehil Shah --- 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 --- --- lib/node_modules/@stdlib/repl/cli/lib/commands/help.js | 3 ++- lib/node_modules/@stdlib/repl/cli/lib/index.js | 2 +- lib/node_modules/@stdlib/repl/cli/lib/main.js | 4 ---- 3 files changed, 3 insertions(+), 6 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/help.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/help.js index c1aa57b58da1..cf849a33b582 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/commands/help.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/commands/help.js @@ -29,6 +29,7 @@ var alias2help = require( '@stdlib/repl/help' ); var indexOf = require( './../index_of.js' ); var findUniqueEntry = require( './../find_unique_entry.js' ); var alias2string = require( './../alias_to_string.js' ); +var HELP_TEXT = require( './../help_text.js' ); var DOCS = require( './../repl_docs.js' ); @@ -59,7 +60,7 @@ function command( repl, cmds ) { var N; var i; if ( arguments.length === 0 ) { - repl._ostream.write( repl._helpText ); + repl._ostream.write( HELP_TEXT ); return; } aliases = repl._aliases; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/index.js b/lib/node_modules/@stdlib/repl/cli/lib/index.js index 54ac5fec5412..e2219323a672 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/index.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/index.js @@ -19,7 +19,7 @@ 'use strict'; /** -* REPL. +* REPL environment. * * @module @stdlib/repl/cli * diff --git a/lib/node_modules/@stdlib/repl/cli/lib/main.js b/lib/node_modules/@stdlib/repl/cli/lib/main.js index 8a6a24b94a7b..d88558e2d2ea 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/main.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/main.js @@ -68,7 +68,6 @@ var SyntaxHighlighter = require( './syntax_highlighter.js' ); var EagerEvaluator = require( './eager_evaluator.js' ); var SETTINGS = require( './settings.js' ); var SETTINGS_VALIDATORS = require( './settings_validators.js' ); -var HELP_TEXT = require( './help_text.js' ); // VARIABLES // @@ -198,9 +197,6 @@ function REPL( options ) { // Cache reference to the output stream: setNonEnumerableReadOnly( this, '_wstream', opts.output ); - // Define help text: - setNonEnumerableReadOnly( this, '_helpText', HELP_TEXT ); - // Cache options: setNonEnumerableReadOnly( this, '_inputPrompt', opts.inputPrompt ); setNonEnumerableReadOnly( this, '_outputPrompt', opts.outputPrompt ); From cce54d730a137f830981b07d8dba64402ef9df47 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 8 Mar 2025 19:33:03 +0000 Subject: [PATCH 13/26] docs: update package paths Signed-off-by: Snehil Shah --- 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: passed - task: lint_package_json status: na - task: lint_repl_help status: na - task: lint_javascript_src status: na - 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 --- --- .../@stdlib/repl/cli/presentation/README.md | 90 +++++++++---------- 1 file changed, 45 insertions(+), 45 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/README.md b/lib/node_modules/@stdlib/repl/cli/presentation/README.md index d27fc703d301..dca6d7d76b3a 100644 --- a/lib/node_modules/@stdlib/repl/cli/presentation/README.md +++ b/lib/node_modules/@stdlib/repl/cli/presentation/README.md @@ -20,13 +20,13 @@ limitations under the License. # REPL Presentation -> Run a [REPL][@stdlib/repl] presentation. +> Run a [REPL][@stdlib/repl/cli] presentation.
-This package allows building presentations using only a [REPL][@stdlib/repl] environment. +This package allows building presentations using only a [REPL][@stdlib/repl/cli] environment. @@ -46,7 +46,7 @@ This package allows building presentations using only a [REPL][@stdlib/repl] env ### Authoring -A [REPL][@stdlib/repl] presentation source file is a text file which includes minimal markup for delineating slides, slide fragments, speaker notes, code, text alignment, and styling. +A [REPL][@stdlib/repl/cli] presentation source file is a text file which includes minimal markup for delineating slides, slide fragments, speaker notes, code, text alignment, and styling. #### Slides @@ -140,7 +140,7 @@ var x = 3.14; ```` -Only JavaScript code blocks are runnable. To run JavaScript code on the current slide, invoke the presentation command `runSlide()` at the [REPL][@stdlib/repl] prompt. +Only JavaScript code blocks are runnable. To run JavaScript code on the current slide, invoke the presentation command `runSlide()` at the [REPL][@stdlib/repl/cli] prompt. #### Speaker Notes @@ -329,18 +329,18 @@ And lastly, custom patterns can include [emoji][@stdlib/datasets/emoji]. For exa ```javascript -var Presentation = require( '@stdlib/repl/presentation' ); +var Presentation = require( '@stdlib/repl/cli/presentation' ); ``` #### Presentation( \[text,] repl\[, options] ) -Returns a [REPL][@stdlib/repl] presentation instance for running a presentation in a provided [`repl`][@stdlib/repl]. +Returns a [REPL][@stdlib/repl/cli] presentation instance for running a presentation in a provided [`repl`][@stdlib/repl/cli]. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -363,11 +363,11 @@ The function accepts the following `options`: - **borderLeft**: left border character sequence. Default: `'* '`. - **borderRight**: right border character sequence. Default: `' *'`. - **counter**: slide counter. Can either be `true`, `false`, or `'progress'`. Default: `false`. -- **width**: presentation width. If `null`, the presentation width is either computed based on the screen size (if a [REPL][@stdlib/repl] output stream is TTY) or set to `80` characters. Default: `null`. -- **height**: presentation height. If `null`, the presentation height is either computed based on the screen size (if a [REPL][@stdlib/repl] output stream is TTY) or set to `25` rows. Default: `null`. -- **workspace**: [REPL][@stdlib/repl] workspace name. A presentation instance adds presentation commands to the specified workspace, thus allowing presentation navigation and interaction. Default: `'presentation'`. +- **width**: presentation width. If `null`, the presentation width is either computed based on the screen size (if a [REPL][@stdlib/repl/cli] output stream is TTY) or set to `80` characters. Default: `null`. +- **height**: presentation height. If `null`, the presentation height is either computed based on the screen size (if a [REPL][@stdlib/repl/cli] output stream is TTY) or set to `25` rows. Default: `null`. +- **workspace**: [REPL][@stdlib/repl/cli] workspace name. A presentation instance adds presentation commands to the specified workspace, thus allowing presentation navigation and interaction. Default: `'presentation'`. - **load**: file path specifying a presentation file to load. If a presentation `text` is provided, this option is **ignored**. -- **autoClear**: `boolean` indicating whether to automatically clear the screen before writing a rendered slide to the [REPL][@stdlib/repl]. Default: `true`. +- **autoClear**: `boolean` indicating whether to automatically clear the screen before writing a rendered slide to the [REPL][@stdlib/repl/cli]. Default: `true`. - **loop**: `boolean` indicating whether to "loop" a presentation (i.e., proceed to the first slide after the last slide and have the last slide precede the first slide). Default: `false`. To initialize a presentation upon instantiating a `Presentation` instance, **either** provide a `string` as the first argument containing the presentation text to render **or** set the `load` option to specify a presentation file to load. @@ -380,7 +380,7 @@ Returns the current presentation slide index. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -411,7 +411,7 @@ Jumps to the last fragment of the last slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -440,7 +440,7 @@ Jumps to the first slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -469,7 +469,7 @@ Jumps to the first fragment of the current slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -498,7 +498,7 @@ Returns the presentation height. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -523,7 +523,7 @@ Jumps a specified number of slides. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -557,7 +557,7 @@ Jumps to a specified slide, where `n` is the nominal (i.e., one-based) slide num ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -586,7 +586,7 @@ Jumps to the last slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -615,7 +615,7 @@ Jumps to the last fragment of the current slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -644,7 +644,7 @@ Returns the presentation length (i.e., number of slides). ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -673,7 +673,7 @@ Loads a presentation from a `file`. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -708,7 +708,7 @@ Moves the presentation to the next slide or slide fragment. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -737,7 +737,7 @@ Moves the presentation to the next slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -766,7 +766,7 @@ Moves the presentation to the previous slide or slide fragment. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -795,7 +795,7 @@ Moves the presentation to the previous slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -824,7 +824,7 @@ Reloads a presentation. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -857,7 +857,7 @@ Renders the current presentation slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -889,7 +889,7 @@ Runs any code on the current presentation slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -912,13 +912,13 @@ function done() { #### Presentation.prototype.show() -Shows a presentation slide (i.e., writes a rendered slide to the presentation [REPL][@stdlib/repl]) +Shows a presentation slide (i.e., writes a rendered slide to the presentation [REPL][@stdlib/repl/cli]) ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -947,7 +947,7 @@ Returns the presentation content height. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -972,7 +972,7 @@ Returns the presentation content width. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -997,7 +997,7 @@ Stops watching a presentation file for changes. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -1035,7 +1035,7 @@ Watches a presentation source file for changes. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -1070,7 +1070,7 @@ Returns the presentation width. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); // Create a new REPL: var repl = new REPL({ @@ -1091,7 +1091,7 @@ repl.close(); ### Commands -[REPL][@stdlib/repl] instances running a [REPL][@stdlib/repl] presentation support the following commands within the presentation workspace... +[REPL][@stdlib/repl/cli] instances running a [REPL][@stdlib/repl/cli] presentation support the following commands within the presentation workspace... #### blank() @@ -1305,7 +1305,7 @@ In [1]: watch(); ### Events -A [REPL][@stdlib/repl] presentation emits the following events... +A [REPL][@stdlib/repl/cli] presentation emits the following events... #### 'watch' @@ -1315,7 +1315,7 @@ This event is emitted upon watching a source presentation file. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); function onWatch() { console.log( 'Watching a source file.' ); @@ -1344,7 +1344,7 @@ When watching a source presentation file, this event is emitted whenever a sourc ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); function onChange() { console.log( 'Source file changed.' ); @@ -1373,7 +1373,7 @@ This event is emitted upon no longer watching a source presentation file. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); +var REPL = require( '@stdlib/repl/cli' ); function onUnwatch( error ) { console.log( 'No longer watching a source file.' ); @@ -1410,7 +1410,7 @@ repl.close(); ## Notes -- Multiple presentations can be run simultaneously within the same [REPL][@stdlib/repl] environment. To do so, assign each presentation instance to a unique workspace. +- Multiple presentations can be run simultaneously within the same [REPL][@stdlib/repl/cli] environment. To do so, assign each presentation instance to a unique workspace.
@@ -1431,8 +1431,8 @@ repl.close(); ```javascript var join = require( 'path' ).join; var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl' ); -var Presentation = require( '@stdlib/repl/presentation' ); +var REPL = require( '@stdlib/repl/cli' ); +var Presentation = require( '@stdlib/repl/cli/presentation' ); function onExit() { console.log( '' ); @@ -1580,7 +1580,7 @@ cat ./path/to/presentation.txt | stdlib-repl-presentation [standard-streams]: https://en.wikipedia.org/wiki/Standard_streams -[@stdlib/repl]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/repl +[@stdlib/repl/cli]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/repl/cli [@stdlib/datasets/emoji]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/datasets/emoji From 2ec1573163b7d213574fa844ffe6fcce171c5eb2 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Mon, 10 Mar 2025 13:36:00 +0000 Subject: [PATCH 14/26] fix: apply review comments Signed-off-by: Snehil Shah --- 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: passed - 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 --- --- .../@stdlib/repl/base/ctor/lib/completer.js | 2 +- .../repl/base/ctor/lib/is_multiline_input.js | 2 +- .../@stdlib/repl/base/ctor/lib/main.js | 84 +++++++++++++++---- .../repl/base/ctor/lib/process_input.js | 4 +- .../@stdlib/repl/base/ctor/lib/validate.js | 12 +-- .../@stdlib/repl/base/package.json | 4 +- .../@stdlib/repl/cli/lib/commands/example.js | 2 +- .../@stdlib/repl/cli/lib/eager_evaluator.js | 4 +- lib/node_modules/@stdlib/repl/cli/lib/main.js | 7 +- .../@stdlib/repl/cli/lib/multiline_handler.js | 5 +- .../repl/cli/lib/syntax_highlighter.js | 2 +- .../@stdlib/repl/cli/lib/validate.js | 2 +- 12 files changed, 88 insertions(+), 42 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js index 2688055ee4a9..7795ca7477ef 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js @@ -84,7 +84,7 @@ function completer( repl ) { return complete; /** - * Callback invoked upon a user entering the TAB character at the command prompt. + * Generates completions for a given line. * * @private * @param {string} line - current line diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js index c768485bde47..27f4b4bceb32 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js @@ -64,7 +64,7 @@ function isMultilineInput( input ) { return false; } // Check if the command has valid syntax... - tmp = this._processCommand( input ); + tmp = this.processCommand( input ); if ( !( tmp instanceof Error ) ) { debug( 'Multi-line input not detected.' ); return false; diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index a87eb1ae3780..790ae80526f6 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -70,8 +70,6 @@ var debug = logger( 'repl' ); * @returns {REPL} REPL instance * * @example -* var REPL = require( '@stdlib/repl/base' ); -* * // Create a new REPL: * var repl = new REPL(); * @@ -189,11 +187,8 @@ function REPL( options ) { // Create a REPL execution context: setNonEnumerable( this, '_context', this.createContext() ); - // Create a new TAB completer: - setNonEnumerableReadOnly( this, '_completer', completerFactory( this ) ); - - // Create a new tokenizer: - setNonEnumerableReadOnly( this, '_tokenizer', tokenizer ); + // Create a new completer: + setNonEnumerableReadOnly( this, 'completer', completerFactory( this ) ); // Add listener for "command" events: this.on( 'command', onCommand ); @@ -269,38 +264,95 @@ inherit( REPL, EventEmitter ); /** * Checks if the given input is a possible multi-line command. * -* @private -* @name _isMultilineInput +* @name isMultilineInput * @memberof REPL.prototype * @type {Function} * @param {string} input - input command * @returns {boolean} boolean indicating whether the given input is a possible multi-line command +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Check if an input is a possible multi-line command: +* var input = 'for( var i = 0; i < 10; i++ ) {'; +* var out = repl.isMultilineInput( input ); +* +* // Close the REPL: +* repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, '_isMultilineInput', isMultilineInput ); +setNonEnumerableReadOnly( REPL.prototype, 'isMultilineInput', isMultilineInput ); /** -* Processes a "raw" input command.. +* Processes a "raw" input command. * -* @private -* @name _processCommand +* @name processCommand * @memberof REPL.prototype * @type {Function} * @param {string} code - unevaluated command * @returns {(string|Error)} processed command or an error +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Process raw command: +* var code = 'var y = 10;'; +* var out = repl.processCommand( code ); +* +* // Close the REPL: +* repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, '_processCommand', processCommand ); +setNonEnumerableReadOnly( REPL.prototype, 'processCommand', processCommand ); /** * Compiles a command. * * @private -* @name _compileCommand +* @name compileCommand * @memberof REPL.prototype * @type {Function} * @param {string} cmd - command string * @returns {(Object|Error)} compiled command or an error +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Process raw command: +* var code = 'var y = 10;'; +* var cmd = repl.processCommand( code ); +* +* // Compile processed command: +* var out = repl.compileCommand( cmd ); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', compileCommand ); + +/** +* Tokenizes the input line based on ECMAScript specification. +* +* @name tokenizer +* @memberof REPL.prototype +* @type {Function} +* @param {string} line - input line +* @param {Object} context - REPL context +* @returns {Array} array of tokens +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Tokenize an input line: +* var line = 'var x = 5;'; +* var out = repl.tokenizer( line, {} ); +* +* // Close the REPL: +* repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, '_compileCommand', compileCommand ); +setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', tokenizer ); /** * Creates a REPL context. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/process_input.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/process_input.js index 891d6a0af56c..47767349dab2 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/process_input.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/process_input.js @@ -57,7 +57,7 @@ function processInput( repl, input ) { } else { // Check if the command has valid syntax... debug( 'Processing command...' ); - tmp = repl._processCommand( input ); + tmp = repl.processCommand( input ); if ( tmp instanceof Error ) { repl.emit( 'command', input, false, tmp, false ); // command failed return; @@ -67,7 +67,7 @@ function processInput( repl, input ) { // Attempt to compile the command: debug( 'Attempting to compile command...' ); - code = repl._compileCommand( tmp ); + code = repl.compileCommand( tmp ); if ( code instanceof Error ) { debug( 'Error: %s', code.message ); repl.emit( 'command', input, false, code, false ); // command failed diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js index eadad0485db4..a62e4c09bd5f 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js @@ -38,14 +38,14 @@ var format = require( '@stdlib/string/format' ); * @private * @param {Object} opts - destination object * @param {Options} options - function options -* @param {ReadableStream} [options.input=process.stdin] - input stream -* @param {WritableStream} [options.output=process.stdout] - output stream -* @param {WritableStream} [options.error=process.stderr] - error stream -* @param {boolean} [options.sandbox=true] - boolean indicating whether to run a REPL in a sandboxed context -* @param {PositiveInteger} [options.timeout=4294967295] - number of milliseconds to execute a command before terminating execution +* @param {ReadableStream} [options.input] - input stream +* @param {WritableStream} [options.output] - output stream +* @param {WritableStream} [options.error] - error stream +* @param {boolean} [options.sandbox] - boolean indicating whether to run a REPL in a sandboxed context +* @param {PositiveInteger} [options.timeout] - number of milliseconds to execute a command before terminating execution * @param {string} [options.save] - file path specifying where to save REPL command history * @param {string} [options.log] - file path specifying where to save REPL commands and printed output -* @param {string} [options.quiet=false] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced +* @param {string} [options.quiet] - boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced * @returns {(Error|null)} error or null * * @example diff --git a/lib/node_modules/@stdlib/repl/base/package.json b/lib/node_modules/@stdlib/repl/base/package.json index 17a48c7e4722..db7bad36a198 100644 --- a/lib/node_modules/@stdlib/repl/base/package.json +++ b/lib/node_modules/@stdlib/repl/base/package.json @@ -55,8 +55,6 @@ "interactive", "console", "terminal", - "shell", - "server", - "toplevel" + "shell" ] } diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js b/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js index c60954b71b98..0a07f5b19ae3 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js @@ -162,7 +162,7 @@ function command( repl, cmds ) { lines.push( out[ i ] ); // If line is part of a multi-line input, wait for the next line... - if ( repl._isMultilineInput( lines.join( '\n' ) ) ) { + if ( repl.isMultilineInput( lines.join( '\n' ) ) ) { return next(); } for ( j = 0; j < lines.length; j++ ) { diff --git a/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js b/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js index 5ace79a1d910..fa5f81dcbfb7 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js @@ -299,13 +299,13 @@ setNonEnumerableReadOnly( EagerEvaluator.prototype, 'onKeypress', function onKey return; } debug( 'Processing command...' ); - tmp = this._repl._processCommand( code ); + tmp = this._repl.processCommand( code ); if ( tmp instanceof Error ) { debug( 'Error encountered when processing command: %s', tmp.message ); return; } debug( 'Compiling command...' ); - executable = this._repl._compileCommand( tmp ); + executable = this._repl.compileCommand( tmp ); if ( executable instanceof Error ) { debug( 'Error encountered when compiling command: %s', executable.message ); return; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/main.js b/lib/node_modules/@stdlib/repl/cli/lib/main.js index d88558e2d2ea..fa86124b6821 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/main.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/main.js @@ -230,13 +230,13 @@ function REPL( options ) { setNonEnumerableReadOnly( this, '_editorActions', new EditorActions( this, this._rli._ttyWrite ) ); // Create a new TAB completer engine: - setNonEnumerableReadOnly( this, '_completerEngine', new CompleterEngine( this, this._completer, this._wstream, this._rli._ttyWrite ) ); + setNonEnumerableReadOnly( this, '_completerEngine', new CompleterEngine( this, this.completer, this._wstream, this._rli._ttyWrite ) ); // Create a new auto-closer: setNonEnumerableReadOnly( this, '_autoCloser', new AutoCloser( this._rli, this._settings.autoClosePairs, this._settings.autoDeletePairs, this._multilineHandler ) ); // Initialize a preview completer: - setNonEnumerableReadOnly( this, '_previewCompleter', new PreviewCompleter( this._rli, this._completer, this._ostream, this._settings.completionPreviews ) ); + setNonEnumerableReadOnly( this, '_previewCompleter', new PreviewCompleter( this._rli, this.completer, this._ostream, this._settings.completionPreviews ) ); // Initialize a syntax-highlighter: setNonEnumerableReadOnly( this, '_syntaxHighlighter', new SyntaxHighlighter( this, this._ostream, this._settings.syntaxHighlighting ) ); @@ -464,7 +464,7 @@ function REPL( options ) { if ( success === false ) { self._ostream.write( 'Error: '+res.message+'\n' ); } else if ( !silent && res !== void 0 ) { - pre = replace( self._outputPrompt, '%d', (self._count).toString() ); + pre = replace( self._outputPrompt, '%d', self._count.toString() ); if ( isndarrayLike( res ) ) { tmp = res.toString(); // FIXME: this is a hack in order to avoid printing private ndarray properties in the REPL, as done by the built-in `util.inspect`. Ideally, we'd roll our own inspector which specifically accommodates stdlib's ndarray and other specialized classes. @@ -675,7 +675,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex var context; var cmds; - // TODO: Call parent method context = BaseREPL.prototype.createContext.call( this ); // Get the list of REPL-specific commands: diff --git a/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js b/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js index 2d95dc21112b..5a1669f1303e 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js @@ -68,9 +68,6 @@ function MultilineHandler( repl, ttyWrite ) { // Cache a reference to the command array: this._cmd = repl._cmd; - // Cache a reference to the command queue: - this._queue = repl._queue; - // Initialize an internal object for command history: this._history = {}; this._history.list = repl._history; @@ -631,7 +628,7 @@ setNonEnumerableReadOnly( MultilineHandler.prototype, 'beforeKeypress', function this._lines[ this._lineIndex ] = this._rli.line; // If we are in paste mode or the command is incomplete, trigger multi-line mode... - if ( !this._multiline.pasteMode && !this._repl._isMultilineInput( cmd.join( '\n' ) ) ) { + if ( !this._multiline.pasteMode && !this._repl.isMultilineInput( cmd.join( '\n' ) ) ) { this._ttyWrite.call( this._rli, data, key ); return; } diff --git a/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js b/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js index 779273cbb1b8..441b2bb43785 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js @@ -328,7 +328,7 @@ setNonEnumerableReadOnly( SyntaxHighlighter.prototype, 'onKeypress', function on // Tokenize: debug( 'Line change detected. Tokenizing line: %s', this._rli.line ); this._line = this._rli.line; // update line buffer - tokens = this._repl._tokenizer( this._line, this._repl._context ); + tokens = this._repl.tokenizer( this._line, this._repl._context ); if ( isEmptyArray( tokens ) ) { debug( 'No tokens found. Skipping highlighting...' ); this._highlightedLine = this._line; diff --git a/lib/node_modules/@stdlib/repl/cli/lib/validate.js b/lib/node_modules/@stdlib/repl/cli/lib/validate.js index c969ab72ccd2..f59b8a2cb8dc 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/validate.js +++ b/lib/node_modules/@stdlib/repl/cli/lib/validate.js @@ -43,7 +43,7 @@ var validateSettings = require( './validate_settings.js' ); * @param {Options} options - function options * @param {string} [options.inputPrompt] - input prompt * @param {string} [options.outputPrompt] - output prompt -* @param {ReadableStream} [options.input=] - input stream +* @param {ReadableStream} [options.input] - input stream * @param {WritableStream} [options.output] - output stream * @param {boolean} [options.sandbox] - boolean indicating whether to run a REPL in a sandboxed context * @param {PositiveInteger} [options.timeout] - number of milliseconds to execute a command before terminating execution From d4fa0882edd385257213b64440838b6da9cfc833 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Mon, 10 Mar 2025 13:42:04 +0000 Subject: [PATCH 15/26] docs: update package keywords Signed-off-by: Snehil Shah --- 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: passed - task: lint_repl_help status: na - task: lint_javascript_src status: na - 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 --- --- lib/node_modules/@stdlib/repl/base/ctor/package.json | 7 +------ lib/node_modules/@stdlib/repl/base/package.json | 5 +---- 2 files changed, 2 insertions(+), 10 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/package.json b/lib/node_modules/@stdlib/repl/base/ctor/package.json index b87e6cc4ebc2..c38d7f25c47f 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/package.json +++ b/lib/node_modules/@stdlib/repl/base/ctor/package.json @@ -56,12 +56,7 @@ "eval", "evaluate", "interact", - "interactive", - "console", - "terminal", - "shell", - "server", - "toplevel" + "interactive" ], "__stdlib__": { "envs": { diff --git a/lib/node_modules/@stdlib/repl/base/package.json b/lib/node_modules/@stdlib/repl/base/package.json index db7bad36a198..7dcd583dd6ca 100644 --- a/lib/node_modules/@stdlib/repl/base/package.json +++ b/lib/node_modules/@stdlib/repl/base/package.json @@ -52,9 +52,6 @@ "eval", "evaluate", "interact", - "interactive", - "console", - "terminal", - "shell" + "interactive" ] } From 1ad2eea588277d742eb94a326a927c8dfa2e8bd0 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Wed, 12 Mar 2025 18:46:27 +0000 Subject: [PATCH 16/26] refactor!: move `repl/cli` to `repl` Signed-off-by: Snehil Shah --- 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: passed - task: lint_repl_help status: na - task: lint_javascript_src status: na - 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 --- --- bin/cli_commands.json | 4 +- .../@stdlib/repl/{cli => }/README.md | 4 +- .../repl/{cli => }/benchmark/benchmark.js | 0 .../@stdlib/repl/{cli => }/bin/cli | 0 .../@stdlib/repl/cli/package.json | 78 ---------------- .../repl/{cli => }/data/contributor.json | 0 .../@stdlib/repl/{cli => }/data/example.csv | 0 .../@stdlib/repl/{cli => }/data/example.json | 0 .../@stdlib/repl/{cli => }/data/help.csv | 0 .../@stdlib/repl/{cli => }/data/help.json | 0 .../@stdlib/repl/{cli => }/data/info.csv | 0 .../@stdlib/repl/{cli => }/data/info.json | 0 .../repl/{cli => }/data/license_text.json | 0 .../@stdlib/repl/{cli => }/data/tutorial.csv | 0 .../@stdlib/repl/{cli => }/data/tutorial.json | 0 .../repl/{cli => }/docs/commands/__done__.txt | 0 .../repl/{cli => }/docs/commands/_require.txt | 0 .../{cli => }/docs/commands/alias2pkg.txt | 0 .../{cli => }/docs/commands/alias2related.txt | 0 .../repl/{cli => }/docs/commands/ans.txt | 0 .../{cli => }/docs/commands/assignfrom.txt | 0 .../repl/{cli => }/docs/commands/assignin.txt | 0 .../repl/{cli => }/docs/commands/citation.txt | 0 .../repl/{cli => }/docs/commands/clear.txt | 0 .../{cli => }/docs/commands/clear_history.txt | 0 .../docs/commands/clear_user_docs.txt | 0 .../{cli => }/docs/commands/clear_vars.txt | 0 .../docs/commands/clear_workspace.txt | 0 .../{cli => }/docs/commands/contributor.txt | 0 .../{cli => }/docs/commands/copyright.txt | 0 .../repl/{cli => }/docs/commands/credits.txt | 0 .../docs/commands/current_workspace.txt | 0 .../{cli => }/docs/commands/deeprerequire.txt | 0 .../docs/commands/delete_workspace.txt | 0 .../repl/{cli => }/docs/commands/donate.txt | 0 .../repl/{cli => }/docs/commands/evalin.txt | 0 .../repl/{cli => }/docs/commands/example.txt | 0 .../repl/{cli => }/docs/commands/global.txt | 0 .../repl/{cli => }/docs/commands/help.txt | 0 .../repl/{cli => }/docs/commands/info.txt | 0 .../{cli => }/docs/commands/is_keyword.txt | 0 .../{cli => }/docs/commands/is_workspace.txt | 0 .../{cli => }/docs/commands/license_text.txt | 0 .../repl/{cli => }/docs/commands/load.txt | 0 .../docs/commands/load_workspace.txt | 0 .../{cli => }/docs/commands/log_start.txt | 0 .../repl/{cli => }/docs/commands/log_stop.txt | 0 .../docs/commands/presentation_start.txt | 0 .../docs/commands/presentation_stop.txt | 0 .../repl/{cli => }/docs/commands/quit.txt | 0 .../docs/commands/rename_workspace.txt | 0 .../{cli => }/docs/commands/rerequire.txt | 0 .../repl/{cli => }/docs/commands/rerun.txt | 0 .../repl/{cli => }/docs/commands/reset.txt | 0 .../repl/{cli => }/docs/commands/save.txt | 0 .../{cli => }/docs/commands/save_start.txt | 0 .../{cli => }/docs/commands/save_stop.txt | 0 .../repl/{cli => }/docs/commands/tutorial.txt | 0 .../repl/{cli => }/docs/commands/user_doc.txt | 0 .../repl/{cli => }/docs/commands/vars.txt | 0 .../docs/commands/vars_workspace.txt | 0 .../{cli => }/docs/commands/workspace.txt | 0 .../{cli => }/docs/commands/workspaces.txt | 0 .../{cli => }/docs/migration-guides/README.md | 0 .../docs/migration-guides/ipython/README.md | 0 .../migration-guides/ipython/data/data.csv | 0 .../docs/migration-guides/matlab/README.md | 0 .../migration-guides/matlab/data/data.csv | 0 .../docs/tutorials/read_eval_print_loop.txt | 0 .../@stdlib/repl/{cli => }/docs/usage.txt | 0 .../@stdlib/repl/{cli => }/etc/cli_opts.json | 0 .../repl/{cli => }/examples/history.txt | 0 .../{cli => }/examples/http/client.js.txt | 0 .../{cli => }/examples/http/server.js.txt | 0 .../@stdlib/repl/{cli => }/examples/index.js | 0 .../examples/net-socket-2/client.js.txt | 0 .../examples/net-socket-2/server.js.txt | 0 .../examples/net-socket/client.js.txt | 0 .../examples/net-socket/server.js.txt | 0 .../@stdlib/repl/{cli => }/lib/actions.js | 0 .../repl/{cli => }/lib/alias_to_string.js | 0 .../@stdlib/repl/{cli => }/lib/ansi_colors.js | 0 .../repl/{cli => }/lib/auto_close_pairs.js | 0 .../lib/auto_close_pairs_close_symbols.js | 0 .../lib/auto_close_pairs_open_symbols.js | 0 .../{cli => }/lib/auto_close_pairs_walk.js | 0 .../repl/{cli => }/lib/browser/index.js | 0 .../@stdlib/repl/{cli => }/lib/commands.js | 0 .../repl/{cli => }/lib/commands/__done__.js | 0 .../repl/{cli => }/lib/commands/add_theme.js | 0 .../repl/{cli => }/lib/commands/alias2pkg.js | 0 .../{cli => }/lib/commands/alias2related.js | 0 .../repl/{cli => }/lib/commands/ans.js | 0 .../repl/{cli => }/lib/commands/assignfrom.js | 0 .../repl/{cli => }/lib/commands/assignin.js | 0 .../repl/{cli => }/lib/commands/citation.js | 0 .../repl/{cli => }/lib/commands/clear.js | 0 .../{cli => }/lib/commands/clear_history.js | 0 .../{cli => }/lib/commands/clear_user_docs.js | 0 .../repl/{cli => }/lib/commands/clear_vars.js | 0 .../{cli => }/lib/commands/clear_workspace.js | 0 .../{cli => }/lib/commands/contributor.js | 0 .../repl/{cli => }/lib/commands/copyright.js | 0 .../repl/{cli => }/lib/commands/credits.js | 0 .../lib/commands/current_workspace.js | 0 .../{cli => }/lib/commands/deeprerequire.js | 0 .../{cli => }/lib/commands/delete_theme.js | 0 .../lib/commands/delete_workspace.js | 0 .../repl/{cli => }/lib/commands/donate.js | 0 .../repl/{cli => }/lib/commands/evalin.js | 0 .../repl/{cli => }/lib/commands/example.js | 0 .../repl/{cli => }/lib/commands/get_theme.js | 0 .../repl/{cli => }/lib/commands/help.js | 0 .../repl/{cli => }/lib/commands/info.js | 0 .../repl/{cli => }/lib/commands/is_keyword.js | 0 .../{cli => }/lib/commands/is_workspace.js | 0 .../{cli => }/lib/commands/keybindings.js | 0 .../{cli => }/lib/commands/license_text.js | 0 .../repl/{cli => }/lib/commands/load.js | 0 .../{cli => }/lib/commands/load_workspace.js | 0 .../repl/{cli => }/lib/commands/pager.js | 0 .../lib/commands/presentation_start.js | 2 +- .../lib/commands/presentation_stop.js | 0 .../repl/{cli => }/lib/commands/quit.js | 0 .../{cli => }/lib/commands/rename_theme.js | 0 .../lib/commands/rename_workspace.js | 0 .../repl/{cli => }/lib/commands/rerequire.js | 0 .../repl/{cli => }/lib/commands/rerun.js | 0 .../repl/{cli => }/lib/commands/reset.js | 0 .../{cli => }/lib/commands/set_keybinding.js | 0 .../repl/{cli => }/lib/commands/settings.js | 0 .../repl/{cli => }/lib/commands/themes.js | 0 .../repl/{cli => }/lib/commands/tutorial.js | 0 .../repl/{cli => }/lib/commands/user_doc.js | 0 .../repl/{cli => }/lib/commands/vars.js | 0 .../{cli => }/lib/commands/vars_workspace.js | 0 .../repl/{cli => }/lib/commands/workspace.js | 0 .../repl/{cli => }/lib/commands/workspaces.js | 0 .../repl/{cli => }/lib/completer_engine.js | 0 .../repl/{cli => }/lib/completer_preview.js | 0 .../@stdlib/repl/{cli => }/lib/contains.js | 0 .../repl/{cli => }/lib/default_keybindings.js | 0 .../@stdlib/repl/{cli => }/lib/defaults.js | 0 .../repl/{cli => }/lib/display_prompt.js | 0 .../repl/{cli => }/lib/eager_evaluator.js | 0 .../repl/{cli => }/lib/editor_actions.js | 0 .../repl/{cli => }/lib/find_unique_entry.js | 0 .../@stdlib/repl/{cli => }/lib/help_text.js | 0 .../@stdlib/repl/{cli => }/lib/index.js | 4 +- .../@stdlib/repl/{cli => }/lib/index_of.js | 0 .../repl/{cli => }/lib/input_prompt.js | 0 .../repl/{cli => }/lib/is_setting_name.js | 0 .../@stdlib/repl/{cli => }/lib/keybindings.js | 0 .../@stdlib/repl/{cli => }/lib/log.js | 0 .../{cli => }/lib/longest_common_prefix.js | 0 .../@stdlib/repl/{cli => }/lib/main.js | 0 .../repl/{cli => }/lib/multiline_handler.js | 0 .../repl/{cli => }/lib/output_stream.js | 0 .../@stdlib/repl/{cli => }/lib/parse_key.js | 0 .../repl/{cli => }/lib/property_comparator.js | 0 .../lib/regexp_leading_whitespace.js | 0 .../lib/regexp_reserved_syntax_characters.js | 0 .../@stdlib/repl/{cli => }/lib/repl_docs.js | 0 .../{cli => }/lib/restore_regexp_matches.js | 0 .../repl/{cli => }/lib/set_commands.js | 0 .../repl/{cli => }/lib/set_commands_global.js | 0 .../@stdlib/repl/{cli => }/lib/setdiff.js | 0 .../@stdlib/repl/{cli => }/lib/settings.js | 0 .../repl/{cli => }/lib/settings_names.js | 0 .../repl/{cli => }/lib/settings_validators.js | 0 .../repl/{cli => }/lib/syntax_highlighter.js | 0 .../@stdlib/repl/{cli => }/lib/themes.js | 0 .../repl/{cli => }/lib/update_regexp_cache.js | 0 .../@stdlib/repl/{cli => }/lib/validate.js | 0 .../{cli => }/lib/validate_keybindings.js | 0 .../repl/{cli => }/lib/validate_settings.js | 0 .../repl/{cli => }/lib/welcome_text.js | 0 .../repl/{cli => }/presentation/README.md | 90 +++++++++---------- .../repl/{cli => }/presentation/bin/cli | 0 .../{cli => }/presentation/data/example.csv | 0 .../{cli => }/presentation/data/example.json | 0 .../repl/{cli => }/presentation/data/help.csv | 0 .../{cli => }/presentation/data/help.json | 0 .../repl/{cli => }/presentation/data/info.csv | 0 .../{cli => }/presentation/data/info.json | 0 .../presentation/docs/commands/blank.txt | 0 .../docs/commands/current_slide.txt | 0 .../presentation/docs/commands/end.txt | 0 .../presentation/docs/commands/first.txt | 0 .../docs/commands/first_fragment.txt | 0 .../presentation/docs/commands/jump.txt | 0 .../presentation/docs/commands/jump_to.txt | 0 .../presentation/docs/commands/last.txt | 0 .../docs/commands/last_fragment.txt | 0 .../docs/commands/load_presentation.txt | 0 .../presentation/docs/commands/next.txt | 0 .../presentation/docs/commands/next_slide.txt | 0 .../presentation/docs/commands/num_slides.txt | 0 .../presentation/docs/commands/pres.txt | 0 .../presentation/docs/commands/prev.txt | 0 .../presentation/docs/commands/prev_slide.txt | 0 .../presentation/docs/commands/redraw.txt | 0 .../docs/commands/reload_presentation.txt | 0 .../docs/commands/render_slide.txt | 0 .../presentation/docs/commands/run_slide.txt | 0 .../presentation/docs/commands/unwatch.txt | 0 .../presentation/docs/commands/watch.txt | 0 .../{cli => }/presentation/docs/usage.txt | 0 .../{cli => }/presentation/etc/cli_opts.json | 0 .../{cli => }/presentation/examples/index.js | 2 +- .../presentation/examples/presentation.txt | 0 .../presentation/lib/align_center.js | 0 .../presentation/lib/align_flush_left.js | 0 .../presentation/lib/align_flush_right.js | 0 .../{cli => }/presentation/lib/align_left.js | 0 .../{cli => }/presentation/lib/align_line.js | 0 .../{cli => }/presentation/lib/align_right.js | 0 .../presentation/lib/ansi_escape_code.js | 0 .../presentation/lib/ansi_escape_codes.js | 0 .../{cli => }/presentation/lib/blank_line.js | 0 .../{cli => }/presentation/lib/commands.js | 0 .../presentation/lib/commands/blank.js | 0 .../lib/commands/current_slide.js | 0 .../presentation/lib/commands/end.js | 0 .../presentation/lib/commands/first.js | 0 .../lib/commands/first_fragment.js | 0 .../presentation/lib/commands/jump.js | 0 .../presentation/lib/commands/jump_to.js | 0 .../presentation/lib/commands/last.js | 0 .../lib/commands/last_fragment.js | 0 .../lib/commands/load_presentation.js | 0 .../presentation/lib/commands/next.js | 0 .../presentation/lib/commands/next_slide.js | 0 .../presentation/lib/commands/num_slides.js | 0 .../presentation/lib/commands/pres.js | 0 .../presentation/lib/commands/prev.js | 0 .../presentation/lib/commands/prev_slide.js | 0 .../presentation/lib/commands/redraw.js | 0 .../lib/commands/reload_presentation.js | 0 .../presentation/lib/commands/render_slide.js | 0 .../presentation/lib/commands/run_slide.js | 0 .../presentation/lib/commands/unwatch.js | 0 .../presentation/lib/commands/watch.js | 0 .../{cli => }/presentation/lib/defaults.js | 0 .../repl/{cli => }/presentation/lib/docs.js | 0 .../repl/{cli => }/presentation/lib/emoji.js | 0 .../{cli => }/presentation/lib/fill_line.js | 0 .../repl/{cli => }/presentation/lib/footer.js | 0 .../repl/{cli => }/presentation/lib/format.js | 0 .../{cli => }/presentation/lib/help_text.js | 0 .../presentation/lib/horizontal_rule.js | 0 .../repl/{cli => }/presentation/lib/index.js | 6 +- .../repl/{cli => }/presentation/lib/main.js | 0 .../repl/{cli => }/presentation/lib/parse.js | 0 .../{cli => }/presentation/lib/parse_slide.js | 0 .../presentation/lib/set_commands.js | 0 .../{cli => }/presentation/lib/style_line.js | 0 .../presentation/lib/style_to_ansi.js | 0 .../repl/{cli => }/presentation/lib/styles.js | 0 .../{cli => }/presentation/lib/validate.js | 0 .../repl/{cli => }/presentation/package.json | 2 +- .../{cli => }/presentation/scripts/build.js | 0 .../@stdlib/repl/{cli => }/scripts/build.js | 0 .../{cli => }/scripts/build_contributors.js | 0 .../repl/{cli => }/scripts/build_help.js | 0 .../repl/{cli => }/scripts/build_license.js | 0 .../repl/{cli => }/scripts/build_tutorials.js | 0 .../array_expression_right_bracket.json | 0 .../object_expression_right_brace.json | 0 .../negative/right_backtick.json | 0 .../negative/right_double_quote.json | 0 .../negative/right_parenthesis.json | 0 .../negative/right_single_quote.json | 0 .../negative/template_literal.json | 0 .../template_literal_with_expression.json | 0 .../positive/arrow_function_body.json | 0 ...binary_left_member_expression_literal.json | 0 .../positive/call_expression.json | 0 ...pression_string_argument_single_quote.json | 0 ...ssion_template_argument_left_backtick.json | 0 .../positive/do_while_body.json | 0 .../positive/do_while_test.json | 0 .../positive/do_while_test_left_bracket.json | 0 .../auto-close-pairs/positive/for_body.json | 0 .../auto-close-pairs/positive/for_init.json | 0 .../auto-close-pairs/positive/for_test.json | 0 .../positive/for_test_member_expression.json | 0 .../auto-close-pairs/positive/for_update.json | 0 .../for_update_member_expression.json | 0 .../positive/function_declaration_body.json | 0 .../function_declaration_signature.json | 0 .../positive/left_backtick.json | 0 .../auto-close-pairs/positive/left_brace.json | 0 .../positive/left_bracket.json | 0 .../positive/left_double_quote.json | 0 .../positive/left_parenthesis.json | 0 .../positive/left_single_quote.json | 0 ...ogical_left_member_expression_literal.json | 0 .../logical_with_left_member_expression.json | 0 ...al_with_left_nested_member_expression.json | 0 .../logical_with_right_member_expression.json | 0 .../member_assignment_expression.json | 0 .../member_assignment_expression_literal.json | 0 .../positive/member_expression.json | 0 .../member_expression_call_expression.json | 0 .../object_expression_left_single_quote.json | 0 .../positive/regexp_body_single_quote.json | 0 .../positive/regexp_literal_left_bracket.json | 0 .../positive/regexp_single_quote.json | 0 .../positive/tagged_template.json | 0 .../tagged_template_left_backtick.json | 0 ...te_literal_expression_with_left_brace.json | 0 ..._literal_expression_with_left_bracket.json | 0 ...ral_expression_with_left_double_quote.json | 0 ...eral_expression_with_left_parenthesis.json | 0 .../positive/three_backticks.json | 0 .../positive/variable_declaration_string.json | 0 .../auto-close-pairs/positive/while_body.json | 0 .../auto-close-pairs/positive/while_test.json | 0 .../fixtures/auto-close-pairs/script.js | 0 ...expression_left_bracket_within_string.json | 0 .../negative/left_backtick_within_string.json | 0 .../left_double_quote_within_string.json | 0 .../left_parenthesis_within_string.json | 0 .../left_single_quote_within_string.json | 0 ...t_expression_left_brace_within_string.json | 0 .../array_expression_left_bracket.json | 0 .../positive/left_backtick.json | 0 .../positive/left_double_quote.json | 0 .../positive/left_parenthesis.json | 0 .../positive/left_single_quote.json | 0 .../object_expression_left_brace.json | 0 .../fixtures/auto-delete-pairs/script.js | 0 .../test/integration/fixtures/repl.js | 0 .../syntax-highlighting/comments.json | 0 .../syntax-highlighting/control_keywords.json | 0 .../declaration_names.json | 0 .../syntax-highlighting/functions.json | 0 .../syntax-highlighting/keywords.json | 0 .../syntax-highlighting/local_scopes.json | 0 .../member_expressions.json | 0 .../syntax-highlighting/numeric_literals.json | 0 .../fixtures/syntax-highlighting/objects.json | 0 .../syntax-highlighting/operators.json | 0 .../syntax-highlighting/punctuation.json | 0 .../fixtures/syntax-highlighting/regexp.json | 0 .../reserved_literals.json | 0 .../special_identifiers.json | 0 .../syntax-highlighting/string_literals.json | 0 .../syntax-highlighting/variables.json | 0 .../test/integration/test.auto_close_pairs.js | 0 .../integration/test.auto_delete_pairs.js | 0 .../test/integration/test.auto_page.js | 0 .../test/integration/test.completer_engine.js | 0 .../integration/test.completion_previews.js | 0 .../integration/test.syntax_highlighting.js | 0 .../@stdlib/repl/{cli => }/test/test.cli.js | 0 .../@stdlib/repl/{cli => }/test/test.js | 0 tools/make/lib/docs/repl.mk | 4 +- 359 files changed, 59 insertions(+), 137 deletions(-) rename lib/node_modules/@stdlib/repl/{cli => }/README.md (99%) rename lib/node_modules/@stdlib/repl/{cli => }/benchmark/benchmark.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/bin/cli (100%) delete mode 100644 lib/node_modules/@stdlib/repl/cli/package.json rename lib/node_modules/@stdlib/repl/{cli => }/data/contributor.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/example.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/example.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/help.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/help.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/info.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/info.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/license_text.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/tutorial.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/data/tutorial.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/__done__.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/_require.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/alias2pkg.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/alias2related.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/ans.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/assignfrom.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/assignin.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/citation.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/clear.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/clear_history.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/clear_user_docs.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/clear_vars.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/clear_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/contributor.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/copyright.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/credits.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/current_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/deeprerequire.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/delete_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/donate.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/evalin.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/example.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/global.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/help.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/info.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/is_keyword.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/is_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/license_text.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/load.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/load_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/log_start.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/log_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/presentation_start.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/presentation_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/quit.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/rename_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/rerequire.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/rerun.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/reset.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/save.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/save_start.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/save_stop.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/tutorial.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/user_doc.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/vars.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/vars_workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/workspace.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/commands/workspaces.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/migration-guides/README.md (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/migration-guides/ipython/README.md (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/migration-guides/ipython/data/data.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/migration-guides/matlab/README.md (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/migration-guides/matlab/data/data.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/tutorials/read_eval_print_loop.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/docs/usage.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/etc/cli_opts.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/history.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/http/client.js.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/http/server.js.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/index.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/net-socket-2/client.js.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/net-socket-2/server.js.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/net-socket/client.js.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/examples/net-socket/server.js.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/actions.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/alias_to_string.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/ansi_colors.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/auto_close_pairs.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/auto_close_pairs_close_symbols.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/auto_close_pairs_open_symbols.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/auto_close_pairs_walk.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/browser/index.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/__done__.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/add_theme.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/alias2pkg.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/alias2related.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/ans.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/assignfrom.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/assignin.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/citation.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/clear.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/clear_history.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/clear_user_docs.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/clear_vars.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/clear_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/contributor.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/copyright.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/credits.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/current_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/deeprerequire.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/delete_theme.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/delete_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/donate.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/evalin.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/example.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/get_theme.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/help.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/info.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/is_keyword.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/is_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/keybindings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/license_text.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/load.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/load_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/pager.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/presentation_start.js (98%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/presentation_stop.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/quit.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/rename_theme.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/rename_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/rerequire.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/rerun.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/reset.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/set_keybinding.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/settings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/themes.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/tutorial.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/user_doc.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/vars.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/vars_workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/workspace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/commands/workspaces.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/completer_engine.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/completer_preview.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/contains.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/default_keybindings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/defaults.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/display_prompt.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/eager_evaluator.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/editor_actions.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/find_unique_entry.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/help_text.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/index.js (93%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/index_of.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/input_prompt.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/is_setting_name.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/keybindings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/log.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/longest_common_prefix.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/main.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/multiline_handler.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/output_stream.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/parse_key.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/property_comparator.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/regexp_leading_whitespace.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/regexp_reserved_syntax_characters.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/repl_docs.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/restore_regexp_matches.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/set_commands.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/set_commands_global.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/setdiff.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/settings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/settings_names.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/settings_validators.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/syntax_highlighter.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/themes.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/update_regexp_cache.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/validate.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/validate_keybindings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/validate_settings.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/lib/welcome_text.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/README.md (91%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/bin/cli (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/data/example.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/data/example.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/data/help.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/data/help.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/data/info.csv (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/data/info.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/blank.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/current_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/end.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/first.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/first_fragment.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/jump.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/jump_to.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/last.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/last_fragment.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/load_presentation.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/next.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/next_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/num_slides.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/pres.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/prev.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/prev_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/redraw.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/reload_presentation.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/render_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/run_slide.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/unwatch.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/commands/watch.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/docs/usage.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/etc/cli_opts.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/examples/index.js (97%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/examples/presentation.txt (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/align_center.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/align_flush_left.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/align_flush_right.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/align_left.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/align_line.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/align_right.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/ansi_escape_code.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/ansi_escape_codes.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/blank_line.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/blank.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/current_slide.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/end.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/first.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/first_fragment.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/jump.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/jump_to.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/last.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/last_fragment.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/load_presentation.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/next.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/next_slide.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/num_slides.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/pres.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/prev.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/prev_slide.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/redraw.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/reload_presentation.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/render_slide.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/run_slide.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/unwatch.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/commands/watch.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/defaults.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/docs.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/emoji.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/fill_line.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/footer.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/format.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/help_text.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/horizontal_rule.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/index.js (88%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/main.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/parse.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/parse_slide.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/set_commands.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/style_line.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/style_to_ansi.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/styles.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/lib/validate.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/package.json (97%) rename lib/node_modules/@stdlib/repl/{cli => }/presentation/scripts/build.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/scripts/build.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/scripts/build_contributors.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/scripts/build_help.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/scripts/build_license.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/scripts/build_tutorials.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/template_literal.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/call_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/for_body.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/for_init.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/for_test.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/for_update.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/left_brace.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/member_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/while_body.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/positive/while_test.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-close-pairs/script.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/auto-delete-pairs/script.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/repl.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/comments.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/control_keywords.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/declaration_names.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/functions.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/keywords.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/local_scopes.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/member_expressions.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/numeric_literals.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/objects.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/operators.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/punctuation.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/regexp.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/reserved_literals.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/special_identifiers.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/string_literals.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/fixtures/syntax-highlighting/variables.json (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/test.auto_close_pairs.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/test.auto_delete_pairs.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/test.auto_page.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/test.completer_engine.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/test.completion_previews.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/integration/test.syntax_highlighting.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/test.cli.js (100%) rename lib/node_modules/@stdlib/repl/{cli => }/test/test.js (100%) diff --git a/bin/cli_commands.json b/bin/cli_commands.json index 78212a2b543d..c2734b707317 100644 --- a/bin/cli_commands.json +++ b/bin/cli_commands.json @@ -788,13 +788,13 @@ { "command": "repl", "description": "Start a REPL.", - "path": "@stdlib/repl/cli", + "path": "@stdlib/repl", "group": "general" }, { "command": "repl-presentation", "description": "Start a REPL presentation.", - "path": "@stdlib/repl/cli/presentation", + "path": "@stdlib/repl/presentation", "group": "general" }, { diff --git a/lib/node_modules/@stdlib/repl/cli/README.md b/lib/node_modules/@stdlib/repl/README.md similarity index 99% rename from lib/node_modules/@stdlib/repl/cli/README.md rename to lib/node_modules/@stdlib/repl/README.md index 16ece9fc3da4..3b9735819d0d 100644 --- a/lib/node_modules/@stdlib/repl/cli/README.md +++ b/lib/node_modules/@stdlib/repl/README.md @@ -43,7 +43,7 @@ The REPL environment exposed here is available both as a standalone application ## Usage ```javascript -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); ``` #### REPL( \[options] ) @@ -1503,7 +1503,7 @@ In [1]: workspaces( { 'details': true } ) ```javascript var join = require( 'path' ).join; -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); function onExit() { console.log( '' ); diff --git a/lib/node_modules/@stdlib/repl/cli/benchmark/benchmark.js b/lib/node_modules/@stdlib/repl/benchmark/benchmark.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/benchmark/benchmark.js rename to lib/node_modules/@stdlib/repl/benchmark/benchmark.js diff --git a/lib/node_modules/@stdlib/repl/cli/bin/cli b/lib/node_modules/@stdlib/repl/bin/cli similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/bin/cli rename to lib/node_modules/@stdlib/repl/bin/cli diff --git a/lib/node_modules/@stdlib/repl/cli/package.json b/lib/node_modules/@stdlib/repl/cli/package.json deleted file mode 100644 index 7e75fc1fac41..000000000000 --- a/lib/node_modules/@stdlib/repl/cli/package.json +++ /dev/null @@ -1,78 +0,0 @@ -{ - "name": "@stdlib/repl/cli", - "version": "0.0.0", - "description": "REPL environment.", - "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" - } - ], - "bin": { - "stdlib-repl": "./bin/cli" - }, - "main": "./lib", - "browser": { - "./lib": "./lib/browser/index.js", - "process": "process/" - }, - "directories": { - "benchmark": "./benchmark", - "data": "./data", - "doc": "./docs", - "example": "./examples", - "lib": "./lib", - "scripts": "./scripts", - "test": "./test" - }, - "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", - "repl", - "read-eval-print-loop", - "eval", - "evaluate", - "interact", - "interactive", - "console", - "terminal", - "shell", - "server", - "toplevel" - ], - "__stdlib__": { - "envs": { - "browser": false - } - } -} diff --git a/lib/node_modules/@stdlib/repl/cli/data/contributor.json b/lib/node_modules/@stdlib/repl/data/contributor.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/contributor.json rename to lib/node_modules/@stdlib/repl/data/contributor.json diff --git a/lib/node_modules/@stdlib/repl/cli/data/example.csv b/lib/node_modules/@stdlib/repl/data/example.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/example.csv rename to lib/node_modules/@stdlib/repl/data/example.csv diff --git a/lib/node_modules/@stdlib/repl/cli/data/example.json b/lib/node_modules/@stdlib/repl/data/example.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/example.json rename to lib/node_modules/@stdlib/repl/data/example.json diff --git a/lib/node_modules/@stdlib/repl/cli/data/help.csv b/lib/node_modules/@stdlib/repl/data/help.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/help.csv rename to lib/node_modules/@stdlib/repl/data/help.csv diff --git a/lib/node_modules/@stdlib/repl/cli/data/help.json b/lib/node_modules/@stdlib/repl/data/help.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/help.json rename to lib/node_modules/@stdlib/repl/data/help.json diff --git a/lib/node_modules/@stdlib/repl/cli/data/info.csv b/lib/node_modules/@stdlib/repl/data/info.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/info.csv rename to lib/node_modules/@stdlib/repl/data/info.csv diff --git a/lib/node_modules/@stdlib/repl/cli/data/info.json b/lib/node_modules/@stdlib/repl/data/info.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/info.json rename to lib/node_modules/@stdlib/repl/data/info.json diff --git a/lib/node_modules/@stdlib/repl/cli/data/license_text.json b/lib/node_modules/@stdlib/repl/data/license_text.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/license_text.json rename to lib/node_modules/@stdlib/repl/data/license_text.json diff --git a/lib/node_modules/@stdlib/repl/cli/data/tutorial.csv b/lib/node_modules/@stdlib/repl/data/tutorial.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/tutorial.csv rename to lib/node_modules/@stdlib/repl/data/tutorial.csv diff --git a/lib/node_modules/@stdlib/repl/cli/data/tutorial.json b/lib/node_modules/@stdlib/repl/data/tutorial.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/data/tutorial.json rename to lib/node_modules/@stdlib/repl/data/tutorial.json diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/__done__.txt b/lib/node_modules/@stdlib/repl/docs/commands/__done__.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/__done__.txt rename to lib/node_modules/@stdlib/repl/docs/commands/__done__.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/_require.txt b/lib/node_modules/@stdlib/repl/docs/commands/_require.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/_require.txt rename to lib/node_modules/@stdlib/repl/docs/commands/_require.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/alias2pkg.txt b/lib/node_modules/@stdlib/repl/docs/commands/alias2pkg.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/alias2pkg.txt rename to lib/node_modules/@stdlib/repl/docs/commands/alias2pkg.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/alias2related.txt b/lib/node_modules/@stdlib/repl/docs/commands/alias2related.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/alias2related.txt rename to lib/node_modules/@stdlib/repl/docs/commands/alias2related.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/ans.txt b/lib/node_modules/@stdlib/repl/docs/commands/ans.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/ans.txt rename to lib/node_modules/@stdlib/repl/docs/commands/ans.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/assignfrom.txt b/lib/node_modules/@stdlib/repl/docs/commands/assignfrom.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/assignfrom.txt rename to lib/node_modules/@stdlib/repl/docs/commands/assignfrom.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/assignin.txt b/lib/node_modules/@stdlib/repl/docs/commands/assignin.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/assignin.txt rename to lib/node_modules/@stdlib/repl/docs/commands/assignin.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/citation.txt b/lib/node_modules/@stdlib/repl/docs/commands/citation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/citation.txt rename to lib/node_modules/@stdlib/repl/docs/commands/citation.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/clear.txt b/lib/node_modules/@stdlib/repl/docs/commands/clear.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/clear.txt rename to lib/node_modules/@stdlib/repl/docs/commands/clear.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_history.txt b/lib/node_modules/@stdlib/repl/docs/commands/clear_history.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/clear_history.txt rename to lib/node_modules/@stdlib/repl/docs/commands/clear_history.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_user_docs.txt b/lib/node_modules/@stdlib/repl/docs/commands/clear_user_docs.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/clear_user_docs.txt rename to lib/node_modules/@stdlib/repl/docs/commands/clear_user_docs.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_vars.txt b/lib/node_modules/@stdlib/repl/docs/commands/clear_vars.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/clear_vars.txt rename to lib/node_modules/@stdlib/repl/docs/commands/clear_vars.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/clear_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/clear_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/clear_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/clear_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/contributor.txt b/lib/node_modules/@stdlib/repl/docs/commands/contributor.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/contributor.txt rename to lib/node_modules/@stdlib/repl/docs/commands/contributor.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/copyright.txt b/lib/node_modules/@stdlib/repl/docs/commands/copyright.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/copyright.txt rename to lib/node_modules/@stdlib/repl/docs/commands/copyright.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/credits.txt b/lib/node_modules/@stdlib/repl/docs/commands/credits.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/credits.txt rename to lib/node_modules/@stdlib/repl/docs/commands/credits.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/current_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/current_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/current_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/current_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/deeprerequire.txt b/lib/node_modules/@stdlib/repl/docs/commands/deeprerequire.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/deeprerequire.txt rename to lib/node_modules/@stdlib/repl/docs/commands/deeprerequire.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/delete_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/delete_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/delete_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/delete_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/donate.txt b/lib/node_modules/@stdlib/repl/docs/commands/donate.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/donate.txt rename to lib/node_modules/@stdlib/repl/docs/commands/donate.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/evalin.txt b/lib/node_modules/@stdlib/repl/docs/commands/evalin.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/evalin.txt rename to lib/node_modules/@stdlib/repl/docs/commands/evalin.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/example.txt b/lib/node_modules/@stdlib/repl/docs/commands/example.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/example.txt rename to lib/node_modules/@stdlib/repl/docs/commands/example.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/global.txt b/lib/node_modules/@stdlib/repl/docs/commands/global.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/global.txt rename to lib/node_modules/@stdlib/repl/docs/commands/global.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/help.txt b/lib/node_modules/@stdlib/repl/docs/commands/help.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/help.txt rename to lib/node_modules/@stdlib/repl/docs/commands/help.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/info.txt b/lib/node_modules/@stdlib/repl/docs/commands/info.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/info.txt rename to lib/node_modules/@stdlib/repl/docs/commands/info.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/is_keyword.txt b/lib/node_modules/@stdlib/repl/docs/commands/is_keyword.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/is_keyword.txt rename to lib/node_modules/@stdlib/repl/docs/commands/is_keyword.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/is_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/is_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/is_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/is_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/license_text.txt b/lib/node_modules/@stdlib/repl/docs/commands/license_text.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/license_text.txt rename to lib/node_modules/@stdlib/repl/docs/commands/license_text.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/load.txt b/lib/node_modules/@stdlib/repl/docs/commands/load.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/load.txt rename to lib/node_modules/@stdlib/repl/docs/commands/load.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/load_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/load_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/load_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/load_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/log_start.txt b/lib/node_modules/@stdlib/repl/docs/commands/log_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/log_start.txt rename to lib/node_modules/@stdlib/repl/docs/commands/log_start.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/log_stop.txt b/lib/node_modules/@stdlib/repl/docs/commands/log_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/log_stop.txt rename to lib/node_modules/@stdlib/repl/docs/commands/log_stop.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_start.txt b/lib/node_modules/@stdlib/repl/docs/commands/presentation_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_start.txt rename to lib/node_modules/@stdlib/repl/docs/commands/presentation_start.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_stop.txt b/lib/node_modules/@stdlib/repl/docs/commands/presentation_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/presentation_stop.txt rename to lib/node_modules/@stdlib/repl/docs/commands/presentation_stop.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/quit.txt b/lib/node_modules/@stdlib/repl/docs/commands/quit.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/quit.txt rename to lib/node_modules/@stdlib/repl/docs/commands/quit.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/rename_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/rename_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/rename_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/rename_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/rerequire.txt b/lib/node_modules/@stdlib/repl/docs/commands/rerequire.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/rerequire.txt rename to lib/node_modules/@stdlib/repl/docs/commands/rerequire.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/rerun.txt b/lib/node_modules/@stdlib/repl/docs/commands/rerun.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/rerun.txt rename to lib/node_modules/@stdlib/repl/docs/commands/rerun.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/reset.txt b/lib/node_modules/@stdlib/repl/docs/commands/reset.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/reset.txt rename to lib/node_modules/@stdlib/repl/docs/commands/reset.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/save.txt b/lib/node_modules/@stdlib/repl/docs/commands/save.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/save.txt rename to lib/node_modules/@stdlib/repl/docs/commands/save.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/save_start.txt b/lib/node_modules/@stdlib/repl/docs/commands/save_start.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/save_start.txt rename to lib/node_modules/@stdlib/repl/docs/commands/save_start.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/save_stop.txt b/lib/node_modules/@stdlib/repl/docs/commands/save_stop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/save_stop.txt rename to lib/node_modules/@stdlib/repl/docs/commands/save_stop.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/tutorial.txt b/lib/node_modules/@stdlib/repl/docs/commands/tutorial.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/tutorial.txt rename to lib/node_modules/@stdlib/repl/docs/commands/tutorial.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/user_doc.txt b/lib/node_modules/@stdlib/repl/docs/commands/user_doc.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/user_doc.txt rename to lib/node_modules/@stdlib/repl/docs/commands/user_doc.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/vars.txt b/lib/node_modules/@stdlib/repl/docs/commands/vars.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/vars.txt rename to lib/node_modules/@stdlib/repl/docs/commands/vars.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/vars_workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/vars_workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/vars_workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/vars_workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/workspace.txt b/lib/node_modules/@stdlib/repl/docs/commands/workspace.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/workspace.txt rename to lib/node_modules/@stdlib/repl/docs/commands/workspace.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/commands/workspaces.txt b/lib/node_modules/@stdlib/repl/docs/commands/workspaces.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/commands/workspaces.txt rename to lib/node_modules/@stdlib/repl/docs/commands/workspaces.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/README.md b/lib/node_modules/@stdlib/repl/docs/migration-guides/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/migration-guides/README.md rename to lib/node_modules/@stdlib/repl/docs/migration-guides/README.md diff --git a/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/README.md b/lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/README.md rename to lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/README.md diff --git a/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/data/data.csv b/lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/data/data.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/migration-guides/ipython/data/data.csv rename to lib/node_modules/@stdlib/repl/docs/migration-guides/ipython/data/data.csv diff --git a/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/README.md b/lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/README.md similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/README.md rename to lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/README.md diff --git a/lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/data/data.csv b/lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/data/data.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/migration-guides/matlab/data/data.csv rename to lib/node_modules/@stdlib/repl/docs/migration-guides/matlab/data/data.csv diff --git a/lib/node_modules/@stdlib/repl/cli/docs/tutorials/read_eval_print_loop.txt b/lib/node_modules/@stdlib/repl/docs/tutorials/read_eval_print_loop.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/tutorials/read_eval_print_loop.txt rename to lib/node_modules/@stdlib/repl/docs/tutorials/read_eval_print_loop.txt diff --git a/lib/node_modules/@stdlib/repl/cli/docs/usage.txt b/lib/node_modules/@stdlib/repl/docs/usage.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/docs/usage.txt rename to lib/node_modules/@stdlib/repl/docs/usage.txt diff --git a/lib/node_modules/@stdlib/repl/cli/etc/cli_opts.json b/lib/node_modules/@stdlib/repl/etc/cli_opts.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/etc/cli_opts.json rename to lib/node_modules/@stdlib/repl/etc/cli_opts.json diff --git a/lib/node_modules/@stdlib/repl/cli/examples/history.txt b/lib/node_modules/@stdlib/repl/examples/history.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/history.txt rename to lib/node_modules/@stdlib/repl/examples/history.txt diff --git a/lib/node_modules/@stdlib/repl/cli/examples/http/client.js.txt b/lib/node_modules/@stdlib/repl/examples/http/client.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/http/client.js.txt rename to lib/node_modules/@stdlib/repl/examples/http/client.js.txt diff --git a/lib/node_modules/@stdlib/repl/cli/examples/http/server.js.txt b/lib/node_modules/@stdlib/repl/examples/http/server.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/http/server.js.txt rename to lib/node_modules/@stdlib/repl/examples/http/server.js.txt diff --git a/lib/node_modules/@stdlib/repl/cli/examples/index.js b/lib/node_modules/@stdlib/repl/examples/index.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/index.js rename to lib/node_modules/@stdlib/repl/examples/index.js diff --git a/lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/client.js.txt b/lib/node_modules/@stdlib/repl/examples/net-socket-2/client.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/client.js.txt rename to lib/node_modules/@stdlib/repl/examples/net-socket-2/client.js.txt diff --git a/lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/server.js.txt b/lib/node_modules/@stdlib/repl/examples/net-socket-2/server.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/net-socket-2/server.js.txt rename to lib/node_modules/@stdlib/repl/examples/net-socket-2/server.js.txt diff --git a/lib/node_modules/@stdlib/repl/cli/examples/net-socket/client.js.txt b/lib/node_modules/@stdlib/repl/examples/net-socket/client.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/net-socket/client.js.txt rename to lib/node_modules/@stdlib/repl/examples/net-socket/client.js.txt diff --git a/lib/node_modules/@stdlib/repl/cli/examples/net-socket/server.js.txt b/lib/node_modules/@stdlib/repl/examples/net-socket/server.js.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/examples/net-socket/server.js.txt rename to lib/node_modules/@stdlib/repl/examples/net-socket/server.js.txt diff --git a/lib/node_modules/@stdlib/repl/cli/lib/actions.js b/lib/node_modules/@stdlib/repl/lib/actions.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/actions.js rename to lib/node_modules/@stdlib/repl/lib/actions.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/alias_to_string.js b/lib/node_modules/@stdlib/repl/lib/alias_to_string.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/alias_to_string.js rename to lib/node_modules/@stdlib/repl/lib/alias_to_string.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/ansi_colors.js b/lib/node_modules/@stdlib/repl/lib/ansi_colors.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/ansi_colors.js rename to lib/node_modules/@stdlib/repl/lib/ansi_colors.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs.js b/lib/node_modules/@stdlib/repl/lib/auto_close_pairs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs.js rename to lib/node_modules/@stdlib/repl/lib/auto_close_pairs.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_close_symbols.js b/lib/node_modules/@stdlib/repl/lib/auto_close_pairs_close_symbols.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_close_symbols.js rename to lib/node_modules/@stdlib/repl/lib/auto_close_pairs_close_symbols.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_open_symbols.js b/lib/node_modules/@stdlib/repl/lib/auto_close_pairs_open_symbols.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_open_symbols.js rename to lib/node_modules/@stdlib/repl/lib/auto_close_pairs_open_symbols.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_walk.js b/lib/node_modules/@stdlib/repl/lib/auto_close_pairs_walk.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/auto_close_pairs_walk.js rename to lib/node_modules/@stdlib/repl/lib/auto_close_pairs_walk.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/browser/index.js b/lib/node_modules/@stdlib/repl/lib/browser/index.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/browser/index.js rename to lib/node_modules/@stdlib/repl/lib/browser/index.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands.js b/lib/node_modules/@stdlib/repl/lib/commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands.js rename to lib/node_modules/@stdlib/repl/lib/commands.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/__done__.js b/lib/node_modules/@stdlib/repl/lib/commands/__done__.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/__done__.js rename to lib/node_modules/@stdlib/repl/lib/commands/__done__.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/add_theme.js b/lib/node_modules/@stdlib/repl/lib/commands/add_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/add_theme.js rename to lib/node_modules/@stdlib/repl/lib/commands/add_theme.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/alias2pkg.js b/lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/alias2pkg.js rename to lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/alias2related.js b/lib/node_modules/@stdlib/repl/lib/commands/alias2related.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/alias2related.js rename to lib/node_modules/@stdlib/repl/lib/commands/alias2related.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/ans.js b/lib/node_modules/@stdlib/repl/lib/commands/ans.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/ans.js rename to lib/node_modules/@stdlib/repl/lib/commands/ans.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/assignfrom.js b/lib/node_modules/@stdlib/repl/lib/commands/assignfrom.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/assignfrom.js rename to lib/node_modules/@stdlib/repl/lib/commands/assignfrom.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/assignin.js b/lib/node_modules/@stdlib/repl/lib/commands/assignin.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/assignin.js rename to lib/node_modules/@stdlib/repl/lib/commands/assignin.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/citation.js b/lib/node_modules/@stdlib/repl/lib/commands/citation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/citation.js rename to lib/node_modules/@stdlib/repl/lib/commands/citation.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/clear.js b/lib/node_modules/@stdlib/repl/lib/commands/clear.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/clear.js rename to lib/node_modules/@stdlib/repl/lib/commands/clear.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_history.js b/lib/node_modules/@stdlib/repl/lib/commands/clear_history.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/clear_history.js rename to lib/node_modules/@stdlib/repl/lib/commands/clear_history.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_user_docs.js b/lib/node_modules/@stdlib/repl/lib/commands/clear_user_docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/clear_user_docs.js rename to lib/node_modules/@stdlib/repl/lib/commands/clear_user_docs.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_vars.js b/lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/clear_vars.js rename to lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/clear_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/clear_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/contributor.js b/lib/node_modules/@stdlib/repl/lib/commands/contributor.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/contributor.js rename to lib/node_modules/@stdlib/repl/lib/commands/contributor.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/copyright.js b/lib/node_modules/@stdlib/repl/lib/commands/copyright.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/copyright.js rename to lib/node_modules/@stdlib/repl/lib/commands/copyright.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/credits.js b/lib/node_modules/@stdlib/repl/lib/commands/credits.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/credits.js rename to lib/node_modules/@stdlib/repl/lib/commands/credits.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/current_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/current_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/deeprerequire.js b/lib/node_modules/@stdlib/repl/lib/commands/deeprerequire.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/deeprerequire.js rename to lib/node_modules/@stdlib/repl/lib/commands/deeprerequire.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/delete_theme.js b/lib/node_modules/@stdlib/repl/lib/commands/delete_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/delete_theme.js rename to lib/node_modules/@stdlib/repl/lib/commands/delete_theme.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/delete_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/delete_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/donate.js b/lib/node_modules/@stdlib/repl/lib/commands/donate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/donate.js rename to lib/node_modules/@stdlib/repl/lib/commands/donate.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/evalin.js b/lib/node_modules/@stdlib/repl/lib/commands/evalin.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/evalin.js rename to lib/node_modules/@stdlib/repl/lib/commands/evalin.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/example.js b/lib/node_modules/@stdlib/repl/lib/commands/example.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/example.js rename to lib/node_modules/@stdlib/repl/lib/commands/example.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/get_theme.js b/lib/node_modules/@stdlib/repl/lib/commands/get_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/get_theme.js rename to lib/node_modules/@stdlib/repl/lib/commands/get_theme.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/help.js b/lib/node_modules/@stdlib/repl/lib/commands/help.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/help.js rename to lib/node_modules/@stdlib/repl/lib/commands/help.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/info.js b/lib/node_modules/@stdlib/repl/lib/commands/info.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/info.js rename to lib/node_modules/@stdlib/repl/lib/commands/info.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/is_keyword.js b/lib/node_modules/@stdlib/repl/lib/commands/is_keyword.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/is_keyword.js rename to lib/node_modules/@stdlib/repl/lib/commands/is_keyword.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/is_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/is_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/keybindings.js b/lib/node_modules/@stdlib/repl/lib/commands/keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/keybindings.js rename to lib/node_modules/@stdlib/repl/lib/commands/keybindings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/license_text.js b/lib/node_modules/@stdlib/repl/lib/commands/license_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/license_text.js rename to lib/node_modules/@stdlib/repl/lib/commands/license_text.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/load.js b/lib/node_modules/@stdlib/repl/lib/commands/load.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/load.js rename to lib/node_modules/@stdlib/repl/lib/commands/load.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/load_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/load_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/pager.js b/lib/node_modules/@stdlib/repl/lib/commands/pager.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/pager.js rename to lib/node_modules/@stdlib/repl/lib/commands/pager.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_start.js b/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js similarity index 98% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_start.js rename to lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js index 127ad2a6f584..949a23831efd 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_start.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js @@ -29,7 +29,7 @@ var isPlainObject = require( '@stdlib/assert/is-plain-object' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var propertyDescriptor = require( '@stdlib/utils/property-descriptor' ); var properties = require( '@stdlib/utils/properties' ); -var Presentation = require( '@stdlib/repl/cli/presentation' ); // eslint-disable-line stdlib/no-redeclare +var Presentation = require( '@stdlib/repl/presentation' ); // eslint-disable-line stdlib/no-redeclare var format = require( '@stdlib/string/format' ); var setdiff = require( './../setdiff.js' ); var propertyComparator = require( './../property_comparator.js' ); diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_stop.js b/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/presentation_stop.js rename to lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/quit.js b/lib/node_modules/@stdlib/repl/lib/commands/quit.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/quit.js rename to lib/node_modules/@stdlib/repl/lib/commands/quit.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/rename_theme.js b/lib/node_modules/@stdlib/repl/lib/commands/rename_theme.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/rename_theme.js rename to lib/node_modules/@stdlib/repl/lib/commands/rename_theme.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/rename_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/rename_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/rerequire.js b/lib/node_modules/@stdlib/repl/lib/commands/rerequire.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/rerequire.js rename to lib/node_modules/@stdlib/repl/lib/commands/rerequire.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/rerun.js b/lib/node_modules/@stdlib/repl/lib/commands/rerun.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/rerun.js rename to lib/node_modules/@stdlib/repl/lib/commands/rerun.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/reset.js b/lib/node_modules/@stdlib/repl/lib/commands/reset.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/reset.js rename to lib/node_modules/@stdlib/repl/lib/commands/reset.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/set_keybinding.js b/lib/node_modules/@stdlib/repl/lib/commands/set_keybinding.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/set_keybinding.js rename to lib/node_modules/@stdlib/repl/lib/commands/set_keybinding.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/settings.js b/lib/node_modules/@stdlib/repl/lib/commands/settings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/settings.js rename to lib/node_modules/@stdlib/repl/lib/commands/settings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/themes.js b/lib/node_modules/@stdlib/repl/lib/commands/themes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/themes.js rename to lib/node_modules/@stdlib/repl/lib/commands/themes.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/tutorial.js b/lib/node_modules/@stdlib/repl/lib/commands/tutorial.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/tutorial.js rename to lib/node_modules/@stdlib/repl/lib/commands/tutorial.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/user_doc.js b/lib/node_modules/@stdlib/repl/lib/commands/user_doc.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/user_doc.js rename to lib/node_modules/@stdlib/repl/lib/commands/user_doc.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/vars.js b/lib/node_modules/@stdlib/repl/lib/commands/vars.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/vars.js rename to lib/node_modules/@stdlib/repl/lib/commands/vars.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/vars_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/vars_workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/workspace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/workspace.js rename to lib/node_modules/@stdlib/repl/lib/commands/workspace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/commands/workspaces.js b/lib/node_modules/@stdlib/repl/lib/commands/workspaces.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/commands/workspaces.js rename to lib/node_modules/@stdlib/repl/lib/commands/workspaces.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/completer_engine.js b/lib/node_modules/@stdlib/repl/lib/completer_engine.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/completer_engine.js rename to lib/node_modules/@stdlib/repl/lib/completer_engine.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/completer_preview.js b/lib/node_modules/@stdlib/repl/lib/completer_preview.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/completer_preview.js rename to lib/node_modules/@stdlib/repl/lib/completer_preview.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/contains.js b/lib/node_modules/@stdlib/repl/lib/contains.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/contains.js rename to lib/node_modules/@stdlib/repl/lib/contains.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/default_keybindings.js b/lib/node_modules/@stdlib/repl/lib/default_keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/default_keybindings.js rename to lib/node_modules/@stdlib/repl/lib/default_keybindings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/defaults.js b/lib/node_modules/@stdlib/repl/lib/defaults.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/defaults.js rename to lib/node_modules/@stdlib/repl/lib/defaults.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/display_prompt.js b/lib/node_modules/@stdlib/repl/lib/display_prompt.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/display_prompt.js rename to lib/node_modules/@stdlib/repl/lib/display_prompt.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js b/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/eager_evaluator.js rename to lib/node_modules/@stdlib/repl/lib/eager_evaluator.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/editor_actions.js b/lib/node_modules/@stdlib/repl/lib/editor_actions.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/editor_actions.js rename to lib/node_modules/@stdlib/repl/lib/editor_actions.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/find_unique_entry.js b/lib/node_modules/@stdlib/repl/lib/find_unique_entry.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/find_unique_entry.js rename to lib/node_modules/@stdlib/repl/lib/find_unique_entry.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/help_text.js b/lib/node_modules/@stdlib/repl/lib/help_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/help_text.js rename to lib/node_modules/@stdlib/repl/lib/help_text.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/index.js b/lib/node_modules/@stdlib/repl/lib/index.js similarity index 93% rename from lib/node_modules/@stdlib/repl/cli/lib/index.js rename to lib/node_modules/@stdlib/repl/lib/index.js index e2219323a672..063fd52f6aa5 100644 --- a/lib/node_modules/@stdlib/repl/cli/lib/index.js +++ b/lib/node_modules/@stdlib/repl/lib/index.js @@ -21,11 +21,11 @@ /** * REPL environment. * -* @module @stdlib/repl/cli +* @module @stdlib/repl * * @example * var debug = require( '@stdlib/streams/node/debug-sink' ); -* var REPL = require( '@stdlib/repl/cli' ); +* var REPL = require( '@stdlib/repl' ); * * function onExit() { * console.log( 'REPL closed.' ); diff --git a/lib/node_modules/@stdlib/repl/cli/lib/index_of.js b/lib/node_modules/@stdlib/repl/lib/index_of.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/index_of.js rename to lib/node_modules/@stdlib/repl/lib/index_of.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/input_prompt.js b/lib/node_modules/@stdlib/repl/lib/input_prompt.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/input_prompt.js rename to lib/node_modules/@stdlib/repl/lib/input_prompt.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/is_setting_name.js b/lib/node_modules/@stdlib/repl/lib/is_setting_name.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/is_setting_name.js rename to lib/node_modules/@stdlib/repl/lib/is_setting_name.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/keybindings.js b/lib/node_modules/@stdlib/repl/lib/keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/keybindings.js rename to lib/node_modules/@stdlib/repl/lib/keybindings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/log.js b/lib/node_modules/@stdlib/repl/lib/log.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/log.js rename to lib/node_modules/@stdlib/repl/lib/log.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/longest_common_prefix.js b/lib/node_modules/@stdlib/repl/lib/longest_common_prefix.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/longest_common_prefix.js rename to lib/node_modules/@stdlib/repl/lib/longest_common_prefix.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/main.js rename to lib/node_modules/@stdlib/repl/lib/main.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js b/lib/node_modules/@stdlib/repl/lib/multiline_handler.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/multiline_handler.js rename to lib/node_modules/@stdlib/repl/lib/multiline_handler.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/output_stream.js b/lib/node_modules/@stdlib/repl/lib/output_stream.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/output_stream.js rename to lib/node_modules/@stdlib/repl/lib/output_stream.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/parse_key.js b/lib/node_modules/@stdlib/repl/lib/parse_key.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/parse_key.js rename to lib/node_modules/@stdlib/repl/lib/parse_key.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/property_comparator.js b/lib/node_modules/@stdlib/repl/lib/property_comparator.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/property_comparator.js rename to lib/node_modules/@stdlib/repl/lib/property_comparator.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/regexp_leading_whitespace.js b/lib/node_modules/@stdlib/repl/lib/regexp_leading_whitespace.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/regexp_leading_whitespace.js rename to lib/node_modules/@stdlib/repl/lib/regexp_leading_whitespace.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/regexp_reserved_syntax_characters.js b/lib/node_modules/@stdlib/repl/lib/regexp_reserved_syntax_characters.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/regexp_reserved_syntax_characters.js rename to lib/node_modules/@stdlib/repl/lib/regexp_reserved_syntax_characters.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/repl_docs.js b/lib/node_modules/@stdlib/repl/lib/repl_docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/repl_docs.js rename to lib/node_modules/@stdlib/repl/lib/repl_docs.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/restore_regexp_matches.js b/lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/restore_regexp_matches.js rename to lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/set_commands.js b/lib/node_modules/@stdlib/repl/lib/set_commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/set_commands.js rename to lib/node_modules/@stdlib/repl/lib/set_commands.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/set_commands_global.js b/lib/node_modules/@stdlib/repl/lib/set_commands_global.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/set_commands_global.js rename to lib/node_modules/@stdlib/repl/lib/set_commands_global.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/setdiff.js b/lib/node_modules/@stdlib/repl/lib/setdiff.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/setdiff.js rename to lib/node_modules/@stdlib/repl/lib/setdiff.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/settings.js b/lib/node_modules/@stdlib/repl/lib/settings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/settings.js rename to lib/node_modules/@stdlib/repl/lib/settings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/settings_names.js b/lib/node_modules/@stdlib/repl/lib/settings_names.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/settings_names.js rename to lib/node_modules/@stdlib/repl/lib/settings_names.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/settings_validators.js b/lib/node_modules/@stdlib/repl/lib/settings_validators.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/settings_validators.js rename to lib/node_modules/@stdlib/repl/lib/settings_validators.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js b/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/syntax_highlighter.js rename to lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/themes.js b/lib/node_modules/@stdlib/repl/lib/themes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/themes.js rename to lib/node_modules/@stdlib/repl/lib/themes.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/update_regexp_cache.js b/lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/update_regexp_cache.js rename to lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/validate.js b/lib/node_modules/@stdlib/repl/lib/validate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/validate.js rename to lib/node_modules/@stdlib/repl/lib/validate.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/validate_keybindings.js b/lib/node_modules/@stdlib/repl/lib/validate_keybindings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/validate_keybindings.js rename to lib/node_modules/@stdlib/repl/lib/validate_keybindings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/validate_settings.js b/lib/node_modules/@stdlib/repl/lib/validate_settings.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/validate_settings.js rename to lib/node_modules/@stdlib/repl/lib/validate_settings.js diff --git a/lib/node_modules/@stdlib/repl/cli/lib/welcome_text.js b/lib/node_modules/@stdlib/repl/lib/welcome_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/lib/welcome_text.js rename to lib/node_modules/@stdlib/repl/lib/welcome_text.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/README.md b/lib/node_modules/@stdlib/repl/presentation/README.md similarity index 91% rename from lib/node_modules/@stdlib/repl/cli/presentation/README.md rename to lib/node_modules/@stdlib/repl/presentation/README.md index dca6d7d76b3a..d27fc703d301 100644 --- a/lib/node_modules/@stdlib/repl/cli/presentation/README.md +++ b/lib/node_modules/@stdlib/repl/presentation/README.md @@ -20,13 +20,13 @@ limitations under the License. # REPL Presentation -> Run a [REPL][@stdlib/repl/cli] presentation. +> Run a [REPL][@stdlib/repl] presentation.
-This package allows building presentations using only a [REPL][@stdlib/repl/cli] environment. +This package allows building presentations using only a [REPL][@stdlib/repl] environment. @@ -46,7 +46,7 @@ This package allows building presentations using only a [REPL][@stdlib/repl/cli] ### Authoring -A [REPL][@stdlib/repl/cli] presentation source file is a text file which includes minimal markup for delineating slides, slide fragments, speaker notes, code, text alignment, and styling. +A [REPL][@stdlib/repl] presentation source file is a text file which includes minimal markup for delineating slides, slide fragments, speaker notes, code, text alignment, and styling. #### Slides @@ -140,7 +140,7 @@ var x = 3.14; ```` -Only JavaScript code blocks are runnable. To run JavaScript code on the current slide, invoke the presentation command `runSlide()` at the [REPL][@stdlib/repl/cli] prompt. +Only JavaScript code blocks are runnable. To run JavaScript code on the current slide, invoke the presentation command `runSlide()` at the [REPL][@stdlib/repl] prompt. #### Speaker Notes @@ -329,18 +329,18 @@ And lastly, custom patterns can include [emoji][@stdlib/datasets/emoji]. For exa ```javascript -var Presentation = require( '@stdlib/repl/cli/presentation' ); +var Presentation = require( '@stdlib/repl/presentation' ); ``` #### Presentation( \[text,] repl\[, options] ) -Returns a [REPL][@stdlib/repl/cli] presentation instance for running a presentation in a provided [`repl`][@stdlib/repl/cli]. +Returns a [REPL][@stdlib/repl] presentation instance for running a presentation in a provided [`repl`][@stdlib/repl]. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -363,11 +363,11 @@ The function accepts the following `options`: - **borderLeft**: left border character sequence. Default: `'* '`. - **borderRight**: right border character sequence. Default: `' *'`. - **counter**: slide counter. Can either be `true`, `false`, or `'progress'`. Default: `false`. -- **width**: presentation width. If `null`, the presentation width is either computed based on the screen size (if a [REPL][@stdlib/repl/cli] output stream is TTY) or set to `80` characters. Default: `null`. -- **height**: presentation height. If `null`, the presentation height is either computed based on the screen size (if a [REPL][@stdlib/repl/cli] output stream is TTY) or set to `25` rows. Default: `null`. -- **workspace**: [REPL][@stdlib/repl/cli] workspace name. A presentation instance adds presentation commands to the specified workspace, thus allowing presentation navigation and interaction. Default: `'presentation'`. +- **width**: presentation width. If `null`, the presentation width is either computed based on the screen size (if a [REPL][@stdlib/repl] output stream is TTY) or set to `80` characters. Default: `null`. +- **height**: presentation height. If `null`, the presentation height is either computed based on the screen size (if a [REPL][@stdlib/repl] output stream is TTY) or set to `25` rows. Default: `null`. +- **workspace**: [REPL][@stdlib/repl] workspace name. A presentation instance adds presentation commands to the specified workspace, thus allowing presentation navigation and interaction. Default: `'presentation'`. - **load**: file path specifying a presentation file to load. If a presentation `text` is provided, this option is **ignored**. -- **autoClear**: `boolean` indicating whether to automatically clear the screen before writing a rendered slide to the [REPL][@stdlib/repl/cli]. Default: `true`. +- **autoClear**: `boolean` indicating whether to automatically clear the screen before writing a rendered slide to the [REPL][@stdlib/repl]. Default: `true`. - **loop**: `boolean` indicating whether to "loop" a presentation (i.e., proceed to the first slide after the last slide and have the last slide precede the first slide). Default: `false`. To initialize a presentation upon instantiating a `Presentation` instance, **either** provide a `string` as the first argument containing the presentation text to render **or** set the `load` option to specify a presentation file to load. @@ -380,7 +380,7 @@ Returns the current presentation slide index. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -411,7 +411,7 @@ Jumps to the last fragment of the last slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -440,7 +440,7 @@ Jumps to the first slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -469,7 +469,7 @@ Jumps to the first fragment of the current slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -498,7 +498,7 @@ Returns the presentation height. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -523,7 +523,7 @@ Jumps a specified number of slides. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -557,7 +557,7 @@ Jumps to a specified slide, where `n` is the nominal (i.e., one-based) slide num ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -586,7 +586,7 @@ Jumps to the last slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -615,7 +615,7 @@ Jumps to the last fragment of the current slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -644,7 +644,7 @@ Returns the presentation length (i.e., number of slides). ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -673,7 +673,7 @@ Loads a presentation from a `file`. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -708,7 +708,7 @@ Moves the presentation to the next slide or slide fragment. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -737,7 +737,7 @@ Moves the presentation to the next slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -766,7 +766,7 @@ Moves the presentation to the previous slide or slide fragment. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -795,7 +795,7 @@ Moves the presentation to the previous slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -824,7 +824,7 @@ Reloads a presentation. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -857,7 +857,7 @@ Renders the current presentation slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -889,7 +889,7 @@ Runs any code on the current presentation slide. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -912,13 +912,13 @@ function done() { #### Presentation.prototype.show() -Shows a presentation slide (i.e., writes a rendered slide to the presentation [REPL][@stdlib/repl/cli]) +Shows a presentation slide (i.e., writes a rendered slide to the presentation [REPL][@stdlib/repl]) ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -947,7 +947,7 @@ Returns the presentation content height. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -972,7 +972,7 @@ Returns the presentation content width. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -997,7 +997,7 @@ Stops watching a presentation file for changes. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -1035,7 +1035,7 @@ Watches a presentation source file for changes. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -1070,7 +1070,7 @@ Returns the presentation width. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); // Create a new REPL: var repl = new REPL({ @@ -1091,7 +1091,7 @@ repl.close(); ### Commands -[REPL][@stdlib/repl/cli] instances running a [REPL][@stdlib/repl/cli] presentation support the following commands within the presentation workspace... +[REPL][@stdlib/repl] instances running a [REPL][@stdlib/repl] presentation support the following commands within the presentation workspace... #### blank() @@ -1305,7 +1305,7 @@ In [1]: watch(); ### Events -A [REPL][@stdlib/repl/cli] presentation emits the following events... +A [REPL][@stdlib/repl] presentation emits the following events... #### 'watch' @@ -1315,7 +1315,7 @@ This event is emitted upon watching a source presentation file. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); function onWatch() { console.log( 'Watching a source file.' ); @@ -1344,7 +1344,7 @@ When watching a source presentation file, this event is emitted whenever a sourc ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); function onChange() { console.log( 'Source file changed.' ); @@ -1373,7 +1373,7 @@ This event is emitted upon no longer watching a source presentation file. ```javascript var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); function onUnwatch( error ) { console.log( 'No longer watching a source file.' ); @@ -1410,7 +1410,7 @@ repl.close(); ## Notes -- Multiple presentations can be run simultaneously within the same [REPL][@stdlib/repl/cli] environment. To do so, assign each presentation instance to a unique workspace. +- Multiple presentations can be run simultaneously within the same [REPL][@stdlib/repl] environment. To do so, assign each presentation instance to a unique workspace.
@@ -1431,8 +1431,8 @@ repl.close(); ```javascript var join = require( 'path' ).join; var debug = require( '@stdlib/streams/node/debug-sink' ); -var REPL = require( '@stdlib/repl/cli' ); -var Presentation = require( '@stdlib/repl/cli/presentation' ); +var REPL = require( '@stdlib/repl' ); +var Presentation = require( '@stdlib/repl/presentation' ); function onExit() { console.log( '' ); @@ -1580,7 +1580,7 @@ cat ./path/to/presentation.txt | stdlib-repl-presentation [standard-streams]: https://en.wikipedia.org/wiki/Standard_streams -[@stdlib/repl/cli]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/repl/cli +[@stdlib/repl]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/repl [@stdlib/datasets/emoji]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/datasets/emoji diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/bin/cli b/lib/node_modules/@stdlib/repl/presentation/bin/cli similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/bin/cli rename to lib/node_modules/@stdlib/repl/presentation/bin/cli diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/data/example.csv b/lib/node_modules/@stdlib/repl/presentation/data/example.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/data/example.csv rename to lib/node_modules/@stdlib/repl/presentation/data/example.csv diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/data/example.json b/lib/node_modules/@stdlib/repl/presentation/data/example.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/data/example.json rename to lib/node_modules/@stdlib/repl/presentation/data/example.json diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/data/help.csv b/lib/node_modules/@stdlib/repl/presentation/data/help.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/data/help.csv rename to lib/node_modules/@stdlib/repl/presentation/data/help.csv diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/data/help.json b/lib/node_modules/@stdlib/repl/presentation/data/help.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/data/help.json rename to lib/node_modules/@stdlib/repl/presentation/data/help.json diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/data/info.csv b/lib/node_modules/@stdlib/repl/presentation/data/info.csv similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/data/info.csv rename to lib/node_modules/@stdlib/repl/presentation/data/info.csv diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/data/info.json b/lib/node_modules/@stdlib/repl/presentation/data/info.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/data/info.json rename to lib/node_modules/@stdlib/repl/presentation/data/info.json diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/blank.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/blank.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/blank.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/blank.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/current_slide.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/current_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/current_slide.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/current_slide.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/end.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/end.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/end.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/end.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/first.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/first.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first_fragment.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/first_fragment.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/first_fragment.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/first_fragment.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/jump.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/jump.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump_to.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/jump_to.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/jump_to.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/jump_to.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/last.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/last.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last_fragment.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/last_fragment.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/last_fragment.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/last_fragment.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/load_presentation.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/load_presentation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/load_presentation.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/load_presentation.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/next.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/next.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next_slide.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/next_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/next_slide.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/next_slide.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/num_slides.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/num_slides.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/num_slides.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/num_slides.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/pres.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/pres.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/pres.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/pres.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/prev.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/prev.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev_slide.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/prev_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/prev_slide.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/prev_slide.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/redraw.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/redraw.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/redraw.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/redraw.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/reload_presentation.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/reload_presentation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/reload_presentation.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/reload_presentation.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/render_slide.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/render_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/render_slide.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/render_slide.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/run_slide.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/run_slide.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/run_slide.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/run_slide.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/unwatch.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/unwatch.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/unwatch.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/unwatch.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/watch.txt b/lib/node_modules/@stdlib/repl/presentation/docs/commands/watch.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/commands/watch.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/commands/watch.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/docs/usage.txt b/lib/node_modules/@stdlib/repl/presentation/docs/usage.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/docs/usage.txt rename to lib/node_modules/@stdlib/repl/presentation/docs/usage.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/etc/cli_opts.json b/lib/node_modules/@stdlib/repl/presentation/etc/cli_opts.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/etc/cli_opts.json rename to lib/node_modules/@stdlib/repl/presentation/etc/cli_opts.json diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/examples/index.js b/lib/node_modules/@stdlib/repl/presentation/examples/index.js similarity index 97% rename from lib/node_modules/@stdlib/repl/cli/presentation/examples/index.js rename to lib/node_modules/@stdlib/repl/presentation/examples/index.js index 0a34df541338..f74db49e0416 100644 --- a/lib/node_modules/@stdlib/repl/cli/presentation/examples/index.js +++ b/lib/node_modules/@stdlib/repl/presentation/examples/index.js @@ -19,7 +19,7 @@ 'use strict'; var join = require( 'path' ).join; -var REPL = require( '@stdlib/repl/cli' ); +var REPL = require( '@stdlib/repl' ); var Presentation = require( './../lib' ); // eslint-disable-line stdlib/no-redeclare function onExit() { diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/examples/presentation.txt b/lib/node_modules/@stdlib/repl/presentation/examples/presentation.txt similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/examples/presentation.txt rename to lib/node_modules/@stdlib/repl/presentation/examples/presentation.txt diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_center.js b/lib/node_modules/@stdlib/repl/presentation/lib/align_center.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/align_center.js rename to lib/node_modules/@stdlib/repl/presentation/lib/align_center.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_left.js b/lib/node_modules/@stdlib/repl/presentation/lib/align_flush_left.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_left.js rename to lib/node_modules/@stdlib/repl/presentation/lib/align_flush_left.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_right.js b/lib/node_modules/@stdlib/repl/presentation/lib/align_flush_right.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/align_flush_right.js rename to lib/node_modules/@stdlib/repl/presentation/lib/align_flush_right.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_left.js b/lib/node_modules/@stdlib/repl/presentation/lib/align_left.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/align_left.js rename to lib/node_modules/@stdlib/repl/presentation/lib/align_left.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_line.js b/lib/node_modules/@stdlib/repl/presentation/lib/align_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/align_line.js rename to lib/node_modules/@stdlib/repl/presentation/lib/align_line.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/align_right.js b/lib/node_modules/@stdlib/repl/presentation/lib/align_right.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/align_right.js rename to lib/node_modules/@stdlib/repl/presentation/lib/align_right.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_code.js b/lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_code.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_code.js rename to lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_code.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_codes.js b/lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_codes.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/ansi_escape_codes.js rename to lib/node_modules/@stdlib/repl/presentation/lib/ansi_escape_codes.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/blank_line.js b/lib/node_modules/@stdlib/repl/presentation/lib/blank_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/blank_line.js rename to lib/node_modules/@stdlib/repl/presentation/lib/blank_line.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/blank.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/blank.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/blank.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/blank.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/current_slide.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/current_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/current_slide.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/current_slide.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/end.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/end.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/end.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/end.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/first.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/first.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first_fragment.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/first_fragment.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/first_fragment.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/first_fragment.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/jump.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/jump.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump_to.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/jump_to.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/jump_to.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/jump_to.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/last.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/last.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last_fragment.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/last_fragment.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/last_fragment.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/last_fragment.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/load_presentation.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/load_presentation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/load_presentation.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/load_presentation.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/next.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/next.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next_slide.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/next_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/next_slide.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/next_slide.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/num_slides.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/num_slides.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/num_slides.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/num_slides.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/pres.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/pres.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/pres.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/pres.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/prev.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/prev.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev_slide.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/prev_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/prev_slide.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/prev_slide.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/redraw.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/redraw.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/redraw.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/redraw.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/reload_presentation.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/reload_presentation.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/reload_presentation.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/reload_presentation.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/render_slide.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/render_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/render_slide.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/render_slide.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/run_slide.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/run_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/run_slide.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/run_slide.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/unwatch.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/unwatch.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/unwatch.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/unwatch.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/watch.js b/lib/node_modules/@stdlib/repl/presentation/lib/commands/watch.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/commands/watch.js rename to lib/node_modules/@stdlib/repl/presentation/lib/commands/watch.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/defaults.js b/lib/node_modules/@stdlib/repl/presentation/lib/defaults.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/defaults.js rename to lib/node_modules/@stdlib/repl/presentation/lib/defaults.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/docs.js b/lib/node_modules/@stdlib/repl/presentation/lib/docs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/docs.js rename to lib/node_modules/@stdlib/repl/presentation/lib/docs.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/emoji.js b/lib/node_modules/@stdlib/repl/presentation/lib/emoji.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/emoji.js rename to lib/node_modules/@stdlib/repl/presentation/lib/emoji.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/fill_line.js b/lib/node_modules/@stdlib/repl/presentation/lib/fill_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/fill_line.js rename to lib/node_modules/@stdlib/repl/presentation/lib/fill_line.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/footer.js b/lib/node_modules/@stdlib/repl/presentation/lib/footer.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/footer.js rename to lib/node_modules/@stdlib/repl/presentation/lib/footer.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/format.js b/lib/node_modules/@stdlib/repl/presentation/lib/format.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/format.js rename to lib/node_modules/@stdlib/repl/presentation/lib/format.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/help_text.js b/lib/node_modules/@stdlib/repl/presentation/lib/help_text.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/help_text.js rename to lib/node_modules/@stdlib/repl/presentation/lib/help_text.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/horizontal_rule.js b/lib/node_modules/@stdlib/repl/presentation/lib/horizontal_rule.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/horizontal_rule.js rename to lib/node_modules/@stdlib/repl/presentation/lib/horizontal_rule.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/index.js b/lib/node_modules/@stdlib/repl/presentation/lib/index.js similarity index 88% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/index.js rename to lib/node_modules/@stdlib/repl/presentation/lib/index.js index 00c58c9544eb..73364031e9fb 100644 --- a/lib/node_modules/@stdlib/repl/cli/presentation/lib/index.js +++ b/lib/node_modules/@stdlib/repl/presentation/lib/index.js @@ -21,12 +21,12 @@ /** * REPL presentation. * -* @module @stdlib/repl/cli/presentation +* @module @stdlib/repl/presentation * * @example * var debug = require( '@stdlib/streams/node/debug-sink' ); -* var REPL = require( '@stdlib/repl/cli' ); -* var Presentation = require( '@stdlib/repl/cli/presentation' ); +* var REPL = require( '@stdlib/repl' ); +* var Presentation = require( '@stdlib/repl/presentation' ); * * function onExit() { * console.log( 'REPL closed.' ); diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/main.js b/lib/node_modules/@stdlib/repl/presentation/lib/main.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/main.js rename to lib/node_modules/@stdlib/repl/presentation/lib/main.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/parse.js b/lib/node_modules/@stdlib/repl/presentation/lib/parse.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/parse.js rename to lib/node_modules/@stdlib/repl/presentation/lib/parse.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/parse_slide.js b/lib/node_modules/@stdlib/repl/presentation/lib/parse_slide.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/parse_slide.js rename to lib/node_modules/@stdlib/repl/presentation/lib/parse_slide.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/set_commands.js b/lib/node_modules/@stdlib/repl/presentation/lib/set_commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/set_commands.js rename to lib/node_modules/@stdlib/repl/presentation/lib/set_commands.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/style_line.js b/lib/node_modules/@stdlib/repl/presentation/lib/style_line.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/style_line.js rename to lib/node_modules/@stdlib/repl/presentation/lib/style_line.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/style_to_ansi.js b/lib/node_modules/@stdlib/repl/presentation/lib/style_to_ansi.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/style_to_ansi.js rename to lib/node_modules/@stdlib/repl/presentation/lib/style_to_ansi.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/styles.js b/lib/node_modules/@stdlib/repl/presentation/lib/styles.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/styles.js rename to lib/node_modules/@stdlib/repl/presentation/lib/styles.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/lib/validate.js b/lib/node_modules/@stdlib/repl/presentation/lib/validate.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/lib/validate.js rename to lib/node_modules/@stdlib/repl/presentation/lib/validate.js diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/package.json b/lib/node_modules/@stdlib/repl/presentation/package.json similarity index 97% rename from lib/node_modules/@stdlib/repl/cli/presentation/package.json rename to lib/node_modules/@stdlib/repl/presentation/package.json index f3166178e52b..6f31caed483e 100644 --- a/lib/node_modules/@stdlib/repl/cli/presentation/package.json +++ b/lib/node_modules/@stdlib/repl/presentation/package.json @@ -1,5 +1,5 @@ { - "name": "@stdlib/repl/cli/presentation", + "name": "@stdlib/repl/presentation", "version": "0.0.0", "description": "REPL presentation.", "license": "Apache-2.0", diff --git a/lib/node_modules/@stdlib/repl/cli/presentation/scripts/build.js b/lib/node_modules/@stdlib/repl/presentation/scripts/build.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/presentation/scripts/build.js rename to lib/node_modules/@stdlib/repl/presentation/scripts/build.js diff --git a/lib/node_modules/@stdlib/repl/cli/scripts/build.js b/lib/node_modules/@stdlib/repl/scripts/build.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/scripts/build.js rename to lib/node_modules/@stdlib/repl/scripts/build.js diff --git a/lib/node_modules/@stdlib/repl/cli/scripts/build_contributors.js b/lib/node_modules/@stdlib/repl/scripts/build_contributors.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/scripts/build_contributors.js rename to lib/node_modules/@stdlib/repl/scripts/build_contributors.js diff --git a/lib/node_modules/@stdlib/repl/cli/scripts/build_help.js b/lib/node_modules/@stdlib/repl/scripts/build_help.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/scripts/build_help.js rename to lib/node_modules/@stdlib/repl/scripts/build_help.js diff --git a/lib/node_modules/@stdlib/repl/cli/scripts/build_license.js b/lib/node_modules/@stdlib/repl/scripts/build_license.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/scripts/build_license.js rename to lib/node_modules/@stdlib/repl/scripts/build_license.js diff --git a/lib/node_modules/@stdlib/repl/cli/scripts/build_tutorials.js b/lib/node_modules/@stdlib/repl/scripts/build_tutorials.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/scripts/build_tutorials.js rename to lib/node_modules/@stdlib/repl/scripts/build_tutorials.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/array_expression_right_bracket.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/object_expression_right_brace.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_backtick.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/right_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/negative/template_literal_with_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/arrow_function_body.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/binary_left_member_expression_literal.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_string_argument_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/call_expression_template_argument_left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_body.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/do_while_test_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_body.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_body.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_body.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_init.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_init.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_init.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_init.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_test_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/for_update_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_body.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/function_declaration_signature.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_brace.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_brace.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_brace.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/left_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_left_member_expression_literal.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_left_nested_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/logical_with_right_member_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_assignment_expression_literal.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/member_expression_call_expression.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/object_expression_left_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_body_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_literal_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/regexp_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/tagged_template_left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_brace.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/template_literal_expression_with_left_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/three_backticks.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/variable_declaration_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_body.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_body.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_body.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_body.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_test.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_test.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/positive/while_test.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/positive/while_test.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/script.js b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/script.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-close-pairs/script.js rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-close-pairs/script.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/array_expression_left_bracket_within_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_backtick_within_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_double_quote_within_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_parenthesis_within_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/left_single_quote_within_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/negative/object_expression_left_brace_within_string.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/array_expression_left_bracket.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_backtick.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_double_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_parenthesis.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/left_single_quote.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/positive/object_expression_left_brace.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/script.js b/lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/script.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/auto-delete-pairs/script.js rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/auto-delete-pairs/script.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/repl.js b/lib/node_modules/@stdlib/repl/test/integration/fixtures/repl.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/repl.js rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/repl.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/comments.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/comments.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/comments.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/comments.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/control_keywords.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/control_keywords.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/control_keywords.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/control_keywords.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/declaration_names.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/declaration_names.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/declaration_names.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/declaration_names.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/functions.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/functions.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/functions.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/functions.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/keywords.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/keywords.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/keywords.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/keywords.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/local_scopes.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/local_scopes.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/local_scopes.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/local_scopes.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/member_expressions.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/member_expressions.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/member_expressions.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/member_expressions.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/numeric_literals.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/numeric_literals.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/numeric_literals.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/numeric_literals.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/objects.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/objects.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/objects.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/objects.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/operators.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/operators.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/operators.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/operators.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/punctuation.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/punctuation.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/punctuation.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/punctuation.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/regexp.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/regexp.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/regexp.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/regexp.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/reserved_literals.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/reserved_literals.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/reserved_literals.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/reserved_literals.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/special_identifiers.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/special_identifiers.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/special_identifiers.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/special_identifiers.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/string_literals.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/string_literals.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/string_literals.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/string_literals.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/variables.json b/lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/variables.json similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/fixtures/syntax-highlighting/variables.json rename to lib/node_modules/@stdlib/repl/test/integration/fixtures/syntax-highlighting/variables.json diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_close_pairs.js b/lib/node_modules/@stdlib/repl/test/integration/test.auto_close_pairs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_close_pairs.js rename to lib/node_modules/@stdlib/repl/test/integration/test.auto_close_pairs.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_delete_pairs.js b/lib/node_modules/@stdlib/repl/test/integration/test.auto_delete_pairs.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_delete_pairs.js rename to lib/node_modules/@stdlib/repl/test/integration/test.auto_delete_pairs.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js b/lib/node_modules/@stdlib/repl/test/integration/test.auto_page.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/test.auto_page.js rename to lib/node_modules/@stdlib/repl/test/integration/test.auto_page.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.completer_engine.js b/lib/node_modules/@stdlib/repl/test/integration/test.completer_engine.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/test.completer_engine.js rename to lib/node_modules/@stdlib/repl/test/integration/test.completer_engine.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js b/lib/node_modules/@stdlib/repl/test/integration/test.completion_previews.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/test.completion_previews.js rename to lib/node_modules/@stdlib/repl/test/integration/test.completion_previews.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/integration/test.syntax_highlighting.js b/lib/node_modules/@stdlib/repl/test/integration/test.syntax_highlighting.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/integration/test.syntax_highlighting.js rename to lib/node_modules/@stdlib/repl/test/integration/test.syntax_highlighting.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/test.cli.js b/lib/node_modules/@stdlib/repl/test/test.cli.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/test.cli.js rename to lib/node_modules/@stdlib/repl/test/test.cli.js diff --git a/lib/node_modules/@stdlib/repl/cli/test/test.js b/lib/node_modules/@stdlib/repl/test/test.js similarity index 100% rename from lib/node_modules/@stdlib/repl/cli/test/test.js rename to lib/node_modules/@stdlib/repl/test/test.js diff --git a/tools/make/lib/docs/repl.mk b/tools/make/lib/docs/repl.mk index e48b0646ba1f..798ce5fef305 100644 --- a/tools/make/lib/docs/repl.mk +++ b/tools/make/lib/docs/repl.mk @@ -22,8 +22,8 @@ # # This target generates REPL documentation. -repl-docs: repl-help repl-info repl-examples repl-signatures repl-typed-signatures repl-aliases repl-alias2pkg repl-pkg2alias repl-alias2related repl-alias2standalone repl-pkg2related repl-pkg2standalone repl-standalone2pkg $(NODE_MODULES) $(SRC_DIR)/@stdlib/repl/cli/scripts/build.js - $(QUIET) $(NODE) "$(SRC_DIR)/@stdlib/repl/cli/scripts/build.js" +repl-docs: repl-help repl-info repl-examples repl-signatures repl-typed-signatures repl-aliases repl-alias2pkg repl-pkg2alias repl-alias2related repl-alias2standalone repl-pkg2related repl-pkg2standalone repl-standalone2pkg $(NODE_MODULES) $(SRC_DIR)/@stdlib/repl/scripts/build.js + $(QUIET) $(NODE) "$(SRC_DIR)/@stdlib/repl/scripts/build.js" .PHONY: repl-docs From 85223c0e628898ae7e3c45aaeedc603eee4ea5ea Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 15 Mar 2025 14:52:23 +0000 Subject: [PATCH 17/26] refactor!: workspaces Signed-off-by: Snehil Shah --- 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: passed - 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 --- --- .../@stdlib/repl/base/ctor/README.md | 174 ++++- .../@stdlib/repl/base/ctor/lib/completer.js | 2 +- .../@stdlib/repl/base/ctor/lib/defaults.js | 4 - .../@stdlib/repl/base/ctor/lib/filter.js | 93 +++ .../repl/base/ctor/lib/is_multiline_input.js | 5 +- .../@stdlib/repl/base/ctor/lib/main.js | 726 +++++++++++++++++- .../@stdlib/repl/base/ctor/lib/tokenizer.js | 586 +++++++------- .../@stdlib/repl/base/ctor/lib/validate.js | 8 - .../@stdlib/repl/lib/commands/clear_vars.js | 4 +- .../repl/lib/commands/clear_workspace.js | 164 +--- .../repl/lib/commands/current_workspace.js | 4 +- .../repl/lib/commands/delete_workspace.js | 36 +- .../@stdlib/repl/lib/commands/evalin.js | 25 +- .../@stdlib/repl/lib/commands/is_workspace.js | 13 +- .../repl/lib/commands/load_workspace.js | 97 +-- .../repl/lib/commands/presentation_start.js | 7 +- .../repl/lib/commands/presentation_stop.js | 4 +- .../repl/lib/commands/rename_workspace.js | 32 +- .../@stdlib/repl/lib/commands/vars.js | 4 +- .../repl/lib/commands/vars_workspace.js | 118 +-- .../@stdlib/repl/lib/commands/workspace.js | 65 +- .../@stdlib/repl/lib/commands/workspaces.js | 7 +- .../@stdlib/repl/lib/completer_engine.js | 12 +- .../@stdlib/repl/lib/completer_preview.js | 14 +- lib/node_modules/@stdlib/repl/lib/main.js | 45 +- .../@stdlib/repl/lib/syntax_highlighter.js | 2 +- 26 files changed, 1379 insertions(+), 872 deletions(-) create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/lib/filter.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index 7aed15b623f9..4a8bb23f5762 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -67,7 +67,6 @@ 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`. @@ -76,6 +75,25 @@ The function accepts the following `options`: - **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`. +### Readable Properties + +#### REPL.prototype.currentWorkspace + +Name of the current workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Get current workspace name: +var ws = repl.currentWorkspace; + +// Close the REPL: +repl.close(); +``` + +### Methods + #### REPL.prototype.createContext() Returns a REPL context. @@ -114,6 +132,158 @@ repl.resetContext(); repl.close(); ``` +#### REPL.prototype.createWorkspace( name ) + +Creates a new workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Create new workspace: +repl.createWorkspace( 'myWorkspace' ); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.switchWorkspace( name ) + +Switches to a specified workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Switch workspace: +repl.switchWorkspace( 'yourWorkspace' ); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.loadWorkspace( name, \[options] ) + +Loads variables from a specified workspace into the current workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Load variables from a workspace: +var count = repl.loadWorkspace( 'yourWorkspace', {} ); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.workspaces() + +Returns list of all workspaces. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// List all workspaces: +var list = repl.workspaces(); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.varsWorkspace( name, \[options] ) + +Returns a list of variable names in a specified workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Get list of variables in current workspace: +var list = repl.varsWorkspace( repl.currentWorkspace ); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.renameWorkspace( oldName, newName ) + +Renames a workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Rename workspace: +repl.renameWorkspace( 'myWorkspace', 'yourWorkspace' ); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.deleteWorkspace( name ) + +Deletes a workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Delete workspace: +repl.deleteWorkspace( 'yourWorkspace' ); + +// ... + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.clearWorkspace( name, \[options] ) + +Deletes user-defined variables in a specified workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Clear user workspace: +var d = repl.clearWorkspace( 'myWorkspace' ); + +// ... + +// Close the REPL: +repl.close(); +``` + #### REPL.prototype.clearHistory() Clears a REPL's history. @@ -260,8 +430,6 @@ console.log( 'REPL closed.' );
-[@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 diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js index 7795ca7477ef..549e7bcc4171 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js @@ -74,7 +74,7 @@ function normalize( list ) { // MAIN // /** -* Returns a callback for supporting TAB completion in a REPL environment. +* Returns a callback for generating completions in a REPL environment. * * @private * @param {REPL} repl - REPL instance diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js index 7b9141c2df42..b6c32e95ca3e 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/defaults.js @@ -20,7 +20,6 @@ // MODULES // -var stdin = require( '@stdlib/streams/node/stdin' ); var stdout = require( '@stdlib/streams/node/stdout' ); var stderr = require( '@stdlib/streams/node/stderr' ); @@ -39,9 +38,6 @@ var stderr = require( '@stdlib/streams/node/stderr' ); */ function defaults() { return { - // Default input stream: - 'input': stdin, - // Default output stream: 'output': stdout, diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/filter.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/filter.js new file mode 100644 index 000000000000..f4b515e08b09 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/filter.js @@ -0,0 +1,93 @@ +/** +* @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'; + +// MODULES // + +var contains = require( './contains.js' ); + + +// MAIN // + +/** +* Filters a variable list based on include and exclude filters. +* +* @private +* @param {Array} list - variable list to filter +* @param {(RegExp|ArrayLikeObject|void)} include - name inclusion filter +* @param {boolean} isArrInc - boolean indicating whether the inclusion filter is an array +* @param {(RegExp|ArrayLikeObject|void)} exclude - name exclusion filter +* @param {boolean} isArrExc - boolean indicating whether the exclusion filter is an array +* @returns {Array} input list +*/ +function filter( list, include, isArrInc, exclude, isArrExc ) { + var FLG; + var v; + var i; + var j; + + // Perform list "compression" without using temporary data structures... + j = 0; + for ( i = 0; i < list.length; i += 2 ) { + // Note: we can only delete "configurable" variables... + if ( list[ i+1 ].configurable === false ) { + // Variable is non-configurable and, hence, cannot be deleted... + continue; + } + v = list[ i ]; + FLG = false; + + // Note: exclude/include order matters!!! + if ( exclude ) { + if ( isArrExc ) { + if ( contains( exclude, v ) ) { + // The variable is in the explicit exclude list: + FLG = true; + } + } else if ( exclude.test( v ) ) { + // The variable passes the exclusion test: + FLG = true; + } + } + // Only apply inclusion filters if the variable has not been already excluded from deletion... + if ( FLG === false && include ) { + if ( isArrInc ) { + if ( !contains( include, v ) ) { + // The variable is *not* in the include list: + FLG = true; + } + } else if ( !include.test( v ) ) { + // The variable does *not* pass the include test: + FLG = true; + } + } + if ( FLG ) { + list[ j ] = list[ i ]; + list[ j+1 ] = list[ i+1 ]; + j += 2; + } + } + list.length = j; + return list; +} + + +// EXPORTS // + +module.exports = filter; diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js index 27f4b4bceb32..ecad93e6c39c 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/is_multiline_input.js @@ -16,8 +16,6 @@ * limitations under the License. */ -/* eslint-disable no-invalid-this */ - 'use strict'; // MODULES // @@ -25,6 +23,7 @@ var Parser = require( 'acorn' ).Parser; var parseLoose = require( 'acorn-loose' ).parse; var logger = require( 'debug' ); +var processCommand = require( './process_command.js' ); var multilinePlugin = require( './acorn_detect_multiline_input.js' ); @@ -64,7 +63,7 @@ function isMultilineInput( input ) { return false; } // Check if the command has valid syntax... - tmp = this.processCommand( input ); + tmp = processCommand( input ); if ( !( tmp instanceof Error ) ) { debug( 'Multi-line input not detected.' ); return false; diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 790ae80526f6..43a0018907b5 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -16,7 +16,7 @@ * limitations under the License. */ -/* eslint-disable no-restricted-syntax, no-invalid-this, no-underscore-dangle */ +/* eslint-disable no-restricted-syntax, max-lines, no-invalid-this, no-underscore-dangle */ 'use strict'; @@ -26,10 +26,24 @@ var EventEmitter = require( 'events' ).EventEmitter; var logger = require( 'debug' ); var inherit = require( '@stdlib/utils/inherit' ); var isConfigurableProperty = require( '@stdlib/assert/is-configurable-property' ); +var isReadableProperty = require( '@stdlib/assert/is-readable-property' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var objectKeys = require( '@stdlib/utils/keys' ); +var properties = require( '@stdlib/utils/properties' ); +var typeOf = require( '@stdlib/utils/type-of' ); var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); +var setReadOnlyAccessor = require( '@stdlib/utils/define-nonenumerable-read-only-accessor' ); var setReadOnly = require( '@stdlib/utils/define-read-only-property' ); +var propertyDescriptor = require( '@stdlib/utils/property-descriptor' ); +var defineProperty = require( '@stdlib/utils/define-property' ); +var isFunction = require( '@stdlib/assert/is-function' ); +var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; +var isString = require( '@stdlib/assert/is-string' ).isPrimitive; +var isPlainObject = require( '@stdlib/assert/is-plain-object' ); +var isArrayLike = require( '@stdlib/assert/is-array-like-object' ); +var isRegExp = require( '@stdlib/assert/is-regexp' ); +var format = require( '@stdlib/string/format' ); var fifo = require( '@stdlib/dstructs/fifo' ); var nextTick = require( '@stdlib/utils/next-tick' ); var validate = require( './validate.js' ); @@ -38,11 +52,15 @@ var setAliases = require( './set_aliases.js' ); var setAliasesGlobal = require( './set_aliases_global.js' ); var createEvalContext = require( './create_evaluation_context.js' ); var completerFactory = require( './completer.js' ); -var tokenizer = require( './tokenizer.js' ); +var tokenizerFactory = require( './tokenizer.js' ); var processCommand = require( './process_command.js' ); var compileCommand = require( './compile_command.js' ); var processInput = require( './process_input.js' ); var isMultilineInput = require( './is_multiline_input.js' ); +var contains = require( './contains.js' ); +var filter = require( './filter.js' ); +var setdiff = require( './setdiff.js' ); +var propertyComparator = require( './property_comparator.js' ); var ALIAS_OVERRIDES = require( './alias_overrides.js' ); @@ -58,7 +76,6 @@ var debug = logger( 'repl' ); * * @constructor * @param {Options} options - constructor options -* @param {ReadableStream} [options.input=process.stdin] - input stream * @param {WritableStream} [options.output=process.stdout] - output stream * @param {WritableStream} [options.error=process.stderr] - error stream * @param {boolean} [options.sandbox=true] - boolean indicating whether to run a REPL in a sandboxed context @@ -105,8 +122,8 @@ function REPL( options ) { } debug( 'Options: %s', JSON.stringify({ - 'input': '', 'output': '', + 'error': '', 'sandbox': opts.sandbox, 'timeout': opts.timeout, 'isTTY': opts.isTTY, @@ -120,7 +137,6 @@ function REPL( options ) { EventEmitter.call( this ); // Cache references to the input and output streams: - setNonEnumerableReadOnly( this, '_istream', opts.input ); setNonEnumerableReadOnly( this, '_ostream', opts.output ); setNonEnumerableReadOnly( this, '_estream', opts.error ); @@ -129,12 +145,6 @@ function REPL( options ) { setNonEnumerableReadOnly( this, '_sandbox', opts.sandbox ); setNonEnumerable( this, '_quiet', opts.quiet ); // allow this to be internally toggled - // Initialize an internal data store: - setNonEnumerableReadOnly( this, '_internal', {} ); - setNonEnumerableReadOnly( this._internal, 'presentation', {} ); - setNonEnumerableReadOnly( this._internal.presentation, 'cache', {} ); - setNonEnumerable( this._internal.presentation, 'counter', 0 ); - // Initialize an internal command queue: setNonEnumerableReadOnly( this, '_queue', fifo() ); @@ -159,9 +169,6 @@ function REPL( options ) { // Initialize a strided internal cache of resolved global variables/properties in order to allow, e.g., help text look-up based on object reference, not just alias name (note: members alternate between `''` and ``): setNonEnumerableReadOnly( this, '_aliases', [] ); - // Initialize a strided internal buffer for storing user-defined documentation: - setNonEnumerableReadOnly( this, '_userdocs', [] ); - // Initialize an internal buffer for storing a (unique) sorted list of workspace global variables/properties which were *initially* introduced during a REPL session (note: this overlaps with `_globalVars`, but more accurately represents a snapshot of the `global` state *before* a user begins entering commands, which is useful when wanting determine what variables/identifiers a user has introduced during a REPL session): setNonEnumerableReadOnly( this, '_workspace', [] ); @@ -185,10 +192,13 @@ function REPL( options ) { setNonEnumerable( this, '_done', void 0 ); // Create a REPL execution context: - setNonEnumerable( this, '_context', this.createContext() ); + setNonEnumerable( this, '_context', this.createContext( opts.output, opts.error ) ); // Create a new completer: - setNonEnumerableReadOnly( this, 'completer', completerFactory( this ) ); + setNonEnumerableReadOnly( this, '_completer', completerFactory( this ) ); + + // Create a new tokenizer: + setNonEnumerableReadOnly( this, '_tokenizer', tokenizerFactory( this._context ) ); // Add listener for "command" events: this.on( 'command', onCommand ); @@ -261,6 +271,27 @@ function REPL( options ) { */ inherit( REPL, EventEmitter ); +/** +* Name of the current workspace. +* +* @name currentWorkspace +* @memberof REPL.prototype +* @type {string} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Get current workspace name: +* var ws = repl.currentWorkspace; +* +* // Close the REPL: +* repl.close(); +*/ +setReadOnlyAccessor( REPL.prototype, 'currentWorkspace', function get() { + return this._currentWorkspace; +}); + /** * Checks if the given input is a possible multi-line command. * @@ -281,7 +312,12 @@ inherit( REPL, EventEmitter ); * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'isMultilineInput', isMultilineInput ); +setNonEnumerableReadOnly( REPL.prototype, 'isMultilineInput', function check( input ) { + if ( !isString( input ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', input ) ); + } + return isMultilineInput( input ); +}); /** * Processes a "raw" input command. @@ -303,7 +339,12 @@ setNonEnumerableReadOnly( REPL.prototype, 'isMultilineInput', isMultilineInput ) * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'processCommand', processCommand ); +setNonEnumerableReadOnly( REPL.prototype, 'processCommand', function process( code ) { + if ( !isString( code ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', code ) ); + } + return processCommand( code ); +}); /** * Compiles a command. @@ -329,7 +370,50 @@ setNonEnumerableReadOnly( REPL.prototype, 'processCommand', processCommand ); * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', compileCommand ); +setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', function compile( cmd ) { + if ( !isString( cmd ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', cmd ) ); + } + return compileCommand( cmd ); +}); + +/** +* Generates completions for a given line. +* +* @name completer +* @memberof REPL.prototype +* @type {Function} +* @param {string} line - current line +* @param {Function} clbk - completion callback +* @returns {void} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Generate completions for a line: +* var line = 'var x = M'; +* repl.completer( line, clbk ); +* +* function clbk( error, completions ) { +* if ( error ) { +* throw error; +* } +* console.log( completions ); +* } +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'completer', function completer( line, clbk ) { + if ( !isString( line ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', line ) ); + } + if ( !isFunction(clbk) ) { + throw new TypeError( format( 'invalid argument. Second argument must be a function. Value: `%s`.', clbk ) ); + } + this._completer( line, clbk ); +}); /** * Tokenizes the input line based on ECMAScript specification. @@ -338,7 +422,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', compileCommand ); * @memberof REPL.prototype * @type {Function} * @param {string} line - input line -* @param {Object} context - REPL context * @returns {Array} array of tokens * * @example @@ -347,12 +430,17 @@ setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', compileCommand ); * * // Tokenize an input line: * var line = 'var x = 5;'; -* var out = repl.tokenizer( line, {} ); +* var out = repl.tokenizer( line ); * * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', tokenizer ); +setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', function tokenizer( line ) { + if ( !isString( line ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', line ) ); + } + return this._tokenizer( line ); +}); /** * Creates a REPL context. @@ -463,12 +551,14 @@ setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext( }); /** -* Clears a REPL's history. +* Creates a new workspace. * -* @name clearHistory +* @name createWorkspace * @memberof REPL.prototype * @type {Function} -* @returns {REPL} REPL instance +* @param {string} name - workspace name +* @throws {TypeError} must provide a unique workspace name +* @returns {void} * * @example * // Create a new REPL: @@ -476,24 +566,584 @@ setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext( * * // ... * -* // Clear the REPL history: -* repl.clearHistory(); +* // Create new workspace: +* repl.createWorkspace( 'myWorkspace' ); * * // ... * * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory() { - debug( 'Resetting REPL history...' ); - this._history.length = 0; - return this; +setNonEnumerableReadOnly( REPL.prototype, 'createWorkspace', function createWorkspace( name ) { + if ( hasOwnProp( this._workspaces, name ) ) { + throw new TypeError( format( 'invalid argument. Workspace already exists. Value: `%s`.', name ) ); + } + this._workspaces[ name ] = []; + debug( 'Created new workspace: %s.', name ); +}); + +/** +* Switches to a specified workspace. +* +* @name switchWorkspace +* @memberof REPL.prototype +* @type {Function} +* @param {string} name - workspace name +* @returns {void} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Switch workspace: +* repl.switchWorkspace( 'yourWorkspace' ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'switchWorkspace', function workspace( name ) { + var vars; + var curr; + var desc; + var ws; + var i; + + if ( !isString( name ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); + } + if ( !hasOwnProp( this._workspaces, name ) ) { + throw new TypeError( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); + } + curr = this._currentWorkspace; + if ( name === curr ) { + return; + } + // Cache and delete the current workspace variables... + vars = this._context.varsWorkspace( curr ); + ws = this._workspaces[ curr ]; + ws.length = 0; // reset + for ( i = 0; i < vars.length; i++ ) { + desc = propertyDescriptor( this._context, vars[ i ] ); + ws.push( vars[ i ], desc ); + + // WARNING: in non-sandboxed environments, we run the risk of deleting global variables which were not introduced by the REPL environment... + if ( desc.configurable ) { + delete this._context[ vars[ i ] ]; + } + } + // Reset the REPL evaluation context (Why? Because we cannot simply delete variables as seen within the REPL environment. E.g., variables declared with `var` in the global scope are non-configurable, and, thus, cannot be deleted (see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/delete). Hence, while we can delete a property/variable here, this deletion does not get propagated to within the REPL environment; i.e., a user can still access the deleted property as a variable within the REPL environment.): + this.resetContext(); + + // Load the workspace's variables... + ws = this._workspaces[ name ]; + for ( i = 0; i < ws.length; i += 2 ) { + desc = propertyDescriptor( this._context, ws[ i ] ); + + // If the variable does not already exist in the current evaluation context, define a new variable... + if ( desc === null ) { + defineProperty( this._context, ws[ i ], ws[ i+1 ] ); + } + // If configurable, we can simply overwrite the existing property descriptor... + else if ( desc.configurable ) { + defineProperty( this._context, ws[ i ], ws[ i+1 ] ); + } + // Otherwise, use direct assignment if the variable is writable... + else if ( hasOwnProp( desc, 'value' ) || hasOwnProp( desc, 'set' ) ) { + this._context[ ws[ i ] ] = ws[ i+1 ]; + } + // Cannot assign to the variable as the variable is read-only... + else { + debug( 'Cannot load \'%s\' from \'%s\' workspace due to the presence of a non-configurable read-only variable of the same name.', ws[ i ], name ); + } + } + ws.length = 0; // free up memory and prevent holding on to old references + debug( 'Switched to %s workspace.', name ); + + // Update the current workspace variable: + this._currentWorkspace = name; // bookkeeping +}); + +/** +* Loads variables from a specified workspace into the current workspace. +* +* @name loadWorkspace +* @memberof REPL.prototype +* @type {Function} +* @param {string} name - workspace name +* @param {Options} [options] - function options +* @param {(RegExp|ArrayLikeObject)} [options.include] - name inclusion filter +* @param {(RegExp|ArrayLikeObject)} [options.exclude] - name exclusion filter +* @param {boolean} [options.override=true] - boolean indicating whether to override existing workspace variables +* @returns {number} number of variables loaded +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Load variables from a workspace: +* var count = repl.loadWorkspace( 'myWorkspace', {} ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'loadWorkspace', function loadWorkspace( name, options ) { + var isArrInc; + var isArrExc; + var opts; + var cnt; + var ws; + var v; + var i; + if ( !isString( name ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); + } + opts = { + 'override': true + }; + if ( arguments.length > 1 ) { + if ( !isPlainObject( options ) ) { + throw new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', name ) ); + } + if ( hasOwnProp( options, 'include' ) ) { + isArrInc = isArrayLike( options.include ); + if ( isArrInc === false && !isRegExp( options.include ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'include', options.include ) ); + } + opts.include = options.include; + } + if ( hasOwnProp( options, 'exclude' ) ) { + isArrExc = isArrayLike( options.exclude ); + if ( isArrExc === false && !isRegExp( options.exclude ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'exclude', options.exclude ) ); + } + opts.exclude = options.exclude; + } + if ( hasOwnProp( options, 'override' ) ) { + if ( !isBoolean( options.override ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'override', options.override ) ); + } + opts.override = options.override; + } + } + if ( name === this._currentWorkspace ) { + return; + } + if ( !hasOwnProp( this._workspaces, name ) ) { + throw new TypeError( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); + } + ws = this._workspaces[ name ]; + + // Note: the internal branches are not the most performant implementation, but the implementation is straightforward and presumably "good enough"... + cnt = 0; + for ( i = 0; i < ws.length; i += 2 ) { + v = ws[ i ]; + if ( opts.include ) { + if ( isArrInc && !contains( opts.include, v ) ) { + continue; + } + if ( !opts.include.test( v ) ) { + continue; + } + } + if ( opts.exclude ) { + if ( isArrExc && contains( opts.exclude, v ) ) { + continue; + } + if ( opts.exclude.test( v ) ) { + continue; + } + } + if ( hasOwnProp( this._context, v ) && opts.override === false ) { + continue; + } + // If we've made it this far, the variable should have passed all filters... + cnt += 1; + defineProperty( this._context, v, ws[ i+1] ); + } + return cnt; +}); + +/** +* Returns list of all workspaces. +* +* @name workspaces +* @memberof REPL.prototype +* @type {Function} +* @returns {Array} workspace names +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // List all workspaces: +* var list = repl.workspaces(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'workspaces', function workspaces() { + return objectKeys( this._workspaces ); +}); + +/** +* Returns a list of variable names in a specified workspace. +* +* @name varsWorkspace +* @memberof REPL.prototype +* @type {Function} +* @param {string} name - workspace name +* @param {Options} [options] - function options +* @param {RegExp} [options.include] - name inclusion filter +* @param {RegExp} [options.exclude] - name exclusion filter +* @param {ArrayLikeObject} [options.types] - type inclusion filter(s) +* @param {boolean} [options.details] - boolean indicating whether to include additional variable details, such as variable type, contents, etc +* @throws {TypeError} must provide a recognized workspace name +* @returns {Array} workspace variable names +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Get list of variables in current workspace: +* var list = repl.varsWorkspace( repl.currentWorkspace ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'varsWorkspace', function varsWorkspace( name, options ) { + var list; + var type; + var out; + var tmp; + var FLG; + var i; + var v; + var j; + + if ( !isString( name ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); + } + if ( arguments.length > 1 ) { + if ( !isPlainObject( options ) ) { + throw new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) ); + } + } else { + options = {}; + } + if ( hasOwnProp( options, 'include' ) && !isRegExp( options.include ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a regular expression. Option: `%s`.', 'include', options.include ) ); + } + if ( hasOwnProp( options, 'exclude' ) && !isRegExp( options.exclude ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a regular expression. Option: `%s`.', 'exclude', options.include ) ); + } + if ( hasOwnProp( options, 'types' ) && !isArrayLike( options.types ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be an array-like object. Option: `%s`.', 'types', options.types ) ); + } + if ( hasOwnProp( options, 'details' ) && !isBoolean( options.details ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'details', options.details ) ); + } + if ( name === this._currentWorkspace ) { + tmp = properties( this._context ).sort( propertyComparator ); + tmp = setdiff( this._workspace, tmp ); + list = []; + for ( i = 0; i < tmp.length; i++ ) { + if ( isReadableProperty( this._context, tmp[ i ] ) ) { + list.push( tmp[ i ], this._context[ tmp[ i ] ] ); + } else { + // The variable can be set, but not retrieved (i.e., is write-only), so value inspection is not possible without triggering an error... + list.push( tmp[ i ], void 0 ); + } + } + } else { + if ( !hasOwnProp( this._workspaces, name ) ) { + throw new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); + } + list = this._workspaces[ name ].slice(); + for ( i = 1; i < list.length; i += 2 ) { + if ( typeof list[ i ].get === 'function' ) { + // WARNING: the `this` context is not defined, as the variable is not actually bound to a global instance! + list[ i ] = list[ i ].get.call( null ); + } else if ( typeof list[ i ].set === 'function' ) { + // The variable can be set, but not retrieved (i.e., is write-only), so value inspection is not possible without triggering an error... + list[ i ] = void 0; + } else { + list[ i ] = list[ i ].value; + } + } + } + out = []; + for ( i = 0; i < list.length; i += 2 ) { + v = list[ i ]; + FLG = false; + type = ''; + if ( options.include && !options.include.test( v ) ) { + continue; + } + if ( options.exclude && options.exclude.test( v ) ) { + continue; + } + if ( options.types ) { + type = typeOf( list[ i+1 ] ); + for ( j = 0; j < options.types.length; j++ ) { + if ( type === options.types[ j ] ) { + FLG = true; + break; + } + } + if ( FLG === false ) { + continue; + } + } + // If we've made it this far, the variable should have passed all filters... + out.push( v ); + if ( options.details ) { + j = out.length - 1; + out[ j ] = { + 'name': out[ j ], + 'type': type || typeOf( list[ i+1 ] ), + 'data': String( list[ i+1 ] ) // WARNING: for large datasets, this could be expensive!!! TODO: may want to consider alternative strategies for serialization based on a value's type. + }; + v = out[ j ].data; + if ( v.length > 20 ) { + out[ j ].data = v.slice( 0, 9 ) + '...' + v.slice( v.length-8 ); + } + } + } + return out; +}); + +/** +* Renames a workspace. +* +* @name renameWorkspace +* @memberof REPL.prototype +* @type {Function} +* @param {string} oldName - name of workspace to rename +* @param {string} newName - new workspace name +* @throws {TypeError} old name must be a recognized workspace name +* @throws {TypeError} new name must be a unique workspace name +* @throws {Error} new name must be different than the old name +* @returns {void} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Rename workspace: +* repl.renameWorkspace( 'myWorkspace', 'yourWorkspace' ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'renameWorkspace', function renameWorkspace( oldName, newName ) { + if ( !isString( oldName ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', oldName ) ); + } + if ( !isString( newName ) ) { + throw new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', newName ) ); + } + if ( !hasOwnProp( this._workspaces, oldName ) ) { + throw new TypeError( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', oldName ) ); + } + if ( oldName === newName ) { + throw new Error( format( 'invalid arguments. New name must be different than the old name. Value: `%s`.', oldName ) ); + } + if ( hasOwnProp( this._workspaces, newName ) ) { + throw new TypeError( format( 'invalid argument. Workspace name already exists. Value: `%s`.', newName ) ); + } + if ( oldName === this._currentWorkspace ) { + if ( oldName === 'base' ) { + this._workspaces[ 'base' ].length = 0; + debug( 'Created \'%s\' workspace and cleared \'base\' workspace. Current workspace: \'%s\'.', newName, newName ); + } else { + delete this._workspaces[ oldName ]; + debug( 'Renamed \'%s\' workspace to \'%s\'. Current workspace: \'%s\'.', oldName, newName, newName ); + } + this._workspaces[ newName ] = []; // "registers" the workspace + this._currentWorkspace = newName; // bookkeeping + return; + } + if ( oldName === 'base' ) { + this._workspaces[ newName ] = this._workspaces[ 'base' ].slice(); + this._workspaces[ 'base' ].length = 0; + debug( 'Created \'%s\' workspace and cleared \'base\' workspace.', newName ); + return; + } + this._workspaces[ newName ] = this._workspaces[ oldName ]; + delete this._workspaces[ oldName ]; + debug( 'Renamed \'%s\' workspace to \'%s\'.', oldName, newName ); +}); + +/** +* Deletes a workspace. +* +* @name deleteWorkspace +* @memberof REPL.prototype +* @type {Function} +* @param {string} name - workspace name +* @throws {TypeError} must provide a recognized workspace name other than 'base' +* @returns {void} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Delete workspace: +* repl.deleteWorkspace( 'yourWorkspace' ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'deleteWorkspace', function deleteWorkspace( name ) { + if ( !isString( name ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); + } + if ( !hasOwnProp( this._workspaces, name ) ) { + throw new TypeError( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); + } + if ( name === 'base' ) { + throw new TypeError( 'invalid operation. Cannot delete the `base` workspace.' ); + } + if ( name === this._currentWorkspace ) { + this.switchWorkspace( 'base' ); + } + delete this._workspaces[ name ]; +}); + +/** +* Deletes user-defined variables in a specified workspace. +* +* @name clearWorkspace +* @memberof REPL.prototype +* @type {Function} +* @param {string} name - workspace name +* @param {Options} [options] - function options +* @param {(RegExp|ArrayLikeObject)} [options.include] - name inclusion filter +* @param {(RegExp|ArrayLikeObject)} [options.exclude] - name exclusion filter +* @throws {TypeError} must provide a recognized workspace name +* @throws {TypeError} must provide a valid options object +* @returns {number} number of deleted variables +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Clear user workspace: +* var d = repl.clearWorkspace( 'myWorkspace' ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'clearWorkspace', function clearWorkspace( name, options ) { + var isArrInc; + var isArrExc; + var list; + var desc; + var tmp; + var i; + var d; // FIXME: Idt this variable is used correctly + + if ( !isString( name ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); + } + if ( arguments.length > 1 ) { + if ( !isPlainObject( options ) ) { + throw new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) ); + } + } else { + options = {}; + } + if ( hasOwnProp( options, 'include' ) ) { + isArrInc = isArrayLike( options.include ); + if ( isArrInc === false && !isRegExp( options.include ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'include', options.include ) ); + } + } + if ( hasOwnProp( options, 'exclude' ) ) { + isArrExc = isArrayLike( options.exclude ); + if ( isArrExc === false && !isRegExp( options.exclude ) ) { + throw new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'exclude', options.include ) ); + } + } + if ( name === this._currentWorkspace ) { + // Get the current variable list: + tmp = this.varsWorkspace( name, {} ); + if ( tmp.length === 0 ) { + // No user-defined variables to delete... + return; + } + // Cache the variable names and their respective property descriptors: + list = []; + for ( i = 0; i < tmp.length; i++ ) { + list.push( tmp[ i ], propertyDescriptor( this._context, tmp[i] ) ); + } + d = list.length / 2; + + // Filter the list of variables: + list = filter( list, options.include, isArrInc, options.exclude, isArrExc ); // eslint-disable-line max-len + + // Reset the REPL evaluation context (Why? Because we cannot simply delete variables as seen within the REPL environment. E.g., variables declared with `var` in the global scope are non-configurable, and, thus, cannot be deleted (see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/delete). While we can delete a property/variable from the REPL context object here, this deletion does not get propagated to within the REPL environment; i.e., a user can still access the deleted property as a variable within the REPL environment. Hence, we need to adopt a cache, reset, and reassign approach, as done here.): + this.resetContext(); // Note: in sandboxed environments, we assume a fresh context object is created! + + // Reassign the variables which were not deleted: + for ( i = 0; i < list.length; i += 2 ) { + desc = list[ i+1 ]; + if ( desc.configurable || this._sandbox ) { + // If configurable, in non-sandboxed environments, we simply overwrite the existing descriptor; in sandboxed environments, we always need to redefine the variable with the appropriate property descriptor; if non-configurable, in non-sandboxed environments, we do not need to reassign/redefine, as the variable could not be deleted from the context object and thus already exists and cannot be reconfigured: + defineProperty( this._context, list[ i ], desc ); + } + } + d -= list.length / 2; + return d; + } + if ( !hasOwnProp( this._workspaces, name ) ) { + throw new TypeError( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); + } + list = this._workspaces[ name ]; + + // Case: clear all user-defined variables... + if ( options.include === void 0 && options.exclude === void 0 ) { + list.length = 0; + return d; + } + // Case: include/exclude filters: + list = filter( list, options.include, isArrInc, options.exclude, isArrExc ); + d -= list.length / 2; + return d; }); /** -* Clears user-defined documentation. +* Clears a REPL's history. * -* @name clearUserDocs +* @name clearHistory * @memberof REPL.prototype * @type {Function} * @returns {REPL} REPL instance @@ -504,17 +1154,17 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory( * * // ... * -* // Clear the user defined documentation: -* repl.clearUserDocs(); +* // Clear the REPL history: +* repl.clearHistory(); * * // ... * * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'clearUserDocs', function clearUserDocs() { - debug( 'Resetting REPL user-defined documentation...' ); - this._userdocs.length = 0; +setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory() { + debug( 'Resetting REPL history...' ); + this._history.length = 0; return this; }); diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/tokenizer.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/tokenizer.js index 5a4ff1c8807a..3d5b5a68ea84 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/tokenizer.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/tokenizer.js @@ -48,343 +48,355 @@ var RE_PUNCTUATION = /(\{|\}|\[|\]|\(|\)|,|;|:|\.|\?|\?\.|=>|\.\.\.|`|\${)/; // MAIN // /** -* Tokenizes the input line based on ECMAScript specification. +* Returns a callback for tokenization. * * @private * @name tokenizer * @type {Function} -* @param {string} line - input line * @param {Object} context - REPL context -* @returns {Array} array of tokens +* @returns {Function} tokenizer callback */ -function tokenizer( line, context ) { - var declarations; - var VISITORS; - var tokens = []; - var ast; - var i; - - // Parse the given line into tokens & comments... - try { - ast = parse( line, { - 'ecmaVersion': 'latest', - 'onToken': onToken, - 'onComment': onComment - }); - } catch ( error ) { // eslint-disable-line no-unused-vars - return tokens; - } - - // Resolve variable declarations from the given line as tokens... - declarations = resolveLocalScopes( ast ); - for ( i = 0; i < declarations.length; i++ ) { - // If declaration cannot be resolved as an identifier, push it as a `name` token: - if ( !resolveIdentifier( declarations[ i ] ) ) { - tokens.push({ - 'value': declarations[ i ].name, - 'type': 'name', - 'start': declarations[ i ].start, - 'end': declarations[ i ].end - }); - } - } - - // Resolve identifiers from the given line as tokens... - VISITORS = { - 'Identifier': resolveIdentifier, - 'MemberExpression': resolveMemberExpression - }; - walk.simple( ast, VISITORS ); - - return tokens; +function tokenizer( context ) { + return tokenize; /** - * Callback invoked upon encountering a `Token` when parsing. + * Tokenizes the input line based on ECMAScript specification. * * @private - * @param {Object} token - token object + * @name tokenize + * @type {Function} + * @param {string} line - input line + * @returns {Array} array of tokens */ - function onToken( token ) { - // Ignore placeholders & EOF tokens: - if ( token.start >= token.end ) { - return; - } - if ( token.type.isLoop || isControlKeyword( token.type.keyword ) || ( token.type.label === 'name' && isUnrecognizedControlKeyword( token.value ) ) ) { - // Control flow keywords - `for`, `while`, `do`, `if`, `else` etc: - token.type = 'control'; - tokens.push( token ); - return; - } - if ( isSpecialIdentifier( token.type.keyword ) ) { - // Special identifiers - `this`, `super`: - token.type = 'specialIdentifier'; - tokens.push( token ); - return; - } - if ( isReservedLiteral( token.type.keyword ) ) { - // Built-in literals - `true`, `false`, `null`, `undefined`: - token.type = 'literal'; - tokens.push( token ); - return; - } - if ( token.type.keyword || ( token.type.label === 'name' && isUnrecognizedKeyword( token.value ) ) ) { - // Keywords - `function`, `import`, `var`, `const`, `let` etc.: - token.type = 'keyword'; - tokens.push( token ); - return; - } - if ( isStringTokenType( token.type.label ) ) { - // Strings and template string literals: - token.type = 'string'; - tokens.push( token ); - return; - } - if ( token.type.label === 'regexp' ) { - // Regex expressions: - token.type = 'regexp'; - tokens.push( token ); - return; - } - if ( token.type.label === 'num' ) { - // Numeric literals: - token.type = 'number'; - tokens.push( token ); - return; - } - if ( token.type.binop || token.type.prefix || token.type.postfix || token.type.isAssign ) { // eslint-disable-line max-len - // Operator symbols - `+`, `=`, `++` etc: - token.type = 'operator'; - tokens.push( token ); - return; - } - if ( RE_PUNCTUATION.test( token.type.label ) ) { - // Punctuation symbols - `,`, `(`, `;` etc: - token.value = token.type.label; - token.type = 'punctuation'; - tokens.push( token ); + function tokenize( line ) { + var declarations; + var VISITORS; + var tokens = []; + var ast; + var i; + + // Parse the given line into tokens & comments... + try { + ast = parse( line, { + 'ecmaVersion': 'latest', + 'onToken': onToken, + 'onComment': onComment + }); + } catch ( error ) { // eslint-disable-line no-unused-vars + return tokens; } - } - /** - * Callback invoked upon encountering a `Comment` when parsing. - * - * @private - * @param {boolean} block - boolean indicating whether a comment is a block comment - * @param {string} text - comment value - * @param {number} start - start index - * @param {number} end - end index - */ - function onComment( block, text, start, end ) { - if ( block ) { - // TODO: add support for highlighting multi-line comments. - return; + // Resolve variable declarations from the given line as tokens... + declarations = resolveLocalScopes( ast ); + for ( i = 0; i < declarations.length; i++ ) { + // If declaration cannot be resolved as an identifier, push it as a `name` token: + if ( !resolveIdentifier( declarations[ i ] ) ) { + tokens.push({ + 'value': declarations[ i ].name, + 'type': 'name', + 'start': declarations[ i ].start, + 'end': declarations[ i ].end + }); + } } - tokens.push({ - 'type': 'comment', - 'start': start, - 'end': end - }); - } - /** - * Resolves an `Identifier` node. - * - * @private - * @param {Object} node - AST node - * @returns {boolean} boolean indicating whether the `Identifier` was resolved - */ - function resolveIdentifier( node ) { - var identifier; + // Resolve identifiers from the given line as tokens... + VISITORS = { + 'Identifier': resolveIdentifier, + 'MemberExpression': resolveMemberExpression + }; + walk.simple( ast, VISITORS ); - // Ignore placeholder nodes: - if ( node.start >= node.end ) { - return true; - } - // Ignore node if it is an unrecognized `keyword`: - if ( isUnrecognizedKeyword( node.name ) || isUnrecognizedControlKeyword( node.name ) ) { // eslint-disable-line max-len - return true; - } - // If node is an unrecognized `literal`, push it as a token: - if ( isUnrecognizedReservedLiteral( node.name ) ) { - tokens.push({ - 'value': node.name, - 'type': 'literal', - 'start': node.start, - 'end': node.end - }); - return true; + return tokens; + + /** + * Callback invoked upon encountering a `Token` when parsing. + * + * @private + * @param {Object} token - token object + */ + function onToken( token ) { + // Ignore placeholders & EOF tokens: + if ( token.start >= token.end ) { + return; + } + if ( token.type.isLoop || isControlKeyword( token.type.keyword ) || ( token.type.label === 'name' && isUnrecognizedControlKeyword( token.value ) ) ) { + // Control flow keywords - `for`, `while`, `do`, `if`, `else` etc: + token.type = 'control'; + tokens.push( token ); + return; + } + if ( isSpecialIdentifier( token.type.keyword ) ) { + // Special identifiers - `this`, `super`: + token.type = 'specialIdentifier'; + tokens.push( token ); + return; + } + if ( isReservedLiteral( token.type.keyword ) ) { + // Built-in literals - `true`, `false`, `null`, `undefined`: + token.type = 'literal'; + tokens.push( token ); + return; + } + if ( token.type.keyword || ( token.type.label === 'name' && isUnrecognizedKeyword( token.value ) ) ) { + // Keywords - `function`, `import`, `var`, `const`, `let` etc.: + token.type = 'keyword'; + tokens.push( token ); + return; + } + if ( isStringTokenType( token.type.label ) ) { + // Strings and template string literals: + token.type = 'string'; + tokens.push( token ); + return; + } + if ( token.type.label === 'regexp' ) { + // Regex expressions: + token.type = 'regexp'; + tokens.push( token ); + return; + } + if ( token.type.label === 'num' ) { + // Numeric literals: + token.type = 'number'; + tokens.push( token ); + return; + } + if ( token.type.binop || token.type.prefix || token.type.postfix || token.type.isAssign ) { // eslint-disable-line max-len + // Operator symbols - `+`, `=`, `++` etc: + token.type = 'operator'; + tokens.push( token ); + return; + } + if ( RE_PUNCTUATION.test( token.type.label ) ) { + // Punctuation symbols - `,`, `(`, `;` etc: + token.value = token.type.label; + token.type = 'punctuation'; + tokens.push( token ); + } } - // If identifier is defined in the local scope, assume and treat it like a `variable` and push it as a token... - if ( contains( resolveLocalScope( ast, node ), node.name ) ) { + + /** + * Callback invoked upon encountering a `Comment` when parsing. + * + * @private + * @param {boolean} block - boolean indicating whether a comment is a block comment + * @param {string} text - comment value + * @param {number} start - start index + * @param {number} end - end index + */ + function onComment( block, text, start, end ) { + if ( block ) { + // TODO: add support for highlighting multi-line comments. + return; + } tokens.push({ - 'value': node.name, - 'type': 'variable', - 'start': node.start, - 'end': node.end + 'type': 'comment', + 'start': start, + 'end': end }); - return true; } - // If identifier is in global context, push it as a token... - identifier = context[ node.name ]; - if ( identifier ) { - if ( isLiteralType( typeof identifier ) ) { + + /** + * Resolves an `Identifier` node. + * + * @private + * @param {Object} node - AST node + * @returns {boolean} boolean indicating whether the `Identifier` was resolved + */ + function resolveIdentifier( node ) { + var identifier; + + // Ignore placeholder nodes: + if ( node.start >= node.end ) { + return true; + } + // Ignore node if it is an unrecognized `keyword`: + if ( isUnrecognizedKeyword( node.name ) || isUnrecognizedControlKeyword( node.name ) ) { // eslint-disable-line max-len + return true; + } + // If node is an unrecognized `literal`, push it as a token: + if ( isUnrecognizedReservedLiteral( node.name ) ) { tokens.push({ 'value': node.name, - 'type': 'variable', + 'type': 'literal', 'start': node.start, 'end': node.end }); - } else { + return true; + } + // If identifier is defined in the local scope, assume and treat it like a `variable` and push it as a token... + if ( contains( resolveLocalScope( ast, node ), node.name ) ) { tokens.push({ 'value': node.name, - 'type': typeof identifier, + 'type': 'variable', 'start': node.start, 'end': node.end }); + return true; } - return true; + // If identifier is in global context, push it as a token... + identifier = context[ node.name ]; + if ( identifier ) { + if ( isLiteralType( typeof identifier ) ) { + tokens.push({ + 'value': node.name, + 'type': 'variable', + 'start': node.start, + 'end': node.end + }); + } else { + tokens.push({ + 'value': node.name, + 'type': typeof identifier, + 'start': node.start, + 'end': node.end + }); + } + return true; + } + return false; } - return false; - } - /** - * Resolves a `MemberExpression` node. - * - * @private - * @param {Object} node - AST node - * @param {boolean} compute - boolean indicating whether to compute the `MemberExpression` - * @returns {(void|*)} computed value of the `MemberExpression` if compute is true - */ - function resolveMemberExpression( node, compute ) { - var properties = linkedList(); - var property; - var computed; - var locals; - var obj; + /** + * Resolves a `MemberExpression` node. + * + * @private + * @param {Object} node - AST node + * @param {boolean} compute - boolean indicating whether to compute the `MemberExpression` + * @returns {(void|*)} computed value of the `MemberExpression` if compute is true + */ + function resolveMemberExpression( node, compute ) { + var properties = linkedList(); + var property; + var computed; + var locals; + var obj; - // Ignore placeholder nodes: - if ( node.start >= node.end ) { - return; - } + // Ignore placeholder nodes: + if ( node.start >= node.end ) { + return; + } - // Resolve members of the `MemberExpression`: - resolveMembers( node ); + // Resolve members of the `MemberExpression`: + resolveMembers( node ); - // Check if the object identifier is valid... - property = properties.first(); - if ( !property ) { - return; - } - // Ignore if the object identifier is a reserved name: - if ( isReservedName( property.value.name ) ) { - return; - } - // If object identifier exists in the local scope, don't resolve from global scope... - locals = resolveLocalScope( ast, property.value ); - if ( contains( locals, property.value.name ) ) { - return; - } - // Enter object's namespace: - obj = context; - properties = properties.iterator(); - obj = obj[ properties.next().value.name ]; - if ( !obj ) { - // Object not defined in context: - return; - } - // Fetch properties from context: - property = properties.next(); - while ( !property.done ) { - // Ignore placeholder nodes: - if ( property.value.start >= property.value.end ) { + // Check if the object identifier is valid... + property = properties.first(); + if ( !property ) { + return; + } + // Ignore if the object identifier is a reserved name: + if ( isReservedName( property.value.name ) ) { + return; + } + // If object identifier exists in the local scope, don't resolve from global scope... + locals = resolveLocalScope( ast, property.value ); + if ( contains( locals, property.value.name ) ) { + return; + } + // Enter object's namespace: + obj = context; + properties = properties.iterator(); + obj = obj[ properties.next().value.name ]; + if ( !obj ) { + // Object not defined in context: return; } - // Case: 'bar' in `foo['bar']` - property already pushed as a string token. Ignore... - if ( property.value.type === 'Literal' ) { - try { - if ( !hasProp( obj, property.value.value ) ) { - // Property not found in context: + // Fetch properties from context: + property = properties.next(); + while ( !property.done ) { + // Ignore placeholder nodes: + if ( property.value.start >= property.value.end ) { + return; + } + // Case: 'bar' in `foo['bar']` - property already pushed as a string token. Ignore... + if ( property.value.type === 'Literal' ) { + try { + if ( !hasProp( obj, property.value.value ) ) { + // Property not found in context: + break; + } + obj = obj[ property.value.value ]; + } catch ( error ) { // eslint-disable-line no-unused-vars break; } - obj = obj[ property.value.value ]; - } catch ( error ) { // eslint-disable-line no-unused-vars - break; + property = properties.next(); + continue; } - property = properties.next(); - continue; - } - // Case: `foo.bar` - resolve property and push it as a token... - if ( property.value.type === 'Identifier' ) { - try { - if ( !hasProp( obj, property.value.name ) ) { - // Property not found in context: + // Case: `foo.bar` - resolve property and push it as a token... + if ( property.value.type === 'Identifier' ) { + try { + if ( !hasProp( obj, property.value.name ) ) { + // Property not found in context: + break; + } + obj = obj[ property.value.name ]; + } catch ( error ) { // eslint-disable-line no-unused-vars break; } - obj = obj[ property.value.name ]; - } catch ( error ) { // eslint-disable-line no-unused-vars - break; - } - if ( !compute ) { - // Push token if property exists in context: - if ( isLiteralType( typeof obj ) ) { - tokens.push({ - 'value': property.value.name, - 'type': 'variable', - 'start': property.value.start, - 'end': property.value.end - }); - } else { - tokens.push({ - 'value': property.value.name, - 'type': typeof obj, - 'start': property.value.start, - 'end': property.value.end - }); + if ( !compute ) { + // Push token if property exists in context: + if ( isLiteralType( typeof obj ) ) { + tokens.push({ + 'value': property.value.name, + 'type': 'variable', + 'start': property.value.start, + 'end': property.value.end + }); + } else { + tokens.push({ + 'value': property.value.name, + 'type': typeof obj, + 'start': property.value.start, + 'end': property.value.end + }); + } } + property = properties.next(); + continue; } - property = properties.next(); - continue; - } - // Case: `foo[a.b].bar` - recursively compute the internal `MemberExpression`... - if ( property.value.type === 'MemberExpression' ) { - computed = resolveMemberExpression( property.value, true ); - if ( !isLiteralType( typeof computed ) ) { - // Couldn't compute the internal `MemberExpression` into a definite name: - break; - } - try { - if ( !hasProp( obj, computed ) ) { - // Property not found in context: + // Case: `foo[a.b].bar` - recursively compute the internal `MemberExpression`... + if ( property.value.type === 'MemberExpression' ) { + computed = resolveMemberExpression( property.value, true ); + if ( !isLiteralType( typeof computed ) ) { + // Couldn't compute the internal `MemberExpression` into a definite name: + break; + } + try { + if ( !hasProp( obj, computed ) ) { + // Property not found in context: + break; + } + obj = obj[ computed ]; + } catch ( error ) { // eslint-disable-line no-unused-vars break; } - obj = obj[ computed ]; - } catch ( error ) { // eslint-disable-line no-unused-vars - break; + property = properties.next(); + continue; } - property = properties.next(); - continue; + break; + } + if ( compute ) { + return obj; } - break; - } - if ( compute ) { - return obj; - } - /** - * Resolves members of the `MemberExpression` node. - * - * @private - * @param {Object} node - node to be traversed - */ - function resolveMembers( node ) { - if ( node.object.type === 'Identifier' ) { - // Reached a resolvable MemberExpression (a.b in a.b.c.d), save property(b) & object(a) and exit: - properties.unshift( node.property ); - properties.unshift( node.object ); - } else if ( node.object.type === 'MemberExpression' ) { - // Found node with another MemberExpression as object, save property and traverse it: - properties.unshift( node.property ); - resolveMembers( node.object ); + /** + * Resolves members of the `MemberExpression` node. + * + * @private + * @param {Object} node - node to be traversed + */ + function resolveMembers( node ) { + if ( node.object.type === 'Identifier' ) { + // Reached a resolvable MemberExpression (a.b in a.b.c.d), save property(b) & object(a) and exit: + properties.unshift( node.property ); + properties.unshift( node.object ); + } else if ( node.object.type === 'MemberExpression' ) { + // Found node with another MemberExpression as object, save property and traverse it: + properties.unshift( node.property ); + resolveMembers( node.object ); + } } } } diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js index a62e4c09bd5f..eb2322769182 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/validate.js @@ -22,7 +22,6 @@ var isPlainObject = require( '@stdlib/assert/is-plain-object' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var isReadableStreamLike = require( '@stdlib/assert/is-node-readable-stream-like' ); var isWritableStreamLike = require( '@stdlib/assert/is-node-writable-stream-like' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; @@ -38,7 +37,6 @@ var format = require( '@stdlib/string/format' ); * @private * @param {Object} opts - destination object * @param {Options} options - function options -* @param {ReadableStream} [options.input] - input stream * @param {WritableStream} [options.output] - output stream * @param {WritableStream} [options.error] - error stream * @param {boolean} [options.sandbox] - boolean indicating whether to run a REPL in a sandboxed context @@ -62,12 +60,6 @@ function validate( opts, options ) { if ( !isPlainObject( options ) ) { return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) ); } - if ( hasOwnProp( options, 'input' ) ) { - opts.input = options.input; - if ( !isReadableStreamLike( options.input ) ) { - return new TypeError( format( 'invalid option. `%s` option must be a readable stream. Option: `%s`.', 'input', options.input ) ); - } - } if ( hasOwnProp( options, 'output' ) ) { opts.output = options.output; if ( !isWritableStreamLike( options.output ) ) { diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js b/lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js index 144caac56065..441172a6c060 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/clear_vars.js @@ -16,8 +16,6 @@ * limitations under the License. */ -/* eslint-disable no-underscore-dangle */ - 'use strict'; // MAIN // @@ -47,7 +45,7 @@ function command( repl ) { } else { opts = {}; } - repl._context.clearWorkspace( repl._currentWorkspace, opts ); + repl.clearWorkspace( repl.currentWorkspace, opts ); } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js index c3187313bf80..20ae1fd4b8c3 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/clear_workspace.js @@ -25,13 +25,7 @@ var logger = require( 'debug' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isPlainObject = require( '@stdlib/assert/is-plain-object' ); -var isArrayLike = require( '@stdlib/assert/is-array-like-object' ); -var isRegExp = require( '@stdlib/assert/is-regexp' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var propertyDescriptor = require( '@stdlib/utils/property-descriptor' ); -var defineProperty = require( '@stdlib/utils/define-property' ); var format = require( '@stdlib/string/format' ); -var contains = require( './../contains.js' ); var log = require( './../log.js' ); @@ -40,71 +34,6 @@ var log = require( './../log.js' ); var debug = logger( 'repl:command:clear_workspace' ); -// FUNCTIONS // - -/** -* Filters a variable list based on include and exclude filters. -* -* @private -* @param {Array} list - variable list to filter -* @param {(RegExp|ArrayLikeObject|void)} include - name inclusion filter -* @param {boolean} isArrInc - boolean indicating whether the inclusion filter is an array -* @param {(RegExp|ArrayLikeObject|void)} exclude - name exclusion filter -* @param {boolean} isArrExc - boolean indicating whether the exclusion filter is an array -* @returns {Array} input list -*/ -function filter( list, include, isArrInc, exclude, isArrExc ) { - var FLG; - var v; - var i; - var j; - - // Perform list "compression" without using temporary data structures... - j = 0; - for ( i = 0; i < list.length; i += 2 ) { - // Note: we can only delete "configurable" variables... - if ( list[ i+1 ].configurable === false ) { - // Variable is non-configurable and, hence, cannot be deleted... - continue; - } - v = list[ i ]; - FLG = false; - - // Note: exclude/include order matters!!! - if ( exclude ) { - if ( isArrExc ) { - if ( contains( exclude, v ) ) { - // The variable is in the explicit exclude list: - FLG = true; - } - } else if ( exclude.test( v ) ) { - // The variable passes the exclusion test: - FLG = true; - } - } - // Only apply inclusion filters if the variable has not been already excluded from deletion... - if ( FLG === false && include ) { - if ( isArrInc ) { - if ( !contains( include, v ) ) { - // The variable is *not* in the include list: - FLG = true; - } - } else if ( !include.test( v ) ) { - // The variable does *not* pass the include test: - FLG = true; - } - } - if ( FLG ) { - list[ j ] = list[ i ]; - list[ j+1 ] = list[ i+1 ]; - j += 2; - } - } - list.length = j; - return list; -} - - // MAIN // /** @@ -128,26 +57,20 @@ function command( repl ) { * @returns {void} */ function onCommand( name, options ) { - var isArrInc; - var isArrExc; var opts; - var list; - var desc; var err; - var tmp; var n; var d; - var i; if ( arguments.length === 0 ) { - n = repl._currentWorkspace; + n = repl.currentWorkspace; opts = {}; } else if ( arguments.length === 1 ) { if ( isString( name ) ) { n = name; opts = {}; } else if ( isPlainObject( name ) ) { - n = repl._currentWorkspace; + n = repl.currentWorkspace; opts = name; } else { err = new TypeError( format( 'invalid argument. Must provide either an options object or a workspace name. Value: `%s`.', name ) ); @@ -156,94 +79,17 @@ function command( repl ) { return; } } else { - if ( !isString( name ) ) { - err = new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } n = name; - if ( !isPlainObject( options ) ) { - err = new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', name ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } opts = options; } - if ( hasOwnProp( opts, 'include' ) ) { - isArrInc = isArrayLike( opts.include ); - if ( isArrInc === false && !isRegExp( opts.include ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'include', opts.include ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - } - if ( hasOwnProp( opts, 'exclude' ) ) { - isArrExc = isArrayLike( opts.exclude ); - if ( isArrExc === false && !isRegExp( opts.exclude ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'exclude', opts.include ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - } - if ( n === repl._currentWorkspace ) { - // Get the current variable list: - tmp = repl._context.varsWorkspace( n, {} ); - if ( tmp.length === 0 ) { - // No user-defined variables to delete... - log( repl, 'No user-defined variables to delete.' ); - debug( 'No user-defined variables to delete.' ); - return; - } - // Cache the variable names and their respective property descriptors: - list = []; - for ( i = 0; i < tmp.length; i++ ) { - list.push( tmp[ i ], propertyDescriptor( repl._context, tmp[i] ) ); // eslint-disable-line max-len - } - d = list.length / 2; - - // Filter the list of variables: - list = filter( list, opts.include, isArrInc, opts.exclude, isArrExc ); // eslint-disable-line max-len - - // Reset the REPL evaluation context (Why? Because we cannot simply delete variables as seen within the REPL environment. E.g., variables declared with `var` in the global scope are non-configurable, and, thus, cannot be deleted (see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/delete). While we can delete a property/variable from the REPL context object here, this deletion does not get propagated to within the REPL environment; i.e., a user can still access the deleted property as a variable within the REPL environment. Hence, we need to adopt a cache, reset, and reassign approach, as done here.): - repl.resetContext(); // Note: in sandboxed environments, we assume a fresh context object is created! - - // Reassign the variables which were not deleted: - for ( i = 0; i < list.length; i += 2 ) { - desc = list[ i+1 ]; - if ( desc.configurable || repl._sandbox ) { - // If configurable, in non-sandboxed environments, we simply overwrite the existing descriptor; in sandboxed environments, we always need to redefine the variable with the appropriate property descriptor; if non-configurable, in non-sandboxed environments, we do not need to reassign/redefine, as the variable could not be deleted from the context object and thus already exists and cannot be reconfigured: - defineProperty( repl._context, list[ i ], desc ); - } - } - d -= list.length / 2; + try { + d = repl.clearWorkspace( n, opts ); log( repl, 'Deleted '+d+' variable(s).' ); debug( 'Deleted %d variable(s).', d ); - return; - } - if ( !hasOwnProp( repl._workspaces, n ) ) { - err = new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', n ) ); + } catch ( err ) { debug( 'Error: %s', err.message ); repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - list = repl._workspaces[ n ]; - - // Case: clear all user-defined variables... - if ( opts.include === void 0 && opts.exclude === void 0 ) { - list.length = 0; - log( repl, 'Deleted '+d+' variable(s).' ); - debug( 'Deleted %d variable(s).', d ); - return; } - // Case: include/exclude filters: - list = filter( list, opts.include, isArrInc, opts.exclude, isArrExc ); - d -= list.length / 2; - log( repl, 'Deleted '+d+' variable(s).' ); - debug( 'Deleted %d variable(s).', d ); } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js index c10c16800875..92bf636bf4e2 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/current_workspace.js @@ -16,8 +16,6 @@ * limitations under the License. */ -/* eslint-disable no-underscore-dangle */ - 'use strict'; // MAIN // @@ -39,7 +37,7 @@ function command( repl ) { * @returns {string} result */ function onCommand() { - return repl._currentWorkspace; + return repl.currentWorkspace; } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js index 279a852c0d7f..dbb1cdc03719 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/delete_workspace.js @@ -23,9 +23,6 @@ // MODULES // var logger = require( 'debug' ); -var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var format = require( '@stdlib/string/format' ); var log = require( './../log.js' ); @@ -54,37 +51,20 @@ function command( repl ) { * @returns {void} */ function onCommand( name ) { - var err; var ws; if ( arguments.length ) { - if ( !isString( name ) ) { - err = new TypeError( format( 'invalid argument. Must provide a string. Value: `%s`.', name ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( !hasOwnProp( repl._workspaces, name ) ) { - err = new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } ws = name; } else { - ws = repl._currentWorkspace; + ws = repl.currentWorkspace; } - if ( ws === 'base' ) { - err = new Error( 'invalid operation. Cannot delete the `base` workspace.' ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; + try { + repl.deleteWorkspace( ws ); + log( repl, 'Deleted \''+ws+'\' workspace.' ); + debug( 'Deleted \'%s\' workspace.', ws ); + } catch ( error ) { + debug( 'Error: %s', error.message ); + repl._ostream.write( 'Error: '+error.message+'\n' ); } - if ( ws === repl._currentWorkspace ) { - repl._context.workspace( 'base' ); - } - delete repl._workspaces[ ws ]; - log( repl, 'Deleted \''+ws+'\' workspace.' ); - debug( 'Deleted \'%s\' workspace.', ws ); } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/evalin.js b/lib/node_modules/@stdlib/repl/lib/commands/evalin.js index 2f17af820bad..9e249e2a52a5 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/evalin.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/evalin.js @@ -25,7 +25,6 @@ var vm = require( 'vm' ); var logger = require( 'debug' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var format = require( '@stdlib/string/format' ); var updateRegExpCache = require( './../update_regexp_cache.js' ); var restoreRegExpMatches = require( './../restore_regexp_matches.js' ); @@ -75,26 +74,26 @@ function command( repl ) { repl._ostream.write( 'Error: '+err.message+'\n' ); return; } - if ( !hasOwnProp( repl._workspaces, workspace ) ) { - err = new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', workspace ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } if ( RE_WHITESPACE.test( expression ) ) { debug( 'Expression only consists of whitespace. Nothing to evaluate.' ); return; } // Cache the name of the current workspace: - ws = repl._currentWorkspace; + ws = repl.currentWorkspace; // Temporarily silence logging: FLG = repl._quiet; repl._quiet = true; - // Switch to the target workspace: - repl._context.workspace( workspace ); - + try { + // Switch to the target workspace: + repl.switchWorkspace( workspace ); + } catch ( error ) { + debug( 'Error: %s', error.message ); + repl._ostream.write( 'Error: '+error.message+'\n' ); + repl._quiet = FLG; + return; + } // Try evaluating the expression... opts = { 'filename': '', @@ -106,7 +105,7 @@ function command( repl ) { } catch ( error ) { debug( 'Error: %s', error.message ); repl._ostream.write( 'Error: '+error.message+'\n' ); - repl._context.workspace( ws ); + repl.switchWorkspace( ws ); repl._quiet = FLG; return; } @@ -130,7 +129,7 @@ function command( repl ) { updateRegExpCache( repl._regexp ); // Return to the previous workspace: - repl._context.workspace( ws ); + repl.switchWorkspace( ws ); // Re-enable logging (if enabled): repl._quiet = FLG; diff --git a/lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js index b24993ea323b..57158e924245 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/is_workspace.js @@ -25,8 +25,7 @@ var logger = require( 'debug' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isRegExp = require( '@stdlib/assert/is-regexp' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var objectKeys = require( '@stdlib/utils/keys' ); +var contains = require( '@stdlib/array/base/assert/contains' ); var format = require( '@stdlib/string/format' ); @@ -55,8 +54,8 @@ function command( repl ) { * @returns {(boolean|void)} boolean indicating whether a workspace exists */ function onCommand( name ) { + var workspaces; var isStr; - var keys; var err; var i; @@ -67,12 +66,12 @@ function command( repl ) { repl._ostream.write( 'Error: '+err.message+'\n' ); return; } + workspaces = repl.workspaces(); if ( isStr ) { - return hasOwnProp( repl._workspaces, name ); + return contains( workspaces, name ); } - keys = objectKeys( repl._workspaces ); - for ( i = 0; i < keys.length; i++ ) { - if ( name.test( keys[ i ] ) ) { + for ( i = 0; i < workspaces.length; i++ ) { + if ( name.test( workspaces[ i ] ) ) { return true; } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js index d47965d7df48..acea75630997 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/load_workspace.js @@ -23,15 +23,8 @@ // MODULES // var logger = require( 'debug' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; -var isPlainObject = require( '@stdlib/assert/is-plain-object' ); -var isArrayLike = require( '@stdlib/assert/is-array-like-object' ); -var isRegExp = require( '@stdlib/assert/is-regexp' ); -var defineProperty = require( '@stdlib/utils/define-property' ); var format = require( '@stdlib/string/format' ); -var contains = require( './../contains.js' ); var log = require( './../log.js' ); @@ -64,102 +57,32 @@ function command( repl ) { * @returns {void} */ function onCommand( name, options ) { - var isArrInc; - var isArrExc; var opts; var err; var cnt; - var ws; - var v; - var i; if ( !isString( name ) ) { err = new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); debug( 'Error: %s', err.message ); repl._ostream.write( 'Error: '+err.message+'\n' ); return; } - opts = { - 'override': true - }; + opts = {}; if ( arguments.length > 1 ) { - if ( !isPlainObject( options ) ) { - err = new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', name ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( hasOwnProp( options, 'include' ) ) { - isArrInc = isArrayLike( options.include ); - if ( isArrInc === false && !isRegExp( options.include ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'include', options.include ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - opts.include = options.include; - } - if ( hasOwnProp( options, 'exclude' ) ) { - isArrExc = isArrayLike( options.exclude ); - if ( isArrExc === false && !isRegExp( options.exclude ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a regular expression or an array-like object. Option: `%s`.', 'exclude', options.exclude ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - opts.exclude = options.exclude; - } - if ( hasOwnProp( options, 'override' ) ) { - if ( !isBoolean( options.override ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'override', options.override ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - opts.override = options.override; - } + opts = options; } - if ( name === repl._currentWorkspace ) { + if ( name === repl.currentWorkspace ) { log( repl, 'Already in \''+name+'\' workspace.' ); debug( 'Already in \'%s\' workspace.', name ); return; } - if ( !hasOwnProp( repl._workspaces, name ) ) { - err = new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', name ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - ws = repl._workspaces[ name ]; - - // Note: the internal branches are not the most performant implementation, but the implementation is straightforward and presumably "good enough"... - cnt = 0; - for ( i = 0; i < ws.length; i += 2 ) { - v = ws[ i ]; - if ( opts.include ) { - if ( isArrInc && !contains( opts.include, v ) ) { - continue; - } - if ( !opts.include.test( v ) ) { - continue; - } - } - if ( opts.exclude ) { - if ( isArrExc && contains( opts.exclude, v ) ) { - continue; - } - if ( opts.exclude.test( v ) ) { - continue; - } - } - if ( hasOwnProp( repl._context, v ) && opts.override === false ) { - continue; - } - // If we've made it this far, the variable should have passed all filters... - cnt += 1; - defineProperty( repl._context, v, ws[ i+1] ); + try { + cnt = repl.loadWorkspace( name, opts ); + log( repl, cnt.toString()+' variable(s) loaded from \''+name+'\' workspace.' ); + debug( '%d variable(s) loaded from \'%s\' workspace.', cnt, name ); + } catch ( error ) { + debug( 'Error: %s', error.message ); + repl._ostream.write( 'Error: '+error.message+'\n' ); } - log( repl, cnt.toString()+' variable(s) loaded from \''+name+'\' workspace.' ); - debug( '%d variable(s) loaded from \'%s\' workspace.', cnt, name ); } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js b/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js index 949a23831efd..30e32e82cb24 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js @@ -27,6 +27,7 @@ var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; var isPlainObject = require( '@stdlib/assert/is-plain-object' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); +var contains = require( '@stdlib/array/base/assert/contains' ); var propertyDescriptor = require( '@stdlib/utils/property-descriptor' ); var properties = require( '@stdlib/utils/properties' ); var Presentation = require( '@stdlib/repl/presentation' ); // eslint-disable-line stdlib/no-redeclare @@ -135,14 +136,14 @@ function command( repl ) { ctx = repl._context; // Cache the current workspace name: - cs = repl._currentWorkspace; + cs = repl.currentWorkspace; // If the destination workspace already exists, we need to delete that workspace in order to allow presentation commands to be properly bound... - if ( ws !== 'base' && repl._context.isWorkspace( ws ) ) { + if ( ws !== 'base' && contains( repl.workspaces(), ws ) ) { debug( 'Deleting workspace: %s', ws ); FLG = repl._quiet; repl._quiet = true; // temporarily silence logging - repl._context.deleteWorkspace( ws ); + repl.deleteWorkspace( ws ); repl._quiet = FLG; } // Create a new presentation... diff --git a/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js b/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js index 3d2ce4937473..18e22032b1a1 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js @@ -74,7 +74,7 @@ function command( repl ) { } key = id; } else { - ws = repl._currentWorkspace; + ws = repl.currentWorkspace; keys = objectKeys( cache ); for ( i = 0; i < keys.length; i++ ) { if ( cache[ keys[ i ] ].w === ws ) { @@ -103,7 +103,7 @@ function command( repl ) { debug( 'Deleting workspace: %s', o.w ); FLG = repl._quiet; repl._quiet = true; // temporarily silence logging - repl._context.deleteWorkspace( o.w ); + repl.deleteWorkspace( o.w ); repl._quiet = FLG; } // Ensure that we no longer watch presentation files (if enabled): diff --git a/lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js index c1c699026127..37ecbc5a1ca2 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/rename_workspace.js @@ -24,7 +24,6 @@ var logger = require( 'debug' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var format = require( '@stdlib/string/format' ); var log = require( './../log.js' ); @@ -68,45 +67,26 @@ function command( repl ) { repl._ostream.write( 'Error: '+err.message+'\n' ); return; } - if ( !hasOwnProp( repl._workspaces, oldName ) ) { - err = new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', oldName ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( oldName === newName ) { - log( repl, 'Workspace is already named \''+newName+'\'.' ); - return; + try { + repl.renameWorkspace( oldName, newName ); + } catch ( error ) { + debug( 'Error: %s', error.message ); + repl._ostream.write( 'Error: '+error.message+'\n' ); } - if ( hasOwnProp( repl._workspaces, newName ) ) { - err = new Error( format( 'invalid argument. Workspace name already exists. Value: `%s`.', newName ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( oldName === repl._currentWorkspace ) { + if ( oldName === repl.currentWorkspace ) { if ( oldName === 'base' ) { - repl._workspaces[ 'base' ].length = 0; log( repl, 'Created \''+newName+'\' workspace and cleared \'base\' workspace. Current workspace: \''+newName+'\'.' ); debug( 'Created \'%s\' workspace and cleared \'base\' workspace. Current workspace: \'%s\'.', newName, newName ); } else { - delete repl._workspaces[ oldName ]; log( repl, 'Renamed \''+oldName+'\' workspace to \''+newName+'\'. Current workspace: \''+newName+'\'.' ); debug( 'Renamed \'%s\' workspace to \'%s\'. Current workspace: \'%s\'.', oldName, newName, newName ); } - repl._workspaces[ newName ] = []; // "registers" the workspace - repl._currentWorkspace = newName; // bookkeeping - return; } if ( oldName === 'base' ) { - repl._workspaces[ newName ] = repl._workspaces[ 'base' ].slice(); - repl._workspaces[ 'base' ].length = 0; log( repl, 'Created \''+newName+'\' workspace and cleared \'base\' workspace.' ); debug( 'Created \'%s\' workspace and cleared \'base\' workspace.', newName ); return; } - repl._workspaces[ newName ] = repl._workspaces[ oldName ]; - delete repl._workspaces[ oldName ]; log( repl, 'Renamed \''+oldName+'\' workspace to \''+newName+'\'.' ); debug( 'Renamed \'%s\' workspace to \'%s\'.', oldName, newName ); } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/vars.js b/lib/node_modules/@stdlib/repl/lib/commands/vars.js index c16437c1baa8..0e7cabc2105b 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/vars.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/vars.js @@ -16,8 +16,6 @@ * limitations under the License. */ -/* eslint-disable no-underscore-dangle */ - 'use strict'; // MAIN // @@ -50,7 +48,7 @@ function command( repl ) { } else { opts = {}; } - return repl._context.varsWorkspace( repl._currentWorkspace, opts ); + return repl.varsWorkspace( repl.currentWorkspace, opts ); } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js index f806033ca051..e6e516ae3c22 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/vars_workspace.js @@ -24,17 +24,8 @@ var logger = require( 'debug' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; var isPlainObject = require( '@stdlib/assert/is-plain-object' ); -var isArrayLike = require( '@stdlib/assert/is-array-like-object' ); -var isRegExp = require( '@stdlib/assert/is-regexp' ); -var isReadableProperty = require( '@stdlib/assert/is-readable-property' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var properties = require( '@stdlib/utils/properties' ); -var typeOf = require( '@stdlib/utils/type-of' ); var format = require( '@stdlib/string/format' ); -var setdiff = require( './../setdiff.js' ); -var propertyComparator = require( './../property_comparator.js' ); // VARIABLES // @@ -68,21 +59,13 @@ function command( repl ) { */ function onCommand( name, options ) { var opts; - var list; - var type; var err; - var tmp; - var out; - var FLG; - var v; var n; - var i; - var j; if ( arguments.length === 0 ) { - return setdiff( repl._workspace, properties( repl._context ).sort( propertyComparator ) ); // eslint-disable-line max-len - } - if ( arguments.length === 1 ) { + n = repl.currentWorkspace; + opts = {}; + } else if ( arguments.length === 1 ) { if ( isString( name ) ) { n = name; opts = {}; @@ -110,101 +93,12 @@ function command( repl ) { } opts = options; } - if ( hasOwnProp( opts, 'include' ) && !isRegExp( opts.include ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a regular expression. Option: `%s`.', 'include', opts.include ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( hasOwnProp( opts, 'exclude' ) && !isRegExp( opts.exclude ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a regular expression. Option: `%s`.', 'exclude', opts.include ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( hasOwnProp( opts, 'types' ) && !isArrayLike( opts.types ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be an array-like object. Option: `%s`.', 'types', opts.types ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( hasOwnProp( opts, 'details' ) && !isBoolean( opts.details ) ) { - err = new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'details', opts.details ) ); + try { + return repl.varsWorkspace( n, opts ); + } catch ( err ) { debug( 'Error: %s', err.message ); repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( n === void 0 || n === repl._currentWorkspace ) { - tmp = properties( repl._context ).sort( propertyComparator ); - tmp = setdiff( repl._workspace, tmp ); - list = []; - for ( i = 0; i < tmp.length; i++ ) { - if ( isReadableProperty( repl._context, tmp[ i ] ) ) { - list.push( tmp[ i ], repl._context[ tmp[ i ] ] ); - } else { - // The variable can be set, but not retrieved (i.e., is write-only), so value inspection is not possible without triggering an error... - list.push( tmp[ i ], void 0 ); - } - } - } else { - if ( !hasOwnProp( repl._workspaces, n ) ) { - err = new Error( format( 'invalid argument. Unrecognized workspace name. Value: `%s`.', n ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - list = repl._workspaces[ n ].slice(); - for ( i = 1; i < list.length; i += 2 ) { - if ( typeof list[ i ].get === 'function' ) { - // WARNING: the `this` context is not defined, as the variable is not actually bound to a global instance! - list[ i ] = list[ i ].get.call( null ); - } else if ( typeof list[ i ].set === 'function' ) { - // The variable can be set, but not retrieved (i.e., is write-only), so value inspection is not possible without triggering an error... - list[ i ] = void 0; - } else { - list[ i ] = list[ i ].value; - } - } - } - out = []; - for ( i = 0; i < list.length; i += 2 ) { - v = list[ i ]; - FLG = false; - type = ''; - if ( opts.include && !opts.include.test( v ) ) { - continue; - } - if ( opts.exclude && opts.exclude.test( v ) ) { - continue; - } - if ( opts.types ) { - type = typeOf( list[ i+1 ] ); - for ( j = 0; j < opts.types.length; j++ ) { - if ( type === opts.types[ j ] ) { - FLG = true; - break; - } - } - if ( FLG === false ) { - continue; - } - } - // If we've made it this far, the variable should have passed all filters... - out.push( v ); - if ( opts.details ) { - j = out.length - 1; - out[ j ] = { - 'name': out[ j ], - 'type': type || typeOf( list[ i+1 ] ), - 'data': String( list[ i+1 ] ) // WARNING: for large datasets, this could be expensive!!! TODO: may want to consider alternative strategies for serialization based on a value's type. - }; - v = out[ j ].data; - if ( v.length > 20 ) { - out[ j ].data = v.slice( 0, 9 ) + '...' + v.slice( v.length-8 ); - } - } } - return out; } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/workspace.js b/lib/node_modules/@stdlib/repl/lib/commands/workspace.js index f2964a97a9c1..d49d7ac52249 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/workspace.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/workspace.js @@ -24,9 +24,6 @@ var logger = require( 'debug' ); var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var propertyDescriptor = require( '@stdlib/utils/property-descriptor' ); -var defineProperty = require( '@stdlib/utils/define-property' ); var format = require( '@stdlib/string/format' ); var log = require( './../log.js' ); @@ -56,77 +53,29 @@ function command( repl ) { * @returns {void} */ function onCommand( name ) { - var vars; - var curr; - var desc; var err; - var ws; - var i; if ( !isString( name ) ) { err = new TypeError( format( 'invalid argument. Must provide a string. Value: `%s`.', name ) ); debug( 'Error: %s', err.message ); repl._ostream.write( 'Error: '+err.message+'\n' ); return; } - curr = repl._currentWorkspace; - if ( name === curr ) { + if ( name === repl.currentWorkspace ) { log( repl, 'Already in \''+name+'\' workspace.' ); debug( 'Already in \'%s\' workspace.', name ); return; } - // Cache and delete the current workspace variables... - vars = repl._context.varsWorkspace( curr ); - ws = repl._workspaces[ curr ]; - ws.length = 0; // reset - for ( i = 0; i < vars.length; i++ ) { - desc = propertyDescriptor( repl._context, vars[ i ] ); - ws.push( vars[ i ], desc ); - - // WARNING: in non-sandboxed environments, we run the risk of deleting global variables which were not introduced by the REPL environment... - if ( desc.configurable ) { - delete repl._context[ vars[ i ] ]; - } - } - // Reset the REPL evaluation context (Why? Because we cannot simply delete variables as seen within the REPL environment. E.g., variables declared with `var` in the global scope are non-configurable, and, thus, cannot be deleted (see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/delete). Hence, while we can delete a property/variable here, this deletion does not get propagated to within the REPL environment; i.e., a user can still access the deleted property as a variable within the REPL environment.): - repl.resetContext(); - - // If the destination workspace already exists, load the workspace's variables... - if ( hasOwnProp( repl._workspaces, name ) ) { - ws = repl._workspaces[ name ]; - for ( i = 0; i < ws.length; i += 2 ) { - desc = propertyDescriptor( repl._context, ws[ i ] ); - - // If the variable does not already exist in the current evaluation context, define a new variable... - if ( desc === null ) { - defineProperty( repl._context, ws[ i ], ws[ i+1 ] ); - } - // If configurable, we can simply overwrite the existing property descriptor... - else if ( desc.configurable ) { - defineProperty( repl._context, ws[ i ], ws[ i+1 ] ); - } - // Otherwise, use direct assignment if the variable is writable... - else if ( hasOwnProp( desc, 'value' ) || hasOwnProp( desc, 'set' ) ) { - repl._context[ ws[ i ] ] = ws[ i+1 ]; - } - // Cannot assign to the variable as the variable is read-only... - else { - log( repl, 'Cannot load \''+ws[ i ]+'\' from \''+name+'\' workspace due to the presence of a non-configurable read-only variable of the same name.' ); - debug( 'Cannot load \'%s\' from \'%s\' workspace due to the presence of a non-configurable read-only variable of the same name.', ws[ i ], name ); - } - } - ws.length = 0; // free up memory and prevent holding on to old references + try { + repl.switchWorkspace( name ); log( repl, 'Switched to \''+name+'\' workspace.' ); debug( 'Switched to %s workspace.', name ); - } - // Otherwise, create a new workspace... - else { - repl._workspaces[ name ] = []; + } catch ( error ) { // eslint-disable-line no-unused-vars + // Workspace doesn't exist, create a new one: + repl.createWorkspace( name ); + repl.switchWorkspace( name ); log( repl, 'Created and switched to \''+name+'\' workspace.' ); debug( 'Created and switched to %s workspace.', name ); } - - // Update the current workspace variable: - repl._currentWorkspace = name; // bookkeeping } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/workspaces.js b/lib/node_modules/@stdlib/repl/lib/commands/workspaces.js index d4e39c858b5f..b51a44d4be6c 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/workspaces.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/workspaces.js @@ -27,7 +27,6 @@ var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive; var isPlainObject = require( '@stdlib/assert/is-plain-object' ); var isRegExp = require( '@stdlib/assert/is-regexp' ); var hasOwnProp = require( '@stdlib/assert/has-own-property' ); -var objectKeys = require( '@stdlib/utils/keys' ); var format = require( '@stdlib/string/format' ); @@ -65,7 +64,7 @@ function command( repl ) { var w; var i; if ( arguments.length === 0 ) { - return objectKeys( repl._workspaces ); + return repl.workspaces(); } if ( !isPlainObject( options ) ) { err = new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', name ) ); @@ -91,7 +90,7 @@ function command( repl ) { repl._ostream.write( 'Error: '+err.message+'\n' ); return; } - tmp = objectKeys( repl._workspaces ); + tmp = repl.workspaces(); out = []; for ( i = 0; i < tmp.length; i++ ) { w = tmp[ i ]; @@ -106,7 +105,7 @@ function command( repl ) { if ( options.details ) { out[ out.length-1 ] = { 'name': w, - 'variables': repl._context.varsWorkspace( w, { + 'variables': repl.varsWorkspace( w, { 'details': true }) }; diff --git a/lib/node_modules/@stdlib/repl/lib/completer_engine.js b/lib/node_modules/@stdlib/repl/lib/completer_engine.js index a1ff5db541fe..d2f58a5f7ad8 100644 --- a/lib/node_modules/@stdlib/repl/lib/completer_engine.js +++ b/lib/node_modules/@stdlib/repl/lib/completer_engine.js @@ -69,14 +69,13 @@ function stripANSI( str ) { * @private * @constructor * @param {REPL} repl - REPL instance -* @param {Function} completer - function for generating possible completions * @param {WritableStream} ostream - writable stream * @param {Function} ttyWrite - function to trigger the default behavior of the keypress * @returns {CompleterEngine} completer engine instance */ -function CompleterEngine( repl, completer, ostream, ttyWrite ) { +function CompleterEngine( repl, ostream, ttyWrite ) { if ( !( this instanceof CompleterEngine ) ) { - return new CompleterEngine( repl, completer, ostream, ttyWrite ); + return new CompleterEngine( repl, ostream, ttyWrite ); } debug( 'Creating a completer engine...' ); @@ -89,9 +88,6 @@ function CompleterEngine( repl, completer, ostream, ttyWrite ) { // Cache a reference to the output writable stream: this._ostream = ostream; - // Cache a reference to the provided completer; - this._completer = completer; - // Cache a reference to the private readline interface `ttyWrite` to allow calling the method when wanting default behavior: this._ttyWrite = ttyWrite; @@ -682,7 +678,7 @@ setNonEnumerableReadOnly( CompleterEngine.prototype, 'beforeKeypress', function // Pause the input stream before generating completions as the completer may be asynchronous: this._rli.pause(); - this._completer( this._inputLine, this._onCompletions ); + this._repl.completer( this._inputLine, this._onCompletions ); }); /** @@ -733,7 +729,7 @@ setNonEnumerableReadOnly( CompleterEngine.prototype, 'onKeypress', function onKe // Pause the input stream before generating completions as the completer may be asynchronous... this._rli.pause(); - this._completer( this._inputLine, this._onCompletions ); + this._repl.completer( this._inputLine, this._onCompletions ); }); /** diff --git a/lib/node_modules/@stdlib/repl/lib/completer_preview.js b/lib/node_modules/@stdlib/repl/lib/completer_preview.js index 2eae0a89ac4e..e3d3f1fdd7bb 100644 --- a/lib/node_modules/@stdlib/repl/lib/completer_preview.js +++ b/lib/node_modules/@stdlib/repl/lib/completer_preview.js @@ -41,30 +41,30 @@ var debug = logger( 'repl:completer:preview' ); * * @private * @constructor +* @param {REPL} repl - REPL instance * @param {Object} rli - readline instance -* @param {Function} completer - function for generating possible completions * @param {WritableStream} ostream - writable stream * @param {boolean} enabled - boolean indicating whether the completer should be initially enabled * @returns {PreviewCompleter} completer instance */ -function PreviewCompleter( rli, completer, ostream, enabled ) { +function PreviewCompleter( repl, rli, ostream, enabled ) { if ( !(this instanceof PreviewCompleter) ) { - return new PreviewCompleter( rli, completer, ostream, enabled ); + return new PreviewCompleter( repl, rli, ostream, enabled ); } debug( 'Creating a preview completer...' ); // Initialize a flag indicating whether the preview completer is enabled: this._enabled = enabled; + // Cache a reference to the provided REPL instance: + this._repl = repl; + // Cache a reference to the provided readline interface: this._rli = rli; // Cache a reference to the output writable stream: this._ostream = ostream; - // Cache a reference to the provided completer: - this._completer = completer; - // Create a callback for processing potential completion previews: this._onCompletions = this._completionCallback(); @@ -232,7 +232,7 @@ setNonEnumerableReadOnly( PreviewCompleter.prototype, 'onKeypress', function onK return; } try { - this._completer( this._rli.line, this._onCompletions ); + this._repl.completer( this._rli.line, this._onCompletions ); } catch ( err ) { debug( 'Error: %s', err.message ); } diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js index fa86124b6821..d4c5647f993a 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/lib/main.js @@ -184,7 +184,6 @@ function REPL( options ) { // Call the parent constructor: BaseREPL.call( this, { - 'input': opts.input, 'output': ostream, 'error': ostream, 'sandbox': opts.sandbox, @@ -194,7 +193,8 @@ function REPL( options ) { 'quiet': opts.quiet }); - // Cache reference to the output stream: + // Cache references to the input and output streams: + setNonEnumerableReadOnly( this, '_istream', opts.input ); setNonEnumerableReadOnly( this, '_wstream', opts.output ); // Cache options: @@ -204,6 +204,15 @@ function REPL( options ) { setNonEnumerableReadOnly( this, '_isTTY', opts.isTTY ); setNonEnumerableReadOnly( this, '_settings', opts.settings ); + // Initialize an internal data store: + setNonEnumerableReadOnly( this, '_internal', {} ); + setNonEnumerableReadOnly( this._internal, 'presentation', {} ); + setNonEnumerableReadOnly( this._internal.presentation, 'cache', {} ); + setNonEnumerable( this._internal.presentation, 'counter', 0 ); + + // Initialize a strided internal buffer for storing user-defined documentation: + setNonEnumerableReadOnly( this, '_userdocs', [] ); + // Initialize an internal flag indicating whether we've received a `SIGINT` signal: setNonEnumerable( this, '_SIGINT', false ); @@ -230,13 +239,13 @@ function REPL( options ) { setNonEnumerableReadOnly( this, '_editorActions', new EditorActions( this, this._rli._ttyWrite ) ); // Create a new TAB completer engine: - setNonEnumerableReadOnly( this, '_completerEngine', new CompleterEngine( this, this.completer, this._wstream, this._rli._ttyWrite ) ); + setNonEnumerableReadOnly( this, '_completerEngine', new CompleterEngine( this, this._wstream, this._rli._ttyWrite ) ); // Create a new auto-closer: setNonEnumerableReadOnly( this, '_autoCloser', new AutoCloser( this._rli, this._settings.autoClosePairs, this._settings.autoDeletePairs, this._multilineHandler ) ); // Initialize a preview completer: - setNonEnumerableReadOnly( this, '_previewCompleter', new PreviewCompleter( this._rli, this.completer, this._ostream, this._settings.completionPreviews ) ); + setNonEnumerableReadOnly( this, '_previewCompleter', new PreviewCompleter( this, this._rli, this._ostream, this._settings.completionPreviews ) ); // Initialize a syntax-highlighter: setNonEnumerableReadOnly( this, '_syntaxHighlighter', new SyntaxHighlighter( this, this._ostream, this._settings.syntaxHighlighting ) ); @@ -1109,6 +1118,34 @@ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { return this; }); +/** +* Clears user-defined documentation. +* +* @name clearUserDocs +* @memberof REPL.prototype +* @type {Function} +* @returns {REPL} REPL instance +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Clear the user defined documentation: +* repl.clearUserDocs(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'clearUserDocs', function clearUserDocs() { + debug( 'Resetting REPL user-defined documentation...' ); + this._userdocs.length = 0; + return this; +}); + /** * Clears the entire REPL screen and scrollback history. * diff --git a/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js b/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js index 441b2bb43785..2855ef42eb3a 100644 --- a/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js +++ b/lib/node_modules/@stdlib/repl/lib/syntax_highlighter.js @@ -328,7 +328,7 @@ setNonEnumerableReadOnly( SyntaxHighlighter.prototype, 'onKeypress', function on // Tokenize: debug( 'Line change detected. Tokenizing line: %s', this._rli.line ); this._line = this._rli.line; // update line buffer - tokens = this._repl.tokenizer( this._line, this._repl._context ); + tokens = this._repl.tokenizer( this._line ); if ( isEmptyArray( tokens ) ) { debug( 'No tokens found. Skipping highlighting...' ); this._highlightedLine = this._line; From d20819265aa373b1ec52e0fa8b5e0ff4c183b3df Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 15 Mar 2025 18:42:39 +0000 Subject: [PATCH 18/26] docs: fix examples Signed-off-by: Snehil Shah --- 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: passed - 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 --- Signed-off-by: Snehil Shah --- .../@stdlib/repl/base/ctor/README.md | 39 ++++++++----------- .../@stdlib/repl/base/ctor/lib/main.js | 22 ++++++++--- 2 files changed, 33 insertions(+), 28 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index 4a8bb23f5762..f819e42a45ce 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -161,8 +161,11 @@ var repl = new REPL(); // ... -// Switch workspace: -repl.switchWorkspace( 'yourWorkspace' ); +// Create new workspace: +repl.createWorkspace( 'myWorkspace' ); + +// Switch to newly created workspace: +repl.switchWorkspace( 'myWorkspace' ); // ... @@ -180,8 +183,11 @@ var repl = new REPL(); // ... +// Create new workspace: +repl.createWorkspace( 'myWorkspace' ); + // Load variables from a workspace: -var count = repl.loadWorkspace( 'yourWorkspace', {} ); +var count = repl.loadWorkspace( 'myWorkspace', {} ); // ... @@ -237,6 +243,9 @@ var repl = new REPL(); // ... +// Create new workspace: +repl.createWorkspace( 'myWorkspace' ); + // Rename workspace: repl.renameWorkspace( 'myWorkspace', 'yourWorkspace' ); @@ -256,6 +265,9 @@ var repl = new REPL(); // ... +// Create new workspace: +repl.createWorkspace( 'yourWorkspace' ); + // Delete workspace: repl.deleteWorkspace( 'yourWorkspace' ); @@ -276,7 +288,7 @@ var repl = new REPL(); // ... // Clear user workspace: -var d = repl.clearWorkspace( 'myWorkspace' ); +var d = repl.clearWorkspace( 'base' ); // ... @@ -303,25 +315,6 @@ repl.clearHistory(); 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. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 43a0018907b5..0db787038569 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -512,7 +512,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext( // Before creating a new execution context in a non-sandboxed environment, remove current workspace variables in order to allow garbage collection and avoid memory leaks (e.g., variables/functions declared during a REPL session which might remain bound to the environment `global` after clearing a REPL): if ( this._sandbox === false ) { // WARNING: in a non-sandboxed environment, if a global variable is externally introduced during a REPL session (i.e., introduced via a mechanism outside of the REPL environment), we will delete that global variable, which means the following logic may introduce unintended side-effects for this particular edge case (e.g., application code may expect the presence of the subsequently deleted global variable). While not ideal, (a) user applications should not be introducing globals to begin with and (b) the probability of a user running a REPL session, a user clearing that REPL session, AND a global variable being introduced between starting a REPL and clearing the REPL should be negligible. - tmp = this._context.vars(); + tmp = this.varsWorkspace( this.currentWorkspace ); for ( i = 0; i < tmp.length; i++ ) { if ( isConfigurableProperty( this._context, tmp[ i ] ) ) { delete this._context[ tmp[ i ] ]; @@ -597,8 +597,11 @@ setNonEnumerableReadOnly( REPL.prototype, 'createWorkspace', function createWork * * // ... * -* // Switch workspace: -* repl.switchWorkspace( 'yourWorkspace' ); +* // Create new workspace: +* repl.createWorkspace( 'myWorkspace' ); +* +* // Switch to newly created workspace: +* repl.switchWorkspace( 'myWorkspace' ); * * // ... * @@ -623,7 +626,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'switchWorkspace', function workspace( return; } // Cache and delete the current workspace variables... - vars = this._context.varsWorkspace( curr ); + vars = this.varsWorkspace( curr ); ws = this._workspaces[ curr ]; ws.length = 0; // reset for ( i = 0; i < vars.length; i++ ) { @@ -686,6 +689,9 @@ setNonEnumerableReadOnly( REPL.prototype, 'switchWorkspace', function workspace( * * // ... * +* // Create new workspace: +* repl.createWorkspace( 'myWorkspace' ); +* * // Load variables from a workspace: * var count = repl.loadWorkspace( 'myWorkspace', {} ); * @@ -947,6 +953,9 @@ setNonEnumerableReadOnly( REPL.prototype, 'varsWorkspace', function varsWorkspac * * // ... * +* // Create new workspace: +* repl.createWorkspace( 'myWorkspace' ); +* * // Rename workspace: * repl.renameWorkspace( 'myWorkspace', 'yourWorkspace' ); * @@ -1010,6 +1019,9 @@ setNonEnumerableReadOnly( REPL.prototype, 'renameWorkspace', function renameWork * * // ... * +* // Create new workspace: +* repl.createWorkspace( 'yourWorkspace' ); +* * // Delete workspace: * repl.deleteWorkspace( 'yourWorkspace' ); * @@ -1055,7 +1067,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'deleteWorkspace', function deleteWork * // ... * * // Clear user workspace: -* var d = repl.clearWorkspace( 'myWorkspace' ); +* var d = repl.clearWorkspace( 'base' ); * * // ... * From 9c834224f87fc0060c4aeb42bcbb985a4df67caf Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 15 Mar 2025 19:27:07 +0000 Subject: [PATCH 19/26] refactor: separate concern of streams The base ctor needs the stream to feed to the Console object. The CLI implementation needs it to paint the entire UI. They serve different purposes in both parties, and hence exposing APIs from the base implementation that allows access to the underlying ostream just doesn't make sense. It's duplication, but cleanly separates concerns Signed-off-by: Snehil Shah --- 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 --- --- lib/node_modules/@stdlib/repl/base/ctor/lib/main.js | 8 ++++---- lib/node_modules/@stdlib/repl/lib/main.js | 1 + 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 0db787038569..1fa1084124b9 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -136,9 +136,9 @@ function REPL( options ) { // Call the parent constructor: EventEmitter.call( this ); - // Cache references to the input and output streams: - setNonEnumerableReadOnly( this, '_ostream', opts.output ); - setNonEnumerableReadOnly( this, '_estream', opts.error ); + // Cache references to the output and error streams: + setNonEnumerableReadOnly( this, '_output', opts.output ); + setNonEnumerableReadOnly( this, '_error', opts.error ); // Cache options: setNonEnumerableReadOnly( this, '_timeout', opts.timeout ); @@ -466,7 +466,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex debug( 'Creating REPL execution context...' ); // Create an evaluation context: - context = createEvalContext( this._contextVars, this._ostream, this._estream, this._sandbox ); // eslint-disable-line max-len + context = createEvalContext( this._contextVars, this._output, this._error, this._sandbox ); // eslint-disable-line max-len // Add project APIs... if ( this._sandbox ) { diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js index d4c5647f993a..dfea1f09db61 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/lib/main.js @@ -195,6 +195,7 @@ function REPL( options ) { // Cache references to the input and output streams: setNonEnumerableReadOnly( this, '_istream', opts.input ); + setNonEnumerableReadOnly( this, '_ostream', ostream ); setNonEnumerableReadOnly( this, '_wstream', opts.output ); // Cache options: From ccdfd71d8f4d939806b9224d11dd80ae3ae1acb7 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Mon, 17 Mar 2025 06:03:58 +0000 Subject: [PATCH 20/26] refactor: clean up context creation Signed-off-by: Snehil Shah --- 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 --- --- .../ctor/lib/create_evaluation_context.js | 6 +-- .../@stdlib/repl/base/ctor/lib/main.js | 45 ++++++++++++++++--- .../repl/{ => base/ctor}/lib/set_commands.js | 0 .../ctor}/lib/set_commands_global.js | 0 lib/node_modules/@stdlib/repl/lib/main.js | 26 +++-------- 5 files changed, 48 insertions(+), 29 deletions(-) rename lib/node_modules/@stdlib/repl/{ => base/ctor}/lib/set_commands.js (100%) rename lib/node_modules/@stdlib/repl/{ => base/ctor}/lib/set_commands_global.js (100%) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/create_evaluation_context.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/create_evaluation_context.js index 7020e14162ed..d70a0a5f46f9 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/create_evaluation_context.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/create_evaluation_context.js @@ -43,21 +43,21 @@ var resolveLookupPaths = Module._resolveLookupPaths; // eslint-disable-line no-u * Creates a REPL evaluation context. * * @private +* @param {Object} context - context object * @param {Array} out - strided output array for storing variables added to the evaluation context * @param {Stream} ostream - output stream * @param {Stream} estream - error stream * @param {boolean} sandbox - boolean indicating whether the evaluation context should be "sandboxed" * @returns {Object} context */ -function createContext( out, ostream, estream, sandbox ) { - var context; +function createContext( context, out, ostream, estream, sandbox ) { var keys; var i; // Create the REPL context... if ( sandbox ) { // Create a sandboxed context: - context = vm.createContext(); + context = vm.createContext( context ); // Assign globals from the current global context to the sandboxed context (note: shallow copy!)... keys = objectKeys( GLOBALS ); diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 1fa1084124b9..418cb83cb6d0 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -31,6 +31,7 @@ var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var objectKeys = require( '@stdlib/utils/keys' ); var properties = require( '@stdlib/utils/properties' ); var typeOf = require( '@stdlib/utils/type-of' ); +var append = require( '@stdlib/utils/append' ); var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); var setReadOnlyAccessor = require( '@stdlib/utils/define-nonenumerable-read-only-accessor' ); @@ -50,6 +51,8 @@ var validate = require( './validate.js' ); var defaults = require( './defaults.js' ); var setAliases = require( './set_aliases.js' ); var setAliasesGlobal = require( './set_aliases_global.js' ); +var setCommands = require( './set_commands.js' ); +var setCommandsGlobal = require( './set_commands_global.js' ); var createEvalContext = require( './create_evaluation_context.js' ); var completerFactory = require( './completer.js' ); var tokenizerFactory = require( './tokenizer.js' ); @@ -448,6 +451,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', function tokenizer( line * @name createContext * @memberof REPL.prototype * @type {Function} +* @param {Object} context - context object * @returns {Object} REPL context * * @example @@ -455,18 +459,23 @@ setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', function tokenizer( line * var repl = new REPL(); * * // Return a new REPL context: -* var ctx = repl.createContext(); +* var ctx = repl.createContext({}); * * // Close the REPL: * repl.close(); */ -setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContext() { - var context; - +setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContext( context ) { + if ( arguments.length ) { + if ( !isPlainObject( context ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a plain object. Value: `%s`.', context ) ); + } + } else { + context = {}; + } debug( 'Creating REPL execution context...' ); // Create an evaluation context: - context = createEvalContext( this._contextVars, this._output, this._error, this._sandbox ); // eslint-disable-line max-len + context = createEvalContext( context, this._contextVars, this._output, this._error, this._sandbox ); // eslint-disable-line max-len // Add project APIs... if ( this._sandbox ) { @@ -475,6 +484,15 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex setAliasesGlobal( this._globalVars, this._aliases, context, ALIAS_OVERRIDES ); // eslint-disable-line max-len } + // NOTE: the context should not be augmented **after** this point, except as done by the user when declaring variables and functions! + + // Sort the list of global variables: + if ( this._sandbox === false ) { + this._globalVars.sort( propertyComparator ); + } + // Capture a snapshot of the current global workspace: + append( this._workspace, properties( context ).sort( propertyComparator ) ); + return context; }); @@ -550,6 +568,23 @@ setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext( return this; }); +/** +* Sets commands on a context object. +* +* @name setCommands +* @memberof REPL.prototype +* @type {Function} +* @param {Object} context - context object +* @param {ArrayArray} commands - commands +* @returns {Object} context object +*/ +setNonEnumerableReadOnly( REPL.prototype, 'setCommands', function set( context, commands ) { + if ( this._sandbox ) { + return setCommands( context, commands ); + } + return setCommandsGlobal( this._globalVars, context, commands ); +}); + /** * Creates a new workspace. * diff --git a/lib/node_modules/@stdlib/repl/lib/set_commands.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/set_commands.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/set_commands.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/set_commands.js diff --git a/lib/node_modules/@stdlib/repl/lib/set_commands_global.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/set_commands_global.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/set_commands_global.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/set_commands_global.js diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js index dfea1f09db61..b00dd3dc4928 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/lib/main.js @@ -41,8 +41,6 @@ var readFileSync = require( '@stdlib/fs/read-file' ).sync; var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; var setNonEnumerable = require( '@stdlib/utils/define-nonenumerable-property' ); var setNonEnumerableReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' ); -var properties = require( '@stdlib/utils/properties' ); -var append = require( '@stdlib/utils/append' ); var nextTick = require( '@stdlib/utils/next-tick' ); var Boolean = require( '@stdlib/boolean/ctor' ); var assign = require( '@stdlib/object/assign' ); @@ -51,9 +49,6 @@ var validate = require( './validate.js' ); var parseKey = require( './parse_key.js' ); var defaults = require( './defaults.js' ); var isSettingName = require( './is_setting_name.js' ); -var setCommands = require( './set_commands.js' ); -var setCommandsGlobal = require( './set_commands_global.js' ); -var propertyComparator = require( './property_comparator.js' ); var commands = require( './commands.js' ); var displayPrompt = require( './display_prompt.js' ); var inputPrompt = require( './input_prompt.js' ); @@ -685,28 +680,17 @@ setNonEnumerableReadOnly( REPL.prototype, 'createContext', function createContex var context; var cmds; - context = BaseREPL.prototype.createContext.call( this ); + // Initialize context object: + context = {}; // Get the list of REPL-specific commands: cmds = commands( this ); // Add commands requiring privileged access to internal instance variables... - if ( this._sandbox ) { - setCommands( context, cmds ); - } else { - setCommandsGlobal( this._globalVars, context, cmds ); - } - - // NOTE: the context should not be augmented **after** this point, except as done by the user when declaring variables and functions! + context = this.setCommands( context, cmds ); - // Sort the list of global variables: - if ( this._sandbox === false ) { - this._globalVars.sort( propertyComparator ); - } - // Capture a snapshot of the current global workspace: - append( this._workspace, properties( context ).sort( propertyComparator ) ); - - return context; + // Call the parent method: + return BaseREPL.prototype.createContext.call( this, context ); }); /** From 99a38e7e0ed103568394f94a640dbc7d62eab81a Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Mon, 17 Mar 2025 06:18:39 +0000 Subject: [PATCH 21/26] fix: heal examples Signed-off-by: Snehil Shah --- 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 --- --- lib/node_modules/@stdlib/repl/base/ctor/lib/main.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 418cb83cb6d0..a82f41c26807 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -195,7 +195,7 @@ function REPL( options ) { setNonEnumerable( this, '_done', void 0 ); // Create a REPL execution context: - setNonEnumerable( this, '_context', this.createContext( opts.output, opts.error ) ); + setNonEnumerable( this, '_context', this.createContext() ); // Create a new completer: setNonEnumerableReadOnly( this, '_completer', completerFactory( this ) ); @@ -451,7 +451,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', function tokenizer( line * @name createContext * @memberof REPL.prototype * @type {Function} -* @param {Object} context - context object +* @param {Object} [context] - context object * @returns {Object} REPL context * * @example From 34103413f830a3f6af169342982683a5426f4879 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Fri, 21 Mar 2025 20:43:28 +0000 Subject: [PATCH 22/26] docs: document `setCommands` Signed-off-by: Snehil Shah --- 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: passed - 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 --- Signed-off-by: Snehil Shah --- .../@stdlib/repl/base/ctor/README.md | 28 +++++++++++++++++++ .../@stdlib/repl/base/ctor/lib/main.js | 23 +++++++++++++++ 2 files changed, 51 insertions(+) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index f819e42a45ce..b739ab8c5b4d 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -132,6 +132,34 @@ repl.resetContext(); repl.close(); ``` +#### REPL.prototype.setCommands( context, commands ) + +Sets commands on a context object. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Initialize empty context: +var ctx = {}; + +// Define custom commands: +function helloWorld() { + console.log( 'Hello World!' ); +} +var cmds = [ [ 'helloWorld', helloWorld, false ] ]; + +// Set custom commands on context: +repl.setCommands( ctx, cmds ); + +// ... + +// Close the REPL: +repl.close(); +``` + #### REPL.prototype.createWorkspace( name ) Creates a new workspace. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index a82f41c26807..c3c0bf466d72 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -577,6 +577,29 @@ setNonEnumerableReadOnly( REPL.prototype, 'resetContext', function resetContext( * @param {Object} context - context object * @param {ArrayArray} commands - commands * @returns {Object} context object +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Initialize empty context: +* var ctx = {}; +* +* // Define custom commands: +* function helloWorld() { +* console.log( 'Hello World!' ); +* } +* var cmds = [ [ 'helloWorld', helloWorld, false ] ]; +* +* // Set custom commands on context: +* repl.setCommands( ctx, cmds ); +* +* // ... +* +* // Close the REPL: +* repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'setCommands', function set( context, commands ) { if ( this._sandbox ) { From 9cefae18bac1235381433b12d6fb4ddc730a7d44 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Fri, 21 Mar 2025 21:19:11 +0000 Subject: [PATCH 23/26] refactor: evalin command Signed-off-by: Snehil Shah --- 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: passed - 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 --- --- .../@stdlib/repl/base/ctor/README.md | 19 ++++ .../@stdlib/repl/base/ctor/lib/main.js | 90 +++++++++++++++++++ .../@stdlib/repl/lib/commands/evalin.js | 83 +---------------- .../repl/lib/restore_regexp_matches.js | 48 ---------- .../@stdlib/repl/lib/update_regexp_cache.js | 47 ---------- 5 files changed, 113 insertions(+), 174 deletions(-) delete mode 100644 lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js delete mode 100644 lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index b739ab8c5b4d..ada22be56747 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -261,6 +261,25 @@ var list = repl.varsWorkspace( repl.currentWorkspace ); repl.close(); ``` +#### REPL.prototype.evalin( workspace, expression ) + +Evaluates an expression in a specified workspace. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// ... + +// Evaluate in base workspace: +repl.evalin( 'base', 'var x = 5;' ); + +// ... + +// Close the REPL: +repl.close(); +``` + #### REPL.prototype.renameWorkspace( oldName, newName ) Renames a workspace. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index c3c0bf466d72..92ad41263b9b 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -22,6 +22,7 @@ // MODULES // +var vm = require( 'vm' ); var EventEmitter = require( 'events' ).EventEmitter; var logger = require( 'debug' ); var inherit = require( '@stdlib/utils/inherit' ); @@ -59,6 +60,8 @@ var tokenizerFactory = require( './tokenizer.js' ); var processCommand = require( './process_command.js' ); var compileCommand = require( './compile_command.js' ); var processInput = require( './process_input.js' ); +var updateRegExpCache = require( './update_regexp_cache.js' ); +var restoreRegExpMatches = require( './restore_regexp_matches.js' ); var isMultilineInput = require( './is_multiline_input.js' ); var contains = require( './contains.js' ); var filter = require( './filter.js' ); @@ -70,6 +73,7 @@ var ALIAS_OVERRIDES = require( './alias_overrides.js' ); // VARIABLES // var debug = logger( 'repl' ); +var RE_WHITESPACE = /^\s*$/; // MAIN // @@ -992,6 +996,92 @@ setNonEnumerableReadOnly( REPL.prototype, 'varsWorkspace', function varsWorkspac return out; }); +/** +* Evaluates an expression in a specified workspace. +* +* @name evalin +* @memberof REPL.prototype +* @type {Function} +* @param {string} workspace - workspace name +* @param {string} expression - expression to evaluate +* @returns {void} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Evaluate in base workspace: +* repl.evalin( 'base', 'var x = 5;' ); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'evalin', function evalin( workspace, expression ) { + var script; + var opts; + var FLG; + var ws; + if ( !isString( workspace ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', workspace ) ); + } + if ( !isString( expression ) ) { + throw new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', workspace ) ); + } + if ( RE_WHITESPACE.test( expression ) ) { + debug( 'Expression only consists of whitespace. Nothing to evaluate.' ); + return; + } + // Cache the name of the current workspace: + ws = this._currentWorkspace; + + // Temporarily silence logging: + FLG = this._quiet; + this._quiet = true; + + try { + // Switch to the target workspace: + this.switchWorkspace( workspace ); + } catch ( error ) { + this._quiet = FLG; + throw error; + } + // Try evaluating the expression... + opts = { + 'filename': '', + 'lineOffset': 0 + }; + try { + // FIXME: this needs to follow the same logic as `process_line`, such as code wrapping, asynchronous execution, and handling top-level `await`!!! + script = new vm.Script( expression, opts ); + } catch ( error ) { + this.switchWorkspace( ws ); + this._quiet = FLG; + throw error; + } + // Set the (non-standard) properties on the `RegExp` expression object to the cached matches: + restoreRegExpMatches( this._regexp ); + + opts = { + 'timeout': this._timeout, + 'displayErrors': false, + 'breakOnSigint': true // Note: only applies for Node.js versions >=6.3.0 + }; + + // FIXME: we need to follow similar logic as `drain.js`, such as SIGINT handling!!! + script.runInContext( this._context, opts ); + updateRegExpCache( this._regexp ); + + // Return to the previous workspace: + this.switchWorkspace( ws ); + + // Re-enable logging (if enabled): + this._quiet = FLG; +}); + /** * Renames a workspace. * diff --git a/lib/node_modules/@stdlib/repl/lib/commands/evalin.js b/lib/node_modules/@stdlib/repl/lib/commands/evalin.js index 9e249e2a52a5..4f33d8f31980 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/evalin.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/evalin.js @@ -22,18 +22,12 @@ // MODULES // -var vm = require( 'vm' ); var logger = require( 'debug' ); -var isString = require( '@stdlib/assert/is-string' ).isPrimitive; -var format = require( '@stdlib/string/format' ); -var updateRegExpCache = require( './../update_regexp_cache.js' ); -var restoreRegExpMatches = require( './../restore_regexp_matches.js' ); // VARIABLES // var debug = logger( 'repl:command:evalin' ); -var RE_WHITESPACE = /^\s*$/; // MAIN // @@ -57,82 +51,13 @@ function command( repl ) { * @returns {void} */ function onCommand( workspace, expression ) { - var script; - var opts; - var err; - var FLG; - var ws; - if ( !isString( workspace ) ) { - err = new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', workspace ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( !isString( expression ) ) { - err = new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', workspace ) ); - debug( 'Error: %s', err.message ); - repl._ostream.write( 'Error: '+err.message+'\n' ); - return; - } - if ( RE_WHITESPACE.test( expression ) ) { - debug( 'Expression only consists of whitespace. Nothing to evaluate.' ); - return; - } - // Cache the name of the current workspace: - ws = repl.currentWorkspace; - - // Temporarily silence logging: - FLG = repl._quiet; - repl._quiet = true; - try { - // Switch to the target workspace: - repl.switchWorkspace( workspace ); - } catch ( error ) { - debug( 'Error: %s', error.message ); - repl._ostream.write( 'Error: '+error.message+'\n' ); - repl._quiet = FLG; - return; - } - // Try evaluating the expression... - opts = { - 'filename': '', - 'lineOffset': 0 - }; - try { - // FIXME: this needs to follow the same logic as `process_line`, such as code wrapping, asynchronous execution, and handling top-level `await`!!! - script = new vm.Script( expression, opts ); - } catch ( error ) { - debug( 'Error: %s', error.message ); - repl._ostream.write( 'Error: '+error.message+'\n' ); - repl.switchWorkspace( ws ); - repl._quiet = FLG; - return; - } - // Set the (non-standard) properties on the `RegExp` expression object to the cached matches: - restoreRegExpMatches( repl._regexp ); - - opts = { - 'timeout': repl._timeout, - 'displayErrors': false, - 'breakOnSigint': true // Note: only applies for Node.js versions >=6.3.0 - }; - - // FIXME: we need to follow similar logic as `drain.js`, such as SIGINT handling!!! - try { - script.runInContext( repl._context, opts ); + repl.evalin( workspace, expression ); repl._ostream.write( 'Successfully evaluated expression.\n' ); - } catch ( error ) { - debug( 'Error: %s', error.message ); - repl._ostream.write( 'Error: '+error.message+'\n' ); + } catch ( err ) { + debug( 'Error: %s', err.message ); + repl._ostream.write( 'Error: '+err.message+'\n' ); } - updateRegExpCache( repl._regexp ); - - // Return to the previous workspace: - repl.switchWorkspace( ws ); - - // Re-enable logging (if enabled): - repl._quiet = FLG; } } diff --git a/lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js b/lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js deleted file mode 100644 index e1658458d972..000000000000 --- a/lib/node_modules/@stdlib/repl/lib/restore_regexp_matches.js +++ /dev/null @@ -1,48 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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'; - -// VARIABLES // - -var SEP_REGEXP_MATCHES = '\u0000\u0000\u0000'; -var RE_REGEXP_MATCHES = new RegExp( [ '^', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)', '(.*)$' ].join( SEP_REGEXP_MATCHES ) ); - - -// MAIN // - -/** -* Restores the (non-standard) properties on the `RegExp` expression object to cached matches. -* -* ## Notes -* -* - In certain JavaScript engines (e.g., V8, SpiderMonkey), the global `RegExp` object has ([non-standard][1]) static, read-only properties (`$1`, `$2`, ..., `$9`) with cached substring matches. This function restores matches to a prior state based on a provided list of cached matches. -* -* [1]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/n -* -* @private -* @param {StringArray} cache - list of previously saved substring matches -*/ -function restoreRegExpMatches( cache ) { - RE_REGEXP_MATCHES.test( cache.join( SEP_REGEXP_MATCHES ) ); -} - - -// EXPORTS // - -module.exports = restoreRegExpMatches; diff --git a/lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js b/lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js deleted file mode 100644 index b630b6679ea5..000000000000 --- a/lib/node_modules/@stdlib/repl/lib/update_regexp_cache.js +++ /dev/null @@ -1,47 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2019 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 // - -/** -* Updates the cache of saved regular expression substring matches. -* -* ## Notes -* -* - In certain JavaScript engines (e.g., V8, SpiderMonkey), the global `RegExp` object has ([non-standard][1]) static, read-only properties (`$1`, `$2`, ..., `$9`) with cached substring matches. -* -* [1]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/n -* -* @private -* @param {StringArray} cache - list of previously saved substring matches -* @returns {StringArray} cache -*/ -function updateRegExpCache( cache ) { - var i; - for ( i = 1; i < cache.length; i++ ) { - cache[ i ] = RegExp[ '$'+i ]; - } - return cache; -} - - -// EXPORTS // - -module.exports = updateRegExpCache; From abc23eed86ec82501cde099fc87c51f9b810ac29 Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Fri, 21 Mar 2025 21:47:51 +0000 Subject: [PATCH 24/26] refactor: move `_cmd` and run logic Signed-off-by: Snehil Shah --- 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: passed - 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 --- Signed-off-by: Snehil Shah --- .../@stdlib/repl/base/ctor/README.md | 110 ++++++++++++++++++ .../@stdlib/repl/base/ctor/lib/completer.js | 2 +- .../@stdlib/repl/base/ctor/lib/main.js | 36 +++++- .../@stdlib/repl/lib/eager_evaluator.js | 6 +- lib/node_modules/@stdlib/repl/lib/main.js | 3 + 5 files changed, 147 insertions(+), 10 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index ada22be56747..a5cd81ee9640 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -94,6 +94,116 @@ repl.close(); ### Methods +#### REPL.prototype.isMultilineInput( input ) + +Checks if the given input is a possible multi-line command. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Check if an input is a possible multi-line command: +var input = 'for( var i = 0; i < 10; i++ ) {'; +var out = repl.isMultilineInput( input ); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.processCommand( code ) + +Processes a "raw" input command. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Process raw command: +var code = 'var y = 10;'; +var out = repl.processCommand( code ); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.compileCommand( cmd ) + +Compiles a command. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Process raw command: +var code = 'var y = 10;'; +var cmd = repl.processCommand( code ); + +// Compile processed command: +var out = repl.compileCommand( cmd ); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.runCommand( exe, opts ) + +Runs a compiled command. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Process and compile a raw command: +var cmd = '1 + 1'; +var code = repl.processCommand( cmd ); +var exe = repl.compileCommand( code ); + +// Run the compiled command: +var out = repl.runCommand( exe, {} ); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.completer( line, clbk ) + +Generates completions for a given line. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Generate completions for a line: +var line = 'var x = M'; +repl.completer( line, clbk ); + +function clbk( error, completions ) { + if ( error ) { + throw error; + } + console.log( completions ); +} + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.tokenizer( line ) + +Tokenizes the input line based on ECMAScript specification. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Tokenize an input line: +var line = 'var x = 5;'; +var out = repl.tokenizer( line ); + +// Close the REPL: +repl.close(); +``` + #### REPL.prototype.createContext() Returns a REPL context. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js index 549e7bcc4171..4eed458261df 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/completer.js @@ -147,7 +147,7 @@ function completer( repl ) { return clbk( null, [ res, line ] ); } // Sanity check that we are attempting to complete something which is completable: - if ( reservedCharsRegExp().test( line[ repl._rli.cursor-1 ] ) ) { + if ( reservedCharsRegExp().test( line[ line.length-1 ] ) ) { debug( 'Detected attempt to trigger completion after a special character.' ); debug( 'Results: %s', res.join( ', ' ) ); return clbk( null, [ res, line ] ); diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 92ad41263b9b..7252bbfa4943 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -158,9 +158,6 @@ function REPL( options ) { // Initialize a strided internal buffer for storing the command history: setNonEnumerableReadOnly( this, '_history', [] ); - // Initialize an internal buffer for storing the current command: - setNonEnumerableReadOnly( this, '_cmd', [] ); - // Initialize a executed command counter: setNonEnumerable( this, '_count', -1 ); @@ -356,7 +353,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'processCommand', function process( co /** * Compiles a command. * -* @private * @name compileCommand * @memberof REPL.prototype * @type {Function} @@ -384,6 +380,38 @@ setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', function compile( cm return compileCommand( cmd ); }); +/** +* Runs a compiled command. +* +* @name runCommand +* @memberof REPL.prototype +* @type {Function} +* @param {Object} exe - compiled executable +* @param {Object} opts - run options +* @returns {*} command result +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Process and compile a raw command: +* var cmd = '1 + 1'; +* var code = repl.processCommand( cmd ); +* var exe = repl.compileCommand( code ); +* +* // Run the compiled command: +* var out = repl.runCommand( exe, {} ); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'runCommand', function run( exe, opts ) { + if ( this._sandbox ) { + return exe.compiled.runInContext( this._context, opts ); + } + return exe.compiled.runInThisContext( opts ); +}); + /** * Generates completions for a given line. * diff --git a/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js b/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js index fa5f81dcbfb7..1016ce5acebd 100644 --- a/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js +++ b/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js @@ -311,11 +311,7 @@ setNonEnumerableReadOnly( EagerEvaluator.prototype, 'onKeypress', function onKey return; } try { - if ( this._repl._sandbox ) { - res = executable.compiled.runInContext( this._repl._context, ROPTS ); - } else { - res = executable.compiled.runInThisContext( ROPTS ); - } + res = this._repl.runCommand( executable, ROPTS ); } catch ( err ) { debug( 'Encountered an error when executing the command: %s', err.message ); return; diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js index b00dd3dc4928..cbbe34389d56 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/lib/main.js @@ -206,6 +206,9 @@ function REPL( options ) { setNonEnumerableReadOnly( this._internal.presentation, 'cache', {} ); setNonEnumerable( this._internal.presentation, 'counter', 0 ); + // Initialize an internal buffer for storing the current command: + setNonEnumerableReadOnly( this, '_cmd', [] ); + // Initialize a strided internal buffer for storing user-defined documentation: setNonEnumerableReadOnly( this, '_userdocs', [] ); From 0c27bb5da9dbed37ba32e5dab3c30e92aa4bce9f Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Fri, 21 Mar 2025 22:21:41 +0000 Subject: [PATCH 25/26] refactor: move `_history` and create accessor for count Signed-off-by: Snehil Shah --- 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: passed - 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 --- Signed-off-by: Snehil Shah --- .../@stdlib/repl/base/ctor/README.md | 49 ++++++----- .../@stdlib/repl/base/ctor/lib/main.js | 81 ++++++++++--------- .../@stdlib/repl/lib/display_prompt.js | 2 +- .../@stdlib/repl/lib/eager_evaluator.js | 2 +- lib/node_modules/@stdlib/repl/lib/log.js | 2 +- lib/node_modules/@stdlib/repl/lib/main.js | 41 +++++++++- 6 files changed, 115 insertions(+), 62 deletions(-) diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index a5cd81ee9640..2774ead27c8d 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -92,6 +92,36 @@ var ws = repl.currentWorkspace; repl.close(); ``` +#### REPL.prototype.quiet + +Boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Check if the REPL is quiet: +var out = repl.quiet; + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.count + +Command count. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Get command count: +var cnt = repl.count; + +// Close the REPL: +repl.close(); +``` + ### Methods #### REPL.prototype.isMultilineInput( input ) @@ -453,25 +483,6 @@ var d = repl.clearWorkspace( 'base' ); 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.reset() Resets a REPL. diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 7252bbfa4943..7df5af63cec5 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -155,9 +155,6 @@ function REPL( options ) { // Initialize an internal command queue: setNonEnumerableReadOnly( this, '_queue', fifo() ); - // Initialize a strided internal buffer for storing the command history: - setNonEnumerableReadOnly( this, '_history', [] ); - // Initialize a executed command counter: setNonEnumerable( this, '_count', -1 ); @@ -257,13 +254,10 @@ function REPL( options ) { * @param {*} res - result * @param {boolean} silent - boolean indicating whether the command output should be silenced */ - function onCommand( cmd, success ) { + function onCommand() { self._count += 1; debug( 'Command count: %d', self._count ); - // Update the internal command history buffer: [..., , , , ...] - self._history.push( self._count, cmd, success ); - // TODO: if successful and if necessary, (asynchronously?) write the command to a history file (question: do we only want to write successful commands to the history file? maybe we need to option for limiting to successful commands?) // TODO: if necessary, (asynchronously?) write the command and result to a log file (JSON serialization?) @@ -296,6 +290,48 @@ setReadOnlyAccessor( REPL.prototype, 'currentWorkspace', function get() { return this._currentWorkspace; }); +/** +* Boolean indicating whether log information, confirmation messages, and other possible REPL diagnostics should be silenced. +* +* @name quiet +* @memberof REPL.prototype +* @type {boolean} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Check if the REPL is quiet: +* var out = repl.quiet; +* +* // Close the REPL: +* repl.close(); +*/ +setReadOnlyAccessor( REPL.prototype, 'quiet', function get() { + return this._quiet; +}); + +/** +* Command count. +* +* @name count +* @memberof REPL.prototype +* @type {number} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Get command count: +* var cnt = repl.count; +* +* // Close the REPL: +* repl.close(); +*/ +setReadOnlyAccessor( REPL.prototype, 'count', function get() { + return this._count; +}); + /** * Checks if the given input is a possible multi-line command. * @@ -1328,34 +1364,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearWorkspace', function clearWorksp return d; }); -/** -* Clears a REPL's history. -* -* @name clearHistory -* @memberof REPL.prototype -* @type {Function} -* @returns {REPL} REPL instance -* -* @example -* // Create a new REPL: -* var repl = new REPL(); -* -* // ... -* -* // Clear the REPL history: -* repl.clearHistory(); -* -* // ... -* -* // Close the REPL: -* repl.close(); -*/ -setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory() { - debug( 'Resetting REPL history...' ); - this._history.length = 0; - return this; -}); - /** * Resets a REPL. * @@ -1388,9 +1396,6 @@ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { // Reset the command queue: this._queue.clear(); - // Clear the command history: - this.clearHistory(); - // Reset the execution context: this.resetContext(); diff --git a/lib/node_modules/@stdlib/repl/lib/display_prompt.js b/lib/node_modules/@stdlib/repl/lib/display_prompt.js index 344cede3bbf7..69bbb323d6e6 100644 --- a/lib/node_modules/@stdlib/repl/lib/display_prompt.js +++ b/lib/node_modules/@stdlib/repl/lib/display_prompt.js @@ -47,7 +47,7 @@ function displayPrompt( repl, preserveCursor ) { } len = repl._cmd.length; if ( len === 0 ) { - if ( repl._padding && repl._count >= 0 ) { + if ( repl._padding && repl.count >= 0 ) { repl._ostream.write( repeat( '\n', repl._padding ) ); } repl._rli.setPrompt( repl._prompt() ); diff --git a/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js b/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js index 1016ce5acebd..fdc84445387d 100644 --- a/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js +++ b/lib/node_modules/@stdlib/repl/lib/eager_evaluator.js @@ -323,7 +323,7 @@ setNonEnumerableReadOnly( EagerEvaluator.prototype, 'onKeypress', function onKey res = res.slice( 0, index ) + '...'; } cursorPosition = this._rli.cursor; - pre = replace( this._repl._outputPrompt, '%d', ( this._repl._count+1 ).toString() ); + pre = replace( this._repl._outputPrompt, '%d', ( this._repl.count+1 ).toString() ); this._repl._ostream.write( '\n' + ANSI_GRAY + pre + res + ANSI_RESET ); readline.moveCursor( this._repl._ostream, 0, -1 ); readline.cursorTo( this._repl._ostream, cursorPosition + this._repl.promptLength() ); diff --git a/lib/node_modules/@stdlib/repl/lib/log.js b/lib/node_modules/@stdlib/repl/lib/log.js index 1ae2f532f99b..21cbe25ce325 100644 --- a/lib/node_modules/@stdlib/repl/lib/log.js +++ b/lib/node_modules/@stdlib/repl/lib/log.js @@ -34,7 +34,7 @@ * @param {string} msg - message */ function log( repl, msg ) { - if ( repl._quiet === false ) { + if ( repl.quiet === false ) { repl._ostream.write( msg+'\n' ); } } diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js index cbbe34389d56..f91006bba3ba 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/lib/main.js @@ -209,6 +209,9 @@ function REPL( options ) { // Initialize an internal buffer for storing the current command: setNonEnumerableReadOnly( this, '_cmd', [] ); + // Initialize a strided internal buffer for storing the command history: + setNonEnumerableReadOnly( this, '_history', [] ); + // Initialize a strided internal buffer for storing user-defined documentation: setNonEnumerableReadOnly( this, '_userdocs', [] ); @@ -469,10 +472,13 @@ function REPL( options ) { var pre; var tmp; + // Update the internal command history buffer: [..., , , , ...] + self._history.push( self.count, cmd, success ); + if ( success === false ) { self._ostream.write( 'Error: '+res.message+'\n' ); } else if ( !silent && res !== void 0 ) { - pre = replace( self._outputPrompt, '%d', self._count.toString() ); + pre = replace( self._outputPrompt, '%d', self.count.toString() ); if ( isndarrayLike( res ) ) { tmp = res.toString(); // FIXME: this is a hack in order to avoid printing private ndarray properties in the REPL, as done by the built-in `util.inspect`. Ideally, we'd roll our own inspector which specifically accommodates stdlib's ndarray and other specialized classes. @@ -521,7 +527,7 @@ setNonEnumerableReadOnly( REPL.prototype, '_displayPrompt', function showPrompt( * @returns {string} command prompt */ setNonEnumerableReadOnly( REPL.prototype, '_prompt', function prompt() { - return inputPrompt( this._inputPrompt, this._count ); + return inputPrompt( this._inputPrompt, this.count ); }); /** @@ -1094,6 +1100,9 @@ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { // Call the parent method: BaseREPL.prototype.reset.call( this ); + // Clear the command history: + this.clearHistory(); + // Clear any command which has been buffered but not yet executed: this.clearCommand(); @@ -1134,6 +1143,34 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearUserDocs', function clearUserDoc return this; }); +/** +* Clears a REPL's history. +* +* @name clearHistory +* @memberof REPL.prototype +* @type {Function} +* @returns {REPL} REPL instance +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // ... +* +* // Clear the REPL history: +* repl.clearHistory(); +* +* // ... +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory() { + debug( 'Resetting REPL history...' ); + this._history.length = 0; + return this; +}); + /** * Clears the entire REPL screen and scrollback history. * From d02e494c89c3f3a8487f9ec29916a26c57b52acb Mon Sep 17 00:00:00 2001 From: Snehil Shah Date: Sat, 29 Mar 2025 14:35:07 +0000 Subject: [PATCH 26/26] refactor: abstract alias resolution Signed-off-by: Snehil Shah --- 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: passed - 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 --- --- .../@stdlib/repl/base/ctor/README.md | 111 ++++++++++ .../{ => base/ctor}/lib/find_unique_entry.js | 0 .../@stdlib/repl/base/ctor/lib/index_of.js | 60 ++++++ .../@stdlib/repl/base/ctor/lib/main.js | 200 ++++++++++++++++++ .../@stdlib/repl/lib/commands/alias2pkg.js | 20 +- .../repl/lib/commands/alias2related.js | 19 +- .../@stdlib/repl/lib/commands/ans.js | 4 +- .../@stdlib/repl/lib/commands/example.js | 48 ++--- .../@stdlib/repl/lib/commands/help.js | 47 ++-- .../@stdlib/repl/lib/commands/info.js | 48 ++--- .../repl/lib/commands/presentation_start.js | 4 - .../repl/lib/commands/presentation_stop.js | 4 - lib/node_modules/@stdlib/repl/lib/main.js | 18 +- 13 files changed, 441 insertions(+), 142 deletions(-) rename lib/node_modules/@stdlib/repl/{ => base/ctor}/lib/find_unique_entry.js (100%) create mode 100644 lib/node_modules/@stdlib/repl/base/ctor/lib/index_of.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/README.md b/lib/node_modules/@stdlib/repl/base/ctor/README.md index 2774ead27c8d..9458a0bfcdc8 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/README.md +++ b/lib/node_modules/@stdlib/repl/base/ctor/README.md @@ -107,6 +107,24 @@ var out = repl.quiet; repl.close(); ``` +#### REPL.prototype.closed + +Boolean indicating whether the REPL is closed. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Check if the REPL is closed: +var out = repl.closed; + +// Close the REPL: +repl.close(); + +// Check if the REPL was closed: +out = repl.closed; +``` + #### REPL.prototype.count Command count. @@ -122,6 +140,24 @@ var cnt = repl.count; repl.close(); ``` +#### REPL.prototype.ans + +Result of the last successfully evaluated command. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Execute a command: +repl.emit( 'input', '2 + 3' ); + +// Get the cached result: +var res = repl.ans; + +// Close the REPL: +repl.close(); +``` + ### Methods #### REPL.prototype.isMultilineInput( input ) @@ -234,6 +270,81 @@ var out = repl.tokenizer( line ); repl.close(); ``` +#### REPL.prototype.resolveContextVarByName( name ) + +Resolves the value of a context variable for a given alias name. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Create a new REPL context: +var ctx = repl.createContext({ + 'a': 5, + 'b': 10 +}); + +// Resolve a context variable by name: +var out = repl.resolveContextVarByName( 'a' ); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.resolveContextVarByRef( ref ) + +Resolves the name of the context variable for a given reference. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Create a new REPL context: +var obj = {}; +var ctx = repl.createContext({ + 'a': obj +}); + +// Resolve a context variable by reference: +var out = repl.resolveContextVarByRef( obj ); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.resolveAliasByRef( ref ) + +Resolves the name of an alias for a given reference. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Resolve alias by reference to the actual alias in context: +var alias = repl.resolveAliasByRef({}); + +// Close the REPL: +repl.close(); +``` + +#### REPL.prototype.resolveAliasByProp( ref ) + +Resolves the name of an alias for a given property reference. + +```javascript +// Create a new REPL: +var repl = new REPL(); + +// Create a new REPL context: +var ctx = repl.createContext(); + +// Resolve alias by reference to the actual alias in context: +var alias = repl.resolveAliasByRef({}); + +// Close the REPL: +repl.close(); +``` + #### REPL.prototype.createContext() Returns a REPL context. diff --git a/lib/node_modules/@stdlib/repl/lib/find_unique_entry.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/find_unique_entry.js similarity index 100% rename from lib/node_modules/@stdlib/repl/lib/find_unique_entry.js rename to lib/node_modules/@stdlib/repl/base/ctor/lib/find_unique_entry.js diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/index_of.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/index_of.js new file mode 100644 index 000000000000..a68e866ca3e2 --- /dev/null +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/index_of.js @@ -0,0 +1,60 @@ +/** +* @license Apache-2.0 +* +* Copyright (c) 2019 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 the index of a search value in a strided array-like object. +* +* @private +* @param {NonNegativeInteger} N - number of elements to search +* @param {ArrayLike} arr - array to search +* @param {integer} stride - index stride +* @param {NonNegativeInteger} offset - index offset +* @param {*} value - search value +* @returns {integer} search value index +* +* @example +* var arr = [ 1, 2, 3 ]; +* +* var bool = indexOf( arr.length, arr, 1, 0, 2 ); +* // returns 1 +* +* bool = indexOf( arr.length, arr, 1, 0, 4 ); +* // returns -1 +*/ +function indexOf( N, arr, stride, offset, value ) { + var idx; + var i; + + idx = offset; + for ( i = 0; i < N; i++ ) { + if ( arr[ idx ] === value ) { + return idx; + } + idx += stride; + } + return -1; +} + + +// EXPORTS // + +module.exports = indexOf; diff --git a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js index 7df5af63cec5..a0ddb615d5bb 100644 --- a/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js +++ b/lib/node_modules/@stdlib/repl/base/ctor/lib/main.js @@ -48,6 +48,8 @@ var isRegExp = require( '@stdlib/assert/is-regexp' ); var format = require( '@stdlib/string/format' ); var fifo = require( '@stdlib/dstructs/fifo' ); var nextTick = require( '@stdlib/utils/next-tick' ); +var indexOf = require( './index_of.js' ); +var findUniqueEntry = require( './find_unique_entry.js' ); var validate = require( './validate.js' ); var defaults = require( './defaults.js' ); var setAliases = require( './set_aliases.js' ); @@ -311,6 +313,30 @@ setReadOnlyAccessor( REPL.prototype, 'quiet', function get() { return this._quiet; }); +/** +* Boolean indicating whether the REPL is closed. +* +* @name closed +* @memberof REPL.prototype +* @type {boolean} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Check if the REPL is closed: +* var out = repl.closed; +* +* // Close the REPL: +* repl.close(); +* +* // Check if the REPL was closed: +* out = repl.closed; +*/ +setReadOnlyAccessor( REPL.prototype, 'closed', function get() { + return this._closed; +}); + /** * Command count. * @@ -332,6 +358,30 @@ setReadOnlyAccessor( REPL.prototype, 'count', function get() { return this._count; }); +/** +* Result of the last successfully evaluated command. +* +* @name ans +* @memberof REPL.prototype +* @type {*} +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Execute a command: +* repl.emit( 'input', '2 + 3' ); +* +* // Get the cached result: +* var res = repl.ans; +* +* // Close the REPL: +* repl.close(); +*/ +setReadOnlyAccessor( REPL.prototype, 'ans', function get() { + return this._ans; +}); + /** * Checks if the given input is a possible multi-line command. * @@ -419,6 +469,10 @@ setNonEnumerableReadOnly( REPL.prototype, 'compileCommand', function compile( cm /** * Runs a compiled command. * +* ## Note +* +* - This runs the command outside of the current REPL session's flow meaning it doesn't affect the REPL's command history or count. +* * @name runCommand * @memberof REPL.prototype * @type {Function} @@ -513,6 +567,152 @@ setNonEnumerableReadOnly( REPL.prototype, 'tokenizer', function tokenizer( line return this._tokenizer( line ); }); +/** +* Resolves the value of a context variable for a given alias name. +* +* @name resolveContextVarByName +* @memberof REPL.prototype +* @type {Function} +* @param {string} name - variable name +* @returns {*} resolved value +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Create a new REPL context: +* var ctx = repl.createContext({ +* 'a': 5, +* 'b': 10 +* }); +* +* // Resolve a context variable by name: +* var name = 'a'; +* var out = repl.resolveContextVarByName( 'a' ); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'resolveContextVarByName', function resolve( name ) { + var i; + + if ( !isString( name ) ) { + throw new TypeError( format( 'invalid argument. First argument must be a string. Value: `%s`.', name ) ); + } + indexOf( this._contextVars.length, this._contextVars, 2, 0, name ); + if ( i < 0 ) { + return void 0; + } + return this._contextVars[ i+1 ]; +}); + +/** +* Resolves the name of the context variable for a given reference. +* +* @name resolveContextVarByRef +* @memberof REPL.prototype +* @type {Function} +* @param {*} ref - variable reference +* @returns {(string|undefined)} variable name +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Create a new REPL context: +* var obj = {}; +* var ctx = repl.createContext({ +* 'a': obj +* }); +* +* // Resolve a context variable by reference: +* var out = repl.resolveContextVarByRef( obj ); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'resolveContextVarByRef', function resolve( ref ) { + var i; + + // Address the fact that the `global` object is proxied (see https://github.com/nodejs/node/issues/855) + if ( + ref !== null && + typeof ref === 'object' && + hasOwnProp( ref, 'global' ) && + ref.global === ref + ) { + i = indexOf( this._contextVars.length, this._contextVars, 2, 1, this._context.global ); // eslint-disable-line max-len + } else { + i = indexOf( this._contextVars.length, this._contextVars, 2, 1, ref ); + } + if ( i < 0 ) { + return void 0; + } + return this._contextVars[ i-1 ]; +}); + +/** +* Resolves the name of an alias for a given reference. +* +* @name resolveAliasByRef +* @memberof REPL.prototype +* @type {Function} +* @param {*} ref - alias reference +* @returns {(string|undefined)} variable name +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Create a new REPL context: +* var ctx = repl.createContext(); +* +* // Resolve alias by reference to the actual alias in context: +* var alias = repl.resolveAliasByRef({}); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'resolveAliasByRef', function resolve( ref ) { + var i = indexOf( this._aliases.length/2, this._aliases, 2, 1, ref ); + if ( i < 0 ) { + return void 0; + } + return this._aliases[ i-1 ]; +}); + +/** +* Resolves the name of an alias for a given property reference. +* +* @name resolveAliasByProp +* @memberof REPL.prototype +* @type {Function} +* @param {*} ref - property reference +* @returns {(string|undefined)} variable name +* +* @example +* // Create a new REPL: +* var repl = new REPL(); +* +* // Create a new REPL context: +* var ctx = repl.createContext(); +* +* // Resolve alias by reference to the actual alias in context: +* var alias = repl.resolveAliasByRef({}); +* +* // Close the REPL: +* repl.close(); +*/ +setNonEnumerableReadOnly( REPL.prototype, 'resolveAliasByProp', function resolve( ref ) { + var entry; + + entry = findUniqueEntry( this._aliases.length/2, this._aliases, 2, 1, ref ); + if ( entry === null ) { + return void 0; + } + return this._aliases[ entry[2]-1 ]+'.'+entry[ 1 ]; +}); + /** * Creates a REPL context. * diff --git a/lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js b/lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js index 31214a58df9e..a4709750053f 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/alias2pkg.js @@ -24,7 +24,6 @@ var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var alias2pkg = require( '@stdlib/namespace/alias2pkg' ); -var indexOf = require( './../index_of.js' ); var alias2string = require( './../alias_to_string.js' ); @@ -48,29 +47,24 @@ function command( repl ) { * @returns {(string|void)} package name */ function onCommand( alias ) { - var aliases; var out; - var N; - var i; - - aliases = repl._aliases; - N = aliases.length; + var o; if ( isString( alias ) ) { out = alias2pkg( alias ); } // If provided an `alias` which is not a string or we failed to resolve a package name based on the provided string value, we try to resolve a string alias (and subsequently a corresponding package name) by searching the list of cached references of global variables/properties... if ( !out ) { - i = indexOf( N/2, aliases, 2, 1, alias ); - if ( i >= 0 ) { - out = alias2pkg( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias ); + if ( o !== void 0 ) { + out = alias2pkg( o ); } } // If we failed to resolve a package name and the provided value is an object, try finding a provided value's constructor (e.g., if provided a `Uint32Array`, try finding the package name for `Uint32Array`)... if ( !out && typeof alias === 'object' && alias !== null && alias.constructor ) { - i = indexOf( N/2, aliases, 2, 1, alias.constructor ); - if ( i >= 0 ) { - out = alias2pkg( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias.constructor ); + if ( o !== void 0 ) { + out = alias2pkg( o ); } } if ( out ) { diff --git a/lib/node_modules/@stdlib/repl/lib/commands/alias2related.js b/lib/node_modules/@stdlib/repl/lib/commands/alias2related.js index 5050935ac41d..c2e881698b2b 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/alias2related.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/alias2related.js @@ -24,7 +24,6 @@ var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var alias2related = require( '@stdlib/namespace/alias2related' ); -var indexOf = require( './../index_of.js' ); var alias2string = require( './../alias_to_string.js' ); @@ -49,13 +48,9 @@ function command( repl, cmds ) { * @returns {(StringArray|void)} related packages as a newline-delimited list */ function onCommand( alias ) { - var aliases; var out; - var N; var i; - - aliases = repl._aliases; - N = aliases.length; + var o; if ( isString( alias ) ) { out = alias2related( alias ); @@ -70,16 +65,16 @@ function command( repl, cmds ) { } // If provided an `alias` which is not a string or we failed to resolve related aliases based on the provided string value, we try to resolve a string alias (and subsequently related aliases) by searching the list of cached references of global variables/properties... if ( !out ) { - i = indexOf( N/2, aliases, 2, 1, alias ); - if ( i >= 0 ) { - out = alias2related( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias ); + if ( o !== void 0 ) { + out = alias2related( o ); } } // If we failed to resolve related aliases and the provided value is an object, try finding a provided value's constructor (e.g., if provided a `Uint32Array`, try finding related aliases for `Uint32Array`)... if ( !out && typeof alias === 'object' && alias !== null && alias.constructor ) { - i = indexOf( N/2, aliases, 2, 1, alias.constructor ); - if ( i >= 0 ) { - out = alias2related( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias.constructor ); + if ( o !== void 0 ) { + out = alias2related( o ); } } if ( out === void 0 || out === null ) { diff --git a/lib/node_modules/@stdlib/repl/lib/commands/ans.js b/lib/node_modules/@stdlib/repl/lib/commands/ans.js index 494cd9c67fc3..fb4c6ae989fc 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/ans.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/ans.js @@ -16,8 +16,6 @@ * limitations under the License. */ -/* eslint-disable no-underscore-dangle */ - 'use strict'; // MAIN // @@ -39,7 +37,7 @@ function command( repl ) { * @returns {*} result */ function onCommand() { - return repl._ans; + return repl.ans; } } diff --git a/lib/node_modules/@stdlib/repl/lib/commands/example.js b/lib/node_modules/@stdlib/repl/lib/commands/example.js index 0a07f5b19ae3..2e20c3d837c7 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/example.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/example.js @@ -24,12 +24,9 @@ var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isFunction = require( '@stdlib/assert/is-function' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var alias2example = require( '@stdlib/repl/code-blocks' ); var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP; var nextTick = require( '@stdlib/utils/next-tick' ); -var indexOf = require( './../index_of.js' ); -var findUniqueEntry = require( './../find_unique_entry.js' ); var alias2string = require( './../alias_to_string.js' ); var DOCS = require( './../repl_docs.js' ); @@ -55,16 +52,11 @@ function command( repl, cmds ) { * @returns {void} */ function onCommand( alias ) { - var aliases; - var entry; var lines; var out; var len; - var N; var i; - - aliases = repl._aliases; - N = aliases.length; + var o; if ( isString( alias ) ) { // Command docs supersede project namespace docs... @@ -74,8 +66,8 @@ function command( repl, cmds ) { } } if ( !out ) { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 0, alias ); // eslint-disable-line max-len - if ( i >= 0 ) { + o = repl.resolveContextVarByName( alias ); + if ( o !== void 0 ) { out = DOCS.example[ alias ]; } } @@ -94,43 +86,33 @@ function command( repl, cmds ) { } // Check if we were provided a reference to a global context variable... if ( !out ) { - // Address the fact that the `global` object is proxied (see https://github.com/nodejs/node/issues/855) - if ( - alias !== null && - typeof alias === 'object' && - hasOwnProp( alias, 'global' ) && - alias.global === alias - ) { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 1, repl._context.global ); // eslint-disable-line max-len - } else { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 1, alias ); // eslint-disable-line max-len - } - if ( i >= 0 ) { - out = DOCS.example[ repl._contextVars[ i-1 ] ]; + o = repl.resolveContextVarByRef( alias ); + if ( o !== void 0 ) { + out = DOCS.example[ o ]; } } // If provided an `alias` which is not a string or we failed to resolve an associated example based on the provided value, we try to resolve a string alias (and subsequently a corresponding example) by searching the list of cached references of global variables/properties... if ( !out ) { - i = indexOf( N/2, aliases, 2, 1, alias ); - if ( i >= 0 ) { - out = alias2example( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias ); + if ( o !== void 0 ) { + out = alias2example( o ); } } // TODO: add support for searching user documentation // If we failed to resolve an associated example and the provided value is an object, try finding a provided value's constructor (e.g., if provided a `Uint32Array`, try finding examples for `Uint32Array`)... if ( !out && typeof alias === 'object' && alias !== null && alias.constructor ) { - i = indexOf( N/2, aliases, 2, 1, alias.constructor ); - if ( i >= 0 ) { - out = alias2example( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias.constructor ); + if ( o !== void 0 ) { + out = alias2example( o ); } } // If we failed to resolve an associated example and the provided value is a function, try finding method examples... if ( !out && isFunction( alias ) ) { // Note: the following is an **expensive** look-up!! - entry = findUniqueEntry( N/2, aliases, 2, 1, alias ); - if ( entry ) { - out = alias2example( aliases[ entry[2]-1 ]+'.'+entry[ 1 ] ); + o = repl.resolveAliasByProp( alias ); + if ( o !== void 0 ) { + out = alias2example( o ); } } if ( out ) { diff --git a/lib/node_modules/@stdlib/repl/lib/commands/help.js b/lib/node_modules/@stdlib/repl/lib/commands/help.js index cf849a33b582..1cf9be9dfca6 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/help.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/help.js @@ -24,10 +24,8 @@ var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isFunction = require( '@stdlib/assert/is-function' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var alias2help = require( '@stdlib/repl/help' ); var indexOf = require( './../index_of.js' ); -var findUniqueEntry = require( './../find_unique_entry.js' ); var alias2string = require( './../alias_to_string.js' ); var HELP_TEXT = require( './../help_text.js' ); var DOCS = require( './../repl_docs.js' ); @@ -54,17 +52,14 @@ function command( repl, cmds ) { * @returns {void} */ function onCommand( alias ) { - var aliases; - var entry; var out; - var N; var i; + var o; + if ( arguments.length === 0 ) { repl._ostream.write( HELP_TEXT ); return; } - aliases = repl._aliases; - N = aliases.length; if ( isString( alias ) ) { // Command docs supersede project namespace docs... @@ -74,8 +69,8 @@ function command( repl, cmds ) { } } if ( !out ) { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 0, alias ); // eslint-disable-line max-len - if ( i >= 0 ) { + o = repl.resolveContextVarByName( alias ); + if ( o !== void 0 ) { out = DOCS.help[ alias ]; } } @@ -100,26 +95,16 @@ function command( repl, cmds ) { } // Check if we were provided a reference to a global context variable... if ( !out ) { - // Address the fact that the `global` object is proxied (see https://github.com/nodejs/node/issues/855) - if ( - alias !== null && - typeof alias === 'object' && - hasOwnProp( alias, 'global' ) && - alias.global === alias - ) { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 1, repl._context.global ); // eslint-disable-line max-len - } else { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 1, alias ); // eslint-disable-line max-len - } - if ( i >= 0 ) { - out = DOCS.help[ repl._contextVars[ i-1 ] ]; + o = repl.resolveContextVarByRef( alias ); + if ( o !== void 0 ) { + out = DOCS.help[ o ]; } } // If provided an `alias` which is not a string or we failed to resolve a help text based on the provided string value, we try to resolve a string alias (and subsequently a corresponding help text) by searching the list of cached references of global variables/properties... if ( !out ) { - i = indexOf( N/2, aliases, 2, 1, alias ); - if ( i >= 0 ) { - out = alias2help( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias ); + if ( o !== void 0 ) { + out = alias2help( o ); } } // Try searching user-defined documentation for a matching object reference... @@ -131,17 +116,17 @@ function command( repl, cmds ) { } // If we failed to resolve help text and the provided value is an object, try finding a provided value's constructor (e.g., if provided a `Uint32Array`, try finding the documentation for `Uint32Array`)... if ( !out && typeof alias === 'object' && alias !== null && alias.constructor ) { - i = indexOf( N/2, aliases, 2, 1, alias.constructor ); - if ( i >= 0 ) { - out = alias2help( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias.constructor ); + if ( o !== void 0 ) { + out = alias2help( o ); } } // If we failed to resolve help text and the provided value is a function, try finding method documentation (note: we cannot perform a full inherited property search as prototype methods can be shared among multiple constructors, and, based on a reference alone, we cannot determine the appropriate document context; e.g., typed array methods all belong to an ancestor constructor `TypedArray` and we cannot tell, for example, whether a reference to `forEach` should return the documentation for `Uint32Array.prototype.forEach` or `Int32Array.prototype.forEach` or any of the other typed array constructors)... if ( !out && isFunction( alias ) ) { // Note: the following is an **expensive** look-up!! Why unique? In order to avoid document conflicts/"race conditions" between two or more context variables having own properties pointing to the same function reference (e.g., PRNGs having a `PRNG` property whose value is shared among multiple PRNGs; which `PRNG` property documentation do we return?). - entry = findUniqueEntry( N/2, aliases, 2, 1, alias ); - if ( entry ) { - out = alias2help( aliases[ entry[2]-1 ]+'.'+entry[ 1 ] ); + o = repl.resolveAliasByProp( alias ); + if ( o !== void 0 ) { + out = alias2help( o ); } } if ( out ) { diff --git a/lib/node_modules/@stdlib/repl/lib/commands/info.js b/lib/node_modules/@stdlib/repl/lib/commands/info.js index 73ba181bc982..768254f9484d 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/info.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/info.js @@ -24,10 +24,7 @@ var isString = require( '@stdlib/assert/is-string' ).isPrimitive; var isFunction = require( '@stdlib/assert/is-function' ); -var hasOwnProp = require( '@stdlib/assert/has-own-property' ); var alias2info = require( '@stdlib/repl/info' ); -var indexOf = require( './../index_of.js' ); -var findUniqueEntry = require( './../find_unique_entry.js' ); var alias2string = require( './../alias_to_string.js' ); var DOCS = require( './../repl_docs.js' ); @@ -53,14 +50,9 @@ function command( repl, cmds ) { * @returns {void} */ function onCommand( alias ) { - var aliases; - var entry; var out; - var N; var i; - - aliases = repl._aliases; - N = aliases.length; + var o; if ( isString( alias ) ) { // Command docs supersede project namespace docs... @@ -70,8 +62,8 @@ function command( repl, cmds ) { } } if ( !out ) { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 0, alias ); // eslint-disable-line max-len - if ( i >= 0 ) { + o = repl.resolveContextVarByName( alias ); + if ( o !== void 0 ) { out = DOCS.info[ alias ]; } } @@ -90,43 +82,33 @@ function command( repl, cmds ) { } // Check if we were provided a reference to a global context variable... if ( !out ) { - // Address the fact that the `global` object is proxied (see https://github.com/nodejs/node/issues/855) - if ( - alias !== null && - typeof alias === 'object' && - hasOwnProp( alias, 'global' ) && - alias.global === alias - ) { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 1, repl._context.global ); // eslint-disable-line max-len - } else { - i = indexOf( repl._contextVars.length, repl._contextVars, 2, 1, alias ); // eslint-disable-line max-len - } - if ( i >= 0 ) { - out = DOCS.info[ repl._contextVars[ i-1 ] ]; + o = repl.resolveContextVarByRef( alias ); + if ( o !== void 0 ) { + out = DOCS.info[ o ]; } } // If provided an `alias` which is not a string or we failed to resolve an abbreviated help text based on the provided string value, we try to resolve a string alias (and subsequently a corresponding abbreviated help text) by searching the list of cached references of global variables/properties... if ( !out ) { - i = indexOf( N/2, aliases, 2, 1, alias ); - if ( i >= 0 ) { - out = alias2info( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias ); + if ( o !== void 0 ) { + out = alias2info( o ); } } // TODO: add support for user-defined documentation // If we failed to resolve abbreviated help text and the provided value is an object, try finding a provided value's constructor (e.g., if provided a `Uint32Array`, try finding the documentation for `Uint32Array`)... if ( !out && typeof alias === 'object' && alias !== null && alias.constructor ) { - i = indexOf( N/2, aliases, 2, 1, alias.constructor ); - if ( i >= 0 ) { - out = alias2info( aliases[ i-1 ] ); + o = repl.resolveAliasByRef( alias.constructor ); + if ( o !== void 0 ) { + out = alias2info( o ); } } // If we failed to resolve abbreviated help text and the provided value is a function, try finding method abbreviated documentation... if ( !out && isFunction( alias ) ) { // Note: the following is an **expensive** look-up!! - entry = findUniqueEntry( N/2, aliases, 2, 1, alias ); - if ( entry ) { - out = alias2info( aliases[ entry[2]-1 ]+'.'+entry[ 1 ] ); + o = repl.resolveAliasByProp( alias ); + if ( o !== void 0 ) { + out = alias2info( o ); } } if ( out ) { diff --git a/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js b/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js index 30e32e82cb24..b4c9965f9eaa 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/presentation_start.js @@ -64,7 +64,6 @@ function command( repl ) { */ function onCommand( text, options ) { var opts; - var FLG; var err; var ctx; var ws; @@ -141,10 +140,7 @@ function command( repl ) { // If the destination workspace already exists, we need to delete that workspace in order to allow presentation commands to be properly bound... if ( ws !== 'base' && contains( repl.workspaces(), ws ) ) { debug( 'Deleting workspace: %s', ws ); - FLG = repl._quiet; - repl._quiet = true; // temporarily silence logging repl.deleteWorkspace( ws ); - repl._quiet = FLG; } // Create a new presentation... debug( 'Creating presentation...' ); diff --git a/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js b/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js index 18e22032b1a1..ad20a05c3aca 100644 --- a/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js +++ b/lib/node_modules/@stdlib/repl/lib/commands/presentation_stop.js @@ -57,7 +57,6 @@ function command( repl ) { function onCommand( id ) { var cache; var keys; - var FLG; var err; var key; var ws; @@ -101,10 +100,7 @@ function command( repl ) { // Delete the presentation workspace... if ( o.w !== 'base' ) { debug( 'Deleting workspace: %s', o.w ); - FLG = repl._quiet; - repl._quiet = true; // temporarily silence logging repl.deleteWorkspace( o.w ); - repl._quiet = FLG; } // Ensure that we no longer watch presentation files (if enabled): o.p.unwatch(); diff --git a/lib/node_modules/@stdlib/repl/lib/main.js b/lib/node_modules/@stdlib/repl/lib/main.js index f91006bba3ba..52e34b525d65 100644 --- a/lib/node_modules/@stdlib/repl/lib/main.js +++ b/lib/node_modules/@stdlib/repl/lib/main.js @@ -380,7 +380,7 @@ function REPL( options ) { */ function onLine( line ) { self._SIGINT = false; // reset flag - if ( self._closed === false ) { + if ( self.closed === false ) { self._multilineHandler.processLine( line ); } } @@ -487,7 +487,7 @@ function REPL( options ) { } self._ostream.write( pre+inspect( tmp )+'\n' ); } - if ( !self._closed ) { + if ( !self.closed ) { displayPrompt( self, false ); } @@ -1008,7 +1008,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { var file; var len; var i; - if ( this._closed ) { + if ( this.closed ) { throw new Error( 'invalid operation. Cannot load a file into a REPL which has already closed.' ); } if ( !isString( fpath ) ) { @@ -1092,7 +1092,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'load', function load( fpath, clbk ) { * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'reset', function onReset() { - if ( this._closed ) { + if ( this.closed ) { throw new Error( 'invalid operation. Cannot reset a REPL which has already closed.' ); } debug( 'Resetting REPL...' ); @@ -1203,7 +1203,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearHistory', function clearHistory( * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'clear', function onClear() { - if ( this._closed ) { + if ( this.closed ) { throw new Error( 'invalid operation. Cannot clear a REPL which has already closed.' ); } if ( this._isTTY ) { @@ -1254,7 +1254,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'clear', function onClear() { * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'clearLine', function onClearLine() { - if ( this._closed ) { + if ( this.closed ) { throw new Error( 'invalid operation. Cannot clear the line of a REPL which has already closed.' ); } if ( this._isTTY ) { @@ -1291,7 +1291,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearLine', function onClearLine() { * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'clearCommand', function onClearCommand() { - if ( this._closed ) { + if ( this.closed ) { throw new Error( 'invalid operation. Cannot clear the command buffer of a REPL which has already closed.' ); } // Clear any command which has been buffered but not yet executed: @@ -1322,7 +1322,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'clearCommand', function onClearComman * repl.close(); */ setNonEnumerableReadOnly( REPL.prototype, 'close', function close() { - if ( this._closed ) { + if ( this.closed ) { debug( 'Attempted to close an already closed REPL.' ); return this; } @@ -1373,7 +1373,7 @@ setNonEnumerableReadOnly( REPL.prototype, 'settings', function settings() { var name; var f; - if ( this._closed ) { + if ( this.closed ) { throw new Error( 'invalid operation. Cannot access settings for a REPL which has already closed.' ); } nargs = arguments.length;