webgpu

type Backend interface {
	// Open starts a process's session.
	Open(p Process, lim Limits, h *Handles) Session
}

type Browser struct {
	// AllowFallback offers a software adapter; off by default, since its
	// work is not GPU work.
	AllowFallback bool
	// GPUTime bounds one submission's GPU work; past it the device is
	// destroyed (lost) rather than letting a container hold the GPU
	// (default 2 s, the order of a driver watchdog).
	GPUTime time.Duration
	// OnSurface receives the surfaces' events: "open", "resize", "close",
	// and "frame" (an ImageBitmap the receiver must transfer or close,
	// with its sequence number). Nil drops frames (closing them). The
	// page acknowledges drawn frames with AckFrame (docs/DESIGN.md,
	// "Surfaces").
	OnSurface func(SurfaceEvent)
	// FrameInterval paces present (default 1/60 s): a surface never shows
	// more than one frame per interval.
	FrameInterval time.Duration
	// MaxWidth and MaxHeight bound a surface (default 1920x1080).
	MaxWidth, MaxHeight int
}

type Destroyer interface{ Destroy() }

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

type InputEvent struct {
	// Kind is "pointer-down", "pointer-up", "pointer-move", "key-down" or
	// "key-up" (the surface methods on-<kind>).
	Kind string
	// X, Y: pointers, in surface pixels from the top-left corner (the page
	// scales from the pane).
	X, Y float64
	// Code is KeyboardEvent.code ("KeyA"); an unknown code is a key of
	// none. Text is the text the key produces (KeyboardEvent.key when it is
	// one character), "" for none.
	Code, Text             string
	Alt, Ctrl, Meta, Shift bool
}

type Limits struct {
	Handles     int   // live resources (default 4096)
	MemoryBytes int64 // buffer and texture bytes alive (default 256 MiB)
	ShaderBytes int   // one WGSL source (default 1 MiB)
	Pipelines   int   // pipelines alive (default 256)
}

type Module struct {
	Backend Backend
	Limits  Limits
	// contains filtered or unexported fields
}

type Process struct {
	GPU       bool   // the process has the gpu capability
	Container string // its container's label (wasi.Config.Label), for surfaces
}

type Session interface {
	// Call runs import name with lifted arguments and returns the result
	// value (nil for none). A *TrapError traps the guest.
	Call(name string, args []any) (any, error)
	// Async reports whether name waits on the platform (WebGPU promises):
	// such calls run off the host call.
	Async(name string) bool
	// Close releases everything (the process ended).
	Close()
}

type Stream struct {
	Elem *wit.Type
	// contains filtered or unexported fields
}

type SurfaceEvent struct {
	Op            string // "open", "resize", "close", "frame"
	Surface       uint32
	Container     string // open: the container's label (its ID), "" if unknown
	Width, Height int
	Seq           uint64   // frames: from 1
	Bitmap        js.Value // frames: an ImageBitmap
}

type TrapError struct{ Msg string }

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