goscriptbench

type Artifact struct {
	// schemaVersion identifies the artifact format
	SchemaVersion int
	// metadata identifies the engine, fixture, revisions, and state boundary
	Metadata RunMetadata
	// sampling records fixed population sizes and summary method
	Sampling SamplingPolicy
	// warmup is the complete row excluded from the scalar population
	Warmup Sample
	// samples are the retained source rows in execution order
	Samples []Sample
	// summary is derived only from samples
	Summary Summary
}

type ArtifactBundle struct {
	// result contains the untraced distribution
	Result Artifact
	// diagnostic contains the traced sample
	Diagnostic DiagnosticArtifact
	// runtimeTrace contains the separately captured diagnostic trace
	RuntimeTrace []byte
	// browserCPUProfile contains optional Chromium-only diagnostic evidence
	BrowserCPUProfile []byte
}

type ArtifactPublisher struct {
	// contains filtered or unexported fields
}

type DiagnosticArtifact struct {
	// schemaVersion identifies the artifact format
	SchemaVersion int
	// runID links the diagnostic to its scalar result
	RunID string
	// engine links the diagnostic to its browser engine
	Engine string
	// sample is excluded from the retained scalar population
	Sample Sample
	// runtimeTraceFile names the required runtime trace
	RuntimeTraceFile string
	// browserCPUProfileFile names optional Chromium-only CPU evidence
	BrowserCPUProfileFile string
}

type EngineCapability struct {
	SchemaVersion int
	RunID         string
	Engine        string
	EngineVersion string
	Capability    string
	Status        string
	Reason        string
}

type Fixture struct {
	// generator names the deterministic fixture algorithm
	Generator string
	// generatorRevision identifies the generator contract
	GeneratorRevision string
	// encoder names the fixture encoder
	Encoder string
	// encoderEnvironment identifies the encoder runtime
	EncoderEnvironment string
	// SHA256 is the lowercase hexadecimal digest of the encoded fixture
	SHA256 string
	// encodedBytes is the encoded fixture size
	EncodedBytes int64
	// width is the decoded fixture width
	Width int
	// height is the decoded fixture height
	Height int
	// colorModel names the decoded fixture color model
	ColorModel string
	// path is the fixture path inside the measured storage system
	Path string
}

type Measurement struct {
	// sample is the browser-local timing row
	Sample Sample
	// runtimeTrace is present only for the traced diagnostic
	RuntimeTrace []byte
	// browserCPUProfile is optional Chromium-only diagnostic evidence
	BrowserCPUProfile []byte
}

type ProjectedImage struct {
	// contains filtered or unexported fields
}

type ProjectedImageConfig struct {
	// runID groups this result with other engine processes
	RunID string
	// engine names the selected Playwright browser
	Engine string
	// spacewaveRevision identifies the Spacewave source tree
	SpacewaveRevision string
	// goScriptRevision identifies the GoScript source tree
	GoScriptRevision string
	// unavailableFields names optional timing fields omitted by the engine
	UnavailableFields []string
	// browserCPUProfile enables optional same-window Chromium profiling
	BrowserCPUProfile bool
}

type RunMetadata struct {
	// runID groups independent engine results from one matrix invocation
	RunID string
	// engine names the selected browser engine
	Engine string
	// engineVersion identifies the launched browser binary
	EngineVersion string
	// compiler names the Go-to-browser compiler
	Compiler string
	// spacewaveRevision identifies the Spacewave source tree
	SpacewaveRevision string
	// goScriptRevision identifies the GoScript source tree
	GoScriptRevision string
	// buildMode names the measured build shape
	BuildMode string
	// workerMode names the GoScript runtime worker shape
	WorkerMode string
	// storageBackend names the measured persistent storage backend
	StorageBackend string
	// runtimeState names the retained and recreated cache cell
	RuntimeState string
	// projectedURLTemplate identifies the measured request family
	ProjectedURLTemplate string
	// fixture identifies the measured bytes
	Fixture Fixture
	// state declares the boundary between samples
	State StateBoundary
	// unavailableFields names optional browser timing fields omitted by this engine
	UnavailableFields []string
}

type Runner struct {
	// contains filtered or unexported fields
}

type Sample struct {
	// ID uniquely identifies the sample within one engine run
	ID string
	// requestStartMs is the projected URL assignment time relative to sample start
	RequestStartMs float64
	// responseStartMs is the matching resource response start
	ResponseStartMs float64
	// responseEndMs is the matching resource response end
	ResponseEndMs float64
	// loadMs is the image load event time
	LoadMs float64
	// decodeMs is the image decode completion time
	DecodeMs float64
	// frameMs is the first animation frame after decode
	FrameMs float64
	// displayReadyMs is the retained scalar and equals frameMs
	DisplayReadyMs float64
	// naturalWidth is the decoded image width
	NaturalWidth int
	// naturalHeight is the decoded image height
	NaturalHeight int
	// transferSize is the browser-reported transferred byte count
	TransferSize int64
	// decodedBodySize is the browser-reported decoded body byte count
	DecodedBodySize int64
	// traced reports whether diagnostic tracing was enabled
	Traced bool
}

type SampleKind string

type SampleRequest struct {
	// kind identifies the sample population
	Kind SampleKind
	// number is one-based within the sample population
	Number int
	// trace enables diagnostic tracing for this action
	Trace bool
}

type SamplingPolicy struct {
	// warmupSamples is the discarded sample count
	WarmupSamples int
	// retainedSamples is the untraced scalar sample count
	RetainedSamples int
	// diagnosticSamples is the traced sample count
	DiagnosticSamples int
	// summaryMethod names the percentile algorithm
	SummaryMethod string
}

type StateBoundary struct {
	// retained names state preserved between samples
	Retained []string
	// recreated names state replaced between samples
	Recreated []string
}

type Summary struct {
	// method names the percentile algorithm
	Method string
	// sampleCount is the number of retained source rows
	SampleCount int
	// medianDisplayReadyMs is the nearest-rank p50
	MedianDisplayReadyMs float64
	// p95DisplayReadyMs is the nearest-rank p95
	P95DisplayReadyMs float64
}

type Workload interface {
	Setup(ctx context.Context) (RunMetadata, error)
	Restart(ctx context.Context, request SampleRequest) error
	Measure(ctx context.Context, request SampleRequest) (Measurement, error)
	Validate(ctx context.Context, request SampleRequest, sample Sample) error
}