feat: Clarify utilies in API (#90)

* fix: Don't export pointwise_loglikelihoods

* chore: Add Compat as dependency

* chore(api): Designate utilities in API as public

* docs: Make sure utilities appear in TOC

* chore: Increment patch number

* Update CHANGELOG.md

Author: sethaxen

CHANGELOG.md

@@ -12,6 +12,12 @@
 
 ### Documentation
 
+## v0.4.7 (Unreleased)
+
+### Features
+
+- Mark utilities in API as `public`. ([#90](https://github.com/arviz-devs/PosteriorStats.jl/pull/90))
+
 ## v0.4.6 (2026-02-03)
 
 ### Features

Project.toml

@@ -1,9 +1,10 @@
 name = "PosteriorStats"
 uuid = "7f36be82-ad55-44ba-a5c0-b8b5480d7aa5"
 authors = ["Seth Axen <seth@sethaxen.com> and contributors"]
-version = "0.4.6"
+version = "0.4.7"
 
 [deps]
+Compat = "34da2185-b29b-5c13-b0c7-acf172513d20"
 Distributions = "31c24e10-a181-5473-b8eb-7969acd0382f"
 DocStringExtensions = "ffbed154-4ef7-542d-bbb7-c09d3a79fcae"
 FFTW = "7a1cc6ca-52ef-59f5-83cd-3a7055c09341"
@@ -33,6 +34,7 @@ Tables = "bd369af6-aec1-5ad0-b16a-f7cc5008161c"
 
 [compat]
 BSON = "0.3"
+Compat = "4.10"
 DimensionalData = "0.24, 0.25, 0.26, 0.27, 0.28, 0.29"
 Distributions = "0.25.57"
 DocStringExtensions = "0.8, 0.9"

docs/src/api.md

@@ -54,7 +54,7 @@ loo_pit
 r2_score
 ```
 
-### Utilities
+## Utilities
 
 ```@docs
 PosteriorStats.kde_reflected

src/PosteriorStats.jl

@@ -1,5 +1,6 @@
 module PosteriorStats
 
+using Compat: Compat
 using Distributions: Distributions
 using DocStringExtensions: FIELDS, FUNCTIONNAME, TYPEDEF, TYPEDFIELDS, SIGNATURES
 using FFTW: FFTW
@@ -48,6 +49,7 @@ export eti, eti!, hdi, hdi!
 
 # Others
 export loo_pit, r2_score
+Compat.@compat public kde_reflected, pointwise_conditional_loglikelihoods
 
 const DEFAULT_CI_PROB = 0.89f0
 const INFORMATION_CRITERION_SCALES = (deviance=-2, log=1, negative_log=-1)

src/pointwise_loglikelihoods.jl

@@ -1,4 +1,4 @@
-@deprecate pointwise_loglikelihoods(y, dists) pointwise_conditional_loglikelihoods(y, dists)
+@deprecate pointwise_loglikelihoods(y, dists) pointwise_conditional_loglikelihoods(y, dists) false
 
 @doc """
     pointwise_conditional_loglikelihoods(y, dists)