stdlib-js / stdlib-js/stdlib

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

Abierto
#2,074 0 comentarios 0 reacciones 0 asignados Ver en GitHub
difficulty: 5 Enhancement JavaScript Needs Discussion priority: Normal REPL RFC
Lenguaje dominante
JavaScript
Estrellas
6k
Forks
1.3k
Merge medio
1 d 3 h
PR fusionados (30 d)
611

Descripción

### 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](https://github.com/stdlib-js/stdlib/blob/develop/CODE_OF_CONDUCT.md).
- [X] Searched for existing issues and pull requests.
- [X] The issue name begins with `RFC:`.

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.