mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-19 11:26:02 +00:00
Adds the 25 video primitive compositions and their generated Mintlify pages. Each page embeds a live <hyperframes-player> preview with editable composition variables rather than a rendered MP4. Adds the catalog-browsing eval under evals/catalog-retrieval: a 424-entry shelf built from HEAD, nine retrieval conditions (no-catalog control, full read, lexical, semantic, and hybrid across several values of k), a brief generator that constructs each brief from a known target, a blind three-pass gold validation committee, and a mechanical scorer that keeps mountable and fit as two separate numbers. The eval vendors its own shelf, primitive sources, and preview list instead of reading them from an ignored working directory, so the shelf regenerates byte for byte from a clean checkout. Derived artifacts stay out: the embedding cache and the run checkpoints are regenerated rather than committed, so no run can score against a stale copy of either. Lint ignores now cover vendored minified player bundles by pattern instead of one path at a time.
45 lines
1.6 KiB
Plaintext
45 lines
1.6 KiB
Plaintext
---
|
|
title: "State Chip Rail"
|
|
description: "A row of status chips snaps through ordered states on scheduled cues while active, completed, and pending chips take distinct appearances."
|
|
---
|
|
|
|
import { PrimitivePlayer } from "/snippets/PrimitivePlayer.jsx";
|
|
|
|
<span className="hf-primitive-eyebrow">Process sequences</span>
|
|
|
|
<PrimitivePlayer name="state-chip-rail" width={1920} height={1080} />
|
|
|
|
## Variables
|
|
|
|
| Name | Type | Default | Description |
|
|
| --- | --- | --- | --- |
|
|
| `states` | `string` | `Queued,Reading,Drafting,Done` | Comma-separated chip labels in machine order (2 to 8 states). |
|
|
| `times` | `string` | `""` | Comma-separated activation times in seconds, one per advance (state 1 onward). Blank entries use the default even rhythm. |
|
|
| `badge_state` | `number` | `1` | Index of the state the badges pop beside. |
|
|
| `badges` | `string` | `""` | Comma-separated badge labels shown beside the badge state. Empty disables. |
|
|
| `accent` | `enum` | `green` | Accent token family used by the active chip. |
|
|
| `exit` | `enum` | `none` | How the rail leaves the frame. Default none: the hold ends the film. |
|
|
|
|
## When to use it
|
|
|
|
A discrete state machine needs seek-exact, instantaneous advances and optional badges beside one activated state.
|
|
|
|
## When to avoid it
|
|
|
|
Avoid it when more than eight states or more than four badges are required, because extra states are dropped and badges are capped at four.
|
|
|
|
## Pairs with
|
|
|
|
- [pill-row-collapse](/primitives/pill-row-collapse)
|
|
- [press-ripple](/primitives/press-ripple)
|
|
|
|
## Install
|
|
|
|
<CodeGroup>
|
|
|
|
```bash Terminal
|
|
npx hyperframes add state-chip-rail
|
|
```
|
|
|
|
</CodeGroup>
|