mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-17 15:24:19 +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.
46 lines
1.5 KiB
Plaintext
46 lines
1.5 KiB
Plaintext
---
|
|
title: "Press Ripple"
|
|
description: "A cursor decelerates onto a positioned target, compresses with it, releases two ripple rings, and exits while the pressed state remains."
|
|
---
|
|
|
|
import { PrimitivePlayer } from "/snippets/PrimitivePlayer.jsx";
|
|
|
|
<span className="hf-primitive-eyebrow">Interaction</span>
|
|
|
|
<PrimitivePlayer name="press-ripple" width={1920} height={1080} />
|
|
|
|
## Variables
|
|
|
|
| Name | Type | Default | Description |
|
|
| --- | --- | --- | --- |
|
|
| `label` | `string` | `Get started` | Text inside the default pill target. |
|
|
| `target_x` | `number` | `50` | Zone center, percent of host width. |
|
|
| `target_y` | `number` | `50` | Zone center, percent of host height. |
|
|
| `press_at` | `number` | `1.4` | Seconds from mount start when the press begins. |
|
|
| `cursor` | `enum` | `light` | Pointer tone. |
|
|
| `accent` | `enum` | `green` | Contract color for the ripple ink and pressed fill. |
|
|
| `exit` | `enum` | `none` | How the frame leaves. None holds the pressed state. |
|
|
|
|
## When to use it
|
|
|
|
A caller-supplied interface target needs one explicit press gesture with a visible impact and release.
|
|
|
|
## When to avoid it
|
|
|
|
Avoid cueing the press outside the safe gesture window, because press_at is clamped so arrival, compression, ripple, and exit all fit inside the duration.
|
|
|
|
## Pairs with
|
|
|
|
- [chevron-pill-card-morph](/primitives/chevron-pill-card-morph)
|
|
- [state-chip-rail](/primitives/state-chip-rail)
|
|
|
|
## Install
|
|
|
|
<CodeGroup>
|
|
|
|
```bash Terminal
|
|
npx hyperframes add press-ripple
|
|
```
|
|
|
|
</CodeGroup>
|