clipwise 0.4.1 → 0.5.0

package/README.ko.md

@@ -8,7 +8,7 @@ YAML 시나리오를 작성하면 시네마틱 데모 영상(MP4/GIF)을 자동
   <img src="https://kwakseongjae.github.io/clipwise/demo.gif" alt="Clipwise 데모" width="100%" />
 </p>
 
-> *`npx clipwise demo` 한 줄로 생성된 영상입니다.*
+> *`npx clipwise demo` 한 줄로 생성된 영상입니다 — YAML 파일 1개, 239줄.*
 
 ## 빠른 시작
 
@@ -184,15 +184,25 @@ steps:
 
 ### 줌
 
-적응형 줌 — 커서를 따라가며 클릭 대상에 자동 줌인.
+적응형 줌 — 커서를 따라가며 클릭 대상에 자동 줌인. 강도 프리셋 또는 숫자 스케일로 설정.
 
 ```yaml
 zoom:
   enabled: true
-  scale: 1.8          # 최대 줌 (1-5)
+  intensity: moderate  # subtle | light | moderate | strong | dramatic
+                       # 1.15x  | 1.25x | 1.35x    | 1.5x   | 1.8x
+  # scale: 1.35       # 숫자로 직접 지정할 때 사용 (intensity 미설정 시)
   duration: 500        # 애니메이션 ms
 ```
 
+| 강도 | 스케일 | 권장 사용처 |
+|------|--------|------------|
+| `subtle` | 1.15× | 정보 밀도 높은 UI, 큰 화면 |
+| `light` | 1.25× | Loom 스타일 부드러운 줌 (권장) |
+| `moderate` | 1.35× | 균형잡힌 기본값 (Camtasia 수준) |
+| `strong` | 1.5× | 명확한 포커스 |
+| `dramatic` | 1.8× | 최대 강조, 단순 UI 전용 |
+
 ### 커서
 
 커스텀 커서 + 클릭 리플 + 트레일 + 하이라이트 + 속도 조절.
@@ -240,13 +250,17 @@ deviceFrame:
 
 ### 키스트로크 HUD
 
-타이핑 내용을 화면 하단에 표시.
+화면 하단에 타이핑 내용을 표시하는 HUD. 기본값은 수정키+단축키만 표시 (Screen Studio, KeyCastr, ScreenFlow 등 업계 표준). `showTyping: true`로 일반 타이핑 내용도 표시 가능.
+
+여러 입력 필드에 걸쳐 입력할 때는 각 필드가 별도 줄로 표시됩니다 (최대 3줄, 오래된 줄은 흐리게).
 
 ```yaml
 keystroke:
   enabled: true
+  showTyping: true       # 타이핑 내용 표시 (기본값: false — 단축키만)
   position: bottom-center
   fontSize: 16
+  fadeAfter: 1500
 ```
 
 ### 워터마크
@@ -276,16 +290,17 @@ speedRamp:
 
 **Apple M1 Max (10코어)** 기준 — Pulse Dashboard 데모, 44초 @ 30fps, 1280×800:
 
-| 단계 | v0.3.0 | v0.4.0 | 변화 |
-|------|--------|--------|------|
-| 녹화 | 30.8 s | 31.1 s | — |
-| 합성 + 인코딩 | 97.2 s | 60.6 s | **−38%** |
-| **전체** | **127.9 s** | **91.7 s** | **−28%** |
-| ms / 프레임 | 69 ms | 67 ms | −3% |
-| 캡처 프레임 수 | 1,303 | 902 | −31% (중복 제거) |
+| 단계 | v0.3.0 | v0.4.0 | v0.5.0 |
+|------|--------|--------|--------|
+| 녹화 | 30.8 s | 31.1 s | 31.1 s |
+| 합성 + 인코딩 | 97.2 s | 60.6 s | 60.6 s |
+| **전체** | **127.9 s** | **91.7 s** | **91.7 s** |
+| 캡처 프레임 수 | 1,303 | 902 | 902 |
 
 v0.4.0 주요 최적화: 동시 스트리밍 파이프라인, 정적 프레임 중복 제거(~33% 건너뜀), 워커별 StaticLayers 캐시, raw RGBA 버퍼 파이프라인.
 
+v0.5.0은 **녹화 품질** 개선에 집중: CSS 트랜지션 억제로 커서 부드러운 이동, 줌 강도 프리셋, 멀티세션 키스트로크 HUD.
+
 ## 출력 압축
 
 `preset` 필드로 화질과 파일 크기를 조절합니다:

package/README.md

@@ -8,7 +8,7 @@ Scriptable cinematic screen recorder for product demos — YAML in, polished MP4
   <img src="https://kwakseongjae.github.io/clipwise/demo.gif" alt="Clipwise demo" width="100%" />
 </p>
 
-> *Generated with `npx clipwise demo` — zero config, one command.*
+> *Generated with `npx clipwise demo` — 1 YAML file, 239 lines, one command.*
 
 ## Quick Start
 
@@ -189,15 +189,24 @@ Adaptive zoom follows cursor and zooms in on click targets.
 ```yaml
 zoom:
   enabled: true
-  scale: 1.8          # Peak zoom level (1-5)
+  intensity: moderate  # subtle | light | moderate | strong | dramatic
+                       # 1.15x  | 1.25x | 1.35x    | 1.5x   | 1.8x
+  # scale: 1.35       # Override with a numeric value instead of intensity
   duration: 500        # Zoom animation ms
   autoZoom:
     followCursor: true
-    maxScale: 2.0
     transitionDuration: 300
     padding: 200
 ```
 
+| Intensity | Scale | Best for |
+|-----------|-------|----------|
+| `subtle` | 1.15× | Dense UIs, large viewports |
+| `light` | 1.25× | Loom-style gentle pull-in (recommended) |
+| `moderate` | 1.35× | Balanced default — Camtasia range |
+| `strong` | 1.5× | Clear focus, some context sacrificed |
+| `dramatic` | 1.8× | Maximum emphasis, sparse UIs only |
+
 ### Cursor
 
 Custom cursor with click ripple, trail, glow highlight, and speed control.
@@ -248,11 +257,14 @@ deviceFrame:
 
 ### Keystroke HUD
 
-Displays typed keys at the bottom of the screen.
+Displays a HUD at the bottom of the screen showing what was typed. By default, only modifier+key shortcuts are shown (industry standard — same as Screen Studio, KeyCastr, ScreenFlow). Set `showTyping: true` to also show regular typed text.
+
+When typing across multiple input fields, each field gets its own line in the HUD (up to 3 recent sessions, oldest dimmed at top, newest bright at bottom).
 
 ```yaml
 keystroke:
   enabled: true
+  showTyping: true       # show typed text (default: false — shortcuts only)
   position: bottom-center
   fontSize: 16
   fadeAfter: 1500
@@ -285,16 +297,17 @@ speedRamp:
 
 Measured on **Apple M1 Max (10 cores)** — Pulse Dashboard demo, 44s @ 30fps, 1280×800:
 
-| Stage | v0.3.0 | v0.4.0 | Change |
+| Stage | v0.3.0 | v0.4.0 | v0.5.0 |
 |-------|--------|--------|--------|
-| Recording | 30.8 s | 31.1 s | — |
-| Compose + Encode | 97.2 s | 60.6 s | **−38%** |
-| **Total** | **127.9 s** | **91.7 s** | **−28%** |
-| ms / frame | 69 ms | 67 ms | −3% |
-| Frames captured | 1,303 | 902 | −31% (dedup) |
+| Recording | 30.8 s | 31.1 s | 31.1 s |
+| Compose + Encode | 97.2 s | 60.6 s | 60.6 s |
+| **Total** | **127.9 s** | **91.7 s** | **91.7 s** |
+| Frames captured | 1,303 | 902 | 902 |
 
 Key optimisations in v0.4.0: concurrent streaming pipeline, static frame deduplication (~33% skipped), per-worker StaticLayers cache, and raw RGBA buffer pipeline.
 
+v0.5.0 focuses on **recording quality** rather than throughput: smooth cursor movement (CSS transition suppression), zoom intensity presets, and multi-session keystroke HUD.
+
 ## Output Compression
 
 Use the `preset` field to control quality and file size: