# ImageFirework — Launch Burst Fade (API)

A procedural ComfyUI workflow that transforms an input image into a staged night-firework animation: launch shell → primary burst → delayed secondary wave → gravity-driven residual tails → local particle/smoke reveal.

## What is included

- `ImageFirework_LaunchBurstFade_API.json`

- `source_complex.png` — the input image used for the reference result

- README and v13 verification metadata

## Requirements

- ComfyUI

- `ComfyUI-ShatterWorld` with the v13 `ImageFirework` node

## Usage

1. Copy `source_complex.png` to the ComfyUI `input/` folder.

2. Load the API workflow.

3. Ensure the LoadImage node points to `source_complex.png`.

4. Execute the workflow.

The default animation uses 180 frames at a 24 fps reference rate. The source image is not shown during the launch; it forms after the burst from local particles and smoke.

## Visual result

The primary break uses a warm gold/white Willow structure with a delayed secondary wave and falling residual tails. The final image forms continuously from a local particle mosaic rather than a global hard cut.

## Verification

This v13 implementation passed the full ComfyUI-ShatterWorld regression suite: `21/21 PASS`. The workflow was executed through the live ComfyUI API and visually inspected.

## Notes

This is a deterministic procedural effect, not a model-generated photographic firework. It is designed for temporally coherent, stylized firework-to-image reveals. No credentials or API keys are included.