@triggery/reatom

Читай атом или computed из Reatom в условии Triggery. Pull-only: атом вызывается только при срабатывании триггера, ни один подписчик к нему не привязан.

Установка

pnpm

pnpm add @triggery/core @triggery/react @triggery/reatom @reatom/core

npm

npm install @triggery/core @triggery/react @triggery/reatom @reatom/core

yarn

yarn add @triggery/core @triggery/react @triggery/reatom @reatom/core

bun

bun add @triggery/core @triggery/react @triggery/reatom @reatom/core

Peer-зависимости: react >= 18.0.0, @reatom/core ^1000 || ^1001.

Что внутри

Экспорт	Назначение
useReatomCondition(trigger, name, atom, selector?)	Регистрирует условие на основе Reatom. Работает с любым вызываемым примитивом Reatom — атомами, computed, производными значениями.

Быстрый пример

import { atom } from '@reatom/core';
import { createTrigger } from '@triggery/core';
import { useReatomCondition } from '@triggery/reatom';

type Settings = { sound: boolean; notifications: boolean };

const $settings = atom<Settings>({ sound: true, notifications: true });

const messageTrigger = createTrigger<{
  events: { 'new-message': { text: string } };
  conditions: { settings: Settings };
  actions: { showToast: { body: string } };
}>({
  id: 'message-received',
  events: ['new-message'],
  required: ['settings'],
  handler({ event, conditions, actions }) {
    if (!conditions.settings.notifications) return;
    actions.showToast?.({ body: event.payload.text });
  },
});

function SettingsBridge() {
  useReatomCondition(messageTrigger, 'settings', $settings);
  return null;
}

С селектором-проекцией:

useReatomCondition(messageTrigger, 'settings', $profile, (p) => p.settings);

Как это работает

Pull-only: атом вызывается (atom()) только при срабатывании триггера. Подписчик не регистрируется, поэтому хост-компонент никогда не ререндерится на обновлениях атома. Для компонентов, которым нужно рендерить значение, используй собственные React-биндинги Reatom (reatomComponent, useAtom).

API

useReatomCondition<V, S, K>(
  trigger: Trigger<S>,
  name: K,
  atom: () => V,
  selector?: (value: V) => ConditionMap<S>[K],
): void

Связанные пакеты

@triggery/core Экспортирует Trigger.

@triggery/react useReatomCondition — это React-хук.

@triggery/jotai Альтернативный адаптер для состояния в форме атомов.

@triggery/signals Альтернативный адаптер для состояния в форме сигналов.

@triggery/zustand Адаптер для состояния в форме стора.

Исходники

• GitHub
• npm
• Changelog