common

type CSP struct {
	// default-src:
	//   nil          ⇒ emit:   default-src 'self'
	//   len == 0     ⇒ omit:   (no default-src directive)
	//   len > 0      ⇒ emit:   default-src <values>
	DefaultSources []string

	// script-src (user additions only):
	//   Directive is ALWAYS emitted with at least 'self' plus any collected hashes/sources.
	//   nil or len == 0 ⇒ no extra user sources added.
	ScriptSources []string

	// script-src strict-dynamic:
	//   When true, appends 'strict-dynamic' to script-src (typically used with nonces/hashes).
	ScriptStrictDynamic bool

	// style-src (user additions only):
	//   Directive is ALWAYS emitted with at least 'self' plus any collected hashes/sources.
	//   nil or len == 0 ⇒ no extra user sources added.
	StyleSources []string

	// connect-src (user additions only):
	//   Directive is ALWAYS emitted with at least 'self'.
	//   nil or len == 0 ⇒ results in: connect-src 'self'
	//   len > 0         ⇒ connect-src 'self' <values>
	ConnectSources []string

	// form-action:
	//   nil      ⇒ emit:   form-action 'none'
	//   len == 0 ⇒ omit:   (no form-action directive)
	//   len > 0  ⇒ emit:   form-action <values>
	FormActions []string

	// object-src:
	//   nil      ⇒ emit:   object-src 'none'
	//   len == 0 ⇒ omit:   (no object-src directive)
	//   len > 0  ⇒ emit:   object-src <values>
	ObjectSources []string

	// frame-src:
	//   nil      ⇒ emit:   frame-src 'none'
	//   len == 0 ⇒ omit:   (no frame-src directive)
	//   len > 0  ⇒ emit:   frame-src <values>
	FrameSources []string

	// frame-ancestors:
	//   nil      ⇒ emit:   frame-ancestors 'none'
	//   len == 0 ⇒ omit:   (no frame-ancestors directive)
	//   len > 0  ⇒ emit:   frame-ancestors <values>
	FrameAcestors []string

	// base-uri:
	//   nil      ⇒ emit:   base-uri 'none'
	//   len == 0 ⇒ omit:   (no base-uri directive)
	//   len > 0  ⇒ emit:   base-uri <values>
	BaseURIAllow []string

	// img-src:
	//   nil or len == 0 ⇒ omit
	//   len > 0         ⇒ emit: img-src <values>
	ImgSources []string

	// font-src:
	//   nil or len == 0 ⇒ omit
	//   len > 0         ⇒ emit: font-src <values>
	FontSources []string

	// media-src:
	//   nil or len == 0 ⇒ omit
	//   len > 0         ⇒ emit: media-src <values>
	MediaSources []string

	// sandbox:
	//   nil or len == 0 ⇒ omit
	//   len > 0         ⇒ emit: sandbox <flags>
	Sandbox []string

	// worker-src:
	//   nil or len == 0 ⇒ omit
	//   len > 0         ⇒ emit: worker-src <values>
	WorkerSources []string

	// report-to:
	//   ""  ⇒ omit
	//   set ⇒ emit: report-to <value>
	// NOTE: To make this effective, you must also send a corresponding
	//       `Report-To` HTTP response header that defines the reporting group.
	ReportTo string
}

type CSPCollector = *cspCollector

type Conf struct {
	// SessionInstanceLimit is the max number of page instances per session.
	// When exceeded, the oldest inactive ones are suspended.
	// Default: 12.
	SessionInstanceLimit int
	// SessionTTL controls how long session lives after last activity.
	// Default behavior (value 0): InstanceTTL
	SessionTTL time.Duration
	// InstanceConnectTimeout controls how long new instance waits
	// before shutdown for the first client connection.
	// Default: RequestTimeout
	InstanceConnectTimeout time.Duration
	// InstanceGoroutineLimit is the max goroutines per page instance.
	// Controls resource use for rendering and reactive updates. Default: 8.
	InstanceGoroutineLimit int
	// InstanceTTL is how long an inactive instance is kept before cleanup.
	// Active = browser connected. Default: 40minutes.
	InstanceTTL time.Duration
	// ServerCacheControl defines cache control header value for JS and CSS
	// resources prepared by the framework.
	// Default "public, max-age=31536000, immutable"
	ServerCacheControl string
	// ServerDisableGzip disables gzip compression for HTML, JS, and CSS if true.
	ServerDisableGzip bool
	// ServerSessionCookiePrefix sets the internal Doors session cookie name prefix.
	// Use it when you want browser-enforced cookie prefix rules, such as
	// __Host- or __Secure-. Empty by default.
	ServerSessionCookiePrefix string
	// ServerSessionCookieNoSecure disables the Secure attribute on the internal
	// Doors session cookie. Use only for plain HTTP development.
	ServerSessionCookieNoSecure bool
	// DisconnectHiddenTimer is how long hidden/background instances stay connected.
	// Default: InstanceTTL/2.
	DisconnectHiddenTimer time.Duration
	// RequestTimeout is the max duration of a client-server request.
	// Default: 30s.
	RequestTimeout time.Duration
	// SolitaireRollTime is the max lifetime of a solitaire sender or report
	// receiver request before rolling to a replacement request.
	// Default: 15s.
	SolitaireRollTime time.Duration
	// SolitaireSyncTimeout is the max pending duration of a server-to-client
	// sync task, including user calls. Exceeding this kills the instance.
	// Default: InstanceTTL.
	SolitaireSyncTimeout time.Duration
	// SolitaireFrameTime is the max time to buffer an outgoing server-to-client
	// frame before forcing a sync flush.
	// Default: ~33.3ms (30 FPS).
	SolitaireFrameTime time.Duration
	// SolitaireFrameSize is the max buffered bytes in an outgoing
	// server-to-client frame before forcing a sync flush.
	// Default: 32 KB.
	SolitaireFrameSize int
	// SolitaireDisableGzip disables gzip compression for solitaire sync payloads if true.
	SolitaireDisableGzip bool
	// SolitaireQueue is the max total queued plus unresolved
	// server-to-client sync tasks. Exceeding this kills the instance.
	// Default: 1024.
	SolitaireQueue int
	// SolitairePending is the max unresolved server-to-client sync tasks.
	// Throttles sending when reached. Default: 256.
	SolitairePending int
	// SolitaireDisableReportStreaming disables browser streaming request bodies for
	// client-to-server reports. When true, each report uses a standalone JSON
	// POST. Default: false.
	SolitaireDisableReportStreaming bool
	// SolitaireReportSize is the max size of one client-to-server report in a
	// streaming report body. Default: 8 MB.
	SolitaireReportSize int
	// SolitaireReportTimeout is the max time to receive and decode one
	// client-to-server report. Default: min(5s, SolitaireRollTime).
	SolitaireReportTimeout time.Duration
	// SolitaireMaxRTT caps the RTT estimate used for sync probing while the
	// server has pending work but no frame ready to flush. Values below
	// 2*SolitaireFrameTime are raised to that minimum. Default: 1s.
	SolitaireMaxRTT time.Duration
}

type EndCause int

type ID *id

type OrderedMap[K cmp.Ordered, V any] []orderedMapEntry[K, V]

type Prime = *prime

type Set[T comparable] map[T]struct{}

type SolitaireConf struct {
	// Roll is the effective solitaire request roll interval.
	Roll time.Duration
	// FrameSize is the effective outgoing server-to-client frame size limit.
	FrameSize int
	// FlushTime is the effective outgoing server-to-client frame time limit.
	FlushTime time.Duration
	// DisableGzip is the effective solitaire payload gzip flag.
	DisableGzip bool
	// DisableReportStreaming is the effective report streaming flag.
	DisableReportStreaming bool
	// Queue is the effective queued plus unresolved sync task limit.
	Queue int
	// Pending is the effective unresolved sync task limit.
	Pending int
	// SyncTimeout is the effective sync task timeout.
	SyncTimeout time.Duration
	// ReportSize is the effective streaming report message size limit.
	ReportSize int
	// ReportTimeout is the effective single-report receive timeout.
	ReportTimeout time.Duration
	// MaxRTT is the effective RTT estimate cap after the 2*FlushTime minimum.
	MaxRTT time.Duration
}