High level changelog:

Overall

• Bump from Go 1.17 to 1.18
• Operations that would previously fail on an oak window because they were not supported on a specific OS will now fail at compile time instead.
• Windows, Linux, and OSX have had their window functionality standardized.
• Examples have been trimmed down and compressed.

Testing

• Added Linux AMD64 and Windows AMD64 automated test agents

Alg Package

• alg/range has been replaced by alg/span, a genericized version of the package.
• Intgeom rectangles now implement the alg/span interface. In other words, rectangles can be queried for arbitrary points within them and have points clamped to their boundaries.

Audio Package

• The audio and pcm packages have been rewritten from scratch.
• A program can now select a specific audio driver for a platform. There are minimal options currently, but this can be extended in the future.
• The pcm package now defines the audio interface in a streamable fashion, and audio defines options for playing back pcm streams.
• Some functionality has been removed with no current replacement, e.g. Ears, positional filters. They can be re-added in the future.
• Streaming enables new functionality like FadeIn and FadeOut stream wrappers.
• Audio format packages can now be compiled in at request instead of always compiled into programs. This should decrease binary sizes of most programs, particularly those not using audio or only using one format.
• The synth package has additional functionality for manipulating generated waveforms like detuning, combining waveforms, and detecting a waveform's pitch.

Entities Package

• This package has been rewritten from scratch to use optional constructors instead of a series of scaling types with additional functionality. entities/x/move has been moved to entities itself.
• entities/x/btn has been trimmed down to use entities internally instead of its own structures.
• entities/x/force and entities/x/stat have been removed.
• entities/x/shake has been promoted to oak/shake.

Event Handling

• Event handling has been augmented to support type safe argument handling via generics.
• The interface for binding and unbinding events, and the internal logic for processing requests, has been overhauled.
• Example: previously to unbind a specific known binding in collision.Detach, we did this:

if _, ok := en.(attachSpace); ok { 
event.UnbindBindable(
	event.UnbindOption{
		Event: event.Event{
			Name:     event.Enter,
			CallerID: s.CID,
		},
		Fn: attachSpaceEnter,
	},
)
}

Now, bindings return a value that can be explicitly used to unbind themselves later:

if as, ok := en.(attachSpace); ok {
    as.getAttachSpace().binding.Unbind()
}

• These rewrites eliminate the need for oak.Config.EventRefreshRate.

Render

• The build tag nogift can be added to exclude the disintegration/gift dependency and its helper functions.
• The build tag noimages can be added to exclude registering the standard library's built in image support.

Scene Handling

• Scenes no longer have a Loop function. For operations that should happen every frame, the event package is preferred, with helpers like scene.Context.DoEachFrame added. scene.Context.GoToScene and its like are preferred for handling when a scene ends.
• Scene contexts embed most of their component constructs, and can be provided to the event and render packages as appropriate.

Changelog by PRs:

• scene: Embed Eventhandler to allow for some embedded calls by @Implausiblyfun in #197
• Feature/v4 eventskeys+examples by @Implausiblyfun in #199
• event: overhaul api by @200sc in #196
• Feature/v4 shaker+examples by @Implausiblyfun in #202
• shiny: overhaul api for v4 by @200sc in #198
• Hotfix: OSX ARM colors by @200sc in #200
• audio: overhaul api for v4 by @200sc in #201
• Feature/v4 entities by @200sc in #203
• Doc + refactor pass 1 by @200sc in #204
• README: Update the readme to have a few more points added by @Implausiblyfun in #206
• Feature/v4 examples by @200sc in #205
• Release/v4.0.0 by @200sc in #207

Full Changelog: v3.4.0...v4.00