@cappa/plugin-storybook 0.0.5 → 0.0.7

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.
@@ -1,11 +1,11 @@
1
1
 
2
2
 
3
- > @cappa/plugin-storybook@0.0.4 build /home/tim/cappa/packages/plugins/plugin-storybook
3
+ > @cappa/plugin-storybook@0.0.6 build /home/tim/cappa/packages/plugins/plugin-storybook
4
4
  > tsdown
5
5
 
6
6
  ℹ tsdown v0.14.1 powered by rolldown v1.0.0-beta.37
7
7
  ℹ Using tsdown config: /home/tim/cappa/packages/plugins/plugin-storybook/tsdown.config.ts
8
- (node:59324) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/tim/cappa/packages/plugins/plugin-storybook/tsdown.config.ts is not specified and it doesn't parse as CommonJS.
8
+ (node:174667) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/tim/cappa/packages/plugins/plugin-storybook/tsdown.config.ts is not specified and it doesn't parse as CommonJS.
9
9
  Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
10
10
  To eliminate this warning, add "type": "module" to /home/tim/cappa/packages/plugins/plugin-storybook/package.json.
11
11
  (Use `node --trace-warnings ...` to show where the warning was created)
@@ -17,15 +17,15 @@ To eliminate this warning, add "type": "module" to /home/tim/cappa/packages/plug
17
17
  - For the "resolve.tsconfigFilename". It is deprecated. Please use the top-level `tsconfig` option instead. 
18
18
  Warning: Invalid input options (1 issue found)
19
19
  - For the "resolve.tsconfigFilename". It is deprecated. Please use the top-level `tsconfig` option instead. 
20
- ℹ [CJS] dist/index.js  7.24 kB │ gzip: 2.54 kB
21
- ℹ [CJS] dist/index.js.map 12.74 kB │ gzip: 4.04 kB
22
- ℹ [CJS] 2 files, total: 19.98 kB
20
+ ℹ [CJS] dist/index.js  7.45 kB │ gzip: 2.59 kB
21
+ ℹ [CJS] dist/index.js.map 13.17 kB │ gzip: 4.12 kB
22
+ ℹ [CJS] 2 files, total: 20.62 kB
23
23
  Warning: Invalid input options (1 issue found)
24
24
  - For the "resolve.tsconfigFilename". It is deprecated. Please use the top-level `tsconfig` option instead. 
25
- ℹ [ESM] dist/index.mjs  6.14 kB │ gzip: 2.13 kB
26
- ℹ [ESM] dist/index.mjs.map 12.72 kB │ gzip: 4.04 kB
25
+ ℹ [ESM] dist/index.mjs  6.35 kB │ gzip: 2.18 kB
26
+ ℹ [ESM] dist/index.mjs.map 13.15 kB │ gzip: 4.12 kB
27
27
  ℹ [ESM] dist/index.d.mts  0.71 kB │ gzip: 0.39 kB
28
- ℹ [ESM] 3 files, total: 19.58 kB
28
+ ℹ [ESM] 3 files, total: 20.21 kB
29
29
  ℹ [CJS] dist/index.d.ts 0.71 kB │ gzip: 0.38 kB
30
30
  ℹ [CJS] 1 files, total: 0.71 kB
31
- ✔ Build complete in 1302ms
31
+ ✔ Build complete in 1230ms
package/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # @cappa/plugin-storybook
2
2
 
3
+ ## 0.0.7
4
+
5
+ ### Patch Changes
6
+
7
+ - 3c53e57: Reuse playwright pages
8
+ - Updated dependencies [3c53e57]
9
+ - @cappa/core@0.0.7
10
+
11
+ ## 0.0.6
12
+
13
+ ### Patch Changes
14
+
15
+ - 2acecef: Add skip option
16
+ - Updated dependencies [2acecef]
17
+ - @cappa/core@0.0.6
18
+
3
19
  ## 0.0.5
4
20
 
5
21
  ### Patch Changes
package/dist/index.js CHANGED
@@ -91,6 +91,7 @@ const cappaPluginStorybook = (options) => {
91
91
  filteredStories = filteredStories.filter((story) => story.type === "story");
92
92
  console.log(`Found ${filteredStories.length} stories to screenshot`);
93
93
  const results = [];
94
+ await screenshotTool.newPage();
94
95
  for (const story of filteredStories) try {
95
96
  const storyUrl = `${storybookUrl}/iframe.html?id=${story.id}&viewMode=story`;
96
97
  const screenshotOptions = {
@@ -102,7 +103,8 @@ const cappaPluginStorybook = (options) => {
102
103
  type: "jpeg"
103
104
  };
104
105
  const filename = `${story.title.replace(/[^a-zA-Z0-9]/g, "_")}_${story.name.replace(/[^a-zA-Z0-9]/g, "_")}.${screenshotOptions.type}`;
105
- const page = await screenshotTool.newPage();
106
+ const page = await screenshotTool.getPage();
107
+ if (!page) throw new Error("Page not found");
106
108
  page.on("console", (message) => {
107
109
  console.log("console", message.text());
108
110
  });
@@ -115,6 +117,10 @@ const cappaPluginStorybook = (options) => {
115
117
  });
116
118
  await page.goto(storyUrl);
117
119
  const options$1 = await latch.p;
120
+ if (options$1.skip) {
121
+ console.log(`Skipping story ${story.title} - ${story.name}`);
122
+ continue;
123
+ }
118
124
  await freezeUI(page);
119
125
  await waitForVisualIdle(page);
120
126
  if (options$1.delay) await page.waitForTimeout(options$1.delay);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["resolve!: (v: T) => void","cappaPluginStorybook: Plugin<StorybookPluginOptions>","data: StorybookStoriesResponse","results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }>","options"],"sources":["../src/cappa/util.ts","../src/cappa/plugin.ts","../src/storybook/util.ts","../src/storybook/decorator.ts"],"sourcesContent":["import type { Page } from \"playwright\";\n\n/**\n * Disable CSS transitions, animations, and scrollbars\n * @param page - The page to disable CSS transitions, animations, and scrollbars\n */\nexport const freezeUI = async (page: Page) => {\n await page.addStyleTag({\n content: `\n\t\t\t* { transition: none !important; animation: none !important }\n\t\t\t* { caret-color: transparent !important }\n\t\t\t::-webkit-scrollbar { display: none }\n\t\t`,\n });\n};\n\n/**\n * Wait for general visual stability on the page\n * @param page - The page to wait for\n */\nexport const waitForVisualIdle = async (page: Page) => {\n // Wait for the page to be fully loaded\n await page.waitForLoadState(\"networkidle\");\n\n await page.evaluate(async () => {\n // Wait for the fonts to be loaded\n if (document.fonts?.ready) await document.fonts.ready;\n\n // Wait for a frame to be idle in the requestAnimationFrame queue\n await new Promise((r) =>\n requestAnimationFrame(() => requestAnimationFrame(r))\n );\n });\n};\n","import { Plugin, ScreenshotOptions, ScreenshotTool } from \"@cappa/core\";\nimport { freezeUI, waitForVisualIdle } from \"./util\";\n\ninterface StorybookStory {\n id: string;\n name: string;\n title: string;\n kind: string;\n story: string;\n type: \"story\" | \"docs\";\n}\n\ninterface StorybookStoriesResponse {\n entries: Record<string, StorybookStory>;\n}\n\ninterface StorybookPluginOptions {\n storybookUrl: string;\n includeStories?: string[];\n excludeStories?: string[];\n defaultViewport?: { width: number; height: number };\n waitForSelector?: string;\n waitForTimeout?: number;\n}\n\n/**\n * Create a latch for a Promise. A latch is a Promise that can be resolved from outside.\n * @param T - The type of the Promise\n * @returns A latch for a Promise\n */\nfunction createLatch<T>() {\n let resolve!: (v: T) => void;\n const p = new Promise<T>((r) => (resolve = r));\n return { p, resolve };\n}\n\n/**\n * Storybook Plugin for Cappa\n * Fetches stories from a running Storybook server and takes screenshots of each story\n */\nexport const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (\n options\n) => {\n return {\n name: \"StorybookPlugin\",\n description:\n \"Takes screenshots of Storybook stories with configurable options\",\n version: \"1.0.0\",\n execute: async (screenshotTool: ScreenshotTool) => {\n if (!options) {\n throw new Error(\"Storybook plugin options are required\");\n }\n if (!options.storybookUrl) {\n throw new Error(\"storybookUrl is required\");\n }\n\n const {\n storybookUrl,\n includeStories = [],\n excludeStories = [],\n defaultViewport = { width: 1920, height: 1080 },\n waitForSelector,\n waitForTimeout,\n } = options;\n\n const storiesUrl = `${storybookUrl}/index.json`;\n console.log(`Fetching stories from: ${storiesUrl}`);\n\n try {\n // Fetch stories from Storybook\n const response = await fetch(storiesUrl);\n if (!response.ok) {\n throw new Error(\n `Failed to fetch stories: ${response.status} ${response.statusText}`\n );\n }\n\n const data: StorybookStoriesResponse = await response.json();\n const stories = Object.values(data.entries);\n\n // Filter stories based on include/exclude patterns\n let filteredStories = stories;\n\n if (includeStories.length > 0) {\n filteredStories = filteredStories.filter((story) =>\n includeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n if (excludeStories.length > 0) {\n filteredStories = filteredStories.filter(\n (story) =>\n !excludeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n // Filter docs etc\n filteredStories = filteredStories.filter(\n (story) => story.type === \"story\"\n );\n\n console.log(`Found ${filteredStories.length} stories to screenshot`);\n\n const results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }> = [];\n\n // Take screenshots of each story\n for (const story of filteredStories) {\n try {\n const storyUrl = `${storybookUrl}/iframe.html?id=${story.id}&viewMode=story`;\n\n // Merge with default options\n const screenshotOptions = {\n viewport: defaultViewport,\n waitForSelector: waitForSelector,\n waitForTimeout: waitForTimeout,\n fullPage: true,\n quality: 90,\n type: \"jpeg\" as const,\n };\n\n // Take screenshot with story-specific filename\n const filename = `${story.title.replace(\n /[^a-zA-Z0-9]/g,\n \"_\"\n )}_${story.name.replace(/[^a-zA-Z0-9]/g, \"_\")}.${\n screenshotOptions.type\n }`;\n\n const page = await screenshotTool.newPage();\n\n page.on(\"console\", (message) => {\n console.log(\"console\", message.text());\n });\n page.on(\"pageerror\", (error) => {\n console.log(\"pageerror\", error);\n });\n\n const latch = createLatch<ScreenshotOptions>();\n\n await page.exposeFunction(\n \"__cappa_parameters\",\n async (payload: ScreenshotOptions) => {\n latch.resolve(payload);\n }\n );\n\n await page.goto(storyUrl);\n\n const options = await latch.p;\n\n await freezeUI(page);\n await waitForVisualIdle(page);\n\n if (options.delay) {\n await page.waitForTimeout(options.delay);\n }\n\n // Actually take the screenshot\n const actualFilepath = await screenshotTool.takeScreenshot(\n page,\n filename,\n {\n fullPage: options.fullPage ?? screenshotOptions.fullPage,\n type: options.type ?? screenshotOptions.type,\n waitForSelector:\n options.waitForSelector ?? screenshotOptions.waitForSelector,\n waitForTimeout:\n options.waitForTimeout ?? screenshotOptions.waitForTimeout,\n }\n );\n\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: true,\n filepath: actualFilepath,\n });\n } catch (error) {\n console.error(\n `Error taking screenshot of story ${story.title} - ${story.name}:`,\n (error as Error).message\n );\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: false,\n error: (error as Error).message,\n });\n }\n }\n\n console.log(\n `Completed screenshots: ${results.filter((r) => r.success).length}/${\n results.length\n } successful`\n );\n return results;\n } catch (error) {\n console.error(\"Error in Storybook plugin:\", (error as Error).message);\n throw error;\n }\n },\n };\n};\n","/**\n * Wait for a function to be exposed on the window object\n * @param name - The name of the function to wait for\n * @param timeoutMs - The timeout in milliseconds\n * @returns The function or rejects if the function is not exposed within the timeout\n */\nexport const waitForExposed = (name: string, timeoutMs = 5000) => {\n return new Promise<Function>((resolve, reject) => {\n const start = performance.now();\n\n const t = setInterval(() => {\n const fn = (window as any)[name];\n if (typeof fn === \"function\") {\n clearInterval(t);\n resolve(fn);\n } else if (performance.now() - start > timeoutMs) {\n clearInterval(t);\n reject(new Error(`Timed out waiting for ${name}`));\n }\n }, 16);\n });\n};\n","import { makeDecorator } from \"storybook/preview-api\";\nimport { waitForExposed } from \"./util\";\n\nexport const withCappaDecorator = makeDecorator({\n name: \"withCappa\",\n parameterName: \"cappa\",\n skipIfNoParametersOrOptions: false,\n wrapper: (getStory, context, { parameters }) => {\n queueMicrotask(async () => {\n try {\n const cappaParameters = await waitForExposed(\"__cappa_parameters\");\n\n cappaParameters(parameters ?? {});\n } catch (error) {\n console.error(error);\n }\n });\n\n return getStory(context);\n },\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["resolve!: (v: T) => void","cappaPluginStorybook: Plugin<StorybookPluginOptions>","data: StorybookStoriesResponse","results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }>","options"],"sources":["../src/cappa/util.ts","../src/cappa/plugin.ts","../src/storybook/util.ts","../src/storybook/decorator.ts"],"sourcesContent":["import type { Page } from \"playwright\";\n\n/**\n * Disable CSS transitions, animations, and scrollbars\n * @param page - The page to disable CSS transitions, animations, and scrollbars\n */\nexport const freezeUI = async (page: Page) => {\n await page.addStyleTag({\n content: `\n\t\t\t* { transition: none !important; animation: none !important }\n\t\t\t* { caret-color: transparent !important }\n\t\t\t::-webkit-scrollbar { display: none }\n\t\t`,\n });\n};\n\n/**\n * Wait for general visual stability on the page\n * @param page - The page to wait for\n */\nexport const waitForVisualIdle = async (page: Page) => {\n // Wait for the page to be fully loaded\n await page.waitForLoadState(\"networkidle\");\n\n await page.evaluate(async () => {\n // Wait for the fonts to be loaded\n if (document.fonts?.ready) await document.fonts.ready;\n\n // Wait for a frame to be idle in the requestAnimationFrame queue\n await new Promise((r) =>\n requestAnimationFrame(() => requestAnimationFrame(r))\n );\n });\n};\n","import { Plugin, ScreenshotOptions, ScreenshotTool } from \"@cappa/core\";\nimport { freezeUI, waitForVisualIdle } from \"./util\";\n\ninterface StorybookStory {\n id: string;\n name: string;\n title: string;\n kind: string;\n story: string;\n type: \"story\" | \"docs\";\n}\n\ninterface StorybookStoriesResponse {\n entries: Record<string, StorybookStory>;\n}\n\ninterface StorybookPluginOptions {\n storybookUrl: string;\n includeStories?: string[];\n excludeStories?: string[];\n defaultViewport?: { width: number; height: number };\n waitForSelector?: string;\n waitForTimeout?: number;\n}\n\n/**\n * Create a latch for a Promise. A latch is a Promise that can be resolved from outside.\n * @param T - The type of the Promise\n * @returns A latch for a Promise\n */\nfunction createLatch<T>() {\n let resolve!: (v: T) => void;\n const p = new Promise<T>((r) => (resolve = r));\n return { p, resolve };\n}\n\n/**\n * Storybook Plugin for Cappa\n * Fetches stories from a running Storybook server and takes screenshots of each story\n */\nexport const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (\n options\n) => {\n return {\n name: \"StorybookPlugin\",\n description:\n \"Takes screenshots of Storybook stories with configurable options\",\n version: \"1.0.0\",\n execute: async (screenshotTool: ScreenshotTool) => {\n if (!options) {\n throw new Error(\"Storybook plugin options are required\");\n }\n if (!options.storybookUrl) {\n throw new Error(\"storybookUrl is required\");\n }\n\n const {\n storybookUrl,\n includeStories = [],\n excludeStories = [],\n defaultViewport = { width: 1920, height: 1080 },\n waitForSelector,\n waitForTimeout,\n } = options;\n\n const storiesUrl = `${storybookUrl}/index.json`;\n console.log(`Fetching stories from: ${storiesUrl}`);\n\n try {\n // Fetch stories from Storybook\n const response = await fetch(storiesUrl);\n if (!response.ok) {\n throw new Error(\n `Failed to fetch stories: ${response.status} ${response.statusText}`\n );\n }\n\n const data: StorybookStoriesResponse = await response.json();\n const stories = Object.values(data.entries);\n\n // Filter stories based on include/exclude patterns\n let filteredStories = stories;\n\n if (includeStories.length > 0) {\n filteredStories = filteredStories.filter((story) =>\n includeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n if (excludeStories.length > 0) {\n filteredStories = filteredStories.filter(\n (story) =>\n !excludeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n // Filter docs etc\n filteredStories = filteredStories.filter(\n (story) => story.type === \"story\"\n );\n\n console.log(`Found ${filteredStories.length} stories to screenshot`);\n\n const results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }> = [];\n\n await screenshotTool.newPage();\n\n // Take screenshots of each story\n for (const story of filteredStories) {\n try {\n const storyUrl = `${storybookUrl}/iframe.html?id=${story.id}&viewMode=story`;\n\n // Merge with default options\n const screenshotOptions = {\n viewport: defaultViewport,\n waitForSelector: waitForSelector,\n waitForTimeout: waitForTimeout,\n fullPage: true,\n quality: 90,\n type: \"jpeg\" as const,\n };\n\n // Take screenshot with story-specific filename\n const filename = `${story.title.replace(\n /[^a-zA-Z0-9]/g,\n \"_\"\n )}_${story.name.replace(/[^a-zA-Z0-9]/g, \"_\")}.${\n screenshotOptions.type\n }`;\n\n const page = await screenshotTool.getPage();\n\n if (!page) {\n throw new Error(\"Page not found\");\n }\n\n page.on(\"console\", (message) => {\n console.log(\"console\", message.text());\n });\n page.on(\"pageerror\", (error) => {\n console.log(\"pageerror\", error);\n });\n\n const latch = createLatch<ScreenshotOptions>();\n\n await page.exposeFunction(\n \"__cappa_parameters\",\n async (payload: ScreenshotOptions) => {\n latch.resolve(payload);\n }\n );\n\n await page.goto(storyUrl);\n\n const options = await latch.p;\n\n if (options.skip) {\n console.log(`Skipping story ${story.title} - ${story.name}`);\n continue;\n }\n\n await freezeUI(page);\n await waitForVisualIdle(page);\n\n if (options.delay) {\n await page.waitForTimeout(options.delay);\n }\n\n // Actually take the screenshot\n const actualFilepath = await screenshotTool.takeScreenshot(\n page,\n filename,\n {\n fullPage: options.fullPage ?? screenshotOptions.fullPage,\n type: options.type ?? screenshotOptions.type,\n waitForSelector:\n options.waitForSelector ?? screenshotOptions.waitForSelector,\n waitForTimeout:\n options.waitForTimeout ?? screenshotOptions.waitForTimeout,\n }\n );\n\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: true,\n filepath: actualFilepath,\n });\n } catch (error) {\n console.error(\n `Error taking screenshot of story ${story.title} - ${story.name}:`,\n (error as Error).message\n );\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: false,\n error: (error as Error).message,\n });\n }\n }\n\n console.log(\n `Completed screenshots: ${results.filter((r) => r.success).length}/${\n results.length\n } successful`\n );\n return results;\n } catch (error) {\n console.error(\"Error in Storybook plugin:\", (error as Error).message);\n throw error;\n }\n },\n };\n};\n","/**\n * Wait for a function to be exposed on the window object\n * @param name - The name of the function to wait for\n * @param timeoutMs - The timeout in milliseconds\n * @returns The function or rejects if the function is not exposed within the timeout\n */\nexport const waitForExposed = (name: string, timeoutMs = 5000) => {\n return new Promise<Function>((resolve, reject) => {\n const start = performance.now();\n\n const t = setInterval(() => {\n const fn = (window as any)[name];\n if (typeof fn === \"function\") {\n clearInterval(t);\n resolve(fn);\n } else if (performance.now() - start > timeoutMs) {\n clearInterval(t);\n reject(new Error(`Timed out waiting for ${name}`));\n }\n }, 16);\n });\n};\n","import { makeDecorator } from \"storybook/preview-api\";\nimport { waitForExposed } from \"./util\";\n\nexport const withCappaDecorator = makeDecorator({\n name: \"withCappa\",\n parameterName: \"cappa\",\n skipIfNoParametersOrOptions: false,\n wrapper: (getStory, context, { parameters }) => {\n queueMicrotask(async () => {\n try {\n const cappaParameters = await waitForExposed(\"__cappa_parameters\");\n\n cappaParameters(parameters ?? {});\n } catch (error) {\n console.error(error);\n }\n });\n\n return getStory(context);\n },\n});\n"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -67,6 +67,7 @@ const cappaPluginStorybook = (options) => {
67
67
  filteredStories = filteredStories.filter((story) => story.type === "story");
68
68
  console.log(`Found ${filteredStories.length} stories to screenshot`);
69
69
  const results = [];
70
+ await screenshotTool.newPage();
70
71
  for (const story of filteredStories) try {
71
72
  const storyUrl = `${storybookUrl}/iframe.html?id=${story.id}&viewMode=story`;
72
73
  const screenshotOptions = {
@@ -78,7 +79,8 @@ const cappaPluginStorybook = (options) => {
78
79
  type: "jpeg"
79
80
  };
80
81
  const filename = `${story.title.replace(/[^a-zA-Z0-9]/g, "_")}_${story.name.replace(/[^a-zA-Z0-9]/g, "_")}.${screenshotOptions.type}`;
81
- const page = await screenshotTool.newPage();
82
+ const page = await screenshotTool.getPage();
83
+ if (!page) throw new Error("Page not found");
82
84
  page.on("console", (message) => {
83
85
  console.log("console", message.text());
84
86
  });
@@ -91,6 +93,10 @@ const cappaPluginStorybook = (options) => {
91
93
  });
92
94
  await page.goto(storyUrl);
93
95
  const options$1 = await latch.p;
96
+ if (options$1.skip) {
97
+ console.log(`Skipping story ${story.title} - ${story.name}`);
98
+ continue;
99
+ }
94
100
  await freezeUI(page);
95
101
  await waitForVisualIdle(page);
96
102
  if (options$1.delay) await page.waitForTimeout(options$1.delay);
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["resolve!: (v: T) => void","cappaPluginStorybook: Plugin<StorybookPluginOptions>","data: StorybookStoriesResponse","results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }>","options"],"sources":["../src/cappa/util.ts","../src/cappa/plugin.ts","../src/storybook/util.ts","../src/storybook/decorator.ts"],"sourcesContent":["import type { Page } from \"playwright\";\n\n/**\n * Disable CSS transitions, animations, and scrollbars\n * @param page - The page to disable CSS transitions, animations, and scrollbars\n */\nexport const freezeUI = async (page: Page) => {\n await page.addStyleTag({\n content: `\n\t\t\t* { transition: none !important; animation: none !important }\n\t\t\t* { caret-color: transparent !important }\n\t\t\t::-webkit-scrollbar { display: none }\n\t\t`,\n });\n};\n\n/**\n * Wait for general visual stability on the page\n * @param page - The page to wait for\n */\nexport const waitForVisualIdle = async (page: Page) => {\n // Wait for the page to be fully loaded\n await page.waitForLoadState(\"networkidle\");\n\n await page.evaluate(async () => {\n // Wait for the fonts to be loaded\n if (document.fonts?.ready) await document.fonts.ready;\n\n // Wait for a frame to be idle in the requestAnimationFrame queue\n await new Promise((r) =>\n requestAnimationFrame(() => requestAnimationFrame(r))\n );\n });\n};\n","import { Plugin, ScreenshotOptions, ScreenshotTool } from \"@cappa/core\";\nimport { freezeUI, waitForVisualIdle } from \"./util\";\n\ninterface StorybookStory {\n id: string;\n name: string;\n title: string;\n kind: string;\n story: string;\n type: \"story\" | \"docs\";\n}\n\ninterface StorybookStoriesResponse {\n entries: Record<string, StorybookStory>;\n}\n\ninterface StorybookPluginOptions {\n storybookUrl: string;\n includeStories?: string[];\n excludeStories?: string[];\n defaultViewport?: { width: number; height: number };\n waitForSelector?: string;\n waitForTimeout?: number;\n}\n\n/**\n * Create a latch for a Promise. A latch is a Promise that can be resolved from outside.\n * @param T - The type of the Promise\n * @returns A latch for a Promise\n */\nfunction createLatch<T>() {\n let resolve!: (v: T) => void;\n const p = new Promise<T>((r) => (resolve = r));\n return { p, resolve };\n}\n\n/**\n * Storybook Plugin for Cappa\n * Fetches stories from a running Storybook server and takes screenshots of each story\n */\nexport const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (\n options\n) => {\n return {\n name: \"StorybookPlugin\",\n description:\n \"Takes screenshots of Storybook stories with configurable options\",\n version: \"1.0.0\",\n execute: async (screenshotTool: ScreenshotTool) => {\n if (!options) {\n throw new Error(\"Storybook plugin options are required\");\n }\n if (!options.storybookUrl) {\n throw new Error(\"storybookUrl is required\");\n }\n\n const {\n storybookUrl,\n includeStories = [],\n excludeStories = [],\n defaultViewport = { width: 1920, height: 1080 },\n waitForSelector,\n waitForTimeout,\n } = options;\n\n const storiesUrl = `${storybookUrl}/index.json`;\n console.log(`Fetching stories from: ${storiesUrl}`);\n\n try {\n // Fetch stories from Storybook\n const response = await fetch(storiesUrl);\n if (!response.ok) {\n throw new Error(\n `Failed to fetch stories: ${response.status} ${response.statusText}`\n );\n }\n\n const data: StorybookStoriesResponse = await response.json();\n const stories = Object.values(data.entries);\n\n // Filter stories based on include/exclude patterns\n let filteredStories = stories;\n\n if (includeStories.length > 0) {\n filteredStories = filteredStories.filter((story) =>\n includeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n if (excludeStories.length > 0) {\n filteredStories = filteredStories.filter(\n (story) =>\n !excludeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n // Filter docs etc\n filteredStories = filteredStories.filter(\n (story) => story.type === \"story\"\n );\n\n console.log(`Found ${filteredStories.length} stories to screenshot`);\n\n const results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }> = [];\n\n // Take screenshots of each story\n for (const story of filteredStories) {\n try {\n const storyUrl = `${storybookUrl}/iframe.html?id=${story.id}&viewMode=story`;\n\n // Merge with default options\n const screenshotOptions = {\n viewport: defaultViewport,\n waitForSelector: waitForSelector,\n waitForTimeout: waitForTimeout,\n fullPage: true,\n quality: 90,\n type: \"jpeg\" as const,\n };\n\n // Take screenshot with story-specific filename\n const filename = `${story.title.replace(\n /[^a-zA-Z0-9]/g,\n \"_\"\n )}_${story.name.replace(/[^a-zA-Z0-9]/g, \"_\")}.${\n screenshotOptions.type\n }`;\n\n const page = await screenshotTool.newPage();\n\n page.on(\"console\", (message) => {\n console.log(\"console\", message.text());\n });\n page.on(\"pageerror\", (error) => {\n console.log(\"pageerror\", error);\n });\n\n const latch = createLatch<ScreenshotOptions>();\n\n await page.exposeFunction(\n \"__cappa_parameters\",\n async (payload: ScreenshotOptions) => {\n latch.resolve(payload);\n }\n );\n\n await page.goto(storyUrl);\n\n const options = await latch.p;\n\n await freezeUI(page);\n await waitForVisualIdle(page);\n\n if (options.delay) {\n await page.waitForTimeout(options.delay);\n }\n\n // Actually take the screenshot\n const actualFilepath = await screenshotTool.takeScreenshot(\n page,\n filename,\n {\n fullPage: options.fullPage ?? screenshotOptions.fullPage,\n type: options.type ?? screenshotOptions.type,\n waitForSelector:\n options.waitForSelector ?? screenshotOptions.waitForSelector,\n waitForTimeout:\n options.waitForTimeout ?? screenshotOptions.waitForTimeout,\n }\n );\n\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: true,\n filepath: actualFilepath,\n });\n } catch (error) {\n console.error(\n `Error taking screenshot of story ${story.title} - ${story.name}:`,\n (error as Error).message\n );\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: false,\n error: (error as Error).message,\n });\n }\n }\n\n console.log(\n `Completed screenshots: ${results.filter((r) => r.success).length}/${\n results.length\n } successful`\n );\n return results;\n } catch (error) {\n console.error(\"Error in Storybook plugin:\", (error as Error).message);\n throw error;\n }\n },\n };\n};\n","/**\n * Wait for a function to be exposed on the window object\n * @param name - The name of the function to wait for\n * @param timeoutMs - The timeout in milliseconds\n * @returns The function or rejects if the function is not exposed within the timeout\n */\nexport const waitForExposed = (name: string, timeoutMs = 5000) => {\n return new Promise<Function>((resolve, reject) => {\n const start = performance.now();\n\n const t = setInterval(() => {\n const fn = (window as any)[name];\n if (typeof fn === \"function\") {\n clearInterval(t);\n resolve(fn);\n } else if (performance.now() - start > timeoutMs) {\n clearInterval(t);\n reject(new Error(`Timed out waiting for ${name}`));\n }\n }, 16);\n });\n};\n","import { makeDecorator } from \"storybook/preview-api\";\nimport { waitForExposed } from \"./util\";\n\nexport const withCappaDecorator = makeDecorator({\n name: \"withCappa\",\n parameterName: \"cappa\",\n skipIfNoParametersOrOptions: false,\n wrapper: (getStory, context, { parameters }) => {\n queueMicrotask(async () => {\n try {\n const cappaParameters = await waitForExposed(\"__cappa_parameters\");\n\n cappaParameters(parameters ?? {});\n } catch (error) {\n console.error(error);\n }\n });\n\n return getStory(context);\n },\n});\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["resolve!: (v: T) => void","cappaPluginStorybook: Plugin<StorybookPluginOptions>","data: StorybookStoriesResponse","results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }>","options"],"sources":["../src/cappa/util.ts","../src/cappa/plugin.ts","../src/storybook/util.ts","../src/storybook/decorator.ts"],"sourcesContent":["import type { Page } from \"playwright\";\n\n/**\n * Disable CSS transitions, animations, and scrollbars\n * @param page - The page to disable CSS transitions, animations, and scrollbars\n */\nexport const freezeUI = async (page: Page) => {\n await page.addStyleTag({\n content: `\n\t\t\t* { transition: none !important; animation: none !important }\n\t\t\t* { caret-color: transparent !important }\n\t\t\t::-webkit-scrollbar { display: none }\n\t\t`,\n });\n};\n\n/**\n * Wait for general visual stability on the page\n * @param page - The page to wait for\n */\nexport const waitForVisualIdle = async (page: Page) => {\n // Wait for the page to be fully loaded\n await page.waitForLoadState(\"networkidle\");\n\n await page.evaluate(async () => {\n // Wait for the fonts to be loaded\n if (document.fonts?.ready) await document.fonts.ready;\n\n // Wait for a frame to be idle in the requestAnimationFrame queue\n await new Promise((r) =>\n requestAnimationFrame(() => requestAnimationFrame(r))\n );\n });\n};\n","import { Plugin, ScreenshotOptions, ScreenshotTool } from \"@cappa/core\";\nimport { freezeUI, waitForVisualIdle } from \"./util\";\n\ninterface StorybookStory {\n id: string;\n name: string;\n title: string;\n kind: string;\n story: string;\n type: \"story\" | \"docs\";\n}\n\ninterface StorybookStoriesResponse {\n entries: Record<string, StorybookStory>;\n}\n\ninterface StorybookPluginOptions {\n storybookUrl: string;\n includeStories?: string[];\n excludeStories?: string[];\n defaultViewport?: { width: number; height: number };\n waitForSelector?: string;\n waitForTimeout?: number;\n}\n\n/**\n * Create a latch for a Promise. A latch is a Promise that can be resolved from outside.\n * @param T - The type of the Promise\n * @returns A latch for a Promise\n */\nfunction createLatch<T>() {\n let resolve!: (v: T) => void;\n const p = new Promise<T>((r) => (resolve = r));\n return { p, resolve };\n}\n\n/**\n * Storybook Plugin for Cappa\n * Fetches stories from a running Storybook server and takes screenshots of each story\n */\nexport const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (\n options\n) => {\n return {\n name: \"StorybookPlugin\",\n description:\n \"Takes screenshots of Storybook stories with configurable options\",\n version: \"1.0.0\",\n execute: async (screenshotTool: ScreenshotTool) => {\n if (!options) {\n throw new Error(\"Storybook plugin options are required\");\n }\n if (!options.storybookUrl) {\n throw new Error(\"storybookUrl is required\");\n }\n\n const {\n storybookUrl,\n includeStories = [],\n excludeStories = [],\n defaultViewport = { width: 1920, height: 1080 },\n waitForSelector,\n waitForTimeout,\n } = options;\n\n const storiesUrl = `${storybookUrl}/index.json`;\n console.log(`Fetching stories from: ${storiesUrl}`);\n\n try {\n // Fetch stories from Storybook\n const response = await fetch(storiesUrl);\n if (!response.ok) {\n throw new Error(\n `Failed to fetch stories: ${response.status} ${response.statusText}`\n );\n }\n\n const data: StorybookStoriesResponse = await response.json();\n const stories = Object.values(data.entries);\n\n // Filter stories based on include/exclude patterns\n let filteredStories = stories;\n\n if (includeStories.length > 0) {\n filteredStories = filteredStories.filter((story) =>\n includeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n if (excludeStories.length > 0) {\n filteredStories = filteredStories.filter(\n (story) =>\n !excludeStories.some(\n (pattern) =>\n story.title.includes(pattern) || story.name.includes(pattern)\n )\n );\n }\n\n // Filter docs etc\n filteredStories = filteredStories.filter(\n (story) => story.type === \"story\"\n );\n\n console.log(`Found ${filteredStories.length} stories to screenshot`);\n\n const results: Array<{\n storyId: string;\n storyName: string;\n storyTitle: string;\n success: boolean;\n filepath?: string;\n error?: string;\n }> = [];\n\n await screenshotTool.newPage();\n\n // Take screenshots of each story\n for (const story of filteredStories) {\n try {\n const storyUrl = `${storybookUrl}/iframe.html?id=${story.id}&viewMode=story`;\n\n // Merge with default options\n const screenshotOptions = {\n viewport: defaultViewport,\n waitForSelector: waitForSelector,\n waitForTimeout: waitForTimeout,\n fullPage: true,\n quality: 90,\n type: \"jpeg\" as const,\n };\n\n // Take screenshot with story-specific filename\n const filename = `${story.title.replace(\n /[^a-zA-Z0-9]/g,\n \"_\"\n )}_${story.name.replace(/[^a-zA-Z0-9]/g, \"_\")}.${\n screenshotOptions.type\n }`;\n\n const page = await screenshotTool.getPage();\n\n if (!page) {\n throw new Error(\"Page not found\");\n }\n\n page.on(\"console\", (message) => {\n console.log(\"console\", message.text());\n });\n page.on(\"pageerror\", (error) => {\n console.log(\"pageerror\", error);\n });\n\n const latch = createLatch<ScreenshotOptions>();\n\n await page.exposeFunction(\n \"__cappa_parameters\",\n async (payload: ScreenshotOptions) => {\n latch.resolve(payload);\n }\n );\n\n await page.goto(storyUrl);\n\n const options = await latch.p;\n\n if (options.skip) {\n console.log(`Skipping story ${story.title} - ${story.name}`);\n continue;\n }\n\n await freezeUI(page);\n await waitForVisualIdle(page);\n\n if (options.delay) {\n await page.waitForTimeout(options.delay);\n }\n\n // Actually take the screenshot\n const actualFilepath = await screenshotTool.takeScreenshot(\n page,\n filename,\n {\n fullPage: options.fullPage ?? screenshotOptions.fullPage,\n type: options.type ?? screenshotOptions.type,\n waitForSelector:\n options.waitForSelector ?? screenshotOptions.waitForSelector,\n waitForTimeout:\n options.waitForTimeout ?? screenshotOptions.waitForTimeout,\n }\n );\n\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: true,\n filepath: actualFilepath,\n });\n } catch (error) {\n console.error(\n `Error taking screenshot of story ${story.title} - ${story.name}:`,\n (error as Error).message\n );\n results.push({\n storyId: story.id,\n storyName: story.name,\n storyTitle: story.title,\n success: false,\n error: (error as Error).message,\n });\n }\n }\n\n console.log(\n `Completed screenshots: ${results.filter((r) => r.success).length}/${\n results.length\n } successful`\n );\n return results;\n } catch (error) {\n console.error(\"Error in Storybook plugin:\", (error as Error).message);\n throw error;\n }\n },\n };\n};\n","/**\n * Wait for a function to be exposed on the window object\n * @param name - The name of the function to wait for\n * @param timeoutMs - The timeout in milliseconds\n * @returns The function or rejects if the function is not exposed within the timeout\n */\nexport const waitForExposed = (name: string, timeoutMs = 5000) => {\n return new Promise<Function>((resolve, reject) => {\n const start = performance.now();\n\n const t = setInterval(() => {\n const fn = (window as any)[name];\n if (typeof fn === \"function\") {\n clearInterval(t);\n resolve(fn);\n } else if (performance.now() - start > timeoutMs) {\n clearInterval(t);\n reject(new Error(`Timed out waiting for ${name}`));\n }\n }, 16);\n });\n};\n","import { makeDecorator } from \"storybook/preview-api\";\nimport { waitForExposed } from \"./util\";\n\nexport const withCappaDecorator = makeDecorator({\n name: \"withCappa\",\n parameterName: \"cappa\",\n skipIfNoParametersOrOptions: false,\n wrapper: (getStory, context, { parameters }) => {\n queueMicrotask(async () => {\n try {\n const cappaParameters = await waitForExposed(\"__cappa_parameters\");\n\n cappaParameters(parameters ?? {});\n } catch (error) {\n console.error(error);\n }\n });\n\n return getStory(context);\n },\n});\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cappa/plugin-storybook",
3
- "version": "0.0.5",
3
+ "version": "0.0.7",
4
4
  "description": "Storybook plugin for Cappa - takes screenshots of Storybook stories",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -24,7 +24,7 @@
24
24
  "license": "MIT",
25
25
  "dependencies": {
26
26
  "storybook": "^9.1.4",
27
- "@cappa/core": "0.0.5"
27
+ "@cappa/core": "0.0.7"
28
28
  },
29
29
  "devDependencies": {
30
30
  "tsdown": "0.14.1",
@@ -116,6 +116,8 @@ export const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (
116
116
  error?: string;
117
117
  }> = [];
118
118
 
119
+ await screenshotTool.newPage();
120
+
119
121
  // Take screenshots of each story
120
122
  for (const story of filteredStories) {
121
123
  try {
@@ -139,7 +141,11 @@ export const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (
139
141
  screenshotOptions.type
140
142
  }`;
141
143
 
142
- const page = await screenshotTool.newPage();
144
+ const page = await screenshotTool.getPage();
145
+
146
+ if (!page) {
147
+ throw new Error("Page not found");
148
+ }
143
149
 
144
150
  page.on("console", (message) => {
145
151
  console.log("console", message.text());
@@ -161,6 +167,11 @@ export const cappaPluginStorybook: Plugin<StorybookPluginOptions> = (
161
167
 
162
168
  const options = await latch.p;
163
169
 
170
+ if (options.skip) {
171
+ console.log(`Skipping story ${story.title} - ${story.name}`);
172
+ continue;
173
+ }
174
+
164
175
  await freezeUI(page);
165
176
  await waitForVisualIdle(page);
166
177