hyperframes 0.4.43 → 0.4.45
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +1693 -523
- package/dist/docs/compositions.md +35 -7
- package/dist/hyperframe-runtime.js +30 -20
- package/dist/hyperframe.manifest.json +1 -1
- package/dist/hyperframe.runtime.iife.js +30 -20
- package/dist/skills/hyperframes/SKILL.md +85 -10
- package/dist/skills/hyperframes/patterns.md +73 -0
- package/dist/skills/hyperframes/references/transcript-guide.md +1 -45
- package/dist/skills/hyperframes-cli/SKILL.md +18 -27
- package/dist/studio/assets/{hyperframes-player-vibA20NC.js → hyperframes-player-Cd8vYWxP.js} +2 -2
- package/dist/studio/assets/{index-Dzq4sUj7.js → index-DpPtpTye.js} +16 -16
- package/dist/studio/index.html +1 -1
- package/dist/templates/_shared/CLAUDE.md +2 -1
- package/package.json +4 -2
- package/dist/skills/hyperframes/references/tts.md +0 -75
package/dist/studio/index.html
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
<meta charset="UTF-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
|
|
6
6
|
<title>HyperFrames Studio</title>
|
|
7
|
-
<script type="module" crossorigin src="/assets/index-
|
|
7
|
+
<script type="module" crossorigin src="/assets/index-DpPtpTye.js"></script>
|
|
8
8
|
<link rel="stylesheet" crossorigin href="/assets/index-BLrgRQSu.css">
|
|
9
9
|
</head>
|
|
10
10
|
<body>
|
|
@@ -7,7 +7,8 @@
|
|
|
7
7
|
| Skill | Command | When to use |
|
|
8
8
|
| -------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------- |
|
|
9
9
|
| **hyperframes** | `/hyperframes` | Creating or editing HTML compositions, captions, TTS, audio-reactive animation, marker highlights |
|
|
10
|
-
| **hyperframes-cli** | `/hyperframes-cli` | CLI
|
|
10
|
+
| **hyperframes-cli** | `/hyperframes-cli` | Dev-loop CLI: init, lint, inspect, preview, render, doctor |
|
|
11
|
+
| **hyperframes-media** | `/hyperframes-media` | Asset preprocessing: tts (Kokoro), transcribe (Whisper), remove-background (u2net) |
|
|
11
12
|
| **hyperframes-registry** | `/hyperframes-registry` | Installing blocks and components via `hyperframes add` |
|
|
12
13
|
| **website-to-hyperframes** | `/website-to-hyperframes` | Capturing a URL and turning it into a video — full website-to-video pipeline |
|
|
13
14
|
| **tailwind** | `/tailwind` | Tailwind v4 browser-runtime styles for projects created with `hyperframes init --tailwind` |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hyperframes",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.45",
|
|
4
4
|
"description": "HyperFrames CLI — create, preview, and render HTML video compositions",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -33,10 +33,12 @@
|
|
|
33
33
|
"giget": "^3.2.0",
|
|
34
34
|
"hono": "^4.0.0",
|
|
35
35
|
"mime-types": "^3.0.2",
|
|
36
|
+
"onnxruntime-node": "^1.20.0",
|
|
36
37
|
"open": "^10.0.0",
|
|
37
38
|
"postcss": "^8.5.8",
|
|
38
39
|
"prettier": "^3.8.1",
|
|
39
|
-
"puppeteer-core": "^24.39.1"
|
|
40
|
+
"puppeteer-core": "^24.39.1",
|
|
41
|
+
"sharp": "^0.34.0"
|
|
40
42
|
},
|
|
41
43
|
"devDependencies": {
|
|
42
44
|
"@clack/prompts": "^1.1.0",
|
|
@@ -1,75 +0,0 @@
|
|
|
1
|
-
# Text-to-Speech
|
|
2
|
-
|
|
3
|
-
Generate speech audio locally using Kokoro-82M (no API key, runs on CPU).
|
|
4
|
-
|
|
5
|
-
## Voice Selection
|
|
6
|
-
|
|
7
|
-
Match voice to content. Default is `af_heart`.
|
|
8
|
-
|
|
9
|
-
| Content type | Voice | Why |
|
|
10
|
-
| ------------- | --------------------- | -------------------------- |
|
|
11
|
-
| Product demo | `af_heart`/`af_nova` | Warm, professional |
|
|
12
|
-
| Tutorial | `am_adam`/`bf_emma` | Neutral, easy to follow |
|
|
13
|
-
| Marketing | `af_sky`/`am_michael` | Energetic or authoritative |
|
|
14
|
-
| Documentation | `bf_emma`/`bm_george` | Clear British English |
|
|
15
|
-
| Casual | `af_heart`/`af_sky` | Approachable, natural |
|
|
16
|
-
|
|
17
|
-
Run `npx hyperframes tts --list` for all 54 voices (8 languages).
|
|
18
|
-
|
|
19
|
-
## Multilingual Phonemization
|
|
20
|
-
|
|
21
|
-
Kokoro voice IDs encode language in the first letter: `a`=American English, `b`=British English, `e`=Spanish, `f`=French, `h`=Hindi, `i`=Italian, `j`=Japanese, `p`=Brazilian Portuguese, `z`=Mandarin. The CLI auto-detects the phonemizer locale from that prefix — you don't need to pass `--lang` when the voice matches the text.
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
npx hyperframes tts "La reunión empieza a las nueve" --voice ef_dora --output es.wav
|
|
25
|
-
npx hyperframes tts "今日はいい天気ですね" --voice jf_alpha --output ja.wav
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
Use `--lang` only to override auto-detection (e.g. stylized accents):
|
|
29
|
-
|
|
30
|
-
```bash
|
|
31
|
-
npx hyperframes tts "Hello there" --voice af_heart --lang fr-fr --output accented.wav
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
Valid `--lang` codes: `en-us`, `en-gb`, `es`, `fr-fr`, `hi`, `it`, `pt-br`, `ja`, `zh`.
|
|
35
|
-
|
|
36
|
-
Non-English phonemization requires `espeak-ng` installed system-wide (`brew install espeak-ng` on macOS, `apt-get install espeak-ng` on Debian/Ubuntu).
|
|
37
|
-
|
|
38
|
-
## Speed Tuning
|
|
39
|
-
|
|
40
|
-
- **0.7-0.8** — Tutorial, complex content
|
|
41
|
-
- **1.0** — Natural pace (default)
|
|
42
|
-
- **1.1-1.2** — Intros, upbeat content
|
|
43
|
-
- **1.5+** — Rarely appropriate
|
|
44
|
-
|
|
45
|
-
## Usage
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
npx hyperframes tts "Your script here" --voice af_nova --output narration.wav
|
|
49
|
-
npx hyperframes tts script.txt --voice bf_emma --output narration.wav
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
In compositions:
|
|
53
|
-
|
|
54
|
-
```html
|
|
55
|
-
<audio
|
|
56
|
-
id="narration"
|
|
57
|
-
data-start="0"
|
|
58
|
-
data-duration="auto"
|
|
59
|
-
data-track-index="2"
|
|
60
|
-
src="narration.wav"
|
|
61
|
-
data-volume="1"
|
|
62
|
-
></audio>
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
## TTS + Captions Workflow
|
|
66
|
-
|
|
67
|
-
```bash
|
|
68
|
-
npx hyperframes tts script.txt --voice af_heart --output narration.wav
|
|
69
|
-
npx hyperframes transcribe narration.wav # → transcript.json with word-level timestamps
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
## Requirements
|
|
73
|
-
|
|
74
|
-
- Python 3.8+ with `kokoro-onnx` and `soundfile`
|
|
75
|
-
- Model downloads on first use (~311 MB + ~27 MB voices, cached in `~/.cache/hyperframes/tts/`)
|