stdlib icon indicating copy to clipboard operation
stdlib copied to clipboard

[RFC]: support auto-completion and completion previews after function executions in the REPL

Open kgryte opened this issue 1 year ago • 0 comments

Description

This RFC proposes adding support for auto-completion and completion previews after function executions in the REPL. The idea is that, for side-effect commands, we could eagerly evaluate and support TAB completion and the display of potential completions. E.g., consider

In [1]: [ 'foo', 'bar', 'beep' ].sort().fil<|>

where <|> is the cursor. In this example, after eager evaluation, we know that sort() returns the input array and thus we should be able to auto-complete filter.

One possibility which may not rely on eager evaluation for implementing this RFC is to take advantage of take advantage of our signature database (see https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/repl/signature), where we statically know output values. If a function/method returns a value having a specific type, we can then auto-complete based on the known properties/methods of that type.

Eager evaluation, however, would allow for result previews of chained commands and would also the need to analyze complex static AST graphs.

Related Issues

  • Implementing this RFC is dependent on https://github.com/stdlib-js/stdlib/issues/2073.
  • Completion previews: https://github.com/stdlib-js/stdlib/issues/1775

Questions

No.

Other

  • https://developer.chrome.com/blog/new-in-devtools-68/#eagerevaluation

Checklist

  • [X] I have read and understood the Code of Conduct.
  • [X] Searched for existing issues and pull requests.
  • [X] The issue name begins with RFC:.

kgryte avatar Mar 27 '24 09:03 kgryte