feat(react): add stable lifecycle events

[aryasaatvik]

Summary

• expose structured lifecycle events through DomainKit.Root
• keep the latest host callback without restarting the managed runtime
• publish events only after canonical state changes and isolate observer failures

<DomainKit.Root
  onEvent={(event) => analytics.track(event._tag, event)}
  transport={transport}
>
  {children}
</DomainKit.Root>

successful mutation -> canonical state update -> best-effort host event

Validation

• React package typecheck
• 54 React unit tests
• repository lint, format, and diff checks

[github-actions]

Tegami

This repository uses Tegami to manage releases. When your changes affect published packages, add a changelog file under .tegami/ before merging.

Create a changelog → · Changelog format

Release preview

Package	Bump	Version
domainkit	minor	0.3.1 → 0.4.0
@domainkit/react	minor	0.3.1 → 0.4.0

Changelogs in this PR

Changelog	Title
react-lifecycle-events.md	Expose structured lifecycle events

Run bun run tegami locally to create a changelog interactively.

_{Managed by Tegami.}

[greptile-apps]

Greptile Summary

The PR exposes structured lifecycle events from DomainKit.Root, keeps event delivery independent of managed runtime identity, and isolates host-observer exceptions.

• Adds public event types for connection, disconnection, provisioning, and cleanup outcomes.
• Emits events after canonical state updates.
• Synchronizes the latest committed listener through a layout effect without rebuilding active models.
• Adds coverage for listener updates, observer failures, and provisioning callback ordering.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
packages/react/src/domain-kit.tsx	Adds a stable emitter backed by the latest listener committed in a layout effect; the previously reported render-phase and passive-effect listener windows are resolved.
packages/react/src/lifecycle.ts	Defines and exports the structured lifecycle-event union and listener contract.
packages/react/src/provisioning.tsx	Emits apply outcomes before invoking the existing flow callback, resolving the previously reported event-suppression path.
packages/react/src/connection.tsx	Publishes successful connection, reuse, and disconnection lifecycle events after updating state.
packages/react/src/cleanup.tsx	Publishes successful and partial cleanup events after canonical cleanup state changes.
packages/react/tests/lifecycle-events.test.tsx	Covers stable listener replacement, observer exception isolation, and provisioning event ordering.

Sequence Diagram

sequenceDiagram
  participant User
  participant Flow as DomainKit flow
  participant Transport
  participant State as Canonical state
  participant Host as Root onEvent
  User->>Flow: Start mutation
  Flow->>Transport: Execute request
  Transport-->>Flow: Successful result
  Flow->>State: Commit result
  Flow->>Host: Emit structured lifecycle event
  Note over Flow,Host: Observer failures are contained

Loading

_{Reviews (5): Last reviewed commit: "chore(release): note React lifecycle eve..." | Re-trigger Greptile}