frog.go

package frog

import (
	"context"
	"io"

	"github.com/pondworks-lib/frog/core"
	"github.com/pondworks-lib/frog/core/validate"
)

type (
	App    = core.Session
	Option = core.Option

	// Core types.
	Model     = core.Model
	Msg       = core.Msg
	KeyMsg    = core.KeyMsg
	KeyType   = core.KeyType
	TickMsg   = core.TickMsg
	QuitMsg   = core.QuitMsg
	Cmd       = core.Cmd
	ResizeMsg = core.ResizeMsg

	// Mouse and paste messages.
	MouseMsg    = core.MouseMsg
	MouseButton = core.MouseButton
	MouseAction = core.MouseAction
	PasteMsg    = core.PasteMsg

	// Styling.
	Style        = core.Style
	Color        = core.Color
	ColorProfile = core.ColorProfile

	// Renderer options.
	RendererOption = core.RendererOption

	// Layout.
	AlignH = core.AlignH
	AlignV = core.AlignV

	// Logger.
	Logger = core.Logger

	// Structured runtime and validation errors.
	Error              = core.Error
	ErrorCode          = core.ErrorCode
	ValidationCode     = validate.Code
	ValidationSeverity = validate.Severity
	ValidationIssue    = validate.Issue
	ValidationReport   = validate.Report
)

// Key constants
const (
	KeyUnknown   = core.KeyUnknown
	KeyRune      = core.KeyRune
	KeyEnter     = core.KeyEnter
	KeyBackspace = core.KeyBackspace
	KeyEsc       = core.KeyEsc
	KeyCtrlC     = core.KeyCtrlC
	KeyUp        = core.KeyUp
	KeyDown      = core.KeyDown
	KeyLeft      = core.KeyLeft
	KeyRight     = core.KeyRight
	KeyTab       = core.KeyTab
	KeySpace     = core.KeySpace
	KeyDelete    = core.KeyDelete
	KeyHome      = core.KeyHome
	KeyEnd       = core.KeyEnd
	KeyPgUp      = core.KeyPgUp
	KeyPgDn      = core.KeyPgDn
	KeyQ         = core.KeyQ
)

// Mouse constants
const (
	MouseUnknown   = core.MouseUnknown
	MouseLeft      = core.MouseLeft
	MouseMiddle    = core.MouseMiddle
	MouseRight     = core.MouseRight
	MouseWheelUp   = core.MouseWheelUp
	MouseWheelDown = core.MouseWheelDown
)

// Runtime error codes
const (
	ErrNilModel       = core.ErrNilModel
	ErrNilRenderer    = core.ErrNilRenderer
	ErrRawMode        = core.ErrRawMode
	ErrInitFailed     = core.ErrInitFailed
	ErrViewFailed     = core.ErrViewFailed
	ErrUpdateFailed   = core.ErrUpdateFailed
	ErrCommandFailed  = core.ErrCommandFailed
	ErrNilUpdateModel = core.ErrNilUpdateModel
)

// Validation issue codes
const (
	ValidationNilModel           = validate.CodeNilModel
	ValidationMissingView        = validate.CodeMissingView
	ValidationEmptyView          = validate.CodeEmptyView
	ValidationViewNotString      = validate.CodeViewNotString
	ValidationViewHasBadRunes    = validate.CodeViewHasBadRunes
	ValidationViewPanic          = validate.CodeViewPanic
	ValidationMissingUpdate      = validate.CodeMissingUpdate
	ValidationBadUpdateSignature = validate.CodeBadUpdateSignature
	ValidationMissingInit        = validate.CodeMissingInit
	ValidationBadInitSignature   = validate.CodeBadInitSignature
	ValidationUpdateNilModel     = validate.CodeUpdateNilModel
	ValidationViewVeryLarge      = validate.CodeViewVeryLarge
	ValidationViewSuspicious     = validate.CodeViewSuspicious
	ValidationNonExportedType    = validate.CodeNonExportedType
	ValidationSlowView           = validate.CodeSlowView
	ValidationSlowInit           = validate.CodeSlowInit
	ValidationHasNoMethods       = validate.CodeHasNoMethods
	ValidationUpdateNotMethod    = validate.CodeUpdateNotMethod
	ValidationViewNotMethod      = validate.CodeViewNotMethod
	ValidationReceiverMismatch   = validate.CodeReceiverMismatch
	ValidationViewControlCodes   = validate.CodeViewControlCodes
)

const (
	MousePress   = core.MousePress
	MouseRelease = core.MouseRelease
	MouseDrag    = core.MouseDrag
	MouseWheel   = core.MouseWheel
)

// Color profile constants
const (
	ColorAuto      = core.ColorAuto
	ColorNone      = core.ColorNone
	ColorANSI16    = core.ColorANSI16
	ColorANSI256   = core.ColorANSI256
	ColorTrueColor = core.ColorTrueColor
)

// Named colors (16-color)
var (
	ColorBlack         = core.ColorBlack
	ColorRed           = core.ColorRed
	ColorGreen         = core.ColorGreen
	ColorYellow        = core.ColorYellow
	ColorBlue          = core.ColorBlue
	ColorMagenta       = core.ColorMagenta
	ColorCyan          = core.ColorCyan
	ColorWhite         = core.ColorWhite
	ColorBrightBlack   = core.ColorBrightBlack
	ColorBrightRed     = core.ColorBrightRed
	ColorBrightGreen   = core.ColorBrightGreen
	ColorBrightYellow  = core.ColorBrightYellow
	ColorBrightBlue    = core.ColorBrightBlue
	ColorBrightMagenta = core.ColorBrightMagenta
	ColorBrightCyan    = core.ColorBrightCyan
	ColorBrightWhite   = core.ColorBrightWhite
)

// Style functions.
var (
	NewStyle  = core.NewStyle
	ANSI256   = core.ANSI256
	RGB       = core.RGB
	Colorize  = core.Colorize
	StripANSI = core.StripANSI

	InspectModel  = validate.InspectModel
	ValidateModel = validate.ValidateModel
)

// App functions.
func NewApp(m Model, opts ...Option) *App { return core.NewSession(m, opts...) }
func Run(m Model, opts ...Option) error {
	if err := validate.ValidateModel(m); err != nil {
		return err
	}
	return core.NewSession(m, opts...).Run()
}

// Context-aware entrypoints.
func NewAppWithContext(ctx context.Context, m Model, opts ...Option) *App {
	return core.NewSessionWithContext(ctx, m, opts...)
}
func RunContext(ctx context.Context, m Model, opts ...Option) error {
	if err := validate.ValidateModel(m); err != nil {
		return err
	}
	return core.NewSessionWithContext(ctx, m, opts...).Run()
}

// Session options
var (
	Tick               = core.Tick
	Quit               = core.Quit
	Nil                = core.Nil
	WithRenderer       = core.WithRenderer
	WithAltScreen      = core.WithAltScreen
	WithMsgBuffer      = core.WithMsgBuffer
	WithOut            = core.WithOut
	WithIn             = core.WithIn
	WithResizeInterval = core.WithResizeInterval
	WithNonInteractive = core.WithNonInteractive
	WithLogger         = core.WithLogger
	WithMouse          = core.WithMouse
	WithBracketedPaste = core.WithBracketedPaste
)

// Renderer helpers.
func NewRenderer(out io.Writer, opts ...RendererOption) core.Renderer {
	return core.NewRenderer(out, opts...)
}

// Help overlay.
func RenderKeyHelp(km *core.KeyMap, width, height int) string {
	return core.RenderHelpOverlay(km, width, height)
}

// FPS-throttled renderer.
func NewThrottledRenderer(out io.Writer, fps int, opts ...core.RendererOption) core.Renderer {
	return core.NewThrottledRenderer(out, fps, opts...)
}

var (
	WithDiff         = core.WithDiff
	WithColorProfile = core.WithColorProfile
)

// Layout helpers.
const (
	AlignLeft   = core.AlignLeft
	AlignCenter = core.AlignCenter
	AlignRight  = core.AlignRight
	AlignTop    = core.AlignTop
	AlignMiddle = core.AlignMiddle
	AlignBottom = core.AlignBottom
)

var (
	Center     = core.Center
	PlaceBlock = core.PlaceBlock
)