# Text scatter

Component. Use when a line should feel thrown into place: words arrive from scattered offsets, each at its own size, height and blur, and converge onto one baseline with a small overshoot. Optional settle from oversized. Exits: none, demote (grey and shrink), fade.

## Mount

Fills its host box: give the host element the size and position you want, the component sizes everything in container units (percent of the host). No fixed canvas.

```html
<div data-composition-id="text-scatter" data-composition-src="compositions/text-scatter.html"
     data-start="0" data-duration="2.5" data-track-index="2"
     data-variable-values='{ "...": "..." }'
     style="position:absolute;left:300px;top:405px;width:1320px;height:195px"></div>
```

## Slots

No HTML slot; content comes from variables.

## Variables

| Variable | Type | Role | Default | Accepted | What changes |
| --- | --- | --- | --- | --- | --- |
| `text` | string | content | `What would you like to create?` | Up to 80 characters | One line of words. |
| `align` | enum | layout | `center` | `center`, `left`, `right` | Where the text sits in the host. |
| `size` | number | layout | `8` | 3 through 60 | Font size as percent of the host height. |
| `spread` | number | motion | `1` | 0 through 2 | How far words start from rest, 0 to 2. |
| `scaleMax` | number | motion | `2` | 1 through 4 | Largest starting scale of a word. |
| `settle` | number | motion | `1` | 1 through 1.6 | Scale the aligned line holds before easing to 1 (1 = no settle). |
| `exit` | enum | motion | `none` | `none`, `demote`, `fade` | none, demote, fade. |
| `grey` | color | style | `#9c969a` | Hex or `transparent` | Colour of the demote exit. |
| `ground` | color | style | `transparent` | Hex or `transparent` | Background; transparent to overlay. |
| `ink` | color | style | `#1a1418` | Hex or `transparent` | Resolved text colour. |
| `font` | font | style | `"Instrument Serif",Georgia,serif` | CSS font-family stack | Display face. Instrument Serif ships with the component. |
| `inAt` | number | timing | `0.04` | 0 through 10 | Seconds before the first word. |
| `seed` | number | motion | `5` | 1 through 999 | Scatter pattern. |

## Package

`index.html` is a demo host at 1920 by 1080; `compositions/text-scatter.html` is the template entry; `assets/` holds GSAP, Instrument Serif and demo SVGs. One paused GSAP timeline on `window.__timelines["text-scatter"]`. Generated from `_kit/components-*.mjs`; run `node packages/compositions/library/_kit/build-components.mjs` after editing.