builtins

type CallContext struct {
	Stdout io.Writer
	Stderr io.Writer
	Stdin  *os.File

	// InLoop is true when the builtin runs inside a for loop.
	InLoop bool

	// LastExitCode is the exit code from the previous command.
	LastExitCode uint8

	// OpenFile opens a file within the shell's path restrictions.
	OpenFile func(ctx context.Context, path string, flags int, mode os.FileMode) (io.ReadWriteCloser, error)

	// PortableErr normalizes an OS error to a POSIX-style message.
	PortableErr func(err error) string
}

type HandlerFunc func(ctx context.Context, callCtx *CallContext, args []string) Result

type Result struct {
	// Code is the exit status code.
	Code uint8

	// Exiting signals that the shell should exit (set by the "exit" builtin).
	Exiting bool

	// BreakN > 0 means break out of N enclosing loops.
	BreakN int

	// ContinueN > 0 means continue from N enclosing loops.
	ContinueN int
}