clipwise 0.7.0 → 0.7.2

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/index.d.ts CHANGED
@@ -105,70 +105,102 @@ declare const StepActionSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
105
105
  selector: z.ZodString;
106
106
  state: z.ZodDefault<z.ZodEnum<["visible", "attached", "hidden"]>>;
107
107
  timeout: z.ZodDefault<z.ZodNumber>;
108
+ /** 대기 중 프레임 연속 캡처 (로딩 애니메이션 보존). */
109
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
110
+ /** captureWhileWaiting 사용 시 출력 영상 속도 배율 (1-32). */
111
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
108
112
  }, "strip", z.ZodTypeAny, {
109
113
  action: "waitForSelector";
110
114
  selector: string;
111
115
  timeout: number;
112
116
  state: "visible" | "attached" | "hidden";
117
+ captureWhileWaiting: boolean;
118
+ displaySpeed: number;
113
119
  }, {
114
120
  action: "waitForSelector";
115
121
  selector: string;
116
122
  timeout?: number | undefined;
117
123
  state?: "visible" | "attached" | "hidden" | undefined;
124
+ captureWhileWaiting?: boolean | undefined;
125
+ displaySpeed?: number | undefined;
118
126
  }>, z.ZodObject<{
119
127
  action: z.ZodLiteral<"waitForNavigation">;
120
128
  waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
121
129
  timeout: z.ZodDefault<z.ZodNumber>;
130
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
131
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
122
132
  }, "strip", z.ZodTypeAny, {
123
133
  action: "waitForNavigation";
124
134
  waitUntil: "load" | "domcontentloaded" | "networkidle";
125
135
  timeout: number;
136
+ captureWhileWaiting: boolean;
137
+ displaySpeed: number;
126
138
  }, {
127
139
  action: "waitForNavigation";
128
140
  waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
129
141
  timeout?: number | undefined;
142
+ captureWhileWaiting?: boolean | undefined;
143
+ displaySpeed?: number | undefined;
130
144
  }>, z.ZodObject<{
131
145
  action: z.ZodLiteral<"waitForURL">;
132
146
  url: z.ZodString;
133
147
  timeout: z.ZodDefault<z.ZodNumber>;
148
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
149
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
134
150
  }, "strip", z.ZodTypeAny, {
135
151
  action: "waitForURL";
136
152
  url: string;
137
153
  timeout: number;
154
+ captureWhileWaiting: boolean;
155
+ displaySpeed: number;
138
156
  }, {
139
157
  action: "waitForURL";
140
158
  url: string;
141
159
  timeout?: number | undefined;
160
+ captureWhileWaiting?: boolean | undefined;
161
+ displaySpeed?: number | undefined;
142
162
  }>, z.ZodObject<{
143
163
  action: z.ZodLiteral<"waitForFunction">;
144
164
  expression: z.ZodString;
145
165
  polling: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"raf">, z.ZodNumber]>>;
146
166
  timeout: z.ZodDefault<z.ZodNumber>;
167
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
168
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
147
169
  }, "strip", z.ZodTypeAny, {
148
170
  action: "waitForFunction";
149
171
  timeout: number;
172
+ captureWhileWaiting: boolean;
173
+ displaySpeed: number;
150
174
  expression: string;
151
175
  polling: number | "raf";
152
176
  }, {
153
177
  action: "waitForFunction";
154
178
  expression: string;
155
179
  timeout?: number | undefined;
180
+ captureWhileWaiting?: boolean | undefined;
181
+ displaySpeed?: number | undefined;
156
182
  polling?: number | "raf" | undefined;
157
183
  }>, z.ZodObject<{
158
184
  action: z.ZodLiteral<"waitForResponse">;
159
185
  url: z.ZodString;
160
186
  status: z.ZodOptional<z.ZodNumber>;
161
187
  timeout: z.ZodDefault<z.ZodNumber>;
188
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
189
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
162
190
  }, "strip", z.ZodTypeAny, {
163
191
  action: "waitForResponse";
164
192
  url: string;
165
193
  timeout: number;
194
+ captureWhileWaiting: boolean;
195
+ displaySpeed: number;
166
196
  status?: number | undefined;
167
197
  }, {
168
198
  action: "waitForResponse";
169
199
  url: string;
170
200
  status?: number | undefined;
171
201
  timeout?: number | undefined;
202
+ captureWhileWaiting?: boolean | undefined;
203
+ displaySpeed?: number | undefined;
172
204
  }>, z.ZodObject<{
173
205
  action: z.ZodLiteral<"smartWait">;
174
206
  /** Condition to wait for */
@@ -182,15 +214,15 @@ declare const StepActionSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
182
214
  }, "strip", z.ZodTypeAny, {
183
215
  action: "smartWait";
184
216
  timeout: number;
185
- until: "selector" | "networkIdle" | "domStable";
186
217
  displaySpeed: number;
218
+ until: "selector" | "networkIdle" | "domStable";
187
219
  selector?: string | undefined;
188
220
  }, {
189
221
  action: "smartWait";
190
222
  selector?: string | undefined;
191
223
  timeout?: number | undefined;
192
- until?: "selector" | "networkIdle" | "domStable" | undefined;
193
224
  displaySpeed?: number | undefined;
225
+ until?: "selector" | "networkIdle" | "domStable" | undefined;
194
226
  }>]>;
195
227
  type StepAction = z.infer<typeof StepActionSchema>;
196
228
  declare const EffectsConfigSchema: z.ZodObject<{
@@ -1083,70 +1115,102 @@ declare const StepSchema: z.ZodObject<{
1083
1115
  selector: z.ZodString;
1084
1116
  state: z.ZodDefault<z.ZodEnum<["visible", "attached", "hidden"]>>;
1085
1117
  timeout: z.ZodDefault<z.ZodNumber>;
1118
+ /** 대기 중 프레임 연속 캡처 (로딩 애니메이션 보존). */
1119
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
1120
+ /** captureWhileWaiting 사용 시 출력 영상 속도 배율 (1-32). */
1121
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
1086
1122
  }, "strip", z.ZodTypeAny, {
1087
1123
  action: "waitForSelector";
1088
1124
  selector: string;
1089
1125
  timeout: number;
1090
1126
  state: "visible" | "attached" | "hidden";
1127
+ captureWhileWaiting: boolean;
1128
+ displaySpeed: number;
1091
1129
  }, {
1092
1130
  action: "waitForSelector";
1093
1131
  selector: string;
1094
1132
  timeout?: number | undefined;
1095
1133
  state?: "visible" | "attached" | "hidden" | undefined;
1134
+ captureWhileWaiting?: boolean | undefined;
1135
+ displaySpeed?: number | undefined;
1096
1136
  }>, z.ZodObject<{
1097
1137
  action: z.ZodLiteral<"waitForNavigation">;
1098
1138
  waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
1099
1139
  timeout: z.ZodDefault<z.ZodNumber>;
1140
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
1141
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
1100
1142
  }, "strip", z.ZodTypeAny, {
1101
1143
  action: "waitForNavigation";
1102
1144
  waitUntil: "load" | "domcontentloaded" | "networkidle";
1103
1145
  timeout: number;
1146
+ captureWhileWaiting: boolean;
1147
+ displaySpeed: number;
1104
1148
  }, {
1105
1149
  action: "waitForNavigation";
1106
1150
  waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
1107
1151
  timeout?: number | undefined;
1152
+ captureWhileWaiting?: boolean | undefined;
1153
+ displaySpeed?: number | undefined;
1108
1154
  }>, z.ZodObject<{
1109
1155
  action: z.ZodLiteral<"waitForURL">;
1110
1156
  url: z.ZodString;
1111
1157
  timeout: z.ZodDefault<z.ZodNumber>;
1158
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
1159
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
1112
1160
  }, "strip", z.ZodTypeAny, {
1113
1161
  action: "waitForURL";
1114
1162
  url: string;
1115
1163
  timeout: number;
1164
+ captureWhileWaiting: boolean;
1165
+ displaySpeed: number;
1116
1166
  }, {
1117
1167
  action: "waitForURL";
1118
1168
  url: string;
1119
1169
  timeout?: number | undefined;
1170
+ captureWhileWaiting?: boolean | undefined;
1171
+ displaySpeed?: number | undefined;
1120
1172
  }>, z.ZodObject<{
1121
1173
  action: z.ZodLiteral<"waitForFunction">;
1122
1174
  expression: z.ZodString;
1123
1175
  polling: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"raf">, z.ZodNumber]>>;
1124
1176
  timeout: z.ZodDefault<z.ZodNumber>;
1177
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
1178
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
1125
1179
  }, "strip", z.ZodTypeAny, {
1126
1180
  action: "waitForFunction";
1127
1181
  timeout: number;
1182
+ captureWhileWaiting: boolean;
1183
+ displaySpeed: number;
1128
1184
  expression: string;
1129
1185
  polling: number | "raf";
1130
1186
  }, {
1131
1187
  action: "waitForFunction";
1132
1188
  expression: string;
1133
1189
  timeout?: number | undefined;
1190
+ captureWhileWaiting?: boolean | undefined;
1191
+ displaySpeed?: number | undefined;
1134
1192
  polling?: number | "raf" | undefined;
1135
1193
  }>, z.ZodObject<{
1136
1194
  action: z.ZodLiteral<"waitForResponse">;
1137
1195
  url: z.ZodString;
1138
1196
  status: z.ZodOptional<z.ZodNumber>;
1139
1197
  timeout: z.ZodDefault<z.ZodNumber>;
1198
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
1199
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
1140
1200
  }, "strip", z.ZodTypeAny, {
1141
1201
  action: "waitForResponse";
1142
1202
  url: string;
1143
1203
  timeout: number;
1204
+ captureWhileWaiting: boolean;
1205
+ displaySpeed: number;
1144
1206
  status?: number | undefined;
1145
1207
  }, {
1146
1208
  action: "waitForResponse";
1147
1209
  url: string;
1148
1210
  status?: number | undefined;
1149
1211
  timeout?: number | undefined;
1212
+ captureWhileWaiting?: boolean | undefined;
1213
+ displaySpeed?: number | undefined;
1150
1214
  }>, z.ZodObject<{
1151
1215
  action: z.ZodLiteral<"smartWait">;
1152
1216
  /** Condition to wait for */
@@ -1160,15 +1224,15 @@ declare const StepSchema: z.ZodObject<{
1160
1224
  }, "strip", z.ZodTypeAny, {
1161
1225
  action: "smartWait";
1162
1226
  timeout: number;
1163
- until: "selector" | "networkIdle" | "domStable";
1164
1227
  displaySpeed: number;
1228
+ until: "selector" | "networkIdle" | "domStable";
1165
1229
  selector?: string | undefined;
1166
1230
  }, {
1167
1231
  action: "smartWait";
1168
1232
  selector?: string | undefined;
1169
1233
  timeout?: number | undefined;
1170
- until?: "selector" | "networkIdle" | "domStable" | undefined;
1171
1234
  displaySpeed?: number | undefined;
1235
+ until?: "selector" | "networkIdle" | "domStable" | undefined;
1172
1236
  }>]>, "many">;
1173
1237
  captureDelay: z.ZodDefault<z.ZodNumber>;
1174
1238
  holdDuration: z.ZodDefault<z.ZodNumber>;
@@ -1572,29 +1636,39 @@ declare const StepSchema: z.ZodObject<{
1572
1636
  selector: string;
1573
1637
  timeout: number;
1574
1638
  state: "visible" | "attached" | "hidden";
1639
+ captureWhileWaiting: boolean;
1640
+ displaySpeed: number;
1575
1641
  } | {
1576
1642
  action: "waitForNavigation";
1577
1643
  waitUntil: "load" | "domcontentloaded" | "networkidle";
1578
1644
  timeout: number;
1645
+ captureWhileWaiting: boolean;
1646
+ displaySpeed: number;
1579
1647
  } | {
1580
1648
  action: "waitForURL";
1581
1649
  url: string;
1582
1650
  timeout: number;
1651
+ captureWhileWaiting: boolean;
1652
+ displaySpeed: number;
1583
1653
  } | {
1584
1654
  action: "waitForFunction";
1585
1655
  timeout: number;
1656
+ captureWhileWaiting: boolean;
1657
+ displaySpeed: number;
1586
1658
  expression: string;
1587
1659
  polling: number | "raf";
1588
1660
  } | {
1589
1661
  action: "waitForResponse";
1590
1662
  url: string;
1591
1663
  timeout: number;
1664
+ captureWhileWaiting: boolean;
1665
+ displaySpeed: number;
1592
1666
  status?: number | undefined;
1593
1667
  } | {
1594
1668
  action: "smartWait";
1595
1669
  timeout: number;
1596
- until: "selector" | "networkIdle" | "domStable";
1597
1670
  displaySpeed: number;
1671
+ until: "selector" | "networkIdle" | "domStable";
1598
1672
  selector?: string | undefined;
1599
1673
  })[];
1600
1674
  captureDelay: number;
@@ -1714,30 +1788,40 @@ declare const StepSchema: z.ZodObject<{
1714
1788
  selector: string;
1715
1789
  timeout?: number | undefined;
1716
1790
  state?: "visible" | "attached" | "hidden" | undefined;
1791
+ captureWhileWaiting?: boolean | undefined;
1792
+ displaySpeed?: number | undefined;
1717
1793
  } | {
1718
1794
  action: "waitForNavigation";
1719
1795
  waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
1720
1796
  timeout?: number | undefined;
1797
+ captureWhileWaiting?: boolean | undefined;
1798
+ displaySpeed?: number | undefined;
1721
1799
  } | {
1722
1800
  action: "waitForURL";
1723
1801
  url: string;
1724
1802
  timeout?: number | undefined;
1803
+ captureWhileWaiting?: boolean | undefined;
1804
+ displaySpeed?: number | undefined;
1725
1805
  } | {
1726
1806
  action: "waitForFunction";
1727
1807
  expression: string;
1728
1808
  timeout?: number | undefined;
1809
+ captureWhileWaiting?: boolean | undefined;
1810
+ displaySpeed?: number | undefined;
1729
1811
  polling?: number | "raf" | undefined;
1730
1812
  } | {
1731
1813
  action: "waitForResponse";
1732
1814
  url: string;
1733
1815
  status?: number | undefined;
1734
1816
  timeout?: number | undefined;
1817
+ captureWhileWaiting?: boolean | undefined;
1818
+ displaySpeed?: number | undefined;
1735
1819
  } | {
1736
1820
  action: "smartWait";
1737
1821
  selector?: string | undefined;
1738
1822
  timeout?: number | undefined;
1739
- until?: "selector" | "networkIdle" | "domStable" | undefined;
1740
1823
  displaySpeed?: number | undefined;
1824
+ until?: "selector" | "networkIdle" | "domStable" | undefined;
1741
1825
  })[];
1742
1826
  name?: string | undefined;
1743
1827
  captureDelay?: number | undefined;
@@ -1843,6 +1927,67 @@ declare const AudioConfigSchema: z.ZodObject<{
1843
1927
  fadeOut?: number | undefined;
1844
1928
  }>;
1845
1929
  type AudioConfig = z.infer<typeof AudioConfigSchema>;
1930
+ /**
1931
+ * Authentication configuration — restores a browser session for recording
1932
+ * pages behind login. Supports Playwright's storageState file (recommended)
1933
+ * or inline cookie definitions.
1934
+ *
1935
+ * Generate a storageState file:
1936
+ * npx playwright codegen --save-storage=auth.json https://my-app.com
1937
+ */
1938
+ declare const AuthConfigSchema: z.ZodObject<{
1939
+ /** Path to a Playwright storageState JSON file (cookies + localStorage). */
1940
+ storageState: z.ZodOptional<z.ZodString>;
1941
+ /** Inline cookie definitions (applied after storageState if both specified). */
1942
+ cookies: z.ZodOptional<z.ZodArray<z.ZodObject<{
1943
+ name: z.ZodString;
1944
+ value: z.ZodString;
1945
+ domain: z.ZodString;
1946
+ path: z.ZodDefault<z.ZodString>;
1947
+ httpOnly: z.ZodDefault<z.ZodBoolean>;
1948
+ secure: z.ZodDefault<z.ZodBoolean>;
1949
+ sameSite: z.ZodDefault<z.ZodEnum<["Strict", "Lax", "None"]>>;
1950
+ }, "strip", z.ZodTypeAny, {
1951
+ value: string;
1952
+ path: string;
1953
+ name: string;
1954
+ domain: string;
1955
+ httpOnly: boolean;
1956
+ secure: boolean;
1957
+ sameSite: "Strict" | "Lax" | "None";
1958
+ }, {
1959
+ value: string;
1960
+ name: string;
1961
+ domain: string;
1962
+ path?: string | undefined;
1963
+ httpOnly?: boolean | undefined;
1964
+ secure?: boolean | undefined;
1965
+ sameSite?: "Strict" | "Lax" | "None" | undefined;
1966
+ }>, "many">>;
1967
+ }, "strip", z.ZodTypeAny, {
1968
+ storageState?: string | undefined;
1969
+ cookies?: {
1970
+ value: string;
1971
+ path: string;
1972
+ name: string;
1973
+ domain: string;
1974
+ httpOnly: boolean;
1975
+ secure: boolean;
1976
+ sameSite: "Strict" | "Lax" | "None";
1977
+ }[] | undefined;
1978
+ }, {
1979
+ storageState?: string | undefined;
1980
+ cookies?: {
1981
+ value: string;
1982
+ name: string;
1983
+ domain: string;
1984
+ path?: string | undefined;
1985
+ httpOnly?: boolean | undefined;
1986
+ secure?: boolean | undefined;
1987
+ sameSite?: "Strict" | "Lax" | "None" | undefined;
1988
+ }[] | undefined;
1989
+ }>;
1990
+ type AuthConfig = z.infer<typeof AuthConfigSchema>;
1846
1991
  declare const ScenarioSchema: z.ZodObject<{
1847
1992
  name: z.ZodString;
1848
1993
  description: z.ZodOptional<z.ZodString>;
@@ -1856,6 +2001,59 @@ declare const ScenarioSchema: z.ZodObject<{
1856
2001
  width?: number | undefined;
1857
2002
  height?: number | undefined;
1858
2003
  }>>;
2004
+ /** Optional authentication — restores browser session for logged-in pages. */
2005
+ auth: z.ZodOptional<z.ZodObject<{
2006
+ /** Path to a Playwright storageState JSON file (cookies + localStorage). */
2007
+ storageState: z.ZodOptional<z.ZodString>;
2008
+ /** Inline cookie definitions (applied after storageState if both specified). */
2009
+ cookies: z.ZodOptional<z.ZodArray<z.ZodObject<{
2010
+ name: z.ZodString;
2011
+ value: z.ZodString;
2012
+ domain: z.ZodString;
2013
+ path: z.ZodDefault<z.ZodString>;
2014
+ httpOnly: z.ZodDefault<z.ZodBoolean>;
2015
+ secure: z.ZodDefault<z.ZodBoolean>;
2016
+ sameSite: z.ZodDefault<z.ZodEnum<["Strict", "Lax", "None"]>>;
2017
+ }, "strip", z.ZodTypeAny, {
2018
+ value: string;
2019
+ path: string;
2020
+ name: string;
2021
+ domain: string;
2022
+ httpOnly: boolean;
2023
+ secure: boolean;
2024
+ sameSite: "Strict" | "Lax" | "None";
2025
+ }, {
2026
+ value: string;
2027
+ name: string;
2028
+ domain: string;
2029
+ path?: string | undefined;
2030
+ httpOnly?: boolean | undefined;
2031
+ secure?: boolean | undefined;
2032
+ sameSite?: "Strict" | "Lax" | "None" | undefined;
2033
+ }>, "many">>;
2034
+ }, "strip", z.ZodTypeAny, {
2035
+ storageState?: string | undefined;
2036
+ cookies?: {
2037
+ value: string;
2038
+ path: string;
2039
+ name: string;
2040
+ domain: string;
2041
+ httpOnly: boolean;
2042
+ secure: boolean;
2043
+ sameSite: "Strict" | "Lax" | "None";
2044
+ }[] | undefined;
2045
+ }, {
2046
+ storageState?: string | undefined;
2047
+ cookies?: {
2048
+ value: string;
2049
+ name: string;
2050
+ domain: string;
2051
+ path?: string | undefined;
2052
+ httpOnly?: boolean | undefined;
2053
+ secure?: boolean | undefined;
2054
+ sameSite?: "Strict" | "Lax" | "None" | undefined;
2055
+ }[] | undefined;
2056
+ }>>;
1859
2057
  effects: z.ZodDefault<z.ZodObject<{
1860
2058
  zoom: z.ZodDefault<z.ZodObject<{
1861
2059
  enabled: z.ZodDefault<z.ZodBoolean>;
@@ -2398,70 +2596,102 @@ declare const ScenarioSchema: z.ZodObject<{
2398
2596
  selector: z.ZodString;
2399
2597
  state: z.ZodDefault<z.ZodEnum<["visible", "attached", "hidden"]>>;
2400
2598
  timeout: z.ZodDefault<z.ZodNumber>;
2599
+ /** 대기 중 프레임 연속 캡처 (로딩 애니메이션 보존). */
2600
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
2601
+ /** captureWhileWaiting 사용 시 출력 영상 속도 배율 (1-32). */
2602
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
2401
2603
  }, "strip", z.ZodTypeAny, {
2402
2604
  action: "waitForSelector";
2403
2605
  selector: string;
2404
2606
  timeout: number;
2405
2607
  state: "visible" | "attached" | "hidden";
2608
+ captureWhileWaiting: boolean;
2609
+ displaySpeed: number;
2406
2610
  }, {
2407
2611
  action: "waitForSelector";
2408
2612
  selector: string;
2409
2613
  timeout?: number | undefined;
2410
2614
  state?: "visible" | "attached" | "hidden" | undefined;
2615
+ captureWhileWaiting?: boolean | undefined;
2616
+ displaySpeed?: number | undefined;
2411
2617
  }>, z.ZodObject<{
2412
2618
  action: z.ZodLiteral<"waitForNavigation">;
2413
2619
  waitUntil: z.ZodDefault<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>;
2414
2620
  timeout: z.ZodDefault<z.ZodNumber>;
2621
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
2622
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
2415
2623
  }, "strip", z.ZodTypeAny, {
2416
2624
  action: "waitForNavigation";
2417
2625
  waitUntil: "load" | "domcontentloaded" | "networkidle";
2418
2626
  timeout: number;
2627
+ captureWhileWaiting: boolean;
2628
+ displaySpeed: number;
2419
2629
  }, {
2420
2630
  action: "waitForNavigation";
2421
2631
  waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
2422
2632
  timeout?: number | undefined;
2633
+ captureWhileWaiting?: boolean | undefined;
2634
+ displaySpeed?: number | undefined;
2423
2635
  }>, z.ZodObject<{
2424
2636
  action: z.ZodLiteral<"waitForURL">;
2425
2637
  url: z.ZodString;
2426
2638
  timeout: z.ZodDefault<z.ZodNumber>;
2639
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
2640
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
2427
2641
  }, "strip", z.ZodTypeAny, {
2428
2642
  action: "waitForURL";
2429
2643
  url: string;
2430
2644
  timeout: number;
2645
+ captureWhileWaiting: boolean;
2646
+ displaySpeed: number;
2431
2647
  }, {
2432
2648
  action: "waitForURL";
2433
2649
  url: string;
2434
2650
  timeout?: number | undefined;
2651
+ captureWhileWaiting?: boolean | undefined;
2652
+ displaySpeed?: number | undefined;
2435
2653
  }>, z.ZodObject<{
2436
2654
  action: z.ZodLiteral<"waitForFunction">;
2437
2655
  expression: z.ZodString;
2438
2656
  polling: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"raf">, z.ZodNumber]>>;
2439
2657
  timeout: z.ZodDefault<z.ZodNumber>;
2658
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
2659
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
2440
2660
  }, "strip", z.ZodTypeAny, {
2441
2661
  action: "waitForFunction";
2442
2662
  timeout: number;
2663
+ captureWhileWaiting: boolean;
2664
+ displaySpeed: number;
2443
2665
  expression: string;
2444
2666
  polling: number | "raf";
2445
2667
  }, {
2446
2668
  action: "waitForFunction";
2447
2669
  expression: string;
2448
2670
  timeout?: number | undefined;
2671
+ captureWhileWaiting?: boolean | undefined;
2672
+ displaySpeed?: number | undefined;
2449
2673
  polling?: number | "raf" | undefined;
2450
2674
  }>, z.ZodObject<{
2451
2675
  action: z.ZodLiteral<"waitForResponse">;
2452
2676
  url: z.ZodString;
2453
2677
  status: z.ZodOptional<z.ZodNumber>;
2454
2678
  timeout: z.ZodDefault<z.ZodNumber>;
2679
+ captureWhileWaiting: z.ZodDefault<z.ZodBoolean>;
2680
+ displaySpeed: z.ZodDefault<z.ZodNumber>;
2455
2681
  }, "strip", z.ZodTypeAny, {
2456
2682
  action: "waitForResponse";
2457
2683
  url: string;
2458
2684
  timeout: number;
2685
+ captureWhileWaiting: boolean;
2686
+ displaySpeed: number;
2459
2687
  status?: number | undefined;
2460
2688
  }, {
2461
2689
  action: "waitForResponse";
2462
2690
  url: string;
2463
2691
  status?: number | undefined;
2464
2692
  timeout?: number | undefined;
2693
+ captureWhileWaiting?: boolean | undefined;
2694
+ displaySpeed?: number | undefined;
2465
2695
  }>, z.ZodObject<{
2466
2696
  action: z.ZodLiteral<"smartWait">;
2467
2697
  /** Condition to wait for */
@@ -2475,15 +2705,15 @@ declare const ScenarioSchema: z.ZodObject<{
2475
2705
  }, "strip", z.ZodTypeAny, {
2476
2706
  action: "smartWait";
2477
2707
  timeout: number;
2478
- until: "selector" | "networkIdle" | "domStable";
2479
2708
  displaySpeed: number;
2709
+ until: "selector" | "networkIdle" | "domStable";
2480
2710
  selector?: string | undefined;
2481
2711
  }, {
2482
2712
  action: "smartWait";
2483
2713
  selector?: string | undefined;
2484
2714
  timeout?: number | undefined;
2485
- until?: "selector" | "networkIdle" | "domStable" | undefined;
2486
2715
  displaySpeed?: number | undefined;
2716
+ until?: "selector" | "networkIdle" | "domStable" | undefined;
2487
2717
  }>]>, "many">;
2488
2718
  captureDelay: z.ZodDefault<z.ZodNumber>;
2489
2719
  holdDuration: z.ZodDefault<z.ZodNumber>;
@@ -2887,29 +3117,39 @@ declare const ScenarioSchema: z.ZodObject<{
2887
3117
  selector: string;
2888
3118
  timeout: number;
2889
3119
  state: "visible" | "attached" | "hidden";
3120
+ captureWhileWaiting: boolean;
3121
+ displaySpeed: number;
2890
3122
  } | {
2891
3123
  action: "waitForNavigation";
2892
3124
  waitUntil: "load" | "domcontentloaded" | "networkidle";
2893
3125
  timeout: number;
3126
+ captureWhileWaiting: boolean;
3127
+ displaySpeed: number;
2894
3128
  } | {
2895
3129
  action: "waitForURL";
2896
3130
  url: string;
2897
3131
  timeout: number;
3132
+ captureWhileWaiting: boolean;
3133
+ displaySpeed: number;
2898
3134
  } | {
2899
3135
  action: "waitForFunction";
2900
3136
  timeout: number;
3137
+ captureWhileWaiting: boolean;
3138
+ displaySpeed: number;
2901
3139
  expression: string;
2902
3140
  polling: number | "raf";
2903
3141
  } | {
2904
3142
  action: "waitForResponse";
2905
3143
  url: string;
2906
3144
  timeout: number;
3145
+ captureWhileWaiting: boolean;
3146
+ displaySpeed: number;
2907
3147
  status?: number | undefined;
2908
3148
  } | {
2909
3149
  action: "smartWait";
2910
3150
  timeout: number;
2911
- until: "selector" | "networkIdle" | "domStable";
2912
3151
  displaySpeed: number;
3152
+ until: "selector" | "networkIdle" | "domStable";
2913
3153
  selector?: string | undefined;
2914
3154
  })[];
2915
3155
  captureDelay: number;
@@ -3029,30 +3269,40 @@ declare const ScenarioSchema: z.ZodObject<{
3029
3269
  selector: string;
3030
3270
  timeout?: number | undefined;
3031
3271
  state?: "visible" | "attached" | "hidden" | undefined;
3272
+ captureWhileWaiting?: boolean | undefined;
3273
+ displaySpeed?: number | undefined;
3032
3274
  } | {
3033
3275
  action: "waitForNavigation";
3034
3276
  waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
3035
3277
  timeout?: number | undefined;
3278
+ captureWhileWaiting?: boolean | undefined;
3279
+ displaySpeed?: number | undefined;
3036
3280
  } | {
3037
3281
  action: "waitForURL";
3038
3282
  url: string;
3039
3283
  timeout?: number | undefined;
3284
+ captureWhileWaiting?: boolean | undefined;
3285
+ displaySpeed?: number | undefined;
3040
3286
  } | {
3041
3287
  action: "waitForFunction";
3042
3288
  expression: string;
3043
3289
  timeout?: number | undefined;
3290
+ captureWhileWaiting?: boolean | undefined;
3291
+ displaySpeed?: number | undefined;
3044
3292
  polling?: number | "raf" | undefined;
3045
3293
  } | {
3046
3294
  action: "waitForResponse";
3047
3295
  url: string;
3048
3296
  status?: number | undefined;
3049
3297
  timeout?: number | undefined;
3298
+ captureWhileWaiting?: boolean | undefined;
3299
+ displaySpeed?: number | undefined;
3050
3300
  } | {
3051
3301
  action: "smartWait";
3052
3302
  selector?: string | undefined;
3053
3303
  timeout?: number | undefined;
3054
- until?: "selector" | "networkIdle" | "domStable" | undefined;
3055
3304
  displaySpeed?: number | undefined;
3305
+ until?: "selector" | "networkIdle" | "domStable" | undefined;
3056
3306
  })[];
3057
3307
  name?: string | undefined;
3058
3308
  captureDelay?: number | undefined;
@@ -3263,29 +3513,39 @@ declare const ScenarioSchema: z.ZodObject<{
3263
3513
  selector: string;
3264
3514
  timeout: number;
3265
3515
  state: "visible" | "attached" | "hidden";
3516
+ captureWhileWaiting: boolean;
3517
+ displaySpeed: number;
3266
3518
  } | {
3267
3519
  action: "waitForNavigation";
3268
3520
  waitUntil: "load" | "domcontentloaded" | "networkidle";
3269
3521
  timeout: number;
3522
+ captureWhileWaiting: boolean;
3523
+ displaySpeed: number;
3270
3524
  } | {
3271
3525
  action: "waitForURL";
3272
3526
  url: string;
3273
3527
  timeout: number;
3528
+ captureWhileWaiting: boolean;
3529
+ displaySpeed: number;
3274
3530
  } | {
3275
3531
  action: "waitForFunction";
3276
3532
  timeout: number;
3533
+ captureWhileWaiting: boolean;
3534
+ displaySpeed: number;
3277
3535
  expression: string;
3278
3536
  polling: number | "raf";
3279
3537
  } | {
3280
3538
  action: "waitForResponse";
3281
3539
  url: string;
3282
3540
  timeout: number;
3541
+ captureWhileWaiting: boolean;
3542
+ displaySpeed: number;
3283
3543
  status?: number | undefined;
3284
3544
  } | {
3285
3545
  action: "smartWait";
3286
3546
  timeout: number;
3287
- until: "selector" | "networkIdle" | "domStable";
3288
3547
  displaySpeed: number;
3548
+ until: "selector" | "networkIdle" | "domStable";
3289
3549
  selector?: string | undefined;
3290
3550
  })[];
3291
3551
  captureDelay: number;
@@ -3368,6 +3628,18 @@ declare const ScenarioSchema: z.ZodObject<{
3368
3628
  } | undefined;
3369
3629
  }[];
3370
3630
  description?: string | undefined;
3631
+ auth?: {
3632
+ storageState?: string | undefined;
3633
+ cookies?: {
3634
+ value: string;
3635
+ path: string;
3636
+ name: string;
3637
+ domain: string;
3638
+ httpOnly: boolean;
3639
+ secure: boolean;
3640
+ sameSite: "Strict" | "Lax" | "None";
3641
+ }[] | undefined;
3642
+ } | undefined;
3371
3643
  audio?: {
3372
3644
  file: string;
3373
3645
  volume: number;
@@ -3415,30 +3687,40 @@ declare const ScenarioSchema: z.ZodObject<{
3415
3687
  selector: string;
3416
3688
  timeout?: number | undefined;
3417
3689
  state?: "visible" | "attached" | "hidden" | undefined;
3690
+ captureWhileWaiting?: boolean | undefined;
3691
+ displaySpeed?: number | undefined;
3418
3692
  } | {
3419
3693
  action: "waitForNavigation";
3420
3694
  waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
3421
3695
  timeout?: number | undefined;
3696
+ captureWhileWaiting?: boolean | undefined;
3697
+ displaySpeed?: number | undefined;
3422
3698
  } | {
3423
3699
  action: "waitForURL";
3424
3700
  url: string;
3425
3701
  timeout?: number | undefined;
3702
+ captureWhileWaiting?: boolean | undefined;
3703
+ displaySpeed?: number | undefined;
3426
3704
  } | {
3427
3705
  action: "waitForFunction";
3428
3706
  expression: string;
3429
3707
  timeout?: number | undefined;
3708
+ captureWhileWaiting?: boolean | undefined;
3709
+ displaySpeed?: number | undefined;
3430
3710
  polling?: number | "raf" | undefined;
3431
3711
  } | {
3432
3712
  action: "waitForResponse";
3433
3713
  url: string;
3434
3714
  status?: number | undefined;
3435
3715
  timeout?: number | undefined;
3716
+ captureWhileWaiting?: boolean | undefined;
3717
+ displaySpeed?: number | undefined;
3436
3718
  } | {
3437
3719
  action: "smartWait";
3438
3720
  selector?: string | undefined;
3439
3721
  timeout?: number | undefined;
3440
- until?: "selector" | "networkIdle" | "domStable" | undefined;
3441
3722
  displaySpeed?: number | undefined;
3723
+ until?: "selector" | "networkIdle" | "domStable" | undefined;
3442
3724
  })[];
3443
3725
  name?: string | undefined;
3444
3726
  captureDelay?: number | undefined;
@@ -3598,6 +3880,18 @@ declare const ScenarioSchema: z.ZodObject<{
3598
3880
  width?: number | undefined;
3599
3881
  height?: number | undefined;
3600
3882
  } | undefined;
3883
+ auth?: {
3884
+ storageState?: string | undefined;
3885
+ cookies?: {
3886
+ value: string;
3887
+ name: string;
3888
+ domain: string;
3889
+ path?: string | undefined;
3890
+ httpOnly?: boolean | undefined;
3891
+ secure?: boolean | undefined;
3892
+ sameSite?: "Strict" | "Lax" | "None" | undefined;
3893
+ }[] | undefined;
3894
+ } | undefined;
3601
3895
  output?: {
3602
3896
  format?: "gif" | "mp4" | "webm" | "png-sequence" | undefined;
3603
3897
  width?: number | undefined;
@@ -3791,6 +4085,11 @@ declare class ClipwiseRecorder {
3791
4085
  * so CDP screencast keeps sending frames even on static pages.
3792
4086
  */
3793
4087
  private waitWithRepaints;
4088
+ /**
4089
+ * 조건 대기 중 프레임을 연속 캡처하는 헬퍼.
4090
+ * smartWait과 동일한 패턴: isWaitingPhase 플래그 + forceRepaint 루프를 조건 promise와 병렬 실행.
4091
+ */
4092
+ private waitForConditionWithCapture;
3794
4093
  /**
3795
4094
  * Pre-register waitForResponse listeners at the start of each step.
3796
4095
  * This ensures the listener is active before any preceding action
@@ -4410,4 +4709,4 @@ interface ValidationResult {
4410
4709
  */
4411
4710
  declare function validateScenario(scenario: Scenario): ValidationResult;
4412
4711
 
4413
- export { type AudioConfig, CanvasRenderer, type CapturedFrame, ClipwiseRecorder, type ComposedFrame, type ConcurrentResult, ConcurrentSession, type EffectsConfig, type FrameContext, type KeystrokeEvent, type OutputConfig, type PipelineProgress, type RecordingHandle, type RecordingSession, type Scenario, type Step, type StepAction, type StepEffectsOverride, StreamingSession, type TransitionType, ZOOM_INTENSITY_SCALES, type ZoomEasing, type ZoomIntensity, type ZoomZone, applyBlur, applyCrossfade, applySlide, applyTransition, applyZoomEasing, buildZoomClickLookup, calculateAdaptiveZoom, calculateAdaptiveZoomFromLookup, calculateAdaptiveZoomFromZones, calculateAdaptiveZoomInWindow, calculatePanOffset, encodeGif, encodeMp4, encodeMp4Stream, lerpZoom, loadScenario, mergeClickZones, parseScenario, renderCursorHighlight, renderCursorTrail, renderKeystrokeHud, renderWatermark, resolveZoomScale, savePngSequence, springEasing, validateScenario };
4712
+ export { type AudioConfig, type AuthConfig, CanvasRenderer, type CapturedFrame, ClipwiseRecorder, type ComposedFrame, type ConcurrentResult, ConcurrentSession, type EffectsConfig, type FrameContext, type KeystrokeEvent, type OutputConfig, type PipelineProgress, type RecordingHandle, type RecordingSession, type Scenario, type Step, type StepAction, type StepEffectsOverride, StreamingSession, type TransitionType, ZOOM_INTENSITY_SCALES, type ZoomEasing, type ZoomIntensity, type ZoomZone, applyBlur, applyCrossfade, applySlide, applyTransition, applyZoomEasing, buildZoomClickLookup, calculateAdaptiveZoom, calculateAdaptiveZoomFromLookup, calculateAdaptiveZoomFromZones, calculateAdaptiveZoomInWindow, calculatePanOffset, encodeGif, encodeMp4, encodeMp4Stream, lerpZoom, loadScenario, mergeClickZones, parseScenario, renderCursorHighlight, renderCursorTrail, renderKeystrokeHud, renderWatermark, resolveZoomScale, savePngSequence, springEasing, validateScenario };