clipwise 0.7.1 → 0.7.2

package/README.ko.md

@@ -5,10 +5,10 @@
 YAML 시나리오를 작성하면 시네마틱 데모 영상(MP4/GIF)을 자동으로 만들어주는 스크린 레코더. Playwright CDP 기반.
 
 <p align="center">
-  <video src="https://github.com/user-attachments/assets/bfd3910d-3449-4d04-b95a-52bea1f16025" autoplay loop muted playsinline width="100%"></video>
+  <video src="https://github.com/user-attachments/assets/800d956f-ecf3-40c4-8750-c93b34285f11" autoplay loop muted playsinline width="100%"></video>
 </p>
 
-> *`npx clipwise demo` 한 줄로 생성된 영상입니다 — YAML 파일 1개, 239줄.*
+> *`npx clipwise demo` 한 줄로 생성된 영상입니다 — YAML 파일 1개, 248줄.*
 
 ## 빠른 시작
 

package/README.md

@@ -5,10 +5,10 @@
 Scriptable cinematic screen recorder for product demos — YAML in, polished MP4 out. Powered by Playwright CDP.
 
 <p align="center">
-  <video src="https://github.com/user-attachments/assets/bfd3910d-3449-4d04-b95a-52bea1f16025" autoplay loop muted playsinline width="100%"></video>
+  <video src="https://github.com/user-attachments/assets/800d956f-ecf3-40c4-8750-c93b34285f11" autoplay loop muted playsinline width="100%"></video>
 </p>
 
-> *Generated with `npx clipwise demo` — 1 YAML file, 239 lines, one command.*
+> *Generated with `npx clipwise demo` — 1 YAML file, 248 lines, one command.*
 
 ## Quick Start
 
@@ -154,7 +154,7 @@ steps:
 |--------|-----------|---------|-------------|
 | `navigate` | `url`, `waitUntil?` | `waitUntil: "networkidle"` | Navigate to URL |
 | `click` | `selector`, `delay?`, `timeout?` | | Click an element |
-| `type` | `selector`, `text`, `delay?`, `timeout?` | `delay: 50` | Type text (char-by-char) |
+| `type` | `selector`, `text`, `delay?`, `timeout?` | `delay: 50` | Type text (char-by-char, React/Vue compatible) |
 | `hover` | `selector`, `timeout?` | | Hover over element |
 | `scroll` | `y?`, `x?`, `selector?`, `smooth?`, `timeout?` | `y: 0`, `x: 0`, `smooth: true` | Scroll by offset |
 | `wait` | `duration` | | Wait (ms) |
@@ -164,13 +164,15 @@ steps:
 
 | Action | Parameters | Default | Description |
 |--------|-----------|---------|-------------|
-| `waitForSelector` | `selector`, `state?`, `timeout?` | `state: "visible"`, `timeout: 15000` | Wait for element state |
-| `waitForNavigation` | `waitUntil?`, `timeout?` | `waitUntil: "networkidle"`, `timeout: 15000` | Wait for page load |
-| `waitForURL` | `url`, `timeout?` | `timeout: 15000` | Wait for URL match |
-| `waitForFunction` | `expression`, `polling?`, `timeout?` | `polling: "raf"`, `timeout: 30000` | Wait for JS expression to be truthy |
-| `waitForResponse` | `url`, `status?`, `timeout?` | `timeout: 30000` | Wait for network response (URL substring match) |
+| `waitForSelector` | `selector`, `state?`, `timeout?`, `captureWhileWaiting?`, `displaySpeed?` | `state: "visible"`, `timeout: 15000` | Wait for element state |
+| `waitForNavigation` | `waitUntil?`, `timeout?`, `captureWhileWaiting?`, `displaySpeed?` | `waitUntil: "networkidle"`, `timeout: 15000` | Wait for page load |
+| `waitForURL` | `url`, `timeout?`, `captureWhileWaiting?`, `displaySpeed?` | `timeout: 15000` | Wait for URL match |
+| `waitForFunction` | `expression`, `polling?`, `timeout?`, `captureWhileWaiting?`, `displaySpeed?` | `polling: "raf"`, `timeout: 30000` | Wait for JS expression to be truthy |
+| `waitForResponse` | `url`, `status?`, `timeout?`, `captureWhileWaiting?`, `displaySpeed?` | `timeout: 30000` | Wait for network response (URL substring match) |
 | `smartWait` | `until`, `selector?`, `timeout?`, `displaySpeed?` | `until: "networkIdle"`, `timeout: 30000`, `displaySpeed: 8` | Smart wait — records real wait, auto-speeds in output |
 
+**`captureWhileWaiting`**: When `true`, continuously captures frames during the wait (like `smartWait`). Useful for recording loading animations, progress bars, streaming responses. Pairs with `displaySpeed` (1-32, default: 8) to auto-compress wait frames in the output.
+
 **`waitUntil`** options: `"load"`, `"domcontentloaded"`, `"networkidle"` (default)
 **`state`** options: `"visible"` (default), `"attached"`, `"hidden"`
 **`polling`** options: `"raf"` (requestAnimationFrame, default) or milliseconds (e.g. `500`)
@@ -213,6 +215,29 @@ For slower, cinematic demos:
 - `holdDuration: 1500-2500` ms
 - `type.delay: 40-60` ms per character
 
+### Authentication
+
+Record pages behind login by restoring a browser session. Supports Playwright's `storageState` file (recommended) or inline cookies.
+
+```yaml
+# Option 1: Playwright storageState file (cookies + localStorage)
+auth:
+  storageState: ./auth-state.json
+
+# Option 2: Inline cookies
+auth:
+  cookies:
+    - name: session_id
+      value: abc123
+      domain: .example.com
+```
+
+Generate a `storageState` file by logging in interactively:
+
+```bash
+npx playwright codegen --save-storage=auth-state.json https://my-app.com
+```
+
 ## Effects
 
 All effects are optional and have sensible defaults.
@@ -297,7 +322,7 @@ deviceFrame:
 
 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).
+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). CJK text (Korean, Chinese, Japanese) is automatically wrapped to fit the screen width.
 
 ```yaml
 keystroke: