@fragments-sdk/cli 0.10.1 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin.js +20 -2
- package/dist/bin.js.map +1 -1
- package/dist/{init-NDQXUWDU.js → init-UFGK5TCN.js} +75 -4
- package/dist/init-UFGK5TCN.js.map +1 -0
- package/dist/snapshot-SV2JOFZH.js +139 -0
- package/dist/snapshot-SV2JOFZH.js.map +1 -0
- package/dist/{viewer-DNMNC5VS.js → viewer-DLLJIMCK.js} +68 -46
- package/dist/viewer-DLLJIMCK.js.map +1 -0
- package/package.json +6 -14
- package/src/bin.ts +30 -0
- package/src/commands/init.ts +76 -1
- package/src/commands/snapshot.ts +197 -0
- package/src/viewer/__tests__/viewer-integration.test.ts +85 -74
- package/src/viewer/server.ts +37 -22
- package/src/viewer/vite-plugin.ts +25 -9
- package/dist/init-NDQXUWDU.js.map +0 -1
- package/dist/viewer-DNMNC5VS.js.map +0 -1
- package/src/viewer/__tests__/a11y-fixes.test.ts +0 -358
- package/src/viewer/__tests__/jsx-parser.test.ts +0 -502
- package/src/viewer/__tests__/render-utils.test.ts +0 -232
- package/src/viewer/__tests__/style-utils.test.ts +0 -404
- package/src/viewer/assets/fragments-logo.ts +0 -4
- package/src/viewer/assets/fragments_logo.png +0 -0
- package/src/viewer/components/AccessibilityPanel.tsx +0 -1457
- package/src/viewer/components/ActionCapture.tsx +0 -172
- package/src/viewer/components/ActionsPanel.tsx +0 -332
- package/src/viewer/components/AllVariantsPreview.tsx +0 -78
- package/src/viewer/components/App.tsx +0 -582
- package/src/viewer/components/BottomPanel.tsx +0 -288
- package/src/viewer/components/CodePanel.naming.test.tsx +0 -59
- package/src/viewer/components/CodePanel.tsx +0 -118
- package/src/viewer/components/CommandPalette.tsx +0 -392
- package/src/viewer/components/ComponentDocView.tsx +0 -164
- package/src/viewer/components/ComponentGraph.tsx +0 -380
- package/src/viewer/components/ComponentHeader.tsx +0 -88
- package/src/viewer/components/ContractPanel.tsx +0 -241
- package/src/viewer/components/EmptyVariantMessage.tsx +0 -54
- package/src/viewer/components/ErrorBoundary.tsx +0 -97
- package/src/viewer/components/FigmaEmbed.tsx +0 -238
- package/src/viewer/components/FragmentEditor.tsx +0 -525
- package/src/viewer/components/FragmentRenderer.tsx +0 -61
- package/src/viewer/components/HeaderSearch.tsx +0 -24
- package/src/viewer/components/HealthDashboard.tsx +0 -441
- package/src/viewer/components/HmrStatusIndicator.tsx +0 -61
- package/src/viewer/components/Icons.tsx +0 -479
- package/src/viewer/components/InteractionsPanel.tsx +0 -757
- package/src/viewer/components/IsolatedPreviewFrame.tsx +0 -346
- package/src/viewer/components/IsolatedRender.tsx +0 -113
- package/src/viewer/components/KeyboardShortcutsHelp.tsx +0 -53
- package/src/viewer/components/LandingPage.tsx +0 -421
- package/src/viewer/components/Layout.tsx +0 -27
- package/src/viewer/components/LeftSidebar.tsx +0 -472
- package/src/viewer/components/LoadErrorMessage.tsx +0 -102
- package/src/viewer/components/MultiViewportPreview.tsx +0 -522
- package/src/viewer/components/NoVariantsMessage.tsx +0 -59
- package/src/viewer/components/PanelShell.tsx +0 -161
- package/src/viewer/components/PerformancePanel.tsx +0 -304
- package/src/viewer/components/PreviewArea.tsx +0 -472
- package/src/viewer/components/PreviewAside.tsx +0 -168
- package/src/viewer/components/PreviewFrameHost.tsx +0 -303
- package/src/viewer/components/PreviewPane.tsx +0 -149
- package/src/viewer/components/PreviewToolbar.tsx +0 -80
- package/src/viewer/components/PropsEditor.tsx +0 -506
- package/src/viewer/components/PropsTable.tsx +0 -111
- package/src/viewer/components/RelationsSection.tsx +0 -88
- package/src/viewer/components/ResizablePanel.tsx +0 -271
- package/src/viewer/components/RightSidebar.tsx +0 -102
- package/src/viewer/components/RuntimeToolsRegistrar.tsx +0 -17
- package/src/viewer/components/ScreenshotButton.tsx +0 -90
- package/src/viewer/components/Sidebar.tsx +0 -169
- package/src/viewer/components/SkeletonLoader.tsx +0 -161
- package/src/viewer/components/ThemeProvider.tsx +0 -42
- package/src/viewer/components/Toast.tsx +0 -3
- package/src/viewer/components/TokenStylePanel.tsx +0 -699
- package/src/viewer/components/TopToolbar.tsx +0 -159
- package/src/viewer/components/UsageSection.tsx +0 -95
- package/src/viewer/components/VariantMatrix.tsx +0 -388
- package/src/viewer/components/VariantRenderer.tsx +0 -131
- package/src/viewer/components/VariantTabs.tsx +0 -40
- package/src/viewer/components/ViewerHeader.tsx +0 -69
- package/src/viewer/components/ViewerStateSync.tsx +0 -52
- package/src/viewer/components/ViewportSelector.tsx +0 -172
- package/src/viewer/components/WebMCPDevTools.tsx +0 -503
- package/src/viewer/components/WebMCPIntegration.tsx +0 -47
- package/src/viewer/components/WebMCPStatusIndicator.tsx +0 -60
- package/src/viewer/components/_future/CreatePage.tsx +0 -836
- package/src/viewer/components/viewer-utils.ts +0 -16
- package/src/viewer/composition-renderer.ts +0 -381
- package/src/viewer/constants/index.ts +0 -1
- package/src/viewer/constants/ui.ts +0 -166
- package/src/viewer/entry.tsx +0 -335
- package/src/viewer/hooks/index.ts +0 -2
- package/src/viewer/hooks/useA11yCache.ts +0 -383
- package/src/viewer/hooks/useA11yService.ts +0 -364
- package/src/viewer/hooks/useActions.ts +0 -138
- package/src/viewer/hooks/useAppState.ts +0 -147
- package/src/viewer/hooks/useCompiledFragments.ts +0 -42
- package/src/viewer/hooks/useFigmaIntegration.ts +0 -132
- package/src/viewer/hooks/useHmrStatus.ts +0 -109
- package/src/viewer/hooks/useKeyboardShortcuts.ts +0 -270
- package/src/viewer/hooks/usePreviewBridge.ts +0 -347
- package/src/viewer/hooks/useScrollSpy.ts +0 -78
- package/src/viewer/hooks/useUrlState.ts +0 -318
- package/src/viewer/hooks/useViewSettings.ts +0 -111
- package/src/viewer/index.html +0 -28
- package/src/viewer/intelligence/healthReport.ts +0 -505
- package/src/viewer/intelligence/styleDrift.ts +0 -340
- package/src/viewer/intelligence/usageScanner.ts +0 -309
- package/src/viewer/jsx-parser.ts +0 -486
- package/src/viewer/preview-frame-entry.tsx +0 -25
- package/src/viewer/preview-frame.html +0 -125
- package/src/viewer/public/favicon.ico +0 -0
- package/src/viewer/render-template.html +0 -68
- package/src/viewer/styles/globals.css +0 -278
- package/src/viewer/types/a11y.ts +0 -197
- package/src/viewer/utils/a11y-fixes.ts +0 -509
- package/src/viewer/utils/actionExport.ts +0 -372
- package/src/viewer/utils/colorSchemes.ts +0 -201
- package/src/viewer/utils/detectRelationships.ts +0 -256
- package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss +0 -10
- package/src/viewer/vendor/shared/src/ComponentDocContent.module.scss.d.ts +0 -2
- package/src/viewer/vendor/shared/src/ComponentDocContent.tsx +0 -274
- package/src/viewer/vendor/shared/src/DocsHeaderBar.tsx +0 -129
- package/src/viewer/vendor/shared/src/DocsPageAsideHost.tsx +0 -89
- package/src/viewer/vendor/shared/src/DocsPageShell.tsx +0 -124
- package/src/viewer/vendor/shared/src/DocsSearchCommand.tsx +0 -99
- package/src/viewer/vendor/shared/src/DocsSidebarNav.tsx +0 -66
- package/src/viewer/vendor/shared/src/PropsTable.module.scss +0 -68
- package/src/viewer/vendor/shared/src/PropsTable.module.scss.d.ts +0 -2
- package/src/viewer/vendor/shared/src/PropsTable.tsx +0 -76
- package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss +0 -114
- package/src/viewer/vendor/shared/src/VariantPreviewCard.module.scss.d.ts +0 -2
- package/src/viewer/vendor/shared/src/VariantPreviewCard.tsx +0 -137
- package/src/viewer/vendor/shared/src/docs-data/index.ts +0 -32
- package/src/viewer/vendor/shared/src/docs-data/mcp-configs.ts +0 -72
- package/src/viewer/vendor/shared/src/docs-data/palettes.ts +0 -75
- package/src/viewer/vendor/shared/src/docs-data/setup-examples.ts +0 -55
- package/src/viewer/vendor/shared/src/docs-layout.scss +0 -28
- package/src/viewer/vendor/shared/src/docs-layout.scss.d.ts +0 -2
- package/src/viewer/vendor/shared/src/index.ts +0 -34
- package/src/viewer/vendor/shared/src/types.ts +0 -53
- package/src/viewer/webmcp/__tests__/analytics.test.ts +0 -108
- package/src/viewer/webmcp/analytics.ts +0 -165
- package/src/viewer/webmcp/index.ts +0 -3
- package/src/viewer/webmcp/posthog-bridge.ts +0 -39
- package/src/viewer/webmcp/runtime-tools.ts +0 -152
- package/src/viewer/webmcp/scan-utils.ts +0 -135
- package/src/viewer/webmcp/use-tool-analytics.ts +0 -69
- package/src/viewer/webmcp/viewer-state.ts +0 -45
|
@@ -11,7 +11,7 @@ import { resolve, join as join2, relative } from "path";
|
|
|
11
11
|
import { spawn } from "child_process";
|
|
12
12
|
import pc2 from "picocolors";
|
|
13
13
|
import fg from "fast-glob";
|
|
14
|
-
import { input, confirm } from "@inquirer/prompts";
|
|
14
|
+
import { input, confirm, select } from "@inquirer/prompts";
|
|
15
15
|
|
|
16
16
|
// src/commands/init-framework.ts
|
|
17
17
|
import { readFile, writeFile, access } from "fs/promises";
|
|
@@ -384,7 +384,7 @@ ${componentStr}
|
|
|
384
384
|
|
|
385
385
|
// Framework (react, vue, svelte)
|
|
386
386
|
framework: '${options.framework}',
|
|
387
|
-
};
|
|
387
|
+
${options.themeBlock || ""}${options.snapshotsBlock || ""}};
|
|
388
388
|
|
|
389
389
|
export default config;
|
|
390
390
|
`;
|
|
@@ -664,6 +664,8 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
|
|
|
664
664
|
let runScan = scenario === "components" || scenario === "stories";
|
|
665
665
|
let createExample = scenario === "fresh";
|
|
666
666
|
let startServer = false;
|
|
667
|
+
let themeBlock = "";
|
|
668
|
+
let snapshotsBlock = "";
|
|
667
669
|
if (!options.yes) {
|
|
668
670
|
componentPath = await input({
|
|
669
671
|
message: "Where are your components located?",
|
|
@@ -675,6 +677,73 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
|
|
|
675
677
|
default: true
|
|
676
678
|
});
|
|
677
679
|
}
|
|
680
|
+
const configureTheme = await confirm({
|
|
681
|
+
message: "Configure theme seeds? (brand color, density, radius)",
|
|
682
|
+
default: false
|
|
683
|
+
});
|
|
684
|
+
if (configureTheme) {
|
|
685
|
+
const brand = await input({
|
|
686
|
+
message: "Brand color (hex)",
|
|
687
|
+
default: "#18181b",
|
|
688
|
+
validate: (v) => /^#[0-9a-fA-F]{6}$/.test(v) || "Enter a valid hex color (e.g., #6366f1)"
|
|
689
|
+
});
|
|
690
|
+
const neutral = await select({
|
|
691
|
+
message: "Neutral palette",
|
|
692
|
+
choices: [
|
|
693
|
+
{ value: "stone", name: "Stone (warm gray)" },
|
|
694
|
+
{ value: "ice", name: "Ice (cool blue-gray)" },
|
|
695
|
+
{ value: "earth", name: "Earth (olive/khaki)" },
|
|
696
|
+
{ value: "sand", name: "Sand (warm beige)" },
|
|
697
|
+
{ value: "fire", name: "Fire (warm red-gray)" }
|
|
698
|
+
],
|
|
699
|
+
default: "stone"
|
|
700
|
+
});
|
|
701
|
+
const density = await select({
|
|
702
|
+
message: "Spacing density",
|
|
703
|
+
choices: [
|
|
704
|
+
{ value: "compact", name: "Compact (tighter spacing)" },
|
|
705
|
+
{ value: "default", name: "Default" },
|
|
706
|
+
{ value: "relaxed", name: "Relaxed (more breathing room)" }
|
|
707
|
+
],
|
|
708
|
+
default: "default"
|
|
709
|
+
});
|
|
710
|
+
const radiusStyle = await select({
|
|
711
|
+
message: "Border radius style",
|
|
712
|
+
choices: [
|
|
713
|
+
{ value: "sharp", name: "Sharp (0px)" },
|
|
714
|
+
{ value: "subtle", name: "Subtle (2px)" },
|
|
715
|
+
{ value: "default", name: "Default (6px)" },
|
|
716
|
+
{ value: "rounded", name: "Rounded (10px)" },
|
|
717
|
+
{ value: "pill", name: "Pill (999px)" }
|
|
718
|
+
],
|
|
719
|
+
default: "default"
|
|
720
|
+
});
|
|
721
|
+
const themeEntries = [];
|
|
722
|
+
if (brand !== "#18181b") themeEntries.push(` brand: '${brand}'`);
|
|
723
|
+
if (neutral !== "stone") themeEntries.push(` neutral: '${neutral}'`);
|
|
724
|
+
if (density !== "default") themeEntries.push(` density: '${density}'`);
|
|
725
|
+
if (radiusStyle !== "default") themeEntries.push(` radiusStyle: '${radiusStyle}'`);
|
|
726
|
+
if (themeEntries.length > 0) {
|
|
727
|
+
themeBlock = `
|
|
728
|
+
// Theme seed values (derives 120+ CSS custom properties)
|
|
729
|
+
theme: {
|
|
730
|
+
${themeEntries.join(",\n")},
|
|
731
|
+
},
|
|
732
|
+
`;
|
|
733
|
+
}
|
|
734
|
+
}
|
|
735
|
+
const enableSnapshots = await confirm({
|
|
736
|
+
message: "Enable visual snapshot tests per component variant?",
|
|
737
|
+
default: false
|
|
738
|
+
});
|
|
739
|
+
if (enableSnapshots) {
|
|
740
|
+
snapshotsBlock = `
|
|
741
|
+
// Visual snapshot testing
|
|
742
|
+
snapshots: {
|
|
743
|
+
enabled: true,
|
|
744
|
+
},
|
|
745
|
+
`;
|
|
746
|
+
}
|
|
678
747
|
startServer = await confirm({
|
|
679
748
|
message: "Start the viewer now?",
|
|
680
749
|
default: true
|
|
@@ -692,7 +761,9 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
|
|
|
692
761
|
const configContent = generateConfig({
|
|
693
762
|
includePaths,
|
|
694
763
|
componentPaths: [`${componentPath}/**/*.tsx`],
|
|
695
|
-
framework: "react"
|
|
764
|
+
framework: "react",
|
|
765
|
+
themeBlock,
|
|
766
|
+
snapshotsBlock
|
|
696
767
|
});
|
|
697
768
|
try {
|
|
698
769
|
await writeFile2(configPath, configContent, "utf-8");
|
|
@@ -793,4 +864,4 @@ Keeping existing configuration. Run \`${BRAND.cliCommand} dev\` to start.
|
|
|
793
864
|
export {
|
|
794
865
|
init
|
|
795
866
|
};
|
|
796
|
-
//# sourceMappingURL=init-
|
|
867
|
+
//# sourceMappingURL=init-UFGK5TCN.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/commands/init.ts","../src/commands/init-framework.ts"],"sourcesContent":["/**\n * fragments init - Smart interactive initialization\n *\n * Handles four scenarios:\n * 1. --scan <path> → Scan external component library, generate fragment files\n * 2. Stories found → Configure and load existing stories\n * 3. Components found (no stories) → Auto-generate documentation\n * 4. 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 /** Path to scan for components (enables scan mode) */\n scan?: string;\n}\n\nexport interface InitResult {\n success: boolean;\n configPath?: string;\n scenario: \"stories\" | \"components\" | \"fresh\" | \"scan\";\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 themeBlock?: string;\n snapshotsBlock?: 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${options.themeBlock || \"\"}${options.snapshotsBlock || \"\"}};\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 // Early return for scan mode — non-interactive\n if (options.scan) {\n const scanPath = resolve(projectRoot, options.scan);\n\n // Verify scan path exists\n try {\n await access(scanPath);\n } catch {\n console.error(pc.red(`\\nScan path not found: ${scanPath}\\n`));\n return {\n success: false,\n scenario: \"scan\",\n storiesFound: 0,\n componentsFound: 0,\n errors: [`Scan path not found: ${scanPath}`],\n };\n }\n\n // Run scan-generate\n const { scanGenerate } = await import(\"./scan-generate.js\");\n const scanResult = await scanGenerate({\n scanPath,\n force: options.force,\n verbose: true,\n });\n\n // Create config pointing at the scanned path\n const relScanPath = relative(projectRoot, scanPath);\n const configPath = join(projectRoot, BRAND.configFile);\n const configContent = generateConfig({\n includePaths: [`${relScanPath}/**/*.fragment.tsx`],\n componentPaths: [`${relScanPath}/**/*.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 // Next steps\n if (scanResult.success) {\n console.log(pc.cyan(\"Next steps:\"));\n console.log(` 1. Search generated files for ${pc.bold(\"TODO:\")} markers and fill in human knowledge`);\n console.log(` 2. Run ${pc.bold(`${BRAND.cliCommand} dev`)} to preview your components`);\n console.log(` 3. Run ${pc.bold(`${BRAND.cliCommand} build`)} to compile fragments.json`);\n console.log();\n }\n\n return {\n success: scanResult.success && errors.length === 0,\n configPath: errors.length === 0 ? configPath : undefined,\n scenario: \"scan\",\n storiesFound: 0,\n componentsFound: scanResult.generated.length,\n errors: [\n ...errors,\n ...scanResult.errors.map((e) => `${e.name}: ${e.error}`),\n ],\n };\n }\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\" || scenario === \"stories\";\n let createExample = scenario === \"fresh\";\n let startServer = false;\n let themeBlock = \"\";\n let snapshotsBlock = \"\";\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 === \"fresh\") {\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 // Theme seed configuration\n const configureTheme = await confirm({\n message: \"Configure theme seeds? (brand color, density, radius)\",\n default: false,\n });\n\n if (configureTheme) {\n const brand = await input({\n message: \"Brand color (hex)\",\n default: \"#18181b\",\n validate: (v) => /^#[0-9a-fA-F]{6}$/.test(v) || \"Enter a valid hex color (e.g., #6366f1)\",\n });\n\n const neutral = await select({\n message: \"Neutral palette\",\n choices: [\n { value: \"stone\", name: \"Stone (warm gray)\" },\n { value: \"ice\", name: \"Ice (cool blue-gray)\" },\n { value: \"earth\", name: \"Earth (olive/khaki)\" },\n { value: \"sand\", name: \"Sand (warm beige)\" },\n { value: \"fire\", name: \"Fire (warm red-gray)\" },\n ],\n default: \"stone\",\n });\n\n const density = await select({\n message: \"Spacing density\",\n choices: [\n { value: \"compact\", name: \"Compact (tighter spacing)\" },\n { value: \"default\", name: \"Default\" },\n { value: \"relaxed\", name: \"Relaxed (more breathing room)\" },\n ],\n default: \"default\",\n });\n\n const radiusStyle = await select({\n message: \"Border radius style\",\n choices: [\n { value: \"sharp\", name: \"Sharp (0px)\" },\n { value: \"subtle\", name: \"Subtle (2px)\" },\n { value: \"default\", name: \"Default (6px)\" },\n { value: \"rounded\", name: \"Rounded (10px)\" },\n { value: \"pill\", name: \"Pill (999px)\" },\n ],\n default: \"default\",\n });\n\n // Build theme config block — only include non-default values\n const themeEntries: string[] = [];\n if (brand !== \"#18181b\") themeEntries.push(` brand: '${brand}'`);\n if (neutral !== \"stone\") themeEntries.push(` neutral: '${neutral}'`);\n if (density !== \"default\") themeEntries.push(` density: '${density}'`);\n if (radiusStyle !== \"default\") themeEntries.push(` radiusStyle: '${radiusStyle}'`);\n\n if (themeEntries.length > 0) {\n themeBlock = `\\n // Theme seed values (derives 120+ CSS custom properties)\\n theme: {\\n${themeEntries.join(\",\\n\")},\\n },\\n`;\n }\n }\n\n // Snapshot toggle\n const enableSnapshots = await confirm({\n message: \"Enable visual snapshot tests per component variant?\",\n default: false,\n });\n\n if (enableSnapshots) {\n snapshotsBlock = `\\n // Visual snapshot testing\\n snapshots: {\\n enabled: true,\\n },\\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 // If Storybook stories detected, also include them for direct rendering\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 themeBlock,\n snapshotsBlock,\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 (runScan) {\n // Run scan to generate fragments.json from source code\n console.log(pc.dim(\"\\nScanning source code for documentation...\\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 console.log(pc.cyan(\"Starting viewer...\\n\"));\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(` 3. Run ${pc.bold(`${BRAND.cliCommand} generate`)} to create fragment files for your components`);\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 defaultMode=\"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","pc","access","configPath","join","configContent","writeFile"]}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
|
|
2
|
+
import "./chunk-D2CDBRNU.js";
|
|
3
|
+
import {
|
|
4
|
+
BRAND
|
|
5
|
+
} from "./chunk-OQO55NKV.js";
|
|
6
|
+
import "./chunk-Z7EY4VHE.js";
|
|
7
|
+
|
|
8
|
+
// src/commands/snapshot.ts
|
|
9
|
+
import { resolve } from "path";
|
|
10
|
+
import { execSync, spawn } from "child_process";
|
|
11
|
+
import { existsSync } from "fs";
|
|
12
|
+
import pc from "picocolors";
|
|
13
|
+
function findSnapshotSpec(projectRoot, explicitPath) {
|
|
14
|
+
if (explicitPath) {
|
|
15
|
+
const resolved = resolve(projectRoot, explicitPath);
|
|
16
|
+
return existsSync(resolved) ? resolved : null;
|
|
17
|
+
}
|
|
18
|
+
const candidates = [
|
|
19
|
+
resolve(projectRoot, "e2e/component-visual-snapshots.spec.ts"),
|
|
20
|
+
resolve(projectRoot, "tests/visual-snapshots.spec.ts"),
|
|
21
|
+
resolve(projectRoot, "test/visual-snapshots.spec.ts")
|
|
22
|
+
];
|
|
23
|
+
for (const candidate of candidates) {
|
|
24
|
+
if (existsSync(candidate)) {
|
|
25
|
+
return candidate;
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
async function snapshot(options = {}) {
|
|
31
|
+
const projectRoot = process.cwd();
|
|
32
|
+
const {
|
|
33
|
+
port,
|
|
34
|
+
update = false,
|
|
35
|
+
component,
|
|
36
|
+
ci = false
|
|
37
|
+
} = options;
|
|
38
|
+
console.log(pc.cyan(`
|
|
39
|
+
${BRAND.name} Visual Snapshots
|
|
40
|
+
`));
|
|
41
|
+
const fragmentsJson = resolve(projectRoot, BRAND.outFile);
|
|
42
|
+
if (!existsSync(fragmentsJson)) {
|
|
43
|
+
console.error(
|
|
44
|
+
pc.red(`${BRAND.outFile} not found. Run ${pc.bold(`${BRAND.cliCommand} build`)} first.`)
|
|
45
|
+
);
|
|
46
|
+
return { success: false, totalTests: 0, passed: 0, failed: 0 };
|
|
47
|
+
}
|
|
48
|
+
const specPath = findSnapshotSpec(projectRoot, options.spec);
|
|
49
|
+
if (!specPath) {
|
|
50
|
+
console.error(
|
|
51
|
+
pc.red("No snapshot spec found.") + "\n" + pc.dim("Expected: e2e/component-visual-snapshots.spec.ts\n") + pc.dim(`Create one or specify with --spec <path>`)
|
|
52
|
+
);
|
|
53
|
+
return { success: false, totalTests: 0, passed: 0, failed: 0 };
|
|
54
|
+
}
|
|
55
|
+
console.log(pc.dim(`Spec: ${specPath}`));
|
|
56
|
+
try {
|
|
57
|
+
execSync("npx playwright --version", { stdio: "pipe" });
|
|
58
|
+
} catch {
|
|
59
|
+
console.error(
|
|
60
|
+
pc.red("Playwright not found.") + "\n" + pc.dim("Install it: pnpm add -D @playwright/test && npx playwright install chromium")
|
|
61
|
+
);
|
|
62
|
+
return { success: false, totalTests: 0, passed: 0, failed: 0 };
|
|
63
|
+
}
|
|
64
|
+
const args = ["playwright", "test", specPath];
|
|
65
|
+
if (update) {
|
|
66
|
+
args.push("--update-snapshots");
|
|
67
|
+
console.log(pc.yellow("Updating snapshots (baselines will be overwritten)"));
|
|
68
|
+
}
|
|
69
|
+
if (component) {
|
|
70
|
+
args.push("--grep", component);
|
|
71
|
+
console.log(pc.dim(`Filtering: ${component}`));
|
|
72
|
+
}
|
|
73
|
+
const env = { ...process.env };
|
|
74
|
+
if (port) {
|
|
75
|
+
env.FRAGMENTS_DEV_PORT = String(port);
|
|
76
|
+
console.log(pc.dim(`Using running dev server on port ${port}`));
|
|
77
|
+
}
|
|
78
|
+
console.log(pc.dim("\nRunning snapshot tests...\n"));
|
|
79
|
+
return new Promise((resolveResult) => {
|
|
80
|
+
const child = spawn("npx", args, {
|
|
81
|
+
cwd: projectRoot,
|
|
82
|
+
stdio: ci ? "pipe" : "inherit",
|
|
83
|
+
env
|
|
84
|
+
});
|
|
85
|
+
let stdout = "";
|
|
86
|
+
if (ci && child.stdout) {
|
|
87
|
+
child.stdout.on("data", (data) => {
|
|
88
|
+
stdout += data.toString();
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
if (ci && child.stderr) {
|
|
92
|
+
child.stderr.on("data", (data) => {
|
|
93
|
+
stdout += data.toString();
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
child.on("close", (code) => {
|
|
97
|
+
const success = code === 0;
|
|
98
|
+
if (ci) {
|
|
99
|
+
const passedMatch = stdout.match(/(\d+) passed/);
|
|
100
|
+
const failedMatch = stdout.match(/(\d+) failed/);
|
|
101
|
+
const passed = passedMatch ? parseInt(passedMatch[1], 10) : 0;
|
|
102
|
+
const failed = failedMatch ? parseInt(failedMatch[1], 10) : 0;
|
|
103
|
+
if (!success) {
|
|
104
|
+
process.stdout.write(stdout);
|
|
105
|
+
}
|
|
106
|
+
resolveResult({
|
|
107
|
+
success,
|
|
108
|
+
totalTests: passed + failed,
|
|
109
|
+
passed,
|
|
110
|
+
failed
|
|
111
|
+
});
|
|
112
|
+
} else {
|
|
113
|
+
if (success) {
|
|
114
|
+
console.log(pc.green("\n\u2713 All snapshots match\n"));
|
|
115
|
+
} else if (update) {
|
|
116
|
+
console.log(pc.green("\n\u2713 Snapshots updated\n"));
|
|
117
|
+
} else {
|
|
118
|
+
console.log(pc.red("\n\u2717 Snapshot mismatches detected"));
|
|
119
|
+
console.log(pc.dim(`Run ${pc.bold(`${BRAND.cliCommand} snapshot --update`)} to accept changes
|
|
120
|
+
`));
|
|
121
|
+
}
|
|
122
|
+
resolveResult({
|
|
123
|
+
success: success || update,
|
|
124
|
+
totalTests: 0,
|
|
125
|
+
passed: 0,
|
|
126
|
+
failed: 0
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
});
|
|
130
|
+
child.on("error", (err) => {
|
|
131
|
+
console.error(pc.red(`Failed to run Playwright: ${err.message}`));
|
|
132
|
+
resolveResult({ success: false, totalTests: 0, passed: 0, failed: 0 });
|
|
133
|
+
});
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
export {
|
|
137
|
+
snapshot
|
|
138
|
+
};
|
|
139
|
+
//# sourceMappingURL=snapshot-SV2JOFZH.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/commands/snapshot.ts"],"sourcesContent":["/**\n * fragments snapshot - Run visual snapshot tests per component variant\n *\n * Starts the dev server (if not already running), then runs Playwright\n * snapshot tests against all component variants discovered in fragments.json.\n */\n\nimport { resolve } from \"node:path\";\nimport { execSync, spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport pc from \"picocolors\";\nimport { BRAND } from \"../core/index.js\";\n\nexport interface SnapshotOptions {\n /** Port of a running dev server (skips starting one) */\n port?: number | string;\n /** Update existing snapshots instead of comparing */\n update?: boolean;\n /** Filter to a specific component name */\n component?: string;\n /** Path to Playwright config (auto-detected if omitted) */\n config?: string;\n /** Path to the snapshot spec file */\n spec?: string;\n /** CI mode — non-interactive, exit 1 on mismatch */\n ci?: boolean;\n}\n\nexport interface SnapshotResult {\n success: boolean;\n totalTests: number;\n passed: number;\n failed: number;\n}\n\n/**\n * Find the snapshot spec file.\n * Checks project root e2e/ first, then falls back to the CLI's bundled spec.\n */\nfunction findSnapshotSpec(projectRoot: string, explicitPath?: string): string | null {\n if (explicitPath) {\n const resolved = resolve(projectRoot, explicitPath);\n return existsSync(resolved) ? resolved : null;\n }\n\n // Check common locations\n const candidates = [\n resolve(projectRoot, \"e2e/component-visual-snapshots.spec.ts\"),\n resolve(projectRoot, \"tests/visual-snapshots.spec.ts\"),\n resolve(projectRoot, \"test/visual-snapshots.spec.ts\"),\n ];\n\n for (const candidate of candidates) {\n if (existsSync(candidate)) {\n return candidate;\n }\n }\n\n return null;\n}\n\n/**\n * Run visual snapshot tests.\n */\nexport async function snapshot(options: SnapshotOptions = {}): Promise<SnapshotResult> {\n const projectRoot = process.cwd();\n const {\n port,\n update = false,\n component,\n ci = false,\n } = options;\n\n console.log(pc.cyan(`\\n${BRAND.name} Visual Snapshots\\n`));\n\n // Check that fragments.json exists\n const fragmentsJson = resolve(projectRoot, BRAND.outFile);\n if (!existsSync(fragmentsJson)) {\n console.error(\n pc.red(`${BRAND.outFile} not found. Run ${pc.bold(`${BRAND.cliCommand} build`)} first.`)\n );\n return { success: false, totalTests: 0, passed: 0, failed: 0 };\n }\n\n // Find the snapshot spec\n const specPath = findSnapshotSpec(projectRoot, options.spec);\n if (!specPath) {\n console.error(\n pc.red(\"No snapshot spec found.\") + \"\\n\" +\n pc.dim(\"Expected: e2e/component-visual-snapshots.spec.ts\\n\") +\n pc.dim(`Create one or specify with --spec <path>`)\n );\n return { success: false, totalTests: 0, passed: 0, failed: 0 };\n }\n\n console.log(pc.dim(`Spec: ${specPath}`));\n\n // Check for Playwright\n try {\n execSync(\"npx playwright --version\", { stdio: \"pipe\" });\n } catch {\n console.error(\n pc.red(\"Playwright not found.\") + \"\\n\" +\n pc.dim(\"Install it: pnpm add -D @playwright/test && npx playwright install chromium\")\n );\n return { success: false, totalTests: 0, passed: 0, failed: 0 };\n }\n\n // Build Playwright args\n const args = [\"playwright\", \"test\", specPath];\n\n if (update) {\n args.push(\"--update-snapshots\");\n console.log(pc.yellow(\"Updating snapshots (baselines will be overwritten)\"));\n }\n\n if (component) {\n args.push(\"--grep\", component);\n console.log(pc.dim(`Filtering: ${component}`));\n }\n\n // If a port is specified, set the BASE_URL env var so the spec\n // can connect to an already-running dev server\n const env: Record<string, string> = { ...process.env as Record<string, string> };\n if (port) {\n env.FRAGMENTS_DEV_PORT = String(port);\n console.log(pc.dim(`Using running dev server on port ${port}`));\n }\n\n console.log(pc.dim(\"\\nRunning snapshot tests...\\n\"));\n\n // Run Playwright\n return new Promise<SnapshotResult>((resolveResult) => {\n const child = spawn(\"npx\", args, {\n cwd: projectRoot,\n stdio: ci ? \"pipe\" : \"inherit\",\n env,\n });\n\n let stdout = \"\";\n\n if (ci && child.stdout) {\n child.stdout.on(\"data\", (data) => {\n stdout += data.toString();\n });\n }\n if (ci && child.stderr) {\n child.stderr.on(\"data\", (data) => {\n stdout += data.toString();\n });\n }\n\n child.on(\"close\", (code) => {\n const success = code === 0;\n\n if (ci) {\n // Parse Playwright output for test counts\n const passedMatch = stdout.match(/(\\d+) passed/);\n const failedMatch = stdout.match(/(\\d+) failed/);\n const passed = passedMatch ? parseInt(passedMatch[1], 10) : 0;\n const failed = failedMatch ? parseInt(failedMatch[1], 10) : 0;\n\n if (!success) {\n process.stdout.write(stdout);\n }\n\n resolveResult({\n success,\n totalTests: passed + failed,\n passed,\n failed,\n });\n } else {\n if (success) {\n console.log(pc.green(\"\\n✓ All snapshots match\\n\"));\n } else if (update) {\n console.log(pc.green(\"\\n✓ Snapshots updated\\n\"));\n } else {\n console.log(pc.red(\"\\n✗ Snapshot mismatches detected\"));\n console.log(pc.dim(`Run ${pc.bold(`${BRAND.cliCommand} snapshot --update`)} to accept changes\\n`));\n }\n\n resolveResult({\n success: success || update,\n totalTests: 0,\n passed: 0,\n failed: 0,\n });\n }\n });\n\n child.on(\"error\", (err) => {\n console.error(pc.red(`Failed to run Playwright: ${err.message}`));\n resolveResult({ success: false, totalTests: 0, passed: 0, failed: 0 });\n });\n });\n}\n"],"mappings":";;;;;;;;AAOA,SAAS,eAAe;AACxB,SAAS,UAAU,aAAa;AAChC,SAAS,kBAAkB;AAC3B,OAAO,QAAQ;AA6Bf,SAAS,iBAAiB,aAAqB,cAAsC;AACnF,MAAI,cAAc;AAChB,UAAM,WAAW,QAAQ,aAAa,YAAY;AAClD,WAAO,WAAW,QAAQ,IAAI,WAAW;AAAA,EAC3C;AAGA,QAAM,aAAa;AAAA,IACjB,QAAQ,aAAa,wCAAwC;AAAA,IAC7D,QAAQ,aAAa,gCAAgC;AAAA,IACrD,QAAQ,aAAa,+BAA+B;AAAA,EACtD;AAEA,aAAW,aAAa,YAAY;AAClC,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAKA,eAAsB,SAAS,UAA2B,CAAC,GAA4B;AACrF,QAAM,cAAc,QAAQ,IAAI;AAChC,QAAM;AAAA,IACJ;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA,KAAK;AAAA,EACP,IAAI;AAEJ,UAAQ,IAAI,GAAG,KAAK;AAAA,EAAK,MAAM,IAAI;AAAA,CAAqB,CAAC;AAGzD,QAAM,gBAAgB,QAAQ,aAAa,MAAM,OAAO;AACxD,MAAI,CAAC,WAAW,aAAa,GAAG;AAC9B,YAAQ;AAAA,MACN,GAAG,IAAI,GAAG,MAAM,OAAO,mBAAmB,GAAG,KAAK,GAAG,MAAM,UAAU,QAAQ,CAAC,SAAS;AAAA,IACzF;AACA,WAAO,EAAE,SAAS,OAAO,YAAY,GAAG,QAAQ,GAAG,QAAQ,EAAE;AAAA,EAC/D;AAGA,QAAM,WAAW,iBAAiB,aAAa,QAAQ,IAAI;AAC3D,MAAI,CAAC,UAAU;AACb,YAAQ;AAAA,MACN,GAAG,IAAI,yBAAyB,IAAI,OACpC,GAAG,IAAI,oDAAoD,IAC3D,GAAG,IAAI,0CAA0C;AAAA,IACnD;AACA,WAAO,EAAE,SAAS,OAAO,YAAY,GAAG,QAAQ,GAAG,QAAQ,EAAE;AAAA,EAC/D;AAEA,UAAQ,IAAI,GAAG,IAAI,SAAS,QAAQ,EAAE,CAAC;AAGvC,MAAI;AACF,aAAS,4BAA4B,EAAE,OAAO,OAAO,CAAC;AAAA,EACxD,QAAQ;AACN,YAAQ;AAAA,MACN,GAAG,IAAI,uBAAuB,IAAI,OAClC,GAAG,IAAI,6EAA6E;AAAA,IACtF;AACA,WAAO,EAAE,SAAS,OAAO,YAAY,GAAG,QAAQ,GAAG,QAAQ,EAAE;AAAA,EAC/D;AAGA,QAAM,OAAO,CAAC,cAAc,QAAQ,QAAQ;AAE5C,MAAI,QAAQ;AACV,SAAK,KAAK,oBAAoB;AAC9B,YAAQ,IAAI,GAAG,OAAO,oDAAoD,CAAC;AAAA,EAC7E;AAEA,MAAI,WAAW;AACb,SAAK,KAAK,UAAU,SAAS;AAC7B,YAAQ,IAAI,GAAG,IAAI,cAAc,SAAS,EAAE,CAAC;AAAA,EAC/C;AAIA,QAAM,MAA8B,EAAE,GAAG,QAAQ,IAA8B;AAC/E,MAAI,MAAM;AACR,QAAI,qBAAqB,OAAO,IAAI;AACpC,YAAQ,IAAI,GAAG,IAAI,oCAAoC,IAAI,EAAE,CAAC;AAAA,EAChE;AAEA,UAAQ,IAAI,GAAG,IAAI,+BAA+B,CAAC;AAGnD,SAAO,IAAI,QAAwB,CAAC,kBAAkB;AACpD,UAAM,QAAQ,MAAM,OAAO,MAAM;AAAA,MAC/B,KAAK;AAAA,MACL,OAAO,KAAK,SAAS;AAAA,MACrB;AAAA,IACF,CAAC;AAED,QAAI,SAAS;AAEb,QAAI,MAAM,MAAM,QAAQ;AACtB,YAAM,OAAO,GAAG,QAAQ,CAAC,SAAS;AAChC,kBAAU,KAAK,SAAS;AAAA,MAC1B,CAAC;AAAA,IACH;AACA,QAAI,MAAM,MAAM,QAAQ;AACtB,YAAM,OAAO,GAAG,QAAQ,CAAC,SAAS;AAChC,kBAAU,KAAK,SAAS;AAAA,MAC1B,CAAC;AAAA,IACH;AAEA,UAAM,GAAG,SAAS,CAAC,SAAS;AAC1B,YAAM,UAAU,SAAS;AAEzB,UAAI,IAAI;AAEN,cAAM,cAAc,OAAO,MAAM,cAAc;AAC/C,cAAM,cAAc,OAAO,MAAM,cAAc;AAC/C,cAAM,SAAS,cAAc,SAAS,YAAY,CAAC,GAAG,EAAE,IAAI;AAC5D,cAAM,SAAS,cAAc,SAAS,YAAY,CAAC,GAAG,EAAE,IAAI;AAE5D,YAAI,CAAC,SAAS;AACZ,kBAAQ,OAAO,MAAM,MAAM;AAAA,QAC7B;AAEA,sBAAc;AAAA,UACZ;AAAA,UACA,YAAY,SAAS;AAAA,UACrB;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH,OAAO;AACL,YAAI,SAAS;AACX,kBAAQ,IAAI,GAAG,MAAM,gCAA2B,CAAC;AAAA,QACnD,WAAW,QAAQ;AACjB,kBAAQ,IAAI,GAAG,MAAM,8BAAyB,CAAC;AAAA,QACjD,OAAO;AACL,kBAAQ,IAAI,GAAG,IAAI,uCAAkC,CAAC;AACtD,kBAAQ,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,GAAG,MAAM,UAAU,oBAAoB,CAAC;AAAA,CAAsB,CAAC;AAAA,QACnG;AAEA,sBAAc;AAAA,UACZ,SAAS,WAAW;AAAA,UACpB,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAED,UAAM,GAAG,SAAS,CAAC,QAAQ;AACzB,cAAQ,MAAM,GAAG,IAAI,6BAA6B,IAAI,OAAO,EAAE,CAAC;AAChE,oBAAc,EAAE,SAAS,OAAO,YAAY,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC;AAAA,IACvE,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}
|