storybook-addon-playwright 5.4.0 → 5.5.0

package/README.md

@@ -88,7 +88,7 @@ Every option is documented with a JSDoc comment explaining its purpose, paramete
 
 ### AI prompt helper for `getScreenshotTitle`
 
-This package exports `createScreenshotTitlePrompt(data, options)` so you can build a strict LLM prompt for title generation and reuse it across projects.
+The AI helper is exported from `storybook-addon-playwright/ai` as `createScreenshotTitlePrompt(data, options)` so you can build a strict LLM prompt for title generation and reuse it across projects.
 
 The helper is designed for small models too. It asks the model to:
 
@@ -101,7 +101,7 @@ Example:
 
 ```js
 const { setConfig } = require('storybook-addon-playwright/configs');
-const { createScreenshotTitlePrompt } = require('storybook-addon-playwright');
+const { createScreenshotTitlePrompt } = require('storybook-addon-playwright/ai');
 
 async function askLlm(prompt) {
   // Call your LLM provider here and return parsed JSON.

package/ai.d.ts

@@ -0,0 +1 @@
+export * from './dist/ai/index';

package/ai.js

@@ -0,0 +1 @@
+module.exports = require('./dist/ai/index');

package/dist/ai/index.d.mts

@@ -0,0 +1,45 @@
+import { G as GenerateScreenshotTitleInput } from '../story-DSpVrFjG.mjs';
+import 'playwright';
+import 'zod';
+
+interface CreateScreenshotTitlePromptOptions {
+    /**
+     * Maximum number of characters allowed in the returned title.
+     *
+     * @default 80
+     */
+    maxTitleLength?: number;
+    /**
+     * Fallback title the model should use when input is too sparse.
+     *
+     * @default 'Should render correctly.'
+     */
+    fallbackTitle?: string;
+    /**
+     * Whether the generated title should include the browser type when useful.
+     *
+     * @default true
+     */
+    includeBrowserType?: boolean;
+    /**
+     * Whether the generated title can include the story id.
+     *
+     * @default false
+     */
+    includeStoryId?: boolean;
+    /**
+     * Additional instructions for the output format, appended to the prompt's output contract section.
+     *
+     * @default 'Return only the generated title as string, without any additional text or formatting.'
+     */
+    outputPrompt?: string | string[];
+}
+/**
+ * Creates a strict prompt for LLMs to generate a screenshot title from Storybook data.
+ *
+ * The prompt enforces JSON-only output in the form:
+ * `{"title":"..."}`.
+ */
+declare function createScreenshotTitlePrompt(data: GenerateScreenshotTitleInput, options?: CreateScreenshotTitlePromptOptions): string;
+
+export { type CreateScreenshotTitlePromptOptions, createScreenshotTitlePrompt };

package/dist/ai/index.d.ts

@@ -0,0 +1,45 @@
+import { G as GenerateScreenshotTitleInput } from '../story-DSpVrFjG.js';
+import 'playwright';
+import 'zod';
+
+interface CreateScreenshotTitlePromptOptions {
+    /**
+     * Maximum number of characters allowed in the returned title.
+     *
+     * @default 80
+     */
+    maxTitleLength?: number;
+    /**
+     * Fallback title the model should use when input is too sparse.
+     *
+     * @default 'Should render correctly.'
+     */
+    fallbackTitle?: string;
+    /**
+     * Whether the generated title should include the browser type when useful.
+     *
+     * @default true
+     */
+    includeBrowserType?: boolean;
+    /**
+     * Whether the generated title can include the story id.
+     *
+     * @default false
+     */
+    includeStoryId?: boolean;
+    /**
+     * Additional instructions for the output format, appended to the prompt's output contract section.
+     *
+     * @default 'Return only the generated title as string, without any additional text or formatting.'
+     */
+    outputPrompt?: string | string[];
+}
+/**
+ * Creates a strict prompt for LLMs to generate a screenshot title from Storybook data.
+ *
+ * The prompt enforces JSON-only output in the form:
+ * `{"title":"..."}`.
+ */
+declare function createScreenshotTitlePrompt(data: GenerateScreenshotTitleInput, options?: CreateScreenshotTitlePromptOptions): string;
+
+export { type CreateScreenshotTitlePromptOptions, createScreenshotTitlePrompt };

package/dist/ai/index.js

@@ -0,0 +1,3 @@
+'use strict';var o={fallbackTitle:"Should render correctly.",includeBrowserType:true,includeStoryId:false,maxTitleLength:80,outputPrompt:"Return only the generated title as string, without any additional text or formatting."},i=2,s=10;function a(e={}){let n=Number.isFinite(e.maxTitleLength)?Math.max(s,Math.floor(e.maxTitleLength)):o.maxTitleLength,t=(Array.isArray(e.outputPrompt)?e.outputPrompt:typeof e.outputPrompt=="string"?[e.outputPrompt]:[o.outputPrompt]).map(r=>r.trim()).map(r=>"- "+r);return {fallbackTitle:typeof e.fallbackTitle=="string"&&e.fallbackTitle.trim()?e.fallbackTitle.trim():o.fallbackTitle,includeBrowserType:e.includeBrowserType??o.includeBrowserType,includeStoryId:e.includeStoryId??o.includeStoryId,maxTitleLength:n,outputPrompt:t}}function l(e,n){let t=a(n),r=JSON.stringify(e,null,i);return ["You are a screenshot title generator for Storybook Playwright.","Your goal is to read the input JSON and produce one clear screenshot title.","","Follow this process internally before writing the final answer:","1) Parse INPUT_JSON as JSON.","2) Review every top-level and nested field and understand what each field says about the screenshot context.","3) Decide the most important details for naming this screenshot.","4) Build a short, human-friendly title.","","Field guide:","- story.name: story display name.","- story.title: Storybook group/title path.","- story.changedArgs: args changed from defaults; high-priority signal for title.","- story.initialArgs: default args for the story; use for context only.","- story.argTypes: arg metadata; use only when it clarifies changedArgs.","- story.parameters: Storybook-level metadata; only use if it impacts screenshot meaning.","- story.filePath: source story file path.","- story.id: unique Storybook story id.","- browser.type: browser engine (chromium, firefox, webkit).","- browser.options: browser/device options such as viewport and device profile.","- screenshotOptions: screenshot behavior options that may change output meaning.","","Title rules:",`- Maximum length: ${t.maxTitleLength} characters.`,`- ${t.includeBrowserType?"Include browser type only when it adds useful context.":"Do not include browser type in the title."}`,`- ${t.includeStoryId?"You may include story.id when needed for uniqueness.":"Do not include story.id unless no other unique context exists."}`,"- Prefer changedArgs details when present.","- Avoid filler words and generic phrases.","- Title must be plain text (no markdown, no quotes around the full title).","","Output contract (strict):",...t.outputPrompt,`- If context is insufficient, use fallback title: ${JSON.stringify(t.fallbackTitle)}`,"","INPUT_JSON:",r].join(`
+`)}exports.createScreenshotTitlePrompt=l;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/generate-screenshot-title-prompt.ts"],"names":["DEFAULT_OPTIONS","INPUT_JSON_INDENT","MIN_TITLE_LENGTH","normalizeOptions","options","maxTitleLength","outputPrompt","instruction","x","createScreenshotTitlePrompt","data","resolved","inputJson"],"mappings":"aAuCA,IAAMA,EAAgE,CACpE,aAAA,CAAe,2BACf,kBAAA,CAAoB,IAAA,CACpB,eAAgB,KAAA,CAChB,cAAA,CAAgB,GAChB,YAAA,CACE,uFACJ,EAEMC,CAAAA,CAAoB,CAAA,CACpBC,EAAmB,EAAA,CAEzB,SAASC,EACPC,CAAAA,CAA8C,EAAC,CACD,CAC9C,IAAMC,CAAAA,CAAiB,MAAA,CAAO,SAASD,CAAAA,CAAQ,cAAc,EACzD,IAAA,CAAK,GAAA,CAAIF,EAAkB,IAAA,CAAK,KAAA,CAAME,EAAQ,cAAwB,CAAC,EACvEJ,CAAAA,CAAgB,cAAA,CAEdM,GACJ,KAAA,CAAM,OAAA,CAAQF,CAAAA,CAAQ,YAAY,EAC9BA,CAAAA,CAAQ,YAAA,CACR,OAAOA,CAAAA,CAAQ,YAAA,EAAiB,SAC9B,CAACA,CAAAA,CAAQ,YAAY,CAAA,CACrB,CAACJ,EAAgB,YAAY,CAAA,EAElC,IAAKO,CAAAA,EAAiBA,CAAAA,CAAuB,MAAM,CAAA,CACnD,IAAKC,CAAAA,EAAM,IAAA,CAAOA,CAAC,CAAA,CAEtB,OAAO,CACL,aAAA,CACE,OAAOJ,EAAQ,aAAA,EAAkB,QAAA,EAAYA,EAAQ,aAAA,CAAc,IAAA,GAC/DA,CAAAA,CAAQ,aAAA,CAAc,MAAK,CAC3BJ,CAAAA,CAAgB,cACtB,kBAAA,CAAoBI,CAAAA,CAAQ,kBAAA,EAAsBJ,CAAAA,CAAgB,mBAClE,cAAA,CAAgBI,CAAAA,CAAQ,gBAAkBJ,CAAAA,CAAgB,cAAA,CAC1D,eAAAK,CAAAA,CACA,YAAA,CAAcC,CAChB,CACF,CAQO,SAASG,CAAAA,CACdC,CAAAA,CACAN,EACQ,CACR,IAAMO,EAAWR,CAAAA,CAAiBC,CAAO,CAAA,CACnCQ,CAAAA,CAAY,KAAK,SAAA,CAAUF,CAAAA,CAAM,KAAMT,CAAiB,CAAA,CAE9D,OAAO,CACL,gEAAA,CACA,8EACA,EAAA,CACA,iEAAA,CACA,+BACA,8GAAA,CACA,kEAAA,CACA,0CACA,EAAA,CACA,cAAA,CACA,oCACA,4CAAA,CACA,kFAAA,CACA,wEAAA,CACA,yEAAA,CACA,2FACA,2CAAA,CACA,wCAAA,CACA,8DACA,gFAAA,CACA,kFAAA,CACA,GACA,cAAA,CACA,CAAA,kBAAA,EAAqBU,EAAS,cAAc,CAAA,YAAA,CAAA,CAC5C,KAAKA,CAAAA,CAAS,kBAAA,CAAqB,yDAA2D,2CAA2C,CAAA,CAAA,CACzI,KAAKA,CAAAA,CAAS,cAAA,CAAiB,uDAAyD,gEAAgE,CAAA,CAAA,CACxJ,6CACA,2CAAA,CACA,4EAAA,CACA,GACA,2BAAA,CACA,GAAGA,EAAS,YAAA,CACZ,CAAA,kDAAA,EAAqD,KAAK,SAAA,CAAUA,CAAAA,CAAS,aAAa,CAAC,CAAA,CAAA,CAC3F,GACA,aAAA,CACAC,CACF,EAAE,IAAA,CAAK;AAAA,CAAI,CACb","file":"index.js","sourcesContent":["import type { GenerateScreenshotTitleInput } from '../schema';\n\nexport interface CreateScreenshotTitlePromptOptions {\n  /**\n   * Maximum number of characters allowed in the returned title.\n   *\n   * @default 80\n   */\n  maxTitleLength?: number;\n\n  /**\n   * Fallback title the model should use when input is too sparse.\n   *\n   * @default 'Should render correctly.'\n   */\n  fallbackTitle?: string;\n\n  /**\n   * Whether the generated title should include the browser type when useful.\n   *\n   * @default true\n   */\n  includeBrowserType?: boolean;\n\n  /**\n   * Whether the generated title can include the story id.\n   *\n   * @default false\n   */\n  includeStoryId?: boolean;\n\n  /**\n   * Additional instructions for the output format, appended to the prompt's output contract section.\n   *\n   * @default 'Return only the generated title as string, without any additional text or formatting.'\n   */\n  outputPrompt?: string | string[];\n}\n\nconst DEFAULT_OPTIONS: Required<CreateScreenshotTitlePromptOptions> = {\n  fallbackTitle: 'Should render correctly.',\n  includeBrowserType: true,\n  includeStoryId: false,\n  maxTitleLength: 80,\n  outputPrompt:\n    'Return only the generated title as string, without any additional text or formatting.',\n};\n\nconst INPUT_JSON_INDENT = 2;\nconst MIN_TITLE_LENGTH = 10;\n\nfunction normalizeOptions(\n  options: CreateScreenshotTitlePromptOptions = {},\n): Required<CreateScreenshotTitlePromptOptions> {\n  const maxTitleLength = Number.isFinite(options.maxTitleLength)\n    ? Math.max(MIN_TITLE_LENGTH, Math.floor(options.maxTitleLength as number))\n    : DEFAULT_OPTIONS.maxTitleLength;\n\n  const outputPrompt = (\n    Array.isArray(options.outputPrompt)\n      ? options.outputPrompt\n      : typeof options.outputPrompt === 'string'\n        ? [options.outputPrompt]\n        : [DEFAULT_OPTIONS.outputPrompt]\n  )\n    .map((instruction) => (instruction as string).trim())\n    .map((x) => '- ' + x);\n\n  return {\n    fallbackTitle:\n      typeof options.fallbackTitle === 'string' && options.fallbackTitle.trim()\n        ? options.fallbackTitle.trim()\n        : DEFAULT_OPTIONS.fallbackTitle,\n    includeBrowserType: options.includeBrowserType ?? DEFAULT_OPTIONS.includeBrowserType,\n    includeStoryId: options.includeStoryId ?? DEFAULT_OPTIONS.includeStoryId,\n    maxTitleLength,\n    outputPrompt: outputPrompt,\n  };\n}\n\n/**\n * Creates a strict prompt for LLMs to generate a screenshot title from Storybook data.\n *\n * The prompt enforces JSON-only output in the form:\n * `{\"title\":\"...\"}`.\n */\nexport function createScreenshotTitlePrompt(\n  data: GenerateScreenshotTitleInput,\n  options?: CreateScreenshotTitlePromptOptions,\n): string {\n  const resolved = normalizeOptions(options);\n  const inputJson = JSON.stringify(data, null, INPUT_JSON_INDENT);\n\n  return [\n    'You are a screenshot title generator for Storybook Playwright.',\n    'Your goal is to read the input JSON and produce one clear screenshot title.',\n    '',\n    'Follow this process internally before writing the final answer:',\n    '1) Parse INPUT_JSON as JSON.',\n    '2) Review every top-level and nested field and understand what each field says about the screenshot context.',\n    '3) Decide the most important details for naming this screenshot.',\n    '4) Build a short, human-friendly title.',\n    '',\n    'Field guide:',\n    '- story.name: story display name.',\n    '- story.title: Storybook group/title path.',\n    '- story.changedArgs: args changed from defaults; high-priority signal for title.',\n    '- story.initialArgs: default args for the story; use for context only.',\n    '- story.argTypes: arg metadata; use only when it clarifies changedArgs.',\n    '- story.parameters: Storybook-level metadata; only use if it impacts screenshot meaning.',\n    '- story.filePath: source story file path.',\n    '- story.id: unique Storybook story id.',\n    '- browser.type: browser engine (chromium, firefox, webkit).',\n    '- browser.options: browser/device options such as viewport and device profile.',\n    '- screenshotOptions: screenshot behavior options that may change output meaning.',\n    '',\n    'Title rules:',\n    `- Maximum length: ${resolved.maxTitleLength} characters.`,\n    `- ${resolved.includeBrowserType ? 'Include browser type only when it adds useful context.' : 'Do not include browser type in the title.'}`,\n    `- ${resolved.includeStoryId ? 'You may include story.id when needed for uniqueness.' : 'Do not include story.id unless no other unique context exists.'}`,\n    '- Prefer changedArgs details when present.',\n    '- Avoid filler words and generic phrases.',\n    '- Title must be plain text (no markdown, no quotes around the full title).',\n    '',\n    'Output contract (strict):',\n    ...resolved.outputPrompt,\n    `- If context is insufficient, use fallback title: ${JSON.stringify(resolved.fallbackTitle)}`,\n    '',\n    'INPUT_JSON:',\n    inputJson,\n  ].join('\\n');\n}\n"]}

package/dist/ai/index.mjs

@@ -0,0 +1,3 @@
+var o={fallbackTitle:"Should render correctly.",includeBrowserType:true,includeStoryId:false,maxTitleLength:80,outputPrompt:"Return only the generated title as string, without any additional text or formatting."},i=2,s=10;function a(e={}){let n=Number.isFinite(e.maxTitleLength)?Math.max(s,Math.floor(e.maxTitleLength)):o.maxTitleLength,t=(Array.isArray(e.outputPrompt)?e.outputPrompt:typeof e.outputPrompt=="string"?[e.outputPrompt]:[o.outputPrompt]).map(r=>r.trim()).map(r=>"- "+r);return {fallbackTitle:typeof e.fallbackTitle=="string"&&e.fallbackTitle.trim()?e.fallbackTitle.trim():o.fallbackTitle,includeBrowserType:e.includeBrowserType??o.includeBrowserType,includeStoryId:e.includeStoryId??o.includeStoryId,maxTitleLength:n,outputPrompt:t}}function l(e,n){let t=a(n),r=JSON.stringify(e,null,i);return ["You are a screenshot title generator for Storybook Playwright.","Your goal is to read the input JSON and produce one clear screenshot title.","","Follow this process internally before writing the final answer:","1) Parse INPUT_JSON as JSON.","2) Review every top-level and nested field and understand what each field says about the screenshot context.","3) Decide the most important details for naming this screenshot.","4) Build a short, human-friendly title.","","Field guide:","- story.name: story display name.","- story.title: Storybook group/title path.","- story.changedArgs: args changed from defaults; high-priority signal for title.","- story.initialArgs: default args for the story; use for context only.","- story.argTypes: arg metadata; use only when it clarifies changedArgs.","- story.parameters: Storybook-level metadata; only use if it impacts screenshot meaning.","- story.filePath: source story file path.","- story.id: unique Storybook story id.","- browser.type: browser engine (chromium, firefox, webkit).","- browser.options: browser/device options such as viewport and device profile.","- screenshotOptions: screenshot behavior options that may change output meaning.","","Title rules:",`- Maximum length: ${t.maxTitleLength} characters.`,`- ${t.includeBrowserType?"Include browser type only when it adds useful context.":"Do not include browser type in the title."}`,`- ${t.includeStoryId?"You may include story.id when needed for uniqueness.":"Do not include story.id unless no other unique context exists."}`,"- Prefer changedArgs details when present.","- Avoid filler words and generic phrases.","- Title must be plain text (no markdown, no quotes around the full title).","","Output contract (strict):",...t.outputPrompt,`- If context is insufficient, use fallback title: ${JSON.stringify(t.fallbackTitle)}`,"","INPUT_JSON:",r].join(`
+`)}export{l as createScreenshotTitlePrompt};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/ai/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/generate-screenshot-title-prompt.ts"],"names":["DEFAULT_OPTIONS","INPUT_JSON_INDENT","MIN_TITLE_LENGTH","normalizeOptions","options","maxTitleLength","outputPrompt","instruction","x","createScreenshotTitlePrompt","data","resolved","inputJson"],"mappings":"AAuCA,IAAMA,EAAgE,CACpE,aAAA,CAAe,2BACf,kBAAA,CAAoB,IAAA,CACpB,eAAgB,KAAA,CAChB,cAAA,CAAgB,GAChB,YAAA,CACE,uFACJ,EAEMC,CAAAA,CAAoB,CAAA,CACpBC,EAAmB,EAAA,CAEzB,SAASC,EACPC,CAAAA,CAA8C,EAAC,CACD,CAC9C,IAAMC,CAAAA,CAAiB,MAAA,CAAO,SAASD,CAAAA,CAAQ,cAAc,EACzD,IAAA,CAAK,GAAA,CAAIF,EAAkB,IAAA,CAAK,KAAA,CAAME,EAAQ,cAAwB,CAAC,EACvEJ,CAAAA,CAAgB,cAAA,CAEdM,GACJ,KAAA,CAAM,OAAA,CAAQF,CAAAA,CAAQ,YAAY,EAC9BA,CAAAA,CAAQ,YAAA,CACR,OAAOA,CAAAA,CAAQ,YAAA,EAAiB,SAC9B,CAACA,CAAAA,CAAQ,YAAY,CAAA,CACrB,CAACJ,EAAgB,YAAY,CAAA,EAElC,IAAKO,CAAAA,EAAiBA,CAAAA,CAAuB,MAAM,CAAA,CACnD,IAAKC,CAAAA,EAAM,IAAA,CAAOA,CAAC,CAAA,CAEtB,OAAO,CACL,aAAA,CACE,OAAOJ,EAAQ,aAAA,EAAkB,QAAA,EAAYA,EAAQ,aAAA,CAAc,IAAA,GAC/DA,CAAAA,CAAQ,aAAA,CAAc,MAAK,CAC3BJ,CAAAA,CAAgB,cACtB,kBAAA,CAAoBI,CAAAA,CAAQ,kBAAA,EAAsBJ,CAAAA,CAAgB,mBAClE,cAAA,CAAgBI,CAAAA,CAAQ,gBAAkBJ,CAAAA,CAAgB,cAAA,CAC1D,eAAAK,CAAAA,CACA,YAAA,CAAcC,CAChB,CACF,CAQO,SAASG,CAAAA,CACdC,CAAAA,CACAN,EACQ,CACR,IAAMO,EAAWR,CAAAA,CAAiBC,CAAO,CAAA,CACnCQ,CAAAA,CAAY,KAAK,SAAA,CAAUF,CAAAA,CAAM,KAAMT,CAAiB,CAAA,CAE9D,OAAO,CACL,gEAAA,CACA,8EACA,EAAA,CACA,iEAAA,CACA,+BACA,8GAAA,CACA,kEAAA,CACA,0CACA,EAAA,CACA,cAAA,CACA,oCACA,4CAAA,CACA,kFAAA,CACA,wEAAA,CACA,yEAAA,CACA,2FACA,2CAAA,CACA,wCAAA,CACA,8DACA,gFAAA,CACA,kFAAA,CACA,GACA,cAAA,CACA,CAAA,kBAAA,EAAqBU,EAAS,cAAc,CAAA,YAAA,CAAA,CAC5C,KAAKA,CAAAA,CAAS,kBAAA,CAAqB,yDAA2D,2CAA2C,CAAA,CAAA,CACzI,KAAKA,CAAAA,CAAS,cAAA,CAAiB,uDAAyD,gEAAgE,CAAA,CAAA,CACxJ,6CACA,2CAAA,CACA,4EAAA,CACA,GACA,2BAAA,CACA,GAAGA,EAAS,YAAA,CACZ,CAAA,kDAAA,EAAqD,KAAK,SAAA,CAAUA,CAAAA,CAAS,aAAa,CAAC,CAAA,CAAA,CAC3F,GACA,aAAA,CACAC,CACF,EAAE,IAAA,CAAK;AAAA,CAAI,CACb","file":"index.mjs","sourcesContent":["import type { GenerateScreenshotTitleInput } from '../schema';\n\nexport interface CreateScreenshotTitlePromptOptions {\n  /**\n   * Maximum number of characters allowed in the returned title.\n   *\n   * @default 80\n   */\n  maxTitleLength?: number;\n\n  /**\n   * Fallback title the model should use when input is too sparse.\n   *\n   * @default 'Should render correctly.'\n   */\n  fallbackTitle?: string;\n\n  /**\n   * Whether the generated title should include the browser type when useful.\n   *\n   * @default true\n   */\n  includeBrowserType?: boolean;\n\n  /**\n   * Whether the generated title can include the story id.\n   *\n   * @default false\n   */\n  includeStoryId?: boolean;\n\n  /**\n   * Additional instructions for the output format, appended to the prompt's output contract section.\n   *\n   * @default 'Return only the generated title as string, without any additional text or formatting.'\n   */\n  outputPrompt?: string | string[];\n}\n\nconst DEFAULT_OPTIONS: Required<CreateScreenshotTitlePromptOptions> = {\n  fallbackTitle: 'Should render correctly.',\n  includeBrowserType: true,\n  includeStoryId: false,\n  maxTitleLength: 80,\n  outputPrompt:\n    'Return only the generated title as string, without any additional text or formatting.',\n};\n\nconst INPUT_JSON_INDENT = 2;\nconst MIN_TITLE_LENGTH = 10;\n\nfunction normalizeOptions(\n  options: CreateScreenshotTitlePromptOptions = {},\n): Required<CreateScreenshotTitlePromptOptions> {\n  const maxTitleLength = Number.isFinite(options.maxTitleLength)\n    ? Math.max(MIN_TITLE_LENGTH, Math.floor(options.maxTitleLength as number))\n    : DEFAULT_OPTIONS.maxTitleLength;\n\n  const outputPrompt = (\n    Array.isArray(options.outputPrompt)\n      ? options.outputPrompt\n      : typeof options.outputPrompt === 'string'\n        ? [options.outputPrompt]\n        : [DEFAULT_OPTIONS.outputPrompt]\n  )\n    .map((instruction) => (instruction as string).trim())\n    .map((x) => '- ' + x);\n\n  return {\n    fallbackTitle:\n      typeof options.fallbackTitle === 'string' && options.fallbackTitle.trim()\n        ? options.fallbackTitle.trim()\n        : DEFAULT_OPTIONS.fallbackTitle,\n    includeBrowserType: options.includeBrowserType ?? DEFAULT_OPTIONS.includeBrowserType,\n    includeStoryId: options.includeStoryId ?? DEFAULT_OPTIONS.includeStoryId,\n    maxTitleLength,\n    outputPrompt: outputPrompt,\n  };\n}\n\n/**\n * Creates a strict prompt for LLMs to generate a screenshot title from Storybook data.\n *\n * The prompt enforces JSON-only output in the form:\n * `{\"title\":\"...\"}`.\n */\nexport function createScreenshotTitlePrompt(\n  data: GenerateScreenshotTitleInput,\n  options?: CreateScreenshotTitlePromptOptions,\n): string {\n  const resolved = normalizeOptions(options);\n  const inputJson = JSON.stringify(data, null, INPUT_JSON_INDENT);\n\n  return [\n    'You are a screenshot title generator for Storybook Playwright.',\n    'Your goal is to read the input JSON and produce one clear screenshot title.',\n    '',\n    'Follow this process internally before writing the final answer:',\n    '1) Parse INPUT_JSON as JSON.',\n    '2) Review every top-level and nested field and understand what each field says about the screenshot context.',\n    '3) Decide the most important details for naming this screenshot.',\n    '4) Build a short, human-friendly title.',\n    '',\n    'Field guide:',\n    '- story.name: story display name.',\n    '- story.title: Storybook group/title path.',\n    '- story.changedArgs: args changed from defaults; high-priority signal for title.',\n    '- story.initialArgs: default args for the story; use for context only.',\n    '- story.argTypes: arg metadata; use only when it clarifies changedArgs.',\n    '- story.parameters: Storybook-level metadata; only use if it impacts screenshot meaning.',\n    '- story.filePath: source story file path.',\n    '- story.id: unique Storybook story id.',\n    '- browser.type: browser engine (chromium, firefox, webkit).',\n    '- browser.options: browser/device options such as viewport and device profile.',\n    '- screenshotOptions: screenshot behavior options that may change output meaning.',\n    '',\n    'Title rules:',\n    `- Maximum length: ${resolved.maxTitleLength} characters.`,\n    `- ${resolved.includeBrowserType ? 'Include browser type only when it adds useful context.' : 'Do not include browser type in the title.'}`,\n    `- ${resolved.includeStoryId ? 'You may include story.id when needed for uniqueness.' : 'Do not include story.id unless no other unique context exists.'}`,\n    '- Prefer changedArgs details when present.',\n    '- Avoid filler words and generic phrases.',\n    '- Title must be plain text (no markdown, no quotes around the full title).',\n    '',\n    'Output contract (strict):',\n    ...resolved.outputPrompt,\n    `- If context is insufficient, use fallback title: ${JSON.stringify(resolved.fallbackTitle)}`,\n    '',\n    'INPUT_JSON:',\n    inputJson,\n  ].join('\\n');\n}\n"]}

package/dist/api/server/routes.d.mts

@@ -2,12 +2,13 @@ import { appRouter } from '../../trpc/router.mjs';
 import '@material-ui/core';
 import 'playwright';
 import 'ts-to-json';
-import '../../request-B60Gnj7P.mjs';
+import '../../story-DSpVrFjG.mjs';
 import 'zod';
 import '@trpc/server';
 import 'node:http';
 import 'jest-image-snapshot';
-import '../../image-diff-DeB-XSUP.mjs';
+import '../../image-diff-BDN_FVyD.mjs';
+import '../../request-CGNOwtQo.mjs';
 import '../../get-screenshot-paths-BhXNedbs.mjs';
 
 

package/dist/api/server/routes.d.ts

@@ -2,12 +2,13 @@ import { appRouter } from '../../trpc/router.js';
 import '@material-ui/core';
 import 'playwright';
 import 'ts-to-json';
-import '../../request-B60Gnj7P.js';
+import '../../story-DSpVrFjG.js';
 import 'zod';
 import '@trpc/server';
 import 'node:http';
 import 'jest-image-snapshot';
-import '../../image-diff-DwK_Ui8E.js';
+import '../../image-diff-BKKtLPxv.js';
+import '../../request-DVZ6cFCg.js';
 import '../../get-screenshot-paths-BhXNedbs.js';
 
 

package/dist/get-screenshots.d.mts

@@ -1,5 +1,6 @@
 import { S as ScreenshotPathInfo } from './get-screenshot-paths-BhXNedbs.mjs';
-import { R as RequestData } from './request-B60Gnj7P.mjs';
+import { R as RequestData } from './request-CGNOwtQo.mjs';
+import './story-DSpVrFjG.mjs';
 import 'playwright';
 import 'zod';
 

package/dist/get-screenshots.d.ts

@@ -1,5 +1,6 @@
 import { S as ScreenshotPathInfo } from './get-screenshot-paths-BhXNedbs.js';
-import { R as RequestData } from './request-B60Gnj7P.js';
+import { R as RequestData } from './request-DVZ6cFCg.js';
+import './story-DSpVrFjG.js';
 import 'playwright';
 import 'zod';
 

package/dist/{image-diff-DwK_Ui8E.d.ts → image-diff-BDN_FVyD.d.mts}

@@ -1,4 +1,4 @@
-import { I as ImageDiffResultOutput } from './request-B60Gnj7P.js';
+import { I as ImageDiffResultOutput } from './story-DSpVrFjG.mjs';
 
 type DiffDirection = 'horizontal' | 'vertical';
 type ImageDiffResult = ImageDiffResultOutput;

package/dist/{image-diff-DeB-XSUP.d.mts → image-diff-BKKtLPxv.d.ts}

@@ -1,4 +1,4 @@
-import { I as ImageDiffResultOutput } from './request-B60Gnj7P.mjs';
+import { I as ImageDiffResultOutput } from './story-DSpVrFjG.js';
 
 type DiffDirection = 'horizontal' | 'vertical';
 type ImageDiffResult = ImageDiffResultOutput;

package/dist/index.d.mts

@@ -1,45 +1,10 @@
-import { G as GenerateScreenshotTitleInput } from './request-B60Gnj7P.mjs';
 export { getScreenshots } from './get-screenshots.mjs';
 export { runImageDiff } from './run-image-diff.mjs';
 export { toMatchScreenshots } from './to-match-screenshots.mjs';
+import './get-screenshot-paths-BhXNedbs.mjs';
+import './request-CGNOwtQo.mjs';
+import './story-DSpVrFjG.mjs';
 import 'playwright';
 import 'zod';
-import './get-screenshot-paths-BhXNedbs.mjs';
-import './image-diff-DeB-XSUP.mjs';
+import './image-diff-BDN_FVyD.mjs';
 import 'jest-image-snapshot';
-
-interface CreateScreenshotTitlePromptOptions {
-    /**
-     * Maximum number of characters allowed in the returned title.
-     *
-     * @default 80
-     */
-    maxTitleLength?: number;
-    /**
-     * Fallback title the model should use when input is too sparse.
-     *
-     * @default 'Should render correctly.'
-     */
-    fallbackTitle?: string;
-    /**
-     * Whether the generated title should include the browser type when useful.
-     *
-     * @default true
-     */
-    includeBrowserType?: boolean;
-    /**
-     * Whether the generated title can include the story id.
-     *
-     * @default false
-     */
-    includeStoryId?: boolean;
-}
-/**
- * Creates a strict prompt for LLMs to generate a screenshot title from Storybook data.
- *
- * The prompt enforces JSON-only output in the form:
- * `{"title":"..."}`.
- */
-declare function createScreenshotTitlePrompt(data: GenerateScreenshotTitleInput, options?: CreateScreenshotTitlePromptOptions): string;
-
-export { type CreateScreenshotTitlePromptOptions, createScreenshotTitlePrompt };

package/dist/index.d.ts

@@ -1,45 +1,10 @@
-import { G as GenerateScreenshotTitleInput } from './request-B60Gnj7P.js';
 export { getScreenshots } from './get-screenshots.js';
 export { runImageDiff } from './run-image-diff.js';
 export { toMatchScreenshots } from './to-match-screenshots.js';
+import './get-screenshot-paths-BhXNedbs.js';
+import './request-DVZ6cFCg.js';
+import './story-DSpVrFjG.js';
 import 'playwright';
 import 'zod';
-import './get-screenshot-paths-BhXNedbs.js';
-import './image-diff-DwK_Ui8E.js';
+import './image-diff-BKKtLPxv.js';
 import 'jest-image-snapshot';
-
-interface CreateScreenshotTitlePromptOptions {
-    /**
-     * Maximum number of characters allowed in the returned title.
-     *
-     * @default 80
-     */
-    maxTitleLength?: number;
-    /**
-     * Fallback title the model should use when input is too sparse.
-     *
-     * @default 'Should render correctly.'
-     */
-    fallbackTitle?: string;
-    /**
-     * Whether the generated title should include the browser type when useful.
-     *
-     * @default true
-     */
-    includeBrowserType?: boolean;
-    /**
-     * Whether the generated title can include the story id.
-     *
-     * @default false
-     */
-    includeStoryId?: boolean;
-}
-/**
- * Creates a strict prompt for LLMs to generate a screenshot title from Storybook data.
- *
- * The prompt enforces JSON-only output in the form:
- * `{"title":"..."}`.
- */
-declare function createScreenshotTitlePrompt(data: GenerateScreenshotTitleInput, options?: CreateScreenshotTitlePromptOptions): string;
-
-export { type CreateScreenshotTitlePromptOptions, createScreenshotTitlePrompt };