docs: add pkg.go.dev examples and godoc improvements

[SoundMatt]

Add runnable Example* functions in *_test.go for all major types. Ensure all exported symbols have complete godoc.