@cappa/plugin-storybook 0.7.1 → 0.8.1

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.js DELETED
@@ -1,375 +0,0 @@
1
- // src/index.esm.ts
2
- import { fileURLToPath } from "url";
3
-
4
- // src/cappa/plugin.ts
5
- import { getLogger } from "@cappa/logger";
6
-
7
- // src/cappa/storybook-url.ts
8
- function encodePairs(obj) {
9
- if (!obj || !Object.keys(obj).length) return "";
10
- return Object.entries(obj).filter(([, v]) => v !== void 0).map(([k, v]) => {
11
- const val = typeof v === "string" ? encodeURIComponent(v) : typeof v === "number" || typeof v === "boolean" ? String(v) : encodeURIComponent(JSON.stringify(v));
12
- return `${encodeURIComponent(k)}:${val}`;
13
- }).join(";");
14
- }
15
- function buildStorybookIframeUrl({
16
- baseUrl,
17
- storyId,
18
- viewMode = "story",
19
- args,
20
- globals,
21
- query,
22
- fullscreen = true,
23
- singleStory = true
24
- }) {
25
- const u = new URL("/iframe.html", baseUrl);
26
- u.searchParams.set("id", storyId);
27
- u.searchParams.set("viewMode", viewMode);
28
- const argPairs = encodePairs(args);
29
- if (argPairs) u.searchParams.set("args", argPairs);
30
- const globalPairs = encodePairs(globals);
31
- if (globalPairs) u.searchParams.set("globals", globalPairs);
32
- if (fullscreen) u.searchParams.set("full", "1");
33
- if (singleStory) u.searchParams.set("singleStory", "true");
34
- if (query) {
35
- for (const [k, v] of Object.entries(query)) {
36
- if (v === void 0) continue;
37
- u.searchParams.set(k, String(v));
38
- }
39
- }
40
- return u.toString();
41
- }
42
-
43
- // src/cappa/util.ts
44
- var freezeUI = async (page) => {
45
- await page.addStyleTag({
46
- content: `
47
- *, *::before, *::after {
48
- -moz-animation: none !important;
49
- -moz-transition: none !important;
50
- transition: none !important;
51
- animation: none !important;
52
- }
53
- *, input, textarea { caret-color: transparent !important }
54
- *:focus { outline: none !important }
55
- *:focus-visible { outline: none !important }
56
- *:focus-within { outline: none !important }
57
- * { text-rendering: optimizeLegibility !important }
58
- ::-webkit-scrollbar { display: none !important }
59
- html { scroll-behavior: auto !important }
60
- svg, svg * {
61
- shape-rendering: crispEdges !important;
62
- text-rendering: geometricPrecision !important;
63
- vector-effect: non-scaling-stroke !important;
64
- }
65
- img { image-rendering: crisp-edges !important }
66
- `
67
- });
68
- };
69
- var waitForVisualIdle = async (page) => {
70
- await page.waitForLoadState("load");
71
- await page.evaluate(async () => {
72
- await document.fonts?.ready?.catch(() => {
73
- });
74
- const imgs = Array.from(document.images).filter((i) => !i.complete);
75
- await Promise.all(
76
- imgs.map(
77
- (i) => new Promise((res) => {
78
- i.onload = i.onerror = () => res(null);
79
- })
80
- )
81
- );
82
- });
83
- await page.evaluate(
84
- ({ minIdleMs }) => new Promise((resolve) => {
85
- let timer = null;
86
- let last = performance.now();
87
- const done = () => {
88
- if (timer) cancelAnimationFrame(timer);
89
- resolve();
90
- };
91
- const mo = new MutationObserver(() => {
92
- last = performance.now();
93
- });
94
- mo.observe(document, {
95
- attributes: true,
96
- childList: true,
97
- subtree: true,
98
- characterData: true
99
- });
100
- const tick = () => {
101
- if (performance.now() - last >= minIdleMs) {
102
- mo.disconnect();
103
- done();
104
- } else {
105
- timer = requestAnimationFrame(tick);
106
- }
107
- };
108
- requestAnimationFrame(() => requestAnimationFrame(tick));
109
- }),
110
- { minIdleMs: 100 }
111
- );
112
- };
113
- var buildFilename = (story) => {
114
- return `${story.title.replace(/[^a-zA-Z0-9/]/g, "")}/${story.name.replace(/[^a-zA-Z0-9]/g, "")}.png`;
115
- };
116
-
117
- // src/cappa/plugin.ts
118
- async function waitForPlayFunctionCompletion(page, storyName) {
119
- const logger = getLogger();
120
- try {
121
- const hasPlayFunction = await page.evaluate(
122
- () => window.__cappa_has_play_function === true
123
- );
124
- if (!hasPlayFunction) {
125
- return;
126
- }
127
- logger.debug(
128
- `Waiting for play function to complete for story: ${storyName}`
129
- );
130
- await page.waitForFunction(() => window.playAfterEach === true, {
131
- timeout: 1e4
132
- });
133
- logger.debug(`Play function completed for story: ${storyName}`);
134
- await page.evaluate(() => {
135
- window.playAfterEach = false;
136
- window.__cappa_has_play_function = false;
137
- });
138
- } catch {
139
- await page.evaluate(() => {
140
- window.playAfterEach = false;
141
- window.__cappa_has_play_function = false;
142
- });
143
- }
144
- }
145
- function toFilterContext(story) {
146
- return {
147
- id: story.id,
148
- title: story.title,
149
- name: story.name,
150
- filePath: `${story.title}/${story.name}`
151
- };
152
- }
153
- function createLatch() {
154
- let resolve;
155
- const p = new Promise((r) => {
156
- resolve = r;
157
- });
158
- return { p, resolve };
159
- }
160
- var cappaPluginStorybook = (options) => {
161
- return {
162
- name: "StorybookPlugin",
163
- description: "Takes screenshots of Storybook stories with configurable options",
164
- discover: async () => {
165
- if (!options) {
166
- throw new Error("Storybook plugin options are required");
167
- }
168
- if (!options.storybookUrl) {
169
- throw new Error("storybookUrl is required");
170
- }
171
- const logger = getLogger();
172
- const {
173
- storybookUrl,
174
- includeStories,
175
- excludeStories,
176
- storybook: defaultStorybookOptions
177
- } = options;
178
- const storiesUrl = `${storybookUrl}/index.json`;
179
- logger.debug(`Fetching stories from: ${storiesUrl}`);
180
- const response = await fetch(storiesUrl);
181
- if (!response.ok) {
182
- throw new Error(
183
- `Failed to fetch stories: ${response.status} ${response.statusText}`
184
- );
185
- }
186
- const data = await response.json();
187
- const stories = Object.values(data.entries);
188
- let filteredStories = stories;
189
- if (includeStories) {
190
- filteredStories = filteredStories.filter(
191
- (story) => includeStories(toFilterContext(story))
192
- );
193
- }
194
- if (excludeStories) {
195
- filteredStories = filteredStories.filter(
196
- (story) => !excludeStories(toFilterContext(story))
197
- );
198
- }
199
- filteredStories = filteredStories.filter(
200
- (story) => story.type === "story"
201
- );
202
- logger.start(`Found ${filteredStories.length} stories to screenshot...`);
203
- return filteredStories.map((story) => ({
204
- id: story.id,
205
- url: buildStorybookIframeUrl({
206
- baseUrl: storybookUrl,
207
- storyId: story.id,
208
- viewMode: defaultStorybookOptions?.viewMode,
209
- args: defaultStorybookOptions?.args,
210
- globals: defaultStorybookOptions?.globals,
211
- query: defaultStorybookOptions?.query,
212
- fullscreen: defaultStorybookOptions?.fullscreen,
213
- singleStory: defaultStorybookOptions?.singleStory
214
- }),
215
- data: {
216
- story
217
- }
218
- }));
219
- },
220
- initPage: async (page, screenshotTool) => {
221
- const logger = getLogger();
222
- const { logConsoleEvents = true } = screenshotTool;
223
- const latchMap = /* @__PURE__ */ new Map();
224
- await page.exposeFunction(
225
- "__cappa_parameters",
226
- async (id, payload) => {
227
- latchMap.get(id)?.resolve?.(payload);
228
- }
229
- );
230
- if (logConsoleEvents) {
231
- page.on("console", (message) => {
232
- logger.debug("console", message.text());
233
- });
234
- }
235
- page.on("pageerror", (error) => {
236
- logger.debug("pageerror", error);
237
- });
238
- return { latchMap };
239
- },
240
- // Phase 2: Execute single story
241
- execute: async (task, page, screenshotTool, context) => {
242
- const { url, data } = task;
243
- const { story } = data;
244
- const logger = getLogger();
245
- const { storybook: defaultStorybookOptions } = options || {};
246
- try {
247
- const currentLatch = createLatch();
248
- context.latchMap.set(story.id, currentLatch);
249
- const captureStart = performance.now();
250
- await page.goto(url);
251
- const storyParameters = await context.latchMap.get(story.id)?.p;
252
- context.latchMap.delete(story.id);
253
- const variantParameters = storyParameters?.variants ?? [];
254
- if (storyParameters?.skip) {
255
- logger.warn(`Skipping story ${story.title} - ${story.name}`);
256
- return {
257
- storyId: story.id,
258
- storyName: `${story.title} - ${story.name}`,
259
- skipped: true
260
- };
261
- }
262
- if (storyParameters && Object.keys(storyParameters).length > 0) {
263
- logger.debug("Taking screenshot with options", storyParameters);
264
- }
265
- const resolvedViewport = storyParameters?.viewport ?? screenshotTool.viewport;
266
- await page.setViewportSize(resolvedViewport);
267
- await freezeUI(page);
268
- await waitForVisualIdle(page);
269
- await waitForPlayFunctionCompletion(
270
- page,
271
- `${story.title} - ${story.name}`
272
- );
273
- const toLocatorMask = (mask) => mask?.map((selector) => page.locator(selector));
274
- const filename = buildFilename(story);
275
- const variantsWithUrls = [];
276
- const variantExtrasEntries = [];
277
- for (const variant of variantParameters) {
278
- const variantFilename = variant.filename || screenshotTool.getVariantFilename(filename, {
279
- id: variant.id,
280
- label: variant.label,
281
- filename: variant.filename
282
- });
283
- const mergedArgs = {
284
- ...defaultStorybookOptions?.args,
285
- ...variant.options?.args
286
- };
287
- variantsWithUrls.push({
288
- id: variant.id,
289
- label: variant.label,
290
- filename: variantFilename,
291
- url: buildStorybookIframeUrl({
292
- baseUrl: options?.storybookUrl || "",
293
- storyId: story.id,
294
- viewMode: defaultStorybookOptions?.viewMode,
295
- args: mergedArgs,
296
- globals: defaultStorybookOptions?.globals,
297
- query: defaultStorybookOptions?.query,
298
- fullscreen: defaultStorybookOptions?.fullscreen,
299
- singleStory: defaultStorybookOptions?.singleStory
300
- }),
301
- options: variant.options ? {
302
- ...variant.options,
303
- mask: toLocatorMask(variant.options.mask)
304
- } : void 0
305
- });
306
- variantExtrasEntries.push([
307
- variant.id,
308
- {
309
- saveDiffImage: true,
310
- diffImageFilename: variantFilename,
311
- diff: variant.options?.diff
312
- }
313
- ]);
314
- }
315
- const baseOptions = {
316
- fullPage: storyParameters?.fullPage,
317
- delay: storyParameters?.delay,
318
- omitBackground: storyParameters?.omitBackground,
319
- skip: storyParameters?.skip,
320
- viewport: storyParameters?.viewport ?? screenshotTool.viewport,
321
- mask: toLocatorMask(storyParameters?.mask)
322
- };
323
- const variantFilenameMap = /* @__PURE__ */ new Map();
324
- for (const variant of variantsWithUrls) {
325
- const variantFilename = variant.filename;
326
- if (!variantFilename) continue;
327
- variantFilenameMap.set(variant.id, variantFilename);
328
- }
329
- const captureExtras = {
330
- saveDiffImage: true,
331
- diffImageFilename: filename,
332
- diff: storyParameters?.diff,
333
- variants: variantExtrasEntries.length ? Object.fromEntries(variantExtrasEntries) : void 0,
334
- skipBaseNavigation: true,
335
- waitForStability: waitForVisualIdle,
336
- captureStart
337
- };
338
- const captureResult = await screenshotTool.captureWithVariants(
339
- page,
340
- filename,
341
- url,
342
- baseOptions,
343
- variantsWithUrls,
344
- captureExtras
345
- );
346
- return {
347
- storyId: story.id,
348
- storyName: `${story.title} - ${story.name}`,
349
- filepath: captureResult.base.filepath,
350
- success: captureResult.base.skipped ? void 0 : captureResult.base.comparisonResult ? captureResult.base.comparisonResult.passed : Boolean(captureResult.base.filepath),
351
- skipped: captureResult.base.skipped
352
- };
353
- } catch (error) {
354
- logger.error(
355
- `Error taking screenshot of story ${story.title} - ${story.name}:`,
356
- error.message
357
- );
358
- return {
359
- storyId: story.id,
360
- storyName: `${story.title} - ${story.name}`,
361
- error: error?.message ?? "Unknown error"
362
- };
363
- }
364
- }
365
- };
366
- };
367
-
368
- // src/index.esm.ts
369
- var previewAnnotations = [
370
- fileURLToPath(new URL("./preview.js", import.meta.url))
371
- ];
372
- export {
373
- cappaPluginStorybook,
374
- previewAnnotations
375
- };
package/dist/preview.js DELETED
@@ -1,60 +0,0 @@
1
- // src/storybook/addon/decorator.ts
2
- import { makeDecorator } from "storybook/preview-api";
3
-
4
- // src/storybook/util.ts
5
- var waitForExposed = (name, timeoutMs = 5e3) => {
6
- return new Promise((resolve, reject) => {
7
- const start = performance.now();
8
- const t = setInterval(() => {
9
- const fn = window[name];
10
- if (typeof fn === "function") {
11
- clearInterval(t);
12
- resolve(fn);
13
- } else if (performance.now() - start > timeoutMs) {
14
- clearInterval(t);
15
- reject(new Error(`Timed out waiting for ${name}`));
16
- }
17
- }, 16);
18
- });
19
- };
20
-
21
- // src/storybook/addon/browser.ts
22
- var isCappa = () => {
23
- return navigator.userAgent.includes("CappaStorybook");
24
- };
25
-
26
- // src/storybook/addon/decorator.ts
27
- var withCappaDecorator = makeDecorator({
28
- name: "withCappa",
29
- parameterName: "cappa",
30
- skipIfNoParametersOrOptions: false,
31
- wrapper: (getStory, context, { parameters: parameters2 }) => {
32
- if (isCappa()) {
33
- window.__cappa_screenshot = true;
34
- if (context.playFunction != null) {
35
- window.__cappa_has_play_function = true;
36
- }
37
- queueMicrotask(async () => {
38
- try {
39
- const cappaParameters = await waitForExposed("__cappa_parameters");
40
- cappaParameters(context.id, parameters2 ?? {});
41
- } catch (error) {
42
- console.error("Cappa decorator error:", error);
43
- }
44
- });
45
- }
46
- return getStory(context);
47
- }
48
- });
49
-
50
- // src/storybook/addon/preview.ts
51
- var decorators = [withCappaDecorator];
52
- var parameters = {};
53
- var afterEach = () => {
54
- window.playAfterEach = true;
55
- };
56
- export {
57
- afterEach,
58
- decorators,
59
- parameters
60
- };