@fragments-sdk/cli 0.7.3 → 0.7.5

package/dist/init-O3FCHEPN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/init.ts"],"sourcesContent":["/**\n * fragments init - Smart interactive initialization\n *\n * Handles three scenarios:\n * 1. Stories found → Configure and load existing stories\n * 2. Components found (no stories) → Auto-generate documentation\n * 3. Fresh project → Guided setup with example component\n */\n\nimport { readFile, writeFile, mkdir, access } from \"node:fs/promises\";\nimport { resolve, join, relative } from \"node:path\";\nimport { spawn } from \"node:child_process\";\nimport pc from \"picocolors\";\nimport { BRAND } from \"../core/index.js\";\nimport fg from \"fast-glob\";\nimport { input, confirm, select } from \"@inquirer/prompts\";\n\nexport interface InitOptions {\n  /** Project root directory */\n  projectRoot?: string;\n  /** Force overwrite existing config */\n  force?: boolean;\n  /** Non-interactive mode - auto-detect and use defaults */\n  yes?: boolean;\n}\n\nexport interface InitResult {\n  success: boolean;\n  configPath?: string;\n  scenario: \"stories\" | \"components\" | \"fresh\";\n  storiesFound: number;\n  componentsFound: number;\n  errors: string[];\n}\n\ninterface DetectionResult {\n  storyFiles: string[];\n  componentFiles: string[];\n  hasConfig: boolean;\n  configPath: string | null;\n  suggestedComponentPath: string;\n}\n\n/**\n * Detect what exists in the project\n */\nasync function detectProject(projectRoot: string): Promise<DetectionResult> {\n  console.log(pc.dim(\"\\nScanning project...\\n\"));\n\n  // Check for existing config\n  const configPath = join(projectRoot, BRAND.configFile);\n  const legacyConfigPath = join(projectRoot, BRAND.legacyConfigFile);\n  let hasConfig = false;\n  let foundConfigPath: string | null = null;\n\n  try {\n    await access(configPath);\n    hasConfig = true;\n    foundConfigPath = configPath;\n  } catch {\n    try {\n      await access(legacyConfigPath);\n      hasConfig = true;\n      foundConfigPath = legacyConfigPath;\n    } catch {\n      // No config\n    }\n  }\n\n  // Scan for story files\n  const storyFiles = await fg(\n    [\"**/*.stories.tsx\", \"**/*.stories.ts\", \"**/*.stories.jsx\", \"**/*.stories.js\"],\n    {\n      cwd: projectRoot,\n      ignore: [\"**/node_modules/**\", \"**/dist/**\", \"**/build/**\", \"**/.storybook/**\"],\n    }\n  );\n\n  // Scan for component files (React components)\n  const componentFiles = await fg(\n    [\"**/components/**/*.tsx\", \"**/Components/**/*.tsx\", \"src/**/*.tsx\"],\n    {\n      cwd: projectRoot,\n      ignore: [\n        \"**/node_modules/**\",\n        \"**/dist/**\",\n        \"**/build/**\",\n        \"**/*.stories.*\",\n        \"**/*.test.*\",\n        \"**/*.spec.*\",\n        \"**/*.d.ts\",\n        \"**/index.tsx\", // Skip barrel files\n      ],\n    }\n  );\n\n  // Filter to likely component files (capitalized names, not utility files)\n  const likelyComponents = componentFiles.filter((f) => {\n    const fileName = f.split(\"/\").pop() || \"\";\n    return /^[A-Z]/.test(fileName) && !fileName.includes(\".styles\");\n  });\n\n  // Suggest component path based on what we found\n  let suggestedComponentPath = \"src/components\";\n  if (likelyComponents.length > 0) {\n    const firstComponent = likelyComponents[0];\n    const parts = firstComponent.split(\"/\");\n    const componentsIndex = parts.findIndex(\n      (p) => p.toLowerCase() === \"components\"\n    );\n    if (componentsIndex !== -1) {\n      suggestedComponentPath = parts.slice(0, componentsIndex + 1).join(\"/\");\n    }\n  }\n\n  return {\n    storyFiles,\n    componentFiles: likelyComponents,\n    hasConfig,\n    configPath: foundConfigPath,\n    suggestedComponentPath,\n  };\n}\n\n/**\n * Generate config file content\n */\nfunction generateConfig(options: {\n  includePaths: string[];\n  componentPaths: string[];\n  framework: string;\n}): string {\n  const includeStr = options.includePaths.map((p) => `    '${p}'`).join(\",\\n\");\n  const componentStr = options.componentPaths.map((p) => `    '${p}'`).join(\",\\n\");\n\n  return `import type { FragmentsConfig } from '@fragments-sdk/cli';\n\nconst config: FragmentsConfig = {\n  // Glob patterns for finding fragment/story files\n  include: [\n${includeStr}\n  ],\n\n  // Glob patterns to exclude\n  exclude: ['**/node_modules/**'],\n\n  // Glob patterns for finding component files (for auto-documentation)\n  components: [\n${componentStr}\n  ],\n\n  // Framework (react, vue, svelte)\n  framework: '${options.framework}',\n};\n\nexport default config;\n`;\n}\n\n/**\n * Generate example Button component\n */\nfunction generateExampleComponent(): string {\n  return `import React from 'react';\n\nexport interface ButtonProps {\n  /** Button label */\n  children: React.ReactNode;\n  /** Visual style variant */\n  variant?: 'primary' | 'secondary' | 'ghost';\n  /** Button size */\n  size?: 'sm' | 'md' | 'lg';\n  /** Disabled state */\n  disabled?: boolean;\n  /** Click handler */\n  onClick?: () => void;\n}\n\nexport function Button({\n  children,\n  variant = 'primary',\n  size = 'md',\n  disabled = false,\n  onClick,\n}: ButtonProps) {\n  const baseStyles = 'inline-flex items-center justify-center font-medium rounded-md transition-colors';\n\n  const variantStyles = {\n    primary: 'bg-blue-600 text-white hover:bg-blue-700',\n    secondary: 'bg-gray-200 text-gray-900 hover:bg-gray-300',\n    ghost: 'bg-transparent text-gray-700 hover:bg-gray-100',\n  };\n\n  const sizeStyles = {\n    sm: 'px-3 py-1.5 text-sm',\n    md: 'px-4 py-2 text-base',\n    lg: 'px-6 py-3 text-lg',\n  };\n\n  return (\n    <button\n      className={\\`\\${baseStyles} \\${variantStyles[variant]} \\${sizeStyles[size]}\\`}\n      disabled={disabled}\n      onClick={onClick}\n    >\n      {children}\n    </button>\n  );\n}\n`;\n}\n\n/**\n * Generate example Button fragment file\n */\nfunction generateExampleFragment(): string {\n  return `import React from 'react';\nimport { defineFragment } from '@fragments-sdk/cli';\nimport { Button } from './Button';\n\nexport default defineFragment({\n  component: Button,\n\n  meta: {\n    name: 'Button',\n    description: 'Interactive button for triggering actions',\n    category: 'Actions',\n    status: 'stable',\n  },\n\n  usage: {\n    when: [\n      'Triggering an action (save, submit, delete)',\n      'Form submission',\n      'Opening dialogs or menus',\n    ],\n    whenNot: [\n      'Simple navigation (use Link)',\n      'Toggling state (use Switch)',\n    ],\n    guidelines: [\n      'Use Primary for the main action in a context',\n      'Only one Primary button per section',\n    ],\n  },\n\n  props: {\n    children: {\n      type: 'node',\n      required: true,\n      description: 'Button label content',\n    },\n    variant: {\n      type: 'enum',\n      values: ['primary', 'secondary', 'ghost'],\n      default: 'primary',\n      description: 'Visual style variant',\n    },\n    size: {\n      type: 'enum',\n      values: ['sm', 'md', 'lg'],\n      default: 'md',\n      description: 'Button size',\n    },\n  },\n\n  variants: [\n    {\n      name: 'Primary',\n      description: 'Default action button',\n      code: \\`import { Button } from './Button';\n\n<Button variant=\"primary\">Save Changes</Button>\\`,\n      render: () => <Button variant=\"primary\">Save Changes</Button>,\n    },\n    {\n      name: 'Secondary',\n      description: 'Less prominent action',\n      code: \\`import { Button } from './Button';\n\n<Button variant=\"secondary\">Cancel</Button>\\`,\n      render: () => <Button variant=\"secondary\">Cancel</Button>,\n    },\n    {\n      name: 'Ghost',\n      description: 'Minimal visual weight',\n      code: \\`import { Button } from './Button';\n\n<Button variant=\"ghost\">Learn More</Button>\\`,\n      render: () => <Button variant=\"ghost\">Learn More</Button>,\n    },\n    {\n      name: 'Sizes',\n      description: 'Available size options',\n      code: \\`import { Button } from './Button';\n\n<>\n  <Button size=\"sm\">Small</Button>\n  <Button size=\"md\">Medium</Button>\n  <Button size=\"lg\">Large</Button>\n</>\\`,\n      render: () => (\n        <>\n          <Button size=\"sm\">Small</Button>\n          <Button size=\"md\">Medium</Button>\n          <Button size=\"lg\">Large</Button>\n        </>\n      ),\n    },\n  ],\n});\n`;\n}\n\n/**\n * Start the dev server\n */\nfunction startDevServer(projectRoot: string): void {\n  console.log(pc.dim(\"\\nStarting development server...\\n\"));\n\n  // Use process.platform to determine the correct command\n  const isWindows = process.platform === \"win32\";\n  const cmd = isWindows ? \"npx.cmd\" : \"npx\";\n\n  const child = spawn(cmd, [BRAND.cliCommand, \"dev\"], {\n    cwd: projectRoot,\n    stdio: \"inherit\",\n  });\n\n  child.on(\"error\", (err) => {\n    console.error(pc.red(\"Failed to start dev server:\"), err.message);\n  });\n}\n\n/**\n * Main init function - smart and interactive by default\n */\nexport async function init(options: InitOptions = {}): Promise<InitResult> {\n  const projectRoot = resolve(options.projectRoot || process.cwd());\n  const errors: string[] = [];\n\n  console.log(pc.cyan(`\\n✨ Welcome to ${BRAND.name}!\\n`));\n\n  // Step 1: Detect what exists\n  const detection = await detectProject(projectRoot);\n\n  // Check for existing config\n  if (detection.hasConfig && !options.force) {\n    console.log(pc.yellow(`⚠ Config already exists: ${BRAND.configFile}`));\n\n    if (!options.yes) {\n      const overwrite = await confirm({\n        message: \"Do you want to reinitialize? (This will overwrite your config)\",\n        default: false,\n      });\n\n      if (!overwrite) {\n        console.log(pc.dim(`\\nKeeping existing configuration. Run \\`${BRAND.cliCommand} dev\\` to start.\\n`));\n        return {\n          success: true,\n          scenario: \"stories\",\n          storiesFound: detection.storyFiles.length,\n          componentsFound: detection.componentFiles.length,\n          errors: [],\n        };\n      }\n    }\n  }\n\n  // Step 2: Determine scenario and show what we found\n  let scenario: \"stories\" | \"components\" | \"fresh\";\n\n  if (detection.storyFiles.length > 0) {\n    scenario = \"stories\";\n    console.log(pc.green(`✓ Found ${detection.storyFiles.length} Storybook story file(s)`));\n    console.log(pc.dim(`  ${detection.storyFiles.slice(0, 3).join(\"\\n  \")}`));\n    if (detection.storyFiles.length > 3) {\n      console.log(pc.dim(`  ... and ${detection.storyFiles.length - 3} more`));\n    }\n    console.log();\n    console.log(\n      pc.cyan(\"Great news! \") +\n        \"Fragments can load your existing stories automatically.\"\n    );\n  } else if (detection.componentFiles.length > 0) {\n    scenario = \"components\";\n    console.log(pc.green(`✓ Found ${detection.componentFiles.length} component file(s)`));\n    console.log(pc.dim(`  ${detection.componentFiles.slice(0, 3).join(\"\\n  \")}`));\n    if (detection.componentFiles.length > 3) {\n      console.log(pc.dim(`  ... and ${detection.componentFiles.length - 3} more`));\n    }\n    console.log();\n    console.log(\n      pc.cyan(\"No stories found, but that's fine! \") +\n        \"Fragments can auto-generate documentation from your TypeScript.\"\n    );\n  } else {\n    scenario = \"fresh\";\n    console.log(pc.yellow(\"No components or stories found.\"));\n    console.log();\n    console.log(pc.cyan(\"Let's create your first fragment!\"));\n  }\n\n  console.log();\n\n  // Step 3: Gather configuration (interactive unless --yes)\n  let componentPath = detection.suggestedComponentPath;\n  let runScan = scenario === \"components\";\n  let createExample = scenario === \"fresh\";\n  let startServer = true;\n\n  if (!options.yes) {\n    // Ask about component location\n    componentPath = await input({\n      message: \"Where are your components located?\",\n      default: detection.suggestedComponentPath,\n    });\n\n    if (scenario === \"components\") {\n      // For component-only projects, ask about scanning\n      runScan = await confirm({\n        message: \"Auto-generate documentation from TypeScript?\",\n        default: true,\n      });\n    } else {\n      // Fresh project - ask about example\n      createExample = await confirm({\n        message: \"Create an example Button component to get started?\",\n        default: true,\n      });\n    }\n\n    // Ask about starting the server\n    startServer = await confirm({\n      message: \"Start the viewer now?\",\n      default: true,\n    });\n  }\n\n  // Step 4: Create configuration\n  console.log(pc.dim(\"\\nCreating configuration...\\n\"));\n\n  // Build include patterns\n  const includePaths: string[] = [\n    `${componentPath}/**/*.fragment.tsx`,\n  ];\n\n  // Include story files when Storybook is detected\n  if (scenario === 'stories') {\n    includePaths.push(`${componentPath}/**/*.stories.tsx`);\n    includePaths.push(`${componentPath}/**/*.stories.ts`);\n  }\n\n  // Create config file\n  const configPath = join(projectRoot, BRAND.configFile);\n  const configContent = generateConfig({\n    includePaths,\n    componentPaths: [`${componentPath}/**/*.tsx`],\n    framework: \"react\",\n  });\n\n  try {\n    await writeFile(configPath, configContent, \"utf-8\");\n    console.log(pc.green(`✓ Created ${BRAND.configFile}`));\n  } catch (e) {\n    errors.push(`Failed to create config: ${e}`);\n  }\n\n  // Step 5: Handle scenario-specific setup\n  if (scenario === \"fresh\" && createExample) {\n    // Create example component\n    const exampleDir = join(projectRoot, componentPath, \"Button\");\n\n    try {\n      await mkdir(exampleDir, { recursive: true });\n\n      // Write Button.tsx\n      await writeFile(\n        join(exampleDir, \"Button.tsx\"),\n        generateExampleComponent(),\n        \"utf-8\"\n      );\n      console.log(\n        pc.green(`✓ Created ${relative(projectRoot, join(exampleDir, \"Button.tsx\"))}`)\n      );\n\n      // Write Button.fragment.tsx\n      await writeFile(\n        join(exampleDir, \"Button.fragment.tsx\"),\n        generateExampleFragment(),\n        \"utf-8\"\n      );\n      console.log(\n        pc.green(\n          `✓ Created ${relative(projectRoot, join(exampleDir, \"Button.fragment.tsx\"))}`\n        )\n      );\n    } catch (e) {\n      errors.push(`Failed to create example component: ${e}`);\n    }\n  }\n\n  if (scenario === \"components\" && runScan) {\n    // Run scan to generate fragments.json\n    console.log(pc.dim(\"\\nGenerating documentation from source code...\\n\"));\n    try {\n      const { scan } = await import(\"./scan.js\");\n      await scan({\n        config: configPath,\n        verbose: false,\n      });\n    } catch (e) {\n      console.log(\n        pc.yellow(`Note: Auto-documentation will run when you start the dev server.`)\n      );\n    }\n  }\n\n  // Step 6: Show next steps or start server\n  if (errors.length === 0) {\n    console.log(pc.green(\"\\n✓ Setup complete!\\n\"));\n\n    if (startServer) {\n      const serverMessage =\n        scenario === \"stories\"\n          ? `Your ${detection.storyFiles.length} stories are loading...`\n          : scenario === \"components\"\n          ? `Your ${detection.componentFiles.length} components are being documented...`\n          : `Your first component is ready!`;\n\n      console.log(pc.cyan(serverMessage));\n      startDevServer(projectRoot);\n    } else {\n      console.log(pc.cyan(\"Next steps:\"));\n      console.log(`  1. Run ${pc.bold(`${BRAND.cliCommand} dev`)} to start the viewer`);\n      if (scenario === \"fresh\") {\n        console.log(`  2. Edit ${pc.bold(`${componentPath}/Button/Button.fragment.tsx`)}`);\n      }\n      console.log();\n    }\n  }\n\n  return {\n    success: errors.length === 0,\n    configPath: errors.length === 0 ? configPath : undefined,\n    scenario,\n    storiesFound: detection.storyFiles.length,\n    componentsFound: detection.componentFiles.length,\n    errors,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/mcp-bin.js

@@ -2,8 +2,8 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   generateContext
-} from "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+} from "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import {
   BRAND,
   DEFAULTS
@@ -60,7 +60,7 @@ var _service = null;
 async function getService() {
   if (!_service) {
     try {
-      _service = await import("./service-CFFBHW4X.js");
+      _service = await import("./service-VA6XKADO.js");
     } catch {
       throw new Error(
         "Visual tools require playwright. Install it with: npm install playwright"

package/dist/{scan-OJRCVKK2.js → scan-IYTZDUKG.js}

@@ -1,15 +1,15 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   scan
-} from "./chunk-R2YH7NLN.js";
-import "./chunk-R6IZZSE7.js";
-import "./chunk-D34Q6A7S.js";
+} from "./chunk-CR3XHBGM.js";
+import "./chunk-JZNATKQA.js";
+import "./chunk-AWYCDRPG.js";
 import "./chunk-YMPGYEWK.js";
-import "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+import "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import "./chunk-EKLMXTWU.js";
 import "./chunk-Z7EY4VHE.js";
 export {
   scan
 };
-//# sourceMappingURL=scan-OJRCVKK2.js.map
+//# sourceMappingURL=scan-IYTZDUKG.js.map

package/dist/{service-CFFBHW4X.js → service-VA6XKADO.js}

@@ -98,8 +98,8 @@ import {
   sleep,
   summarizePatternsForPrompt
 } from "./chunk-YMPGYEWK.js";
-import "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+import "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import {
   BRAND,
   DEFAULTS
@@ -207,4 +207,4 @@ export {
   sleep,
   summarizePatternsForPrompt
 };
-//# sourceMappingURL=service-CFFBHW4X.js.map
+//# sourceMappingURL=service-VA6XKADO.js.map

package/dist/{static-viewer-VA2JXSCX.js → static-viewer-5N42MBDR.js}

@@ -3,12 +3,12 @@ import {
   generateStaticViewer,
   generateViewerFromJson
 } from "./chunk-TOIE7VXF.js";
-import "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+import "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import "./chunk-EKLMXTWU.js";
 import "./chunk-Z7EY4VHE.js";
 export {
   generateStaticViewer,
   generateViewerFromJson
 };
-//# sourceMappingURL=static-viewer-VA2JXSCX.js.map
+//# sourceMappingURL=static-viewer-5N42MBDR.js.map

package/dist/{test-O7DZNKDC.js → test-OMMDWL2W.js}

@@ -1,11 +1,11 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   parseFragmentFile
-} from "./chunk-R6IZZSE7.js";
+} from "./chunk-JZNATKQA.js";
 import {
   discoverFragmentFiles
-} from "./chunk-D34Q6A7S.js";
-import "./chunk-P33AKQJW.js";
+} from "./chunk-AWYCDRPG.js";
+import "./chunk-SFWZ4K7C.js";
 import "./chunk-EKLMXTWU.js";
 import "./chunk-Z7EY4VHE.js";
 
@@ -1072,4 +1072,4 @@ export {
   listTests,
   runTestCommand
 };
-//# sourceMappingURL=test-O7DZNKDC.js.map
+//# sourceMappingURL=test-OMMDWL2W.js.map

package/dist/{tokens-N7THFD6J.js → tokens-6VJAHFIG.js}

@@ -1,13 +1,13 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   loadConfig
-} from "./chunk-R6IZZSE7.js";
-import "./chunk-D34Q6A7S.js";
+} from "./chunk-JZNATKQA.js";
+import "./chunk-AWYCDRPG.js";
 import {
   parseTokenFiles
 } from "./chunk-YMPGYEWK.js";
-import "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+import "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import {
   BRAND
 } from "./chunk-EKLMXTWU.js";
@@ -173,4 +173,4 @@ export {
   tokens_default as default,
   tokens
 };
-//# sourceMappingURL=tokens-N7THFD6J.js.map
+//# sourceMappingURL=tokens-6VJAHFIG.js.map

package/dist/{viewer-QTR7QJMM.js → viewer-IVP5XC7U.js}

@@ -4,15 +4,15 @@ import {
   findStorybookDir,
   generatePreviewModule,
   loadConfig
-} from "./chunk-R6IZZSE7.js";
+} from "./chunk-JZNATKQA.js";
 import {
   discoverFragmentFiles,
   discoverInstalledFragments
-} from "./chunk-D34Q6A7S.js";
+} from "./chunk-AWYCDRPG.js";
 import {
   generateContext
-} from "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+} from "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import {
   BRAND
 } from "./chunk-EKLMXTWU.js";
@@ -360,7 +360,7 @@ var sharedRenderPool = null;
 var browserPoolModule = null;
 async function getSharedRenderPool() {
   if (!browserPoolModule) {
-    browserPoolModule = await import("./service-CFFBHW4X.js");
+    browserPoolModule = await import("./service-VA6XKADO.js");
   }
   if (!sharedRenderPool) {
     sharedRenderPool = new browserPoolModule.BrowserPool({
@@ -392,6 +392,16 @@ function fragmentsPlugin(options) {
     // Add process.env shim and esbuild config for Storybook compatibility
     config() {
       return {
+        build: {
+          rollupOptions: {
+            onwarn(warning, defaultHandler) {
+              if (warning.code === "MODULE_LEVEL_DIRECTIVE" || warning.message && warning.message.includes("has been externalized")) {
+                return;
+              }
+              defaultHandler(warning);
+            }
+          }
+        },
         define: {
           // Shim process.env for story files that use it (e.g., process.env.STORYBOOK_*)
           "process.env": "{}"
@@ -593,7 +603,7 @@ function fragmentsPlugin(options) {
             const address = _server.httpServer?.address();
             const port = typeof address === "object" && address ? address.port : 6006;
             const renderViewport = viewport || { width: 800, height: 600 };
-            const { FigmaClient, bufferToBase64Url } = await import("./service-CFFBHW4X.js");
+            const { FigmaClient, bufferToBase64Url } = await import("./service-VA6XKADO.js");
             const figmaClient = new FigmaClient({
               accessToken: figmaToken
             });
@@ -684,7 +694,7 @@ function fragmentsPlugin(options) {
               );
               return;
             }
-            const { FigmaClient } = await import("./service-CFFBHW4X.js");
+            const { FigmaClient } = await import("./service-VA6XKADO.js");
             const figmaClient = new FigmaClient({ accessToken: figmaToken });
             const { fileKey, nodeId } = figmaClient.parseUrl(figmaUrl);
             const figmaDesignProps = await figmaClient.getNodeProperties(
@@ -725,7 +735,7 @@ function fragmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-CFFBHW4X.js");
+            const { getSharedTokenRegistry } = await import("./service-VA6XKADO.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -785,7 +795,7 @@ function fragmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-CFFBHW4X.js");
+            const { getSharedTokenRegistry } = await import("./service-VA6XKADO.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -847,7 +857,7 @@ function fragmentsPlugin(options) {
               res.end(JSON.stringify({ error: "Could not resolve fragment file path" }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-CFFBHW4X.js");
+            const { getSharedTokenRegistry } = await import("./service-VA6XKADO.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -973,7 +983,7 @@ function fragmentsPlugin(options) {
             }
             const { writeFile, mkdir } = await import("fs/promises");
             const { join: join2 } = await import("path");
-            const { BRAND: BRAND2 } = await import("./core-3NMNCLFW.js");
+            const { BRAND: BRAND2 } = await import("./core-T7BDYEGO.js");
             const fragmentsDir = join2(projectRoot, BRAND2.dataDir, BRAND2.componentsDir);
             await mkdir(fragmentsDir, { recursive: true });
             const fragmentPath = join2(
@@ -1009,7 +1019,7 @@ function fragmentsPlugin(options) {
             }
             if (!config.tokens || !config.tokens.include || config.tokens.include.length === 0) {
               try {
-                const { discoverTokenFiles } = await import("./discovery-AKGA6CJD.js");
+                const { discoverTokenFiles } = await import("./discovery-Z4RDDFVR.js");
                 const discovered = await discoverTokenFiles(projectRoot);
                 if (discovered.length > 0) {
                   config.tokens = {
@@ -1046,7 +1056,7 @@ function fragmentsPlugin(options) {
             const {
               getSharedTokenRegistry,
               generateTokenPatches
-            } = await import("./service-CFFBHW4X.js");
+            } = await import("./service-VA6XKADO.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -1465,7 +1475,15 @@ function mergeMetadata(fragment, metadataModule) {
   if (metadata.variants && fragment.variants) {
     for (const metaVariant of metadata.variants) {
       const fragmentVariant = fragment.variants.find(v => v.name === metaVariant.name);
-      if (fragmentVariant && metaVariant.figma && !fragmentVariant.figma) {
+      if (!fragmentVariant) continue;
+
+      // Use authored code snippets from fragment metadata when story variants
+      // don't define their own code.
+      if (metaVariant.code && !fragmentVariant.code) {
+        fragmentVariant.code = metaVariant.code;
+      }
+
+      if (metaVariant.figma && !fragmentVariant.figma) {
         fragmentVariant.figma = metaVariant.figma;
       }
     }
@@ -1552,7 +1570,9 @@ export async function loadFragment(path) {
     }
   }
 
-  loadedFragments.set(path, fragment);
+  if (fragment) {
+    loadedFragments.set(path, fragment);
+  }
   return fragment;
 }
 
@@ -1931,7 +1951,7 @@ async function loadFullFragmentForCompare(_server, _fragmentFiles, componentName
   }
 }
 async function compareImages(image1Base64, image2Base64, threshold) {
-  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-CFFBHW4X.js");
+  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-VA6XKADO.js");
   const { PNG } = await import("pngjs");
   const buffer1 = base64UrlToBuffer(image1Base64);
   const buffer2 = base64UrlToBuffer(image2Base64);
@@ -2184,4 +2204,4 @@ export {
   createDevServer,
   fragmentsPlugin
 };
-//# sourceMappingURL=viewer-QTR7QJMM.js.map
+//# sourceMappingURL=viewer-IVP5XC7U.js.map