@fragments-sdk/cli 0.15.2 → 0.15.4

package/dist/create-LA4J2HHQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/create.ts","../src/theme/serializer.ts","../src/theme/schema.ts","../src/theme/generator.ts"],"sourcesContent":["/**\n * fragments create - Scaffold a new project with Fragments UI and a custom theme\n *\n * Mirrors the shadcn model: configure on the web (usefragments.com/create),\n * then `npx @fragments-sdk/cli create` bootstraps a project with that config.\n */\n\nimport { execSync } from 'node:child_process';\nimport { existsSync, mkdirSync, writeFileSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\nimport pc from 'picocolors';\nimport { BRAND } from '../core/index.js';\nimport { decompressTheme } from '../theme/serializer.js';\nimport { generateCssTokens, generateScssTokens } from '../theme/generator.js';\nimport type { ThemeConfig } from '../theme/types.js';\n\n// ============================================\n// Font Helpers\n// ============================================\n\n/**\n * Extract the primary font family name from a CSS font-stack string.\n * e.g. '\"Space Grotesk\", sans-serif' → 'Space Grotesk'\n */\nfunction extractFontFamily(cssFontStack: string): string | null {\n  const match = cssFontStack.match(/^[\"']?([^\"',]+)[\"']?/);\n  if (!match) return null;\n  const name = match[1].trim();\n  const generics = [\"sans-serif\", \"serif\", \"monospace\", \"cursive\", \"fantasy\", \"system-ui\"];\n  if (generics.includes(name.toLowerCase())) return null;\n  if (name.toLowerCase() === \"inter\") return null; // Inter is the default, no need to load\n  return name;\n}\n\nfunction googleFontsUrl(familyName: string): string {\n  return `https://fonts.googleapis.com/css2?family=${encodeURIComponent(familyName)}:wght@400;500;600;700&display=swap`;\n}\n\n// ============================================\n// Types\n// ============================================\n\nexport interface CreateOptions {\n  name?: string;\n  template?: 'nextjs' | 'vite';\n  packageManager?: 'npm' | 'pnpm' | 'yarn' | 'bun';\n  theme?: string;\n  preset?: string;\n  brand?: string;\n  scss?: boolean;\n  mcp?: boolean;\n  yes?: boolean;\n  noGit?: boolean;\n}\n\nexport interface CreateResult {\n  success: boolean;\n  projectDir?: string;\n  error?: string;\n}\n\n// ============================================\n// Package Manager Detection\n// ============================================\n\nfunction detectPackageManager(): 'npm' | 'pnpm' | 'yarn' | 'bun' {\n  const agent = process.env.npm_config_user_agent || '';\n  if (agent.startsWith('pnpm')) return 'pnpm';\n  if (agent.startsWith('yarn')) return 'yarn';\n  if (agent.startsWith('bun')) return 'bun';\n  return 'npm';\n}\n\nfunction getInstallCommand(pm: string): string {\n  return pm === 'yarn' ? 'yarn add' : `${pm} add`;\n}\n\nfunction getDevInstallCommand(pm: string): string {\n  return pm === 'yarn' ? 'yarn add -D' : `${pm} add -D`;\n}\n\nfunction getRunCommand(pm: string): string {\n  return pm === 'npm' ? 'npm run' : pm;\n}\n\n// ============================================\n// Validation\n// ============================================\n\nfunction isValidProjectName(name: string): boolean {\n  return /^[a-z0-9][a-z0-9._-]*$/.test(name);\n}\n\n// ============================================\n// Theme Resolution\n// ============================================\n\nconst PRESET_API_URL = 'https://canny-otter-874.convex.site/api/theme-presets';\n\nasync function fetchPreset(presetId: string): Promise<ThemeConfig | null> {\n  try {\n    const res = await fetch(`${PRESET_API_URL}?id=${encodeURIComponent(presetId)}`);\n    if (!res.ok) return null;\n    const theme = await res.json();\n    if (!theme || !theme.name) return null;\n    return theme as ThemeConfig;\n  } catch {\n    return null;\n  }\n}\n\nasync function resolveTheme(options: CreateOptions): Promise<ThemeConfig | null> {\n  if (options.preset) {\n    console.log(pc.dim(`  Fetching theme preset ${options.preset}...`));\n    const theme = await fetchPreset(options.preset);\n    if (!theme) {\n      console.error(pc.red(`Error: Could not fetch preset \"${options.preset}\". It may have expired or the ID is invalid.`));\n      return null;\n    }\n    return theme;\n  }\n\n  if (options.theme) {\n    const decoded = decompressTheme(options.theme);\n    if (!decoded) {\n      console.error(pc.red('Error: Could not decode theme string. Make sure you copied it from usefragments.com/create'));\n      return null;\n    }\n    return decoded;\n  }\n\n  if (options.brand) {\n    return {\n      name: 'custom',\n      colors: {\n        accent: options.brand,\n      },\n    };\n  }\n\n  return {\n    name: 'default',\n    colors: {\n      accent: '#6366f1',\n    },\n  };\n}\n\n// ============================================\n// Templates\n// ============================================\n\nexport function generateNextjsLayout(themePath: string, theme?: ThemeConfig): string {\n  const fontName = theme?.typography?.fontSans ? extractFontFamily(theme.typography.fontSans) : null;\n  const fontUrl = fontName ? googleFontsUrl(fontName) : null;\n\n  const htmlOpen = fontUrl\n    ? `    <html lang=\"en\" suppressHydrationWarning>\n      <head>\n        <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n        <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossOrigin=\"\" />\n        <link href=\"${fontUrl}\" rel=\"stylesheet\" />\n      </head>\n      <body>`\n    : `    <html lang=\"en\" suppressHydrationWarning>\n      <body>`;\n\n  return `import type { Metadata } from 'next';\nimport '@fragments-sdk/ui/styles';\nimport '${themePath}';\nimport { Providers } from './providers';\n\nexport const metadata: Metadata = {\n  title: 'My App',\n  description: 'Built with Fragments UI',\n};\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n${htmlOpen}\n        <Providers>{children}</Providers>\n      </body>\n    </html>\n  );\n}\n`;\n}\n\nexport function generateNextjsProviders(): string {\n  return `'use client';\n\nimport type { ReactNode } from 'react';\nimport { ThemeProvider, TooltipProvider, ToastProvider } from '@fragments-sdk/ui';\n\nexport function Providers({ children }: { children: ReactNode }) {\n  return (\n    <ThemeProvider defaultMode=\"system\">\n      <TooltipProvider>\n        <ToastProvider>{children}</ToastProvider>\n      </TooltipProvider>\n    </ThemeProvider>\n  );\n}\n`;\n}\n\nexport function generateNextjsPage(): string {\n  return `'use client';\n\nimport { useState } from 'react';\nimport {\n  Avatar,\n  Badge,\n  Button,\n  Card,\n  Checkbox,\n  Input,\n  Progress,\n  Separator,\n  Stack,\n  Switch,\n  Tabs,\n  Text,\n  Tooltip,\n} from '@fragments-sdk/ui';\nimport styles from './page.module.css';\n\nfunction StatCard({ label, value, change }: { label: string; value: string; change: string }) {\n  const isPositive = change.startsWith('+');\n  return (\n    <Card>\n      <Card.Body>\n        <Stack gap=\"xs\">\n          <Text size=\"sm\" color=\"secondary\">{label}</Text>\n          <Text size=\"2xl\" weight=\"semibold\">{value}</Text>\n          <Badge variant={isPositive ? 'success' : 'error'} size=\"sm\">{change}</Badge>\n        </Stack>\n      </Card.Body>\n    </Card>\n  );\n}\n\nfunction TaskItem({ title, done }: { title: string; done?: boolean }) {\n  const [checked, setChecked] = useState(done ?? false);\n  return (\n    <Stack direction=\"row\" align=\"center\" gap=\"sm\">\n      <Checkbox checked={checked} onChange={() => setChecked(!checked)} />\n      <Text size=\"sm\" className={checked ? styles.done : undefined}>{title}</Text>\n    </Stack>\n  );\n}\n\nexport default function Home() {\n  const [notifications, setNotifications] = useState(true);\n\n  return (\n    <main className={styles.page}>\n      {/* Hero */}\n      <Stack align=\"center\" gap=\"md\" className={styles.hero}>\n        <Badge variant=\"info\">Powered by Fragments UI</Badge>\n        <Text as=\"h1\" size=\"2xl\" weight=\"bold\">Your app is ready</Text>\n        <Text size=\"lg\" color=\"secondary\" className={styles.heroDescription}>\n          This page showcases your custom theme and components.\n          Edit <code>src/app/page.tsx</code> to start building.\n        </Text>\n        <Stack direction=\"row\" gap=\"sm\">\n          <Button size=\"lg\">Start building</Button>\n          <Button size=\"lg\" variant=\"secondary\">Read the docs</Button>\n        </Stack>\n      </Stack>\n\n      <Separator />\n\n      {/* Stats */}\n      <div className={styles.statsGrid}>\n        <StatCard label=\"Components\" value=\"66\" change=\"+12 this month\" />\n        <StatCard label=\"Design tokens\" value=\"80\" change=\"+5 new\" />\n        <StatCard label=\"Accessibility\" value=\"98%\" change=\"+2.4%\" />\n      </div>\n\n      {/* Content */}\n      <div className={styles.contentGrid}>\n        <Card>\n          <Card.Header>\n            <Card.Title>Getting started</Card.Title>\n            <Card.Description>Pick up where you left off</Card.Description>\n          </Card.Header>\n          <Card.Body>\n            <Tabs defaultValue=\"tasks\">\n              <Tabs.List>\n                <Tabs.Tab value=\"tasks\">Tasks</Tabs.Tab>\n                <Tabs.Tab value=\"progress\">Progress</Tabs.Tab>\n              </Tabs.List>\n              <Tabs.Panel value=\"tasks\">\n                <Stack gap=\"sm\" className={styles.tabContent}>\n                  <TaskItem title=\"Install Fragments UI\" done />\n                  <TaskItem title=\"Configure your theme\" done />\n                  <TaskItem title=\"Build your first page\" />\n                  <TaskItem title=\"Set up MCP for AI tooling\" />\n                  <TaskItem title=\"Deploy to production\" />\n                </Stack>\n              </Tabs.Panel>\n              <Tabs.Panel value=\"progress\">\n                <Stack gap=\"md\" className={styles.tabContent}>\n                  <Stack gap=\"xs\">\n                    <Stack direction=\"row\" justify=\"between\">\n                      <Text size=\"sm\">Setup</Text>\n                      <Text size=\"sm\" color=\"secondary\">2 of 5</Text>\n                    </Stack>\n                    <Progress value={40} />\n                  </Stack>\n                  <Text size=\"sm\" color=\"secondary\">\n                    Complete the remaining tasks to finish setting up your project.\n                  </Text>\n                </Stack>\n              </Tabs.Panel>\n            </Tabs>\n          </Card.Body>\n        </Card>\n\n        <Card>\n          <Card.Header>\n            <Card.Title>Settings</Card.Title>\n            <Card.Description>Manage your preferences</Card.Description>\n          </Card.Header>\n          <Card.Body>\n            <Stack gap=\"md\">\n              <Input placeholder=\"Search settings...\" />\n              <Stack direction=\"row\" align=\"center\" justify=\"between\">\n                <Stack gap=\"xs\">\n                  <Text size=\"sm\" weight=\"medium\">Notifications</Text>\n                  <Text size=\"xs\" color=\"secondary\">Receive alerts for updates</Text>\n                </Stack>\n                <Switch checked={notifications} onChange={() => setNotifications(!notifications)} />\n              </Stack>\n              <Separator />\n              <Stack direction=\"row\" align=\"center\" justify=\"between\">\n                <Stack gap=\"xs\">\n                  <Text size=\"sm\" weight=\"medium\">Theme</Text>\n                  <Text size=\"xs\" color=\"secondary\">System preference detected</Text>\n                </Stack>\n                <Badge variant=\"default\" size=\"sm\">Auto</Badge>\n              </Stack>\n              <Separator />\n              <Stack direction=\"row\" gap=\"sm\" align=\"center\">\n                <Avatar name=\"You\" size=\"sm\" />\n                <Stack gap=\"xs\" className={styles.flex1}>\n                  <Text size=\"sm\" weight=\"medium\">Your account</Text>\n                  <Text size=\"xs\" color=\"secondary\">Manage profile and billing</Text>\n                </Stack>\n                <Tooltip content=\"Go to account settings\">\n                  <Button variant=\"ghost\" size=\"sm\">Manage</Button>\n                </Tooltip>\n              </Stack>\n            </Stack>\n          </Card.Body>\n        </Card>\n      </div>\n\n      {/* Footer */}\n      <Text size=\"sm\" color=\"secondary\" className={styles.footer}>\n        Built with{' '}\n        <a href=\"https://usefragments.com\" className={styles.link}>Fragments UI</a>\n        {' '}&mdash; 66 components, 80 design tokens, accessible by default.\n      </Text>\n    </main>\n  );\n}\n`;\n}\n\nexport function generatePageCssModule(): string {\n  return `.page {\n  min-height: 100vh;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  padding: var(--fui-space-6, 3rem) var(--fui-space-3, 1.5rem);\n  gap: var(--fui-space-4, 2rem);\n  max-width: 960px;\n  margin: 0 auto;\n}\n\n.hero {\n  text-align: center;\n  padding-top: var(--fui-space-4, 2rem);\n  padding-bottom: var(--fui-space-2, 1rem);\n}\n\n.heroDescription {\n  max-width: 480px;\n}\n\n.heroDescription code {\n  font-size: 0.875em;\n  font-family: var(--fui-font-mono, monospace);\n  background: var(--fui-bg-secondary);\n  padding: 0.125em 0.375em;\n  border-radius: var(--fui-radius-sm, 0.25rem);\n}\n\n.statsGrid {\n  display: grid;\n  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));\n  gap: var(--fui-space-2, 1rem);\n  width: 100%;\n}\n\n.contentGrid {\n  display: grid;\n  grid-template-columns: 1fr 1fr;\n  gap: var(--fui-space-3, 1.5rem);\n  width: 100%;\n}\n\n@media (max-width: 768px) {\n  .contentGrid {\n    grid-template-columns: 1fr;\n  }\n}\n\n.tabContent {\n  padding-top: var(--fui-space-1, 0.75rem);\n}\n\n.done {\n  text-decoration: line-through;\n  opacity: 0.5;\n}\n\n.flex1 {\n  flex: 1;\n}\n\n.footer {\n  padding-top: var(--fui-space-2, 1rem);\n}\n\n.link {\n  color: inherit;\n  text-decoration: underline;\n}\n\n.link:hover {\n  color: var(--fui-color-accent);\n}\n`;\n}\n\nfunction generateViteMain(themePath: string): string {\n  return `import { StrictMode } from 'react';\nimport { createRoot } from 'react-dom/client';\nimport { ThemeProvider, TooltipProvider, ToastProvider } from '@fragments-sdk/ui';\nimport '@fragments-sdk/ui/styles';\nimport '${themePath}';\nimport App from './App';\n\ncreateRoot(document.getElementById('root')!).render(\n  <StrictMode>\n    <ThemeProvider defaultMode=\"system\">\n      <TooltipProvider>\n        <ToastProvider>\n          <App />\n        </ToastProvider>\n      </TooltipProvider>\n    </ThemeProvider>\n  </StrictMode>,\n);\n`;\n}\n\nfunction generateViteApp(): string {\n  // Same content as Next.js page but with App.module.css import\n  return generateNextjsPage()\n    .replace(\"'use client';\\n\\n\", '')\n    .replace(\"import styles from './page.module.css';\", \"import styles from './App.module.css';\")\n    .replace('src/app/page.tsx', 'src/App.tsx')\n    .replace('export default function Home()', 'function App()')\n    + '\\nexport default App;\\n';\n}\n\nfunction injectFontIntoViteHtml(projectDir: string, theme: ThemeConfig): void {\n  const fontName = theme.typography?.fontSans ? extractFontFamily(theme.typography.fontSans) : null;\n  if (!fontName) return;\n\n  const indexPath = join(projectDir, \"index.html\");\n  if (!existsSync(indexPath)) return;\n\n  let html = readFileSync(indexPath, \"utf-8\");\n  const fontLinks = [\n    '    <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />',\n    '    <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />',\n    `    <link href=\"${googleFontsUrl(fontName)}\" rel=\"stylesheet\" />`,\n  ].join(\"\\n\");\n  html = html.replace(\"</head>\", `${fontLinks}\\n  </head>`);\n  writeFileSync(indexPath, html, \"utf-8\");\n}\n\n// ============================================\n// Scaffolding\n// ============================================\n\nasync function promptIfMissing(options: CreateOptions): Promise<CreateOptions> {\n  const resolved = { ...options };\n\n  if (!resolved.name) {\n    if (resolved.yes) {\n      resolved.name = 'my-app';\n    } else {\n      try {\n        const { input } = await import('@inquirer/prompts');\n        resolved.name = await input({\n          message: 'Project name:',\n          default: 'my-app',\n          validate: (val) => isValidProjectName(val) || 'Use lowercase letters, numbers, hyphens, dots, underscores',\n        });\n      } catch {\n        resolved.name = 'my-app';\n      }\n    }\n  }\n\n  if (!resolved.template && !resolved.yes) {\n    try {\n      const { select } = await import('@inquirer/prompts');\n      resolved.template = await select({\n        message: 'Framework:',\n        choices: [\n          { name: 'Next.js (App Router)', value: 'nextjs' as const },\n          { name: 'Vite + React', value: 'vite' as const },\n        ],\n        default: 'nextjs',\n      });\n    } catch {\n      resolved.template = 'nextjs';\n    }\n  }\n\n  resolved.template = resolved.template || 'nextjs';\n  resolved.packageManager = resolved.packageManager || detectPackageManager();\n\n  return resolved;\n}\n\nfunction scaffoldFramework(name: string, template: string, pm: string): void {\n  console.log(pc.cyan(`\\nScaffolding ${template === 'nextjs' ? 'Next.js' : 'Vite + React'} project...\\n`));\n\n  if (template === 'nextjs') {\n    const cmd = `npx create-next-app@latest ${name} --ts --app --src-dir --no-tailwind --no-eslint --import-alias \"@/*\" --yes`;\n    execSync(cmd, { stdio: 'inherit' });\n  } else {\n    // Vite\n    if (pm === 'bun') {\n      execSync(`bun create vite ${name} --template react-ts`, { stdio: 'inherit' });\n    } else {\n      execSync(`npm create vite@latest ${name} -- --template react-ts`, { stdio: 'inherit' });\n    }\n  }\n}\n\nfunction installDeps(projectDir: string, pm: string): void {\n  console.log(pc.cyan('\\nInstalling Fragments UI...\\n'));\n\n  const install = getInstallCommand(pm);\n  const devInstall = getDevInstallCommand(pm);\n  // sass is required — without it, @fragments-sdk/ui/styles resolves to the\n  // compiled CSS which is missing the :root token definitions and body resets.\n  // The SCSS entry (used when sass is present) includes the full token layer.\n  execSync(`${install} @fragments-sdk/ui`, { cwd: projectDir, stdio: 'inherit' });\n  execSync(`${devInstall} sass`, { cwd: projectDir, stdio: 'inherit' });\n}\n\nfunction writeThemeFile(projectDir: string, theme: ThemeConfig, template: string): string {\n  const stylesDir = join(projectDir, 'src', 'styles');\n  mkdirSync(stylesDir, { recursive: true });\n\n  // Always generate SCSS so we can @use the globals (which includes :root tokens,\n  // body resets, dark mode, and the full design system foundation).\n  // We also need the component CSS (dist/assets/ui.css) which is separate from\n  // the token globals — the `sass` export resolves to globals.scss only.\n  const cssContent = generateCssTokens(theme);\n  const content = `// Fragments UI — tokens, resets, dark mode\n@use '@fragments-sdk/ui/styles';\n\n// Theme overrides (generated from your preset)\n${cssContent}`;\n\n  const filePath = join(stylesDir, 'theme.scss');\n  writeFileSync(filePath, content, 'utf-8');\n\n  if (template === 'nextjs') {\n    return '../styles/theme.scss';\n  }\n  return './styles/theme.scss';\n}\n\nexport function addNextTranspilePackages(projectDir: string): void {\n  const configCandidates = ['next.config.ts', 'next.config.mjs', 'next.config.js'];\n\n  for (const configFile of configCandidates) {\n    const fullPath = join(projectDir, configFile);\n    if (!existsSync(fullPath)) continue;\n\n    const content = readFileSync(fullPath, 'utf-8');\n\n    if (content.includes('transpilePackages') && content.includes('@fragments-sdk/ui')) {\n      return;\n    }\n\n    if (content.includes('transpilePackages')) {\n      return;\n    }\n\n    const patterns = [\n      {\n        search: /const\\s+\\w+\\s*(?::\\s*\\w+)?\\s*=\\s*\\{/,\n        replacement: (match: string) => `${match}\\n  transpilePackages: ['@fragments-sdk/ui'],`,\n      },\n      {\n        search: /module\\.exports\\s*=\\s*\\{/,\n        replacement: (match: string) => `${match}\\n  transpilePackages: ['@fragments-sdk/ui'],`,\n      },\n      {\n        search: /export\\s+default\\s*\\{/,\n        replacement: (match: string) => `${match}\\n  transpilePackages: ['@fragments-sdk/ui'],`,\n      },\n    ];\n\n    for (const pattern of patterns) {\n      if (!pattern.search.test(content)) continue;\n\n      writeFileSync(\n        fullPath,\n        content.replace(pattern.search, pattern.replacement),\n        'utf-8',\n      );\n      return;\n    }\n\n    return;\n  }\n}\n\nfunction rewriteAppFiles(projectDir: string, template: string, themePath: string, theme: ThemeConfig): void {\n  if (template === 'nextjs') {\n    // Rewrite layout.tsx\n    const layoutPath = join(projectDir, 'src', 'app', 'layout.tsx');\n    writeFileSync(layoutPath, generateNextjsLayout(themePath, theme), 'utf-8');\n\n    const providersPath = join(projectDir, 'src', 'app', 'providers.tsx');\n    writeFileSync(providersPath, generateNextjsProviders(), 'utf-8');\n\n    // Rewrite page.tsx + CSS module\n    const pagePath = join(projectDir, 'src', 'app', 'page.tsx');\n    writeFileSync(pagePath, generateNextjsPage(), 'utf-8');\n\n    const pageCssPath = join(projectDir, 'src', 'app', 'page.module.css');\n    writeFileSync(pageCssPath, generatePageCssModule(), 'utf-8');\n\n    // Remove globals.css if it exists (we use our own theme)\n    const globalsCssPath = join(projectDir, 'src', 'app', 'globals.css');\n    try {\n      unlinkSync(globalsCssPath);\n    } catch { /* doesn't exist */ }\n\n    addNextTranspilePackages(projectDir);\n  } else {\n    // Vite: rewrite main.tsx and App.tsx\n    const mainPath = join(projectDir, 'src', 'main.tsx');\n    writeFileSync(mainPath, generateViteMain(themePath), 'utf-8');\n\n    const appPath = join(projectDir, 'src', 'App.tsx');\n    writeFileSync(appPath, generateViteApp(), 'utf-8');\n\n    const appCssModulePath = join(projectDir, 'src', 'App.module.css');\n    writeFileSync(appCssModulePath, generatePageCssModule(), 'utf-8');\n\n    // Clean up default Vite files\n    for (const file of ['src/App.css', 'src/index.css']) {\n      try {\n        unlinkSync(join(projectDir, file));\n      } catch { /* doesn't exist */ }\n    }\n\n    injectFontIntoViteHtml(projectDir, theme);\n  }\n}\n\nfunction initGit(projectDir: string): void {\n  try {\n    // create-next-app already inits git, so check first\n    if (!existsSync(join(projectDir, '.git'))) {\n      execSync('git init', { cwd: projectDir, stdio: 'ignore' });\n      execSync('git add -A', { cwd: projectDir, stdio: 'ignore' });\n      execSync('git commit -m \"Initial commit with Fragments UI\"', { cwd: projectDir, stdio: 'ignore' });\n    }\n  } catch {\n    // Git not available — skip silently\n  }\n}\n\nfunction configureMcp(projectDir: string): void {\n  const mcpConfig = {\n    mcpServers: {\n      fragments: {\n        command: 'npx',\n        args: ['-y', '@fragments-sdk/cli', 'mcp'],\n      },\n    },\n  };\n\n  const mcpDir = join(projectDir, '.mcp');\n  mkdirSync(mcpDir, { recursive: true });\n  writeFileSync(join(mcpDir, 'config.json'), JSON.stringify(mcpConfig, null, 2), 'utf-8');\n}\n\n// ============================================\n// Main\n// ============================================\n\nexport async function create(options: CreateOptions): Promise<CreateResult> {\n  console.log(pc.cyan(`\\n${BRAND.name} Create\\n`));\n\n  // 1. Gather inputs\n  const resolved = await promptIfMissing(options);\n  const name = resolved.name!;\n  const template = resolved.template!;\n  const pm = resolved.packageManager!;\n\n  // 2. Validate\n  if (!isValidProjectName(name)) {\n    return { success: false, error: `Invalid project name: ${name}. Use lowercase letters, numbers, hyphens, dots, underscores.` };\n  }\n\n  const projectDir = resolve(process.cwd(), name);\n  if (existsSync(projectDir)) {\n    return { success: false, error: `Directory \"${name}\" already exists.` };\n  }\n\n  // 3. Resolve theme\n  const theme = await resolveTheme(resolved);\n  if (!theme) {\n    return { success: false, error: 'Invalid theme configuration.' };\n  }\n\n  // 4. Scaffold framework\n  scaffoldFramework(name, template, pm);\n\n  if (!existsSync(projectDir)) {\n    return { success: false, error: 'Framework scaffolding failed — project directory was not created.' };\n  }\n\n  // 5. Install deps\n  installDeps(projectDir, pm);\n\n  // 6. Write theme tokens\n  const themePath = writeThemeFile(projectDir, theme, template);\n\n  // 7. Rewrite app files with providers + theme import\n  rewriteAppFiles(projectDir, template, themePath, theme);\n\n  // 8. MCP config\n  if (resolved.mcp) {\n    configureMcp(projectDir);\n    console.log(pc.dim('  Configured MCP server for AI tooling'));\n  }\n\n  // 9. Git init\n  if (!resolved.noGit) {\n    initGit(projectDir);\n  }\n\n  // 10. Success message\n  const run = getRunCommand(pm);\n  console.log('');\n  console.log(pc.green('  Project created successfully!'));\n  console.log('');\n  console.log(`  ${pc.cyan('cd')} ${name}`);\n  console.log(`  ${pc.cyan(run)} dev`);\n  console.log('');\n\n  if (theme.name !== 'default') {\n    console.log(pc.dim(`  Theme \"${theme.name}\" applied with full token set.`));\n    console.log(pc.dim(`  Edit src/styles/theme.scss to customize.\\n`));\n  }\n\n  return { success: true, projectDir };\n}\n","/**\n * Theme Serialization\n *\n * Encodes/decodes theme configurations to/from URL-safe strings\n * using zlib compression and base64url encoding.\n */\n\nimport { deflateSync, inflateSync } from \"node:zlib\";\nimport { validateThemeConfig } from \"./schema.js\";\nimport type { ThemeConfig } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://usefragments.com/create\";\n\n/**\n * Convert a Buffer to base64url encoding (URL-safe base64)\n */\nfunction toBase64Url(buffer: Buffer): string {\n  return buffer\n    .toString(\"base64\")\n    .replace(/\\+/g, \"-\")\n    .replace(/\\//g, \"_\")\n    .replace(/=/g, \"\");\n}\n\n/**\n * Convert a base64url string to Buffer\n */\nfunction fromBase64Url(str: string): Buffer {\n  // Restore standard base64 characters\n  let base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\");\n\n  // Add padding if needed\n  const pad = base64.length % 4;\n  if (pad) {\n    base64 += \"=\".repeat(4 - pad);\n  }\n\n  return Buffer.from(base64, \"base64\");\n}\n\n/**\n * Compress a theme configuration to a URL-safe string\n *\n * Process: JSON → deflate → base64url\n *\n * @param config - Theme configuration to compress\n * @returns URL-safe encoded string\n */\nexport function compressTheme(config: ThemeConfig): string {\n  const json = JSON.stringify(config);\n  const compressed = deflateSync(Buffer.from(json, \"utf-8\"), { level: 9 });\n  return toBase64Url(compressed);\n}\n\n/**\n * Decompress a URL-safe string back to theme configuration\n *\n * Process: base64url → inflate → JSON\n *\n * @param encoded - URL-safe encoded string\n * @returns Theme configuration or null if invalid\n */\nexport function decompressTheme(encoded: string): ThemeConfig | null {\n  // Try zlib-compressed first (CLI native encoding)\n  try {\n    const buffer = fromBase64Url(encoded);\n    const decompressed = inflateSync(buffer);\n    const json = decompressed.toString(\"utf-8\");\n    const parsed = JSON.parse(json);\n    const result = validateThemeConfig(parsed);\n    if (result.success) return result.data;\n  } catch { /* not zlib-compressed */ }\n\n  // Fall back to plain base64url JSON (browser/docs encoding)\n  try {\n    const buffer = fromBase64Url(encoded);\n    const json = buffer.toString(\"utf-8\");\n    const parsed = JSON.parse(json);\n    const result = validateThemeConfig(parsed);\n    if (result.success) return result.data;\n  } catch { /* invalid */ }\n\n  return null;\n}\n\n/**\n * Encode a theme configuration to a full URL with ?preset= parameter\n *\n * @param config - Theme configuration to encode\n * @param baseUrl - Base URL (default: https://fragments.dev/init)\n * @returns Full URL with encoded theme as preset parameter\n */\nexport function encodeThemeToUrl(\n  config: ThemeConfig,\n  baseUrl: string = DEFAULT_BASE_URL\n): string {\n  const encoded = compressTheme(config);\n  const url = new URL(baseUrl);\n  url.searchParams.set(\"preset\", encoded);\n  return url.toString();\n}\n\n/**\n * Decode a theme from a URL or raw encoded string\n *\n * Handles:\n * - Full URLs with ?preset= parameter\n * - Raw encoded strings (compressed theme data)\n *\n * @param input - URL or encoded string\n * @returns Theme configuration or null if invalid\n */\nexport function decodeThemeFromUrl(input: string): ThemeConfig | null {\n  // Try to parse as URL first\n  try {\n    const url = new URL(input);\n    const preset = url.searchParams.get(\"preset\");\n    if (preset) {\n      return decompressTheme(preset);\n    }\n    // URL parsed but no preset param\n    return null;\n  } catch {\n    // Not a valid URL, try as raw encoded string\n    return decompressTheme(input);\n  }\n}\n","/**\n * Theme Configuration Zod Schemas\n *\n * Provides validation for theme configuration objects\n */\n\nimport { z } from \"zod\";\nimport type { ThemeConfig } from \"./types.js\";\n\n/**\n * Regex patterns for color validation\n */\nconst HEX_COLOR_REGEX = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;\nconst RGB_COLOR_REGEX = /^rgba?\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*,\\s*\\d{1,3}\\s*(,\\s*(0|1|0?\\.\\d+))?\\s*\\)$/;\nconst HSL_COLOR_REGEX = /^hsla?\\(\\s*\\d{1,3}\\s*,\\s*\\d{1,3}%\\s*,\\s*\\d{1,3}%\\s*(,\\s*(0|1|0?\\.\\d+))?\\s*\\)$/;\n\n/**\n * CSS color string validator\n */\nconst colorSchema = z.string().refine(\n  (val) => {\n    return (\n      HEX_COLOR_REGEX.test(val) ||\n      RGB_COLOR_REGEX.test(val) ||\n      HSL_COLOR_REGEX.test(val)\n    );\n  },\n  { message: \"Invalid color format. Use hex (#rrggbb), rgb(), rgba(), hsl(), or hsla()\" }\n);\n\n/**\n * CSS size value validator (px, rem, em, etc.)\n */\nconst sizeSchema = z.string().refine(\n  (val) => {\n    // Match number followed by unit, or just a number (for unitless values like 9999px)\n    return /^-?\\d*\\.?\\d+(px|rem|em|%|vw|vh)?$/.test(val);\n  },\n  { message: \"Invalid size format. Use px, rem, em, %, vw, or vh\" }\n);\n\n/**\n * Shadow value validator (more permissive for complex shadow syntax)\n */\nconst shadowSchema = z.string();\n\n/**\n * Font stack validator\n */\nconst fontStackSchema = z.string();\n\n/**\n * Font weight validator (100-900 in increments of 100)\n */\nconst fontWeightSchema = z.number().int().min(100).max(900);\n\n/**\n * Theme colors schema\n */\nexport const themeColorsSchema = z.object({\n  accent: colorSchema.optional(),\n  accentHover: colorSchema.optional(),\n  accentActive: colorSchema.optional(),\n  danger: colorSchema.optional(),\n  dangerHover: colorSchema.optional(),\n  success: colorSchema.optional(),\n  warning: colorSchema.optional(),\n  info: colorSchema.optional(),\n  dangerBg: colorSchema.optional(),\n  successBg: colorSchema.optional(),\n  warningBg: colorSchema.optional(),\n  infoBg: colorSchema.optional(),\n}).strict();\n\n/**\n * Theme surfaces schema\n */\nexport const themeSurfacesSchema = z.object({\n  bgPrimary: colorSchema.optional(),\n  bgSecondary: colorSchema.optional(),\n  bgTertiary: colorSchema.optional(),\n  bgElevated: colorSchema.optional(),\n  bgHover: colorSchema.optional(),\n  bgActive: colorSchema.optional(),\n}).strict();\n\n/**\n * Theme text schema\n */\nexport const themeTextSchema = z.object({\n  primary: colorSchema.optional(),\n  secondary: colorSchema.optional(),\n  tertiary: colorSchema.optional(),\n  inverse: colorSchema.optional(),\n}).strict();\n\n/**\n * Theme borders schema\n */\nexport const themeBordersSchema = z.object({\n  default: colorSchema.optional(),\n  strong: colorSchema.optional(),\n}).strict();\n\n/**\n * Theme typography schema\n */\nexport const themeTypographySchema = z.object({\n  fontSans: fontStackSchema.optional(),\n  fontMono: fontStackSchema.optional(),\n  fontWeightNormal: fontWeightSchema.optional(),\n  fontWeightMedium: fontWeightSchema.optional(),\n  fontWeightSemibold: fontWeightSchema.optional(),\n}).strict();\n\n/**\n * Theme radius schema\n */\nexport const themeRadiusSchema = z.object({\n  sm: sizeSchema.optional(),\n  md: sizeSchema.optional(),\n  lg: sizeSchema.optional(),\n  full: sizeSchema.optional(),\n}).strict();\n\n/**\n * Theme shadows schema\n */\nexport const themeShadowsSchema = z.object({\n  sm: shadowSchema.optional(),\n  md: shadowSchema.optional(),\n}).strict();\n\n/**\n * Theme dark mode schema\n */\nexport const themeDarkModeSchema = z.object({\n  surfaces: themeSurfacesSchema.optional(),\n  text: themeTextSchema.optional(),\n  borders: themeBordersSchema.optional(),\n  shadows: themeShadowsSchema.optional(),\n  accent: colorSchema.optional(),\n  accentHover: colorSchema.optional(),\n  accentActive: colorSchema.optional(),\n  dangerBg: colorSchema.optional(),\n  successBg: colorSchema.optional(),\n  warningBg: colorSchema.optional(),\n  infoBg: colorSchema.optional(),\n  backdrop: colorSchema.optional(),\n  dangerText: colorSchema.optional(),\n  successText: colorSchema.optional(),\n  warningText: colorSchema.optional(),\n  infoText: colorSchema.optional(),\n}).strict();\n\n/**\n * Complete theme configuration schema\n */\nexport const themeConfigSchema = z.object({\n  name: z.string().min(1, \"Theme name is required\"),\n  version: z.string().optional(),\n  extends: z.string().optional(),\n  colors: themeColorsSchema.optional(),\n  surfaces: themeSurfacesSchema.optional(),\n  text: themeTextSchema.optional(),\n  borders: themeBordersSchema.optional(),\n  typography: themeTypographySchema.optional(),\n  radius: themeRadiusSchema.optional(),\n  shadows: themeShadowsSchema.optional(),\n  dark: themeDarkModeSchema.optional(),\n  density: z.enum(['compact', 'default', 'relaxed']).optional(),\n}).strict();\n\n/**\n * Type for the inferred schema\n */\nexport type ThemeConfigInput = z.input<typeof themeConfigSchema>;\nexport type ThemeConfigOutput = z.output<typeof themeConfigSchema>;\n\n/**\n * Validation result type\n */\nexport type ThemeValidationResult =\n  | { success: true; data: ThemeConfig }\n  | { success: false; error: z.ZodError };\n\n/**\n * Validate a theme configuration object\n *\n * @param config - The theme configuration to validate\n * @returns Validation result with either the parsed data or error details\n */\nexport function validateThemeConfig(config: unknown): ThemeValidationResult {\n  const result = themeConfigSchema.safeParse(config);\n\n  if (result.success) {\n    return { success: true, data: result.data as ThemeConfig };\n  }\n\n  return { success: false, error: result.error };\n}\n","/**\n * Theme Token Generator\n *\n * Generates SCSS and CSS token files from theme configurations\n */\n\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type {\n  ThemeConfig,\n  TokenGeneratorOptions,\n  TokenGeneratorResult,\n  ContrastPair,\n  ContrastWarning,\n  ContrastValidationResult,\n} from \"./types.js\";\nimport {\n  parseColor,\n  contrastRatio,\n  meetsAA as checkAA,\n  meetsAAA as checkAAA,\n} from \"./contrast.js\";\n\nconst DEFAULT_FILE_PREFIX = \"_theme-tokens\";\n\n/**\n * Token mapping from ThemeConfig structure to SCSS variable names\n */\nconst TOKEN_MAPPINGS = {\n  colors: {\n    accent: \"fui-color-accent\",\n    accentHover: \"fui-color-accent-hover\",\n    accentActive: \"fui-color-accent-active\",\n    danger: \"fui-color-danger\",\n    dangerHover: \"fui-color-danger-hover\",\n    success: \"fui-color-success\",\n    warning: \"fui-color-warning\",\n    info: \"fui-color-info\",\n    dangerBg: \"fui-color-danger-bg\",\n    successBg: \"fui-color-success-bg\",\n    warningBg: \"fui-color-warning-bg\",\n    infoBg: \"fui-color-info-bg\",\n    dangerText: \"fui-color-danger-text\",\n    successText: \"fui-color-success-text\",\n    warningText: \"fui-color-warning-text\",\n    infoText: \"fui-color-info-text\",\n  },\n  surfaces: {\n    bgPrimary: \"fui-bg-primary\",\n    bgSecondary: \"fui-bg-secondary\",\n    bgTertiary: \"fui-bg-tertiary\",\n    bgElevated: \"fui-bg-elevated\",\n    bgHover: \"fui-bg-hover\",\n    bgActive: \"fui-bg-active\",\n  },\n  text: {\n    primary: \"fui-text-primary\",\n    secondary: \"fui-text-secondary\",\n    tertiary: \"fui-text-tertiary\",\n    inverse: \"fui-text-inverse\",\n  },\n  borders: {\n    default: \"fui-border\",\n    strong: \"fui-border-strong\",\n  },\n  typography: {\n    fontSans: \"fui-font-sans\",\n    fontMono: \"fui-font-mono\",\n    fontWeightNormal: \"fui-font-weight-normal\",\n    fontWeightMedium: \"fui-font-weight-medium\",\n    fontWeightSemibold: \"fui-font-weight-semibold\",\n  },\n  radius: {\n    sm: \"fui-radius-sm\",\n    md: \"fui-radius-md\",\n    lg: \"fui-radius-lg\",\n    full: \"fui-radius-full\",\n  },\n  shadows: {\n    sm: \"fui-shadow-sm\",\n    md: \"fui-shadow-md\",\n  },\n} as const;\n\n/**\n * Dark mode token mappings\n */\nconst DARK_TOKEN_MAPPINGS = {\n  surfaces: {\n    bgPrimary: \"fui-dark-bg-primary\",\n    bgSecondary: \"fui-dark-bg-secondary\",\n    bgTertiary: \"fui-dark-bg-tertiary\",\n    bgElevated: \"fui-dark-bg-elevated\",\n    bgHover: \"fui-dark-bg-hover\",\n    bgActive: \"fui-dark-bg-active\",\n  },\n  text: {\n    primary: \"fui-dark-text-primary\",\n    secondary: \"fui-dark-text-secondary\",\n    tertiary: \"fui-dark-text-tertiary\",\n    inverse: \"fui-dark-text-inverse\",\n  },\n  borders: {\n    default: \"fui-dark-border\",\n    strong: \"fui-dark-border-strong\",\n  },\n  shadows: {\n    sm: \"fui-dark-shadow-sm\",\n    md: \"fui-dark-shadow-md\",\n  },\n  // Direct dark mode properties\n  accent: \"fui-dark-color-accent\",\n  accentHover: \"fui-dark-color-accent-hover\",\n  accentActive: \"fui-dark-color-accent-active\",\n  dangerBg: \"fui-dark-color-danger-bg\",\n  successBg: \"fui-dark-color-success-bg\",\n  warningBg: \"fui-dark-color-warning-bg\",\n  infoBg: \"fui-dark-color-info-bg\",\n  dangerText: \"fui-dark-color-danger-text\",\n  successText: \"fui-dark-color-success-text\",\n  warningText: \"fui-dark-color-warning-text\",\n  infoText: \"fui-dark-color-info-text\",\n  backdrop: \"fui-dark-backdrop\",\n} as const;\n\n/**\n * Generate tokens for a category\n */\nfunction generateCategoryTokens(\n  config: ThemeConfig,\n  categoryKey: keyof typeof TOKEN_MAPPINGS,\n  format: \"scss\" | \"css\"\n): string[] {\n  const category = config[categoryKey];\n  if (!category) return [];\n\n  const mappings = TOKEN_MAPPINGS[categoryKey];\n  const tokens: string[] = [];\n\n  for (const [key, varName] of Object.entries(mappings)) {\n    const value = (category as Record<string, unknown>)[key];\n    if (value !== undefined) {\n      if (format === \"scss\") {\n        tokens.push(`$${varName}: ${value} !default;`);\n      } else {\n        tokens.push(`  --${varName}: ${value};`);\n      }\n    }\n  }\n\n  return tokens;\n}\n\n/**\n * Generate dark mode tokens\n */\nfunction generateDarkTokens(\n  config: ThemeConfig,\n  format: \"scss\" | \"css\"\n): string[] {\n  if (!config.dark) return [];\n\n  const tokens: string[] = [];\n\n  // Handle nested categories\n  const nestedCategories = [\"surfaces\", \"text\", \"borders\", \"shadows\"] as const;\n  for (const category of nestedCategories) {\n    const categoryData = config.dark[category];\n    if (!categoryData) continue;\n\n    const mappings = DARK_TOKEN_MAPPINGS[category];\n    for (const [key, varName] of Object.entries(mappings)) {\n      const value = (categoryData as Record<string, unknown>)[key];\n      if (value !== undefined) {\n        if (format === \"scss\") {\n          tokens.push(`$${varName}: ${value} !default;`);\n        } else {\n          tokens.push(`  --${varName.replace(\"fui-dark-\", \"fui-\")}: ${value};`);\n        }\n      }\n    }\n  }\n\n  // Handle direct dark mode properties\n  const directProps = [\"accent\", \"accentHover\", \"accentActive\", \"dangerBg\", \"successBg\", \"warningBg\", \"infoBg\", \"dangerText\", \"successText\", \"warningText\", \"infoText\", \"backdrop\"] as const;\n  for (const prop of directProps) {\n    const value = config.dark[prop];\n    if (value !== undefined) {\n      const varName = DARK_TOKEN_MAPPINGS[prop];\n      if (format === \"scss\") {\n        tokens.push(`$${varName}: ${value} !default;`);\n      } else {\n        // For CSS, use the light mode variable name in dark context\n        const cssVarName = varName.replace(\"fui-dark-color-\", \"fui-color-\").replace(\"fui-dark-\", \"fui-\");\n        tokens.push(`  --${cssVarName}: ${value};`);\n      }\n    }\n  }\n\n  return tokens;\n}\n\n/**\n * Validate contrast across all text/surface token pairs in a theme.\n *\n * Returns `ContrastValidationResult` with every evaluated pair plus\n * errors (fails AA) and warnings (passes AA, fails AAA).\n */\nexport function validateContrast(config: ThemeConfig): ContrastValidationResult {\n  const pairs: ContrastPair[] = [];\n  const warnings: ContrastWarning[] = [];\n  const errors: ContrastWarning[] = [];\n\n  const textTokens = [\n    { key: 'primary', token: 'text.primary' },\n    { key: 'secondary', token: 'text.secondary' },\n    { key: 'tertiary', token: 'text.tertiary' },\n  ] as const;\n\n  const surfaceTokens = [\n    { key: 'bgPrimary', token: 'surfaces.bgPrimary' },\n    { key: 'bgSecondary', token: 'surfaces.bgSecondary' },\n    { key: 'bgTertiary', token: 'surfaces.bgTertiary' },\n    { key: 'bgElevated', token: 'surfaces.bgElevated' },\n  ] as const;\n\n  // -- Light mode matrix --\n  for (const text of textTokens) {\n    const textColor = config.text?.[text.key];\n    if (!textColor) continue;\n\n    for (const surface of surfaceTokens) {\n      const surfaceColor = config.surfaces?.[surface.key];\n      if (!surfaceColor) continue;\n\n      try {\n        const fg = parseColor(textColor);\n        const bg = parseColor(surfaceColor);\n        const ratio = contrastRatio(fg, bg);\n        const aa = checkAA(ratio);\n        const aaa = checkAAA(ratio);\n\n        const pair: ContrastPair = {\n          textToken: text.token,\n          surfaceToken: surface.token,\n          textColor,\n          surfaceColor,\n          ratio: Math.round(ratio * 100) / 100,\n          meetsAA: aa,\n          meetsAAA: aaa,\n          mode: 'light',\n        };\n        pairs.push(pair);\n\n        if (!aa) {\n          errors.push({\n            message: `${text.token} (${textColor}) on ${surface.token} (${surfaceColor}) — ${pair.ratio}:1 — fails AA (need 4.5:1)`,\n            pair,\n            severity: 'error',\n          });\n        } else if (!aaa) {\n          warnings.push({\n            message: `${text.token} (${textColor}) on ${surface.token} (${surfaceColor}) — ${pair.ratio}:1 — passes AA but fails AAA (need 7:1)`,\n            pair,\n            severity: 'warning',\n          });\n        }\n      } catch {\n        // Skip unparseable colors (e.g. rgba with alpha)\n      }\n    }\n  }\n\n  // inverse text on accent\n  if (config.text?.inverse && config.colors?.accent) {\n    try {\n      const fg = parseColor(config.text.inverse);\n      const bg = parseColor(config.colors.accent);\n      const ratio = contrastRatio(fg, bg);\n      const aa = checkAA(ratio);\n      const aaa = checkAAA(ratio);\n\n      const pair: ContrastPair = {\n        textToken: 'text.inverse',\n        surfaceToken: 'colors.accent',\n        textColor: config.text.inverse,\n        surfaceColor: config.colors.accent,\n        ratio: Math.round(ratio * 100) / 100,\n        meetsAA: aa,\n        meetsAAA: aaa,\n        mode: 'light',\n      };\n      pairs.push(pair);\n\n      if (!aa) {\n        errors.push({\n          message: `text.inverse (${config.text.inverse}) on colors.accent (${config.colors.accent}) — ${pair.ratio}:1 — fails AA`,\n          pair,\n          severity: 'error',\n        });\n      } else if (!aaa) {\n        warnings.push({\n          message: `text.inverse (${config.text.inverse}) on colors.accent (${config.colors.accent}) — ${pair.ratio}:1 — passes AA but fails AAA`,\n          pair,\n          severity: 'warning',\n        });\n      }\n    } catch {\n      // skip\n    }\n  }\n\n  // -- Dark mode matrix --\n  if (config.dark) {\n    const darkTextTokens = [\n      { key: 'primary' as const, token: 'dark.text.primary' },\n      { key: 'secondary' as const, token: 'dark.text.secondary' },\n      { key: 'tertiary' as const, token: 'dark.text.tertiary' },\n    ];\n\n    const darkSurfaceTokens = [\n      { key: 'bgPrimary' as const, token: 'dark.surfaces.bgPrimary' },\n      { key: 'bgSecondary' as const, token: 'dark.surfaces.bgSecondary' },\n      { key: 'bgTertiary' as const, token: 'dark.surfaces.bgTertiary' },\n      { key: 'bgElevated' as const, token: 'dark.surfaces.bgElevated' },\n    ];\n\n    for (const text of darkTextTokens) {\n      const textColor = config.dark.text?.[text.key] ?? config.text?.[text.key];\n      if (!textColor) continue;\n\n      for (const surface of darkSurfaceTokens) {\n        const surfaceColor = config.dark.surfaces?.[surface.key] ?? config.surfaces?.[surface.key];\n        if (!surfaceColor) continue;\n\n        try {\n          const fg = parseColor(textColor);\n          const bg = parseColor(surfaceColor);\n          const ratio = contrastRatio(fg, bg);\n          const aa = checkAA(ratio);\n          const aaa = checkAAA(ratio);\n\n          const pair: ContrastPair = {\n            textToken: text.token,\n            surfaceToken: surface.token,\n            textColor,\n            surfaceColor,\n            ratio: Math.round(ratio * 100) / 100,\n            meetsAA: aa,\n            meetsAAA: aaa,\n            mode: 'dark',\n          };\n          pairs.push(pair);\n\n          if (!aa) {\n            errors.push({\n              message: `${text.token} (${textColor}) on ${surface.token} (${surfaceColor}) — ${pair.ratio}:1 — fails AA`,\n              pair,\n              severity: 'error',\n            });\n          } else if (!aaa) {\n            warnings.push({\n              message: `${text.token} (${textColor}) on ${surface.token} (${surfaceColor}) — ${pair.ratio}:1 — passes AA but fails AAA`,\n              pair,\n              severity: 'warning',\n            });\n          }\n        } catch {\n          // skip\n        }\n      }\n    }\n  }\n\n  return {\n    pairs,\n    warnings,\n    errors,\n    passed: errors.length === 0,\n  };\n}\n\n/**\n * Generate SCSS tokens from a theme configuration\n *\n * @param config - Theme configuration\n * @returns SCSS content string\n */\nexport function generateScssTokens(config: ThemeConfig): string {\n  const lines: string[] = [];\n\n  // Header\n  lines.push(\"// Auto-generated by @fragments-sdk/cli\");\n  lines.push(`// Theme: ${config.name}`);\n  if (config.version) {\n    lines.push(`// Version: ${config.version}`);\n  }\n  lines.push(\"\");\n\n  // Colors\n  const colorTokens = generateCategoryTokens(config, \"colors\", \"scss\");\n  if (colorTokens.length > 0) {\n    lines.push(\"// Colors\");\n    lines.push(...colorTokens);\n    lines.push(\"\");\n  }\n\n  // Surfaces\n  const surfaceTokens = generateCategoryTokens(config, \"surfaces\", \"scss\");\n  if (surfaceTokens.length > 0) {\n    lines.push(\"// Surfaces\");\n    lines.push(...surfaceTokens);\n    lines.push(\"\");\n  }\n\n  // Text\n  const textTokens = generateCategoryTokens(config, \"text\", \"scss\");\n  if (textTokens.length > 0) {\n    lines.push(\"// Text\");\n    lines.push(...textTokens);\n    lines.push(\"\");\n  }\n\n  // Borders\n  const borderTokens = generateCategoryTokens(config, \"borders\", \"scss\");\n  if (borderTokens.length > 0) {\n    lines.push(\"// Borders\");\n    lines.push(...borderTokens);\n    if (config.borders?.default) {\n      lines.push(`$fui-border-default: ${config.borders.default} !default;`);\n    }\n    lines.push(\"\");\n  }\n\n  // Typography\n  const typographyTokens = generateCategoryTokens(config, \"typography\", \"scss\");\n  if (typographyTokens.length > 0) {\n    lines.push(\"// Typography\");\n    lines.push(...typographyTokens);\n    lines.push(\"\");\n  }\n\n  // Border Radius\n  const radiusTokens = generateCategoryTokens(config, \"radius\", \"scss\");\n  if (radiusTokens.length > 0) {\n    lines.push(\"// Border Radius\");\n    lines.push(...radiusTokens);\n    lines.push(\"\");\n  }\n\n  // Shadows\n  const shadowTokens = generateCategoryTokens(config, \"shadows\", \"scss\");\n  if (shadowTokens.length > 0) {\n    lines.push(\"// Shadows\");\n    lines.push(...shadowTokens);\n    lines.push(\"\");\n  }\n\n  // Density\n  if (config.density) {\n    lines.push(\"// Density\");\n    lines.push(`$fui-density: \"${config.density}\" !default;`);\n    lines.push(\"\");\n  }\n\n  // Dark mode\n  const darkTokens = generateDarkTokens(config, \"scss\");\n  if (darkTokens.length > 0) {\n    lines.push(\"// Dark Mode\");\n    lines.push(...darkTokens);\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate CSS custom properties from a theme configuration\n *\n * @param config - Theme configuration\n * @returns CSS content string\n */\nexport function generateCssTokens(config: ThemeConfig): string {\n  const lines: string[] = [];\n\n  // Header\n  lines.push(\"/* Auto-generated by @fragments-sdk/cli */\");\n  lines.push(`/* Theme: ${config.name} */`);\n  if (config.version) {\n    lines.push(`/* Version: ${config.version} */`);\n  }\n  lines.push(\"\");\n\n  // Collect all light mode tokens\n  const lightTokens: string[] = [];\n\n  const categories = [\"colors\", \"surfaces\", \"text\", \"borders\", \"typography\", \"radius\", \"shadows\"] as const;\n  for (const category of categories) {\n    const tokens = generateCategoryTokens(config, category, \"css\");\n    lightTokens.push(...tokens);\n  }\n\n  // Emit --fui-border-default alias (components reference both names)\n  if (config.borders?.default) {\n    lightTokens.push(`  --fui-border-default: ${config.borders.default};`);\n  }\n\n  // Density\n  if (config.density) {\n    lightTokens.push(`  --fui-density: ${config.density};`);\n  }\n\n  if (lightTokens.length > 0) {\n    lines.push(\":root {\");\n    lines.push(...lightTokens);\n    lines.push(\"}\");\n    lines.push(\"\");\n  }\n\n  // Dark mode\n  const darkTokens = generateDarkTokens(config, \"css\");\n\n  // Border-default alias for dark mode\n  if (config.dark?.borders?.default) {\n    darkTokens.push(`  --fui-border-default: ${config.dark.borders.default};`);\n  }\n\n  if (darkTokens.length > 0) {\n    lines.push(':root.dark,');\n    lines.push(':root[data-theme=\"dark\"] {');\n    lines.push(...darkTokens);\n    lines.push(\"}\");\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate token files from a theme configuration\n *\n * @param config - Theme configuration\n * @param options - Generator options\n * @returns Result with file paths or error\n */\nexport async function generateTokenFiles(\n  config: ThemeConfig,\n  options: TokenGeneratorOptions\n): Promise<TokenGeneratorResult> {\n  const { format, outputDir, filePrefix = DEFAULT_FILE_PREFIX } = options;\n\n  try {\n    // Ensure output directory exists\n    await mkdir(outputDir, { recursive: true });\n\n    const result: TokenGeneratorResult = { success: true };\n\n    // Run contrast validation (non-blocking)\n    const contrastResult = validateContrast(config);\n    result.contrastValidation = contrastResult;\n\n    if (contrastResult.errors.length > 0) {\n      for (const err of contrastResult.errors) {\n        console.warn(`[contrast] ERROR: ${err.message}`);\n      }\n    }\n    if (contrastResult.warnings.length > 0) {\n      for (const warn of contrastResult.warnings) {\n        console.warn(`[contrast] WARNING: ${warn.message}`);\n      }\n    }\n\n    // Generate SCSS if requested\n    if (format === \"scss\" || format === \"both\") {\n      const scssContent = generateScssTokens(config);\n      const scssPath = join(outputDir, `${filePrefix}.scss`);\n      await writeFile(scssPath, scssContent, \"utf-8\");\n      result.scssPath = scssPath;\n    }\n\n    // Generate CSS if requested\n    if (format === \"css\" || format === \"both\") {\n      const cssContent = generateCssTokens(config);\n      const cssPath = join(outputDir, `${filePrefix}.css`);\n      await writeFile(cssPath, cssContent, \"utf-8\");\n      result.cssPath = cssPath;\n    }\n\n    return result;\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n}\n"],"mappings":"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","names":["join","join"]}

package/dist/{govern-scan-OYFZYOQW.js → govern-scan-DW4QUAYD.js}

@@ -9,10 +9,11 @@ import pc from "picocolors";
 import { resolve, relative } from "path";
 import { existsSync } from "fs";
 var SCAN_DEFAULT_RULES = {
-  "safety/no-dangerous-html": true,
+  "safety/block-event-handlers": true,
+  "safety/block-dangerous-props": true,
+  "safety/block-controlled-props": true,
+  "safety/block-function-props": true,
   "safety/sanitize-hrefs": true,
-  "safety/no-inline-scripts": true,
-  "safety/no-exposed-secrets": true,
   "tokens/require-design-tokens": true
 };
 function detectRootDir(cwd) {
@@ -410,4 +411,4 @@ export {
   governScan,
   governWatch
 };
-//# sourceMappingURL=govern-scan-OYFZYOQW.js.map
+//# sourceMappingURL=govern-scan-DW4QUAYD.js.map

package/dist/govern-scan-DW4QUAYD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/govern-scan.ts"],"sourcesContent":["/**\n * govern scan / govern watch — Zero-config governance scanning\n *\n * Parses real JSX/TSX files via the existing codebase scanner, converts\n * component usages to UISpec, and runs governance checks per file.\n * Optionally submits results to Fragments Cloud.\n */\n\nimport pc from 'picocolors';\nimport { resolve, relative } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport { BRAND } from '../core/index.js';\nimport type { ComponentUsage } from '../service/enhance/types.js';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface GovernScanOptions {\n  /** Root directory to scan (default: auto-detect) */\n  dir?: string;\n  /** Path to govern.config.ts */\n  config?: string;\n  /** Output format */\n  format?: 'summary' | 'json' | 'sarif';\n  /** Suppress non-error output */\n  quiet?: boolean;\n}\n\nexport interface GovernWatchOptions extends GovernScanOptions {\n  /** Debounce interval in ms (default: 300) */\n  debounce?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Scan defaults — applied when no config file exists\n// ---------------------------------------------------------------------------\n\nconst SCAN_DEFAULT_RULES: Record<string, boolean | object> = {\n  'safety/block-event-handlers': true,\n  'safety/block-dangerous-props': true,\n  'safety/block-controlled-props': true,\n  'safety/block-function-props': true,\n  'safety/sanitize-hrefs': true,\n  'tokens/require-design-tokens': true,\n};\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Auto-detect root directory by looking for common React project dirs\n */\nfunction detectRootDir(cwd: string): string {\n  const candidates = ['src', 'app', 'pages', 'components'];\n  for (const dir of candidates) {\n    if (existsSync(resolve(cwd, dir))) {\n      return cwd;\n    }\n  }\n  return cwd;\n}\n\n/**\n * Group component usages by their source file\n */\nfunction groupByFile(usages: ComponentUsage[]): Map<string, ComponentUsage[]> {\n  const grouped = new Map<string, ComponentUsage[]>();\n  for (const usage of usages) {\n    const existing = grouped.get(usage.filePath);\n    if (existing) {\n      existing.push(usage);\n    } else {\n      grouped.set(usage.filePath, [usage]);\n    }\n  }\n  return grouped;\n}\n\n// ---------------------------------------------------------------------------\n// governScan\n// ---------------------------------------------------------------------------\n\nexport async function governScan(\n  options: GovernScanOptions = {},\n): Promise<{ exitCode: number }> {\n  const {\n    loadPolicy,\n    createEngine,\n    buildAdaptersFromConfig,\n    createCloudAdapter,\n    formatVerdict,\n    computeComponentHealth,\n  } = await import('@fragments-sdk/govern');\n\n  const { scanCodebase } = await import(\n    '../service/enhance/codebase-scanner.js'\n  );\n  const { usagesToSpec } = await import(\n    '../service/enhance/converter.js'\n  );\n\n  const format = options.format ?? 'summary';\n  const quiet = options.quiet ?? false;\n\n  if (!quiet) {\n    console.log(pc.cyan(`\\n${BRAND.name} Governance Scan\\n`));\n  }\n\n  // 1. Resolve root directory\n  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));\n  if (!quiet) {\n    console.log(pc.dim(`  Root: ${rootDir}\\n`));\n  }\n\n  // 2. Load policy — use scan defaults if no config exists\n  let policy = await loadPolicy(options.config);\n  const hasRules = Object.keys(policy.rules).length > 0;\n\n  if (!hasRules) {\n    policy = { ...policy, rules: SCAN_DEFAULT_RULES };\n    if (!quiet) {\n      console.log(pc.dim('  No config found — using scan defaults (safety + tokens)\\n'));\n    }\n  }\n\n  // 3. Extract code tokens for cloud ingest\n  let codeTokens: string | undefined;\n  if (process.env.FRAGMENTS_API_KEY) {\n    codeTokens = await extractCodeTokens(rootDir, options.config, quiet);\n  }\n\n  // 3b. Load contract registry for governance + cloud ingest (if fragments.json exists)\n  let contractRegistry: string | undefined;\n  let registryMap: Record<string, unknown> | undefined;\n  {\n    const { readFileSync, existsSync } = await import('node:fs');\n    const fragmentsJsonPath = resolve(rootDir, 'fragments.json');\n    if (existsSync(fragmentsJsonPath)) {\n      try {\n        const raw = readFileSync(fragmentsJsonPath, 'utf-8');\n        const parsed = JSON.parse(raw);\n        if (parsed.fragments && Array.isArray(parsed.fragments)) {\n          // Build name-keyed map for engine registry injection\n          const map: Record<string, unknown> = {};\n          for (const f of parsed.fragments) {\n            if (f.meta?.name) {\n              map[f.meta.name] = f;\n            }\n          }\n          registryMap = map;\n\n          if (process.env.FRAGMENTS_API_KEY) {\n            contractRegistry = JSON.stringify({ fragments: parsed.fragments });\n          }\n          if (!quiet) {\n            console.log(pc.dim(`  Contract registry loaded (${parsed.fragments.length} components)\\n`));\n          }\n        }\n      } catch {\n        // Invalid fragments.json — skip\n      }\n    }\n  }\n\n  // 4. Build adapters. Auto-add cloud if FRAGMENTS_API_KEY is set\n  const adapters = buildAdaptersFromConfig(policy.audit);\n  const hasCloudAdapter = adapters.length > 0 && policy.audit?.cloud;\n  if (!hasCloudAdapter && process.env.FRAGMENTS_API_KEY) {\n    adapters.push(createCloudAdapter({ codeTokens, contractRegistry }));\n    if (!quiet) {\n      console.log(pc.dim('  Cloud audit enabled (FRAGMENTS_API_KEY detected)\\n'));\n    }\n  }\n\n  // 5. Create engine (with registry for contract-aware validators)\n  const engine = createEngine(\n    policy,\n    adapters,\n    registryMap\n      ? { registry: { fragments: registryMap as Record<string, Record<string, unknown>> } }\n      : undefined,\n  );\n\n  // 6. Scan codebase\n  if (!quiet) {\n    console.log(pc.dim('  Scanning files...\\n'));\n  }\n\n  const analysis = await scanCodebase({\n    rootDir,\n    useCache: true,\n    onProgress: quiet\n      ? undefined\n      : (progress) => {\n          if (progress.phase === 'scanning') {\n            process.stdout.write(\n              `\\r  ${pc.dim(`[${progress.current}/${progress.total}]`)} ${pc.dim(relative(rootDir, progress.currentFile))}`,\n            );\n          }\n        },\n  });\n\n  if (!quiet) {\n    // Clear progress line\n    process.stdout.write('\\r' + ' '.repeat(80) + '\\r');\n    console.log(\n      pc.dim(`  Scanned ${analysis.totalFiles} files, found ${analysis.totalComponents} component types\\n`),\n    );\n  }\n\n  // 7. Collect all usages across components\n  const allUsages: ComponentUsage[] = [];\n  for (const comp of Object.values(analysis.components)) {\n    allUsages.push(...comp.usages);\n  }\n\n  if (allUsages.length === 0) {\n    if (!quiet) {\n      console.log(pc.yellow('  No component usages found.\\n'));\n    }\n    return { exitCode: 0 };\n  }\n\n  // 8. Group by file and run checks\n  const grouped = groupByFile(allUsages);\n  let totalFiles = 0;\n  let passedFiles = 0;\n  let totalViolations = 0;\n  const violationCounts = new Map<string, number>();\n  const allVerdicts: Awaited<ReturnType<typeof engine.check>>[] = [];\n\n  // Build per-file usage snapshot for cloud\n  const usageSnapshot: Array<{\n    file: string;\n    components: Array<{\n      name: string;\n      line: number;\n      props: { static: Record<string, unknown>; dynamic: string[] };\n    }>;\n  }> = [];\n\n  for (const [filePath, usages] of grouped) {\n    const spec = usagesToSpec(usages, filePath, rootDir);\n    const relPath = relative(rootDir, filePath);\n\n    const verdict = await engine.check(spec, {\n      runner: 'cli',\n      input: relPath,\n    });\n    allVerdicts.push(verdict);\n\n    // Collect per-file usage snapshot\n    usageSnapshot.push({\n      file: relPath,\n      components: usages.map((u) => ({\n        name: u.componentName,\n        line: u.line,\n        props: {\n          static: u.props.static,\n          dynamic: u.props.dynamic,\n        },\n      })),\n    });\n\n    totalFiles++;\n\n    if (verdict.passed) {\n      passedFiles++;\n    } else {\n      if (!quiet) {\n        console.log(pc.red(`  ✗ ${relPath}`));\n        if (format === 'summary') {\n          for (const result of verdict.results) {\n            for (const v of result.violations) {\n              const count = violationCounts.get(v.rule) ?? 0;\n              violationCounts.set(v.rule, count + 1);\n              totalViolations++;\n              console.log(\n                pc.dim(`    ${v.severity} `) +\n                pc.yellow(v.rule) +\n                pc.dim(` — ${v.message}`),\n              );\n              if (v.nodeId) {\n                console.log(pc.dim(`      at ${v.nodeId}`));\n              }\n            }\n          }\n        }\n      }\n    }\n\n    if (verdict.passed && !quiet && format === 'summary') {\n      console.log(pc.green(`  ✓ ${relPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`));\n    }\n\n    // JSON/SARIF: print per-file\n    if (format === 'json' || format === 'sarif') {\n      const output = formatVerdict(verdict, format);\n      console.log(output);\n    }\n  }\n\n  // 8b. Compute component health\n  const health = computeComponentHealth(allVerdicts, registryMap ?? {});\n\n  // 9. Summary\n  if (!quiet && format === 'summary') {\n    console.log(pc.dim('\\n  ─────────────────────────────────────\\n'));\n    console.log(`  Files checked:  ${totalFiles}`);\n    console.log(`  Passed:         ${passedFiles}/${totalFiles}`);\n    console.log(`  Violations:     ${totalViolations}`);\n\n    if (violationCounts.size > 0) {\n      console.log(pc.dim('\\n  Top violations:'));\n      const sorted = [...violationCounts.entries()].sort((a, b) => b[1] - a[1]);\n      for (const [rule, count] of sorted.slice(0, 5)) {\n        console.log(pc.dim(`    ${count}× `) + pc.yellow(rule));\n      }\n    }\n\n    // Component health\n    console.log(pc.dim('\\n  Component Health:'));\n    console.log(`    Contract coverage:  ${health.contractCoverage}% (${health.contractedComponents}/${health.totalComponents})`);\n    console.log(`    Compliance rate:    ${health.overallCompliance}%`);\n\n    if (health.uncontracted.length > 0) {\n      console.log(pc.dim(`    Uncontracted:       ${health.uncontracted.slice(0, 5).join(', ')}${health.uncontracted.length > 5 ? ` (+${health.uncontracted.length - 5} more)` : ''}`));\n    }\n\n    console.log();\n\n    if (passedFiles === totalFiles) {\n      console.log(pc.green(`  ✓ All files passed governance checks\\n`));\n    } else {\n      console.log(\n        pc.red(`  ✗ ${totalFiles - passedFiles} file(s) failed governance checks\\n`),\n      );\n    }\n  }\n\n  // 10. Push component usage snapshot + health to Cloud (if API key set)\n  if (process.env.FRAGMENTS_API_KEY && usageSnapshot.length > 0) {\n    try {\n      const apiKey = process.env.FRAGMENTS_API_KEY;\n      const url = process.env.FRAGMENTS_URL ?? 'https://app.usefragments.com';\n      await fetch(`${url}/api/ingest`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${apiKey}`,\n        },\n        body: JSON.stringify({\n          componentUsage: JSON.stringify(usageSnapshot),\n          componentHealth: JSON.stringify(health),\n        }),\n      });\n    } catch {\n      // Non-critical — don't fail the scan\n    }\n  }\n\n  return { exitCode: passedFiles === totalFiles ? 0 : 1 };\n}\n\n// ---------------------------------------------------------------------------\n// Token extraction for cloud ingest\n// ---------------------------------------------------------------------------\n\n/**\n * Auto-detect and extract code tokens to send alongside governance verdicts.\n * Tries: 1) tokens config from fragments.config.ts, 2) Tailwind config.\n * Returns a flat JSON string of token name → value, or undefined if nothing found.\n */\nasync function extractCodeTokens(\n  rootDir: string,\n  configPath?: string,\n  quiet?: boolean,\n): Promise<string | undefined> {\n  try {\n    // 1. Try fragments.config.ts tokens config\n    try {\n      const { loadConfig } = await import('../core/node.js');\n      const { parseTokenFiles } = await import('../service/index.js');\n\n      const { config, configDir } = await loadConfig(configPath);\n      if (config.tokens?.include?.length) {\n        const result = await parseTokenFiles(config.tokens, configDir);\n        if (result.tokens.length > 0) {\n          const flat: Record<string, string> = {};\n          for (const token of result.tokens) {\n            flat[token.name] = token.resolvedValue;\n          }\n          if (!quiet) {\n            console.log(\n              pc.dim(`  Extracted ${result.tokens.length} code tokens from config\\n`),\n            );\n          }\n          return JSON.stringify(flat);\n        }\n      }\n    } catch {\n      // No config or no tokens section — fall through\n    }\n\n    // 2. Try Tailwind config\n    const {\n      findTailwindConfig,\n      loadTailwindConfig,\n    } = await import('../service/token-normalizer.js');\n\n    const tailwindPath = findTailwindConfig(rootDir);\n    if (tailwindPath) {\n      const tokens = await loadTailwindConfig(tailwindPath);\n      if (tokens.length > 0) {\n        const flat: Record<string, string> = {};\n        for (const token of tokens) {\n          flat[token.name] = token.value;\n        }\n        if (!quiet) {\n          console.log(\n            pc.dim(`  Extracted ${tokens.length} tokens from Tailwind config\\n`),\n          );\n        }\n        return JSON.stringify(flat);\n      }\n    }\n  } catch (error) {\n    if (!quiet) {\n      console.log(\n        pc.dim(\n          `  Token extraction skipped: ${error instanceof Error ? error.message : 'unknown error'}\\n`,\n        ),\n      );\n    }\n  }\n\n  return undefined;\n}\n\n// ---------------------------------------------------------------------------\n// governWatch\n// ---------------------------------------------------------------------------\n\nexport async function governWatch(\n  options: GovernWatchOptions = {},\n): Promise<void> {\n  const {\n    loadPolicy,\n    createEngine,\n    buildAdaptersFromConfig,\n    createCloudAdapter,\n    formatVerdict,\n  } = await import('@fragments-sdk/govern');\n\n  const { scanFile } = await import('../service/enhance/scanner.js');\n  const { usagesToSpec } = await import(\n    '../service/enhance/converter.js'\n  );\n\n  const quiet = options.quiet ?? false;\n  const debounceMs = options.debounce ?? 300;\n  const format = options.format ?? 'summary';\n\n  // 1. Run initial scan\n  console.log(pc.cyan(`\\n${BRAND.name} Governance Watch\\n`));\n\n  const { exitCode } = await governScan(options);\n  if (!quiet) {\n    console.log(\n      pc.dim(`  Initial scan ${exitCode === 0 ? 'passed' : 'completed with violations'}\\n`),\n    );\n  }\n\n  // 2. Set up engine for incremental checks\n  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));\n  let policy = await loadPolicy(options.config);\n  if (Object.keys(policy.rules).length === 0) {\n    policy = { ...policy, rules: SCAN_DEFAULT_RULES };\n  }\n  const adapters = buildAdaptersFromConfig(policy.audit);\n  if (!adapters.some(() => policy.audit?.cloud) && process.env.FRAGMENTS_API_KEY) {\n    adapters.push(createCloudAdapter());\n  }\n  const engine = createEngine(policy, adapters);\n\n  // 3. Watch for changes\n  console.log(pc.dim('  Watching for changes... (Ctrl+C to stop)\\n'));\n\n  const chokidar = await import('chokidar');\n\n  const watcher = chokidar.watch(\n    ['**/*.tsx', '**/*.ts', '**/*.jsx', '**/*.js'],\n    {\n      cwd: rootDir,\n      ignoreInitial: true,\n      ignored: [\n        '**/node_modules/**',\n        '**/dist/**',\n        '**/build/**',\n        '**/.next/**',\n        '**/*.test.*',\n        '**/*.spec.*',\n        '**/*.stories.*',\n      ],\n      awaitWriteFinish: { stabilityThreshold: debounceMs },\n    },\n  );\n\n  const handleChange = async (changedRelPath: string) => {\n    const absolutePath = resolve(rootDir, changedRelPath);\n\n    try {\n      const { usages } = await scanFile(absolutePath);\n\n      if (usages.length === 0) {\n        if (!quiet) {\n          console.log(pc.dim(`  ○ ${changedRelPath} — no component usages`));\n        }\n        return;\n      }\n\n      const spec = usagesToSpec(usages, absolutePath, rootDir);\n      const verdict = await engine.check(spec, {\n        runner: 'cli',\n        input: changedRelPath,\n      });\n\n      if (verdict.passed) {\n        console.log(\n          pc.green(`  ✓ ${changedRelPath}`) +\n          pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`),\n        );\n      } else {\n        console.log(pc.red(`  ✗ ${changedRelPath}`));\n        if (format === 'summary') {\n          for (const result of verdict.results) {\n            for (const v of result.violations) {\n              console.log(\n                pc.dim(`    ${v.severity} `) +\n                pc.yellow(v.rule) +\n                pc.dim(` — ${v.message}`),\n              );\n            }\n          }\n        } else {\n          console.log(formatVerdict(verdict, format));\n        }\n      }\n    } catch (error) {\n      if (!quiet) {\n        console.log(\n          pc.dim(`  ⚠ ${changedRelPath} — `) +\n          pc.yellow(error instanceof Error ? error.message : 'parse error'),\n        );\n      }\n    }\n  };\n\n  watcher.on('change', handleChange);\n  watcher.on('add', handleChange);\n\n  // Keep process alive\n  await new Promise(() => {});\n}\n"],"mappings":"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","names":["existsSync"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/cli",
-  "version": "0.15.2",
+  "version": "0.15.4",
   "license": "FSL-1.1-MIT",
   "description": "CLI, MCP server, and dev tools for Fragments design system",
   "author": "Conan McNicholl",
@@ -50,31 +50,16 @@
     "dist",
     "src"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
-  },
   "scarfSettings": {
     "defaultOptIn": true
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
-    "@fragments-sdk/compiler": "workspace:*",
-    "@fragments-sdk/extract": "workspace:*",
     "@babel/generator": "^7.23.6",
     "@babel/parser": "^7.23.6",
     "@babel/traverse": "^7.23.6",
     "@babel/types": "^7.23.6",
     "@figma/rest-api-spec": "^0.35.0",
-    "@fragments-sdk/context": "workspace:*",
-    "@fragments-sdk/core": "workspace:*",
-    "@fragments-sdk/govern": "workspace:^",
-    "@fragments-sdk/viewer": "workspace:*",
-    "@fragments-sdk/webmcp": "workspace:*",
     "@inquirer/prompts": "^7.2.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@phosphor-icons/react": "^2.1.10",
@@ -95,7 +80,14 @@
     "shiki": "^3.21.0",
     "vite": "^6.0.0",
     "vite-plugin-svgr": "^4.5.0",
-    "zod": "^3.24.1"
+    "zod": "^3.24.1",
+    "@fragments-sdk/compiler": "0.2.0",
+    "@fragments-sdk/extract": "0.1.0",
+    "@fragments-sdk/context": "0.6.0",
+    "@fragments-sdk/govern": "^0.3.1",
+    "@fragments-sdk/core": "2.0.0",
+    "@fragments-sdk/webmcp": "3.0.0",
+    "@fragments-sdk/viewer": "0.2.8"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.6.8",
@@ -128,5 +120,13 @@
     "react-dom": {
       "optional": true
     }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
   }
-}
+}

package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/label.contract.json

@@ -37,6 +37,6 @@
     "source": "extracted",
     "verified": false,
     "frameworkSupport": "native",
-    "extractedAt": "2026-03-25T18:56:02.138Z"
+    "extractedAt": "2026-03-26T14:13:18.781Z"
   }
 }

package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/primitive.contract.json

@@ -15,6 +15,6 @@
     "source": "extracted",
     "verified": false,
     "frameworkSupport": "native",
-    "extractedAt": "2026-03-25T18:56:02.138Z"
+    "extractedAt": "2026-03-26T14:13:18.783Z"
   }
 }

package/src/commands/__tests__/create.test.ts

@@ -22,11 +22,13 @@ describe("create command templates", () => {
   });
 
   it("generates a Next.js layout that routes providers through a client wrapper", () => {
-    const layout = generateNextjsLayout("../styles/theme.css");
+    const layout = generateNextjsLayout("../styles/theme.scss");
 
     expect(layout).toContain("import { Providers } from './providers';");
     expect(layout).toContain("<Providers>{children}</Providers>");
     expect(layout).not.toContain("ThemeProvider");
+    expect(layout).toContain("import '@fragments-sdk/ui/styles';");
+    expect(layout).toContain("import '../styles/theme.scss';");
   });
 
   it("generates a client providers module for Next.js", () => {
@@ -37,11 +39,16 @@ describe("create command templates", () => {
     expect(providers).toContain("ToastProvider");
   });
 
-  it("marks the sample Next.js page as a client component", () => {
+  it("marks the sample Next.js page as a client component with component showcase", () => {
     const page = generateNextjsPage();
 
     expect(page).toContain("'use client';");
-    expect(page).toContain("import { Button, Card, Stack, Text, Input } from '@fragments-sdk/ui';");
+    expect(page).toContain("from '@fragments-sdk/ui';");
+    expect(page).toContain("import styles from './page.module.css';");
+    expect(page).toContain("Card");
+    expect(page).toContain("Tabs");
+    expect(page).toContain("Badge");
+    expect(page).toContain("Progress");
   });
 
   it("adds transpilePackages for @fragments-sdk/ui to next.config.ts", async () => {