@pygmalionjs/pygmalion 0.2.18 → 0.2.20

package/README.ko.md

@@ -86,6 +86,25 @@ export default defineConfig({
 `PYGMALION_PREVIEW_MODE=1`을 사용하면 통합 플러그인이 재귀적으로 실행되지
 않습니다.
 
+## 지원하는 폭에서 프레임 확인하기
+
+프레임은 모서리를 끌거나 W/H 입력으로 크기를 바꿉니다. 여기에 애플리케이션이
+실제로 보장하는 폭에 이름을 붙여 두면, 그 입력 옆에 버튼으로 놓입니다. 숫자를
+외우지 않아도 폭 사이를 오갈 수 있습니다.
+
+```tsx
+<PygmalionEditor
+  viewportPresets={[
+    { label: '480', width: 480, height: 800, description: '지원 최소 폭' },
+    { label: '기본', width: 1280, height: 800 },
+  ]}
+/>
+```
+
+`height`를 빼면 폭만 바꾸고 높이는 그대로 둡니다. 프레임이 그 크기에 있는 동안
+버튼은 눌린 상태로 보이고, **Reset to default size**는 여전히 매니페스트가 선언한
+뷰포트로 되돌립니다.
+
 ## 화면과 시나리오 등록
 
 애플리케이션별 라우트, fixture, 인증, 목 데이터, 화면 이름은 호스트가

package/README.md

@@ -154,6 +154,45 @@ unapplied edits, `switchSource` refuses rather than leave the canvas on a
 revision those edits were never written against — apply or revert them first, or
 pass `{ discardEdits: true }`.
 
+## Check a frame at the widths you support
+
+A frame resizes by corner drag or by the W/H boxes. Name the widths your
+application actually guarantees and they become one-click buttons next to those
+boxes, so moving between them costs nothing to remember:
+
+```tsx
+<PygmalionEditor
+  viewportPresets={[
+    { label: '480', width: 480, height: 800, description: 'Minimum supported width' },
+    { label: 'Default', width: 1280, height: 800 },
+  ]}
+/>
+```
+
+Omit `height` to change width alone and leave the frame's height as it is. The
+button reads as active while the frame sits at that size, and **Reset to default
+size** still returns the frame to the viewport its manifest authored.
+
+### Screens that never stop moving
+
+A capture waits for the document to hold still. A screen with an elapsed clock, a
+level meter, or a marquee never does, so it fails on `stabilize` no matter how
+long it waits. Declare those regions and their mutations stop counting as churn:
+
+```ts
+captureStoryboardCase({
+  // ...
+  stability: {
+    volatileSelectors: ['[data-testid="elapsed-time"]', '[data-live-meter]'],
+  },
+});
+```
+
+The wait itself samples every 100ms and needs three identical samples, up to a
+4s ceiling — wide enough for a screen that repaints on a one-second beat.
+`attempts`, `requiredStableSamples`, `intervalMs`, and `minimumWaitMs` are
+adjustable for anything slower.
+
 ## Register screens and scenarios
 
 The host owns application-specific routes, fixtures, authentication, mock data,