# Particle lifecycle events
Handle the discriminated event and diagnostic records.

## APIs demonstrated

- [PibblParticleBurstAcceptedEvent](/reference/types/particles/) from `@pibbl/core/particles`
- [PibblParticleBurstRejectedEvent](/reference/types/particles/) from `@pibbl/core/particles`
- [PibblParticleDiagnostic](/reference/types/particles/) from `@pibbl/core/particles`
- [PibblParticleDrainStartEvent](/reference/types/particles/) from `@pibbl/core/particles`
- [PibblParticleFinishEvent](/reference/types/particles/) from `@pibbl/core/particles`
- [PibblParticleStartEvent](/reference/types/particles/) from `@pibbl/core/particles`
- [PibblParticleSystemEvent](/reference/types/particles/) from `@pibbl/core/particles`

## Complete example

[Plain source](/minimal/particles/events.ts). Run as a browser module after the document body exists. TSX uses `jsx: "react-jsx"` and `jsxImportSource: "@pibbl/core"`.

```ts
import {
  type PibblParticleBurstAcceptedEvent,
  type PibblParticleBurstRejectedEvent,
  type PibblParticleDiagnostic,
  type PibblParticleDrainStartEvent,
  type PibblParticleFinishEvent,
  type PibblParticleStartEvent,
  type PibblParticleSystemEvent,
} from "@pibbl/core/particles";

const started: PibblParticleStartEvent = { type: "start" };
const accepted: PibblParticleBurstAcceptedEvent = {
  type: "burst-accepted",
  emitter: "spark",
  requested: 12,
  accepted: 12,
};
const rejected: PibblParticleBurstRejectedEvent = {
  type: "burst-rejected",
  emitter: "spark",
  requested: 12,
  accepted: 0,
  reason: "capacity",
};
const draining: PibblParticleDrainStartEvent = { type: "drain-start" };
const finished: PibblParticleFinishEvent = { type: "finish" };
const events: PibblParticleSystemEvent[] = [
  started,
  accepted,
  rejected,
  draining,
  finished,
];
const diagnostic: PibblParticleDiagnostic = {
  type: "capacity-rejected",
  message: "The emitter has reached its capacity.",
  emitter: rejected.emitter,
};

const output = document.createElement("pre");
output.textContent = [
  ...events.map((event) => event.type),
  diagnostic.message,
].join("\n");
document.body.append(output);

```

## Usage notes

- Displays the event sequence and diagnostic in the document.

## Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.