dom.go RawHistoryFolder

1package systemviews
2
3import (
4	"fmt"
5	"html"
6)
7
8type DOM interface {
9	Mount(markup string) error
10}
11
12// DOMAction is a browser event delegated from the mounted systemview DOM.
13type DOMAction struct {
14	Action string
15	Data   map[string]string
16}
17
18// DOMActionHandler handles delegated browser actions.
19type DOMActionHandler func(DOMAction)
20
21// DOMActionBinder is implemented by DOM adapters that can delegate events back
22// to the App. Tests can keep using the smaller DOM interface.
23type DOMActionBinder interface {
24	BindActions(handler DOMActionHandler) error
25}
26
27// DOMReadinessSignaler is implemented by DOM adapters that can mark the
28// loading shell ready or terminally failed. The App calls it after the
29// initial mount and action binding complete; history-data completion is a
30// separate concern and never gates readiness. Adapters without it keep
31// legacy behavior, leaving shell state to the page script.
32type DOMReadinessSignaler interface {
33	// SignalReady clears the shell loading state after mount and binding.
34	SignalReady() error
35	// SignalError clears the shell loading state with a fatal message
36	// when mount or binding fails.
37	SignalError(message string) error
38}
39
40// DOMHistoryTimelineAppender is implemented by DOM adapters that can append
41// older history windows without reparsing and remounting the whole page.
42type DOMHistoryTimelineAppender interface {
43	AppendHistoryTimeline(markup string) error
44}
45
46func placeholderHTML(route Route) string {
47	name := html.EscapeString(string(route))
48	if name == "" || route == RouteUnknown {
49		name = "unknown"
50	}
51
52	return fmt.Sprintf(`<p>systemviews %s</p>`, name)
53}