@fragments-sdk/cli 0.15.0 → 0.15.2
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/{ai-client-I6MDWNYA.js → ai-client-LSLQGOMM.js} +1 -2
- package/dist/bin.js +565 -548
- package/dist/bin.js.map +1 -1
- package/dist/chunk-5JF26E55.js +1255 -0
- package/dist/chunk-5JF26E55.js.map +1 -0
- package/dist/{chunk-XJQ5BIWI.js → chunk-6SQPP47U.js} +30 -314
- package/dist/chunk-6SQPP47U.js.map +1 -0
- package/dist/{chunk-65WSVDV5.js → chunk-HQ6A6DTV.js} +1386 -1097
- package/dist/chunk-HQ6A6DTV.js.map +1 -0
- package/dist/chunk-MHIBEEW4.js +511 -0
- package/dist/chunk-MHIBEEW4.js.map +1 -0
- package/dist/{chunk-CZD3AD4Q.js → chunk-ONUP6Z4W.js} +17 -6
- package/dist/chunk-ONUP6Z4W.js.map +1 -0
- package/dist/{codebase-scanner-VOTPXRYW.js → codebase-scanner-MQHUZC2G.js} +1 -2
- package/dist/{converter-JLINP7CJ.js → converter-7XM3Y6NJ.js} +1 -2
- package/dist/{converter-JLINP7CJ.js.map → converter-7XM3Y6NJ.js.map} +1 -1
- package/dist/core/index.js +0 -1
- package/dist/create-JVAU3YKN.js +852 -0
- package/dist/create-JVAU3YKN.js.map +1 -0
- package/dist/doctor-BDPMYYE6.js +385 -0
- package/dist/doctor-BDPMYYE6.js.map +1 -0
- package/dist/{generate-A4FP5426.js → generate-PVOLUAAC.js} +3 -4
- package/dist/{generate-A4FP5426.js.map → generate-PVOLUAAC.js.map} +1 -1
- package/dist/{govern-scan-UCBZR6D6.js → govern-scan-OYFZYOQW.js} +142 -9
- package/dist/govern-scan-OYFZYOQW.js.map +1 -0
- package/dist/index.d.ts +2 -22
- package/dist/index.js +8 -7
- package/dist/index.js.map +1 -1
- package/dist/{init-HGSM35XA.js → init-SSGUSP7Z.js} +3 -4
- package/dist/{init-HGSM35XA.js.map → init-SSGUSP7Z.js.map} +1 -1
- package/dist/{init-cloud-MQ6GRJAZ.js → init-cloud-3DNKPWFB.js} +29 -4
- package/dist/{init-cloud-MQ6GRJAZ.js.map → init-cloud-3DNKPWFB.js.map} +1 -1
- package/dist/mcp-bin.js +1 -2
- package/dist/mcp-bin.js.map +1 -1
- package/dist/node-37AUE74M.js +65 -0
- package/dist/push-contracts-WY32TFP6.js +84 -0
- package/dist/push-contracts-WY32TFP6.js.map +1 -0
- package/dist/{scan-VNNKACG2.js → scan-PKSYSTRR.js} +5 -5
- package/dist/{scan-generate-TWRHNU5M.js → scan-generate-VY27PIOX.js} +8 -9
- package/dist/scan-generate-VY27PIOX.js.map +1 -0
- package/dist/{scanner-7LAZYPWZ.js → scanner-4KZNOXAK.js} +1 -2
- package/dist/{service-FHQU7YS7.js → service-QJGWUIVL.js} +16 -9
- package/dist/{snapshot-KQEQ6XHL.js → snapshot-WIJMEIFT.js} +1 -2
- package/dist/{snapshot-KQEQ6XHL.js.map → snapshot-WIJMEIFT.js.map} +1 -1
- package/dist/{static-viewer-63PG6FWY.js → static-viewer-7QIBQZRC.js} +1 -2
- package/dist/{test-UQYUCZIS.js → test-64Z5BKBA.js} +2 -3
- package/dist/{test-UQYUCZIS.js.map → test-64Z5BKBA.js.map} +1 -1
- package/dist/token-normalizer-TEPOVBPV.js +312 -0
- package/dist/token-normalizer-TEPOVBPV.js.map +1 -0
- package/dist/token-parser-32KOIOFN.js +22 -0
- package/dist/token-parser-32KOIOFN.js.map +1 -0
- package/dist/{tokens-6GYKDV6U.js → tokens-NZWFQIAB.js} +7 -7
- package/dist/{tokens-generate-VTZV5EEW.js → tokens-generate-5JQSJ27E.js} +1 -2
- package/dist/{tokens-generate-VTZV5EEW.js.map → tokens-generate-5JQSJ27E.js.map} +1 -1
- package/dist/tokens-push-HY3KO36V.js +148 -0
- package/dist/tokens-push-HY3KO36V.js.map +1 -0
- package/package.json +18 -16
- package/src/bin.ts +94 -1
- package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/label.contract.json +1 -1
- package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/primitive.contract.json +1 -1
- package/src/commands/__tests__/build-freshness.test.ts +231 -0
- package/src/commands/__tests__/create.test.ts +71 -0
- package/src/commands/__tests__/drift-sync.test.ts +1 -1
- package/src/commands/__tests__/govern.test.ts +258 -0
- package/src/commands/__tests__/init.test.ts +9 -1
- package/src/commands/__tests__/scan-generate.test.ts +1 -1
- package/src/commands/build.ts +54 -1
- package/src/commands/context.ts +1 -1
- package/src/commands/create.ts +590 -0
- package/src/commands/doctor.ts +3 -2
- package/src/commands/govern-scan.ts +187 -8
- package/src/commands/govern.ts +65 -2
- package/src/commands/init-cloud.ts +32 -4
- package/src/commands/push-contracts.ts +112 -0
- package/src/commands/scan-generate.ts +1 -1
- package/src/commands/scan.ts +13 -0
- package/src/commands/sync.ts +2 -2
- package/src/commands/tokens-push.ts +199 -0
- package/src/core/__tests__/token-resolver.test.ts +1 -1
- package/src/core/component-extractor.test.ts +1 -1
- package/src/core/drift-verifier.ts +1 -1
- package/src/core/extractor-adapter.ts +1 -1
- package/src/index.ts +3 -3
- package/src/migrate/fragment-to-contract.ts +2 -2
- package/src/service/index.ts +8 -0
- package/src/service/tailwind-v4-parser.ts +314 -0
- package/src/service/token-parser.ts +56 -0
- package/src/setup.ts +10 -39
- package/src/theme/__tests__/component-contrast.test.ts +2 -2
- package/src/theme/__tests__/serializer.test.ts +1 -1
- package/src/theme/generator.ts +30 -1
- package/src/theme/schema.ts +8 -0
- package/src/theme/serializer.ts +13 -9
- package/src/theme/types.ts +8 -0
- package/src/validators.ts +1 -2
- package/dist/chunk-65WSVDV5.js.map +0 -1
- package/dist/chunk-7WHVW72L.js +0 -2664
- package/dist/chunk-7WHVW72L.js.map +0 -1
- package/dist/chunk-CZD3AD4Q.js.map +0 -1
- package/dist/chunk-MN3TJ3D5.js +0 -695
- package/dist/chunk-MN3TJ3D5.js.map +0 -1
- package/dist/chunk-XJQ5BIWI.js.map +0 -1
- package/dist/chunk-Z7EY4VHE.js +0 -50
- package/dist/govern-scan-UCBZR6D6.js.map +0 -1
- package/dist/sass.node-4XJK6YBF.js +0 -130708
- package/dist/sass.node-4XJK6YBF.js.map +0 -1
- package/dist/scan-generate-TWRHNU5M.js.map +0 -1
- package/src/build.ts +0 -736
- package/src/core/auto-props.ts +0 -464
- package/src/core/component-extractor.ts +0 -1121
- package/src/core/token-resolver.ts +0 -155
- package/src/viewer/preview-adapter.ts +0 -116
- /package/dist/{ai-client-I6MDWNYA.js.map → ai-client-LSLQGOMM.js.map} +0 -0
- /package/dist/{chunk-Z7EY4VHE.js.map → codebase-scanner-MQHUZC2G.js.map} +0 -0
- /package/dist/{codebase-scanner-VOTPXRYW.js.map → node-37AUE74M.js.map} +0 -0
- /package/dist/{scan-VNNKACG2.js.map → scan-PKSYSTRR.js.map} +0 -0
- /package/dist/{scanner-7LAZYPWZ.js.map → scanner-4KZNOXAK.js.map} +0 -0
- /package/dist/{service-FHQU7YS7.js.map → service-QJGWUIVL.js.map} +0 -0
- /package/dist/{static-viewer-63PG6FWY.js.map → static-viewer-7QIBQZRC.js.map} +0 -0
- /package/dist/{tokens-6GYKDV6U.js.map → tokens-NZWFQIAB.js.map} +0 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/commands/generate.ts"],"sourcesContent":["/**\n * fragments generate - Generate fragment files from component source code\n *\n * Analyzes component source code and generates proper defineFragment() TSX files\n * colocated next to the component source. These files are parseable by the\n * build command and renderable by the dev viewer.\n */\n\nimport { readFile, writeFile, access } from \"node:fs/promises\";\nimport { resolve, basename, dirname, relative, join } from \"node:path\";\nimport pc from \"picocolors\";\nimport fg from \"fast-glob\";\nimport { BRAND } from \"../core/index.js\";\nimport { extractPropsFromFile } from \"../core/node.js\";\n\nexport interface GenerateOptions {\n /** Project root directory */\n projectRoot?: string;\n /** Specific component name to generate (optional) */\n component?: string;\n /** Overwrite existing fragment files */\n force?: boolean;\n /** Pattern for component files */\n componentPattern?: string;\n}\n\nexport interface GenerateResult {\n success: boolean;\n generated: Array<{ name: string; path: string }>;\n skipped: Array<{ name: string; reason: string }>;\n errors: Array<{ name: string; error: string }>;\n}\n\n/**\n * Generate fragment files from component source code\n */\nexport async function generate(options: GenerateOptions = {}): Promise<GenerateResult> {\n const projectRoot = resolve(options.projectRoot || process.cwd());\n const generated: Array<{ name: string; path: string }> = [];\n const skipped: Array<{ name: string; reason: string }> = [];\n const errors: Array<{ name: string; error: string }> = [];\n\n console.log(pc.cyan(`\\n${BRAND.name} Generate\\n`));\n\n // Find component files\n const componentPattern =\n options.componentPattern ||\n \"src/components/**/*.tsx\";\n\n const componentFiles = await fg(componentPattern, {\n cwd: projectRoot,\n ignore: [\n \"**/node_modules/**\",\n \"**/*.stories.*\",\n \"**/*.fragment.*\",\n \"**/*.test.*\",\n \"**/*.spec.*\",\n \"**/*.d.ts\",\n \"**/index.tsx\", // Often just re-exports\n ],\n absolute: true,\n });\n\n // Find story files for pattern inference\n const storyFiles = await fg([\"src/**/*.stories.tsx\", \"src/**/*.stories.ts\"], {\n cwd: projectRoot,\n ignore: [\"**/node_modules/**\"],\n absolute: true,\n });\n\n // Build story map for pattern inference (names + args)\n const storyMap = new Map<string, StoryVariant[]>();\n for (const storyFile of storyFiles) {\n try {\n const content = await readFile(storyFile, \"utf-8\");\n const componentName = extractComponentNameFromStory(content, storyFile);\n if (componentName) {\n const variants = extractStoryVariants(content);\n storyMap.set(componentName, variants);\n }\n } catch {\n // Ignore parsing errors\n }\n }\n\n console.log(pc.dim(`Found ${componentFiles.length} component files\\n`));\n\n // Process each component file\n for (const filePath of componentFiles) {\n try {\n const extracted = extractPropsFromFile(filePath);\n\n if (!extracted || !extracted.componentName) {\n continue;\n }\n\n const componentName = extracted.componentName;\n\n // Filter by component name if specified\n if (options.component && componentName !== options.component) {\n continue;\n }\n\n // Write fragment file colocated next to the component source\n const componentDir = dirname(filePath);\n const componentBaseName = basename(filePath, \".tsx\");\n const fragmentPath = join(componentDir, `${componentBaseName}${BRAND.fileExtension}`);\n\n let fragmentExists = false;\n try {\n await access(fragmentPath);\n fragmentExists = true;\n } catch {\n // Fragment doesn't exist\n }\n\n if (fragmentExists && !options.force) {\n skipped.push({ name: componentName, reason: \"Fragment already exists\" });\n console.log(pc.dim(` Skipping ${componentName} (fragment exists)`));\n continue;\n }\n\n // Generate proper defineFragment() TSX content\n const storyVariants = storyMap.get(componentName) || [];\n const fragmentContent = generateFragmentTsx(\n componentName,\n componentBaseName,\n extracted,\n filePath,\n storyVariants\n );\n\n // Write fragment file\n await writeFile(fragmentPath, fragmentContent, \"utf-8\");\n generated.push({ name: componentName, path: relative(projectRoot, fragmentPath) });\n console.log(pc.green(` ✓ Generated ${componentName}${BRAND.fileExtension}`));\n } catch (e) {\n const fileName = basename(filePath);\n errors.push({\n name: fileName,\n error: e instanceof Error ? e.message : String(e),\n });\n console.log(pc.red(` ✗ Failed: ${fileName}`));\n }\n }\n\n // Summary\n console.log();\n if (generated.length > 0) {\n console.log(pc.green(`✓ Generated ${generated.length} fragment(s)`));\n }\n if (skipped.length > 0) {\n console.log(pc.dim(` Skipped ${skipped.length} (use --force to overwrite)`));\n }\n if (errors.length > 0) {\n console.log(pc.yellow(` ${errors.length} error(s)`));\n }\n console.log();\n\n return {\n success: errors.length === 0,\n generated,\n skipped,\n errors,\n };\n}\n\n/**\n * Generate proper defineFragment() TSX file content\n */\nfunction generateFragmentTsx(\n componentName: string,\n componentBaseName: string,\n extracted: ReturnType<typeof extractPropsFromFile> & { componentName: string },\n filePath: string,\n storyVariants: StoryVariant[]\n): string {\n const storyNames = storyVariants.map((v) => v.name);\n const whenToUse = inferUsageFromStories(storyNames);\n const description = generateDescription(componentName, extracted.props);\n const status = inferStatus(filePath);\n const accessibility = inferAccessibility(extracted.props);\n\n // Build props object for defineFragment\n const propsEntries = Object.entries(extracted.props || {});\n\n // Format when array\n const whenLines = whenToUse.length > 0\n ? whenToUse.map((w) => ` '${escapeQuotes(w)}',`).join(\"\\n\")\n : ` 'TODO: describe when to use ${componentName}',`;\n\n // Format props\n let propsBlock = \"{}\";\n if (propsEntries.length > 0) {\n const propLines = propsEntries.map(([name, info]) => {\n const propInfo = info as Record<string, unknown>;\n const rawType = propInfo.type ? String(propInfo.type) : \"\";\n const classified = classifyPropType(rawType);\n const desc = propInfo.description ? String(propInfo.description).replace(/\\n/g, \" \") : \"\";\n const required = propInfo.required ? \"true\" : \"false\";\n const parts = [` type: '${classified.type}'`];\n if (desc) parts.push(` description: '${escapeQuotes(desc)}'`);\n parts.push(` required: ${required}`);\n if (propInfo.default !== undefined) {\n parts.push(` default: ${JSON.stringify(propInfo.default)}`);\n }\n // Use classified values (from string literal unions) or existing values\n const values = classified.values || (propInfo.values && Array.isArray(propInfo.values) ? propInfo.values : null);\n if (values && values.length > 0) {\n parts.push(` values: ${JSON.stringify(values)}`);\n }\n return ` ${name}: {\\n${parts.join(\",\\n\")},\\n }`;\n });\n propsBlock = `{\\n${propLines.join(\",\\n\")},\\n }`;\n }\n\n // Build accessibility section\n let accessibilityBlock = \"\";\n if (accessibility.role || (accessibility.requirements && accessibility.requirements.length > 0)) {\n const parts: string[] = [];\n if (accessibility.role) {\n parts.push(` role: '${accessibility.role}'`);\n }\n if (accessibility.requirements && accessibility.requirements.length > 0) {\n const reqs = accessibility.requirements.map((r) => `'${escapeQuotes(r)}'`).join(\", \");\n parts.push(` requirements: [${reqs}]`);\n }\n accessibilityBlock = `\n\n accessibility: {\n${parts.join(\",\\n\")},\n },`;\n }\n\n // Build variants from story args or fallback to bare render\n const variants = buildVariants(componentName, storyVariants);\n\n // Use default import when the source component uses export default\n const componentImportStatement = extracted.isDefaultExport\n ? `import ${componentName} from './${componentBaseName}';`\n : `import { ${componentName} } from './${componentBaseName}';`;\n\n return `import React from 'react';\nimport { defineFragment } from '@fragments-sdk/cli/core';\n${componentImportStatement}\n\nexport default defineFragment({\n component: ${componentName},\n\n meta: {\n name: '${escapeQuotes(componentName)}',\n description: '${escapeQuotes(description)}',\n category: '${inferCategory(componentName, extracted.props)}',\n status: '${status}',\n },\n\n usage: {\n when: [\n${whenLines}\n ],\n whenNot: [],\n },\n\n props: ${propsBlock},${accessibilityBlock}\n\n variants: [\n${variants}\n ],\n});\n`;\n}\n\n/**\n * Escape single quotes in strings\n */\nfunction escapeQuotes(str: string): string {\n return str.replace(/'/g, \"\\\\'\");\n}\n\n/**\n * Classify a raw TypeScript type string into a valid fragment prop type enum value.\n * Returns the classified type and optionally extracted enum values.\n */\nfunction classifyPropType(rawType: string): { type: string; values?: string[] } {\n const t = rawType.replace(/\\s+/g, \" \").trim();\n const lower = t.toLowerCase();\n\n // Direct primitive matches\n if (lower === \"string\") return { type: \"string\" };\n if (lower === \"number\") return { type: \"number\" };\n if (lower === \"boolean\" || lower === \"bool\") return { type: \"boolean\" };\n\n // String/number literal unions → enum with values\n // e.g., '\"primary\" | \"secondary\"' or \"'default' | 'modal'\"\n if (/^[\"'][^\"']*[\"'](\\s*\\|\\s*[\"'][^\"']*[\"'])*$/.test(t)) {\n const values = [...t.matchAll(/[\"']([^\"']+)[\"']/g)].map((m) => m[1]);\n if (values.length > 0) return { type: \"enum\", values };\n }\n\n // Function types — arrow functions, callbacks, handlers, dispatchers\n if (\n lower.includes(\"=>\") ||\n lower.includes(\"handler\") ||\n lower.includes(\"callback\") ||\n lower.includes(\"dispatch\") ||\n lower.includes(\"listener\") ||\n /^\\(/.test(t)\n ) {\n return { type: \"function\" };\n }\n\n // React node types\n if (\n lower.includes(\"reactnode\") ||\n lower.includes(\"react.reactnode\") ||\n lower === \"node\"\n ) {\n return { type: \"node\" };\n }\n\n // React element types\n if (\n lower.includes(\"reactelement\") ||\n lower.includes(\"react.reactelement\") ||\n lower.includes(\"jsx.element\")\n ) {\n return { type: \"element\" };\n }\n\n // Array types\n if (lower.includes(\"[]\") || lower.startsWith(\"array<\") || lower.startsWith(\"readonly \")) {\n return { type: \"array\" };\n }\n\n // Object types (must come after array check since objects can contain [])\n if (lower.startsWith(\"{\") || lower.includes(\"record<\") || lower === \"object\") {\n return { type: \"object\" };\n }\n\n // Union types (mixed types with |)\n if (lower.includes(\"|\")) {\n // Check if it's a union of just string literals (enum)\n const parts = t.split(\"|\").map((p) => p.trim());\n const allStringLiterals = parts.every((p) => /^[\"'].*[\"']$/.test(p));\n if (allStringLiterals) {\n const values = parts.map((p) => p.replace(/^[\"']|[\"']$/g, \"\"));\n return { type: \"enum\", values };\n }\n return { type: \"union\" };\n }\n\n // Anything else\n return { type: \"custom\" };\n}\n\n/**\n * Infer category from component name and props\n */\nfunction inferCategory(componentName: string, props: Record<string, unknown>): string {\n const lower = componentName.toLowerCase();\n\n const categoryPatterns: Record<string, string[]> = {\n \"Actions\": [\"button\", \"action\", \"cta\", \"fab\", \"floatingaction\"],\n \"Forms\": [\"form\", \"input\", \"select\", \"checkbox\", \"radio\", \"textarea\", \"field\", \"textfield\", \"datepicker\", \"switch\", \"slider\", \"segmented\"],\n \"Layout\": [\"layout\", \"container\", \"grid\", \"flex\", \"stack\", \"box\", \"divider\", \"spacer\", \"sidebar\"],\n \"Navigation\": [\"nav\", \"menu\", \"breadcrumb\", \"tab\", \"link\", \"pagination\", \"stepper\", \"topbar\"],\n \"Feedback\": [\"alert\", \"toast\", \"notification\", \"message\", \"badge\", \"indicator\", \"progress\", \"spinner\", \"loading\", \"loader\", \"lozenge\", \"chip\"],\n \"Data Display\": [\"table\", \"list\", \"card\", \"avatar\", \"stat\", \"timeline\", \"tree\", \"datalist\", \"datacard\"],\n \"Overlays\": [\"modal\", \"dialog\", \"drawer\", \"popover\", \"tooltip\", \"dropdown\", \"slidepanel\"],\n \"Typography\": [\"text\", \"heading\", \"title\", \"label\", \"paragraph\"],\n \"Media\": [\"image\", \"video\", \"icon\", \"carousel\"],\n };\n\n for (const [category, patterns] of Object.entries(categoryPatterns)) {\n for (const pattern of patterns) {\n if (lower.includes(pattern)) {\n return category;\n }\n }\n }\n\n if (\"onClick\" in props || \"onPress\" in props) return \"Actions\";\n if (\"value\" in props || \"defaultValue\" in props) return \"Forms\";\n if (\"children\" in props) return \"Layout\";\n\n return \"Components\";\n}\n\n/**\n * Extract component name from story file\n */\nfunction extractComponentNameFromStory(content: string, filePath: string): string | null {\n const titleMatch = content.match(/title:\\s*['\"](?:[^'\"]+\\/)?([^'\"]+)['\"]/);\n if (titleMatch) {\n return titleMatch[1];\n }\n\n const fileName = basename(filePath);\n const componentName = fileName.replace(/\\.stories\\.(tsx?|jsx?)$/, \"\");\n if (/^[A-Z]/.test(componentName)) {\n return componentName;\n }\n\n return null;\n}\n\ninterface StoryVariant {\n name: string;\n args: Record<string, unknown>;\n}\n\n/**\n * Extract story names and their args from story file content (CSF3 format).\n * Parses patterns like:\n * export const Primary: Story = { args: { variant: 'primary', children: 'Click me' } }\n */\nfunction extractStoryVariants(content: string): StoryVariant[] {\n const variants: StoryVariant[] = [];\n\n const exportMatches = content.matchAll(\n /export\\s+const\\s+([A-Z][a-zA-Z0-9]*)\\s*[=:]/g\n );\n\n for (const match of exportMatches) {\n const name = match[1];\n if (name === \"default\" || name.endsWith(\"Args\") || name.endsWith(\"Meta\")) {\n continue;\n }\n\n const args = extractStoryArgs(content, name);\n variants.push({ name, args });\n }\n\n return variants;\n}\n\n/**\n * Extract the `args` object from a named story export.\n * Uses balanced-brace matching to handle nested objects.\n */\nfunction extractStoryArgs(content: string, storyName: string): Record<string, unknown> {\n // Find the story export and look for an args block\n const storyPattern = new RegExp(\n `export\\\\s+const\\\\s+${storyName}[^=]*=\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\n\\\\};`,\n );\n const storyMatch = content.match(storyPattern);\n if (!storyMatch) return {};\n\n const storyBody = storyMatch[1];\n\n // Find the args block within the story body\n const argsStart = storyBody.indexOf('args:');\n if (argsStart === -1) return {};\n\n // Find the opening brace after \"args:\"\n const braceStart = storyBody.indexOf('{', argsStart);\n if (braceStart === -1) return {};\n\n // Balanced brace matching to find the full args object\n let depth = 0;\n let braceEnd = -1;\n for (let i = braceStart; i < storyBody.length; i++) {\n if (storyBody[i] === '{') depth++;\n else if (storyBody[i] === '}') {\n depth--;\n if (depth === 0) {\n braceEnd = i;\n break;\n }\n }\n }\n if (braceEnd === -1) return {};\n\n const argsBlock = storyBody.slice(braceStart + 1, braceEnd).trim();\n return parseArgsBlock(argsBlock);\n}\n\n/**\n * Parse a simplified args block into key-value pairs.\n * Handles string literals, numbers, booleans, and simple expressions.\n */\nfunction parseArgsBlock(argsBlock: string): Record<string, unknown> {\n const args: Record<string, unknown> = {};\n\n // Match key: value pairs (handles string, number, boolean values)\n const pairPattern = /(\\w+)\\s*:\\s*(?:['\"]([^'\"]*?)['\"]|(true|false)|(\\d+(?:\\.\\d+)?))/g;\n let pairMatch: RegExpExecArray | null;\n\n while ((pairMatch = pairPattern.exec(argsBlock)) !== null) {\n const key = pairMatch[1];\n if (pairMatch[2] !== undefined) {\n // String value\n args[key] = pairMatch[2];\n } else if (pairMatch[3] !== undefined) {\n // Boolean\n args[key] = pairMatch[3] === 'true';\n } else if (pairMatch[4] !== undefined) {\n // Number\n args[key] = Number(pairMatch[4]);\n }\n }\n\n return args;\n}\n\n/**\n * Build variant entries from story args.\n * If stories have args, generates JSX with those props.\n * Falls back to a bare `<Component />` for the Default variant.\n */\nfunction buildVariants(componentName: string, storyVariants: StoryVariant[]): string {\n // Filter to variants with args, plus always include a Default\n const hasDefault = storyVariants.some((v) => v.name === 'Default');\n const entries: string[] = [];\n\n if (!hasDefault) {\n entries.push(formatVariantEntry(componentName, 'Default', `Default ${componentName}`, {}));\n }\n\n for (const variant of storyVariants) {\n const description = variant.name\n .replace(/([A-Z])/g, ' $1')\n .trim();\n entries.push(formatVariantEntry(componentName, variant.name, `${description} ${componentName}`, variant.args));\n }\n\n // Deduplicate: if stories provided a Default, don't double-add\n return entries.join('\\n');\n}\n\n/**\n * Format a single variant entry with JSX code and render function.\n * Handles `children` as JSX children, all other args as props.\n */\nfunction formatVariantEntry(\n componentName: string,\n name: string,\n description: string,\n args: Record<string, unknown>\n): string {\n const jsxCode = buildJsxString(componentName, args);\n return ` {\n name: '${escapeQuotes(name)}',\n description: '${escapeQuotes(description)}',\n code: \\`${jsxCode}\\`,\n render: () => ${jsxCode},\n },`;\n}\n\n/**\n * Build a JSX string from component name and args.\n * `children` string args become JSX children, others become props.\n */\nfunction buildJsxString(componentName: string, args: Record<string, unknown>): string {\n const { children, ...restArgs } = args;\n const propParts: string[] = [];\n\n for (const [key, value] of Object.entries(restArgs)) {\n if (typeof value === 'string') {\n propParts.push(`${key}=\"${escapeQuotes(value)}\"`);\n } else if (typeof value === 'boolean') {\n propParts.push(value ? key : `${key}={false}`);\n } else if (typeof value === 'number') {\n propParts.push(`${key}={${value}}`);\n }\n }\n\n const propsStr = propParts.length > 0 ? ' ' + propParts.join(' ') : '';\n\n if (typeof children === 'string') {\n return `<${componentName}${propsStr}>${children}</${componentName}>`;\n }\n\n return `<${componentName}${propsStr} />`;\n}\n\n/**\n * Infer usage scenarios from story names\n */\nfunction inferUsageFromStories(storyNames: string[]): string[] {\n const usage: string[] = [];\n\n for (const name of storyNames) {\n const sentence = name\n .replace(/([A-Z])/g, \" $1\")\n .trim()\n .toLowerCase();\n\n if (\n [\"default\", \"primary\", \"basic\", \"example\", \"playground\"].includes(\n sentence.toLowerCase()\n )\n ) {\n continue;\n }\n\n if (sentence.includes(\"loading\")) {\n usage.push(\"Showing loading states\");\n } else if (sentence.includes(\"disabled\")) {\n usage.push(\"Preventing user interaction\");\n } else if (sentence.includes(\"error\")) {\n usage.push(\"Displaying error states\");\n } else if (sentence.includes(\"success\")) {\n usage.push(\"Showing success feedback\");\n } else if (sentence.includes(\"empty\")) {\n usage.push(\"Handling empty states\");\n } else if (sentence.includes(\"with\")) {\n const withPart = sentence.replace(\"with \", \"\");\n usage.push(`Displaying with ${withPart}`);\n }\n }\n\n return usage;\n}\n\n/**\n * Generate description from component name and props\n */\nfunction generateDescription(\n componentName: string,\n props: Record<string, unknown>\n): string {\n const words = componentName\n .replace(/([A-Z])/g, \" $1\")\n .trim()\n .toLowerCase();\n\n const hasOnClick = \"onClick\" in props || \"onPress\" in props;\n const hasValue = \"value\" in props || \"defaultValue\" in props;\n const hasChildren = \"children\" in props;\n\n if (hasOnClick && !hasValue) {\n return `Interactive ${words} element for triggering actions`;\n }\n\n if (hasValue) {\n return `Form ${words} for user input`;\n }\n\n if (hasChildren) {\n return `Container ${words} for grouping content`;\n }\n\n return `${words.charAt(0).toUpperCase() + words.slice(1)} component`;\n}\n\n/**\n * Infer accessibility from props\n */\nfunction inferAccessibility(props: Record<string, unknown>): {\n role?: string;\n requirements?: string[];\n} {\n const accessibility: { role?: string; requirements?: string[] } = {};\n\n const hasOnClick = \"onClick\" in props || \"onPress\" in props;\n const hasAriaLabel = \"ariaLabel\" in props || \"aria-label\" in props;\n const hasDisabled = \"disabled\" in props;\n const hasHref = \"href\" in props;\n\n if (hasOnClick && !hasHref) {\n accessibility.role = \"button\";\n } else if (hasHref) {\n accessibility.role = \"link\";\n }\n\n const requirements: string[] = [];\n\n if (hasOnClick && !hasAriaLabel) {\n requirements.push(\"Should have visible text or aria-label\");\n }\n\n if (hasDisabled) {\n requirements.push(\"Disabled state should be conveyed to assistive technology\");\n }\n\n if (requirements.length > 0) {\n accessibility.requirements = requirements;\n }\n\n return accessibility;\n}\n\n/**\n * Infer status from file path\n */\nfunction inferStatus(\n filePath: string\n): \"draft\" | \"experimental\" | \"beta\" | \"stable\" | \"deprecated\" {\n const lowerPath = filePath.toLowerCase();\n\n if (lowerPath.includes(\"/experimental/\") || lowerPath.includes(\"/labs/\")) {\n return \"experimental\";\n }\n if (lowerPath.includes(\"/beta/\")) {\n return \"beta\";\n }\n if (lowerPath.includes(\"/deprecated/\") || lowerPath.includes(\"/legacy/\")) {\n return \"deprecated\";\n }\n if (lowerPath.includes(\"/draft/\") || lowerPath.includes(\"/wip/\")) {\n return \"draft\";\n }\n\n return \"stable\";\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/commands/generate.ts"],"sourcesContent":["/**\n * fragments generate - Generate fragment files from component source code\n *\n * Analyzes component source code and generates proper defineFragment() TSX files\n * colocated next to the component source. These files are parseable by the\n * build command and renderable by the dev viewer.\n */\n\nimport { readFile, writeFile, access } from \"node:fs/promises\";\nimport { resolve, basename, dirname, relative, join } from \"node:path\";\nimport pc from \"picocolors\";\nimport fg from \"fast-glob\";\nimport { BRAND } from \"../core/index.js\";\nimport { extractPropsFromFile } from \"../core/node.js\";\n\nexport interface GenerateOptions {\n /** Project root directory */\n projectRoot?: string;\n /** Specific component name to generate (optional) */\n component?: string;\n /** Overwrite existing fragment files */\n force?: boolean;\n /** Pattern for component files */\n componentPattern?: string;\n}\n\nexport interface GenerateResult {\n success: boolean;\n generated: Array<{ name: string; path: string }>;\n skipped: Array<{ name: string; reason: string }>;\n errors: Array<{ name: string; error: string }>;\n}\n\n/**\n * Generate fragment files from component source code\n */\nexport async function generate(options: GenerateOptions = {}): Promise<GenerateResult> {\n const projectRoot = resolve(options.projectRoot || process.cwd());\n const generated: Array<{ name: string; path: string }> = [];\n const skipped: Array<{ name: string; reason: string }> = [];\n const errors: Array<{ name: string; error: string }> = [];\n\n console.log(pc.cyan(`\\n${BRAND.name} Generate\\n`));\n\n // Find component files\n const componentPattern =\n options.componentPattern ||\n \"src/components/**/*.tsx\";\n\n const componentFiles = await fg(componentPattern, {\n cwd: projectRoot,\n ignore: [\n \"**/node_modules/**\",\n \"**/*.stories.*\",\n \"**/*.fragment.*\",\n \"**/*.test.*\",\n \"**/*.spec.*\",\n \"**/*.d.ts\",\n \"**/index.tsx\", // Often just re-exports\n ],\n absolute: true,\n });\n\n // Find story files for pattern inference\n const storyFiles = await fg([\"src/**/*.stories.tsx\", \"src/**/*.stories.ts\"], {\n cwd: projectRoot,\n ignore: [\"**/node_modules/**\"],\n absolute: true,\n });\n\n // Build story map for pattern inference (names + args)\n const storyMap = new Map<string, StoryVariant[]>();\n for (const storyFile of storyFiles) {\n try {\n const content = await readFile(storyFile, \"utf-8\");\n const componentName = extractComponentNameFromStory(content, storyFile);\n if (componentName) {\n const variants = extractStoryVariants(content);\n storyMap.set(componentName, variants);\n }\n } catch {\n // Ignore parsing errors\n }\n }\n\n console.log(pc.dim(`Found ${componentFiles.length} component files\\n`));\n\n // Process each component file\n for (const filePath of componentFiles) {\n try {\n const extracted = extractPropsFromFile(filePath);\n\n if (!extracted || !extracted.componentName) {\n continue;\n }\n\n const componentName = extracted.componentName;\n\n // Filter by component name if specified\n if (options.component && componentName !== options.component) {\n continue;\n }\n\n // Write fragment file colocated next to the component source\n const componentDir = dirname(filePath);\n const componentBaseName = basename(filePath, \".tsx\");\n const fragmentPath = join(componentDir, `${componentBaseName}${BRAND.fileExtension}`);\n\n let fragmentExists = false;\n try {\n await access(fragmentPath);\n fragmentExists = true;\n } catch {\n // Fragment doesn't exist\n }\n\n if (fragmentExists && !options.force) {\n skipped.push({ name: componentName, reason: \"Fragment already exists\" });\n console.log(pc.dim(` Skipping ${componentName} (fragment exists)`));\n continue;\n }\n\n // Generate proper defineFragment() TSX content\n const storyVariants = storyMap.get(componentName) || [];\n const fragmentContent = generateFragmentTsx(\n componentName,\n componentBaseName,\n extracted,\n filePath,\n storyVariants\n );\n\n // Write fragment file\n await writeFile(fragmentPath, fragmentContent, \"utf-8\");\n generated.push({ name: componentName, path: relative(projectRoot, fragmentPath) });\n console.log(pc.green(` ✓ Generated ${componentName}${BRAND.fileExtension}`));\n } catch (e) {\n const fileName = basename(filePath);\n errors.push({\n name: fileName,\n error: e instanceof Error ? e.message : String(e),\n });\n console.log(pc.red(` ✗ Failed: ${fileName}`));\n }\n }\n\n // Summary\n console.log();\n if (generated.length > 0) {\n console.log(pc.green(`✓ Generated ${generated.length} fragment(s)`));\n }\n if (skipped.length > 0) {\n console.log(pc.dim(` Skipped ${skipped.length} (use --force to overwrite)`));\n }\n if (errors.length > 0) {\n console.log(pc.yellow(` ${errors.length} error(s)`));\n }\n console.log();\n\n return {\n success: errors.length === 0,\n generated,\n skipped,\n errors,\n };\n}\n\n/**\n * Generate proper defineFragment() TSX file content\n */\nfunction generateFragmentTsx(\n componentName: string,\n componentBaseName: string,\n extracted: ReturnType<typeof extractPropsFromFile> & { componentName: string },\n filePath: string,\n storyVariants: StoryVariant[]\n): string {\n const storyNames = storyVariants.map((v) => v.name);\n const whenToUse = inferUsageFromStories(storyNames);\n const description = generateDescription(componentName, extracted.props);\n const status = inferStatus(filePath);\n const accessibility = inferAccessibility(extracted.props);\n\n // Build props object for defineFragment\n const propsEntries = Object.entries(extracted.props || {});\n\n // Format when array\n const whenLines = whenToUse.length > 0\n ? whenToUse.map((w) => ` '${escapeQuotes(w)}',`).join(\"\\n\")\n : ` 'TODO: describe when to use ${componentName}',`;\n\n // Format props\n let propsBlock = \"{}\";\n if (propsEntries.length > 0) {\n const propLines = propsEntries.map(([name, info]) => {\n const propInfo = info as Record<string, unknown>;\n const rawType = propInfo.type ? String(propInfo.type) : \"\";\n const classified = classifyPropType(rawType);\n const desc = propInfo.description ? String(propInfo.description).replace(/\\n/g, \" \") : \"\";\n const required = propInfo.required ? \"true\" : \"false\";\n const parts = [` type: '${classified.type}'`];\n if (desc) parts.push(` description: '${escapeQuotes(desc)}'`);\n parts.push(` required: ${required}`);\n if (propInfo.default !== undefined) {\n parts.push(` default: ${JSON.stringify(propInfo.default)}`);\n }\n // Use classified values (from string literal unions) or existing values\n const values = classified.values || (propInfo.values && Array.isArray(propInfo.values) ? propInfo.values : null);\n if (values && values.length > 0) {\n parts.push(` values: ${JSON.stringify(values)}`);\n }\n return ` ${name}: {\\n${parts.join(\",\\n\")},\\n }`;\n });\n propsBlock = `{\\n${propLines.join(\",\\n\")},\\n }`;\n }\n\n // Build accessibility section\n let accessibilityBlock = \"\";\n if (accessibility.role || (accessibility.requirements && accessibility.requirements.length > 0)) {\n const parts: string[] = [];\n if (accessibility.role) {\n parts.push(` role: '${accessibility.role}'`);\n }\n if (accessibility.requirements && accessibility.requirements.length > 0) {\n const reqs = accessibility.requirements.map((r) => `'${escapeQuotes(r)}'`).join(\", \");\n parts.push(` requirements: [${reqs}]`);\n }\n accessibilityBlock = `\n\n accessibility: {\n${parts.join(\",\\n\")},\n },`;\n }\n\n // Build variants from story args or fallback to bare render\n const variants = buildVariants(componentName, storyVariants);\n\n // Use default import when the source component uses export default\n const componentImportStatement = extracted.isDefaultExport\n ? `import ${componentName} from './${componentBaseName}';`\n : `import { ${componentName} } from './${componentBaseName}';`;\n\n return `import React from 'react';\nimport { defineFragment } from '@fragments-sdk/cli/core';\n${componentImportStatement}\n\nexport default defineFragment({\n component: ${componentName},\n\n meta: {\n name: '${escapeQuotes(componentName)}',\n description: '${escapeQuotes(description)}',\n category: '${inferCategory(componentName, extracted.props)}',\n status: '${status}',\n },\n\n usage: {\n when: [\n${whenLines}\n ],\n whenNot: [],\n },\n\n props: ${propsBlock},${accessibilityBlock}\n\n variants: [\n${variants}\n ],\n});\n`;\n}\n\n/**\n * Escape single quotes in strings\n */\nfunction escapeQuotes(str: string): string {\n return str.replace(/'/g, \"\\\\'\");\n}\n\n/**\n * Classify a raw TypeScript type string into a valid fragment prop type enum value.\n * Returns the classified type and optionally extracted enum values.\n */\nfunction classifyPropType(rawType: string): { type: string; values?: string[] } {\n const t = rawType.replace(/\\s+/g, \" \").trim();\n const lower = t.toLowerCase();\n\n // Direct primitive matches\n if (lower === \"string\") return { type: \"string\" };\n if (lower === \"number\") return { type: \"number\" };\n if (lower === \"boolean\" || lower === \"bool\") return { type: \"boolean\" };\n\n // String/number literal unions → enum with values\n // e.g., '\"primary\" | \"secondary\"' or \"'default' | 'modal'\"\n if (/^[\"'][^\"']*[\"'](\\s*\\|\\s*[\"'][^\"']*[\"'])*$/.test(t)) {\n const values = [...t.matchAll(/[\"']([^\"']+)[\"']/g)].map((m) => m[1]);\n if (values.length > 0) return { type: \"enum\", values };\n }\n\n // Function types — arrow functions, callbacks, handlers, dispatchers\n if (\n lower.includes(\"=>\") ||\n lower.includes(\"handler\") ||\n lower.includes(\"callback\") ||\n lower.includes(\"dispatch\") ||\n lower.includes(\"listener\") ||\n /^\\(/.test(t)\n ) {\n return { type: \"function\" };\n }\n\n // React node types\n if (\n lower.includes(\"reactnode\") ||\n lower.includes(\"react.reactnode\") ||\n lower === \"node\"\n ) {\n return { type: \"node\" };\n }\n\n // React element types\n if (\n lower.includes(\"reactelement\") ||\n lower.includes(\"react.reactelement\") ||\n lower.includes(\"jsx.element\")\n ) {\n return { type: \"element\" };\n }\n\n // Array types\n if (lower.includes(\"[]\") || lower.startsWith(\"array<\") || lower.startsWith(\"readonly \")) {\n return { type: \"array\" };\n }\n\n // Object types (must come after array check since objects can contain [])\n if (lower.startsWith(\"{\") || lower.includes(\"record<\") || lower === \"object\") {\n return { type: \"object\" };\n }\n\n // Union types (mixed types with |)\n if (lower.includes(\"|\")) {\n // Check if it's a union of just string literals (enum)\n const parts = t.split(\"|\").map((p) => p.trim());\n const allStringLiterals = parts.every((p) => /^[\"'].*[\"']$/.test(p));\n if (allStringLiterals) {\n const values = parts.map((p) => p.replace(/^[\"']|[\"']$/g, \"\"));\n return { type: \"enum\", values };\n }\n return { type: \"union\" };\n }\n\n // Anything else\n return { type: \"custom\" };\n}\n\n/**\n * Infer category from component name and props\n */\nfunction inferCategory(componentName: string, props: Record<string, unknown>): string {\n const lower = componentName.toLowerCase();\n\n const categoryPatterns: Record<string, string[]> = {\n \"Actions\": [\"button\", \"action\", \"cta\", \"fab\", \"floatingaction\"],\n \"Forms\": [\"form\", \"input\", \"select\", \"checkbox\", \"radio\", \"textarea\", \"field\", \"textfield\", \"datepicker\", \"switch\", \"slider\", \"segmented\"],\n \"Layout\": [\"layout\", \"container\", \"grid\", \"flex\", \"stack\", \"box\", \"divider\", \"spacer\", \"sidebar\"],\n \"Navigation\": [\"nav\", \"menu\", \"breadcrumb\", \"tab\", \"link\", \"pagination\", \"stepper\", \"topbar\"],\n \"Feedback\": [\"alert\", \"toast\", \"notification\", \"message\", \"badge\", \"indicator\", \"progress\", \"spinner\", \"loading\", \"loader\", \"lozenge\", \"chip\"],\n \"Data Display\": [\"table\", \"list\", \"card\", \"avatar\", \"stat\", \"timeline\", \"tree\", \"datalist\", \"datacard\"],\n \"Overlays\": [\"modal\", \"dialog\", \"drawer\", \"popover\", \"tooltip\", \"dropdown\", \"slidepanel\"],\n \"Typography\": [\"text\", \"heading\", \"title\", \"label\", \"paragraph\"],\n \"Media\": [\"image\", \"video\", \"icon\", \"carousel\"],\n };\n\n for (const [category, patterns] of Object.entries(categoryPatterns)) {\n for (const pattern of patterns) {\n if (lower.includes(pattern)) {\n return category;\n }\n }\n }\n\n if (\"onClick\" in props || \"onPress\" in props) return \"Actions\";\n if (\"value\" in props || \"defaultValue\" in props) return \"Forms\";\n if (\"children\" in props) return \"Layout\";\n\n return \"Components\";\n}\n\n/**\n * Extract component name from story file\n */\nfunction extractComponentNameFromStory(content: string, filePath: string): string | null {\n const titleMatch = content.match(/title:\\s*['\"](?:[^'\"]+\\/)?([^'\"]+)['\"]/);\n if (titleMatch) {\n return titleMatch[1];\n }\n\n const fileName = basename(filePath);\n const componentName = fileName.replace(/\\.stories\\.(tsx?|jsx?)$/, \"\");\n if (/^[A-Z]/.test(componentName)) {\n return componentName;\n }\n\n return null;\n}\n\ninterface StoryVariant {\n name: string;\n args: Record<string, unknown>;\n}\n\n/**\n * Extract story names and their args from story file content (CSF3 format).\n * Parses patterns like:\n * export const Primary: Story = { args: { variant: 'primary', children: 'Click me' } }\n */\nfunction extractStoryVariants(content: string): StoryVariant[] {\n const variants: StoryVariant[] = [];\n\n const exportMatches = content.matchAll(\n /export\\s+const\\s+([A-Z][a-zA-Z0-9]*)\\s*[=:]/g\n );\n\n for (const match of exportMatches) {\n const name = match[1];\n if (name === \"default\" || name.endsWith(\"Args\") || name.endsWith(\"Meta\")) {\n continue;\n }\n\n const args = extractStoryArgs(content, name);\n variants.push({ name, args });\n }\n\n return variants;\n}\n\n/**\n * Extract the `args` object from a named story export.\n * Uses balanced-brace matching to handle nested objects.\n */\nfunction extractStoryArgs(content: string, storyName: string): Record<string, unknown> {\n // Find the story export and look for an args block\n const storyPattern = new RegExp(\n `export\\\\s+const\\\\s+${storyName}[^=]*=\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\n\\\\};`,\n );\n const storyMatch = content.match(storyPattern);\n if (!storyMatch) return {};\n\n const storyBody = storyMatch[1];\n\n // Find the args block within the story body\n const argsStart = storyBody.indexOf('args:');\n if (argsStart === -1) return {};\n\n // Find the opening brace after \"args:\"\n const braceStart = storyBody.indexOf('{', argsStart);\n if (braceStart === -1) return {};\n\n // Balanced brace matching to find the full args object\n let depth = 0;\n let braceEnd = -1;\n for (let i = braceStart; i < storyBody.length; i++) {\n if (storyBody[i] === '{') depth++;\n else if (storyBody[i] === '}') {\n depth--;\n if (depth === 0) {\n braceEnd = i;\n break;\n }\n }\n }\n if (braceEnd === -1) return {};\n\n const argsBlock = storyBody.slice(braceStart + 1, braceEnd).trim();\n return parseArgsBlock(argsBlock);\n}\n\n/**\n * Parse a simplified args block into key-value pairs.\n * Handles string literals, numbers, booleans, and simple expressions.\n */\nfunction parseArgsBlock(argsBlock: string): Record<string, unknown> {\n const args: Record<string, unknown> = {};\n\n // Match key: value pairs (handles string, number, boolean values)\n const pairPattern = /(\\w+)\\s*:\\s*(?:['\"]([^'\"]*?)['\"]|(true|false)|(\\d+(?:\\.\\d+)?))/g;\n let pairMatch: RegExpExecArray | null;\n\n while ((pairMatch = pairPattern.exec(argsBlock)) !== null) {\n const key = pairMatch[1];\n if (pairMatch[2] !== undefined) {\n // String value\n args[key] = pairMatch[2];\n } else if (pairMatch[3] !== undefined) {\n // Boolean\n args[key] = pairMatch[3] === 'true';\n } else if (pairMatch[4] !== undefined) {\n // Number\n args[key] = Number(pairMatch[4]);\n }\n }\n\n return args;\n}\n\n/**\n * Build variant entries from story args.\n * If stories have args, generates JSX with those props.\n * Falls back to a bare `<Component />` for the Default variant.\n */\nfunction buildVariants(componentName: string, storyVariants: StoryVariant[]): string {\n // Filter to variants with args, plus always include a Default\n const hasDefault = storyVariants.some((v) => v.name === 'Default');\n const entries: string[] = [];\n\n if (!hasDefault) {\n entries.push(formatVariantEntry(componentName, 'Default', `Default ${componentName}`, {}));\n }\n\n for (const variant of storyVariants) {\n const description = variant.name\n .replace(/([A-Z])/g, ' $1')\n .trim();\n entries.push(formatVariantEntry(componentName, variant.name, `${description} ${componentName}`, variant.args));\n }\n\n // Deduplicate: if stories provided a Default, don't double-add\n return entries.join('\\n');\n}\n\n/**\n * Format a single variant entry with JSX code and render function.\n * Handles `children` as JSX children, all other args as props.\n */\nfunction formatVariantEntry(\n componentName: string,\n name: string,\n description: string,\n args: Record<string, unknown>\n): string {\n const jsxCode = buildJsxString(componentName, args);\n return ` {\n name: '${escapeQuotes(name)}',\n description: '${escapeQuotes(description)}',\n code: \\`${jsxCode}\\`,\n render: () => ${jsxCode},\n },`;\n}\n\n/**\n * Build a JSX string from component name and args.\n * `children` string args become JSX children, others become props.\n */\nfunction buildJsxString(componentName: string, args: Record<string, unknown>): string {\n const { children, ...restArgs } = args;\n const propParts: string[] = [];\n\n for (const [key, value] of Object.entries(restArgs)) {\n if (typeof value === 'string') {\n propParts.push(`${key}=\"${escapeQuotes(value)}\"`);\n } else if (typeof value === 'boolean') {\n propParts.push(value ? key : `${key}={false}`);\n } else if (typeof value === 'number') {\n propParts.push(`${key}={${value}}`);\n }\n }\n\n const propsStr = propParts.length > 0 ? ' ' + propParts.join(' ') : '';\n\n if (typeof children === 'string') {\n return `<${componentName}${propsStr}>${children}</${componentName}>`;\n }\n\n return `<${componentName}${propsStr} />`;\n}\n\n/**\n * Infer usage scenarios from story names\n */\nfunction inferUsageFromStories(storyNames: string[]): string[] {\n const usage: string[] = [];\n\n for (const name of storyNames) {\n const sentence = name\n .replace(/([A-Z])/g, \" $1\")\n .trim()\n .toLowerCase();\n\n if (\n [\"default\", \"primary\", \"basic\", \"example\", \"playground\"].includes(\n sentence.toLowerCase()\n )\n ) {\n continue;\n }\n\n if (sentence.includes(\"loading\")) {\n usage.push(\"Showing loading states\");\n } else if (sentence.includes(\"disabled\")) {\n usage.push(\"Preventing user interaction\");\n } else if (sentence.includes(\"error\")) {\n usage.push(\"Displaying error states\");\n } else if (sentence.includes(\"success\")) {\n usage.push(\"Showing success feedback\");\n } else if (sentence.includes(\"empty\")) {\n usage.push(\"Handling empty states\");\n } else if (sentence.includes(\"with\")) {\n const withPart = sentence.replace(\"with \", \"\");\n usage.push(`Displaying with ${withPart}`);\n }\n }\n\n return usage;\n}\n\n/**\n * Generate description from component name and props\n */\nfunction generateDescription(\n componentName: string,\n props: Record<string, unknown>\n): string {\n const words = componentName\n .replace(/([A-Z])/g, \" $1\")\n .trim()\n .toLowerCase();\n\n const hasOnClick = \"onClick\" in props || \"onPress\" in props;\n const hasValue = \"value\" in props || \"defaultValue\" in props;\n const hasChildren = \"children\" in props;\n\n if (hasOnClick && !hasValue) {\n return `Interactive ${words} element for triggering actions`;\n }\n\n if (hasValue) {\n return `Form ${words} for user input`;\n }\n\n if (hasChildren) {\n return `Container ${words} for grouping content`;\n }\n\n return `${words.charAt(0).toUpperCase() + words.slice(1)} component`;\n}\n\n/**\n * Infer accessibility from props\n */\nfunction inferAccessibility(props: Record<string, unknown>): {\n role?: string;\n requirements?: string[];\n} {\n const accessibility: { role?: string; requirements?: string[] } = {};\n\n const hasOnClick = \"onClick\" in props || \"onPress\" in props;\n const hasAriaLabel = \"ariaLabel\" in props || \"aria-label\" in props;\n const hasDisabled = \"disabled\" in props;\n const hasHref = \"href\" in props;\n\n if (hasOnClick && !hasHref) {\n accessibility.role = \"button\";\n } else if (hasHref) {\n accessibility.role = \"link\";\n }\n\n const requirements: string[] = [];\n\n if (hasOnClick && !hasAriaLabel) {\n requirements.push(\"Should have visible text or aria-label\");\n }\n\n if (hasDisabled) {\n requirements.push(\"Disabled state should be conveyed to assistive technology\");\n }\n\n if (requirements.length > 0) {\n accessibility.requirements = requirements;\n }\n\n return accessibility;\n}\n\n/**\n * Infer status from file path\n */\nfunction inferStatus(\n filePath: string\n): \"draft\" | \"experimental\" | \"beta\" | \"stable\" | \"deprecated\" {\n const lowerPath = filePath.toLowerCase();\n\n if (lowerPath.includes(\"/experimental/\") || lowerPath.includes(\"/labs/\")) {\n return \"experimental\";\n }\n if (lowerPath.includes(\"/beta/\")) {\n return \"beta\";\n }\n if (lowerPath.includes(\"/deprecated/\") || lowerPath.includes(\"/legacy/\")) {\n return \"deprecated\";\n }\n if (lowerPath.includes(\"/draft/\") || lowerPath.includes(\"/wip/\")) {\n return \"draft\";\n }\n\n return \"stable\";\n}\n"],"mappings":";;;;;;;;;;AAQA,SAAS,UAAU,WAAW,cAAc;AAC5C,SAAS,SAAS,UAAU,SAAS,UAAU,YAAY;AAC3D,OAAO,QAAQ;AACf,OAAO,QAAQ;AAyBf,eAAsB,SAAS,UAA2B,CAAC,GAA4B;AACrF,QAAM,cAAc,QAAQ,QAAQ,eAAe,QAAQ,IAAI,CAAC;AAChE,QAAM,YAAmD,CAAC;AAC1D,QAAM,UAAmD,CAAC;AAC1D,QAAM,SAAiD,CAAC;AAExD,UAAQ,IAAI,GAAG,KAAK;AAAA,EAAK,MAAM,IAAI;AAAA,CAAa,CAAC;AAGjD,QAAM,mBACJ,QAAQ,oBACR;AAEF,QAAM,iBAAiB,MAAM,GAAG,kBAAkB;AAAA,IAChD,KAAK;AAAA,IACL,QAAQ;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,IACF;AAAA,IACA,UAAU;AAAA,EACZ,CAAC;AAGD,QAAM,aAAa,MAAM,GAAG,CAAC,wBAAwB,qBAAqB,GAAG;AAAA,IAC3E,KAAK;AAAA,IACL,QAAQ,CAAC,oBAAoB;AAAA,IAC7B,UAAU;AAAA,EACZ,CAAC;AAGD,QAAM,WAAW,oBAAI,IAA4B;AACjD,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,YAAM,UAAU,MAAM,SAAS,WAAW,OAAO;AACjD,YAAM,gBAAgB,8BAA8B,SAAS,SAAS;AACtE,UAAI,eAAe;AACjB,cAAM,WAAW,qBAAqB,OAAO;AAC7C,iBAAS,IAAI,eAAe,QAAQ;AAAA,MACtC;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,UAAQ,IAAI,GAAG,IAAI,SAAS,eAAe,MAAM;AAAA,CAAoB,CAAC;AAGtE,aAAW,YAAY,gBAAgB;AACrC,QAAI;AACF,YAAM,YAAY,qBAAqB,QAAQ;AAE/C,UAAI,CAAC,aAAa,CAAC,UAAU,eAAe;AAC1C;AAAA,MACF;AAEA,YAAM,gBAAgB,UAAU;AAGhC,UAAI,QAAQ,aAAa,kBAAkB,QAAQ,WAAW;AAC5D;AAAA,MACF;AAGA,YAAM,eAAe,QAAQ,QAAQ;AACrC,YAAM,oBAAoB,SAAS,UAAU,MAAM;AACnD,YAAM,eAAe,KAAK,cAAc,GAAG,iBAAiB,GAAG,MAAM,aAAa,EAAE;AAEpF,UAAI,iBAAiB;AACrB,UAAI;AACF,cAAM,OAAO,YAAY;AACzB,yBAAiB;AAAA,MACnB,QAAQ;AAAA,MAER;AAEA,UAAI,kBAAkB,CAAC,QAAQ,OAAO;AACpC,gBAAQ,KAAK,EAAE,MAAM,eAAe,QAAQ,0BAA0B,CAAC;AACvE,gBAAQ,IAAI,GAAG,IAAI,cAAc,aAAa,oBAAoB,CAAC;AACnE;AAAA,MACF;AAGA,YAAM,gBAAgB,SAAS,IAAI,aAAa,KAAK,CAAC;AACtD,YAAM,kBAAkB;AAAA,QACtB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAGA,YAAM,UAAU,cAAc,iBAAiB,OAAO;AACtD,gBAAU,KAAK,EAAE,MAAM,eAAe,MAAM,SAAS,aAAa,YAAY,EAAE,CAAC;AACjF,cAAQ,IAAI,GAAG,MAAM,sBAAiB,aAAa,GAAG,MAAM,aAAa,EAAE,CAAC;AAAA,IAC9E,SAAS,GAAG;AACV,YAAM,WAAW,SAAS,QAAQ;AAClC,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,OAAO,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AAAA,MAClD,CAAC;AACD,cAAQ,IAAI,GAAG,IAAI,oBAAe,QAAQ,EAAE,CAAC;AAAA,IAC/C;AAAA,EACF;AAGA,UAAQ,IAAI;AACZ,MAAI,UAAU,SAAS,GAAG;AACxB,YAAQ,IAAI,GAAG,MAAM,oBAAe,UAAU,MAAM,cAAc,CAAC;AAAA,EACrE;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,YAAQ,IAAI,GAAG,IAAI,aAAa,QAAQ,MAAM,6BAA6B,CAAC;AAAA,EAC9E;AACA,MAAI,OAAO,SAAS,GAAG;AACrB,YAAQ,IAAI,GAAG,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAAA,EACtD;AACA,UAAQ,IAAI;AAEZ,SAAO;AAAA,IACL,SAAS,OAAO,WAAW;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAKA,SAAS,oBACP,eACA,mBACA,WACA,UACA,eACQ;AACR,QAAM,aAAa,cAAc,IAAI,CAAC,MAAM,EAAE,IAAI;AAClD,QAAM,YAAY,sBAAsB,UAAU;AAClD,QAAM,cAAc,oBAAoB,eAAe,UAAU,KAAK;AACtE,QAAM,SAAS,YAAY,QAAQ;AACnC,QAAM,gBAAgB,mBAAmB,UAAU,KAAK;AAGxD,QAAM,eAAe,OAAO,QAAQ,UAAU,SAAS,CAAC,CAAC;AAGzD,QAAM,YAAY,UAAU,SAAS,IACjC,UAAU,IAAI,CAAC,MAAM,UAAU,aAAa,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,IAC7D,qCAAqC,aAAa;AAGtD,MAAI,aAAa;AACjB,MAAI,aAAa,SAAS,GAAG;AAC3B,UAAM,YAAY,aAAa,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM;AACnD,YAAM,WAAW;AACjB,YAAM,UAAU,SAAS,OAAO,OAAO,SAAS,IAAI,IAAI;AACxD,YAAM,aAAa,iBAAiB,OAAO;AAC3C,YAAM,OAAO,SAAS,cAAc,OAAO,SAAS,WAAW,EAAE,QAAQ,OAAO,GAAG,IAAI;AACvF,YAAM,WAAW,SAAS,WAAW,SAAS;AAC9C,YAAM,QAAQ,CAAC,gBAAgB,WAAW,IAAI,GAAG;AACjD,UAAI,KAAM,OAAM,KAAK,uBAAuB,aAAa,IAAI,CAAC,GAAG;AACjE,YAAM,KAAK,mBAAmB,QAAQ,EAAE;AACxC,UAAI,SAAS,YAAY,QAAW;AAClC,cAAM,KAAK,kBAAkB,KAAK,UAAU,SAAS,OAAO,CAAC,EAAE;AAAA,MACjE;AAEA,YAAM,SAAS,WAAW,WAAW,SAAS,UAAU,MAAM,QAAQ,SAAS,MAAM,IAAI,SAAS,SAAS;AAC3G,UAAI,UAAU,OAAO,SAAS,GAAG;AAC/B,cAAM,KAAK,iBAAiB,KAAK,UAAU,MAAM,CAAC,EAAE;AAAA,MACtD;AACA,aAAO,OAAO,IAAI;AAAA,EAAQ,MAAM,KAAK,KAAK,CAAC;AAAA;AAAA,IAC7C,CAAC;AACD,iBAAa;AAAA,EAAM,UAAU,KAAK,KAAK,CAAC;AAAA;AAAA,EAC1C;AAGA,MAAI,qBAAqB;AACzB,MAAI,cAAc,QAAS,cAAc,gBAAgB,cAAc,aAAa,SAAS,GAAI;AAC/F,UAAM,QAAkB,CAAC;AACzB,QAAI,cAAc,MAAM;AACtB,YAAM,KAAK,cAAc,cAAc,IAAI,GAAG;AAAA,IAChD;AACA,QAAI,cAAc,gBAAgB,cAAc,aAAa,SAAS,GAAG;AACvE,YAAM,OAAO,cAAc,aAAa,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,GAAG,EAAE,KAAK,IAAI;AACpF,YAAM,KAAK,sBAAsB,IAAI,GAAG;AAAA,IAC1C;AACA,yBAAqB;AAAA;AAAA;AAAA,EAGvB,MAAM,KAAK,KAAK,CAAC;AAAA;AAAA,EAEjB;AAGA,QAAM,WAAW,cAAc,eAAe,aAAa;AAG3D,QAAM,2BAA2B,UAAU,kBACvC,UAAU,aAAa,YAAY,iBAAiB,OACpD,YAAY,aAAa,cAAc,iBAAiB;AAE5D,SAAO;AAAA;AAAA,EAEP,wBAAwB;AAAA;AAAA;AAAA,eAGX,aAAa;AAAA;AAAA;AAAA,aAGf,aAAa,aAAa,CAAC;AAAA,oBACpB,aAAa,WAAW,CAAC;AAAA,iBAC5B,cAAc,eAAe,UAAU,KAAK,CAAC;AAAA,eAC/C,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,EAKnB,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,WAKA,UAAU,IAAI,kBAAkB;AAAA;AAAA;AAAA,EAGzC,QAAQ;AAAA;AAAA;AAAA;AAIV;AAKA,SAAS,aAAa,KAAqB;AACzC,SAAO,IAAI,QAAQ,MAAM,KAAK;AAChC;AAMA,SAAS,iBAAiB,SAAsD;AAC9E,QAAM,IAAI,QAAQ,QAAQ,QAAQ,GAAG,EAAE,KAAK;AAC5C,QAAM,QAAQ,EAAE,YAAY;AAG5B,MAAI,UAAU,SAAU,QAAO,EAAE,MAAM,SAAS;AAChD,MAAI,UAAU,SAAU,QAAO,EAAE,MAAM,SAAS;AAChD,MAAI,UAAU,aAAa,UAAU,OAAQ,QAAO,EAAE,MAAM,UAAU;AAItE,MAAI,4CAA4C,KAAK,CAAC,GAAG;AACvD,UAAM,SAAS,CAAC,GAAG,EAAE,SAAS,mBAAmB,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACnE,QAAI,OAAO,SAAS,EAAG,QAAO,EAAE,MAAM,QAAQ,OAAO;AAAA,EACvD;AAGA,MACE,MAAM,SAAS,IAAI,KACnB,MAAM,SAAS,SAAS,KACxB,MAAM,SAAS,UAAU,KACzB,MAAM,SAAS,UAAU,KACzB,MAAM,SAAS,UAAU,KACzB,MAAM,KAAK,CAAC,GACZ;AACA,WAAO,EAAE,MAAM,WAAW;AAAA,EAC5B;AAGA,MACE,MAAM,SAAS,WAAW,KAC1B,MAAM,SAAS,iBAAiB,KAChC,UAAU,QACV;AACA,WAAO,EAAE,MAAM,OAAO;AAAA,EACxB;AAGA,MACE,MAAM,SAAS,cAAc,KAC7B,MAAM,SAAS,oBAAoB,KACnC,MAAM,SAAS,aAAa,GAC5B;AACA,WAAO,EAAE,MAAM,UAAU;AAAA,EAC3B;AAGA,MAAI,MAAM,SAAS,IAAI,KAAK,MAAM,WAAW,QAAQ,KAAK,MAAM,WAAW,WAAW,GAAG;AACvF,WAAO,EAAE,MAAM,QAAQ;AAAA,EACzB;AAGA,MAAI,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,SAAS,KAAK,UAAU,UAAU;AAC5E,WAAO,EAAE,MAAM,SAAS;AAAA,EAC1B;AAGA,MAAI,MAAM,SAAS,GAAG,GAAG;AAEvB,UAAM,QAAQ,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AAC9C,UAAM,oBAAoB,MAAM,MAAM,CAAC,MAAM,eAAe,KAAK,CAAC,CAAC;AACnE,QAAI,mBAAmB;AACrB,YAAM,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,gBAAgB,EAAE,CAAC;AAC7D,aAAO,EAAE,MAAM,QAAQ,OAAO;AAAA,IAChC;AACA,WAAO,EAAE,MAAM,QAAQ;AAAA,EACzB;AAGA,SAAO,EAAE,MAAM,SAAS;AAC1B;AAKA,SAAS,cAAc,eAAuB,OAAwC;AACpF,QAAM,QAAQ,cAAc,YAAY;AAExC,QAAM,mBAA6C;AAAA,IACjD,WAAW,CAAC,UAAU,UAAU,OAAO,OAAO,gBAAgB;AAAA,IAC9D,SAAS,CAAC,QAAQ,SAAS,UAAU,YAAY,SAAS,YAAY,SAAS,aAAa,cAAc,UAAU,UAAU,WAAW;AAAA,IACzI,UAAU,CAAC,UAAU,aAAa,QAAQ,QAAQ,SAAS,OAAO,WAAW,UAAU,SAAS;AAAA,IAChG,cAAc,CAAC,OAAO,QAAQ,cAAc,OAAO,QAAQ,cAAc,WAAW,QAAQ;AAAA,IAC5F,YAAY,CAAC,SAAS,SAAS,gBAAgB,WAAW,SAAS,aAAa,YAAY,WAAW,WAAW,UAAU,WAAW,MAAM;AAAA,IAC7I,gBAAgB,CAAC,SAAS,QAAQ,QAAQ,UAAU,QAAQ,YAAY,QAAQ,YAAY,UAAU;AAAA,IACtG,YAAY,CAAC,SAAS,UAAU,UAAU,WAAW,WAAW,YAAY,YAAY;AAAA,IACxF,cAAc,CAAC,QAAQ,WAAW,SAAS,SAAS,WAAW;AAAA,IAC/D,SAAS,CAAC,SAAS,SAAS,QAAQ,UAAU;AAAA,EAChD;AAEA,aAAW,CAAC,UAAU,QAAQ,KAAK,OAAO,QAAQ,gBAAgB,GAAG;AACnE,eAAW,WAAW,UAAU;AAC9B,UAAI,MAAM,SAAS,OAAO,GAAG;AAC3B,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEA,MAAI,aAAa,SAAS,aAAa,MAAO,QAAO;AACrD,MAAI,WAAW,SAAS,kBAAkB,MAAO,QAAO;AACxD,MAAI,cAAc,MAAO,QAAO;AAEhC,SAAO;AACT;AAKA,SAAS,8BAA8B,SAAiB,UAAiC;AACvF,QAAM,aAAa,QAAQ,MAAM,wCAAwC;AACzE,MAAI,YAAY;AACd,WAAO,WAAW,CAAC;AAAA,EACrB;AAEA,QAAM,WAAW,SAAS,QAAQ;AAClC,QAAM,gBAAgB,SAAS,QAAQ,2BAA2B,EAAE;AACpE,MAAI,SAAS,KAAK,aAAa,GAAG;AAChC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAYA,SAAS,qBAAqB,SAAiC;AAC7D,QAAM,WAA2B,CAAC;AAElC,QAAM,gBAAgB,QAAQ;AAAA,IAC5B;AAAA,EACF;AAEA,aAAW,SAAS,eAAe;AACjC,UAAM,OAAO,MAAM,CAAC;AACpB,QAAI,SAAS,aAAa,KAAK,SAAS,MAAM,KAAK,KAAK,SAAS,MAAM,GAAG;AACxE;AAAA,IACF;AAEA,UAAM,OAAO,iBAAiB,SAAS,IAAI;AAC3C,aAAS,KAAK,EAAE,MAAM,KAAK,CAAC;AAAA,EAC9B;AAEA,SAAO;AACT;AAMA,SAAS,iBAAiB,SAAiB,WAA4C;AAErF,QAAM,eAAe,IAAI;AAAA,IACvB,sBAAsB,SAAS;AAAA,EACjC;AACA,QAAM,aAAa,QAAQ,MAAM,YAAY;AAC7C,MAAI,CAAC,WAAY,QAAO,CAAC;AAEzB,QAAM,YAAY,WAAW,CAAC;AAG9B,QAAM,YAAY,UAAU,QAAQ,OAAO;AAC3C,MAAI,cAAc,GAAI,QAAO,CAAC;AAG9B,QAAM,aAAa,UAAU,QAAQ,KAAK,SAAS;AACnD,MAAI,eAAe,GAAI,QAAO,CAAC;AAG/B,MAAI,QAAQ;AACZ,MAAI,WAAW;AACf,WAAS,IAAI,YAAY,IAAI,UAAU,QAAQ,KAAK;AAClD,QAAI,UAAU,CAAC,MAAM,IAAK;AAAA,aACjB,UAAU,CAAC,MAAM,KAAK;AAC7B;AACA,UAAI,UAAU,GAAG;AACf,mBAAW;AACX;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,MAAI,aAAa,GAAI,QAAO,CAAC;AAE7B,QAAM,YAAY,UAAU,MAAM,aAAa,GAAG,QAAQ,EAAE,KAAK;AACjE,SAAO,eAAe,SAAS;AACjC;AAMA,SAAS,eAAe,WAA4C;AAClE,QAAM,OAAgC,CAAC;AAGvC,QAAM,cAAc;AACpB,MAAI;AAEJ,UAAQ,YAAY,YAAY,KAAK,SAAS,OAAO,MAAM;AACzD,UAAM,MAAM,UAAU,CAAC;AACvB,QAAI,UAAU,CAAC,MAAM,QAAW;AAE9B,WAAK,GAAG,IAAI,UAAU,CAAC;AAAA,IACzB,WAAW,UAAU,CAAC,MAAM,QAAW;AAErC,WAAK,GAAG,IAAI,UAAU,CAAC,MAAM;AAAA,IAC/B,WAAW,UAAU,CAAC,MAAM,QAAW;AAErC,WAAK,GAAG,IAAI,OAAO,UAAU,CAAC,CAAC;AAAA,IACjC;AAAA,EACF;AAEA,SAAO;AACT;AAOA,SAAS,cAAc,eAAuB,eAAuC;AAEnF,QAAM,aAAa,cAAc,KAAK,CAAC,MAAM,EAAE,SAAS,SAAS;AACjE,QAAM,UAAoB,CAAC;AAE3B,MAAI,CAAC,YAAY;AACf,YAAQ,KAAK,mBAAmB,eAAe,WAAW,WAAW,aAAa,IAAI,CAAC,CAAC,CAAC;AAAA,EAC3F;AAEA,aAAW,WAAW,eAAe;AACnC,UAAM,cAAc,QAAQ,KACzB,QAAQ,YAAY,KAAK,EACzB,KAAK;AACR,YAAQ,KAAK,mBAAmB,eAAe,QAAQ,MAAM,GAAG,WAAW,IAAI,aAAa,IAAI,QAAQ,IAAI,CAAC;AAAA,EAC/G;AAGA,SAAO,QAAQ,KAAK,IAAI;AAC1B;AAMA,SAAS,mBACP,eACA,MACA,aACA,MACQ;AACR,QAAM,UAAU,eAAe,eAAe,IAAI;AAClD,SAAO;AAAA,eACM,aAAa,IAAI,CAAC;AAAA,sBACX,aAAa,WAAW,CAAC;AAAA,gBAC/B,OAAO;AAAA,sBACD,OAAO;AAAA;AAE7B;AAMA,SAAS,eAAe,eAAuB,MAAuC;AACpF,QAAM,EAAE,UAAU,GAAG,SAAS,IAAI;AAClC,QAAM,YAAsB,CAAC;AAE7B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACnD,QAAI,OAAO,UAAU,UAAU;AAC7B,gBAAU,KAAK,GAAG,GAAG,KAAK,aAAa,KAAK,CAAC,GAAG;AAAA,IAClD,WAAW,OAAO,UAAU,WAAW;AACrC,gBAAU,KAAK,QAAQ,MAAM,GAAG,GAAG,UAAU;AAAA,IAC/C,WAAW,OAAO,UAAU,UAAU;AACpC,gBAAU,KAAK,GAAG,GAAG,KAAK,KAAK,GAAG;AAAA,IACpC;AAAA,EACF;AAEA,QAAM,WAAW,UAAU,SAAS,IAAI,MAAM,UAAU,KAAK,GAAG,IAAI;AAEpE,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO,IAAI,aAAa,GAAG,QAAQ,IAAI,QAAQ,KAAK,aAAa;AAAA,EACnE;AAEA,SAAO,IAAI,aAAa,GAAG,QAAQ;AACrC;AAKA,SAAS,sBAAsB,YAAgC;AAC7D,QAAM,QAAkB,CAAC;AAEzB,aAAW,QAAQ,YAAY;AAC7B,UAAM,WAAW,KACd,QAAQ,YAAY,KAAK,EACzB,KAAK,EACL,YAAY;AAEf,QACE,CAAC,WAAW,WAAW,SAAS,WAAW,YAAY,EAAE;AAAA,MACvD,SAAS,YAAY;AAAA,IACvB,GACA;AACA;AAAA,IACF;AAEA,QAAI,SAAS,SAAS,SAAS,GAAG;AAChC,YAAM,KAAK,wBAAwB;AAAA,IACrC,WAAW,SAAS,SAAS,UAAU,GAAG;AACxC,YAAM,KAAK,6BAA6B;AAAA,IAC1C,WAAW,SAAS,SAAS,OAAO,GAAG;AACrC,YAAM,KAAK,yBAAyB;AAAA,IACtC,WAAW,SAAS,SAAS,SAAS,GAAG;AACvC,YAAM,KAAK,0BAA0B;AAAA,IACvC,WAAW,SAAS,SAAS,OAAO,GAAG;AACrC,YAAM,KAAK,uBAAuB;AAAA,IACpC,WAAW,SAAS,SAAS,MAAM,GAAG;AACpC,YAAM,WAAW,SAAS,QAAQ,SAAS,EAAE;AAC7C,YAAM,KAAK,mBAAmB,QAAQ,EAAE;AAAA,IAC1C;AAAA,EACF;AAEA,SAAO;AACT;AAKA,SAAS,oBACP,eACA,OACQ;AACR,QAAM,QAAQ,cACX,QAAQ,YAAY,KAAK,EACzB,KAAK,EACL,YAAY;AAEf,QAAM,aAAa,aAAa,SAAS,aAAa;AACtD,QAAM,WAAW,WAAW,SAAS,kBAAkB;AACvD,QAAM,cAAc,cAAc;AAElC,MAAI,cAAc,CAAC,UAAU;AAC3B,WAAO,eAAe,KAAK;AAAA,EAC7B;AAEA,MAAI,UAAU;AACZ,WAAO,QAAQ,KAAK;AAAA,EACtB;AAEA,MAAI,aAAa;AACf,WAAO,aAAa,KAAK;AAAA,EAC3B;AAEA,SAAO,GAAG,MAAM,OAAO,CAAC,EAAE,YAAY,IAAI,MAAM,MAAM,CAAC,CAAC;AAC1D;AAKA,SAAS,mBAAmB,OAG1B;AACA,QAAM,gBAA4D,CAAC;AAEnE,QAAM,aAAa,aAAa,SAAS,aAAa;AACtD,QAAM,eAAe,eAAe,SAAS,gBAAgB;AAC7D,QAAM,cAAc,cAAc;AAClC,QAAM,UAAU,UAAU;AAE1B,MAAI,cAAc,CAAC,SAAS;AAC1B,kBAAc,OAAO;AAAA,EACvB,WAAW,SAAS;AAClB,kBAAc,OAAO;AAAA,EACvB;AAEA,QAAM,eAAyB,CAAC;AAEhC,MAAI,cAAc,CAAC,cAAc;AAC/B,iBAAa,KAAK,wCAAwC;AAAA,EAC5D;AAEA,MAAI,aAAa;AACf,iBAAa,KAAK,2DAA2D;AAAA,EAC/E;AAEA,MAAI,aAAa,SAAS,GAAG;AAC3B,kBAAc,eAAe;AAAA,EAC/B;AAEA,SAAO;AACT;AAKA,SAAS,YACP,UAC6D;AAC7D,QAAM,YAAY,SAAS,YAAY;AAEvC,MAAI,UAAU,SAAS,gBAAgB,KAAK,UAAU,SAAS,QAAQ,GAAG;AACxE,WAAO;AAAA,EACT;AACA,MAAI,UAAU,SAAS,QAAQ,GAAG;AAChC,WAAO;AAAA,EACT;AACA,MAAI,UAAU,SAAS,cAAc,KAAK,UAAU,SAAS,UAAU,GAAG;AACxE,WAAO;AAAA,EACT;AACA,MAAI,UAAU,SAAS,SAAS,KAAK,UAAU,SAAS,OAAO,GAAG;AAChE,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}
|
|
@@ -3,7 +3,6 @@ import "./chunk-D2CDBRNU.js";
|
|
|
3
3
|
import {
|
|
4
4
|
BRAND
|
|
5
5
|
} from "./chunk-32LIWN2P.js";
|
|
6
|
-
import "./chunk-Z7EY4VHE.js";
|
|
7
6
|
|
|
8
7
|
// src/commands/govern-scan.ts
|
|
9
8
|
import pc from "picocolors";
|
|
@@ -43,10 +42,11 @@ async function governScan(options = {}) {
|
|
|
43
42
|
createEngine,
|
|
44
43
|
buildAdaptersFromConfig,
|
|
45
44
|
createCloudAdapter,
|
|
46
|
-
formatVerdict
|
|
45
|
+
formatVerdict,
|
|
46
|
+
computeComponentHealth
|
|
47
47
|
} = await import("@fragments-sdk/govern");
|
|
48
|
-
const { scanCodebase } = await import("./codebase-scanner-
|
|
49
|
-
const { usagesToSpec } = await import("./converter-
|
|
48
|
+
const { scanCodebase } = await import("./codebase-scanner-MQHUZC2G.js");
|
|
49
|
+
const { usagesToSpec } = await import("./converter-7XM3Y6NJ.js");
|
|
50
50
|
const format = options.format ?? "summary";
|
|
51
51
|
const quiet = options.quiet ?? false;
|
|
52
52
|
if (!quiet) {
|
|
@@ -67,15 +67,52 @@ ${BRAND.name} Governance Scan
|
|
|
67
67
|
console.log(pc.dim(" No config found \u2014 using scan defaults (safety + tokens)\n"));
|
|
68
68
|
}
|
|
69
69
|
}
|
|
70
|
+
let codeTokens;
|
|
71
|
+
if (process.env.FRAGMENTS_API_KEY) {
|
|
72
|
+
codeTokens = await extractCodeTokens(rootDir, options.config, quiet);
|
|
73
|
+
}
|
|
74
|
+
let contractRegistry;
|
|
75
|
+
let registryMap;
|
|
76
|
+
{
|
|
77
|
+
const { readFileSync, existsSync: existsSync2 } = await import("fs");
|
|
78
|
+
const fragmentsJsonPath = resolve(rootDir, "fragments.json");
|
|
79
|
+
if (existsSync2(fragmentsJsonPath)) {
|
|
80
|
+
try {
|
|
81
|
+
const raw = readFileSync(fragmentsJsonPath, "utf-8");
|
|
82
|
+
const parsed = JSON.parse(raw);
|
|
83
|
+
if (parsed.fragments && Array.isArray(parsed.fragments)) {
|
|
84
|
+
const map = {};
|
|
85
|
+
for (const f of parsed.fragments) {
|
|
86
|
+
if (f.meta?.name) {
|
|
87
|
+
map[f.meta.name] = f;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
registryMap = map;
|
|
91
|
+
if (process.env.FRAGMENTS_API_KEY) {
|
|
92
|
+
contractRegistry = JSON.stringify({ fragments: parsed.fragments });
|
|
93
|
+
}
|
|
94
|
+
if (!quiet) {
|
|
95
|
+
console.log(pc.dim(` Contract registry loaded (${parsed.fragments.length} components)
|
|
96
|
+
`));
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
} catch {
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
70
103
|
const adapters = buildAdaptersFromConfig(policy.audit);
|
|
71
104
|
const hasCloudAdapter = adapters.length > 0 && policy.audit?.cloud;
|
|
72
105
|
if (!hasCloudAdapter && process.env.FRAGMENTS_API_KEY) {
|
|
73
|
-
adapters.push(createCloudAdapter());
|
|
106
|
+
adapters.push(createCloudAdapter({ codeTokens, contractRegistry }));
|
|
74
107
|
if (!quiet) {
|
|
75
108
|
console.log(pc.dim(" Cloud audit enabled (FRAGMENTS_API_KEY detected)\n"));
|
|
76
109
|
}
|
|
77
110
|
}
|
|
78
|
-
const engine = createEngine(
|
|
111
|
+
const engine = createEngine(
|
|
112
|
+
policy,
|
|
113
|
+
adapters,
|
|
114
|
+
registryMap ? { registry: { fragments: registryMap } } : void 0
|
|
115
|
+
);
|
|
79
116
|
if (!quiet) {
|
|
80
117
|
console.log(pc.dim(" Scanning files...\n"));
|
|
81
118
|
}
|
|
@@ -112,6 +149,8 @@ ${BRAND.name} Governance Scan
|
|
|
112
149
|
let passedFiles = 0;
|
|
113
150
|
let totalViolations = 0;
|
|
114
151
|
const violationCounts = /* @__PURE__ */ new Map();
|
|
152
|
+
const allVerdicts = [];
|
|
153
|
+
const usageSnapshot = [];
|
|
115
154
|
for (const [filePath, usages] of grouped) {
|
|
116
155
|
const spec = usagesToSpec(usages, filePath, rootDir);
|
|
117
156
|
const relPath = relative(rootDir, filePath);
|
|
@@ -119,6 +158,18 @@ ${BRAND.name} Governance Scan
|
|
|
119
158
|
runner: "cli",
|
|
120
159
|
input: relPath
|
|
121
160
|
});
|
|
161
|
+
allVerdicts.push(verdict);
|
|
162
|
+
usageSnapshot.push({
|
|
163
|
+
file: relPath,
|
|
164
|
+
components: usages.map((u) => ({
|
|
165
|
+
name: u.componentName,
|
|
166
|
+
line: u.line,
|
|
167
|
+
props: {
|
|
168
|
+
static: u.props.static,
|
|
169
|
+
dynamic: u.props.dynamic
|
|
170
|
+
}
|
|
171
|
+
}))
|
|
172
|
+
});
|
|
122
173
|
totalFiles++;
|
|
123
174
|
if (verdict.passed) {
|
|
124
175
|
passedFiles++;
|
|
@@ -150,6 +201,7 @@ ${BRAND.name} Governance Scan
|
|
|
150
201
|
console.log(output);
|
|
151
202
|
}
|
|
152
203
|
}
|
|
204
|
+
const health = computeComponentHealth(allVerdicts, registryMap ?? {});
|
|
153
205
|
if (!quiet && format === "summary") {
|
|
154
206
|
console.log(pc.dim("\n \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
|
|
155
207
|
console.log(` Files checked: ${totalFiles}`);
|
|
@@ -162,6 +214,12 @@ ${BRAND.name} Governance Scan
|
|
|
162
214
|
console.log(pc.dim(` ${count}\xD7 `) + pc.yellow(rule));
|
|
163
215
|
}
|
|
164
216
|
}
|
|
217
|
+
console.log(pc.dim("\n Component Health:"));
|
|
218
|
+
console.log(` Contract coverage: ${health.contractCoverage}% (${health.contractedComponents}/${health.totalComponents})`);
|
|
219
|
+
console.log(` Compliance rate: ${health.overallCompliance}%`);
|
|
220
|
+
if (health.uncontracted.length > 0) {
|
|
221
|
+
console.log(pc.dim(` Uncontracted: ${health.uncontracted.slice(0, 5).join(", ")}${health.uncontracted.length > 5 ? ` (+${health.uncontracted.length - 5} more)` : ""}`));
|
|
222
|
+
}
|
|
165
223
|
console.log();
|
|
166
224
|
if (passedFiles === totalFiles) {
|
|
167
225
|
console.log(pc.green(` \u2713 All files passed governance checks
|
|
@@ -173,8 +231,83 @@ ${BRAND.name} Governance Scan
|
|
|
173
231
|
);
|
|
174
232
|
}
|
|
175
233
|
}
|
|
234
|
+
if (process.env.FRAGMENTS_API_KEY && usageSnapshot.length > 0) {
|
|
235
|
+
try {
|
|
236
|
+
const apiKey = process.env.FRAGMENTS_API_KEY;
|
|
237
|
+
const url = process.env.FRAGMENTS_URL ?? "https://app.usefragments.com";
|
|
238
|
+
await fetch(`${url}/api/ingest`, {
|
|
239
|
+
method: "POST",
|
|
240
|
+
headers: {
|
|
241
|
+
"Content-Type": "application/json",
|
|
242
|
+
Authorization: `Bearer ${apiKey}`
|
|
243
|
+
},
|
|
244
|
+
body: JSON.stringify({
|
|
245
|
+
componentUsage: JSON.stringify(usageSnapshot),
|
|
246
|
+
componentHealth: JSON.stringify(health)
|
|
247
|
+
})
|
|
248
|
+
});
|
|
249
|
+
} catch {
|
|
250
|
+
}
|
|
251
|
+
}
|
|
176
252
|
return { exitCode: passedFiles === totalFiles ? 0 : 1 };
|
|
177
253
|
}
|
|
254
|
+
async function extractCodeTokens(rootDir, configPath, quiet) {
|
|
255
|
+
try {
|
|
256
|
+
try {
|
|
257
|
+
const { loadConfig } = await import("./node-37AUE74M.js");
|
|
258
|
+
const { parseTokenFiles } = await import("./service-QJGWUIVL.js");
|
|
259
|
+
const { config, configDir } = await loadConfig(configPath);
|
|
260
|
+
if (config.tokens?.include?.length) {
|
|
261
|
+
const result = await parseTokenFiles(config.tokens, configDir);
|
|
262
|
+
if (result.tokens.length > 0) {
|
|
263
|
+
const flat = {};
|
|
264
|
+
for (const token of result.tokens) {
|
|
265
|
+
flat[token.name] = token.resolvedValue;
|
|
266
|
+
}
|
|
267
|
+
if (!quiet) {
|
|
268
|
+
console.log(
|
|
269
|
+
pc.dim(` Extracted ${result.tokens.length} code tokens from config
|
|
270
|
+
`)
|
|
271
|
+
);
|
|
272
|
+
}
|
|
273
|
+
return JSON.stringify(flat);
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
} catch {
|
|
277
|
+
}
|
|
278
|
+
const {
|
|
279
|
+
findTailwindConfig,
|
|
280
|
+
loadTailwindConfig
|
|
281
|
+
} = await import("./token-normalizer-TEPOVBPV.js");
|
|
282
|
+
const tailwindPath = findTailwindConfig(rootDir);
|
|
283
|
+
if (tailwindPath) {
|
|
284
|
+
const tokens = await loadTailwindConfig(tailwindPath);
|
|
285
|
+
if (tokens.length > 0) {
|
|
286
|
+
const flat = {};
|
|
287
|
+
for (const token of tokens) {
|
|
288
|
+
flat[token.name] = token.value;
|
|
289
|
+
}
|
|
290
|
+
if (!quiet) {
|
|
291
|
+
console.log(
|
|
292
|
+
pc.dim(` Extracted ${tokens.length} tokens from Tailwind config
|
|
293
|
+
`)
|
|
294
|
+
);
|
|
295
|
+
}
|
|
296
|
+
return JSON.stringify(flat);
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
} catch (error) {
|
|
300
|
+
if (!quiet) {
|
|
301
|
+
console.log(
|
|
302
|
+
pc.dim(
|
|
303
|
+
` Token extraction skipped: ${error instanceof Error ? error.message : "unknown error"}
|
|
304
|
+
`
|
|
305
|
+
)
|
|
306
|
+
);
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
return void 0;
|
|
310
|
+
}
|
|
178
311
|
async function governWatch(options = {}) {
|
|
179
312
|
const {
|
|
180
313
|
loadPolicy,
|
|
@@ -183,8 +316,8 @@ async function governWatch(options = {}) {
|
|
|
183
316
|
createCloudAdapter,
|
|
184
317
|
formatVerdict
|
|
185
318
|
} = await import("@fragments-sdk/govern");
|
|
186
|
-
const { scanFile } = await import("./scanner-
|
|
187
|
-
const { usagesToSpec } = await import("./converter-
|
|
319
|
+
const { scanFile } = await import("./scanner-4KZNOXAK.js");
|
|
320
|
+
const { usagesToSpec } = await import("./converter-7XM3Y6NJ.js");
|
|
188
321
|
const quiet = options.quiet ?? false;
|
|
189
322
|
const debounceMs = options.debounce ?? 300;
|
|
190
323
|
const format = options.format ?? "summary";
|
|
@@ -277,4 +410,4 @@ export {
|
|
|
277
410
|
governScan,
|
|
278
411
|
governWatch
|
|
279
412
|
};
|
|
280
|
-
//# sourceMappingURL=govern-scan-
|
|
413
|
+
//# sourceMappingURL=govern-scan-OYFZYOQW.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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/no-dangerous-html': true,\n 'safety/sanitize-hrefs': true,\n 'safety/no-inline-scripts': true,\n 'safety/no-exposed-secrets': 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/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { FragmentsConfig, Theme, DiffResult, CompiledFragmentsFile } from '@fragments-sdk/core';
|
|
2
2
|
export { FragmentsConfig, defineBlock, defineFragment } from '@fragments-sdk/core';
|
|
3
|
+
export { BuildResult, buildFragments } from '@fragments-sdk/compiler';
|
|
3
4
|
export { CLI_COMMANDS, CLI_COMMAND_CATEGORIES, CliCategoryInfo, CliCommandCategory, CliCommandDef, CliOptionDef } from '@fragments-sdk/context/cli-commands';
|
|
4
5
|
|
|
5
6
|
/**
|
|
@@ -72,27 +73,6 @@ declare function validateAll(config: FragmentsConfig, configDir: string, options
|
|
|
72
73
|
*/
|
|
73
74
|
declare function validateSnippets(config: FragmentsConfig, configDir: string, options?: ValidationRunOptions): Promise<ValidationResult>;
|
|
74
75
|
|
|
75
|
-
interface BuildResult {
|
|
76
|
-
success: boolean;
|
|
77
|
-
outputPath: string;
|
|
78
|
-
fragmentCount: number;
|
|
79
|
-
errors: Array<{
|
|
80
|
-
file: string;
|
|
81
|
-
error: string;
|
|
82
|
-
}>;
|
|
83
|
-
warnings: Array<{
|
|
84
|
-
file: string;
|
|
85
|
-
warning: string;
|
|
86
|
-
}>;
|
|
87
|
-
}
|
|
88
|
-
/**
|
|
89
|
-
* Build compiled fragments.json file for AI consumption.
|
|
90
|
-
*
|
|
91
|
-
* Uses AST parsing to extract metadata WITHOUT executing fragment files.
|
|
92
|
-
* This means the build works without any project dependencies installed.
|
|
93
|
-
*/
|
|
94
|
-
declare function buildFragments(config: FragmentsConfig, configDir: string): Promise<BuildResult>;
|
|
95
|
-
|
|
96
76
|
/**
|
|
97
77
|
* Options for the screenshot command
|
|
98
78
|
*/
|
|
@@ -400,4 +380,4 @@ declare function generateStaticViewer(data: CompiledFragmentsFile): string;
|
|
|
400
380
|
*/
|
|
401
381
|
declare function generateViewerFromJson(jsonPath: string): Promise<string>;
|
|
402
382
|
|
|
403
|
-
export { type AnalyzeOptions, type AnalyzeResult, type
|
|
383
|
+
export { type AnalyzeOptions, type AnalyzeResult, type DiffCommandOptions, type DiffCommandResult, type DiscoveredFile, type ScreenshotCommandOptions, type ScreenshotResult, type ValidationError, type ValidationResult, type ValidationRunOptions, type ValidationWarning, type VariantDiffResult, discoverComponentFiles, discoverFragmentFiles, extractComponentName, findConfigFile, generateStaticViewer, generateViewerFromJson, loadConfig, runAnalyzeCommand, runDiffCommand, runScreenshotCommand, validateAll, validateCoverage, validateSchema, validateSnippets };
|
package/dist/index.js
CHANGED
|
@@ -4,7 +4,6 @@ import {
|
|
|
4
4
|
generateViewerFromJson
|
|
5
5
|
} from "./chunk-2WXKALIG.js";
|
|
6
6
|
import {
|
|
7
|
-
buildFragments,
|
|
8
7
|
runAnalyzeCommand,
|
|
9
8
|
runDiffCommand,
|
|
10
9
|
runScreenshotCommand,
|
|
@@ -12,24 +11,26 @@ import {
|
|
|
12
11
|
validateCoverage,
|
|
13
12
|
validateSchema,
|
|
14
13
|
validateSnippets
|
|
15
|
-
} from "./chunk-
|
|
16
|
-
import "./chunk-
|
|
14
|
+
} from "./chunk-5JF26E55.js";
|
|
15
|
+
import "./chunk-6SQPP47U.js";
|
|
16
|
+
import "./chunk-D2CDBRNU.js";
|
|
17
17
|
import {
|
|
18
18
|
discoverComponentFiles,
|
|
19
19
|
discoverFragmentFiles,
|
|
20
20
|
extractComponentName,
|
|
21
21
|
findConfigFile,
|
|
22
22
|
loadConfig
|
|
23
|
-
} from "./chunk-
|
|
24
|
-
import "./chunk-XJQ5BIWI.js";
|
|
25
|
-
import "./chunk-D2CDBRNU.js";
|
|
23
|
+
} from "./chunk-HQ6A6DTV.js";
|
|
26
24
|
import {
|
|
27
25
|
defineBlock,
|
|
28
26
|
defineFragment
|
|
29
27
|
} from "./chunk-32LIWN2P.js";
|
|
28
|
+
import "./chunk-MHIBEEW4.js";
|
|
30
29
|
import "./chunk-QCN35LJU.js";
|
|
31
30
|
import "./chunk-7DZC4YEV.js";
|
|
32
|
-
|
|
31
|
+
|
|
32
|
+
// src/index.ts
|
|
33
|
+
import { buildFragments } from "@fragments-sdk/compiler";
|
|
33
34
|
|
|
34
35
|
// src/cli-commands.ts
|
|
35
36
|
import {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/cli-commands.ts"],"sourcesContent":["/**\n * CLI command metadata — re-exported from @fragments-sdk/context for convenience.\n *\n * The source of truth lives in @fragments-sdk/context/cli-commands so that\n * browser-safe consumers (like the docs site) can import without pulling in\n * Node.js dependencies from the CLI package.\n */\nexport {\n CLI_COMMANDS,\n CLI_COMMAND_CATEGORIES,\n} from '@fragments-sdk/context/cli-commands';\n\nexport type {\n CliCommandDef,\n CliOptionDef,\n CliCommandCategory,\n CliCategoryInfo,\n} from '@fragments-sdk/context/cli-commands';\n"],"mappings":"
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/cli-commands.ts"],"sourcesContent":["// Re-export from core/node (Node.js-only APIs)\nexport {\n loadConfig,\n findConfigFile,\n discoverFragmentFiles,\n discoverComponentFiles,\n extractComponentName,\n} from \"./core/node.js\";\nexport type { DiscoveredFile } from \"./core/node.js\";\n\n// Validators\nexport { validateSchema, validateCoverage, validateAll, validateSnippets } from \"./validators.js\";\nexport type {\n ValidationResult,\n ValidationError,\n ValidationWarning,\n ValidationRunOptions,\n} from \"./validators.js\";\n\n// Build (delegated to @fragments-sdk/compiler)\nexport { buildFragments } from '@fragments-sdk/compiler';\nexport type { BuildResult } from '@fragments-sdk/compiler';\n\n// Screenshot\nexport { runScreenshotCommand } from \"./screenshot.js\";\nexport type {\n ScreenshotCommandOptions,\n ScreenshotResult,\n} from \"./screenshot.js\";\n\n// Diff\nexport { runDiffCommand } from \"./diff.js\";\nexport type {\n DiffCommandOptions,\n DiffCommandResult,\n VariantDiffResult,\n} from \"./diff.js\";\n\n// Analyze\nexport { runAnalyzeCommand } from \"./analyze.js\";\nexport type { AnalyzeOptions, AnalyzeResult } from \"./analyze.js\";\n\n// Static Viewer\nexport { generateStaticViewer, generateViewerFromJson } from \"./static-viewer.js\";\n\n// Config type (used by generated fragments.config.ts)\nexport type { FragmentsConfig } from \"./core/index.js\";\n\n// Fragment definition API (used by generated .fragment.tsx files)\nexport { defineFragment, defineBlock } from \"./core/index.js\";\n\n// CLI Command metadata (for docs)\nexport { CLI_COMMANDS, CLI_COMMAND_CATEGORIES } from \"./cli-commands.js\";\nexport type { CliCommandDef, CliOptionDef, CliCommandCategory, CliCategoryInfo } from \"./cli-commands.js\";\n","/**\n * CLI command metadata — re-exported from @fragments-sdk/context for convenience.\n *\n * The source of truth lives in @fragments-sdk/context/cli-commands so that\n * browser-safe consumers (like the docs site) can import without pulling in\n * Node.js dependencies from the CLI package.\n */\nexport {\n CLI_COMMANDS,\n CLI_COMMAND_CATEGORIES,\n} from '@fragments-sdk/context/cli-commands';\n\nexport type {\n CliCommandDef,\n CliOptionDef,\n CliCommandCategory,\n CliCategoryInfo,\n} from '@fragments-sdk/context/cli-commands';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAS,sBAAsB;;;ACb/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}
|
|
@@ -10,7 +10,6 @@ import "./chunk-D2CDBRNU.js";
|
|
|
10
10
|
import {
|
|
11
11
|
BRAND
|
|
12
12
|
} from "./chunk-32LIWN2P.js";
|
|
13
|
-
import "./chunk-Z7EY4VHE.js";
|
|
14
13
|
|
|
15
14
|
// src/commands/init.ts
|
|
16
15
|
import { readFile, writeFile, mkdir, access } from "fs/promises";
|
|
@@ -371,7 +370,7 @@ Scan path not found: ${scanPath}
|
|
|
371
370
|
errors: [`Scan path not found: ${scanPath}`]
|
|
372
371
|
};
|
|
373
372
|
}
|
|
374
|
-
const { scanGenerate } = await import("./scan-generate-
|
|
373
|
+
const { scanGenerate } = await import("./scan-generate-VY27PIOX.js");
|
|
375
374
|
const scanResult = await scanGenerate({
|
|
376
375
|
scanPath,
|
|
377
376
|
force: options.force,
|
|
@@ -579,7 +578,7 @@ ${BRAND.name} init
|
|
|
579
578
|
}
|
|
580
579
|
if (scenario === "components" || scenario === "stories") {
|
|
581
580
|
try {
|
|
582
|
-
const { scan } = await import("./scan-
|
|
581
|
+
const { scan } = await import("./scan-PKSYSTRR.js");
|
|
583
582
|
const scanResult = await scan({
|
|
584
583
|
config: configPath,
|
|
585
584
|
verbose: false,
|
|
@@ -636,4 +635,4 @@ ${BRAND.name} init
|
|
|
636
635
|
export {
|
|
637
636
|
init
|
|
638
637
|
};
|
|
639
|
-
//# sourceMappingURL=init-
|
|
638
|
+
//# sourceMappingURL=init-SSGUSP7Z.js.map
|