@molecule/app-emoji-reactions-react

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

Emoji reaction bar.

Exports <EmojiReactions> and the EmojiReaction type — one toggle chip per existing reaction plus an optional "+" quick-pick popover. Standalone (not coupled to a message-bubble layout, unlike MessageReactions in @molecule/app-message-bubble-react).

Quick Start

import { EmojiReactions } from '@molecule/app-emoji-reactions-react'

;<EmojiReactions
  reactions={[
    { emoji: '👍', count: 12, reactedByMe: true },
    { emoji: '❤️', count: 5 },
  ]}
  onToggle={(emoji) => toggleReaction(postId, emoji)}
  onAdd={(emoji) => addReaction(postId, emoji)}
/>

Type

feature

Installation

npm install @molecule/app-emoji-reactions-react @molecule/app-react @molecule/app-ui @molecule/app-ui-react react
npm install -D @types/react

API

Interfaces

EmojiReaction

Represents a single emoji reaction with its aggregated count and current-user state.

interface EmojiReaction {
  emoji: string
  count: number
  /** Whether the current user reacted with this emoji. */
  reactedByMe?: boolean
}

EmojiReactionsProps

Props for {@link EmojiReactions}.

interface EmojiReactionsProps {
  reactions: EmojiReaction[]
  /** Called when a reaction chip is toggled by the current user. */
  onToggle?: (emoji: string) => void
  /** Quick-pick emojis offered when "+" is clicked. */
  quickPicks?: string[]
  /** Called when the user picks a new emoji. */
  onAdd?: (emoji: string) => void
  /** Optional wrapper class. */
  className?: string
  /**
   * Optional custom tooltip content shown on hover / focus of a reaction chip
   * (e.g. an avatar list of who reacted). When provided, it replaces the
   * default "{count} reactions" title. Returning a nullish value falls back to
   * the default title for that chip.
   */
  renderTooltip?: (r: EmojiReaction) => ReactNode
}

Functions

EmojiReactions(props)

Generic emoji reaction bar — chip per existing reaction + an add button that opens a quick-pick row. Different from MessageReactions in app-message-bubble-react in being standalone (not coupled to the message bubble layout).

function EmojiReactions({
  reactions,
  onToggle,
  quickPicks = DEFAULT_PICKS,
  onAdd,
  className,
  renderTooltip,
}: EmojiReactionsProps): JSX.Element

• props — Component props (see {@link EmojiReactionsProps}).

Injection Notes

Requirements

Peer dependencies:

• @molecule/app-react ^1.0.1
• @molecule/app-ui ^1.0.1
• @molecule/app-ui-react ^1.0.1
• react ^18.0.0 || ^19.0.0

Runtime Dependencies

• @molecule/app-react

• @molecule/app-ui

• @molecule/app-ui-react

• react

• Fully controlled: the component renders reactions as given and emits onToggle / onAdd — it never mutates counts itself.

• The "+" button and quick-pick popover render only when onAdd is passed. Default quick picks: 👍 ❤️ 🎉 😄 😢 🙏 (override via quickPicks).

• renderTooltip(r) renders custom tooltip content (e.g. an avatar list of who reacted) in a role="tooltip" element revealed on hover / focus of the chip; it replaces the default "<count> reactions" title. Return a nullish value for a given chip to keep the default title.

• All user-facing text is translatable: the default count title resolves through t('reactions.count') and the add-button label through t('reactions.add'), both with English fallbacks — companion locale bond: @molecule/app-locales-emoji-reactions.

• Every interactive element carries a data-mol-id: emoji-reaction on each chip, emoji-reaction-add on the "+" button, emoji-reaction-pick on each quick-pick.

• Requires a wired ClassMap bond and the app I18nProvider (standard molecule app setup).

Translations

Translation strings are provided by @molecule/app-locales-emoji-reactions.