# Text wobble

Component. Use for a working state: the glyphs of a short label bob on their own phases. At a chosen time the label shrinks to a point, swaps to the done text and pops back with a slight overshoot, then fades. Pair it with an orb or a blur reveal.

## 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-wobble" data-composition-src="compositions/text-wobble.html"
     data-start="0" data-duration="3" 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 | `Generating` | Up to 30 characters | Text while working. |
| `doneText` | string | content | `Done!` | Up to 30 characters | Text swapped in at done time. Empty for no swap. |
| `doneAt` | number | timing | `1.7` | 0.3 through 20 | Seconds until the swap. |
| `fadeAfter` | number | timing | `0.75` | -1 through 10 | Seconds after done before the label fades. Negative keeps it. |
| `amplitude` | number | motion | `7` | 0 through 30 | Bob height as percent of the font size. |
| `period` | number | timing | `0.4` | 0.1 through 2 | Seconds per bob. |
| `align` | enum | layout | `left` | `left`, `center` | Where the label sits. |
| `size` | number | layout | `40` | 3 through 60 | Font size as percent of host height. |
| `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. |
| `seed` | number | motion | `9` | 1 through 999 | Bob phases. |

## Package

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