better-design 0.31.1 → 0.33.0

package/dist/index.js

@@ -1232,6 +1232,7 @@ var init_tool_names = __esm({
       "get-design-config",
       "get-design-system-kit",
       "get-design-system-status",
+      "get-inspiration",
       "get-jig-guide",
       "get-motion-guide",
       "get-react-native-guide",
@@ -1269,6 +1270,7 @@ var init_tool_names = __esm({
       "get-design-config",
       "get-design-system-kit",
       "get-design-system-status",
+      "get-inspiration",
       "get-jig-guide",
       "get-motion-guide",
       "get-react-native-guide",
@@ -1374,6 +1376,7 @@ Better Design provides design systems, design principles and UI review checks fo
 
 - find-design-system searches the catalog. preview-design-system shows one system. get-design-system-kit returns its install command or CSS kit.
 - create-design-system generates a custom system. get-design-system-status reports its progress.
+- get-inspiration returns real App Store screenshot sets from shipped apps as images.
 - get-ui-principle, get-ux-principle and the platform guides return design principles and best practices on a topic.
 - get-review-rules, check-comprehension, inspect-spacing and review-dashboard-structure check finished interfaces.
 - find-icon-library, find-icons and install-icons return icon component files.`;
@@ -1396,7 +1399,8 @@ Better Design provides design systems, design principles and UI review checks fo
       "install-icons": "Fetches the named icons from the public Iconify API and returns one React component file per icon, plus an index.ts barrel, as text for the caller to save. It writes no files. Takes a `libraryId` and icon names from find-icons.",
       "detect-icon-library": "Reads the contents of the `.library.json` file that an earlier icon install left in a project and returns the icon library the project uses and the icons it has installed, or reports that none is recorded.",
       "find-design-system": "Searches Better Design's catalog of design systems by industry, personality or a description of the interface, and returns ranked matches with a preview link for each. Use it when the user wants a design system or a visual direction for an app, site, page, dashboard or presentation.",
-      "get-design-system-kit": "Returns the build kit for a catalog design system or a generated project. `target` picks the format: `react` returns one shadcn install command for every component and the tokens, `html` returns framework-free token and component CSS for inline canvases, `react-native` and `swiftui` return mobile kits, `shopify` returns Liquid theme files, and `dtcg` returns a W3C Design Tokens document. `component` narrows the React install to one component.",
+      "get-design-system-kit": "Returns the build kit for a catalog design system or a generated project. `target` picks the format: `react` returns one shadcn install command for every component and the tokens, `html` returns framework-free token and component CSS for inline canvases, `react-native` and `swiftui` return mobile kits, `shopify` returns Liquid theme files, `dtcg` returns a W3C Design Tokens document, and `store-screenshots` returns slide files and a render script for App Store and Google Play screenshots. `component` narrows the React install to one component.",
+      "get-inspiration": 'Returns real reference designs from Better Design\'s library as images. `type` picks the collection: today `app-store-screenshots`, the App Store screenshot sets of shipped apps, each with its title and category. `category`, such as "Productivity", narrows the sets, and `limit` sets how many come back, 1 to 6.',
       "create-design-system": "Starts generating a custom design system from a description of the product and its look, and returns the project id and project URL at once. Generation runs in the background and typically takes 1 to 3 minutes. get-design-system-status reports progress and returns the install command when it finishes. `baseDesignSystemId` starts from a catalog system, and `brandCss` builds from an existing brand token sheet, such as the output of extract-design-system. Each call uses one credit from the user's Better Design account. Anyone with the registry or preview URL can view the generated source and previews.",
       "get-design-system-status": "Reports the progress of a design system started with create-design-system. While generation runs it returns the current stage. When generation finishes it returns the live preview URL and the `npx shadcn add` install command.",
       "preview-design-system": "Returns a visual preview of a catalog design system: its palette, typography, buttons, card, input and badge, with a link to the full live showcase. Takes an id from find-design-system.",
@@ -1891,6 +1895,7 @@ function buildKitOutputSchema(enableShopifyKit = true) {
     componentExampleHtml: z5.string().min(1).optional().describe("HTML target only. Starter markup that demonstrates the required .ds wrapper and ds-* component classes."),
     tokensJson: z5.string().min(1).optional().describe("DTCG target only. The design tokens as a W3C Design Tokens (DTCG) document. Write it to tokens.json; every token tool reads this format, including Style Dictionary, Tokens Studio, Terrazzo, and the Figma plugins that create variables."),
     nativeFiles: z5.array(z5.object({ path: z5.string().min(1), content: z5.string().min(1) })).optional().describe("React Native and SwiftUI targets only. Write each file verbatim at its path: this system's stored theme and material, and the primitives that read it."),
+    screenshotFiles: z5.array(z5.object({ path: z5.string().min(1), content: z5.string().min(1) })).optional().describe("Store screenshots target only. Write each file verbatim at its path, then follow buildInstructions to capture screens, write the slides and render the PNG files."),
     unsupportedTokens: z5.array(z5.object({
       name: z5.string().min(1),
       value: z5.string().min(1),
@@ -10867,6 +10872,184 @@ ${FAQ_CARD_ITEM}
   }
 });
 
+// ../shared/src/mcp/store-screenshots.ts
+function renderScript() {
+  const sizes = JSON.stringify(STORE_SCREENSHOT_SIZES);
+  const feature = JSON.stringify(PLAY_FEATURE_GRAPHIC);
+  return `// Renders store screenshots from slides.json at the exact store sizes. [Better Design]
+// Run once per change: node store-screenshots/render.mjs
+import { chromium } from "playwright";
+import { mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const SIZES = ${sizes};
+const FEATURE = ${feature};
+const RANGE = ${JSON.stringify(STORE_SLIDE_RANGE)};
+const deck = JSON.parse(readFileSync(join(here, "slides.json"), "utf8"));
+
+if (deck.slides.length < RANGE.min || deck.slides.length > RANGE.max) {
+  throw new Error(\`slides.json holds \${deck.slides.length} slides. Use \${RANGE.min} to \${RANGE.max}: Google Play shows at most \${RANGE.max}.\`);
+}
+
+// App Store Connect rejects a PNG with an alpha channel, so check the header, not the look.
+function check(file, size) {
+  const png = readFileSync(file);
+  const width = png.readUInt32BE(16), height = png.readUInt32BE(20), colorType = png[25];
+  if (width !== size.width || height !== size.height) throw new Error(\`\${file} is \${width} x \${height}, not \${size.width} x \${size.height}.\`);
+  if (colorType !== 2) throw new Error(\`\${file} has a transparency layer. Give every slide an opaque background.\`);
+}
+
+async function shoot(browser, size, data, file) {
+  const page = await browser.newPage({ viewport: { width: size.width, height: size.height }, deviceScaleFactor: 1 });
+  await page.addInitScript((slide) => { window.__SLIDE__ = slide; }, data);
+  await page.goto(pathToFileURL(join(here, "slide.html")).href);
+  await page.evaluate(async () => {
+    await document.fonts.ready;
+    await Promise.all([...document.images].map((img) => img.decode().catch(() => { throw new Error("Missing capture: " + img.src); })));
+  });
+  await page.screenshot({ path: file, type: "png" });
+  await page.close();
+  check(file, size);
+}
+
+const browser = await chromium.launch();
+try {
+  for (const size of SIZES) {
+    mkdirSync(join(here, "out", size.id), { recursive: true });
+    for (const [i, slide] of deck.slides.entries()) {
+      const file = join(here, "out", size.id, String(i + 1).padStart(2, "0") + ".png");
+      await shoot(browser, size, { kind: "slide", app: deck.app, slide, frame: size.frame }, file);
+      console.log("wrote", file);
+    }
+  }
+  mkdirSync(join(here, "out", FEATURE.id), { recursive: true });
+  const feature = join(here, "out", FEATURE.id, "feature-graphic.png");
+  await shoot(browser, FEATURE, { kind: "feature", app: deck.app, slide: deck.featureGraphic, frame: "none" }, feature);
+  console.log("wrote", feature);
+} finally {
+  await browser.close();
+}
+`;
+}
+function buildStoreScreenshotFiles(tokensCss) {
+  return [
+    { path: "store-screenshots/theme.css", content: tokensCss },
+    { path: "store-screenshots/slides.json", content: `${JSON.stringify(EXAMPLE_SLIDES, null, 2)}
+` },
+    { path: "store-screenshots/slide.html", content: SLIDE_HTML },
+    { path: "store-screenshots/render.mjs", content: renderScript() }
+  ];
+}
+function fencedFile(file) {
+  const longest = Math.max(0, ...[...file.content.matchAll(/`+/g)].map((run) => run[0].length));
+  const fence3 = "`".repeat(Math.max(3, longest + 1));
+  return `## ${file.path}
+
+${fence3}
+${file.content.replace(/\n$/, "")}
+${fence3}`;
+}
+function storeScreenshotText(name, files) {
+  return [storeScreenshotInstructions(name), ...files.map(fencedFile)].join("\n\n");
+}
+function storeScreenshotInstructions(name) {
+  const sizes = [...STORE_SCREENSHOT_SIZES, PLAY_FEATURE_GRAPHIC].map((size) => `- ${size.label}: ${size.width} x ${size.height}, in \`store-screenshots/out/${size.id}/\``).join("\n");
+  return [
+    `# Store screenshots in ${name}`,
+    "",
+    "1. Write each file in `screenshotFiles` verbatim at its path.",
+    `2. Capture ${STORE_SLIDE_RANGE.min} to ${STORE_SLIDE_RANGE.max} app screens into \`store-screenshots/captures/\`. iOS Simulator: \`xcrun simctl io booted screenshot store-screenshots/captures/01.png\`. Android emulator: \`adb exec-out screencap -p > store-screenshots/captures/01.png\`.`,
+    '3. Edit `slides.json`: one outcome per slide, a headline a person understands in one second, and no claims such as "Best", "#1" or "Free", which Google Play rejects. Check every headline with Better Design\'s `check-comprehension` tool before you render.',
+    "4. Install Playwright once as a dev dependency with the project's package manager, then its browser: `npx playwright install chromium`.",
+    "5. Google Play asks the feature graphic to avoid pure white, black and dark gray. When this system's primary color is one of those, set `--feature-background` and `--feature-foreground` to a brand color pair at the end of `theme.css`.",
+    "6. Run `node store-screenshots/render.mjs`. It stops on any file with the wrong size or a transparency layer.",
+    "",
+    "It writes:",
+    sizes,
+    "",
+    "Google Play screenshots carry no drawn phone, because Google asks for no device imagery. Show the user every PNG before they upload it."
+  ].join("\n");
+}
+var STORE_SCREENSHOT_SIZES, PLAY_FEATURE_GRAPHIC, STORE_SLIDE_RANGE, EXAMPLE_SLIDES, SLIDE_HTML;
+var init_store_screenshots = __esm({
+  "../shared/src/mcp/store-screenshots.ts"() {
+    "use strict";
+    STORE_SCREENSHOT_SIZES = [
+      { id: "iphone-6-9", label: "iPhone 6.9 inch", width: 1320, height: 2868, frame: "phone" },
+      { id: "play-phone", label: "Google Play phone", width: 1080, height: 1920, frame: "none" }
+    ];
+    PLAY_FEATURE_GRAPHIC = {
+      id: "play-feature-graphic",
+      label: "Google Play feature graphic",
+      width: 1024,
+      height: 500,
+      frame: "none"
+    };
+    STORE_SLIDE_RANGE = { min: 3, max: 8 };
+    EXAMPLE_SLIDES = {
+      app: "Your app",
+      slides: [
+        { headline: "Say the first outcome in five words", subhead: "", capture: "captures/01.png" },
+        { headline: "Show the second outcome next", subhead: "", capture: "captures/02.png" },
+        { headline: "End on the reason to stay", subhead: "", capture: "captures/03.png" }
+      ],
+      featureGraphic: { headline: "Your app, in one line" }
+    };
+    SLIDE_HTML = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="stylesheet" href="theme.css">
+<style>
+  html, body { margin: 0; width: 100vw; height: 100vh; overflow: hidden; }
+  body { background: var(--background); color: var(--foreground); font-family: var(--font-sans, system-ui, sans-serif);
+    display: flex; flex-direction: column; align-items: center; box-sizing: border-box; padding: 7vh 8vw 0; gap: 3vh; }
+  h1 { margin: 0; font-size: 7.5vw; line-height: 1.12; font-weight: 700; text-align: center; text-wrap: balance; letter-spacing: -0.02em; }
+  p { margin: 0; font-size: 4vw; line-height: 1.35; text-align: center; color: var(--muted-foreground); text-wrap: balance; }
+  .shot { flex: 1; min-height: 0; width: 100%; display: flex; justify-content: center; align-items: flex-start; }
+  .shot img { display: block; height: 100%; max-width: 100%; object-fit: cover; object-position: top; }
+  .phone { height: 104%; aspect-ratio: 9 / 19.5; box-sizing: border-box; padding: 1.6vw; border-radius: 11vw 11vw 0 0;
+    background: var(--foreground); overflow: hidden; }
+  .phone img { width: 100%; height: 100%; border-radius: 9.4vw 9.4vw 0 0; }
+  .bare img { border-radius: calc(var(--radius, 0.75rem) * 3) calc(var(--radius, 0.75rem) * 3) 0 0; }
+  body.feature { background: var(--feature-background, var(--primary)); color: var(--feature-foreground, var(--primary-foreground)); justify-content: center; align-items: flex-start; padding: 0 10vw; gap: 4vh; }
+  body.feature h1 { font-size: 7vw; text-align: left; }
+  body.feature .app { font-size: 3.4vw; font-weight: 600; opacity: 0.85; }
+</style>
+</head>
+<body>
+<script>
+  // The render script sets window.__SLIDE__ before this page loads.
+  const { kind, app, slide, frame } = window.__SLIDE__;
+  const add = (tag, className, text) => {
+    const el = document.createElement(tag);
+    if (className) el.className = className;
+    if (text) el.textContent = text;
+    return document.body.appendChild(el);
+  };
+  if (kind === "feature") {
+    document.body.classList.add("feature");
+    add("div", "app", app);
+    add("h1", "", slide.headline);
+  } else {
+    add("h1", "", slide.headline);
+    if (slide.subhead) add("p", "", slide.subhead);
+    const shot = add("div", "shot " + (frame === "phone" ? "" : "bare"));
+    const holder = frame === "phone" ? shot.appendChild(document.createElement("div")) : shot;
+    if (frame === "phone") holder.className = "phone";
+    const img = holder.appendChild(document.createElement("img"));
+    img.src = slide.capture;
+    img.alt = "";
+  }
+</script>
+</body>
+</html>
+`;
+  }
+});
+
 // ../shared/src/registry-css.ts
 function parseCssVars(css) {
   const out = { theme: {}, light: {}, dark: {} };
@@ -13892,36 +14075,38 @@ ${fence3}` }],
       )
     }, icons);
   });
+  const loadTokenSource = async ({ designSystemId, projectId }) => {
+    if (projectId) {
+      const result = await fetchProjectTokensCss(projectId, apiFetch, authContext);
+      return {
+        tokensCss: result?.tokensCss,
+        name: result?.name ?? `Project ${projectId.slice(0, 8)}`,
+        viewUrl: `${APP_BASE_URL}/projects/${projectId}`,
+        icons: result?.iconLibrary
+      };
+    }
+    if (!designSystemId) return null;
+    const ds = await provider.getDesignSystemById(designSystemId, { includeComponents: false, includeHtml: false });
+    return {
+      tokensCss: await fetchCatalogTokensCss(designSystemId),
+      name: ds?.metadata.title ?? designSystemId,
+      viewUrl: `${APP_BASE_URL}/design-systems/${designSystemId}`,
+      icons: ds ? await catalogKitIcons(ds.metadata, provider) : void 0
+    };
+  };
   const getDtcgKit = async ({
     designSystemId,
     projectId,
     context
   }) => tracked("get-design-system-kit", { target: "dtcg", designSystemId, projectId, context }, async () => {
-    let tokensCss;
-    let name;
-    let viewUrl;
-    let icons;
-    if (projectId) {
-      viewUrl = `${APP_BASE_URL}/projects/${projectId}`;
-      const result = await fetchProjectTokensCss(projectId, apiFetch, authContext);
-      tokensCss = result?.tokensCss;
-      icons = result?.iconLibrary;
-      name = result?.name ?? `Project ${projectId.slice(0, 8)}`;
-    } else if (designSystemId) {
-      viewUrl = `${APP_BASE_URL}/design-systems/${designSystemId}`;
-      const ds = await provider.getDesignSystemById(designSystemId, {
-        includeComponents: false,
-        includeHtml: false
-      });
-      tokensCss = await fetchCatalogTokensCss(designSystemId);
-      name = ds?.metadata.title ?? designSystemId;
-      icons = ds ? await catalogKitIcons(ds.metadata, provider) : void 0;
-    } else {
+    const source = await loadTokenSource({ designSystemId, projectId });
+    if (!source) {
       return {
         content: [{ type: "text", text: "For target dtcg, pass either a catalog designSystemId (from find-design-system) or a projectId (from create-design-system)." }],
         structuredContent: { status: "error", name: "Missing design system", tokensCss: "" }
       };
     }
+    const { tokensCss, name, viewUrl, icons } = source;
     if (!tokensCss) {
       return {
         content: [{ type: "text", text: `Could not load tokens for "${projectId ?? designSystemId}". A generated project may still be building. Check ${viewUrl}.` }],
@@ -13947,6 +14132,33 @@ ${fence3}` }],
       structuredContent: { status: "completed", name, viewUrl, tokensCss, tokensJson }
     }, icons);
   });
+  const getStoreScreenshots = async ({
+    designSystemId,
+    projectId,
+    context
+  }) => tracked("get-design-system-kit", { target: "store-screenshots", designSystemId, projectId, context }, async () => {
+    const source = await loadTokenSource({ designSystemId, projectId });
+    if (!source?.tokensCss) {
+      const reason = source ? `Could not load tokens for "${projectId ?? designSystemId}". A generated project may still be building. Check ${source.viewUrl}.` : "For target store-screenshots, pass either a catalog designSystemId (from find-design-system) or a projectId (from create-design-system).";
+      return {
+        content: [{ type: "text", text: reason }],
+        structuredContent: { status: "error", name: source?.name ?? "Missing design system", tokensCss: "" }
+      };
+    }
+    const files = buildStoreScreenshotFiles(source.tokensCss);
+    const instructions = storeScreenshotInstructions(source.name);
+    return {
+      content: [{ type: "text", text: storeScreenshotText(source.name, files) }],
+      structuredContent: {
+        status: "completed",
+        name: source.name,
+        viewUrl: source.viewUrl,
+        tokensCss: source.tokensCss,
+        buildInstructions: instructions,
+        screenshotFiles: files
+      }
+    };
+  });
   const fetchProjectMobilePrimitives = async (projectId) => {
     try {
       const res = await apiFetch(`${APP_BASE_URL}/api/projects/${projectId}/mobile/all.json`, { headers: authHeaders(authContext) });
@@ -14162,9 +14374,10 @@ ${BUILD_TARGET_RULE}`,
             "html",
             ...enableShopifyKit ? ["shopify"] : [],
             "dtcg",
+            "store-screenshots",
             ...enableMobileKits ? ["react-native", "swiftui"] : []
           ]
-        ).describe(`Required build target. Use "react" for any host with filesystem + terminal; use "html" only for inline chat canvases/artifacts.${enableShopifyKit ? ' Use "shopify" for Shopify stores and themes.' : ""} Use "dtcg" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. ${enableMobileKits ? ` Use "react-native" for a React Native or Expo app and "swiftui" for an iOS app: each returns this system's stored mobile kit, its own material on native primitives, plus the handoff to the matching guide.` : ""}`),
+        ).describe(`Required build target. Use "react" for any host with filesystem + terminal; use "html" only for inline chat canvases/artifacts.${enableShopifyKit ? ' Use "shopify" for Shopify stores and themes.' : ""} Use "dtcg" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. Use "store-screenshots" for App Store and Google Play screenshots in this system: it returns slide files and a render script that writes PNG files at the store sizes. ${enableMobileKits ? ` Use "react-native" for a React Native or Expo app and "swiftui" for an iOS app: each returns this system's stored mobile kit, its own material on native primitives, plus the handoff to the matching guide.` : ""}`),
         designSystemId: z14.string().min(1).optional().describe(`Catalog design system ID from find-design-system. Required for target react; for every other target pass this or projectId.`),
         projectId: z14.string().min(1).optional().describe(`Generated project ID from create-design-system / get-design-system-status. Supported with every target but react.`),
         component: z14.union([z14.string(), z14.array(z14.string())]).optional().describe("React target only. Pass only when the user asks to inspect specific component source code. Omit to scaffold the entire design system."),
@@ -14180,7 +14393,7 @@ ${BUILD_TARGET_RULE}`,
       // interactive preview path. [BD-240]
     },
     async ({ target, designSystemId, projectId, component, library, context }) => {
-      if (target !== "react" && target !== "html" && target !== "shopify" && target !== "dtcg" && target !== "react-native" && target !== "swiftui") {
+      if (target !== "react" && target !== "html" && target !== "shopify" && target !== "dtcg" && target !== "store-screenshots" && target !== "react-native" && target !== "swiftui") {
         return {
           content: [{ type: "text", text: `Unknown target "${target}".` }],
           structuredContent: { status: "error", name: "Unknown target", tokensCss: "" }
@@ -14192,6 +14405,9 @@ ${BUILD_TARGET_RULE}`,
       if (target === "dtcg") {
         return withRedesignContract(await getDtcgKit({ designSystemId, projectId, context }));
       }
+      if (target === "store-screenshots") {
+        return getStoreScreenshots({ designSystemId, projectId, context });
+      }
       if (target === "react-native" || target === "swiftui") {
         if (!enableMobileKits) {
           return {
@@ -14687,6 +14903,7 @@ var init_design_system_tools = __esm({
     init_shopify_kit();
     init_redesign_contract();
     init_selected_icon_handoff();
+    init_store_screenshots();
     init_shopify_primitives();
     init_preview_html();
     init_shared();
@@ -22772,7 +22989,7 @@ function columnToSchema(column, factory) {
   }
   return schema;
 }
-function numberColumnToSchema(column, z35, coerce) {
+function numberColumnToSchema(column, z37, coerce) {
   let unsigned = column.getSQLType().includes("unsigned");
   let min;
   let max;
@@ -22840,20 +23057,20 @@ function numberColumnToSchema(column, z35, coerce) {
     min = Number.MIN_SAFE_INTEGER;
     max = Number.MAX_SAFE_INTEGER;
   }
-  let schema = coerce === true || coerce?.number ? z35.coerce.number() : z35.number();
+  let schema = coerce === true || coerce?.number ? z37.coerce.number() : z37.number();
   schema = schema.min(min).max(max);
   return integer2 ? schema.int() : schema;
 }
-function bigintColumnToSchema(column, z35, coerce) {
+function bigintColumnToSchema(column, z37, coerce) {
   const unsigned = column.getSQLType().includes("unsigned");
   const min = unsigned ? 0n : CONSTANTS.INT64_MIN;
   const max = unsigned ? CONSTANTS.INT64_UNSIGNED_MAX : CONSTANTS.INT64_MAX;
-  const schema = coerce === true || coerce?.bigint ? z35.coerce.bigint() : z35.bigint();
+  const schema = coerce === true || coerce?.bigint ? z37.coerce.bigint() : z37.bigint();
   return schema.min(min).max(max);
 }
-function stringColumnToSchema(column, z35, coerce) {
+function stringColumnToSchema(column, z37, coerce) {
   if (isColumnType(column, ["PgUUID"])) {
-    return z35.string().uuid();
+    return z37.string().uuid();
   }
   let max;
   let regex;
@@ -22885,7 +23102,7 @@ function stringColumnToSchema(column, z35, coerce) {
     regex = /^[01]+$/;
     max = column.dimensions;
   }
-  let schema = coerce === true || coerce?.string ? z35.coerce.string() : z35.string();
+  let schema = coerce === true || coerce?.string ? z37.coerce.string() : z37.string();
   schema = regex ? schema.regex(regex) : schema;
   return max && fixed ? schema.length(max) : max ? schema.max(max) : schema;
 }
@@ -22983,7 +23200,7 @@ var init_drizzle_zod = __esm({
 
 // ../shared/src/schema.ts
 import { z as z16 } from "zod";
-var vector2, messageRoleEnum, messageTypeEnum, designSystemStatusEnum, onboardingPathValues, onboardingPathSchema, onboardingPathSqlValues, mcpIssueCategoryValues, mcpIssueStatusValues, mcpIssueImprovementStatusValues, mcpIssueImprovementVerdictValues, mcpIssueImprovementStatusSchema, mcpIssueImprovementVerdictSchema, mcpIssueImprovementStatusSqlValues, mcpIssueImprovementVerdictSqlValues, designConfigSchema, projectMemoryDataSchema, projects, messages, projectMemory, fragments, usage, scrapeBlock, resourceAccess, user, signupAlertDeliveries, billingAlertDeliveries, TEAM_RULES_MAX_BYTES, teamRules, billingSubscription, githubInstallationClaim, githubInstallation, featureAccess, session, account, verification, jwks, oauthClient, oauthRefreshToken, oauthAccessToken, oauthConsent, designSystems, designSystemComponents, foundationalDocs, apiKeys, emailCampaignSends, emailCampaignSteps, projectEvents, iconLibraries, dsSearchQueries, mcpToolCalls, mcpClientConnections, evalVerdicts, generationInputs, mcpIssues, mcpIssueImprovements, projectsRelations, projectMemoryRelations, mcpIssuesRelations, mcpIssueImprovementsRelations, messagesRelations, fragmentsRelations, designSystemsRelations, designSystemComponentsRelations, insertProjectSchema, selectProjectSchema, insertMessageSchema, selectMessageSchema, insertFragmentSchema, selectFragmentSchema, insertProjectMemorySchema, selectProjectMemorySchema, insertDesignSystemSchema, selectDesignSystemSchema, insertDesignSystemComponentSchema, selectDesignSystemComponentSchema, insertFoundationalDocSchema, selectFoundationalDocSchema, insertIconLibrarySchema, selectIconLibrarySchema, insertApiKeySchema, selectApiKeySchema, insertUserSchema, selectUserSchema, insertSignupAlertDeliverySchema, selectSignupAlertDeliverySchema, insertEmailCampaignSendSchema, selectEmailCampaignSendSchema, insertEmailCampaignStepSchema, selectEmailCampaignStepSchema, insertMcpIssueImprovementSchema, selectMcpIssueImprovementSchema, pluginAuthNonces;
+var vector2, messageRoleEnum, messageTypeEnum, designSystemStatusEnum, onboardingPathValues, onboardingPathSchema, onboardingPathSqlValues, mcpIssueCategoryValues, mcpIssueStatusValues, mcpIssueImprovementStatusValues, mcpIssueImprovementVerdictValues, mcpIssueImprovementStatusSchema, mcpIssueImprovementVerdictSchema, mcpIssueImprovementStatusSqlValues, mcpIssueImprovementVerdictSqlValues, designConfigSchema, projectMemoryDataSchema, projects, messages, projectMemory, fragments, usage, scrapeBlock, resourceAccess, user, signupAlertDeliveries, billingAlertDeliveries, billingEmailDeliveries, TEAM_RULES_MAX_BYTES, teamRules, billingSubscription, githubInstallationClaim, githubInstallation, featureAccess, session, account, verification, jwks, oauthClient, oauthRefreshToken, oauthAccessToken, oauthConsent, designSystems, designSystemComponents, foundationalDocs, apiKeys, emailCampaignSends, emailCampaignSteps, projectEvents, iconLibraries, dsSearchQueries, mcpToolCalls, mcpClientConnections, evalVerdicts, generationInputs, mcpIssues, mcpIssueImprovements, projectsRelations, projectMemoryRelations, mcpIssuesRelations, mcpIssueImprovementsRelations, messagesRelations, fragmentsRelations, designSystemsRelations, designSystemComponentsRelations, insertProjectSchema, selectProjectSchema, insertMessageSchema, selectMessageSchema, insertFragmentSchema, selectFragmentSchema, insertProjectMemorySchema, selectProjectMemorySchema, insertDesignSystemSchema, selectDesignSystemSchema, insertDesignSystemComponentSchema, selectDesignSystemComponentSchema, insertFoundationalDocSchema, selectFoundationalDocSchema, insertIconLibrarySchema, selectIconLibrarySchema, insertApiKeySchema, selectApiKeySchema, insertUserSchema, selectUserSchema, insertSignupAlertDeliverySchema, selectSignupAlertDeliverySchema, insertEmailCampaignSendSchema, selectEmailCampaignSendSchema, insertEmailCampaignStepSchema, selectEmailCampaignStepSchema, insertMcpIssueImprovementSchema, selectMcpIssueImprovementSchema, pluginAuthNonces;
 var init_schema2 = __esm({
   "../shared/src/schema.ts"() {
     "use strict";
@@ -23314,6 +23531,40 @@ var init_schema2 = __esm({
         )
       ]
     );
+    billingEmailDeliveries = pgTable(
+      "billing_email_deliveries",
+      {
+        id: text("id").primaryKey(),
+        userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+        toEmail: text("to_email").notNull(),
+        /** The Stripe subscription the email is about, so the daily cap can count per subscription. */
+        stripeSubscriptionId: text("stripe_subscription_id").notNull(),
+        email: jsonb("email").$type().notNull(),
+        occurredAt: timestamp("occurred_at", { withTimezone: true }).notNull(),
+        status: text("status").$type().default("pending").notNull(),
+        attemptCount: integer("attempt_count").default(0).notNull(),
+        nextAttemptAt: timestamp("next_attempt_at", { withTimezone: true }).defaultNow().notNull(),
+        leaseUntil: timestamp("lease_until", { withTimezone: true }),
+        leaseToken: uuid("lease_token"),
+        deliveredAt: timestamp("delivered_at", { withTimezone: true }),
+        resendEmailId: text("resend_email_id"),
+        lastError: text("last_error"),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (t) => [
+        index("billing_email_deliveries_due_idx").on(t.status, t.nextAttemptAt, t.leaseUntil),
+        index("billing_email_deliveries_subscription_idx").on(t.stripeSubscriptionId, t.createdAt),
+        check(
+          "billing_email_deliveries_status_valid",
+          sql`${t.status} in ('pending', 'processing', 'delivered', 'failed')`
+        ),
+        check(
+          "billing_email_deliveries_processing_lease_valid",
+          sql`${t.status} <> 'processing' or (${t.leaseUntil} is not null and ${t.leaseToken} is not null)`
+        )
+      ]
+    );
     TEAM_RULES_MAX_BYTES = 32 * 1024;
     teamRules = pgTable(
       "team_rules",
@@ -28887,8 +29138,131 @@ var init_feature_map_tools = __esm({
   }
 });
 
+// ../shared/src/mcp/inspiration.ts
+import { z as z28 } from "zod";
+function describeSet(set) {
+  const heading = `## ${set.title}${set.category ? ` (${set.category})` : ""}`;
+  if (!set.notes) return heading;
+  const written = /* @__PURE__ */ new Date(`${set.notes.writtenAt}T00:00:00Z`);
+  const date2 = Number.isNaN(written.getTime()) ? set.notes.writtenAt : NOTE_DATE.format(written);
+  return [
+    heading,
+    `Headlines: ${set.notes.headline}`,
+    `Slide order: ${set.notes.order}`,
+    `Framing: ${set.notes.framing}`,
+    `Color: ${set.notes.color}`,
+    `Better Design's notes, written by a vision model from these screenshots on ${date2}. The listing may have changed since.`
+  ].join("\n");
+}
+var INSPIRATION_TYPES, MAX_INSPIRATION_LIMIT, noteSchema, inspirationNotesFileSchema, indexFileSchema, indexEntrySchema, inspirationIndexSchema, NOTE_DATE;
+var init_inspiration = __esm({
+  "../shared/src/mcp/inspiration.ts"() {
+    "use strict";
+    INSPIRATION_TYPES = ["app-store-screenshots"];
+    MAX_INSPIRATION_LIMIT = 6;
+    noteSchema = z28.object({
+      slug: z28.string(),
+      /** The day the note was written, as YYYY-MM-DD. A listing can change after it. */
+      writtenAt: z28.string(),
+      headline: z28.string(),
+      order: z28.string(),
+      framing: z28.string(),
+      color: z28.string()
+    });
+    inspirationNotesFileSchema = z28.object({
+      model: z28.string(),
+      notes: z28.array(noteSchema)
+    });
+    indexFileSchema = z28.object({
+      key: z28.string(),
+      type: z28.string(),
+      width: z28.number(),
+      height: z28.number()
+    });
+    indexEntrySchema = z28.object({
+      title: z28.string(),
+      slug: z28.string(),
+      category: z28.string().nullish(),
+      files: z28.array(indexFileSchema)
+    });
+    inspirationIndexSchema = z28.object({
+      entries: z28.array(indexEntrySchema)
+    });
+    NOTE_DATE = new Intl.DateTimeFormat("en-GB", { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" });
+  }
+});
+
+// ../shared/src/mcp/tools/inspiration-tools.ts
+import { z as z29 } from "zod";
+function describeSets(result) {
+  const lines = result.sets.map((set, i) => {
+    const category = set.category ? `, ${set.category}` : "";
+    return `${i + 1}. ${set.title}${category}: ${set.images.length} screenshot${set.images.length === 1 ? "" : "s"} below`;
+  });
+  return [
+    `# App Store screenshot sets`,
+    "",
+    ...lines,
+    "",
+    "Each image follows the set it belongs to. Read each set for its headline style, slide order, device framing and color, then propose two or three directions for the user's own screenshots and let the user pick one."
+  ].join("\n");
+}
+function noMatch(result, category) {
+  const asked = category ? `No App Store screenshot sets match the category "${category}".` : "The library holds no App Store screenshot sets yet.";
+  return `${asked} Categories in the library: ${result.categories.join(", ")}.`;
+}
+function registerInspirationTools({ server, tracked }, readInspiration2) {
+  server.registerTool(
+    "get-inspiration",
+    {
+      title: "Get Inspiration",
+      description: `Send real reference designs from Better Design's library as images, so you can study how shipped products solved the same design problem before you design the user's own.
+
+Use it before designing App Store or Google Play screenshots: pass \`type: "app-store-screenshots"\`, and a \`category\` such as "Health & Fitness" when the user's app has one. Each set arrives as its title and category, followed by its first screenshots.
+
+Then propose two or three directions drawn from what the sets do (headline style, slide order, device framing, color), and let the user choose before you build anything.`,
+      inputSchema: z29.object({
+        type: z29.enum(INSPIRATION_TYPES).describe('The kind of reference to send. Today: "app-store-screenshots".'),
+        category: z29.string().trim().min(1).max(60).optional().describe('Optional App Store category, for example "Productivity" or "Health & Fitness". Ignores case.'),
+        limit: z29.number().int().min(1).max(MAX_INSPIRATION_LIMIT).optional().describe(`How many sets to send, 1 to ${MAX_INSPIRATION_LIMIT}. Defaults to 3.`),
+        context: CONTEXT_ARG
+      }),
+      annotations: READ_ONLY_TOOL_ANNOTATIONS
+    },
+    async ({ type, category, limit, context }) => tracked("get-inspiration", { type, category: category ?? null, limit: limit ?? null, context }, async () => {
+      if (!readInspiration2) return { content: [{ type: "text", text: NOT_AVAILABLE }] };
+      const result = await readInspiration2({ type, category, limit });
+      if (result.sets.length === 0) {
+        return { content: [{ type: "text", text: noMatch(result, category) }] };
+      }
+      return {
+        content: [
+          { type: "text", text: describeSets(result) },
+          ...result.sets.flatMap((set) => [
+            { type: "text", text: describeSet(set) },
+            ...set.images.map((image) => ({
+              type: "image",
+              data: image.data,
+              mimeType: image.mimeType
+            }))
+          ])
+        ]
+      };
+    })
+  );
+}
+var NOT_AVAILABLE;
+var init_inspiration_tools = __esm({
+  "../shared/src/mcp/tools/inspiration-tools.ts"() {
+    "use strict";
+    init_shared();
+    init_inspiration();
+    NOT_AVAILABLE = "The inspiration library is not available from this server. Try again with the hosted Better Design MCP server or the latest `better-design` npm package.";
+  }
+});
+
 // ../shared/src/mcp/tools.ts
-function registerAllTools(server, provider, onToolUsage, authContext, options = {}, apiFetch = globalThis.fetch, userId, captureDashboardBrowser2) {
+function registerAllTools(server, provider, onToolUsage, authContext, options = {}, apiFetch = globalThis.fetch, userId, captureDashboardBrowser2, readInspiration2) {
   const { track, tracked } = createTracking(server, onToolUsage);
   const deps = {
     server,
@@ -28914,6 +29288,7 @@ function registerAllTools(server, provider, onToolUsage, authContext, options =
   registerInspectionTools(deps);
   registerFeatureMapTools(deps);
   registerTeamRulesTools(deps);
+  registerInspirationTools(deps, readInspiration2);
   registerPreviewResource(deps);
   registerInspectionResource(deps);
 }
@@ -28937,6 +29312,7 @@ var init_tools = __esm({
     init_widget_tools();
     init_feature_map_tools();
     init_team_rules_tools();
+    init_inspiration_tools();
     init_shared();
   }
 });
@@ -28946,7 +29322,7 @@ var MCP_IMPLEMENTATION_VERSION;
 var init_version2 = __esm({
   "../shared/src/mcp/version.ts"() {
     "use strict";
-    MCP_IMPLEMENTATION_VERSION = "0.31.1";
+    MCP_IMPLEMENTATION_VERSION = "0.33.0";
   }
 });
 
@@ -29011,7 +29387,8 @@ function createMcpServer(options) {
     apiFetch = globalThis.fetch,
     userId,
     captureDashboardBrowser: captureDashboardBrowser2,
-    directoryListing = false
+    directoryListing = false,
+    readInspiration: readInspiration2
   } = options;
   const server = new McpServer(
     { name, version: version2 },
@@ -29038,7 +29415,8 @@ function createMcpServer(options) {
     },
     apiFetch,
     userId,
-    captureDashboardBrowser2
+    captureDashboardBrowser2,
+    readInspiration2
   );
   return server;
 }
@@ -29078,6 +29456,7 @@ __export(api_client_exports, {
   getSessionGuidance: () => getSessionGuidance,
   getTeamRules: () => getTeamRules,
   listPrinciples: () => listPrinciples,
+  readInspiration: () => readInspiration,
   searchDesignSystems: () => searchDesignSystems,
   searchIconLibraries: () => searchIconLibraries,
   searchIcons: () => searchIcons,
@@ -29115,6 +29494,12 @@ function captureDashboardBrowser(input) {
     timeoutMs: 9e4
   });
 }
+function readInspiration(input) {
+  const params = new URLSearchParams({ type: input.type });
+  if (input.category) params.set("category", input.category);
+  if (input.limit !== void 0) params.set("limit", String(input.limit));
+  return request(`/v1/inspiration?${params}`, { timeoutMs: 3e4 });
+}
 async function searchDesignSystems(query, limit = 5) {
   return request(
     `/v1/design-systems/search?q=${encodeURIComponent(query)}&limit=${limit}`
@@ -31091,7 +31476,7 @@ var init_engine = __esm({
 });
 
 // ../shared/src/lint/config.ts
-import { z as z28 } from "zod";
+import { z as z30 } from "zod";
 function mergeReviewConfig(override) {
   if (!override) return DEFAULT_REVIEW_CONFIG;
   return {
@@ -31149,47 +31534,47 @@ var init_config = __esm({
         semanticTokens: { enabled: true }
       }
     };
-    reviewFlowStepSchema = z28.discriminatedUnion("action", [
-      z28.object({ action: z28.literal("click"), selector: z28.string() }),
-      z28.object({ action: z28.literal("type"), selector: z28.string(), value: z28.string() }),
-      z28.object({ action: z28.literal("press"), key: z28.string() }),
-      z28.object({ action: z28.literal("wait"), milliseconds: z28.number().finite().nonnegative() })
+    reviewFlowStepSchema = z30.discriminatedUnion("action", [
+      z30.object({ action: z30.literal("click"), selector: z30.string() }),
+      z30.object({ action: z30.literal("type"), selector: z30.string(), value: z30.string() }),
+      z30.object({ action: z30.literal("press"), key: z30.string() }),
+      z30.object({ action: z30.literal("wait"), milliseconds: z30.number().finite().nonnegative() })
     ]);
-    visualReviewConfigSchema = z28.object({
-      enabled: z28.boolean().optional(),
-      model: z28.object({
-        enabled: z28.boolean().optional(),
-        maxScreenshots: z28.number().int().nonnegative().optional()
+    visualReviewConfigSchema = z30.object({
+      enabled: z30.boolean().optional(),
+      model: z30.object({
+        enabled: z30.boolean().optional(),
+        maxScreenshots: z30.number().int().nonnegative().optional()
       }).optional(),
-      routes: z28.array(z28.string()).optional(),
-      viewports: z28.array(z28.enum(["desktop", "mobile", "reflow"])).optional(),
-      flows: z28.array(z28.object({
-        name: z28.string(),
-        persona: z28.string(),
-        path: z28.string().optional(),
-        steps: z28.array(reviewFlowStepSchema)
+      routes: z30.array(z30.string()).optional(),
+      viewports: z30.array(z30.enum(["desktop", "mobile", "reflow"])).optional(),
+      flows: z30.array(z30.object({
+        name: z30.string(),
+        persona: z30.string(),
+        path: z30.string().optional(),
+        steps: z30.array(reviewFlowStepSchema)
       })).optional(),
-      componentGallery: z28.object({
-        enabled: z28.boolean().optional(),
-        componentSelector: z28.string().optional(),
-        canvasSelector: z28.string().optional(),
-        labelSelector: z28.string().optional(),
-        maxComponents: z28.number().int().nonnegative().optional()
+      componentGallery: z30.object({
+        enabled: z30.boolean().optional(),
+        componentSelector: z30.string().optional(),
+        canvasSelector: z30.string().optional(),
+        labelSelector: z30.string().optional(),
+        maxComponents: z30.number().int().nonnegative().optional()
       }).optional()
     });
-    reviewConfigOverrideSchema = z28.object({
-      designSystem: z28.string().optional(),
+    reviewConfigOverrideSchema = z30.object({
+      designSystem: z30.string().optional(),
       visual: visualReviewConfigSchema.optional(),
-      rules: z28.object({
-        elements: z28.record(z28.string(), z28.object({ use: z28.string(), from: z28.string() })).optional(),
-        tokens: z28.record(z28.string(), z28.string()).optional(),
-        wcag: z28.object({
-          enabled: z28.boolean().optional(),
-          severity: z28.enum(["all", "critical+serious"]).optional()
+      rules: z30.object({
+        elements: z30.record(z30.string(), z30.object({ use: z30.string(), from: z30.string() })).optional(),
+        tokens: z30.record(z30.string(), z30.string()).optional(),
+        wcag: z30.object({
+          enabled: z30.boolean().optional(),
+          severity: z30.enum(["all", "critical+serious"]).optional()
         }).optional(),
-        slop: z28.object({ enabled: z28.boolean().optional() }).optional(),
-        copy: z28.object({ enabled: z28.boolean().optional() }).optional(),
-        semanticTokens: z28.object({ enabled: z28.boolean().optional() }).optional()
+        slop: z30.object({ enabled: z30.boolean().optional() }).optional(),
+        copy: z30.object({ enabled: z30.boolean().optional() }).optional(),
+        semanticTokens: z30.object({ enabled: z30.boolean().optional() }).optional()
       }).optional()
     });
   }
@@ -31565,7 +31950,7 @@ __export(review_tool_exports, {
   isReviewableSourcePath: () => isReviewableSourcePath,
   registerReviewTool: () => registerReviewTool
 });
-import { z as z29 } from "zod";
+import { z as z31 } from "zod";
 function isReviewableSourcePath(path6) {
   return /\.(tsx|jsx|ts|js|css)$/i.test(path6);
 }
@@ -31589,11 +31974,11 @@ get-review-rules gives you the judgment rules to apply yourself. This tool is th
 This source reviewer cannot judge rendered hierarchy or semantic color roles. After it passes, inspect the rendered dashboard and confirm title \u2192 metrics \u2192 records \u2192 interpretation, distinct action and status colors, and that a stepper begins only after a task starts.
 
 Fix every critical and serious finding, then call it again on the fixed source. Findings feed the same loop as a human code review: read, fix, re-check.`,
-      inputSchema: z29.object({
-        files: z29.array(
-          z29.object({
-            path: z29.string().trim().min(1).max(400).describe("Repo-relative file path, e.g. components/signup-form.tsx."),
-            content: z29.string().max(MAX_FILE_CHARS).describe("The file's full source.")
+      inputSchema: z31.object({
+        files: z31.array(
+          z31.object({
+            path: z31.string().trim().min(1).max(400).describe("Repo-relative file path, e.g. components/signup-form.tsx."),
+            content: z31.string().max(MAX_FILE_CHARS).describe("The file's full source.")
           })
         ).min(1).max(MAX_FILES).describe("The .tsx, .jsx, .ts, .js, and .css files to review, as written."),
         context: CONTEXT_ARG
@@ -31654,7 +32039,7 @@ review-ui-code({ files: [{ path: "components/signup-form.tsx", content: "..." },
 });
 
 // ../shared/src/mcp/figma-prototype.ts
-import { z as z30 } from "zod";
+import { z as z32 } from "zod";
 function escapeHtml(value) {
   return value.replace(/[&<>"]/g, (char2) => ESCAPES.get(char2) ?? char2);
 }
@@ -31688,63 +32073,63 @@ var colorSchema, paintSchema, sizingSchema, baseSchema, prototypeNodeSchema, pro
 var init_figma_prototype = __esm({
   "../shared/src/mcp/figma-prototype.ts"() {
     "use strict";
-    colorSchema = z30.object({ r: z30.number(), g: z30.number(), b: z30.number(), a: z30.number() });
-    paintSchema = z30.object({ variable: z30.string().optional(), color: colorSchema.optional() });
-    sizingSchema = z30.enum(["FIXED", "HUG", "FILL"]);
-    baseSchema = z30.object({
-      name: z30.string(),
-      width: z30.number(),
-      height: z30.number(),
-      x: z30.number(),
-      y: z30.number(),
-      sizing: z30.object({ horizontal: sizingSchema, vertical: sizingSchema }).optional(),
-      absolute: z30.boolean().optional(),
-      opacity: z30.number().optional()
+    colorSchema = z32.object({ r: z32.number(), g: z32.number(), b: z32.number(), a: z32.number() });
+    paintSchema = z32.object({ variable: z32.string().optional(), color: colorSchema.optional() });
+    sizingSchema = z32.enum(["FIXED", "HUG", "FILL"]);
+    baseSchema = z32.object({
+      name: z32.string(),
+      width: z32.number(),
+      height: z32.number(),
+      x: z32.number(),
+      y: z32.number(),
+      sizing: z32.object({ horizontal: sizingSchema, vertical: sizingSchema }).optional(),
+      absolute: z32.boolean().optional(),
+      opacity: z32.number().optional()
     });
-    prototypeNodeSchema = z30.lazy(() => z30.discriminatedUnion("kind", [
+    prototypeNodeSchema = z32.lazy(() => z32.discriminatedUnion("kind", [
       baseSchema.extend({
-        kind: z30.literal("instance"),
-        auditKey: z30.string(),
-        systemId: z30.string(),
-        texts: z30.array(z30.string()),
-        mainTexts: z30.array(z30.string())
+        kind: z32.literal("instance"),
+        auditKey: z32.string(),
+        systemId: z32.string(),
+        texts: z32.array(z32.string()),
+        mainTexts: z32.array(z32.string())
       }),
       baseSchema.extend({
-        kind: z30.literal("frame"),
-        layout: z30.object({
-          direction: z30.enum(["HORIZONTAL", "VERTICAL"]),
-          gap: z30.number(),
-          padding: z30.tuple([z30.number(), z30.number(), z30.number(), z30.number()]),
-          primary: z30.enum(["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]),
-          counter: z30.enum(["MIN", "CENTER", "MAX", "BASELINE"]),
-          wrap: z30.boolean().optional()
+        kind: z32.literal("frame"),
+        layout: z32.object({
+          direction: z32.enum(["HORIZONTAL", "VERTICAL"]),
+          gap: z32.number(),
+          padding: z32.tuple([z32.number(), z32.number(), z32.number(), z32.number()]),
+          primary: z32.enum(["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]),
+          counter: z32.enum(["MIN", "CENTER", "MAX", "BASELINE"]),
+          wrap: z32.boolean().optional()
         }).optional(),
         fill: paintSchema.optional(),
-        stroke: z30.object({ paint: paintSchema, weight: z30.number() }).optional(),
-        radius: z30.number().optional(),
-        clips: z30.boolean().optional(),
-        children: z30.array(prototypeNodeSchema)
+        stroke: z32.object({ paint: paintSchema, weight: z32.number() }).optional(),
+        radius: z32.number().optional(),
+        clips: z32.boolean().optional(),
+        children: z32.array(prototypeNodeSchema)
       }),
       baseSchema.extend({
-        kind: z30.literal("text"),
-        characters: z30.string(),
-        fontSize: z30.number(),
-        fontWeight: z30.number(),
-        lineHeight: z30.number().optional(),
-        letterSpacing: z30.number().optional(),
-        fontFamily: z30.string().optional(),
-        align: z30.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]),
+        kind: z32.literal("text"),
+        characters: z32.string(),
+        fontSize: z32.number(),
+        fontWeight: z32.number(),
+        lineHeight: z32.number().optional(),
+        letterSpacing: z32.number().optional(),
+        fontFamily: z32.string().optional(),
+        align: z32.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]),
         fill: paintSchema.optional()
       }),
       baseSchema.extend({
-        kind: z30.literal("shape"),
-        svg: z30.string(),
-        reason: z30.string()
+        kind: z32.literal("shape"),
+        svg: z32.string(),
+        reason: z32.string()
       })
     ]));
-    prototypeRequestSchema = z30.object({
-      type: z30.literal("better-design-figma-prototype"),
-      id: z30.string(),
+    prototypeRequestSchema = z32.object({
+      type: z32.literal("better-design-figma-prototype"),
+      id: z32.string(),
       frame: prototypeNodeSchema
     });
     ESCAPES = /* @__PURE__ */ new Map([["&", "&amp;"], ["<", "&lt;"], [">", "&gt;"], ['"', "&quot;"]]);
@@ -31930,7 +32315,7 @@ var init_figma_model_prompt = __esm({
 });
 
 // ../shared/src/mcp/figma-model.ts
-import { z as z31 } from "zod";
+import { z as z33 } from "zod";
 function fenced(text3, language) {
   const match = text3.match(new RegExp("```" + language + "[^\\n]*\\n([\\s\\S]*?)```", "i"));
   return match ? match[1] : null;
@@ -32136,8 +32521,8 @@ var init_figma_model = __esm({
     init_figma_prototype();
     init_html_kit();
     init_preview_html();
-    unplacedSchema = z31.object({
-      unplaced: z31.array(z31.object({ name: z31.string(), reason: z31.string() }))
+    unplacedSchema = z33.object({
+      unplaced: z33.array(z33.object({ name: z33.string(), reason: z33.string() }))
     });
     UNSAFE_BLOCKS = /<(script|iframe|object|embed|noscript)\b[\s\S]*?(<\/\1[^>]*>|$)/gi;
     UNSAFE_TAGS = /<\/?(meta|link|base|form|style)\b[^>]*(>|$)/gi;
@@ -32238,7 +32623,7 @@ var init_figma_model_handoff = __esm({
 });
 
 // ../shared/src/mcp/figma-model-providers.ts
-import { z as z32 } from "zod";
+import { z as z34 } from "zod";
 function serverLabel(url) {
   try {
     const parsed = new URL(url);
@@ -32331,19 +32716,19 @@ var init_figma_model_providers = __esm({
     DEFAULT_LOCAL_MODEL = "gemma4:latest";
     DEFAULT_LOCAL_BASE_URL = "http://localhost:11434/v1";
     MAX_OUTPUT_TOKENS = 16e3;
-    chatReplySchema = z32.object({
-      choices: z32.array(z32.object({
-        message: z32.object({ content: z32.string().nullable().optional() }),
-        finish_reason: z32.string().nullable().optional()
+    chatReplySchema = z34.object({
+      choices: z34.array(z34.object({
+        message: z34.object({ content: z34.string().nullable().optional() }),
+        finish_reason: z34.string().nullable().optional()
       })).min(1),
-      usage: z32.object({ prompt_tokens: z32.number(), completion_tokens: z32.number() }).optional()
+      usage: z34.object({ prompt_tokens: z34.number(), completion_tokens: z34.number() }).optional()
     });
-    errorCodeSchema = z32.object({ code: z32.string() });
+    errorCodeSchema = z34.object({ code: z34.string() });
   }
 });
 
 // ../shared/src/mcp/figma-relay.ts
-import { z as z33 } from "zod";
+import { z as z35 } from "zod";
 function noPluginMessage() {
   return "No Figma plugin is connected. Open the Figma file, run Plugins, Development, Better Design, and leave the panel open.";
 }
@@ -32357,35 +32742,35 @@ var init_figma_relay = __esm({
     "use strict";
     init_figma_prototype();
     FIGMA_RELAY_PORT = 4397;
-    relayRequestSchema = z33.object({
-      id: z33.string(),
+    relayRequestSchema = z35.object({
+      id: z35.string(),
       /** A frame name as it reads in Figma. Omitted means the current selection. */
-      frame: z33.string().optional(),
+      frame: z35.string().optional(),
       /**
        * `model` asks for the serialized frame and its PNG instead of a rendered
        * page, so a model can rebuild a frame that holds no library component.
        * Omitted means the library path, unchanged. [BD-866]
        */
-      mode: z33.enum(["library", "model"]).optional()
+      mode: z35.enum(["library", "model"]).optional()
     });
-    relayResultSchema = z33.object({
-      id: z33.string(),
-      html: z33.string().optional(),
-      error: z33.string().optional(),
-      components: z33.number().optional(),
-      report: z33.array(z33.object({ name: z33.string(), reason: z33.string() })).default([]),
-      frame: z33.string().optional(),
+    relayResultSchema = z35.object({
+      id: z35.string(),
+      html: z35.string().optional(),
+      error: z35.string().optional(),
+      components: z35.number().optional(),
+      report: z35.array(z35.object({ name: z35.string(), reason: z35.string() })).default([]),
+      frame: z35.string().optional(),
       /** The frames the plugin found, so a missing name can say what is there. */
-      frames: z33.array(z33.string()).optional(),
+      frames: z35.array(z35.string()).optional(),
       /** Model mode: the serialized frame, for the model to rebuild. */
       tree: prototypeNodeSchema.optional(),
       /** Model mode: the frame's PNG export, base64. */
-      png: z33.string().optional()
+      png: z35.string().optional()
     });
-    relayHelloSchema = z33.object({
-      file: z33.string(),
+    relayHelloSchema = z35.object({
+      file: z35.string(),
       /** The design system the file holds, when the plugin knows it. */
-      system: z33.string().optional()
+      system: z35.string().optional()
     });
     POLL_HOLD_MS = 25e3;
     REQUEST_TIMEOUT_MS = 3e5;
@@ -32553,7 +32938,7 @@ __export(figma_prototype_tool_exports, {
 });
 import { mkdir as mkdir2, readFile, stat, writeFile as writeFile2 } from "fs/promises";
 import { dirname as dirname3, resolve as resolve2 } from "path";
-import { z as z34 } from "zod";
+import { z as z36 } from "zod";
 async function ensureRelay() {
   if (relay) return relay;
   starting ??= startFigmaRelay().then((started) => {
@@ -32613,30 +32998,30 @@ function registerFigmaPrototypeTool(server) {
         "yourself: the tool returns a prompt file and the frame's image, you write the answer to a file, and",
         "you call this tool again with frameId and answerPath so it checks the page and reports what is missing."
       ].join(" "),
-      inputSchema: z34.object({
-        frame: z34.string().optional().describe("The frame's name as it reads in Figma. Omit to use the current selection."),
-        outputPath: z34.string().optional().describe("Where to write the HTML. Relative paths resolve against the working directory."),
-        mode: z34.enum(["library", "model"]).optional().describe(
+      inputSchema: z36.object({
+        frame: z36.string().optional().describe("The frame's name as it reads in Figma. Omit to use the current selection."),
+        outputPath: z36.string().optional().describe("Where to write the HTML. Relative paths resolve against the working directory."),
+        mode: z36.enum(["library", "model"]).optional().describe(
           "library (the default) maps components from a Better Design library. model asks a model to rebuild a frame from any file."
         ),
-        system: z34.string().optional().describe("Model mode: the catalog design system to build with, as find-design-system names it."),
-        provider: z34.enum(["agent", "openai-compatible"]).optional().describe(
+        system: z36.string().optional().describe("Model mode: the catalog design system to build with, as find-design-system names it."),
+        provider: z36.enum(["agent", "openai-compatible"]).optional().describe(
           "Model mode: agent (the default) hands the frame to you to rebuild; openai-compatible calls a local server, Ollama by default."
         ),
-        model: z34.string().optional().describe(`Model mode with openai-compatible: the local model id. Defaults to ${DEFAULT_LOCAL_MODEL}.`),
-        frameId: z34.string().optional().describe("Model mode, second call: the frameId the first call returned."),
-        answerPath: z34.string().optional().describe("Model mode, second call: the file holding your answer, as the prompt file asks.")
+        model: z36.string().optional().describe(`Model mode with openai-compatible: the local model id. Defaults to ${DEFAULT_LOCAL_MODEL}.`),
+        frameId: z36.string().optional().describe("Model mode, second call: the frameId the first call returned."),
+        answerPath: z36.string().optional().describe("Model mode, second call: the file holding your answer, as the prompt file asks.")
       }),
-      outputSchema: z34.object({
-        status: z34.enum(["completed", "failed", "needs-answer"]),
-        message: z34.string(),
-        frameId: z34.string().optional(),
-        promptPath: z34.string().optional(),
-        imagePath: z34.string().optional(),
-        path: z34.string().optional(),
-        components: z34.number().optional(),
-        report: z34.array(z34.object({ name: z34.string(), reason: z34.string() })).optional(),
-        model: z34.string().optional()
+      outputSchema: z36.object({
+        status: z36.enum(["completed", "failed", "needs-answer"]),
+        message: z36.string(),
+        frameId: z36.string().optional(),
+        promptPath: z36.string().optional(),
+        imagePath: z36.string().optional(),
+        path: z36.string().optional(),
+        components: z36.number().optional(),
+        report: z36.array(z36.object({ name: z36.string(), reason: z36.string() })).optional(),
+        model: z36.string().optional()
       }),
       annotations: { readOnlyHint: false, openWorldHint: true }
     },
@@ -32858,6 +33243,7 @@ async function startServer() {
   const { createHttpDataProvider: createHttpDataProvider2 } = await Promise.resolve().then(() => (init_http_data_provider(), http_data_provider_exports));
   const {
     captureDashboardBrowser: captureDashboardBrowser2,
+    readInspiration: readInspiration2,
     trackToolUsage: trackToolUsage2,
     trackMcpInstalled: trackMcpInstalled2
   } = await Promise.resolve().then(() => (init_api_client(), api_client_exports));
@@ -32883,7 +33269,8 @@ async function startServer() {
     name: "DesignSystems",
     version: MCP_IMPLEMENTATION_VERSION2,
     onToolUsage,
-    captureDashboardBrowser: captureDashboardBrowser2
+    captureDashboardBrowser: captureDashboardBrowser2,
+    readInspiration: readInspiration2
   });
   registerReviewTool2(server, onToolUsage);
   registerFigmaPrototypeTool2(server);