@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/browser.cjs CHANGED
@@ -1,32 +1,10 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __export = (target, all) => {
7
- for (var name in all)
8
- __defProp(target, name, { get: all[name], enumerable: true });
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ //#region src/storybook/addon/browser.ts
3
+ /**
4
+ * Checks if the current window is a cappa window
5
+ */
6
+ const isCappa = () => {
7
+ return navigator.userAgent.includes("CappaStorybook");
9
8
  };
10
- var __copyProps = (to, from, except, desc) => {
11
- if (from && typeof from === "object" || typeof from === "function") {
12
- for (let key of __getOwnPropNames(from))
13
- if (!__hasOwnProp.call(to, key) && key !== except)
14
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
- }
16
- return to;
17
- };
18
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
-
20
- // src/storybook/addon/browser.ts
21
- var browser_exports = {};
22
- __export(browser_exports, {
23
- isCappa: () => isCappa
24
- });
25
- module.exports = __toCommonJS(browser_exports);
26
- var isCappa = () => {
27
- return navigator.userAgent.includes("CappaStorybook");
28
- };
29
- // Annotate the CommonJS export names for ESM import in node:
30
- 0 && (module.exports = {
31
- isCappa
32
- });
9
+ //#endregion
10
+ exports.isCappa = isCappa;
@@ -1,6 +1,7 @@
1
+ //#region src/storybook/addon/browser.d.ts
1
2
  /**
2
3
  * Checks if the current window is a cappa window
3
4
  */
4
5
  declare const isCappa: () => boolean;
5
-
6
- export { isCappa };
6
+ //#endregion
7
+ export { isCappa };
@@ -1,6 +1,7 @@
1
+ //#region src/storybook/addon/browser.d.ts
1
2
  /**
2
3
  * Checks if the current window is a cappa window
3
4
  */
4
5
  declare const isCappa: () => boolean;
5
-
6
- export { isCappa };
6
+ //#endregion
7
+ export { isCappa };
@@ -0,0 +1,9 @@
1
+ //#region src/storybook/addon/browser.ts
2
+ /**
3
+ * Checks if the current window is a cappa window
4
+ */
5
+ const isCappa = () => {
6
+ return navigator.userAgent.includes("CappaStorybook");
7
+ };
8
+ //#endregion
9
+ export { isCappa };
@@ -0,0 +1,322 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ let _cappa_logger = require("@cappa/logger");
3
+ //#region src/cappa/storybook-url.ts
4
+ function encodePairs(obj) {
5
+ if (!obj || !Object.keys(obj).length) return "";
6
+ return Object.entries(obj).filter(([, v]) => v !== void 0).map(([k, v]) => {
7
+ const val = typeof v === "string" ? encodeURIComponent(v) : typeof v === "number" || typeof v === "boolean" ? String(v) : encodeURIComponent(JSON.stringify(v));
8
+ return `${encodeURIComponent(k)}:${val}`;
9
+ }).join(";");
10
+ }
11
+ function buildStorybookIframeUrl({ baseUrl, storyId, viewMode = "story", args, globals, query, fullscreen = true, singleStory = true }) {
12
+ const u = new URL("/iframe.html", baseUrl);
13
+ u.searchParams.set("id", storyId);
14
+ u.searchParams.set("viewMode", viewMode);
15
+ const argPairs = encodePairs(args);
16
+ if (argPairs) u.searchParams.set("args", argPairs);
17
+ const globalPairs = encodePairs(globals);
18
+ if (globalPairs) u.searchParams.set("globals", globalPairs);
19
+ if (fullscreen) u.searchParams.set("full", "1");
20
+ if (singleStory) u.searchParams.set("singleStory", "true");
21
+ if (query) for (const [k, v] of Object.entries(query)) {
22
+ if (v === void 0) continue;
23
+ u.searchParams.set(k, String(v));
24
+ }
25
+ return u.toString();
26
+ }
27
+ //#endregion
28
+ //#region src/cappa/util.ts
29
+ /**
30
+ * Disable CSS transitions, animations, and scrollbars
31
+ * @param page - The page to disable CSS transitions, animations, and scrollbars
32
+ */
33
+ const freezeUI = async (page) => {
34
+ await page.addStyleTag({ content: `
35
+ *, *::before, *::after {
36
+ -moz-animation: none !important;
37
+ -moz-transition: none !important;
38
+ transition: none !important;
39
+ animation: none !important;
40
+ }
41
+ *, input, textarea { caret-color: transparent !important }
42
+ *:focus { outline: none !important }
43
+ *:focus-visible { outline: none !important }
44
+ *:focus-within { outline: none !important }
45
+ * { text-rendering: optimizeLegibility !important }
46
+ ::-webkit-scrollbar { display: none !important }
47
+ html { scroll-behavior: auto !important }
48
+ svg, svg * {
49
+ shape-rendering: crispEdges !important;
50
+ text-rendering: geometricPrecision !important;
51
+ vector-effect: non-scaling-stroke !important;
52
+ }
53
+ img { image-rendering: crisp-edges !important }
54
+ ` });
55
+ };
56
+ /**
57
+ * Wait for general visual stability on the page
58
+ * @param page - The page to wait for
59
+ */
60
+ const waitForVisualIdle = async (page) => {
61
+ await page.waitForLoadState("load");
62
+ await page.evaluate(async () => {
63
+ await document.fonts?.ready?.catch(() => {});
64
+ const imgs = Array.from(document.images).filter((i) => !i.complete);
65
+ await Promise.all(imgs.map((i) => new Promise((res) => {
66
+ i.onload = i.onerror = () => res(null);
67
+ })));
68
+ });
69
+ await page.evaluate(({ minIdleMs }) => new Promise((resolve) => {
70
+ let timer = null;
71
+ let last = performance.now();
72
+ const done = () => {
73
+ if (timer) cancelAnimationFrame(timer);
74
+ resolve();
75
+ };
76
+ const mo = new MutationObserver(() => {
77
+ last = performance.now();
78
+ });
79
+ mo.observe(document, {
80
+ attributes: true,
81
+ childList: true,
82
+ subtree: true,
83
+ characterData: true
84
+ });
85
+ const tick = () => {
86
+ if (performance.now() - last >= minIdleMs) {
87
+ mo.disconnect();
88
+ done();
89
+ } else timer = requestAnimationFrame(tick);
90
+ };
91
+ requestAnimationFrame(() => requestAnimationFrame(tick));
92
+ }), { minIdleMs: 100 });
93
+ };
94
+ /**
95
+ * Build a filename for a story.
96
+ * @param story - The story to build a filename for
97
+ * @returns The filename for the story. Slashes represent folders that should be handled by seperate file system calls.
98
+ */
99
+ const buildFilename = (story) => {
100
+ return `${story.title.replace(/[^a-zA-Z0-9/]/g, "")}/${story.name.replace(/[^a-zA-Z0-9]/g, "")}.png`;
101
+ };
102
+ //#endregion
103
+ //#region src/cappa/plugin.ts
104
+ /**
105
+ * Wait for the play function to complete by checking the playAfterEach flag
106
+ * Only waits if the story actually has a play function
107
+ */
108
+ async function waitForPlayFunctionCompletion(page, storyName) {
109
+ const logger = (0, _cappa_logger.getLogger)();
110
+ try {
111
+ if (!await page.evaluate(() => window.__cappa_has_play_function === true)) return;
112
+ logger.debug(`Waiting for play function to complete for story: ${storyName}`);
113
+ await page.waitForFunction(() => window.playAfterEach === true, { timeout: 1e4 });
114
+ logger.debug(`Play function completed for story: ${storyName}`);
115
+ await page.evaluate(() => {
116
+ window.playAfterEach = false;
117
+ window.__cappa_has_play_function = false;
118
+ });
119
+ } catch {
120
+ await page.evaluate(() => {
121
+ window.playAfterEach = false;
122
+ window.__cappa_has_play_function = false;
123
+ });
124
+ }
125
+ }
126
+ function toFilterContext(story) {
127
+ return {
128
+ id: story.id,
129
+ title: story.title,
130
+ name: story.name,
131
+ filePath: `${story.title}/${story.name}`
132
+ };
133
+ }
134
+ /**
135
+ * Create a latch for a Promise. A latch is a Promise that can be resolved from outside.
136
+ * @param T - The type of the Promise
137
+ * @returns A latch for a Promise
138
+ */
139
+ function createLatch() {
140
+ let resolve;
141
+ return {
142
+ p: new Promise((r) => {
143
+ resolve = r;
144
+ }),
145
+ resolve
146
+ };
147
+ }
148
+ /**
149
+ * Storybook Plugin for Cappa
150
+ * Fetches stories from a running Storybook server and takes screenshots of each story.
151
+ * Supports includeStories and excludeStories predicate functions for filtering.
152
+ */
153
+ const cappaPluginStorybook = (options) => {
154
+ return {
155
+ name: "StorybookPlugin",
156
+ description: "Takes screenshots of Storybook stories with configurable options",
157
+ discover: async (screenshotTool) => {
158
+ if (!options) throw new Error("Storybook plugin options are required");
159
+ if (!options.storybookUrl) throw new Error("storybookUrl is required");
160
+ const logger = (0, _cappa_logger.getLogger)();
161
+ const { storybookUrl, includeStories, excludeStories, storybook: defaultStorybookOptions } = options;
162
+ const storiesUrl = `${storybookUrl}/index.json`;
163
+ logger.debug(`Fetching stories from: ${storiesUrl}`);
164
+ const timeout = screenshotTool.connectionTimeout;
165
+ let response;
166
+ try {
167
+ response = await fetch(storiesUrl, { signal: AbortSignal.timeout(timeout) });
168
+ } catch (error) {
169
+ if (error instanceof DOMException && error.name === "TimeoutError") throw new Error(`Connection to Storybook at ${storybookUrl} timed out after ${timeout}ms. Make sure Storybook is running and accessible.`);
170
+ throw new Error(`Failed to connect to Storybook at ${storybookUrl}. Make sure Storybook is running and accessible. Error: ${error.message}`);
171
+ }
172
+ if (!response.ok) throw new Error(`Failed to fetch stories: ${response.status} ${response.statusText}`);
173
+ const data = await response.json();
174
+ let filteredStories = Object.values(data.entries);
175
+ if (includeStories) filteredStories = filteredStories.filter((story) => includeStories(toFilterContext(story)));
176
+ if (excludeStories) filteredStories = filteredStories.filter((story) => !excludeStories(toFilterContext(story)));
177
+ filteredStories = filteredStories.filter((story) => story.type === "story");
178
+ logger.start(`Found ${filteredStories.length} stories to screenshot...`);
179
+ return filteredStories.map((story) => ({
180
+ id: story.id,
181
+ url: buildStorybookIframeUrl({
182
+ baseUrl: storybookUrl,
183
+ storyId: story.id,
184
+ viewMode: defaultStorybookOptions?.viewMode,
185
+ args: defaultStorybookOptions?.args,
186
+ globals: defaultStorybookOptions?.globals,
187
+ query: defaultStorybookOptions?.query,
188
+ fullscreen: defaultStorybookOptions?.fullscreen,
189
+ singleStory: defaultStorybookOptions?.singleStory
190
+ }),
191
+ data: { story }
192
+ }));
193
+ },
194
+ initPage: async (page, screenshotTool) => {
195
+ const logger = (0, _cappa_logger.getLogger)();
196
+ const { logConsoleEvents = true } = screenshotTool;
197
+ const latchMap = /* @__PURE__ */ new Map();
198
+ await page.exposeFunction("__cappa_parameters", async (id, payload) => {
199
+ latchMap.get(id)?.resolve?.(payload);
200
+ });
201
+ if (logConsoleEvents) page.on("console", (message) => {
202
+ logger.debug("console", message.text());
203
+ });
204
+ page.on("pageerror", (error) => {
205
+ logger.debug("pageerror", error);
206
+ });
207
+ return { latchMap };
208
+ },
209
+ execute: async (task, page, screenshotTool, context) => {
210
+ const { url, data } = task;
211
+ const { story } = data;
212
+ const logger = (0, _cappa_logger.getLogger)();
213
+ const { storybook: defaultStorybookOptions } = options || {};
214
+ try {
215
+ const currentLatch = createLatch();
216
+ context.latchMap.set(story.id, currentLatch);
217
+ const captureStart = performance.now();
218
+ await page.goto(url, { timeout: screenshotTool.connectionTimeout });
219
+ const storyParameters = await context.latchMap.get(story.id)?.p;
220
+ context.latchMap.delete(story.id);
221
+ const variantParameters = storyParameters?.variants ?? [];
222
+ if (storyParameters?.skip) {
223
+ logger.warn(`Skipping story ${story.title} - ${story.name}`);
224
+ return {
225
+ storyId: story.id,
226
+ storyName: `${story.title} - ${story.name}`,
227
+ skipped: true
228
+ };
229
+ }
230
+ if (storyParameters && Object.keys(storyParameters).length > 0) logger.debug("Taking screenshot with options", storyParameters);
231
+ const resolvedViewport = storyParameters?.viewport ?? screenshotTool.viewport;
232
+ await page.setViewportSize(resolvedViewport);
233
+ await freezeUI(page);
234
+ await waitForVisualIdle(page);
235
+ await waitForPlayFunctionCompletion(page, `${story.title} - ${story.name}`);
236
+ const toLocatorMask = (mask) => mask?.map((selector) => page.locator(selector));
237
+ const filename = buildFilename(story);
238
+ const variantsWithUrls = [];
239
+ const variantExtrasEntries = [];
240
+ for (const variant of variantParameters) {
241
+ const variantFilename = variant.filename || screenshotTool.getVariantFilename(filename, {
242
+ id: variant.id,
243
+ label: variant.label,
244
+ filename: variant.filename
245
+ });
246
+ const mergedArgs = {
247
+ ...defaultStorybookOptions?.args,
248
+ ...variant.options?.args
249
+ };
250
+ variantsWithUrls.push({
251
+ id: variant.id,
252
+ label: variant.label,
253
+ filename: variantFilename,
254
+ url: buildStorybookIframeUrl({
255
+ baseUrl: options?.storybookUrl || "",
256
+ storyId: story.id,
257
+ viewMode: defaultStorybookOptions?.viewMode,
258
+ args: mergedArgs,
259
+ globals: defaultStorybookOptions?.globals,
260
+ query: defaultStorybookOptions?.query,
261
+ fullscreen: defaultStorybookOptions?.fullscreen,
262
+ singleStory: defaultStorybookOptions?.singleStory
263
+ }),
264
+ options: variant.options ? {
265
+ ...variant.options,
266
+ mask: toLocatorMask(variant.options.mask)
267
+ } : void 0
268
+ });
269
+ variantExtrasEntries.push([variant.id, {
270
+ saveDiffImage: true,
271
+ diffImageFilename: variantFilename,
272
+ diff: variant.options?.diff
273
+ }]);
274
+ }
275
+ const baseOptions = {
276
+ fullPage: storyParameters?.fullPage,
277
+ delay: storyParameters?.delay,
278
+ omitBackground: storyParameters?.omitBackground,
279
+ skip: storyParameters?.skip,
280
+ viewport: storyParameters?.viewport ?? screenshotTool.viewport,
281
+ mask: toLocatorMask(storyParameters?.mask)
282
+ };
283
+ const variantFilenameMap = /* @__PURE__ */ new Map();
284
+ for (const variant of variantsWithUrls) {
285
+ const variantFilename = variant.filename;
286
+ if (!variantFilename) continue;
287
+ variantFilenameMap.set(variant.id, variantFilename);
288
+ }
289
+ const captureExtras = {
290
+ saveDiffImage: true,
291
+ diffImageFilename: filename,
292
+ diff: storyParameters?.diff,
293
+ variants: variantExtrasEntries.length ? Object.fromEntries(variantExtrasEntries) : void 0,
294
+ skipBaseNavigation: true,
295
+ waitForStability: waitForVisualIdle,
296
+ captureStart
297
+ };
298
+ const captureResult = await screenshotTool.captureWithVariants(page, filename, url, baseOptions, variantsWithUrls, captureExtras);
299
+ return {
300
+ storyId: story.id,
301
+ storyName: `${story.title} - ${story.name}`,
302
+ filepath: captureResult.base.filepath,
303
+ success: captureResult.base.skipped ? void 0 : captureResult.base.comparisonResult ? captureResult.base.comparisonResult.passed : Boolean(captureResult.base.filepath),
304
+ skipped: captureResult.base.skipped
305
+ };
306
+ } catch (error) {
307
+ logger.error(`Error taking screenshot of story ${story.title} - ${story.name}:`, error.message);
308
+ return {
309
+ storyId: story.id,
310
+ storyName: `${story.title} - ${story.name}`,
311
+ error: error?.message ?? "Unknown error"
312
+ };
313
+ }
314
+ }
315
+ };
316
+ };
317
+ //#endregion
318
+ //#region src/index.cjs.ts
319
+ const previewAnnotations = [require.resolve("./preview.js")];
320
+ //#endregion
321
+ exports.cappaPluginStorybook = cappaPluginStorybook;
322
+ exports.previewAnnotations = previewAnnotations;
@@ -1,73 +1,75 @@
1
- import { DiffOptions, Plugin } from '@cappa/core';
1
+ import { DiffOptions, Plugin } from "@cappa/core";
2
2
 
3
+ //#region src/types.d.ts
3
4
  interface StorybookRenderOptions {
4
- viewMode?: "story" | "docs";
5
- args?: Record<string, unknown>;
6
- globals?: Record<string, string | number | boolean>;
7
- query?: Record<string, string | number | boolean>;
8
- fullscreen?: boolean;
9
- singleStory?: boolean;
5
+ viewMode?: "story" | "docs";
6
+ args?: Record<string, unknown>;
7
+ globals?: Record<string, string | number | boolean>;
8
+ query?: Record<string, string | number | boolean>;
9
+ fullscreen?: boolean;
10
+ singleStory?: boolean;
10
11
  }
11
12
  type DiffOptionsStorybook = DiffOptions;
12
13
  interface ScreenshotVariantOverrideStorybook {
13
- fullPage?: boolean;
14
- delay?: number;
15
- skip?: boolean;
16
- mask?: string[];
17
- omitBackground?: boolean;
18
- viewport?: {
19
- width: number;
20
- height: number;
21
- };
22
- args?: Record<string, unknown>;
23
- /**
24
- * Optional diff settings override applied when comparing this screenshot.
25
- * Supports both pixel (default) and gmsd algorithms.
26
- */
27
- diff?: DiffOptionsStorybook;
14
+ fullPage?: boolean;
15
+ delay?: number;
16
+ skip?: boolean;
17
+ mask?: string[];
18
+ omitBackground?: boolean;
19
+ viewport?: {
20
+ width: number;
21
+ height: number;
22
+ };
23
+ args?: Record<string, unknown>;
24
+ /**
25
+ * Optional diff settings override applied when comparing this screenshot.
26
+ * Supports both pixel (default) and gmsd algorithms.
27
+ */
28
+ diff?: DiffOptionsStorybook;
28
29
  }
29
30
  interface ScreenshotVariantOptionsStorybook {
30
- id: string;
31
- label?: string;
32
- filename?: string;
33
- options?: ScreenshotVariantOverrideStorybook;
31
+ id: string;
32
+ label?: string;
33
+ filename?: string;
34
+ options?: ScreenshotVariantOverrideStorybook;
34
35
  }
35
36
  interface ScreenshotOptionsStorybook extends ScreenshotVariantOverrideStorybook {
36
- variants?: ScreenshotVariantOptionsStorybook[];
37
+ variants?: ScreenshotVariantOptionsStorybook[];
37
38
  }
38
-
39
+ //#endregion
40
+ //#region src/cappa/plugin.d.ts
39
41
  /**
40
42
  * Context passed to includeStories and excludeStories predicate functions.
41
43
  * Use these fields to decide which stories to include or exclude.
42
44
  */
43
45
  interface StoryFilterContext {
44
- id: string;
45
- title: string;
46
- name: string;
47
- /** Full story path: `${title}/${name}` (e.g. "Button/Primary") */
48
- filePath: string;
46
+ id: string;
47
+ title: string;
48
+ name: string;
49
+ /** Full story path: `${title}/${name}` (e.g. "Button/Primary") */
50
+ filePath: string;
49
51
  }
50
52
  interface StorybookPluginOptions {
51
- storybookUrl: string;
52
- /**
53
- * Optional predicate to include stories. If provided, only stories for which
54
- * it returns true are included. Example: (s) => s.id === 'button--primary'
55
- * or (s) => s.title === 'Button'.
56
- */
57
- includeStories?: (story: StoryFilterContext) => boolean;
58
- /**
59
- * Optional predicate to exclude stories. If provided, stories for which it
60
- * returns true are excluded (applied after includeStories). Example:
61
- * (s) => s.title === 'Input'.
62
- */
63
- excludeStories?: (story: StoryFilterContext) => boolean;
64
- defaultViewport?: {
65
- width: number;
66
- height: number;
67
- };
68
- waitForSelector?: string;
69
- waitForTimeout?: number;
70
- storybook?: StorybookRenderOptions;
53
+ storybookUrl: string;
54
+ /**
55
+ * Optional predicate to include stories. If provided, only stories for which
56
+ * it returns true are included. Example: (s) => s.id === 'button--primary'
57
+ * or (s) => s.title === 'Button'.
58
+ */
59
+ includeStories?: (story: StoryFilterContext) => boolean;
60
+ /**
61
+ * Optional predicate to exclude stories. If provided, stories for which it
62
+ * returns true are excluded (applied after includeStories). Example:
63
+ * (s) => s.title === 'Input'.
64
+ */
65
+ excludeStories?: (story: StoryFilterContext) => boolean;
66
+ defaultViewport?: {
67
+ width: number;
68
+ height: number;
69
+ };
70
+ waitForSelector?: string;
71
+ waitForTimeout?: number;
72
+ storybook?: StorybookRenderOptions;
71
73
  }
72
74
  /**
73
75
  * Storybook Plugin for Cappa
@@ -75,7 +77,8 @@ interface StorybookPluginOptions {
75
77
  * Supports includeStories and excludeStories predicate functions for filtering.
76
78
  */
77
79
  declare const cappaPluginStorybook: Plugin<StorybookPluginOptions>;
78
-
80
+ //#endregion
81
+ //#region src/index.cjs.d.ts
79
82
  declare const previewAnnotations: string[];
80
-
81
- export { type ScreenshotOptionsStorybook as CappaStorybookOptions, type StoryFilterContext, type StorybookPluginOptions, cappaPluginStorybook, previewAnnotations };
83
+ //#endregion
84
+ export { type ScreenshotOptionsStorybook as CappaStorybookOptions, type StoryFilterContext, type StorybookPluginOptions, cappaPluginStorybook, previewAnnotations };
@@ -0,0 +1,84 @@
1
+ import { DiffOptions, Plugin } from "@cappa/core";
2
+
3
+ //#region src/types.d.ts
4
+ interface StorybookRenderOptions {
5
+ viewMode?: "story" | "docs";
6
+ args?: Record<string, unknown>;
7
+ globals?: Record<string, string | number | boolean>;
8
+ query?: Record<string, string | number | boolean>;
9
+ fullscreen?: boolean;
10
+ singleStory?: boolean;
11
+ }
12
+ type DiffOptionsStorybook = DiffOptions;
13
+ interface ScreenshotVariantOverrideStorybook {
14
+ fullPage?: boolean;
15
+ delay?: number;
16
+ skip?: boolean;
17
+ mask?: string[];
18
+ omitBackground?: boolean;
19
+ viewport?: {
20
+ width: number;
21
+ height: number;
22
+ };
23
+ args?: Record<string, unknown>;
24
+ /**
25
+ * Optional diff settings override applied when comparing this screenshot.
26
+ * Supports both pixel (default) and gmsd algorithms.
27
+ */
28
+ diff?: DiffOptionsStorybook;
29
+ }
30
+ interface ScreenshotVariantOptionsStorybook {
31
+ id: string;
32
+ label?: string;
33
+ filename?: string;
34
+ options?: ScreenshotVariantOverrideStorybook;
35
+ }
36
+ interface ScreenshotOptionsStorybook extends ScreenshotVariantOverrideStorybook {
37
+ variants?: ScreenshotVariantOptionsStorybook[];
38
+ }
39
+ //#endregion
40
+ //#region src/cappa/plugin.d.ts
41
+ /**
42
+ * Context passed to includeStories and excludeStories predicate functions.
43
+ * Use these fields to decide which stories to include or exclude.
44
+ */
45
+ interface StoryFilterContext {
46
+ id: string;
47
+ title: string;
48
+ name: string;
49
+ /** Full story path: `${title}/${name}` (e.g. "Button/Primary") */
50
+ filePath: string;
51
+ }
52
+ interface StorybookPluginOptions {
53
+ storybookUrl: string;
54
+ /**
55
+ * Optional predicate to include stories. If provided, only stories for which
56
+ * it returns true are included. Example: (s) => s.id === 'button--primary'
57
+ * or (s) => s.title === 'Button'.
58
+ */
59
+ includeStories?: (story: StoryFilterContext) => boolean;
60
+ /**
61
+ * Optional predicate to exclude stories. If provided, stories for which it
62
+ * returns true are excluded (applied after includeStories). Example:
63
+ * (s) => s.title === 'Input'.
64
+ */
65
+ excludeStories?: (story: StoryFilterContext) => boolean;
66
+ defaultViewport?: {
67
+ width: number;
68
+ height: number;
69
+ };
70
+ waitForSelector?: string;
71
+ waitForTimeout?: number;
72
+ storybook?: StorybookRenderOptions;
73
+ }
74
+ /**
75
+ * Storybook Plugin for Cappa
76
+ * Fetches stories from a running Storybook server and takes screenshots of each story.
77
+ * Supports includeStories and excludeStories predicate functions for filtering.
78
+ */
79
+ declare const cappaPluginStorybook: Plugin<StorybookPluginOptions>;
80
+ //#endregion
81
+ //#region src/index.esm.d.ts
82
+ declare const previewAnnotations: string[];
83
+ //#endregion
84
+ export { type ScreenshotOptionsStorybook as CappaStorybookOptions, type StoryFilterContext, type StorybookPluginOptions, cappaPluginStorybook, previewAnnotations };