crudview

type Config struct {
	// ParentID is the DOM id the form mounts under.
	ParentID string
	// Presenter is built by the module via view.New(...). Required.
	Presenter view.Presenter
	// IDs supplies new ids for hidden text-PK auto-assignment on submit (the
	// form's composition-root injection, see form.New). Required — New fails
	// if nil. Pass unixid.NewUnixID() at your composition root.
	IDs model.IDGenerator

	// Filter is the control that narrows the list. Optional: nil renders no
	// controls band. When nil, New installs a searchbar.SearchBar carrying the
	// presenter's placeholder — the ergonomic default, not a decision imposed:
	// pass any widget.Filterable to replace it.
	Filter dom.Component

	// List builds the row-rendering widget. Optional: nil installs a
	// targetlist.TargetList factory — the ergonomic default, not a decision
	// imposed: pass a targethour.TargetHour (or anything satisfying
	// ListView) factory instead when the data wants a leading date/time
	// badge (view.Item's LeadTop/Main/Bottom) rather than a plain label.
	List func(selected *dom.SignalString, onSelect func(view.Item), onDelete func(string)) ListView
}

type CrudView struct {
	Element // value embed — NEVER *dom.Element

	Title     string
	Form      Component // what Render paints (may stay nil in standalone mode)
	Presenter view.Presenter

	// Filter is the control that narrows the list — a searchbar.SearchBar, a
	// calendar, a select. nil paints no controls band at all. If it implements
	// widget.Filterable, crudview wires it to the list filter in Init.
	//
	// The type is Component, not widget.Filterable, on purpose: a control with
	// no live output (a static legend, a chip strip that navigates elsewhere) is
	// a legitimate occupant and must not be forced to implement a callback it
	// would never fire.
	Filter Component

	// List builds the row-rendering widget, given the Selected signal and the
	// OnSelect/OnDelete callbacks CrudView owns — Init calls it once. Set by
	// New from Config.List; nil there resolves to a targetlist.TargetList
	// factory, same "ergonomic default, not a decision imposed" as Filter.
	List func(selected *SignalString, onSelect func(view.Item), onDelete func(string)) ListView

	// Additive user hooks — called AFTER the built-in behavior. Assigning them
	// can never disable list→form fill, save or delete wiring.
	OnSelect  func(it view.Item)
	OnNew     func()
	OnSaved   func(err error)
	OnDeleted func(id string, err error)
	OnCancel  func()
	// contains filtered or unexported fields
}

type ListView interface {
	Component
	SetItems(items []view.Item)
	Items() []view.Item
	Count() int
	CloseMenus()
}