This library was previously called custom-pointer-react, and only supported a single type of animated cursor. This new rewrite focuses on better accessibility, modularity, and performance.

Breaking changes

• Package name: custom-pointer-react → qursor
• API model:
  • Before: single animated cursor component
  • Now: variant-based system managed by CursorProvider + useCursor

New APIs

• <CursorProvider variants={...} config={...} />
  • config.enabled, config.trailing, config.reducedMotionRespect, config.disableOnTouch, config.cursorClassName
• useCursor()
  • variant, setVariant(name, meta?), pushVariant(name, { timeout?, meta? }), popVariant(), setVariantComponent(name, component), setMeta(meta)
• <CursorTarget variant="..." meta? disabled?>
• Data attributes
  • data-cursor="hover", data-cursor-meta='{"key":"value"}'

Tooling

• Tests with Vitest + Testing Library
• ESM, strong types, and zero runtime deps in core

Deprecation

• custom-pointer-react is no longer maintained. Migrate to qursor for updates and new features.