@primeuix/utils

PrimeUIX Utils

Low-level utility functions shared across PrimeUI libraries. Covers the DOM, object comparison and transformation, class name merging, event bus, UUID generation, z-index management, and prop merging. Each domain is a separate subpath so bundlers can tree-shake unused areas.

import { find, addClass, getOffset, getFocusableElements } from '@primeuix/utils/dom';
import { deepMerge, resolveFieldData, isEmpty, toCamelCase } from '@primeuix/utils/object';
import { cn } from '@primeuix/utils/classnames';
import { EventBus } from '@primeuix/utils/eventbus';
import { ZIndex } from '@primeuix/utils/zindex';

DOM covers element queries, position and offset calculations, CSS class helpers, scroll utilities, hidden element dimension detection, browser detection, and transition/animation presence checks.

Object covers deep and shallow equality, deep merge, field resolution by dot-path, type guards (isArray, isDate, isEmpty), array helpers, and string case converters (toCamelCase, toKebabCase, toFlatCase).

Class names — cn() accepts strings, arrays, and { className: boolean } objects and merges them into a single string.

EventBus is a lightweight pub/sub for cross-package communication without framework dependencies.

ZIndex is a stacking context tracker that assigns and releases z-index values in the correct order for overlapping overlays.

License

Licensed under the PrimeUI License - Copyright (c) PrimeTek Informatics