/*
  StarForth — Steady-State Virtual Machine Runtime

  Copyright (c) 2023–2025 Robert A. James
  All rights reserved.

  Licensed under the StarForth License, Version 1.0
*/

#ifndef SCROLL_WORDS_H
#define SCROLL_WORDS_H

#include "vm.h"

/**
 * @defgroup scroll_words REPL Scrollback Words
 * @{
 *
 * @brief `SCROLL-BACK`/`SCROLL-FWD`, the REPL scrollback controls
 * (FABRIC-0.md item 4.4q). Kernel-only; no-op on hosted builds (no
 * framebuffer console there).
 *
 * @par SCROLL-BACK ( n -- )
 * Move the scrollback view back @c n lines (toward older output) and
 * redraw. Clamped at the oldest stored line -- no error on over-request,
 * it just stops there.
 *
 * @par SCROLL-FWD ( n -- )
 * Move the scrollback view forward @c n lines (toward live output) and
 * redraw. Clamped at the live view.
 * @}
 */

void register_scroll_words(VM *vm);

#endif /* SCROLL_WORDS_H */