repl

Returns true if all brackets ((), [], {}) and string quotes (', ") in input are properly balanced and closed. Use this to decide whether a user's input is complete before executing it.

use plugin repl::{is_balanced}

print(is_balanced("(a + b)"))         // true
print(is_balanced("(a + b"))          // false
print(is_balanced('{"key": "val"}'))  // true

Given a string and a position of an opening or closing bracket, returns the position of the paired bracket. Returns nil if no match is found or pos is not a bracket character.

use plugin repl::{find_matching_bracket}

let src = "(hello (world))"
let close = find_matching_bracket(src, 0)
print(close)  // 14

Returns a table of all bracket characters found in input. Each entry has pos (byte offset), depth (nesting level), and char (the bracket character).

use plugin repl::{highlight_brackets}

let info = highlight_brackets("fn(a, [b, c])")
for _, b in info {
  print("{b["char"]} at {b["pos"]} depth {b["depth"]}")
}

Removes ANSI escape sequences (color codes, cursor movement, etc.) from a string. Useful when storing or processing terminal output.

use plugin repl::{strip_ansi}

let clean = strip_ansi("\x1b[31mError:\x1b[0m file not found")
print(clean)  // Error: file not found

Word-wraps text to at most width characters per line, splitting on whitespace boundaries. Preserves existing newlines.

use plugin repl::{wrap_text}

let msg = "This is a very long description that should be wrapped at a reasonable column width for terminal display."
print(wrap_text(msg, 40))

Returns the longest common prefix shared by all strings in the table. Useful for tab-completion suggestions.

use plugin repl::{common_prefix}

let candidates = ["print", "println", "printf"]
print(common_prefix(candidates))  // "print"

Creates a new command history instance. History entries are stored in insertion order with 1-based indexing.

use plugin repl::{History}

let hist = History()
hist.add("let x = 42")
hist.add("print(x)")
print(hist.count())  // 2

Appends a line string to the end of the history.

hist.add("use plugin json::{parse}")

Returns the history entry at the given 1-based index, or nil if the index is out of range.

print(hist.get(1))  // first entry

Returns all history entries that contain query as a substring. Results are re-indexed from 1.

let results = hist.search("plugin")
for _, entry in results {
  print(entry)
}

Returns the number of entries currently in the history.

print("{hist.count()} commands in history")

Returns the most recently added entry, or nil if history is empty.

let prev = hist.last()
if prev != nil {
  print("last command: {prev}")
}

Removes all entries from the history.

hist.clear()

Returns all entries as a numbered table. Useful for displaying the full history list.

let all = hist.to_table()
for i, line in all {
  print("{i}: {line}")
}

Removes duplicate entries in-place, keeping the most recent occurrence of each unique line.

hist.add("print(x)")
hist.add("let x = 1")
hist.add("print(x)")
hist.remove_duplicates()
print(hist.count())  // 2

Removes the entry at the given 1-based index. Returns true on success, false if the index is out of range.

hist.remove(1)

Returns entries from index start (inclusive) to end (exclusive), re-indexed from 1.

let recent = hist.slice(hist.count() - 4, hist.count())