Utilities

Small standalone helpers used across the package. Each one is a single function with a focused responsibility.

Helpers

• emptyNull — collapse empty / falsy strings to null
• generateColorPalette — turn a base hex color into a CSS-variable shade scale via OKLCH
• guarded — wrap a function with global error handling for HTTP-aware exceptions
• onError — partially-applied guarded factory that captures an onError callback up front
• persistentRef — Ref<T> that mirrors localStorage with a custom serializer
• persistentStringRef — string-flavoured persistentRef with sane defaults for nullable text values
• runBefore — decorator that runs a side effect before invoking the wrapped function
• unrefAll — unref many dependencies at once and throw UnresolvedDependencyException on falsy values
• unwrapElement — resolve a ref to either an HTMLElement or null, with ComponentPublicInstance support

See also

• Errors — exceptions thrown by these utilities
• Composables — most of these utilities power the composables in the package