@fragments-sdk/cli 0.7.14 → 0.7.16

package/dist/init-DIZ6UNBL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/init.ts","../src/commands/init-framework.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, dirname, basename } 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\";\nimport {\n  setupFramework,\n  detectFramework,\n  type Framework,\n} from \"./init-framework.js\";\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  /** Explicit framework override */\n  framework?: string;\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        \"**/*.fragment.*\",\n        \"**/*.test.*\",\n        \"**/*.spec.*\",\n        \"**/*.d.ts\",\n        \"**/index.tsx\", // Skip barrel files\n      ],\n    }\n  );\n\n  // Filter to likely component files (exclude known non-component patterns)\n  const nonComponentPatterns = /\\.(styles|utils|helpers|constants|types|hooks|context|config|mock|fixture)\\./i;\n  const nonComponentNames = /^(index|types|utils|helpers|constants|hooks|providers|layout|use[A-Z])/;\n  const likelyComponents = componentFiles.filter((f) => {\n    const fileName = f.split(\"/\").pop() || \"\";\n    const baseName = fileName.replace(/\\.tsx$/, \"\");\n    return !nonComponentPatterns.test(fileName) && !nonComponentNames.test(baseName);\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/core';\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 * Convert a filename to PascalCase component name\n */\nfunction toPascalCase(str: string): string {\n  return str\n    .replace(/[-_.](\\w)/g, (_, c) => c.toUpperCase())\n    .replace(/^\\w/, (c) => c.toUpperCase());\n}\n\n/**\n * Generate a minimal fragment stub for a discovered component\n */\nfunction generateFragmentStub(componentName: string, importPath: string): string {\n  return `import React from 'react';\nimport { defineFragment } from '@fragments-sdk/cli/core';\nimport { ${componentName} } from '${importPath}';\n\nexport default defineFragment({\n  component: ${componentName},\n\n  meta: {\n    name: '${componentName}',\n    description: '${componentName} component',\n    category: 'general',\n    status: 'beta',\n  },\n\n  usage: {\n    when: ['TODO: describe when to use ${componentName}'],\n    whenNot: ['TODO: describe when not to use ${componentName}'],\n  },\n\n  props: {},\n\n  variants: [\n    {\n      name: 'Default',\n      description: 'Default ${componentName}',\n      code: \\`<${componentName} />\\`,\n      render: () => <${componentName} />,\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    // Generate .fragment.tsx stubs for discovered components\n    let stubsCreated = 0;\n    for (const compFile of detection.componentFiles) {\n      const absPath = join(projectRoot, compFile);\n      const dir = dirname(absPath);\n      const fileName = basename(compFile, \".tsx\");\n      const componentName = toPascalCase(fileName);\n      const fragmentPath = join(dir, `${fileName}.fragment.tsx`);\n\n      // Skip if fragment already exists\n      try {\n        await access(fragmentPath);\n        continue; // already exists\n      } catch {\n        // doesn't exist, create it\n      }\n\n      try {\n        const stub = generateFragmentStub(componentName, `./${fileName}`);\n        await writeFile(fragmentPath, stub, \"utf-8\");\n        stubsCreated++;\n      } catch {\n        // skip files we can't write to\n      }\n    }\n\n    if (stubsCreated > 0) {\n      console.log(pc.green(`✓ Generated ${stubsCreated} fragment stub(s)`));\n    }\n\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: Framework-specific configuration\n  console.log(pc.dim(\"\\nConfiguring framework integration...\\n\"));\n\n  const frameworkOverride = options.framework as Framework | undefined;\n  const frameworkResult = await setupFramework({\n    projectRoot,\n    framework: frameworkOverride,\n  });\n\n  if (frameworkResult.filesCreated.length > 0) {\n    for (const file of frameworkResult.filesCreated) {\n      console.log(pc.green(`✓ Created ${file}`));\n    }\n  }\n\n  if (frameworkResult.configModified.length > 0) {\n    for (const file of frameworkResult.configModified) {\n      console.log(pc.green(`✓ Updated ${file}`));\n    }\n  }\n\n  if (frameworkResult.packagesToInstall.length > 0) {\n    const pkgs = frameworkResult.packagesToInstall.join(\" \");\n    console.log(\n      pc.yellow(`\\n⚠ Install required dependencies: `) +\n        pc.bold(`pnpm add -D ${pkgs}`)\n    );\n  }\n\n  for (const warning of frameworkResult.warnings) {\n    console.log(pc.yellow(`  Note: ${warning}`));\n  }\n\n  // Step 7: 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","/**\n * Framework detection and auto-configuration for fragments init.\n *\n * Detects the consumer's framework (Next.js, Vite, Remix, Astro)\n * and generates appropriate configuration files.\n */\n\nimport { readFile, writeFile, access } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport pc from \"picocolors\";\n\n// ============================================\n// Types\n// ============================================\n\nexport type Framework = \"nextjs\" | \"vite\" | \"remix\" | \"astro\" | \"unknown\";\n\nexport interface FrameworkDetection {\n  framework: Framework;\n  /** Package that triggered the detection */\n  detectedBy: string | null;\n}\n\nexport interface FrameworkSetupOptions {\n  /** Project root directory */\n  projectRoot: string;\n  /** Override auto-detected framework */\n  framework?: Framework;\n  /** Seed overrides for globals.scss generation */\n  seeds?: {\n    brand?: string;\n    neutral?: string;\n    density?: string;\n    radiusStyle?: string;\n  };\n}\n\nexport interface FrameworkSetupResult {\n  framework: Framework;\n  filesCreated: string[];\n  packagesToInstall: string[];\n  configModified: string[];\n  warnings: string[];\n}\n\n// ============================================\n// Framework Detection\n// ============================================\n\n/**\n * Detect framework from package.json dependencies\n */\nexport async function detectFramework(\n  projectRoot: string\n): Promise<FrameworkDetection> {\n  try {\n    const pkgPath = join(projectRoot, \"package.json\");\n    const pkgContent = await readFile(pkgPath, \"utf-8\");\n    const pkg = JSON.parse(pkgContent);\n\n    const allDeps = {\n      ...pkg.dependencies,\n      ...pkg.devDependencies,\n    };\n\n    // Check in order of specificity\n    if (allDeps[\"next\"]) {\n      return { framework: \"nextjs\", detectedBy: \"next\" };\n    }\n    if (allDeps[\"@remix-run/react\"]) {\n      return { framework: \"remix\", detectedBy: \"@remix-run/react\" };\n    }\n    if (allDeps[\"astro\"]) {\n      return { framework: \"astro\", detectedBy: \"astro\" };\n    }\n    if (allDeps[\"vite\"]) {\n      return { framework: \"vite\", detectedBy: \"vite\" };\n    }\n\n    return { framework: \"unknown\", detectedBy: null };\n  } catch {\n    return { framework: \"unknown\", detectedBy: null };\n  }\n}\n\n// ============================================\n// Globals SCSS Generation\n// ============================================\n\nfunction generateGlobalsSCSS(seeds?: FrameworkSetupOptions[\"seeds\"]): string {\n  const withClauses: string[] = [];\n\n  if (seeds?.brand) {\n    withClauses.push(`  $fui-brand: ${seeds.brand}`);\n  }\n  if (seeds?.neutral) {\n    withClauses.push(`  $fui-neutral: \"${seeds.neutral}\"`);\n  }\n  if (seeds?.density) {\n    withClauses.push(`  $fui-density: \"${seeds.density}\"`);\n  }\n  if (seeds?.radiusStyle) {\n    withClauses.push(`  $fui-radius-style: \"${seeds.radiusStyle}\"`);\n  }\n\n  const useStatement =\n    withClauses.length > 0\n      ? `@use '@fragments-sdk/ui/styles' with (\\n${withClauses.join(\",\\n\")}\\n);`\n      : `@use '@fragments-sdk/ui/styles';`;\n\n  return `// Fragments SDK Global Styles\n// Customize seed values to theme the entire design system.\n// See: https://usefragments.com/docs/theming\n${useStatement}\n`;\n}\n\n// ============================================\n// Providers Component Generation\n// ============================================\n\nfunction generateProviders(): string {\n  return `'use client';\n\nimport { ThemeProvider } from '@fragments-sdk/ui';\n\nexport function Providers({ children }: { children: React.ReactNode }) {\n  return (\n    <ThemeProvider defaultTheme=\"system\" attribute=\"data-theme\">\n      {children}\n    </ThemeProvider>\n  );\n}\n`;\n}\n\n// ============================================\n// Per-Framework Configuration\n// ============================================\n\nasync function setupNextJS(\n  projectRoot: string,\n  options: FrameworkSetupOptions\n): Promise<FrameworkSetupResult> {\n  const result: FrameworkSetupResult = {\n    framework: \"nextjs\",\n    filesCreated: [],\n    packagesToInstall: [],\n    configModified: [],\n    warnings: [],\n  };\n\n  // Check if sass is installed\n  try {\n    const pkgContent = await readFile(\n      join(projectRoot, \"package.json\"),\n      \"utf-8\"\n    );\n    const pkg = JSON.parse(pkgContent);\n    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };\n    if (!allDeps[\"sass\"]) {\n      result.packagesToInstall.push(\"sass\");\n    }\n  } catch {\n    // Proceed without checking\n  }\n\n  // Update next.config if transpilePackages is needed\n  const nextConfigPaths = [\n    \"next.config.ts\",\n    \"next.config.mjs\",\n    \"next.config.js\",\n  ];\n\n  for (const configName of nextConfigPaths) {\n    const configPath = join(projectRoot, configName);\n    try {\n      await access(configPath);\n      const content = await readFile(configPath, \"utf-8\");\n\n      if (!content.includes(\"transpilePackages\")) {\n        // Add transpilePackages to the config\n        if (content.includes(\"const nextConfig\")) {\n          const updated = content.replace(\n            /const nextConfig\\s*=\\s*\\{/,\n            `const nextConfig = {\\n  transpilePackages: ['@fragments-sdk/ui'],`\n          );\n          await writeFile(configPath, updated, \"utf-8\");\n          result.configModified.push(configName);\n        } else {\n          result.warnings.push(\n            `Could not auto-modify ${configName}. Add transpilePackages: ['@fragments-sdk/ui'] manually.`\n          );\n        }\n      }\n      break;\n    } catch {\n      continue;\n    }\n  }\n\n  // Generate globals.scss\n  const globalsPath = join(projectRoot, \"src\", \"styles\", \"globals.scss\");\n  try {\n    await access(globalsPath);\n    result.warnings.push(\n      \"src/styles/globals.scss already exists. Skipped generation.\"\n    );\n  } catch {\n    await writeFile(globalsPath, generateGlobalsSCSS(options.seeds), \"utf-8\");\n    result.filesCreated.push(\"src/styles/globals.scss\");\n  }\n\n  // Generate providers.tsx\n  const providersPath = join(projectRoot, \"src\", \"providers.tsx\");\n  try {\n    await access(providersPath);\n    result.warnings.push(\"src/providers.tsx already exists. Skipped.\");\n  } catch {\n    await writeFile(providersPath, generateProviders(), \"utf-8\");\n    result.filesCreated.push(\"src/providers.tsx\");\n  }\n\n  return result;\n}\n\nasync function setupVite(\n  projectRoot: string,\n  options: FrameworkSetupOptions\n): Promise<FrameworkSetupResult> {\n  const result: FrameworkSetupResult = {\n    framework: \"vite\",\n    filesCreated: [],\n    packagesToInstall: [],\n    configModified: [],\n    warnings: [],\n  };\n\n  // Check if sass is installed\n  try {\n    const pkgContent = await readFile(\n      join(projectRoot, \"package.json\"),\n      \"utf-8\"\n    );\n    const pkg = JSON.parse(pkgContent);\n    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };\n    if (!allDeps[\"sass\"]) {\n      result.packagesToInstall.push(\"sass\");\n    }\n  } catch {\n    // Proceed\n  }\n\n  // Generate globals.scss\n  const globalsPath = join(projectRoot, \"src\", \"styles\", \"globals.scss\");\n  try {\n    await access(globalsPath);\n    result.warnings.push(\n      \"src/styles/globals.scss already exists. Skipped generation.\"\n    );\n  } catch {\n    await writeFile(globalsPath, generateGlobalsSCSS(options.seeds), \"utf-8\");\n    result.filesCreated.push(\"src/styles/globals.scss\");\n  }\n\n  // Generate providers.tsx\n  const providersPath = join(projectRoot, \"src\", \"providers.tsx\");\n  try {\n    await access(providersPath);\n    result.warnings.push(\"src/providers.tsx already exists. Skipped.\");\n  } catch {\n    await writeFile(providersPath, generateProviders(), \"utf-8\");\n    result.filesCreated.push(\"src/providers.tsx\");\n  }\n\n  return result;\n}\n\nasync function setupRemix(\n  projectRoot: string,\n  options: FrameworkSetupOptions\n): Promise<FrameworkSetupResult> {\n  const result: FrameworkSetupResult = {\n    framework: \"remix\",\n    filesCreated: [],\n    packagesToInstall: [],\n    configModified: [],\n    warnings: [],\n  };\n\n  result.packagesToInstall.push(\"sass\");\n\n  // Generate globals.scss in app/styles\n  const globalsPath = join(projectRoot, \"app\", \"styles\", \"globals.scss\");\n  try {\n    await access(globalsPath);\n    result.warnings.push(\n      \"app/styles/globals.scss already exists. Skipped generation.\"\n    );\n  } catch {\n    await writeFile(globalsPath, generateGlobalsSCSS(options.seeds), \"utf-8\");\n    result.filesCreated.push(\"app/styles/globals.scss\");\n  }\n\n  // Generate providers.tsx\n  const providersPath = join(projectRoot, \"app\", \"providers.tsx\");\n  try {\n    await access(providersPath);\n    result.warnings.push(\"app/providers.tsx already exists. Skipped.\");\n  } catch {\n    await writeFile(providersPath, generateProviders(), \"utf-8\");\n    result.filesCreated.push(\"app/providers.tsx\");\n  }\n\n  result.warnings.push(\n    'Add @fragments-sdk/ui to serverDependenciesToBundle in remix.config if using source imports.'\n  );\n\n  return result;\n}\n\nasync function setupAstro(\n  projectRoot: string,\n  options: FrameworkSetupOptions\n): Promise<FrameworkSetupResult> {\n  const result: FrameworkSetupResult = {\n    framework: \"astro\",\n    filesCreated: [],\n    packagesToInstall: [],\n    configModified: [],\n    warnings: [],\n  };\n\n  result.packagesToInstall.push(\"sass\");\n\n  // Generate globals.scss\n  const globalsPath = join(projectRoot, \"src\", \"styles\", \"globals.scss\");\n  try {\n    await access(globalsPath);\n    result.warnings.push(\n      \"src/styles/globals.scss already exists. Skipped generation.\"\n    );\n  } catch {\n    await writeFile(globalsPath, generateGlobalsSCSS(options.seeds), \"utf-8\");\n    result.filesCreated.push(\"src/styles/globals.scss\");\n  }\n\n  return result;\n}\n\n// ============================================\n// Main Setup Function\n// ============================================\n\n/**\n * Set up framework-specific configuration for @fragments-sdk/ui\n */\nexport async function setupFramework(\n  options: FrameworkSetupOptions\n): Promise<FrameworkSetupResult> {\n  const { projectRoot } = options;\n\n  // Detect or use provided framework\n  let framework = options.framework;\n  if (!framework || framework === \"unknown\") {\n    const detection = await detectFramework(projectRoot);\n    framework = detection.framework;\n\n    if (detection.detectedBy) {\n      console.log(\n        pc.green(`  Detected ${frameworkLabel(framework)}`) +\n          pc.dim(` (via ${detection.detectedBy})`)\n      );\n    }\n  } else {\n    console.log(pc.green(`  Framework: ${frameworkLabel(framework)}`));\n  }\n\n  switch (framework) {\n    case \"nextjs\":\n      return setupNextJS(projectRoot, options);\n    case \"vite\":\n      return setupVite(projectRoot, options);\n    case \"remix\":\n      return setupRemix(projectRoot, options);\n    case \"astro\":\n      return setupAstro(projectRoot, options);\n    default:\n      return {\n        framework: \"unknown\",\n        filesCreated: [],\n        packagesToInstall: [\"sass\"],\n        configModified: [],\n        warnings: [\n          \"Could not detect framework. Install sass and import @fragments-sdk/ui/styles manually.\",\n        ],\n      };\n  }\n}\n\nfunction frameworkLabel(framework: Framework): string {\n  switch (framework) {\n    case \"nextjs\":\n      return \"Next.js\";\n    case \"vite\":\n      return \"Vite\";\n    case \"remix\":\n      return \"Remix\";\n    case \"astro\":\n      return \"Astro\";\n    default:\n      return \"Unknown\";\n  }\n}\n"],"mappings":"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","names":["writeFile","access","join","pc","pc","join","access","writeFile"]}

package/dist/mcp-bin.js

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

package/dist/{scan-BSMLGBX4.js → scan-X3DI2X5G.js}

@@ -5,11 +5,11 @@ import {
 import "./chunk-57OW43NL.js";
 import "./chunk-AWYCDRPG.js";
 import "./chunk-YMPGYEWK.js";
-import "./chunk-TQOGBAOZ.js";
+import "./chunk-WLXFE6XW.js";
 import "./chunk-7CRC46HV.js";
 import "./chunk-EKLMXTWU.js";
 import "./chunk-Z7EY4VHE.js";
 export {
   scan
 };
-//# sourceMappingURL=scan-BSMLGBX4.js.map
+//# sourceMappingURL=scan-X3DI2X5G.js.map

package/dist/{service-QACVPR37.js → service-JEWWTSKI.js}

@@ -98,7 +98,7 @@ import {
   sleep,
   summarizePatternsForPrompt
 } from "./chunk-YMPGYEWK.js";
-import "./chunk-TQOGBAOZ.js";
+import "./chunk-WLXFE6XW.js";
 import "./chunk-7CRC46HV.js";
 import {
   BRAND,
@@ -207,4 +207,4 @@ export {
   sleep,
   summarizePatternsForPrompt
 };
-//# sourceMappingURL=service-QACVPR37.js.map
+//# sourceMappingURL=service-JEWWTSKI.js.map

package/dist/{static-viewer-2RQD5QLR.js → static-viewer-JIWCYKVK.js}

@@ -3,7 +3,7 @@ import {
   generateStaticViewer,
   generateViewerFromJson
 } from "./chunk-TOIE7VXF.js";
-import "./chunk-TQOGBAOZ.js";
+import "./chunk-WLXFE6XW.js";
 import "./chunk-7CRC46HV.js";
 import "./chunk-EKLMXTWU.js";
 import "./chunk-Z7EY4VHE.js";
@@ -11,4 +11,4 @@ export {
   generateStaticViewer,
   generateViewerFromJson
 };
-//# sourceMappingURL=static-viewer-2RQD5QLR.js.map
+//# sourceMappingURL=static-viewer-JIWCYKVK.js.map

package/dist/{tokens-A3BZIQPB.js → tokens-K2AGUUOJ.js}

@@ -6,7 +6,7 @@ import "./chunk-AWYCDRPG.js";
 import {
   parseTokenFiles
 } from "./chunk-YMPGYEWK.js";
-import "./chunk-TQOGBAOZ.js";
+import "./chunk-WLXFE6XW.js";
 import "./chunk-7CRC46HV.js";
 import {
   BRAND
@@ -173,4 +173,4 @@ export {
   tokens_default as default,
   tokens
 };
-//# sourceMappingURL=tokens-A3BZIQPB.js.map
+//# sourceMappingURL=tokens-K2AGUUOJ.js.map

package/dist/{viewer-CNLZQUFO.js → viewer-QKIAPTPG.js}

@@ -3,7 +3,8 @@ import {
   findPreviewConfigPath,
   findStorybookDir,
   generatePreviewModule,
-  loadConfig
+  loadConfig,
+  parseFragmentFile
 } from "./chunk-57OW43NL.js";
 import {
   discoverFragmentFiles,
@@ -11,7 +12,7 @@ import {
 } from "./chunk-AWYCDRPG.js";
 import {
   generateContext
-} from "./chunk-TQOGBAOZ.js";
+} from "./chunk-WLXFE6XW.js";
 import "./chunk-7CRC46HV.js";
 import {
   BRAND
@@ -360,7 +361,7 @@ var sharedRenderPool = null;
 var browserPoolModule = null;
 async function getSharedRenderPool() {
   if (!browserPoolModule) {
-    browserPoolModule = await import("./service-QACVPR37.js");
+    browserPoolModule = await import("./service-JEWWTSKI.js");
   }
   if (!sharedRenderPool) {
     sharedRenderPool = new browserPoolModule.BrowserPool({
@@ -603,7 +604,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-QACVPR37.js");
+            const { FigmaClient, bufferToBase64Url } = await import("./service-JEWWTSKI.js");
             const figmaClient = new FigmaClient({
               accessToken: figmaToken
             });
@@ -694,7 +695,7 @@ function fragmentsPlugin(options) {
               );
               return;
             }
-            const { FigmaClient } = await import("./service-QACVPR37.js");
+            const { FigmaClient } = await import("./service-JEWWTSKI.js");
             const figmaClient = new FigmaClient({ accessToken: figmaToken });
             const { fileKey, nodeId } = figmaClient.parseUrl(figmaUrl);
             const figmaDesignProps = await figmaClient.getNodeProperties(
@@ -735,7 +736,7 @@ function fragmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-QACVPR37.js");
+            const { getSharedTokenRegistry } = await import("./service-JEWWTSKI.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -795,7 +796,7 @@ function fragmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-QACVPR37.js");
+            const { getSharedTokenRegistry } = await import("./service-JEWWTSKI.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -857,7 +858,7 @@ function fragmentsPlugin(options) {
               res.end(JSON.stringify({ error: "Could not resolve fragment file path" }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-QACVPR37.js");
+            const { getSharedTokenRegistry } = await import("./service-JEWWTSKI.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -931,6 +932,22 @@ function fragmentsPlugin(options) {
           }
           return;
         }
+        if (req.url === "/fragments/compiled.json") {
+          try {
+            const { join: join2 } = await import("path");
+            const fragmentsJsonPath = join2(projectRoot, BRAND.outFile);
+            const content = await readFile(fragmentsJsonPath, "utf-8");
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(content);
+          } catch (error) {
+            console.warn(`[${BRAND.name}] Failed to serve compiled.json:`, error);
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({
+              error: `${BRAND.outFile} not found. Run '${BRAND.cliCommand} build' first.`
+            }));
+          }
+          return;
+        }
         if (req.url?.startsWith("/fragments/context")) {
           try {
             const url = new URL(req.url, "http://localhost");
@@ -1056,7 +1073,7 @@ function fragmentsPlugin(options) {
             const {
               getSharedTokenRegistry,
               generateTokenPatches
-            } = await import("./service-QACVPR37.js");
+            } = await import("./service-JEWWTSKI.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -1424,6 +1441,28 @@ async function extractDependenciesFromSource(absolutePath) {
   }
 }
 async function generateFragmentsModule(fragmentFiles, config, previewConfigPath) {
+  const authoredVariantCodeCache = /* @__PURE__ */ new Map();
+  async function loadAuthoredVariantCode(fragmentFilePath) {
+    if (authoredVariantCodeCache.has(fragmentFilePath)) {
+      return authoredVariantCodeCache.get(fragmentFilePath);
+    }
+    try {
+      const source = await readFile(fragmentFilePath, "utf-8");
+      const parsed = parseFragmentFile(source, fragmentFilePath);
+      const variantCodeByName = {};
+      for (const variant of parsed.variants) {
+        if (typeof variant.code !== "string") continue;
+        const normalized = variant.code.trim();
+        if (normalized.length === 0) continue;
+        variantCodeByName[variant.name] = normalized;
+      }
+      authoredVariantCodeCache.set(fragmentFilePath, variantCodeByName);
+      return variantCodeByName;
+    } catch {
+      authoredVariantCodeCache.set(fragmentFilePath, {});
+      return {};
+    }
+  }
   const filesByBasePath = /* @__PURE__ */ new Map();
   for (const file of fragmentFiles) {
     const basePath = getBaseComponentPath(file.relativePath);
@@ -1442,6 +1481,8 @@ async function generateFragmentsModule(fragmentFiles, config, previewConfigPath)
       if (!primaryFile) return null;
       const isStory = !!files.storyFile;
       const metadataPath = files.storyFile && files.fragmentFile ? files.fragmentFile.absolutePath : null;
+      const codeSourceFile = files.fragmentFile && files.fragmentFile.absolutePath ? files.fragmentFile.absolutePath : !isStory ? primaryFile.absolutePath : null;
+      const authoredVariantCode = codeSourceFile ? await loadAuthoredVariantCode(codeSourceFile) : {};
       const componentName = extractComponentName(primaryFile.relativePath);
       const fragmentSource = files.fragmentFile || primaryFile;
       const dependencies = await extractDependenciesFromSource(fragmentSource.absolutePath);
@@ -1451,7 +1492,8 @@ async function generateFragmentsModule(fragmentFiles, config, previewConfigPath)
     componentName: ${JSON.stringify(componentName)},
     dependencies: ${JSON.stringify(dependencies)},
     loader: () => import("${primaryFile.absolutePath}"),
-    metadataLoader: ${metadataPath ? `() => import("${metadataPath}")` : "null"}
+    metadataLoader: ${metadataPath ? `() => import("${metadataPath}")` : "null"},
+    authoredVariantCode: ${JSON.stringify(authoredVariantCode)}
   }`;
     })
   );
@@ -1520,6 +1562,20 @@ function mergeMetadata(fragment, metadataModule) {
   return fragment;
 }
 
+function mergeAuthoredVariantCode(fragment, authoredVariantCode) {
+  if (!fragment?.variants || !authoredVariantCode) return fragment;
+
+  for (const variant of fragment.variants) {
+    if (!variant || variant.code) continue;
+    const code = authoredVariantCode[variant.name];
+    if (typeof code === "string" && code.trim().length > 0) {
+      variant.code = code;
+    }
+  }
+
+  return fragment;
+}
+
 // Load all fragments (for initial render)
 // Gracefully handles individual failures - one bad story won't break all fragments
 export async function loadAllFragments() {
@@ -1557,6 +1613,8 @@ export async function loadAllFragments() {
           }
         }
 
+        fragment = mergeAuthoredVariantCode(fragment, loader.authoredVariantCode);
+
         loadedFragments.set(loader.path, fragment);
         return { path: loader.path, fragment };
       } catch (error) {
@@ -1614,6 +1672,10 @@ export async function loadFragment(path) {
     }
   }
 
+  if (fragment) {
+    fragment = mergeAuthoredVariantCode(fragment, loader.authoredVariantCode);
+  }
+
   if (fragment) {
     loadedFragments.set(path, fragment);
   }
@@ -1995,7 +2057,7 @@ async function loadFullFragmentForCompare(_server, _fragmentFiles, componentName
   }
 }
 async function compareImages(image1Base64, image2Base64, threshold) {
-  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-QACVPR37.js");
+  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-JEWWTSKI.js");
   const { PNG } = await import("pngjs");
   const buffer1 = base64UrlToBuffer(image1Base64);
   const buffer2 = base64UrlToBuffer(image2Base64);
@@ -2098,6 +2160,8 @@ var packagesRoot = resolve2(cliPackageRoot, "..");
 var localUiLibRoot = resolve2(packagesRoot, "../libs/ui/src");
 var localSharedLibRoot = resolve2(packagesRoot, "../libs/shared/src");
 var vendoredSharedLibRoot = resolve2(viewerRoot, "vendor/shared/src");
+var localWebMCPRoot = resolve2(packagesRoot, "webmcp/src");
+var localContextRoot = resolve2(packagesRoot, "context/src");
 function resolveUiLib(nodeModulesDir) {
   const localIndex = join(localUiLibRoot, "index.ts");
   if (existsSync(localIndex)) {
@@ -2113,6 +2177,36 @@ function resolveUiLib(nodeModulesDir) {
   }
   return localUiLibRoot;
 }
+function resolveWebMCPLib(nodeModulesDir) {
+  const localIndex = join(localWebMCPRoot, "index.ts");
+  if (existsSync(localIndex)) {
+    return localWebMCPRoot;
+  }
+  const installedSrc = join(nodeModulesDir, "@fragments-sdk/webmcp/src/index.ts");
+  if (existsSync(installedSrc)) {
+    return resolve2(dirname2(installedSrc));
+  }
+  const installedDist = join(nodeModulesDir, "@fragments-sdk/webmcp");
+  if (existsSync(installedDist)) {
+    return installedDist;
+  }
+  return localWebMCPRoot;
+}
+function resolveContextLib(nodeModulesDir) {
+  const localIndex = join(localContextRoot, "index.ts");
+  if (existsSync(localIndex)) {
+    return localContextRoot;
+  }
+  const installedSrc = join(nodeModulesDir, "@fragments-sdk/context/src/index.ts");
+  if (existsSync(installedSrc)) {
+    return resolve2(dirname2(installedSrc));
+  }
+  const installedDist = join(nodeModulesDir, "@fragments-sdk/context");
+  if (existsSync(installedDist)) {
+    return installedDist;
+  }
+  return localContextRoot;
+}
 function resolveSharedLib() {
   const localIndex = join(localSharedLibRoot, "index.ts");
   if (existsSync(localIndex)) {
@@ -2219,6 +2313,8 @@ async function createDevServer(options = {}) {
   const nodeModulesPath = findNodeModules(projectRoot);
   const uiLibRoot = resolveUiLib(nodeModulesPath);
   const sharedLibRoot = resolveSharedLib();
+  const webmcpLibRoot = resolveWebMCPLib(nodeModulesPath);
+  const contextLibRoot = resolveContextLib(nodeModulesPath);
   console.log(`\u{1F4C1} Using node_modules: ${nodeModulesPath}`);
   const installedPkgRoots = [...new Set(
     installedFiles.map((f) => {
@@ -2234,13 +2330,15 @@ async function createDevServer(options = {}) {
     // Don't load config again
     root: projectRoot,
     // Run from PROJECT root
+    publicDir: resolve2(viewerRoot, "public"),
+    // Serve static assets (favicon) from viewer
     base: "/",
     server: {
       port,
       open: open ? "/fragments/" : false,
       fs: {
         // Allow serving files from viewer package, project, shared libs, and node_modules root
-        allow: [viewerRoot, uiLibRoot, sharedLibRoot, projectRoot, configDir, dirname2(nodeModulesPath), ...installedPkgRoots]
+        allow: [viewerRoot, uiLibRoot, sharedLibRoot, webmcpLibRoot, contextLibRoot, projectRoot, configDir, dirname2(nodeModulesPath), ...installedPkgRoots]
       }
     },
     plugins: [
@@ -2255,8 +2353,13 @@ async function createDevServer(options = {}) {
         projectRoot
       })
     ],
-    // CSS configuration
-    css: {},
+    // CSS configuration — preserve original hyphenated class names in CSS modules
+    // Vite 6 defaults to camelCaseOnly, but our components use styles['gap-sm'] etc.
+    css: {
+      modules: {
+        localsConvention: "camelCase"
+      }
+    },
     optimizeDeps: {
       // Include common dependencies for faster startup
       include: ["react", "react-dom", "react/jsx-runtime", "react/jsx-dev-runtime"]
@@ -2270,6 +2373,14 @@ async function createDevServer(options = {}) {
         "@fragments-sdk/ui": uiLibRoot,
         // Resolve @fragments-sdk/shared to monorepo source or vendored fallback
         "@fragments-sdk/shared": sharedLibRoot,
+        // Resolve @fragments-sdk/webmcp subpaths to monorepo source or installed package
+        "@fragments-sdk/webmcp/react": join(webmcpLibRoot, "react/index.ts"),
+        "@fragments-sdk/webmcp/fragments": join(webmcpLibRoot, "fragments/index.ts"),
+        "@fragments-sdk/webmcp": webmcpLibRoot,
+        // Resolve @fragments-sdk/context subpaths to monorepo source or installed package
+        "@fragments-sdk/context/types": join(contextLibRoot, "types/index.ts"),
+        "@fragments-sdk/context/mcp-tools": join(contextLibRoot, "mcp-tools/index.ts"),
+        "@fragments-sdk/context": contextLibRoot,
         // Resolve @fragments-sdk/cli/core to the CLI's own core source
         "@fragments-sdk/cli/core": resolve2(cliPackageRoot, "src/core/index.ts"),
         // Ensure ALL react imports resolve to project's node_modules
@@ -2339,4 +2450,4 @@ export {
   createDevServer,
   fragmentsPlugin
 };
-//# sourceMappingURL=viewer-CNLZQUFO.js.map
+//# sourceMappingURL=viewer-QKIAPTPG.js.map