bind

type BindClickedHook[T comparable] func(bind Binder[T], elem *jaws.Element, name string) (err error)

type BindGetHook[T comparable] func(bind Binder[T], elem *jaws.Element) (value T)

type BindSetHook[T comparable] func(bind Binder[T], elem *jaws.Element, value T) (err error)

type BindSuccessHook func(*jaws.Element) (err error)

type Binder[T comparable] interface {
	RWLocker
	Setter[T]
	jtag.TagGetter
	Formatter
	jaws.ClickHandler

	JawsBinderPrev() Binder[T] // returns the previous Binder in the chain, or nil
	JawsGetLocked(elem *jaws.Element) (value T)
	JawsSetLocked(elem *jaws.Element, value T) (err error)

	// SetLocked returns a Binder[T] that will call fn instead of JawsSetLocked.
	//
	// The lock will be held at this point.
	// Do not lock or unlock the Binder within fn. Do not call JawsSet.
	//
	// The bind argument to the function is the previous Binder in the chain,
	// and you probably want to call it's JawsSetLocked first.
	SetLocked(fn BindSetHook[T]) (newbind Binder[T])

	// GetLocked returns a Binder[T] that will call fn instead of JawsGetLocked.
	//
	// The lock will be held at this point, preferring RLock over Lock, if available.
	// Do not lock or unlock the Binder within fn. Do not call JawsGet.
	//
	// The bind argument to the function is the previous Binder in the chain,
	// and you probably want to call it's JawsGetLocked first.
	GetLocked(fn BindGetHook[T]) (newbind Binder[T])

	// Success returns a Binder[T] that will call fn after the value has been set
	// with no errors. No locks are held when the function is called.
	// If the function returns an error, that will be returned from JawsSet.
	//
	// The function must have one of the following signatures:
	//  * func()
	//  * func() error
	//  * func(*Element)
	//  * func(*Element) error
	Success(fn any) (newbind Binder[T])

	// FormatHTML returns a HTMLGetter using fmt.Sprintf(f, JawsGet[T](elem))
	FormatHTML(f string) (getter HTMLGetter)

	// Clicked returns a Binder[T] that will call fn when JawsClick is invoked.
	//
	// The Binder locks are not held when the function is called.
	Clicked(fn BindClickedHook[T]) (newbind Binder[T])
}

type Formatter interface {
	// Format returns a Getter[string] using fmt.Sprintf(f, JawsGet[T](elem))
	Format(f string) (getter Getter[string])
}

type Getter[T comparable] interface {
	JawsGet(elem *jaws.Element) (value T)
}

type HTMLGetter interface {
	JawsGetHTML(e *jaws.Element) template.HTML
}

type RWLocker interface {
	sync.Locker
	RLock()
	RUnlock()
}

type Setter[T comparable] interface {
	Getter[T]
	// JawsSet may return ErrValueUnchanged to indicate value was already set.
	JawsSet(elem *jaws.Element, value T) (err error)
}

type SetterFloat64[T numeric] interface {
	Getter[T]
	// JawsSet may return ErrValueUnchanged to indicate value was already set.
	JawsSet(elem *jaws.Element, value T) (err error)
}